3. Simplicity Studio与射频调试环境搭建

Simplicity Studio 是 Silicon Labs 为 EFM32、EFR32、EFM8 等系列 MCU 与无线 SoC 提供的集成开发环境。对于无线射频调试而言，它不只是一个代码编辑器，而是把编译器、SDK、硬件配置、射频参数生成、抓包分析和能耗测量整合在同一个工程上下文中的工作台。本节围绕“装好、配好、连上、跑通”四个目标，说明从安装到第一次编译下载的完整路径，并重点解释 Radio Configurator、Network Analyzer、Energy Profiler 三个工具在射频调试中的位置与用法。

安装与首次启动

Simplicity Studio 5 基于 Eclipse 框架，安装包可从 Silicon Labs 官网获取。安装时建议选择非系统盘路径，并预留至少 10 GB 空间，因为后续 SDK 与工具链体积较大。安装完成后首次启动会要求登录 Silicon Labs 账号，登录的作用是关联授权、获取 SDK 更新以及使用部分云服务。若在离线环境使用，可跳过登录，但需要手动导入已下载的 SDK 包。

首次进入主界面后，先确认两件事：一是 Launcher Perspective 中是否识别到已连接的开发板；二是 Preferences → Simplicity Studio → SDKs 中是否已有可用的 Gecko SDK。开发板通过 USB 连接后，若驱动正常，Launcher 会自动识别板型、MCU 型号和板载调试器（J-Link 或板载 Debug）。若未识别，优先检查 USB 线是否为数据线、驱动是否安装，而不是直接怀疑硬件损坏。

SDK 管理与版本选择

Gecko SDK（GSDK）是无线工程的核心依赖，包含协议栈（Bluetooth、Zigbee、Proprietary、Sub-GHz 等）、外设驱动、示例工程和 Radio Configurator 的底层定义。SDK 管理的关键不是“装最新”，而是“与目标协议和芯片匹配”。在 Preferences → Simplicity Studio → SDKs 中可以添加多个 SDK 版本，工程创建时再选择具体版本。

一个常见误区是：升级 SDK 后直接打开旧工程编译，结果出现 API 不兼容或组件缺失。正确做法是保留原 SDK 版本用于维护旧工程，新功能用新 SDK 新建工程。下表给出示例性的版本选择参考（具体版本号以实际发布为准）：

工程创建与组件配置

在 Launcher 中选择 Create New Project，然后选择 Silicon Labs Project，按“目标板/芯片 → 示例工程或空工程 → SDK 版本 → 编译器”的顺序完成创建。对于射频调试，建议从一个可运行的示例（如 RAIL Simple TRX 或 BLE SoC Empty）起步，而不是从完全空工程开始，这样可以先验证工具链和硬件通路，再逐步替换业务逻辑。

工程创建后，核心配置文件是 .slcp（项目配置）和 .slcs（解决方案配置）。通过 Project Configurator 可以添加或移除组件，例如 RAIL Library、BLE Stack、Sleep Timer、GPIO 等。每次修改组件后，Studio 会自动重新生成 autogen 目录下的初始化代码，因此不要手动修改 autogen 中的文件，否则下次生成会被覆盖。

Radio Configurator：射频参数的生成器

Radio Configurator 是无线调试中最关键的工具之一。它把射频物理层参数（频点、带宽、扩频因子、调制方式、发射功率、前导码、同步字等）以图形化方式配置，并生成对应的 radio_settings 结构体和初始化代码。对于 Sub-GHz 私有协议，这些参数直接决定链路能否建立；对于 BLE，则主要影响射频性能与合规性。

使用时，先在 Project Configurator 中打开 Radio Configurator，选择目标 PHY（如 2.4 GHz BLE 1M、Sub-GHz 868 MHz OOK 等），再逐项设置。修改后点击 Generate，Studio 会把参数写入 autogen/radio_config.h 等文件。调试阶段若发现通信失败，第一步不是改代码，而是核对 Radio Configurator 中的频点、速率、同步字是否与对端一致。

Network Analyzer：把空中包“看”出来

Network Analyzer 用于抓取和分析无线数据包。它既可以配合板载调试器使用，也可以配合专用抓包器（如 EFR32 开发板作为 sniffer）。使用时在 Studio 中打开 Network Analyzer 视图，选择抓包设备、目标信道和协议解析方式，然后开始捕获。抓到的每一帧会显示时间戳、信道、RSSI、CRC 状态和解析后的字段。

射频调试中，Network Analyzer 的价值在于区分“发不出去”和“收不到”。如果发送端有包、接收端无包，问题可能在接收端配置或天线；如果发送端本身无包，问题在发射链路或初始化。注意抓包信道必须与 Radio Configurator 中设置的信道一致，否则会看到“空频道”。

Energy Profiler：功耗与射频行为的关联

Energy Profiler 通过板载电流测量电路，实时绘制电流曲线。对于电池供电的无线节点，它能直观显示发射峰值、接收窗口、睡眠电流和唤醒周期。典型用法是：先运行一段广播或连接事件，观察发射瞬间的电流尖峰是否与预期功率档位相符；再观察空闲时是否进入低功耗模式。若平均电流远高于估算值，常见原因是外设未关闭、GPIO 悬空或射频未正确进入睡眠。

编译下载与首次验证

工程配置完成后，点击 Build 编译。若出现组件缺失或 API 报错，优先检查 SDK 版本与组件依赖，而不是逐行改代码。编译通过后，通过 Debug 或 Run 下载到目标板。下载前确认调试器连接正常、目标板供电正常、复位方式正确。

首次验证建议按以下顺序进行：

1. 确认串口有启动日志输出，说明程序已运行；
2. 用 Network Analyzer 抓包，确认射频有发射；
3. 用 Energy Profiler 观察电流，确认功耗行为合理；
4. 若使用两块板，确认收发双方 Radio Configurator 参数完全一致。