Overview

This short guide will help you understand how to troubleshoot issues/problems with the CAT-M/NB-IoT connection. A lot of information about the connection can be obtained using modem "AT" commands. By definition, "AT" means 'attention'. Each command string is prefixed with "AT", and a number of discrete commands can be concatenated after the "AT".

Please check the examples below to better understand how to initiate those commands and what information can be obtained using them.

note:Mobile network is managed by the ISP. If there are any issues with the connection, we advise contacting ISP beforehand and making sure that they support/allow the connection or the setting in the first place. If you decide to change the configuration with AT commands (without consulting with the ISP), you can do it at your own risk.

Initiating AT Commands

Option A

To send the command, you must use the CLI.

Open the terminal and type in the following:

[admin@MikroTik] > system serial-terminal port=modem channel=2

Pay attention to the port and channel used. Select the port and channel that is used by the PPP-OUT interface. In our example, the port is "modem" and the data channel is "2".

Once the command is initiated it should show the following output where you can now type in the AT commands:

[admin@MikroTik] > system serial-terminal port=modem channel=2 [Ctrl-A is the prefix key] at+cpin? +CPIN: READY OK

In the example above, AT command "at+cpin?" is used and the answer "+CPIN: READY" is received.

Option B

The second way to send AT commands is through the ppp-client interface:

[admin@MikroTik] > interface ppp-client at-chat input="AT+CPIN\?" number: 0 output: +CPIN: READY

You can get the same result as withOption A.

AT Commands

at

Simpleatcommand checks communication between the module (device) and application.

[Ctrl-A is the prefix key] at OK

When "OK" is returned, it means the module successfully responded.

at+cpin?

This command is used to check the status of the SIM card.

[Ctrl-A is the prefix key] at+cpin? +CPIN: READY OK

Status "+CPIN: READY" means that the SIM card is installed properly.

如果SIM PIN is used, you should get the answer "+CPIN: SIM PIN" → in this case, you can unlock it via the commandat+cpin="xxxx", wherexxxxis the pin code.

If you get the response "+CME ERROR: SIM not inserted" → double-check that the SIM card is properly installed in the SIM slot.

at+cfun?

The "CFUN" command is used to check the functional mode. There could be different responses to this command.

[Ctrl-A is the prefix key] at+cfun? +CFUN: 1 OK

When the status is "+CFUN: 1" it means that the device is set to full functionality. It is suggested to use this mode.

Among many other responses, for example, you can get "+CFUN: 4" which means that the device is set to flight mode where Tx, Rx, LTE, and GNSS services, are disabled.

You can manually set the mode to full functionality with the commandat+cfun=1.

at+cops?

Theat+cops?command is used to check the current network connection.

[Ctrl-A is the prefix key] at+cops? +cops: 0,0,"LMT",8 OK

Using the example above as the reference, we can see that we got the response "0,0,"LMT",8".

The first value in the response dictates whether the "automatic" or "manual" mode is used. When ISP connection is set to be "automatic" the value will show "0". When ISP connection is set to be "manual" the value will show "1".

The second value in the response represents ISP's name format. If it is "0", it means the ISP name is in "long format alphanumeric". If it is "1", it means the ISP name is in "short format alphanumeric".

The third part of the response is the ISP name itself.

The fourth part of the response represents the technology used. "8" stands for eMTC (CAT-M) and "9" for NB-IoT.

at+cops=?

Theat+cops=?is used to get the list of all available ISPs. This commandcantake some time (up ~ 1 min) to display the results.

[Ctrl-A is the prefix key] at+cops=? +cops: (1,"LMT","LMT","24701",9),(2,"LMT","LMT","24701",8),,(0,1,2,3,4),(0,1,2) OK

You can manually set up the ISP that you wish to connect to via the commandat+cops=mode,format,"provider", wheremodeis the mode used (0→ automatic network selection; 1→ manual network selection),formatis the ISP name format (0→ long alphanumeric format; 1→ short alphanumeric format; 2→ numeric format), and "provider" is the ISP name (in the format that was selected). For example, to manually select the network from the list, use the commandat+cops=1,1,"LMT".

To select ISP automatically, use the commandat+cops=0.

at+creg?

at+creg?command is used to check the network's registration status.

[Ctrl-A is the prefix key] at+creg? +CREG: 0,1 OK

The first value shows whether the network registration unsolicited result code is enabled or disabled (0→ disabled, 1→ enabled; 2→ enabled + location information). The second value shows circuit mode registration status (0→ not registered/the device is not searching for an operator to register to; 1→ registered/home network; 2→ not registered, but trying to search for an operator to register to; 3→ registration was denied; 4→ unknown; 5→ registered and roaming).

If you have more than 2 values returned, it means that network registration and location information unsolicited result code is enabled. The second value will show a two-byte location area code in hexadecimal format, the third value will show four-byte GERANE/E-UTRAN cell ID in hexadecimal format and the last value will show access technology of the serving cell ("8" for CAT-M and "9" for NB-IoT).

at+csq

Theat+csq命令返回接收到的信号强度指征n (RSSI) and channel bit error (BER) values. This command will return proper values only when the registration in the network is complete.

[Ctrl-A is the prefix key] at+csq +csq: 25,99 OK

The first value is RSSI (dBm):

The second value is BER (%):

As per the example/output "+csq: 25,99", the result translates to RSSI~63 dBm and BER parameter not detectable.

at+qnwinfo

The command returns information about access technology, ISP and band selected. This command will return proper information only when the registration in the network is complete.

