跳到主要内容
RoboMasterQDU未来战队

QDU-Robomaster

初音未来战队基于 XRobot 完成了全兵种的功能实现。

这里是战队的开发文档,用来带新队员上手,也给其他队伍做参考。电控和算法两组的仓库、配置和链路,都能从这一页找到对应的文档。

动画
电控组bsp-dev-cRobotConfig

五个兵种,六份配置

整车配置都在 bsp-dev-c 的 User/RobotConfig/ 下,电机 ID、反向、PID、几何参数和事件绑定写在各自的 YAML 里。换车型时替换 xrobot_gen_main --config 后面的文件,重新生成后编译。

helm_infantry.yaml、radar.yaml、wheel_leg.yaml 目前仅 BlinkLED,还没有整车模块,这里没有列出。

英
机器人 ID1

英雄

配置
hero.yaml
功能
底盘、云台、MiniGimbal、HeroLauncher、功率管理、通信
模块
ChassisGimbalMiniGimbalHeroLauncherSuperPowerPowerControlSharedTopicSharedTopicClient
xrobot_gen_main --config User/RobotConfig/hero.yaml
步
机器人 ID3–5

步兵

配置
omni_infantry_3.yamlomni_infantry_4.yaml
功能
全向底盘、云台、步兵发射机构、相机同步、通信omni_infantry_4.yaml:另一份全向步兵配置,设备分配和参数单独维护
模块
ChassisGimbalInfantryLauncherCameraSyncSharedTopicSharedTopicClient
xrobot_gen_main --config User/RobotConfig/omni_infantry_3.yaml
哨
机器人 ID7

哨兵

配置
sentry.yaml
功能
底盘、云台、步兵发射机构、SentryProtocol、功率管理、通信
模块
ChassisGimbalInfantryLauncherSentryProtocolSuperPowerPowerControlSharedTopicSharedTopicClient
xrobot_gen_main --config User/RobotConfig/sentry.yaml
空
机器人 ID6

空中

配置
aerial.yaml
功能
姿态、遥控、云台、步兵发射机构、主机通信
模块
BMI088MadgwickAHRSDR16GimbalInfantryLauncherSharedTopicSharedTopicClient
xrobot_gen_main --config User/RobotConfig/aerial.yaml
镖
机器人 ID8

飞镖

配置
dart.yaml
功能
电机、遥控、裁判、Dart、主机通信
模块
RMMotorDR16RefereeDartSharedTopicSharedTopicClient
xrobot_gen_main --config User/RobotConfig/dart.yaml

卡片由 scripts/gen-robots.js 按机器人配置页的配置清单生成。

算法组自瞄链路

从相机到云台,一条自瞄链路

HikCamera 出图,CameraFrameSync 把图像和 IMU 按时间对齐成同步帧,ArmorDetector 找装甲板并解 PnP,ArmorTracker 按编号跟踪车辆,Aimer 预测运动、计算弹道和云台计划。结果经 SharedTopicClient 送到 C 板,由云台执行。

Tracker 按装甲板编号分别维护车辆状态和 EKF;Aimer 预测目标运动,展开四个装甲面,挑出能打的一面再求弹道。弹道模型带二次空气阻力,用 RK4 积分。右边这块按步骤演示目标被发现、预测到开火的过程。

算法组相机与同步

每张图都知道是哪一刻拍的

CameraSync 在 C 板的 IMU 回调里计时,到点拉高触发线,相机开始曝光,同时把这次采样的时间戳放进 SyncEvent 发给上位机。图像晚几毫秒才到,CameraFrameSync 按序号配上 SyncEvent,取曝光中点最近的一次 IMU 采样。

拖曝光时间,看中点怎么挪;让相机丢一帧,看上位机怎么靠序号发现;切到 20 Hz,看 STOP、稳定、START 的握手。

算法组Webots

Webots 和实车用同一套自瞄模块

bsp-webots-autoaim 用 WebotsCamera、WebotsGimbal、WebotsFireNotify、WebotsReferee 替换相机、云台、发射机构和裁判系统,Detector、Tracker、Aimer 与实车共用。没有整车,也能把检测、跟踪到瞄准的整条链路跑起来。

Windows 上运行原生 Webots,controller 在 Docker 容器里编译运行;Linux 上两者都可以原生运行。

全组协作开发环境

