构建固件

获取代码

通过git拉取

克隆仓库

# github
git clone https://github.com/xrobot-org/XRobot.git

# gitee
git pull https://gitee.com/x-robot/XRobot.git

初始化第三方库

方式一:使用脚本自动初始化

./project.py init

方式二:使用gitee镜像

./project.py init-cn

方式三:直接使用git命令行初始化

git submodule init && git submodule update

直接下载完整代码

由于拉取完整代码对网络要求较高,同时又过于耗费时间,可以在仓库的Releases页面找到发布的最新的以Repo开头的版本,下载repo.zip解压即可。此压缩文件包含仓库代码以及所有第三方库,可以直接进行编译,但是版本可能会落后于主线,需要手动拉取一遍。

配置工程

手动创建一个新配置

图形化:

./project.py config

配置界面

命令行:

./project.py menuconfig

配置界面

选择已有的配置

  1. 查看可编译目标 ./project.py list
  2. 选择加载某个编译目标的配置文件 例如:./project.py select rm-c infantry加载c板步兵配置。之后手动编译

构建

  • GUI

    在VSCode下方工具栏里选择Build

  • 命令行

    cmake -DCMAKE\_TOOLCHAIN\_FILE:STRING=utils/CMake/toolchain.cmake -H. -B./build -G Ninja -DCMAKE_BUILD_TYPE:STRING=Debug

  • 直接选择目标构建

    例如:./project.py build rm-c infantry编译C板步兵代码,或者使用 ./project.py build all all编译所有开发板的所有兵种代码。

固件

输出路径:

  • ./build/xrobot.elf
  • ./build/xrobot.bin
  • ./build/xrobot.hex