Zephyr SDK 目录结构详解

ScilogyHunter2026-06-14 11:06

Zephyr SDK 1.0.1 目录结构详解：深入探索开发工具链的奥秘

引言

在嵌入式开发领域，理解工具链的目录结构是掌握开发环境的关键一步。作为Zephyr RTOS的官方开发套件，Zephyr SDK 的目录结构设计合理、层次清晰。本文将基于Zephyr SDK 1.0.1的实际目录结构，深入剖析每个目录和文件的作用，帮助开发者全面理解SDK的组织架构。

一、Zephyr SDK 目录概览

1.1 整体结构图

#mermaid-svg-BqKzz6fe8FG4oRTi{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-BqKzz6fe8FG4oRTi .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-BqKzz6fe8FG4oRTi .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-BqKzz6fe8FG4oRTi .error-icon{fill:#552222;}#mermaid-svg-BqKzz6fe8FG4oRTi .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-BqKzz6fe8FG4oRTi .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-BqKzz6fe8FG4oRTi .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-BqKzz6fe8FG4oRTi .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-BqKzz6fe8FG4oRTi .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-BqKzz6fe8FG4oRTi .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-BqKzz6fe8FG4oRTi .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-BqKzz6fe8FG4oRTi .marker{fill:#333333;stroke:#333333;}#mermaid-svg-BqKzz6fe8FG4oRTi .marker.cross{stroke:#333333;}#mermaid-svg-BqKzz6fe8FG4oRTi svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-BqKzz6fe8FG4oRTi p{margin:0;}#mermaid-svg-BqKzz6fe8FG4oRTi .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-BqKzz6fe8FG4oRTi .cluster-label text{fill:#333;}#mermaid-svg-BqKzz6fe8FG4oRTi .cluster-label span{color:#333;}#mermaid-svg-BqKzz6fe8FG4oRTi .cluster-label span p{background-color:transparent;}#mermaid-svg-BqKzz6fe8FG4oRTi .label text,#mermaid-svg-BqKzz6fe8FG4oRTi span{fill:#333;color:#333;}#mermaid-svg-BqKzz6fe8FG4oRTi .node rect,#mermaid-svg-BqKzz6fe8FG4oRTi .node circle,#mermaid-svg-BqKzz6fe8FG4oRTi .node ellipse,#mermaid-svg-BqKzz6fe8FG4oRTi .node polygon,#mermaid-svg-BqKzz6fe8FG4oRTi .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-BqKzz6fe8FG4oRTi .rough-node .label text,#mermaid-svg-BqKzz6fe8FG4oRTi .node .label text,#mermaid-svg-BqKzz6fe8FG4oRTi .image-shape .label,#mermaid-svg-BqKzz6fe8FG4oRTi .icon-shape .label{text-anchor:middle;}#mermaid-svg-BqKzz6fe8FG4oRTi .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-BqKzz6fe8FG4oRTi .rough-node .label,#mermaid-svg-BqKzz6fe8FG4oRTi .node .label,#mermaid-svg-BqKzz6fe8FG4oRTi .image-shape .label,#mermaid-svg-BqKzz6fe8FG4oRTi .icon-shape .label{text-align:center;}#mermaid-svg-BqKzz6fe8FG4oRTi .node.clickable{cursor:pointer;}#mermaid-svg-BqKzz6fe8FG4oRTi .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-BqKzz6fe8FG4oRTi .arrowheadPath{fill:#333333;}#mermaid-svg-BqKzz6fe8FG4oRTi .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-BqKzz6fe8FG4oRTi .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-BqKzz6fe8FG4oRTi .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-BqKzz6fe8FG4oRTi .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-BqKzz6fe8FG4oRTi .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-BqKzz6fe8FG4oRTi .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-BqKzz6fe8FG4oRTi .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-BqKzz6fe8FG4oRTi .cluster text{fill:#333;}#mermaid-svg-BqKzz6fe8FG4oRTi .cluster span{color:#333;}#mermaid-svg-BqKzz6fe8FG4oRTi div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-BqKzz6fe8FG4oRTi .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-BqKzz6fe8FG4oRTi rect.text{fill:none;stroke-width:0;}#mermaid-svg-BqKzz6fe8FG4oRTi .icon-shape,#mermaid-svg-BqKzz6fe8FG4oRTi .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-BqKzz6fe8FG4oRTi .icon-shape p,#mermaid-svg-BqKzz6fe8FG4oRTi .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-BqKzz6fe8FG4oRTi .icon-shape .label rect,#mermaid-svg-BqKzz6fe8FG4oRTi .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-BqKzz6fe8FG4oRTi .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-BqKzz6fe8FG4oRTi .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-BqKzz6fe8FG4oRTi :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} zephyr-sdk-1.0.1/
cmake/
gnu/
hosttools/
sdk_gnu_toolchains
sdk_version
setup.sh
zephyr/
Zephyr-sdkConfig.cmake
Zephyr-sdkConfigVersion.cmake
zephyr_sdk_export.cmake
aarch64-zephyr-elf
arm-zephyr-eabi
riscv64-zephyr-elf
xtensa-*
其他架构...
environment-setup-*
sysroots/
version-*
安装脚本

