写在前面
如果有时间的话可以查看官方的文档说明更加详细准确，本文只是整理一部分协议。
07-5123-08-Zigbee-Cluster-Library.pdf 的“2.4 Command Frame Formats”章节。
ZCL命令帧结构
ZCL帧包含两个部分包头和负载。
包头：
- 控制字节（frame control），必选
- 制造商ID(manufacturer code)，可选
- 序列号(Transaction sequence number)，必选
- 命令ID(command identifier)，必选
负载：
- 负载（payload）
实例：
ZCL包头
控制字节（frame control）
帧类型（Frame Type） ：
- 00：全局命令，与特定属性无关，比如读写属性命令
- 01：特定集群命令，针对某个特定功能或集群定义的命令。例如，灯光控制、温度测量等集群会有自己专用的命令。
- 10-11：预留
全局命令示例：属性读取
特定集群命令示例：开关命令
制造商特定字段（Manufacturer Specific）：
- 0：标准ZCL命令
- 1：制造商自定义ZCL命令，ZCL帧需要填写制造商ID(manufacturer code)字段
标准ZCL命令示例：基础属性读取
制造商自定义ZCL命令示例：自定义属性读取
方向（Direction）：
- 0：cluster的客户端向服务端，如网关读取设备属性
- 1：cluster的服务端向客户端，如设备上报属性
禁用默认响应（Disable Default Response）：
0：开启默认响应。只有设备数据主动上报时才为 0，此时网关会主动回一个 Response 报文，作为上报成功的标记。
1：禁用默认响应。默认为该值。
制造商ID(manufacturer code)
制造商ID：控制字节（frame control）中的制造商特定字段（Manufacturer Specific）为1时需要赋值。
序列号(Transaction sequence number)
通讯序号，累加，请求和响应序号相同
命令ID(command identifier)
常规全局命令
全局命令是针对 Zigbee 协议栈中所有集群的基本控制命令。它们用于协调设备的基本操作。
| Command Identifier Field Value | Description |
|---|---|
| 0x00 | Read Attributes |
| 0x01 | Read Attributes Response |
| 0x02 | Write Attributes |
| 0x03 | Write Attributes Undivided |
| 0x04 | Write Attributes Response |
| 0x05 | Write Attributes No Response |
| 0x06 | Configure Reporting |
| 0x07 | Configure Reporting Response |
| 0x08 | Read Reporting Configuration |
| 0x09 | Read Reporting Configuration Response |
| 0x0a | Report attributes |
| 0x0b | Default Response |
| 0x0c | Discover Attributes |
| 0x0d | Discover Attributes Response |
| 0x0e | Read Attributes Structured |
| 0x0f | Write Attributes Structured |
| 0x10 | Write Attributes Structured response |
| 0x11 | Discover Commands Received |
| 0x12 | Discover Commands Received Response |
| 0x13 | Discover Commands Generated |
| 0x14 | Discover Commands Generated Response |
| 0x15 | Discover Attributes Extended |
| 0x16 | Discover Attributes Extended Response |
特定集群命令
特定集群命令是针对某个特定功能或集群定义的命令。例如，灯光控制、温度测量等集群会有自己专用的命令。
例如，对于开关控制集群（0x0006）：
- 0x00: Off
关闭设备（例如关闭灯光）。 - 0x01: On
打开设备（例如打开灯光）。 - 0x02: Toggle
切换设备的当前状态（例如，开关灯光的开/关状态）。 - 0x03: Move
启动设备的持续动作（例如，调节灯光的亮度或调节窗帘的位置）。 - 0x04: Move to Level
将设备移动到指定的水平值（例如，调节灯光到设定的亮度级别）。
例如，对于门锁集群（0x0101）：
- 0x00: Lock Door
锁住门。 - 0x01: Unlock Door
解锁门。 - 0x02: Toggle Door Lock
切换门的锁定状态。
负载（payload）
根据命令类型决定格式，具体说明见官方文档“2.5 General Command Frames”，其中说明了各个命令ID对应的作用与负载的格式。
数据类型说明：“2.6.2.2 Data Type Table”章节
参考
07-5123-08-Zigbee-Cluster-Library.pdf
