10分钟跑通第一块固件Zephyr west 从干净环境到烧录开发板【免费下载链接】zephyrPrimary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.项目地址: https://gitcode.com/GitHub_Trending/ze/zephyrZephyr 的代码分布在几十个独立的 Git 仓库里构建链路又横跨工具链选择、Kconfig 选项和设备树编译靠手工一条命令一条命令地敲完全不现实。west 是 Zephyr 官方提供的构建工具负责 Zephyr项目初始化按清单文件拉取、同步全部子仓库、Zephyr固件构建封装 CMake 和 Ninja以及把编译好的固件烧录到 Zephyr开发板 上。跟着这篇文章敲完几条命令就能从装依赖一路走到烧录 hello_world 看到灯亮全程只涉及 init、update、build、flash 四类命令。⚡准备工作把依赖和 west 一次性装好west 本身是一个 Python 包前置条件是 Python 3.10 或更高版本、Git、CMake 3.20.5 或更高版本以及设备树编译器 dtc 1.4.6 或更高版本dtc 负责把 .dts 设备树源文件编译成内核可读的二进制。在 Ubuntu 上可以一条命令装齐依赖sudo apt install --no-install-recommends git cmake ninja-build gperf \ ccache dfu-util device-tree-compiler wget python3-dev python3-venv python3-tk \ xz-utils file make gcc gcc-multilib g-multilib libsdl2-dev libmagic1west 建议装在虚拟环境里它的依赖完全不碰系统 Python之后升级、回退都不用担心影响系统包python3 -m venv ~/zephyrproject/.venv source ~/zephyrproject/.venv/bin/activate pip install west前两行创建并激活虚拟环境第三行把 west 装进去。装完想确认是否可用敲west help能看到完整命令列表就说明一切正常。从 0 到第一次构建用 west init 创建工作区west init会克隆 Zephyr 主仓库并生成.west/工作区配置目录。跑完后工作区包含三部分zephyr/主仓库、modules/第三方模块和tools/辅助工具。west init ~/zephyrproject想直接固定到某个版本初始化加上--mr参数例如west init --mr v3.4.0 ~/zephyrproject。用 west update 拉齐所有子仓库光有主仓库还编不出来。west 会读取工作区根目录的 west.yml——这是清单文件定义了每个模块的远端地址、存放路径和锁定版本——然后一次性把所有子仓库拉下来cd ~/zephyrproject west update拉取完成后可用west list核对它会打印每个项目的名称、在工作区中的路径和源仓库地址缺没缺仓库一目了然。编译 hello_world 并烧进开发板west build命令 的标准写法是“开发板 源码目录”拿官方 hello_world 示例练手cd ~/zephyrproject/zephyr west build -p always -b nrf52840dk_nrf52840 samples/basic/hello_world-b指定目标 Zephyr开发板-p always强制重新生成构建系统文件避免残留旧配置导致奇怪问题。构建过程中 west 先调用 CMake 生成构建系统再用 Ninja 或 Make 完成编译产物默认落在build/目录想放到别的位置就加-d build/nrf52840之后的增量构建沿用同一目录。编译通过后west flash烧录 一条命令west flashwest flash 会自动识别目标板并选用合适的烧录工具写入固件。一块板子有多个烧录接口时用--runner指定其中一个例如west flash --runner jlink。想进一步做断点调试west debug会启动 GDB 并连接目标设备也可以作为 IDE 调试的入口。日常高频场景日常开发很少需要背一堆命令按场景对号入座就好。只给单个模块换版本。只想重新同步某一个模块时把名字传进去即可west update hal_stm32。版本本身由 west.yml 里的 revision 字段锁定同步结果不对就先查这里。图形化改构建选项。Zephyr 的构建选项都在 Kconfig 里用命令行逐个传-DCONFIG_XXX敲几个就嫌烦可视化菜单更顺手west build -b nrf52840dk_nrf52840 samples/basic/hello_world -t menuconfig查支持的开发板清单。填-b的值之前先敲west boards输出里的板子全名可以直接拿去用。让外部 CMake 工程找到 Zephyr。不走 west build而是把 Zephyr 当作依赖接进自己的 CMake 工程时执行west zephyr-export导出 CMake 包外部工程就能找到 Zephyr 的头文件和库。忘了某个命令的选项west help打印通用帮助west help build可以看特定命令的详细帮助。 默认板、版本锁定与自定义命令west config管理工作区级设置。设好默认开发板west config build.board nrf52840dk_nrf52840之后west build samples/basic/hello_world就不用再带-b参数团队里检出同一工作区的人共用同一个默认板少一次复制粘贴出错的机会。版本锁定直接写在 west.yml 里给模块写上 revision取值可以是分支名、标签或提交哈希之后无论west update跑多少次该模块都停在锁定版本projects: - name: hal_stm32 revision: dc7c2543a079c57a4e7dbee54ed7877880dc235b path: modules/hal/stm32团队里有固定的重复操作时还可以写自己的 west 命令在.west/config文件的[west]段里写command-path scripts/west-commands再往scripts/west-commands目录放对应的命令脚本之后就能像内置命令一样从命令行调用。避坑速查三类高频报错west update 时提示缺少 Python 依赖项目所需的 Python 包可以从清单批量装上west packages pip --install构建卡在半路、报错状态怪异先做一次干净构建west build -c还不行的话把整个build/目录删掉再用west build -b board source-dir从头来一遍。子仓库同步冲突、本地死活解不开用west update --reset把所有子仓库重置回 west.yml 锁定的版本。本地未提交的改动会一并丢失动手前先备份。烧录成功后接上串口终端就能看到程序的运行输出了。各命令的完整选项细节可以去官方文档翻一翻doc/develop/getting_started/。【免费下载链接】zephyrPrimary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.项目地址: https://gitcode.com/GitHub_Trending/ze/zephyr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考