1.2 根目录清单

目录/文件 类型 说明
cmake/ 目录 CMake配置文件目录
gnu/ 目录 GNU交叉编译工具链目录
hosttools/ 目录 主机工具和环境配置
sdk_gnu_toolchains 文件 工具链配置文件
sdk_version 文件 SDK版本信息文件
setup.sh 文件 SDK安装初始化脚本

二、cmake 目录详解

2.1 目录结构

复制代码 
cmake/
├── zephyr/
├── Zephyr-sdkConfig.cmake
├── Zephyr-sdkConfigVersion.cmake
└── zephyr_sdk_export.cmake

2.2 文件作用详解

文件 作用
zephyr/ Zephyr CMake模块目录
Zephyr-sdkConfig.cmake SDK CMake配置文件
Zephyr-sdkConfigVersion.cmake SDK版本配置文件
zephyr_sdk_export.cmake SDK导出配置文件

2.3 CMake配置文件详解

2.3.1 Zephyr-sdkConfig.cmake

作用：CMake查找SDK时的配置入口

cmake 复制代码 
# Zephyr-sdkConfig.cmake 示例内容
set(ZEPHYR_SDK_INSTALL_DIR "/home/debian0/zephyr-sdk-1.0.1")
set(ZEPHYR_TOOLCHAIN_VARIANT "zephyr")

# 设置工具链路径
set(CMAKE_SYSTEM_NAME Generic)
set(CMAKE_SYSTEM_PROCESSOR arm)
2.3.2 Zephyr-sdkConfigVersion.cmake

作用：版本信息配置

cmake 复制代码 
# Zephyr-sdkConfigVersion.cmake 示例
set(PACKAGE_VERSION "1.0.1")
set(PACKAGE_VERSION_EXACT TRUE)
set(PACKAGE_VERSION_COMPATIBLE TRUE)
2.3.3 zephyr_sdk_export.cmake

作用：导出SDK变量供CMake使用

cmake 复制代码 
# zephyr_sdk_export.cmake 示例
export(ZEPHYR_SDK_INSTALL_DIR)
export(ZEPHYR_TOOLCHAIN_VARIANT)

2.4 CMake与Zephyr构建系统的关系

#mermaid-svg-5mR3rofcmuu6uscT{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-5mR3rofcmuu6uscT .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-5mR3rofcmuu6uscT .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-5mR3rofcmuu6uscT .error-icon{fill:#552222;}#mermaid-svg-5mR3rofcmuu6uscT .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-5mR3rofcmuu6uscT .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-5mR3rofcmuu6uscT .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-5mR3rofcmuu6uscT .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-5mR3rofcmuu6uscT .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-5mR3rofcmuu6uscT .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-5mR3rofcmuu6uscT .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-5mR3rofcmuu6uscT .marker{fill:#333333;stroke:#333333;}#mermaid-svg-5mR3rofcmuu6uscT .marker.cross{stroke:#333333;}#mermaid-svg-5mR3rofcmuu6uscT svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-5mR3rofcmuu6uscT p{margin:0;}#mermaid-svg-5mR3rofcmuu6uscT .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-5mR3rofcmuu6uscT .cluster-label text{fill:#333;}#mermaid-svg-5mR3rofcmuu6uscT .cluster-label span{color:#333;}#mermaid-svg-5mR3rofcmuu6uscT .cluster-label span p{background-color:transparent;}#mermaid-svg-5mR3rofcmuu6uscT .label text,#mermaid-svg-5mR3rofcmuu6uscT span{fill:#333;color:#333;}#mermaid-svg-5mR3rofcmuu6uscT .node rect,#mermaid-svg-5mR3rofcmuu6uscT .node circle,#mermaid-svg-5mR3rofcmuu6uscT .node ellipse,#mermaid-svg-5mR3rofcmuu6uscT .node polygon,#mermaid-svg-5mR3rofcmuu6uscT .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-5mR3rofcmuu6uscT .rough-node .label text,#mermaid-svg-5mR3rofcmuu6uscT .node .label text,#mermaid-svg-5mR3rofcmuu6uscT .image-shape .label,#mermaid-svg-5mR3rofcmuu6uscT .icon-shape .label{text-anchor:middle;}#mermaid-svg-5mR3rofcmuu6uscT .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-5mR3rofcmuu6uscT .rough-node .label,#mermaid-svg-5mR3rofcmuu6uscT .node .label,#mermaid-svg-5mR3rofcmuu6uscT .image-shape .label,#mermaid-svg-5mR3rofcmuu6uscT .icon-shape .label{text-align:center;}#mermaid-svg-5mR3rofcmuu6uscT .node.clickable{cursor:pointer;}#mermaid-svg-5mR3rofcmuu6uscT .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-5mR3rofcmuu6uscT .arrowheadPath{fill:#333333;}#mermaid-svg-5mR3rofcmuu6uscT .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-5mR3rofcmuu6uscT .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-5mR3rofcmuu6uscT .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5mR3rofcmuu6uscT .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-5mR3rofcmuu6uscT .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5mR3rofcmuu6uscT .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-5mR3rofcmuu6uscT .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-5mR3rofcmuu6uscT .cluster text{fill:#333;}#mermaid-svg-5mR3rofcmuu6uscT .cluster span{color:#333;}#mermaid-svg-5mR3rofcmuu6uscT div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-5mR3rofcmuu6uscT .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-5mR3rofcmuu6uscT rect.text{fill:none;stroke-width:0;}#mermaid-svg-5mR3rofcmuu6uscT .icon-shape,#mermaid-svg-5mR3rofcmuu6uscT .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5mR3rofcmuu6uscT .icon-shape p,#mermaid-svg-5mR3rofcmuu6uscT .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-5mR3rofcmuu6uscT .icon-shape .label rect,#mermaid-svg-5mR3rofcmuu6uscT .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5mR3rofcmuu6uscT .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-5mR3rofcmuu6uscT .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-5mR3rofcmuu6uscT :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} west build
CMake
Zephyr-sdkConfig.cmake
加载工具链
gnu/arm-zephyr-eabi
编译项目

