Tx Request With Tls Profile - 0X23 - Digi XBee 3 Cellular LTE-M User Manual

API frames

Tx Request with TLS Profile - 0x23

Description
The frame gives greater control to the application over the TLS settings used for a connection.
A TX Request with TLS Profile frame implies the use of TLS and behaves similar to the TX Request
(0x20) frame, with the protocol field replaced with a TLS Profile field to choose from the profiles
configured with the $0, $1, and $2 configuration commands.
Note For NB-IoT, TCP support is dependent on the network. Contact your network provider for
details.
Format
The following table provides the contents of the frame. For details on frame structure, see
format.
Field name
Frame type
Frame ID
Destination
address
Destination port
Source port
TLS profile
Digi XBee® 3 Cellular LTE-M/NB-IoT Global Smart Modem User Guide
Field
value Data type Description
0x23 Byte
Byte Reference identifier used to match status responses. 0
disables the TX Status frame.
32-bit big
endian
16-bit
big endian
16-bit If the source port is 0, the device attempts to send the
big endian frame data using an existing open socket with a
destination that matches the destination address and
destination port fields of this frame. If there is no
matching socket, then the device attempts to open a
new socket.
If the source port is non-zero, the device attempts to
send the frame data using an existing open socket with
a source and destination that matches the source port,
destination address, and destination port fields of this
frame. If there is no matching socket, the TX Status
frame returns an error.
Byte Zero-indexed number that indicates the profile as
specified by the corresponding $<num> command.
Tx Request with TLS Profile - 0x23
API frame
257