跳到主要内容

快速上手

先用 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。