Skip to content

AT+QENG

Query primary serving cell and neighbor cell information. The maximum response time is 300 ms.

Test Command

AT+QENG=?
Response
+QENG: (list of supported <cell_type>s)
OK

Serving Cell

Execute the below Command to query the serving cell information

AT+QENG="servingcell"
Response in LTE mode
+QENG: "servingcell",<state>,"LTE",<is_tdd>,<MCC>,<MNC>,<cellID>,<PCID>,<earfcn>,<freq_band_ind>,<UL_bandwidth>,<DL_bandwidth>,<TAC>,<RSRP>,<RSRQ>,<RSSI>,<SINR>,<CQI>,<tx_power>,<srxlev>

Example:

mmcli -m 2 --command="AT+QENG=\"servingcell\""

+QENG: "LTE","FDD",460,00,81EF7D0,78,1300,3,5,5,1806,-68,-8,-38,15
+QENG: "NR5G-NSA", 460,00,570,-90,64,-11

OK

Response in WCDMA mode

+QENG: "servingcell",<state>,"WCDMA",<MCC>,<MNC>,<LAC>,<cellID>,<uarfcn>,<PSC>,<RAC>,<RSCP>,<ecio>,<phych>,<SF>,<slot>,<speech_code>,<comMod>
Response in EN-DC mode

+QENG: "servingcell",<state> 
+QENG: "LTE",<is_tdd>,<MCC>,<MNC>,<cellID>,<PCID>,<earfcn>,<freq_band_ind>,<UL_bandwidth>,<DL_bandwidth>,<TAC>,<RSRP>,<RSRQ>,<RSSI>,<SINR>,<CQI>, <tx_power>,<srxlev> 
+QENG: "NR5G-NSA",<MCC>,<MNC>,<PCID>,<NR5G_RSRP>,<NR5G_SINR>,<NR5G_RSRQ>

Neighbour Cell

Write Command Query the information of neighbor cell tower information.

AT+QENG="neighbourcell"
Response In LTE mode

[+QENG: "neighbourcell intra","LTE",<earfcn>,<PCID>,<RSRQ>,<RSRP>,<RSSI>,<SINR>,<srxlev>,<cell_resel_priority>,<s_non_intra_search>,<thresh_serving_low>,<s_intra_search> ...]
[+QENG: "neighbourcell inter","LTE",<earfcn>,<PCID>,<RSRQ>,<RSRP>,<RSSI>,<SINR>,<srxlev>,<cell_resel_priority>,<threshX_low>,<threshX_high> ...]
[+QENG: "neighbourcell","WCDMA",<uarfcn>,<cell_resel_priority>,<thresh_Xhigh>,<thresh_Xlow>,<PSC>,<RSCP><ecno>,<srxlev> ...]

Example:

mmcli -m 2 --command="AT+QENG=\"neighbourcell\""

+QENG: "neighbourcell intra","LTE",38950,276,-3,-88,-65,0,37,7,16,6,44
+QENG: "neighbourcell inter","LTE",39148,-,-,-,-,-,37,0,30,7,-,-,-,-
+QENG: "neighbourcell inter","LTE",37900,-,-,-,-,-,0,0,30,6,-,-,-,-

OK

Response in WCDMA mode

[+QENG: "neighbourcell","WCDMA",<uarfcn>,<srxqual>,<PSC>,<RSCP>,<ecno>,<set>,<rank>,<srxlev> ...]
[+QENG: "neighbourcell","LTE",<earfcn>,<cellID>,<RSRP>,<RSRQ>,<s_rxlev> ...]

Parameters

"-" or - indicates the parameter is invalid under the current condition.

