4. Zigbee开发环境搭建
Zigbee开发环境并不是“装一个IDE就能写代码”这么简单。一个可用的工程环境通常由四层构成：芯片与模组、协议栈SDK、编译工具链、调试与抓包工具。四层之间版本必须匹配，否则最常见的现象是编译通过但下载失败、能入网但抓不到包、或者协议栈API与示例代码对不上。本节以TI CC2530、TI CC2652和Silicon Labs EFR32三条主流路线为例，说明选型依据、SDK安装方式、编译工具链配置以及调试工具的实际连接方法。
一、芯片平台选型：先看协议栈代际，再看引脚与功耗
选型时最容易犯的错误是只看主频和Flash。Zigbee开发真正决定工作量的是协议栈代际和芯片是否支持所需角色。
- TI CC2530：8051内核，配套Z-Stack 3.0.2（Zigbee 3.0）。优势是资料极多、模块便宜、适合教学和已有Z-Stack工程维护；劣势是RAM仅8KB，做复杂应用或OTA时余量紧张，且TI已将其定位为成熟/维护型产品。
- TI CC2652：ARM Cortex-M4F，配套SimpleLink SDK中的Z-Stack，支持Zigbee 3.0、Thread、BLE多协议。适合新项目、需要较大RAM、需要协调器+路由器+终端多角色或需要与BLE共存的场景。
- Silicon Labs EFR32MG：Cortex-M33/M4，配套Gecko SDK（GSDK）与Simplicity Studio，EmberZNet协议栈成熟，图形化配置（Radio Configurator、Zigbee Cluster Configurator）完善，适合对低功耗、射频性能和量产工具有要求的项目。
一个实用的判断顺序是：若课程或既有代码基于Z-Stack 3.0.2且以学习协议为主，选CC2530；若要做可扩展的新产品并希望保留BLE升级通道，选CC2652；若团队更依赖图形化配置和完整量产工具链，选EFR32。下表给出示例性对比，具体参数以各厂商最新数据手册为准。
| 平台 | 内核 | 典型协议栈 | 开发环境 | 典型适用场景 |
|---|---|---|---|---|
| CC2530 | 8051 | Z-Stack 3.0.2 | IAR EW8051 | 教学、存量工程维护 |
| CC2652 | Cortex-M4F | SimpleLink Z-Stack | CCS / IAR EWARM | 新项目、多协议 |
| EFR32MG | Cortex-M33/M4 | EmberZNet (GSDK) | Simplicity Studio | 低功耗产品、量产 |
二、SDK安装：路径、版本与工程导入
SDK安装的核心不是“装完”，而是让工程能找到协议栈源码和链接库。三条路线的典型做法如下。
CC2530 + Z-Stack 3.0.2：从TI官网下载Z-Stack 3.0.2安装包，默认安装到 C:\Texas Instruments\ZStack-CC2530-3.0.2。安装后不要移动目录，因为IAR工程中的相对路径和库文件引用都基于该结构。用IAR EW8051打开 Projects\zstack\HomeAutomation\SampleLight\CC2530DB\SampleLight.eww，在Workspace中选择协调器、路由器或终端对应的构建配置。
CC2652 + SimpleLink SDK：安装SimpleLink CC13xx CC26xx SDK，并同时安装对应版本的CCS或IAR。SDK通常位于 C:\ti\simplelink_cc13x2_26x2_sdk_x_xx_xx_xx。导入示例工程时使用 examples\rtos\CC2652RB_LAUNCHXL\zstack 下的工程，注意选择与开发板匹配的Board，否则射频前端配置会不一致。
EFR32 + GSDK：安装Simplicity Studio 5，在Launcher中安装Gecko SDK和EmberZNet。新建工程时选择Zigbee → ZigbeeMinimal或ZigbeeSoC，Studio会自动生成 .slcp 工程文件。修改协议栈组件后需要重新生成，生成失败通常是因为组件依赖未满足，而不是代码错误。
三、编译工具链与调试工具配置
编译工具链的选择由芯片内核决定：CC2530必须使用IAR EW8051；CC2652可用CCS或IAR EWARM；EFR32使用Simplicity Studio自带的GCC。安装后需要确认三件事：编译器版本与SDK要求一致、许可证可用、工程能完整编译出 .hex 或 .out。
调试工具方面，CC2530常用CC Debugger配合SmartRF Flash Programmer下载；CC2652使用XDS110调试器，通过CCS的Debug配置下载和单步；EFR32使用板载J-Link或外部J-Link，在Studio中直接Flash。抓包工具是Zigbee调试的关键：TI提供Packet Sniffer 2配合CC2531 USB Dongle，Silicon Labs提供Network Analyzer配合EFR32或专用Sniffer。抓包时要确认信道与网络一致，否则只能看到噪声。
# 以CC2530为例，编译后典型产物
SampleLight.hex # 可下载固件
SampleLight.map # 查看Flash/RAM占用
# 下载前确认：
# 1. CC Debugger指示灯为绿色
# 2. 目标板供电正常
# 3. Flash Programmer中选择正确的EB/BB配置判断环境是否真正可用，不要只看“编译成功”。建议按以下顺序验证：编译无错误且map文件显示RAM占用低于芯片上限；下载后设备能被调试器识别；协调器上电后能建立网络；终端设备能入网并在抓包工具中看到Beacon Request、Association Request和Transport Key等关键帧。若编译通过但入网失败，优先检查协议栈版本、信道配置和抓包信道是否一致。
最后给出一个可执行的验收清单，用于确认环境是否达到“能开发”的状态：编译产物存在且map文件RAM占用低于芯片上限；调试器能识别目标芯片；下载后设备能复位运行；协调器能建立网络；终端能入网；抓包工具能在同一信道看到入网关键帧。若其中任一项失败，先回到对应层排查，而不是直接修改应用代码。环境搭建的价值就在于把问题定位在正确的层，而不是让协议栈、工具链和硬件问题混在一起。