跳到主要内容

通信规范

模块间使用 Topic 传递数据,模式切换等动作通过 Event 连接。框架接口见 消息系统和事件系统。

主机与 C 板​

以 omni_infantry_3.yaml 和 Linux hik.yaml 为例,通信清单如下:

方向Topic内容
主机 → C 板target_euler云台角度、角速度、角加速度
主机 → C 板fire_notify发射许可
主机 → C 板camera_sync_command相机同步命令
C 板 → 主机gimbal_gyro、gimbal_accl、gimbal_quatIMU 与姿态
C 板 → 主机camera_sync_result触发与同步结果
C 板 → 主机robot_game_ref裁判摘要

C 板使用默认 Topic 域,Linux 接收端将这些数据放入 host 域。

C 板接收侧配置:

- id: sharedtopic
name: SharedTopic
constructor_args:
uart_name: usb_otg_hs_cdc
buffer_size: 512
topic_configs:
- target_euler
- fire_notify
- camera_sync_command

同一配置中的 SharedTopicClient 负责反方向发送。FS 与 HS CDC 的用途见外设映射。

SharedTopic 的几个名字​

SharedTopic 和 SharedTopicClient 是两个模块仓库。前者使用 Topic::Server 接收并解析串口数据,后者订阅本地 Topic、打包并发送。USB CDC 同样可以承载这条链路。

LibXR::LinuxSharedTopic 则是同机跨进程共享内存接口,与这两个串口模块不同。

两个串口模块构造时会查找 Topic。出现 Topic not found 时,检查创建顺序、名称和域;接收 Topic 应在接收模块启动前创建好。

云台目标字段​

当前 Aimer 将机械俯仰同时写入 rol、pit,以及各自的 _dot、_ddot 字段。实体 HostData/CMD/Gimbal 路径使用 pit,WebotsGimbal 使用 rol。偏航使用 yaw 一组字段。

角度单位为 rad,角速度为 rad/s,角加速度为 rad/s²。字段兼容关系以 Aimer 和电控侧消费代码为准。

接口变更​

修改 Topic 时同时检查收发两侧的类型、名称、域、单位和时间戳。异步处理还要确认消息有效期,回调中借用的指针不能直接留给另一个线程。

遥控事件在机器人 YAML 的 EventBinder 中连接。排查模式切换时,依次看输入事件、绑定关系和 CMD 当前控制源。

源码:bsp-dev-c、bsp-linux-autoaim。