Metadata
- name
- rdk-x5-tros
- description
- 使用 RDK X5 上的 TogetheROS.Bot (tros.b) Humble 框架：启动 43 个预装 ROS2 算法包、管理 ROS2 话题/节点/服务、构建摄像头+AI+输出（Web/语音/HDMI）集成 pipeline、创建自定义 ROS2 工作空间。Use when the user mentions ROS2, TROS, ros2 launch, topic/node/service, or wants to build an integrated multi-component pipeline combining camera + AI + any output (集成/pipeline/全链路). Also use when user combines camera + AI + display/audio in one request. Do NOT use for camera-only hardware setup (use rdk-x5-camera), /app demo scripts (use rdk-x5-app), standalone AI inference without ROS2 (use rdk-x5-ai-detect), GPIO/I2C hardware (use rdk-x5-gpio), or system management (use rdk-x5-system).
- license
- MIT-0
- metadata
- {"openclaw":{"requires":{"bins":["ros2","colcon"]},"compatibility":{"platform":"rdk-x5"}}}
RDK X5 TROS — TogetheROS.Bot 机器人开发
所有 tros 包安装在 /opt/tros/humble/，共 43 个包、136 个 launch 文件。
前置准备
# 每个终端必须 source
source /opt/tros/humble/setup.bash
预装包速查表
感知算法（17 个）
| 包名 |
功能 |
| dnn_node_example |
YOLO/分类/分割通用推理 |
| mono2d_body_detection |
人体 2D 检测 |
| mono3d_indoor_detection |
室内 3D 检测 |
| face_age_detection |
人脸年龄检测 |
| face_landmarks_detection |
人脸关键点 |
| hand_gesture_detection |
手势检测 |
| hand_lmk_detection |
手部关键点 |
| hobot_falldown_detection |
跌倒检测 |
| hobot_dosod |
开放词汇检测 (DOSOD) |
| hobot_yolo_world |
YOLO-World 开放词汇 |
| parking_perception |
停车场感知 |
| mono_mobilesam |
MobileSAM 分割 |
| mono_edgesam |
EdgeSAM 轻量分割 |
| elevation_net |
高程估计 |
| mono_pwcnet |
光流估计 |
| reid |
行人重识别 |
| clip_manage |
CLIP 图文匹配 |
传感器驱动（6 个）
| 包名 |
功能 |
| mipi_cam |
MIPI 摄像头 |
| hobot_usb_cam |
USB 摄像头 |
| hobot_zed_cam |
ZED 双目 |
| hobot_stereonet |
双目深度估计 |
| imu_sensor |
IMU |
| hobot_audio |
音频采集 |
处理与输出（8 个）
| 包名 |
功能 |
| hobot_codec |
图像编解码 |
| hobot_cv |
硬件加速图像处理 |
| hobot_hdmi |
HDMI 显示 |
| hobot_image_publisher |
图片发布（测试） |
| hobot_visualization |
可视化叠加 |
| websocket |
Web 展示 (port 8000) |
| hobot_rtsp_client |
RTSP 拉流 |
| hobot_vio |
视频 IO |
应用方案（6 个）
| 包名 |
功能 |
| hobot_llamacpp |
端侧 LLM 大模型 |
| audio_control |
语音控制 |
| audio_tracking |
声源追踪 |
| body_tracking |
人体追踪 |
| gesture_control |
手势控制 |
| parking_search |
智能车位搜索 |
工具包（6 个）
hobot_shm（零拷贝共享内存）、tros_lowpass_filter、tros_perception_fusion、dstereo_occnet 等。
常用 Pipeline
摄像头 + YOLO + Web
ros2 launch dnn_node_example dnn_node_example.launch.py \
dnn_example_config_file:=config/yolov5sworkconfig.json \
dnn_example_image_width:=640 dnn_example_image_height:=480
人脸关键点 + Web
ros2 launch face_landmarks_detection body_det_face_landmarks_det.launch.py
DOSOD 开放词汇
ros2 launch hobot_dosod dosod.launch.py
SAM 分割
ros2 launch mono_mobilesam sam.launch.py
LLM 大模型
ros2 launch hobot_llamacpp hobot_llamacpp.launch.py
ROS2 管理命令
ros2 topic list # 所有话题
ros2 topic hz /image_raw # 话题频率
ros2 topic echo /ai_msg --no-arr # 打印数据
ros2 node list # 运行中节点
ros2 node info /mipi_cam # 节点详情
ros2 service list # 服务列表
ros2 param list # 参数列表
查看 launch 文件
ls /opt/tros/humble/share/<package_name>/launch/
自定义开发
mkdir -p ~/tros_ws/src && cd ~/tros_ws/src
ros2 pkg create my_node --build-type ament_python --dependencies rclpy
cd ~/tros_ws && colcon build
source install/setup.bash
ros2 run my_node my_node
排查故障
| 现象 |
原因 |
解决 |
Package not found |
未 source 环境 |
source /opt/tros/humble/setup.bash |
| 节点启动后立即退出 |
依赖节点未启动（如缺摄像头） |
先启动摄像头节点，再启动算法节点 |
| topic 无数据 |
节点间 topic 名称不匹配 |
ros2 topic list 检查；用 --remap 对齐 |
| 共享内存报错 |
hobot_shm 配置问题 |
检查 /dev/shm 空间：df -h /dev/shm |
