Set command

The set command starts neighboring cell measurements and reports the channel parameters.

Syntax:

%NCELLMEAS[=<search_type>]

Notification syntax:

%NCELLMEAS: status [,<cell_id>,<plmn>,<tac>,<timing_advance>,<current_earfcn>,<current_phys_cell_id>,
<current_rsrp>,<current_rsrq>,<measurement_time>,][,<n_earfcn>1,<n_phys_cell_id>1,<n_rsrp>1,<n_rsrq>1,<time_diff>1]
[,<n_earfcn>2,<n_phys_cell_id>2,<n_rsrp>2,<n_rsrq>2,<time_diff>2] 
... 
[,<n_earfcn>17,<n_phys_cell_id>17,<n_rsrp>17,<n_rsrq>17,<time_diff>17][,<timing_advance_measurement_time>]
Note: The optional part is included in the response only when <status> is 0 (measurement successful).
+CME ERROR code
517 – Modem not activated.

The notification parameters and their defined values are the following:

<search_type>
0 – Modem searches RPLMN based on previous cell history.
1 – Modem starts with the same search method as in option 0.
If a suitable cell is not found, the modem performs a light search where it continues the search by measuring the radio conditions and makes assumptions on where networks might be deployed. If RPLMN is not found based on previous cell history, the modem accepts any found PLMN.
2 – Modem uses otherwise the same search method as in option 1, except that it performs a complete search for all supported bands.
Note: Supported bands might be limited by band lock.
The modem uses the <search_type> parameter only when cell search is required to complete the requested measurement.
<status>
0 – Measurement successful
1 – Measurement failed, no cell available
<cell_id>
String in hexadecimal format. The cell ID the User Equipment (UE) is camped on. 4-byte Evolved Terrestrial Radio Access Network (E-UTRAN) cell ID.
<plmn>
String. Mobile Country Code (MCC) and Mobile Network Code (MNC) values.
<tac>
String in hexadecimal format. 2-byte Tracking Area Code (TAC).
<timing_advance>
Integer. Timing advance value (Ts). Time units as specified in 3GPP TS 36.211.
0–20512 – When timing advance is valid
65535 – When timing advance is not valid
Note: Timing advance might be reported from past measurements. The client application is responsible for checking the <timing_advance_measurement_time> parameter and the serving cell's <measurement_time> parameter for the difference between the measurement times.
<current_earfcn>
Integer. E-UTRA Absolute Radio Frequency Channel Number (EARFCN) of the current cell where the EARFCN is as defined in 3GPP TS 36.101.
<measurement_time>
Measurement time of the serving cell in ms calculated from modem boot time.
Range 0–18 446 744 073 709 551 614 ms.
<n_earfcn>
Integer. EARFCN of the neighboring cell where the EARFCN is as defined in 3GPP TS 36.101.
<current_phys_cell_id>
Integer. Physical cell ID of the current cell.
<n_phys_cell_id>
Integer. Physical cell ID of the neighboring cell.
<current_rsrp>
Reference Signal Received Power (RSRP) of the current cell.
–17 – When RSRP < –156 dBm
–16 – When –156 ≤ RSRP < –155 dBm
… … …
–3 – When –143 ≤ RSRP < –142 dBm
–2 – When –142 ≤ RSRP < –141 dBm
–1 – When –141 ≤ RSRP < –140 dBm
0 – When RSRP < –140 dBm
1 – When –140 ≤ RSRP < –139 dBm
2 – When –139 ≤ RSRP < –138 dBm
… … …
95 – When –46 ≤ RSRP < –45 dBm
96 – When –45 ≤ RSRP < –44 dBm
97 – When –44 ≤ RSRP dBm
255 – Not known or not detectable
The index value of RSRP can be converted to decibel with the following formula: Index – 140 = dBm. For example, 95 – 140 = –46 dBm and –16 – 140 = –156 dBm.
<n_rsrp>
RSRP of the neighboring cell.
–17 – When RSRP < –156 dBm
–16 – When –156 ≤ RSRP < –155 dBm
… … …
–3 – When –143 ≤ RSRP < –142 dBm
–2 – When –142 ≤ RSRP < –141 dBm
–1 – When –141 ≤ RSRP < –140 dBm
0 – When RSRP < –140 dBm
1 – When –140 ≤ RSRP < –139 dBm
2 – When –139 ≤ RSRP < –138 dBm
… … …
95 – When –46 ≤ RSRP < –45 dBm
96 – When –45 ≤ RSRP < –44 dBm
97 – When –44 ≤ RSRP dBm
255 – Not known or not detectable
<current_rsrq>
RSRQ of the current cell.
–30 – When RSRQ < –34 dB
–29 – When –34 ≤ RSRQ < –33.5 dB
… … …
–2 – When –20.5 ≤ RSRQ < –20 dB
–1 – When –20 ≤ RSRQ < –19.5 dB
0 – When RSRQ < –19.5 dB
1 – When –19.5 ≤ RSRQ < –19 dB
2 – When –19 ≤ RSRQ < –18.5 dB
… … …
32 – When –4 ≤ RSRQ < –3.5 dB
33 – When –3.5 ≤ RSRQ < –3 dB
34 – When –3 ≤ RSRQ dB
35 – When –3 ≤ RSRQ < –2.5 dB
36 – When –2.5 ≤ RSRQ < –2 dB
… … …
45 – When 2 ≤ RSRQ < 2.5 dB
46 – When 2.5 ≤ RSRQ dB
255 – Not known or not detectable
The index value of RSRQ can be converted to decibel with the following formula: Index x ½ – 19,5 = dB. For example, (32 x ½) – 19,5 = –4 dB and (–29 x ½) – 19,5 = –34 dB.
<n_rsrq>
RSRQ of the neighboring cell.
–30 – When RSRQ < –34 dB
–29 – When –34 ≤ RSRQ < –33.5 dB
… … …
–2 – When –20.5 ≤ RSRQ < –20 dB
–1 – When –20 ≤ RSRQ < –19.5 dB
0 – When RSRQ < –19.5 dB
1 – When –19.5 ≤ RSRQ < –19 dB
2 – When –19 ≤ RSRQ < –18.5 dB
… … …
32 – When –4 ≤ RSRQ < –3.5 dB
33 – When –3.5 ≤ RSRQ < –3 dB
34 – When –3 ≤ RSRQ dB
35 – When –3 ≤ RSRQ < –2.5 dB
36 – When –2.5 ≤ RSRQ < –2 dB
… … …
45 – When 2 ≤ RSRQ < 2.5 dB
46 – When 2.5 ≤ RSRQ dB
255 – Not known or not detectable
<time_diff>
Difference in ms between the latest performed serving cell measurement and neighboring cell measurement.
–99999 ms < time_diff < 99999 ms
0 – Value not valid
<timing_advance_measurement_time>
0 – 18 446 744 073 709 551 614 ms
Measurement time of timing advance in milliseconds calculated from modem boot time.

The following command example starts neighboring cell measurement:

AT%NCELLMEAS
OK

The following notification example indicates a finished measurement. The result contains the serving cell and two neighboring cells:

%NCELLMEAS: 0,"00011B07","26295","00B7",10512,2300,7,63,31,150344527, 2300,8,60,29,0,2400,11,55,26,184,9034