Set command

The set command sets the supported system modes of the modem. The command configuration is stored to Non-volatile Memory (NVM) approximately every 48 hours and when the modem is set to minimum functionality mode with the +CFUN=0 command.

Active %XPOFWARN warning blocks the storing to NVM.

If the modem detects a conflicting band lock and operator restrictions in at least one system, this means that there are no usable bands in that system and the command returns ERROR and +CME ERROR code 522.

Note:
  • Only one supported LTE mode is allowed at a time.
  • Both the LTE-M and Narrowband Internet of Things (NB-IoT) system modes can be configured and enabled.
  • This command is allowed only before activating the modem using the +CFUN=1 command. If the mode needs to be changed, enter Minimum functionality mode using the +CFUN=0 command or set it to flight mode using the +CFUN=4 command.
  • Operator configurations can override values set by the user.

Syntax:

%XSYSTEMMODE=<LTE_M_support>,<NB_IoT_support>,<GNSS_support>,<LTE_preference>
+CME ERROR code
518 – Not allowed in active state.
522 – Band configuration not valid for selected mode.

The set command parameters and their defined values are the following:

<LTE_M_support>
0 – LTE-M not supported
1 – LTE-M supported
<NB_IoT_support>
0 – NB-IoT not supported
1 – NB-IoT supported
<GNSS_support>
0 – Global Navigation Satellite System (GNSS) not supported
1 – GNSS supported
<LTE_preference>
0 – No preference. Initial system selection is based on history data and Universal Subscriber Identity Module (USIM). If history data or USIM configuration are not available, LTE-M is prioritized in the initial system selection.
1 – LTE-M preferred.
2 – NB-IoT preferred.
3 – Network selection priorities override system priority, but if the same network or equal priority networks are found, LTE-M is preferred.
4 – Network selection priorities override system priority, but if the same network or equal priority networks are found, NB-IoT is preferred.
Note: If <LTE_preference> is set to a non-zero value, <LTE_M_support> or <NB_IoT_support> or both must be set.

The following command example sets LTE-M and GNSS as the system modes. No preferred LTE mode set:

AT%XSYSTEMMODE=1,0,1,0
OK