ROS 2 集成
在 Apex 架构中,机器人内置控制器运行机器人控制、遥操作、相机和录制相关的 ROS 2 节点:当前机型为天准或灵境 Thor 控制器,早期机型为 Orin。上位机上的 Apex Teleop 负责连接管理和操作流程。
接口文档
| 机器人或设备 | 文档 |
|---|---|
| Marvin Pro | Marvin Pro ROS 2 接口:命名空间、安全要求、输入仲裁、话题、服务、网络端口与话题频率 |
| Skye 与 Luna | Skye 与 Luna ROS 2 接口:关节差异、全身控制指令、服务与移动底盘 |
| 头部与腕部相机 | 相机 ROS 话题 |
| RealSense 相机 | RealSense 相机(ROS 2) |
| 允许录制与转发的话题 | 话题白名单 |
编写客户端前,请在已安装版本上确认话题名称、消息类型、单位、坐标系和更新方式。以机器人上 ros2 topic list -t 的输出为准。
加载 Apex ROS 2 环境
登录机器人控制器(参见连接 Orin 或 Thor),在每个新终端中加载环境:
source /etc/apex/apex_ros_env.sh
在 Marvin Pro 上,Apex 节点默认运行在 tj 命名空间下,核心接口位于 /tj/...。基于旧版 /control/...、/info/... 路径编写的程序需要更新。
区分不同接口
| 接口 | 作用 |
|---|---|
| Marvin 运动控制 SDK | 与机器人控制器通信 |
| Apex ROS 2 接口 | 机器人端应用集成与遥测 |
| Apex 上位机应用 | 操作员连接、模式选择与录制 |
ROS 2 集成并不意味着 SDK 的每个功能都以话题或服务形式开放。不要假设 Luna/Skye 的消息定义或控制器设置适用于 Marvin Pro。
发送指令前
确认由哪个进程控制机器人、控制权如何交接,以及指令使用的坐标系和单位。请阅读对应机器人接口文档中的安全要求和输入仲裁规则,以及遥操作模式与输入源。