Zephyr SDK 1.0.1 安装与STM32F103C8T6开发环境搭建全攻略-尧图网络科技

最近在尝试用 Zephyr RTOS 开发一个基于 STM32F103C8T6 的小项目，结果第一步安装 Zephyr SDK 就卡住了。网上资料要么版本太老，要么步骤不全，尤其是针对 Windows 和 Linux 不同环境的细节，踩了不少坑。为了帮大家少走弯路，我把自己从零开始，在 Windows 和 Ubuntu 上安装 Zephyr SDK 1.0.1 版本，并成功在 STM32F103C8T6 最小系统板上运行第一个 Blinky 例程的全过程整理出来。

这篇文章会手把手带你完成 Zephyr 开发环境的搭建，内容覆盖 SDK 下载、安装、环境变量配置、项目构建、烧录和调试。无论你是嵌入式新手想入门 Zephyr，还是有一定经验的开发者想快速上手 STM32F103，都能跟着步骤一步步操作，最终点亮你的 LED。

1. Zephyr RTOS 与 SDK 核心概念

在开始动手之前，我们先花几分钟理解一下 Zephyr 和它的 SDK 到底是什么，这能帮你更好地理解后续每一步操作的意义。

1.1 什么是 Zephyr RTOS？

Zephyr 是一个由 Linux 基金会托管的、开源的、可扩展的实时操作系统（RTOS）。它专为资源受限的嵌入式设备设计，支持从简单的 8 位微控制器到功能强大的 32 位应用处理器。与 FreeRTOS、uC/OS 等传统 RTOS 相比，Zephyr 有几个显著特点：

高度模块化与可配置性：通过 Kconfig 系统，你可以像配置 Linux 内核一样，精确地裁剪或启用你需要的功能模块，生成最适合你硬件和应用的系统镜像，避免资源浪费。
强大的硬件抽象与驱动模型：它提供了统一的设备驱动模型和硬件抽象层（HAL），使得应用程序代码可以相对独立于底层硬件。这意味着为一块 STM32 板子写的代码，经过少量修改就能移植到另一块 Nordic 或 Espressif 的板子上。
丰富的协议栈与组件：内置了对蓝牙（包括 Bluetooth LE Mesh）、Wi-Fi、LoRaWAN、CAN、USB 等多种通信协议的支持，以及文件系统、电源管理、安全框架等高级组件。
活跃的社区与完善的工具链：作为 Linux 基金会项目，它拥有活跃的社区和持续迭代的官方工具链（也就是我们马上要安装的 Zephyr SDK），开发体验更接近现代软件开发。

简单来说，如果你想开发一个需要联网、低功耗、且可能运行在多种硬件平台上的物联网设备，Zephyr 是一个非常值得考虑的选择。

1.2 为什么需要 Zephyr SDK？

Zephyr SDK（Software Development Kit）是 Zephyr 项目官方提供的软件开发工具包。它不是一个单一的软件，而是一个包含了构建 Zephyr 应用所需几乎所有工具的集合。尝试手动配置这些工具（尤其是针对 ARM、RISC-V 等架构的交叉编译工具链）非常繁琐且容易出错，SDK 则帮你一站式搞定。

Zephyr SDK 主要包含以下核心组件：

交叉编译工具链：这是 SDK 的核心。例如，为了在 x86 的电脑上编译出能在 ARM 架构的 STM32 上运行的代码，你需要 ARM 的 GCC 编译器（arm-none-eabi-gcc）、链接器、汇编器等。SDK 为你预置了针对多种架构（ARM, RISC-V, Xtensa 等）的 GNU 或 LLVM/Clang 工具链。
主机工具：
- QEMU：一个开源的处理器模拟器。SDK 内置了定制版的 QEMU，允许你在没有真实硬件的情况下，在电脑上模拟运行 Zephyr 应用程序，极大方便了前期开发和调试。
- OpenOCD：开源的片上调试器。它是连接你的电脑和 STM32 这类芯片的 JTAG/SWD 调试器的桥梁，用于烧录程序、单步调试、查看寄存器等。
- CMake：Zephyr 使用 CMake 作为其构建系统。SDK 确保了 CMake 能找到正确的工具链。
Python 脚本与工具：Zephyr 的元工具west以及一些辅助脚本也依赖 Python 环境，SDK 的安装脚本会帮助配置相关路径。

简单总结：没有 Zephyr SDK，你就无法编译 Zephyr 项目代码。安装 SDK 是开启 Zephyr 开发之旅的第一步，也是必须的一步。

