015、Zephyr RTOS开发环境搭建（SDK安装与配置）

Zephyr RTOS 开发环境搭建（SDK安装与配置）

从一次“编译不过”的深夜说起

凌晨两点，产线上报了一块新板子的Zephyr固件死活刷不进去。我远程连上开发机，west build跑完，终端吐出一串红色错误——undefined reference to__device_dts_ord_xxx’`。当时第一反应是“DTS又没对齐”，但检查了设备树文件，没问题。折腾半小时，最后发现是SDK版本和Zephyr主分支不匹配，工具链里缺了某个SoC的补丁。那晚之后，我决定把SDK安装这件事彻底标准化，不再让环境问题浪费研发时间。

别用系统包管理器装Zephyr SDK

很多新手会问：“apt install zephyr-sdk行不行？” 行，但你会后悔。Ubuntu仓库里的版本通常滞后半年以上，而Zephyr的DTS绑定、驱动框架迭代极快。我见过有人用apt装了0.13.x的SDK，然后去编译main分支的Zephyr，结果链接器报了一堆“找不到设备树宏”的错误。这里踩过坑：SDK必须和Zephyr源码版本严格对应。

官方推荐的方式是手动下载SDK包，解压到固定路径。我习惯放在/opt/zephyr-sdk-0.16.8（版本号随你选，但别用太旧的）。下载时注意区分Linux、macOS、Windows，别下错。另外，SDK包里的setup.sh脚本会自动注册工具链到CMake，但有个细节——它默认