Gento Skye / Luna 终端直贴式通讯排查手册
适用:Gento 系列 Skye、Luna。
本文所有排查代码均可整段粘贴到控制器终端运行,不调用外部排查脚本。Gento 与 Marvin Pro 是并列源码体系,控制链判断不能混用。
1. 使用规则
- 每个代码块独立可运行。
- 默认命令只读取状态,不控制机器人。
- 结果保存到:
~/apex_direct_gento_check/
gripper-active会真实控制夹爪,必须单独确认安全。- 代码自动兼容 Apex ROS namespace。
结果标记:
| 标记 | 含义 |
|---|---|
[MISSING] | Topic 不存在 |
[DATA] | 收到数据 |
[NO_DATA] | Topic 存在但没有收到数据 |
| Publisher count 大于 0 | 仅表示发现发布端 |
| Subscription count 大于 0 | 仅表示发现订阅端 |
2. Skye 和 Luna 区别
| 项目 | Skye | Luna |
|---|---|---|
| 本体 | 可上下移动 | 带类似膝盖的多关节身体结构 |
| 底层对象 | Gento Skye L1 SDK | Gento Luna L1 SDK |
| 身体命令 | 升降/身体轴 | 多关节身体轴 |
| Teleop 参数 | 通常 enable_tcp=false | 通常 enable_tcp=true |
| 型号状态 | 应识别为 Gento Skye | 应识别为 Gento Luna |
测试前必须明确当前是 Skye 还是 Luna,并核对关节数量和身体控制行为。
3. 推荐启动顺序和进程要求
Robot -> Start- 确认前端机型为 Skye 或 Luna
Teleop -> StartTool -> StartCamera -> Start,仅相机测试需要- 连接头显进入遥操
| 模块 | 必需服务/进程 |
|---|---|
| Robot | apex-robot.service、Gento Robot Node、L1 SDK 通讯 |
| 头显 | apex-teleop.service、controller_udp.py / VR reader |
| IK | teleop_manager_v2、ik_request_mux |
| QP 和命令选择 | qp_controller、joint_cmd_mux |
| 坐标 | tracking_base_tf 等 TF 进程 |
| 末端 | apex-tool.service、对应末端节点 |
| 相机 | apex-camera.service、Argus/GMSL/WebRTC 进程 |