三、gnu 目录详解

3.1 目录结构概览

gnu/目录包含了所有架构的GNU交叉编译工具链，是SDK的核心组成部分：

复制代码 
gnu/
├── aarch64-zephyr-elf          # ARM 64位架构
├── arc64-zephyr-elf            # ARC 64位架构
├── arc-zephyr-elf              # ARC架构
├── arm-zephyr-eabi             # ARM Cortex-M架构
├── microblazeel-zephyr-elf     # MicroBlaze架构
├── mips-zephyr-elf             # MIPS架构
├── or1k-zephyr-elf             # OpenRISC架构
├── riscv64-zephyr-elf          # RISC-V 64位架构
├── rx-zephyr-elf               # Renesas RX架构
├── sparc-zephyr-elf            # SPARC架构
├── x86_64-zephyr-elf           # x86 64位架构
├── xtensa-*                    # Xtensa系列架构

3.2 支持的架构分类表

架构类型 工具链名称 典型应用场景
ARM 64位 aarch64-zephyr-elf ARM Cortex-A系列
ARM Cortex-M arm-zephyr-eabi STM32、nRF52等主流MCU
RISC-V riscv64-zephyr-elf RISC-V开源芯片
x86 x86_64-zephyr-elf x86嵌入式设备
ARC arc-zephyr-elf Synopsys ARC处理器
MIPS mips-zephyr-elf MIPS架构芯片
MicroBlaze microblazeel-zephyr-elf Xilinx FPGA软核
SPARC sparc-zephyr-elf SPARC架构处理器
OpenRISC or1k-zephyr-elf OpenRISC开源架构
Renesas RX rx-zephyr-elf Renesas RX系列MCU

3.3 Xtensa架构详解

Xtensa架构是可配置的处理器架构，SDK支持多种Xtensa变体：

Xtensa变体 工具链 应用场景
Intel ADSP xtensa-intel_ace15_mtpm_zephyr-elf Intel音频DSP
Intel ACE xtensa-intel_ace30_ptl_zephyr-elf Intel ACE30
Intel TGL xtensa-intel_tgl_adsp_zephyr-elf Tiger Lake ADSP
Espressif ESP32 xtensa-espressif_esp32_zephyr-elf ESP32芯片
Espressif ESP32S2 xtensa-espressif_esp32s2_zephyr-elf ESP32-S2
Espressif ESP32S3 xtensa-espressif_esp32s3_zephyr-elf ESP32-S3
NXP i.MX ADSP xtensa-nxp_imx8m_adsp_zephyr-elf NXP i.MX8 DSP
NXP RT500/600 xtensa-nxp_rt500_adsp_zephyr-elf NXP RT系列
MTK MT818x xtensa-mtk_mt818x_adsp_zephyr-elf MediaTek ADSP
AMD ACP xtensa-amd_acp_6_0_adsp_zephyr-elf AMD音频协处理器
Sample Controller xtensa-sample_controller_zephyr-elf Xtensa示例控制器

3.4 单个工具链目录结构

