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 powered off with the +CFUN=0 command.

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
<band_mask>
String. Bit string where LSB is band 1. Leading zeroes 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