zigbee zcl规范及其协议栈实现1

落日映苍穹つ 2022-07-13 04:13 183阅读 0赞

refer to ZigBee\_Cluster\_Library\_Public\_download\_version  
1.zcl 分为几个不同的功能领域，  
每个领域霸占一部分clusterid  
![1363444660_8609.jpg][]  
比如通用领域有如下的clusterid  
![1363444979_2847.jpg][]  
![1363444991_8519.jpg][]  
![1363445298_7225.jpg][]  
![1363445317_6687.jpg][]  
........  
在协议栈的zcl.h中有对这些clusterid定义，对应上面的文档，但是不完整

1.  // General Clusters
2.  \#define ZCL\_CLUSTER\_ID\_GEN\_BASIC 0x0000
3.  \#define ZCL\_CLUSTER\_ID\_GEN\_POWER\_CFG 0x0001
4.  \#define ZCL\_CLUSTER\_ID\_GEN\_DEVICE\_TEMP\_CONFIG 0x0002
5.  \#define ZCL\_CLUSTER\_ID\_GEN\_IDENTIFY 0x0003
6.  \#define ZCL\_CLUSTER\_ID\_GEN\_GROUPS 0x0004
7.  \#define ZCL\_CLUSTER\_ID\_GEN\_SCENES 0x0005
8.  \#define ZCL\_CLUSTER\_ID\_GEN\_ON\_OFF 0x0006
9.  \#define ZCL\_CLUSTER\_ID\_GEN\_ON\_OFF\_SWITCH\_CONFIG 0x0007
10. \#define ZCL\_CLUSTER\_ID\_GEN\_LEVEL\_CONTROL 0x0008
11. \#define ZCL\_CLUSTER\_ID\_GEN\_ALARMS 0x0009
12. \#define ZCL\_CLUSTER\_ID\_GEN\_TIME 0x000A
13. \#define ZCL\_CLUSTER\_ID\_GEN\_LOCATION 0x000B
14. \#define ZCL\_CLUSTER\_ID\_GEN\_KEY\_ESTABLISHMENT 0x0800
15. 
16. // Closures Clusters
17. \#define ZCL\_CLUSTER\_ID\_CLOSURES\_SHADE\_CONFIG 0x0100
18. 
19. // HVAC Clusters
20. \#define ZCL\_CLUSTER\_ID\_HVAC\_PUMP\_CONFIG\_CONTROL 0x0200
21. \#define ZCL\_CLUSTER\_ID\_HAVC\_THERMOSTAT 0x0201
22. \#define ZCL\_CLUSTER\_ID\_HAVC\_FAN\_CONTROL 0x0202
23. \#define ZCL\_CLUSTER\_ID\_HAVC\_DIHUMIDIFICATION\_CONTROL 0x0203
24. \#define ZCL\_CLUSTER\_ID\_HAVC\_USER\_INTERFACE\_CONFIG 0x0204
25. 
26. // Lighting Clusters
27. \#define ZCL\_CLUSTER\_ID\_LIGHTING\_COLOR\_CONTROL 0x0300
28. \#define ZCL\_CLUSTER\_ID\_LIGHTING\_BALLAST\_CONFIG 0x0301
29. 
30. // Measurement and Sensing Clusters
31. \#define ZCL\_CLUSTER\_ID\_MS\_ILLUMINANCE\_MEASUREMENT 0x0400
32. \#define ZCL\_CLUSTER\_ID\_MS\_ILLUMINANCE\_LEVEL\_SENSING\_CONFIG 0x0401
33. \#define ZCL\_CLUSTER\_ID\_MS\_TEMPERATURE\_MEASUREMENT 0x0402
34. \#define ZCL\_CLUSTER\_ID\_MS\_PRESSURE\_MEASUREMENT 0x0403
35. \#define ZCL\_CLUSTER\_ID\_MS\_FLOW\_MEASUREMENT 0x0404
36. \#define ZCL\_CLUSTER\_ID\_MS\_RELATIVE\_HUMIDITY 0x0405
37. \#define ZCL\_CLUSTER\_ID\_MS\_OCCUPANCY\_SENSING 0x0406
38. 
39. // Security and Safety (SS) Clusters
40. \#define ZCL\_CLUSTER\_ID\_SS\_IAS\_ZONE 0x0500
41. \#define ZCL\_CLUSTER\_ID\_SS\_IAS\_ACE 0x0501
42. \#define ZCL\_CLUSTER\_ID\_SS\_IAS\_WD 0x0502
43. 
44. // Protocol Interfaces
45. \#define ZCL\_CLUSTER\_ID\_PI\_GENERIC\_TUNNEL 0x0600
46. \#define ZCL\_CLUSTER\_ID\_PI\_BACNET\_PROTOCOL\_TUNNEL 0x0601
47. \#define ZCL\_CLUSTER\_ID\_PI\_11073\_PROTOCOL\_TUNNEL 0x0614
48. 
49. // Advanced Metering Initiative (SE) Clusters 
50. \#define ZCL\_CLUSTER\_ID\_SE\_PRICING 0x0700
51. \#define ZCL\_CLUSTER\_ID\_SE\_LOAD\_CONTROL 0x0701
52. \#define ZCL\_CLUSTER\_ID\_SE\_SIMPLE\_METERING 0x0702
53. \#define ZCL\_CLUSTER\_ID\_SE\_MESSAGE 0x0703
54. \#define ZCL\_CLUSTER\_ID\_SE\_REGISTRATION 0x0704
55. \#define ZCL\_CLUSTER\_ID\_SE\_SE\_TUNNELING 0x0705
56. \#define ZCL\_CLUSTER\_ID\_SE\_PRE\_PAYMENT 0x0706

