2. nRF54硬件架构与Matter开发环境搭建
Matter 设备对无线并发、内存占用与安全启动都有硬性要求，Nordic 的 nRF54 系列正是为这类场景设计的。本章先把 nRF54H20 与 nRF54L15 的核心资源差异讲清楚，再落到开发板选型、nRF Connect SDK 安装与工具链配置，最终得到一个可以编译并烧录 Matter 示例的可用环境。
一、nRF54H20 与 nRF54L15 的核心资源差异
nRF54 系列不是单一芯片，而是两条定位不同的产品线。理解它们的架构差异，直接决定后续 Matter 工程选哪块板、用哪套构建目标。
nRF54H20 采用多核异构架构：应用核为 Arm Cortex-M33，主频 320 MHz，带 FPU 与 DSP 指令；另有一颗 256 MHz 的 Cortex-M33 作为网络/协议核，以及独立的 PPR（外设处理核）和 FLPR（快速低功耗核）。片上非易失存储约 2 MB，RAM 约 1 MB。无线部分支持 Bluetooth LE、802.15.4（Thread）与 2.4 GHz 专有协议，且具备多协议并发能力。安全方面集成 TrustZone、安全启动、密钥存储与加密加速器，适合作为 Matter 的 Thread 边界路由器或高性能终端节点。
nRF54L15 则是单核架构：一颗 128 MHz 的 Cortex-M33，配 1.5 MB NVM 与 256 KB RAM，同样支持 Bluetooth LE 与 802.15.4。它的定位是低功耗终端节点，例如 Matter over Thread 的传感器、灯控或开关。相比 H20，L15 资源更紧凑，但成本与功耗更优，是量产终端的主力。
选型判断可以归纳为：需要多协议并发、边界路由或复杂应用逻辑时选 H20；做单一 Thread 终端节点、追求低功耗与成本时选 L15。两者共用同一套 nRF Connect SDK 与 Zephyr 构建体系，代码迁移成本较低。
二、开发板套件选择
Nordic 官方对应的开发板是 nRF54H20 DK 与 nRF54L15 DK。两块板都板载调试器（J-Link OB），通过 USB-C 连接主机即可完成烧录与调试，无需额外仿真器。
nRF54H20 DK 板载多组按键与 LED、外部 Flash、以及用于多协议测试的天线接口，适合验证 Thread 边界路由器与 Matter 控制器交互。nRF54L15 DK 更简洁，适合做终端节点固件开发与功耗测量。若手头只有一块板，建议先用 nRF54L15 DK 跑通 Matter 灯控示例，再按需补充 H20 DK。
接线与供电上，两块板均通过 USB-C 供电，调试口与串口复用同一 USB 连接。串口日志是后续判断设备是否成功加入 Thread 网络的主要观察窗口，务必在开发前确认串口终端可用。
三、nRF Connect SDK 安装
nRF Connect SDK（NCS）基于 Zephyr，Matter 支持由 connectedhomeip 集成而来。推荐使用 nRF Connect for VS Code 扩展完成安装，它会自动管理工具链与 SDK 版本，避免手工配置 Python 依赖的麻烦。
安装流程如下：
- 安装 VS Code，在扩展市场搜索并安装 “nRF Connect for VS Code Extension Pack”。
- 打开 nRF Connect 侧边栏，进入 “Manage SDKs”，点击 “Install SDK”。
- 选择 NCS 版本。Matter 开发建议选择带 Matter 支持的稳定版本，例如 v2.6.x 或更高，并确认该版本包含
nrf与matter相关模块。 - 选择安装路径（避免中文与空格路径），等待 SDK 与工具链下载完成。
- 在 “Manage toolchains” 中确认已安装对应版本的 Zephyr SDK 与编译器。
若使用命令行方式，可先安装 west，再初始化工作区：
pip install west
west init -m https://github.com/nrfconnect/sdk-nrf --mr v2.6.1 ncs
cd ncs
west update
west zephyr-export
pip install -r zephyr/scripts/requirements.txt
pip install -r nrf/scripts/requirements.txt其中 --mr 指定版本标签，实际使用时替换为目标版本。初始化完成后，工作区目录下会同时存在 nrf、zephyr、modules 等目录，这是后续构建的基础。
四、工具链配置与构建验证
工具链配置的核心是让构建系统找到正确的 Zephyr SDK 与 Python 环境。使用 VS Code 扩展时，这些由扩展自动写入；命令行方式则需设置环境变量：
export ZEPHYR_BASE=~/ncs/zephyr
export ZEPHYR_TOOLCHAIN_VARIANT=zephyr
export ZEPHYR_SDK_INSTALL_DIR=~/zephyr-sdk-0.16.5配置完成后，用 Matter 示例做一次构建验证。以 nRF54L15 DK 上的灯控示例为例：
west build -b nrf54l15dk/nrf54l15/cpuapp \
nrf/samples/matter/light_bulb \
-- -DCONF_FILE=prj.conf构建成功后会生成 build/zephyr/zephyr.hex。烧录使用：
west flash烧录后打开串口终端（波特率通常为 115200），应能看到设备启动日志，包括 Matter 初始化、Thread 网络扫描与配网状态。若日志停在启动阶段，优先检查板型参数是否写错、SDK 版本是否匹配、以及串口是否被其他程序占用。
west build -b <board> -p always 中的 -p always 做一次干净构建，避免旧缓存导致的链接错误。五、环境自检清单
在进入 Matter 应用开发前，可用下表快速核对环境是否就绪。每一项都对应后续调试中容易出问题的环节。
| 检查项 | 预期结果 | 常见问题 |
|---|---|---|
| SDK 版本 | 包含 matter 模块，版本与板型匹配 | 版本过旧，缺少 Matter 示例 |
| 工具链 | Zephyr SDK 路径正确，编译器可用 | 环境变量未设置，构建报找不到编译器 |
| 板型参数 | 与实物 DK 一致 | H20 与 L15 参数混用导致烧录失败 |
| 串口 | 可打开并输出启动日志 | 端口被占用或波特率错误 |
| 烧录 | west flash 成功，设备重启 | 调试器驱动异常或 USB 连接不稳 |