Receive Packet - 0x90
Request frames:
Description
This frame type is emitted when a device configured with standard API output—AO (API Output Options) = 0—receives an RF data packet.
Typically this frame is emitted as a result of a device on the network sending serial data using the Transmit Request - 0x10 or Explicit Addressing Command Request - 0x11 addressed either as a broadcast or unicast transmission.
Format
The following table provides the contents of the frame. For details on frame structure, see API frame format.
Offset | Size | Frame Field | Description |
---|---|---|---|
0 | 8-bit | Start Delimiter | Indicates the start of an API frame. |
1 | 16-bit | Length | Number of bytes between the length and checksum. |
3 | 8-bit | Frame type |
Receive Packet - 0x90 |
4 | 64-bit | 64-bit source address |
The sender's 64-bit address. If the sender's 16-bit address is used, then it will return all 0xFF. |
12 | 16-bit | 16-bit source address |
The sender's 16-bit network address. If the sender's 64-bit address is used, then it will be 0xFFFE. |
14 | 8-bit | Receive options |
Bit field of options that apply to the received message:
|
15-n | variable | Received data | The RF payload data that the device receives. |
EOF | 8-bit | Checksum | 0xFF minus the 8-bit sum of bytes from offset 3 to this byte (between length and checksum). |
Examples
Each example is written without escapes (AP = 1) and all bytes are represented in hex format. For brevity, the start delimiter, length, and checksum fields have been excluded.
64-bit unicast
A device with the 64-bit address of 0013A20041AEB54E sent a unicast transmission to a specific device with the payload of "TxData". The following frame is emitted if the destination is configured with AO = 0.
7E 00 12 90 00 13 A2 00 41 AE B5 4E FF FE C1 54 78 44 61 74 61 C4
Frame type | 64-bit source | Reserved | Rx options | Received data |
---|---|---|---|---|
0x90 |
0x0013A200 |
0xFFFE | 0x00 | 0x547844617461 |
Output |
|
Use 64-bit address | Unicast | "TxData" |