Set command

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

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 state, they are preserved for 10 s after entering RRC CONNECTED state unless they are overwritten by RRC CONNECTED state measurements. If there are no preserved RRC IDLE state measurements in RRC CONNECTED state, 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.

530 – Measurement ongoing. Wait for result notification or stop ongoing measurement by using %NCELLMEASSTOP before starting a new measurement.

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, 2 – 15.

Maximum number of cells to be searched. Mandatory for GCI search types 3–5. Ignored with search types 0–2.

<status>

0 – Measurement successful.

1 – Measurement failed.

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 RRC CONNECTED state. 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 RRC IDLE state. 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