Digi XBee LTE-M/NB-IoT Element

The XBee LTE-M/NB-IoT element is used to send data over a cellular network. This element is for using the Digi XBee3 Cellular LTE-M/NB-IoT cellular modem. This cellular modem communicates over UART using an AT command set. It takes several seconds to perform HTTP transactions, so it’s recommended to send data infrequently.

Given the high RAM usage of this element for storing HTTP packets, it’s only available on the following platforms:

  • Arduino Mega
  • NXP Rapid IoT
  • Maxim MAX32630 Feather
  • ESP32 and its variants

The XBee LTE-M/NB-IoT is a protocol element that can be imported into the Element Toolbox through the Add Element Add Element button located in the toolbox from the Embedded tab.

Element Icon
XBee LTE-M/NB-IoT Element

Properties

The following properties can be changed for the XBee LTE-M/NB-IoT element:

Name

The name of the element.

UART Driver Instance

The UART driver instance to use.

NOTE: The chosen UART driver instance must be exclusive to the cellular modem. It must not be shared with debug print data.

GPIO Driver Instance

The chosen GPIO driver instance to use.

Reset Pin

The GPIO pin that resets the modem. This pin will automatically be used to reset the modem on startup. Set to ATMO_GPIO_NO_PIN if unused.

Destination Phone Number

Phone number used for SMS messages. This should be formatted with digits only (no spaces or dashes), with an optional + entered at the beginning of the number for the country code.

Triggers

The following triggers are available to execute events from within the XBee LTE-M/NB-IoT element:

Triggered

Execute an event when the source element connected to the XBee LTE-M/NB-IoT triggers.

SMS Sent

Execute an event after an SMS message is sent.

Abilities

The following abilities are available for the XBee LTE-M/NB-IoT element when its source element triggers:

Trigger

Trigger the element(s) that follow the XBee LTE-M/NB-IoT element.

Send SMS

Send an SMS to the phone number specified in the element’s properties.