Supported modems

Digi Embedded Yocto includes out-of-box support for the following cellular devices:

Configure XBee for cellular connectivity

Before you can use an XBee cellular modem, you must configure it. Digi recommends you use the XBee Configuration and Test Utility (XCTU). XCTU is a multi-platform program developed by Digi that enables users to interact with Digi radio frequency (RF) devices through a graphical interface. The application includes built-in tools that make it easy to set up, configure, and test Digi RF devices. For instructions on downloading and using XCTU, see the XCTU User Guide.

Once you have installed XCTU in your PC, follow these steps:

  1. Insert an unlocked SIM card into the XBee Cellular modem.

  2. Plug the XBee Cellular into the XBee development board.

  3. Connect your XBee development board to the PC.

  4. Open the XCTU configuration tool.

  5. Click the Configuration working modes button.

  6. Select an XBee module from the Radio Modules list.

  7. Configure your device:

Digi XBee3 Cellular LTE Cat 1 supports USB communication with the cellular modem. To configure it, follow these steps:

  1. In the P1 (DIO11) field, select USB Direct [7] and click the Write button.

Digi XBee3 Cellular NB-IoT supports USB communication with the cellular modem. To configure it, follow these steps:

  1. In the P1 (DIO11) field, select USB Direct [7] and click the Write button.

  2. In the DO (Device Options) field, enter 4 (Enable USB direct mode) and click the Write button.

  3. In the N# (Network Technology) field, select NB-IoT Only [3] and click the Write button.

  4. Enable the bands. The bands are specified as a bitmask given as a hexadecimal value. To enable bands 8 and 20, in the BN field, enter 80080 and click the Write button.

  5. In the CP (Carrier Profile) field, select No Profile (1) and click the Write button.

Digi XBee3 Cellular LTE-M supports USB communication with the cellular modem. To configure it, follow these steps:

  1. In the P1 (DIO11) field, select USB Direct [7] and click the Write button.

  2. In the DO (Device Options) field, enter 4 (Enable USB direct mode) and click the Write button.

  3. In the N# (Network Technology) field, select LTE-M Only [2] and click the Write button.

  1. if your carrier requires you to set a specific APN, type that APN value in the AN (Access Point Name) field and click the Write button. Otherwise, go to the next step.

  2. Reset the module.

  3. Read the radio settings and verify that your modifications were saved.

  4. Connect your XBee cellular device to your ConnectCore 8X SBC Pro board.

System support for cellular connectivity

The cellular support in Digi Embedded Yocto is based on the NetworkManager and ModemManager open source software packages. If the cellular device is configured correctly and plugged into the ConnectCore 8X SBC Pro board, the boot process automatically detects and initializes it. You can verify whether the cellular device was detected by executing the following command:

~# mmcli -L

Found 1 modems:
        /org/freedesktop/ModemManager1/Modem/0 [u-blox] SARA-R410M-02B

~#

Known issues

  • When you are using ModemManager, the initialization of some cellular modems could fail if there is no power cycling of the card between two initializations. This could happen during a software reset. To avoid this situation, we recommend you incorporate a mechanism in your carrier board to power cycle the modem at boot time.