每个架构工具链目录（如arm-zephyr-eabi/）包含：
#mermaid-svg-dxA8z8yibezdf9r5{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-dxA8z8yibezdf9r5 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-dxA8z8yibezdf9r5 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-dxA8z8yibezdf9r5 .error-icon{fill:#552222;}#mermaid-svg-dxA8z8yibezdf9r5 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-dxA8z8yibezdf9r5 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-dxA8z8yibezdf9r5 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-dxA8z8yibezdf9r5 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-dxA8z8yibezdf9r5 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-dxA8z8yibezdf9r5 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-dxA8z8yibezdf9r5 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-dxA8z8yibezdf9r5 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-dxA8z8yibezdf9r5 .marker.cross{stroke:#333333;}#mermaid-svg-dxA8z8yibezdf9r5 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-dxA8z8yibezdf9r5 p{margin:0;}#mermaid-svg-dxA8z8yibezdf9r5 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-dxA8z8yibezdf9r5 .cluster-label text{fill:#333;}#mermaid-svg-dxA8z8yibezdf9r5 .cluster-label span{color:#333;}#mermaid-svg-dxA8z8yibezdf9r5 .cluster-label span p{background-color:transparent;}#mermaid-svg-dxA8z8yibezdf9r5 .label text,#mermaid-svg-dxA8z8yibezdf9r5 span{fill:#333;color:#333;}#mermaid-svg-dxA8z8yibezdf9r5 .node rect,#mermaid-svg-dxA8z8yibezdf9r5 .node circle,#mermaid-svg-dxA8z8yibezdf9r5 .node ellipse,#mermaid-svg-dxA8z8yibezdf9r5 .node polygon,#mermaid-svg-dxA8z8yibezdf9r5 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-dxA8z8yibezdf9r5 .rough-node .label text,#mermaid-svg-dxA8z8yibezdf9r5 .node .label text,#mermaid-svg-dxA8z8yibezdf9r5 .image-shape .label,#mermaid-svg-dxA8z8yibezdf9r5 .icon-shape .label{text-anchor:middle;}#mermaid-svg-dxA8z8yibezdf9r5 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-dxA8z8yibezdf9r5 .rough-node .label,#mermaid-svg-dxA8z8yibezdf9r5 .node .label,#mermaid-svg-dxA8z8yibezdf9r5 .image-shape .label,#mermaid-svg-dxA8z8yibezdf9r5 .icon-shape .label{text-align:center;}#mermaid-svg-dxA8z8yibezdf9r5 .node.clickable{cursor:pointer;}#mermaid-svg-dxA8z8yibezdf9r5 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-dxA8z8yibezdf9r5 .arrowheadPath{fill:#333333;}#mermaid-svg-dxA8z8yibezdf9r5 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-dxA8z8yibezdf9r5 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-dxA8z8yibezdf9r5 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-dxA8z8yibezdf9r5 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-dxA8z8yibezdf9r5 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-dxA8z8yibezdf9r5 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-dxA8z8yibezdf9r5 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-dxA8z8yibezdf9r5 .cluster text{fill:#333;}#mermaid-svg-dxA8z8yibezdf9r5 .cluster span{color:#333;}#mermaid-svg-dxA8z8yibezdf9r5 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-dxA8z8yibezdf9r5 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-dxA8z8yibezdf9r5 rect.text{fill:none;stroke-width:0;}#mermaid-svg-dxA8z8yibezdf9r5 .icon-shape,#mermaid-svg-dxA8z8yibezdf9r5 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-dxA8z8yibezdf9r5 .icon-shape p,#mermaid-svg-dxA8z8yibezdf9r5 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-dxA8z8yibezdf9r5 .icon-shape .label rect,#mermaid-svg-dxA8z8yibezdf9r5 .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-dxA8z8yibezdf9r5 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-dxA8z8yibezdf9r5 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-dxA8z8yibezdf9r5 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} arm-zephyr-eabi/
bin/
lib/
include/
libgcc/
arm-zephyr-eabi-gcc
arm-zephyr-eabi-g++
arm-zephyr-eabi-ld
arm-zephyr-eabi-as
arm-zephyr-eabi-gdb
其他工具...
链接库文件
头文件
GCC运行时库

3.5 工具链核心工具列表

工具 功能
*-gcc C编译器
*-g++ C++编译器
*-ld 链接器
*-as 汇编器
*-ar 静态库归档工具
*-nm 符号表查看工具
*-objcopy 目标文件转换工具
*-objdump 反汇编工具
*-readelf ELF文件分析工具
*-gdb GDB调试器
*-strip 符号剥离工具

四、hosttools 目录详解

4.1 目录结构

复制代码 
hosttools/
├── environment-setup-x86_64-pokysdk-linux
├── sysroots/
├── version-x86_64-pokysdk-linux
└── zephyr-sdk-x86_64-hosttools-standalone-0.10.sh

4.2 文件作用详解

文件 作用
environment-setup-x86_64-pokysdk-linux 主机环境配置脚本
sysroots/ 主机系统根文件目录
version-x86_64-pokysdk-linux 主机工具版本信息
zephyr-sdk-x86_64-hosttools-standalone-0.10.sh 主机工具安装脚本

4.3 environment-setup 脚本详解

作用：配置主机开发环境变量

bash 复制代码 
# environment-setup-x86_64-pokysdk-linux 示例内容
export PATH=/home/debian0/zephyr-sdk-1.0.1/hosttools/sysroots/x86_64-pokysdk-linux/usr/bin:$PATH
export CC=x86_64-pokysdk-linux-gcc
export CXX=x86_64-pokysdk-linux-g++
export LD=x86_64-pokysdk-linux-ld

# 设置PKG_CONFIG路径
export PKG_CONFIG_PATH=/home/debian0/zephyr-sdk-1.0.1/hosttools/sysroots/x86_64-pokysdk-linux/usr/lib/pkgconfig

4.4 sysroots 目录详解

