nrf9160

Set command

The set command requests evaluation of connection parameters.

Syntax:

%CONEVAL

Response syntax:

%CONEVAL: <result>[,<rrc_state>,<energy_estimate>,<rsrp>,<rsrq>,<snr>,<cell_id>,<plmn>,
<phyc_cell_id>,<earfcn>,<band>,<tau_triggered>,<ce_level>,<tx_power>,<tx_repetitions>,
<rx_repetitions>,<dl-pathloss>]

The response parameters and their defined values are the following:

<result>
0 – Connection pre-evaluation successful
1 – Evaluation failed, no cell available
2 – Evaluation failed, Universal Integrated Circuit Card (UICC) not available
3 – Evaluation failed, only barred cells available
4 – Evaluation failed, busy (for example, Global Navigation Satellite System (GNSS) activity)
5 – Evaluation failed, aborted because of higher priority operation
6 – Evaluation failed, not registered
7 – Evaluation failed, unspecified
<rrc_state>
0 – RRC connection in RRC IDLE state during measurements
1 – RRC connection in RRC CONNECTED state during measurements
<energy_estimate>
Relative estimated energy consumption of data transmission compared to nominal consumption. A higher value means smaller energy consumption.
5 – Bad conditions. Difficulties in setting up connections. Maximum number of repetitions might be needed for data.
6 – Poor conditions. Setting up a connection might require retries and a higher number of repetitions for data.
7 – Normal conditions for cIoT device. No repetitions for data or only a few repetitions in the worst case.
8 – Good conditions. Possibly very good conditions for small amounts of data.
9 – Excellent conditions. Efficient data transfer estimated also for larger amounts of data.
<rsrp>
Current Reference Signal Received Power (RSRP) level at the time of the report
–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.
<rsrq>
Current Reference Signal Received Quality (RSRQ) level at the time of the report
–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.
<snr>
Current Signal-to-Noise Ratio (SNR) level at the time of the report
0 SNR < -24 dB
1 – When –24 dB <= SNR < –23 dB
2 – When –23 dB <= SNR < –22 dB
: : : :
snr
47 – When 22 dB <= SNR < 23 dB
48 – When 23 dB <= SNR < 24 dB
49 – When 24 dB <= SNR
127 – Not known or not detectable
The index value of SNR can be converted to decibel with the following formula: Index – 24 = dB. For example, 1 – 24 = –23 dB and 47 – 24 = 23 dB.
<cell_id>
String in hexadecimal format. 4-byte Evolved Terrestrial Radio Access Network (E-UTRAN) cell ID.
<plmn>
String. Mobile Country Code (MCC) and Mobile Network Code (MNC) values.
<phys_cell_id>
Integer, 0–503. Physical cell ID of evaluated LTE cell.
<earfcn>
Integer. EARFCN of a cell where the EARFCN is as defined in 3GPP TS 36.101.
<band>
Integer, 1–88. See 3GPP 36.101.
0 when current band information is not available.
<tau_triggered>
0 – User Equipment (UE) is registered on the evaluated cell. Therefore, Tracking Area Update (TAU) is not needed before sending user data.
1 – UE is not registered on the evaluated cell. Therefore, the TAU procedure is initiated before sending user data.
255 – Not known.
<ce_level>
0 – CE Level 0. No repetitions or small number of repetitions.
1 – CE Level 1. Medium number of repetitions.
2 – CE Level 2. Large number of repetitions.
3 – CE Level 3. Very large number of repetitions (not supported).
255 – Invalid or not known.
If <rrc_state> is 0, the CE level is estimated based on RSRP and network configuration.
If <rrc_state> is 1, the CE level corresponds to the currently used CE level.
<tx_power>
Integer, –45 to +23 dBm.
The estimate of TX power depends on the RRC state in which the measurement is taken.
If <rrc_state> is 0, the value corresponds to the estimated TX power level of the first preamble transmission in (N)PRACH.
If <rrc_state> is 1, the value corresponds to the latest physical data channel (N)PUSCH transmission power level.
See 3GPP 36.101 and 3GPP 36.213.
<tx_repetitions>
Integer, 1–2048.
The estimate of TX repetitions depends on the RRC state in which the measurement is taken.
If <rrc_state> is 0, the value corresponds to the initial preamble repetition level in (N)PRACH based on <ce_level> and network configuration.
If <rrc_state> is 1, the value corresponds to the latest physical data channel (N)PUSCH transmission repetition level.
See 3GPP TS 36.331 and 3GPP TS 36.213.
<rx_repetitions>
Integer, 1–2048.
The estimate of RX repetitions depends on the RRC state in which the measurement is taken.
If <rrc_state> is 0, Initial Random Access control channel (M/NPDCCH) reception repetition level based on <ce_level> and network configuration.
If <rrc_state> is 1, the latest physical data channel (N)PDSCH reception repetition level.
See 3GPP TS 36.331 and 3GPP TS 36.213.
<dl-pathloss>
Integer. Reduction in power density in dB.

The following command example requests the pre-evaluation of a connection:

AT%CONEVAL
%CONEVAL: 0,1,5,8,2,14,"011B0780”,"26295",7,1575,3,1,1,23,16,32,130
OK