Telit NE310H2, NL865H2 Reference Manual

Page 1
Mod. 0805 2017-01 Rev.6
NE310H2 and NL865H2
AT Command Reference Guide
1VV0301611 Rev. 7 – 2020-08-18
Page 2
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 2 of 228 2020-08-18
SPECIFICATIONS ARE SUBJECT TO CHANGE WITHOUT NOTICE
NOTICE
While reasonable efforts have been made to assure the accuracy of this document, Telit assumes no liability resulting from any inaccuracies or omissions in this document, or from use of the information obtained herein. The information in this document has been carefully checked and is believed to be reliable. However, no responsibility is assumed for inaccuracies or omissions. Telit reserves the right to make changes to any products described herein and reserves the right to revise this document and to make changes from time to time in content hereof with no obligation to notify any person of revisions or changes. Telit does not assume any liability arising out of the application or use of any product, software, or circuit described herein; neither does it convey license under its patent rights or the rights of others.
It is possible that this publication may contain references to, or information about Telit products (machines and programs), programming, or services that are not announced in your country. Such references or information must not be construed to mean that Telit intends to announce such Telit products, programming, or services in your country.
COPYRIGHTS
This instruction manual and the Telit products described in this instruction manual may be, include or describe copyrighted Telit material, such as computer programs stored in semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit and its licensors certain exclusive rights for copyrighted material, including the exclusive right to copy, reproduce in any form, distribute and make derivative works of the copyrighted material. Accordingly, any copyrighted material of Telit and its licensors contained herein or in the Telit products described in this instruction manual may not be copied, reproduced, distributed, merged or modified in any manner without the express written permission of Telit. Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Telit, as arises by operation of law in the sale of a product.
COMPUTER SOFTWARE COPYRIGHTS
The Telit and 3rd Party supplied Software (SW) products described in this instruction manual may include copyrighted Telit and other 3rd Party supplied computer programs stored in semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit and other 3rd Party supplied SW certain exclusive rights for copyrighted computer programs, including the exclusive right to copy or reproduce in any form the copyrighted computer program. Accordingly, any copyrighted Telit or other 3rd Party supplied SW computer programs contained in the Telit products described in this instruction manual may not be copied (reverse engineered) or reproduced in any manner without the express written permission of Telit or the 3rd Party SW supplier. Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Telit or other 3rd Party supplied SW, except for the normal non-exclusive, royalty free license to use that arises by operation of law in the sale of a product.
Page 3
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 3 of 228 2020-08-18
USAGE AND DISCLOSURE RESTRICTIONS
I. License Agreements
The software described in this document is the property of Telit and its licensors. It is furnished by express license agreement only and may be used only in accordance with the terms of such an agreement.
II. Copyrighted Materials
Software and documentation are copyrighted materials. Making unauthorized copies is prohibited by law. No part of the software or documentation may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, without prior written permission of Telit
III. High Risk Materials
Components, units, or third-party products used in the product described herein are NOT fault­tolerant and are NOT designed, manufactured, or intended for use as on-line control equipment in the following hazardous environments requiring fail-safe controls: the operation of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air Traffic Control, Life Support, or Weapons Systems (High Risk Activities"). Telit and its supplier(s) specifically disclaim any expressed or implied warranty of fitness for such High Risk Activities.
IV. Trademarks
TELIT and the Stylized T Logo are registered in Trademark Office. All other product or service names are the property of their respective owners.
V. Third Party Rights
The software may include Third Party Right software. In this case you agree to comply with all terms and conditions imposed on you in respect of such separate software. In addition to Third Party Terms, the disclaimer of warranty and limitation of liability provisions in this License shall apply to the Third Party Right software.
TELIT HEREBY DISCLAIMS ANY AND ALL WARRANTIES EXPRESS OR IMPLIED FROM ANY THIRD PARTIES REGARDING ANY SEPARATE FILES, ANY THIRD PARTY MATERIALS INCLUDED IN THE SOFTWARE, ANY THIRD PARTY MATERIALS FROM WHICH THE
SOFTWARE IS DERIVED (COLLECTIVELY “OTHER CODE”), AND THE USE OF ANY OR ALL
THE OTHER CODE IN CONNECTION WITH THE SOFTWARE, INCLUDING (WITHOUT LIMITATION) ANY WARRANTIES OF SATISFACTORY QUALITY OR FITNESS FOR A PARTICULAR PURPOSE.
NO THIRD PARTY LICENSORS OF OTHER CODE SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND WHETHER MADE UNDER CONTRACT, TORT OR OTHER LEGAL THEORY, ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE OTHER CODE OR THE EXERCISE OF ANY RIGHTS GRANTED UNDER EITHER OR BOTH THIS LICENSE AND THE LEGAL TERMS APPLICABLE TO ANY SEPARATE FILES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Page 4
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 4 of 228 2020-08-18
APPLICABILITY TABLE
PRODUCTS
NE310H2-W1
NL865H2-W1
Page 5
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 5 of 228 2020-08-18
Contents
NOTICE ................................ ................................................................ ................................. 2
COPYRIGHTS ....................................................................................................................... 2
COMPUTER SOFTWARE COPYRIGHTS ............................................................................. 2
USAGE AND DISCLOSURE RESTRICTIONS ...................................................................... 3
I. License Agreements ............................................................................................ 3
II. Copyrighted Materials .......................................................................................... 3
III. High Risk Materials .............................................................................................. 3
IV. Trademarks .......................................................................................................... 3
V. Third Party Rights ................................................................................................ 3
APPLICABILITY TABLE ....................................................................................................... 4
CONTENTS ........................................................................................................................... 5
1. INTRODUCTION ........................................................................................................ 13
Scope ................................................................................................................ 13
Audience ............................................................................................................ 13
Contact Information, Support ............................................................................. 13
Text Conventions ............................................................................................... 14
2. AT COMMANDS ......................................................................................................... 15
Definitions .......................................................................................................... 15
AT Command Syntax ......................................................................................... 15
3. IDENTIFICATION COMMANDS ................................................................................. 18
AT+CGMI Request manufacturer identification ................................ .................. 18
AT+CGMM Request model identification ................................ ........................... 18
AT+CGMR Request revision identification ......................................................... 19
AT+CGSN Request IMEI ................................................................................... 19
AT+CIMI Request international mobile subscriber identity ................................. 20
*MATREADY ..................................................................................................... 21
AT+GMI Request manufacturer identification ................................ ..................... 21
AT+GMM Request model identification .............................................................. 22
AT+GMR Request revision identification ............................................................ 22
AT+GOI/+CGIO Request global object identification .......................................... 23
Page 6
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 6 of 228 2020-08-18
AT+GSN Request TA serial number identification (IMEI) ................................... 23
AT+ICF Set TE-TA control character framing ..................................................... 24
AT+CLCK Facility Lock ...................................................................................... 25
AT+CPWD Change password ............................................................................ 26
AT+CREG Network registration ......................................................................... 27
AT+CRSM Restricted SIM Access ..................................................................... 28
AT+CSCS Select TE Character Set ................................................................... 29
AT+CNUM Subscriber Number ................................ .......................................... 30
AT+CPOL Preferred operator list ....................................................................... 30
AT+CSIM Generic SIM Access .......................................................................... 31
AT+CTZR Time Zone Reporting ........................................................................ 32
4. GENERAL COMMANDS ............................................................................................ 33
ATE Command Echo ......................................................................................... 33
AT&D Set circuit Data Terminal Ready(DTR) function mod ................................ 33
ATV DCE Response Format .............................................................................. 34
AT+CFUN Set Phone Functionality .................................................................... 34
AT+CMEE Report Mobile Termination Error ...................................................... 35
+CME ERROR ME Error Result Code ............................................................... 36
AT+CEER Extended Error Report ...................................................................... 38
ATI Display product identification information ..................................................... 39
ATQ Set result code presentation mode............................................................. 40
ATN1 initial setting to handshake at highest speed ............................................ 40
ATS0 Set number of rings before automatically answering the call .................... 41
ATS1 Ring Counter ............................................................................................ 41
ATS2 Set escape sequence character ............................................................... 42
ATS3 Set command line termination character .................................................. 43
ATS4 Set response formatting character............................................................ 44
ATS5 Set command line editing character ......................................................... 45
ATS7 Set number of seconds to wait for connection completion ........................ 45
ATS10 Set disconnect delay after indicating the absence of data carrier ........... 46
ATS12 Set Escape Code Guard Time ................................................................ 46
ATS25 Set DTR change time ............................................................................. 48
ATS95 enable extended result codes ................................................................. 49
ATX Set CONNECT result code format and call monitoring ............................... 49
AT+FCLASS Set fax class ................................................................................. 50
AT+GCAP Request complete TA capabilities list ............................................... 50
Page 7
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 7 of 228 2020-08-18
AT&F Set all current parameters to manufacturer defaults ................................. 51
AT&K Flow control setting .................................................................................. 51
AT&V Display current configuration .................................................................... 52
AT&W Store current parameter to user defined profile ....................................... 52
AT&C Set circuit Data Carrier Detect (DCD) function mode ............................... 52
AT&D Set circuit Data Terminal Ready (DTR) function mode ............................. 53
5. SERIAL INTERFACE CONTROL COMMANDS ......................................................... 54
AT+IPR Set the Baud rate of UART ................................................................... 54
AT+IFC Local data flow control .......................................................................... 55
AT#TCOMWRT Firmware Upgrade through UART ........................................... 56
AT+CMUX Serial Multiplexer control ................................................................. 58
AT#TCLRBDRT Clear historical baud rate ......................................................... 59
6. SIM COMMANDS ....................................................................................................... 60
AT+CPIN Enter PIN ........................................................................................... 60
AT*MICCID Read USIM ICCID file .................................................................... 61
7. NETWORK SERVICE COMMANDS ........................................................................... 62
AT+CEREG EPS Network registration ............................................................... 62
AT+COPS PLMN Reselection ............................................................................ 64
AT+CESQ Get signal quality .............................................................................. 65
AT+CSQ Get signal quality ................................................................................ 66
AT+CTZU Automatic Time Zone Update ............................................................ 67
AT+CCLK Clock Management .......................................................................... 68
AT*MFRCLLCK Lock UE to specific frequency and optionally Cell ID ................ 69
AT*MBAND Query Current Modem NB-IOT Operating Band ............................. 70
AT*MBSC Lock BAND ....................................................................................... 71
AT*MENGINFO Query current network status and cell information .................... 72
AT*MNBIOTRAI Actively release RRC connection ............................................. 75
AT*RRCRELEASE Actively release RRC connection ........................................ 76
AT+CCIOTOPT CIoT Optimization Configuration............................................... 77
AT+CCHO Open UICC Logical Channel ............................................................ 78
AT+CCHC Close UICC Logical Channel ............................................................ 78
AT+CGLA Generic UICC Logical Channel Access ............................................. 79
AT+CPINR Remaining PIN Retries .................................................................... 80
AT+CGATT GPRS/Packet Domain attach or detach .......................................... 81
AT+CGACT PDP context activate or deactivate ................................................. 82
Page 8
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 8 of 228 2020-08-18
AT+CGPADDR Show PDP address ................................................................... 83
AT+IPCONFIG Query the device’s IP address ................................................... 84
AT+CGEREP Packet Domain Event Reporting .................................................. 84
AT+CGREG Network registration status ............................................................ 86
AT+CGPIAF Printing IP Address Format ........................................................... 87
AT+CGDEL Delete Non-Active PDP Contexts ................................................... 89
AT+CGAUTH Define PDP Context Authentication Parameters .......................... 90
AT+CGDATA Enter Data State .......................................................................... 91
AT*MBANDSL Set Modem NB-IOT Search Prefer Band List ............................. 91
AT*MNBIOTDT NB-IoT Data Type ..................................................................... 92
AT*MLPINFO Report packet domain packet counters ........................................ 93
8. POWER SAVING COMMANDS .................................................................................. 94
AT+CEDRXS eDRX Settings ............................................................................. 94
AT+CEDRXRDP eDRX to read dynamic parameters ......................................... 97
AT*MEDRXCFG eDRX configuration ................................................................. 98
AT+CPSMS set power saving mode (PSM) ..................................................... 100
AT*MNBIOTEVENT enable/disable active report of PSM ................................ 104
AT#TSLK enable/disable UE enter sleep ......................................................... 105
9. PS-DOMAIN COMMANDS ....................................................................................... 106
AT*MCGDEFCONT set the PSD connection settings for PDN connection ....... 106
AT+CGDCONT Define PDP Context................................................................ 107
AT+CGCONTRDP PDP Context Read ............................................................ 108
+IP IP address Unsolicited report command .................................................... 109
10. HARDWARE COMMANDS ...................................................................................... 110
AT+TRST RESET the Module.......................................................................... 110
AT+TURNOFF Turn Off the Module ................................................................. 110
AT#TADC Read pin ADC value ....................................................................... 110
AT#TCONTLED LED status control ................................................................. 111
AT+EGPIO Operate GPIO ............................................................................... 112
AT#SYSHALT System Halt ................................................................ .............. 114
AT#SHDN Software Shut Down ....................................................................... 115
AT+CBC Query Power Supply Voltage ............................................................ 115
AT#I2CWR - Write to I2C ................................................................................. 116
AT#I2CRD - Read to I2C ................................................................................. 117
AT#SPIOPEN Initialize modem serial port with SPI protocol ............................ 118
Page 9
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 9 of 228 2020-08-18
AT#SPICLOSE De-initialize modem serial port for SPI protocol ....................... 119
AT#SPIRW Write a buffer to the SPI and prints the read data .......................... 120
AT#GPIO General Purpose Input/Output Pin Control ....................................... 121
AT#E2RI Event Ring Indicator ......................................................................... 123
11. SNTP NETWORK COMMANDS ............................................................................... 124
AT+ESNTPSTART Start to query network time ............................................... 124
AT+ESNTPSTOP Stop to query network time .................................................. 124
+ESNTP received network time ....................................................................... 124
12. SMS COMMANDS .................................................................................................... 126
AT+CSMS Select Message Service ................................................................. 126
AT+CMGF Message Format ............................................................................ 127
AT+CSCA Service Centre Address .................................................................. 128
AT+CSMP Set Text Mode Parameters ............................................................. 129
AT+CSAS Save Settings .................................................................................. 130
AT+CRES Restore Settings ............................................................................. 130
AT+CNMI New Message Indications to TE ...................................................... 132
AT+CMGL List Messages ................................................................................ 133
AT+CMGR Read Message .............................................................................. 135
AT+CMGS Send Message ............................................................................... 138
AT+CMSS Send Message from Storage .......................................................... 139
AT+CMGW Write Message to Memory ............................................................ 140
AT+CMGD Delete Message ............................................................................. 141
AT+CMGC Send Command ............................................................................. 142
AT+CPMS Preferred Message Storage ........................................................... 143
AT+CSDH Show SMS text mode parameters .................................................. 144
AT+CNMA New Message Acknowledgment .................................................... 145
+CMS ERROR Message Service Failure Result Code ..................................... 146
13. TCP/IP COMMANDS ................................................................................................ 147
AT+ESOC CreateTCP/UDP socket .................................................................. 147
AT+ESOB Bind local address and local port ................................................... 147
AT+ESOCON Connect socket to remote address and port .............................. 148
AT+ESOSEND Send data to remote via socket ............................................... 149
AT+ESOCL Close socket ................................................................................. 149
+ESONMI Socket message arrived indicator ................................................... 150
+ESOERR Socket error indicator ..................................................................... 150
Page 10
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 10 of 228 2020-08-18
AT+ESODATAMODE Change to transparent mode ......................................... 151
AT+PING Test IP network connectivity to a remote host .................................. 152
Example: Create TCP socket ........................................................................... 153
Example: Create UDP socket ........................................................................... 153
14. MQTT COMMANDS ................................................................................................. 154
AT+EMQSCFG Encryption Configuration of MQTT .......................................... 154
AT+EMQSCFGRAW Encryption Configuration of MQTT through
transparent transmission .................................................................................. 157
AT+EMQNEW New MQTT ............................................................................... 160
AT+EMQCFG Configure Parameters of MQTT ................................................ 161
AT+EMQCON Send MQTT Connection packet ................................................ 162
AT+EMQDISCON Disconnect MQTT ............................................................... 163
+EMQDISCON Unsolicited report of MQTT disconnection .............................. 163
AT+EMQSUB Send MQTT subscribe packet ................................................... 163
AT+EMQUNSUB Send MQTT unsubscribe packet .......................................... 164
AT+EMQPUB Send MQTT publish packet ....................................................... 164
+EMQPUB –Unsolicited report of MQTT publish packet .................................. 165
Example: create MQTT connection ................................................................. 165
15. COAP COMMANDS ................................................................................................. 166
AT+ECOAPNEW Create a CoAP client instance ............................................ 166
AT+ECOAPSEND Send CoAP data................................................................. 166
AT+ECOAPDEL Destroy the CoAP client instance .......................................... 168
+ECOAPNMI Content from CoAP server ........................................................ 169
Example: COAP client send data ..................................................................... 170
16. FTP COMMANDS ..................................................................................................... 172
AT+FTPOPEN Start FTP file service................................................................ 172
AT+FTPCLOSE Close FTP file service ............................................................ 173
AT+FTPSIZE Get the Size of FTP File ............................................................. 173
AT+FTPGET FTP File download ...................................................................... 174
AT+FTPPUTCON Establish upload link ........................................................... 175
AT+FTPPUTDATA FTP File upload ................................................................. 176
AT+FTPCFG configuration FTP file content download format .......................... 177
AT+FTPGETOTA download Difference packet from FTP server ...................... 177
AT+OTAUP Excute FTP FOTA Update ............................................................ 178
URC of FTP FOTA and LwM2M FOTA ............................................................ 178
FTP Process Example ..................................................................................... 179
Page 11
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 11 of 228 2020-08-18
FTP FOTA Process Example ........................................................................... 180
17. HTTP/HTTPS COMMANDS ...................................................................................... 181
AT+EHTTPCREATE Create a HTTP/HTTPS client instance ........................... 181
AT+EHTTPCON Establish the HTTP/HTTPS connection ................................. 182
AT+EHTTPDISCON Close HTTP/HTTPS connection ..................................... 182
AT+EHTTPDESTROY Destroy the HTTP/HTTPS client instance ................... 183
AT+EHTTPSEND Send HTTP/HTTPS package .............................................. 183
+EHTTPNMIH Header of the response from host ............................................ 184
+EHTTPNMIC Content of the response from host............................................ 185
+EHTTPERR HTTP/HTTPS client connection error indicator ........................... 185
Example: Create HTTP connection ................................ .................................. 186
Example: Create HTTPS connection ................................................................ 187
18. HTTP/HTTPS SIMPLIFIED COMMANDS ................................................................. 189
AT+HTTPCFG Configure Parameters for HTTP(S) connection ........................ 189
AT+HTTPURL Set URL of HTTP(S) Server ..................................................... 196
AT+HTTPGET Send GET Request to HTTP(S) Server .................................... 197
AT+HTTPPOST Send POST Request to HTTP(S) Server ............................... 198
Result code of HTTP/HTTPS ........................................................................... 200
19. NIDD COMMANDS ................................................................................................... 201
AT+NIDD Non-IP Data Delivery AT command ................................................. 201
20. LWM2M COMMANDS .............................................................................................. 202
AT+ELMREG Configuration LwM2M instance and establish connection .......... 202
AT+ELMDEREG Delete LwM2M instance and disconnect ............................... 204
AT+ELMBINDING Configuration binding mode ................................................ 205
AT+ELMADDOBJ Add LwM2M object ............................................................. 206
AT+ELMDELOBJ Delete LwM2M object .......................................................... 206
AT+ ELMUPDATE Update lifetime ................................................................... 207
+ELMREAD URC indicate server sending a read request ................................ 208
AT+ELMREADRSP Response to server’s read request ................................... 208
+ELMWRITE URC indicate server sending a write request .............................. 209
AT+ELMWRITERSP Response to server’s write request ................................. 210
+ELMEXECUTE URC indicate server sending a excute request ...................... 210
AT+ELMEXECUTERSP Response to server’s execute request ....................... 211
+ELMOBSERVEREQ URC indicate server sending a observe request ........... 211
AT+ELMOBSERVERSP Response to server’s observe request ...................... 212
Page 12
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 12 of 228 2020-08-18
AT+ELMSEND Send data to server ................................................................. 213
AT+ELMSTATUS Query the LwM2M instance status ...................................... 214
+ELMEVT URC of information notification ....................................................... 215
Create LwM2M connection example ................................................................ 216
21. TLS NEWWORK COMMANDS ................................................................................ 218
AT+TLSCFG Configuration TLS Context Parameters ................................................. 218
AT+TLSOPEN Establish TLS connection ........................................................ 220
AT+TLSCLOSE Close TLS connection ................................ ............................ 221
AT+TLSSEND Send data in ASCII code .......................................................... 221
AT+TLSSENDRAW Send original data ................................ ............................ 222
AT+TLSRECV URC of Receive data................................................................ 223
AT+TLSSTAT Get TLS connection state .......................................................... 223
+TLSSTAT URC of TLS connection state ........................................................ 224
TLS connection example .................................................................................. 224
22. NETWORK FRIENDLY MODE ................................................................................. 225
AT+NFM NETwork Friendly Mode Enable/disable ........................................... 225
AT+NFM NETwork Friendly Mode Enable/disable ........................................... 225
23. LIST OF ACRONYMS .............................................................................................. 226
24. DOCUMENT HISTORY ............................................................................................ 227
Page 13
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 13 of 228 2020-08-18
1. INTRODUCTION
Scope
This document is aimed at providing a detailed specification and a comprehensive listing as a reference for the whole set of AT commands.
Audience
Readers of this document should be familiar with Telit modules and their ease of controlling by means of AT Commands.
Contact Information, Support
For general contact, technical support services, technical questions and report documentation errors contact Telit Technical Support at:
TS-EMEA@telit.com
TS-AMERICAS@telit.com
TS-APAC@telit.com
TS-SRD@telit.com
Alternatively, use:
http://www.telit.com/support
For detailed information about where you can buy the Telit modules or for recommendations on accessories and components visit:
http://www.telit.com
Our aim is to make this guide as helpful as possible. Keep us informed of your comments and suggestions for improvements.
Telit appreciates feedback from the users of our information.
Page 14
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 14 of 228 2020-08-18
Text Conventions
SET section – This section provides all information related to SET functionality of involved AT command. If it has got strictly and relevant SET information, these are located at section end.
READ section – This section provides all information related to READ functionality of involved AT command. If it has got strictly and relevant READ information, these are located at section end.
TEST section – This section provides all information related to TEST functionality of involved AT command. If it has got strictly and relevant TEST information, these are located at section end.
Additional info – This section provides any kind of additional and useful information related to the AT command section as well as command exceptions or special behavior cases.
REFERENCE section – This section provides useful references (standards or normative) related to involved AT command.
EXAMPLE section – This section provides useful examples related to involved AT command.
NOTE section – This section provides all information related to involved AT commands. Each note can provide a different level of information: danger, caution/warning and tip/information.
Danger – This information MUST be followed or catastrophic equipment failure or bodily injury may occur.
Caution or Warning – Alerts the user to important points about integrating the module, if these points are not followed, the module and end user equipment may fail or malfunction.
Tip or Information – Provides advice and suggestions that may be useful when integrating the module.
All dates are in ISO 8601 format, i.e. YYYY-MM-DD.
Page 15
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 15 of 228 2020-08-18
2. AT COMMANDS
The Telit wireless module family can be controlled via the serial interface using the standard AT commands1F1F1. The Telit wireless module family is compliant with:
1. Hayes standard AT command set, to maintain the compatibility with existing SW programs.
2. 3GPP TS 27.007 specific AT command and GPRS specific commands.
3. 3GPP TS 27.005 specific AT commands for SMS (Short Message Service) and CBS (Cell Broadcast Service)
Moreover, Telit wireless module family supports also Telit proprietary AT commands for special purposes.
The following is a description of how to use the AT commands with the Telit wireless module family.
Definitions
The following syntactical definitions apply:
<CR> Carriage return character is the command line and result code terminator character. <LF> Linefeed character is the character recognized as line feed character. <...> Name enclosed in angle brackets is a syntactical element. They do not appear in the
command line.
[...] Optional subparameter of a command or an optional part of TA information response is
enclosed in square brackets. Brackets themselves do not appear in the command line.
AT Command Syntax
The AT command format supported by Telit module is following the 3GPP related standards. There are two types of extended command:
- Parameter type commands. This type of commands may be:
Set command, AT+CMD=[<value>]<CR>, to store a value or values for later use
Read command, AT+CMD?<CR>, to determine the current value or values stored
Test command, AT+CMD=?<CR>, to give information about the type of its subparameters
- Action type commands. Execution command, This type of command may be “executed” or “tested”
1
The AT is an ATTENTION command and is used as a prefix to other parameters in a string. The
AT command combined with other parameters can be set up in the communications package or typed in manually as a command line instruction combined with other parameters can be set up in the communications package or typed in manually as a command line instruction.
Page 16
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 16 of 228 2020-08-18
If all the subparameters of a parameter type command +CMD are optional, issuing AT+CMD=<CR> causes the OK result code to be returned and the previous values of the omitted subparameters to be retained.
NOTE:
The command line buffer accepts a maximum of 400 characters. If this number is exceeded none of the commands will be executed and TA returns ERROR.
2.2.1. Command Lines
A command line is made up of three elements: the prefix, the body and the termination character. The command line prefix consists of the characters “AT” or “at”, or, to repeat the execution of the previous command line, the characters “A/” or “a/”. The termination character may be selected by a user option (parameter S3), the default being <CR>.
The basic structures of the command line are:
AT command without parameter, AT is the command line prefix, CMD1 is the body of a basic command and <CR> is the command line terminator character, format: AT[
|&]<command> Example: AT+CGMR
Read command for checking current sub-parameter values, Format: AT[ |&]<command>?
Example: AT+CMEE?
Test command for checking possible sub-parameter values, Format: AT[ |&]<command>=?
Example: AT+CGDCONT=?
AT command with parameter, Format: AT[|&]<command>=<par1>,<par2>,<par3>… The response of this command is:
<CR><LF><response><CR><LF>
<CR><LF><OK/ERROR>[ERROR information]<CR><LF>
NOTE: The command line buffer accepts a maximum of 80 characters. If this number is exceeded none of the commands will be executed and TA returns ERROR.
Page 17
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 17 of 228 2020-08-18
2.2.2. Information Responses and Result Codes
The TA response, in case of verbose response format enabled, for the previous examples command line could be as shown below:
Information response to +CMD1? <CR><LF>+CMD1:2,1,10<CR><LF> Information response to +CMD1=? <CR><LF>+CMD1: (0-2),(0,1),(0-15)<CR><LF> Final result code <CR><LF>OK<CR><LF> Moreover there are other two types of result codes:
result codes that inform about progress of TA operation (e.g. connection establishment CONNECT)
result codes that indicate occurrence of an event not directly associated with issuance of a command from TE
2.2.3. Command Response Time-out
Every command issued to the Telit modules returns a result response if response codes are enabled (default). The time needed to process the given command and return the response varies, depending on the command type. Commands that do not interact with the SIM or the network, and involve only internal set up settings or readings, have an immediate response, depending on SIM configuration(e.g., number of contacts stored in the phonebook, number of stored SMS), or on the network the command may interact with.
In the table below are listed only the commands whose interaction with the SIM or the network could lead to long response timings. When not otherwise specified, timing is referred to set command.
Command
Estimated maximum time to get
response (Seconds)
+COPS
180 (For test command)
+CLCK
180
+CPWD
180
+CPIN
5
+CRSM
5
2.2.4. Command Issuing Timing
The chain Command -> Response shall always be respected and a new command must not be issued before the module has terminated all the sending of its response result code (whatever it may be).
This applies especially to applications that “sense” the OK text and therefore may send the next
command before the complete code <CR><LF>OK<CR><LF> is sent by the module. It is advisable anyway to wait for at least 20ms between the end of the reception of the response and the issue of the next AT command. If the response codes are disabled and therefore the module does not report any response to the command, then at least the 20ms pause time shall be respected.
During command mode, due to hardware limitations, under severe CPU load the serial port can lose some characters if placed in auto-baud at high speeds. Therefore, if you encounter this problem fix the baud rate with +IPR command.
Page 18
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 18 of 228 2020-08-18
3. IDENTIFICATION COMMANDS
AT+CGMI Request manufacturer identification
This command is used to Request manufacturer identification
AT+CGMI Response <CR><LF><manufacturer><CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<manufacturer>: module manufacturer
AT+CGMI=? Response <CR><LF>OK<CR><LF>
AT+CGMI TELIT
OK
AT+CGMM Request model identification
This command causes the DCE to transmit one or more lines of information text, determined by the manufacturer,
which is intended to permit the user of the DCE to identify the specific model of device.
AT+CGMM Response
<CR><LF><model><CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<model>: module ID
AT+CGMM=? Response <CR><LF>OK<CR><LF>
AT+CGMM NE310H2-W1
OK
Page 19
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 19 of 228 2020-08-18
AT+CGMR Request revision identification
Execution command returns the device model identification code without command echo
AT+CGMR Response
<CR><LF><revision><CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF> Parameter
<revision>: firmware version
AT+CGMR=? Response <CR><LF>OK<CR><LF>
AT+CGMR M0J.00000-B001
OK
AT+CGSN Request IMEI
This command is used to request IMEI/SN/SVN
AT+CGSN=<sn>
<CR><LF><sn><CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<sn> it is SN in default
0 SN 1 IMEI 2 IMEISV 3 SVN
AT+CGSN=?
<CR><LF>list <sn><CR><LF> <CR><LF>OK<CR><LF>
Page 20
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 20 of 228 2020-08-18
AT+CGSN +CGSN: 1234567
OK AT+CGSN=0 1234567
OK AT+CGSN=1 +CGSN: 123456789012396
OK AT+CGSN=2 +CGSN: 1234567890123901
OK AT+CGSN=3 +CGSN: 01
OK
AT+CIMI Request international mobile subscriber identity
This command is used to request IMSI.
AT+CIMI
Response <CR><LF><IMSI><CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<IMSI>: International Mobile Subscriber Identity (string without double quotes)
AT+CIMI=?
Response <CR><LF>OK<CR><LF>
AT+CIMI 010011234567890
OK
Page 21
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 21 of 228 2020-08-18
*MATREADY
This unsolicited result code is generated on any new AT channel that is enabled. It is not configurable and will always be generated when a channel is enabled. This URC is not generated on channels re-enabled after wakeup from deep sleep.
unsolicited result code
*MATREADY: <ready_status><CR><LF>
Parameter
<ready_status> 1: AT channel ready (only valid value
When module power on and AT channel enabled *MATREADY: 1 +CFUN: 1
+CPIN: READY
AT+GMI Request manufacturer identification
3GPP TS 27.007
Execute command AT+GMI Response
• TA returns manufacturer identification text.
• <manufacturer>
OK Parameters
• <manufacturer>
Test command AT+GMI=? Response
• OK
Page 22
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 22 of 228 2020-08-18
AT+GMM Request model identification
3GPP TS 27.007
Execute command AT+GMM Response
• TA returns product model identification text
• <model> OK
Parameters
• <model>
Test command AT+GMM=? Response OK
AT+GMR Request revision identification
3GPP TS 27.007
Execute command AT+CGMR Response
• TA returns product software version identification text
• <revision> OK
Parameters
• <revision>
Test command AT+GMR=? Response OK
Page 23
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 23 of 228 2020-08-18
AT+GOI/+CGIO Request global object identification
ITU-T Recommendation V.25 ter
Execute command AT+GOI/+CGIO Response
• TA reports one or more lines of information text that permit the user to identify the device,
based on the ISO system for registering unique object identifiers. Parameter
• <Object Id> identifier of device type Scope Channel specific (response output only on channel which entered the command)
Test command AT+GOI/+CGIO=? Response
• OK
AT+GSN Request TA serial number identification (IMEI)
ITU-T Recommendation V.25 ter
Execute command AT+GSN Response
• TA reports the IMEI (International Mobile Equipment Identifier) number in information text
that permits the user to identify the individual ME device.
• <sn> OK
Parameter
• <sn> IMEI of the telephone (International Mobile station Equipment Identity) Scope Channel specific (response output only on channel which entered the command)
Test command AT+GSN=? Response OK
Page 24
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 24 of 228 2020-08-18
AT+ICF Set TE-TA control character framing
ITU-T Recommendation V.25 ter
Set command AT+ICF=[<format>,[<parity>]] Response
• This parameter setting determines the serial interface character framing format and parity
received by TA from TE.
• Note: +IPR=0 forces +ICF=0
• OK
Parameter Note: The parity field is ignored if the format field specifies no parity.
• <format> 1 8 data 0 parity 2 stop 2 8 data 1 parity 1 stop 3 8 data 0 parity 1 stop 4 7 data 0 parity 2 stop 5 7 data 1 parity 1 stop 6 7 data 0 parity 1 stop
• <parity> 0 odd 1 even 2 mark (1) 3 space (0) Scope Channel Specific
Test command AT+ICF=? Response
• +ICF:(list of supported <format>s), (list of supported <parity>s) OK Parameter
• see set command
Read command AT+ICF? Response
• +ICF: <format>,<parity> OK o Note: This framing is applied for command state Parameter
• see set command
Page 25
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 25 of 228 2020-08-18
AT+CLCK Facility Lock
This command is used to lock, unlock or interrogate a ME or a network facility <fac>. Password is normally needed to do
such actions. When querying the status of a network service (<mode>=2) the response line for ‘not active’ case
(<status>=0) should be returned only if service is not active for any <class>.
3GPP TS 27.007
Execute command AT+CLCK = <fac>,<mode>[,<passwd>[,<class>]] Response This command is used to lock, unlock or interrogate a ME or a network facility <fac>. Password is normally needed to do such actions. When querying the status of a network
service (<mode>=2) the response line for ‘not active’ case (<status>=0) should be returned
only if service is not active for any <class>.
• If <mode><>2 and command is successful OK
• If <mode>=2 and command is successful +CLCK: <status>[,<class1>[<CR><LF>
+CLCK: <status>, class2....]] OK
• If error is related to ME functionality: +CME ERROR: <err> Parameters <fac> "SC" SIM (lock SIM card) (SIM asks password in ME power-up and when this lock command issued)
Proprietary additions: <mode> 0 unlock 1 lock 2 query status <passwd> password <class> Field not required for NB-IOT, so will be ignored <status> 0 off 1 on
Test command AT+CLCK=? Response
• +CLCK: (list of supported <fac>s) OK Parameters
• see execute command
Page 26
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 26 of 228 2020-08-18
AT+CPWD Change password
3GPP TS 27.007
Execute command AT+CPWD = <fac>,[<oldpwd>],<newpwd> Response TA sets a new password for the facility lock function.
• OK
• If error is related to ME functionality:
+CME ERROR: <err> Parameters
• <fac> "SC" SIM (lock SIM card) (SIM asks password in ME power-up and when this lock command issued)
• <oldpwd> old password
• <newpwd> new password
Test command AT+CPWD=? Response TA returns a list of pairs that present the available facilities and the maximum length of their password.
• +CPWD: list of supported (<fac>, <pwdlength>)s OK
• If error is related to ME functionality:
+CME ERROR: <err> Parameters
• <fac> see execute command
• <pwdlength> integer maximum length of password
Page 27
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 27 of 228 2020-08-18
AT+CREG Network registration
3GPP TS 27.007
Set command AT+CREG=[<n>] Response
• UE controls the presentation of an unsolicited result code +CREG: <stat> when <n>=1 and
there is a change in the ME network registration status.
• OK Parameters <n> 0 disable network registration unsolicited result code 1 enable network registration unsolicited result code +CREG: <stat> 2 enable network registration and location information unsolicited result code +CREG: <stat>[,<lac>,<ci>[,<AcT>]]
<stat> 0 not registered, ME is not currently searching a new operator to register to 1 registered, home network 2 not registered, but ME is currently searching a new operator to register to 3 registration denied 4 unknown 5 registered, roaming 6 registered for “SMS only”, home network (applicable only when <Act> indicates NB-IOT 7 registered for “SMS only”, roaming (applicable only when <Act> indicates NB-IOT
<lac> string type; two byte location area code or tracking area code in hexadecimal format (e.g."00C3" equals 195 in decimal)
<ci> string type; four byte UTRAN/GERAN/E-UTRAN cell ID in hexadecimal format <AcT> access technology of the registered network 9 NB-IoT
Unsolicited result code
• When <n>=1 and there is a change in the ME network registration status: +CREG: <stat>
• When <n>=2 and there is a change in the ME cell status:
+CREG: <stat>[,<lac>,<ci>[,<AcT>]] Parameters
• see set command
Note
• For NB-IoT product, only <AcT> value of 9 is valid
Test command AT+CREG=? Response
• +CREG: list of supported <n>s OK Parameters
• see set command
Read command AT+CREG? Response UE returns the status of result code presentation and an integer <stat> which shows whether
Page 28
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 28 of 228 2020-08-18
the network has currently indicated the registration of the ME. Location information elements <lac>, <ci> and <AcT> are returned only when <n>=2 and ME is registered in the network.
When <n> = 0 or 1: +CREG: <n>,<stat> OK
• When <n> = 2: +CREG: <n>,<stat>[,<lac>,<ci>[,<AcT>]] OK
• If error is related to ME functionality: +CME ERROR: <err> Parameters
• see set command
AT+CRSM Restricted SIM Access
3GPP TS 27.007
Set command AT+CRSM=<command>[,<fileid>[,<P1>,<P2>,<P3>[,<data>[,<pathid>]]]] Response
• +CRSM: <sw1>,<sw2>[,<response>]
• +CME ERROR: <err>
Parameters
• <command> integer type: 3GPP 102.221 SIM command sent from the ME to the SIM 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS
• <fileid> integer type; this is the identifier of an elementary datafile on SIM. Mandatory for every command except STATUS.
• <P1>,<P2>,<P3> integer type; parameters passed on by the ME to the SIM. These
parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in 3GPP 102.221
• <data> information which shall be written to the SIM (hexadecimal character format; refer +CSCS)
• <sw1>,<sw2> integer type; information from the SIM about the execution of the actual
command. These parameters are delivered to the TE in both cases, on successful or failed execution of the command
• <response> response of a successful completion of the command previously issued
(hexadecimal character format; refer +CSCS). STATUS and GET RESPONSE return data, which gives information about the current elementary data field. This information includes the type of file and its size (refer 3GPP 102.221). After READ BINARY or READ RECORD command the requested data will be returned. <response> is not returned after a successful UPDATE BINARY or UPDATE RECORD command
• <pathid> String type; contains the path of an elementary file on the SIM/UICC in
hexadecimal format as defined in ETSI TS 102.211 (e.g. “7F205F70” in SIM and UICC case).
The <pathid> only used in the mode “select path from MF” as defined in ETSI TS 102.211. <pathid> is only valid for USIMs
Page 29
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 29 of 228 2020-08-18
Test command AT+CRSM=? Response
• OK
AT+CSCS Select TE Character Set
3GPP TS 27.007
Set command AT+CSCS=[<chset>] Response
• Sets which character set <chset> is used by the TE. The TA can then convert character
strings correctly between the TE and ME character sets. Parameter
• <chset> “GSM” GSM default alphabet. “HEX” Hexadecimal numbers in character strings “IRA” International reference alphabet (ITU-T T.50) “PCCP” PC character set Code Page “PCDN” PC Danish/Norwegian character set “UCS2” UCS2 alphabet “8859-1” ISO 8859 Latin (1) character set
Test command AT+CSCS=? Response
• +CSCS: (list of supported <chest>s)
Read command AT+CSCS? Response
• +CSCS: <chset> OK Parameters
• see Set command
Page 30
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 30 of 228 2020-08-18
AT+CNUM Subscriber Number
3GPP TS 27.007
Test command AT+CNUM=? Response <CR><LF>OK<CR><LF>
AT+CPOL Preferred operator list
3GPP TS 27.007
Set command AT+CPOL=[<index>][,<format>[,<oper>[,<GSM_AcT>,<GSM_Compact_AcT>,<UTRAN_ AcT>,<E-UTRAN_AcT>]]] Response
• +CME ERROR: <err> Parameters <index> integer type: order number of operator in USIM preferred operator list <format> 0 long format alphanumeric <oper> 1 short format alphanumeric <oper> 2 numeric <oper> <opern> string type: <format> indicates whether alphanumeric or numeric format used (see +COPS command)
<GSM_AcTn> GSM Access technology; 0 access technology not selected 1 access technology selected
<GSM_Comp_AcTn> GSM compact Access technology; 0 access technology not selected access technology selected
<UTRAN_AcTn> UTRA Access technology; 0 access technology not selected 1 access technology selected
<E-UTRAN_AcTn> E-UTRAN Access technology; 0 access technology not selected 1 access technology selected
Note
Not all USIMs support the preferred operator list.
Test command AT+CPOL=? Response
• +CPOL: (list of supported <index>s),(list of supported <format>s) Parameter
• See set command
Page 31
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 31 of 228 2020-08-18
Read command AT+CPOL? Response
• +CPOL: <index1>,<format>,<oper1>[,<GSM_AcT1>,<GSMcomp_AcT1>,<UTRAN_AcT1>,<E­UTRAN_Act1]
[<CR><LF>+CPOL:
<index2>,<format>,<oper2>[,<GSM_AcT2>,<GSMcomp_AcT2>,<UTRAN_AcT2,<E-UTRAN_AcT2>]
• […]]
• +CME ERROR: <err>
Parameter
• See set command
AT+CSIM Generic SIM Access
3GPP TS 27.007
Set command AT+CSIM=<length>,<command> Response
• +CSIM: <length>,<response>
• +CME ERROR: <err>
Parameters
• <length> integer type: length of characters sent to the TE in <command> or <response> (i.e. twice the number of octets in the raw data)
• <command> string type: hex format: 3GPP 102.221 SIM command sent from the ME to the SIM
• <response> string type: hex format: 3GPP 102.221 response from SIM to <command>
Test command AT+CSIM=? Response
• OK
Page 32
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 32 of 228 2020-08-18
AT+CTZR Time Zone Reporting
3GPP TS 27.007
Set command AT+CTZR=<onoff> Response
<CR><LF>OK<CR><LF>
If error is related to ME functionality:
<CR><LF>+CME ERROR: <err><CR><LF>
This set command enables and disables the time zone change event reporting. If the reporting is enabled the MT returns the unsolicited result code +CTZV: <tz> whenever thetime zone is changed. Parameter
<onoff> 0 Disable time zone change event reporting (default value)
1 Enable time zone change event reporting by unsolicited result code +CTZV: <tz> 2 Enable extended time zone and local time reporting by unsolicited result code +CTZE: <tz>,<dst>,[<time>]. <tz> String type. The sum of the local time zone (difference between the local time and GMT is expressed in quarters of an hour) plus daylight saving time. The format is “±zz”, expressed as a fixed width, two-digit integer with the range -
48 ... +56. To maintain a fixed width, numbers in the range -9 ... +9 are expressed with a leading zero, e.g. “-09”, +00” and “+09”.
<dst> Integer type. Indicates whether <tz> includes daylight savings adjustment
0 <tz> includes no adjustment for daylight saving time 1 <tz> includes +1 hour (equals 4 quarters in <tz>) adjustment for daylight saving time
2 <tz> includes +2 hours (equals 8 quarters in <tz>) adjustment for daylight saving time <time> String type. The local time. The format is “YYYY/MM/DD,hh:mm:ss”, expressed as integers representing year (YYYY), month (MM), date (DD), hour (hh), minute (mm) and second (ss). This parameter can be provided by the network when delivering time zone information and will be presented in the unsolicited result code of extended time zone reporting if provided by the network. The format of "MM", "hh are variable width, numbers in the range 1~9 are expressed with 1~9.
Test command AT+CTZR=? Response
<CR><LF>+CTZR: (list of supported <onoff>s) <CR><LF> <CR><LF>OK<CR><LF>
If error is related to ME functionality:
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
See set command
Read command AT+CTZR? Response
<CR><LF>+CTZR: <onoff><CR><LF> <CR><LF>OK<CR><LF>
If error is related to ME functionality:
<CR><LF>+CME ERROR: <err><CR><LF>
Parameters See set command
Page 33
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 33 of 228 2020-08-18
4. GENERAL COMMANDS
ATE Command Echo
The setting of this parameter enables/disables the command echo.
AT E<val>
Response <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter <val>:
0: DCE disables command echo
1: DCE enables command echo , hence command sent to the device are echoed back to the
DTE. . (factory default)
ATE0
OK
//Input AT, but the device disable command echo
OK
AT&D Set circuit Data Terminal Ready(DTR) function mod
Set circuit Data Terminal Ready(DTR) function mode.this parameter detremines how the TA responds when circuit
108/2(DTR) is changed from the ON to the OFF condition during data mode.
AT&D[<value>]
Response <CR><LF>OK<CR><LF>
Parameter <value>:
0: TA ignores status on DTR.
1:ON->OFF on DTR:Change to command mode with call remaining connected 2:OFF->ON on DTR:Disconnect call,change to command mode,During state DTR=OFF is auto­answer off.
Page 34
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 34 of 228 2020-08-18
ATV DCE Response Format
The setting of this parameter determines the contents of the header and trailer transmitted with result codes and information responses. It also determines whether result codes are transmitted in a numeric form or an alphabetic (or "verbose") form. The text portion of information responses is not affected by this setting.
ATV<val>
Response <CR><LF>OK<CR><LF> or <CR><LF>+CME ERROR: <err><CR><LF>
Parameter <val>: 0: DCE transmits limited headers and trailers and numeric text. 1:DCE transmits full headers and trailers and verbose response text.
AT+CFUN Set Phone Functionality
Set command selectsthe level of functionality <fun> in the MT.
AT+CFUN=[<fun>[,<rst>]]
Response <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF> Parameter <fun>: 0: minimum functionality 1: full functionality (factory default) 4: disable phone both transmit and receive RF circuits 7: Disable SIM card; transmit and receive circuits are valid Other value reserved
NOTE: issuing AT+CFUN=4[,0] actually causes the module to perform either a network deregistration and a SIM deactivation.
<rst>: 0: no need to reset the module to make <fun> effect. 1: need to reset the module to make <fun> effect. 2: reserved NOTE: This shall be always default 0 when <rst> is not given
unsolicited
result
code
When module power on and the module will report: +CFUN: <fun><CR><LF>
AT+CFUN=?
Response <CR><LF>+CFUN: (list of supported <fun>s), (list of supported <rst>s)<CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Page 35
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 35 of 228 2020-08-18
AT+CFUN?
Response <CR><LF>+CFUN: <fun><CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
AT+CFUN? +CFUN: 1
OK AT+CFUN=? +CFUN: (0,1,4,7),(0-2)
OK
AT+CMEE Report Mobile Termination Error
Set command disables or enables the use of result code +CME ERROR: <err> as an indication of an error relating to the functionality of the MT. When enabled, MT related errors cause +CME ERROR: <err>final result code instead of the regular ERROR final result code. ERROR is returned normally when error is related to syntax, invalid parameters, or TA functionality. Read command returns the current value of subparameter <n>. Test command returns values supported as a compound value.
AT+CMEE=[<n>] Response <CR><LF>OK<CR><LF>
Parameter
<n>:
0: disable +CME ERROR: <err> result code and use ERROR instead
1: enable +CME ERROR: <err> result code and use numeric <err> values
2: enable +CME ERROR: <err> result code and use verbose <err>values
AT+CMEE=? Response
<CR><LF>+CMEE: (list of supported <n>s)<CR><LF> <CR><LF>OK<CR><LF>
AT+CMEE? Response
<CR><LF>+CMEE: <n><CR><LF> <CR><LF>OK<CR><LF>
AT+CMEE=0 //+CME ERROR shall not be used OK AT+CGSN
ERROR AT+CMEE=1 //use numeric <err>
Page 36
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 36 of 228 2020-08-18
OK AT+CGSN
+CME ERROR: 23 AT+CMEE=2 //use verbose <err> OK AT+CGSN
+CME ERROR: memory failure
+CME ERROR ME Error Result Code
This is NOT a command, it is the error response to +Cxxx 3gpp TS 27.007 commands.
+CME ERROR ME Error Result Code
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter <err> - error code can be either numeric or verbose (see +CMEE).
The possible values of <err> are reported in the table:
Numeric Format
Verbose Format
General error:
0
Phone failure
1
No connection to phone
2
phone-adaptor link reserved
3
Operation not allowed
4
Operation not allowed
5
PH-SIM PIN required
6
PH-FSIM PIN required
7
PH-FSIM PUK required
10
SIM not inserted
11
SIM PIN required
12
SIM PUK required
13
SIM failure
14
SIM busy
15
SIM wrong
16
Incorrect password
17
SIM PIN2 required
18
SIM PUK2 require
20
Memory full
21
Invalid index
Page 37
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 37 of 228 2020-08-18
22
Not found
23
Memory failure
24
Text string too long
25
Invalid characters in text string
26
Dial string too long
27
Invalid characters in dial string
30
No network service
31
Network timer-out
32
Network not allowed -emergency calls only
40
Network personalization PIN required
41
Network personalization PUK required
42
Network subset personalization PIN required
43
Network subset personalization PUK required
44
Service provider personalization PIN required
45
Service provider personalization PUK required
46
Corporate personalization PIN required
47
corporate personalization PUK required
48
Hidden key required (NOTE: This key is required when accessing hidden phonebook
49
EAP method not supported
50
Incorrect parameters
100
unknown
GPRS-related errors
Errors related to a failure to perform an Attach
103
Illegal MS (#3)
106
Illegal ME (#6)
107
GPRS services not allowed (#7)
111
PLMN not allowed (#11)
112
Location area not allowed (#12)
113
Roaming not allowed in this location area (#13)
Errors related to a failure to Activate a Context
132
service option not supported (#32)
133
requested service option not subscribed (#33)
134
service option temporarily out of order (#34)
149
PDP authentication failure
Other GPRS errors
150
invalid mobile class
Page 38
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 38 of 228 2020-08-18
148
unspecified GPRS error
VBS / VGCS and eMLPP -related errors
151
VBS/VGCS not supported by the network
152
No service subscription on SIM
153
No subscription for group ID
154
Group Id not activated on SIM
155
No matching notification
156
VBS/VGCS call already present
157
Congestion
158
Network failure
159
Uplink busy
160
No access rights for SIM file
161
No subscription for priority
162
operation not applicable or not possible
AT+CEER Extended Error Report
Reports extended error related to the last unsuccessful call
3GPP TS 27.007
SIM Presence
Setting saved
Can be aborted
MAX timeout
Not required
No
No
-
AT+CEER Execution command returns one or more lines of information text <report> offering the TA user an extended error report, in the format:
+CEER: <report> This report regards some error condition that may occur:
- the failure in the last unsuccessful call setup (originating or answering)
- the last call release If no error condition has occurred since power up, then "Normal, unspecified" condition is
reported
AT+CEER=? Test command returns OK result code.
Page 39
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 39 of 228 2020-08-18
ATI Display product identification information
ATI Display product identification information
ITU-T Recommendation V.25 ter
SIM Presence
Setting saved
Can be aborted
MAX timeout
Not required
No
No
-
ATI Execution command ATI Display product identification information Response TA issues product information text Example: Telit NE310H2-W1
OK
Page 40
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 40 of 228 2020-08-18
ATQ Set result code presentation mode
ITU-T Recommendation V.25 ter
SIM Presence
Setting saved
Can be aborted
MAX timeout
Not required
-
Set command ATQ[<n>] Response This parameter setting determines whether the TA transmits any result code to the TE. Information text
transmitted in response is not affected by this setting. If <n>=0: OK If <n>=1: (none) Parameter <n> 0 TA transmits result code 1 Result codes are suppressed and not transmitted
ATN1 initial setting to handshake at highest speed
Some PC modem driver initial setting to handshake at highest speed larger than S37
Set command ATN1 Response Some standard PC modem drivers will send this AT command to initialize the setting, but it is meaningless in
the 3GPP standard. Return OK and no effect for the setting. OK
Page 41
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 41 of 228 2020-08-18
ATS0 Set number of rings before automatically answering the call
Set command ATS0=<n> Response This parameter setting determines the number of rings before auto-answer. This command has no effect
for the setting. OK Parameter <n> 0 automatic answering is disabled 1-255 enable automatic answering on the ring number specified
Read command ATS0? Response <n> OK
ATS1 Ring Counter
Set command ATS1=<n> Response This command will not alter the RING counter, but simply display. This command has no effect for the
setting. OK Parameter <n> 0-255 The number of “RING” strings sent to the TE as a result of receiving an incoming call.
Page 42
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 42 of 228 2020-08-18
ATS2 Set escape sequence character
ATS2 Set escape sequence character
ITU-T Recommendation V.25 ter
SIM Presence
Setting saved
Can be aborted
MAX timeout
Not required
-
Set command ATS2=[<n>] Response
• This parameter setting determines the character recognized by the TA to indicate the escape sequence.
• OK
Parameter <n> 0-43-255 escape sequence character Note: default 43 = ‘+’
Read command ATS2? Response
• <n> OK
Page 43
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 43 of 228 2020-08-18
ATS3 Set command line termination character
ATS3 Set command line termination character
ITU-T Recommendation V.25 ter
SIM Presence
Setting saved
Can be aborted
MAX timeout
Not required
-
Set command ATS3=[<n>] Response
• This parameter setting determines the character recognized by the TA to terminate an incoming command
line. The TA also returns this character in output.
• OK Parameter
• <n> 0-13-127 command line termination character Note: default 13 = CR
Read command ATS3? Response
• <n> OK
Page 44
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 44 of 228 2020-08-18
ATS4 Set response formatting character
ATS4 Set response formatting character
ITU-T Recommendation V.25 ter
SIM Presence
Setting saved
Can be aborted
MAX timeout
Not required
-
Set command ATS4=[<n>] Response This parameter setting determines the character generated by the TA for result code and information
text. OK Parameter
• <n> 0-10-127 response formatting character Note: default 10 = LF
Read command ATS4? Response
• <n> OK
Page 45
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 45 of 228 2020-08-18
ATS5 Set command line editing character
ATS5 Set command line editing character
ITU-T Recommendation V.25 ter
SIM Presence
Setting saved
Can be aborted
MAX timeout
Not required
-
Set command ATS5=[<n>] Response
• This parameter setting determines the character recognized by TA as a request to delete from the
command line the immediately preceding character.
• OK Parameter
• <n> 0-8-127 command line editing character Note: default 8 = Backspace
Read command ATS5? Response
• <n> OK
ATS7 Set number of seconds to wait for connection completion
Set command ATS7=<n> Response This parameter setting determinesthe amount of time to wait for the connection completion in case of
answering or originating a call. This command has no effect for the setting. OK Parameter <n> 1-255 number of seconds to wait for connection completio.default value is 255.
Page 46
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 46 of 228 2020-08-18
ATS10 Set disconnect delay after indicating the absence of data carrier
ATS10 Set disconnect delay after indicating the absence of data carrier
Set command ATS10=<n> Response This parameter specifies the amount of time, in tenths of a second, that the DCE will remains
connected to the line (off-hook) after the DCE has indicated the absence of received line signal. This command has no effect for the setting.
OK Parameter <n> 1-254 Number of tenths of a second of delay
ATS12 Set Escape Code Guard Time
This command sets the escape code guard time in fiftieths of a second. The escape guard time is used to measure when to detect the +++ escape sequence has been entered by the PC in order to drop out of data mode back to AT command mode.
The guard time determines the time that forms a guard period before and after three escape sequence characters. In order to distinguish an escape sequence from just three escape sequence characters in the data stream there is timing associated to the three escape sequence characters of an escape sequence.
The time between the last byte of the data stream and the first escape sequence character must be at least the guard time and the time between each escape sequence character of the escape sequence must be less than the guard time and no other byte is received after the third escape sequence character for the time of the guard time. If an escape sequence is detected, the OK result code will be sent to the DTE. Otherwise, the DCE will stay in data mode.
ITU-T 3GPP TS 27.007 Note
• Set Escape Code Guard Time command
For example: “<Guard time>+++<Guard time>”
Execution command ATS12=<n> Response
• OK If error is related to wrong AT syntax:
• +CME ERROR: <err> Parameters
• <n> Numeric value of the escape guard time value in 1/50 seconds: o 000-255 Number of 20 ms. Default is 050 (1 sec).
Page 47
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 47 of 228 2020-08-18
Test Command ATS12=? Response
• ERROR
Read command ATS12? Response
• <n>
• OK
• NB: <n> is in 3 decimal digits format (e.g. Default value is given as 050). If error is related to wrong
AT syntax:
• +CME ERROR: <err>
AT+S12=? ERROR
ATS12=100 OK
ATS12? 100 OK
Page 48
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 48 of 228 2020-08-18
ATS25 Set DTR change time
This command sets the S-register 25 Detect DTR change time that contain the threshold for noticing a change in DTR. This time permits to the modem to ignore DTR before taking action specified by &Dn (See AT&D Circuit 108 behavior).
The value unit is in 1/100 seconds. Default value is set to 5 (50ms delay after a DTR drop before the modem acts on it).
ITU-T 3GPP TS 27.007 Note Set DTR change Time command
Execution command ATS25=<n> Response
• OK
• If error is related to wrong AT syntax:
+CME ERROR: <err> Parameters • <n> Numeric value of DTR delay in 10 milliseconds: 000-255 Number of 10 ms. Default is 005.
Test Command ATS25=? Response
• ERROR
Read command ATS25? Response
• <n>
• OK
• <n> is in 3 decimal digits format (e.g. Default value is given as 000)
• If error is related to wrong AT syntax:
+CME ERROR: <err>
Page 49
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 49 of 228 2020-08-18
ATS95 enable extended result codes
ATS95 Some PC modem driver initial setting to enable extended result codes
Execution command ATS95=<n> Response Some standard PC modem drivers will send this AT command to initialize the setting, but it is meaningless in the 3gpp standard. So we just return OK and no effect for the setting. <CR><LF>OK<CR><LF>­Parameters
• <n> 0-255 meaningless for the GSM, and GPRS/Packet Domain setting.
Read command ATS95? Response <CR><LF>OK<CR><LF>
ATX Set CONNECT result code format and call monitoring
Set command ATX[<value>] Response This parameter setting determines whether or not the TA detected the presence of dial tone and busy signal and whether or not TA transmits particular result codes <CR><LF>OK <CR><LF> Parameter <value> 0 CONNECT result code only returned, dial tone and busy detection are both disabled 1 CONNECT<text> result code only returned, dial tone and busy detection are both disabled 2 CONNECT<text> result code returned, dial tone detection is enabled, busy detection is disabled 3 CONNECT<text> result code returned, dial tone detection is disabled, busy detection is enabled 4 CONNECT<text> result code returned, dial tone and busy detection are both enabled
Page 50
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 50 of 228 2020-08-18
AT+FCLASS Set fax class
Set command AT+FCLASS=<n> Response This command has no effect for the setting, and is supported for compatibility reasons. <CR><LF>OK <CR><LF> Parameter <n> 0 data 1 fax class 1
AT+FCLASS=? Response +FLASS: list of supported <n>s OK
AT+FCLASS=? Response +FLASS: <n> OK
AT+GCAP Request complete TA capabilities list
Set command AT+GCAP
Response TA reports a list of additional capabilites. +GCAP: <name>s OK
Parameter <name> example, +CGSM
Page 51
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 51 of 228 2020-08-18
AT&F Set all current parameters to manufacturer defaults
ITU-T Recommendation V.25 ter
Set command AT&F[value] Response TA sets all current parameters to the manufacturer defined profile. <CR><LF>OK<CR><LF> Parameter <value> 0 set all TA parameters to manufacturer defaults
AT&K Flow control setting
ITU-T Recommendation V.25 ter Note: This command does not store anything in the profile data because it sets the AT+IFC settings when used: AT&K0 is equivalent of entering AT+IFC=0,0 AT&K3 is equivalent of entering AT+IFC=2,2 AT&K4 is equivalent of entering AT+IFC=1,1
Set command AT&K[<value>] Response <CR><LF>OK <CR><LF> Parameter <value> 0 No flow control 3 RTS /CTS flow control (hardware) 4 XON/XOFF flow control (software) Scope For S/W flow control, this sets on a per channel basis when using the 27.010 MUX. I.e. flow control characters are sent/received within the 27.010 MUX frame as part of the data. For hardware flow control the setting will apply to all channels routed through one connection level (e.g. USB, UART).
Page 52
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 52 of 228 2020-08-18
AT&V Display current configuration
Set command AT&V[<n>] Response TA returns the current parameter setting. <CR><LF><current configurations text><CR><LF> <CR><LF>OK<CR><LF> Parameter <n> 0 profile number
AT&W Store current parameter to user defined profile
Set command AT&W[<n>] Response TA stores the current parameter setting in the user-defined profile. Note: The user-defined profile is stored in non-volatile memory. <CR><LF>OK<CR><LF> Parameter <n> 0 profile number to store to Scope Channel Specific Only one user profile is stored in NVRAM. This command will store the current Generic parameters values and the Channel Specific values for the channel on which the command is received
AT&C Set circuit Data Carrier Detect (DCD) function mode
Set command AT&C[<value>] Response
This parameter determines how the state of circuit 109(DCD) relates to the detection of received line signal from the distant end. This command has no effect for the setting. <CR><LF>OK<CR><LF> Parameter <value> 0 DCD line is always ON 1 DCD line is ON only in the presence of data carrier Scope Channel Specific
Page 53
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 53 of 228 2020-08-18
AT&D Set circuit Data Terminal Ready (DTR) function mode
Set command AT&D[<value>] Response This parameter determines how the TA responds when circuit 108/2(DTR) is changed from the ON to the OFF condition during data mode. This command has no effect for the setting. <CR><LF>OK<CR><LF> Parameter <value> 0 TA ignores status on DTR 1 ON->OFF on DTR: Change to command mode with call remaining connected 2 ON->OFF on DTR: Disconnect call, change to command mode. During state DTR = OFF is auto-answer off. Scope Channel Specific
Page 54
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 54 of 228 2020-08-18
5. SERIAL INTERFACE CONTROL COMMANDS
AT+IPR Set the Baud rate of UART
This command is used to Set the Baud rate of UART. This command will take effect after restart the module and it will be saved after restart.
AT+IPR=<rate>
Response <CR><LF>OK<CR><LF>
Parameter <rate>Baud rate, default value is 0, that is enable baud rate auto detectable.
NOTE:
1. supportedauto detectable <rate>s are:4800,9600,19200,38400,57600,115200, supported fixed­only<rate>s are: 0,4800,9600,19200,38400,57600,115200,230400,460800,921600.
2. If set the fixed rate, the baud rate auto detection is invalid. If you need baud rate auto detection, you need to restart the module.
3. If <rate>=0, that is enable baud rate auto detect, and the default baud rate is 115200.
AT+IPR=?
Response <CR><LF>+IPR:(list of supported autodetectable rate values)[,(list of fixed-only rate values)]<CR><LF>
<CR><LF>OK<CR><LF>
AT+IPR?
Response <CR><LF>+IPR: <rate><CR><LF>
<CR><LF>OK<CR><LF>
AT+IPR? +IPR: 115200
OK at+ipr=? +IPR: (110,300,1200,2400,4800,9600,19200,38400,57600,115200),(0,9600,19200,38400,57600,115200,230400,460800,921600)
OK
Page 55
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 55 of 228 2020-08-18
AT+IFC Local data flow control
This set command is used to control the operation of local flow control between the DTE and DCE during the data state. It accepts two numeric sub-parameters: <DCE_by_DTE>, which specifies the method to be used by the DTE to control the flow of received data from the DCE; <DTE_by_DCE>, which specifies the method to be used by the DCE to control the flow of transmitted data from the DTE.
AT+IFC=[<DCE_by_DTE> [,<DTE_by_DCE>]]
Response <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter <DCE_by_DTE> specifies the method will be used by TE at receive of data from TA
0 No data flow control 1 XON/XOFF, don’t pass characters on to data stack 2 Line 133: Ready for Receiving
<DTE_by_DCE> specifies the method will be used by TA at receive of data from TE
0 No data flow control 1 XON/XOFF 2 line 106: Clear to send(CTS) NOTE: DC1 is IA5 1/1; DC3 is IA5 1/3.
AT+IFC=?
Response <CR><LF>+IFC:(list of supported <DCE_by_DTE> values),(list of supported <DTE_by_DCE>
values)<CR><LF> <CR><LF>OK<CR><LF>
AT+IFC?
Response <CR><LF>+IFC: <DCE_by_DTE>,<DTE_by_DCE><CR><LF>
<CR><LF>OK<CR><LF>
AT+IFC=? +IFC: (0-2),(0-2)
OK AT+IFC? +IFC: 0,0
OK
Page 56
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 56 of 228 2020-08-18
AT#TCOMWRT Firmware Upgrade through UART
This command permits to run a Firmware upgrade UART using a Delta binary file. It is usable on MAIN UART port and consists in two phases: File transfer to memory and then upgrade The command requires the file length as parameter. When run it will present a prompt “>“ and a “CONNECT” message. After the CONNECT message it is possible to transfer the binary file. If the file length equal the <file_length>, the module will return OK after the transfer. Ensure to use a correct delta file from the version the module is using tot he new release (Contact Telit Technical support for details)
AT#TCOMWRT=<file_len><CR> ><file_data>
Response
<CR><LF>CONNECT<CR><LF> If update success, it will report: <CR><LF>FOTA SUCCESS<CR><LF> If update failed, it will report: <CR><LF>FOTA FAILED<CR><LF>
Parameter
<file_len>integer type, the file data length in byte. <file_data> The update file /data FW upgrade after system reset.
Note: 1. The returned “>“ and “CONNECT”from module stands for module is ready to receive file, if you send file before “CONNECT”, the data will lost and it will cause update failure.
AT#TCOMWRT=?
Response
<CR><LF>OK<CR><LF>
AT#TCOMWRT=34728 > CONNECT OK
AT+TRST OK +CPIN: NOT READY
F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000
Page 57
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 57 of 228 2020-08-18
U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM
*MATREADY: 1 +CFUN: 1
FOTA SUCCESS +CPIN: READY
Page 58
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 58 of 228 2020-08-18
AT+CMUX Serial Multiplexer control
This command is used to enable CMUX function; there is no need to disable CMUX. When you close CMUX in MCU, the module will exit CMUX automatically. Note: You need to send at+eurcconf=1 after you enable CMUX, and you need to send at+eurcconf=0 before you disable CMUX function.
AT+CMUX=<mode>[,<subset>[,<port_speed>[,<N1>[,<T1>[,<N2>[,<T2>[,<T3>[,<k>]]]]]]]] Response
<CR><LF>OK<CR><LF> or <CR><LF> ERROR<CR><LF>
Parameter <mode> (multiplexer Transparency Mechanism)
-1 Multiplexer not active 0 Multiplexer enable 1 enhance mode(not support yet)
<subset>Initial control channel setup, not support yet
0 UIH frames used only (default value) 1 UI frames used only
<port_speed> Transmission rate (not relevant for USB interface,not support yet)
0 Auto-baud 1 9600 bps 2 19200 bps 3 38400 bps 4 57600 bps 5 115200 bps (Default value) 6 230400 bps
7 460800 bps <N1>: Maximum frame size: 1-4096 (default value 31 for basic option), not yet supported <T1>: Acknowledgement time in units of 10ms:1-255 (default value 10 (100ms), not yet supported <N2>: Maximum number of re-transmissions: 0-100 (default value is 3), not yet supported <T2>: Response timer for the MUX channel in units of 10ms: 2-255 (default value is 30 (300ms)), not yet supported <T3> : Wake up response timer in seconds: 1-255 (default value is 10), not yet supported <k> : Window size for Advanced operation with Error Recovery options: 1-7 (default value is 2), not yet supported
AT+CMUX=? Response <CR><LF>+CMUX: (list of supported <mode>s), (list of supported <subset>s), (list of supported<port_speed>s), (list of supported<N1>s), (list of supported<T1>s), (list of supported<N2>s), (list if supported<T2>s), (list of supported <T3>s), <list of supported <k>s)<CR><LF> <CR><LF>OK<CR><LF>
AT+CMUX? Response If <mode> = 0, return: <CR><LF> +CMUX:<mode>, [<subset>], <port_speed>, <N1>,<T>,<N2>,<T2>,<T3>[,<k>]<CR><LF> <CR><LF>OK<CR><LF> Otherwise , return: <CR><LF>+CMUX:<mode><CR><LF> <CR><LF>OK<CR><LF> +CME ERROR: <err>
Page 59
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 59 of 228 2020-08-18
AT+CMUX=0 OK
AT#TCLRBDRT Clear historical baud rate
This command is used to Clear historical baud rate.
Set command AT#TCLRBDRT
Response <CR><LF>OK<CR><LF>
AT+IPR=9600 OK
AT+IPR? +IPR: 9600 OK
AT#TCLRBDRT OK
AT+IPR? +IPR: 0
OK
Page 60
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 60 of 228 2020-08-18
6. SIM COMMANDS
AT+CPIN Enter PIN
Set command sends to the MT a password which is necessary before it can be operated (SIM PIN, SIM PUK, PH-SIM PIN, etc.). If the PIN is to be entered twice, the TA shall automatically repeat the PIN. If no PIN request is pending, no action is taken towards MT and an error message, +CME ERROR, is returned to TE. If the PIN required is SIM PUK or SIM PUK2, the second pin is required. This second pin, <newpin>, is used to replace the old pin in the active application in the UICC (GSM or USIM) or SIM card. Read command returns an alphanumeric string indicating whether some password is required or not.
AT+CPIN=<pin>[,<newpin>]
Response <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<pin>,<newpin>: string type values <code> values reserved by the present document:
READY MT is not pending for any password SIM PIN MT is waiting UICC/SIM PIN to be given SIM PUK MT is waiting UICC/SIM PUK to be given PH-SIM PIN MT is waiting phone-to-SIM/UICC card password to be given SIM PIN2 MT is waiting active application in the UICC (GSM or USIM) or SIM card PIN2 to be given (this <code> is recommended to be returned only when the last executed command resulted in PIN2 authentication failure (i.e. +CME ERROR: 17); if PIN2 is not entered right after the failure, it is recommended that MT does not block its operation) SIM PUK2 MT is waiting active application in the UICC (GSM or USIM) or SIM card PUK2 to be given (this <code> is recommended to be returned only when the last executed command resulted in PUK2 authentication failure (i.e. +CME ERROR: 18); if PUK2 and new PIN2 are not entered right after the failure, it is recommended that MT does not block its operation) PH-NET PIN MT is waiting network personalization password to be given
Note: If the status of <code> is left below you need input commands
SIM PIN AT+CPIN=<pin> SIM PUK AT+CPIN=<puk>,<newpin> SIM PUK2 AT+CPIN=<puk2>,<newpin2> SIM PIN 2 AT+CPIN=<pin2>
AT+CPIN=?
Response <CR><LF>OK<CR><LF>
AT+CPIN?
Response <CR><LF>+CPIN: <code><CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Page 61
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 61 of 228 2020-08-18
AT+CMEE=2 OK AT+CPIN? +CPIN: READY
OK
AT*MICCID Read USIM ICCID file
Read USIM ICCID file
AT*MICCID
Response <CR><LF>*MICCID: <iccid><CR><LF>
<CR><LF>OK<CR><LF>
Parameter <iccid>:SIM/USIM ICCID
AT*MICCID
*MICCID: 86860460020123456381
OK
Page 62
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 62 of 228 2020-08-18
7. NETWORK SERVICE COMMANDS
AT+CEREG EPS Network registration
Set command controls the presentation of an unsolicited result code +CEREG: <stat> when <n>=1 and there is a change in the MT network registration status, or code +CEREG: <stat>[,[<lac>],[<ci>],[<AcT>]] when<n>=2 and there is a change of the network cell. Read command returns the status of result code presentation and an integer <stat> which shows whether the network has currently indicated the registration of the MT. Location information elements <lac> and <ci> are returned only when <n>=2 and MT is registered in the network. Test command returns the range of supported <n>.
AT+CEREG=[<n>]
Response <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<n>:
0 disable network registration unsolicited result code 1 enable network registration unsolicited result code: +CEREG: <stat> 2 enable network registration unsolicited result code: +CEREG: <stat>[,[<tac>],[<ci>],[<AcT>,[rac]] 3 enable network registration unsolicited result code: +CEREG: <stat>[,[<tac>],[<ci>],[<AcT>,[rac],[<cause_type>,<reject_cause>]] 4 enable network registration unsolicited result code: +CEREG: <stat>[,[<lac>],[<ci>],[<AcT>],[<rac>][,,[,[<Active-Time>],[<Periodic­RAU>],[<GPRS-READY-timer>]]]] 5 enable network registration unsolicited result code: +CEREG:<stat>[,[<tac>],[<ci>],[<AcT>],[<rac>][,[<cause_type>],[<reject_cause>][,[<Active­Time>],[<Periodic-RAU>,[<GPRS-READY-time>]]]]]
<stat>:
0 not registered, MT is not currently searching a new operator to register to 1 registered, home network 2 not registered, but MT is currently searching a new operator to register to 3 registration denied 4 unknown
5 registered, roaming <tac>: string type; two bytes tracking area code in hexadecimal format <ci>: string type; four byte cell ID in hexadecimal format <AcT>: integer type; access technology of the serving cell
9 NB-IOT
<rac>: NB-IOT, “00”
<cause_type>: integer type; indicates the type of <reject_cause>
0 Indicates that <reject_cause> contains an EMM cause value, see 3GPP TS 24.301 Annex
A.
1 Indicates that <reject_cause> contains a manufacturer-specific cause. <reject_cause>: integer type; contains the cause of the failed registration. The value is of type as defined by <cause_type>. <Active-Time>: string type; one byte in an 8-bit format. Indicates the Active Time value (T3324) allocated to the UE in E-UTRAN. The Active Time value is coded as one byte (octet 3) of the GPRS Timer 2 information element coded as bit format (e.g. "00100100" equals 4 minutes). For the coding and the value range, see the GPRS Timer 2 IE in 3GPP TS 24.008 Table
10.5.163/3GPP TS 24.008. See also 3GPP TS 23.682 and 3GPP TS 23.401. <Periodic-TAU>: string type; one byte in an 8-bit format. Indicates the extended periodic TAU value (T3412) allocated to the UE in E-UTRAN. The extended periodic TAU value is coded as one byte (octet 3) of the GPRS Timer 3 information element coded as bit format (e.g. "01000111" equals 70 hours). For the coding and the value range, see the GPRS Timer 3 IE in 3GPP TS
24.008, Table 10.5.163a/3GPP TS 24.008. See also 3GPP TS 23.682 and 3GPP TS 23.401.
Page 63
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 63 of 228 2020-08-18
AT+CEREG?
Response when <n>=0, 1, 2 or 3 and command successful: +CEREG: <n>,<stat>[,[<tac>],[<ci>],[<AcT>,<rac>[,<cause_type>,<reject_cause>]]]
• when <n>=4 or 5 and command successful:
+CEREG:<n>,<stat>[,[<tac>],[<ci>],[<AcT>],[<rac>][,[<cause_type>],[<reject_cause>][,[<Active­Time>],[<Periodic-TAU>]]]]
If error is related to wrong AT syntax or operation not allowed: +CME ERROR: <err>
AT+CEREG=?
Response <CR><LF>+CEREG: (list of supported <n>s)<CR><LF>
<CR><LF>OK<CR><LF>
AT+CEREG? +CEREG: 0,1
OK AT+CEREG=? +CEREG: (0-5)
OK
Page 64
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 64 of 228 2020-08-18
AT+COPS PLMN Reselection
Set command forces an attempt to select and register the LTE network operator. <mode> is used to select whether the selection is done automatically by the MT or is forced by this command to operator <oper>. Read command returns the current mode and the currently selected operator. If no operator is selected, <format> and<oper> are omitted. Test command returns a list of quadruplets, each representing an operator present in the network.
AT+COPS=[<mode>[,<format>[,<oper>[,<AcT>]]]] Response
<CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<stat>:
0 unknown
1 available
2 current
3 forbidden <oper> operator in format as per <mode> <mode> 0 automatic mode; <oper> field is ignored
1 manual operator selection; <oper> field shall be present
2 manual deregister from network
3 set only <format> (for read command +COPS?) – not shown in Read command response
4 manual/automatic selected; if manual selection fails, automatic mode (<mode>=0) is
entered <format> 0: long format alphanumeric <oper>;can be up to 16 characters long
1: short format alphanumeric <oper>
2: numeric <oper>; GSM Location Area Identification number
AT+COPS?
Response <CR><LF>+COPS: <mode>[,<format>,<oper>[,<AcT>]]<CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
AT+COPS=?
Response <CR><LF>+COPS: [list of supported (<stat>,long alphanumeric <oper>,short alphanumeric <oper>,numeric
<oper>[,<AcT>])s][,,(list of supported <mode>s),(list of supported <format>s)]<CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
AT+COPS? +COPS: 0,0,"46011",9
OK
Page 65
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 65 of 228 2020-08-18
AT+CESQ Get signal quality
Execution command returns received signal quality parameters. If the current serving cell is not an E-UTRA cell, <rsrq> and <rsrp> are set to 255. Test command returns values supported as compound values.
AT+CESQ
Response <CR><LF>+CESQ:<rxlev>,<ber>,<rscp>,<ecno>,<rsrq>,<rsrp><CR><LF>
<CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<rxlev>:
0: -110 dBm or less 1: -110 dBm <= rssi < -109 dBm 2: -109 dBm <= rssi < -108 dBm ….: …. 61: -50dBm <= rssi < -49 dBm 62: -49dBm <= rssi < -48 dBm 63: -48dBm <= rssi 99: not known or not detectable
<ber>
0…7: as RXQUAL values RXQUAL_0…RXQUAL_7 asdefined in 45.008. 99: not known or not detectable
<rscp>
0: -120 dBm or less 1: -120 dBm <= rscp < -119 dBm 2: -119 dBm <= rscp < -118 dBm …: … 94: -27 dBm <= rscp < -26 dBm 95: -26 dBm <= rscp < -25 dBm 96: -25 dBm <= rscp 255: not known or not detectable
<ecno>
0: -24 dBm or less 1: --24dBm <= Ec/Io < -23.5 dBm 2: --23.5dBm <= Ec/Io < -23 dBm …: … 47: --1dBm <= Ec/Io < -0.5 dBm 48: --0.5dBm <= Ec/Io < 0 dBm 49: 0 dBm <= Ec/Io 255: not known or not detectable
<rsrq>:
0: -19.5 dB or less 1: -19.5dB <= rsrq < -19 dB 2: -19dB <= rsrq < -18.5 dB …: … 32: -4 dB <= rsrq < -3.5 dB 33: -3.5 dB <= rsrq < -3 dB 34: -3 dB <= rsrq 255: not known or not detectable
<rsrp>
0: -140 dBm or less 1: -140dBm <= rsrp < -139 dBm 2: -139dBm <= rsrp < -138 dBm …: … 95: -46dBm <= rsrp < -45 dBm 96: -45dBm <= rsrp < -44 dBm 97: -44dBm <= rsrp 255: not known or not detectable
Page 66
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 66 of 228 2020-08-18
AT+CESQ=?
Response <CR><LF>+CESQ: (list of supports <rxlev>s), (list of supported <ber>s), (list of supported <rscp>s>), (list of supported <ecno>s), (list of supported <rsrq>s), (list of supported <rsrp>s)<CR><LF>
<CR><LF>OK<CR><LF>
AT+CESQ=? +CESQ: (0-63,99),(99),(255),(255),(0-34,255),(0-97,255)
OK
AT+CSQ Get signal quality
Execution command returns received signal quality parameters and ber.
AT+CSQ
Response <CR><LF>+CSQ: <rssi>,<ber><CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<rssi>:
0 -113dBm or less 1 -111dBm
2...30 -109... -53dBm 31 -51 dBm or greater 99 not known or not detectable
<ber> (in percent):
0...7 This parameter is only valid for GSM. 0 – <0.01% 1 – 0.01% --- 0.1% 2 – 0.1% --- 0.5% 3 – 0.5% --- 1.0% 4 – 1.0% --- 2.0% 5 – 2.0% --- 4.0% 6 – 4.0% --- 8.0% 7 – more than 8.0% 99 -- not known or not detectable
AT+CSQ=?
Response <CR><LF>+CSQ: (list of supported <rssi>s),(list of supported <ber>s)<CR><LF>
<CR><LF>OK<CR><LF>
AT+CSQ +CSQ: 17,99
OK
Page 67
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 67 of 228 2020-08-18
AT+CTZU Automatic Time Zone Update
Set command enables and disables automatic time zone update via NITZ. If setting fails in an MT error, +CME ERROR: <err> is returned. It will take effect once setting, and will invalid after restart the module. Read command returns the current settings in the MT.
AT+CTZU=<on\off>
Response <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter <onoff>: 0 – Disable automatic time zone update via NITZ (default) 1 – Enable automatic time zone update via NITZ..
AT+CTZU=?
Response <CR><LF>+CTZU: (list of supported <onoff>s)<CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
AT+CTZU?
Response <CR><LF>+CTZU: <onoff><CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
AT+CTZU=? +CTZU: (0-1)
OK AT+CTZU?
+CTZU: 0
OK
Page 68
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 68 of 228 2020-08-18
AT+CCLK Clock Management
Clock Management
AT+CCLK=<time>
Response <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
<time>: string type value; format is "yy/MM/dd,hh:mm:sszz", where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range -47...+48). E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals to "94/05/06,22:10:00+08"
AT+CCLK?
Response <CR><LF>+CCLK: <time><CR><LF> <CR><LF>OK<CR><LF> or
<CR><LF>+CME ERROR: <err><CR><LF>
AT+CCLK=?
Response <CR><LF>OK<CR><LF>
AT+CCLK="14/09/11,16:54:00+08" OK AT+CCLK? +CCLK: "14/09/11,16:54:15+08"
OK
Page 69
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 69 of 228 2020-08-18
AT*MFRCLLCK Lock UE to specific frequency and optionally Cell ID
This command is used to lock UE to specific frequency and optionally Cell ID.It will take effect once setting, and will be invalid after restart the module.
AT*MFRCLLCK=<lock>,<earfcn>[,<earfcn_offset>[,<pci>]] Response
<CR><LF>OK<CR><LF> Parameter <lock>: Integer value indicating whether to activate lock, or remove lock:
0: Remove lock
1: Activate lock <earfcn>: Integer value indicating requested EARFCN on which to lock. Range 0- 262143. Value of 0 indicates to remove any lock for EARFCN and Cell <earfcn_offset> Integer value indicating requested EARFCN offset:
0: Offset of -2
1: Offset of -1
2: Offset of -0.5
3: Offset of 0
4: Offset of 1 <pci>: Integer value: Physical cell ID. Range: 0-503
AT*MFRCLLCK=? Response
<CR><LF>*MFRCLLCK: (0,1)[,(0-262143),(0-4)[,(0-503)]]<CR><LF> <CR><LF>OK<CR><LF>
AT*MFRCLLCK? Response
When not setting earfcn/cellid: <CR><LF>*MFRCLLCK: 0<CR><LF> <CR><LF>OK<CR><LF>
When setting earfcn/cellid <CR><LF>*MFRCLLCK:<lock>[,<earfcn>,<earfcn_offset>[,<pci>]]<CR><LF> <CR><LF>OK<CR><LF>
AT*MFRCLLCK=1,10,3,301 // Lock to EARFCN 10, offset 0, PCI 301 OK AT*MFRCLLCK=0 //Remove lock OK
Page 70
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 70 of 228 2020-08-18
AT*MBAND Query Current Modem NB-IOT Operating Band
Query Current Modem NB-IOT Operating Band
AT*MBAND=?
Response <CR><LF>*MBAND: (list of valid <Current Band>s)<CR><LF>
<CR><LF>OK<CR><LF>
Parameter
<Current Band> Integer value indicating current selected NB-IOT band Valid values: 1,2,3,5,8,12,13,17,18,19,20,26,28,66
AT*MBAND?
Response <CR><LF>*MBAND:<Current Band><CR><LF> <CR><LF>OK<CR><LF> Or
<CR><LF>+CME ERROR: <err><CR><LF>
AT*MBAND=? *MBAND: (1,2,3,5,8,12,13,17,18,19,20,26,28,66)
OK AT*MBAND? *MBAND: 5
OK
Page 71
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 71 of 228 2020-08-18
AT*MBSC Lock BAND
This command is used to lock band, and it will take effect after restart the module, the setting parameters will be saved even when power-off.
AT*MBSC=<number>,<support_bands_list>
Response <CR><LF>*MBSC: 0<CR><LF> <CR><LF>OK<CR><LF> Or
<CR><LF>+CME ERROR: <err><CR><LF>
Parameter
< number>: integer type, the band number need to lock. <support_band_lists>: integer type, the bands list need to lock, and is devided by “,”
AT*MBSC?
Response <CR><LF>[*MBSC:<Support Band>]<CR><LF> <CR><LF>OK<CR><LF> Or
<CR><LF>+CME ERROR: <err><CR><LF>
AT*MBSC=3,3,5,8 //lock three bands, that is band3,5,8 *MBSC: 0
OK
Page 72
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 72 of 228 2020-08-18
AT*MENGINFO Query current network status and cell information
This command is used to query current network status, and modem status information for serving cell.
AT*MENGINFO=<mode>
Response If <mode> = 0 display serving cell and up to 4 neighbor cell information: <CR><LF>*MENGINFOSC:
<sc_earfcn>,<sc_earfcn_offset>,<sc_pci>,<sc_cellid>,[<sc_rsrp>],[<sc_rsrq>],[<sc_rssi>],[<sc_snr>],<sc_band>,<sc_t ac>,[<sc_ecl>],[<sc_tx_pwr>]
[<CR><LF>*MENGINFONC: <nc_earfcn>,<nc_earfcn_offset>,<nc_pci>,<nc_rsrp> [...]] <CR><LF>OK<CR><LF> If <mode> = 1 display data transfer information only if modem in RRC-CONNECTED state: *MENGINFODT:
<RLC_UL_BLER>,<RLC_DL_BLER>,<MAC_UL_BLER>,<MAC_DL_BLER>,<MAC_UL_total_bytes>,<MAC_DL_total _bytes>,<MAC_UL_total_HARQ_TX>,<MAC_DL_total_HARQ_TX>,<MAC_UL_HARQ_re_TX>,<MAC_DL_HARQ_re _TX>,<RLC_UL_tput>,<RLC_DL_tput>,<MAC_UL_tput>,<MAC_DL_tput>
<CR><LF>OK<CR><LF> If error is related to wrong AT syntax or incorrect <mode> or UE in incorrect state +CME ERROR: <err>
Parameter
<mode>Integer value indicating requested engineering information.
0: Radio information for serving and neighbor cells
1: display data transfer information only if modem in RRC-CONNECTED state
Serving Cell/Neighbor Cell information:
<sc_earfcn> Integer value indicating the EARFCN for serving cell. Range 0- 262143
<sc_earfcn_offset> Integer value indicating the EARFCN offset for serving cell:
0: Offset of -2
1: Offset of -1
2: Offset of -0.5
3: Offset of 0
4: Offset of 1
<sc_pci> Integer value indicating the serving cell physical cell ID. Range 0 – 503.
<sc_cellid> String type; four byte (28 bit) cell ID in hexadecimal format for serving cell.
<sc_rsrp> Signed integer indicating serving cell RSRP value in units of dBm (can be negative value).
Available only in RRC-IDLE state.
<sc_rsrq> Signed integer indicating serving cell RSRQ value in units of dB (can benegative value).
Available only in RRC-IDLE state.
<sc_rssi> Signed integer indicating serving cell RSSI value in units of dBm (can be negative value).
Available only in RRC-IDLE state.
<sc_snr> Signed integer value. Last SNR value for serving cell in units of dB.Available only in RRC-
IDLE state.
<sc_band> Integer value; current serving cell band
<sc_tac> String type; two byte tracking area code (TAC) in hexadecimal format (e.g. "00C3" equals
195 in decimal).
<sc_ecl> Integer value. Last Enhanced Coverage Level (ECL) value for serving cell. Range 0-2.
<sc_tx_pwr> Signed integer value indicating current UE transmit power. Units of cBm Centibels
relative to one milliwatt (can be negative value).
<nc_earfcn> Integer value indicating the EARFCN for neighbor cell. Range 0-262143
<nc_earfcn_offset> Integer value indicating the EARFCN offset for neighbor cell:
0: Offset of -2
1: Offset of -1
2: Offset of -0.5
3: Offset of 0
4: Offset of 1
<nc_pci> Integer value indicating the neighbor cell physical cell ID. Range 0-503.
Page 73
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 73 of 228 2020-08-18
<nc_rsrp> Signed integer indicating neighbor cell RSRP value in units of dBm (can be negative
value).
Data Transfer Information:
<RLC_UL_BLER> Integer value. Represented in % value (range 0 to 100). UL block error rate (as
per IRQ) in RLC. Calculated over all established RLC AM radio bearers. Calculated from the
beginning of successfully established/resumed RRC connection or since previous
AT*MENGINFO query with <mode>=1, whichever is later. Only valid in RRC-CONNECTED state.
<RLC_DL_BLER> Integer value Represented in % value (range 0 to 100). DL block error rate (as
per ARQ) in RLC. Calculated over all established RLC AM radio bearers. Calculated from the
beginning of successfully established / resumed RRC connection, or since previous
AT*MENGINFO query with <mode>=1, whichever is later. Available only in RRC-CONNECTED state.
<MAC_UL_BLER> Integer value. Represented in % value (range 0 to 100). UL block error rate (as
per HARQ) in MAC for UL-SCH. Calculated from the beginning of successfully established / resumed
/ re-established RRC connection, or since previous AT*MENGINFO query with<mode>=1, whichever
is later. Available only in RRC-CONNECTED state.
<MAC_DL_BLER> Integer value. Represented in % value (range 0 to 100). DL block error rate (as
per HARQ) in MAC for DL-SCH, excluding BCCH. Calculated from the beginning of successfully
established / resumed / re-established RRC connection, or since previous
AT*MENGINFO query with <mode>=1, whichever is later. Available only in RRC-CONNECTED
state.
< MAC_UL_total_bytes> Integer value. Total number of transport block bytes (re)transmitted on UL-
SCH. Calculated for UL-SCH over all HARQ transmissions and retransmissions. Calculated from the
beginning of successfully established / resumed / re-established RRC connection, or since previous
AT*MENGINFO query with <mode>=1, whichever is later.
Available only in RRC-CONNECTED state. Unit: bytes
<MAC_DL_total_bytes> Integer value. Total number of transport block bytes (re)transmitted on DL-
SCH, excluding BCCH. Calculated from the beginning of successfully established / resumed / re-
established RRC connection, or since previous AT*MENGINFO query with <mode>=1, whichever is
later. Available only in RRC-CONNECTED state. Unit: bytes
<MAC_UL_total_HARQ_TX> Integer value. Total number of HARQ (re)transmissions for transport
blocks on UL-SCH. Calculated from the beginning of successfully established / resumed / re-
established RRC connection, or since previous AT*MENGINFO query with <mode>=1, whichever is
later. Available only in RRC-CONNECTED state. Unit: (re)transmissions
< MAC_DL_total_HARQ_TX> Integer value. Total number of HARQ (re)transmissions for transport
blocks on DL-SCH, excluding BCCH. Calculated from the beginning of successfully established /
resumed / re-established RRC connection, or since previous AT*MENGINFO query with <mode>=1,
whichever is later. Available only in RRC-CONNECTED state. Unit: (re)transmissions
< MAC_UL_HARQ_re_TX> Integer value. Number of HARQ retransmissions for transport blocks
on UL-SCH. Calculated from the beginning of successfully established / resumed / re-established
RRC connection, or since previous AT*MENGINFO query with <mode>=1, whichever is later.
Available only in RRC-CONNECTED state. Unit: retransmissions
<MAC_DL_HARQ_re_TX> Integer value. Number of HARQ retransmissions for transport blocks on
DL-SCH, excluding BCCH. Calculated from the beginning of successfully established / resumed / re-
established RRC connection, or since previous AT*MENGINFO query with <mode>=1, whichever is
later. Available only in RRC-CONNECTED state. Unit: retransmissions.
<RLC_UL_tput> Integer value. RLC uplink throughput. Calculated over all established RLC AM
radio bearers. Calculated from the beginning of successfully established /resumed RRC connection,
or since previous AT*MENGINFO query with <mode>=1, whichever is later. Available only in RRC-
CONNECTED state. Unit: kbits / s
<RLC_DL_tput> Integer value. RLC downlink throughput. Calculated over all established RLC AM
radio bearers Calculated from the beginning of successfully established / resumed RRC connection,
or since previous AT*MENGINFO query with <mode>=1, whichever is later. Available only in RRC-
CONNECTED state. Unit: kbits / s
Page 74
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 74 of 228 2020-08-18
<MAC_UL_tput> Integer value. UL throughput in MAC for UL-SCH. Calculated from the beginning
of successfully established / resumed / re-established RRC connection, or since previous
AT*MENGINFO query with <mode>=1, whichever is later. Available only in RRC-CONNECTED
state. Unit: kbits / s
<MAC_DL_tput> Integer value. DL throughput in MAC for DL-SCH, excluding BCCH. Calculated
from the beginning of successfully established / resumed / re-established RRC connection, or since
previous AT*MENGINFO query with <mode>=1, whichever is later. Available only in RRC-
CONNECTED state. Unit: kbits / s
Note: when the module return +CME ERROR, the error code are shown as bellows: 1: No Service state 2:In cell search state 3:ERRC is deactivated 4:In cell re-selection state 5:In reestablishment state 6:In PSM state 7:No data transfer in idle state
AT*MENGINFO=?
Response <CR><LF>*MENGINFO: (list of supported <mode>)
<CR><LF>OK<CR><LF>
AT*MENGINFO?
Response <CR><LF>OK<CR><LF>
(power up in in CFUN=0 mode)
AT*MENGINFO=0
ERROR //Cannot display information in CFUN=0 mode
AT+CFUN=1
OK
(Not yet registered to network)
AT*MENGINFO=0
OK
(Registered to network)
AT*MENGINFO=0
*MENGINFOSC: 3701,3,69,”27447553”,-1073,-1175,-1145,290,18,11,0,0,-35
*MENGINFONC: 3701,0,60,-1073
*MENGINFONC: 3369,1,37,-1073
*MENGINFONC: 3210,2,23,-1073
*MENGINFONC: 3001,1,15,-1073
OK
Page 75
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 75 of 228 2020-08-18
AT*MNBIOTRAI Actively release RRC connection
This command is used for active RRC_Release in the following scenarios:
1. Need to upload 1 UL packet and no DL packet reply
2. Need to upload 1 UL packet and 1 DL packet reply
AT*MNBIOTRAI=<rai> Response <CR><LF>OK<CR><LF>
Parameter
<rai>:Integer value 0:No valid information (default) 1:upload 1 UL packet and no DL packet reply 2:upload 1 UL packet and 1 DL packet reply
AT*MNBIOTRAI? Response <CR><LF>*MNBIOTRAI:rai<CR><LF>
<CR><LF>OK<CR><LF>
AT*MNBIOTRAI=? Response <CR><LF>*MNBIOTRAI: (0-2)<CR><LF>
<CR><LF>OK<CR><LF>
AT*MNBIOTRAI? *MNBIOTRAI: 0
OK AT*MNBIOTRAI=? *MNBIOTRAI: (0-2)
OK AT*MNBIOTRAI=1
OK
Page 76
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 76 of 228 2020-08-18
AT*RRCRELEASE Actively release RRC connection
This command is used for active RRC_Release without any data bearer, and can directly release the RRC connection.
AT*RRCRELEASE Response <CR><LF>OK<CR><LF>
AT*RRCRELEASE=? Response <CR><LF>OK<CR><LF>
AT*RRCRELEASE? Response <CR><LF>OK<CR><LF>
AT*RRCRELEASE OK
AT*RRCRELEASE=? OK
AT*RRCRELEASE?
OK
Page 77
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 77 of 228 2020-08-18
AT+CCIOTOPT CIoT Optimization Configuration
The set command controls which CIoT EPS optimizations the UE indicates as supported and preferred in the ATTACH REQUEST and TRACKING AREA UPDATE REQUEST messages. The command also allows reporting of the CIoT EPS optimizations that are supported by the network. A UE supporting CIoT functionality may support control plane CIoT EPS optimization or user plane CIoT EPS optimization or both (see 3GPP TS 24.301, sub-clause 9.9.3.34). Based on the application characteristics the UE may prefer to be registered for control plane CIoT EPS optimization or for user plane CIoT EPS optimization (see 3GPP TS 24.301, sub-clause 9.9.3.0B). Further the network may support control plane CIoT EPS optimization or user plane CIoT EPS optimization or both (see 3GPP TS 24.301, sub-clause 9.9.3.12A). The set command is used also to control the unsolicited result code +CCIOTOPTI. An unsolicited result code +CCIOTOPTI: <supported_Network_opt> is used to indicate the supported CIoT EPS optimizations by the network. The read command returns the current settings for supported and preferred CIoT EPS optimizations and the current status of unsolicited result code +CCIOTOPTI.
Execution command
AT+CCIOTOPT=[<n>,[<supported UE_opt>[,<preferred_UE_opt>]]]
Response
• OK
• If error is related to wrong AT syntax:
+CME ERROR: <err>
Unsolicited result code
• +CCIOTOPTI: <supported_Network_opt> is used to indicate the supported CIoT EPS
optimizations by the network. Parameters
• <n>: integer type, enables or disables reporting of unsolicited result code +CCIOTOPTI. 0 Disable reporting. 1 Enable reporting. 3 Disable reporting and reset the parameters for CIoT EPS optimization to the default
values.
• <supported_UE_opt>: integer type; indicates the UE's support for CIoT EPS optimizations. 1 Support for control plane CIoT EPS optimization. 3 Support for both control plane CIoT EPS optimization and user plane CIoT EPS
optimization.
<preferred_UE_opt> integer type; indicates the UE's preference for CIoT EPS optimizations. 0 No preference 1 Preference for control plane CIoT EPS optimization 2 Preference for user plane CIoT EPS optimization
• <supported_Network_opt>: integer type; indicates the Network support for CIoT EPS
optimizations.
0 No support 1 Support for control plane CIoT EPS optimization. 2 Support for user plane CIoT EPS optimization. 3 Support for both control plane CIoT EPS optimization and user plane CIoT EPS
optimization.
Test Command AT+CCIOTOPT=? Response
• +CCIOTOPT: (list of supported <n>s),(list of supported <supported_UE_opt>s),(list of
supported <preferred_UE_opt>s)
• OK
Read command AT+CCIOTOPT? Response
• +CCIOTOPT :<n>,<supported_UE_opt>,<preferred_UE_opt>
Page 78
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 78 of 228 2020-08-18
AT+CCHO Open UICC Logical Channel
Execution of this command causes the MT to return <sessionid> to allow the TE to identify a channel that is being allocated by the currently selected UICC, which is attached to ME. The currently selected UICC will open a new logical channel; select the application identified by the <dfname> received with this command and return a session Id as the response. The ME restricts the communication between the TE and the UICC to this logical channel. This <sessionid> is used when sending commands with Generic UICC Logical Channel access +CGLA commands.
Execution command
AT+CCHO=<dfname>
Response
• <sessionid>
• OK
• If error is related to wrong AT syntax:
+CME ERROR: <err>
Parameters
• <dfname>: String type in hexadecimal character format. All selectable applications in the UICC
are referenced by a DF name coded on 1 to 16 bytes
• <sessionid>: integer type; a session Id to be used to target a specific application on the smart
card (e.g. (U)SIM, WIM, ISIM) using logical channels mechanism
• See 3GPP TS 31.101 for more information about defined values.
AT+CCHC Close UICC Logical Channel
This command asks the ME to close a communication session with the active UICC. The ME closes the previously opened logical channel. The TE will no longer be able to send commands on this logical channel. The UICC will close the logical channel when receiving this command.
Execution command
AT+CCHC=<sessionid>
Response
• CCHC
• OK
• If error is related to wrong AT syntax:
+CME ERROR: <err>
Parameters
• <sessionid>: integer type; the session used to target a specific application on the smart card
(e.g. (U)SIM, WIM, ISIM) using logical channels mechanism
• See 3GPP TS 31.101 for more information about defined values.
Page 79
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 79 of 228 2020-08-18
AT+CGLA Generic UICC Logical Channel Access
Set command transmits to the MT the <command> is sent as is to the selected UICC. The UICC <response> is sent back by the MT to the TA as is. This command allows a direct control of the currently selected UICC by a distant application on the TE. Although +CGLA allows the TE to take control over the UICC-MT interface, there are some functions of the UICC-MT interface that logically do not need to be accessed from outside the TA/MT and, for security reasons the GSM network authentication should not be handled outside the TA/MT. So, a Run GSM Algorithm command or an Authenticate command in GSM context shall not be allowed whether the +CGLA is locked or unlocked. However, the TE may send Authenticate commands in other security contexts (e.g. EAP security context).
Execution command
AT+CGLA=<sessionid>,<length>,<command>
Response
• +CGLA: <length>,<response>
• OK
• If error is related to wrong AT syntax:
+CME ERROR: <err>
Parameters
• <sessionid>: integer type; this is the identifier of the session used to send the APDU commands
to the UICC. It is mandatory to send commands to the UICC when targeting applications on the smart card using a logical channel other than the default channel (channel "0").
• <length> : integer type; length of the characters that are sent to TE in <command> or
<response> (two times the actual length of the command or response)
• <command> : command passed on by the MT to the UICC in the format as described in
3GPP TS 31.101 (hexadecimal character format)
• <response> : response to the command passed on by the UICC to the MT in the format as
described in 3GPP TS 31.101 (hexadecimal character format)
Page 80
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 80 of 228 2020-08-18
AT+CPINR Remaining PIN Retries
Execution command cause the UE to return the number of remaining PIN retries for the UE passwords with intermediate result code +CPINR: <code>,<retries>[,<default_retries>] for standard PINs and +CPINRE: <ext_code>,<retries>[,<default_retries>] for manufacturer specific PINs. One line with one intermediate result code is returned for every <code> or <ext_code> selected by <sel_code>. When execution command is issued without the optional parameter <sel_code>, intermediate result codes are returned for all <code>s and <ext_code>s. In the intermediate result codes, the parameter <default_retries> is an optional (manufacturer specific) parameter, per <code> and <ext_code>. Note that the modem does not support the +CPINRE indication.
Execution Command
AT+CPINR[=<sel_code>]
Response
• [+CPINR: <code>,<retries>,[<default_retries>]
• [<CR>,<LF>:CPINR: <code>,<retries>,[default_retries>
• […]]
• OK
• If error is related to wrong AT syntax:
+CME ERROR: <err>
Parameters
• <sel_code>: String type. Same values as for the <code> parameter. These values are
strings and shall be indicated within double quotes. Wildcard match by ‘*’, meaning match any (sub-
)string, or ‘?’ meaning an character can be used.
• <retries>: Integer type. Number of remaining retries per PIN.
• <default_retries>: Integer type. Number of default/initial retries per PIN.
• <code>: Type of PIN. All values listed under the description of the AT+CPIN Command,
<code> parameter except “READY”.
Test Command AT+CPINR=? Response
• OK
Read Command AT+CPINR? Response
• +CME ERROR: <err>
+CPINR examples AT+CPINR=? Test command OK
AT+CPINR? Read command ERROR
AT+CPINR=”SIM*” Execute command. Read all SIM PIN retries starting
+CPINR: “SIM PIN”,3,3 with the string “SIM”. +CPINR: “SIM PUK”,10.10 +CPINR: “SIM PIN2”,3,3 +CPINR: “SIM PUK2”,10,10 +CPINR: “SIM UPIN”,3,3 +CPINR: “SIM UPUK”,10,10
OK AT+CPINR Execute command. Read all SIM PIN retries.
Page 81
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 81 of 228 2020-08-18
+CPINR: “SIM PIN”,3,3 with the string “SIM”. +CPINR: “SIM PUK”,10.10 +CPINR: “SIM PIN2”,3,3 +CPINR: “SIM PUK2”,10,10 +CPINR: “SIM UPIN”,3,3 +CPINR: “SIM UPUK”,10,10
OK AT+CPINR=”SIM PIN*” Execute command. Read all SIM PIN retries
starting +CPINR: “SIM PIN”,3,3 with the string “SIM PIN”. OK
AT+CGATT GPRS/Packet Domain attach or detach
3GPP TS 27.007
Set command AT+CGATT=[<state>] Response
• OK
• ERROR
Parameter
• <state> indicates the state of GPRS/Packet Domain attachment
0 – detached 1 – attached Other values are reserved and will result in an ERROR response to the execution command.
Test command
AT+CGATT=?
Response
• +CGATT: (list of supported <state>s)
Parameter
• See set command
Read command
AT+CGATT?
Response
• +CGATT: <state>
Parameter
• See set command
Page 82
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 82 of 228 2020-08-18
AT+CGACT PDP context activate or deactivate
The execution command is used to activate or deactivate the specified PDP context (s). After the command has completed, the UE remains in V.250 command state. If any PDP context is already in the requested state, the state for that context remains unchanged. If the UE is not PS attached when the activation form of the command is executed, the UE first performs a PS attach and them attempts to activate the specified contexts. Note that in the 27.007 specification there is the following statement:
• For EPS, if an attempt is made to disconnect the last PDN connection, then the UE responds with ERROR or, if
extended error responses are enabled, a +CME ERROR. This applies when use of CID0 is enabled for the PDN connection activated during attach (AT*MLTEGCF=2). In fact,
entering AT+CGACT=<0 or 1>,0 will generate ERROR response If CID0 mode is not enabled (AT*MLTEGCF=0/1) then it is possible to enter the AT+CGACT command to deactivate the last PDN connection from the point of view of the middleware. When the user uses AT+CGACT to disconnect the last PDN connection the following occurs:
• The PDN connection is preserved in the protocol stack
• The PDN connection is disconnected at the middleware, so the <cid> for the PDN connection is marked as
deactivated
• OK response is returned rather than ERROR
For EPS, the activation request for an EPS bearer resource will be answered by the network by either an EPS dedicated bearer activation or EPS bearer modification request. The request must be accepted by the UE before the PDP context can be set in to established state.
• If no <cid>s are specified the activation form of the command activates all defined contexts.
• If no <cid>s are specified the deactivation form of the command deactivates all active contexts.
The read command returns the current activation states for all the defined PDP contexts. The test command is used for requesting information on the supported PDP context activation states.
Set command AT+CGACT=[<state>[,<cid>[,<cid>[,…]]]] Response
• OK
NO CARRIER
• ERROR
Parameter
• <state> indicates the state of PDP context activation 0 – deactivated 1 – activated Other values are reserved and will result in an ERROR response to the execution command.
• <cid> a numeric parameter which specifies a particular PDP context definition (see +CGDCONT command)
Reference 3GPP TS 27.007
• If context is deactivated successfully, NO CARRIER is returned
• If CID0 for PDN activated during attach is enabled, then AT+CGACT=<0 or 1>,0 will cau se
ERROR r
Test command AT+CGACT=? Response
• +CGACT: (list of supported <state>s) Parameter See set command
Read command AT+CGACT? Response
• +CGACT: <cid>,<state>
Page 83
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 83 of 228 2020-08-18
• [<CR><LF>+CGACT: <cid>,<state>
• […]]
Parameter
• See set command
AT+CGPADDR Show PDP address
Set command AT+CGPADDR= [<cid>[,<cid>[,…]]] Response +CGPADDR: <cid>,<PDP_addr> [<CR><LF>+CGPADDR: <cid>,<PDP_addr> [...]] Parameter
• <cid> a numeric parameter which specifies a particular PDP context definition (see +CGDCONT command). If no <cid> is specified, the addresses for all defined contexts are returned.
• <PDP_addr> a string that identifies the MT in the address space applicable to the PDP. The
address may be static or dynamic. For a static address, it will be the one set by the +CGDCONT command when the context was defined. For a dynamic address, it will be the one assigned during the last PDP context activation that used the context definition referred to by <cid>. <PDP_address> is omitted if none is available.
Test command AT+CGPADDR=? Response
• +CGPADDR: (list of defined <cid>s) Parameter
• See set command
Reference 3GPP TS 27.007
Page 84
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 84 of 228 2020-08-18
AT+IPCONFIG Query the device’s IP address
This command can be used to query the IP address for the device.
Active command AT+IPCONFIG Response
• +IPCONFIG: <IP addr> OK
• ERROR
AT+IPCONFIG +IPCONFIG: fe80:0:0:0:3c:ffb8:f4c9:1207
+IPCONFIG: 2001:14bb:170:4c91:3c:ffb8:f4c9:1207 +IPCONFIG: 178.55.211.180 +IPCONFIG: 127.0.0.1 OK
AT+CGEREP Packet Domain Event Reporting
Set command enables or disables sending of unsolicited result codes, +CGEV: XXX from UE to TE in the case of certain events occurring in the Packet Domain UE or the network. <mode> controls the processing of unsolicited result codes specified within this command. <bfr> controls the effect on buffered codes when <mode> 1 or 2 is entered. Read command returns the current mode and buffer settings. Test command returns the modes and buffer settings supported by the UE as compound values.
Execution Command AT+CGEREP=[<mode>] Response
• OK
• If error is related to wrong AT syntax:
+CME ERROR: <err> Parameters <mode> 0 buffer unsolicited result codes in the UE; if UE result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE. 1 discard unsolicited result codes when UE-TE link is reserved (e.g. in on-line data mode); otherwise forward them directly to the TE <bfr> 0 UE buffer of unsolicited result codes defined within this command is cleared when <mode> 1 is entered
Unsolicited Result Codes supported:
For network attachment, the following unsolicited result codes and the corresponding events are defined: +CGEV: NW DETACH The network has forced a PS detach. This implies that all active contexts have been deactivated. These are not reported separately. +CGEV: ME DETACH The mobile termination has forced a PS detach. This implies that all active contexts have been deactivated. These are not reported separately.
Page 85
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 85 of 228 2020-08-18
For PDP context activation, the following unsolicited result codes and the corresponding events are defined:
+CGEV: NW PDN ACT <cid> The network has activated a context. The context represents a Primary PDP context in GSM/UMTS. The <cid> for this context is provided to the TE. The format of the parameter <cid> is found in command +CGDCONT. NOTE 1: This event is not applicable for EPS.
+CGEV: ME PDN ACT <cid>[,<reason>[,<cid_other>]] The mobile termination has activated a context. The context represents a PDN connection in NB­IOT. The <cid> for this context is provided to the TE. This event is sent either in result of explicit context activation request (+CGACT), or in result of implicit context activation request associated to attach request (+CGATT=1). The format of the parameter <cid> and <cid other> are found in command +CGDCONT.
For PDP context deactivation, the following unsolicited result codes and the corresponding events are defined:
+CGEV: NW PDN DEACT <cid> The network has deactivated a context. The context represents a PDN connection in NB-IOT. The associated <cid> for this context is provided to the TE. The format of the parameter <cid> is found in command +CGDCONT. NOTE 2: Occurrence of this event replaces usage of the event +CGEV: NW DEACT <PDP_type>, <PDP_addr>, [<cid>]
+CGEV: ME PDN DEACT <cid> The mobile termination has deactivated a context. The context represents a PDN connection in NB-IOT. The <cid> for this context is provided to the TE. The format of the parameter <cid> is found in command +CGDCONT.
NOTE 3: Occurrence of this event replaces usage of the event +CGEV: ME DEACT <PDP_type>, <PDP_addr>, [<cid>]
For other PDP context handling, the following unsolicited result codes and the corresponding events are defined:
+CGEV: REJECT <PDP_type>, <PDP_addr> A network request for context activation occurred when the UE was unable to report it to the TE with a +CRING unsolicited result code and was automatically rejected. The format of the parameters <PDP_type> and <PDP_addr> are found in command +CGDCONT. NOTE 6: This event is not applicable for EPS.
+CGEV: NW REACT <PDP_type>, <PDP_addr>, [<cid>] The network has requested a context reactivation. The <cid> that was used to reactivate the context is provided if known to the UE. The format of the parameters <PDP_type>, <PDP_addr> and <cid> are found in command +CGDCONT. NOTE 7: This event is not applicable for EPS.
Parameter:
<PDP_type> Packet Data Protocol type (see +CGDCONT command) <PDP_addr> Packet Data Protocol address (see +CGDCONT command} <cid> Context Id (see +CGDCONT command) Note: <cid> only given if known to the UE. <class> GPRS mobile class (see +CGCLASS command) <event_type> Integer type parameter indicates whether this is an informational Event of whether the TE as acknowledged it. 0 Informational event 1 Information request: Acknowledgement required. The Acknowledgement can be accept or reject, see AT+CGANS. <change_reason> Integer type parameter indicates what kind of change occurred. 1 TFT only changed 2 QoS only changed 3 Both TFT and QoS changed
Page 86
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 86 of 228 2020-08-18
<reason> Integer type parameter indicates the reason why the context activation request for PDP type IPV4V6 was not granted. This parameter is only included if the requested PDP type associated with <cid> is IPV4V6, and the PDP type assign by the network for <cid> is either IPV4 or IPV6 0 IPV4 only allowed 1 IPV6 only allowed 2 single address bearers only allowed 3 single address bearers only allowed and MT initiated context activation for a second address type bearer was not successful <cid_other> Indicated the context identifier allocated by MT for an MT nitiated context of a second address type. MT shall only include this parameter if <reason> parameter indicates single address bearers only allowed, and MT support MT initiated context activation of a second address type without additional commands from the TE, and MT has activated the PDN connection or PDP context associated with <cid_other>.
Test Command AT+CGEREP=? Response
• +CGEREP: (list of supported <mode>s), (list of supported <bfr>s)
• OK
Read Command AT+CGEREP? Response
• +CGEREP: <mode>,<bfr>
• OK
AT+CGREG Network registration status
This command is used to display the packet switched network registration status.
Set command AT+CGREG=[<n>] Response Parameter <n> 0 disable network registration unsolicited result code 1 enable network registration unsolicited result code +CGREG: <stat> 2 enable network registration and location information unsolicited result code +CGREG: <stat>[,<lac>,<ci>[,<AcT>,<rac>]] <stat> 0 not registered, ME is not currently searching a new operator to register to 1 registered, home network 2 not registered, but ME is currently searching for a new operator to register to 3 registration denied 4 unknown 5 registered, roaming 6 registered for “SMS only”, home network (applicable only when <Act> indicates E-UTRAN 7 registered for “SMS only”, roaming (applicable only when <Act> indicates E-UTRAN <lac> string type; two byte location area code in hexadecimal format (e.g. "00C3" equals 195 in decimal) <ci> string type; four byte UTRAN/GERAN/E-UTRAN cell ID in hexadecimal format <AcT> access technology of the registered network 9 NB-IoT <rac> string type; one byte routing area code in hexadecimal format Note
• The set command controls the presentation of an unsolicited result code +CGREG: <stat>
when <n>=1 and there is a change in the UE's GPRS network registration status, or code
Page 87
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 87 of 228 2020-08-18
+CGREG: <stat>[,<lac>,<ci>[,<AcT>,<rac>]] when <n>=2 and there is a change of the network cell.
• For NB-IoT product, only <AcT> value of 9 is valid.
Test command AT+CGREG=? Response
• +CGREG: (list of supported <n>s) Parameter
• See set command
Read command AT+CGREG? Response
• +CGREG: <n>,<stat>[,<lac>,<ci>[,<AcT>]]
• +CME ERROR: <err>
Parameter
• See set command
Reference 3GPP TS 27.007
AT+CGPIAF Printing IP Address Format
Set command decides what format to print IPV6 address parameters of other AT commands. See RFC 4291 for details of the IPv6 address format. The +CGPIAF parameters <IPv6_AddressFormat>, <IPv6_SubnetNotation>, <IPv6_LeadingZeros> and <IPv6_CompressedZeros> affect the following commands and parameters:
1) in +CGTFT and +CGTFTRDP, the <source address and subnet mask>;
2) in +CGDCONT, the <PDP_addr>;
3) in +CGPADDR, the <PDP_addr_1> and <PDP_addr_2>;
4) in +CGCONTRDP, the <source address and subnet mask>, <DNS_prim_addr>,
<DNS_sec_addr>,<P_CSCF_prim_addr> and <P_CSCF_sec_addr>;
Read command returns the current command parameter settings.
Test command returns values supported as compound values.
Execution Command AT+CGPIAF=[IPv6_AddressFormat>[,<IPv6_SubnetNotation>[,<IPv6_LeadingZeros>[,<IPv6_CompressZero s>]]]] Response OK If error is related to wrong AT syntax: +CME ERROR: <err> Parameters <IPv6_AddressFormat>: Integer type, decides the IPV6 address format. Relevant for all AT command parameters that can hold an IPV6 address. 0: Use IPV4-like dot-notation. IP address, and Subnetwork mask if applicable, are dot-separated. Example: For <source address and subnet mask>: “32.1.13.184.0.0.205.48.0.0.0.0.0.0.0.0.255.255.255.255.255.255.255.240.0.0.0.0.0.0.0.0” For other IP address parameters: “32.1.13.184.0.0.205.48.0.0.0.0.0.0.0.0” 1: Use IPV6-like colon notation. IP address, and subnetwork mask if applicable and when given
Page 88
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 88 of 228 2020-08-18
explicitly, are separated by a space. Example:
For <source address and subnet mask>: “2001:0DB8:0000:CD30:0000:0000:0000:0000 FFFF:FFFF:FFFF:FFF0:0000:0000:0000:0000” For other IP address parameters: “2001:0DB8:0000:CD80:0000:0000:0000:0000”
<IPv6_SubnetNotation>: Integer type, decides the subnet-notation for <source Address and subnet mask>. Setting does not apply If <IPVv6_AddressFormat>=0. 0: Both IP Address and subnet mask are stated Explicitly, separated by a space. Example: “2001:0DB8:0000:CD30:0000:0000:0000:0000 FFFF:FFFF:FFFF:FFF0:0000:0000:0000:0000” 1 The printout format is applying / (forward slash) subnet-prefix Classless Inter-Domain Routing (CIDR) notation: Example: “2001:0DB8:0000:CD30:0000:0000:0000:0000/60”
<IVv6_LeadingZeros>: Integer type, decides whether leading zeros are Omitted or not. Setting does not apply if <IPv6_AddressFormat>=0. 0: Leading zeros are omitted. Example: “2001:DB8:0:CD30:0:0:0:0” 1: Leading zeros are included. Example: “2001:0DB8:0000:CD30:0000:0000:0000:0000”
<IPv6_CompressZeros>: Integer type, decides whether 1-n instances of 16 bit zero-values are replaced by only “..”. This Applies only once. Setting does not apply if <IPv6_AddressFormat>=0. 0: No zero compression. Example: “2001:DB8:0:CD30:0:0:0:0” 1 Use zero compression. Example: “2001:DB8:0:CD30::”
Read Command AT+CGPIAF? Response
• +CGPIAF: <IPv6_AddressFormat>,<IPv6_SubnetNotation>,<IPv6_LeadingZeros>, <IPv6_CompressZeros>
• OK
• +CME ERROR: <err>
Test Command AT+CGPIAF=? Response
• +CGPIAF: (list of supported <IPv6_AddressFormat>s), (list of supported <IPv6_SubnetNotation>s), (list of supported IPv6_LeadingZeros>s), (list of supported IPv6_CompressZeros>s)
• OK
+CGPIAF examples AT+CGPIAF=? Test command +CGPIAF: (0,1),(0,1),(0,1),(0,1) OK
AT+CGPIAF? Read command +CGPIAF: 0,0,0,0 All Settings at default format OK
AT+CGPIAF=1,1,0,1 Set command. Use IPV6-like notation, with the “/” OK format for subnet mask, omit leading zeros and use zero compression.
Page 89
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 89 of 228 2020-08-18
AT+CGDEL Delete Non-Active PDP Contexts
The execution command +CGDEL=<cid> removes the indicated PDP context and removes all associated data related to the indicated PDP contexts that are not activated. The AT command will not delete or removeinformation for activated PDP contexts. The removed PDP context is listed by the +CGDEL: <cid> intermediate result code.
• If <cid> points to a primary PDP context, the PDP context will be deleted together with all linked secondary PDP
contexts if none of the PDP contexts are activated.
• If <cid> points to a secondary PDP context, the PDP context will be deleted if it is not activated.
A special form of the command can be given as +CGDEL (with the =<cid> omitted). In this form, all primary PDP contexts that are not activated or have any activated secondary PDP contexts will be removed and all secondary PDP contexts that are not activated will be removed. The associated data of all the deleted PDP contexts will be removed, and the removed PDP context are listed by the +CGDEL: <cid>[,<cid>[,...]] intermediate result code. Activated PDP contexts will not cause this form of the command to return ERROR or +CME ERROR.
Note, +CGDEL will remove associated PDP context data that can be set by the AT commands +CGDCONT, +CGDSCONT, +CGTFT, +CGEQREQ, +CGEQMIN and +CGEQOS. For an attempt to delete PDP context(s) which would violate these rules, a +CME ERROR response is returned.
Execution Command AT+CGDEL=<cid>] Response
• +CGDEL: <cid>[,<cid>[,…]]
• OK
• If error is related to wrong AT syntax:
+CME ERROR: <err> Parameters <cid>: a numeric parameter which specifies a particular PDP context Definition.
Read Command AT+CGDEL? Response
• +CME ERROR: <err>
Test Command AT+CGDEL=? Response
• OK
Page 90
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 90 of 228 2020-08-18
AT+CGAUTH Define PDP Context Authentication Parameters
Set command allows the user to specify authentication parameters for a PDP context identified by the (local) context identification parameter <cid> used during the PDP context activation and the PDP context modification procedures. Since the <cid> is the same parameter that is used in the +CGDCONT and +CGDSCONT commands, +CGAUTH is effectively as an extension to these commands.
Note, this AT command transfers information in the clear that can be regarded as sensitive in security terms. Care must be exercised in providing this command where the AT commands are used in insecure The read command returns the current settings for each defined context. The test command returns values supported as a compound value.
Execution Command AT+CGAUTH=<cid>[,<auth_prot>[,<userid>[,<password>]]] Response
• When <auth_prot>/<username>/<password> set: OK
• When no <auth_prot>/<username>/<password> set displays current auth_prot username and
password for <cid>: +CGAUTH:<cid>,<auth_prot>,<username>,<password> OK
• OK
• If error is related to wrong AT syntax:
+CME ERROR: <err> Parameters <cid>: A numeric parameter which specifies a particular PDP context definition (see the +CGDCONT and +CGDSCONT commands). <auth_prot>: Numeric parameter. Authentication protocol used for this PDP context. 0: None. Used to indicate that no authentication protocol is used for this PDP context. Username and password are removed if previously specified. 1: PAP <userid>: String type. User name for access to the IP network. <password>: String type. Password for access to the IP network.
Read Command AT+CGAUTH? Response
• [+CGAUTH: <cid>,<auth_prot>,<userid>,<password>]
• [<CR><LF>+CGAUTH: <cid>,<auth_prot>,<userid>,<password>
• […]]
• OK
Test Command AT+CGAUTH=? Response
• +CGAUTH: (range of supported <cid>s),(list of supported <auth_prot>s),(range of supported <userid>s),(range of supported <password>s)
• OK
Page 91
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 91 of 228 2020-08-18
AT+CGDATA Enter Data State
This command is used activate a PDP context / EPS bearer rather than using the ATD*99# method. It will be used by the Packet Transport mechanism for activating a PDP context / EPS bearer. Note that is it is possible for AT+CGDATA to re-use an already active context as long as the context was activated with no data connection on the same channel (i.e. activated with AT+CGACT).
Set command AT+CGDATA=[<L2P>[,<cid>[,<cid>[,…]]]] Response
• OK
• ERROR
Parameter
• <L2P> a string parameter that indicates the layer 2 protocol to be used between the TE and MT: M-PT – Packet Transport Mechanism protocol for a PDP such as IP
Other values are not supported and will result in an ERROR response to the execution command.
• <cid> a numeric parameter which specifies a particular PDP context definition (see +CGDCONT
command)
Test command AT+CGDATA=? Response
• +CGDATA: (list of supported <L2P>s)
Parameter
• See set command
AT*MBANDSL Set Modem NB-IOT Search Prefer Band List
Set command AT*MBANDSL=<Enable>[,<band number>,<band1>,<band2>,<band3>,<ban4>]
Response
• OK
• +CME ERROR: <err>
Parameter < Enable > Integer value indicating search prefer band list enable or disable 0 :disable 1:enable < band number > Integer value indicating search prefer band number Valid values: 1,2,3,4 < band1> Integer value indicating current search prefer NB-IOT band Valid values: 1,2,3,5,8,11,12,13,17,18,19,20,21,25,26,28,31,66,70
Page 92
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 92 of 228 2020-08-18
AT*MNBIOTDT NB-IoT Data Type
This command is used to set the NB-IoT data type per APN (Normal or Exceptional data).
Execution command AT*MNBIOTDT=<type>[,<cid>[,<cid>[,…]]] Response
• OK
Parameters
• <type>: integer type
0 – Normal data (default) 1 – Exceptional data
• <cid>: integer type. Specifies a particular PDP context definition.
If no <cid>s are specified the command sets <type> for all active PDP contexts. Note
• The UE will not remember this setting over sleep cycles (i.e. the UE will fall back to default setting
after sleep)
Test Command AT*MNBIOTDT=? Response
• *MNBIOTDT: (list of supported <types>s)
• OK
Read command AT*MNBIOTDT? Response
• Displays <type> for all active PDP contexts:
[*MNBIOTDT:<cid>,type] [<CR><LF>*MNBIOTDT:<cid>,<type>] […]] OK
Page 93
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 93 of 228 2020-08-18
AT*MLPINFO Report packet domain packet counters
This command is used to report packet domain packet counters.
Execution command AT*MLPINFO
Response <CR><LF>*MLPINFO: <sleep_duration>,<rx_time>,<tx_time><CR><LF> <CR><LF>OK<CR><LF>
• If error is related to wrong AT syntax
<CR><LF>+CME ERROR: <err><CR><LF> Set Command
AT*MLPINFO=[<mode>] Response
<CR><LF>*MLPINFO: <sleep_duration>,<rx_time>,<tx_time><CR><LF> <CR><LF>OK<CR><LF>
• If error is related to wrong AT syntax
<CR><LF>+CME ERROR: <err><CR><LF> Parameters
<mode> Integer value indicating the query mode. 0 Return the time in unit of 0.1 second 1 Return the time in unit of millisecond
<sleep_duration> Integer value indicating the total sleep duration from the latest boot up, in unit of 0.1 second or millisecond.
<rx_time> Integer value indicating the total RX time from the latest boot up, in unit of 0.1 second or millisecond.
<tx_time> Integer value indicating the total TX time from the latest boot up, in unit of 0.1 second or millisecond.
Note: Execution command AT*MLPINFO returns <sleep_duration>,<rx_time>,<tx_time> in 0.1 second.
Page 94
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 94 of 228 2020-08-18
8. POWER SAVING COMMANDS
AT+CEDRXS eDRX Settings
This setting instruction is used to set eDRX parameter, enable/disable eDRX, and request eDRX parameter set in a particular system. This command will take effect once setting, and the parameters will be saved when power-off
When <mode>=2, the setting instruction can also make the module report actively when an eDRX-related parameter provided by network changes.
+CEDRXP:<AcT-type>[,<Requested_eDRX_value>[,<NW-provided_eDRX_value>[,<Paging_time_window>]]] When +CEDRXS=3 is sending, eDRX shall not be used and all the previous parameters set shall be removed to
restore them to default values. The query instruction is used for the current set value of all the defined <act-type>.
AT+CEDRXS=<mode>,[,<AcT-type>[,<Requested_eDRX_value>]]
Response
<CR><LF>OK<CR><LF> or
<CR><LF>ERROR<CR><LF>
Parameter <mode>integer data to enable/disable eDRX. This parameter can be applied to all the specified types of access technology,
0 Disable EDRX 1 Enable eDRX 2 Enable eDRX and enable active submission in the following formats: +CEDRXP:<AcT-type>[,<Requested_eDRX_value>[,<NW-
provided_eDRX_value>[,<Paging_time_window>]]]
3 Disable the use of eDRX and discard all parameters for eDRX or, if available, reset to the manufacturer specific default values. <AcT-type>: integer data, access technology type
0 Access technology without using eDRX. The parameter is only used to actively report result codes.
5 E-UTRAN (NB-S1 mode) <Requested_eDRX_value>: character type parameter occupying the bit1-bit4 of eDRX. The parameter can be applied to A/Gb mode, Iu mode, or S1 mode. In different modes, the parameter is defined as follows:
In A/Gb mode (EC-GSM-IoT/GSM):
Bit 4 ~bit1 GERAN eDRX cycle duration. The number of 51-MF in every GERAN eDRX cycle
0000 About 1,88 seconds (Note 1, Note 2) 8
0001 About 3,76 seconds (Note 1, Note 2) 16
0010 About 7,53 seconds (Note 1, Note 2) 32
0011 12,24 seconds (Note 2) 52
0100 24,48 seconds (Note 2) 104
0101 48,96 seconds (Note 2) 208
0110 97,92 seconds (Note 2) 416
0111 195,84 seconds (Note 2) 832
1000 391,68 seconds (Note 2) 1664
1001 783,36 seconds (Note 2) 3328
Page 95
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 95 of 228 2020-08-18
1010 1566,72 seconds (Note 2) 6656
1011 3133,44 seconds (Note 2) 13312
All values other than those in the list will be automatically equated with the parameter 0000;
Note1: All the cycle parameter values above have been rounded to two decimals;
Note2: All the cycle parameter values can be obtained by the formula: ((3,06 / 13) * (Number of 51-MF))
In NB-S1/WB-S1 mode (E-UTRAN):
Bit 4 ~bit1 E-UTRAN eDRX cycle length duration eDRX cycle parameter 'TeDRX'
0000 5,12 seconds (Note 4) Note 3
0001 10,24 seconds (Note 4) 20
0010 20,48 seconds 21
0011 40,96 seconds 22
0100 61,44 seconds (Note 5) 6
0101 81,92 seconds 23
0110 102,4 seconds (Note 5) 10
0111 122,88 seconds (Note 5) 12
1000 143,36 seconds (Note 5) 14
1001 163,84 seconds 24
1010 327,68 seconds 25
1011 655,36 seconds 26
1100 1310,72 seconds 27
1101 2621,44 seconds 28
1110 5242,88 seconds (Note 6) 29
1111 10485,76 seconds (Note 6) 210
All values other than those in the list will be automatically become parameter 0000 by default;
Note3: In E-UTRAN system, when eDRX cycle lasts 5.12S, parameter TeDRX is invalid.
Note4: The value is applied to WB-S1 mode. In NB-S1 mode, it is equivalent to the eDRX parameter not containing the cycle duration parameter.
Note5: The value is applied to WB-S1 mode. In NB-S1 mode, these parameters are automatically equated with 0010.
Note6: The value is applied to the NB-S1 mode. <NW-provided_eDRX_value>: the eDRX value assigned by the network. The definition of the parameter is equivalent to <Requested_eDRX_value> <Paging_time_window>: character type parameter, which occupies the bit5-bit8 of eDRX parameter. PTW value (paging time window). In different modes, the parameter is defined as follows:
In NB-S1 mode:
Bit 8~bit5 Paging Time Window length
0000 2,56 seconds
0001 5,12 seconds
0010 7,68 seconds
0011 10,24 seconds
0100 12,8 seconds
0101 15,36 seconds
0110 17,92 seconds
0111 20,48 seconds
1000 23,04 seconds
1001 25,6 seconds
Page 96
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 96 of 228 2020-08-18
1010 28,16 seconds
1011 30,72 seconds
1100 33,28 seconds
1101 35,84 seconds
1110 38,4 seconds
1111 40,96 seconds
AT+CEDRXS=? Response
<CR><LF>+CEDRXS: (list of supported <mode>s),(list of supported <AcT-type>s),(list of supported <Requested_eDRX_value>s) <CR><LF>
<CR><LF>OK<CR><LF>
AT+CEDRXS? Response
[<CR><LF>+CEDRXS: <AcT-type>,<Requested_eDRX_value> [<CR><LF>+CEDRXS: <AcT-type>,<Requested_eDRX_value> [...]]] <CR><LF>OK<CR><LF>
AT+CEDRXS=1,5,"1101" OK AT+CEDRXS? +CEDRXS: 5,"1101"
OK AT+CEDRXS=? +CEDRXS: (0-3),(5),("0000"-"1111")
OK
Page 97
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 97 of 228 2020-08-18
AT+CEDRXRDP eDRX to read dynamic parameters
When eDRX is used for currently registered cell, the instruction is used to return <Requested_eDRX_value>, <NW­provided_eDRX_value> and <Paging_time_window>. If current registered cell does not use eDRX, the setting instruction returns AcT-type=0.
AT+CEDRXRDP Response
<CR><LF>+CEDRXRDP: <AcT-type>[,<Requested_eDRX_value>[,<NW-
provided_eDRX_value>[,<Paging_time_window>]]]<CR><LF>
<CR><LF>OK<CR><LF>
Parameter
<AcT-type>: integer data, access technology type.
0 Access technology without using eDRX. The parameter is only used to actively report result codes.
5 E-UTRAN (NB-S1 mode)
<Requested_eDRX_value>: character type parameter occupying the bit1-bit4 of eDRX. The parameter can be applied to A/Gb mode, Iu mode, or S1 mode. Refer to the parameter definition of <Requested_eDRX_value> of +CEDRXS? instruction.
<NW-provided_eDRX_value>: the eDRX value assigned by the network. The definition of the parameter is equivalent to <Requested_eDRX_value>
<Paging_time_window>: character type parameter, which occupies the bit5-bit8 of eDRX parameter. PTS value (paging time window). Refer to the parameter definition of <Paging_time_window> of +CEDRXS? instruction.
AT+CEDRXRDP=? Response <CR><LF>OK<CR><LF>
AT+CEDRXRDP CEDRXRDP: 5,"1101","1101","0100"
OK AT+CEDRXRDP=?
OK
Page 98
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 98 of 228 2020-08-18
AT*MEDRXCFG eDRX configuration
The set command controls the setting of the UEs eDRX parameters. The command controls whether the UE wants to apply eDRX or not, as well as the requested eDRX value and requested paging time window value for each
specified type of access technology.
The set command also controls the presentation of an unsolicited result code +CEDRXP: <AcT­type>[,<Requested_eDRX_value>[,<NW-provided_eDRX_value>[,<Paging_time_window>]]] when <n>=2 and there
is a change in the eDRX parameters provided by the network.
A special form of the command can be given as *MEDRXCFG=3. In this form, eDRX will be disabled and data for all parameters in the command *MEDRXCFG will be removed or, if available, set to the manufacturer specific default
values.
Execution command
AT*MEDRXCFG=[<mode>,[,<AcT-
type>[,<Requested_eDRX_value>[,<Requested_Paging_time_window_value>]]]] Response
• OK
• If error is related to wrong AT syntax: +CME ERROR: <err> Unsolicited result code
+CEDRXP:<AcT-type>[,<Requested_eDRX_value>[,<NW-
provided_eDRX_value>[,<Paging_time_window>]]]
<mode>: integer type, indicates to disable or enable the use of eDRX in the UE. This parameter
is applicable to all specified types of access technology, i.e. the most recent setting of <mode> will take effect for all specified values of <AcT>. 0 Disable the use of eDRX 1 Enable the use of eDRX
2 Enable the use of eDRX and enable the unsolicited result code +CEDRXP: <AcT-
type>[,<Requested_eDRX_value>[,<NW- provided_eDRX_value>[,<Paging_time_window>]]]
3 Disable the use of eDRX and discard all parameters for eDRX or, if available, reset to the
manufacturer specific default values.
<AcT-type>: integer type, indicates the type of access technology. This AT-command is used to
specify the relationship between the type of access technology and the requested eDRX value.
0 Access technology is not using eDRX. This parameter value is only used in the unsolicited
result code.
Page 99
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 99 of 228 2020-08-18
5 E-UTRAN (NB-S1 mode)
<Requested_eDRX_value>: string type; half a byte in a 4-bit format. The eDRX value refers to bit 4 to 1 of octet 3 of the Extended DRX parameters information element (see su b-clause 10.5.5.32 of 3GPP TS 24.008). For the coding and the value range, see Extended DRX parameters information element in 3GPP TS 24.008 Table 10.5.5.32/3GPP TS 24.008. The default value, if
available, is manufacturer specific.
<Requested_Paging_time_window_value>: string type; half a byte in a 4-bit format. The paging time window refers to bit 8 to 5 of octet 3 of the Extended DRX parameters information element (see sub-clause 10.5.5.32 of 3GPP TS 24.008). For the coding and the value range, see the Extended RX parameters information element in 3GPP TS 24.008 Table 10.5.5.32/3GPP TS
24.008.
<NW-provided_eDRX_value>: string type; half a byte in a 4-bit format. The eDRX value refers to bit 4 to 1 of octet 3 of the Extended DRX parameters information element (see sub- clause 10.5.5.32 of 3GPP TS 24.008). For the coding and the value range, see Extended DRX parameters
information element in 3GPP TS 24.008 Table 10.5.5.32/3GPP TS 24.008.
<Paging_time_window>: string type; half a byte in a 4-bit format. The paging time window refers to bit 8 to 5 of octet 3 of the Extended DRX parameters information element (see sub-clause
10.5.5.32 of 3GPP TS 24.008). For the coding and the value range, see the Extended DRX
parameters information element in 3GPP TS 24.008 Table 10.5.5.32/3GPP TS 24.008.
Test Command AT*MEDRXCFG=? Response
• *MEDRXCFG: (list of supported <mode>s),(list of supported <AcT-type>s),(list of supported
<Requested_eDRX_value>s) ,(list of supported <Requested_Paging_time_window_value>s)
• OK
Read command AT*MEDRXCFG? Response
[*MERDRXCFG: <AcT-
type>,<Requested_eDRX_value>[,<Requested_Paging_time_window_value>]
[<CR><LF>*MEDRXCFG: <AcT-
type>,<Requested_eDRX_value>[,<Requested_Paging_time_window_value>]
• [...]]]
• OK
Page 100
NE310H2 & NL865H2 AT Commands Reference Guide
1VV0301611 Rev. 7 Page 100 of 228 2020-08-18
AT+CPSMS set power saving mode (PSM)
This command is used to set the PSM (power saving mode) mode of the module: enable and disable this mode. This command can be used to set RAU (routing area update) cycle and the time of GPRS READY Timer under GSM network and set TAU (location update) cycle and Active Time value under LTE Cat.M/NB-IOT network. This command will take effect after restart, and the parameters will be saved when power-off
AT+CPSMS=2 instruction is mainly used to disable PSM mode and remove all the parameters previously set to restore them to default values.
The query instruction is mainly used to return current parameter settings; The help instruction is mainly used to return the range of supported parameters.
AT+CPSMS=[<mode>[,<Requested_Periodic-RAU>[,<Requested_GPRS-READY­timer>[,<Requested_Periodic-TAU>[,<Requested_Active-Time>]]]]] Response OK +CME ERROR: <err>
Defined values mode
0 Disable PSM 1 Enable PSM
<Requested_Periodic-RAU>: string type; 8-bit single byte. Request setting RAU cycle (T3412) unde
GERAN/UTRAN network. The parameter is defined as follows:
Bit 8
Bit 7
Bit 6
Bit 5
Bit 4
Bit 3
Bit 2
Bit 1
Unit
Timer value
0 0 0 – 10 minutes
0 0 1 – 1 hour
0 1 0 –10 hours
0 1 1 –2 seconds
1 0 0 -30 seconds
1 0 1 –1 minute
1 1 0 -320 hours
1 1 1– T3412 timer invalid
Bit5 - 1 represents the value of a binary encoded timer.
For example: "01000111”: 010 means the unit is 10 hours and 00111 represents decimal number 7. Therefore, the parameter is equal to
70 hours, 25200S;
01110101: 011 means the unit is 25 and 10101 represents decimal number 21. Therefore, the parameter is equal to 42S;
10111101: 101 means the unit is 1 minute and 11101 represents decimal number 29. Therefore, the parameter is equal to 29 minutes,
1740S;
Loading...