2.每个clusterid由一些属性集合和命令集合组成  
比如  
general领域的basic clusterid就有以下这么多的属性(分为了两部分，基本设备信息和设备配置信息)  
 ![1363445850_2446.jpg][]  
![1363445864_9133.jpg][]  
 general领域的basic clusterid还有1个命令  
![1363446057_7843.jpg][]  
  
clusterid的属性和命令在协议栈的实现，比如general领域的basic clusterid，位于zcl\_general.h

1.  /\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/
2.  /\*\*\* Basic Cluster Attributes \*\*\*/
3.  /\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/
4.  // Basic Device Information
5.  \#define ATTRID\_BASIC\_ZCL\_VERSION 0x0000
6.  \#define ATTRID\_BASIC\_APPL\_VERSION 0x0001
7.  \#define ATTRID\_BASIC\_STACK\_VERSION 0x0002
8.  \#define ATTRID\_BASIC\_HW\_VERSION 0x0003
9.  \#define ATTRID\_BASIC\_MANUFACTURER\_NAME 0x0004
10. \#define ATTRID\_BASIC\_MODEL\_ID 0x0005
11. \#define ATTRID\_BASIC\_DATE\_CODE 0x0006
12. \#define ATTRID\_BASIC\_POWER\_SOURCE 0x0007
13. // Basic Device Settings
14. \#define ATTRID\_BASIC\_LOCATION\_DESC 0x0010
15. \#define ATTRID\_BASIC\_PHYSICAL\_ENV 0x0011
16. \#define ATTRID\_BASIC\_DEVICE\_ENABLED 0x0012
17. \#define ATTRID\_BASIC\_ALARM\_MASK 0x0013
18. ... 
19. /\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/
20. /\*\*\* Basic Cluster Commands \*\*\*/
21. /\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/
22. \#define COMMAND\_BASIC\_RESET\_FACT\_DEFAULT 0x00
23. <span style="font-family:SimSun;"> 
24. </span>

各个领域的clusterid和属性分别位于  
zcl\_general.h-通用  
zcl\_closures.h-室内or 门禁?  
zcl\_hvac.h-空调  
zcl\_lighting.h-照明  
zcl\_ms.h-Measurements and Sensing  
zcl\_ss.h  
zcl\_pi.h  
  
 有了clusterid的属性的宏定义，还需对属性配置(赋值)  
比如，zcl\_samplelight.c中对clusterid ZCL\_CLUSTER\_ID\_GEN\_BASIC的各个属性进行的配置：

