User Data Relay - 0X2D; Example Use Cases - Digi XBee 3 Cellular LTE-M User Manual

API frames

User Data Relay - 0x2D

Description
Allows for data to be sent to an interface with a designation of a target interface for the data to be
output on. The frame can be sent or received from any of the following interfaces: MicroPython
(internal interface), UART, and BLE. This frame is used in conjunction with
0xAD.
You can send and receive User Data Relay Frames from MicroPython. See
Relay frames in the MicroPython Programming Guide.
Format
The following table provides the contents of the frame. For details on frame structure, see
format.
Field
Field name value
Frame type 0x2D
Frame ID
Destination
interface
Data
Error cases
The Frame ID is used to report error conditions in a method consistent with existing transmit frames.
The error codes are mapped to statuses. The following conditions result in an error that is reported in
a TX Status frame, referencing the frame ID from the 0x2d request.
Invalid interface (0x7c) : The user specified a destination interface that does not exist.
n
Interface not accepting frames (0x7d): The destination interface is a valid interface, but is not
n
in a state that can accept data. For example UART not in API mode, BLE does not have a GATT
client connected, or buffer queues are full.

Example use cases

These examples show you can use this frame.
You can use the frame to send data to an external processor through the XBee UART/SPI via
n
the BLE connection. Use a cellphone to send the frame with UART interface as a target. Data
contained within the frame is sent out the UART contained within an Output Frame. The
external processor then receives and acts on the frame.
Digi XBee® 3 Cellular LTE-M/NB-IoT Global Smart Modem User Guide
Data
type Description
Byte
Reference identifier used to match TX Status frames
0x89) sent for errors. A value of 0 disables the TX Status frame.
Byte 0 = Serial port (SPI, or UART when in API mode)
1 = BLE
2 = MicroPython
Variable
User Data Relay - 0x2D
User Data Relay Output -
Send and receive User Data
API frame
(type
265