16-bit Receive Packet - 0x81
Request frames:
- Transmit Request - 0x10
- 64-bit Transmit Request - 0x00
- 16-bit Transmit Request - 0x01
Description
This frame type is emitted when a device configured with legacy API output— = 2—receives an RF data packet from a device configured to use 16-bit source addressing—MY < 0xFFFE.
Note This frame format is deprecated and should only be used by customers who require compatibility with legacy Digi RF products. For new designs, we encourage you to use Receive Packet frame - 0x90 for reception of API transmissions.
Format
The following table provides the contents of the frame. For details on frame structure, see API frame specifications.
| 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 |
16-bit Receive Packet - 0x81 |
| 4 | 16-bit | 16-bit source address |
The sender's 16-bit network address. |
| 6 | 8-bit | RSSI | Received Signal Strength Indicator. The Hexadecimal equivalent of (-dBm) value. For example if RX signal strength is -40 dBm, then 0x28 (40 decimal) is returned. |
| 7 | 8-bit |
Options |
Bit field of options that apply to the received message:
Note Option values may be combined. |
| 8-n | variable | RF 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 16-bit address of 1234 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 = 2.
7E 00 0B 81 12 34 5E 01 54 78 44 61 74 61 93
|
Frame type |
64-bit source |
RSSI |
Rx options |
Received data |
|---|---|---|---|---|
| 0x80 |
0x1234 |
0x5E | 0x01 | 0x547844617461 |
| Output |
|
-94 dBm | ACK was sent | "TxData" |
PDF
