Zephyr west 上手指南：从零安装到 10 分钟烧录 hello_world

Zephyr west 上手指南从零安装到 10 分钟烧录 hello_world【免费下载链接】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手拿一块 Nordic nrf52840 开发板任务是把 hello_world 示例固件烧上去让串口打出 Hello World!。Zephyr 的构建系统依赖一个叫 west 的命令行工具它负责同步 Zephyr 的多仓库源码、封装 CMake 构建固件再执行烧录和调试。读完这篇指南你能从零完成 west 安装到 hello_world 烧录的全流程并独立处理常见报错。west 在 Zephyr 开发流程中的位置Zephyr 源码不是一个仓库主仓库 zephyr 只含内核、驱动和子系统HAL、中间件等各自独立成仓如 hal_stm32、mbedtls加起来上百个。west 就是统一管理这些仓库的工具它读取 west.yml 知道要拉哪些仓库、放在哪个目录同时提供 build、flash、debug 等子命令。可以把它理解为 Zephyr 构建系统对外的唯一入口。上图是 manifest 仓库zephyr与各子仓库的关系west.yml 里每个项目都被固定到某个提交west update负责让本地工作区与这份清单对齐。十分钟跑通第一个固件 以下命令按顺序执行即可。以 Ubuntu 为例。1. 安装系统依赖sudo apt install --no-install-recommends git cmake ninja-build gperf \ ccache dfu-util device-tree-compiler wget python3-dev python3-venv \ xz-utils file make gcc g装的是 west 和编译链依赖cmake、ninja、设备树编译器 dtc、交叉编译用的 gcc 等。2. west 安装放进虚拟环境mkdir -p ~/workspace cd ~/workspace python3 -m venv .venv source .venv/bin/activate pip install west在工作区建一个 Python 虚拟环境并把 west 装进去避免和系统 Python 的包互相干扰。3. 初始化工作区west init -m https://gitcode.com/GitHub_Trending/ze/zephyr zephyrproject cd zephyrproject把 zephyr 主仓库克隆到zephyrproject/zephyr并生成.west/配置目录。4. 同步模块仓库west update按 west.yml 声明把每个项目克隆到指定目录、检出固定提交。跑完可以用west list查看工作区里所有项目及路径。5. 构建 hello_worldcd zephyr west build -b nrf52840dk_nrf52840 -p always -d build samples/hello_world注意在zephyr/目录下执行示例路径相对它。参数含义-b nrf52840dk_nrf52840目标开发板-p always重新生成构建系统不复用旧缓存-d build构建目录产物在build/zephyr/下zephyr.elf、zephyr.hex、zephyr.bin。6. 烧录固件west flashwest 根据开发板自动选择烧录方式把构建目录里的 hex 写进板子。五个高频场景实战日常开发反复用到的场景每个一节一行命令。切换开发板west boards列出当前支持的所有开发板。换板后换个-b和构建目录重新构建即可west build -b feather_nrf52840_express -p always -d build-feather samples/hello_world也可以设置默认板之后 west build 可省略-bwest config build.board nrf52840dk_nrf52840用 west.yml 的 revision 锁定模块版本west.yml 中每个项目都带revision字段可以是分支、标签或提交哈希。要固定某个模块的版本改对应条目- name: hal_stm32 revision: dc7c2543a079c57a4e7dbee54ed7877880dc235b path: modules/hal/stm32然后west update hal_stm32只把这一个模块同步到指定提交。menuconfig 图形化改参数west build -b nrf52840dk_nrf52840 samples/hello_world -t menuconfig打开终端菜单界面方向键导航、回车选择。保存后 Kconfig 参数写入构建目录再跑一次 west build 生效。--runner 指定烧录器west flash --runner jlinkwest 烧录固件时默认按开发板自动猜工具--runner可以显式指定jlink、pyocd、openocd、uf2 等。west debug 接入调试west debug -r jlink在构建目录下运行west 会启动 gdb 连接zephyr.elf并通过 J-Link 接上板子可以直接断点、单步。出问题怎么办排障速查 现象可能原因一条命令解法west: command not found虚拟环境没激活或 west 未装source .venv/bin/activate pip install westwest update中断、部分仓库缺失网络不稳或克隆被中断west update --only-missing只补缺失项目CMake 报 board 找不到-b板子名拼错west boards查正确名称旧缓存导致报错位置离谱构建目录残留过期文件west build -c清理后重新构建west flash找不到设备烧录器未接好或方式猜错west flash --runner jlink --interface serial提示缺少 Python 模块依赖没装全pip install -r scripts/requirements-base.txtwest 是 Zephyr 构建系统的统一入口多仓库同步、构建、烧录、调试都从它出发。想继续深入延伸阅读官方入门文档。【免费下载链接】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），仅供参考