尧图网页设计 
Zephyr开发环境搭建完整指南Windows Docker容器westVSCode快速上手【免费下载链接】zephyr-cnzephyr-cn is a collection of original work of SIG-Zephyr项目地址: https://gitcode.com/openeuler/zephyr-cn如果你想在Windows上搭建Zephyr RTOS开发环境又不想在宿主机里手动装齐工具链zephyr-cn项目给出的Docker容器化路线值得优先考虑拉取zephyr-build镜像把本地目录挂进容器west update补齐依赖即可在容器里完成编译、仿真与调试。下文按备材料→改设置→起容器→跑示例→接编辑器→排障的顺序展开每一步都附成功标志方便你随时自查进度。为什么Windows上更适合用容器跑ZephyrZephyr的构建体系由west、CMake与Python工具组成配套的Zephyr SDK也是以Linux安装脚本形式发布的直接在Windows宿主机铺设环境步骤多、失败点分散。容器方案把这件事简化成一台开箱即用的Linux开发机编译器、west命令、SDK依赖全部封装在zephyrprojectrtos/zephyr-build镜像里宿主机只负责存放代码和运行Docker Desktop比传统虚拟机更轻删除容器即可还原现场。先看懂这张分层图后面调试时心里有数你的Application位于OS Services线程、存储、网络等之上再往下是kernel的调度与电源管理最底层对接具体硬件Platform。在qemu_cortex_m3这类虚拟板上验证应用就是绕开真实硬件、直接驱动上层代码的方式。备齐四样材料再动手离线包、SDK和两个软件开工前把下面这些文件与软件准备好项目文档的准备阶段列出了版本与获取入口可对照文件名核对材料版本 / 用途sig_zephyr_v2.7.4.tar.gz基于Zephyr LTS 2.7.4、按Zephyr工程布局打包的离线工作区zephyr-sdk-0.13.1-linux-x86_64-setup.runZephyr SDK安装脚本含编译器、调试器等工具链Windows Terminal命令输入入口Docker Desktop V4.18.0容器运行时需启用WSL2 建议先把两个大文件复制到你准备挂载的本地目录如D:\Workspace\SIG_Zephyr容器阶段就不需要再传文件了。Docker Desktop先改两处镜像落盘位置与国内镜像源⚠️ zephyr-build镜像约12GB若保留默认的C盘存放位置系统盘很快会被占满。镜像位置在Docker Desktop的Settings中进入Resources打开Advanced面板把Disk image location改到其他盘符。镜像源默认源在国内访问不稳定在Docker的JSON配置文件中加入国内镜像源{ registry-mirrors: [ https://registry.docker-cn.com, https://mirror.aliyuncs.com ] }两项设置都保存后重启Docker Desktop生效效果可以在下一步的拉取速度上直观确认。一条命令拉取zephyr-build镜像打开Windows Terminal执行命令获取官方构建镜像docker pull zephyrprojectrtos/zephyr-build:latest当所有层都显示Pull complete、终端打印Digest行说明拉取完成。再用docker images复核一遍仓库名应为zephyrprojectrtos/zephyr-buildTAG为latestSIZE约12GB。启动容器并把Windows目录映射进/workdir这一步的关键是把Windows上的目录映射到容器的/workdir让宿主机编辑的文件能在容器内直接操作作用类似Linux服务器与Windows之间的共享目录docker run -it --name SIG_Zephyr -v /d/Workspace/SIG_Zephyr:/workdir zephyrprojectrtos/zephyr-build:latest以D:\Workspace\SIG_Zephyr为例D盘在Docker Desktop中写作/d/。成功标志提示符变成user容器ID:/workdir$这类Linux用户格式说明你已经进入容器。容器内三步还原工作区解压、west update、装SDK第1步确认文件可见。离线包与SDK脚本此前已放入D:\Workspace\SIG_Zephyr在容器里执行ls应看到sig_zephyr_v2.7.4.tar.gz和zephyr-sdk-0.13.1-linux-x86_64-setup.run两个文件。第2步解压并核对结构。tar -xvzf sig_zephyr_v2.7.4.tar.gz成功后ls -a会多出.west、zephyr、modules、bootloader、tools五个目录——它们合起来就是一个完整的Zephyr工作区。.west里已记录清单配置因此无需再执行west init。第3步同步依赖并安装SDK。west update chmod x zephyr-sdk-0.13.1-linux-x86_64-setup.run ./zephyr-sdk-0.13.1-linux-x86_64-setup.runwest update会按清单文件逐一核对工作区内的Git仓库此步可以跳过但它是验证工程布局是否完整的最直接手段。SDK安装脚本参照官方Getting Started Guide的Install a Toolchain章节执行即可安装包已在手其中的下载步骤可跳过。用philosophers示例验证环境是否可用配置全部就绪后用官方示例做一次端到端验证。先进入zephyr目录指定QEMU虚拟板进行构建cd zephyr west build -p auto -b qemu_cortex_m3 samples/philosophers成功标志输出末尾出现Linking C executable zephyr/zephyr.elf随后打印FLASH、IDT_LIST等内存区域占用统计说明可执行文件已生成。接着启动QEMU仿真器运行west build -t run看到终端中几位哲学家按不同优先级如[P: 3]、[C: -2]交替打印THINKING、EATING、HOLDING ONE FORK说明环境已完全打通——这个示例本质上是在演示可抢占/协作线程、动态互斥锁与线程睡眠。停止方式CtrlC可中断例程若想直接退出QEMU按屏幕提示按CTRLA再按X。West工作区机制west update背后在做什么长期维护这个工作区需要理解四个概念顶级目录容纳整个项目的根目录本方案中即/workdir。west从当前目录向上搜索.west目录来定位它搜索失败时退回ZEPHYR_BASE环境变量指向的位置。清单仓库包含west.yml清单文件的Git仓库对上游Zephyr而言就是zephyr仓库。清单文件YAML格式列出west需要在工作区维护的Git仓库及各自签出的修订版本。项目被west管理的每个Git仓库如modules/lib/zcbor、net-tools构建系统依赖west来定位它们的位置。高频命令按使用场景排列west build -b board app路径构建应用west build -t run仿真运行west build -t debug调试。注意west build属于Zephyr仓库提供的拓展命令west核心本身只负责init、update这类工作区操作。VSCode接入workspace模板、IntelliSense与构建调试任务Zephyr构建系统的本体是westcmake命令行VSCode只是叠加在其上的皮但代码浏览与调试的效率提升明显。先安装推荐插件组C/CIntelliSense与调试CMake构建脚本语言支持kconfig配置项高亮nRF DeviceTreeZephyr设备树支持Arm AssemblyARM汇编高亮工作区布局。推荐multi-root workspace并把build目录与源码树分开存放避免构建产物污染git仓库zephyr_workspace ├── zephyr # Zephyr OS源码 ├── modules # Zephyr模块按需添加 ├── app # 自定义应用 └── build # 构建输出目录项目在vscode/zephyr.code-workspace提供了现成的workspace模板核心内容如下{ folders: [ { path: zephyr }, { path: build }, { path: modules/lib/open-amp }, { path: modules/hal/libmetal } ], settings: { C_Cpp.default.compileCommands: ${workspaceFolder}/../build/compile_commands.json, C_Cpp.default.cStandard: c99, C_Cpp.default.cppStandard: c11 } }IntelliSense依赖compile_commands.json。Zephyr代码规模大插件默认配置无法支撑准确索引必须把compileCommands指向构建生成的compile_commands.json。该文件由CMake配置阶段产出且只覆盖本次构建涉及的文件——例如未启用网络功能时subsys/net下的代码不会被索引。若缺少该文件可在build目录下先执行cmake -DBOARDtarget board path-to-zephyr-application构建与调试任务。在build/.vscode/下创建tasks.json把west build、menuconfig、clean等封装成VSCode任务即可从Run Task面板一键触发编译在同目录的launch.json中配置gdb启动参数就能在VSCode里用图形化方式打断点、单步、查看变量。三个高频卡点west命令丢失、容器重启、QEMU退出west命令找不到。通常是没有加载Zephyr的shell环境先执行source zephyr/zephyr-env.sh容器退出或停止后如何回来。容器内输入exit只是脱离容器不会删除数据文件还在宿主机挂载目录里。恢复用这两条命令docker start SIG_Zephyr docker attach SIG_Zephyr想在VSCode里直接操作容器。安装Docker扩展在扩展面板找到运行中的SIG_Zephyr选择Attach to Container即可在VSCode中直接编辑容器内文件。继续深入文档入口与资料路径doc/source/develop/windows_docker.rstDocker方案的原始文档含准备清单与完整命令doc/source/develop/vscode.rstVSCode开发、构建任务与调试细节doc/source/develop/west/basic.rst、doc/source/develop/west/install.rstwest概念、安装与shell补全doc/source/develop/kernel/线程同步、消息传递、轮询等内核概念章节doc/source/develop/subsys/logging、shell、storageNVS/flash等子系统使用如需获取项目全部资源文档、示例与社区资料可克隆资源仓库git clone https://gitcode.com/openeuler/zephyr-cn【免费下载链接】zephyr-cnzephyr-cn is a collection of original work of SIG-Zephyr项目地址: https://gitcode.com/openeuler/zephyr-cn创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Zephyr开发环境搭建完整指南：Windows Docker容器+west+VSCode快速上手
Zephyr开发环境搭建完整指南Windows Docker容器westVSCode快速上手【免费下载链接】zephyr-cnzephyr-cn is a collection of original work of SIG-Zephyr项目地址: https://gitcode.com/openeuler/zephyr-cn如果你想在Windows上搭建Zephyr RTOS开发环境又不想在宿主机里手动装齐工具链zephyr-cn项目给出的Docker容器化路线值得优先考虑拉取zephyr-build镜像把本地目录挂进容器west update补齐依赖即可在容器里完成编译、仿真与调试。下文按备材料→改设置→起容器→跑示例→接编辑器→排障的顺序展开每一步都附成功标志方便你随时自查进度。为什么Windows上更适合用容器跑ZephyrZephyr的构建体系由west、CMake与Python工具组成配套的Zephyr SDK也是以Linux安装脚本形式发布的直接在Windows宿主机铺设环境步骤多、失败点分散。容器方案把这件事简化成一台开箱即用的Linux开发机编译器、west命令、SDK依赖全部封装在zephyrprojectrtos/zephyr-build镜像里宿主机只负责存放代码和运行Docker Desktop比传统虚拟机更轻删除容器即可还原现场。先看懂这张分层图后面调试时心里有数你的Application位于OS Services线程、存储、网络等之上再往下是kernel的调度与电源管理最底层对接具体硬件Platform。在qemu_cortex_m3这类虚拟板上验证应用就是绕开真实硬件、直接驱动上层代码的方式。备齐四样材料再动手离线包、SDK和两个软件开工前把下面这些文件与软件准备好项目文档的准备阶段列出了版本与获取入口可对照文件名核对材料版本 / 用途sig_zephyr_v2.7.4.tar.gz基于Zephyr LTS 2.7.4、按Zephyr工程布局打包的离线工作区zephyr-sdk-0.13.1-linux-x86_64-setup.runZephyr SDK安装脚本含编译器、调试器等工具链Windows Terminal命令输入入口Docker Desktop V4.18.0容器运行时需启用WSL2 建议先把两个大文件复制到你准备挂载的本地目录如D:\Workspace\SIG_Zephyr容器阶段就不需要再传文件了。Docker Desktop先改两处镜像落盘位置与国内镜像源⚠️ zephyr-build镜像约12GB若保留默认的C盘存放位置系统盘很快会被占满。镜像位置在Docker Desktop的Settings中进入Resources打开Advanced面板把Disk image location改到其他盘符。镜像源默认源在国内访问不稳定在Docker的JSON配置文件中加入国内镜像源{ registry-mirrors: [ https://registry.docker-cn.com, https://mirror.aliyuncs.com ] }两项设置都保存后重启Docker Desktop生效效果可以在下一步的拉取速度上直观确认。一条命令拉取zephyr-build镜像打开Windows Terminal执行命令获取官方构建镜像docker pull zephyrprojectrtos/zephyr-build:latest当所有层都显示Pull complete、终端打印Digest行说明拉取完成。再用docker images复核一遍仓库名应为zephyrprojectrtos/zephyr-buildTAG为latestSIZE约12GB。启动容器并把Windows目录映射进/workdir这一步的关键是把Windows上的目录映射到容器的/workdir让宿主机编辑的文件能在容器内直接操作作用类似Linux服务器与Windows之间的共享目录docker run -it --name SIG_Zephyr -v /d/Workspace/SIG_Zephyr:/workdir zephyrprojectrtos/zephyr-build:latest以D:\Workspace\SIG_Zephyr为例D盘在Docker Desktop中写作/d/。成功标志提示符变成user容器ID:/workdir$这类Linux用户格式说明你已经进入容器。容器内三步还原工作区解压、west update、装SDK第1步确认文件可见。离线包与SDK脚本此前已放入D:\Workspace\SIG_Zephyr在容器里执行ls应看到sig_zephyr_v2.7.4.tar.gz和zephyr-sdk-0.13.1-linux-x86_64-setup.run两个文件。第2步解压并核对结构。tar -xvzf sig_zephyr_v2.7.4.tar.gz成功后ls -a会多出.west、zephyr、modules、bootloader、tools五个目录——它们合起来就是一个完整的Zephyr工作区。.west里已记录清单配置因此无需再执行west init。第3步同步依赖并安装SDK。west update chmod x zephyr-sdk-0.13.1-linux-x86_64-setup.run ./zephyr-sdk-0.13.1-linux-x86_64-setup.runwest update会按清单文件逐一核对工作区内的Git仓库此步可以跳过但它是验证工程布局是否完整的最直接手段。SDK安装脚本参照官方Getting Started Guide的Install a Toolchain章节执行即可安装包已在手其中的下载步骤可跳过。用philosophers示例验证环境是否可用配置全部就绪后用官方示例做一次端到端验证。先进入zephyr目录指定QEMU虚拟板进行构建cd zephyr west build -p auto -b qemu_cortex_m3 samples/philosophers成功标志输出末尾出现Linking C executable zephyr/zephyr.elf随后打印FLASH、IDT_LIST等内存区域占用统计说明可执行文件已生成。接着启动QEMU仿真器运行west build -t run看到终端中几位哲学家按不同优先级如[P: 3]、[C: -2]交替打印THINKING、EATING、HOLDING ONE FORK说明环境已完全打通——这个示例本质上是在演示可抢占/协作线程、动态互斥锁与线程睡眠。停止方式CtrlC可中断例程若想直接退出QEMU按屏幕提示按CTRLA再按X。West工作区机制west update背后在做什么长期维护这个工作区需要理解四个概念顶级目录容纳整个项目的根目录本方案中即/workdir。west从当前目录向上搜索.west目录来定位它搜索失败时退回ZEPHYR_BASE环境变量指向的位置。清单仓库包含west.yml清单文件的Git仓库对上游Zephyr而言就是zephyr仓库。清单文件YAML格式列出west需要在工作区维护的Git仓库及各自签出的修订版本。项目被west管理的每个Git仓库如modules/lib/zcbor、net-tools构建系统依赖west来定位它们的位置。高频命令按使用场景排列west build -b board app路径构建应用west build -t run仿真运行west build -t debug调试。注意west build属于Zephyr仓库提供的拓展命令west核心本身只负责init、update这类工作区操作。VSCode接入workspace模板、IntelliSense与构建调试任务Zephyr构建系统的本体是westcmake命令行VSCode只是叠加在其上的皮但代码浏览与调试的效率提升明显。先安装推荐插件组C/CIntelliSense与调试CMake构建脚本语言支持kconfig配置项高亮nRF DeviceTreeZephyr设备树支持Arm AssemblyARM汇编高亮工作区布局。推荐multi-root workspace并把build目录与源码树分开存放避免构建产物污染git仓库zephyr_workspace ├── zephyr # Zephyr OS源码 ├── modules # Zephyr模块按需添加 ├── app # 自定义应用 └── build # 构建输出目录项目在vscode/zephyr.code-workspace提供了现成的workspace模板核心内容如下{ folders: [ { path: zephyr }, { path: build }, { path: modules/lib/open-amp }, { path: modules/hal/libmetal } ], settings: { C_Cpp.default.compileCommands: ${workspaceFolder}/../build/compile_commands.json, C_Cpp.default.cStandard: c99, C_Cpp.default.cppStandard: c11 } }IntelliSense依赖compile_commands.json。Zephyr代码规模大插件默认配置无法支撑准确索引必须把compileCommands指向构建生成的compile_commands.json。该文件由CMake配置阶段产出且只覆盖本次构建涉及的文件——例如未启用网络功能时subsys/net下的代码不会被索引。若缺少该文件可在build目录下先执行cmake -DBOARDtarget board path-to-zephyr-application构建与调试任务。在build/.vscode/下创建tasks.json把west build、menuconfig、clean等封装成VSCode任务即可从Run Task面板一键触发编译在同目录的launch.json中配置gdb启动参数就能在VSCode里用图形化方式打断点、单步、查看变量。三个高频卡点west命令丢失、容器重启、QEMU退出west命令找不到。通常是没有加载Zephyr的shell环境先执行source zephyr/zephyr-env.sh容器退出或停止后如何回来。容器内输入exit只是脱离容器不会删除数据文件还在宿主机挂载目录里。恢复用这两条命令docker start SIG_Zephyr docker attach SIG_Zephyr想在VSCode里直接操作容器。安装Docker扩展在扩展面板找到运行中的SIG_Zephyr选择Attach to Container即可在VSCode中直接编辑容器内文件。继续深入文档入口与资料路径doc/source/develop/windows_docker.rstDocker方案的原始文档含准备清单与完整命令doc/source/develop/vscode.rstVSCode开发、构建任务与调试细节doc/source/develop/west/basic.rst、doc/source/develop/west/install.rstwest概念、安装与shell补全doc/source/develop/kernel/线程同步、消息传递、轮询等内核概念章节doc/source/develop/subsys/logging、shell、storageNVS/flash等子系统使用如需获取项目全部资源文档、示例与社区资料可克隆资源仓库git clone https://gitcode.com/openeuler/zephyr-cn【免费下载链接】zephyr-cnzephyr-cn is a collection of original work of SIG-Zephyr项目地址: https://gitcode.com/openeuler/zephyr-cn创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考