1.3 关于 STM32F103C8T6 与“最小系统板”

STM32F103C8T6 是意法半导体（ST）基于 ARM Cortex-M3 内核的经典微控制器，因其性价比高、资源丰富（72MHz主频、64KB Flash、20KB RAM、丰富外设）而被广泛用于各种嵌入式产品和教学中。

“最小系统板”指的是仅包含让这颗 MCU 运行起来所必需的最少外部电路的开发板，通常包括：

电源电路（如 USB 转 5V/3.3V）
复位电路
时钟电路（外部晶振）
程序下载接口（如 SWD 接口）
核心芯片（STM32F103C8T6）
引出所有 IO 引脚

你手头常见的“蓝色小板”或“黑色小板”就是它的最小系统板。在 Zephyr 中，它通常对应着stm32f103c8t6或stm32_min_dev等开发板定义。我们将使用这块板子作为本次教程的硬件平台。

2. 环境准备与版本说明

在开始安装前，请确保你的开发环境满足以下要求。我将分别给出 Windows 和 Linux (Ubuntu) 下的准备步骤。

2.1 操作系统与基础软件

对于 Windows 用户：

操作系统：Windows 10 或 Windows 11。
终端：强烈建议使用Windows Terminal或Git Bash。系统自带的cmd或PowerShell在某些步骤中可能遇到路径或命令问题。本文后续 Windows 示例将基于 Git Bash。
压缩工具：确保已安装7-Zip或Bandizip等支持.7z格式的解压软件，用于解压 SDK 包。
Python：Zephyr 工具需要 Python 3.8 或更高版本。请从 python.org 下载并安装，务必在安装时勾选 “Add Python to PATH”。

对于 Linux (Ubuntu/Debian) 用户：

操作系统：Ubuntu 20.04 LTS, 22.04 LTS 或更高版本。
终端：使用系统自带的终端即可。

基础工具：打开终端，运行以下命令安装编译和开发所需的基础包：

sudo apt update sudo apt install -y git cmake ninja-build gperf \ ccache dfu-util device-tree-compiler wget \ python3-dev python3-pip python3-setuptools python3-tk python3-wheel xz-utils file \ make gcc g++ libssl-dev libncurses-dev

Python：Ubuntu 通常已预装 Python 3。可通过python3 --version确认。

2.2 版本选择：Zephyr SDK 1.0.1

根据官方文档和项目标题，我们本次安装的 SDK 版本是1.0.1。这是一个相对较新的稳定版本，对 Zephyr 3.x 和 4.x 版本都有良好的兼容性。

重要提示：Zephyr SDK 版本与 Zephyr RTOS 源码版本存在兼容性矩阵。虽然 1.0.1 是一个通用性较好的版本，但如果你计划使用某个特定版本的 Zephyr 源码（例如从 GitHub 拉取main分支或某个 LTS 版本），最好查阅官方的 Zephyr SDK Version Compatibility Matrix 来确认最佳匹配的 SDK 版本。

对于本教程和大多数入门及一般开发场景，使用Zephyr SDK 1.0.1是安全且推荐的选择。

2.3 安装目录规划

为了避免权限问题和路径混乱，建议将 Zephyr SDK 安装在你的用户主目录下。

Windows：C:\Users\<你的用户名>\zephyr-sdk-1.0.1或通过 Git Bash 访问的/c/Users/<你的用户名>/zephyr-sdk-1.0.1
Linux：~/zephyr-sdk-1.0.1(即/home/<你的用户名>/zephyr-sdk-1.0.1)

官方也推荐其他位置，如~/.local或/opt，但主目录是最简单无脑的选择。

3. 分步安装 Zephyr SDK 1.0.1

现在，我们开始正式的安装过程。请根据你的操作系统选择对应的章节。

3.1 Windows 系统安装步骤