开发环境与 Git 协作

战队有四个 BSP,每个一页环境说明。第一次接触某个平台,先按对应组的快速上手把工程跑通,再进入模块内部。

两组之间交接的姿态、角速度和目标位置默认使用本体系 B(+X 车头,+Y 左侧,+Z 向上);Topic 的名称、域、单位和时间戳按通信规范对齐。

STM32C 板

bsp-dev-c

当前主要的 C 板电控工程,整车配置在 User/RobotConfig/。Windows 原生 STM32 工具链或 Linux ARM 工具链都可以编译。

STM32WindowsLinux
STM32MC02

bsp-dev-mc02

MC02 板级工程,默认程序是蜂鸣器测试。初始化比 C 板多一步 xrobot_src_man create-sources。

STM32WindowsLinux
Linux实车自瞄

bsp-linux-autoaim

实车 Linux 自瞄,接 Hik 相机,用 OpenVINO 推理。User/RunConfig/ 下有实车相机、文件回放和采集标定几套运行配置。

LinuxOpenVINO
Webots仿真

bsp-webots-autoaim

Webots 自瞄仿真。Windows 上 Webots 原生运行,controller 在 Docker 容器里编译;Linux 可以全部原生运行。

WebotsDockerOpenVINO

Git 协作

正式改动走分支,不直接提交到 main、master、dev。一个 PR 只处理一个主题,写清变更内容、验证方式和影响范围;坐标系、通信、同步链路这类改动实机验证后再合并。

每个模块仓库维护自己的 CI,跨仓库改动在相关 PR 里互相引用,并写明合并顺序。

  • feature/<short-desc>
  • fix/<short-desc>
  • docs/<short-desc>
  • refactor/<short-desc>
新队员上手路线

新队员从这里开始

先读两组共用的几页,再按组往下走。每一步对应一篇文档,读完可以勾上;进度只保存在当前浏览器里。

两组共用

先读这几页

为什么全队都用 XRobot,整车怎么连起来,两组之间按什么约定交接。

0/6
  1. 欢迎文档目录和框架文档入口
  2. 设计思想一套开发方式、分布式通信、模块复用
  3. 整体架构自瞄系统和下位机系统的结构图
  4. 坐标系规范本体系 B、BMI088 安装变换、云台目标字段
  5. 团队工作流分支、PR、CI 和跨仓库改动
  6. 开发环境四个 BSP 的入口
电控组bsp-dev-c

电控组

从 C 板的 LED 程序开始,走通生成、编译、烧录,再换成整车配置。

0/9
  1. 电控组文档总览常用工程和工程里的几个位置
  2. bsp-dev-c 环境工具链和初始化命令
  3. 快速上手用 LED 程序走一遍生成、编译、烧录
  4. 机器人配置各车型 YAML 和切换方法
  5. 外设映射YAML 里的名字对应哪个外设
  6. 模块索引每项功能在哪个模块仓库
  7. 通信规范Topic、Event 和主机通信
  8. 代码规范命名、格式化和生成文件
  9. 调试与上板常见问题和要看的状态
算法组bsp-webots-autoaim

算法组

先在 Webots 里把整条链路跑起来,再顺着链路读每个模块。

0/9
  1. 算法组开发指南常用仓库和各页内容
  2. 快速上手开发容器、编译、连接 Webots、看预览
  3. 模块索引功能和源码文件的对应
  4. 相机与同步触发、时间戳和帧几何
  5. 运行配置Webots 与 Linux 的运行 YAML
  6. 自瞄链路Detector、Tracker、Aimer 之间的数据
  7. 算法细节检测、跟踪、弹道和 MPC
  8. Webots 仿真world、controller 和仿真设备
  9. 测试与回归场景冒烟测试和端到端验收
框架仓库版本

框架文档、仓库和版本基线

XRobot / LibXR 的安装、代码生成、模块管理和 API 写在框架文档里,本站只写战队的用法。战队的 BSP 和模块仓库都在 GitHub 组织 QDU-Robomaster 下。

XRobot 框架文档

环境配置、代码生成、模块管理、消息与事件系统,以及 LibXR 的类文档。

xrobot-org.github.io

GitHub 组织

BSP、自瞄模块和 Webots 适配模块的源码,每个模块一个仓库。

github.com/QDU-Robomaster