Receive Packet - 0x90

Request frames:

Description

This frame type is emitted when a device configured with standard API output—AO (API 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 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

Receive Packet - 0x90

4 64-bit 64-bit source address

The sender's 64-bit address.

12 16-bit Reserved

Unused, but this field is typically set to 0xFFFE.

14 8-bit Receive options

Bit field of options that apply to the received message:

  • Bit 0: Packet was Acknowledged [0x01]
  • Bit 1: Packet was sent as a broadcast [0x02]
  • Bit 2: Reserved
  • Bit 3: Reserved
  • Bit 4: Reserved
  • Bit 5: Reserved
  • Bit 6: Reserved
  • Bit 6, 7: DigiMesh delivery method
    • b’00 = <invalid option>

    • b’01 = Point-multipoint [0x40]

    • b’10 = Directed Broadcast [0x80]

    • b’11 = DigiMesh [0xC0]

Note Option values may be combined.

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
41AEB54E

0x5614 0xC1 0x547844617461 
Output
Unused ACK was sent in DigiMesh mode "TxData"