1.  CONST zclAttrRec\_t zclSampleLight\_Attrs\[SAMPLELIGHT\_MAX\_ATTRIBUTES\] = 
2.  \{ 
3.  // \*\*\* General Basic Cluster Attributes \*\*\*
4.   \{ 
5.   ZCL\_CLUSTER\_ID\_GEN\_BASIC, // Cluster IDs - defined in the foundation (ie. zcl.h)
6.   \{ // Attribute record
7.   ATTRID\_BASIC\_HW\_VERSION, // Attribute ID - Found in Cluster Library header (ie. zcl\_general.h)
8.   ZCL\_DATATYPE\_UINT8, // Data Type - found in zcl.h
9.   ACCESS\_CONTROL\_READ, // Variable access control - found in zcl.h
10.  (**void** \*)&zclSampleLight\_HWRevision // Pointer to attribute variable
11.  \} 
12.  \}, 
13.  \{ 
14.  ZCL\_CLUSTER\_ID\_GEN\_BASIC, 
15.  \{ // Attribute record
16.  ATTRID\_BASIC\_ZCL\_VERSION, 
17.  ZCL\_DATATYPE\_UINT8, 
18.  ACCESS\_CONTROL\_READ, 
19.  (**void** \*)&zclSampleLight\_ZCLVersion 
20.  \} 
21.  \}, 
22.  \{ 
23.  ZCL\_CLUSTER\_ID\_GEN\_BASIC, 
24.  \{ // Attribute record
25.  ATTRID\_BASIC\_MANUFACTURER\_NAME, 
26.  ZCL\_DATATYPE\_CHAR\_STR, 
27.  ACCESS\_CONTROL\_READ, 
28.  (**void** \*)zclSampleLight\_ManufacturerName 
29.  \} 
30.  \}, 
31.  \{ 
32.  ZCL\_CLUSTER\_ID\_GEN\_BASIC, 
33.  \{ // Attribute record
34.  ATTRID\_BASIC\_MODEL\_ID, 
35.  ZCL\_DATATYPE\_CHAR\_STR, 
36.  ACCESS\_CONTROL\_READ, 
37.  (**void** \*)zclSampleLight\_ModelId 
38.  \} 
39.  \}, 
40.  \{ 
41.  ZCL\_CLUSTER\_ID\_GEN\_BASIC, 
42.  \{ // Attribute record
43.  ATTRID\_BASIC\_DATE\_CODE, 
44.  ZCL\_DATATYPE\_CHAR\_STR, 
45.  ACCESS\_CONTROL\_READ, 
46.  (**void** \*)zclSampleLight\_DateCode 
47.  \} 
48.  \}, 
49.  \{ 
50.  ZCL\_CLUSTER\_ID\_GEN\_BASIC, 
51.  \{ // Attribute record
52.  ATTRID\_BASIC\_POWER\_SOURCE, 
53.  ZCL\_DATATYPE\_UINT8, 
54.  ACCESS\_CONTROL\_READ, 
55.  (**void** \*)&zclSampleLight\_PowerSource 
56.  \} 
57.  \}, 
58.  \{ 
59.  ZCL\_CLUSTER\_ID\_GEN\_BASIC, 
60.  \{ // Attribute record
61.  ATTRID\_BASIC\_LOCATION\_DESC, 
62.  ZCL\_DATATYPE\_CHAR\_STR, 
63.  (ACCESS\_CONTROL\_READ | ACCESS\_CONTROL\_WRITE), 
64.  (**void** \*)zclSampleLight\_LocationDescription 
65.  \} 
66.  \}, 
67.  \{ 
68.  ZCL\_CLUSTER\_ID\_GEN\_BASIC, 
69.  \{ // Attribute record
70.  ATTRID\_BASIC\_PHYSICAL\_ENV, 
71.  ZCL\_DATATYPE\_UINT8, 
72.  (ACCESS\_CONTROL\_READ | ACCESS\_CONTROL\_WRITE), 
73.  (**void** \*)&zclSampleLight\_PhysicalEnvironment 
74.  \} 
75.  \}, 
76.  \{ 
77.  ZCL\_CLUSTER\_ID\_GEN\_BASIC, 
78.  \{ // Attribute record
79.  ATTRID\_BASIC\_DEVICE\_ENABLED, 
80.  ZCL\_DATATYPE\_BOOLEAN, 
81.  (ACCESS\_CONTROL\_READ | ACCESS\_CONTROL\_WRITE), 
82.  (**void** \*)&zclSampleLight\_DeviceEnable 
83.  \} 
84.  \}, 
85. 
86. // \*\*\* Identify Cluster Attribute \*\*\*
87.  \{ 
88.  ZCL\_CLUSTER\_ID\_GEN\_IDENTIFY, 
89.  \{ // Attribute record
90.  ATTRID\_IDENTIFY\_TIME, 
91.  ZCL\_DATATYPE\_UINT16, 
92.  (ACCESS\_CONTROL\_READ | ACCESS\_CONTROL\_WRITE), 
93.  (**void** \*)&zclSampleLight\_IdentifyTime 
94.  \} 
95.  \}, 
96. 
97. // \*\*\* On/Off Cluster Attributes \*\*\*
98.  \{ 
99.  ZCL\_CLUSTER\_ID\_GEN\_ON\_OFF, 
100.  \{ // Attribute record
101.  ATTRID\_ON\_OFF, 
102.  ZCL\_DATATYPE\_UINT8, 
103.  ACCESS\_CONTROL\_READ, 
104.  (**void** \*)&zclSampleLight\_OnOff 
105.  \} 
106.  \}, 
107. \}

