Configure cellular modem

Configuring the LR54's cellular modem involves configuring the following items:

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.

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 WWAN 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 30s.
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, 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 LR54 can connect.

(Optional) For 4G bands, specify the 4G bands.
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 LR54 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 wwan enable false
(config)>
```
Set the SIM slot that should be used by the modem:
```
(config)> network modem wwan 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 wwan 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 wwan 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 30s.
Set the maximum number of interfaces. This is used when using dual-APN SIMs. The default is 1.
```
(config)> network modem wwan 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 wwan carrier_switch false
(config)>
```

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

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

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

(config)> network modem wwan access_tech ?

Access technology: The cellular network technology that the modem may use.
Format:
    2G
    3G
    4G
    4GM
    4GT
    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 wwan antenna value
(config)>
```
where value is one of the following:
- main
- aux
- both
(Optional) To specify the 4G bands you want to include or exclude:

(config)> network modem wwan 4g_bands
(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.