下载 SDK 压缩包打开 Git Bash，进入你的用户主目录，使用wget命令下载 Windows 版本的 SDK 包。注意，Windows 版本是.7z格式。
```
cd ~ wget https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v1.0.1/zephyr-sdk-1.0.1_windows-x86_64_gnu.7z
```
如果wget命令不存在，你可以先用浏览器打开上面的链接手动下载，然后将下载的文件移动到C:\Users\<你的用户名>\目录下。
解压 SDK 包使用你安装的压缩软件（如 7-Zip）解压刚下载的.7z文件。解压目标目录就选择当前目录 (C:\Users\<你的用户名>\)。解压后会生成一个名为zephyr-sdk-1.0.1的文件夹。
- 也可以在 Git Bash 中使用命令解压（需安装p7zip）:
```
7z x zephyr-sdk-1.0.1_windows-x86_64_gnu.7z
```
运行安装脚本解压完成后，进入 SDK 目录并运行安装脚本setup.cmd。注意，这个脚本必须在cmd.exe中运行，而不是 Git Bash 或 PowerShell。
- 打开cmd.exe（按 Win+R，输入cmd回车）。
- 切换到 SDK 目录并运行脚本：
```
cd %HOMEPATH%\zephyr-sdk-1.0.1 setup.cmd
```
- 脚本运行后，会有一个交互式提示，询问你是否要安装工具链。直接按回车选择默认的[y]即可。它会开始下载并安装所需的工具链到当前目录。这个过程需要一些时间，请保持网络通畅。
验证安装安装脚本运行完毕后，关闭cmd.exe。重新打开一个Git Bash终端，输入以下命令检查工具链是否可用：
```
arm-none-eabi-gcc --version
```
如果安装成功，你应该能看到类似gcc version 12.2.0 (Zephyr SDK 1.0.1)的输出信息。

3.2 Linux (Ubuntu) 系统安装步骤

下载并验证 SDK 压缩包打开终端，执行以下命令下载并校验文件完整性。
```
cd ~ wget https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v1.0.1/zephyr-sdk-1.0.1_linux-x86_64_gnu.tar.xz wget -O - https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v1.0.1/sha256.sum | shasum --check --ignore-missing
```
第二条命令会校验下载文件的 SHA256 哈希值，如果输出显示zephyr-sdk-1.0.1_linux-x86_64_gnu.tar.xz: OK则说明文件完整无误。
注意：如果你的主机是 ARM64 架构（例如树莓派 4B），需要将下载链接中的x86_64替换为aarch64。
解压 SDK 包使用tar命令解压：
```
tar xvf zephyr-sdk-1.0.1_linux-x86_64_gnu.tar.xz
```
解压后同样会生成zephyr-sdk-1.0.1目录。
运行安装脚本进入目录并运行安装脚本：
```
cd zephyr-sdk-1.0.1 ./setup.sh
```
脚本会提示你接受许可协议，并询问是否安装工具链。一路按回车选择默认选项即可。它会将工具链安装到当前目录的toolchains子目录下。
安装 udev 规则（重要！）这一步是为了让普通用户也能通过 USB 访问调试器（如 ST-Link），无需每次使用sudo。执行以下命令：
```
sudo cp ~/zephyr-sdk-1.0.1/hosttools/sysroots/x86_64-pokysdk-linux/usr/share/openocd/contrib/60-openocd.rules /etc/udev/rules.d/ sudo udevadm control --reload
```
完成后，请拔插一下你的 ST-Link 调试器，或者重启电脑，使规则生效。
验证安装在终端中测试工具链：
```
arm-none-eabi-gcc --version
```
同样，你应该能看到带有 Zephyr SDK 版本的 GCC 信息。

3.3 配置环境变量

为了让系统在任何位置都能找到 Zephyr SDK 的工具，我们需要设置一个环境变量ZEPHYR_SDK_INSTALL_DIR。

对于 Windows (Git Bash)：编辑你的~/.bashrc文件（如果不存在就创建）：

nano ~/.bashrc

在文件末尾添加一行（请根据你的实际安装路径修改）：

export ZEPHYR_SDK_INSTALL_DIR="/c/Users/你的用户名/zephyr-sdk-1.0.1"

保存退出（Ctrl+X, 然后Y, 回车）。然后让配置生效：

source ~/.bashrc

对于 Linux：编辑~/.bashrc或~/.zshrc（取决于你的 shell）：

nano ~/.bashrc

在文件末尾添加：

export ZEPHYR_SDK_INSTALL_DIR=~/zephyr-sdk-1.0.1

保存退出，并生效：

source ~/.bashrc

验证环境变量：重新打开一个终端，输入echo $ZEPHYR_SDK_INSTALL_DIR，应该能正确显示你设置的路径。

4. 获取 Zephyr 源码与项目初始化

SDK 是工具，我们还需要 Zephyr 操作系统本身的源代码和项目管理工具west。

4.1 安装 West 元工具

West 是 Zephyr 项目的“元工具”，用于管理多个仓库（Zephyr 本身由核心仓库和许多模块仓库组成）、构建、烧录等。使用 pip 安装：