sysroots/目录包含主机工具的系统根文件：
#mermaid-svg-KBzJswhqrPPMgfV0{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-KBzJswhqrPPMgfV0 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-KBzJswhqrPPMgfV0 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-KBzJswhqrPPMgfV0 .error-icon{fill:#552222;}#mermaid-svg-KBzJswhqrPPMgfV0 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-KBzJswhqrPPMgfV0 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-KBzJswhqrPPMgfV0 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-KBzJswhqrPPMgfV0 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-KBzJswhqrPPMgfV0 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-KBzJswhqrPPMgfV0 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-KBzJswhqrPPMgfV0 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-KBzJswhqrPPMgfV0 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-KBzJswhqrPPMgfV0 .marker.cross{stroke:#333333;}#mermaid-svg-KBzJswhqrPPMgfV0 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-KBzJswhqrPPMgfV0 p{margin:0;}#mermaid-svg-KBzJswhqrPPMgfV0 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-KBzJswhqrPPMgfV0 .cluster-label text{fill:#333;}#mermaid-svg-KBzJswhqrPPMgfV0 .cluster-label span{color:#333;}#mermaid-svg-KBzJswhqrPPMgfV0 .cluster-label span p{background-color:transparent;}#mermaid-svg-KBzJswhqrPPMgfV0 .label text,#mermaid-svg-KBzJswhqrPPMgfV0 span{fill:#333;color:#333;}#mermaid-svg-KBzJswhqrPPMgfV0 .node rect,#mermaid-svg-KBzJswhqrPPMgfV0 .node circle,#mermaid-svg-KBzJswhqrPPMgfV0 .node ellipse,#mermaid-svg-KBzJswhqrPPMgfV0 .node polygon,#mermaid-svg-KBzJswhqrPPMgfV0 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-KBzJswhqrPPMgfV0 .rough-node .label text,#mermaid-svg-KBzJswhqrPPMgfV0 .node .label text,#mermaid-svg-KBzJswhqrPPMgfV0 .image-shape .label,#mermaid-svg-KBzJswhqrPPMgfV0 .icon-shape .label{text-anchor:middle;}#mermaid-svg-KBzJswhqrPPMgfV0 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-KBzJswhqrPPMgfV0 .rough-node .label,#mermaid-svg-KBzJswhqrPPMgfV0 .node .label,#mermaid-svg-KBzJswhqrPPMgfV0 .image-shape .label,#mermaid-svg-KBzJswhqrPPMgfV0 .icon-shape .label{text-align:center;}#mermaid-svg-KBzJswhqrPPMgfV0 .node.clickable{cursor:pointer;}#mermaid-svg-KBzJswhqrPPMgfV0 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-KBzJswhqrPPMgfV0 .arrowheadPath{fill:#333333;}#mermaid-svg-KBzJswhqrPPMgfV0 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-KBzJswhqrPPMgfV0 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-KBzJswhqrPPMgfV0 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-KBzJswhqrPPMgfV0 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-KBzJswhqrPPMgfV0 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-KBzJswhqrPPMgfV0 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-KBzJswhqrPPMgfV0 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-KBzJswhqrPPMgfV0 .cluster text{fill:#333;}#mermaid-svg-KBzJswhqrPPMgfV0 .cluster span{color:#333;}#mermaid-svg-KBzJswhqrPPMgfV0 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-KBzJswhqrPPMgfV0 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-KBzJswhqrPPMgfV0 rect.text{fill:none;stroke-width:0;}#mermaid-svg-KBzJswhqrPPMgfV0 .icon-shape,#mermaid-svg-KBzJswhqrPPMgfV0 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-KBzJswhqrPPMgfV0 .icon-shape p,#mermaid-svg-KBzJswhqrPPMgfV0 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-KBzJswhqrPPMgfV0 .icon-shape .label rect,#mermaid-svg-KBzJswhqrPPMgfV0 .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-KBzJswhqrPPMgfV0 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-KBzJswhqrPPMgfV0 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-KBzJswhqrPPMgfV0 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} sysroots/
x86_64-pokysdk-linux/
usr/
bin/
lib/
include/
主机编译工具
主机库文件
主机头文件

4.5 主机工具的作用

主机工具主要用于：

  • 编译主机端工具（如west、CMake模块）
  • 运行主机端辅助程序
  • 提供Python环境支持

五、根目录文件详解

5.1 setup.sh 安装脚本

作用：SDK初始化配置脚本

bash 复制代码 
#!/bin/bash
# Zephyr SDK 1.0.1 setup.sh

# 设置SDK安装目录
ZEPHYR_SDK_INSTALL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

# 检测系统架构
ARCH=$(uname -m)

# 配置环境变量
export ZEPHYR_TOOLCHAIN_VARIANT=zephyr
export ZEPHYR_SDK_INSTALL_DIR

# 安装主机工具
./hosttools/zephyr-sdk-${ARCH}-hosttools-standalone-*.sh

echo "Zephyr SDK setup complete!"
echo "SDK installed at: $ZEPHYR_SDK_INSTALL_DIR"

使用方法：

bash 复制代码 
cd ~/zephyr-sdk-1.0.1
./setup.sh

5.2 sdk_version 版本文件

作用：记录SDK版本信息

bash 复制代码 
# sdk_version 内容示例
1.0.1

查看方法：

bash 复制代码 
cat ~/zephyr-sdk-1.0.1/sdk_version

