nrf9160

Set command

The set command reads modem parameters.

Syntax:

%XMONITOR

Response syntax:v1.0.xv1.1.x

%XMONITOR: <reg_status>,[<full_name>,<short_name>,<plmn>,<tac>,<AcT>,<band>,<cell_id>,
<phys_cell_id>,<EARFCN>,<rsrp>,<snr>,<NW-provided_eDRX_value>,<Active-Time>,<Periodic-TAU-ext>]

Response syntax:v1.2.xv1.3.x

%XMONITOR: <reg_status>,[<full_name>,<short_name>,<plmn>,<tac>,<AcT>,<band>,<cell_id>,
<phys_cell_id>,<EARFCN>,<rsrp>,<snr>,<NW-provided_eDRX_value>,<Active-Time>,<Periodic-TAU-ext>,<Periodic-TAU>]

The response parameters and their defined values are the following:

<reg_status>
0 – Not registered. User Equipment (UE) is not currently searching for an operator to register to.
1 – Registered, home network
2 – Not registered, but UE is currently trying to attach or searching an operator to register to
3 – Registration denied
4 – Unknown (for example, out of Evolved Terrestrial Radio Access Network (E-UTRAN) coverage)
5 – Registered, roaming
90 – Not registered due to Universal Integrated Circuit Card (UICC) failure
Note: The optional part is included in the response only when <reg_status> is 1 or 5. Some parameters may not be present in specific circumstances. For example, <phys_cell_id>, <EARFCN>, <rsrp>, and <snr> are not available when the device is not camped on a cell.
<full_name>
String in alphanumeric format. Operator name.
<short_name>
String in alphanumeric format. Operator name.
<plmn>
String of digits. Mobile Country Code (MCC) and Mobile Network Code (MNC) values.
<tac>
String in hexadecimal format. 2-byte Tracking Area Code (TAC).
<AcT>
7 – E-UTRAN
9 – E-UTRAN NB-S1
<band>
Integer, 1−68. See 3GPP 36.101. The value is 0 when current band information is not available.
<cell_id>
String in hexadecimal format. 4-byte E-UTRAN cell ID.
<phys_cell_id>
Integer. Physical cell ID.
<EARFCN>
Integer. E-UTRA Absolute Radio Frequency Channel Number (EARFCN) for a given cell where EARFCN is as defined in 3GPP TS 36.101.
<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.
<snr>
0 – SNR < −24 dB
1 – When −24 dB ≤ SNR < −23 dB
2 – When −23 dB ≤ SNR < −22 dB
...
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.
<NW-provided_eDRX_value>
String. Half a byte in 4-bit format.
A configuration value that the network provides for the eDRX period. The value in this parameter does not necessarily indicate that eDRX is in use by the current cell to which the UE is registered. The use of eDRX can be dynamically monitored with the unsolicited notification +CEDRXP and its <ActT-type> parameter.
The Extended Discontinuous Reception (eDRX) value refers to bit 4 to 1 of octet 3 of the Extended DRX parameters information element (see 3GPP TS 24.008, subclause 10.5.5.32).
Bit
4 3 2 1 – E-UTRAN e-I-DRX cycle length duration
0 0 0 0 – 5.12 s1
0 0 0 1 – 10.24 s1
0 0 1 0 – 20.48 s
0 0 1 1 – 40.96 s
0 1 0 0 – 61.44 s2
0 1 0 1 – 81.92 s
0 1 1 0 – 102.4 s2
0 1 1 1 – 122.88 s2
1 0 0 0 – 143.36 s2
1 0 0 1 – 163.84 s
1 0 1 0 – 327.68 s
1 0 1 1 – 655,36 s
1 1 0 0 – 1,310.72 s
1 1 0 1 – 2,621.44 s
1 1 1 0 – 5,242.88 s3
1 1 1 1 – 10,485.76 s3
<Active-Time>
String. 1 byte in 8-bit format.
Indicates the Active Time value (T3324) allocated to the device in E-UTRAN. For the coding and value range, see the GPRS Timer 2 IE in 3GPP TS 24.008 Table 10.5.163/3GPP TS 24.008.
The device can enter Power Saving Mode (PSM) state in LTE idle mode when the <Active-Time> parameter has a valid value where at least one of bits 6–8 is set to 0. The length of PSM sleep is the value that remains from the value configured for periodic TAU after active time has elapsed, which is T3324 subtracted from T3412.
GPRS Timer 2 value (octet 3).
Bits 5 to 1 represent the binary coded timer value.
Bits 8 to 6 define the timer value unit for the GPRS timer as follows:
Bits
8 7 6
0 0 0 – Value is incremented in multiples of 2 s
0 0 1 – Value is incremented in multiples of 1 min
0 1 0 – Value is incremented in multiples of 6 min
1 1 1 – Value indicates that the timer is deactivated
<Periodic-TAU-ext>
String. 1 byte in 8-bit format.
Indicates the extended periodic TAU value (T3412_EXT extended value) allocated to the device in E-UTRAN. For the coding and value range, see the GPRS Timer 3 IE in 3GPP TS 24.008 Table 10.5.163a/3GPP TS 24.008.
GPRS Timer 3 value (octet 3).
Bits 5 to 1 represent the binary coded timer value.
Bits 8 to 6 define the timer value unit for the GPRS timer as follows:
Bits
8 7 6
0 0 0 – Value is incremented in multiples of 10 min
0 0 1 – Value is incremented in multiples of 1 h
0 1 0 – Value is incremented in multiples of 10 h
0 1 1 – Value is incremented in multiples of 2 s
1 0 0 – Value is incremented in multiples of 30 s
1 0 1 – Value is incremented in multiples of 1 min
1 1 0 – Value is incremented in multiples of 320 h
1 1 1 – Value indicates that the timer is deactivated
<Periodic-TAU>v1.2.xv1.3.x
String. 1 byte in 8-bit format.
Indicates the periodic TAU value (T3412) allocated to the device in E-UTRAN. For the coding and value range, see the GPRS Timer IE in 3GPP TS 24.008 Table 10.5.172/3GPP TS 24.008.
Timer value (octet 2).
Bits 5 to 1 represent the binary coded timer value.
Bits 8 to 6 define the timer value unit for the GPRS timer as follows:
Bits
8 7 6
0 0 0 – Value is incremented in multiples of 2 s
0 0 1 – Value is incremented in multiples of 1 min
0 1 0 – Value is incremented in multiples of 6 min
1 1 1 – Value indicates that the timer is deactivated

The following command example reads modem parameters:v1.0.xv1.1.x

AT%XMONITOR
        %XMONITOR: 1,"EDAV","EDAV","26295","00B7",7,4,"00011B07",7,2300,63,39,"",
        "11100000","11100000"
        OK

The following command example reads modem parameters:v1.2.xv1.3.x

AT%XMONITOR
        %XMONITOR: 1,"EDAV","EDAV","26295","00B7",7,4,"00011B07",7,2300,63,39,"",
        "11100000","11100000","11100000"
        OK
1 The value is applicable only in WB-S1 mode. If received in NB-S1 mode it is interpreted as if the Extended DRX parameters IE were not included in the message by this version of the protocol.
2 The value is applicable only in WB-S1 mode. If received in NB-S1 mode it is interpreted as 0010 by this version of the protocol.
3 The value is applicable only in NB-S1 mode. If received in WB-S1 mode it is interpreted as 1101 by this version of the protocol.