📚 课程目录第4章开发环境搭建

4. 开发环境搭建：Zephyr SDK安装、West工具链配置、调试器驱动安装与验证

搭建一个稳定、可复现的开发环境是驱动调试工作的基础。本节将按照“SDK → 工具链 → 调试器驱动 → 验证”的路径，逐步完成Zephyr开发环境的搭建。所有操作均以Linux（Ubuntu 22.04 LTS）为主要平台，Windows/macOS用户可参考官方文档进行适配。

环境一致性建议： 团队开发时，建议使用Docker或DevContainer固化Zephyr SDK与West版本，避免因主机环境差异导致的“在我机器上能跑”问题。

4.1 Zephyr SDK安装

Zephyr SDK提供了跨平台编译所需的工具链、库和主机工具。推荐使用官方提供的自解压安装包。

4.1.1 下载与解压

访问 Zephyr SDK Releases 页面，下载适用于Linux的 zephyr-sdk-0.16.8_linux-x86_64.tar.xz（版本号以最新稳定版为准）。
将SDK解压到统一目录，例如 /opt：

cd ~/Downloads
tar xf zephyr-sdk-0.16.8_linux-x86_64.tar.xz
sudo mv zephyr-sdk-0.16.8 /opt/

4.1.2 运行安装脚本

SDK包内包含一个安装脚本，用于设置工具链符号链接和udev规则：

cd /opt/zephyr-sdk-0.16.8
sudo ./setup.sh

安装脚本会执行以下操作：

为所有支持的架构（arm, x86, riscv, xtensa等）创建工具链符号链接。
安装OpenOCD、QEMU等主机调试工具。
复制udev规则文件，使调试器设备节点具有正确的权限。

权限注意： 如果跳过 sudo ./setup.sh，后续使用West flash或OpenOCD时可能因权限不足无法访问USB调试器。安装后建议重新插拔调试器，并确认用户已加入 plugdev 或 dialout 组。

4.1.3 验证SDK安装

检查工具链是否可用：

export ZEPHYR_SDK_INSTALL_DIR=/opt/zephyr-sdk-0.16.8
arm-zephyr-eabi-gcc --version

预期输出应显示Zephyr工具链版本信息，例如：

arm-zephyr-eabi-gcc (Zephyr SDK 0.16.8) 12.2.0
Copyright (C) 2022 Free Software Foundation, Inc.

4.2 West工具链配置

West是Zephyr的元构建工具，负责项目初始化、依赖管理和构建/烧录命令调度。

4.2.1 安装West

推荐使用Python虚拟环境安装West，避免与系统Python包冲突：

python3 -m venv ~/zephyrproject/.venv
source ~/zephyrproject/.venv/bin/activate
pip install west

4.2.2 初始化Zephyr工作区

west init ~/zephyrproject
cd ~/zephyrproject
west update

west init 会拉取 west.yml 清单文件，west update 则根据清单克隆所有必要的Zephyr仓库（包括主仓库、模块、驱动库等）。

4.2.3 导出Zephyr环境变量

将以下内容添加到 ~/.bashrc 或 ~/.zshrc：

source ~/zephyrproject/.venv/bin/activate
export ZEPHYR_BASE=~/zephyrproject/zephyr
export ZEPHYR_SDK_INSTALL_DIR=/opt/zephyr-sdk-0.16.8
source $ZEPHYR_BASE/zephyr-env.sh

重新加载配置文件后，执行 west --version 确认安装成功。

4.2.4 West常用命令速查表

命令	功能	典型场景
`west init`	初始化Zephyr工作区	首次搭建环境
`west update`	同步所有模块仓库	拉取最新依赖
`west build`	配置并编译应用	日常开发构建
`west flash`	烧录固件到目标板	部署测试
`west debug`	启动调试会话	驱动故障定位

4.3 调试器驱动安装与验证

Zephyr开发中最常用的调试器是SEGGER J-Link和ST-Link。两者均需安装对应的驱动软件，并确保系统能够正确识别设备。

4.3.1 SEGGER J-Link驱动

J-Link驱动由SEGGER官方提供，包含调试器固件、GDB Server和命令行工具。

从 SEGGER下载页面下载 JLink_Linux_x86_64.deb。
安装：

sudo dpkg -i JLink_Linux_x86_64.deb

安装后，J-Link工具默认位于 /opt/SEGGER/JLink/。验证方法：

JLinkExe -device NRF52840_XXAA -if SWD -speed 4000 -autoconnect 1

如果连接成功，终端会显示J-Link固件版本和目标芯片ID。

4.3.2 ST-Link驱动

ST-Link驱动通常通过安装STM32CubeProgrammer或使用开源工具 stlink 实现。

方法一：安装stlink工具包（推荐）

sudo apt install stlink-tools
st-info --version

方法二：安装STM32CubeProgrammer

从ST官网下载并安装后，确保 ST-LINK_SERVER 或 STM32_Programmer_CLI 可执行文件在PATH中。

验证ST-Link连接：

st-info --probe

预期输出应显示连接的ST-Link版本和序列号。

4.3.3 调试器驱动对比

特性	SEGGER J-Link	ST-Link
支持芯片范围	ARM Cortex-M/R/A, RISC-V等	STM32全系列
调试速度	最高 50 MHz (SWD)	最高 4 MHz (SWD)
GDB Server	JLinkGDBServer	st-util / ST-LINK_GDB_server
Zephyr集成	原生支持，west flash/debug直接调用	需配置board.cmake或使用openocd
价格	较高（教育版约$60）	低（Nucleo板载免费）

  调试器选择建议： 对于Zephyr驱动开发，J-Link提供更稳定的调试体验和更快的下载速度。如果使用STM32 Nucleo开发板，板载ST-Link完全够用，无需额外购买。

4.4 环境验证综合测试

完成上述安装后，通过一个完整的“构建→烧录→调试”闭环验证环境是否就绪。

4.4.1 构建示例项目

cd ~/zephyrproject
west build -b nrf52840dk_nrf52840 samples/basic/blinky

如果构建成功，终端会显示 Build completed successfully，并在 build/zephyr/ 目录下生成 zephyr.hex 和 zephyr.elf。

4.4.2 烧录验证

west flash

烧录成功后，开发板上的LED应开始闪烁。如果烧录失败，检查：

调试器是否被系统识别（lsusb 查看设备列表）。
udev规则是否生效（ls -l /dev/ttyACM* 或 /dev/ttyUSB*）。
用户是否在 plugdev 组中（groups 命令查看）。

4.4.3 调试会话验证

west debug

该命令会启动GDB并连接到目标板。在GDB提示符下输入：

(gdb) target remote :2331
(gdb) monitor reset
(gdb) continue

如果LED继续闪烁，说明调试会话正常工作。

常见问题： 如果 west debug 报错 Could not connect to target，请检查SWD接线是否正确，以及目标板是否上电。对于J-Link，可以尝试降低SWD速度（如 --speed 1000）。

4.5 环境搭建检查清单

使用以下清单快速确认环境完整性：

检查项	验证命令	预期结果
Zephyr SDK	`arm-zephyr-eabi-gcc --version`	显示版本号
West工具	`west --version`	显示版本号
J-Link驱动	`JLinkExe -device NRF52840_XXAA -if SWD -speed 4000 -autoconnect 1`	连接成功
ST-Link驱动	`st-info --probe`	显示调试器信息
构建测试	`west build -b nrf52840dk_nrf52840 samples/basic/blinky`	构建成功
烧录测试	`west flash`	LED闪烁
调试测试	`west debug`	GDB连接成功