5.3 sdk_gnu_toolchains 配置文件

作用：工具链配置信息

bash 复制代码 
# sdk_gnu_toolchains 内容示例
aarch64-zephyr-elf
arc64-zephyr-elf
arc-zephyr-elf
arm-zephyr-eabi
microblazeel-zephyr-elf
mips-zephyr-elf
or1k-zephyr-elf
riscv64-zephyr-elf
rx-zephyr-elf
sparc-zephyr-elf
x86_64-zephyr-elf
xtensa-*

六、目录关系与构建流程

6.1 组件关系图

#mermaid-svg-xIknmq632bSQvqYg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-xIknmq632bSQvqYg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-xIknmq632bSQvqYg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-xIknmq632bSQvqYg .error-icon{fill:#552222;}#mermaid-svg-xIknmq632bSQvqYg .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-xIknmq632bSQvqYg .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-xIknmq632bSQvqYg .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-xIknmq632bSQvqYg .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-xIknmq632bSQvqYg .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-xIknmq632bSQvqYg .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-xIknmq632bSQvqYg .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-xIknmq632bSQvqYg .marker{fill:#333333;stroke:#333333;}#mermaid-svg-xIknmq632bSQvqYg .marker.cross{stroke:#333333;}#mermaid-svg-xIknmq632bSQvqYg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-xIknmq632bSQvqYg p{margin:0;}#mermaid-svg-xIknmq632bSQvqYg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-xIknmq632bSQvqYg .cluster-label text{fill:#333;}#mermaid-svg-xIknmq632bSQvqYg .cluster-label span{color:#333;}#mermaid-svg-xIknmq632bSQvqYg .cluster-label span p{background-color:transparent;}#mermaid-svg-xIknmq632bSQvqYg .label text,#mermaid-svg-xIknmq632bSQvqYg span{fill:#333;color:#333;}#mermaid-svg-xIknmq632bSQvqYg .node rect,#mermaid-svg-xIknmq632bSQvqYg .node circle,#mermaid-svg-xIknmq632bSQvqYg .node ellipse,#mermaid-svg-xIknmq632bSQvqYg .node polygon,#mermaid-svg-xIknmq632bSQvqYg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-xIknmq632bSQvqYg .rough-node .label text,#mermaid-svg-xIknmq632bSQvqYg .node .label text,#mermaid-svg-xIknmq632bSQvqYg .image-shape .label,#mermaid-svg-xIknmq632bSQvqYg .icon-shape .label{text-anchor:middle;}#mermaid-svg-xIknmq632bSQvqYg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-xIknmq632bSQvqYg .rough-node .label,#mermaid-svg-xIknmq632bSQvqYg .node .label,#mermaid-svg-xIknmq632bSQvqYg .image-shape .label,#mermaid-svg-xIknmq632bSQvqYg .icon-shape .label{text-align:center;}#mermaid-svg-xIknmq632bSQvqYg .node.clickable{cursor:pointer;}#mermaid-svg-xIknmq632bSQvqYg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-xIknmq632bSQvqYg .arrowheadPath{fill:#333333;}#mermaid-svg-xIknmq632bSQvqYg .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-xIknmq632bSQvqYg .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-xIknmq632bSQvqYg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-xIknmq632bSQvqYg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-xIknmq632bSQvqYg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-xIknmq632bSQvqYg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-xIknmq632bSQvqYg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-xIknmq632bSQvqYg .cluster text{fill:#333;}#mermaid-svg-xIknmq632bSQvqYg .cluster span{color:#333;}#mermaid-svg-xIknmq632bSQvqYg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-xIknmq632bSQvqYg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-xIknmq632bSQvqYg rect.text{fill:none;stroke-width:0;}#mermaid-svg-xIknmq632bSQvqYg .icon-shape,#mermaid-svg-xIknmq632bSQvqYg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-xIknmq632bSQvqYg .icon-shape p,#mermaid-svg-xIknmq632bSQvqYg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-xIknmq632bSQvqYg .icon-shape .label rect,#mermaid-svg-xIknmq632bSQvqYg .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-xIknmq632bSQvqYg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-xIknmq632bSQvqYg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-xIknmq632bSQvqYg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 开发者
west build
CMake构建系统
cmake/Zephyr-sdkConfig.cmake
读取sdk_version
读取sdk_gnu_toolchains
选择工具链
gnu/arm-zephyr-eabi
编译源代码
生成ELF文件
主机工具
hosttools/
编译主机端工具
辅助构建过程

6.2 编译流程详解

