Set command

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

Syntax:

%NCELLMEAS[=<search_type>]

Syntax:v1.3.x≥4

%NCELLMEAS[=<search_type>][,<gci_count>]

Notification syntax for <search_type> 0–2:

%NCELLMEAS: <status> 
[,<cell_id>,<plmn>,<tac>,<timing_advance>,<earfcn>,<phys_cell_id>,<rsrp>,<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>]

Notification syntax for <search_type> 3–5:v1.3.x≥4

%NCELLMEAS: <status>
[,<cell_id>,<plmn>,<tac>,<timing_advance>,<timing_advance_measurement_time>,<earfcn>,
<phys_cell_id>,<rsrp>,<rsrq>,<measurement_time>,<serving>,<neighbor_count>
[,<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]...],
[<cell_id>,<plmn>,<tac>,<timing_advance>,<timing_advance_measurement_time>,<earfcn>,
<phys_cell_id>,<rsrp>,<rsrq>,<measurement_time>,<serving>,<neighbor_count>
[,<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]...]...
Note: The optional part is included in the response only when <status> is 0 (measurement successful).

The result notification for <search_type>s 3–5 contains cell ID, Public Land Mobile Network (PLMN), and Type Allocation Code (TAC) for up to <gci_count> cells, and optionally a list of neighboring cell measurement results related to each cell. The <neighbor_count> indicates how many neighboring cells are present after each cell.v1.3.x≥4

For <search_type>s 3–5, <neighbor_count> is always 0 for other cells except the serving cell, which means that the neighboring cell list is not available. If neighbor cell results for the serving cell are available when the User Equipment (UE) is in RRC Idle mode, they are preserved for 10 s after entering RRC Connected mode unless they are overwritten by RRC Connected mode measurements. If there are no preserved RRC Idle mode measurements in RRC connected mode, neighbor cell results are available only if the network has configured neighbor measurements for the UE. Valid Terminal Adapter (TA) information is available only for the serving cell. These parameters are included for all cells in the result format to keep the same structure for every cell to simplify response parsing.v1.3.x≥4

If there is currently a serving cell, it is indicated by <serving> parameter value 1 and listed as the first cell in the result notification.v1.3.x≥4

+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 <search_type> 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 <search_type> 1, except that it performs a complete search for all supported bands.
3 – GCI search. Modem searches E-UTRA Absolute Radio Frequency Channel Number (EARFCN)s based on previous cell history.v1.3.x≥4
4 – GCI search. Modem starts with the same search method as in <search_type> 3. If less than <gci_count> cells are found, modem performs light search on bands that are valid for the area of the current ITU-T region.v1.3.x≥4
5 – GCI search. Modem starts with the same search method as in <search_type> 3. If less than <gci_count> cells are found, modem performs complete search on all supported bands.v1.3.x≥4
The modem uses the <search_type> parameter only when cell search is required to complete the requested measurement.
Note: Supported bands might be limited by band lock.
<gci_count>v1.3.x≥4
Integer.
Maximum number of cells to be searched. Mandatory for GCI search types 3–5. Ignored with search types 0–2.
Range 2––15.
<status>
0 – Measurement successful.
1 – Measurement failed. No cell available.
2 – Measurement interrupted. Results can be incomplete.v1.3.x≥4
<cell_id>
String in hexadecimal format. The cell ID the 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.
<earfcn>
Integer. EARFCN of the cell where the EARFCN is as defined in 3GPP TS 36.101.
<measurement_time>
Measurement time of the 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.
<phys_cell_id>
Integer. Physical cell ID of the cell.
<n_phys_cell_id>
Integer. Physical cell ID of the neighboring cell.
<rsrp>
Reference Signal Received Power (RSRP) of the 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 = –45 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
<rsrq>
RSRQ of the 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.
<serving>v1.3.x≥4
0 – Current cell is not serving cell
1 – Current cell is serving cell
<neighbor_count>v1.3.x≥4
Integer. Number of neighboring cell results after current cell. Can be 0.

The following command example starts neighboring cell measurement with default <search_type> 0:

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

The following command example starts a GCI search based on cell history with <search_type> 3 searching two cells:v1.3.x≥4

AT%NCELLMEAS=3,2
OK

The following notification example indicates that the UE is in connected mode. The result notification contains serving cell with GCI information and measurement results of four neighboring cells:v1.3.x≥4

%NCELLMEAS:  0,"00011B07","26295","00B7",10512,9034,2300,7,63,31,150344527,1,4,2300,
8,60,29,92,2300,9,59,28,100,2400,10,56,27,162,2400,11,55,26,184

The following notification example indicates that the UE is in idle mode. The result notification contains two cells with GCI information and no neighboring cell measurement results:v1.3.x≥4

%NCELLMEAS:  0,"00011B07","26295","00B7",10512,9034,2300,7,63,31,150344527,
1,0,"00011B08","26295","00B7",65535,0,2300,9,62,30,150345527,0,0