pip3 install west

安装完成后，运行west --version检查是否成功。

4.2 初始化工作区并获取源码

我们创建一个专门的工作目录，并用west init来拉取代码。

# 创建一个工作目录，名字自定 mkdir -p ~/zephyrproject cd ~/zephyrproject # 使用 west init 初始化，并指定拉取 main 分支的代码 # -m 指定 manifest 文件的 URL，--mr 指定分支（main 是最新开发分支，稳定版可用 v3.6.0 等） west init -m https://github.com/zephyrproject-rtos/zephyr --mr main # 拉取所有子模块和依赖（这一步耗时较长，请耐心等待） west update

4.3 导出 Zephyr 环境变量

Zephyr 的构建系统需要知道核心源码的位置。我们通过一个脚本来设置一系列环境变量。

# 进入 Zephyr 源码目录 cd ~/zephyrproject/zephyr # 执行环境设置脚本 # 对于 Linux/Git Bash: source zephyr-env.sh # 对于 Windows 原生 cmd (如果你在用): # zephyr-env.bat

重要：每打开一个新的终端窗口进行 Zephyr 开发，都需要先cd到zephyr目录并source这个脚本，或者将它的内容添加到你的~/.bashrc中。一个更一劳永逸的方法是，把下面这行加到你的~/.bashrc末尾：

source ~/zephyrproject/zephyr/zephyr-env.sh

5. 第一个 Zephyr 项目：点亮 STM32F103C8T6 的 LED

环境终于搭好了！现在我们来创建一个最简单的项目——闪烁 LED（Blinky）。这是嵌入式世界的“Hello World”。

5.1 了解开发板标识

在 Zephyr 中，每块支持的开发板都有一个唯一的标识符。对于 STM32F103C8T6 最小系统板，常用的标识符是stm32f103c8t6或stm32_min_dev（后者是一个通用名称，通常也指向这块板子）。我们可以通过以下命令查看所有支持的板子列表（输出很长）：

west boards

在输出中寻找stm32f103c8t6。

5.2 构建 Blinky 示例

Zephyr 源码中自带大量示例，位于zephyr/samples/目录下。我们直接使用最基本的blinky。

# 切换到示例目录 cd ~/zephyrproject/zephyr/samples/basic/blinky # 使用 west build 进行构建 # -b 指定目标板 (board) # -p auto 或 -p always 确保构建前先清理 west build -b stm32f103c8t6 -p always

命令解释：

west build: 调用构建命令。
-b stm32f103c8t6: 指定目标板。
-p always: 在构建前先清理（pristine）构建目录，确保是全新构建。第一次构建或修改了重要配置后建议使用。

构建过程会持续一两分钟。如果一切顺利，你会在最后看到[100%] Linking C executable zephyr/zephyr.elf和[100%] Built target zephyr_final的成功信息。

构建产物位于build/zephyr/目录下，其中最重要的文件是：

zephyr.elf: 包含调试信息的可执行文件。
zephyr.bin: 纯二进制镜像，用于烧录。
zephyr.hex: Intel HEX 格式镜像，也可用于烧录。

5.3 硬件连接与烧录

你需要准备：

STM32F103C8T6 最小系统板。
ST-Link V2 调试器/编程器（或其他兼容的调试器，如 J-Link）。
连接线（杜邦线）。

连接方式（SWD 四线制）：

ST-Link 的 3.3V-> 开发板的3.3V
ST-Link 的 GND-> 开发板的GND
ST-Link 的 SWDIO-> 开发板的DIO(或 PA13)
ST-Link 的 SWCLK-> 开发板的DCLK(或 PA14)

将 ST-Link 通过 USB 线连接到电脑。

5.4 使用 West 命令烧录

Zephyr 的west工具集成了烧录功能，非常方便。在刚才构建的目录下执行：

west flash

west flash命令会自动检测连接的调试器和板子类型，并调用合适的工具（通常是 OpenOCD，它包含在 Zephyr SDK 中）将zephyr.bin文件烧录到芯片的 Flash 中。

如果烧录成功，你应该能看到终端输出类似*** Flashing Done ***的信息，并且开发板上的 LED（通常是 PC13 引脚连接的 LED）开始闪烁！

恭喜你！你已经成功在 STM32F103C8T6 上运行了第一个 Zephyr 程序。

5.5 使用 OpenOCD 手动烧录（备用方案）

