Set command

nRF9160 AT Commands

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 might 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−85. 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>
Integer. Reported RSRP value.
0 – When measured RSRP < −140 dBm.
1 – When −140 dBm ≤ measured RSRP < −139 dBm.
2 – When −139 dBm ≤ measured RSRP < −138 dBm.
...
95 – When −46 dBm ≤ measured RSRP < −45 dBm.
96 – When −45 dBm ≤ measured RSRP < −44 dBm.
97 – When −44 dBm ≤ measured RSRP.
255 – Not known or not detectable.
The lower dB boundary of this range can be determined using the reported RSRP value and the following formula: reported RSRP value–141=dBm. For example, 95–141=–46 dBm. Thus, the range is –46 dBm ≤ measured RSRP < –45 dBm.
<snr>
Reported SNR value.
0 – When measured SNR < −24 dB.
1 – When −24 dB ≤ measured SNR < −23 dB.
2 – When −23 dB ≤ measured SNR < −22 dB.
...
47 – When 22 dB ≤ measured SNR < 23 dB.
48 – When 23 dB ≤ measured SNR < 24 dB.
49 – When 24 dB ≤ measured SNR.
127 – Not known or not detectable.
The lower dB boundary of this range can be determined using the reported SNR value and the following formula: reported value of SNR–25=dB. For example, 1–25=–24 dB. Thus, the range is –24 dB ≤ measured SNR < –23 dB. Also, 47–25=22 dB. Thus, the range is 22 dB ≤ measured SNR < 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 s2.
0 0 0 1 – 10.24 s2.
0 0 1 0 – 20.48 s.
0 0 1 1 – 40.96 s.
0 1 0 0 – 61.44 s3.
0 1 0 1 – 81.92 s.
0 1 1 0 – 102.4 s3.
0 1 1 1 – 122.88 s3.
1 0 0 0 – 143.36 s3.
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 s4.
1 1 1 1 – 10,485.76 s4.
<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
2 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.
3 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.
4 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.