nrf9160

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.v1.3.x≥2
Note:
  • Only one supported LTE mode is allowed at a time. v1.0.x v1.1.x v1.2.x pti_v1.1.x≥1
  • Both the LTE-M and Narrowband Internet of Things (NB-IoT) system modes can be configured and enabled.v1.3.x
  • This command is allowed only before activating the modem using the +CFUN=1 command. If the mode needs to be changed, do the following:
    • Enter Minimum functionality mode using the +CFUN=0 command. v1.0.x v1.1.x v1.2.x
    • Enter Minimum functionality mode using the +CFUN=0 command or set it to flight mode using the +CFUN=4 command.v1.3.x
  • 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. v1.1.x v1.2.x v1.3.x
1 – LTE-M preferred.v1.3.x
2 – NB-IoT preferred.v1.3.x
3 – Network selection priorities override system priority, but if the same network or equal priority networks are found, LTE-M is preferred.v1.3.x
4 – Network selection priorities override system priority, but if the same network or equal priority networks are found, NB-IoT is preferred.v1.3.x
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