Digi XBee, Руководство пользователя, Страница: 117 / 307

Network commissioning and diagnostics Group Table API
XBee/XBee-PRO® S2C ZigBee® RF Module 117
Preamble = “11 01 “+LocalDevic”FFFE E6 E7 0006 C105 00 00"
The packet is addressed to the local node, using a source endpoint of 0xE6, clusterID of 0x0006, and
profileID of 0xC105. The destination endpoint E7 holds the endpoint parameter for the “Add Group”
command.
ZCL_header = “01 ee 00"
The first field (byte) is a frame control field which specifies a Cluster Specific command (0x01) using a
Client->Server direction(0x00). The second field is a transaction sequence number used to associate
the response with the command request. The third field is the command identifier for “Add Group”
(0x00)
1
.
ZCL_payload = “3412 04 41 42 43 44"
The first two bytes is the group Id to add in little endian representation. The next byte is the string
name length (00 if there is no string). The other bytes are the descriptive ASCII string name (“ABCD”)
for the group table entry. The string is represented with its length in the first byte, and the other
bytes containing the ASCII characters.
The example packet in raw hex byte form:
7e001e11010013a2004047b55cfffee6e70006c105000001ee0034120441424344c7
The response in raw hex byte form, consisting of two packets:
7e0018910013a2004047b55cfffee7e68006c1050009ee0000341238
7e00078b01fffe00000076
The response in decoded form:
ZigBee Explicit Rx Indicator
API 0x91 64DestAddr 0x0013A2004047B55C 16DestAddr 0xFFFE SrcEP 0xE7 DestEP 0xE6
ClusterID 0x8006 ProfileID 0xC105 Options 0x00
RF_Data 0x09EE00003412
The response in terms of Preamble, ZCL Header, and ZCL payload:
Preamble = “910013a2004047b55cfffee7e68006c10500”
The packet has its endpoint values reversed from the request, and the clusterID is 0x8006 indicating a
Group cluster response.
ZCL_header = “09 ee 00"
The first field is a frame control field which specifies a Cluster Specific command (0x01) using a Server-
> Client direction. The second field is a transaction sequence number used to associate the response
with the command request. The third field is the command identifier “Add Group” (0x00)
2
.
ZCL_payload = “00 3412"
The first byte is a status byte (SUCCESS=0x00)
3
. The next two bytes hold the group ID (0x1234) in little
endian form.
This is the decoded second message, which is a Tx Status for the original command request. If the
FrameId value in the original command request had been zero, or if no space was available in the
transmit UART buffer, then no Tx Status message occurs.
ZigBee Tx Status
API 0x8B FrameID 0x01 16DestAddr 0xFFFE
Transmit Retries 0x00 Delivery Status 0x00 Discovery Status 0x00 Success
1
ZigBee Cluster Library , document 075123r02: Add Group Command, section 3.6.2.3.1.
2
ZigBee Cluster Library , document 075123r02: Add Group Command, section 3.6.2.3.1.
3
ZigBee Cluster Library , document 075123r02: Add Group Response, section 3.6.2.4.1 and Status Enumerations,
section 2.5.3.