ZigBee是低功耗无线通信里用得最多的技术之一，智能家居、工业传感器、照明控制这些场景都少不了它。不少开发者买了ZigBee模块，但组网时遇到一堆问题：节点连不上、数据传丢了、网络一扩容就不稳定。今天从基本概念讲起，到实际组网调试的常见坑，把ZigBee网络搭起来跑通。

先搞清ZigBee网络里的三种角色。Coordinator（协调器）是网络的核心，负责创建网络、分配地址，一个网络里只有一个。Router（路由器）负责数据转发和扩展网络覆盖范围，可以有多个。End Device（终端设备）是叶子节点，不转发数据，直接跟Coordinator或者Router通信，功耗最低，可以休眠。这三种角色构成了整个ZigBee网络。

组网的拓扑结构有三种：星型、树型、Mesh。星型最简单，所有终端直接跟协调器通信，距离有限、可靠性差，一个路由器挂了周围节点都断。树型是星型的扩展，路由器下面还能接路由器，但数据只能往上走再往下走，绕路。Mesh是最常用的拓扑，节点之间可以自由通信，数据可以多跳转发，某个节点挂了其他节点能自动找新的路径，可靠性高、覆盖广。实际项目里基本都用Mesh。

组网的基本流程。第一步，Coordinator上电后创建网络，选一个Pan ID（网络标识）和工作信道（2.4GHz频段有16个信道，选一个干扰小的）。第二步，Router上电后搜索附近的网络，找到Coordinator请求加入，Coordinator分配一个16位短地址。第三步，End Device同理搜索加入，加入后跟父节点（Coordinator或Router）建立绑定关系。整个过程大概几秒到十几秒，取决于网络规模。

开发ZigBee常用的方案：TI的CC2530/CC2531芯片配Z-Stack协议栈，是目前资料最多、社区最活跃的方案；NXP的JN5168也不错，但生态没TI的好；ESP32-C3/C6自带ZigBee，性价比高，国内用的人越来越多。每个方案都有自己的编译环境和下载工具，初学推荐TI的方案，中文资料多、示例丰富。

实际组网的常见问题。第一，信道干扰：如果附近有WiFi路由器在同一信道（2.4GHz WiFi和ZigBee信道有重叠），ZigBee通信会不稳定、丢包多。解决办法是把ZigBee信道调到11、14、15这些WiFi干扰小的信道。第二，距离不够：ZigBee室内穿墙大概10到20米，开阔地能到几十米。要扩展距离可以加路由器做中继，或者换功率更大的模块（比如带PA的CC2591+CC2530方案）。第三，地址冲突：如果两个网络的Pan ID重复，节点可能加入错误的网络，创建网络时要选一个独特的Pan ID。第四，功耗问题：End Device要省电的话必须开休眠模式，定时醒来通信，不要一直保持唤醒状态，否则电池很快用完。

调试ZigBee网络最有效的工具是抓包器。TI的Z-Stack Packet Sniffer或者Ubiqua Sniffer，能抓到空中的ZigBee数据包，看到节点加入、数据传输、网络维护的完整过程。抓包能快速定位组网失败、数据丢包这些问题，比靠LED指示靠谱多了。初学阶段建议先搭个小网络：一个协调器、两个路由器、三四个终端，跑通数据传输再慢慢扩展。ZigBee的难度不在技术本身，而在于网络调试的经验积累，多抓几次包、多调几次参数就熟悉了。