Configure cellular modem

To configure your TX40's cellular modem, you need to modify the network and SIM settings.

Required configuration items

Enable the cellular modem.
The cellular modem is enabled by default.
Determine the SIM slot that will be used when connecting to the cellular network.
Configure the maximum number of interfaces that can use the modem.
Enable carrier switching, which allows the modem to automatically match the carrier for the active SIM.
Carrier switching is enabled by default.
Configure the access technology.
Determine which cellular antennas to use.

Additional configuration items

If Active SIM slot is set to Any, by default the device uses the SIM slot that was last used or was operational. As an alternative, you can specify a preferred SIM slot.

In the event of a failover to a non-preferred SIM, or if manual SIM switching is used to switch to a non-preferred SIM, the modem will attempt to reconnect to the SIM in the preferred SIM slot.
5G single slice (NSSAI) support

The Digi TX40 cellular modem supports 5G technology. In order to take advantage of the 5G capabilities of the device, you must use a SIM that has been provisioned for 5G support.

To configure the modem:

 Web

Log into Digi Remote Manager, or log into the local Web UI as a user with full Admin access rights.
Access the device configuration:
Remote Manager:
1. Locate your device as described in Use Digi Remote Manager to view and manage your device.
2. Click the Device ID.
3. Click Settings.
4. Click to expand Config.
Local Web UI:
1. On the menu, click System. Under Configuration, click Device Configuration.
  The Configuration window is displayed.
For single-cellular models, click Network > Modems > WWAN cellular modem or WWAN1 cellular modem.

Modem configurations are enabled by default. Click to toggle Enable to off to disable.
The Active SIM slot selection is used to determine which SIM slot the modem will attempt to connect with. For Active SIM slot, select one of the following options:
- Any: Use the SIM slot that was last used or was last operational. The default is Any.
- SIM1: Only use SIM slot 1 with the modem
- SIM2: Only use SIM slot 2 with the modem
If you set the Active SIM slot to Any, the Preferred SIM slot option displays. Options for Preferred SIM slot are:
- None: The modem attempts to connect to the SIM in the SIM slot that was last used or was last operational. None is the default.
- SIM slot: Select the SIM slot that should be considered the preferred slot for this modem. If a preferred SIM is configured, the Preferred SIM slot check schedule displays in the configuration settings. In the event of a SIM failover, or if manual SIM switching is used to switch SIM slots, the modem attempts to reconnect to the preferred SIM at the interval or schedule configured in the Preferred SIM slot check schedule settings. If a Preferred SIM slot is selected, you can choose the type of schedule:
  - On boot - Runs task when device starts.
  - Interval - Runs task once per hour.
  - Set time - Runs task at a set time.
  - During system maintenance window - Runs task only during the period of time designated for system maintenance.
  - Manual - Task is not performed automatically.
  - After - Task runs for a fixed time interval on a different SIM and then goes back to the preferred SIM.
For Maximum number of interfaces, type the number of interfaces that can be configured to use this modem. This is used when using dual-APN SIMs. The default is 1.
For Signal strength query interval, type or select the amount of time the system waits before polling the modem for signal information.
Allowed values are any number of weeks, days, hours, minutes, or seconds, and take the format number{w|d|h|m|s}.
For example, to set Signal strength query interval to ten minutes, enter 10m or 600s.
The default is 10s.
Enable Carrier switching to allow the modem to automatically match the carrier for the active SIM. Carrier switching is enabled by default.
For Access technology, select the type of cellular technology that this modem should use to access the cellular network, or select All technologies to configure the modem to use the best available technology. The default is All technologies.
For Antennas, select whether the modem should use the main antenna, the auxiliary antenna, or both the main and auxiliary antennas.

Note For 4G bands and 5G bands, specify the frequency bands you want to include or exclude. By default, all bands are used. To only use certain bands, separate each band in the list with a space (for example, B1 B3 B5). To exclude certain bands, separate each band in the list with a space and precede each band with an exclamation point (for example, !B1 !B5).

CAUTION! Make sure to confirm with your service provider that the bands you want to include or exclude are accurate. Connection issues may occur if a service provider changed any of the frequency bands they use for their network and you have set limitations on the bands to which the TX40 can connect.

(Optional) For 4G bands, specify the 4G bands.
(Optional) For 5G bands, specify the 5G bands.
Click to expand Default Slice Information.
1. Click Enable to enable the default slice for this modem.
2. For Slice Service Type (SST), select the type of slice to be used.
  Allowed values are:
  - eMBB: Enhanced Mobile Broadband.
  - URLLC: Ultra-Reliable Low-Latency Communications.
  - MIoT: Massive Internet of Things.
  - Custom: Custom 5G slice where device is forced to use the network you specify.
    - For Custom SST value, specify the PLMN ID number.
  The default is eMBB.