Parameter String Description
<celltype> "servingcell"
"neighbourcell"
The information of 3G/4G/5G serving and neighbour cell towers.
<state> "SEARCH" Searching but could not (yet) find a suitable cell.
"LIMSRV" Camping on a cell but has not registered.
"NOCONN" Camping on a cell has registered on the network, and it is in idle mode.
"CONNECT" Camping on a cell and registered on the network, a call is in progress.
<is_tdd> "TDD" & "FDD" The LTE network mode.
<MCC> Number format Mobile Country Code (first part of the PLMN code).
<MNC> Number format Mobile Network Code (second part of the PLMN code).
<LAC> Integer type Location Area Code. The parameter determines the two bytes' location area code in hexadecimal format (e.g., 00C1 equals 193 in decimal). Range: 0–65535.
<cellID> Cell tower ID The parameter determines the 16-bit (GSM) or 28-bit (UMTS) cell ID, which range is 0–0xFFFFFFF.
<PCID> Number format Physical cell ID.
<uarfcn> UTRA-ARFCN The parameter determines the UTRA-ARFCN of the cell that was scanned.
<earfcn> E-UTRA-ARFCN The parameter determines the E-UTRA-ARFCN of the cell that was scanned.
<freq_band_ind> E-UTRAN bands E-UTRA frequency band (see 3GPP 36.101)
<UL_bandwidth> Integer type UL bandwidth.
0 -- 1.4 MHz
1 -- 3 MHz
2 -- 5 MHz
3 -- 10 MHz
4 -- 15 MHz
5 -- 20 MHz
<DL_bandwidth> Integer type DL bandwidth.
0 -- 1.4 MHz
1 -- 3 MHz
2 -- 5 MHz
3 -- 10 MHz
4 -- 15 MHz
5 -- 20 MHz
<TAC> Number format Tracking Area Code
See 3GPP 23.003 Section 19.4.2.3
<PSC> Number format The parameter determines the primary scrambling code of the cell that was scanned.
<RAC> Integer type Routing Area Code. Range: 0–255.
<RSCP> Number format The parameter determines the Received Signal Code Power level of the scanned cell.
<ecio> Number format Carrier to noise ratio in dB = measured Ec/Io value in dB.
<RSRP> Negative number Indicates the signal of Reference Signal Received Power in both LTE and 5G-NR modes.
Range: -140 to -44 dBm.
The closer to -44, the better the signal is.
The closer to -140, the worse the signal is.
<RSRQ> Negative number Indicates the signal of Reference Signal Received Quality in both LTE and 5G modes.
Range: -20 to -3 dB.
The closer to -3, the better the signal is.
The closer to -20, the worse the signal is.
<RSSI> Number format Received Signal Strength Indication. LTE only.
<SINR> Number format Indicates Signal-to-Interface plus Noise Ratio.
The conversion formula for actual SINR is
Y = (1/5) × X × 10 - 20
(X is the value queried by AT+QENG, and Y is the SINR value).
Range: -20 to 30 dB.
<CQI> Integer type Channel Quality Indication. Range: 1–30.
<tx_power> Number format TX power value in 1/10 dBm. It is the maximum of all UL channel TX power. The value is only meaningful when the device is in traffic.
<phych> Integer type Physical channel.
0 -- DPCH
1 -- FDPCH
<SF> Integer type They are spreading factor.
0 -- SF_4
1 -- SF_8
2 -- SF_16
3 -- SF_32
4 -- SF_64
5 -- SF_128
6 -- SF_256
7 -- SF_512
8 -- UNKNOWN
<slot> Integer type Slot format.
0–16 for DPCH
0–9 for FDPCH
<speech_code> Number format Destination number on which call is to be deflected.
<comMod> Number format Compress mode.
0 -- Not support compress mode
1 -- Support compress mode
<srxqual> Number format The receiver automatically gains control of the camped frequency.
<ecno> Number format Carrier to noise ratio in dB = measured Ec/Io value in dB.
<set> Integer type 3G neighbor cell set.
1 -- Active set
2 -- Synchronous neighbor set
3 -- Asynchronous neighbor set
<rank> Number format The rank of this cell as a neighbor for inter-RAT cell reselection.
<srxlev> Number format Suitable receive level for inter frequency cell.
<threshX_low> - To be considered for reselection. An evaluated lower-priority cell's suitable receive level value must be greater than this value.
<threshX_high> - To be considered for reselection. An evaluated higher-priority cell's suitable receive level value must be greater than this value.
<thresh_Xhigh> - Reselection threshold for high priority layers.
<thresh_Xlow> - Reselection threshold for low priority layers.
<cpich_rscp> - The absolute power level of the common pilot channel as received by the UE in dBm ×10.
<cpich_ecno> - The ratio of the received energy per PN chip for the common pilot channel to the total received power spectral density at the UE antenna connector in dB × 10.
<srxlev> - Select receive level value for base station in dB.
<cell_resel_priority> Number format Cell reselection priority. Range: 0–7.
<s_non_intra_search> - Threshold to control non-intra frequency searches.
<thresh_serving_low> - Specifies the suitable receive level threshold (in dB) used by the UE on the serving cell when reselecting towards a lower priority RAT/frequency.
<s_intra_search> - Cell selection parameter for the intra frequency cell.

Last Updated: 2024-04-21