3.除了clusterid的专有命令之外，还有部分通用命令，比如读取clusterid的某个属性，  
![1363446895_2601.jpg][]  
![1363446914_9172.jpg][]  
在协议栈的实现，位于zcl.h

1.  /\*\*\* Foundation Command IDs \*\*\*/
2.  \#define ZCL\_CMD\_READ 0x00
3.  \#define ZCL\_CMD\_READ\_RSP 0x01
4.  \#define ZCL\_CMD\_WRITE 0x02
5.  \#define ZCL\_CMD\_WRITE\_UNDIVIDED 0x03
6.  \#define ZCL\_CMD\_WRITE\_RSP 0x04
7.  \#define ZCL\_CMD\_WRITE\_NO\_RSP 0x05
8.  \#define ZCL\_CMD\_CONFIG\_REPORT 0x06
9.  \#define ZCL\_CMD\_CONFIG\_REPORT\_RSP 0x07
10. \#define ZCL\_CMD\_READ\_REPORT\_CFG 0x08
11. \#define ZCL\_CMD\_READ\_REPORT\_CFG\_RSP 0x09
12. \#define ZCL\_CMD\_REPORT 0x0a
13. \#define ZCL\_CMD\_DEFAULT\_RSP 0x0b
14. \#define ZCL\_CMD\_DISCOVER 0x0c
15. \#define ZCL\_CMD\_DISCOVER\_RSP 0x0d
16. 
17. \#define ZCL\_CMD\_MAX ZCL\_CMD\_DISCOVER\_RSP
18.

[1363444660_8609.jpg]: https://img-my.csdn.net/uploads/201303/16/1363444660_8609.jpg
[1363444979_2847.jpg]: https://img-my.csdn.net/uploads/201303/16/1363444979_2847.jpg
[1363444991_8519.jpg]: https://img-my.csdn.net/uploads/201303/16/1363444991_8519.jpg
[1363445298_7225.jpg]: https://img-my.csdn.net/uploads/201303/16/1363445298_7225.jpg
[1363445317_6687.jpg]: https://img-my.csdn.net/uploads/201303/16/1363445317_6687.jpg
[1363445850_2446.jpg]: https://img-my.csdn.net/uploads/201303/16/1363445850_2446.jpg
[1363445864_9133.jpg]: https://img-my.csdn.net/uploads/201303/16/1363445864_9133.jpg
[1363446057_7843.jpg]: https://img-my.csdn.net/uploads/201303/16/1363446057_7843.jpg
[1363446895_2601.jpg]: https://img-my.csdn.net/uploads/201303/16/1363446895_2601.jpg
[1363446914_9172.jpg]: https://img-my.csdn.net/uploads/201303/16/1363446914_9172.jpg