Set command

The set command sets locked bands and bitmasks to limit supported bands.

Supported bands are masked with permanent and runtime masks. A logical AND operation is performed to %XBANDLOCK commands. If a permanent or runtime mask has been given, it is required that the second mask has at least one band in common with the first mask. Otherwise, the command returns ERROR. The command returns ERROR at an attempt to disable all supported bands.

Permanent mask 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.

When permanently limiting the used bands with %XBANDLOCK=3 and then performing TX self-calibration with %TXSELFCAL=1, execute %XBANDLOCK=3 before %TXSELFCAL=1. nRF9131

Note: Set band lock before activating modem with +CFUN.
Syntax:
%XBANDLOCK=<operation>[,<band_mask>]
+CME ERROR code
518 – Not allowed in active state.

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

<operation>
0 – Remove band locks.
1 – Set permanent band mask.
2 – Set runtime band mask.
3 – Set erase-protected band mask. Writing the mask is possible only in the Production Test Image (PTI) firmware.nRF9131
<band_mask>
String. Bit string where LSB is band 1. Leading zeros can be omitted. Maximum length 88 characters.

The following command example sets permanent band 4 lock:

AT%XBANDLOCK=1,"1000"
OK

The following command example sets runtime band 4 and 13 lock:

AT%XBANDLOCK=2,"1000000001000"
OK