2. 创建第一个Gecko SDK工程
在完成 Simplicity Studio 5（以下简称 SSv5）与 Gecko SDK（GSDK）的安装后，真正进入开发的第一步是创建一个可编译、可下载、可调试的工程。SSv5 的工程创建流程与通用 IDE 有相似之处，但它的核心差异在于：工程并不是从空白开始，而是从 SDK 示例（Example Project） 派生而来。理解这一点，才能理解后续的项目结构、组件配置与代码生成机制。
一、工程模板的选择逻辑
在 SSv5 中点击 File → New → Silicon Labs Project Wizard，向导会依次要求选择目标器件（Target）、SDK 版本和示例工程。目标器件决定了可用外设与内存布局，例如选择 EFR32MG21A020F768IM32 时，Flash 为 768 KB、RAM 为 64 KB，这些数值会直接影响链接脚本与堆栈配置。SDK 版本则决定可用的组件与 API 集合，同一示例在不同 GSDK 版本下可能对应不同的组件依赖。
示例工程按用途大致分为几类：基础外设类（如 Empty C Project、Blink Bare-metal）、无线协议类（如 Zigbee、BLE、Proprietary 的 SoC 或 NCP 示例）、驱动与中间件类（如 Micrium OS、FatFs、mbedTLS）。选择原则是：先用最接近目标功能的示例作为起点，再通过组件裁剪，而不是从空工程手工堆叠。例如要做 BLE 外设，应选择 Bluetooth - SoC Empty，它已包含 Bluetooth 协议栈、GATT 框架和事件循环，省去大量初始化工作。
blink、uart、ble），并查看右侧的 Description 与 Included Components，确认其依赖是否与硬件匹配。二、项目结构解析
工程创建完成后，Project Explorer 中会出现若干节点。以 Bluetooth - SoC Empty 为例，其结构可归纳为三层：
- 工程根节点：包含
.slcp（Silicon Labs Project 配置文件）、.project、.cproject。其中.slcp是工程的“真源”，记录了目标器件、SDK 版本、组件列表和源文件引用。 - 自动生成目录：
autogen/下存放由组件配置生成的sl_component_catalog.h、sl_event_handler.c、sl_system_init.c等。这些文件不应手工修改，重新生成时会被覆盖。 - 用户源码目录：
app.c、main.c、app_init.c等，是开发者真正编写业务逻辑的位置。其中app_init()在系统初始化后被调用，app_process_action()在事件循环中被周期调用。
理解 sl_system_init() 的调用链尤为关键：它依次初始化时钟、GPIO、中断、组件（如 Bluetooth、UART）、事件处理，最后进入 app_init()。因此，任何依赖外设的代码都应放在 app_init() 之后，而不是 main() 开头。
三、编译与下载
SSv5 默认使用 GNU ARM v10.3.1 工具链。点击工具栏的锤子图标即可编译，Console 中会输出编译日志。若出现 undefined reference，通常是组件未启用或源文件未加入 .slcp；若出现 region FLASH overflowed，则说明代码超出 Flash 容量，需要裁剪组件或优化编译选项。
下载前需确认调试器连接正常。以 J-Link 为例，在 Debug Adapters 视图中应能看到设备序列号。点击 Run → Debug 会先编译、再烧录、最后停在 main() 入口。若使用 Run 而非 Debug，则烧录后直接运行，不进入调试会话。
四、调试运行与结果判断
进入调试后，常用操作包括：设置断点、单步（Step Into/Over）、查看变量（Variables）、查看寄存器（Registers）和内存（Memory）。对于无线工程，还可以通过 Network Analyzer 观察空口数据包。
一个典型的验证流程是：在 app_init() 中初始化一个 LED 和 UART，在 app_process_action() 中每 500 ms 翻转 LED 并打印一行日志。若 LED 按预期闪烁、串口助手收到 Hello Gecko SDK，则说明工程创建、编译、下载、调试链路全部打通。若 LED 不亮，应依次检查：GPIO 端口与引脚是否与硬件原理图一致、时钟是否使能、app_process_action() 是否被调用。
autogen/ 下的文件。若需调整组件参数，应在 .slcp 的 Software Components 界面中修改，保存后 SSv5 会自动重新生成代码。五、可直接使用的工程创建检查表
| 检查项 | 预期值 / 操作 | 异常处理 |
|---|---|---|
| 目标器件 | 与开发板丝印一致，如 EFR32MG21A020F768IM32 | 重新运行 Project Wizard 选择正确器件 |
| SDK 版本 | 与团队约定一致，如 GSDK 4.4.x | 在 SDK 管理器中安装对应版本 |
| 示例工程 | Bluetooth - SoC Empty 或 Blink Bare-metal | 搜索关键字并查看 Included Components |
| 编译结果 | Console 显示 Build Finished，0 errors | 检查组件依赖与 Flash 容量 |
| 调试器连接 | Debug Adapters 中显示序列号 | 检查 USB 线、驱动与供电 |
| 下载运行 | LED 闪烁或串口输出预期字符串 | 核对 GPIO 引脚、时钟与调用链 |
完成以上步骤后，你已经拥有一个可运行、可调试的 Gecko SDK 工程。后续所有功能开发，都将在这个工程骨架上通过组件配置与用户代码扩展来完成。