快速上手
先用 C 板默认的 LED 程序走一遍下载、生成、编译和烧录,再换成整车配置。
准备工具
按 STM32 环境配置安装工具链和调试工具。Windows 可以直接使用原生 STM32 开发环境。
XRobot 和代码生成器装在自己的 Python 环境中:
python -m pip install xrobot libxr
这里的 Python 包 libxr 是代码生成工具。工程使用的 C++ 库通过 Git submodule 获取。
拉取与初始化
git clone https://github.com/QDU-Robomaster/bsp-dev-c.git
cd bsp-dev-c
git submodule update --init --recursive
xr_cubemx_cfg -d . --xrobot
xrobot_setup
LibXR 位于 Middlewares/Third_Party/LibXR/,各模块下载到 Modules/。初始化完成后,生成默认入口:
xrobot_gen_main --config User/xrobot.yaml
默认配置创建 BlinkLED,blink_cycle 为 250。生成的入口是 User/xrobot_main.hpp。
编译
在安装好 STM32 工具的 Bash 或 Git Bash 中执行:
bash tools/build.sh --skip-format -c User/xrobot.yaml -b build/debug
脚本会生成入口、配置 CMake 并编译。--skip-format 只跳过源码格式化,方便第一次构建时保持下载下来的模块不变。
构建目录中应有:
build/debug/DevC.elf
build/debug/DevC.hex
build/debug/DevC.bin
使用原生 PowerShell 开发时,可按 bsp-dev-c 环境页配置工具链后通过 CMake 编译。
烧录与调试
连接 C 板和调试探针,在 STM32 调试工具中选择刚生成的 DevC.elf,确认芯片型号和 SWD 连接后下载、复位。程序启动后观察 LED。
没有预期现象时,先检查是否停在断点、异常或初始化阶段。终端输出接在 USB OTG FS CDC;接线和端口名称见外设映射。
首次运行整车配置前,先断开电机动力,核对 CAN ID、方向和限位后再逐项通电。
改一个参数
把 User/xrobot.yaml 中的 blink_cycle 从 250 改为 500,重新生成、编译并烧录,观察 LED 周期的变化。配置改在 YAML 中,生成头文件会在下一次运行生成器时覆盖。
整车配置另放在 User/RobotConfig/,例如:
xrobot_gen_main --config User/RobotConfig/omni_infantry_3.yaml
各份文件的用途见机器人配置。
源码:bsp-dev-c。