02 · west、源码与 SDK
目标：建立固定 Zephyr v4.2.0 的固件开发工作区。以下命令只在新工作区首次执行；已经存在 .west 时，不要再次初始化。
创建独立 Python 环境
mkdir -p ~/Projects/zephyr-workspace
python3 -m venv ~/Projects/zephyr-workspace/.venv
source ~/Projects/zephyr-workspace/.venv/bin/activate
python -m pip install west
每次开启新终端先执行 source。不要使用 sudo pip。
固定源码版本
west init -m https://github.com/zephyrproject-rtos/zephyr \
--mr v4.2.0 ~/Projects/zephyr-workspace
cd ~/Projects/zephyr-workspace
west update
west zephyr-export
west packages pip --install
west init 建立工作区；west update 拉取清单中指定的模块；west zephyr-export 注册 CMake 包；west packages 安装当前源码需要的 Python 包。网络失败时先排查连接，再重试失败步骤。
安装 SDK 与 ESP32 blobs
cd ~/Projects/zephyr-workspace/zephyr
west sdk install --help
SDK 安装参数以 v4.2.0 工作区中的帮助为准。使用下方命令把 SDK 放进专用目录；下载体积可能较大。
mkdir -p ~/.local/opt
west sdk install --install-base ~/.local/opt
west blobs fetch hal_espressif
Espressif 的 Wi-Fi / Bluetooth 使用二进制 blobs。板卡指南建议在 west update 后获取它们。SDK 和 blobs 都有各自的许可；本仓库不打包这些二进制。
记录当前状态
west --version
git describe --tags --always
west list
west manifest --freeze > ../west-manifest-frozen.yml
最后一个文件放在固件工作区中，用于记录模块修订。git describe 应表明检出的是 v4.2.0。如果 SDK 定位失败，检查实际安装路径及 ZEPHYR_SDK_INSTALL_DIR，并核对是否已运行 SDK 的 setup 注册步骤。
日常重新进入
source ~/Projects/zephyr-workspace/.venv/bin/activate
cd ~/Projects/zephyr-workspace/zephyr
-
west update完整成功，无缺失模块。 - 已记录源码标签、west 和 SDK 版本。
- 已完成 SDK 安装和 blobs 下载。
下一步：确认板卡。
官方来源
基于 Zephyr v4.2.0 官方资料整理的中文学习笔记，非逐字翻译；命令及说明作了学习场景适配。