ZigBee组网这事说起来不难，但真到自己动手的时候，坑还是不少的。很多人以为买了几个ZigBee模块，按说明书连上就能自动组网，结果发现有的节点死活加不进去，有的加进去了又老是掉线，折腾半天网络拓扑还是乱的。这篇文章把我实际项目中踩过的坑和摸索出来的经验整理一下，希望能帮大家少走弯路。

先简单说一下ZigBee的组网原理。ZigBee网络里有三种角色：协调器（Coordinator）、路由器（Router）和终端设备（End Device）。协调器是整个网络的老大，负责发起网络、分配地址、管理节点加入。路由器既能收发数据，又能帮其他节点转发数据，还能允许新节点加入。终端设备最省电，只能跟父节点通信，不能转发数据，适合用电池供电的场景。

组网的第一步是把协调器配置好。协调器上电后会扫描周围的信道，选一个干扰最小的建立网络。这里有个细节：信道的选择直接影响后续网络的稳定性。如果周围WiFi信号多，2.4GHz频段会比较拥挤，ZigBee和WiFi在信道上有重叠，容易互相干扰。实际调试时可以用频谱分析仪或者简单的RSSI扫描工具看看哪个信道最干净，手动指定信道比自动选择更靠谱。

节点加入网络的过程叫"关联"。新节点上电后会发送信标请求，周围的协调器和路由器收到后会回复信标帧，新节点根据信号强度选一个父节点加入。听起来很智能，但问题就出在这里——如果周围有多个网络，新节点可能会加入错误的网络；如果父节点的子节点数量已满，新节点就会被拒绝。TI的Z-Stack里每个父节点默认能带的子节点数是有限制的，这个参数要根据实际场景调整。

网络地址分配也是个容易出问题的地方。ZigBee用的是分布式地址分配机制（Distributed Address Assignment），协调器先给自己分配地址0x0000，然后按Cskip算法给子节点分配地址块。如果网络深度设得太小，节点数一多地址就不够分；如果设得太大，地址空间利用率又低。一般智能家居场景网络深度设3到4层就够了，工业场景可能需要更深一些。

组网完成后最头疼的是节点掉线和网络自愈。ZigBee号称有自修复能力，但实际表现取决于具体实现。终端设备如果和父节点失去联系，会尝试重新关联，如果父节点不在了，它会找新的父节点。路由器如果掉线，它的子节点会变成孤儿，需要重新入网。这个过程中数据会丢失，所以上层应用最好有重传机制或者数据缓存策略。

实际工程中提高组网稳定性的几个技巧：第一，供电要稳，ZigBee模块对电压波动敏感，特别是射频部分，电压不稳会导致发射功率下降、通信距离缩短。第二，天线位置和朝向要注意，尽量避开金属遮挡，室内环境多径效应严重，天线方向差几厘米信号强度可能差十几dB。第三，固件版本要统一，不同版本的协议栈可能有兼容性问题，组网前确保所有节点烧的是同一版固件。

调试ZigBee网络有个神器叫ZigBee抓包器，比如TI的SmartRF Packet Sniffer或者Ubiqua Protocol Analyzer。抓包能看到底层的MAC帧、NWK帧，排查问题特别直观。节点为什么加不进去？看关联请求和关联响应的帧内容，状态码会告诉你原因——是信道不匹配、PAN ID冲突、还是父节点容量已满。数据为什么发不到？看路由表和路由发现过程，可能是路由路径断了，也可能是地址解析出了问题。

现在市面上ZigBee方案很多，TI的CC2530/CC2652、Silicon Labs的EFR32、Nordic的nRF52840都是比较主流的选择。选型时除了看射频性能，还要关注协议栈的成熟度、开发文档的完整度、社区活跃度。TI的Z-Stack资料最全，例程丰富，适合初学者。Silicon Labs的Simplicity Studio集成度高，配置工具图形化做得好。Nordic的协议栈比较轻量，跟BLE双模方案结合得好。

总的来说，ZigBee组网是个系统工程，从硬件设计、固件开发到网络部署、后期维护，每个环节都有需要注意的地方。把基础原理搞明白，多抓包分析，遇到问题逐个排查，组网成功率会高很多。现在Matter协议出来了，ZigBee正在向Matter过渡，但底层组网机制变化不大，这些经验以后照样用得上。