Digi XBee User Manual

API Operation Send Public Profile Commands with the API
XBee/XBee-PRO® S2C ZigBee® RF Module
214
Send Public Profile Commands with the API
You can use the XBee API using the Explicit Transmit API frame (0x11) to send commands in public
profiles such as Smart Energy and Home Automation. Sending public profile commands with the
Explicit Transmit API frame requires some formatting of the data payload field. Most of the public
profile commands fit into the ZigBee Cluster Library (ZCL) architecture as described in Send ZigBee
Cluster Library (ZCL) commands with the API.
The following table shows how you can use the Explicit API frame to send a demand response and load
control message (cluster ID 0x701) in the smart energy profile (profile ID 0x0109) in the revision 14
Smart Energy specification. The device sends a “Load Control Event”message (command ID 0x00) and
to a device with 64- bit address of 0x0013A200 40401234 with a 16-bit address of 0x5678. The event
starts a load control event for water heaters and smart appliances for a duration of 1 minute, starting
immediately.
Note When sending public profile commands, set the AO command to 1 to enable the explicit receive
API frame. This provides indication of the source 64- and 16-bit addresses, cluster ID, profile ID, and
endpoint information for each received packet. This information is required to properly decode
received data.
Frame specific data
Frame Fields Offset
Description
Frame type 3
Frame ID 4 Identifies the serial port data frame for the host to
correlate with a subsequent transmit status. If set
to 0, no transmit status frame will be sent out the
serial port.
64-bit
destination
address
MSB 5 The 64-bit address of the destination device (big
endian byte order). For unicast transmissions, set to
the 64-bit address of the destination device, or to
0x0000000000000000 to send a unicast to the
coordinator. Set to 0x000000000000FFFF for
broadcast.
6
7
8
9
10
11
LSB
12
16-bit
destination
network
address
MSB
13
The 16-bit address of the destination device (big
endian byte order). Set to 0xFFFE for broadcast, or if
the 16-bit address is unknown.
LSB
14
Source
endpoint
15 Set to the source endpoint on the sending device.
(0x41 arbitrarily selected).

Digi XBee Specifications

General

Brand	Digi
Model	XBee
Category	Control Unit
Language	English