工具链 SDK配置 CMake west工具 开发者 工具链 SDK配置 CMake west工具 开发者 #mermaid-svg-d9j0BDeR7ntNaVwU{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-d9j0BDeR7ntNaVwU .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-d9j0BDeR7ntNaVwU .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-d9j0BDeR7ntNaVwU .error-icon{fill:#552222;}#mermaid-svg-d9j0BDeR7ntNaVwU .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-d9j0BDeR7ntNaVwU .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-d9j0BDeR7ntNaVwU .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-d9j0BDeR7ntNaVwU .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-d9j0BDeR7ntNaVwU .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-d9j0BDeR7ntNaVwU .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-d9j0BDeR7ntNaVwU .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-d9j0BDeR7ntNaVwU .marker{fill:#333333;stroke:#333333;}#mermaid-svg-d9j0BDeR7ntNaVwU .marker.cross{stroke:#333333;}#mermaid-svg-d9j0BDeR7ntNaVwU svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-d9j0BDeR7ntNaVwU p{margin:0;}#mermaid-svg-d9j0BDeR7ntNaVwU .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-d9j0BDeR7ntNaVwU text.actor>tspan{fill:black;stroke:none;}#mermaid-svg-d9j0BDeR7ntNaVwU .actor-line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-d9j0BDeR7ntNaVwU .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-d9j0BDeR7ntNaVwU .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-svg-d9j0BDeR7ntNaVwU .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-svg-d9j0BDeR7ntNaVwU #arrowhead path{fill:#333;stroke:#333;}#mermaid-svg-d9j0BDeR7ntNaVwU .sequenceNumber{fill:white;}#mermaid-svg-d9j0BDeR7ntNaVwU #sequencenumber{fill:#333;}#mermaid-svg-d9j0BDeR7ntNaVwU #crosshead path{fill:#333;stroke:#333;}#mermaid-svg-d9j0BDeR7ntNaVwU .messageText{fill:#333;stroke:none;}#mermaid-svg-d9j0BDeR7ntNaVwU .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-d9j0BDeR7ntNaVwU .labelText,#mermaid-svg-d9j0BDeR7ntNaVwU .labelText>tspan{fill:black;stroke:none;}#mermaid-svg-d9j0BDeR7ntNaVwU .loopText,#mermaid-svg-d9j0BDeR7ntNaVwU .loopText>tspan{fill:black;stroke:none;}#mermaid-svg-d9j0BDeR7ntNaVwU .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-d9j0BDeR7ntNaVwU .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-d9j0BDeR7ntNaVwU .noteText,#mermaid-svg-d9j0BDeR7ntNaVwU .noteText>tspan{fill:black;stroke:none;}#mermaid-svg-d9j0BDeR7ntNaVwU .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-svg-d9j0BDeR7ntNaVwU .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-svg-d9j0BDeR7ntNaVwU .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-svg-d9j0BDeR7ntNaVwU .actorPopupMenu{position:absolute;}#mermaid-svg-d9j0BDeR7ntNaVwU .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-d9j0BDeR7ntNaVwU .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-d9j0BDeR7ntNaVwU .actor-man circle,#mermaid-svg-d9j0BDeR7ntNaVwU line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-svg-d9j0BDeR7ntNaVwU :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} west build -b nrf52840dk 启动CMake构建 加载cmake/Zephyr-sdkConfig.cmake 读取sdk_version 读取sdk_gnu_toolchains 选择arm-zephyr-eabi工具链 gcc编译源文件 ld链接目标文件 生成zephyr.elf

七、实战操作指南

7.1 查看SDK信息

bash 复制代码 
# 查看SDK版本
cat ~/zephyr-sdk-1.0.1/sdk_version

# 查看支持的架构
cat ~/zephyr-sdk-1.0.1/sdk_gnu_toolchains

# 列出所有工具链
ls ~/zephyr-sdk-1.0.1/gnu/

7.2 验证工具链

bash 复制代码 
# 检查ARM工具链版本
~/zephyr-sdk-1.0.1/gnu/arm-zephyr-eabi/bin/arm-zephyr-eabi-gcc --version

# 检查RISC-V工具链版本
~/zephyr-sdk-1.0.1/gnu/riscv64-zephyr-elf/bin/riscv64-zephyr-elf-gcc --version

# 检查Xtensa ESP32工具链
~/zephyr-sdk-1.0.1/gnu/xtensa-espressif_esp32_zephyr-elf/bin/xtensa-espressif_esp32_zephyr-elf-gcc --version

7.3 设置环境变量

bash 复制代码 
# 方法1：运行setup.sh
cd ~/zephyr-sdk-1.0.1
./setup.sh

# 方法2：手动设置环境变量
export ZEPHYR_SDK_INSTALL_DIR=~/zephyr-sdk-1.0.1
export ZEPHYR_TOOLCHAIN_VARIANT=zephyr

7.4 加载主机工具环境

bash 复制代码 
# 加载主机工具环境
source ~/zephyr-sdk-1.0.1/hosttools/environment-setup-x86_64-pokysdk-linux

# 验证主机工具
which gcc
gcc --version

八、常见问题与解决方案

8.1 找不到工具链

问题：

复制代码 
CMake Error: Could not find toolchain

解决方案：

bash 复制代码 
# 检查环境变量
echo $ZEPHYR_SDK_INSTALL_DIR
echo $ZEPHYR_TOOLCHAIN_VARIANT

# 重新运行setup.sh
cd ~/zephyr-sdk-1.0.1
./setup.sh

8.2 版本不匹配

问题：SDK版本与Zephyr版本不兼容

解决方案：

bash 复制代码 
# 查看SDK版本
cat ~/zephyr-sdk-1.0.1/sdk_version

