Api Operation With Escaped Characters (Ap Parameter = 2) - Digi XBee 3 Cellular LTE-M User Manual

Operate in API mode
Frame fields
Start delimiter
Length
Frame data
Checksum
Any data received prior to the start delimiter is silently discarded. If the frame is not received correctly
or if the checksum fails, the XBee replies with a radio status frame indicating the reason for the
failure.

API operation with escaped characters (AP parameter = 2)

Setting API to 2 allows escaped control characters in the API frame. Due to its increased complexity,
we only recommend this API mode in specific circumstances. API 2 may help improve reliability if the
serial interface to the device is unstable or malformed frames are frequently being generated.
When operating in API 2, if an unescaped 0x7E byte is observed, it is treated as the start of a new API
frame and all data received prior to this delimiter is silently discarded. For more information on using
this API mode, see the
API escaped operating mode works similarly to API mode. The only difference is that when working in
API escaped mode, the software must escape any payload bytes that match API frame specific data,
such as the start-of-frame byte (0x7E). The following table shows the structure of an API frame with
escaped characters:
Frame fields Byte
Start 1
delimiter
Length 2 - 3
Frame data 4 - n
Checksum n + 1
Start delimiter field
This field indicates the beginning of a frame. It is always 0x7E. This allows the device to easily detect a
new incoming frame.
Escaped characters in API frames
If operating in API mode with escaped characters (AP parameter = 2), when sending or receiving a
serial data frame, specific data values must be escaped (flagged) so they do not interfere with the
data frame sequencing. To escape an interfering data byte, insert 0x7D and follow it with the byte to
be escaped (XORed with 0x20).
The following data bytes need to be escaped:
0x7E: start delimiter
n
0x7D: escape character
n
Digi XBee® 3 Cellular LTE-M/NB-IoT Global Smart Modem User Guide
Byte Description
1 0x7E
2 - 3 Most Significant Byte, Least Significant Byte
4 - number (n) API-specific structure
n + 1 1 byte
Escaped Characters and API Mode 2
Description
0x7E
Most Significant Byte, Least Significant
Byte
API-specific structure
1 byte
API frame format
in the Digi Knowledge base.
Characters escaped if
needed
248