Explicit Addressing Command frame - 0x11
Description
This frame is similar to Transmit Request (0x10), but it also requires you to specify the application-layer addressing fields: endpoints, cluster ID, and profile ID.
This frame causes the device to send payload data as an RF packet to a specific destination, using specific source and destination endpoints, cluster ID, and profile ID.
- For broadcast transmissions, set the 64-bit destination address to 0x000000000000FFFF .
- For all other transmissions, setting the 16-bit address to the correct 16-bit address helps improve performance when transmitting to multiple destinations. If you do not know a 16-bit address, set this field to 0xFFFE (unknown). If successful, the Transmit Status frame (0x8B) indicates the discovered 16-bit address.
You can set the broadcast radius from 0 up to NH to 0xFF. If set to 0, the value of NH specifies the broadcast radius (recommended). This parameter is only used for broadcast transmissions.
You can read the maximum number of payload bytes with the NP command.
Note Using source routing reduces the RF payload by two bytes per intermediate hop in the source route.
Format
The following table provides the contents of the frame. For details on the frame structure, see API frame format.
| Frame data fields | Offset | Description | ||
|---|---|---|---|---|
| Frame type | 3 | 0x11 | ||
| Frame ID | 4 |
Identifies the data frame for the host to correlate with a subsequent ACK. If set to 0, the device does not send a response. |
||
| 64-bit destination Address | 5-12 |
MSB first, LSB last. Set to the 64-bit address of the destination device. Reserved 64-bit address for the coordinator = 0x0000000000000000 Broadcast = 0x000000000000FFFF |
||
| 16-bit destination Network Address |
|
Set to the 16-bit address of the destination device, if known. Set to 0xFFFE if the address is unknown, or if sending a broadcast. | ||
|
Source Endpoint |
15 | Source Endpoint for the transmission. | ||
|
Destination Endpoint |
16 |
Destination Endpoint for the transmission. |
||
|
Cluster ID |
|
Cluster ID used in the transmission. | ||
| Profile ID | 19-20 | Profile ID used in the transmission. | ||
| Broadcast Radius | 21 |
Sets the maximum number of hops a broadcast transmission can traverse. If set to 0, the device sets the transmission radius to the network maximum hops value. |
||
| Transmission Options | 22 |
Bitfield of supported transmission options. Supported values include the following: 0x01 - Disable retries 0x04- Indirect Addressing 0x08- Multicast Addressing 0x20 - Enable APS encryption (if EE = 1) 0x40 - Use the extended transmission timeout for this destination Enabling APS encryption decreases the maximum number of RF payload bytes by 4 (below the value reported by NP). Setting the extended timeout bit causes the stack to set the extended transmission timeout for the destination address. See Transmission, addressing, and routing. All unused and unsupported bits must be set to 0. |
||
| Data Payload | 23-n |
Up to NP bytes per packet. Sent to the destination device. |
Example
The following example sends a data transmission to a device with:
- 64-bit address: 0x00
- Source endpoint: 0xA0
- Destination endpoint: 0xA1
- Cluster ID: 0x1554
- Profile ID: 0xC105
- Payload: TxData
|
Frame data fields |
Offset |
Example |
|---|---|---|
|
Start delimiter |
0 |
0x7E |
|
Length |
MSB 1 |
0x00 |
|
LSB 2 |
0x1A |
|
|
Frame type |
3 |
0x11 |
| Frame ID | 4 | 0x01 |
|
64-bit destination address
|
MSB 5 |
0x00 |
|
6 |
0x00 |
|
|
7 |
0x00 | |
|
8 |
0x00 | |
|
9 |
0x00 | |
|
10 |
0x00 | |
|
11 |
0x00 | |
|
LSB12 |
0x00 | |
|
16-bit destination Network Address |
MSB 13 |
0xFF |
| LSB 14 |
0xFE |
|
|
Source endpoint |
15 |
0xA0 |
|
Destination endpoint |
16 |
0xA1 |
|
Cluster ID |
17 |
0x15 |
|
18 |
0x54 |
|
|
Profile ID |
19 |
0xC1 |
|
20 |
0x05 |
|
|
Broadcast radius |
21 |
0x00 |
|
Transmit options |
22 |
0x00 |
|
Data payload |
23 |
0x54 |
|
24 |
0x78 |
|
|
25 |
0x44 |
|
|
26 |
0x61 |
|
|
27 |
0x74 |
|
|
28 |
0x61 |
|
|
Checksum |
29 |
0x3A |
PDF
