1. 协议栈核心架构 (OSAL Task System)

在 Z-Stack 中，Zigbee 协议的各个层级（PHY, MAC, NWK, APS, ZDO, ZCL）都被实现为独立的 OSAL 任务。

• 任务初始化与事件循环： 在文件 OSAL_SampleSw.c 中，可以看到协议栈各层的初始化顺序。osalInitTasks 函数按优先级顺序初始化了以下关键层：
  1. macTaskInit: MAC 层（介质访问控制）。
  2. nwk_init: NWK 层（网络层，负责路由和寻址）。
  3. APS_Init: APS 层（应用支持子层，负责绑定和组播）。
  4. ZDApp_Init: ZDO 层（Zigbee 设备对象，负责设备发现和管理）。
  5. zcl_Init: ZCL 层（Zigbee 集群库，通用应用标准）。
  6. bdb_Init: BDB 层（Base Device Behavior，Zigbee 3.0 的入网行为标准）。
  7. zclSampleSw_Init: 用户应用层，即你当前的应用逻辑。

2. 应用框架层 API (AF Layer)

这是应用层发送和接收无线数据的主要接口。你的代码中大量使用了 AF 层的 API。

• 注册端点 (Endpoint Registration)：
  • API: afRegister( endPointDesc_t *epDesc )
  • 实现: 在 zclSampleSw_Init 中，应用通过 afRegister(&sampleSw_TestEp) 注册了一个端点（Endpoint 8）。这告诉协议栈：发往端点 8 的消息应交给 zclSampleSw_TaskID 处理。
• 发送数据 (Data Request)：
  • API: AF_DataRequest(...)
  • 实现: 在 zclSampleSw_AF_General 函数中封装了此 API。它支持三种模式：
    • afAddr16Bit: 点对点单播 (P2P)。
    • afAddrBroadcast: 广播 (Broadcast)。
    • afAddrGroup: 组播 (Multicast)。
  • 它需要指定目标地址、Cluster ID (如 CLUSTER_P2P 0x8000)、数据长度和数据负载。
• 接收数据 (Incoming Message)：
  • 处理机制: 当底层收到数据时，OSAL 会发送 AF_INCOMING_MSG_CMD 事件。
  • 实现: 在 zclSampleSw_event_loop 中捕获此事件，并调用 zclSampleSw_AF_RxProc 处理接收到的 afIncomingMSGPacket_t 数据包。

3. 基础设备行为层 API (BDB Layer – Zigbee 3.0)

BDB 层简化了 Zigbee 网络的建立和加入过程（Commisioning）。

• 启动入网/组网:
  • API: bdb_StartCommissioning( mode )
  • 实现:
    • 协调器 (Coordinator): 使用 BDB_COMMISSIONING_MODE_NWK_FORMATION | BDB_COMMISSIONING_MODE_NWK_STEERING 来创建网络并允许其他设备加入。
    • 终端/路由 (EndDevice/Router): 使用 BDB_COMMISSIONING_MODE_NWK_STEERING 来搜索并加入现有网络。
• 入网状态回调:
  • API: bdb_RegisterCommissioningStatusCB( callback )
  • 实现: 注册了 zclSampleSw_ProcessCommissioningStatus 函数。当入网成功（BDB_COMMISSIONING_SUCCESS）或失败时，协议栈会回调此函数。你的代码在这里处理了断线重连逻辑。

4. Zigbee 设备对象层 API (ZDO Layer)

ZDO 负责设备在网络中的管理功能，如地址发现、节点描述符查询等。

• 地址请求:
  • API: ZDP_IEEEAddrReq(...)
  • 实现: 在 zclSampleSw_AF_RxProc 中，协调器收到新设备的数据后，调用此函数查询该设备的 64 位 MAC 地址（IEEE Address）。
• ZDO 消息注册与处理:
  • API: ZDO_RegisterForZDOMsg(...)
  • 实现: 在初始化时注册了 IEEE_addr_rsp 和 Device_annce 消息。当收到这些 ZDO 响应时，会在 zclSampleSw_processZDOMgs 函数中进行解析。

5. Zigbee 集群库实现 (ZCL Layer)

ZCL 定义了标准化的设备行为（如开关、调光、温湿度传感器）。

• 属性表 (Attribute Table):
  • 实现: 在 zcl_samplesw_data.c 中定义了 zclSampleSw_Attrs 数组。这包含了该设备支持的所有标准属性，例如：
    • ZCL_CLUSTER_ID_GEN_BASIC: 基础信息（厂商名、型号）。
    • ZCL_CLUSTER_ID_GEN_ON_OFF: 开关状态。
• 简单描述符 (Simple Descriptor):
  • 实现: zclSampleSw_SimpleDesc 定义了设备支持的 Cluster ID 列表（输入和输出簇），这是其他 Zigbee 设备识别该设备功能的依据。

6. 网络管理与辅助 API (NWK & APS)

虽然你的应用代码主要通过 BDB 和 AF 操作，但也直接使用了部分底层 API：

• 组管理:
  • API: aps_AddGroup(...)
  • 实现: 初始化时调用此函数将端点加入到组 ID 0x0001，用于接收组播消息。
• 入网许可 (Permit Join):
  • API: NLME_PermitJoiningRequest(...)
  • 实现: 协调器调用此函数来通过 MAC 层/网络层命令允许新设备入网。
• 地址获取:
  • API: NLME_GetExtAddr(), NLME_GetShortAddr()
  • 实现: 用于获取自身的 64 位长地址和 16 位短地址。

总结

该仓库实现了一个基于 Z-Stack 的 Zigbee 应用，其协议交互流程如下：

1. OSAL 启动并调度各层任务。
2. BDB 负责将设备接入 Zigbee 网络。
3. ZDO 辅助获取网络中设备的地址信息。
4. ZCL 定义了设备的标准属性和描述符。
5. AF 提供了应用层收发自定义传感器数据（如光照、温湿度）的通道。