给 Zephyr RTOS 配一套离线开发环境从拉代码到烧录不断网【免费下载链接】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盘清离线开发要备齐的四类资源内网隔离的工控机房、没有外网的野外作业点网络一断west update拉不到模块、SDK 装不上、pip 下不了包Zephyr 离线开发整条链路就此停摆。正确做法是先在一台能联网的机器上把源码、模块、工具链、Python 依赖四类资源全部落到本地目录再整体搬到目标机手工挂载。目标机此后不再触碰任何在线仓库编译、烧录全在本地闭环。资源名来源说明Zephyr 源码git clone主仓库含 Kconfig 与根 CMakeLists.txt是离线的根west 模块west.yml 列出的 url各 HAL / 子系统依赖逐个手动克隆Zephyr SDK官网对应版本包如zephyr-sdk-0.16.4_linux-x86_64.tar.xzPython 依赖pip download离线生成依 doc/requirements.txt 下载动手前逐项核对硬件与资源清单资源备齐不等于能开工先把磁盘、硬件和四类资源合并成一张清单逐格打钩少一项后面就会卡住。用df -h ~确认剩余空间用目录是否存在判断模块是否克隆完整用SDK_VERSION核对工具链是否匹配。检查项达标要求核对方式☐ 磁盘空间≥ 10 GB源码工具链缓存df -h ~看剩余量☐ 开发板属于 boards/ 收录型号板级支持包目录存在☐ Zephyr 源码已 clone 到本地根目录有west.yml☐ west 模块全部 url 已克隆与west.yml一一对应☐ Zephyr SDK版本与源码同步对照 SDK_VERSION☐ Python 依赖已pip download完成pip_pkgs目录非空把四类资源依次落到本地目录主线分四步走先克隆模块再解 SDK再装依赖最后用ZEPHYR_MODULES挂上构建。每步都替代了west原本的自动行为因此命令要手动敲全。手动克隆 west.yml 里的全部模块west 把每个模块视作独立仓库、由主仓库统一调度离线化后这套关系要手动复刻所以不能只 clone 主仓库就了事。mkdir -p ~/zephyrproject cd ~/zephyrproject git clone https://gitcode.com/GitHub_Trending/ze/zephyr # 提取 west.yml 中全部模块 url逐一克隆进 modules/ grep url west.yml git clone west.yml 中的 url modules/模块名上面先用真实地址拉主仓库再用grep url west.yml列出模块清单并逐个克隆目的是补齐west不联网时无法自动同步的部分。提示模块清单以 west.yml 为准别漏掉带可选标记的条目。解压 Zephyr SDK 并挂上工具链变量把 SDK 解压进固定目录再跑setup.sh生成工具链说明文件为后面 CMake 识别做准备。mkdir -p ~/zephyr_sdk tar xf ~/zephyr_offline/zephyr-sdk-0.16.4_linux-x86_64.tar.xz -C ~/zephyr_sdk ~/zephyr_sdk/setup.sh解压后还要把两个环境变量指过去让构建系统找到本地工具链而不是去网上找。export ZEPHYR_TOOLCHAIN_VARIANTzephyr export ZEPHYR_SDK_INSTALL_DIR~/zephyr_sdk提示写进.bashrc才能跨终端会话保持。离线把 Python 依赖装进虚拟环境单独建一个虚拟环境把依赖关在里面避免污染系统 Python也方便整体搬迁。python3 -m venv ~/zephyrproject/.venv source ~/zephyrproject/.venv/bin/activate pip install --no-index --find-links~/zephyr_offline/pip_pkgs -r doc/requirements.txt其中--no-index的作用是关键它禁止 pip 联网查源只从--find-links指定的本地目录取包从而保证装包过程完全离线。提示依赖清单以 doc/requirements.txt 为唯一依据。用 ZEPHYR_MODULES 代替 west 跑构建模块挂好后把路径用ZEPHYR_MODULES手工喂给 CMake省掉 west 的自动发现逻辑再直接驱动 ninja。cmake -Bbuild -S. -DZEPHYR_MODULES~/zephyrproject/modules/module1;~/zephyrproject/modules/module2 ninja -C build提示更多细节见 doc/develop/west/without-west.rst。编译最小示例并烧进开发板验证工具链通了就编译一个最小应用验证端到端链路先选不需要实板的qemu_x86出 elf再换实板烧录确认能跑。cd ~/zephyrproject/zephyr mkdir -p build cd build cmake -DBOARDqemu_x86 -DZEPHYR_MODULES../modules .. make -j$(nproc)选qemu_x86是因为它无需硬件即可产出zephyr/zephyr.elf用来确认工具链与模块配置无误。elf 生成后接上 J-Link 手动烧录以nrf52840dk为例。JLinkExe -device nrf52840_xxaa -if swd -speed 4000 -autoconnect 1 loadbin build/zephyr/zephyr.bin 0x0 r q提示支持的工具与参数见 doc/develop/flash_debug/host-tools.rst。按现象快速定位三类常见故障离线环境出错基本集中在版本与依赖两处对照现象直接执行对应命令即可不用逐行翻日志。现象原因解决命令编译报module version mismatch本地模块与 west.yml 的revision不一致按revision字段执行git checkout commit新架构 SDK 编不过旧版 SDK 不支持该架构对照 SDK_VERSION 换成同步版本pip装包冲突依赖版本互相制约pip check定位再pip install --force-reinstall指定版本维护离线环境并找到进阶入口环境跑通后要低成本维持建议把三件小事固化下来每月重跑一次grep url west.yml刷新模块镜像依赖包按 doc/requirements.txt 分目录归档便于回溯版本给常用开发板各写一份编译脚本减少重复敲参。想深入配置细节从 Kconfig 的离线选项与根 CMakeLists.txt 的构建逻辑读起图形化配置界面可作参照已在 Ubuntu 22.04 与 Windows 10 验证其他系统注意路径分隔符与工具链版本差异。【免费下载链接】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），仅供参考