Zephyr嵌入式实时操作系统 - 构建工具

原创

已于 2026-03-05 10:08:00 修改 · 1.3k 阅读

标签

#Zephyr #rtos

于 2025-09-24 14:41:37 首次发布

Zephyr作为开源软件中的佼佼者，其在源码配置、编写、构建、流程化方面都值得我们去认真钻研和学习。但在真正开始基于Zephyr RTOS开发固件或者应用程序之前，需要开发者学习并掌握以下关键工具：Kconfig系统配置工具、CMake跨平台构建工具、DeviceTree设备树硬件描述工具。官方文档：Build and Configuration Systems

DeviceTree设备树解析

DeviceTree设备树是一种用来描述硬件的数据结构，它具有自己独特的语法格式。另外，设备树有专门的编译器DTC，可以将设备树源文件DTS编译成可供内核动态解析的DTB文件。Zephyr RTOS设备树实际开发过程中，开发工具链中的C预处理器会将Zephyr源码不同层级目录下面的 .dtsi、.dts、.overlay 设备树描述源文件，先合并到一个预处理的文本文件中 zephyr/build/zephyr/zephyr.dts.pre 。然后，位于Scripts目录下的解析脚本 zephyr\scripts\dts\gen_defines.py 会根据设备树文件中的"compatible"找到相匹配的 .yaml/.yml 属性规则文件（Devicetree bindings：设备树绑定文件）所声明的设备树节点中可使用的设备属性及其约束，对设备树进行校验。如果校验成功，Zephyr构建系统会输出一个完整的设备树源文件 zephyr\build\zephyr\zephyr.dts ，并且会将上面这个预处理器文本文件 zephyr.dts.pre 按照 Devicetree bindings 解析生成一个带有预处理器宏的C头文件zephyr\build\zephyr\include\generated\zephyr\devicetree_generated.h 。但驱动层和应用层代码在构建时并不会直接包含该头文件，而是通过 devicetree.h 头文件包含 devicetree_generated.h 来间接获取devicetree_generated.h头文件中的预处理器宏。
DTS

Kconfig系统配置

相信很多面向Linux系统级嵌入式开发的小伙伴们对这个Kconfig（kernel configuration）系统配置工具一定非常熟悉。Zephyr RTOS借鉴了Linux系统的开发思想，同样采用Kconfig配置工具进行系统宏定义、内核裁剪等。实际开发中，开发者只需要知道Kconfig是用来将繁杂的系统宏定义、繁杂的模块选项配置通过图形化菜单的形式进行组织、显示，达到能够让开发者一目了然的查看到系统配置内容的目的就可以了。python虚拟环境终端输入 west build -t menuconfig 可查看图形菜单。

(.venv) PS E:\PhotonIC\Projects_rtos\zephyrproject> cd .\zephyr\
(.venv) PS E:\PhotonIC\Projects_rtos\zephyrproject\zephyr> west build -t menuconfig
-- west build: running target menuconfig
[0/1] CMakeFiles\menuconfig-5f29641.bat aac4a947780a298bLoaded configuration 'E:/PhotonIC/Projects_rtos/zephyrproject/zephyr/build/zephyr/.config'    
No changes to save (for 'E:/PhotonIC/Projects_rtos/zephyrproject/zephyr/build/zephyr/.config')

mainmenuconfig
基于Kconfig配置工具，不同层级目录下的Kconfig片段会进行合并处理，生成最终的 zephyr\build\zephyr\.config ，该 .config文件供CMake使用。另外还生成一个 zephyr\build\zephyr\include\generated\zephyr\autoconf.h包含配置宏的头文件，该 autoconf.h 头文件在编译阶段会自动展开。

Kconfig

CMake跨平台构建

CMake是跨平台构建工具，它提供了高效易用的构建语言，可以帮助开发者实现大型软件项目的自动化构建。Zephyr RTOS项目在CMake原有语法定义的基础上，新添加了很多适用于Zephyr构建的编译宏。这大大提高了Zephyr RTOS的构建效率。CMake构建Zephyr项目可分为两个阶段：配置阶段和编译阶段。配置阶段是按照CMakeLists.txt中的规则配置，包括对DeviceTree和Kconfig进行配置，使用CMake生成本地Makefile/Ninja文件。编译阶段是使用Make或者Ninja将本地Makefile文件编译成可执行文件（zephyr.elf、zephyr.hex、zephyr.bin），在这个过程中，Zephyr使用了很多的处理脚本，这些脚本位于：zephyr\scripts\build。
CMake

Zephyr项目编译过程

基于Kconfig内核配置工具、DeviceTree设备树、CMake跨平台构建工具等，一个完整的Zephyr项目就可以被成功编译。下面的编译输出信息可以清晰的告诉开发者项目是如何一步一步被构建出来的。

(.venv) PS E:\PhotonIC\Projects_rtos\zephyrproject\zephyr> west build -p always -b stm32_min_dev samples\basic\blinky 
-- west build: making build dir E:\PhotonIC\Projects_rtos\zephyrproject\zephyr\build pristine
-- west build: generating a build system
Loading Zephyr default modules (Zephyr base).
-- Application: E:/PhotonIC/Projects_rtos/zephyrproject/zephyr/samples/basic/blinky
-- CMake version: 4.1.1
-- Found Python3: E:/PhotonIC/Projects_rtos/zephyrproject/.venv/Scripts/python