%XBANDLOCK 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.v1.3.x≥2

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 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

Set command