[Ctrl-A is the prefix key] at+qnwinfo +QNWINFO: "eMTC","24701","LTE BAND 20",6300 OK

按照上面的示例中,您可以看到坏蛋rent module uses "eMTC" (CAT-M), ISP is "24701" (numeric format, which stands for "LMT"), LTE Band 20, and channel ID "6300".

at+qcsq

The commandat+qcsqreturns information about the signal strength of the current ISP connection and the technology used.

[Ctrl-A is the prefix key] at+qcsq +QCSQ: "eMTC",-62,-87,111,-12 OK

The first parameter returned is "eMTC" which shows the technology used by the module (CAT-M). If the network can not be determined (is uncertain) → "NOSERVICE" will be returned.

The rest of the parameters show the signal strength of the connection.

When the technology is recognized as "NBIoT" or "eMTC" (CAT-M):

• the first numeric value displays received signal strength (LTE RSSI);
• the second value displays the reference signal received power (LTE RSRP);
• the third value displays the signal to interference plus noise ratio (LTE SINR) → the value is displayed as the logarithmical value of SINR and the value is 1/5th of a dB (result can be in between 0-250 range, which translates to -20 dB to +30 dB range);
• the fourth value displays the reference signal received quality (LTE RSRQ).

As per the example above, RSSI=-62 dBm, RSRP=-87 dBm, SINR=111(111/5-20)~2 dB, RSRQ=-12 dB.

at+qcfg="iotopmode"?

The command is used to check which technology is used to connect to ISP. It is possible for the modem to work only in CAT-M mode, only in NB-IoT mode, or in both.

[Ctrl-A is the prefix key] at+qcfg="iotopmode"? +QCFG: "iotopmode",2 OK

You can lock the SIM card to work only in the specific mode with the commandat+qcfg="iotopmode",mode,effect, wheremodeis the mode (0→ only CAT-M; 1→ only NB-IoT; 2→ both), andeffectis when to take effect (0→ to take effect after reboot; 1→ to take effect immediately).

To speed up network searching, it is suggested to execute the commandat+cfun=0(to turn off the radio) and then use the described command. After that, executeat+cfun=1,1(to turn on the radio back and reset the module to take effect).

at+qcfg="band"?

This command is used to check which bands/frequencies are currently accepted.

[Ctrl-A is the prefix key] at+qcfg="band"? +QCFG: "band",0x0,0x100002000000000f0e189f,0x10004200000000090e189f OK

The first value in the "qcfg" response shows a hexadecimal value that specifies theGSM frequency band.This value is not relevant for the Quectel BG77 module. This value can be ignored.

The second hexadecimal value specifiesCAT-M频段(which is 0x100002000000000f0e189f).Ifit isset to 0,itmeans not to changethefrequency band. If, for example, it is 0x15, it means → 0x01(LTE Band 1)+0x04(LTE Band 3)+0x10(LTE Band 5).

The last hexadecimal value specifiesNB-IoT frequency bands(which is 0x10004200000000090e189f).Ifit isset to 0,itmeans not to changethefrequency band. If, for example, it is 0x15, it means → 0x01(LTE Band 1)+0x04(LTE Band 3)+0x10(LTE Band 5).

You can change the band with the commandat+qcfg="band",GSM_band,CAT_M_band,NB_IoT_band,effect, whereGSM_bandis GSM frequency band (can be left 0x0),CAT_M_bandis the CAT-M frequency band,NB_IoT_bandis the NB-IoT band andeffectis whether to take effect immediately (1) or to take effect after module reboots (0).

To setup module the way so that all bands are supported, use the command:

[Ctrl-A is the prefix key] at+qcfg="band",0x0,0x100002000000000f0e189f,0x10004200000000090e189f,1 OK

To speed up network searching, it is suggested to execute the commandat+cfun=0(to turn off the radio) and then use the described command. After that, executeat+cfun=1,1(to turn on the radio back and reset the module to take effect).

at+qgpscfg="priority",(0-1)

It is important to understand that data transfer over CAT-M/NB-IoT and GNSS can not work simultaneously (WWAN and GNSS Rx chains in the BG77 module share certain hardware blocks, meaning themodule does not supportconcurrentoperation ofWWAN and GNSS.). That is why theat+qgpscfg="priority",(0-1)command was introduced.

It is possible to change the priority with the commands:

[Ctrl-A is the prefix key] at+qgpscfg="priority",0 OK at+qgpscfg="priority",1 OK

at+qgpscfg="priority",0command sets thehighest priority for GNSS.

at+qgpscfg="priority",1command sets thehighest priority for LTE (WWAN).

When the device is in theLTE (WWAN) priority mode, the GNSS positioning request can successfully go through only when the RRC is released (Radio Resource Control protocol has many functions, but mainly is responsible for connection establishment and its release function) and LTE (WWAN) enters an idle sleep mode. Both LTE (WWAN) and GNSS can co-exist inLTE (WWAN) priority modeonly under the condition that eDRX is supported and not blocked by the ISP. If the network connection gets established (RRC is in the connected state) and the data begins flowing to the server → GNSS will be deferred until the data transmission is over and RCC is released. In case the eDRX is supported and the module enters this mode (data transmission is over) → GNSS coordinates will be sent. Once the data begins flowing to the server again, GNSS will be deferred until the device enters eDRX mode again.

When the device is in theGNSS priority mode, the GNSS positioning request succeeds in all WWAN states. If the device is in the RCC-connected state → it will release the RCC connection and initiates the GNSS session. After that, if there is WWAN data to be sent → RCC connection will be initiated again.