1. 搭建Zephyr开发环境

任务目标

在Ubuntu 22.04/24.04上完成Zephyr RTOS开发环境搭建，包括安装依赖包、获取Zephyr源码、安装west工具与Zephyr SDK，最终编译Hello World示例并在QEMU上运行验证。

环境依赖

• Ubuntu 22.04或24.04（x86_64），需具备sudo权限
• 已安装Python 3.10+、pip3、git、cmake（≥3.20）、ninja-build
• 网络可访问GitHub与Zephyr下载服务器

实现步骤与代码

1. 安装系统依赖包

sudo apt update
sudo apt install --yes 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 gcc-multilib \
  g++-multilib libsdl2-dev libmagic1

2. 获取Zephyr源码并安装west

# 安装west
pip3 install --user west

# 创建workspace目录并获取Zephyr源码（以v3.7.0为例）
mkdir ~/zephyrproject && cd ~/zephyrproject
west init --mr v3.7.0
west update

# 安装Zephyr的Python依赖
pip3 install --user -r zephyr/scripts/requirements.txt

3. 安装Zephyr SDK

cd ~
wget https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.16.8/zephyr-sdk-0.16.8_linux-x86_64.tar.xz
tar xf zephyr-sdk-0.16.8_linux-x86_64.tar.xz
cd zephyr-sdk-0.16.8
./setup.sh -t all -h -c

# 将SDK路径写入~/.zephyrrc（west会自动加载）
echo "export ZEPHYR_SDK_INSTALL_DIR=~/zephyr-sdk-0.16.8" >> ~/.zephyrrc

4. 编译Hello World并运行于QEMU

cd ~/zephyrproject/zephyr
west build -p auto -b qemu_x86 samples/hello_world
west build -t run

5. 完整环境变量配置（~/.zephyrrc）

export ZEPHYR_BASE=~/zephyrproject/zephyr
export ZEPHYR_SDK_INSTALL_DIR=~/zephyr-sdk-0.16.8
export PATH=$PATH:~/.local/bin

验证方法与判定标准

执行west build -t run后，QEMU窗口或终端将输出以下内容，出现即表示环境搭建成功且Hello World程序正确运行：

Hello World! qemu_x86

同时终端会显示模拟的启动日志（含Booting Zephyr OS等字样），随后程序正常退出。若编译阶段无错误且上述输出可见，则判定环境搭建与运行验证通过。

常见问题

• west命令找不到：确认~/.local/bin已加入PATH，或重新登录终端使环境变量生效。
• CMake版本过低：Zephyr 3.7要求CMake≥3.20，使用cmake --version检查，必要时通过pip3 install --user cmake升级。
• SDK setup.sh报错：确认已安装libsdl2-dev，且~/.zephyrrc中路径与实际解压位置一致。
• QEMU无显示输出：若在无图形环境（SSH）中运行，需加-nographic参数：west build -t run -- -nographic。