3. (Optional) For Slice Differentator (SD), type additional information that supplements the SST to differentiate among multiple network slices of the same SST.
Click Apply to save the configuration and apply the change.

 Command line

Select the device in Remote Manager and click Actions > Open Console, or log into the TX40 local command line as a user with full Admin access rights.
Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.
At the command line, type config to enter configuration mode:
```
> config
(config)>
```
Modem configurations are enabled by default. To disable:
```
(config)> network modem wwan1 enable false
(config)>
```
Set the SIM slot that should be used by the modem:
```
(config)> network modem wwan1 sim_slot value
(config)>
```
where value is one of the following:
- any: Uses either SIM slot.
- 1: Uses the first SIM slot.
- 2. Uses the second SIM slot.
The default is any.
If sim_slot is set to any, set the SIM slot that should be considered the preferred slot for this modem:
```
(config)> network modem wwan1 sim_slot_preference value
(config)>
```
where value is one of the following:
- none: Does not consider either SIM slot to be the preferred slot.
- 1: Configures the first SIM slot as the preferred SIM slot.
- 2. Configures the second SIM slot as the preferred SIM slot.
In the event of a failover to a non-preferred SIM, or if manual SIM switching is used to switch to a non-preferred SIM, the modem will attempt to reconnect to the SIM in the preferred SIM slot. The default is none.
To set the preferred SIM slot check schedule:
```
(config)> network modem modem sim_slot_preference_value
```
where value is one of the following:
- 1: SIM slot 1.
- 2. SIM slot 2.
```
(config)> ...run-time when value  
```
where value is one of the following:
- after
- boot
- interval
- maintenance_window
- manual
- set_time
The default is set_time.
Set the amount of time the system waits before polling the modem for signal information:
```
(config)> network modem wwan1 query_interval value
(config)>
```
where value is any number of weeks, days, hours, minutes, or seconds, and takes the format number{w|d|h|m|s}.
For example, to set query_interval to ten minutes, enter either 10m or 600s:
```
(config)> network modem wan query_interval  600s
(config)> 
```
The default is 10s.
Set the maximum number of interfaces. This is used when using dual-APN SIMs. The default is 1.
```
(config)> network modem wwan1 max_intfs int
(config)>
```
Carrier switching allows the modem to automatically match the carrier for the active SIM. Carrier switching is enabled by default. To disable:
```
(config)> network modem wwan1 carrier_switch false
(config)>
```

Set the type of cellular technology that this modem should use to access the cellular network:

(config)> network modem wwan1 access_tech value
(config)>

Available options for value vary depending on the modem type. To determine available options:

(config)> network modem wwan1 access_tech ?

Access technology: The cellular network technology that the modem may use.
Format:
    2G
    3G
    4G
    4GM
    4GT
    5G
    5G-ALL
    5G-NSA
    all
Default value: all
Current value: all

(config)>

The default is all, which uses the best available technology.

Set whether the modem should use the main antenna, the auxiliary antenna, or both the main and auxiliary antennas:
```
(config)> network modem wwan1 antenna value
(config)>
```
where value is one of the following:
- main
- aux
- both
(Optional) To specify the 4G or 5G bands you want to include or exclude:

(config)> network modem wwan1 4g_bands
(config)>

(config)> network modem wwan1 5g_bands
(config)>

Configure default slice information:
1. Enable the default slice for this modem:
```
(config)> network modem wwan1 default_slice_info enabled true
(config)>
```
2. Set the type of slice to be used:
```
(config)> network modem wwan1 default_slice_info sst value
(config)>
```
  where value is one of:
  - EMBB: Enhanced Mobile Broadband.
  - URLLC: Ultra-Reliable Low-Latency Communications.
  - MIOT: Massive Internet of Things.
  - CUSTOM: Custom 5G slice where device is forced to use the network you specify.
  The default is EMBB.
3. (Optional) Add additional information that supplements the SST to differentiate among multiple network slices of the same SST:
```
(config)> network modem wwan1 default_slice_info sd string
(config)>
```
Save the configuration and apply the change.
```
(config)> save
Configuration saved.
>
```
Type exit to exit the Admin CLI.
Depending on your device configuration, you may be presented with an Access selection menu. Type quit to disconnect from the device.