2. nRF54硬件平台与开发环境搭建

nRF54系列是Nordic在nRF52之后推出的新一代多协议SoC，目前工程上最常接触的两条产品线是nRF54H20与nRF54L15。它们都能跑蓝牙低功耗、Thread、Zigbee、2.4 GHz私有协议，甚至支持多协议并发，但定位差异明显：nRF54H20面向高性能、多核、多协议并发的复杂网关与高端终端；nRF54L15面向低功耗、小体积、单协议或轻量并发的电池设备。选型的第一步不是看主频，而是先确认“是否需要多协议同时在线”以及“功耗与封装约束”。

2.1 开发板选型：nRF54H20 DK 与 nRF54L15 DK

nRF54H20 DK搭载nRF54H20 SoC，内部包含应用核、网络核与多个外设域，适合验证蓝牙+Thread并发、Matter边界路由器、多协议网关等场景。nRF54L15 DK搭载nRF54L15 SoC，集成Cortex-M33与低功耗蓝牙/802.15.4射频，适合传感器节点、可穿戴、单协议或轻量并发产品。两者都带板载J-Link调试器、按键、LED与射频测试接口，但nRF54H20 DK在引脚复用、外设数量与调试通道上更丰富。

选型时可参考以下判断：若项目需要同时运行蓝牙与Thread/Zigbee，并需要较大RAM/Flash与多核隔离，优先nRF54H20；若项目以电池供电、成本敏感、协议单一为主，优先nRF54L15。注意：nRF54H20与nRF54L15的引脚、外设和时钟树不同，工程配置不能直接照搬。

2.2 nRF Connect SDK 安装与工具链配置

Nordic当前主推nRF Connect SDK（NCS），它基于Zephyr RTOS，集成了协议栈、驱动、示例与构建系统。推荐使用nRF Connect for VS Code扩展 + nRF Connect SDK Toolchain Manager的组合：Toolchain Manager负责下载指定版本的NCS与配套工具链，VS Code负责工程创建、构建、烧录与调试。

安装流程可概括为：安装nRF Connect for VS Code扩展 → 在扩展中打开Toolchain Manager → 选择NCS版本（例如v2.6.x或v2.7.x，需与后续协议栈版本匹配）→ 安装工具链 → 在VS Code中设置NCS路径。安装完成后，用west命令验证环境：

west --version
nrfutil version

若使用命令行方式，也可通过nrfutil安装工具链并初始化west工作区。关键点是：NCS版本、Zephyr版本、协议栈版本三者必须一致，否则会出现API不匹配或链接错误。

2.3 第一个多协议工程创建

在VS Code中创建工程时，选择“Create a new application”，从NCS示例中选择一个多协议相关样例，例如nrf/samples/bluetooth/peripheral_uart作为起点，再逐步加入802.15.4或Thread支持。更直接的方式是使用west build指定板型与样例：

west build -b nrf54h20dk/nrf54h20/cpuapp samples/bluetooth/peripheral_uart
west flash

对于nRF54L15，板型通常写作nrf54l15dk/nrf54l15/cpuapp。构建成功后，用串口工具查看日志，确认蓝牙广播已启动。若要验证多协议并发，可在prj.conf中同时使能蓝牙与802.15.4相关配置，并注意射频时隙与中断优先级分配。

2.4 环境验证与常见问题

环境搭建完成后，建议做三项验证：一是west build能成功生成zephyr.hex；二是west flash后板子能正常启动并打印日志；三是用nRF Connect for Desktop的Bluetooth Low Energy应用能扫描到设备。常见问题包括：工具链路径未设置导致west找不到命令；NCS版本与样例不匹配导致编译报错；板型名称写错导致构建失败；串口被占用导致日志无输出。