Request frames:
This frame type is emitted when a network transmission request completes. The status field of this frame indicates whether the request succeeded or failed and the reason. This frame type provides additional networking details about the transmission.
This frame is only emitted if the Frame ID in the request is non-zero.
Note Broadcast transmissions are not acknowledged and always return a status of 0x00, even if the delivery failed.
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 |
Transmit Status - 0x8B |
4 | 8-bit | Frame ID | Identifies the data frame for the host to correlate with a prior request. |
5 | 16-bit | Reserved |
Unused, but this field is typically set to 0xFFFE. |
7 | 8-bit | Transmit retry count | The number of application transmission retries that occur. |
8 | 8-bit | Delivery status |
Complete list of delivery statuses: 0x00 = Success 0x01 = MAC ACK failure 0x02 = CCA/LBT failure 0x03 = Indirect message unrequested / no spectrum available 0x21 = Network ACK failure 0x25 = Route not found 0x31 = Internal resource error 0x32 = Resource error lack of free buffers, timers, etc. 0x74 = Data payload too large 0x75 = Indirect message unrequested |
9 | 8-bit | Discovery status |
Complete list of delivery statuses: 0x00 = No discovery overhead 0x02 = Route discovery |
EOF | 8-bit | Checksum | 0xFF minus the 8-bit sum of bytes from offset 3 to this byte (between length and checksum). |