4. 开发环境搭建

Thread边界路由器的开发环境并不是“装一个IDE就能跑”的单一软件，而是一条从主机工具链、构建系统、OpenThread源码到硬件调试通道的完整链路。任何一环缺失，都会在后续编译或烧录阶段以难以定位的错误暴露出来。本节按照“先工具链、再SDK、后源码编译、最后调试工具”的顺序，把这条链路一次搭通，并给出可复现的验证方法。

一、主机工具链：编译与构建的基础

OpenThread官方推荐在Linux（Ubuntu 20.04/22.04）下开发，Windows用户建议使用WSL2。核心工具链包括：GCC交叉编译器（用于ARM Cortex-M目标）、CMake（3.13以上）、Ninja构建器、Python 3（用于脚本与测试）、Git与pkg-config。以Ubuntu为例，一次性安装：

sudo apt update
sudo apt install -y git cmake ninja-build python3 python3-pip \
  gcc-arm-none-eabi gdb-multiarch libncurses-dev \
  autoconf automake libtool pkg-config

安装完成后必须验证版本，而不是假设成功。执行 arm-none-eabi-gcc --version 应输出类似 10.3.1 的版本号；cmake --version 应不低于3.13。若 arm-none-eabi-gcc 提示找不到命令，说明包名或PATH有问题，需先解决再继续，否则后续编译会在链接阶段报“cannot find -lc”之类的错误。

二、获取SDK与OpenThread源码

边界路由器通常基于Nordic nRF52840或Silicon Labs EFR32等支持802.15.4的SoC。以nRF52840为例，需要两部分代码：厂商SDK（提供HAL、驱动、SoftDevice或协议栈底层）和OpenThread源码（提供Thread协议栈与边界路由功能）。

OpenThread源码通过Git获取，并切换到稳定分支：

git clone https://github.com/openthread/openthread.git
cd openthread
git checkout thread-reference-20230119   # 示例稳定标签
./script/bootstrap

bootstrap脚本会自动拉取子模块（如mbedtls、nlbuild-autotools）并准备构建环境。若网络受限导致子模块拉取失败，可改用 git submodule update --init --recursive 手动补全。厂商SDK则从官方渠道下载压缩包，解压到与openthread同级的目录，例如 ~/ncs 或 ~/nRF5_SDK_17.1.0，保持路径不含中文和空格，避免CMake解析异常。

三、OpenThread源码编译

OpenThread支持两种构建方式：POSIX模拟器（用于快速验证协议逻辑）和嵌入式目标（用于真实硬件）。开发初期建议先用POSIX构建确认源码完整，再切换到目标板。

POSIX构建：

./script/cmake-build simulation
# 产物位于 build/simulation/examples/apps/cli/ot-cli-ftd

嵌入式目标构建以nRF52840为例，需指定工具链文件和目标平台：

./script/cmake-build nrf52840 \
  -DOT_BORDER_ROUTER=ON \
  -DOT_COMMISSIONER=ON \
  -DOT_JOINER=ON \
  -DOT_COAP=ON \
  -DOT_DHCP6_CLIENT=ON \
  -DOT_DHCP6_SERVER=ON

其中 OT_BORDER_ROUTER=ON 是边界路由器的关键开关，它启用NCP/边界代理、DHCPv6前缀代理和路由通告功能。编译成功后，产物为 build/nrf52840/bin/ot-ncp-ftd.hex 或 .elf。若编译报错，优先检查三项：工具链路径是否被CMake识别、子模块是否完整、目标平台名称是否与 examples/platforms/ 下的目录一致。

四、调试工具配置

硬件调试依赖SWD接口。nRF52840开发板通常板载J-Link OB，安装 nrfjprog 与 JLinkExe 后即可烧录。若使用独立J-Link或DAPLink，则配置OpenOCD：

openocd -f interface/jlink.cfg -f target/nrf52.cfg

调试会话使用 gdb-multiarch 连接：

arm-none-eabi-gdb build/nrf52840/bin/ot-ncp-ftd.elf
(gdb) target remote localhost:3333
(gdb) monitor reset halt
(gdb) load
(gdb) continue

串口日志是边界路由器最常用的观察手段。OpenThread CLI默认通过UART输出，参数为115200波特率、8数据位、无校验、1停止位。Linux下设备名通常为 /dev/ttyACM0，若提示权限不足，将当前用户加入 dialout 组：sudo usermod -aG dialout $USER，重新登录后生效。

五、环境验证与判断依据

环境是否搭好，不能靠“看起来没报错”判断，而要用可观察的输出确认。建议按以下顺序验证：

• 工具链：arm-none-eabi-gcc --version 正常输出版本号。
• 源码完整性：ls third_party/mbedtls 目录非空，说明子模块已拉取。
• 编译产物：build/nrf52840/bin/ 下存在 .elf 与 .hex 文件，且 .elf 大小在数百KB量级。
• 烧录成功：nrfjprog --program ot-ncp-ftd.hex --chiperase --reset 返回 Parsing hex file... Programming... Verified.。
• 运行状态：串口输入 state，返回 leader 或 router；输入 br state，返回边界路由状态（如 started）。