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如果你需要在无外网访问的机器上编译 Zephyr RTOS 应用这篇文章给出了一条可落地的路径提前把源码、模块仓库、SDK 与 Python 依赖搬到本地再绕过west update手动指定构建参数。读完并照做后你的内网机器应能完成离线构建产出zephyr.elf等固件文件并可通过手动烧录方式验证到板。什么时候需要离线环境以下三种情况比较典型临时断网出差、高铁、展会现场机器只能用蜂窝热点甚至没有网络但需要继续改代码、出固件。内网隔离产线调试机、安全域内的开发机按制度不允许访问公网west update、SDK 在线下载、pip 拉包都会被防火墙拦截。弱网/限流环境网络能通但极慢或不稳定大仓库反复克隆、断点续传失败提前准备本地镜像反而更省事。需要说明一点离线依赖的是提前准备好的本地资源包并不是机器本身不依赖任何外部资源。资源准备阶段克隆仓库、下载 SDK 和 pip 包通常仍需要一台能联网的机器完成。离线资源怎么备清单与数量资源来源与获取方式存放位置示例Zephyr 主仓库源码联网机器上克隆后整库搬运或git clone后做本地裸库~/zephyrproject/zephyrwest 模块源码对照 west.yml 中projects列表逐个克隆目录名用每项的path字段~/zephyrproject/modules/...、~/zephyrproject/bootloader/...等Zephyr SDK 安装包从 Zephyr SDK 官方渠道下载与源码版本匹配的zephyr-sdk-*.tar.xz当前仓库 SDK_VERSION 标注为1.0.1选型时以该文件为准~/zephyr_offline/Python 离线依赖包联网机器执行pip download生成 wheel 集合清单参考 doc/requirements.txt文档构建与部分工具链依赖~/zephyr_offline/pip_pkgs/构建工具CMake、Ninja或 Make、git 本体以及west可选系统目录烧录/调试工具如 J-Link 驱动与JLinkExe、OpenOCD 等按目标板选择列表见 doc/develop/flash_debug/host-tools.rst系统目录或~/zephyr_offline/tools/准备模块仓库时west.yml 是唯一权威清单。每一项包含name仓库名、path在工程内应放置的目录和revision应检出的提交号。建议直接用脚本提取避免手工抄漏# 在联网机器上输出模块清单示例grep 快速浏览 grep -E name:|path:|revision: west.yml | head -50克隆时的对应关系是git clone 仓库地址 path字段值然后进入该目录git checkout revision字段值。主仓库可以从官方镜像获取例如git clone https://gitcode.com/GitHub_Trending/ze/zephyr环境装配路线目录、SDK、依赖、构建参数按目录结构 → SDK 落盘 → Python 依赖 → 构建参数四步走每一步都有明确的完成标志。1. 目录结构落位在目标机器上先搭好骨架以~/zephyrproject为工作区mkdir -p ~/zephyrproject cd ~/zephyrproject cp -r /path/to/local/zephyr . # 主仓库放到 zephyrproject/zephyr mkdir -p modules/hal modules/lib bootloader tools # 按 west.yml 的 path 字段把各模块仓库复制到对应子目录完成后执行find . -maxdepth 2 -type d应能看到zephyr、modules/hal/nordic之类的目录。目录名与west.yml的path不一致是后续找不到模块问题的最常见来源。2. Zephyr SDK 离线落盘把提前下载好的 SDK 压缩包拷到目标机器后解压、执行其自带的安装脚本mkdir -p ~/zephyr_sdk tar xf ~/zephyr_offline/zephyr-sdk-*.tar.xz -C ~/zephyr_sdk cd ~/zephyr_sdk ./setup.sh # 脚本会把工具链放到对应版本子目录脚本执行完成后用ls ~/zephyr_sdk确认出现带版本号名的 SDK 目录。然后配置环境变量让 CMake 使用 SDK 自带的交叉工具链# 仅当前会话生效 export ZEPHYR_TOOLCHAIN_VARIANTzephyr export ZEPHYR_SDK_INSTALL_DIR$HOME/zephyr_sdk/实际SDK目录需要长期生效时把上面两行追加到~/.bashrczsh 用户改为~/.zshrc再source一下。执行which zephyr-env.sh能找到文件说明路径配置正确。3. Python 依赖离线安装如果只用 CMake 直接构建见下文Python 依赖并不是硬门槛但若你还要用 west 命令或构建文档就需要离线安装。在联网机器上先拉包pip download -r doc/requirements.txt -d ~/zephyr_offline/pip_pkgs再在目标机器建虚拟环境只从本地目录安装python3 -m venv ~/zephyrproject/.venv source ~/zephyrproject/.venv/bin/activate pip install --no-index --find-links$HOME/zephyr_offline/pip_pkgs \ -r ~/zephyrproject/zephyr/doc/requirements.txt--no-index的作用就是禁止访问 PyPI。执行结束应看到一系列Successfully installed ...若报No matching distribution found说明离线包里缺对应平台/版本的 wheel需要回到联网机器补齐。west 自身的依赖以它仓库内的 requirements 清单为准离线包中一并包含即可。4. 模块路径替换方案不依赖 west 的构建参数官方对不使用 west 构建的说明见 doc/develop/west/without-west.rst。核心思路是west build平时会自动把模块目录汇总进ZEPHYR_MODULES变量现在改为手动传cd ~/zephyrproject cmake -B build \ -S /path/to/your_app \ -DBOARDnrf52840dk/nrf52840 \ -DZEPHYR_MODULES$HOME/zephyrproject/modules/hal/nordic;$HOME/zephyrproject/modules/lib/picolibc ninja -C build两个注意点ZEPHYR_MODULES用分号分隔多个路径bash 中建议整体加引号或用$展开变量列表按你的应用实际用到的模块裁剪hal_*、picolibc、mbedtls等是最常见的几类具体以 Kconfig 提示和构建报错为准。最小构建验证用 qemu_x86 或 hello_world 打通链路环境是否可用用一个最小样例来验证最直接。仓库自带 samples/hello_world/配合qemu_x86板可以完全在软件上跑通不依赖实体开发板cd ~/zephyrproject cmake -B build_qemu \ -S ~/zephyrproject/zephyr/samples/hello_world \ -DBOARDqemu_x86 ninja -C build_qemuhello_world 用到的内核与库都在主仓库内多数情况下不需要额外模块路径即可编过若报错提示缺少某个模块再按前面第 4 小节的办法补充ZEPHYR_MODULES。成功判断标准构建结束无FAILED且build_qemu/zephyr/下生成了zephyr.elf、zephyr.bin等产物。随后可选跑一次 QEMU 确认程序能打印输出。这一步通了说明源码 模块 工具链 构建参数四件套在离线状态下是齐的再换成真实板子目标-DBOARD...做正式构建即可。烧录与边界说明验证到实体板上手动烧录是最通用的方式。下面以 nRF52840 系列开发板 J-Link 为例命令为可直接执行的示例JLinkExe -device nrf52840_xxaa -if swd -speed 4000 -autoconnect 1 # 进入交互提示符后依次输入 # loadbin build/zephyr/zephyr.bin 0x0 # r # q不同开发板需要替换三处参数否则可能连接失败或烧录错位参数说明取值参考-device芯片型号以 J-Link 支持的器件列表和板级支持包为准-if接口常见为swd也有jtag、cmin烧录地址loadbin第三参数多数板为0x0带 bootloader 的场景可能偏移具体以开发板文档为准OpenOCD、pyOCD 等工具同理各板支持的工具与参数可在 doc/develop/flash_debug/host-tools.rst 和对应boards/厂商/板子/文档中查到。没有west flash时这些宿主工具就是唯一的烧录入口属于 west 替代方案的一部分。故障定位构建失败先查这里现象可能原因检查方法处理方向报找不到模块或ZEPHYR_MODULES路径无效模块目录名与west.yml的path不一致分号被 shell 吞掉ls ~/zephyrproject/modules/hal对照清单echo $ZEPHYR_MODULES看实际值按path字段重命名目录给整个变量加引号模块在但内容不对编译报错像接口不匹配检出的revision与主仓库要求不符在模块目录执行git log -1与 west.yml 中该行revision比对git checkout revision到指定提交提示未找到工具链 /zephyr-env.shSDK 环境变量没设或指向了不存在的目录echo $ZEPHYR_SDK_INSTALL_DIR并ls该路径修正ZEPHYR_SDK_INSTALL_DIR指向实际 SDK 目录确认ZEPHYR_TOOLCHAIN_VARIANTzephyrpip 报No matching distribution离线包缺该平台/Python 版本的 wheel或平台轮子如 macOS 与 Linux 互用看报错中的包名与平台标签比对~/zephyr_offline/pip_pkgs内容在相同操作系统和 Python 版本的联网机器重新pip downloadCMake 阶段报板子不支持BOARD名拼写错误或该板不在此版本支持列表在boards/下查目录名核对厂商目录层级改成正确的厂商/板子形式烧录时Failed to connect设备型号、接口、速度参数与实物不符换-speed 500、确认-if类型换线换口排除硬件问题按烧录与边界说明一节的表格逐项替换排查顺序建议从下往上走先确认 CMake 配置阶段能否找到 SDK 和模块再看编译最后才是链接与烧录。资产维护建议离线环境建好之后还要能长期用下去本地镜像定期更新约定每月或每次主仓库升级时在联网机器上对各仓库git fetch把主仓库与模块仓库一起打包搬运。主仓库每次更新后west.yml 中的revision都会变模块仓库必须跟着重新git checkout否则就是清单里的版本不匹配问题。依赖版本化管理pip_pkgs目录按用途分子目录存放并记录每次打包对应的 requirements 清单和日期换 Python 小版本前先确认离线包是否覆盖。备份策略源码、SDK、pip 包分三份存放例如# 源码备份排除 .git 可显著减小体积需要保留历史就去掉 --exclude tar czf zephyr_src_$(date %Y%m%d).tar.gz --exclude.git -C ~ zephyrproject # SDK 与依赖包同步到外部磁盘 rsync -av ~/zephyr_sdk ~/zephyr_offline /path/to/external/drive/记录环境快照把主仓库提交号、SDK 版本对照 SDK_VERSION、各模块 revision 写成一份简短笔记放在工作区换机器复现环境时能一次对齐。下一步当离线链路稳定后可以顺着 doc/develop/west/without-west.rst 理解手动构建的完整语义再结合 samples/hello_world/ 的prj.conf学习 Kconfig 如何驱动构建。Windows 或不同工具链版本的机器上路径分隔符与环境变量写法会有差异命令执行前先按当前系统习惯做一次小范围验证。祝编译顺利。【免费下载链接】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），仅供参考