nrf9160

Set command

The set command subscribes notifications of changes in signal quality.

Syntax:

%CESQ=<n>

Notification syntax:

%CESQ: <rsrp>,<rsrp_threshold_index>,<rsrq>,<rsrq_treshold_index>

The set command parameters and their defined values are the following:

<n>
0 – Unsubscribe signal quality notifications
1 – Subscribe signal quality notifications
<rsrp>
0 – RSRP < −140 dBm
1 – When −140 dBm ≤ RSRP < −139 dBm
2 – When −139 dBm ≤ RSRP < −138 dBm
...
95 – When −46 dBm ≤ RSRP < −45 dBm
96 – When −45 dBm ≤ RSRP < −44 dBm
97 – When −44 dBm ≤ RSRP
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.
<rsrp_threshold_index>
Index of Reference Signal Received Power (RSRP) threshold which is below measured RSRP value.
0 – RSRP is below the first threshold. 0–20 (–140 dBm to –121 dBm).
1 – RSRP is between the first and second threshold. 20–39 (–120 dBm to –101 dBm).
2 – RSPR is between the second and third threshold. 40–59 (–100 dBm to –81 dBm).
3 – RSRP is between the third and fourth threshold. 60–79 (–80 dBm to –61 dBm).
4 – RSRP is above the fourth threshold. 80–97 (–60 dBm to –44 dBm).
255 – Unknown.
With default thresholds 20, 40, 60, and 80, the measured value 70 leads to index 3.
<rsrq>
0 rsrq < −19.5 dB
1 – When −19.5 dB ≤ RSRQ < −19 dB
2 – When −19 dB ≤ RSRQ < −18.5 dB
...
32 – When −4 dB ≤ RSRQ < −3.5 dB
33 – When −3.5 dB ≤ RSRQ < −3 dB
34 – When −3 dB ≤ RSRQ
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 = –3,5 dB.
<rsrq_threshold_index>
Index of RSRQ threshold which is below the measured RSRQ value.
0 – RSRQ is below the first threshold. 0–7 (–19.5 dB to –16.5 dB).
1 – RSRQ is between the first and second threshold. 7–13 (–16 dB to –13 dB).
2 – RSRQ is between the second and third threshold. 14–20 (–12.5 dB to –9.5 dB).
3 – RSRQ is between the third and fourth threshold. 21–27 (–9 dB to –6 dB).
4 – RSRQ is above the fourth threshold. 28–34 (–5.5 dB to –3 dB).
255 – Unknown
With the default thresholds 7, 14, 21, and 28, the measured value 17 leads to index 2.

The following command example subscribes Evolved Universal Terrestrial Radio Access (E-UTRA) signal quality notifications:

AT%CESQ=1
OK

The following notification example indicates a change in the measured average RSRP. The average RSRP is 62 and mapped to threshold 3, the measured RSRQ average has been 12 and mapped to threshold index 1.

%CESQ: 62,3,12,1