如果west flash失败，可以尝试使用 OpenOCD 手动烧录。首先确保你的 ST-Link 被系统识别（Linux 下可运行lsusb查看）。

# 进入构建目录 cd ~/zephyrproject/zephyr/samples/basic/blinky/build # 启动 OpenOCD 连接 ST-Link 和 STM32F1 openocd -f interface/stlink.cfg -f target/stm32f1x.cfg

如果连接成功，会看到 OpenOCD 在等待 Telnet 或 GDB 连接。不要关闭这个终端。另开一个终端，使用telnet或gdb进行烧录。

方法一：使用 Telnet

telnet localhost 4444

在 telnet 会话中，输入：

program zephyr/zephyr.bin verify reset exit

方法二：使用 GDB

arm-none-eabi-gdb zephyr/zephyr.elf

在 GDB 中，输入：

target remote localhost:3333 monitor reset halt load monitor reset run detach quit

6. 常见问题与排查思路

安装和构建过程中难免会遇到问题。这里列出一些常见错误及其解决方法。

问题现象	可能原因	排查与解决思路
`west build`失败，提示`找不到编译器`或`CMake Error`	1. SDK 未正确安装或环境变量未设置。 2. 未在 Zephyr 目录下`source zephyr-env.sh`。	1. 运行`arm-none-eabi-gcc --version`确认工具链可用。 2. 运行`echo $ZEPHYR_SDK_INSTALL_DIR`确认路径正确。 3. 确保在当前终端已执行`source ~/zephyrproject/zephyr/zephyr-env.sh`。
`west flash`失败，提示`No ST-Link detected`或`Cannot open USB device`	1. ST-Link 驱动未安装（Windows）。 2. Linux 下 udev 规则未安装或未生效。 3. 线缆接触不良或板子未供电。	1.Windows：安装 ST-Link 官方驱动。 2.Linux：重新执行`sudo cp ... 60-openocd.rules`和`sudo udevadm control --reload`，并重新插拔ST-Link。 3. 检查所有连线，确保板子供电灯亮。
构建时出现`Kconfig`相关错误	板子配置冲突或依赖不满足。	1. 使用`west build -b stm32f103c8t6 -t menuconfig`打开配置界面，检查并保存。 2. 尝试`west build -p always`进行彻底清理后再构建。
`west update`速度慢或失败	网络问题，特别是从 GitHub 拉取子模块。	1. 尝试配置 Git 代理或使用国内镜像源。 2. 分步执行：先`west init`，然后手动修改`.west/config`中的`url-base`为镜像源地址，再`west update`。
运行`arm-none-eabi-gcc`提示`command not found`	SDK 的`setup.sh`或`setup.cmd`脚本未成功运行，或环境变量 PATH 未包含工具链路径。	1. 进入 SDK 安装目录，重新运行`./setup.sh`(Linux) 或`setup.cmd`(Windows)。 2. 检查 SDK 目录下的`toolchains/`子目录是否存在，并手动将其下的`bin`目录（如`arm-zephyr-eabi/bin`）添加到系统的 PATH 环境变量中。
烧录成功但 LED 不闪烁	1. 开发板上的 LED 连接的不是默认引脚（PC13）。 2. 示例代码的 GPIO 配置与你的板子不匹配。	1. 查看你的最小系统板原理图，确认 LED 连接的是哪个 GPIO 引脚。 2. 修改示例代码。打开`samples/basic/blinky/src/main.c`，找到`#define LED0_NODE DT_ALIAS(led0)`相关的部分。你需要根据你的板子设备树（DTS）定义来调整。对于最常见的`stm32f103c8t6`，其设备树通常已将`led0`别名指向 PC13。

7. 进阶：创建自定义项目与最佳实践

学会了运行示例，下一步就是创建自己的项目。

7.1 使用 West 创建新项目

不建议在 Zephyr 源码目录内直接开发。最佳实践是在工作区外创建独立的应用程序目录。

# 回到工作区上级目录 cd ~/zephyrproject # 使用 west 创建一个名为 my_app 的新项目 west create -p app -b stm32f103c8t6 ./my_app cd my_app

这会在my_app目录下生成一个包含src/,CMakeLists.txt,prj.conf等文件的标准 Zephyr 应用骨架。

7.2 项目结构解析

my_app/ ├── CMakeLists.txt # 告诉 CMake 如何构建这个应用 ├── prj.conf # 主要的 Kconfig 配置文件，用于启用/禁用内核功能 ├── src/ │ └── main.c # 你的应用程序主文件 └── west.yml # West 清单文件，定义此应用的依赖和位置

