跳到主要内容

ROS 2 集成

在 Apex 架构中,机器人内置控制器运行机器人控制、遥操作、相机和录制相关的 ROS 2 节点:当前机型为天准或灵境 Thor 控制器,早期机型为 Orin。上位机上的 Apex Teleop 负责连接管理和操作流程。

接口文档​

机器人或设备文档
Marvin ProMarvin Pro ROS 2 接口:命名空间、安全要求、输入仲裁、话题、服务、网络端口与话题频率
Skye 与 LunaSkye 与 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。

发送指令前​

确认由哪个进程控制机器人、控制权如何交接,以及指令使用的坐标系和单位。请阅读对应机器人接口文档中的安全要求和输入仲裁规则,以及遥操作模式与输入源。