Digi XBee3 LTE-M/NB-IoT Element

The XBee3 LTE-M/NB-IoT element is used to send data over a cellular network. This element is for using the Digi XBee33 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 XBee3 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.

Properties

The following properties can be changed for the XBee3 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 XBee3 LTE-M/NB-IoT element:

Triggered

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

SMS Sent

Execute an event after an SMS message is sent.

Abilities

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

Trigger

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

Send SMS

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