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的各种嵌入式平台。

参考资料：

相关推荐
wotaifuzao11 天前
(十)BLE GATT与ATT深度解剖-从属性表到CCCD-订阅收不到数据的终极答案
低功耗蓝牙·ble·nrf52·zephyr·gatt·cccd
星源~11 天前
zephyr-Linux环境下搭建步骤
linux·mcu·嵌入式开发·zephyr
dozenyaoyida20 天前
Zephyr BLE 上行链路源码拆解：一个空中报文怎么从 radio 跑到应用回调（NCS v3.2.1）
controller·嵌入式开发·ble·host·zephyr·协议栈·软链路层
dozenyaoyida22 天前
Zephyr BLE GATT Server 注册到收发调用链源码解析（NCS v3.2.1）
ble·zephyr·gatt·ble协议栈
iini1 个月前
nRF Connect SDK 开发新体验：VS Code + Claude Code + DeepSeek + Nordic MCP 全流程（蓝牙开发实例）
agent·ai编程·nrf connect sdk·zephyr·蓝牙开发·deepseek·mcp·claude code·nordic mcp
fitpolo2 个月前
详解Zephyr设备树与设备驱动模型
zephyr
乐鑫科技 Espressif2 个月前
用 AI 开发 Zephyr-IoT 应用
人工智能·物联网·esp32·乐鑫科技·zephyr
固执的你2 个月前
串口中断接收协议数据并用状态机解析_printk()打印内容
zephyr
fitpolo2 个月前
Zephyr的SPI
zephyr
toradexsh3 个月前
基于 NXP i.MX8M Plus 测试 Zephyr RTOS
arm·rtos·nxp·imx8mp·zephyr
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02Telegram APK 下载安装完整指南 — 2026年最新03GitHub 镜像站点042026 爱知・名古屋亚运会怎么看？直播平台+赛程安排分享05历年考研数学一、数学二、数学三真题试卷及答案PDF06蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接072026年CSP-J初赛分数线-----预测08微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新092026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？10人工智能（AI）发展史：详细里程碑