7.3 编写一个简单的按键控制 LED 程序

让我们修改src/main.c，实现一个按下按键（假设接在 PA0）切换 LED 状态的功能。

/* * SPDX-License-Identifier: Apache-2.0 */ #include <zephyr/kernel.h> #include <zephyr/drivers/gpio.h> /* 定义 LED 和按键的设备树节点别名 */ #define LED0_NODE DT_ALIAS(led0) #define SW0_NODE DT_ALIAS(sw0) /* 获取 GPIO 设备指针 */ static const struct gpio_dt_spec led = GPIO_DT_SPEC_GET(LED0_NODE, gpios); static const struct gpio_dt_spec button = GPIO_DT_SPEC_GET(SW0_NODE, gpios); /* 按键中断回调函数 */ static void button_pressed(const struct device *dev, struct gpio_callback *cb, uint32_t pins) { /* 简单的防抖处理 */ k_sleep(K_MSEC(50)); if (gpio_pin_get_dt(&button) == 0) { // 确认按键仍处于按下状态 /* 翻转 LED 状态 */ gpio_pin_toggle_dt(&led); } } static struct gpio_callback button_cb_data; void main(void) { int ret; printk("Zephyr Button-LED Example on STM32F103C8t6\n"); /* 检查 LED 和按键设备是否就绪 */ if (!device_is_ready(led.port)) { printk("Error: LED device is not ready\n"); return; } if (!device_is_ready(button.port)) { printk("Error: button device is not ready\n"); return; } /* 配置 LED 引脚为输出，默认关闭 */ ret = gpio_pin_configure_dt(&led, GPIO_OUTPUT_INACTIVE); if (ret < 0) { printk("Error configuring LED pin\n"); return; } /* 配置按键引脚为输入，启用上拉电阻（假设按键按下为低电平）*/ ret = gpio_pin_configure_dt(&button, GPIO_INPUT | GPIO_PULL_UP); if (ret < 0) { printk("Error configuring button pin\n"); return; } /* 配置按键中断：下降沿触发（按下时）*/ ret = gpio_pin_interrupt_configure_dt(&button, GPIO_INT_EDGE_TO_ACTIVE); if (ret < 0) { printk("Error configuring button interrupt\n"); return; } /* 初始化并添加中断回调函数 */ gpio_init_callback(&button_cb_data, button_pressed, BIT(button.pin)); gpio_add_callback(button.port, &button_cb_data); printk("Press the button to toggle the LED.\n"); /* 主循环什么都不做，等待中断 */ while (1) { k_sleep(K_SECONDS(1)); } }

7.4 配置项目并构建

你需要修改prj.conf来启用 GPIO 和中断支持：

# 启用 GPIO 驱动 CONFIG_GPIO=y # 启用打印输出 CONFIG_PRINTK=y CONFIG_STDOUT_CONSOLE=y # 为按钮启用中断支持 CONFIG_GPIO_GET=y

然后，像之前一样构建和烧录：

west build -b stm32f103c8t6 -p always west flash

7.5 工程建议与最佳实践

版本控制：使用 Git 管理你的应用程序代码，但将build/目录添加到.gitignore。
配置管理：复杂的配置可以拆分到多个.conf文件，使用CONFIG_前缀的宏在代码中控制功能。
设备树（DTS）覆盖：如果你的板子引脚定义与标准板不同，不要直接修改 Zephyr 源码中的设备树。而是在你的应用目录下创建boards/子目录，添加一个<board>.overlay文件来覆盖或添加节点。例如，创建一个boards/stm32f103c8t6.overlay来重新定义led0或sw0的引脚。
调试：
- 日志：充分利用printk和LOG_MODULE_*进行日志输出。
- GDB 调试：使用west debug或west debugserver配合arm-none-eabi-gdb进行源码级单步调试，这是查找复杂 Bug 的利器。
电源管理：对于电池供电设备，务必研究 Zephyr 的电源管理（PM）子系统，合理使用k_sleep()和低功耗模式。

至此，你已经完成了从零搭建 Zephyr 开发环境，到运行示例，再到创建和调试自定义项目的完整流程。Zephyr 生态庞大，接下来可以深入探索其网络协议栈（如 Bluetooth, WiFi）、文件系统、多线程管理、传感器驱动框架等模块。官方文档和samples/目录下的示例是你最好的学习资源。遇到问题，多在 Zephyr 项目的 GitHub 仓库或相关技术社区搜索和提问。