# 查看Zephyr版本
cd ~/zephyrproject/zephyr
git describe --tags

# 确保版本兼容

8.3 主机工具缺失

问题：缺少主机端编译工具

解决方案：

bash 复制代码 
# 安装主机工具
cd ~/zephyr-sdk-1.0.1/hosttools
./zephyr-sdk-x86_64-hosttools-standalone-0.10.sh

# 加载环境
source ~/zephyr-sdk-1.0.1/hosttools/environment-setup-x86_64-pokysdk-linux

8.4 Xtensa工具链选择错误

问题：ESP32项目使用了错误的Xtensa工具链

解决方案：

bash 复制代码 
# ESP32使用espressif_esp32工具链
west build -b esp32 samples/hello_world

# ESP32-S3使用espressif_esp32s3工具链
west build -b esp32s3 samples/hello_world

九、SDK架构支持统计

9.1 架构数量统计

#mermaid-svg-fSYNB17AOiX8wAy2{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-fSYNB17AOiX8wAy2 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-fSYNB17AOiX8wAy2 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-fSYNB17AOiX8wAy2 .error-icon{fill:#552222;}#mermaid-svg-fSYNB17AOiX8wAy2 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-fSYNB17AOiX8wAy2 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-fSYNB17AOiX8wAy2 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-fSYNB17AOiX8wAy2 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-fSYNB17AOiX8wAy2 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-fSYNB17AOiX8wAy2 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-fSYNB17AOiX8wAy2 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-fSYNB17AOiX8wAy2 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-fSYNB17AOiX8wAy2 .marker.cross{stroke:#333333;}#mermaid-svg-fSYNB17AOiX8wAy2 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-fSYNB17AOiX8wAy2 p{margin:0;}#mermaid-svg-fSYNB17AOiX8wAy2 .pieCircle{stroke:#000000;stroke-width:2px;opacity:0.7;}#mermaid-svg-fSYNB17AOiX8wAy2 .pieOuterCircle{stroke:#000000;stroke-width:1px;fill:none;}#mermaid-svg-fSYNB17AOiX8wAy2 .pieTitleText{text-anchor:middle;font-size:25px;fill:#000000;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-fSYNB17AOiX8wAy2 .slice{font-family:"trebuchet ms",verdana,arial,sans-serif;fill:#000000;font-size:17px;}#mermaid-svg-fSYNB17AOiX8wAy2 .legend text{fill:#000000;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:17px;}#mermaid-svg-fSYNB17AOiX8wAy2 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 63% 25% 6% 3% 3% Zephyr SDK 1.0.1 支持的架构分布 ARM系列 RISC-V X86 Xtensa系列 其他架构

9.2 详细统计表

类别 数量 具体架构
ARM系列 2 aarch64, arm
RISC-V 1 riscv64
x86 1 x86_64
ARC系列 2 arc, arc64
Xtensa系列 20+ Intel、Espressif、NXP、MTK、AMD等
其他架构 6 MIPS、MicroBlaze、SPARC、OpenRISC、RX

结束语

通过本文的详细解析，相信大家对Zephyr SDK 1.0.1的实际目录结构有了全面的认识。SDK采用了清晰的模块化设计：

目录 主要作用
cmake/ CMake构建系统配置
gnu/ 30+架构的交叉编译工具链
hosttools/ 主机端开发工具和环境
setup.sh SDK初始化安装脚本
sdk_version 版本信息
sdk_gnu_toolchains 工具链配置列表

理解这些目录和文件的作用，不仅能帮助我们更好地使用SDK，还能在遇到问题时快速定位原因。特别是gnu/目录中丰富的工具链支持，让Zephyr能够覆盖从主流MCU到专业DSP的各种嵌入式平台。

参考资料：

相关推荐
ScilogyHunter4 小时前
Zephyr概述
zephyr
ScilogyHunter4 小时前
Zephyr Shell完全指南
shell·zephyr
ScilogyHunter6 小时前
West工具完全指南
zephyr·west
ScilogyHunter7 小时前
Zephyr SDK 完全指南
zephyr
Molesidy1 天前
【Embedded Development】【Zephyr】【Windows】基于STM32的Zephyr移植
stm32·led·zephyr
IAR Systems1 天前
使用IAR Arm工具链开发和调试Zephyr RTOS
arm开发·嵌入式·iar·zephyr
mftang19 天前
Zephyr RTOS 中k_mutex（互斥锁）功能介绍
互斥锁·zephyr·zephyr rtos·k_mutex
fitpolo20 天前
蓝牙低功耗基3-蓝牙低功耗中的数据交4
zephyr
嵌入式学习和实践1 个月前
Zephyr 实时系统下 W25Q128 + LittleFS 文件系统实战指南
zephyr·lfs文件系统·w25q128
热门推荐
01HTTP 与 HTTPS 的区别：从原理到实战详解022026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？03【AI】2026 年具身智能模型和世界模型总结042026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？05AI科技热点日报 | 2026年6月1日06《置身钉内》原文-可播放阅读07GitHub 镜像站点08Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析092026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf10AI一周事件 · 2026-06-03 至 2026-06-09