wangfq/mobile_comm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
caef43a6be3eaf280868afa8ca12f0cc737aa498
mobile_comm/luatos/air780epm/docs/rfa/rfa_manual.txt
T
wangfq 173dd6874f init: Air780EPM 官方 LuatOS 项目代码基线 
- 来源: 合宙 LuatOS 官方仓库 air780epm 模块完整代码
- 路径: luatos/air780epm/module/Air780EPM/demo 含官方 demo(含 mqtt/mqtts/socket/uart 等)
- 后续: 基于 demo 开发 UART<->MQTT 数据上报功能
2026-08-31 08:53:49 +08:00

13933 lines
512 KiB
Plaintext
Raw Blame History

EC CAT1
AT Commands Manual
Rev. EC CAT1_AT_Commands_Manual_V1.2
Content
Content ................................................................................................................................. 2
1 Introduction ........................................................................................................................ 8
1.1 Definitions................................................................................................................ 8
1.2 AT command syntax ................................................................................................ 8
1.3 3GPP compliance .................................................................................................... 9
2 General Control Commands .............................................................................................10
2.1 Basic CommandsITU-T V.250 .........................................................................10
2.1.1 ATE Command echo.....................................................................................10
2.1.2 ATQ Result code suppression ......................................................................10
2.1.3 AT&F Set parameters to factory-defined configuration .................................11
2.1.4 AT&W Store parameters to user-defined configuration.................................12
2.1.5 AT&V Display current configuration parameters ...........................................13
2.1.6 ATO Return to online data state from online command state .......................14
2.1.7 ATH Disconnect from the line and terminate call ..........................................15
2.1.8 AT&C Set DCD Function Mode ....................................................................15
2.1.9 AT&D Set DTR Function Mode .....................................................................16
2.2 3GPP Commands (27.007) ....................................................................................17
2.2.1 AT+CFUN set phone functionality.................................................................17
2.2.2 AT+CGSN request product serial number ....................................................18
2.2.3 AT+CGMR request manufacturer revision ....................................................19
2.2.4 AT+CMEE report mobile termination error....................................................20
2.2.5 AT+COPS PLMN selection ...........................................................................21
2.2.6 AT+CREG network registration.....................................................................23
2.2.7 AT+CEREG EPS network registration status................................................25
2.2.8 AT+CSQ get signal quality............................................................................28
2.2.9 AT+CESQ get extended signal quality..........................................................29
2.2.10 AT+CPSMS power saving mode setting .....................................................31
2.2.11 AT+CEDRXS eDRX setting ........................................................................33
2.2.12 AT+CEDRXRDP eDRX read dynamic parameters .....................................34
2.2.13 AT+CCIOTOPT cIot optimization configuration ..........................................35
2.2.14 AT+CGCMOD PDP context modify.............................................................37
2.2.15 AT+CGATT PS attach or detach .................................................................38
2.2.16 AT+CGACT PDP context activate or deactivate .........................................39
2.2.17 AT+CGDATA enter data state .....................................................................40
2.2.18 AT+CGDCONT define a PDP context.........................................................41
2.2.19 AT+CGCONTRDP PDP context read dynamic parameters ........................45
2.2.20 AT+CGEQOS define EPS quality of service ...............................................47
2.2.21 AT+CGEQOSRDP EPS quality of service read dynamic parameters.........48
2.2.22 AT+CGSCONTRDP read secondary PDP dynamic parameters ................50
2.2.23 AT+CGTFT traffic flow template..................................................................51
2.2.24 AT+CGAPNRC APN rate control ................................................................54
2.2.25 AT+CGEREP Packet domain event reporting.............................................55
2.2.26 +CGEV used to indicate EPS PDN connection and bearer resources
operations status ...................................................................................................57
2.2.27 AT+CGPADDR show PDP address(es) ......................................................58
2.2.28 AT+CSCON signalling connection status ...................................................59
2.2.29 AT+CCLK return current date and time ......................................................60
2.2.30 AT+CIMI request international mobile subscriber identity ...........................61
2.2.31 AT+CPIN enter PIN ....................................................................................62
2.2.32 AT+CLCK facility lock .................................................................................63
2.2.33 AT+CPWD change password .....................................................................64
2.2.34 AT+CSIM generic SIM access ....................................................................65
2.2.35 AT+CRSM restricted SIM............................................................................66
2.2.36 AT+CCHO open logical channel .................................................................67
2.2.37 AT+CCHC close logical channel.................................................................68
2.2.38 AT+CGLA generic UICC logical channel access ........................................69
2.2.39 AT+CTZU automatic time zone update.......................................................70
2.2.40 AT+CTZR time zone reporting ....................................................................71
2.2.41 AT+CRCES reading coverage enhancement status ...................................73
2.2.42 AT+CIPCA initial PDN context activation ....................................................74
2.2.43 AT+CGMI request manufacturer identification ............................................75
2.2.44 AT+CGMM request model identification .....................................................76
2.2.45 AT+CPINR remaining PIN retries ...............................................................77
2.2.46 AT+CGAUTH define PDP context authentication parameters ....................78
2.2.47 AT+IPR set UE baud rate ...........................................................................80
2.2.48 AT+ICF set UE serial port character framing ..............................................81
2.2.49 AT+CNUM request subscriber number .......................................................82
2.2.50 AT+CEER extended error report.................................................................83
2.2.51 AT+CEMODE UE modes of operation for EPS...........................................83
2.2.52 AT+IFC set UE local flow control ................................................................84
2.2.53 AT+CPOL Preferred PLMN list ...................................................................85
2.2.54 AT+CPLS Selection of preferred PLMN list ................................................87
2.2.55 AT+CSODCP sending of originating data via the control plane ..................88
2.2.56 AT+CRTDCP reporting of terminating data via the control plane................90
2.2.57 ATD Request packet domain service ..........................................................91
2.3 3GPP Commands (27.005) ....................................................................................92
2.3.1 AT+CMGS send message ............................................................................92
2.3.2 AT+CSCA service center address ................................................................93
2.3.3 AT+CMGF message format ..........................................................................94
2.3.4 AT+CSMP set text mode parameters ...........................................................95
2.3.5 AT+CSMS select message service...............................................................96
2.3.6 AT+CPMS set preferred message storage ...................................................97
2.3.7 AT+CSDH show text mode parameters ........................................................99
2.3.8 AT+CNMI new message reporting configuration ........................................100
2.3.9 AT+CNMA New message Acknowledgement to UE/TE..............................102
2.3.10 +CMT new message received ..................................................................103
2.3.11 AT+CMGL list message ............................................................................103
2.3.12 AT+CMGR read message ........................................................................107
2.3.13 AT+CMGD delete message ...................................................................... 110
2.3.14 AT+CMGW write message to memory ..................................................... 111
2.3.15 AT+CMSS send message from storage ................................................... 112
2.3.16 AT+CMMS more message to send ........................................................... 114
2.3.17 AT+CSCB Select Cell Broadcast Message Types .................................... 115
3 Extended Commands ..................................................................................................... 116
3.1 EC General Commands ....................................................................................... 116
3.1.1 AT+ECBAND .............................................................................................. 116
3.1.2 AT+ECLOGDBVER .................................................................................... 117
3.1.3 AT+ECCFG.................................................................................................117
3.1.4 AT+ECPING ...............................................................................................123
3.1.5 AT+ECIPERF..............................................................................................125
3.1.6 AT+ECFREQ ..............................................................................................127
3.1.7 AT+ECRMFPLMN ......................................................................................129
3.1.8 AT+ECSENDDATA .....................................................................................130
3.1.9 +RECVNONIP ............................................................................................131
3.1.10 AT+ECPMUCFG.......................................................................................131
3.1.11 AT+ECSMSSEND.....................................................................................132
3.1.12 AT+ECCGSN............................................................................................134
3.1.13 AT+ECRST ...............................................................................................134
3.1.14 AT+ECPSMR............................................................................................135
3.1.15 AT+ECPLMNS ..........................................................................................136
3.1.16 AT+ECCESQS..........................................................................................137
3.1.17 AT+ECSTATUS.........................................................................................138
3.1.18 AT+ECICCID ............................................................................................142
3.1.19 AT+ECBCINFO.........................................................................................142
3.1.20 AT+ECDNS...............................................................................................146
3.1.21 AT+ECDNSCFG .......................................................................................147
3.1.22 AT+ECEMMTIME .....................................................................................148
3.1.23 AT+ECPCFG ............................................................................................149
3.1.24 AT+ECUSBSYS........................................................................................151
3.1.25 AT+ECSLEEP...........................................................................................152
3.1.26 AT+ECSIMCFG ........................................................................................153
3.1.27 AT+ECSIMSLEEP ....................................................................................155
3.1.28 AT+ECCGSNLOCK ..................................................................................156
3.1.29 AT+ECSAVEFAC ......................................................................................157
3.1.30 AT+ECTASKINFO ....................................................................................158
3.1.31 AT+ECTASKHISTINFO ............................................................................158
3.1.32 AT+ECSHOWMEM...................................................................................158
3.1.33 AT+ECSYSTEST ......................................................................................159
3.1.34 AT+ECVOTECHK .....................................................................................160
3.1.35 AT+ECURC ..............................................................................................161
3.1.36 AT+ECPTWEDRXS ..................................................................................163
3.1.37 +ECPIN ....................................................................................................165
3.1.38 +ECPCFUN ..............................................................................................166
3.1.39 +ECPADDR ..............................................................................................166
3.1.40 AT+ECADC...............................................................................................167
3.1.41 AT+ECSWC..............................................................................................168
3.1.42 AT+ECSNTP.............................................................................................169
3.1.43 AT+ECIPR ................................................................................................170
3.1.44 AT+ECNPICFG.........................................................................................171
3.1.45 AT+ECPRODMODE .................................................................................171
3.1.46 AT+ECPMUSTATUS.................................................................................172
3.1.47 AT+ECSTATIS ..........................................................................................173
3.1.48 AT+ECFSINFO .........................................................................................176
3.1.49 AT+ECFLASHMONITORINFO .................................................................177
3.1.50 AT+ECPURC ............................................................................................179
3.1.51 +SLPMODE..............................................................................................180
3.1.52 AT+ECEVENTSTATIS ..............................................................................180
3.1.53 AT+ECUSATP ..........................................................................................182
3.1.54 AT+ECPLMNRESELECT .........................................................................183
3.1.55 AT+NFWUPD ...........................................................................................184
3.1.56 AT+ECSIMRM ..........................................................................................185
3.1.57 AT+ECNETCFG .......................................................................................185
3.1.58 AT+ECNETDEVCTL .................................................................................187
3.1.59 AT+ECGDCNT .........................................................................................188
3.1.60 AT+ECAUGDCNT ....................................................................................189
3.1.61 AT+ECNASTCFG .....................................................................................191
3.1.62 AT+ECCMGS ...........................................................................................192
3.1.63 AT+ECCMGR ...........................................................................................193
3.1.64 AT+ECLEDMODE ....................................................................................196
3.1.65 AT+ECWIFISCAN.....................................................................................197
3.1.66 AT+ECPOWD ...........................................................................................199
3.1.67 AT+ECURCCFG .......................................................................................199
3.1.68 AT+RLCHK ...............................................................................................202
3.1.69 AT+ECSCLKEX ........................................................................................202
3.2 Socket Commands (solution A) ............................................................................204
3.2.1 AT+SKTCREATE ........................................................................................204
3.2.2 AT+SKTCONNECT ....................................................................................205
3.2.3 AT+SKTBIND..............................................................................................205
3.2.4 AT+SKTSEND ............................................................................................206
3.2.5 AT+SKTSENDT ..........................................................................................207
3.2.6 +SKTRECV ................................................................................................208
3.2.7 +SKTERR...................................................................................................209
3.2.8 AT+SKTSTATUS.........................................................................................209
3.2.9 AT+SKTDELETE ........................................................................................210
3.3 HTTP(S) Commands ............................................................................................210
3.3.1 AT+HTTPCFG Configure HTTP(S) related parameters..............................210
3.3.2 AT+HTTPURL Set HTTP URL ....................................................................212
3.3.3 AT+HTTPGET Send HTTP GET request to HTTP(S) server......................213
3.3.4 AT+HTTPGETEX Send range GET request to HTTP(S) server ................214
3.3.5 AT+HTTPPOST Send POST request to HTTP(S) Server..........................215
3.3.6 AT+HTTPPOSTFILE send POST request in file.........................................217
3.3.7 AT+HTTPREAD read the response of HTTP(S) server from UART/USB ...218
3.3.8 AT+HTTPREADFILE Read HTTP(S) server response to file......................218
3.3.9 AT+HTTPSTOP cancel HTTP request........................................................219
3.3.10 AT+HTTPFOTADL firmware upgrade via HTTP(S) server........................220
3.3.11 Summary of <err> Codes .........................................................................221
3.3.12 HTTP(S) response code...........................................................................221
3.4 SSL Commands ...................................................................................................222
3.4.1 AT+SSLCFG Configure SSL related parameters........................................222
3.4.2 AT+SSLOPEN Connect to the remote server and handshake ...................225
3.4.3 AT+SSLSEND send data............................................................................226
3.4.4 AT+SSLCLOSE Close the SSL connection................................................227
3.4.5 AT+SSLSTATE Query the status of the socket connection.........................227
3.4.6 +SSLURC: "recv" the received data ...........................................................228
3.4.7 +SSLURC: "closed" notify disconnect ........................................................229
3.4.8 Summary of <err> Codes ...........................................................................229
3.5 MQTT Commands ................................................................................................229
3.5.1 AT+ECMTCFG ...........................................................................................229
3.5.2 AT+ECMTOPEN .........................................................................................233
3.5.3 AT+ECMTCLOSE .......................................................................................234
3.5.4 AT+ECMTCONN ........................................................................................235
3.5.5 AT+ECMTDISC ..........................................................................................236
3.5.6 AT+ECMTSUB............................................................................................236
3.5.7 AT+ECMTUNS ...........................................................................................237
3.5.8 AT+ECMTPUB............................................................................................238
3.5.9 +ECMTSTAT ..............................................................................................239
3.5.10 +ECMTRECV ...........................................................................................240
3.6 Socket Command(solution B) ...............................................................................240
3.6.1 AT+ECSOCR..............................................................................................240
3.6.2 AT+ECSOST ..............................................................................................242
3.6.3 AT+ECSOSTT ............................................................................................243
3.6.4 AT+ECSOSTF ............................................................................................245
3.6.5 AT+ECSOSTFT ..........................................................................................247
3.6.6 AT+ECQSOS..............................................................................................249
3.6.7 AT+ECSORF ..............................................................................................249
3.6.8 AT+ECSOCO..............................................................................................250
3.6.9 AT+ECSOSD ..............................................................................................251
3.6.10 AT+ECSOSDT..........................................................................................253
3.6.11 AT+ECSOCL.............................................................................................254
3.6.12 AT+ECSONMI ..........................................................................................255
3.6.13 AT+ECSONMIE ........................................................................................256
3.6.14 +ECSOCLI ...............................................................................................258
3.6.15 +ECSOSTR ..............................................................................................259
3.6.16 +ECSOCO................................................................................................259
3.6.17 Error code for socket command(solution B) .............................................260
3.7 Socket Command(TCP Server Mode) ..................................................................260
3.7.1 AT+ECSRVSOCRTCP ...............................................................................260
3.7.2 AT+ECSRVSOCLTCPLISTEN....................................................................262
3.7.3 AT+ECSRVSOCLTCPCLIENT ...................................................................262
3.7.4 AT+ECSRVSOTCPSENDCLT ....................................................................263
3.7.5 AT+ECSRVSOTCPSENDCLTT ..................................................................264
3.7.6 AT+ECSRVSOTCPLISTENSTATUS ..........................................................266
3.7.7 +ECACCEPTTCPCLIENTSOCKET ...........................................................266
3.7.8 +ECSRVSOTCPCLTRCV...........................................................................267
3.7.9 +ECSRVSOCCLIENTCPCLOSE ...............................................................268
3.8 FILE Commands...................................................................................................269
3.8.1 AT+FOPEN.................................................................................................269
3.8.2 AT+FREAD .................................................................................................270
3.8.3 AT+FWRITE ...............................................................................................271
3.8.4 AT+FSEEK .................................................................................................272
3.8.5 AT+FPOSITION ..........................................................................................273
3.8.6 AT+FTUCAT ...............................................................................................273
3.8.7 AT+FERASE...............................................................................................274
3.8.8 AT+FRENAME............................................................................................275
3.8.9 AT+FCLOSE...............................................................................................275
3.8.10 AT+FDELETE ...........................................................................................276
4 Error Values ....................................................................................................................277
Annex AChange history..................................................................................................280
1 Introduction
1.1 Definitions
For the purposes of the present document, the following syntactical definitions apply
<CR> Carriage return character.
<LF> Linefeed character.
<...> Name enclosed in angle brackets is a syntactical element. Brackets themselves 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. When
subparameter is not given in parameter type commands, new value equals to its previous value. In
action type commands, action should be done on the basis of the recommended default setting of
the subparameter.
NO_SAVE The parameter of the current AT command will be lost, if module is rebooted or current
AT command doesn't have parameter
AUTO_SAVE The parameter of the current AT command will be kept in NVRAM automatically
and take in effect immediately, and it won't be lost if module is reboot
AUTO_SAVE_REBOOT The parameter of the current AT command will be kept in NVRAM
automatically and take in effect after reboot, and it won't be lost if module is reboot
- `-' means this AT command doesn't care the parameter saving mode
1.2 AT command syntax
1.2.1 AT command type
Type Format Description
Test Command AT+<cmd>=? Check possible sub-parameter values
Read Command AT+<cmd>? Check current sub-parameter values
Set Command AT+<cmd>=p1[,p2[,p3[...]]] Set command
Execution Command AT+<cmd> Execution command
Eigencomm use AT+EC<cmd> to implement self-extended command.
1.2.2 Command line
See figure 1 for general structure of a command line. Standardized basic commands are found only in
ITU-T Recommendation V.250 [14]. The commands in this specification use syntax rules of extended
commands. Every extended command has a test command (trailing =?) to test the existence of the
command and to give information about the type of its subparameters. Parameter type commands also
have a read command (trailing ?) to check the current values of subparameters. Action type commands
do not store the values of any of their possible subparameters, and therefore do not have a read
command.
subparameter read command for checking
current subparameter values
command line prefix extended commands are command line
delimited with semicolon termination character
ATCMD1 CMD2=12; +CMD1; +CMD2=,,15; +CMD2?; +CMD2=?<CR>
basic command subparameters
(no + prefix) may be omitted
extended command test command for checking
(prefixed with +) possible subparameter values
Figure 1: Basic structure of a command line
If all commands in a command line has been performed successfully, result code
<CR><LF>OK<CR><LF> is sent from the TA to the TE.
If subparameter values of a command are not accepted by the TA (or command itself is invalid, or
command cannot be performed for some reason), result code <CR><LF>ERROR<CR><LF> is sent to the
TE and no subsequent commands in the command line are processed. ERROR response may be
replaced by +CME ERROR: <err> (refer clause 4) when command was not processed due to an error
related to MT operation.
1.3 3GPP compliance
Basic commands are compiled with ITU-T V.250(07/2003)
3GPP commands are complied with the 3GPP TS 27.007 V16.0.0 (2019-03) and 3GPP TS 27.005 V15.0.0
(2018-06).
2 General Control Commands
2.1 Basic CommandsITU-T V.250
2.1.1 ATE Command echo
The setting of this parameter determines whether or not the DCE echoes characters received from the
DTE during command state and online command state.
ATE Response
OK
Set Command If there is any error, response:
ATE<value> +CME ERROR: <err>
5s
Maximum Response Time NO_SAVE
Parameter Saving Mode Note: AT&W will save <value> to NVM.
Parameter INTEGER TYPE
<VALUE>
0 DCE does not echo characters during command state and online
command state
1 DCE echoes characters during command state and online command state
The default value is 1
Example
ATE0
OK
2.1.2 ATQ Result code suppression
The setting of this parameter determines whether or not the DCE transmits unsolicited result codes to
the DTE. When result codes are being suppressed, unsolicited result is not transmitted.
NOTE: currently, this command is not fully implemented as defined in ITU-T V.250.
ATQ Response
OK
Set Command
ATQ<value>
Maximum Response Time If there is any error, response:
Parameter Saving Mode +CME ERROR: <err>
5s
NO_SAVE
Note: AT&W will save <value> to NVM.
Parameter INTEGER TYPE
<VALUE>
0 DCE transmits unsolicited result codes
1 Unsolicited result codes are suppressed and not transmitted.
Note:
a) If set to "1", all unsolicited result codes are all suppressed, including:
PING/IPERF/LWM2M unsolicited result codes;
b) If set to "1", only suppress the unsolicited result codes; And AT
response/result codes are not suppressed;
The default value is 0
Example
ATQ0
OK
2.1.3 AT&F Set parameters to factory-defined configuration
This command set parameters to default values specified by the manufacturer.
AT&F Response
OK
Execution Command If there is any error, response:
AT&F[<value>] +CME ERROR: <err>
5s
Maximum Response Time AUTO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE
<VALUE>
0 Set parameters to factory defaults.
The following AT commands will be set to factory-defined default value.
AT command Parameters Factory-defined defaults
AT&C <value> 0
AT&D <value> 2
ATE <value> 1
ATQ <value> 0
AT+CREG
AT+CEREG <n> 0
AT+CEDRX
AT+CCIOTOPT <n> 0
AT+CMGF
AT+CSCON <mode> 0
AT+CMEE
AT+CTZR <n> 0
AT+CTZU
AT+ECCESQ <mode> 1
AT+ECPSMR
AT+ECEMMTIME <n> 0
AT+ECPTWEDRXS
AT+ECURC <n> 1
AT+ECLEDMODE
AT+ECPURC <reporting> 0
AT+CSMS
AT+CSDH <onoff> 1
Example <report level> 0
AT&F <n> 0
OK
<bitmap> 0
<mode> 0
<value> 0
<state> 0
<value> 0
<service> 0
<show> 0
2.1.4 AT&W Store parameters to user-defined configuration
This command store parameters to the user-defined configuration profile in non-volatile memory.
AT&W Response
OK
Execution Command If there is any error, response:
AT&W[<value>] +CME ERROR: <err>
5s
Maximum Response Time AUTO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE
<VALUE>
0 User-defined configuration profile ID.
The following AT commands will be set to user-defined configuration profile in non-volatile memory.
AT command Parameters Display with AT&V
AT&C <value> Y
AT&D <value> Y
ATE <value> Y
ATQ <value> Y
AT+CREG <n> N
AT+CEREG <n> N
AT+CEDRX <mode> N
AT+CCIOTOPT <n> N
AT+CMGF <mode> N
AT+CSCON <n> N
AT+CMEE <n> N
AT+CTZR <reporting> N
AT+CTZU <onoff> N
AT+ECCESQ <report level> N
AT+ECPSMR <n> N
AT+ECEMMTIME <bitmap> N
AT+ECPTWEDRXS <mode> N
AT+ECURC <value> N
AT+ECLEDMODE <state> N
AT+ECPURC <value> N
AT+CSMS <service> N
AT+CSDH <show> N
Example
AT&W
OK
2.1.5 AT&V Display current configuration parameters
This command displays the current settings of some basic command parameters.
AT&V Response
&C: <value>
Execution Command &D: <value>
AT&V &F: <value>
&W: <value>
E: <value>
Q: <value>
Maximum Response Time OK
Parameter Saving Mode If there is any error, response:
+CME ERROR: <err>
Example 5s
NO_SAVE
AT&V
&C: 0
&D: 2
&F: 0
&W: 0
E: 1
Q: 0
OK
2.1.6 ATO Return to online data state from online command state
This command causes the DCE to return to online data state and issue a CONNECT result code.
ATO Response
If connection is successfully resume:
Set Command CONNECT
ATO[<value>]
If connection is not successfully resume:
NO CARRIER
Maximum Response Time If there is any error, response:
Parameter Saving Mode +CME ERROR: <err>
5s
NO_SAVE
Parameter INTEGER TYPE
<VALUE>
0 Return to online data state from online command state;
Example
ATO0
CONNECT
ATO
CONNECT
2.1.7 ATH Disconnect from the line and terminate call
This command instructs the DCE to disconnect from the line and terminate any call in progress.
ATH Response
OK
Set Command
ATH[<value>]
Maximum Response Time If there is any error, response:
Parameter Saving Mode +CME ERROR: <err>
5s
NO_SAVE
Parameter INTEGER TYPE
<VALUE>
0 Disconect from the line and terminate call;
Example
ATH0
OK
ATH
OK
2.1.8 AT&C Set DCD Function Mode
This command controls the Circuit 109 behavior of UE's DCD (data carrier detection) line.
AT&C Response
OK
Set Command
AT&C[<value>]
Maximum Response Time If there is any error, response:
Parameter Saving Mode +CME ERROR: <err>
5s
NO_SAVE
Note: AT&W will save <value> to NVM.
Parameter INTEGER TYPE
<VALUE>
0 DCD function is always ON; The default value is 0.
1 DCD function is ON only in the presence of data carrier;
Example
AT&C1
OK
2.1.9 AT&D Set DTR Function Mode
This command determines how the UE responds when circuit 108/2 (DTR) is changed from ON to the OFF
condition during online data state.
AT&D Response
OK
Set Command
AT&D[<value>]
Maximum Response Time If there is any error, response:
Parameter Saving Mode +CME ERROR: <err>
5s
NO_SAVE
Note: AT&W will save <value> to NVM.
Parameter INTEGER TYPE
<VALUE>
0 Ignore DTR;
1 ON->OFF on DTR: Enter online command state while the call remains
connected;
2 ON->OFF on DTR: Disconnect the call, and change to command mode;
The default value is 2.
Example
AT&D2
OK
2.2 3GPP Commands (27.007)
2.2.1 AT+CFUN set phone functionality
Set command selects the level of functionality in the MT. Level "full functionality" is where the highest
level of power is drawn. "Minimum functionality" is where minimum power is drawn.
Read command returns the current setting of <fun>.
Test command returns values supported by the MT as compound values.
AT+CFUN Response
OK
Set Command If there is any error, response:
AT+CFUN=<fun>[,<rst>] +CME ERROR: <err>
Response
Read Command +CFUN: <fun>
AT+CFUN? OK
Response
Test Command +CFUN: (list of supported <fun>s),(list of
AT+CFUN=? supported <rst>s)
OK
Maximum Response Time 25s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
<FUN> 0 Minimum functionality
<RST> 1 Full functionality
4 Turn off RF
Integer type
0 Do not reset the MT before setting it to <fun> power level. This shall
always be defaulted when <rst> is not given.
1 Reset the MT. <fun> will be ignored currently. MT is "Full functionality"
after reset.
Example
AT+CFUN=?
+CFUN:(0,1,4),(0,1)
OK
AT+CFUN?
+CFUN:1
OK
AT+CFUN=1
OK
2.2.2 AT+CGSN request product serial number
The execution command returns the IMEI (International Mobile Station Equipment Identity) number and
related information.
Test command returns values supported as a compound value.
AT+CGSN Response
When <snt>=0 and command successful:
Set Command +CGSN: <sn>
AT+CGSN=<snt> OK
When <snt>=1 and command successful:
Execution Command +CGSN: <imei>
AT+CGSN OK
When <snt>=2 and command successful:
+CGSN: <imeisv>
OK
When <snt>=3 and command successful:
+CGSN: <svn>
OK
If there is any error, response:
+CME ERROR: <err>
Response
<sn>
OK
Test Command If there is any error, response:
AT+CGSN=? ERROR
or
Maximum Response Time +CME ERROR: <err>
Response
+CGSN: (list of supported <snt>s)
OK
5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE; INDICATING THE SERIAL NUMBER TYPE THAT HAS BEEN
<SNT> REQUESTED
<SN> 0 Return <sn>
<IMEI>
<IMEISV> 1 Returns the IMEI(International Mobile station Equipment Identity)
<SVN>
2 Returns the IMEISV(International Mobile station Equipment Identity and Software
Version number)
3 Returns the SVN(Software Version Number)
One or more lines of information text determined by the MT manufacturer (not support
now)
String type; in decimal format indicating the IMEI
String type; in decimal format indicating the IMEISV
String type; in decimal format indicating the current SVN which is a part of IMEISV
Example
AT+CGSN=1
+CGSN: "788596633100008"
OK
AT+CGSN=2
+CGSN: "7885966331000001"
OK
AT+CGSN=3
+CGSN: "01"
OK
AT+CGSN=?
+CGSN: (0,1,2,3)
OK
2.2.3 AT+CGMR request manufacturer revision
The execution command returns the manufacturer revision. Now it returns the firmware revision and
build time.
AT+CGMR Response
Execution Command
AT+CGMR +CGMR: <"Board Version&&SDK
Version&&EVB Version&&Compiled
Test Command Time">
AT+CGMR=? Response
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Example
AT+CGMR
+CGMR:
-- Board: EC618_EVK --
-- SDK Version: EC618_SW_V001.000.xxx --
-- EVB Version: EC618_HW_V1.0 --
-- Compiled: Dec 2 2021 13:49:27 --
OK
AT+CGMR=?
OK
2.2.4 AT+CMEE report mobile termination error
The write command disables or enables the use of final 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.
The read command returns the current setting of <n>.
The test command returns values supported as a compound value.
AT+CMEE Response
OK
Set Command Response
AT+CMEE=<n> +CMEE: <n>
Read Command OK
AT+CMEE? Response
+CMEE: (list of supported <n>s)
Test Command OK
AT+CMEE=? 5s
Maximum Response Time
Parameter Saving Mode NO_SAVE
Note: AT&W will save <n> to NVM.
Parameter INTEGER TYPE
<MODE>
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
Example
AT+CMEE=?
+CMEE: (0-2)
OK
AT+CMEE?
+CMEE: 1
OK
AT+CMEE=2
OK
2.2.5 AT+COPS PLMN selection
The set command forces an attempt to select and register the network operator using the USIM card
installed in the currently selected card slot. <mode> is used to select whether the selection is done
automatically by the MT or is forced by this command to operator <oper> (it shall be given in format
<format>) to a certain access technology, indicated in <AcT>. If the selected operator is not available, no
other operator shall be selected (except <mode>=4). If the selected access technology is not available,
then the same operator shall be selected in other access technology. The selected operator name format
shall also apply to further read commands (AT+COPS?). <mode>=2 forces an attempt to deregister from
the network. The selected mode affects all further network registration (e.g. after <mode>=2, MT shall be
unregistered until <mode>=0 or 1 is selected). This command should be abortable when
registration/deregistration attempt is made.
The read command returns the current mode, the currently selected operator and the current access
technology. If no operator is selected, <format>, <oper> and <AcT> are omitted.
The test command returns a set of five parameters, each representing an operator present in the
network. A set consists of an integer indicating the availability of the operator <stat>, long and short
alphanumeric format of the operator's name, numeric format representation of the operator and access
technology. Any of the formats may be unavailable and should then be an empty field. The list of
operators shall be in order: home network, networks referenced in USIM or active application in the
UICC (GSM or USIM) in the following order: HPLMN selector, user controlled PLMN selector, operator
controlled PLMN selector and PLMN selector (in the USIM or GSM application), and other networks.
After the operator list MT returns lists of supported <mode>s and <format>s. These lists shall be
delimited from the operator list by two commas.
AT+COPS Response
OK
Set Command If there is any error, response:
AT+COPS=<mode>[,<format>[,<oper>[,<AcT>]] +CME ERROR: <err>
] Response
Read Command +COPS:
AT+COPS? <mode>[,<format>,<oper>][,<AcT>
]
Test Command OK
AT+COPS=? If there is any error, response:
+CME ERROR: <err>
Maximum Response Time Response
Parameter Saving Mode +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)
OK
If there is any error, response:
+CME ERROR: <err>
305s
AUTO_SAVE
Note: Set <mode> to 0,1,4 will save to
NVM
Parameter INTEGER TYPE
<MODE>
0 Automatic(<oper> field is ignored)
1 Manual(<oper> field shall be present, and <AcT> is optional)
Note: <format> set to 2 is only supported in this case;
2 Deregister from network
3 Set only <format> (for read command AT+COPS?), do not attempt to
register/deregister (<oper> and <AcT> fields are ignored);
4 Manual/automatic (<oper> field shall be present); if manual selection fails,
automatic mode (<mode>=0) is entered;
Note: <format> set to 2 is only supported in this case;
<FORMAT> Integer type
<OPER>
<STAT> 0 Long format alphanumeric <oper>
<ACT>
1 Short format alphanumeric <oper>
2 Numeric <oper>
String type
<format> indicates if the format is alphanumeric or numeric; long alphanumeric format
can be up to 16 characters long and short format up to 8 characters; numeric format is
the GSM location area identification number which consists of a three BCD digit ITU-T
country code coded, plus a two or three BCD digit network code, which is administration
specific.
Integer type
0 Unknown
1 Available
2 Current
3 Forbidden
Integer type; access technology selected
7 E-UTRAN
Example
AT+COPS=1,2,"46000"
OK
AT+COPS?
+COPS: 0,2,"46000",7
OK
AT+COPS=?
+COPS: (2,"CHINA MOBILE","CMCC","46000",7), (3,"CHN-UNICOMM","UNICOM","46001",7), (0,"CHN-
CT","CT","46011",7),,(0-4),(0-2)
OK
2.2.6 AT+CREG network registration
Set command controls the presentation of an unsolicited result code +CREG: <stat> when <n>=1 and
there is a change in the MT's circuit mode network registration status in GERAN/UTRAN/E-UTRAN, or
unsolicited result code +CREG: <stat>[,[<lac>],[<ci>],[<AcT>]] when <n>=2 and there is a
change of the network cell in GERAN/UTRAN/E-UTRAN. The parameters <AcT>, <lac> and <ci> are
sent only if available. The value <n>=3 further extends the unsolicited result code with
[,<cause_type>,<reject_cause>], when available, when the value of <stat> changes.
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>, <ci> and <AcT>, if available, are returned only when <n>=2 and MT is registered in the
network. The parameters [,<cause_type>,<reject_cause>], if available, are returned when
<n>=3.
Test command returns values supported as a compound value.
AT+CREG Response
OK
Set Command If there is any error, response:
AT+CREG=[<n>] +CME ERROR: <err>
Response
Read Command +CREG: <n>,<stat>
AT+CREG? [,[<tac>],[<ci>],[<AcT>][,<cause_type>,<reject_cause>]]
OK
Test Command Response
AT+CREG=? +CREG:(list of supported <n>s)
OK
Maximum Response 5s
Time
Parameter Saving Mode NO_SAVE
Note: AT&W will save <n> to NVM.
Parameter INTEGER TYPE
<N> 0 Disable network registration unsolicited result code
<STAT> 1 Enable network registration unsolicited result code
+CREG: <stat>
2 Enable network registration and location information unsolicited
result code +CREG: <stat>[,[<lac>],[<ci>],[<AcT>]
3 Enable network registration, location information and cause value
information unsolicited result code
+CREG: <stat>[,[<lac>],[<ci>],[<AcT>]
[,<cause_type>,<reject_cause>]]
Integer type
0 not registered, MT is not currently searching a new operator to
register to
1 registered, home network (not applicable)
2 not registered, but MT is currently searching a new operator to
register to
3 registration denied
4 unknown (e.g. out of GERAN/UTRAN/E-UTRAN coverage)
5 registered, roaming (not applicable)
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)
8 attached for emergency bearer services only (not applicable)
9 registered for "CSFB not preferred", home network (not applicable)
10 registered for "CSFB not preferred", roaming (not applicable)
<TAC> String type
<CI>
<ACT> two byte tracking area code
<CAUSE_TYPE>
String type
<REJECT_CAUSE>
Four byte cell ID in hexadecimal format
Integer type; access technology of the serving cell
7 E-UTRAN
Integer type; indicates the type of <reject_cause>
0 Indicates that <reject_cause> contains an MM cause value, see
3GPP TS 24.008 [8] Annex G.
1 Indicates that <reject_cause> contains a manufacturer specific
cause.
Integer type; contains the cause of the failed registration. The value is of type as
defined by <cause_type>.
Example
AT+CREG?
+CREG: 3,0
OK
2.2.7 AT+CEREG EPS network registration status
The set command controls the presentation of an unsolicited result code +CEREG: <n>,<stat> when
<n>=1 and there is a change in the MT's EPS network registration status in E-UTRAN, or unsolicited
result code +CEREG: <n>,<stat>[,[<tac>],[<ci>],[<AcT>]] when <n>=2 and there is a
change of the network cell in EUTRAN. The parameters <AcT>,<tac> and <ci> are provided only if
available. The value <n>=3 further extends the unsolicited result code with
[,<cause_type>,<reject_cause>], when available, when the value of <stat> changes.
If the UE requests PSM for reducing its power consumption, the set command controls the presentation
of an unsolicited result code: +CEREG:
<n>,<stat>[,[<tac>],[<ci>],[<AcT>][,[<cause_type>],[<reject_cause>][,[<Active
-Time>],[<Periodic-TAU>]]]]. When <n>=4, the unsolicited result code will provide the UE with
additional information for the active time value and the extended periodic TAU value if there is a change
of the network cell in E-UTRAN. The value <n>=5 further enhances the unsolicited result code with
<cause_type> and <reject_cause> when the value of <stat> changes. The parameters <AcT>,
<tac>,<ci>,<cause_type>,<reject_cause>,<Active-Time> and <Periodic-TAU> are
provided only if available.
The 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
<tac>, <ci> and <AcT>, if available, are returned only when <n>=2 and MT is registered in the
network. The parameters [,<cause_type>,<reject_cause>], if available, are returned when
<n>=3.
Test command returns values supported as a compound value.
AT+CEREG Response
OK
Set Command If there is any error, response:
AT+CEREG=<n> +CME ERROR: <err>
When <n>=0,1,2 or 3 and command successful:
Read Command +CEREG: <n>,<stat>[,[<tac>],[<ci>],[<AcT>
AT+CEREG? [,<cause_type>,<reject_cause>]]]
OK
Test Command When <n>=4 or 5 and command successful:
AT+CEREG=? +CEREG: <n>,<stat>[,[<tac>],[<ci>],[<AcT>],
Maximum Response Time [<cause_type>,<reject_cause>[,[<Active_Time>],[<P
Parameter Saving Mode eriodic_TAU>]]]]
OK
If there is any error, response:
+CME ERROR: <err>
Response
+CEREG: (list of supported <n>s)
OK
5s
NO_SAVE
Note: AT&W will save <n> to NVM.
Parameter INTEGER TYPE;
<N> 0 disable network registration unsolicited result code
1 enable network registration unsolicited result code +CEREG: <stat>
2 enable network registration and location information unsolicited result code
+CEREG: <stat>[,[<tac>],[<ci>],[<AcT>]]
3 enable network registration, location information and EMM cause value
<STAT> information unsolicited result code
+CEREG:
<TAC> <stat>[,[<tac>],[<ci>],[<AcT>][,<cause_type>,<reject_cause
<CI> >]]
<ACT> 4 For a UE that wants to apply PSM, enable network registration and location
information unsolicited result code
<CAUSE_TYPE +CEREG: <stat>[,[<tac>],[<ci>],[<AcT>][,,[,[<Active-
> Time>],[<Periodic-TAU>]]]]
5 For a UE that wants to apply PSM, enable network registration, location
information and EMM cause value information unsolicited result code
+CEREG:
<stat>[,[<tac>],[<ci>],[<AcT>][,[<cause_type>],[<reject_ca
use>][,[<Active-Time>],[<Periodic-TAU>]]]]
Integer type; indicates the EPS registration status
0 Not registered, MT is not currently searching an operator to register to
1 Registered, home network
2 Not registered, but MT is currently trying to attach or searching an operator to
register to
3 Registration denied
4 Unknown (e.g. out of E-UTRAN coverage)
5 Registered, roaming
6 Registered for "SMS only", home network (not applicable)
7 Registered for "SMS only", roaming (not applicable)
8 Attached for emergency bearer services only (not applicable)
9 Registered for "CSFB not preferred", home network (not applicable)
10 Registered for "CSFB not preferred", roaming (not applicable)
String type; two bytes tracking area code in hexadecimal format (e.g. "00C3" equals
195 in decimal)
String type; four bytes E-UTRAN cell ID in hexadecimal format
Integer type; indicates the access technology of the serving cell
0 GSM (not applicable)
1 GSM Compact (not applicable)
2 UTRAN (not applicable)
3 GSM w/EGPRS (not applicable)
4 UTRAN w/HSDPA (not applicable)
5 UTRAN w/HSUPA (not applicable)
6 UTRAN w/HSDPA and HSUPA (not applicable)
7 E-UTRAN
8 EC-GSM-IoT (A/Gb mode) (not applicable)
9 E-UTRAN (NB-S1 mode)
Integer type; indicates the type of <reject_cause>
0 Indicates that <reject_cause> contains an EMM cause value
1 Indicates that <reject_cause> contains a manufacturer-specific cause value
<REJECT_CAU Integer type; contains the cause of the failed registration. The value is of type as
SE> defined by <cause_type>.
<ACTIVE_TIM String type; one byte in an 8-bit format. Requested Active Time value (T3324) to be
E> allocated to the UE. (e.g. "00100100" equals 4 minutes).
Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 defines the timer value
<PERIODIC_T unit for the GPRS timer
AU> String type; one byte in an 8-bit format. Requested extended periodic TAU value
(T3412) to be allocated to the UE in E-UTRAN. (e.g. "01000111" equals 70 hours).
Bits 5 to 1 represent the binary coded timer value
Bits 6 to 8 define the timer value unit
Example
AT+CEREG=5
OK
AT+CEREG?
+CEREG: 5,1,"5b49","0190271a",7
OK
AT+CEREG=?
+CEREG: (0,1,2,3,4,5)
OK
2.2.8 AT+CSQ get signal quality
The execution command returns received signal quality <rssi> and channel bit error rate <ber> from
the MT. Please refer to Chapter 4 for possible <err> values.
The test command returns values supported as compound values.
AT+CSQ Response
+CSQ: <rssi>,<ber>
Execution Command
AT+CSQ
Test Command OK
AT+CSQ=? If there is any error, response:
+CME ERROR: <err>
Maximum Response Time Response
+CSQ: (list of supported <rssi>s),(list of
supported <ber>s)
OK
5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
<RSSI> 0 -113dBm or less
<BER> 1 -111dBm
2...30 -109...-53 dBm
31 -51 dBm or greater
99 not known or not detectable
Integer type
0...7 as RXQUAL values in the table in 3GPP TS 45.008 [20] subclause 8.2.4
99 not known or not detectable
Note: the AT also could be executed while USIM is not inserted.
Example
AT+CSQ
+CSQ: 27,0
OK
2.2.9 AT+CESQ get extended signal quality
The execution command returns received signal quality parameters. Since it only supports Cat.1,
<rxlev> and <ber> are set to value 99, <rscp> and <ecno> is set to 255.
Description in 8.69 of spec 27.007:
If the current serving cell is not a GERAN cell, <rxlev> and <ber> are set to value 99.
If the current serving cell is not a UTRA FDD or UTRA TDD cell, <rscp> is set to 255.
If the current serving cell is not a UTRA FDD cell, <ecno> is set to 255.
The test command returns values supported as compound values.
AT+CESQ Response
+CESQ:
Execution Command <rxlev>,<ber>,<rscp>,<ecno>,<rsrq>,<rsrp>
AT+CESQ OK
If there is any error, response:
Test Command +CME ERROR: <err>
AT+CESQ=? Response
+CESQ: (list of supported <rxlev>s),(list of supported
Maximum Response Time <ber>s, list of supported <rscp>s),(list of supported
Parameter Saving Mode <ecno>s, list of supported <rsrq>s),(list of supported
<rsrp>s)
OK
5s
NO_SAVE
Parameter
<RXLEV> INTEGER TYPE; NOT SUPPORTED BY CAT.1
99 not known or not detectable
<BER> Integer type; not supported by Cat.1
99 not known or not detectable
<RSCP> Integer type; not supported by Cat.1
255 not known or not detectable
<ECNO> Integer type; not supported by Cat.1
255 not known or not detectable
<RSRQ> Integer type
0 rsrq<-19.5dB
1 -19.5dB<=rsrq<-19dB
2 -19dB<=rsrq<-18.5dB
: : : :
32 -4dB<=rsrq<-3.5dB
33 -3.5dB<=-3 dB
34 -3 dB <=rsrq
255 not known or not detectable
<RSRP> Integer type
0 rsrp<-149dBm
1 -140dBm<=rsrp<-139dBm
2 -139dBm<=rsrp<-138dBm
: : : :
95 -46dBm<=rsrp<-45dBm
96 -45dBm<=rsrp<-44dBm
97 -44dBm<=rsrp
255 not known or not detectable
Note: the AT also could be executed while USIM is not inserted.
Example
AT+CESQ
+CESQ: 99,99,255,255,26,56
OK
AT+CESQ=?
+CESQ: (99),(99),(255),(255),(0-34,255),(0-97,255)
OK
2.2.10 AT+CPSMS power saving mode setting
The set command controls the setting of the UE's power saving mode (PSM) parameters. The command
controls whether the UE wants to apply PSM or not. Please refer to the unsolicited result codes provided
by AT+CEREG for the active time value and the extended periodic TAU value that are allocated to the UE
by the network in E-UTRAN.
A special form of the command can be given as AT+CPSMS=2. In this form, the use of PSM will be disabled
and data for all parameters in the command +CPSMS will be removed.
The read command returns the current parameter values.
The test command returns the supported <mode>s and the value ranges for the requested extended
periodic TAU value in E-UTRAN and the requested Active Time value as compound values.
AT+CPSMS Response
OK
Set Command If there is any error, response:
AT+CPSMS=<mode>[,<Requested_Periodic- +CME ERROR: <err>
RAU>[,<Requested_GPRS-READY-
timer>[,<Requested_Periodic- Response
TAU>[,<Requested_Active-Time>]]]] +CPSMS:
Read Command <mode>,[<Requested_Periodic-
AT+CPSMS? RAU>],[<Requested_GPRS-READY-
timer>],[<Requested_Periodic-
Test Command TAU>],[<Requested_Active-Time>]
AT+CPSMS=? Response
+CPSMS: (list of supported <mode>s),(list of
Maximum Response Time supported <Requested_Periodic-RAU>s,
Parameter Saving Mode list of supported <Requested_GPRS-READY-
timer>s),(list of supported
<Requested_Periodic-TAU>s, list of
supported <Requested_Active-Time>s)
OK
5s
AUTO_SAVE
Parameter INTEGER TYPE; INDICATES TO DISABLE OR ENABLE THE
<MODE>
USE OF PSM IN THE UE
0 Disable the use of PSM
1 Enable the use of PSM
2 Disable the use of PSM and discard all parameters for
PSM
<REQUESTED_PERIODIC-RAU> String type; not supported by Cat.1
<REQUESTED_GPRS-READY-TIMER>
<REQUESTED_PERIODIC-TAU> String type; not supported by Cat.1
<REQUESTED_ACTIVE-TIME> String type; one byte in an 8-bit format. Requested extended
periodic TAU value (T3412) to be allocated to the UE in E-
UTRAN. (e.g. "01000111" equals 70 hours).
Bits 5 to 1 represent the binary coded timer value
Bits 6 to 8 define the timer value unit as follows:
Bits
876
0 0 0 Value is incremented in multiples of 10 minutes
0 0 1 Value is incremented in multiples of 1 hour
0 1 0 Value is incremented in multiples of 10 hours
0 1 1 Value is incremented in multiples of 2 seconds
1 0 0 Value is incremented in multiples of 30 seconds
1 0 1 Value is incremented in multiples of 1 minute
1 1 0 Value is incremented in multiples of 320 hours
1 1 1 Value indicates that the timer is deactivated
The default value is 20 hours
String type; one byte in an 8-bit format. Requested Active Time
value (T3324) to be allocated to the UE.
(e.g. "00100100" equals 4 minutes).
Bits 5 to 1 represent the binary coded timer value.
Bits 6 to 8 defines the timer value unit for the GPRS timer as
follows:
Bits
876
0 0 0 Value is incremented in multiples of 2 seconds
0 0 1 Value is incremented in multiples of 1 minute
0 1 0 Value is incremented in multiples of decihours
1 1 1 Value indicates that the timer is deactivated
The default value is 5 minutes
Example
AT+CPSMS=1,,,,"00100010"
OK
AT+CPSMS?
+CPSMS: 1,,,,"00100010"
OK
AT+CPSMS=?
+CPSMS: (0-2),,,("00000000"-"11111111"),("00000000"-"11111111")
OK
2.2.11 AT+CEDRXS eDRX setting
The set command controls the setting of the UE's eDRX parameters. It can be used to control whether
the UE wants to apply eDRX or not, as well as the requested eDRX value for Cat.1.
A special form of the command can be given as AT+CEDRXS=3. In this form, eDRX will be disabled and
data for all parameters in AT+CEDRXS command will be removed.
The set command also controls the presentation of an unsolicited result code +CEDRXP:
<AcTtype>[,<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.
The read command returns the current settings for each defined value of <AcT-type>.
The test command returns the supported <mode>s and the value ranges for the access technology and
the requested eDRX value as compound values.
AT+CEDRXS Response
OK
Set Command If there is any error, response:
AT+CEDRXS=<mode>,<AcT- +CME ERROR: <err>
type>[,<Requested_eDRX_value>] Response
+CEDRXS: <AcT-
Read Command type>,<Requested_eDRX_value>
AT+CEDRXS? OK
Response
Test Command +CEDRXS: (list of supported <mode>s),(list of
AT+CEDRXS=? supported <AcT-type>s),(list of supported
<Requested_eDRX_value>s)
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Note: AT&W will save <mode> to NVM
Parameter INTEGER TYPE; INDICATES TO DISABLE OR ENABLE THE USE OF
EDRX IN THE UE. THIS PARAMETER IS APPLICABLE TO ALL
<MODE> SPECIFIED TYPES OF ACCESS TECHNOLOGY, I.E. THE MOST
RECENT SETTING OF <MODE> WILL TAKE EFFECT FOR ALL
SPECIFIED VALUES OF <ACT-TYPE>.
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.
<ACT-TYPE> Integer type; indicates the type of access technology. AT+CEDRXS? is
<REQUESTED_EDRX_VALUE> used to specify the relationship between the type of access technology
<NW-
PROVIDED_EDRX_VALUE > and the requested eDRX value.
<PAGING_TIME_WINDOW >
0 Access technology is not using eDRX. This parameter value is
only used in the unsolicited result code.
4 E-UTRAN (WB-S1 mode)
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.
(e.g."0010" equals 20.48 seconds)
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.
(e.g."0010" equals 20.48 seconds)
string type; half a byte in a 4 bit format. The paging time window referes
to bit 8 to 5 of octet 3 of the Extended DRX parameters information
element.
(e.g."0000" equals 2.56 seconds)
Example
AT+CEDRXS=1,4,"0010"
OK
AT+CEDRXS?
+CEDRXS: 4,"0010"
OK
AT+CEDRXS=?
+CEDRXS: (0,1,2,3),4,("0000"-"1111")
OK
2.2.12 AT+CEDRXRDP eDRX read dynamic parameters
The execution command returns <AcT-type>, <Requested_eDRX_value>, <NW-
provided_eDRX_value> and <Paging_time_window>. If eDRX is used for the cell that the UE is
currently registered to. If the cell that the UE is currently registered to is not using eDRX, <AcT-
type>=0 is returned.
AT+CEDRXRDP
Execution Command Response
AT+CEDRXRDP +CEDRXRDP: <AcT-
type>[,<Requested_eDRX_value>[,<NW-
Test Command provided_eDRX_value>[,<Paging_time_window>]]]
AT+CEDRXRDP=? OK
Maximum Response Time Response
Parameter Saving Mode OK
5s
NO_SAVE
Parameter INTEGER TYPE; INDICATES THE TYPE OF ACCESS
TECHNOLOGY.
<ACT-TYPE> 0 Access technology is not using eDRX
4 E-UTRAN (WB-S1 mode)
<REQUESTED_EDRX_VALUE> String type; half a byte in a 4-bit format.
<NW-PROVIDED_EDRX_VALUE> (e.g."0010" equals 20.48 seconds)
<PAGING_TIME_WINDOW> String type; half a byte in a 4-bit format.
(e.g."0010" equals 20.48 seconds)
String type; half a byte in a 4-bit format.
(e.g."0000" equals 2.56 seconds)
Example
AT+CEDRXRDP
+CEDRXRDP: 4,"0010","1101","0100"
OK
AT+CEDRXRDP=?
OK
2.2.13 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.
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.
The test command returns values supported as compound values.
AT+CCIOTOPT Response
OK
Set Command If there is any error, response:
AT+CCIOTOPT=<n>[,<support_UE_opt>[,<preferr +CME ERROR: <err>
ed_ue_opt>]] Response
Read Command +CCIOTOPT:
AT+CCIOTOPT? <n>,<support_UE_opt>,<preferre
d_UE_opt>
Test Command OK
AT+CCIOTOPT=? Response
+CCIOTOPT: (list of supported
Maximum Response Time <n>s),(list of supported
Parameter Saving Mode <support_UE_opt>s),(list of supported
<preferred_UE_opt>s)
5s
NO_SAVE
Note: AT&W will save <n> to NVM.
Parameter INTEGER TYPE; INDICATES THE TYPE OF ACCESS
TECHNOLOGY.
<N> 0 Disable reporting
<SUPPORT_UE_OPT> 1 Enable reporting
<PREFERRED_UE_OPT> 3 Disable reporting and reset the parameters for CIoT EPS
<SUPPORTED_NETWORK_OPT> optimization to the default values.
Integer type; indicates the UE's 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 optimizations
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
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
Example
AT+CCIOTOPT=?
+CCIOTOPT: (0,1,3),(0,1,2,3),(0,1,2)
OK
AT+CCIOTOPT?
+CCIOTOPT: 0,3,1
OK
2.2.14 AT+CGCMOD PDP context modify
The execution command is used to modify the specified PDP context with request to QoS profiles and
TFTs. If the requested modification for any specified context cannot be achieved, an ERROR or +CME
ERROR response is returned..
The test command returns a list of <cid>s associated with active contexts.
AT+CGCMOD Response
OK
Set Command If there is any error, response:
AT+CGCMOD=<cid> (Note1) +CME ERROR: <err>
Response
Test Command +CGCMOD: (list of <cid>s associated with active contexts)
AT+CGCMOD=? OK
70s
Maximum Response Time NO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT
DEFINITION.
<CID> <CID> VALUES OF 1-15 ARE SUPPORTED.
Note1:
1) Not support to specify several <cid>s, just not support: AT+CGCMOD=<cid>,<cid>[,..]
Example
AT+CGCMOD=?
+CGCMOD: (1)
OK
2.2.15 AT+CGATT PS attach or detach
The set command is used to attach the MT to, or detach the MT from, the Packet Domain service. If the
MT is already in the requested state, the command is ignored and the OK response is returned. If the
requested state cannot be achieved, +CME ERROR response is returned. Any active PDP contexts will be
automatically deactivated when the attachment state changes to detached.
The read command returns the current Packet Domain service state.
The test command is used for requesting information on the supported Packet Domain service states.
AT+CGATT Response
OK
Set Command If there is any error, response:
AT+CGATT=<state> +CME ERROR: <err>
Response
Read Command +CGATT: <state>
AT+CGATT? OK
Response
Test Command +CGATT: (list of supported <state>s)
AT+CGATT=? OK
70s
Maximum Response Time NO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE; INDICATES THE STATE OF PS ATTACHMENT.
0 Detached
<STATE> 1 Attached
Example
AT+CGATT=?
+CGATT: (0,1)
OK
AT+CGATT?
+CGATT: 1
OK
2.2.16 AT+CGACT PDP context activate or deactivate
The set command is used to activate or deactivate the specified PDP context. If any PDP context is
already in the requested state, the state for that context remains unchanged. If the requested state for
any specified context cannot be achieved, an +CME ERROR response is returned. If the MT is not PS
attached when the activation form of the command is executed, the MT first performs a PS attach and
then attempts to activate the specified contexts. If the attach fail, then the MT responds with +CME
ERROR.
For EPS, if an attempt is made to disconnect the last PDN connection, then the MT responds with a
+CME 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 MT before the PDP context can be set in to established state.
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.
AT+CGACT Response
OK
Set Command If there is any error, response:
AT+CGACT=<state>,<cid> (Note1) +CME ERROR: <err>
Response
Read Command [+CGACT: <cid>,<state>]
AT+CGACT? [<CR><LF>+CGACT:<cid>,<state>.
[...]]
Test Command OK
AT+CGACT=? Response
+CGACT: (list of supported <state>s)
Maximum Response Time OK
Parameter Saving Mode 70s
NO_SAVE
Parameter
<STATE> INTEGER TYPE; INDICATES THE ACTIVATION STATE OF PDP
<CID> CONTEXT ACTIVATION.
0 Deactivated
1 Activated
Integer type; specifies a particular PDP context definition. Only one
<cid> can be activated or deactivated at the same time.
<cid> values of 1-15 are supported.
<cid> cid that defined in +CGDCONT/+CGDSCONT
Note1
1) <cid> must be specified, just not support to activate/deactivate all defined/activated bearers.
2) Not support to specify several <cid>s, just not support:
AT+CGACT=<state>,<cid>,<cid>[,..].
Example
AT+CGACT=?
+CGACT: (0,1)
OK
AT+CGACT?
+CGACT: 1,1
OK
2.2.17 AT+CGDATA enter data state
The execution command causes the MT to perform whatever actions are necessary to establish
communication between the TE and the network using one Packet Domain PDP types. This may include
performing a PS attach and one PDP context activations. <cid> should be specified (see the
+CGDCONT) in order to provide the information needed for the context activation request.
The test command is used for requesting information on the supported <L2P> protocols.
AT+CGDATA Response
OK
Set Command If there is any error, response:
AT+CGDATA=<L2P>,<cid> +CME ERROR: <err>
Response
Test Command +CGDATA: (list of supported <L2P>s)
AT+CGDATA=?
Maximum Response Time OK
Parameter Saving Mode 70s
NO_SAVE
Parameter STRING TYPE; INDICATES THE LAYER 2 PROTOCOL TO BE
USED BETWEEN THE TE AND MT.
<L2P> M-PT Eigencomm specified protocol � PDP Type, such as
<CID> IP/IPV6/IPV4V6/Non-IP
Integer type; specifies a particular PDP context definition.
<cid> values of 1-15 are supported.
Note:
1) This AT command is not fully followed the 3GPP 27.007, execution command just trigger MT to
activate a PDP context, just same as: +CGACT=1,<cid>.
2) If PDP activation success, MT issues the result code: OK, not: CONNECT, as not support V.250
online data state now.
Example
AT+CGDATA=?
+CGDATA: ("M-PT")
OK
2.2.18 AT+CGDCONT define a PDP context
The set command specifies PDP context parameter values for a PDP context identified by the (local)
context identification parameter, <cid> It also allows the TE to specify whether security protected
transmission of ESM information is requested, because the PCO can include information that requires
ciphering. There can be other reasons for the UE to use security protected transmission of ESM
information, e.g. if the UE needs to transfer an APN. The number of PDP contexts that may be in a
defined state at the same time is given by the range returned by the test command.
For EPS the PDN connection and its associated EPS default bearer is identified herewith.
A special form of the set command, +CGDCONT=<cid> causes the values for context number <cid> to
become undefined.
The read command returns the current settings for each defined context.
The test command returns values supported as compound values
AT+CGDCONT Response
Set Command
AT+CGDCONT=<cid>[,<PDP_type>[,APN>[ OK
,<PDP_addr>[,<d_comp>[,<h_comp>[,<I If there is any error, response:
Pv4AddrAlloc>[,<request_type>[,<P- +CME ERROR: <err>
CSCF_discovery>[,<IM_CN_Signalling_
Flag_Ind>[,<NSLPI>[,<securePCO>[,<I
Pv4_MTU_discovery>]]]]]]]]]]]
Read Command Response
AT+CGDCONT? +CGDCONT:
<cid>,<PDP_type>,<APN>,<PDP_addr>,<d_c
Test Command omp>,<h_comp>[,<IPv4AddrAlloc>[,<reque
AT+CGDCONT=? st_type>[,<P-
CSCF_discovery>[,<IM_CN_Signalling_Fla
g_Ind>[<NSLPI>[,<securePCO>[,<IPv4_MTU
_discovery>]]]]]]]]
[<CR><LF>+CGDCONT:<cid>,<PDP_type>,<AP
N>,<PDP_addr>,<d_comp>,<h_comp>[,<IPv4
AddrAlloc>[,<request_type>[,<P-
CSCF_discovery>[,<IM_CN_Signalling_Fla
g_Ind>[<NSLPI>[,<securePCO>[,<IPv4_MTU
_discovery>]]]]]]]]]
[...]]
OK
Response
+CGDCONT: (range of supported
<cid>s),<PDP_type>,,,(list of supported
<d_comp>s),(list of supported <h_comp>s),(list of
supported <IPv4AddrAlloc>s),(list of supported
<request_type>s),(list of supported
<PCSCF_discovery>s),(list of supported
<IM_CN_Signalling_Flag_Ind>s),(list of
supported <NSLPI>s),(list of supported
<securePCO>s),(list of supported
<IPv4_MTU_discovery>s),(list of supported
<Local_Addr_Ind>s),
[<CR><LF>+CGDCONT: (range of supported
<cid>s),<PDP_type>,,,(list of supported
<d_comp>s),(list of supported <h_comp>s),(list of
supported <IPv4AddrAlloc>s),(list of supported
<request_type>s),(list of supported
<PCSCF_discovery>s),(list of supported
<IM_CN_Signalling_Flag_Ind>s),(list of
supported <NSLPI>s),(list of supported
<securePCO>s),(list of supported
Maximum Response Time <IPv4_MTU_discovery>s),(list of supported
Parameter Saving Mode <Local_Addr_Ind>s)
[...]]
Parameter 5s
NO_SAVE
<CID>
INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT
<PDP_TYPE>
DEFINITION. THE PARAMETER IS LOCAL TO THE TE-MT
<APN>
<PDP_ADDR> INTERFACE AND IS USED IN OTHER PDP CONTEXT-RELATED
<D_COMP>
<H_COMP> COMMANDS. THE RANGE OF PERMITTED VALUES IS
<IPV4ADDRALLOC>
<REQUEST_TYPE> RETURNED BY THE TEST FORM OF THE COMMAND.
<P-CSCF_DISCOVERY> <CID> VALUES OF 1-15 ARE SUPPORTED.
String type; specifies the type of packet data protocol. The default
value is manufacturer specific.
IP Internet Protocol
IPV6 Internet Protocol, version 6
IPV4V6 Virtual <PDP_type> introduced to handle dual
IP stack UE capability
Non-IP Transfer of Non-IP data to external packet data
network
String type; a logical name that is used to select the GGSN or the
external packet data network.
the max length is 99 characters;
String type; identifies the MT in the address space applicable to
the PDP. (ignored with the set command)
Integer type; don't need for CAT1
Integer type; don't need for CAT1
Integer type; control how the MT/TA requests to get the IPv4
address information
0 IPv4 address allocation through NAS signalling
1 IPv4 address allocated through DHCP (Not support)
Integer type; indicates the type of PDP context activation request
for the PDP context
0 PDP context is for new PDP context establishment or for
handover from a non-3GPP access network
1 PDP context is for emergency bearer services (Not
support)
2 PDP context is for new PDP context establishment
3 PDP context is for handover from a non-3GPP access
network (Not support)
Integer type; influences how the MT/TA requests to get the P-
CSCF address
0 Preference of P-CSCF address discovery not influenced
by +CGDCONT
1 Preference of P-CSCF address discovery through NAS
signaling (Not support)
2 Preference of P-CSCF address discovery through DHCP
(Not support)
<IM_CN_SIGNALLING_FLAG_IND> Integer type; indicates to the network whether the PDP context is
<NSLPI>
<SECUREPCO> for IM CN subsystem-related signaling only or not
<IPV4_MTU_DISCOVERY>
<LOCAL_ADDR_IND> 0 UE indicates that the PDP context is not for IM CN
subsystem-related signaling only
1 UE indicates that the PDP context is for IM CN
subsystem-related signaling only (Not support)
Integer type; indicates the NAS signaling priority requested for this
PDP context
0 Indicates that this PDP context is to be activated with the
value for the low priority indicator configured in the MT.
1 Indicates that this PDP context is to be activated with the
value for the low priority indicator set to "MS is not
configured for NAS signaling low priority"
Integer type; specifies if security protected transmission of PCO is
requested or not
0 Security protected transmission of PCO is not requested
1 Security protected transmission of PCO is requested
(Not support)
Integer type; influences how the MT/TA requests to get the IPv4
MTU size
0 Preference of IPv4 MTU size discovery not influenced by
+CGDCONT
1 Preference of IPv4 MTU size discovery through NAS
signalling
Integer type; indicates to the network whether or not the MS
supports local IP address in TFTs
0 Indicates that the MS does not support local IP address
in TFTs
1 Indicates that the MS supports local IP address in TFTs
(Not support)
Example
AT+CGDCONT=1,"ipv6","apn1"
OK
AT+CGDCONT?
+CGDCONT: 1,"IP","snbiot.mnc006.mcc460.gprs","10.212.154.7"
+CGDCONT: 2,"IPV6","apn1"
OK
AT+CGDCONT=?
+CGDCONT: (1-15),"IP",,,,,(0),(0,2),(0),(0),(0,1),(0),(0,1),(0)
+CGDCONT: (1-15),"IPV6",,,,,(0),(0,2),(0),(0),(0,1),(0),(0),(0)
+CGDCONT: (1-15),"IPV4V6",,,,,(0),(0,2),(0),(0),(0,1),(0),(0,1),(0)
+CGDCONT: (1-15),"Non-IP",,,,,(0),(0,2),(0),(0),(0,1),(0),(0),(0),(0,1)
OK
//note, if a bearer is activated with ipv4v6 addresses, two PDP context information will
be returned as the response of reading command, such as:
AT+CGDCONT?
+CGDCONT: 1,"IPV4V6","ctnb.MNC011.MCC460.GPRS","11.50.125.207"
+CGDCONT:
2,"IPV4V6","ctnb.MNC011.MCC460.GPRS","36.14.8.120.0.80.3.53.0.2.0.1.83.170.233.153"
OK
2.2.19 AT+CGCONTRDP PDP context read dynamic parameters
The execution command returns the relevant information for an active non-secondary PDP context with
the context identifier <cid>. If the MT has dual stack capabilities, at least one pair of lines with
information is returned per <cid>. First one line with the IPv4 parameters followed by one line with the
IPv6 parameters. If this MT with dual stack capabilities indicates more than more than two IP addresses
of DNS servers, multiple of such pairs of lines are returned.
If the parameter <cid> is omitted, the relevant information for all active non secondary PDP contexts is
returned.
The test command returns a list of <cid>s associated with active non secondary contexts.
AT+CGCONTRDP Response
[+CGCONTRDP:
Set Command <cid>,<bearer_id>,<apn>[,<local_addr and
AT+CGCONTRDP[=<cid>] subnet_mask>[,<gw_addr>[,<DNS_prim_addr>[,<DNS
_sec_addr>[,<PCSCF_prim_addr>[,<PCSCF_sec_addr
>[,<IM_CN_Signalling_Flag>[,<LIPA_indication>[
,<IPv4_MTU>[,<WLAN_Offload>[,<Local_Addr_Ind>
[,<Serving_PLMN_rate_control_valu
e>]]]]]]]]]]]]]
[<CR><LF>+CGCONTRDP:
Test Command <cid>,<bearer_id>,<apn>[,<local_addr and
AT+CGCONTRDP=? subnet_mask>[,<gw_addr>[,<DNS_prim_addr>[,<DNS
_sec_addr>[,<PCSCF_prim_addr>[,<PCSCF_sec_addr
Maximum Response Time >[,<IM_CN_Signalling_Flag>[,<LIPA_indication>[
Parameter Saving Mode ,<IPv4_MTU>[,<WLAN_Offload>[,<Local_Addr_Ind>[
,<Serving_PLMN_rate_control_value>]]]]]]]]]]]]
]
[...]]
OK
If there is any error, response:
+CME ERROR: <err>
Response
+CGCONTRDP: (list of <cid>s associated with active
contexts)
OK
5s
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR NON
SECONDARY PDP CONTEXT DEFINITION.
<CID> <CID> VALUES OF 1-15 ARE SUPPORTED.
Integer type; identifies the bearer.
<BEARER_ID>
<APN> String type; a logical name that was used to select the
<LOCAL_ADDR_AND_SUBNET_MASK> GGSN or the external packet data network.
<DNS_PRIM_ADDR> String type; shows the IP address and subnet mask of the
<DNS_SEC_ADDR> MT. The string is given as dot-separated numeric (0-255)
<P_CSCF_PRIM_ADDR> String type; the IP address of the primary DNS server.
<P_CSCF_SEC_ADDR>
<IM_CN_SIGNALLING_FLAG> String type; the IP address of the secondary DNS server.
<LIPA_INDICATION>
<IPV4_MTU> String type; shows the IP address of the primary P-CSCF
<WLAN_OFFLOAD> server. (Not displayed)
String type; shows the IP address of the secondary P-CSCF
<LOCAL_ADDR_IND> server. (Not displayed)
Integer type; shows whether the PDP context is for IM CN
subsystem-related signalling only or not. (Not displayed)
Integer type; indicates that the PDP context provides
connectivity using a LIPA PDN connection. (Not displayed)
Integer type; shows the IPv4 MTU size in octets
Integer type; indicates whether traffic can be offloaded using
the specified PDN connection via a WLAN or not. (Not
displayed)
integer type; indicates whether or not the MS and the
network support local IP address in TFTs. (Not displayed)
< Integer type; indicates the maximum number of uplink
SERVING_PLMN_RATE_CONTROL_VALUE> messages the UE is allowed to send in a 6 minute interval.
Example
AT+CGCONTRDP=1
+CGCONTRDP:
1,5,"CMNbiot.mnc004.mcc460.gprs","100.115.240.198.255.255.255.0","211.136.20.203","211.136
.17.107"
OK
2.2.20 AT+CGEQOS define EPS quality of service
The set command allows the TE to specify the EPS Quality of Service parameters <cid>, <QCI>,
[<DL_GBR> and <UL_GBR>] and [<DL_MBR> and <UL_MBR>] for a PDP context or Traffic Flows (see
3GPP TS 24.301 [83] and 3GPP TS 23.203 [85]).
A special form of the set command, +CGEQOS=<cid> causes the values for context number <cid> to
become undefined.
The read command returns the current settings for each defined QoS.
The test command returns the ranges of the supported parameters as compound values.
AT+CGEQOS Response
OK
Set Command If there is any error, response:
AT+CGEQOS=<cid>[,<QCI>[,<DL_GBR>,<UL_ +CME ERROR: <err>
GBR>[,<DL_MBR>,<UL_MBR>]]] Response
Read Command [+CGEQOS:
AT+CGEQOS? <cid>,<QCI>,[<DL_GBR>,<UL_GBR>],[<DL_
MBR>,<UL_MBR>]]
Test Command [<CR><LF>
AT+CGEQOS=? +CGEQOS:<cid>,<QCI>,[<DL_GBR>,<UL_GBR
Maximum Response Time >],[<DL_MBR>,<UL_MBR>][...]]
Parameter Saving Mode OK
Response
+CGEQOS: (range of supported <cid>s),(list
of supported <QCI>s)
5s
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR EPS TRAFFIC FLOWS
<CID> DEFINITION IN EPS AND PDP CONTEXT DEFINITION.
<QCI>
<CID> VALUES OF 1-15 ARE SUPPORTED.
<DL_GBR>
<UL_GBR> Integer type;specifies a class of EPS QoS
<DL_MBR>
<UL_MBR> 0 QCI is selected by network
[1-4] Value range for guaranteed bit rate Traffic Flows
75 Value for guaranteed bit rate Traffic Flows
[5-9] Value range for non-guaranteed bit rate Traffic Flows
79 Value for non-guaranteed bit rate Traffic Flows
Integer type; indicates DL GBR in case of GBR QCI. The value is in kbit/s. This
parameter is omitted for a non-GBR QCI
Integer type; indicates UL GBR in case of GBR QCI. The value is in kbit/s. This
parameter is omitted for a non-GBR QCI
Integer type; indicates DL MBR in case of GBR QCI. The value is in kbit/s. This
parameter is omitted for a non-GBR QCI
Integer type; indicates UL MBR in case of GBR QCI. The value is in kbit/s. This
parameter is omitted for a non-GBR QCI
Example
AT+CGEQOS=1,9
OK
AT+CGEQOS=1,4,64,64,64,64
OK
2.2.21 AT+CGEQOSRDP EPS quality of service read dynamic
parameters
The execution command returns the quality of service parameters <QCI>,[<DL_GBR> and <UL_GBR>]
and [<DL_MBR> and <UL_MBR>] of the active secondary or non-secondary PDP context associated to
the provided context identifier <cid>.
If the parameter <cid> is omitted, the quality of service parameters for all secondary and non-secondary
active PDP contexts are returned.
The test command returns a list of <cid>s associated with secondary or non-secondary active PDP
contexts.
AT+CGEQOSRDP
Set Command Response
AT+CGEQOSRDP +CGEQOSRDP:
[=<cid>] <cid>,<QCI>,[<DL_GBR>,<UL_GBR>],[<DL_MBR>,<UL_MBR>][<DL_A
MBR>,<UL_AMBR>]
Test Command [<CR><LF>+CGEQOSRDP:
AT+CGEQOSRDP=? <cid>,<QCI>,[<DL_GBR>,<UL_GBR>],[<DL_MBR>,<UL_MBR>][<DL_A
Maximum Response MBR>,<UL_AMBR>]
Time [...]]
Parameter Saving OK
Mode If there is any error, response:
+CME ERROR: <err>
Response
+CGEQOSRDP: (list of <cid>s associated with active contexts)
OK
5s
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT DEFINITION
<CID> (SEE THE +CGDCONT COMMANDS).
<QCI>
<CID> VALUES OF 1-15 ARE SUPPORTED.
<DL_GBR>
<UL_GBR> Integer type;specifies a class of EPS QoS
<DL_MBR>
<UL_MBR> 0 QCI is selected by network
<DL_AMBR>
<UL_AMBR> [1-4] Value range for guaranteed bit rate Traffic Flows
75 Value for guaranteed bit rate Traffic Flows
[5-9] Value range for non-guaranteed bit rate Traffic Flows
79 Value for non-guaranteed bit rate Traffic Flows
[128- Value range for Operator-specific QCIs
254]
Integer type; indicates DL GBR in case of GBR QCI. The value is in kbit/s. This
parameter is omitted for a non-GBR QCI
Integer type; indicates UL GBR in case of GBR QCI. The value is in kbit/s. This
parameter is omitted for a non-GBR QCI
Integer type; indicates DL MBR in case of GBR QCI. The value is in kbit/s. This
parameter is omitted for a non-GBR QCI
Integer type; indicates UL MBR in case of GBR QCI. The value is in kbit/s. This
parameter is omitted for a non-GBR QCI
Integer type; indicates DL APN aggregate MBR. The value is in kbit/s.
Integer type; indicates UL APN aggregate MBR. The value is in kbit/s.
Example
AT+CGEQOSRDP
+CGEQOSRDP: 1,9
OK
2.2.22 AT+CGSCONTRDP read secondary PDP dynamic parameters
The execution command returns the relevant information for an secondary PDP context with the context
identifier <cid>.
If the parameter <cid> is omitted, the relevant information for all active secondary PDP contexts is
returned.
If the parameter is omitted and use "=" to query, the relevant information for all active PDP contexts is
returned.
AT+ CGSCONTRDP Response
[+CGSCONTRDP:
Set Command <cid>,<p_cid>,<bearer_id>[,<IM_CN_
AT+CGSCONTRDP[=<cid>] Signalling_Flag>[,<WLAN_Offload>[,<PDU_session
_id>,<QFI>]]]]
Test Command [<CR><LF>+CGSCONTRDP:
AT+ CGSCONTRDP =? <cid>,<p_cid>,<bearer_id>[
,<IM_CN_Signalling_Flag>[,<WLAN_Offload>[,<PDU
Maximum Response Time _session_id>,<QFI>]]]
Parameter Saving Mode OK
If there is any error, response:
+CME ERROR: <err>
Response
+CGSCONTRDP: (list of <cid>s associated with
active contexts)
5s
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR EPS TRAFFIC FLOWS
DEFINITION IN EPS AND PDP CONTEXT DEFINITION.
<CID>
<CID> VALUES OF 1-15 ARE SUPPORTED.
<PCID> Integer type; specifies the primary default eps bearer id of current
secondary pdp
<BEARER_ID>
< pcid > values of 1-15 are supported.
Integer type; identifies the bearer, EPS Bearer
<bearer_id> values of 5-15 are supported.
<IM_CN_SIGNALLING_FLAG> Integer type; shows whether the PDP context is for IM CN subsystem-
related signalling only or not.
0 PDP context is not for IM CN subsystem-related signalling only
1 PDP context is for IM CN subsystem-related signalling only
current default is 0.
<WLAN_OFFLOAD> Integer type; it indicates whether traffic can be offloaded using the
specified PDN connection via a WLAN or not
Not support
<PDU_SESSION_ID> Integer type; identifies the PDU session
Not support
<QFI> Integer type; identifies the QoS flow
Not support
AT+CGSCONTRDP=2
+CGCSONTRDP: 2,1,6,0,0,0,0
OK
AT+CGSCONTRDP=?
+CGCSONTRDP: (1,2,3,4)
OK
2.2.23 AT+CGTFT traffic flow template
This command allows the TE to specify a Packet Filter - PF for a Traffic Flow Template - TFT that is used
in the GGSN in UMTS/GPRS and Packet GW in EPS for routing of packets onto different QoS flows
towards the TE. A TFT consists of from one and up to 16 Packet Filters, each identified by a unique
<packet filter identifier>. A Packet Filter also has an <evaluation precedence index>
that is unique within all TFTs associated with all PDP contexts that are associated with the same PDP
address.
The set command specifies a Packet Filter that is to be added to the TFT stored in the MT and used for
the context identified by the (local) context identification parameter, <cid>.
A special form of the set command, +CGTFT=<cid> causes all of the Packet Filters in the TFT for
context number <cid> to become undefined. At any time there may exist only one PDP context with no
associated TFT amongst all PDP contexts associated to one PDP address. At an attempt to delete a
TFT, which would violate this rule, an +CME ERROR response is returned.
The read command returns the current settings for all Packet Filters for each defined context.
The test command returns values supported as compound values. If the MT supports several PDP types,
the parameter value ranges for each PDP type are returned on a separate line. TFTs shall be used for
PDP-type IP only.
AT+CGTFT Response
OK
Set Command If there is any error, response:
AT+CGTFT=<cid>,[<packet filter +CME ERROR: <err>
identifier>,<evaluation
procedure index>[,remote address
and subnet mask>[,<protocol
number (ipv4)/next header
(ipv6)>[,<local port
range>[,<remote port
range>[,<ipsec security
parameter index (spi)>[,<type of
service (tos) (ipv4) and
mask>[,<flow label
(ipv6)>[,<direction>]]]]]]]]]
Read Command Response
AT+CGTFT? [+CGTFT: <cid>,<packet filter
identifier>,<evaluation precedence
index>,<remote address and subnet
mask>,<protocol number (ipv4) / next
header (ipv6)>,<local port range>,<remote
port range>,<ipsec security parameter
index (spi)>,<type of service (tos)
(ipv4) and mask /traffic class (ipv6) and
mask>,<flow label (ipv6)>,<direction>]
[<CR><LF>+CGTFT: <cid>,<packet filter
identifier>,<evaluation precedence
index>,<remote address and subnet
mask>,<protocol number (ipv4) / next
header (ipv6)>,<local port range>,<remote
port range>,<ipsec security parameter
index (spi)>,<type of service (tos)
(ipv4) and mask /traffic class (ipv6) and
mask>,<flow label (ipv6)>,<direction>
[...]]
Test Command OK
AT+CGTFT=? If there is any error, response:
+CME ERROR: <err>
Response
+CGTFT: <PDP_type>,(list of supported <packet
filter identifier>s),(list of supported
<evaluation precedence index>s),(list of
supported <remote address and subnet
mask>s),(list of supported <protocol number
(ipv4) / next header (ipv6)>s),(list of
supported <local port range>s),(list of supported
<remote port range>s),(list of supported <ipsec
security parameter index (spi)>s),(list of
supported <type of service (tos) (ipv4) and
mask / traffic class (ipv6) and mask>s),(list
of supported <flow label (ipv6)>s),(list of
supported <direction>s)
[<CR><LF>+CGTFT: <PDP_type>,(list of supported
<packet filter identifier>s),(list of supported
<evaluation precedence index>s),(list of
supported <remote address and subnet
mask>s),(list of supported <protocol number
(ipv4) / next header (ipv6)>s),(list of
supported <local port range>s),(list of supported
<remote port range>s),(list of supported <ipsec
security parameter index (spi)>s),(list of
supported <type of service (tos) (ipv4) and
mask/ traffic class (ipv6) and mask>s),(list
of supported <flow label (ipv6)>s),(list
ofsupported <direction>s)
[...]
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT
DEFINITION
<CID> <CID> VALUES OF 1-15 ARE SUPPORTED.
Integer type; Value range is from 1 to 16.
<PACKET FILTER
IDENTIFIER> Integer type; The value range is from 0 to 255.
<EVALUATION
PRECEDENCE INDEX> string type; The string is given as dot-separated numeric (0-255)
<REMOTE ADDRESS AND
SUBNET MASK> Integer type; Value range is from 0 to 255.
<PROTOCOL NUMBER
(IPV4) / NEXT HEADER string type; The string is given as dot-separated numeric (0-65535)
(IPV6)> string type; The string is given as dot-separated numeric (0-65535)
<LOCAL PORT RANGE>
<REMOTE PORT RANGE>
<IPSEC SECURITY Integer type; numeric value in hexadecimal format
PARAMETER INDEX>
<TYPE OF SERVICE string type; The string is given as dot-separated numeric (0-255)
(TOS) (IPV4) AND MASK
/ TRAFFIC CLASS Integer type ;numeric value in hexadecimal format
(IPV6) AND MASK> Integer type. Specifies the transmission direction in which the
<FLOW LABEL (IPV6)> packet filter shall be applied.
<DIRECTION> 0 Pre-Release 7 TFT filter
1 Uplink
2 Downlink
3 Birectional (Up & Downlink)
Example
AT+CGTFT=1,2,6,"32.1.11.160.0.0.0.0.0.0.0.0.0.0.0.0.255.255.255.255.0.0.0.0.0.0.0.0.0.0.0.
0",17,"60001.60001","60350.60450",,168.252,,1
OK
2.2.24 AT+CGAPNRC APN rate control
This execution command returns the APN rate control parameters (see 3GPP TS 24.008 [8]) associated
to the provided context identifier <cid>. If the parameter <cid> is omitted, the APN rate control
parameters for all active PDP contexts are returned.
The test command returns a list of <cid>s associated with secondary and non secondary active PDP
contexts.
AT+CGAPNRC Response
+CGAPNRC: <cid>[,<Additional_exception_
Set Command reports>[,<Uplink_time_unit>[,<Maximum_u
AT+CGAPNRC[=<cid>] plink_rate>]]]
[<CR><LF>+CGAPNRC: <cid>[,<Additional_ex
Test Command ception_reports>[,<Uplink_time_unit>[,<M
AT+CGAPNRC=? aximum_uplink_rate>]]]
[...]]
OK
If there is any error, response:
+CME ERROR: <err>
Response
+CGAPNRC: (list of <cid>s associated with active
Maximum Response Time contexts)
Parameter Saving Mode OK
5s
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT
DEFINITION (SEE THE +CGDCONT COMMANDS).
<CID> <CID> VALUES OF 1-15 ARE SUPPORTED.
<ADDITIONAL_EXCEPTION_REPORTS> Integer type; indicates whether or not additional exception
reports are allowed to be sent when the maximum uplink rate
<UPLINK_TIME_UNIT> is reached. This refers to bit 4 of octet 1 of the APN rate
control parameters IE as specified in 3GPP TS 24.008 [8]
<MAXIMUM_UPLINK_RATE> subclause 10.5.6.3.2.
0 Additional_exception_reports at maximum rate reached
are not allowed to be sent.
1 Additional_exception_reports at maximum rate reached
are allowed to be sent.
Integer typ; specifies the time unit to be used for the maximum
uplink rate. This refers to bits 1 to 3 of octet 1 of the APN rate
control parameters IE as specified in 3GPP TS 24.008 [8]
subclause 10.5.6.3.2.
0 unrestricted
1 minute
2 hour
3 day
4 week
Integer type; specifies the maximum number of messages the
UE is restricted to send per uplink time unit. This refers to octet
2 to 4 of the APN rate control parameters IE as specified in
3GPP TS 24.008 [8] subclause 10.5.6.3.2
Example
AT+CGAPNRC=?
+CGAPNRC: (1)
OK
2.2.25 AT+CGEREP Packet domain event reporting
Set command enables or disables sending of unsolicited result codes, +CGEV: XXX from MT to TE in the
case of certain events occurring in the Packet Domain MT 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. If a setting is not supported by the MT, ERROR or +CME ERROR: is returned.
Read command returns the current mode and buffer settings.
Test command returns the modes and buffer settings supported by the MT as compound values.
AT+CGEREP Response
OK
Set Command If there is any error, response:
AT+CGEREP=<mode>[,<bfr>] +CME ERROR: <err>
Response
Read Command +CGEREP: <mode>,<bfr>
AT+CGEREP? OK
Response
Test Command +CGEREP: (list of supported <mode>s),(list of supported
AT+CGEREP=? <bfr>s)
OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Note: AT&W will save <mode> to NVM.
Parameter INTEGER TYPE;
<MODE> 0 buffer unsolicited result codes in the MT; if MT result code
<BFR> buffer is full, the oldest ones can be discarded.No codes are
forwarded to the TE.
Note: default value
1 discard unsolicited result codes when MT-TE link is reserved
(e.g. in on-line data mode); otherwise forward them directly to
the TE
integer type;
0 MT buffer of unsolicited result codes defined within this
command is cleared when <mode> 1 ; Only it now
Example
AT+CGEREP=1,0
OK
AT+CGEREP?
+CGEREP: 1,0
OK
AT+CGEREP=?
+CGEREP: (0,1),(0)
OK
2.2.26 +CGEV used to indicate EPS PDN connection and bearer
resources operations status
This is an unsolicited message to indicate EPS PDN connection and bearer resources
operations status
+CGEV
+CGEV: <xxx>
Parameter THE NETWORK HAS FORCED A CONTEXT
DEACTIVATION.
+CGEV: NW PDN DEACT <CID> The mobile termination has forced a context deactivation.
+CGEV: ME PDN DEACT <CID>
+CGEV: ME PDN ACT <CID> The ME has activated a context.
[,< PDNREASON >]
+CGEV: NW MODIFY The network has modified a context.
<CID>,<CHANGE_REASON>,<EVENT_TYPE>
+CGEV: ME MODIFY The mobile termination has modified a context.
<CID>,<CHANGE_REASON>,<EVENT_TYPE>
Parameter THE FORMAT IS FOUND IN COMMAND +CGDCONT.
<CID> <CID> VALUES OF 1-15 ARE SUPPORTED.
<PDNREASON>
0 IPV4 only allowed
<BEARERTYPE>
<CHANGE_REASON> 1 IPV6 only allowed
2 Single address bearer only allowed
3 Single address bearer only allowed and active second bearer failed
4 No reason
0 NULL
1 default
2 Dedicated (Not application)
Integer type; a bit map that indicates what kind of change occurred.the value is
<EVENT_TYPE > determined by summing all the applicable bits.
Bit 1 TFT changed
Bit 2 Qos changed
Bit 3 WLAN Offload changed
integer type; indicates whether this is an informational event or whether the TE
has to acknowledge it.(not support now)
Example
+CGEV: ME PDN ACT 1,0
2.2.27 AT+CGPADDR show PDP address(es)
The execution command returns a list of PDP addresses for the specified context identifiers. If no <cid>
is specified, the addresses for all defined contexts are returned.
The test command returns a list of defined <cid>s
AT+CGPADDR Response
+CGPADDR: <cid>[,<PDP_addr_1>[,<PDP_addr_2>]]
Set Command [<CR><LF>+CGPADDR:<cid>,[<PDP_addr_1>[,<PDP_addr_2>]]]
AT+CGPADDR [...]
[=<cid>] OK
If there is any error, response:
Test Command +CME ERROR: <err>
AT+CGPADDR=? Response
+CGPADDR: (list of defined <cid>s)
Maximum Response OK
Time 5s
Parameter Saving Mode
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT
DEFINITION (SEE THE +CGDCONT COMMANDS).
<CID> <CID> VALUES OF 1-15 ARE SUPPORTED.
<PDP_addr_1> and <PDP_addr_2>: each is a string type that
<PDP_ADDR_1> identifies the MT in the address space applicable to the PDP. Both
<PDP_ADDR_2> <PDP_addr_1> and <PDP_addr_2> are omitted if none is available.
Both <PDP_addr_1> and <PDP_addr_2> are included when both
IPv4 and IPv6 addresses are assigned, with <PDP_addr_1>
containing the IPv4 address and <PDP_addr_2> containing the IPv6
address.
The string is given as dot-separated numeric (0-255) parameter of
the form:
a1.a2.a3.a4 for IPv4 and
a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a16 for IPv6.
Example
AT+CGPADDR
+CGPADDR: 1,"100.120.44.90"
OK
2.2.28 AT+CSCON signalling connection status
The set command controls the presentation of an unsolicited result code +CSCON. If <n>=1, +CSCON:
<mode> is sent from the MT when the connection mode of the MT is changed.
The read command returns the status of result code presentation and an integer <mode> which shows
whether the MT is currently in idle mode or connected mode.
Test command returns supported values as a compound value.
AT+CSCON Response
OK
Set Command If there is any error, response:
AT+CSCON=<n> +CME ERROR: <err>
Response
Read Command +CSCON: <n>,<mode>
AT+CSCON? OK
Response
Test Command +CSCON: (list of supported <n>s)
AT+CSCON=? OK
5s
Maximum Response Time NO_SAVE
Parameter Saving Mode Note: AT&W will save <n> to NVM.
Parameter INTEGER TYPE
0 Disable unsolicited result code
<N>
Note: default value
1 Enable unsolicited result code +CSCON:<mode>
<MODE> Integer type; indicates the signalling connection status
0 idle
Example 1 connected
AT+CSCON=?
+CSCON: (0,1)
OK
AT+CSCON=1
OK
AT+CSCON?
+CSCON: 1,0
OK
AT+CSCON=0
OK
AT+CSCON?
+CSCON: 0,0
OK
2.2.29 AT+CCLK return current date and time
Set command sets the real-time clock of the MT.
The read command returns the current setting of the clock.
AT+CCLK Response
OK
Set Command If there is any error, response:
AT+CCLK=<time> +CME ERROR: <err>
Response
Read Command +CCLK: <time>
AT+CCLK? OK
Response
Test Command OK
AT+CCLK=?
Maximum Response Time 5s
Parameter Saving Mode AUTO_SAVE
Parameter STRING TYPE
String type. The format is "yy/MM/dd,hh:mm:ss�zz", where
<TIME> characters indicate year (four digits), month, day, hour, minute,
second and time zone (indicates the difference, expressed in
quarters of an hour, between the local time and GMT; and range is -
96 ~ +96). For instance, 6th of May 2014, 22:10:00 GMT+2 hours
equals "2014/05/06,22:10:00+08"
Note: the year should be after 2000 years, otherwise there will be
asserted
Example
AT+CCLK="2018/07/25,02:22:22+00"
OK
AT+CCLK?
+CCLK: "2018/07/25,02:22:30+00"
OK
AT+CCLK=?
OK
2.2.30 AT+CIMI request international mobile subscriber identity
Execution command causes the TA to return <IMSI>, which is intended to permit the TE to identify the
individual SIM card or active application in the UICC which is attached to MT.
AT+CIMI Response
<IMSI>
Set Command OK
AT+CIMI If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+CIMI=? OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter STRING TYPE
International Mobile Subscriber Identity (string without double quotes)
<IMSI>
Example
AT+CIMI=?
OK
AT+CIMI
460043263600043
OK
2.2.31 AT+CPIN enter PIN
Set command sends to the MT a password which is necessary before it can be operated (SIM PIN, SIM
PUK, 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 SIM.
Read command returns an alphanumeric string indicating whether some password is required or not.
AT+CPIN Response
OK
Set Command If there is any error, response:
AT+CPIN=<pin>[,<newpin>] +CME ERROR: <err>
Response
Read Command +CPIN: <code>
AT+CPIN? OK
Response
Test Command OK
AT+CPIN=? 5s
Maximum Response Time NO_SAVE
Parameter Saving Mode
Parameter STRING TYPE
String type
<PIN>,<NEWPIN> READY
<CODE> SIM PIN
MT is not pending for any password
MT is waiting SIM PIN to be given
SIM PUK MT is waiting SIM PUK to be given
SIM PIN2 MT is waiting SIM PIN2 to be given
SIM PUK2 MT is waiting SIM PUK2 to be given
Example
AT+CPIN?
+CPIN: READY
OK
2.2.32 AT+CLCK facility lock
Execute command is used to lock, unlock or interrogate a MT 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>. This command should be abortable when network facilities are set or interrogated.
Test command returns facility values supported as a compound value.
AT+CLCK Response
OK
Set Command If there is any error, response:
AT+CLCK=<fac>,<mode>[,<passwd>] +CME ERROR: <err>
When <mode>=2 and command successful:
Test Command +CLCK: <status>
AT+CLCK=? Response
+CLCK: (list of supported <fac>s)
Maximum Response Time OK
Parameter Saving Mode If there is any error, response:
+CME ERROR: <err>
5s
NO_SAVE
Parameter STRING TYPE
<FAC> "SC" SIM (lock SIM/UICC card installed in the currently selected card
<MODE> slot) (SIM/UICC asks password in MT power-up and when this
lock command issued)
Integer type
0 Unlock
1 Lock
2 Query status
<STATUS> Integer type
<PASSWD> 0 Not active
Example 1 active
AT+CLCK=? String type; shall be the same as password specified for the facility from the MT
+CLCK:("SC")
OK user interface or with command Change Password +CPWD
2.2.33 AT+CPWD change password
Command sets a new password for the facility lock function defined by command Facility Lock +CLCK.
Test command returns a list of pairs which present the available facilities and the maximum length of
their password.
AT+CPWD Response
OK
Set Command If there is any error, response:
AT+CPWD=<fac>,<oldpwd>,<newpwd> +CME ERROR: <err>
Response
Test Command +CPWD: list of supported (<fac>,<pwdlength>)s
AT+CPWD=? OK
If there is any error, response:
Maximum Response Time +CME ERROR: <err>
Parameter Saving Mode 5s
NO_SAVE
Parameter STRING TYPE
<FAC> "SC" SIM (lock SIM/UICC card installed in the currently selected card
<OLDPWD>,<NEWPWD> slot) (SIM/UICC asks password in
MT power-up and when this lock command issued)
String type
<oldpwd> shall be the same as password specified for the
facility from the MT user interface or with command Change
Password +CPWD and <newpwd> is the new password,
maximum length of password can be determined with
<pwdlength>
<PWDLENGTH> Integer type; maximum length of the password for the facility
Example
AT+CPWD=?
+CPWD: ("SC",8)
OK
2.2.34 AT+CSIM generic SIM access
Set command transmits to the MT the <command> it then shall send as it is to the SIM. In the same
manner, the SIM <response> shall be sent back by the MT to the TA as it is.
This command allows a direct control of the SIM that is installed in the currently selected card slot, by an
distant application on the TE. The TE shall then take care of processing SIM information within the frame
specified by GSM/UMTS.
AT+CSIM Response
+CSIM: <length>,<response>
Set Command OK
AT+CSIM=<length>,<command> If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+CSIM=? OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter
<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> String type
command passed on by the MT to the SIM in the format as described in
3GPP TS 51.011 [28]
(hexadecimal character format)
<RESPONSE> String type
response to the command passed on by the SIM to the MT in the format as
described in 3GPP TS 51.011 [28] (hexadecimal character format)
Note: The SIM sleep (power off) shall be disabled by AT+ECSIMSLEEP=0 (refer to 3.1.27) before enter
AT+CSIM.
Example
AT+CSIM=?
OK
AT+CSIM=14,"00A4000C023F00"
+CSIM: 4, "9000"
OK
2.2.35 AT+CRSM restricted SIM
By using this command instead of Generic SIM Access +CSIM TE application has easier but more limited
access to the SIM database. Set command transmits to the MT the SIM <command> and its required
parameters. If a SIM installed in the currently selected card slot, the MT handles internally all SIM-MT
interface locking and file selection routines. As response to the command, MT sends the actual SIM
information parameters and response data. MT error result code +CME ERROR may be returned when
the command cannot be passed to the SIM, but failure in the execution of the command in the SIM is
reported in <sw1> and <sw2> parameters.
Coordination of command requests to SIM and the ones issued by GSM/UMTS application inside the MT
is implementation dependent. However, the TE should be aware of the precedence of the GSM/UMTS
application commands to the TE commands.
AT+CRSM Response
+CRSM:
Set Command <sw1>,<sw2>[,<respon
AT+CRSM=<command>[,<fileid>[,<P1>,<P2>,<P3>[,<data>[, se>]
<pathid>]]]] OK
If there is any error,
Test Command response:
AT+CRSM=? +CME ERROR: <err>
Maximum Response Time Response
Parameter Saving Mode OK
5s
NO_SAVE
Parameter INTEGER TYPE; COMMAND PASSED ON BY THE MT TO THE SIM;
<COMMAND>
REFER 3GPP TS 51.011 [28]
176 READ BINARY
178 READ RECORD
192 GET RESPONSE
214 UPDATE BINARY
220 UPDATE RECORD
242 STATUS
All other values are reserved
<FILEID> Integer type; this is the identifier of a elementary datafile on SIM. Mandatory
for every command except STATUS
The range of valid file identifiers depends on the actual SIM and is defined in
3GPP TS 51.011 [28]. Optional files may not be present at all.
<P1>,<P2>,<P3> Integer type; parameters passed on by the MT to the SIM. These parameters
are mandatory for every command, except GET RESPONSE and STATUS.
The values are described in 3GPP TS 51.011 [28]
<DATA> String type; information which shall be written to the SIM (hexadecimal
character format)
<PATHID> String type; contains the path of an elementary file on the SIM/UICC in
hexadecimal format as defined in ETSI TS 102 221 [60] (e.g. "7F205F70" in
SIM and UICC case). The <pathid> shall only be used in the mode "select by
path from MF" as defined in ETSI TS 102 221 [60]
<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> String type; response of a successful completion of the command previously
issued (hexadecimal character format). STATUS and GET RESPONSE
return data, which gives information about the current elementary datafield.
This information includes the type of file and its size (refer 3GPP TS 51.011
[28]). After READ BINARY, READ RECORD or RETRIEVE DATA command
the requested data will be returned. <response> is not returned after a
successful UPDATE BINARY, UPDATE RECORD or SET DATA command.
Note: The SIM sleep (power off) shall be disabled by AT+ECSIMSLEEP=0 (refer to 3.1.27) before enter
AT+CRSM.
Example
AT+CRSM=176,28423,0,0,18
+CRSM: 144, 0, "08490660"
OK
2.2.36 AT+CCHO open logical channel
Execution of the 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 shall restrict the communication between the
TE and the UICC to this logical channel.
This <sessionid> is to be used when sending commands with Restricted UICC Logical Channel access
+CRLA or Generic UICC Logical Channel access +CGLA commands.
AT+CCHO Response
<sessionid>
Set Command OK
AT+CCHO=<dfname> If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+CCHO=? OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter STRING TYPE
all selectable applications in the UICC are referenced by a DF name coded on 1
<DFNAME> to 16 bytes.
Integer type
<SESSIONID> a session Id to be used in order to target a specific application on the smart
card (e.g. (U)SIM, WIM, ISIM) using logical channels mechanism.
Example
AT+CCHO="A00000004374506173732E496F54"
1
OK
2.2.37 AT+CCHC close logical channel
This command asks the ME to close a communication session with the active UICC. The ME shall close 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.
AT+CCHC Response
+CCHC
Set Command OK
AT+CCHC=<sessionid> If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+CCHC=? OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
a session Id to be used in order to target a specific application on the smart
<SESSIONID> card (e.g. (U)SIM, WIM, ISIM) using logical channels mechanism.
Example
AT+CCHC=1
+CCHC
OK
2.2.38 AT+CGLA generic UICC logical channel access
Set command transmits to the MT the <command> it then shall send as it is to the selected UICC. In the
same manner the UICC <response> shall be sent back by the MT to the TA as it is.
This command allows a direct control of the currently selected UICC by a distant application on the TE.
The TE shall then take care of processing UICC information within the frame specified by GSM/UMTS.
Although Generic UICC Logical Channel Access command +CGLA allows 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. Moreover, for security reason the GSM network authentication should
not be handled outside the TA/MT. Therefore, it shall not be allowed to execute a Run GSM Algorithm
command or an Authenticate command in GSM context from the TE using +CGLA at all-time whether the
+CGLA is locked or unlocked. This shall not forbid the TE to send Authenticate commands in other security
contexts (e.g. EAP security context).
For example, the TA/MT shall forbid the transfer of the Authenticate command to a USIM application when
parameters P2 = 0 (GSM security context). See 3GPP TS 31.102 for USIM authenticate command
definition.
AT+CGLA
Set Command Response
AT+CGLA=<sessionid>,<length>,<command> +CGLA: <length>,<response>
OK
If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+CGLA=? OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
this is the identifier of the session to be used in order to send the APDU
<SESSIONID> commands to the UICC. It is mandatory in order to send commands to the
UICC when targeting applications on the smart card using a logical channel
<LENGTH> other than the default channel (channel "0").
<COMMAND> Integer type
<RESPONSE> length of the characters that are sent to TE in <command> or <response>
(two times the actual length of the command or response)
String type
command passed on by the MT to the UICC in the format as described in
3GPP TS 31.101 (hexadecimal character format)
String type
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)
Example
AT+CGLA=1,38,"81F100000E0051010A11223344556677889900"
+CGLA: 42,
"009868119122009036664601FA483D3E000000253D165EF45278745B0F4365C32CBE23CEEBB331839000"
OK
2.2.39 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.
Read command returns the current settings in the MT.
Test command returns supported on- and off-values as a compound value.
AT+CTZU Response
OK
Set Command If there is any error, response:
AT+CTZU=<onoff> +CME ERROR: <err>
Response
Read Command +CTZU: <onoff>
AT+CTZU? OK
Response
Test Command +CTZU: (lists of supported <onoff>s)
AT+CTZU=?
OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Note: AT&W will save <onoff> to NVM.
Parameter INTEGER TYPE
0 Disable automatic time zone update via NITZ.
<ONOFF> 1 Enable automatic time zone update via NITZ.
Note: default value
Example
AT+CTZU=1
OK
AT+CTZU?
+CTZU: 1
OK
AT+CTZU=?
+CTZU: (0-1)
OK
2.2.40 AT+CTZR time zone reporting
This set command controls the time zone change event reporting. If reporting is enabled the MT returns
the unsolicited result code +CTZV: <tz>, +CTZE: <tz>,<dst>,[<time>], or +CTZEU:
<tz>,<dst>,[<utime>]whenever the time zone is changed. The MT also provides the time zone
upon network registration if provided by the network. If setting fails in an MT error, +CME ERROR: <err>
is returned.
Read command returns the current reporting settings in the MT.
Test command returns supported <reporting>-values as a compound value.
AT+CTZR Response
OK
Set Command If there is any error, response:
AT+CTZR=<reporting> +CME ERROR: <err>
Read Command Response
AT+CTZR? +CTZR: <reporting>
OK
Test Command Response
AT+CTZR=? +CTZR: (lists of supported <reporting>s)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Note: AT&W will save <reporting> to NVM.
Parameter INTEGER TYPE
<REPORTING> 0 disable time zone change event reporting.
<TZ> Note: default value.
<DST>
<TIME> 1 Enable time zone change event reporting by unsolicited result code
<UTIME>
+CTZV: <tz>.
2 Enable extended time zone and local time reporting by unsolicited result
code +CTZE: <tz>,<dst>,[<time>].
Note: not supported.
3 Enable extended time zone and universal time reporting by unsolicited
result code +CTZEU: <tz>,<dst>,[<utime>]
String type
representing the sum of the local time zone (difference between the local time
and GMT 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"
Interger type, indicating 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
String type
Value representing 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). The local time can be derived by the MT
from information provided by the network at the time of delivering time zone
information and will be present in the unsolicited result code for extended time
zone and local time reporting if the universal time is provided by the network.
String type
Value representing the universal 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). The universal time can be provided by the
network at the time of delivering time zone information and will be present in the
unsolicited result code for extended time zone and universal time reporting if
provided by the network.
Example
AT+CTZR=3
OK
AT+CTZR?
+CTZR: 3
OK
AT+CTZR=?
+CTZR: (0,1,3)
OK
2.2.41 AT+CRCES reading coverage enhancement status
This command returns the coverage enhancement status of the MT. The terminal can consider the
coverage enhancement status prior to deciding to transmit data. Depending on the coverage
enhancement status the terminal can refrain from transmitting data.
The coverage enhancement status is only provided by the MT if the access technology of the serving cell
is E-UTRAN, EC-GSM-IoT or E-UTRAN (NB-S1 mode). If the access technology of the serving cell is
different, <Act>=0 is indicated.
AT+CRCES Response
+CRCES: <AcT>,<CE_level>,<CC>
Execution Command
AT+CRCES
Test Command OK
AT+CRCES=? Response
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE
Parameter INTEGER TYPE; ACCESS TECHNOLOGY OF THE SERVING CELL.
<ACT>
<CE_LEVEL> 0 Location disclosure allowed.
1 E-UTRAN.
<CC> 2 EC-GSM-IoT (A/Gb mode)
3 E-UTRAN (NB-S1 mode)
Example Integer type; Coverage Enhancement (CE) level of the MT in the serving cell.
Applicable only if <Act>=1 (E-UTRAN) or <Act>=1 (E-UTRAN).
AT+CRCES 0 No Coverage Enhancement in the serving cell
+CRCES: 1,1,0 1 Coverage Enhancement level 0
OK 2 Coverage Enhancement level 1
AT+CRCES=? 3 Coverage Enhancement level 2
OK 4 Coverage Enhancement level 3
Integer type; Coverage Class (CC) of the MT in the serving cell. Applicable only
if <Act>=2 (EC-GSMIoT).
0 No Coverage Class in the serving cell
1 Coverage Class 1
2 Coverage Class 2
3 Coverage Class 3
4 Coverage Class 4
5 Coverage Class 5
2.2.42 AT+CIPCA initial PDN context activation
The set command controls whether an initial PDP context (see subclause 10.1.0) shall be established
automatically following an attach procedure when the UE is attached to GERAN or UTRAN RATs and
whether the UE is attached to E-UTRAN with or without a PDN connection.
The read command returns the current setting of the command.
The test command returns values supported as a compound value.
AT+CIPCA
Set Command Response
AT+CIPCA=[<n>[,<Attach OK
WithoutPDN>]] If there is any error, response:
+CME ERROR: <err>
Read Command Response
AT+CIPCA? +CIPCA: <n>[,<AttachWithoutPDN>]
OK
Test Command Response
AT+CIPCA=? +CIPCA: (list of supported <n>s),(list of
supported <AttachWithoutPDN>s)
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE
Parameter INTEGER TYPE. ACTIVATION OF PDP CONTEXT UPON ATTACH.
0 Do not activate(Not support)
<N> 1 Always activate(Not support)
2 Activate when not roaming(Not support)
< 3 No change in current setting
ATTACHWITHOUTPDN> Integer type. EPS Attach with or without PDN connection.
0 EPS Attach with PDN connection
1 EPS Attach without PDN connection
Example
AT+CIPCA=3,0
OK
AT+CIPCA?
+CIPCA: 3,0
OK
AT+CIPCA=?
+CIPCA: (3),(0-1)
OK
2.2.43 AT+CGMI request manufacturer identification
Execution command causes the TA to return one or more lines of information text <manufacturer>,
determined by the MT manufacturer, which is intended to permit the user of the TA to identify the
manufacturer of the MT to which it is connected to. Typically, the text will consist of a single line
containing the name of the manufacturer, but manufacturers may choose to provide more information if
desired.
AT+CGMI Response
+CGMI: <manufacturer>
Execution Command
AT+CGMI
Test Command OK
AT+CGMI=? Response
+CGMI: < manufacturer_ID>
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE
Example
AT+CGMI
+CGMI: "eigencomm"
OK
AT+CGMI=?
+CGMI:<manufacturer_ID>
OK
2.2.44 AT+CGMM request model identification
Execution command causes the TA to return one or more lines of information text <model>, determined
by the MT manufacturer, which is intended to permit the user of the TA to identify the specific model of
the MT to which it is connected to. Typically, the text will consist of a single line containing the name of
the product, but manufacturers may choose to provide more information if desired.
AT+CGMM Response
+CGMM: <model>
Execution Command
AT+CGMM
Test Command OK
AT+CGMM=? Response
+CGMM: <model>
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE
Example
AT+CGMM
+CGMM: "eigencomm","EC618"
OK
AT+CGMM=?
+CGMM:<list of supported technologies>,<model>
OK
2.2.45 AT+CPINR remaining PIN retries
Execution command and set command cause the MT to return the number of remaining PIN retries for
the MT passwords with intermediate result code +CPINR: <code>,<retries>[,<default_retries>] for
standard PINs.
AT+CPINR Response
+CPINR:
Set Command <code>,<retries>[,<default_retries>]
AT+CPINR=<code>
OK
Execution Command If there is any error, response:
AT+CPINR +CME ERROR: <err>
Response
+CPINR:
<code>,<retries>[,<default_retries>]
+CPINR:
<code>,<retries>[,<default_retries>]
OK
Test Command If there is any error, response:
+CME ERROR: <err>
Response
AT+CPINR=? OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter TYPE OF PIN. ALL VALUES LISTED UNDER THE DESCRIPTION OF THE
AT+CPIN COMMAND, <CODE> PARAMETER EXCEPT `READY'.
<CODE> Integer type; Number of remaining retries per PIN.
Integer type; Number of default/initial retries per PIN.
<RETRIES>
<DEFAULT_RETRIES>
Example
AT+CPINR="SIM PIN"
+CPINR: "SIM PIN",3,3
OK
AT+CPINR
+CPINR: "SIM PIN",3,3
+CPINR: "SIM PUK",10,10
+CPINR: "SIM PIN2",3,3
+CPINR: "SIM PUK2",10,10
OK
2.2.46 AT+CGAUTH define PDP context authentication parameters
Set command allows the TE 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. Refer subclause
9.2 for possible <err> values.
The read command returns the current settings for each defined context.
The test command returns values supported as compound values
AT+CGAUTH Response
OK
Set Command If there is any error, response:
AT+CGAUTH=<cid>[,<auth_proto>[, +CME ERROR: <err>
<userid>[,<password>]]] Response
[+CGAUTH:
Read Command <cid>,<auth_proto>,<userid>,<pass
AT+CGAUTH? word>]
[<CR><LF>+CGAUTH:
<cid>,<auth_proto>,<useri
d>,<password>[...]]
Test Command OK
AT+CGAUTH=? Response
+CGAUTH: (range of supported <cid>s),(list
Maximum Response Time of supported <auth_proto>s),(range of
Parameter Saving Mode supported <userid>s),(range of supported
<password>s)
5s
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT DEFINITION. THE PA
<CID> TO THE TE-MT INTERFACE AND IS USED IN OTHER PDP CONTEXT-RELATED C
<AUTH_PROTO>
RANGE OF PERMITTED VALUES IS RETURNED BY THE TEST FORM OF THE CO
<USERID>
<PASSWORD> <CID> VALUES OF 1-15 ARE SUPPORTED.
Integer type
0 None. Used to indicate that no authentication protocol is used for this PD
1 PAP
2 CHAP
The default value is 0
STRING TYPE
USERID STRING, THE MAX LENGTH IS 64 CHARACTERS WITH 1 LINE END MA
THE DEFAULT VALUE IS ""(NULL)
STRING TYPE
PASSWORD STRING, THE MAX LENGTH IS 64 CHARACTERS WITH 1 LINE END
THE DEFAULT VALUE IS ""(NULL)
Example
AT+CGAUTH=?
+CGAUTH: (1-15),(0-2),(64),(64)
OK
AT+CGAUTH?
+CGAUTH: 1,0,"",""
OK
AT+CGAUTH=1,1,"userid","psw"
OK
2.2.47 AT+IPR set UE baud rate
Set command sets the UE baud rate to be used.
Read command returns the current baud rate.
Test command returns baud rates supported by the UE.
AT+IPR Response
OK
Set Command
AT+IPR=<rate>
Read Command If there is any error, response:
AT+IPR? +CME ERROR: <err>
Response
+IPR:<rate>
Test Command OK
AT+IPR=? Response
+IPR:(list of supported auto detectable <rate> values),(list
of fixed-only <rate> values)
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE
Parameter BAUD RATE AT WHICH THE UE WILL ACCEPT COMMANDS.
NOTE:
<RATE> 1. IF THIS VALUE IS 0 FOR SET COMMAND, UE WILL ENTER AUTO BAUD
RATE DETECTION MODE AND `AT' OR `AT' SHALL BE SENT FOR BAUD
RATE DETECTION.
2. IF THIS VALUE IS 0 FOR SET COMMAND, THE CHARACTER FORMAT IS
FORCED TO 8 DATA, NONE PARITY, 1 STOP, +ICF=3(SEE AT+ICF
SECTION)
3. AUTO BAUD FEATURE IS NOT SUPPORTED ON EC618
Example
AT+IPR=115200
OK
AT+IPR?
+IPR:115200
OK
AT+IPR=?
+IPR:(600,1200,2400,4800,9600,19200,38400,57600,115200,230400),(0,300,600,1200,2400,4800,9
600,19200,38400,57600,115200,230400,460800)
OK
2.2.48 AT+ICF set UE serial port character framing
Set command sets the UE character framing to be used.
Read command returns the current character framing.
Test command returns character framing supported by the UE.
AT+ICF Response
OK
Set Command
AT+ICF=<format>[,<parity>]
Read Command If there is any error, response:
AT+ICF? +CME ERROR: <err>
Response
+ICF:<format>,<parity>
Test Command OK
AT+ICF=? Response
+ICF:(list of supported <format> values),(list of supported
<parity> values)
Maximum Response Time OK
Parameter Saving Mode 5s
SAVE
Parameter INTEGER TYPE. IT DETERMINES THE NUMBER OF BITS IN THE DATA
BITS, THE PRESENCE OF A PARITY BIT, AND THE NUMBER OF STOP BITS
<FORMAT> IN THE START-STOP FRAME
1 8 Data; 2 Stop
2 8 Data; 1 Parity; 1 Stop
3 8 Data; 1 Stop
4 7 Data; 2 Stop
<PARITY> 5 7 Data; 1 Parity; 1 Stop
6 7 Data; 1 Stop
Integer type. It determines how the parity bit is generated and checked, if
present
0 Odd
1 Even
Example
AT+ICF=2,1 // Set as 8 data, even parity, 1 stop
OK
AT+ICF?
+ICF:2,1
OK
AT+ICF=?
+ICF:(1-6),(0-1)
OK
2.2.49 AT+CNUM request subscriber number
Action command returns the MSISDNs (up to 4) related to the subscriber stored in the USIM.
AT+CNUM Response
[+CNUM: [<alpha>],<number>,<type>]
Set Command [+CNUM: [<alpha>],<number>,<type>]
AT+CNUM [...]
Test Command OK
AT+CNUM=? If there is any error, response:
Maximum Response Time +CME ERROR: <err>
Parameter Saving Mode Response
OK
5s
NO_SAVE
Parameter STRING TYPE
Optional alphanumeric string associated with <number>
<ALPHA> String type
Phone number of format specified by <type>
<NUMBER>
<TYPE> Type of address octet in integer format (refer 3GPP TS24.008
subclause 10.5.4.7), e.g.
129 Unknown type
145 International type (use "+" for international access code)
161 National type
2.2.50 AT+CEER extended error report
Execution command causes the TA to return one or more lines of information text <report>, determined
by the MT manufacturer, which should offer the users of the TA an extended report of the reason for the
last unsuccessful attach
AT+CEER Response
+CEER: <report>
Execution Command
AT+CEER
Maximum Response Time OK
Parameter Saving Mode If there is any error, response:
+CME ERROR: <err>
5s
NO_SAVE
Parameter STRING TYPE
The total number of characters, including line terminators, in the
<REPORT> information text shall not exceed 2041 characters.
2.2.51 AT+CEMODE UE modes of operation for EPS
The set command is used to set the MT to operate according to the specified mode of operation for EPS,
see 3GPP TS 24.301 [83]. If the requested mode of operation is not supported, an ERROR or +CME
ERROR response is returned. Extended error responses are enabled by the +CMEE command.
The read command returns the mode of operation set by the TE, independent of the current serving cell
capability and independent of the current serving cell Access Technology.
The test command is used for requesting information on the supported MT modes of operation as a
compound value.
AT+CEMODE
Set Command Response
AT+CEMODE=<mode> OK
If there is any error, response:
Read Command +CME ERROR: <err>
AT+CEMODE? Response
Test Command +CEMODE: <mode>
AT+CEMODE=? OK
Maximum Response Time Response
Parameter Saving Mode +CEMODE: (list of supported <mode>s)
OK
Parameter 5s
NO_SAVE
<MODE>
INTEGER TYPE; INDICATES THE MODE OF OPERATION. THE
Example DEFAULT VALUE IS MANUFACTURER SPECIFIC
0 PS mode 2 of operation
AT+CEMODE=?
+CEMODE: (0,1,2,3) 1 CS/PS mode 1 of operation
OK
AT+CEMODE? 2 CS/PS mode 2 of operation
+CEMODE: 1
OK 3 PS mode 1 of operation
AT+CEMODE=3
OK
2.2.52 AT+IFC set UE local flow control
Set command sets the UE local flow control to be used.
Read command returns the current local flow control.
Test command returns local flow control supported by the UE.
AT+IFC
Set Command Response
AT+IFC=<DCE_by_DTE>,<DTE_by_DCE> OK
Read Command If there is any error, response:
AT+IFC? +CME ERROR: <err>
Response
+IFC:<DCE_by_DTE>,<DTE_by_DCE>
Test Command OK
AT+IFC=? Response
+IFC: (0,2),(0,2) i.e. lists of supported <DCE_by_DTE>
and list of supported <DTE_by_DCE>
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE
Parameter INTEGER TYPE. IT SPECIFIES THE METHOD TO BE USED BY THE DTE TO
CONTROL THE FLOW OF RECEIVED DATA FROM THE DCE
<DCE_BY_DTE> 0 none
2 RTS
<DTE_BY_DCE> Integer type. It specifies the method to be used by the DCE to control the flow of
transmitted data from the DTE
0 none
2 CTS
2.2.53 AT+CPOL Preferred PLMN list
This command is used to edit the PLMN selector with Access Technology lists in the active application in
the UICC (USIM).
Execute command writes an entry in the USIM list of preferred PLMNs in the User controlled PLMN
selector with Access Technology, EFPLMNwAcT. If <index> is given but <oper> is left out, entry is deleted.
If <oper> is given but <index> is left out, <oper> is put in the next free location. If only <format> is
given, the format of the <oper> in the read command is changed. The Access Technology selection
parameters, <GSM_AcT>, <GSM_Compact_AcT> and <UTRAN_AcT> and <E-UTRAN_AcT> are required,
see 3GPP TS 31.102. Refer sub clause 9.2 for possible <err> values.
Read command returns all used entries from the USIM list of preferred PLMNs, previously selected by the
command +CPLS, with the Access Technologies for each PLMN in the list.
AT+CPOL
Set Command Response
AT+CPOL=[<index>][,<format>[,<oper> OK
[,<GSM_AcT>,<GSM_Compact_AcT>,
<UTRAN_AcT>,<E-UTRAN_AcT>]]] If there is any error, response:
+CME ERROR: <err>
Read Command Response
AT+CPOL? +CPOL: <index1>,<format>,<oper1>
[,<GSM_AcT1>,<GSM_Compact_AcT1>,
<UTRAN_AcT1>,<E-UTRAN_AcT1>]
[<CR>,<LF>+CPOL: <index2>,<format>,
<oper2>[,<GSM_AcT2>,<GSM_Compact_AcT2>
,<UTRAN_AcT2>,<E-UTRAN_AcT2>]
[...]]
OK
Test Command If there is any error, response:
AT+CPOL=? +CME ERROR: <err>
Response
+CPOL: (list of supported <index>s),(list of
supported <format>s)
OK
Maximum Response Time If there is any error, response:
Parameter Saving Mode +CME ERROR: <err>
5s
NO_SAVE
Parameter INTEGER TYPE
The order number of operator in the USIM preferred operator list.
<INDEXN> Integer type
<FORMAT> 0 long format alphanumeric <oper>
1 short format alphanumeric <oper>
<OPERN> 2 numeric <oper>
<GSM_ACTN> string type
<format> indicates if the format is alphanumeric or numeric (see +COPS)
integer type; GSM access technology:
<GSM_COMPACT_ACTN> 0 access technology not selected
<UTRAN_ACTN> 1 access technology selected
<E-UTRAN_ACTN> integer type; GSM compact access technology
0 access technology not selected
1 access technology selected
integer type; UTRAN access technology
0 access technology not selected
1 access technology selected
integer type; E-UTRAN access technology
0 access technology not selected
1 access technology selected
Example
AT+CPOL=1,2,"46000",0,0,0,1
OK
AT+CPOL?
+CPOL=1,2,"46000",0,0,0,1
OK
AT+CPOL=?
OK
2.2.54 AT+CPLS Selection of preferred PLMN list
This command is used to select one PLMN selector with Access Technology list in the active application
in the UICC (USIM), that is used by +CPOL command.
Execute command selects a list in the USIM. Refer subclause 9.2 for possible <err> values.
Read command returns the selected PLMN selector list from the USIM.
Test command returns the whole index range supported lists by the USIM as a compound value.
AT+CPLS Response
OK
Set Command
AT+CPLS=[<list>]
Read Command If there is any error, response:
+CME ERROR: <err>
Response
AT+CPLS? +CPLS: <list>
OK
Test Command If there is any error, response:
AT+CPLS=? +CME ERROR: <err>
Response
+CPLS: (list of supported <list>s)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Parameter INTEGER TYPE.
0 User controlled PLMN selector with Access Technology EFPLMNwAcT
<LIST> 1 Operator controlled PLMN selector with Access Technology EFOPLMNwAcT
2 HPLMN selector with Access Technology EFHPLMNwAcT
Example
AT+CPLS=1
OK
AT+CPLS?
+CPLS: 1
OK
AT+CPLS=?
+CPLS: 0,1,2
OK
2.2.55 AT+CSODCP sending of originating data via the control plane
The set command is used by the TE to transmit data over control plane to network via MT. Context
identifier <cid> is used to link the data to particular context.
This command optionally indicates that the application on the MT expects that the exchange of data:
- will be completed with this uplink data transfer; or
- will be completed with the next received downlink data.
This command also optionally indicates whether or not the data to be transmitted is an exception data.
This command causes transmission of an ESM DATA TRANSPORT message, as defined in 3GPP TS
24.301.
AT+CSODCP Response
OK
Set Command If there is any error, response:
AT+CSODCP=<cid>,<cpdata_length>,<c +CME ERROR: <err>
pdata>[,<RAI>[,<type_of_user_data>
]]
Test Command Response
AT+CSODCP=? +CSODCP: (range of supported <cid>s),(maximum
number of octets of user data indicated by
Maximum Response Time <cpdata_length>),(list of supported <RAI>s),(list
Parameter Saving Mode of supported <type_of_user_data>s)
5s
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT
DEFINITION.
<CID> <CID> VALUES OF 0-10 ARE SUPPORTED.
NOTE:
<CPDATA_LENGTH> IF <CID> SET TO 0, JUST USE CURRENT DEFAULT BEARER
<CPDATA> TO SEND THIS ORIGINATING DATA.
<RAI> Integer type. Indicates the number of octets of the <cpdata>
information element. The max length is 950.
<TYPE_OF_USER_DATA> string of octets.
Integer type. Indicates the value of the release assistance
indication
0 No information available
1 The MT expects that exchange of datawill be completed
with the transmission of the ESM DATA
TRANSPORT message.
2 The MT expects that exchange of data will be completed
with the receipt of an ESM DATA TRANSPORT
message.
Integer type. Indicates whether the user data that is transmitted is
regular or
exceptional.
0 Regular data
1 Exception data
Example
AT+CSODCP=0,20,"A1B2C3E4F50011223344A1B2C3E4F50011223344",0,0
OK
2.2.56 AT+CRTDCP reporting of terminating data via the control plane
The set command is used to enable and disable reporting of data from the network to the MT that is
transmitted via the control plane in downlink direction. If reporting is enabled, the MT returns the
unsolicited result code +CRTDCP: <cid>,<cpdata_length>,<cpdata> when data is received from
the network.
AT+CRTDCP Response
OK
Set Command If there is any error, response:
AT+CRTDCP=[<reporting>] +CME ERROR: <err>
Response
Read Command +CRTDCP: <reporting>
AT+CRTDCP? OK
Response
Test Command +CRTDCP: (list of supported <reporting>s),(range of
AT+CRTDCP=? supported <cid>s),(maximum number of octets of user
dataindicated by <cpdata_length>)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Parameter INTEGER TYPE, CONTROLLING REPORTING OF MOBILE
TERMINATED CONTROL PLANE DATA EVENTS
<REPORTING> 0 Disable reporting of MT control plane data.
1 Enable reporting of MT control plane data by the unsolicited
<CID>
result code +CRTDCP.
<CPDATA_LENGTH> Integer type. A numeric parameter which specifies a particular PDP
<CPDATA> context or EPS bearer context definition. The <cid> parameter is
local to the TE-MT interface and identifies the PDP or EPS bearer
contexts which have been setup via AT command (see the
+CGDCONT commands).
<cid> values of 0-10 are supported.
Integer type. Indicates the number of octets of the <cpdata>
information element. When there is no data to transmit, the value
shall be set to zero.
string of octets. Contains the user data container contents (refer
3GPP TS 24.301 [83] subclause 9.9.4.24). When there is no data to
transmit, the <cpdata> shall be an empty string (""). And support
"HEX" character format type.
Example
AT+CRTDCP=0
OK
AT+CRTDCP?
+CRTDCP: 0
OK
AT+CRTDCP=1
OK
AT+CRTDCP?
+CRTDCP: 1
OK
2.2.57 ATD Request packet domain service
This command is used to request packet domain service and causes the MT to enter the V.250 online data
state.
ATD Response
If connection is successfully:
Set Command CONNECT
ATD*<GPRS_SC>[*[<called_address>][*[<L2P>]
[*[<cid>]]]]#
If connection cannot be established:
NO CARRIER
Maximum Response Time If there is any error, response:
Parameter Saving Mode +CME ERROR: <err>
5s
NO_SAVE
Parameter STRING TYPE. GPRS SERVICE CODE
99 identifies a request to use the Packet Domain service
<GPRS_SC>
<CALLED_ADDRESS> String type. The called party in the address space applicable to the PDP
<L2P> Note: This item is currently not supported
<CID> String type. The layer 2 protocol to be used
PPP or 1 (Equivalent to PPP)
Integer type. Specifies a particular PDP context definition
1-15.
Example
ATD*99#
CONNECT
2.3 3GPP Commands (27.005)
2.3.1 AT+CMGS send message
Execution command sends message from a TE to the network (SMS-SUBMIT). Message reference
value <mr> is returned to the TE on successful message delivery. Value can be used to identify message
upon unsolicited delivery status report result code. If sending fails in a network or an ME error, final result
code +CMS ERROR: <err> is returned. See chapter Message Service Failure Result Code for a list of
<err> values. This command should be abortable.
AT+CMGS If sending successful:
+CMGS: <mr>
Set Command If there is any error, response:
If text mode(AT+CMGF=1): +CMS ERROR: <err>
AT+CMGS=<da>[,<toda>]<CR>
Text is entered<ctrl-Z/ESC>
if PDU mode(+CMGF=0): if PDU mode (+CMGF=0) and sending successful:
+CMGS=<length><CR> +CMGS: <mr>[,<ackpdu>]
PDU is given<ctrl-Z/ESC> if sending fails:
+CMS ERROR: <err>
Maximum Response Time 60s
Parameter Saving Mode NO_SAVE
Parameter STRING TYPE; IN TEXT MODE (AT+CMGF=1)
Destination address
<DA> integer type; Type of destination address
3GPP TS 23.040 [3] TP-Message-Reference in integer format.
<TODA>
<MR> indicate the number of octets coded in the TP layer data unit to be
<LENGTH> given (i.e. SMSC address octets are excluded)
Example
AT+CMGF=1(TEXT mode)
OK
AT+CMGS="1064899990000"
>TEST
CTRL+Z(1A(hex))
+CMGS: 1
OK
AT+CMGF=0(PDU mode)
OK
AT+CMGS=155
>0891683108100065F9910C0D81014698195030F30000A79F54741914AFA7C76B9058FEBEBB41E6371EA4AEB7E
173D0DB5E9683E8E832881DD6E741E4F7F9340789C3E3B50BB40CD7CD6537689A2E83926879590E32CAC375903
D5D9683C4E578BDDC2E83A065B6BEEC02B540B0986C46ABD96EB81CA805A2228BA06835395C8284D2E7D509323
EB12065B5099D829ED6A21444451641CCA0360B223E8FA72948181C2E01
CTRL+Z(1A(hex))
+CMGS: 1
OK
Note for PDU mode:
SMS text: The quick brown fox jumps over the lazy dog's back. Kaufen Sie Ihrer Frau vier
bequeme Pelze. - 0123456789 - THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG'S BACK
RP-Destination Address(destination Service Centre address): 8613800100569
2.3.2 AT+CSCA service center address
Set command updates the SMSC address, through which mobile originated SMs are transmitted. In text
mode, setting is used by send and write commands. In PDU mode, setting is used by the same
commands, but only when the length of the SMSC address coded into <pdu> parameter equals zero.
AT+CSCA Response
OK
Set Command If there is any error, response:
AT+CSCA=<sca>[,<tosca>] +CMS ERROR: <err>
Response
Read Command +CSCA: <sca>,<tosca>
AT+CSCA? 5s
Maximum Response Time NO_SAVE
Parameter Saving Mode
Parameter STRING TYPE; 3GPP TS 24.011 [6] RP SC ADDRESS ADDRESS-
VALUE FIELD IN STRING FORMAT; BCD NUMBERS (OR
<SCA> GSM 7-BIT DEFAULT ALPHABET CHARACTERS) ARE
CONVERTED TO CHARACTERS
<TOSCA> Integer type. 3GPP TS 24.011 [6] RP SC address Type-of-Address
octet in integer format (when first character of <da> is + (IRA 43),
Example default value is 145, otherwise default value is 129).
AT+CSCA="8613800200569"
OK
AT+CSCA?
+CSCA: "8613800200569",129
OK
2.3.3 AT+CMGF message format
Set command tells the TA, which input and output format of messages to use. <mode> indicates the
format of messages used with send, list, read and write commands and unsolicited result codes resulting
from received messages. Mode can be either PDU mode (entire TP data units used) or text mode
(headers and body of the messages given as separate parameters).
Test command returns supported modes as a compound value.
AT+CMGF Response
OK
Set Command If there is any error, response:
AT+CMGF=<mode> +CMS ERROR: <err>
Response
Read Command +CMGF: <mode>
AT+CMGF? Response
Test Command +CMGF: (list of supported <mode>s)
AT+CMGF=? 5s
Maximum Response Time NO_SAVE
Parameter Saving Mode Note: AT&W will save <mode> to NVM.
Parameter INTEGER TYPE;
<MODE>
0 PDU mode
1 Text mode
Example
AT+CMGF=1
OK
AT+CMGF?
+CMGF: 1
OK
2.3.4 AT+CSMP set text mode parameters
Set command is used to select values for additional parameters needed when SM is sent to the network
or placed in a storage when text format message mode is selected. It is possible to set the validity period
starting from when the SM is received by the SMSC (<vp> is in range 0... 255) or define the absolute
time of the validity period termination (<vp> is a string). The format of <vp> is given by <fo>. If TA
supports the EVPF, see 3GPP TS 23.040 [3], it shall be given as a hexadecimal coded string (refer e.g.
<pdu>) with double quotes.
AT+CSMP Response
OK
Set Command If there is any error, response:
AT+CSMP=<fo>[,<vp>[,<pid>[,<dcs>]] +CMS ERROR: <err>
] Response
+CSMP: <fo>,<vp>,<pid>,<dcs>
Read Command 5s
AT+CSMP? AUTO_SAVE
Maximum Response Time
Parameter Saving Mode
Parameter INTEGER TYPE;
First octet for sms submit pdu,status report required
<FO> integer type;
<VP> Validity period
<PID> integer type;
<DCS> Protocol identifier
integer type;
Data coding scheme
Example
AT+CSMP=33,167,0,0
OK
AT+CSMP?
+CSMP: 33,167,0,0
OK
2.3.5 AT+CSMS select message service
Set command selects messaging service <service>. It returns the types of messages supported by the
ME: <mt> for mobile terminated messages, <mo> for mobile originated messages and <bm> for
broadcast type messages. If chosen service is not supported by the ME (but is supported by the TA),
final result code +CMS ERROR: <err> shall be returned. See chapter Message Service Failure Result
Code for a list of <err> values.
Also read command returns supported message types along the current service setting.
Test command returns a list of all services supported by the TA.
AT+CSMS Response
+CSMS: <mt>,<mo>,<bm>
Set Command OK
AT+CSMS=<service> If there is any error, response:
+CMS ERROR: <err>
Read Command Response
AT+CSMS? +CSMS: <service>,<mt>,<mo>,<bm>
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Note: AT&W will save <service> to NVM.
Parameter INTEGER TYPE;
<SERVICE> 0 3GPP TS 23.040 and 3GPP TS 23.041.
<MT> 1 3GPP TS 23.040 [3] and 3GPP TS 23.041 [4] the requirement of
<MO>
<service> setting 1 is mentioned under corresponding command
descriptions).
Integer type; Mobile Terminated Message
0 Type not supported
1 Type supported
Integer type; Mobile Originated Message
0 Type not supported
1 Type supported
<BM> Integer type; Broadcast type Message
Example 0 Type not supported
AT+CSMS=0 1 Type supported
+CSMS: 1,1,0
OK
AT+CSMS=1
+CSMS: 1,1,0
OK
AT+CSMS?
+CSMS:1,1,1,0
OK
2.3.6 AT+CPMS set preferred message storage
Set command selects memory storages <mem1>, <mem2> and <mem3> to be used for reading, writing,
etc. If chosen storage is not appropriate for the ME, final result code +CMS ERROR: <err> shall be
returned.
Test command returns lists of memory storages supported by the TA.
AT+CPMS Response
+CPMS:
Set Command <used1>,<total1>,<used2>,<total2>,<used
AT+CPMS=<mem1>[,<mem2>[,<mem3>]] 3>,<total3>
OK
Read Command If there is any error, response:
AT+CPMS? +CMS ERROR: <err>
Response
+CPMS:
<mem1>,<used1>,<total1>,<mem2>,<used2>,
<total2>,<mem3>,<used3>,<total3>
Maximum Response Time 5s
Parameter Saving Mode AUTO_SAVE
Parameter
<MEM1> STRING TYPE; THE MEMORY STORAGE FROM WHICH MESSAGE ARE READ
<MEM2> AND DELETED.
<MEM3> "SM" (U)SIM message storage
<USED1> "ME" Mobile Equipment(ME) message storage
<USED2>
<USED3> "MT" any of the storage associated with ME(same as "ME" storage)
<TOTAL1>
<TOTAL2> "BM" broadcast message storage(current not support)
<TOTAL3>
"SR" SMS status report storage
String type; The memory storage to which writing and sending operation are made.
Refer <mem1> for defined values.
"SM" (U)SIM message storage
"ME" Mobile Equipment(ME) message storage
"MT" any of the storage associated with ME(same as "ME" storage)
"BM" broadcast message storage(current not support)
"SR" SMS status report storage
String type; The memory storage to which received SMS message are preferred to
be stored. Refer <mem1> for defined values.
"SM" (U)SIM message storage
"ME" Mobile Equipment(ME) message storage
"MT" any of the storage associated with ME(same as "ME" storage)
"BM" broadcast message storage(current not support)
"SR" SMS status report storage
integer type;
Number of current message in <mem1>
integer type;
Number of current message in <mem2>
integer type;
Number of current message in <mem3>
integer type;
Total number of message which can be stored in <mem1>
integer type;
Total number of message which can be stored in <mem2>
integer type;
Total number of message which can be stored in <mem3>
Example
AT+CPMS="SM","SM","SM"
+CPMS: 0,60,0,60,0,60
OK
AT+CPMS?
+CPMS: "SM",0,60, "SM",0,60, "SM",0,60
OK
2.3.7 AT+CSDH show text mode parameters
Set command controls whether detailed header information is shown in text mode result codes.
Test command returns supported values as a compound value.
AT+CSDH Response
OK
Set Command If there is any error, response:
AT+CSDH=<show> +CMS ERROR: <err>
Response
Read Command +CSDH: <show>
AT+CSDH?
Test Command Response
AT+CSDH=? +CSDH: (list of support <show>s)
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Note: AT&W will save <show> to NVM.
Parameter INTEGER TYPE;
<SHOW>
0 do not show header values defined in commands +CSCA and +CSMP
(<sca>, <tosca>, <fo>, <vp>, <pid> and <dcs>) nor <length>, <toda> or
<tooa> in +CMT, +CMGL, +CMGR result codes for SMSDELIVERs and SMS-
SUBMITs in text mode; for SMS-COMMANDs in +CMGR result code, do not
show <pid>, <mn>, <da>, <toda>, <length> or <cdata>
1 Show the values in result codes.
Example
AT+CSDH=1
OK
AT+CSDH?
+CSDH: 1
OK
2.3.8 AT+CNMI new message reporting configuration
Set command selects the procedure, how receiving of new messages from the network is indicated to
the TE when TE is active, e.g. DTR signal is ON. If TE is inactive (e.g. DTR signal is OFF), message
receiving should be done as specified in 3GPP TS 23.038 [2].
Test command gives the settings supported by the TA as compound values.
AT+CNMI Response
OK
Set Command If there is any error, response:
AT+CNMI=[<mode>[,<mt>[,<bm>[,<ds>[ +CMS ERROR: <err>
,<bfr>]]]]] Response
+CNMI: <mode>,<mt>,<bm>,<ds>,<bfr>
Read Command
AT+CNMI?
Test Command Response
AT+CNMI=? +CNMI: (list of supported <mode>s),(list of supported
<mt>s),(list of supported <bm>s),(list of supported
Maximum Response Time <ds>s),(list of supported <bfr>s)
Parameter Saving Mode 5s
AUTO_SAVE
Parameter INTEGER TYPE;
<MODE> CONTROLS THE PROCESSING OF UNSOLICITED RESULT CODES SPECIFIED
<MT> WITHIN THIS COMMAND, THE
SETTING AFFECTS ONLY TO UNSOLICITED RESULT CODES SPECIFIED WITHIN
THIS COMMAND.
0 Buffer unsolicited result codes in the TA. If TA result code buffer is full,
indications can be buffered in some other place or the oldest indications may
be discarded and replaced with the new received indications
1 Discard indication and reject new received message unsolicited result codes
when TA-TE link is reserved (e.g. in on-line data mode). Otherwise forward
them directly to the TE.
2 Buffer unsolicited result codes in the TA when TA-TE link is reserved (e.g. in
on-line data mode) and flush them to the TE after reservation. Otherwise
forward them directly to the TE.
3 Forward unsolicited result codes directly to the TE. TA-TE link specific inband
technique used to embed result codes and data when TA is in on-line data
mode.
Integer type;
Controls the processing of unsolicited result codes specified within this command, the
setting affects only to unsolicited result codes specified within this command.
0 No SMS-DELIVER indications are routed to the TE.
1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is
routed to the TE using unsolicited result code:
+CMTI: <mem>,<index>
2 SMS-DELIVERs (except class 2 messages and messages in the message
waiting indication group (store message)) are routed directly to the TE using
unsolicited result code:
+CMT: [<alpha>],<length><CR><LF><pdu> (PDU mode enabled); or
+CMT: <oa>,[<alpha>],<scts>[,<tooa>,<fo>,<pid>,<dcs>,<sca>,<tosca>,<lengt
h>]<CR><LF><data> (text mode enabled; about parameters in italics, refer
command Show Text Mode Parameters +CSDH)
Class 2 messages and messages in the message waiting indication group
(store message) result in indication as defined in <mt>=1.
3 Class 3 SMS-DELIVERs are routed directly to TE using unsolicited result
codes defined in <mt>=2. Messages of other data coding schemes result in
indication as defined in <mt>=1.
<BM> Integer type;
<DS> The rules for storing received CBMs depend on its data coding scheme (refer 3GPP TS
<BFR>
23.038[2]), the setting of Select CBM Types (+CSCB) and this value is: (current not
Example
support)
0 No CBM indications are routed to the TE.
1 If CBM is stored into ME/TA, indication of the memory location is routed to the
TE using unsolicited result code:
+CBMI: <mem>,<index>
2 New CBMs are routed directly to the TE using unsolicited result code:
+CBM: <length><CR><LF><pdu> (PDU mode enabled); or
+CBM: <sn>,<mid>,<dcs>,<page>,<pages><CR><LF><data> (text mode enabled)
Integer type;
0 No SMS-STATUS-REPORTs are routed to the TE
1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code:
+CDS: <length><CR><LF><pdu> (PDU mode enabled); or
+CDS: <fo>,<mr>,[<ra>],[<tora>],<scts>,<dt>,<st> (text mode enabled)
2 If SMS-STATUS-REPORT is stored into ME/TA, indication of the memory
location is routed to the TE using unsolicited result code:
+CDSI: <mem>,<index>
Integer type; (current not support)
0 TA buffer of unsolicited result codes defined within this command is flushed to
the TE when <mode> 1...3 is entered (OK response shall be given before
flushing the codes).
1 TA buffer of unsolicited result codes defined within this command is cleared
when <mode> 1...3 is entered.
AT+CNMI=?
+CNMI: (0-3),(0-3),(0-3),(0-2),(0-1)
OK
AT+CNMI=2,1,0,1,0 (send SM and status report indications to TE when TA in command mode,
otherwise buffer)
OK
+CMTI: "ME",2 (new message received and saved in index 2)
2.3.9 AT+CNMA New message Acknowledgement to UE/TE
For Text mode:
Execution command confirms correct reception of a new message (SMS-DELIVER or SMS-STATUS-
REPORT) which is routed directly to the TE (refer command +CNMI). This acknowledgement command
(causing ME to send RP-ACK to the network) shall be used when +CSMS parameter <service> equals
1. TA shall not send another +CMT or +CDS result code to TE before previous one is acknowledged.
For PDU mode:
Set command can send either positive (RPACK) or negative (RP-ERROR) acknowledgement to the
network. Parameter <n> defines which one will be sent.
AT+CNMA Possible response(s):
+CMS ERROR: <err>
Set Command
If Text mode(+CMGF=1)
AT+CNMA
If PDU mode(+CMGF=0) 5s
AT+CNMA[=<n>[,<length>[<CR> AUTO_SAVE
PDU is given<ctrl-Z/ESC>]]]
Maximum Response Time
Parameter Saving Mode
Parameter INTEGER TYPE;
<N>
0 Command operates similarly as defined for the text mode
1 Send RP-ACK to the network, accept only in PDU mode.
2 Send RP-ERROR (ME/TA shall send SMS-DELIVER REPORT with 3GPP
TS 23.040[3] TP-FCS value set to 'FF' (unspecified error cause).
Example
AT+CSMS=1
+CSMS: 1,1,1
OK
+CMT: "106499990000","19.05.16 16:27:55 GMT:+8" hello //+CMNI set parameter <mt> to 2
AT+CNMA //use this command to send RP-ACK to network
OK
2.3.10 +CMT new message received
SMS-DELIVERs are routed directly to the TE using unsolicited result code.
SMS-DELIVERs are routed directly to the TE using unsolicited result code. Currently only support TEXT
mode SMS-DELIVER message display.
+CMT
+CMT: <oa>, <scts><CR><LF><data> (text mode enabled)
Parameter INTEGER TYPE;
Deliver Message's source address(text mode enabled)
<LENGTH> String type;
<OA> Deliver Message's source address(text mode enabled)
<SCTS> String type; TP-Service-Centre-Time-Stamp in time-string format
3GPP TS 23.040 [3] TP-Discharge-Time in time-string format: "yy/MM/dd,hh:mm:ss�zz",
<DATA> where characters indicate year (two last digits), month, day, hour, minutes, seconds and
time zone. E.g. 6th of
May 1994, 22:10:00 GMT+2 hours equals to "94/05/06,22:10:00+08"
String type;
The content of deliver message in HEX string format
Example
+CMT: "106499990000","19.05.16 16:27:55 GMT:+8" hello
2.3.11 AT+CMGL list message
Execution command returns messages with status value <stat> from message storage <mem1> to the
TE. About text mode parameters in italics, refer command Show Text Mode Parameters +CSDH. If status
of the message is 'received unread', status in the storage changes to 'received read'. If listing fails, final
result code +CMS ERROR: <err> is returned.
AT+CMGL Response
if text mode (+CMGF=1),for SMS-SUBMITs
Set Command or SMS-DELIVERs:
AT+CMGL[=<stat> +CMGL:
<index>,<stat>,<oa/da>,[<alpha>],[<scts
>][,<tooa/toda>,<length>]<CR><LF><data>
[<CR><LF>+CMGL:
<index>,<stat>,<da/oa>,[<alpha>],[<scts
>][,<tooa/toda>,<length>]<CR><LF><data>
[...]]
if text mode (+CMGF=1), for SMS-STATUS-
REPORTs:
+CMGL:
<index>,<stat>,<fo>,<mr>,[<ra>],[<tora>
],<scts>,<dt>,<st>[<CR><LF>+CMGL:
<index>,<stat>,<fo>,<mr>,[<ra>],[<tora>
],<scts>,<dt>,<st>[...]]
if text mode (+CMGF=1), for SMS-
COMMANDs(current not supported):
+CMGL:
<index>,<stat>,<fo>,<ct>[<CR><LF>+CMGL:
<index>,<stat>,<fo>,<ct>[...]]
if text mode (+CMGF=1), for CBM
storage(current not supported):
+CMGL:
<index>,<stat>,<sn>,<mid>,<page>,<pages
><CR><LF><data>[<CR><LF>+CMGL:
<index>,<stat>,<sn>,<mid>,<page>,<pages
><CR><LF><data>[...]]
Test Command if PDU mode (+CMGF=0):
+CMGL:
<index>,<stat>,[<alpha>],<length><CR><L
F><pdu>[<CR><LF>+CMGL:<index>,<stat>,[<
alpha>],<length><CR><LF><pdu>[...]]
if there is any error, response:
+CMS ERROR: <err>
Response
AT+CMGL=? +CMGL: (list of supported <stat>s)
Maximum Response Time 30s
Parameter Saving Mode AUTO_SAVE
Parameter INTEGER TYPE; THE VALUE IS THE RANGE OF LOCATION NUMBER
<INDEX> SUPPORTED BY THE ASSOCIATED MEMORY
<STAT>
integer type in PDU mode (default 0), or string type in text mode (default "REC
<ALPHA>
UNREAD"); indicates the status of message in memory; defined values:
<DA>
<OA> 0 or "REC UNREAD" received unread message (i.e. new message)
<DT>
<SCTS> 1 or "REC READ" received read message
<FO>
<PID> 2 or "STO UNSENT" stored unsent message (only applicable to SMS)
<DCS>
3 or "STO SENT" stored sent message (only applicable to SMs)
4 or "ALL " all message(only applicable to +CMGL)
string type;
The alphanumeric representation of <da> or <oa> corresponding to the entry found in
MT phonebook; implementation of this feature is manufacturer specific; used
character set should be the one selected with command Select TE Character Set
+CSCS (see definition of this command in 3GPP TS 27.007 [9]).
Destination address, 3GPP TS 23.040 [3] TP-Destination-Address Address-Value field
in string format; BCD numbers (or GSM 7 bit default alphabet characters) are
converted to characters of the currently selected TE character set; type of address
given by <toda>.
Originating address, 3GPP TS 23.040 [3] TP-Originating-Address Address-Value field
in string format; BCD numbers (or GSM 7 bit default alphabet characters) are
converted to characters of the currently selected TE character set; type of address
given by <tooa>.
3GPP TS 23.040 [3] TP-Discharge-Time in time-string format:
"yy/MM/dd,hh:mm:ss�zz", where characters indicate year (two last digits), month, day,
hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours
equals to "94/05/06,22:10:00+08".
String type;
3GPP TS 23.040 [3] TP-Service-Centre-Time-Stamp in time-string format (refer <dt>).
Integer type;
Frist Octet, depending on the command or result code: first octet of 3GPP TS 23.040
[3] SMS-DELIVER, SMSSUBMIT (default 33), SMS-STATUS-REPORT, or SMS-
COMMAND in integer format.
Integer type;
Protocol identifier. 3GPP TS 23.040 [3] TP-Protocol-Identifier in integer format (default
0)
Integer type;
Data Coding Scheme. Depending on the command or result code: 3GPP TS 23.038
[2] SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in
integer format.
<VP> depending on SMS-SUBMIT <fo> setting: 3GPP TS 23.040 [3] TP-Validity-Period
<CT> either in integer format (default 167) or in time-string format (refer <dt>).
<MR> GPP TS 23.040 [3] TP-Command-Type in integer format (default 0).
<RA> 3GPP TS 23.040 [3] TP-Message-Reference in integer format.
3GPP TS 23.040 [3] TP-Recipient-Address Address-Value field in string format; BCD
<TODA> numbers (or GSM 7 bit default alphabet characters) are converted to characters of the
<TORA> currently selected TE character set(refer command +CSCS in 3GPP TS 27.007 [9]);
<TOOA> type of address given by <tora>.
<LENGTH> 3GPP TS 24.011 [6] TP-Destination-Address Type-of-Address octet in integer format
(when first character of <da> is + (IRA 43) default is 145, otherwise default is 129).
<DATA> 3GPP TS 24.011 [6] TP-Recipient-Address Type-of-Address octet in integer format
<PDU> (default refer <toda>).
3GPP TS 24.011 [6] TP-Recipient-Address Type-of-Address octet in integer format
<SN> (default refer <toda>).
<ST> integer type;
<MID> The value indicating in the text mode (+CMGF=1) the length of the message body
<PAGE> <data> > (or <cdata>) in characters; or in PDU mode (+CMGF=0), the length of the
<PAGES> actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted
in the length).
In the case of SMS: 3GPP TS 23.040 [3] TP-User-Data in text mode responses;
In the case of SMS: 3GPP TS 24.011 [6] SC address followed by 3GPP TS 23.040 [3]
TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA
character long hexadecimal number (e.g. octet with integer value 42 is presented to
TE as two characters 2A (IRA 50 and 65)).
3GPP TS 23.041 [4] CBM Serial Number in integer format.
3GPP TS 23.040 [3] TP-Status in integer format.
3GPP TS 23.041 [4] CBM Message Identifier in integer format.
3GPP TS 23.041 [4] CBM Page Parameter bits 4-7 in integer format.
3GPP TS 23.041 [4] CBM Page Parameter bits 0-3 in integer format.
Example
AT+CMGL="ALL" //read all SMS
+CMGL: 1,"REC READ","+358501234567","Mr. Smith","95/07/03,17:45:03+04"
This is the body of the message.
+CMGL: 2,"STO UNSENT","+358501234567","Mr. Smith",
This is the body of the reply.
OK
2.3.12 AT+CMGR read message
Execution command returns message with location value <index> from message storage <mem1> to the
TE. About text mode parameters in italics, refer command Show Text Mode Parameters +CSDH. If status
of the message is 'received unread', status in the storage changes to 'received read'. If reading fails, final
result code +CMS ERROR: <err> is returned.
AT+CMGR Response
if text mode (+CMGF=1),for SMS-DELIVER:
Set Command +CMGR:
AT+CMGR=<index> <stat>,<oa>,[<alpha>],<scts>[,<tooa>,<f
o>,<pid>,<dcs>,
<sca>,<tosca>,<length>]<CR><LF><data>
if text mode (+CMGF=1),for SMS-SUBMIT:
+CMGR:
<stat>,<da>,[<alpha>][,<toda>,<fo>,<pid
>,<dcs>,[<vp>],
<sca>,<tosca>,<length>]<CR><LF><data>
if text mode (+CMGF=1), for SMS-STATUS-
REPORT:
+CMGR:
<stat>,<fo>,<mr>,[<ra>],[<tora>],<scts>
,<dt>,<st>
if text mode (+CMGF=1),for SMS-
COMMAND(current not supported):
+CMGR:
<stat>,<fo>,<ct>[,<pid>,[<mn>],[<da>],[
<toda>],<length>
<CR><LF><cdata>]
if text mode (+CMGF=1),for CBM
storage(current not supported):
+CMGR:
<stat>,<sn>,<mid>,<dcs>,<page>,<pages><
CR><LF><data>
Test Command if PDU mode (+CMGF=0):
AT+CMGR=? +CMGR:
<stat>,[<alpha>],<length><CR><LF><pdu>
if there is any error, response:
+CMS ERROR: <err>
Response
OK
Maximum Response Time 5s
Parameter Saving Mode AUTO_SAVE
Parameter INTEGER TYPE;
THE VALUE IS THE RANGE OF LOCATION NUMBER SUPPORTED BY THE
<INDEX> ASSOCIATED MEMORY
<STAT> integer type in PDU mode (default 0), or string type in text mode (default "REC
UNREAD"); indicates the status of message in memory; defined values:
<ALPHA> 0 or "REC UNREAD" received unread message (i.e. new message)
1 or "REC READ" received read message
<DA> 2 or "STO UNSENT" stored unsent message (only applicable to SMS)
<OA> 3 or "STO SENT" stored sent message (only applicable to SMs)
<DT> string type;
<SCTS> The alphanumeric representation of <da> or <oa> corresponding to the entry found in
<FO> MT phonebook; implementation of this feature is manufacturer specific; used
<PID> character set should be the one selected with command Select TE Character Set
<DCS> +CSCS (see definition of this command in 3GPP TS 27.007 [9]).
<VP> Destination address, 3GPP TS 23.040 [3] TP-Destination-Address Address-Value field
in string format; BCD numbers (or GSM 7 bit default alphabet characters) are
converted to characters of the currently selected TE character set; type of address
given by <toda>.
Originating address, 3GPP TS 23.040 [3] TP-Originating-Address Address-Value field
in string format; BCD numbers (or GSM 7 bit default alphabet characters) are
converted to characters of the currently selected TE character set; type of address
given by <tooa>.
3GPP TS 23.040 [3] TP-Discharge-Time in time-string format:
"yy/MM/dd,hh:mm:ss�zz", where characters indicate year (two last digits), month, day,
hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours
equals to "94/05/06,22:10:00+08"
String type;
3GPP TS 23.040 [3] TP-Service-Centre-Time-Stamp in time-string format (refer <dt>).
Integer type; Frist Octet, depending on the command or result code: first octet of
3GPP TS 23.040 [3] SMS-DELIVER, SMSSUBMIT (default 33), SMS-STATUS-
REPORT, or SMS-COMMAND in integer format
Integer type;
Protocol identifier. 3GPP TS 23.040 [3] TP-Protocol-Identifier in integer format (default
0)
Integer type;
Data Coding Scheme, depending on the command or result code: 3GPP TS 23.038
[2] SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in
integer format
Depending on SMS-SUBMIT <fo> setting: 3GPP TS 23.040 [3] TP-Validity-Period
either in integer format (default 167) or in time-string format (refer <dt>)
<MN> 3GPP TS 23.040 [3] TP-Message-Number in integer format
<MR> 3GPP TS 23.040 [3] TP-Message-Reference in integer format
<RA> 3GPP TS 23.040 [3] TP-Recipient-Address Address-Value field in string format; BCD
numbers (or GSM 7 bit default alphabet characters) are converted to characters of the
<TODA> currently selected TE character set(refer command +CSCS in 3GPP TS 27.007 [9]);
<TORA> type of address given by <tora>
<TOOA> 3GPP TS 24.011 [6] TP-Destination-Address Type-of-Address octet in integer format
<SCA> (when first character of <da> is + (IRA 43) default is 145, otherwise default is 129)
3GPP TS 24.011 [6] TP-Recipient-Address Type-of-Address octet in integer format
<TOSCA> (default refer <toda>)
<LENGTH> 3GPP TS 24.011 [6] TP-Recipient-Address Type-of-Address octet in integer format
(default refer <toda>)
<DATA> 3GPP TS 24.011 [6] RP SC address Address-Value field in string format; BCD
<PDU> numbers (or GSM 7 bit default alphabet characters) are converted to characters of the
currently Selected TE character set (refer command +CSCS in 3GPP TS 27.007 [9]);
<SN> type of address given by <tosca>
<ST> 3GPP TS 24.011 [6] RP SC address Type-of-Address octet in integer format (default
<MID> refer <toda>)
<PAGE> integer type;
<PAGES> The value indicating in the text mode (+CMGF=1) the length of the message body
<data> > (or <cdata>) in characters; or in PDU mode (+CMGF=0), the length of the
actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted
in the length)
In the case of SMS: 3GPP TS 23.040 [3] TP-User-Data in text mode responses;
In the case of SMS: 3GPP TS 24.011 [6] SC address followed by 3GPP TS 23.040 [3]
TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA
character long hexadecimal number (e.g. octet with integer value 42 is presented to
TE as two characters 2A (IRA 50 and 65))
3GPP TS 23.041 [4] CBM Serial Number in integer format
3GPP TS 23.040 [3] TP-Status in integer format
3GPP TS 23.041 [4] CBM Message Identifier in integer format
3GPP TS 23.041 [4] CBM Page Parameter bits 4-7 in integer format
3GPP TS 23.041 [4] CBM Page Parameter bits 0-3 in integer format
Example
AT+CSDH=1
OK
+CMTI: "ME",2 //new message received in index 2
AT+CMGR=2 //read the message
+CMGR: "REC UNREAD","+358507654321","Mr. Jones","95/07/03,17:38:15+04"
This is the Mr. Jones testing
OK
2.3.13 AT+CMGD delete message
Execution command deletes message from preferred message storage <mem1> location <index>. If
<delflag> is present and not set to 0 then the ME shall ignore <index> and follow the rules for <delflag>
shown below. If deleting fails, final result code +CMS ERROR: <err> is returned.
Test command shows the valid memory locations and optionally the supported values of <delflag>.
AT+CMGD Response
OK
Set Command If there is any error, response:
AT+CMGD=<index>[,<delflag>] +CMS ERROR: <err>
Response
Test Command +CMGD: (list of support <index>s),(list of supported
AT+CMGD=? <delflag>s)
5s
Maximum Response Time AUTO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE;
<INDEX> THE VALUE IS THE RANGE OF LOCATION NUMBER SUPPORTED BY THE
<DELFLAG> ASSOCIATED MEMORY
integer type;
indicating multiple message deletion request as follows
0 Delete the message specified in <index>.
1 Delete all read messages from preferred message storage(mem1),
leaving unread messages and stored mobile originated messages
(whether sent or not) untouched.
2 Delete all read messages from preferred message storage(mem1) and
sent mobile originated messages, leaving unread messages and unsent
mobile originated messages untouched.
3 Delete all read messages from preferred message storage(mem1), sent
and unsent mobile originated messages leaving unread messages
untouched.
4 Delete all messages from preferred message storage(mem1) including
unread messages.
Example
AT+CSDH=1
OK
AT+CMGL="ALL" //read all SMs
+CMGL: 1,"REC READ","+358501234567","Mr. Smith","95/07/03,17:45:03+04"
This is the body of the message.
+CMGL: 2,"STO UNSENT","+358501234567","Mr. Smith",
This is the body of the reply.
OK
AT+CMGD=1 //deleted the message which of the index is 1
OK
AT+CMGL="ALL" //read all SMs again
+CMGL: 2,"STO UNSENT","+358501234567","Mr. Smith",
This is the body of the reply.
OK
2.3.14 AT+CMGW write message to memory
Execution command stores message (either SMS-DELIVER or SMS-SUBMIT) to memory storage
<mem2>. Memory location <index> of the stored message is returned. By default, message status will
be set to 'stored unsent', but parameter <stat> allows also other status values to be given. The entering
of text is done similarly as specified in command Send Message +CMGS. If writing fails, final result code
+CMS ERROR: <err> is returned. See chapter Message Service Failure Result Code for <err> values.
NOTE: SMS-COMMANDs and SMS-STATUS-REPORTs can not be stored in text mode.
AT+CMGW Response
+CMGW: <index>
Set Command If there is any error, response:
if text mode (+CMGF=1): +CMS ERROR: <err>
+CMGW[=<oa/da>[,<tooa/toda>[,<stat
>]]]<CR>
text is entered<ctrl+Z/ESC>
if PDU mode (+CMGF=0):
+CMGW=<length>[,<stat>]<CR>
PDU is given<ctrl+Z/ESC>
<ctrl+Z>: entered text/pdu finshed Response
<ESC>: cancel the this command. OK
Test Command 5s
AT+CMGW=?
Maximum Response Time
Parameter Saving Mode AUTO_SAVE
Parameter INTEGER TYPE;
INDEX OF MESSAGE IN SELECTED PREFERRED STORAGE MEMORY<MEM2> BY
<INDEX> COMMAND +CPMS CONFIGURATION.
<OA> Originating address, 3GPP TS 23.040 [3] TP-Originating-Address Address-Value field in
<DA> string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to
<TODA> characters of the currently selected TE character set; type of address given by <tooa>.
<TOOA> Destination address, 3GPP TS 23.040 [3] TP-Destination-Address Address-Value field in
<STAT> string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to
characters of the currently selected TE character set; type of address given by <toda>.
<LENGTH> 3GPP TS 24.011 [6] TP-Destination-Address Type-of-Address octet in integer format
(when first character of <da> is + (IRA 43) default is 145, otherwise default is 129)
3GPP TS 24.011 [6] TP-Originating-Address Type-of-Address octet in integer format
(default refer<toda>)
integer type in PDU mode (default 0), or string type in text mode (default "REC UNREAD");
indicates the status of message in memory; defined values:
0 or "REC UNREAD" received unread message (i.e. new message)
1 or "REC READ" received read message
2 or "STO UNSENT" stored unsent message (only applicable to SMS)
3 or "STO SENT" stored sent message (only applicable to SMs)
integer type;
The value indicating in the text mode (+CMGF=1) the length of the message body in
characters; or in PDU mode (+CMGF=0), the length of the actual TP data unit in octets
(i.e. the RP layer SMSC address octets are not counted in the length)
Example
AT+CMGW="9501231234" //write message
> This is the message body. ^Z //index number in storage returned
+CMGW: 7
OK
2.3.15 AT+CMSS send message from storage
Execution command sends message with location value <index> from preferred message storage
<mem2> to the network (SMS-SUBMIT or SMS-COMMAND). If new recipient address <da> is given
given for SMS-SUBMIT, it shall be used instead of the one stored with the message. Reference value
<mr> is returned to the TE on successful message delivery. If sending fails in a network or an ME error,
final result code +CMS ERROR: <err> is returned.
AT+CMSS Response
if text mode (+CMGF=1) and sending successful:
Set Command +CMSS: <mr>[,<scts>]
AT+CMSS=<index>[,<da>[,<toda>]]
if PDU mode (+CMGF=0) and sending successful:
+CMSS: <mr>[,<ackpdu>]
Test Command If there is any error, response:
AT+CMSS=? +CMS ERROR: <err>
Maximum Response Time Response
Parameter Saving Mode OK
5s
AUTO_SAVE
Parameter INTEGER TYPE;
INDEX OF MESSAGE IN SELECTED PREFERRED STORAGE MEMORY<MEM2>
<INDEX> Destination address, 3GPP TS 23.040 [3] TP-Destination-Address Address-Value field in
<DA> string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to
characters of the currently selected TE character set; type of address given by <toda>.
<TODA> 3GPP TS 24.011 [6] TP-Destination-Address Type-of-Address octet in integer format
<MR> (when first character of <da> is + (IRA 43) default is 145, otherwise default is 129)
Message reference, 3GPP TS 23.040 [3] TP-Message-Reference in integer format.
Example
AT+CMGW="9501231234" //write message
> This is the message body. ^Z //index number in storage returned
+CMGW: 7
OK
AT+CMSS=7 //Send the message of which index is 4 from memory storage.
+CMSS: 1
OK
2.3.16 AT+CMMS more message to send
Set command controls the continuity of SMS relay protocol link. When feature is enabled (and supported
by network) multiple messages can be sent much faster as link is kept open.
Test command returns supported values as a compound value.
AT+CMMS Response
OK
Set Command If there is any error, response:
AT+CMMS=<n> +CMS ERROR: <err>
Response
Read Command +CMMS: <n>
AT+CMMS?
Test Command Response
AT+CMMS=? +CMMS: (list of support <n>s)
Maximum Response Time 5s
Parameter Saving Mode AUTO_SAVE
Parameter INTEGER TYPE;
<N>
0 Disable
1 keep enabled until the time between the response of the latest message send
command (+CMGS, +CMSS, etc.)and the next send command exceeds 1-5
seconds (the exact value is up to ME implementation), then ME shall close the
link and TA switches <n> automatically back to <n>=0
2 enable (if the time between the response of the latest message send
command and the next send command exceeds 1-5 seconds (the exact value
is up to ME implementation), ME shall close the link but TA shall not switch
automatically back to <n>=0).
Example
AT+CMMS=1
OK
AT+CMMS?
+CMMS: 1
OK
2.3.17 AT+CSCB Select Cell Broadcast Message Types
Set command selects which types of CBMs are to be received by the ME.
Test command returns supported modes as a compound value.
AT+CSCB Response
OK
Set Command If there is any error, response:
AT+CSCB=[<mode>[,<mids>[,<dcss>]]] +CMS ERROR: <err>
Response
Read Command +CSCB: <mode>,<mids>,<dcss>
AT+CSCB?
Test Command Response
AT+CSCB=? +CSCB: (list of supported <mode>s)
Maximum Response Time 5s
Parameter Saving Mode AUTO_SAVE
Parameter INTEGER TYPE;
<MODE> 0 message types specified in <mids> and <dcss> are accepted
<MIDS> 1 message types specified in <mids> and <dcss> are not accepted
<DCSS> string type;
all different possible combinations of CBM message identifiers (default is empty string);
e.g. "0,1,5,320-478,922"
string type;
all different possible combinations of CBM data coding schemes (default is empty string);
e.g. "0-3,5"
Example
AT+CSCB=1,"4379,4371-4376","1"
OK
AT+CSCB?
+CSCB=1,(4371-4376,4379),(1)
OK
3 Extended Commands
3.1 EC General Commands
3.1.1 AT+ECBAND
The command sets the bands to be used.
Read command returns the current band list.
Test command returns bands supported by the UE.
AT+ECBAND Response
OK
Set Command If there is any error, response:
AT+ECBAND=<band1>[,<band2>[,<band3>...]] +CME ERROR: <err>
Response
Read Command +ECBAND:
AT+ECBAND? <band1>[,<band2>[,<band3>[...]]]
OK
Test Command Response
AT+ECBAND=? +ECBAND: (list of supported <band>s)
OK
Maximum Response Time 25s
Parameter Saving Mode AUTO_SAVE
Parameter INTEGER TYPE
Band list in decimal number.
<BAND> The default value is decided by RF Calibration table
Example
AT+ECBAND?
+ECBAND: 1,3,5,8,34,38,39,40,41
OK
AT+ECBAND=?
+ECBAND: (1,3,5,8,34,38,39,40,41)
OK
AT+ECBAND=5,8
OK
3.1.2 AT+ECLOGDBVER
This read command returns current unilog database version information.
AT+ECLOGDBVER Response
+ECLOGDBVER: <LogDbVserion>
Read Command OK
AT+ECLOGDBVER? 5s
NO_SAVE
Maximum Response Time
Parameter Saving Mode
3.1.3 AT+ECCFG
The command set UE extended configuration.
The read command return current setting of each parameters.
The test command returns values supported as a compound value.
AT+ECCFG Response
OK
Set Command If there is any error, response:
AT+ECCFG=<param>,<value> +CME ERROR: <err>
Response
Read Command +ECCFG: <param1>,< value1>
AT+ECCFG? [+ECCFG: <param2>,<value2>]
[...]
Test Command OK
AT+ECCFG=? Response
+ECCFG: (list of supported <param>s)
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE_REBOOT
Parameter
<PARAM STRING TYPE, NAME OF CONFIGURATION PARAMETER.
> "PsSoftReset" Whether UE support protocol stack soft reset.
Note:
a) Supported values: (0,1)
b) Default value: 1.
"Rohc" Whether UE support ROHC.
Note:
a) Supported values: (0,1)
b) Default value: 1.
"Ipv6RsForTestSim" Whether UE trigger IPv6 NDP (RS) procedure to get IPv6
prefix address, when the SIM card inserted is a TEST SIM.
Note:
a) Supported values: (0,1)
b) Default value 0.
c) IPv6 NDP (RS) procedure is triggered by default if the
inserted SIM card is not for testing.
"Ipv6RsDelay" Delay in seconds then UE trigger IPv6 NDP (RS) procedure
to get IPv6 prefix address.
Note:
a) Supported values: (0-65535)
b) Default value 5.
c) IPv6 NDP (RS) procedure is triggered by default if the
inserted SIM card is not for testing.
"PlmnSearchPowerLeve Set the PLMN search level when UE OOS;
l" Note:
a) Supported values: (0,1,2,3,4)
0 - OOS PLMN search interval: 5 seconds, 10 seconds,
20 seconds
1 - OOS PLMN search interval: 15 seconds, 30
seconds, 1 minute
2 - OOS PLMN search interval: 5 minutes, 10 minutes,
15 minutes
3 - OOS PLMN search interval: 30 seconds, then stop
PLMN search, and let AT: AT+ECPLMNS to start PLMN
search
4 � Don't perform PLMN search when OOS,
let user to decide next action(whether perform PLMN
search or not)
b) Default value: 1
"Epco" Whether UE need to use "EPCO" in "PDN CONNECTION
REQUEST" and in IE "UE network capability" carried in
"ATTACH REQUEST", and "ESM INFORMATION
RESPONSE"; If set to 0, just use "PCO".
Note:
a) Supported values: (0,1)
"T3324MaxValueS" b) Default value: 0
"BarValueS" Set user control T3324 value in second.
"DataInactTimer" Note:
"RelaxMonitorDeltaP"
"UeCategory" a) Support values: (0-16777215)
b) Default value: 16777215
c) If T3324MaxValueS is smaller than 65535 and network
configured T3324 is equal to or greater than
T3324MaxValueS (or network not configured T3324),use
the configured T3324MaxValueS
d) If T3324MaxValueS is smaller than 65535 and network
configured T3324 is smaller than T3324MaxValueS , use
the network configured value
e) If T3324MaxValueS is equal to or greater than
65535,just means disable this feature(use network
configured value)
UE bar period due to SIB14,after timer expiry,UE
can retry access to network.
Note:
a) Supported values: (1-600)
b) Default value: 120.
Set the value of "data inactivity timer" in seconds, if this
timer is not configured by NW (in MAC-MainConfig), just use
this setting value.
Note:
a) Supported value: (0,15-255)
b) Default value: 60
c) If set to 0, just means this timer is invalid, don't need to
start.
d) It must be restricted to execute in power off or air plane
state
Set the value of "SearchDeltaP" in DB for Relex-Monitor
feature. If this value is not configured by NW (in SIB3), just
use this setting value.
Note:
a) Supported values: (0-15)
b) Default value: 0
c) It must be restricted to execute in power off or air plane
state
Set the value of UE category.
Note:
a) Supported values:
(1, cat1)
(2, cat1-bis)
b) Default value: 1
"RelVersion" c) It must be restricted to execute in power off or air plane
"EnableEAB" state
"EnableABCheck" Set the UE release version.
"AttachEpsCid" Note:
"TcpTptOpt" a) Supported values: (13,14)
b) Default value: 13
"PowerAttachWithIMSI c) It must be restricted to execute in power off or air plane
"
"PowerAttachWoEia" state
"EnableDataCounter" Enable or disable Extended Access Barring.
Note:
a) Supported values: (0,1)
Default value: 1.
Enable or disable Access Barring check (included in SIB2
and SIB14).
Note:
b) Supported values: (0,1)
Default value: 0, Disable access barring check
Set the default eps bearer context cid value
Note:
a) Supported values: (1,15)
Default value: 1.
Enable or disable TCP throughput optimization.
Note:
a) Supported values: (0,1,2)
(0, disable TCP TPT optimization)
(1, enable TCP TPT optimization solution)
(2, enable another TCP TPT optimization
solution)
Default value: 1.
Enable or disable power on ATTACH with IMSI.
Note:
a) Supported values: (0,1)
Default value: 1.
Enable or disable power on ATTACH without integrity
protected.
Note:
a) Supported values: (0,1)
Default value: 1.
Enable or disable PS data counter feature.
Note:
Note:
a) Supported values: (0,1)
Default value: 0.
b) Only enable this configuration, AT+ECGDCNT and
"UpdateLociCtrl" AT+ECAUGDCNT can be executed.
c) Please enable this command with caution, it may cause
"RoamService"
"SavePlmnSelMode" the UE to only enter sleep2 and can't enter Hibernate.
"EmergencyCamp" It's best to keep disabled when not in use.
"EnableAcl" Set the mode of updating EFEPSLOCI and EFLOCI to SIM or
NVM.
Note:
a) Supported values: (0,1)
0 - Update EFEPSLOCI and EFLOCI to SIM or NVM (if EF
not present in SIM) if the parameters are changed (EPS
update status, TAI, GUTI for EFEPSLOCI; TMSI, LAI for
EFLOCI).
1 - Delay updating EFEPSLOCI and EFLOCI to SIM or
NVM (if EF not present in SIM) until do deregistration
(AT+CFUN=0). Side effect in this mode: The EFs may
not be updated to SIM or NVM if SIM is removed or
power down UE without sending AT+CFUN=0.
b) Default value: 0.
Enable or disable the roaming service.
AT+ECCFG="RoamService"[,<roam_mode>[,<effect
>]]
Note:
a) <roam_mode> Supported values: (1,2,255)
1 � Disable roaming service.
2,255 � Enable roaming service.
Default value: 2.
b) <effect> Supported values: (0,1)
0 � Take effect after UE reboots
1 � Take effect immediately
c) Default value: 1
Enable or disable saving the PLMN select mode that is set
through AT+COPS to NVM.
Note:
a) Supported values: (0,1)
0 � The PLMN select mode will not be save to NVM. It
will be reset to automatic PLMN selection after reboot.
1 - The PLMN select mode will be save to NVM and
will not be changed after reboot.
b) Default value: 1.
Enable or disable emergency camp.
Note:
c) Supported values: (0,1)
Default value: 0.
Enable or disable UE ACL(Apn Control List).
"PdpRemap" Note:
"PdpReact" a) Supported values: (0,1)
"WeakCellOpt" Default value: 0.
"QRxLevMin" Enable or disable UE Remap
Note:
a) Supported values: (0,1,2)
Default value: 0.
Value 1: Enable Remap
Value 2: Enable more times Remap
Enable or disable UE React
Note:
a) Supported values: (0,1)
Default value: 0.
Value 1: Enable React
Enable or disable improve UE cell search cell signal when
detect the cell signal is weak
Note:
a) Supported values: (0,1)
b) Default value: 1
c) It must be restricted to execute in power off or air plane
state
Enable or disable User configure q-RxlevMin*2.
Not Suggest enable it unless when testing the performance
of UE camp on a cell.
Note:
a) Supported value ranges: [-156 ~ 0]
b) Default value: 0
c) It must be restricted to execute in power off or air plane
state
Example
AT+ECCFG="Rohc",0
OK
AT+ECCFG?
+ECCFG: "PsSoftReset",1
+ECCFG: "Rohc",1
+ECCFG: "Ipv6RsForTestSim",0
+ECCFG: "Ipv6RsDelay",15
+ECCFG: "PlmnSearchPowerLevel",1
+ECCFG: "Epco",0
+ECCFG: "T3324MaxValueS",16777215
+ECCFG: "BarValueS",120
+ECCFG: "DataInactTimer",60
+ECCFG: "RelaxMonitorDeltaP",0
+ECCFG: "UeCategory",1
+ECCFG: "RelVersion",13
+ECCFG: "EnableEAB",1
+ECCFG: "AttchEpsCid",1
+ECCFG: "TcpTptOpt",1
+ECCFG: "PowerAttachWithIMSI",1
+ECCFG: "PowerAttachWoEia",1
+ECCFG: "EnableDataCounter",0
+ECCFG: "UpdateLociCtrl",0
+ECCFG: "RoamService",2
+ECCFG: "SavePlmnSelMode",1
+ECCFG: "EmergencyCamp",0
+ECCFG: "EnableAcl",0
+ECCFG: "PdpRemap",0
+ECCFG: "PdpReact",0
+ECCFG: "EnableABCheck",0
+ECCFG: "WeakCellOpt", 1
+ECCFG: "QRxLevMin", 0
OK
AT+ECCFG=?
("PsSoftReset","Rohc","Ipv6RsForTestSim","Ipv6RsDelay","PlmnSearchPowerLevel","Epco","T332
4MaxValueS","BarValueS","DataInactTimer","RelaxMonitorDeltaP","UeCategory","RelVersion","E
nableEAB","EnableABCheck","AttachEpsCid","TcpTptOpt","PowerAttachWithIMSI","PowerAttachWoE
ia","EnableDataCounter","UpdateLociCtrl","RoamService","SavePlmnSelMode","EmergencyCamp","
EnableAcl","PdpRemap","PdpReact","EnableABCheck","WeakCellOpt","QRxLevMin")
OK
3.1.4 AT+ECPING
The command sends an ICMP packet to the specified host address. AT+ECPING initiates the sending of
a PING packet with payload size: <size> to the specified address. This will either cause a packet to be
returned if the remote system is connected and responding to PING packets or no response will be
received. If none of the response packet received within the timeout period <timeout>. It will continue
to send PING packet until the <count> number of times.
The test command returns values supported as a compound value.
AT+ECPING
Set Command Response
AT+ECPING=<ipaddr/Url>/<mode>[,<count>[,<size>[,<ti OK
meout>]]] If there is any error, response:
Test Command +SOCKET ERROR: <err>
AT+ECPING=? Response
+ECPING: (list of supported
Maximum Response Time <ipaddr/Url/mode>s),(list
Parameter Saving Mode of supported <count> s),(list
of supported <size>s),(list of
supported <timeout>s)
OK
5s
NO_SAVE
Parameter
<MODE> INTEGER TYPE
0 Stop ping
<IPADDR/URL> String type, IP address or URL
<COUNT> Integer type, ping times
1-255
Note: default value: 4. 255 means all the time
<SIZE> Integer type, payload size
1-1500
Note: default value: 32 bytes
<TIMEOUT> Integer type, UE ping reply timeout after ping request.(ms)
Note: <timeout> values between 1 to 600000 are supported, and default value:
20000
Note:
a) When one PING reply received in <timeout>, an unsolicited result code: +ECPING: SUCC, dest:
<dest_ip_addr>, RTT: <rtt_time>ms will sent to TE.
b) If no PING reply received in <timeout>, an unsolicited result code: +ECPING: FAIL, dest:
<dest_ip_addr>, time out: <timeout>ms will sent to TE.
c) If this is an ERROR meet during PING procedure, an unsolicited result code: +ECPING: ERROR,
cause: <cause> will sent to TE.
d) When PING procedure is done, an unsolicited result code: +ECPING: DONE<CR><LF>+ECPING:
dest: <dest_ip_addr>, <count> packets transmittted, <reply_count> received,
<lost_percent>% packet loss<CR> rtt min/avg/max = <rtt_min> / <rtt_avg> /
<rtt_max> ms will sent to TE.
Example
Ping 180.97.33.107 10 times with 32 bytes payload, timeout is 60 seconds:
AT+ECPING="180.97.33.107",10,32,60000
OK
+ECPING: SUCC, dest: 180.97.33.107, RTT: 334 ms
+ECPING: SUCC, dest: 180.97.33.107, RTT: 179 ms
...
Stop ping:
AT+ECPING=0
OK
3.1.5 AT+ECIPERF
The command tests the TCP/IP's uplink and downlink IPERF performance.
The test command returns values supported as a compound value.
AT+ECIPERF
Set Command Response
AT+ECIPERF=<action>[,<protocol>[,<port>[,<ipaddr> OK
[,<tpt>[,payload_size[,<packet_number>[,<duration> If there is any error, response:
[,<report_interval>]]]]]]]] +SOCKET ERROR: <err>
Test Command Response
AT+ECIPERF=? +ECIPERF: (list of suppprted
<action>s),(list of supported
<protcol>s),(list of supported
<port>s), (list of supported
<tpt>s),(list of supported
<payload_size>s),(list of
supported <pkg_num>s), (list of
supported <duration>s),(list
of supported
<report_interval>s)
OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE, IPERF COMMAND
0 Terminate all IPERF services
<ACTION> 1 Start IPERF client
2 Stop IPERF client
3 Start IPERF server
<PROTOCOL> 4 Start IPERF UDP NAT server
<PORT> Note: One type of IPERF UDP server, in this mode, UE will send one
UDP packet to remote server to setup the UDP connection, then UE
<IPADDR> wait to receive the DL UDP packets, and start the DL UDP IPERF
server.
<TPT>
<PAYLOAD_SIZE> 5 Stop IPERF server
<PACKET_NUMBER> Integer type
< 0 UDP
REPORT_INTERVAL > 1 TCP
Integer type, UDP/TCP port number.
<DURATION> Note:
a) if <action> is 1 or 4, this <port> is the destination server port number.
b) if <action> is 3, this <port> is the local IPERF server port number.
c) Default value: 5001
String type, IP address.
Note:
a) if <action> is 1 or 4, this <ipaddr> is mandatory, and indicate the
destination server address.
b) If <action> is 3 and the test domain is ipv6 domain, this <ipaddr> is
mandatory. it must be the UE local ipv6 address.
Integer type, throughput in bps.
Note: default value: 20000 the max value is 1200000 bps
Integer type, payload size of UL UDP/TCP IPERF packet. Used for client
mode
36-1472
Note: default value 1350
Integer type, packet number of UE send, when acted as a client mode.
1-65000
Note: default value 0UE will send packets all the time
Integer type, report internal of IPERF service result. UE send the following
unsolicited result codes periodically in this interval (in seconds).
a) If <action> is 1, the unsolicited result codes: +ECIPERF: Client
SUCC, pkg sent bytes: <bytes>, UL through put: <tpt>
bps
b) If <action> is 3 or 4, the unsolicited result codes: +ECIPERF:
Server SUCC, pkg recv bytes: <bytes>, DL through put:
<tpt> bps
Note: default value: 10
Integer type, IPERF service duration in seconds
Note: if not specified, IPERF will not stop, before meet an error, or received
a terminate command.
Note:
a) When IPERF client service is finished (terminated/timeout), UE send the unsolicited result codes:
+ECIPERF: Client END, pkg sent total bytes: <bytes>, average UL through
put: <tpt> bps
b) When IPERF server service is finished (terminated/timeout), UE send the unsolicited result codes:
+ECIPERF: Server END, pkg recv total bytes: <bytes>, average DL through
put: <tpt> bps
c) If happens an error which caused the IPERF service can't go on, UE send the unsolicited result
codes: +ECIPERF: Client FAIL, <err>; or +ECIPERF: Server FAIL, <err>
Example
AT+ECIPERF=1,0,5001,"180.167.122.150",10000
OK
+ECIPERF: Client SUCC, pkg sent bytes: 13720, UL through put: 10976 bps
+ECIPERF: Client SUCC, pkg sent bytes: 9604, UL through put: 7683 bps
+ECIPERF: Client SUCC, pkg sent bytes: 12348, UL through put: 9878 bps
+ECIPERF: Client SUCC, pkg sent bytes: 12348, UL through put: 9878 bps
AT+ECIPERF=0
OK
+ECIPERF: Client END, pkg sent total bytes: 52136, average UL through put: 9268 bps
3.1.6 AT+ECFREQ
The command set prefer EARFCN list, lock or unlock cell.
Read command returns the current EARFCN setting.
The test command returns values supported as a compound value.
AT+ECFREQ Response
OK
Set Command If there is any error, response:
If cell unlock(mode = 0): +CME ERROR: <err>
AT+ECFREQ=<mode>
If set prefer EARFCN list (mode = 1):
AT+ECFREQ=<mode>[,<earfcn1>[,<earfcn2>...]]
If cell lock (mode = 2):
AT+ECFREQ=<mode>,<earfcn>[,<phyCellId>]
Read Command Response
AT+ECFREQ? If neither set prefer EARFCN list nor lock
EARFCN/cell :
Test Command OK
AT+ECFREQ=? If set prefer EARFCN list:
Maximum Response Time +ECFREQ: <1>,<arfcn1>,<arfcn2>,...
Parameter Saving Mode If lock EARFCN or lock cell:
+ECFREQ: <2>,<arfcn>,<phyCellId>
OK
If both set prefer EARFCN list and lock
EARFCN/cell:
+ECFREQ: <1>,<arfcn1>,<arfcn2>,...
+ECFREQ: <2>,<arfcn>,<phyCellId>
OK
Response
+ECFREQ: (list of supported <mode>s)
OK
5s
AUTO_SAVE
Parameter INTEGER TYPE
<MODE> 0 Cancel cell lock
<EARFCN> 1 Set prefer EARFCN list
<PHYCELLID>
2 EARFCN lock, or cell lock
3 Clear prefer EARFCN
Integer type
E-UTRA Absolute Radio Frequency Channel Number
Integer type
Physical cell ID
Note:
AT+ECFREQ must be restricted to execute in power off or air plane state.
Example
AT+ECFREQ=1,3738,3734
OK
AT+ECFREQ?
+ECFREQ: 1,3738,3734
OK
AT+ECFREQ=2,3738,143
OK
AT+ECFREQ?
+ECFREQ: 1,3738,3734
+ECFREQ: 2,3738,143
OK
AT+ECFREQ=0
OK
AT+ECFREQ?
+ECFREQ: 1,3738,3734
OK
AT+ECFREQ=3
OK
AT+ECFREQ?
OK
3.1.7 AT+ECRMFPLMN
Set command remove FPLMN in NVM or SIM.
The test command returns values supported as a compound value.
AT+ECRMFPLMN Response
OK
Set Command If there is any error, response:
AT+ECRMFPLMN=<mode> +CME ERROR: <err>
Response
Test Command +ECRMFPLMN: (list of supported <mode>s)
AT+ECRMFPLMN=? OK
5s
Maximum Response Time AUTO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE
<MODE>
0 Remove FPLMN in NVM file and in SIM card
1 Remove FPLMN in NVM file
2 Remove FPLMN in SIM card
Example
AT+ECRMFPLMN=0
OK
3.1.8 AT+ECSENDDATA
The set command could send data via control plane or user plane
AT+ECSENDDATA Response
OK
Set Command If there is any error, response:
AT+ECSENDDATA=<cid>,<data_length>,<da +CME ERROR: <err>
ta>[,<RAI>[,<type_of_user_data>]] Response
+ECSENDDATA: (range of supported
Test Command <cid>s),(maximum number of octets of user
AT+ECSENDDATA=? data indicated by <data_length>), (list of
supported <RAI>s),(list of supported
Maximum Response Time <type_of_user_data>s)
Parameter Saving Mode 5s
NO_SAVE
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT
DEFINITION.
<CID> NOTE:
IF <CID> SET TO 1, JUST USE CURRENT DEFAULT BEARER
<DATA_LENGTH> TO SEND THIS ORIGINATING DATA.
<DATA> Integer type. Indicates the number of octets of the <data>
<RAI> information element. The max length is 950.
string of octets.
Integer type. Indicates the value of the release assistance
indication
0 No information available
1 The MT expects that exchange of data will be completed
with the transmission of this UL packet.
2 The MT expects that exchange of data will be completed
<TYPE_OF_USER_DATA> with the receipt of a DL packet.
Integer type. Indicates whether the user data that is transmitted is
regular or exceptional.
0 Regular data
1 Exception data
Note:
Difference with AT+CSODCP, AT+CSODCP limit to transmit data over control plane to network, but this AT
don't have such limitation.
Example
AT+ECSENDDATA=5,2,"ABCD"
OK
3.1.9 +RECVNONIP
This is an unsolicited code message used to indicate downlink NON-IP data.
+RECVNONIP
+RECVNONIP: <cid>,<data_length>,<data>
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT DEFINITION.
<CID> VALUES OF 1-15 ARE SUPPORTED.
<CID> Integer type. Indicates the number of octets of the <data> information element.
<DATA_LENGTH> string of octets.
<DATA>
Example
3.1.10 AT+ECPMUCFG
The command set PMU mode.
Read command returns the current setup.
Test command returns values supported as a compound value.
AT+ECPMUCFG Response
OK
Set Command If there is any error, response:
AT+ECPMUCFG=<enable>[,<mode +CME ERROR: <err>
>]
Read Command Response
AT+ECPMUCFG? +ECPMUCFG: <enable>[,<mode>]
OK
Note:
If PMU is disabled, <mode> will not return.
Test Command Response
AT+ECPMUCFG=? +ECPMUCFG: (range of supported <enable>s) , (list of
supported <mode>s)
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE
Parameter INTEGER TYPE; SPECIFIES TO ENABLE PMU OR NOT
<ENABLE> 0 Disable the PMU<mode> will be ignored and only enter idle
<MODE> 1 Enable the PMU
The default value is 1
Integer type; specifies to depth of sleep mode
0 Active
1 Idle
2 Sleep1
3 Sleep2
4 Hibernate
The default value is 1
Example
AT+ECPMUCFG=1,4
OK
AT+ECPMUCFG=0
OK
AT+ECPMUCFG?
+ECPMUCFG: 0
AT+ECPMUCFG=?
+ECPMUCFG: (0-1),(0-4)
3.1.11 AT+ECSMSSEND
The command is used to send one SMS.
AT+ECSMSSEND Response
Set Command OK
If there is any error, response:
TEXT mode: +CME ERROR: <err>
AT+ECSMSSEND=<mode>,<da>,[<toda>,<test_sms>]
PDU mode: 60s
AT+ECSMSSEND=<mode>,<pdu>
Maximum Response Time NO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE
<MODE> 0 PDU mode
<DA> 1 TEXT mode
<TODA>
<TEST_SMS> String type; in text mode (AT+CMGF=1)
Destination address for TXT mode
integer type; Type of destination address
String type
Message's content for TXT mode
Example
AT+CMGF=1(TEXT mode)
AT+ECSMSSEND=1,"1064899990000",,"hello"
+CMGS: 8
OK
AT+ECSMSSEND=1,1064899990000,,"hello"
+CMGS: 8
OK
AT+CMGF=0(PDU mode)
AT+ECSMSSEND=0,0891683108100065F9910C0D81014698195030F30000A79F54741914AFA7C76B9058FEBEBB4
1E6371EA4AEB7E173D0DB5E9683E8E832881DD6E741E4F7F9340789C3E3B50BB40CD7CD6537689A2E839268795
90E32CAC375903D5D9683C4E578BDDC2E83A065B6BEEC02B540B0986C46ABD96EB81CA805A2228BA06835395C8
284D2E7D509323EB12065B5099D829ED6A21444451641CCA0360B223E8FA72948181C2E01
+CMGS: 8
OK
Note for PDU mode:
SMS text: The quick brown fox jumps over the lazy dog's back. Kaufen Sie Ihrer Frau vier
bequeme Pelze. - 0123456789 - THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG'S BACK
RP-Destination Address(destination Service Centre address): 8613800100569
3.1.12 AT+ECCGSN
The command sets the imei.and sn. Use AT+CGSN to read IMEI or SN
AT+ECCGSN Response
OK
Set Command If there is any error, response:
AT+ECCGSN=<type>,<sn/imei> +CME ERROR: <err>
Response
Test Command +ECCGSN: (list of supported
AT+ECCGSN=? <type>s),(data)
OK
Maximum Response Time 5s
Parameter Saving Mode AUTO_SAVE
Parameter STRING TYPE
<TYPE> Can be "IMEI" or "SN"
String type
<SN/IMEI> IMEI (15bytes character only)
SN(31bytes maximum as visable character)
The default IMEI is 866818039921444
The default SN is ""(NULL)
Example
AT+ECCGSN="IMEI","788596633100008"
OK
AT+ECCGSN="SN","01"
OK
3.1.13 AT+ECRST
The command restart the chip. Response
OK
AT+ECRST 5s
NO_SAVE
Execution Command
AT+ECRST
Maximum Response Time
Parameter Saving Mode
Example
AT+ECRST
OK
3.1.14 AT+ECPSMR
The command report the power saving mode status.
AT+ECPSMR Response
OK
Set Command If there is any error, response:
AT+ECPSMR=<n> +CME ERROR: <err>
Response
Read Command +ECPSMR: <n>,<mode>
AT+ECPSMR? OK
Response
Test Command +ECPSMR: (range of supported <n>s)
AT+ECPSMR=? OK
Response
Indicate +ECPSMR: <mode>
5s
Maximum Response Time NO_SAVE
Parameter Saving Mode Note: AT&W will save <n> to NVM.
Parameter INTEGER TYPE
0: disable unsolicited result code
<N> 1: enable unsolicited result code +ECPSMR: <mode>
The default value is 0
<MODE> Integer type
0: normal mode
1: power saving mode
Example
AT+ECPSMR=1
OK
AT+ECPSMR?
+ECPSMR: 1,0
OK
AT+ECPSMR=?
+ECPSMR: (0,1)
+ECPSMR: 1
3.1.15 AT+ECPLMNS
Set command is used to trigger a PLMN search while UE is out of service, if UE is not out of service,
+CME ERROR: <err> is returned.
Read command returns the current PLMN search state, and the reset of time of PLMN search timer.
AT+ECPLMNS Response
OK
Set Command If there is any error, response:
AT+ECPLMNS +CME ERROR: <err>
Response
Read Command +ECPLMNS: <state>[,<oosTimeStep>]
AT+ECPLMNS? OK
Response
Test Command OK
AT+ECPLMNS=? 5s
Maximum Response Time NO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE
0 Deactivated, no PLMN search is ongoing
<STATE> 1 Searching, PLMN search is ongoing
2 Selected, already selected a PLMN
<OOSTIMESTEP> 3 OOS, UE is out of service and has started a PLMN search timer
Integer type. The rest of time (in seconds) of OOS PLMN search timer, only
present when <state> is 3.
Example
AT+ECPLMNS
OK
AT+ECPLMNS?
+ECPLMNS: 3, 108
OK
3.1.16 AT+ECCESQS
The set command controls the extended signal quality change event reporting. If reporting is enabled the
MT returns the unsolicited result codes: +CESQ:
<rxlev>,<ber>,<rscp>,<ecno>,<rsrq>,<rsrp>, or +ECCESQ:
RSRP,<rsrp>,RSRQ,<rsrq>,SNR,<snr> whenever the extended signal quality is changed. If setting
fails in an MT error, +CME ERROR: <err> is returned.
The read command returns the current reporting settings in the MT.
The test command returns values supported as compound values.
AT+ECCESQS Response
OK
Execution Command If there is any error, response:
AT+ECCESQS=<report level> +CME ERROR: <err>
Response
Read Command +ECCESQS: <report level>
AT+ECCESQS?
Test Command OK
AT+ECCESQS=? Response
+ECCESQS: (list of supported <report level>s)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Note: AT&W will save <report level> to NVM.
Parameter INTEGER TYPE
<REPORT 0 disable unsolicited report.
LEVEL>
1 report +CESQ: <rxlev>,<ber>,<rscp>,<ecno>,<rsrq>,<rsrp>
<RXLEV>
<BER> 2 report +ECCESQ: RSRP,<rsrp>,RSRQ,<rsrq>,SNR,<snr>
<RSCP>
<ECNO> The default value is 0
Integer type; not supported by CAT1
99 not known or not detectable
Integer type; not supported by CAT1
99 not known or not detectable
Integer type; not supported by CAT1
255 not known or not detectable
Integer type; not supported by CAT1
255 not known or not detectable
<RSRP> Integer type
<RSRQ> For +CESQ reporting, refer to sub clause 2.2.9 AT+CESQ
<SNR> For +ECCESQ reporting, the range is -156 dBm to -44 dBm
Integer type
For +CESQ reporting, refer to sub clause 2.2.9 AT+CESQ
For +ECCESQ reporting, the range is -34 dB to 2.5 dB
Integer type
The range is -20 dB to 40 dB
Example
AT+ECCESQS=2
OK
AT+ECCESQS?
+ECCESQ: 2
OK
AT+ECCESQS=?
+ECCESQS: (0-2)
OK
3.1.17 AT+ECSTATUS
This action command returns some key parameter in UE side.
AT+ECSTATUS Response
+ECSTATUS: PHY, DlEarfcn:<dlEarfcn>,
Execution Command UlEarfcn:<ulEarfcn>, PCI:<pci>, Band:<band>,
AT+ECSTATUS RSRP:<rsrp>, RSRQ:<rsrq>, SNR:<snr>, DlBler:<dlBler>,
UlBler:<ulBler>, DataInactTimerS:<dataInactTimers>,
RetxBSRTimerP:<retxBSRTimerP>, TAvalue:<taValue>,
TxPower<txPower>
+ECSTATUS: L2, SrbNum:<srbNum>, DrbNum:<drbNum>
+ECSTATUS: RRC, State:<rrcState>, TAC:<tac>,
CellId:<cellId>
+ECSTATUS: EMM, EmmState:<emmState>,
EmmMode:<emmMode>, PTWMs:<ptwMs>,
EDRXPeriodMs:<eDRXPeriodMs>,
PsmExT3412TimerS:<psmExT3412TimerS>,
T3324TimerS:<T3324TimerS>,
T3346RemainTimeS:<T3346RemainTimeS>
+ECSTATUS: PLMN, PlmnState:<plmnState>,
PlmnType:<plmnType>, SelectPlmn:<selectPlmn>
+ECSTATUS: ESM, ActBearerNum:<actBearerNum>,
APN:<apn>, IPv4:<ipaddr>
Set Command +ECSTATUS: CCM, Cfun:<cfun>, IMSI:<imsi>
AT+ECSTATUS=<module> OK
Response
Test Command +ECSTATUS: <module>,
AT+ECSTATUS=? <name>:<value>[,<name>:<value>[,...]]
Maximum Response Time OK
Parameter Saving Mode If there is any error, response:
+CME ERROR: <err>
Response
+ECSTATUS: (list of supported <module>s)
OK
5s
NO_SAVE
Parameter UNQUOTED STRING
Modules of protocol statck, supported value: PHY, L2, RRC, EMM,
<MODULE> PLMN, ESM, CCM.
Integer type
<DLEARFCN> Downlink earfcn, value range is 0~262143
<ULEARFCN> Integer type
<PCI> Uplink earfcn, value range is 0~262143
<BAND> Integer type
<RSRP> Physical cell ID, value range is 0~503
<RSRQ> Integer type
<SNR> Band, value range is 0~70
Integer type
Value in dBm, range is -156dBm ~ -44dBm
Integer type
Value in dB, range is -34dB ~ -2.5dB
Integer type
Value in dB, range is -20dB ~ 40dB
<DLBLER> Integer type
<ULBLER> Downlink block error, value range is 0~10000
<DATAINACTTIMERS> Integer type
<RETXBSRTIMERP> Uplink block error, value range is 0~10000
Integer type
<TAVALUE> Data inactive timer in seconds, value range is 0~180
Integer type
<TXPOWER> Timer for BSR reporting, value in number of PDCCH periods. Value
pp4 corresponds to 4 PDCCH periods, pp16 corresponds to 16
<DRBNUM> PDCCH periods and so on.
<RRCSTATE> Integer type
Timing advance value.
<TAC> Value range is 0~1282.
<CELLID> -1 is invalid value
<EMMSTATE> Integer type
Current TX power level in dBm.
<EMMMODE> Value range is -45~23.
<PTWMS> -128 is invalid value
<EDRXPERIODMS> Integer type
<PSMEXT3412TIMERS> Value range is 0~11
<T3324TIMERS> String type
<T3346REMAINTIMES > Value range is "DEACT","OOS","IDLE","SUSPEND IDLE","
<PLMNSTATE> CONNECTED","UNKONWN"
Integer type
Value range is 0~65534
Integer type
Value range is 0~268435455
String type
Value range is "NULL","DEREG"," REG INIT","REG","DEREG
INIT","TAU INIT","SR INIT","UNKNOWN"
String type
Value range is "IDLE","PSM","CONNECTED","UNKNOWN"
Integer type
eDRX Paging Time Window in milliseconds
Integer type
eDRX period in milliseconds
Integer type
Extended T3412 timer value in seconds
Integer type
T3324 timer value in seconds
Integer type
If T3346 is running, set to the remaining time, else set to 0
String type
Value range is "NO PLMN", "SEARCHING", "SELECTED",
"UNKNOWN"
<PLMNTYPE> String type
<SELECTPLMN>
<ACTBEARERNUM> Value range is "HPLMN", "EHPLMN", "VPLMN", "UPLMN",
<APN>
<IPV4ADDR IPV6ADDR> "OPLMN", "UNKNOWN"
<FUN>
String type
<IMSI>
Selected PLMN
Integer type
activated bearer number
String type
access point name
String type
Ipv4/Ipv6 address
Integer type
0 Minimum functionality
1 Full functionality
4 Turn off RF
String type
International Mobile Subscriber Identity (string with double quotes)
Example
AT+ECSTATUS
+ECSTATUS: PHY, DlEarfcn:3738, UlEarfcn:21738, PCI:11, Band:8, RSRP:-91, RSRQ:-8, SNR:8,
DlBler:0/100, UlBler:0/100, DataInactTimerS:0, RetxBSRTimerP:0, TAvalue:-1, TxPower:-128
+ECSTATUS: L2, SrbNum:0, DrbNum:0
+ECSTATUS: RRC, State:"IDLE", TAC:23369, CellId:26224411
+ECSTATUS: EMM, EmmState:"REG", EmmMode:"IDLE", PTWMs:5120, EDRXPeriodMs:40960,
PsmExT3412TimerS:0, T3324TimerS:300, T3346RemainTimeS:0
+ECSTATUS: PLMN, PlmnState:"SELECTED", PlmnType:"EHPLMN", SelectPlmn:"0x460,0xf000"
+ECSTATUS: ESM, ActBearerNum:1, APN:"sxzcat1.mnc006.mcc460.gprs", IPv4:"100.83.34.10"
+ECSTATUS: CCM, Cfun:1, IMSI:"460043263600041"
OK
AT+ECSTATUS=PHY
+ECSTATUS: PHY, DlEarfcn:3738, UlEarfcn:21738, PCI:11, Band:8, RSRP:-91, RSRQ:-8, SNR:8,
DlBler:0/100, UlBler:0/100, DataInactTimerS:0, RetxBSRTimerP:0, TAvalue:-1, TxPower:-128
OK
AT+ECSTATUS=?
+ECSTATUS: (PHY,L2,RRC,EMM,PLMN,ESM,CCM)
OK
3.1.18 AT+ECICCID
Execution command causes the TA to return the ICCID of the UICC.
AT+ECICCID
Execution Command Response
AT+ECICCID +ECICCID: <ICCID>
Test Command OK
AT+ECICCID=? If there is any error, response:
Maximum Response Time +CME ERROR: <err>
Parameter Saving Mode Response
OK
Parameter 5s
NO_SAVE
<ICCID>
STRING TYPE
Integrated circuit card identification
Example
AT+ECICCID
+ECICCID: 89861119220009636664
OK
3.1.19 AT+ECBCINFO
Execution command to return the basic serving cell information and neighbor cells information, mainly
used for location service.
AT+ECBCINFO Response
+ECBCINFOSC:
Execution Command <earfcn>,<pci>,<rsrp>,<rsrq>,<mcc>,<mnc
AT+ECBCINFO[=<mode>[,<timeoutS>[,<
save_for_later>[,<max_cell_number>
[,<report_mode>]]]]] >,<cellid>,<tac>
[<CR><LF>+ECBCINFONC:
Test Command <earfcn>,<pci>,<rsrp>,<rsrq>[,<mcc>,<mn
AT+ECBCINFO=? c>,<cellid>,<tac>]
[...]]
Maximum Response Time OK
Parameter Saving Mode If there is any error, response:
+CME ERROR: <err>
Response
+ECBCINFO: (list of supported <mode>s),(range
of supported <timeoutS>),(list of supported
<save_for_later>s), (range of supported
<max_cell_number>s),(list of supported
<report_mode>s)
OK
305s
NO_SAVE
Parameter INTEGER TYPE
0 Only search/measure neighbor cell signal quality: RSRP and RSRQ, don't
<MODE>
acquire neighbor cell SIB1 don't return cell location information. In this
<TIMEOUTS> mode, neighbor cell information in AT response is: +ECBCINFONC:
<SAVE_FOR_LATE <earfcn>,<pci>,<rsrp>,<rsrq>
R> Note: default value 0
1 Search cell, including measure cell and acquire cell SIB1 to get cellID,
PLMN, and tac info. In this mode, neighbor cell information in AT response
is: +ECBCINFONC:
<earfcn>,<pci>,<rsrp>,<rsrq>,<mcc>,<mnc>,<cellid>,<tac>
Note:
If cell locked is enabled, UE will only response serving cell information.
If frequency locked is enabled, UE will response serving cell and intra-
frequency information.
2 Read saved cell information, <save_for_later> set to 1 should be
called before, otherwise, no cell information will be returned.
Integer type
MAX measurement time in unit of seconds, cell information should be
acquired/returned in this time period.
Note:
1. Range: (4-300)
2. Default value: 8
Integer type
Whether need to save cell information, which could be returned in case of
AT+ECBCINFO=2 later.
<MAX_CELL_NUMB Note:
ER> 1. As the cell information should be saved into flash when enter deep sleep
<REPORT_MODE> mode: sleep2 and HIB, don't suggest to save it frequently.
2. List value: (0,1)
<EARFCN> 3. Default value: 0, not save.
<PCI> Integer type
<RSRP> Max number of cells to be measured or searched, including serving cell.
<RSRQ> Note:
<MCC> 1. The more cells needed, the longer measurement time it takes.
<MNC> 2. Range: (1-7)
<CELLID> 3. Default value: 7
<TAC> Integer type
0 Synchronous mode. Report cell info in AT response.
Note: Default value: 0
1 Asynchronous mode. AT response immediately, measured cell information
returned in URC:
[<CR><LF>+ECBCINFOSC:
<earfcn>,<pci>,<rsrp>,<rsrq>,<mcc>,<mnc>,<cellid>,<tac>[
<CR><LF>
[<CR><LF>+ECBCINFONC:
<earfcn>,<pci>,<rsrp>,<rsrq>[,<mcc>,<mnc>,<cellid>,<tac>
]
[...]]
Integer type
Indicate the EARFCN of the cell. Range 0 ~ 262143
Integer type
Indicate the physical cell ID. Range 0 ~ 503
Integer type
Indicate the measurement of RSRP value, in unit of dBm. Range -156 ~ -44
Integer type
Indicate the measurement of RSRQ value, in unit of dB. Range -34 ~ 2.5
String type
Indicate the mobile country code
String type
Indicate the mobile network code
String type
Four byte E-UTRAN cell ID in hexadecimal format
String type
Two byte tracking area code in hexadecimal format
Note:
1. This AT command could be executed in cfun0/cfun4 state.
2. This AT command could also be executed, if SIM card is not inserted.
3. If the UE is not registered successfully (e.g. in cfun0/cfun4 state, or if no SIM card inserted), then the
cell with the best signal quality (RSRP) will be regarded as the serving cell.
4. If the UE is registered, then the cell with the same registered PLMN (or EPLMN) will be returned.
Example
//test command
AT+ECBCINFO=?
+ECBCINFO: (0,1,2),(4-300),(0,1),(1-5),(0,1)
OK
//execute, default mode is 0
AT+ECBCINFO
+ECBCINFOSC: 3684,9,-87,-10,"460","00","0190271A","5B49"
+ECBCINFONC: 3686,425,-86,-9
+ECBCINFONC: 3688,172,-87,-12
+ECBCINFONC: 3686,484,-89,-12
OK
//execute, mode set to 0
AT+ECBCINFO=0
+ECBCINFOSC: 3684,9,-84,-9,"460","00","0190271A","5B49"
+ECBCINFONC: 3688,172,-86,-11
+ECBCINFONC: 3686,425,-93,-16
OK
//execute, mode set to 1
AT+ECBCINFO=1,12,1,2
+ECBCINFOSC: 3684,9,-86,-9,"460","00","0190271A","5B49"
+ECBCINFONC: 3686,425,-88,-10,"460","00","0192781A","5B65"
OK
//execute, read last saved cell information
AT+ECBCINFO=2
+ECBCINFOSC: 3684,9,-86,-9,"460","00","0190271A","5B49"
+ECBCINFONC: 3686,425,-88,-10,"460","00","0192781A","5B65"
OK
//execute, asynchronous report mode
AT+ECBCINFO=1,8,0,5,1
OK
+ECBCINFOSC: 3684,9,-84,-9,"460","00","0190271A","5B49"
+ECBCINFONC: 3688,172,-86,-8,"460","00","0182201A","5B4A"
+ECBCINFONC: 3686,425,-88,-10,"460","00","0192781A","5B65"
+ECBCINFONC: 3684,124,-88,-15,"460","00","00D5205A","5B2C"
+ECBCINFONC: 3686,484,-92,-14,"460","00","0192891A","5B4A"
3.1.20 AT+ECDNS
This command to get the IP address for a specific URL. As a limitation now, only one IP address is
returned for a URL
AT+ECDNS Response
+ECDNS: <ipaddr>
Execution Command OK
AT+ECDNS=<url> If there is any error, response:
+SOCKET ERROR: <err>
Test Command Response
AT+ECDNS=? OK
Maximum Response Time 30s
Parameter Saving Mode NO_SAVE
Parameter STRING TYPE
Domain name
<URL> String type
If IPv4 type, output is dot-notation format, such as: "32.1.13.184"
<IPADDR> If IPv6 type, output is colon-notation format, such as:
"2001:0DB8:0000:CD30:0000:0000:0000:0002"
Example
AT+ECDNS="www.baidu.com"
+ECDNS: "39.156.66.14"
OK
3.1.21 AT+ECDNSCFG
Set command set the default DNS server addresses configuration. It is the lowest priority for DNS server
addresses setting. When the DNS server addresses is invalid which is assigned by core network or
operator default setting. The DNS server addresses will be configured.
AT+ECDNSCFG
Execution Command Response
AT+ECDNSCFG=<ipaddr1>[,<ipaddr2> OK
[,<ipaddr3>[,<ipaddr4>]]] If there is any error, response:
+SOCKET ERROR: <err>
Read Command Response
AT+ECDNSCFG? +ECDNSCFG: <ipaddr1>[,<ipaddr2>
[,<ipaddr3>[,<ipaddr4>]]]
OK
Test Command Response
AT+ECDNSCFG=? OK
Maximum Response Time 5s
Parameter Saving Mode AUTO_SAVE
Parameter STRING TYPE
If IPv4 type, output is dot-notation format, such as: "32.1.13.184"
<IPADDR> If IPv6 type, output is colon-notation format, such as:
"2001:0DB8:0000:CD30:0000:0000:0000:0002"
Example
AT+ECDNSCFG?
+ECDNSCFG:
"114.114.114.114","114.114.115.115","240c:0000:0000:0000:0000:0000:0000:6666", "240c:0000:
0000:0000:0000:0000:0000:6644"
OK
AT+ECDNSCFG="114.114.114.12"
OK
3.1.22 AT+ECEMMTIME
This command report and get the Emm Time State, include T3346T3448 and T3412/extend T3412.
AT+ECEMMTIME Response
OK
Set Command If there is any error, response:
AT+ECEMMTIME=<bitmap> +CME ERROR: <err>
Response
Read Command +ECEMMTIME:0,<timeState>[,<remainTimeValue>]
AT+ECEMMTIME? +ECEMMTIME:1,<timeState>[,<remainTimeValue>]
+ECEMMTIME:2,<timeState>[,<remainTimeValue>]
OK
If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+ECEMMTIME=? +ECEMMTIME: (range of supported <bitmap>s)
Indicate OK
Maximum Response Time Response
Parameter Saving Mode +ECEMMTIME:
<timeId>,<timeState>[,<timeValue>]
Parameter 5s
NO_SAVE
<BITMAP> Note: AT&W will save <bitmap> to NVM.
<TIMEID> INTEGER TYPE
bit 0: enable/disable unsolicited result code T3346
<TIMESTATE> bit 1: enable/disable unsolicited result code T3448
bit 2: enable/disable unsolicited result code T3412/ext T3412
<REMAINTIMEVALUE> The default value is 0
Integer type
0: Emm Timer: T3346
1: Emm Timer: T3448
2: Emm Timer: T3412/ext T3412
Integer type
0: Start
1: Stop
2: Expiry
Integer type
Time remain value in seconds, Only include when <timeState> is 0.
<TIMEVALUE> Integer type
Time value in seconds, Only include when < timeState> is 0.
Example
AT+ECEMMTIME=7
OK
AT+ECEMMTIME?
+ECEMMTIME: 0,1
+ECEMMTIME: 1,1
+ECEMMTIME: 2,0,3240
OK
+ECEMMTIME: 2,0,3240
3.1.23 AT+ECPCFG
Set command is used to set plat configure, if set parameter error, +CME ERROR: <err> is returned.
Read command returns the current plat configure setting.
AT+ECPCFG Response
OK
Set Command If there is any error, response:
AT+ECPCFG=<mode>,<value> +CME ERROR: <err>
Response
Read Command +ECPCFG:
AT+ECPCFG? "faultAction":<value>,"uartDumpPort" :<value>,"s
tartWDT":<value>,"logCtrl":<value>,"logLevel":<v
alue>,"logBaudrate":<value>,"slpWaitTime":<value
>,"logPortSel":<value>,"usbCtrl":<value>,"usbSwT
race":<value>,"usbSlpMask":<value>,"usbSlpThd":<
value>,"pwrKeyMode":<value>,"usbNet":<value>,"fo
taUrcBaudrate":<value>,"fotaUrcPortSel":<value>
Test Command OK
AT+ECPCFG=? Response
+ECPCFG: <option>,<setting>
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter STRING TYPE
faultAction Set the hardfault action mode
<MODE> uartDumpPort Choose assert info dump uart port
startWDT Set watch dog mode
<VALUE> logCtrl Set log control mode
logLevel Set log print level
logBaudrate Set log print baud rate
slpWaitTime Set sleep wait time
logPortSel Set log output port
usbCtrl Set usb control mode
Integer type
For faultAction, the values range is from 0 to 4
0: dump full exception info to flash and EPAT tool then trapped in endless
loop
1: print necessary exception info then reset
2: dump full exception info to flash then reset
3: dump full exception info to flash and EPAT tool then reset
4: reset directly. Suggest set to this value when mass production stage.
10: enable uart to help dumping and dump full exception info to flash and
EPAT tool then trapped in endless loop
13: enable uart to help dumping and dump full exception info to flash and
EPAT tool then reset
For uartDumpPort, the values range is from 0 to 255
0-n(subject to the total number of uart port): the index of uart port through
which to output dump info
255: disable this feature
For startWDT, the values range is from 0 to 1
0: stop WDT
1: start WDT. Suggest set to this value when mass production stage.
For logCtrl, the values range is from 0 to 2
0: unilog is disabled
1: only sw log is enabled
2: All log is enabled
For logLevel, the values range is from 0 to 5
0: debug log level
1: info log level
2: value log level
3: signal log level
4: warning log level
5: error log level
For logBaudrate, the values range is from 921600 to 6000000
For slpWaitTime, the values range is from 0 to 0xffff
For logPortSel, the values range is from 0 to 2
0: log is output to USB default
1: log is output to UART0
2: log could be output to USB and UART
For usbCtrl, the values range is from 0 to 2
0: usb is enabled and initialized, RNDIS is enumerated
1: usb is enabled and initialized, RNDIS is not enumerated
2: usb is disabled and not initialized
NOTE: Should not disable RNDIS in WIN PC when enable and disable
RNDIS. If RNDIS is disabled in WIN PC host side, dynamic enable and
disable RNDIS in UE via above AT, PC will not fresh device manager and still
show RNDIS device and it will also effect VCOM port.
e.g. step1: 3 VCOM ports and 1 RNDIS is enumed
step2: disable RNDIS in WIN PC
step3: AT+ECPCFG=usbCtrl,1 to disable RNDIS in UE
step4: after reset UE, WIN PC still show RNDIS and only 2 VCOM ports
For usbSwTrace, the values range is from 0 to 1
0: disable usb software trace
1: enable usb software trace
For usbSlpMask, the values range is from 0 to 1
0: usb will vote for sleep
1: mask the usb voting result
For usbSlpThd, the values range is from 0 to 65535
NOTE: do not sleep when sleep time is less than usbSlpThd to avoid too
much USB enumeration on PC.
For pwrKeyMode, the values range is from 0 to 2
0: power key internal pull up without debounce
1: power key internal pull up with debounce
2: power key without internal pull up
For usbNet, the values range is from 0 to 1
0: RNDIS network interface
1: ECM network interface
For fotaUrcBaudrate, which is a read command here, the value is set by
"AT+IPR=<value>"
For fotaUrcPortSel, the value is splitted by 2 parts,
Bit4-7: port type, 0 - USB, 1 - UART
Bit0-3: port index
3.1.24 AT+ECUSBSYS
Set command is used to set plat configure, if set parameter error, +CME ERROR: <err> is returned.
Read command returns the current plat configure setting.
AT+ ECUSBSYS Response
OK
Set Command If there is any error, response:
AT+ECUSBSYS=<mode>,<value +CME ERROR: <err>
> Response
+ECUSBSYS:
Read Command "VBUSModeEn":<value>,"VBUSWkupPad" :<value>
AT+ECUSBSYS? OK
Response
Test Command +ECUSBSYS: <option>,<setting>
AT+ECUSBSYS=?
Maximum Response Time OK
Parameter Saving Mode 5s
SAVE
Parameter STRING TYPE
VBUSModeEn Set the VBUS Mode enable/disable
<MODE> VBUSWkupPad Set VBUS Wakeup pad index
<VALUE> Integer type
For VBUSModeEn, the values range is from 0 to 1
0: USB VBUS Mode disable
1: USB VBUS Mode enable
For VBUSWkupPad, the values range is from 0 to 5
0: USB VBUS connect to wake up pad 0
1: USB VBUS connect to wake up pad 1
2: USB VBUS connect to wake up pad 2
3: USB VBUS connect to wake up pad 3
4: USB VBUS connect to wake up pad 4
5: USB VBUS connect to wake up pad 5
3.1.25 AT+ECSLEEP
This command is used for power consumption test. After executing this command, UE will enter related
low power state. And UE could be wake up by wakeup PAD, after wake up, UE will reboot.
AT+ECSLEEP
Set Command Response
AT+ECSLEEP=<state> +ECSLEEP: <mode>
Test Command OK
AT+ECSLEEP=? If there is any error, response:
+CME ERROR: <err>
Response
+ECSLEEP: <state>
Maximum Response Time OK
Parameter Saving Mode 5s
SAVE
Parameter INTEGER TYPE
<STATE> 0 HIB2
<MODE> 1 HIB1
2 SLEEP2
3 SLEEP1
4 OFF
String type
HIB2 Hibernate2 status
HIB1 Hibernate1 status
SLEEP2 Sleep2 status
SLEEP1 Sleep1 status
3.1.26 AT+ECSIMCFG
The command set sim configuration.
The read command return current setting of each parameters.
The test command returns values supported as a compound value.
AT+ECSIMCFG Response
OK
Set Command If there is any error, response:
AT+ECSIMCFG=<param>,<value> +CME ERROR: <err>
Response
Read Command +ECSIMCFG: <param1>,< value1>
AT+ECSIMCFG?
Test Command [+ECSIMCFG: <param2>,<value2>]
AT+ECSIMCFG=? [...]
OK
Maximum Response Time Response
Parameter Saving Mode +ECSIMCFG: (list of supported <param>s)
OK
5s
AUTO_SAVE
Parameter STRING TYPE, NAME OF CONFIGURATION PARAMETER. NOTE: THE MAX
<PARAM>
NUMBER OF CONFIGURATION PARAMETERS IS 8 FOR A SINGLE AT
COMMAND.
"SimSimulator" Enable/disable virtual SIM card for instrument
test,such as CMW500.
Note:
a) Supported values: (0,1)
b) Default value: 0
c) Set it, then virtual SIM or real SIM take effect
by terminal reset or entering AT+CFUN=0/1.
"SimPowerSave" Enable/disable SIM power save.
Note:
a) Supported values: (0,1)
b) Default value: 1.
"SimPresenceDetect" Enable/disable SIM presence detection
Note:
a) Supported values: (0,1)
b) Default value: 1.
"SimSlot" Select SIM slot, only support SIM slot 0 or 1. The
hardware interface of SIM shall be ready if select
SIM slot 0 or 1.
Note:
a) Supported values: (0,1)
b) Default value: 0
c) It must be restricted to execute in power off
(AT+CFUN=0) state.
"SoftSIM" Enable/disable SoftSIM if integrated, then start
SoftSIM or physical SIM card when power on.
Note:
a) Supported values: (0,1)
b) Default value: 0
c) It must be restricted to execute in power off
(AT+CFUN=0) state.
d) Shall integrate SoftSIM lib to EC SDK with
SoftSIM vender.
Example
AT+ECSIMCFG="SimSimulator",0
OK
AT+ECSIMCFG?
+ECSIMCFG: "SimSimulator ",0
+ECSIMCFG: "SimPowerSave ",1
+ECSIMCFG: "SimPresenceDetect",0
+ECSIMCFG: "SimSlot",0
+ECSIMCFG: "SoftSim",0
OK
AT+ECSIMCFG=?
("SimSimulator","SimPowerSave","SimPresenceDetect","SimSlot","SoftSim")
OK
3.1.27 AT+ECSIMSLEEP
The command set UE to allow SIM card sleep (power off SIM) or not (power on SIM) for AT+CSIM and
AT+CRSM. It's only allowed when "SimPowerSave" is 1 set by AT+ECSIMCFG. If "SimPowerSave" is 1,
shall set SIM sleep not allowed (power on SIM) before use AT+CSIM or AT+CRSM, then set SIM sleep
allowed (power off SIM) to save power after finish all commands of AT+CSIM or AT+CRSM.
The read command return current setting of each parameters.
The test command returns values supported as a compound value.
AT+ECSIMSLEEP Response
OK
Set Command If there is any error, response:
AT+ECSIMSLEEP=<mode> +CME ERROR: <err>
Response
Read Command +ECSIMSLEEP: <mode>
AT+ECSIMSLEEP? OK
Response
Test Command +ECSIMSLEEP: (list of supported <mode>s)
AT+ECSIMSLEEP=? OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
<MODE>
0 Not allowed SIM sleep
1 Allowed SIM sleep
Note:
Default value: 1
3.1.28 AT+ECCGSNLOCK
This command is used to set lock flag for IMEI and SN. If locked, IMEI and SN could not be write via
AT+ECCGSN command. The lock feature maybe required in production stage, to prevent customer's miss
operation. If lock is set, it could not be cleared via AT command, the only way to clear it is via flash tool
(erase related region).
The set command set lock for IMEI and SN.
The test command returns parameter supported as a compound value.
The read command returns current lock status.
AT+ECCGSNLOCK Response
OK
Set Command If there is any error, response:
AT+ECCGSNLOCK=<para> +CME ERROR: <err>
Response
Test Command +ECCGSN: <list of support para>
AT+ECCGSNLOCK =? OK
Response
Read Command +ECCGSN: <imeistatus,snstatus>
AT+ECCGSNLOCK? OK
If there is any error, response:
Maximum Response Time +CME ERROR: <err>
Parameter Saving Mode 5s
SAVE
Parameter STRING TYPE
<PARA>
"IMEI"
"SN"
<IMEISTATUS> String type
"IMEI LOCKED"
"IMEI NOT LOCKED "
<SNSTATUS> String type
"SN LOCKED"
"SN NOT LOCKED "
Example
AT+ECCGSNLOCK=IMEI//lock imei
OK
AT+ECCGSNLOCK?
+ECCGSNLOCK: IMEI LOCKED,SN NOT LOCKED
OK
AT+ECCGSN=IMEI,XXXXXX
+ECCGSN:IMEI LOCKED
+CME ERROR: 50
3.1.29 AT+ECSAVEFAC
This command is used in production line, which saves related regions to default reliable region.
e.g. after IMEI/SN was written or RF calibration was done.
Default reliable regions is used to restore factory setting.
The set command saves related regions to default reliable region..
The test command returns mode supported as a compound value.
AT+ECSAVEFAC Response
OK
Set Command If there is any error, response:
AT+ECSAVEFAC=<mode> +CME ERROR: <err>
Response
Test Command +ECSAVEFAC: <mode>
AT+ECSAVEFAC=? OK
5s
Maximum Response Time SAVE
Parameter Saving Mode
Parameter STRING TYPE
<MODE>
"all" All regions
"rfregion" Only RF regions
"other" Regions except RF, currently IMEI/SN region
3.1.30 AT+ECTASKINFO
The execution command returns all the task's name, id, status, priority and stack information. This
command is only for debug purpose.
AT+ECTASKINFO Response
+ECTASKINFO: <task information>
Execution Command OK
AT+ECTASKINFO 5s
Maximum Response NO_SAVE
Time
Parameter Saving Mode
3.1.31 AT+ECTASKHISTINFO
The execution command shows most recent tasks' scheduling history. This command is only for debug
purpose.
AT+ECTASKHISTINFO Response
+ECTASKHISINFO: <task scheduling history>
Execution Command OK
AT+ECTASKHISINFO 5s
NO_SAVE
Maximum Response Time
Parameter Saving Mode
3.1.32 AT+ECSHOWMEM
The execution command shows current heap memory usage. This command is only for debug purpose.
AT+ECSHOWMEM
Execution Command Response
AT+ECSHOWMEM +ECSHOWMEM: <curr_free_heap, min_free_heap>
OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter
<CURR_FREE_HEAP > INTEGER TYPE
0--heap size current remained free memory size in heap
<MIN_FREE_HEAP > Integer type
0---heap size minimum heap memory size ever remaining in heap
3.1.33 AT+ECSYSTEST
This command is only for debug purpose.
The test command returns option supported as a compound value.
The set command triggers a test feature.
AT+ECSYSTEST Response
+ECSYSTEST: <option>
Test Command OK
AT+ECSYSTEST=? Response
KO
Set Command If there is any error, response:
AT+ECSYSTEST=<option> +CME ERROR: <err>
When <test>="assert" or "fsassert" system assert
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter STRING TYPE
< OPTION >
handshake Perform handshake with UE
assert Trigger a test assert
testwdt Trigger watch dog test
fsassert Trigger file system assert for test
hardfault Trigger a hardfault for test
3.1.34 AT+ECVOTECHK
This command shows current vote state, which can help to analyze the reason of sleep failure.
This command is only for debug purpose.
AT+ ECVOTECHK Response
Sleep Vote Info:
Set Command <vote info detail>
AT+ECVOTECHK OK
Maximum Response Time 5s
Parameter Saving Mode NO SAVE
NOTE: vote info detail shows comprehensive information which will affect sleep process in SDK.
The detail info is separated into 5 parts.
Part1: user set sleep depth limitation.
Part2: EC internal sleep vote result.
Part3: application vote result.
Part4: user registered sleep depth callback.
Part5: driver vote result.
Part6: cp vote result
For more detail information, please refer to slpman.h in SDK and low power development manual.
Example
AT+ECVOTECHK
Sleep Vote Info:
Deepest Sleep Mode: Hibn //part1
(Note: return the deepest sleep mode allowed to enter. It can be set by using
slpManSetPmuSleepMode which can be found in slpman.h.)
EC SDK Vote for: Hibn (Note: SDK internal vote result)//part2
Detail: 0x0,0x0,0x0
Application Vote for: Hibn //part3
(Note: Normally, application use the vote API in slpman.h to control sleep state. This item returns the
application vote result)
Handle: 0 Name: CTIOT_NB Prohibit State: NULL Vote count: 0
Handle: 1 Name: ONENETSL Prohibit State: NULL Vote count: 0
Note: The sub item show more detail of vote the vote result, including vote handle, name
information, vote state and vote counter
Prohibit State can be "NULL","Slp1", "Slp2", "Hibn"
Prohibit State: NULL App do not prohibit to enter all sleep state
Prohibit State: Slp2 App prohibit to enter sleep2, so the system can only sleep to sleep1
User defined Sleep Callback Vote for: Hibn //part4
(Note: Vote result for UsrSlpDepth callback which is registered by calling
slpManRegisterUsrSlpDepthCb())
Driver Vote bitMap: 0x0, with vote mask: 0x0 //part5
(Note: driver vote result and vote mask info. The bitmap is corresponding to the enum type
slpDrvVoteModule_t in slpman_ec616.h
The vote mask indicate the sleep flow do not care about specific driver vote result
For example:
Driver Vote bitMap: 0x9, with vote mask: 0x8
UART and ADC do not allow to sleep, but as the vote mask is 0x8, PMU module do not take ADC
vote result into consideration. It will enter sleep as soon as UART clear the bit 0
For drivers, if the (bitmap & (~mask)) != 0 the system can not go to sleep1 or deeper state)
CP sleeped: 1, Vote to: 2(slp1/2/hib/none) //part6
(Note: report cp sleep state and cp vote result)
OK
3.1.35 AT+ECURC
The command close/open URC (unsolicited result code) report.
AT+ ECURC Response
OK
Set Command If there is any error, response:
AT+ECURC=[<urcStr>,]<val +CME ERROR: <err>
ue> Response
+ECURC:
Read Command "CREG":<value>,"CEREG":<value>,"CEDRXP":<value>,"
AT+ECURC? CCIOTOPTI":<value>,"CSCON":<value>,"CTZEU":<value
>,"ECCESQ":<value>,"CGEV":<value>,"ECPSMR":<value
>,"ECPTWEDRXP":<value>,"ECPIN":<value>,"ECPADDR":
<value>,"ECPCFUN":<value>,"ECSMSFULL":<value>
OK
If there is any error, response:
Test Command +CME ERROR: <err>
AT+ECURC=? Response
+ECURC: "ALL":(0-1),"CREG":(0-1),"CEREG":(0-
1),"CEDRXP":(0-1),"CCIOTOPTI":(0-1),"CSCON":(0-
1),"CTZEU":(0-1),"ECCESQ":(0-1),"CGEV":(0-
1),"ECPSMR":(0-1),"ECPTWEDRXP":(0-1),"ECPIN":(0-
1),"ECPADDR":(0-1),"ECPCFUN":(0-
1),"ECSMSFULL":(0-1)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Note: AT&W will save <value> to NVM.
Parameter STRING TYPE;
<URCSTR> If <urcStr> is not included, it will be interpreted as "ALL".
<VALUE> "ALL" All unsolicited result codes included as below
"CREG" unsolicited result code +CREG
"CEREG" unsolicited result code +CEREG
"CEDRXP" unsolicited result code +CEDRXP
"CCIOTOPTI" unsolicited result code +CCIOTOPTI
"CSCON" unsolicited result code +CSCON
"CTZEU" unsolicited result code +CTZEU
"ECCESQ" unsolicited result code +ECCESQ
"CGEV" unsolicited result code +CGEV
"ECPSMR" unsolicited result code +ECPSMR
"ECPTWEDRXP" unsolicited result code +ECPTWEDRXP
"ECPIN" unsolicited result code +ECPIN
"ECPADDR" unsolicited result code +ECPADDR
"ECPCFUN" unsolicited result code +ECPCFUN
"ECSMSFULL" unsolicited result code +ECSMSFULL
Integer type;
0 disable unsolicited result code report
1 enable unsolicited result code report
Example
AT+ECURC="ALL",1
OK
AT+ECURC=1
OK
AT+ECURC?
+ECURC:
"CREG":1,"CEREG":1,"CEDRXP":0,"CCIOTOPTI":0,"CSCON":1,"CTZEU":1,"ECCESQ":1,"CGEV":1,"ECPSM
R":1,"ECPTWEDRXP":1,"ECPIN":1,"ECPADDR":1,"ECPCFUN":1,"ECSMSFULL":1
OK
AT+ECURC=?
+ECURC: "ALL":(0-1),"CREG":(0-1),"CEREG":(0-1),"CEDRXP":(0-1),"CCIOTOPTI":(0-
1),"CSCON":(0-1),"CTZEU":(0-1),"ECCESQ":(0-1),"CGEV":(0-1),"ECPSMR":(0-1),"ECPTWEDRXP":(0-
1),"ECPIN":(0-1),"ECPADDR":(0-1),"ECPCFUN":(0-1),"ECSMSFULL":(0-1)
OK
3.1.36 AT+ECPTWEDRXS
The set command controls the setting of the UE's paging time window and eDRX parameters. It can be
used to control whether the UE wants to apply paging time window and eDRX or not, as well as the
requested eDRX value.
The set command also contols the presentation of the URC when <n>=2 and there is a change of the
paging time window and eDRX parameters provided by network:
+ECPTWEDRXP: <AcT-
type>[,<Requested_Paging_time_window>[,<Requested_eDRX_value>[,<NW_provided_eDRX_value>[,
<Paging_time_window>]]]]
A special form of the command can be given as AT+ECPTWEDRXS=3. In this form, paging time window
and eDRX will be disabled and data for all parameters in AT+ECPTWEDRXS command will be removed.
The read command returns the current settings for each defined value of <AcT-type>.
The test command returns the supported <mode>s and the value ranges for the access technology and
the requested paging time window and requested eDRX value as compound values.
AT+ECPTWEDRXS Response
OK
Set Command If there is any error, response:
AT+ECPTWEDRXS=<mode>,<AcT- +CME ERROR: <err>
type>[,<Requested_Paging_ti
me_window>[,<Requested_eDRX Response
_value>]] +ECPTWEDRXS: <AcT-
Read Command type>,<Requested_Paging_time_window>,<Requeste
AT+ECPTWEDRXS? d_eDRX_value>[,<NW_provided_eDRX_VALUE>[,<Pagi
ng_time_window>]]
Test Command OK
AT+ECPTWEDRXS=? Response
+ECPTWEDRXS: (list of supported <mode>s),(list of
Maximum Response Time supported <AcT-type>s),(list of supported
Parameter Saving Mode <Requested_Paging_time_window>s), (list of supported
<Requested_eDRX_value>s)
5s
NO_SAVE
Note: AT&W will save <value> to NVM.
Parameter INTEGER TYPE; INDICATES TO DISABLE OR ENABLE THE
USE OF REQUESTED PAGING TIME WINDOW AND EDRX IN
<MODE> 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-TYPE>.
0 Disable the use of requested paging time window and eDRX
1 Enable the use of requested paging time window and eDRX
2 Enable the use of requested paging time window and eDRX
and enable the unsolicited result code:
+ECPTWEDRXP: <AcT-
type>[,<Requested_Paging_time_window>
[,<Requested_eDRX_value>[,<NW-
provided_eDRX_value>[,<Paging_time_window>]]]
3 Disable the use of paging time window and eDRX and
discard all parameters for pagint time window and eDRX.
<ACT-TYPE> Integer type; indicates the type of access technology.
0 Access technology is not using eDRX
4 E-UTRAN(WB-S1 mode)
<REQUESTED_PAGING_TIME_WINDOW > String type; half a byte in a 4 bit format. The paging time window
<REQUESTED_EDRX_VALUE> referes to bit 8 to 5 of octet 3 of the Extended DRX parameters
<NW-PROVIDED_EDRX_VALUE > information element.
<PAGING_TIME_WINDOW > (e.g."0000" equals 2.56 seconds)
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.
(e.g."0010" equals 20.48 seconds)
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.
(e.g."0010" equals 20.48 seconds)
String type; half a byte in a 4 bit format. The paging time window
referes to bit 8 to 5 of octet 3 of the Extended DRX parameters
information element.
(e.g."0000" equals 2.56 seconds)
Example
AT+ECPTWEDRXS=1,4,"0011","0011"
OK
AT+ECPTWEDRXS?
+ECPTWEDRXS: 4,"0011","0011"
OK
AT+ECPTWEDRXS=?
+ECPTWEDRXS: (0,1,2,3),4,("0000"-"1111"),("0000"-"1111")
OK
3.1.37 +ECPIN
This is an unsolicited result code used to indicate SIM PIN state. It's controlled by AT+ECURC.
+ECPIN
+ECPIN: <code>
Parameter STRING TYPE MT is not pending for any password
READY MT is waiting SIM PIN to be given
<CODE> SIM PIN MT is waiting SIM PUK to be given
SIM PUK MT is waiting SIM PIN2 to be given
Example SIM PIN2 MT is waiting SIM PUK2 to be given
SIM PUK2 The SIM PUK is locked
SIM PUK BLOCKED The SIM is not ready.
NOT READY The SIM is not inserted
NOT INSERTED
3.1.38 +ECPCFUN
This is an unsolicited result code used to indicate the setting of <fun> as AT+CFUN when the MT
powered on. It's controlled by AT+ECURC.
+ECPCFUN
+ECPCFUN: <fun>
Parameter INTEGER TYPE
<FUN>
0 Minimum functionality
1 Full functionality
4 Turn off RF
Example
3.1.39 +ECPADDR
This is an unsolicited result code used to print PDP address. It's controlled by AT+ECURC.
+ECPADDR
+ECPADDR: <cid>[,<PDP_addr_1>[,<PDP_addr_2>]]
Parameter INTEGER TYPE; SPECIFIES A PARTICULAR PDP CONTEXT
DEFINITION (SEE THE +CGDCONT COMMANDS).
<CID>
<PDP_ADDR_1> <CID> VALUES OF 1-15 ARE SUPPORTED.
<PDP_ADDR_2>
<PDP_addr_1> and <PDP_addr_2>: each is a string type that
Example identifies the MT in the address space applicable to the PDP. Both
<PDP_addr_1> and <PDP_addr_2> are omitted if none is available.
Both <PDP_addr_1> and <PDP_addr_2> are included when both
IPv4 and IPv6 addresses are assigned, with <PDP_addr_1>
containing the IPv4 address and <PDP_addr_2> containing the IPv6
address.
The string is given as dot-separated numeric (0-255) parameter of
the form:
a1.a2.a3.a4 for IPv4 and colon-separated hexadecimal parameter of
the form:
xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx for IPv6.
3.1.40 AT+ECADC
This command is used to get thermal temperature and VBAT values sampled by ADC.
AT+ECADC Response
+ECADC: <option>
Test Command OK
AT+ECADC=? Response
+ECADC: <option>,<value>[,<option>,<value>]
Set Command OK
AT+ECADC=<option> 5s
NO_SAVE
Maximum Response Time
Parameter Saving Mode
Parameter STRING TYPE
<OPTION> temp Get current thermal temperature in unit of degree centigrade with 1
<VALUE> degree resolution.
Example vbat Get current VBAT value in unit of mV.
all Get current thermal temperature and VBAT value.
Integer type; Corresponding value of option
AT+ECADC=all
+ECADC: TEMP,26,VBAT,3604
OK
AT+ECADC=temp
+ECADC: TEMP,26
OK
AT+ECADC=vbat
+ECADC: VBAT,3604
OK
3.1.41 AT+ECSWC
The command set UE to enable, disable, query and reset SIM write counter. The counter record the
execution of SIM write command, such as update binary and update record
The read command return current setting of <mode>.
AT+ECSWC Response
OK
Set Command If there is any error, response:
AT+ECSWC=<mode> +CME ERROR: <err>
When <mode>=2 and command successful:
Read Command +ECSWC: <filename>,<counter>
AT+ECSWC? +ECSWC: <filename>,<counter>
Test Command ...
AT+ECSWC=? OK
Maximum Response Time Response
Parameter Saving Mode +ECSWC: <mode>
OK
Response
+ECSWC: (list of supported <mode>s)
OK
5s
SAVE
Parameter INTEGER TYPE
<MODE> 0 Disable the SIM write counter
<FILENAME> 1 Enable the SIM write counter
2 Query the SIM write counter
3 Reset all SIM write counter as 0
String type; SIM EF name, referred to TS31.102, "null" means no file writed.
<COUNTER> Integer type; if overflow occurs, restart from 0.
3.1.42 AT+ECSNTP
This command is used to synchronize the local time with the Universal Time Coordinated (UTC) via the
SNTP server.
The test command returns the supported parameters
The set command sets server name and start to synchronize the local time with the Universal Time
Coordinated (UTC). It will return immediately, the UTC content will be returned via URC.
AT+ECSNTP
Set Command Response
AT+ECSNTP=<server>[,<port>,<autosync>] OK
+ECSNTP:<time>
If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+ECSNTP=? +ECSNTP:"IP ADDR/URL",(0-
65535),(0,1)
OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter STRING TYPE
Address of the NTP server. The format is a
<SERVER> domain name or a dotted decimal IP address.
integer type
<PORT> The NTP server port number, default is 123
<AUTOSYNC> integer type
Whether to automatically set synchronized
<TIME> time to local UTC. Default is 0.
0 Not set
Example 1 Set
string type
AT+ECSNTP=cn.pool.ntp.org Time synchronized from NTP server
OK The format is: "yy/mm/dd: hh/mm/ss,hour:minute:second"
+ECSNTP: 2020/08/01,08:53:48
3.1.43 AT+ECIPR
Set command sets the UE baud rate to be used.
Read command returns the current baud rate.
Test command returns baud rates supported by the UE.
AT+ECIPR Response
OK
Set Command
AT+ECIPR=<rate>
Read Command If there is any error, response:
AT+ECIPR? +CME ERROR: <err>
Response
+ECIPR:<rate>
Test Command OK
AT+ECIPR=? Response
+ECIPR: (list of fixed-only <rate> values)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Parameter BAUD RATE AT WHICH THE UE WILL ACCEPT COMMANDS.
<RATE>
Example
AT+ECIPR=115200
OK
AT+ECIPR?
+ECIPR:115200
OK
AT+ECIPR=?
+ECIPR:(600,1200,2400,4800,9600,19200,38400,57600,115200,230400,460800)
OK
3.1.44 AT+ECNPICFG
Set command is used to set NPI config
Read command returns the current NPI config setting.
AT+ECNPICFG Response
OK
Set Command If there is any error, response:
AT+ECNPICFG=<option>,<setting> +CME ERROR: <err>
Response
Read Command +ECNPICFG:
AT+ECNPICFG? "rfCaliDone":<value>,"rfNSTDone":<value>
Test Command OK
AT+ECNPICFG=? Response
+ECNPICFG: <option>:<value>
Maximum Response Time OK
Parameter Saving Mode 5s
SAVE
Parameter STRING TYPE
rfCaliDone Set RFCALI process status
<OPTION> rfNSTDone Set RFNST process status
Integer type
<SETTING> For rfCaliDone , the values range is from 0 to 1
0: RFCALI process is not done
1: RFCALI process is done
For rfNSTDone, the values range is from 0 to 1
0: RFNST process is not done
1: RFNST process is done
3.1.45 AT+ECPRODMODE
Set command is used to control entering NPI production mode.
Read command returns the current NPI production mode status.
AT+ECPRODMODE
Set Command Response
AT+ECPRODMODE=<setting> OK
If there is any error, response:
Read Command +CME ERROR: <err>
AT+ECPRODMODE? Response
+ECPRODMODE:
"prodModeEnable":<value1>,"prodModeEnter
":<value2>
Test Command OK
AT+ECPRODMODE=? Response
+ECPRODMODE: <status>
Maximum Response Time OK
Parameter Saving Mode 5s
SAVE
Parameter STRING TYPE
prodModeEnable Enable production mode
<SETTING> prodModeDisable Disable production mode
prodModeEnter Enter production mode
<VALUE1> prodModeExit Exit production mode
<VALUE2> Integer type
<STATUS> 0: prodMode is disabled
1: prodMode is enabled
Integer type
0: prodMode isn't entered
1: prodMode is entered
reflects prodMode status
3.1.46 AT+ECPMUSTATUS
The command obtains UE last PMU status.
AT+ECPMUSTATUS Response
+ECPMUSTATUS: <slpstate>, <slptime>
Read Command OK
AT+ECPMUSTATUS? 5s
NO_SAVE
Maximum Response Time
Parameter Saving Mode
Parameter STRING TYPE
Last PMU state UE entered:
<SLPSTATE> Actv Active state
Slp1 Sleep1 state
<SLPTIME> Slp2 Sleep2 state
Hibn Hibernate state
Integer type
Last sleep duration in ms, will be 0 if slpstate is Actv
Example
AT+ECPMUSTATUS?
+ECPMUSTATUS: Actv, 0
OK
AT+ECPMUSTATUS?
+ECPMUSTATUS: Hibn, 3625
OK
3.1.47 AT+ECSTATIS
It is an action command. The execution command causes the MT to start/stop protocol statistic information
reporting.
The test command returns a list of supported <interval> setting.
AT+ECSTATIS Response
OK
Execution Command If there is any error, response:
AT+ECSTATIS=<interval> +CME ERROR: <err>
Response
Test Command +ECSTATIS: list of supported <interval>s
AT+ECSTATIS=?
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Parameter INTEGER TYPE
<INTERVAL>
0 Stop statistic information report
(1-600) UE report statistic information in this period, value is in unit of
seconds.
Note 1:
When statistics reporting is turned on, the UE will disable to enter deep sleep state (Sleep2 & Hibernate)
Note 2:
Statistical parameters description:
Layer Parameter Description Unit Range
AvgRSRP Average RSRP dBm
PHY AvgSnr Average SNR db (-20,40)
COMM TransmissionMode Transmission Mode (1-10)
DlBler DL block error rate %
NewGrantBler DL block error of newGrant %
Physical layer DL average through put (contains
PhyDlTpt HARQ failure data) bps
PHY DL dlGrantNum total DL grant received
dlAvgHarqNum averaged DL receive times for all harq
AvgPRB DL PRB number byte (0-100)
AvgMCS DL MCS number % (0-28)
AvgTBS Average DL transport block size % (0-1287)
dlAvgCqi averaged wideband CQI reported bps
UlBler UL block error rate (0-100)
NewGrantBler UL block error of newGrant byte (0-28)
Physical layer UL average through put (contains dBm (0-645)
PHY UL PhyUlTpt HARQ failure data) byte
ulGrantNum total UL grant number byte
ulAvgHarqNum averaged UL transmit times for all harq byte
AvgPRB UL PRB number byte
AvgMCS UL MCS number bps
AvgTBS Average UL transport block size bps
txPower Tx power
Total amount of MAC layer data transmitted during
MacUlBytes the interval
Total amount of MAC layer padding data
MAC MacUlPadBytes transmitted during the interval
MacDlBytes Total amount of MAC layer data received during
the interval
MacDlPadBytes Total amount of MAC layer padding data received
MacUlTpt during the interval
MacDlTpt MAC layer UL average through put
MAC layer DL average through put
Total amount of new RLC PDU data transmitted
RlcUlPduBytes during the interval byte
Total amount of re-transmitted RLC PDU data
RlcUlRetxBytes transmitted during the interval byte
RLC Total amount of RLC PDU data received during the
RlcDlPduBytes interval byte
RLC layer UL average through put (not contained
RlcUlTpt the re-transmission data) bps
RlcDlTpt RLC layer DL average through put bps
Total amount of PDCP layer data transmitted
during the interval
Note: here just means the data arrived in UE RLC
PdcpUlPduBytes layer, not means transmitted to network. byte
PDCP PdcpDlPduBytes Total amount of PDCP layer data received during
the interval byte
Total amount of PDCP discarded data transmitted
PdcpULDiscardBytes during the interval byte
PdcpUlTpt PDCP layer UL average through put bps
PdcpDlTpt PDCP layer DL average through put bps
Example
//start statistic information report
AT+ECSTATIS=10
OK
//UE report following URC in period of 10 seconds
+ECSTATIS: PHY COMM, AvgRSRP: -75, AvgSnr: 9, TransmissionMode: TM2
+ECSTATIS: PHY DL, DlBler: 0%, NewGrantBler: 0%, PhyDlTpt: 57 bps, dlGrantNum: 0,
dlAvgHarqNum: 1, AvgPRB: 8, AvgMCS: 1, AvgTBS: 41, dlAvgCqi: 13
+ECSTATIS: PHY UL, UlBler: 0%, NewGrantBler: 0%, PhyUlTpt: 48200 bps, ulGrantNum: 0,
ulAvgHarqNum: 1, AvgPRB: 10, AvgMCS: 12, AvgTBS: 125, txPower: -12(dBm)
+ECSTATIS: MAC, MacUlBytes:29250, MacUlPadBytes:0, MacDlBytes: 36, MacDlPadBytes: 20,
MacUlTpt: 46800 bps, MacDlTpt: 57 bps
+ECSTATIS: RLC, RlcUlPduBytes:29006, RlcUlRetxBytes:0, RlcDlPduBytes: 8, RlcUlTpt: 46409
bps, RlcDlTpt: 12 bps
+ECSTATIS: PDCP, PdcpUlPduBytes: 31424, PdcpDlPduBytes: 0, PdcpULDiscardBytes: 0,
PdcpUlTpt: 50278 bps, PdcpDlTpt: 0 bps
//stop
AT+ECSTATIS=0
OK
//test
AT+ECSTATIS=?
+ECSTATIS: (0,1-600)
OK
3.1.48 AT+ECFSINFO
The command lists file size and name, file system information including total and used space in unit of
block.
AT+ ECFSINFO Response
<file system information>
Execution Command OK
AT+ECFSINFO 5s
NO_SAVE
Maximum Response Time
Parameter Saving Mode
Example
AT+ECFSINFO
size file name
76B cemmcomminfo.nvm
306B cemmemminfo.nvm
42B cemmesminfo.nvm
244B cemmplmninfo.nvm
60B cerrcinfo.nvm
2284B cesmpdpauthconfig.nvm
2732B cesmpdpconfig.nvm
52B mwconfig.nvm
104B mwinfo.nvm
12B npiconfig.nvm
22B plat_config
16B time_values
164B uepsconfig.nvm
244B uiccctrlconfig.nvm
FS block: Totoal : 72 used: 7
OK
3.1.49 AT+ECFLASHMONITORINFO
The command is used to monitor flash information.
AT+ECFLASHMONITORINFO Response
+ECFLASHMONITORINFO: (0,1,2,3)
Test Command OK
AT+ECFLASHMONITORINFO=? Response
<monitor infomation> if option is 1,2,3
Set Command OK
AT+ECFLASHMONITORINFO=<option> 5s
NO_SAVE
Maximum Response Time
Parameter Saving Mode
Parameter INTEGER TYPE
0 reset file system monitor counter
<OPTION> 1 show file write counter
2 show file system block erase counter
3 show pmu back up raw flash erase counter
Note, macro FLASH_MONITOR_ENABLE shall be enabled for option 1 and 2
Example
AT+ECFLASHMONITORINFO=1
writeCount,writeBytesCount,file name
0,0B, cemmcomminfo.nvm
0,0B, cemmemminfo.nvm
0,0B, cemmesminfo.nvm
0,0B, cemmplmninfo.nvm
246,59040B, cerrcinfo.nvm
0,0B, cesmpdpauthconfig.nvm
0,0B, cesmpdpconfig.nvm
0,0B, mwconfig_nvm
0,0B, mwinfo.nvm
2,8B, npiconfig.nvm
4,34B, plat_config
0,0B, time_values
0,0B, uepsconfig_nvm
5039,1169048B, uiccctrlconfig.nvm
OK
AT+ECFLASHMONITORINFO=2
37,35,359,364,339,325,330,221,240,259
265,246,238,230,223,230,239,234,365,252
360,252,378,261,271,276,262,267,261,244
243,239,242,243,239,231,237,278,359,253
266,283,326,245,334,234,261,239,0,279
280,398,299,385,274,242,367,235,227,237
357,260,260,276,277,247,240,238,234,0
0,359,0,409,404,400,312,278,256,248
239,226,231,246
OK
AT+ECFLASHMONITORINFO=3
PMU Flash Erase Count:
Copy0: PlatPS: 224/234/223/1 Phy: 325/1
Copy1: PlatPS: 224/234/223/1 Phy: 325/1
Copy2: PlatPS: 224/233/222/1 Phy: 325/1
Copy3: PlatPS: 224/233/222/1 Phy: 324/1
OK
AT+ECFLASHMONITORINFO=0
OK
AT+ECFLASHMONITORINFO=1
writeCount,writeBytesCount,file name
0,0B, cemmcomminfo.nvm
0,0B, cemmemminfo.nvm
0,0B, cemmesminfo.nvm
0,0B, cemmplmninfo.nvm
0,0B, cerrcinfo.nvm
0,0B, cesmpdpauthconfig.nvm
0,0B, cesmpdpconfig _nvm
0,0B, mwconfig.nvm
0,0B, mwinfo.nvm
0,0B, plat_config.nvm
0,0B, time_values
0,0B, uepsconfig _nvm
0,0B,uiccctrlconfig.nvm
OK
3.1.50 AT+ECPURC
The command enable/disable platform URC (unsolicited result code) report.
AT+ ECPURC Response
OK
Set Command If there is any error, response:
AT+ECPURC=<urcStr>,<value> +CME ERROR: <err>
Response
Read Command +ECPURC: "HIBNATE":<value>, "SLEEP2":<value>,
AT+ECPURC? "SLEEP1":<value>
Test Command OK
AT+ECPURC=? If there is any error, response:
+CME ERROR: <err>
Response
+ECPURC: "Mode":(0-1)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Note: AT&W will save <value> to NVM.
Parameter STRING TYPE;
<URCSTR> "HIBNATE" Enable URC Report when enter HIBERNATE
<VALUE> "SLEEP2" Enable URC Report when enter SLEEP2
"SLEEP1" Enable URC Report when enter SLEEP1
Integer type;
0 disable unsolicited result code report
1 enable unsolicited result code report
Example //enable hibernate URC
AT+ECPURC="HIBNATE",1
OK
AT+ECPURC?
+ECPURC: "HIBNATE":1, "SLEEP2":0, "SLEEP1":0
OK
AT+ECPURC=?
+ECPURC: "Mode":(0-1)
OK
3.1.51 +SLPMODE
This is an unsolicited message to indicate entering or exiting sleep. Only report when specific URC report
is enabled. Use ECURC to enable URC report.
+SLPMODE
+SLPMODE: <mode>
Parameter INTEGER TYPE
<MODE>
0 Exiting sleep to active mode
1 Entering sleep1
2 Entering sleep2
3 Entering Hibernate
Example //enable hibernate URC
AT+ECPURC="HIBNATE",1
OK
+SLPMODE: 3 //entering hibernate
+SLPMODE: 0 //enter active mode or sleep failed
3.1.52 AT+ECEVENTSTATIS
The execution command use to set/get UE EMM and RRC specific event statistics.
AT+ECEVENTSTATIS Response
OK
Execution Command If there is any error, response:
AT+ECEVENTSTATIS =<mode> +CME ERROR: <err>
Response
Test Command +ECEVENTSTATIS: list of supported <mode>
AT+ECEVENTSTATIS=?
Read Command OK
AT+ECEVENTSTATIS? Response
+ECEVENTSTATIS: <mode>
+ECEVENTSTATIS: RRC, ConEstSucc:<num>,
ConEstFail:<num>
+ECEVENTSTATIS: EMM, AttachSucc:<num>,
AttachFail:<num>, TAUSucc:<num>, TAUFail:<num>,
SRSucc:<num>, SRFail:<num>, AuthFail:<num>,
DetachNum:<num>
+ECEVENTSTATIS: PLMN, OOS:<num>
Maximum Response Time OK
Parameter Saving Mode 5s
SAVE
Parameter INTEGER TYPE
<MODE>
0 Stop event statistic � default value
1 Start event statistic
2 Clear event statistic (Note: the mode should be executed in "UE
Power Off state (AT+CFUN=0)")
Note 1:
Statistical parameters description:
Layer Parameter Description Range
AttachSucc Total amount of Attach Success Procedure 0-65535
0-65535
AttachFail Total amount of Attach Failure Procedure
Total amount of Tracking Area Update Success 0-65535
TAUSucc Procedure
Total amount of Tracking Area Update Failure 0-65535
EMM TAUFail Procedure
SRSucc Total amount of Service Request Success 0-65535
Procedure
SRFail Total amount of Service Request Failure 0-65535
AuthFail Procedure 0-65535
Total amount of Authentication Reject Procedure
DetachNum Total amount of MT-Detach and MO-Detach 0-65535
PLMN OOS Procedure 0-65535
Total amount of PLMN Out-of-service
RRC ConEstSucc Total amount of RRC Connection Success 0-65535
ConEstFail Procedure 0-65535
Total amount of RRC Connection Failure
Procedure
Example
//start statistic mode
AT+ECEVENTSTATIS=1
OK
//Inquire EMM and RRC event statistics
AT+ECEVENTSTATIS?
+ECEVENTSTATIS: 1
+ECEVENTSTATIS: RRC, ConEstSucc:2, ConEstFail:0
+ECEVENTSTATIS: EMM, AttachSucc:1, AttachFail:0, TAUSucc:0, TAUFail:0, SRSucc:0, SRFail:0,
AuthFail:0, DetachNum:1
+ECEVENTSTATIS: PLMN, OOS:1
//Clear EMM and RRC event statistics
AT+CFUN=0
OK
AT+ECEVENTSTATIS=2
OK
//stop
AT+ECEVENTSTATIS=0
OK
//test
AT+ECEVENTSTATIS=?
+ECEVENTSTATIS: (0,1,2)
OK
3.1.53 AT+ECUSATP
Set command transmits to the MT the <profile> to modify terminal profile of USAT.
The read command return current setting of each parameters.
The test command returns values supported as a compound value.
AT+ECUSATP Response
OK
Set Command If there is any error, response:
AT+ECUSATP=<length>,<profile> +CME ERROR: <err>
Response
Read Command +ECUSATP: <length>,<profile>
AT+ECUSATP? OK
Response
Test Command OK
AT+ECUSATP=? 5s
Maximum Response Time NO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE
length of the characters that are sent to TE in <profile> (two times the
<LENGTH> actual length of the command or response)
String type
<PROFILE> The profile describing the supported USAT facilities as specified for the
terminal profile in 3GPP TS31.111.
(hexadecimal character format)
Example
3.1.54 AT+ECPLMNRESELECT Response
OK
The command start PLMN user reselection. 5s
NO_SAVE
AT+ECPLMNRESELECT
Execution Command
AT+ECPLMNRESELECT
Maximum Response Time
Parameter Saving Mode
Example
AT+ECPLMNRESELECT
OK
3.1.55 AT+NFWUPD
The execution command will erase FOTA download region in internal flash, download the delta file, validate
the delta file, query the name & the version of delta file, upgrade the delta file and inform the receiver the
download of delta file has been completed.
AT+NFWUPD
Execution Command Response
AT+NFWUPD=<cmd>[,<sn>,<nbytes>,<data>,<xor8sum>] OK
If there is any error, response:
ERROR
OR
+CME ERROR: <err>
Test Command Response
AT+NFWUPD=? +NFWUPD: list of supported
<cmd>
Maximum Response Time OK
Parameter Saving Mode If there is any error, response:
ERROR
OR
+CME ERROR: <err>
10s
NO SAVE
Parameter Integer type.
0 Erase the FOTA download region in internal FLASH.
<cmd> 1 Download the segments of delta file, which should be download in
<sn> orders. And the parameters(<sn>, <nbytes>, <data>, <xor8sum>) is valid
<nbytes> only on this condition.
<data> 2 Validate the delta file.
<xor8sum> 3 Query the name of delta file.
4 Query the version of delta file.
5 Upgrade the delta file.
6 Inform the receiver the download of delta file has been completed.
Integer type. Segment No. of the delta file, which is started with 0 and
increased by 1 in orders afterwards. Range: 0-65535.
Integer type. Total bytes of delta file segment, which should be is multiple of 4
bytes. Range: 4-256
String type. The segment data in hex string format, the length of which is
2*<nbytes>.
String type. The result of XOR8 checksum in hex string format.
Example
AT+NFWUPD=1,0,200,75fabe4dd6d334916877e68a04c9fa89871afd5a965dca42a561afdb549
8ff186c8996d4ba31ee7d2e3e7aee35980ce80f269616e2dfe03ff75f53bf34776f73756e3037
ff2000d49b1d001b0000000046425a683131415926535920e20d98000017f6dffe90020a000c4
00004000100040000410080008114808000c80fa0005454d304c04308c11e81aa3c90c869a036
a6d468d076dd0655f348075e4cae4241b9848c67db91280dea539c3c5b143680fd1fe3faa7408
00322e0ba17724538509020e20d980000,1b
OK
AT+NFWUPD=?
+NFWUPD: (0-6)
OK
3.1.56 AT+ECSIMRM
Execution command causes the TA to execute SIM removal procedure.
AT+ECSIMRM Response
OK
Execution Command If there is any error, response:
AT+ECSIMRM +CME ERROR: <err>
Response
Test Command OK
AT+ECSIMRM=? 5s
Maximum Response Time NO_SAVE
Parameter Saving Mode
Note: SIM removal is required by GCF test. Recover the SIM by AT+CFUN=0/1 or reset terminal.
Example
AT+ECSIMRM
OK
3.1.57 AT+ECNETCFG
The command set the network adapter parameter configuration. Set <nat> to enable or disable NAT
(Network Address Translation). When NAT is enable, configure local host IP address by <host_addr> if
set or default address "192.168.10.2". When NAT is disable, configure global IP address allocated by
LTE network. Set <pppauthselect> to select the PPP authentication parameters. When <pppauthselect>
is set to 0, the authentication parameters are pre-defined by AT+CGAUTH. When <pppauthselect> is set
to 1, the authentication parameters are defined in PPP LCP procedure.
AT+ECNETCFG Response
OK
Set Command If there is any error, response:
AT+ECNETCFG="nat",<nat>[,<host_addr>] +CME ERROR: <err>
AT+ECNETCFG="pppauthselect",<pppauths Response
elect> +ECNETCFG: "nat",<nat>,<host_addr>
Read Command +ECNETCFG: "pppauthselect",<pppauths
AT+ECNETCFG? elect>
Test Command OK
AT+ECNETCFG=? Response
+ECNETCFG: (list of supported
("nat",<nat>,<host_addr>)s)
+ECNETCFG: (list of supported
("pppauthselect",<pppauthselect >)s)
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE
Parameter INTEGER TYPE
<NAT> 0 Disable network address translation
<HOST_ADDR>
1 Enable network address translation
<PPPAUTHSELECT>
String type
Local host IP address supported IPv4 type only
Note:
a) Supported values: "192.168.a.b", a:0-255, b:2-254
b) Default value: "192.168.10.2"
Integer type
0 The PPP authentication parameters are pre-defined by
AT+CGAUTH. The default value is 0.
1 The PPP authentication parameters are defined in PPP LCP
procedure.
Example
AT+ECNETCFG?
+ECNETCFG: "nat",0,"192.168.10.2"
+ECNETCFG: "pppauthselect",0
OK
AT+ECNETCFG="nat",1,"192.168.10.8"
OK
AT+ECNETCFG="pppauthselect",1
OK
3.1.58 AT+ECNETDEVCTL
The command set data path control for the network adapter. Control data path open by setting <op> to
bind LWIP to PDN context with <cid>. Control data path close by setting <op> to unbind LWIP to PDN
context with <cid>.
AT+ECNETDEVCTL
Set Command Response
AT+ECNETDEVCTL=<op>,<cid>,[,<urc_en>] OK
If there is any error, response:
+CME ERROR: <err>
Read Command Response
AT+ECNETDEVCTL? +ECNETDEVCTL:
<op>,<cid>,<urc_en>,<state>
OK
Test Command Response
AT+ECNETDEVCTL=? +ECNETDEVCTL: (list of supported
(<OP>,<cid>,<urc_en>)s)
OK
Maximum Response Time 5s
Parameter Saving Mode AUTO_SAVE (<op>=3 only)
Parameter INTEGER TYPE; SPECIFIES DEVICE CONTROL OPTION.
<OP>
0 Unbind cid for LWIP
1 Bind cid for LWIP once and no rebind if re-activate PDN
context with same cid after deactivation.
2 Bind cid for LWIP and rebind if re-activate PDN context with
the same cid after deactivation.
3 Auto dial and bind cid when power on, saved in NVM after
power down.
<CID> Integer type; specifies a particular non secondary PDP context
definition.
<cid> values of 1-15 are supported.
<URC_EN> Integer type; specifies whether report URC +ECNETDEVCTL:<state>
0 Disable URC +ECNETDEVCTL:<state>
1 Enable URC +ECNETDEVCTL:<state>
<STATE> Integer type; specifies cid bound state.
0 Bind cid for LWIP failure
1 Bind cid for LWIP success
Note:
If the <cid> for PDN context defined but deactivated, bind this <cid> will auto activate PDN context. If
the <cid> for PDN context undefined, bind this <cid> will cause activation failed.
Example
AT+ECNETDEVCTL?
+ECNETDEVCTL: 0,0,0,0
OK
AT+ECDNSCFG=1,1,1
OK
3.1.59 AT+ECGDCNT
The command can query how many bytes are sent or received by PS module.
AT+ECGDCNT Response
OK
Set Command If there is any error, response:
AT+ECGDCNT=<option> +CME ERROR: <err>
Response
Read Command +ECGDCNT: <bytes_sent>,<bytes_recv>
AT+ECGDCNT?
Test Command OK
AT+ECGDCNT=? If there is any error, response:
+CME ERROR: <err>
Response
+ECGDCNT: (0,1)
OK
Maximum Response Time 5s
Parameter Saving Mode AUTO_SAVE
Parameter INTEGER TYPE
<OPTION> 0 Reset the data counter
<BYTES_SENT> 1 Save the data counter to NVM.
<BYTES_RECV> Integer type
The number of bytes sent
Note:
a) Supported values: (0-0xFFFFFFFFFFFFFFFFF)
Integer type
The number of bytes received
Note:
a) Supported values: (0-0xFFFFFFFFFFFFFFFFF)
Note:
Please use this command with caution! It may cause the UE to only enter sleep2 and can't enter
hibernate. In addition, frequent saving to NVM will affect the service lift. It's best to keep disabled by
AT+ECCFG="EnableDataCounter",0 when not in use.
Example
AT+ECGDCNT=?
+ECGDCNT: (0,1)
OK
AT+ECGDCNT?
+ECGDCNT: 128,64
OK
AT+ECGDCNT=1
OK
3.1.60 AT+ECAUGDCNT
The command can auto save the result of AT+ECGDCNT? to NVM.
AT+ECAUGDCNT Response
OK
Set Command
AT+ECAUGDCNT=<interval>
Read Command If there is any error, response:
AT+ECAUGDCNT? +CME ERROR: <err>
Response
+ECAUGDCNT: <interval>
Test Command OK
AT+ECAUGDCNT=? If there is any error, response:
+CME ERROR: <err>
Response
+ECAUGDCNT: (0,30-65535)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Parameter
INTEGER TYPE
<INTERVAL> The interval for auto save the result of AT+ECGDCNT?. Unit is
second.
Note:
a) Supported values: (030-65535)
b) If the interval is set to 0, will disable auto save function.
Note:
The interval for auto save is not always strictly consistent with the user setting. For example, if UE enter
sleep2 or hibernate before auto save, the auto save time will be postponed until wake up from sleep2 or
hibernate. Also the same as AT+ECGDCNT, please use this command with caution!
Example
AT+ECAUGDCNT=?
+ECAUGDCNT: (0,30-65535)
OK
AT+ECAUGDCNT?
+ECGDCNT: 30
OK
AT+ECGDCNT=60
OK
3.1.61 AT+ECNASTCFG
The execution command set the nas related timers to UE, it includes fellow timers:
HighPriority Plmn search timer
Esm 3482 timer -the timer related the PDN CONNECTIVITY REQUEST
Esm 3492 timer -the timer related the PDN DISCONNECT REQUEST
AT+ ECNASTCFG Response
OK
Execution Command If there is any error, response:
AT+ ECNASTCFG +CME ERROR: <err>
=<timer_id>[,<timer_val>,[,<try_count Response
>]] \r\n+ECNASTCFG:
Read Command 0,[,<timer_val>,<try_count>]
AT+ ECNASTCFG? \r\n+ECNASTCFG:
1,[,<timer_val>,<try_count>]
\r\n+ECNASTCFG:
2,[,<timer_val>,<try_count>]
Test Command OK
AT+ ECNASTCFG =? Note: if the timer is not
configured, timer_val and try_count
Maximum Response Time will not return
Parameter Saving Mode Response
+ECNASTCFG: (list of supported (
<timer_id >s,
<timer_val>s,
<try_count>s)
OK
5s
AUTO_SAVE (<op>=3 only)
Parameter INTEGER TYPE; SPECIFIES TIMER ID DEFINED.
<TIMER_ID> 0 The High priority plmn seach timer
<TIMER_VAL> 1 The esm pdn connectivity request timer(3482 itmer)
< TRY_COUNT>
2 The esm pdn disconnect request timer(3492 itmer)
Integer type; specifies the repeat interval of timer
unit: second
Integer type; specifies the max repeat times of timer
Example
AT+ ECNASTCFG?
+ECNASTCFG: 0
+ECNASTCFG: 1
+ECNASTCFG: 2
OK
AT+ ECNASTCFG?
+ECNASTCFG: 0,100,0
+ECNASTCFG: 1,32,5
+ECNASTCFG: 2,32,5
OK
AT+ ECNASTCFG =0,100,1
OK
AT+ ECNASTCFG=?
+ECNASTCFG: 0,(1-1048575),(0-255)
+ECNASTCFG: 1,(1-32),(1-5)
+ECNASTCFG: 2,(1-32),(1-5)
OK
3.1.62 AT+ECCMGS
The execution command sends concatenated short message from a TE to the network (SMS-SUBMIT).
This is an extended command of AT+CMGS. The 3 additional parameters <msg_ref>, <msg_max>,
<msg_seq> are used for sending concatenated short message. Message reference value <mr> is
returned to the TE on successful message delivery. Value can be used to identify message upon
unsolicited delivery status report result code. If sending fails in a network or an ME error, final result code
+CMS ERROR: <err> is returned. This command should be abortable. This command is only supported
in text mode.
AT+ECCMGS If sending successful:
+ECCMGS: <mr>
Set Command If there is any error, response:
AT+ECCMGS=<da>[,<toda>] +CMS ERROR: <err>
[,<msg_ref>,<msg_max>,<msg_seq>]<C
R> Response
Text is entered<ctrl-Z/ESC> OK
Test Command 60s
AT+ECCMGS=? NO_SAVE
Maximum Response Time
Parameter Saving Mode
Parameter STRING TYPE; DESTINATION ADDRESS
<DA> Integer type; Type of destination address
<TODA> Integer type; Concatenated short message reference number. This
<MSG_REF> reference number shall remain constant for every short message
which makes up a particular concatenated message. Value range is
<MSG_MAX> 0~255
Integer type; Total number of short messages in the concatenated
<MSG_SEQ> short messages. The value shall start at 1 and remain constant for
every short messages which makes up the concatenated short
<MR> message. If the value is 0 then it is sent as non-concatenated short
message. Value range is 0~255
Integer type; Sequence number of the current short message within
the concatenated short message. The value shall start at 1 and
increment by one for every short message sent within the
concatenated short message. If the value is 0 or the value is greater
than <msg_max> then it is sent as non-concatenated short message.
Value range is 0~255
TP-Message-Reference in integer format.
Example
AT+CMGF=1
OK
AT+ECCMGS="1064899990000",,34,4,1
>Test Concatenated SMS 1CTRL+Z(1a(hex))
+ECCMGS: 1
OK
AT+ECCMGS="1064899990000",,34,4,2
>Test Concatenated SMS 2CTRL+Z(1a(hex))
+ECCMGS: 2
OK
3.1.63 AT+ECCMGR
The execution command returns concatenated short message with location value <index> from message
storage <mem1> to the TE. This is an extended command of AT+CMGR. The 3 additional parameters
<msg_ref>, <msg_max>, <msg_seq> are returned for concatenated short message. If status of the
message is 'received unread', status in the storage changes to 'received read'. If reading fails, final result
code +CMS ERROR: <err> is returned. This command is only supported in text mode.
AT+ECCMGR Response
for SMS-DELIVER:
Set Command
AT+ECCMGR=<index>
+ECCMGR:
<stat>,<oa>,[<alpha>],<scts>[,<tooa>,<f
o>,<pid>,<dcs>,<sca>,<tosca>,<length>][
,<msg_ref>,<msg_max>,<msg_seq>]<CR><LF>
<data>
OK
for SMS-SUBMIT:
+ECCMGR:
<stat>,<da>,[<alpha>][,<toda>,<fo>,<pid
>,<dcs>,[<vp>],<sca>,<tosca>,<length>][
,<msg_ref>,<msg_max>,<msg_seq>]<CR><LF>
<data>
Test Command OK
AT+ECCMGR=? Response
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Parameter INTEGER TYPE;
THE VALUE IS THE RANGE OF LOCATION NUMBER SUPPORTED BY THE
<INDEX> ASSOCIATED MEMORY
<STAT> String type (default "REC UNREAD"); Indicates the status of message in memory;
defined values:
<ALPHA>
"REC UNREAD" received unread message (i.e. new message)
<DA> "REC READ" received read message
<OA> "STO UNSENT" stored unsent message (only applicable to SMS)
<DT> "STO SENT" stored sent message (only applicable to SMs)
String type;
The alphanumeric representation of <da> or <oa> corresponding to the entry found in
MT phonebook; implementation of this feature is manufacturer specific; used
character set should be the one selected with command Select TE Character Set
+CSCS (see definition of this command in 3GPP TS 27.007 [9]).
Destination address, 3GPP TS 23.040 [3] TP-Destination-Address Address-Value field
in string format; BCD numbers (or GSM 7 bit default alphabet characters) are
converted to characters of the currently selected TE character set; type of address
given by <toda>.
Originating address, 3GPP TS 23.040 [3] TP-Originating-Address Address-Value field
in string format; BCD numbers (or GSM 7 bit default alphabet characters) are
converted to characters of the currently selected TE character set; type of address
given by <tooa>.
3GPP TS 23.040 [3] TP-Discharge-Time in time-string format:
<SCTS> "yy/MM/dd,hh:mm:ss�zz", where characters indicate year (two last digits), month, day,
<FO> hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours
equals to "94/05/06,22:10:00+08"
<PID> String type;
3GPP TS 23.040 [3] TP-Service-Centre-Time-Stamp in time-string format (refer <dt>).
<DCS> Integer type; Frist Octet, depending on the command or result code: first octet of
3GPP TS 23.040 [3] SMS-DELIVER, SMSSUBMIT (default 33), SMS-STATUS-
<VP> REPORT, or SMS-COMMAND in integer format
<MN> Integer type;
<MR> Protocol identifier. 3GPP TS 23.040 [3] TP-Protocol-Identifier in integer format (default
<RA> 0)
Integer type;
<TODA> Data Coding Scheme, depending on the command or result code: 3GPP TS 23.038
<TORA> [2] SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in
<TOOA> integer format
<SCA> Depending on SMS-SUBMIT <fo> setting: 3GPP TS 23.040 [3] TP-Validity-Period
either in integer format (default 167) or in time-string format (refer <dt>)
<TOSCA> 3GPP TS 23.040 [3] TP-Message-Number in integer format
<LENGTH> 3GPP TS 23.040 [3] TP-Message-Reference in integer format
3GPP TS 23.040 [3] TP-Recipient-Address Address-Value field in string format; BCD
<MSG_REF> numbers (or GSM 7 bit default alphabet characters) are converted to characters of the
<MSG_MAX> currently selected TE character set(refer command +CSCS in 3GPP TS 27.007 [9]);
<MSG_SEQ> type of address given by <tora>
<DATA> 3GPP TS 24.011 [6] TP-Destination-Address Type-of-Address octet in integer format
(when first character of <da> is + (IRA 43) default is 145, otherwise default is 129)
3GPP TS 24.011 [6] TP-Recipient-Address Type-of-Address octet in integer format
(default refer <toda>)
3GPP TS 24.011 [6] TP-Recipient-Address Type-of-Address octet in integer format
(default refer <toda>)
3GPP TS 24.011 [6] RP SC address Address-Value field in string format; BCD
numbers (or GSM 7 bit default alphabet characters) are converted to characters of the
currently Selected TE character set (refer command +CSCS in 3GPP TS 27.007 [9]);
type of address given by <tosca>
3GPP TS 24.011 [6] RP SC address Type-of-Address octet in integer format (default
refer <toda>)
Integer type; The value indicating in the text mode (+CMGF=1) the length of the
message body <data> > (or <cdata>) in characters; or in PDU mode (+CMGF=0), the
length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are
not counted in the length)
Integer type; Concatenated short message reference number
Integer type; Total number of short messages in the concatenated short message
Integer type; Sequence number of the current short message within the concatenated
short message
In the case of SMS: 3GPP TS 23.040 [3] TP-User-Data in text mode responses;
Example //new concatenated message received in index 2
//new concatenated message received in index 3
+CMTI: "ME",2
+CMTI: "ME",3
AT+ECCMGR=2 //read the 1st sequence message
+ECCMGR: "REC UNREAD","+358507654321","","95/07/03,17:38:15+04",34,2,1
Test Concatenated SMS 1
OK
AT+ECCMGR=3 //read the 2nd sequence message
+ECCMGR: "REC UNREAD","+358507654321","","95/07/03,17:38:15+04",34,2,2
Test Concatenated SMS 2
OK
3.1.64 AT+ECLEDMODE
Set command is used to enable the Netlight function
Read command returns the whether the Netlight function is enable or not.
AT+ECLEDMODE Response
OK
Set Command If there is any error, response:
AT+ECLEDMODE=<state> +CME ERROR: <err>
Response
Read Command +ECLEDMODE: <state>
AT+ECLEDMODE?
Test Command OK
AT+ECLEDMODE=? Response
+ECLEDMODE: (0,1)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Note: AT&W will save <state> to NVM.
Parameter INTEGER TYPE
0 Netlight function disable
<STATE> 1 Netlight function enable
NOTE:
Netlight is set to PAD 46 using PWM Instance 3. It can be changed by rewrite NetLightInit function (in
bsp_custom.c). Call NetLightInit in BSP_CustomInit to enable this function.
(1) Netlight function may cause extra power consumption in active state
(2) Using AONIO as PWM pad may cause extra leakage in sleep state, power off
AONIO(slpManAONIOPowerOff) before sleep when there is no need to keep AON latched.
(3) All sleep is disabled, until modem enter Idle/PSM
(4) A pull-down resistor is needed to keep Pad low to avoid unwanted flicker
Netlight Indication Note Modem Status
HighLevel 64ms(LED ON)/ LowLevel 800ms(LED OFF) Network searching
HighLevel 64ms(LED ON)/ LowLevel 2000ms(LED OFF) Network connected in Connect state
Keep Low Level Modem Idle/PSM or other
3.1.65 AT+ECWIFISCAN
The execution command is used for detect Wi-Fi SSID information.
Set command sets the Wi-Fi detect parameters to be used.
Read command returns the current Wi-Fi scan parameters.
Test command returns Wi-Fi scan range of parameters supported by the UE.
AT+ECWIFISCAN Response
+ECWIFISCAN:<ecn>,<ssid>,<rssi>,<mac>,<
Set Command channel>
AT+ECWIFISCAN=[<time>],[<round>],[
<maxbssidnum>],[<scantimeout>],[<p OK
riority>] Note: wifiscan cnf also provide ssid
Name and the length of ssid Name.
Read Command Response
AT+ECWIFISCAN? +ECWIFISCAN:<time>,<round>,<maxbssidnum
>,<scantimeout>,<priority>
Test Command OK
AT+ECWIFISCAN=? Response
+ECWIFISCAN:(4000-255000),(1-3),(4-
10),(1-255),(0-1)
Maximum Response Time OK
Parameter Saving Mode 255s
NO_SAVE
Parameter
<TIME> INTEGER TYPE; UNIT: MILLISECONDS
THE VALUE IS MAX RESPONSE TIME OF WI-FI SCAN;
DEFAULT VALUE IS 12000
<MAXBSSIDNUM> Integer type;
The value is the max required Wi-Fi SSID number.
Default value is 5
<ROUND> Integer type;
The value is max number of Wi-Fi scan rounds.
Default value is 1
<SCANTIMEOUT> Integer type; unit : second
The value is max search time per Wi-Fi scan round.
Default value is 5
<PRIORITY> Integer type;
The value is the priority of Wi-Fi scan. [ 0 means data preferred; 1 means Wi-Fi
preferred]
Default value is 0
Note:
1> ECWIFISCAN AT could be executed in CFUN0 / CFUN4 / NO-USIM / Normal state.
2> Wi-Fi scan only could be executed while PHY in Idle state.
If the priority is set to 0 and UE in connection state, UE will not start the Wi-Fi scan
procedure until UE return back to Idle state.
If the priority is set to 1 and UE in connection state, UE will release connection
immediately and start Wi-Fi scan procedure.
3> <time> value should not be less than <round> multiplied by <scantimeout>.
4> <maxbssidnum> means the max required Wi-Fi SSID number.
Case 1 - If UE has detected the required Wi-Fi SSID, UE will stop Wi-Fi procedure and
report the detected Wi-Fi result.
Case 2 - If UE has not detected the required Wi-Fi SSID before execute time out, UE will
abort Wi-Fi procedure and report the detected Wi-Fi result.
Case 3 - The round is set to 3 and maxbssidnum is set to 10, if in the first round UE
could detect five Wi-Fi SSID, in the second round UE could detect three Wi-Fi SSID, in
the third round UE could detect six Wi-Fi SSID. UE will delete the duplicate Wi-Fi SSID
and sort the Wi-Fi SSID by descending order, then report the ten Wi-Fi SSID result.
Example
AT+ECWIFISCAN=12000,1,5,3,0
+ECWIFISCAN:(-,-,-28,"00:BE:D5:20:EA:54",11)
+ECWIFISCAN:(-,-,-38,"00:BE:D5:20:EA:27",3)
+ECWIFISCAN:(-,-,-39,"00:BE:D5:20:EA:27",6)
+ECWIFISCAN:(-,-,-44,"00:BE:D5:20:EA:27",9)
+ECWIFISCAN:(-,-,-44,"00:BE:D5:20:EC:23",1)
OK
AT+ECWIFISCAN?
+ECWIFISCAN:12000,1,5,5,0
OK
AT+ECWIFISCAN=?
+ECWIFISCAN:(4000-255000),(1-3),(4-10),(1-255),(0-1)
OK
3.1.66 AT+ECPOWD
This command is used to power down the chip. Once the power is down, all wakeup is disabled. Only a
negative edge on power key pad can power on the chip.
AT+ECPOWD Response
+ECPOWD: (0,1)
Test Command OK
AT+ECPOWD=? Response
OK
Set Command
AT+ECPOWD=<option>
Maximum Response Time POWERED DOWN
Parameter Saving Mode 5s
NO_SAVE
Parameter INTEGER TYPE
<OPTION> 0 Immediately power down
Example 1 The command set cfun=0 and then power down.
AT+ECPOWD=1
OK
POWERED DOWN
3.1.67 AT+ECURCCFG
This command control the behavior of URC report.
AT+ ECURCCFG
Set Command Response
AT+ECURCCFG="ri/smsincoming",<type> OK
[,<pulseduration>,<pulsecount>] If there is any error, response:
+CME ERROR: <err>
AT+ECURCCFG="ri/other",<type>[,<pul
seduration>,<pulsecount>]
AT+ECURCCFG="delay",<delay_time>
AT+ECURCCFG="cache",<cache_enable>
AT+ECURCCFG="atpendurc",<atpendurc_ Response
enable> +ECURCCFG: "ri/smsincoming",1,120,5
Read Command +ECURCCFG: "other",1,120,5
AT+ECURCCFG? +ECURCCFG: "delay",0
+ECURCCFG: "cache",0
+ECURCCFG: "atpendurc",0
Test Command OK
AT+ECURCCFG=? If there is any error, response:
+CME ERROR: <err>
Response
+ECURCCFG: "ri/smsincoming",(0-1),(1-
2000),(1-5)
+ECURCCFG: "other",(0-1),(1-2000),(1-
5)
+ECURCCFG: "delay",(0-10000)
+ECURCCFG: "cache",(0-1)
+ECURCCFG: "atpendurc",(0-1)
Maximum Response Time OK
Parameter Saving Mode 5s
AUTO_SAVE
Parameter INTEGER TYPE
0 off. The default value is 0.
<TYPE> 1 pulse. Pulse width determined by <pulseduraion>.
Integer type
<PULSEDURATION> Set the pulse width(i.e. low voltage width). The range is 1-2000 and the
default value is 120ms.
This parameter is only vaild when <type> is 1.
<PULSECOUNT> Integer type
<DELAY_TIME> Set the pulse count. The range is 1-5 and the default value is 5.
<CACHE_ENABLE> This parameter is only vaild when <type> is 1.
The interval time between two pulses is equal to <pulseduraion>.
<ATPENDURC_ENABLE> Integer type
Set the pulse width. The range is 1-2000 and the default value is 120ms.
Integer type
0 disable. The default value is 0.
1 enable.
Whether URC need to be cached. If enable, all URC except RI should
be cached in URC FIFO (length: 16) list. If the FIFO length is exceed,
the oldest URC is discarded.
Integer type
0 disable.
1 enable. The default value is 0.
Whether URC need to be pended after current AT command(s) all
processed, but RI don't need to be pended.
AT+ECURCCFG="ri/smsincoming",1,120,1
OK
AT+ECURCCFG="ri/other",1,120,1
OK
AT+ECURCCFG="delay",0
OK
AT+ECURCCFG="cache",0
OK
AT+ECURCCFG="atpendurc",0
OK
AT+ECURCCFG?
+ECURCCFG: "ri/smsincoming",1,120,5
+ECURCCFG: "other",1,120,5
+ECURCCFG: "delay",0
+ECURCCFG: "cache",0
+ECURCCFG: "atpendurc",0
OK
AT+ECURCCFG=?
+ECURCCFG: "ri/smsincoming",(0-1),(1-2000),(1-5)
+ECURCCFG: "other",(0-1),(1-2000),(1-5)
+ECURCCFG: "delay",(0-10000)
+ECURCCFG: "cache",(0-1)
+ECURCCFG: "atpendurc",(0-1)
OK
3.1.68 AT+RLCHK
This command is used to check nvram.
AT+RLCHK Response
+RLCHK:<ret_value>
Set Command
AT+RLCHK=<option>
OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter STRING TYPE
all Check ap and cp nvram
<OPTION> Ap Only check ap nvram
Cp Only check cp nvram
<RET_VALUE> Hex type
When Bit0 is set 1, it means that nvram1 has passed the verification, and so
on
Example
AT+RLCHK="all"
+RLCHK:0x3FB
OK
3.1.69 AT+ECSCLKEX
This command set the enhanced sleep mode configurations. Set <mode> to enable or disable enhanced
sleep mode. When <mode> is enable, set the <idle_time> to release RRC connection after no data is sent
or received on DRB.
AT+ ECSCLKEX Response
OK
Set Command If there is any error, response:
AT+ECSCLKEX=<mode>[,<idle_time>,<re +CME ERROR: <err>
try_time>] Response
+ECSCLKEX: 1,2,10
Read Command
AT+ECSCLKEX?
Test Command OK
AT+ECSCLKEX=? If there is any error, response:
+CME ERROR: <err>
Response
+ECSCLKEX: (0-1),(1-50),(1-600)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Parameter INTEGER TYPE
0 disable. The default value is 0.
<MODE> 1 enable.
<IDLE_TIME> Integer type
Set the time to go to RRC idle state after no data is sent or received on
<RETRY_TIME> DRB. unit: second
The default value is 2s.
Integer type
This parameter is currently meaningless and can be ignored. unit: second
AT+ECSCLKEX=1,2,10
OK
AT+ECSCLKEX?
+ECSCLKEX: 1,2,10
OK
AT+ECSCLKEX=?
+ECSCLKEX: (0-1),(1-50),(1-600)
OK
3.2 Socket Commands (solution A)
3.2.1 AT+SKTCREATE
The command creates a socket on the UE and associates with specified protocol. UE supports up to 12
sockets(TCP or UDP) at the same time. And will return error if it is exceeded.
The test command returns values supported as a compound value.
AT+SKTCREATE
Set Command Response
AT+SKTCREATE=<domain>,<type>,<protocol> +SKTCREATE: <fd>
OK
If there is any error, response:
+SOCKET ERROR: <err>
Test Command Response
AT+SKTCREATE=? +SKTCREATE: (list of supported <domain>s),
(list of supported <type>s), (list of supported
<protocol>s)
OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
<FD> 0-11 Socket file description
<DOMAIN>
Integer type
<TYPE>
1 IPV4
<PROTOCOL>
2 IPV6
Integer type
1 TCP
2 UDP
Integer type; standard internet protocol definition
6 IPPROTO_TCP
17 IPPROTO_UDP
Example
AT+SKTCREATE=1,2,17
+SKTCREATE: 1
OK
3.2.2 AT+SKTCONNECT
For TCP, the command connect socket with remote address and port.
For UDP, the command save remote address and port for send
AT+SKTCONNECT Response
Set Command OK
AT+SKTCONNECT=<fd>,<addr>,<port> If there is any error, response:
+SOCKET ERROR: <err>
Test Command Response
AT+SKTCONNECT=? +SKTCONNECT: (list of supported <fd>s),
(<addr>), (list of supported <port>s)
Maximum Response Time OK
Parameter Saving Mode 35s
NO_SAVE
Parameter INTEGER TYPE
<FD> 0-11 Socket file description returned by +SKTCREATE
<ADDR> string type
<PORT> Remote address to connect or send to
Integer type
Remote port to connect or send to
Example
3.2.3 AT+SKTBIND
The command bind socket with local address and port. If the address is default, it means any address.
AT+SKTBIND Response
OK
Set Command If there is any error, response:
AT+SKTBIND=<fd>,<addr>,<port> +SOCKET ERROR: <err>
Response
Test Command +SKTBIND: (list of supported <fd>s), ( <addr>),
AT+SKTBIND=?
Maximum Response Time (list of supported <port>s)
Parameter Saving Mode OK
5s
NO_SAVE
Parameter INTEGER TYPE
<FD> 0-11 Socket file description returned by +SKTCREATE
<ADDR> string type
<PORT> address to bind. If address is defaults means any address.
Integer type
port to bind
Example
3.2.4 AT+SKTSEND
Send a containing length bytes of data to remote port on remote addr.
AT+SKTSEND Response
OK
Set Command If there is any error, response:
AT+SKTSEND=<fd>,<data +SOCKET ERROR: <err>
len>,<data>[,<rai info>[,<except Response
info>]] +SKTSEND: (list of supported <fd>s), (list of
Test Command supported <data len>s), (<data>), (list of
AT+SKTSEND=? supported <rai info>s), (list of supported
<expect info>s)
Maximum Response Time OK
Parameter Saving Mode 5s
NO_SAVE
Parameter INTEGER TYPE
<FD> 0-11 Socket file description returned by +SKTCREATE
<DATA LEN>
Integer type
<DATA>
<RAI INFO> length of data in hex string format, the max length is 1400
Integer type
Data in hex string
Integer type (option)
0-2 release assistance indication
0 no rai info
1 no further uplink or downlink data transmission subsequent to the uplink
data transmission subsequent to the uplink data transmission is expected
2 only a single downlink data transmission and no further uplink data
transmission subsequent to the uplink data transmission is expected
Note: default value: 0
<EXCEPT Integer type (option)
INFO>
0-1 expect data indication
0 disable expect data indication
1 enable expect data indication
Note: default value: 0
Example
Send data:23456
AT+SKTSEND=0,5,3233343536
OK
3.2.5 AT+SKTSENDT
Send a containing length bytes of data to remote port on remote address with transparent mode.
If the command contain the parameter of "data len", It need input enough data with hex string format
after ">" output. If the command did not contain the parameter of "data len", the input of data must end
with "CTRL+Z".
AT+SKTSEND
Set Command Response
AT+SKTSENDT=<fd>[,<data len>[,<rai OK
info>[,<except info>]]] If there is any error, response:
+SOCKET ERROR: <err>
Test Command Response
AT+SKTSENDT=? +SKTSENDT: (list of supported <fd>s), (list of
supported <data len>s), (list of supported
<rai info>s), (list of supported <expect
info>s)
OK
Maximum Response Time 60s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
<FD> 0-11 Socket file description returned by +SKTCREATE
<DATA LEN> Integer type
<DATA> length of data in hex string format, the max length is 1400
Integer type
Data in hex string
<RAI INFO> Integer type (option)
<EXCEPT 0-2 release assistance indication
INFO>
0 no rai info
1 no further uplink or downlink data transmission subsequent to the uplink
data transmission subsequent to the uplink data transmission is expected
2 only a single downlink data transmission and no further uplink data
transmission subsequent to the uplink data transmission is expected
Note: default value: 0
Integer type (option)
0-2 expect data indication
2 disable expect data indication
3 enable expect data indication
Note: default value: 0
Example
Send data:23456
AT+SKTSENDT=0,5
>3233343536
OK
AT+SKTSENDT=0
>3233343536
1A
OK
3.2.6 +SKTRECV
This is an unsolicited message to show data has been received on a socket.
+SKTRECV
+SKTRECV: <fd>,<len>,<data>
Parameter INTEGER TYPE
<FD> 0-11 Socket file description that data from
<LEN> String type
<DATA> Received data length(bytes)
String type
Received data in hex string format
Example
3.2.7 +SKTERR
This is an unsolicited message to show the error number when error occur.
+SKTERR
+SKTERR: <fd>,<errno>
Parameter
<FD> INTEGER TYPE
0-11 Socket file description that data from
<ERRNO> Integer type Posix Errno defines
12 Out of memory error
105 No buffer space available
62 Timer expired
113 No route to host
115 Operation now in progress
22 Invalid argument
11 Operation would block
107 Transport endpoint is not connected
103 Software caused connection abort
104 Connection reset by peer
Note: if there is some error with the socket which is connected, the socket will be closed automatic
Example
3.2.8 AT+SKTSTATUS Response
+SKTSTATUS: <status>
Get the status of a socket by file description. OK
If there is any error, response:
AT+SKTSTATUS +SOCKET ERROR: <err>
Response
Set Command +SKTSTATUS: (list of supported <fd>s)
AT+SKTSTATUS=<fd> OK
5s
Test Command NO_SAVE
AT+SKTSTATUS=?
Maximum Response Time
Parameter Saving Mode
Parameter INTEGER TYPE
<FD> 0-11 Socket file description returned by +SKTCREATE
<STATUS> Integer type
1 Not connected
2 Connecting
3 Connected
Example
3.2.9 AT+SKTDELETE
Delete a socket by file description.
AT+SKTDELETE Response
OK
Set Command If there is any error, response:
AT+SKTDELETE=<fd> +SOCKET ERROR: <err>
Response
Test Command +SKTDELETE: (list of supported <fd>s)
AT+SKTDELETE=? OK
5s
Maximum Response Time NO_SAVE
Parameter Saving Mode
Parameter INTEGER TYPE
<FD>
0-11 Socket file description returned by +SKTCREATE
Example
3.3 HTTP(S) Commands
3.3.1 AT+HTTPCFG Configure HTTP(S) related parameters
This command is used to configure HTTP(S) related parameters, including custom request headers, and
output HTTP response headers. If the setting command has only the first parameter, it means to query the
current configuration.
AT+HTTPCFG Response
Test Command +HTTPCFG: "contextid",( range of supported <contextID>)
AT+HTTPCFG=? +HTTPCFG: "requestheader",( range of supported
<request_header>)
Set Command +HTTPCFG: "responseheader",( range of supported
AT+HTTPCFG="contextid <response_header>)
"[,<contextID>] +HTTPCFG: "sslctxid",( range of supported <sslctxID>)
+HTTPCFG: "contenttype",( range of supported
Set Command <content_type>)
AT+HTTPCFG="requesthe OK
ader"[,<request_heade Response
r>] If optional parameters are omitted, query the current configuration:
+HTTPCFG: "contextid", <contextID>
Set Command OK
AT+HTTPCFG="responseh If optional parameters are specified:
eader"[,<response_hea OK
der>] If there is any error, response:
+HTTP ERROR: <err>
Set Command Response
AT+HTTPCFG="sslctxid" If optional parameters are omitted, query the current configuration:
[,<sslctxID>] +HTTPCFG: "requestheader", <request_header>
OK
Set Command If optional parameters are specified:
OK
If there is any error, response:
+HTTP ERROR: <err>
Response
If optional parameters are omitted, query the current configuration:
+HTTPCFG: "responseheader", <response_header>
OK
If optional parameters are specified:
OK
If there is any error, response
+HTTP ERROR: <err>
Response
If optional parameters are omitted, query the current configuration:
+HTTPCFG: "sslctxid", <sslctxID>
OK
If optional parameters are specified:
OK
If there is any error, response
+HTTP ERROR: <err>
Response
AT+HTTPCFG="contentty If optional parameters are omitted, query the current configuration:
pe"[,<content_type>] +HTTPCFG: "contenttype", <content_type>
OK
Maximum Response Time If optional parameters are specified:
Parameter Saving Mode OK
If there is any error, response:
+HTTP ERROR: <err>
5s
NO_SAVE
Parameter INTEGER TYPE. PDP CONTEXT ID. RANGE: 1~15. DEFAULT VALUE: 1
<CONTEXTID>
<REQUEST_HEADE Integer type. Disable or enable custom HTTP request headers
R>
<RESPONSE_HEAD 0 disable
ER>
<SSLCTXID > 1 enable
<CONTENT_TYPE>
Integer type. Disable or enable output HTTP response headers.
<ERR>
0 disable
1 enable
Integer type
SSL context ID, Range: 0~5.
Integer type
0 application/x-www-form-urlencoded
1 text/plain
2 application/octet-stream
3 multipart/form-data
Integer type Error code, refer to section 3.3.11.
3.3.2 AT+HTTPURL Set HTTP URL
The URL must start with http:// or https://, which means access to an HTTP or HTTPS server.
AT+HTTPURL Response
Test Command +HTTPURL: (range of supported <URL_length>),
AT+HTTPURL=? range of supported <timeout>)
OK
Set Command Response
AT+HTTPURL=<URL_length>[,<timeout>] If parameter valid:
CONNECT
TA switches to transparent transmission mode and
can enter URL. When the total size of the input data
reaches <URL_length>, TA will switch back to
Read Command command mode and report the following results:
AT+HTTPURL? OK
If the input time reaches <timeout>, but the
Maximum Response Time received URL length is less than <URL_length>, TA
Parameter Saving Mode will switch back to command mode and report the
following results:
+HTTP ERROR: <err>
Response
+HTTPURL: <URL>
OK
depend on <timeout>
NO_SAVE
Parameter INTEGER TYPE
<URL_LENGTH> URL length. Range: 1~2048. Unit: byte.
<TIMEOUT>
Integer type
<ERR> The maximum input time of the URL. Range: 1~65535. Default value: 60. Unit:
seconds.
Integer type. Error code, refer to section 3.3.11.
3.3.3 AT+HTTPGET Send HTTP GET request to HTTP(S) server
According to <request_header> in the AT+HTTPCFG="requestheader"[,<request_header>], the
AT+HTTPGET setting command has two forms:
If <request_header> is 0, after enter AT+HTTPREAD or AT+HTTPREADFILE, if CONNECT is output
within 20 seconds, it means the HTTP(S) server connection is successful, if not, it will output +HTTP
ERROR: <err>.
If <request_header> is 1, it will immediately output CONNECT after sending AT+HTTPGET, and switch
to transparent transmission mode, and receive custom request headers. After input custom request
headers and after sending AT+HTTPREAD or AT+HTTPREADFILE, if CONNECT is output within 20
seconds, it means successfully connect to HTTP server, if not, it will output +HTTP ERROR: <err>.
After connection successful, If the HTTP response headers includes Content-Length, it will output URC
+HTTPGET: <err>,<httprspcode>,<content_length>.
When the GET request is executed and the download is interrupted by network problems, it will display
+HTTPGET: <err>,<httprspcode>,<current_length>, the value of <err> is 11, and <current_length>
indicates the length of data already download. After the network is restored, use the AT+HTTPGETEX
command to download the remaining part.
AT+HTTPGET Response
Test Command +HTTPGET:( range of supported
AT+HTTPGET=?
Set Command <data_length>),range of supported
If <request_header> is 0 <input_time>
AT+HTTPGET OK
Set Command Response
If <request_header> is 1 OK
AT+HTTPGET=<data_length>[,<input_time>]
Response
Maximum Response Time If parameter valid:
Parameter Saving Mode CONNECT
TA switch to transparent transmission mode,
and receive customized request headers:
OK
If input time is out of <input_time> and
receive data less than <data_length>,TA
will turn to command mode and display:
+HTTP ERROR: <err>
depend on <input_time>
NO_SAVE
Parameter
<DATA_LENGTH> INTEGER TYPE
HTTP request headers' length.
Range: 1~2048. Unit: byte
<INPUT_TIME> Integer type
The maximum input time of the HTTP request headers. Range: 1~65535.
Default value: 60. Unit: second
<HTTPRSPCODE> Integer type
HTTP response code. Refer to chapter 6.
<REQUEST_HEADER > Integer type, disable or enable custom HTTP headers.
0 disable
1 enable
<CONTENT_LENGTH> Integer type
HTTP response body length. Unit: byte.
<ERR> Integer type
Error code, refer to section 3.3.11.
3.3.4 AT+HTTPGETEX Send range GET request to HTTP(S) server
Similar to reading files, MCU can get data of specified location and specified length from HTTP(S) server
through AT+HTTPGETEX. This command can only be executed when
AT+HTTPCFG="requestheader",0. HTTP(S) server will respond to the range GET request with 206.
AT+HTTPGETEX Response
Test Command +HTTPGETEX: <start _position>,
AT+HTTPGETEX=? <read_len>
OK
Set Command Response
AT+HTTPGETEX=<start _position>, OK
<read_len> If there is any error:
+HTTP ERROR:<err>
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
<START start position of data want get, start from 0
_POSITION> Integer type
<READ_LEN> length of data want get
<HTTPRSPCODE> Integer type
<CONTENT_LENGTH> HTTP response code. Refer to chapter 3.3.12.
<ERR> Integer type
HTTP response body length. Unit: byte.
Integer type
Error code, refer to section 3.3.11.
3.3.5 AT+HTTPPOST Send POST request to HTTP(S) Server
This command is used to send HTTP POST request. After AT+HTTPPOST is input, TA will output
CONNECT and enter the transparent transmission mode. The user enters the information that the POST
request needs to carry through the UART/USB, and once the input length reaches the <data_length>,
TA exit the transparent transmission mode, return OK, After enter AT+HTTPREAD or
AT+HTTPREADFILE and begin connect. If CONNECT is output within 20 seconds, it means the
HTTP(S) server connection is successful; if not, +HTTP ERROR: <err> will be output.
The following URC will output after get server's response:
+HTTPPOST:<err>,<httprspcode>[,<content_length>]. If download is interrupted the TA will send
URC again and the <content_length> is the length of already downloaded.
According to the <request_header> in the AT+HTTPCFG="requestheader"[,<request_header>], the
request data has two forms. If <request_header> is 0, the request data only need to include POST
request body, If <request_header> is 1, the request data need to include POST request headers and
POST request body.
AT+HTTPPOST
Test Command Response
AT+ HTTPPOST=? +HTTPPOST: (range of supported
<data_length>),(
Set Command <input_time>)
If <request_header> is 0disable custom OK
HTTP request headers Response
AT+ CONNECT
HTTPPOST=<data_length>[,<input_time>] TA switch to transparent transmission mode, and
Set Command input request data: HTTP POST request body.
If <request_header> is 1enable custom
HTTP request headers When the data length reaches the
AT+ <data_length>,TA back to command mode
HTTPPOST=<data_length>[,<input_time>] and response:
OK
Maximum Response Time If input time is out of <input_time> and receive
Parameter Saving Mode data less than <data_length>,TA will turn to
command mode and response:
+HTTP ERROR: <err>
If there is any error, response:
+HTTP ERROR:<err>
Response
CONNECT
TA switch to transparent transmission mode, and
input request data:HTTP POST request headers
and HTTP POST request body. When the data
length reaches the <data_length>,TA back to
command mode:
OK
If input time is out of <input_time> and receive
data less than <data_length>,TA will turn to
command mode and response:
+HTTP ERROR: <err>
If there is any error, response:
+HTTP ERROR:<err>
depend on <input_time>
NO_SAVE
Parameter INTEGER TYPE
<DATA_LENGTH> If <request_header> is 0,it's POST request body's length,If
<request_header> is 1,It's HTTP POST request headers and body's
<INPUT_TIME> length. Range: 1~4096. Unit: byte.
Integer type
The maximum input time of the HTTP POST request. Range: 1~65535.
Default value: 60. Unit: second.
<HTTPRSPCODE> Integer type
<CONTENT_LENGTH> HTTP response code. Refer to chapter 3.3.12.
<ERR> Integer type
HTTP response content length. Unit: byte.
Integer type
Error code, refer to section 3.3.11.
3.3.6 AT+HTTPPOSTFILE send POST request in file
This command can send the POST request that save in the file. According the <request_header> in the
AT+HTTPCFG="requestheader"[,<request_header>], the command has two forms: if
<request_header> is 0,the content of the file is POST contentif <request_header> is 1,the content of
the file is POST request headers and POST content.
After enter AT+HTTPREAD or AT+HTTPREADFILE and connect success, TA will send URC
+HTTPPOSTFILE: <err>,<httprspcode>[,<content_length>]. If download is interrupted the TA will
send the URC again and <content_length> is the length of already downloaded.
AT+HTTPPOSTFILE Response
Test Command +HTTPPOSTFILE: <file_name>
AT+HTTPPOSTFILE=? OK
Response
Set Command connect with HTTP server success:
AT+HTTPPOSTFILE=<file_name> CONNECT
if <request_header> is 1, the file must contain OK
HTTP headers If there is any error, response:
+HTTP ERROR:<err>
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter STRING TYPE
<FILE_NAME> file name. The maximum length: 255 byte
Integer type
<ERR> Error code, refer to section 3.3.11.
3.3.7 AT+HTTPREAD read the response of HTTP(S) server from
UART/USB
The command should use after success execute the command:AT+HTTPGET,
AT+HTTPGETEX,AT+HTTPPOST or AT+HTTPPOSTFILE. After connect success with HTTP(S) server,
according to different requests, the following URC will output: +HTTPGET:
<err>,<httprspcode>,<content_length>,+HTTPPOST: <err>,<httprspcode>[,<content_length>] or
+HTTPPOSTFILE: <err>,<httprspcode>,<content_length>.
According the <response_header> in AT+HTTPCFG="responseheader",<response_header>, if
<response_header> is 0, this command's response does not include the response headers, if
<response_header> is 1, this command's response include the response headers.
AT+HTTPREAD Response
Test Command OK
AT+HTTPREAD=? Response
Execute Command If connect success:
AT+HTTPREAD OK
CONNECT
Maximum Response Time If has enter AT+HTTPGET before:
Parameter Saving Mode +HTTPGET: <err>,<httprspcode>,<content_length>
<HTTP response data>
OK
If there is any error, response:
+HTTP ERROR:<err>
25s
NO_SAVE
Parameter INTEGER TYPE
<ERR> Error code, refer to section 3.3.11.
3.3.8 AT+HTTPREADFILE Read HTTP(S) server response to file
The command should use after success execute the command: AT+HTTPGET,
AT+HTTPGETEX,AT+HTTPPOST or AT+HTTPPOSTFILE. After connect success with HTTP(S) server,
according to different requests, the following URC will output: +HTTPGET:
<err>,<httprspcode>,<content_length>,+HTTPPOST: <err>,<httprspcode>[,<content_length>] or
+HTTPPOSTFILE: <err>,<httprspcode>,<content_length>. Then the server's response will save in
file.
AT+HTTPREADFILE Response
Test Command +HTTPREADFILE: <file_name>
AT+HTTPREADFILE =? OK
Set Command Response
AT+ HTTPREADFILE=<file_name> If connect success:
If has enter AT+HTTPGET before:
Maximum Response Time +HTTPGET:
Parameter Saving Mode <err>,<httprspcode>,<content_length>
OK
If there is any error, response:
+HTTP ERROR: <err>
25s
NO_SAVE
Parameter STRING TYPE
<FILE_NAME> File name. The maximum length: 255 byte
Integer type
<ERR> Error code, refer to section 3.3.11
3.3.9 AT+HTTPSTOP cancel HTTP request
MCU can cancel the HTTP GET/POST request through this command, and disconnect the connection
with HTTP(S) server.
AT+HTTPSTOP Response
Test Command OK
AT+HTTPSTOP=? Response
Execute Command OK
AT+HTTPSTOP If there is any error, response:
+HTTP ERROR:<err>
Maximum Response Time 10s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
<ERR> Error code, refer to section 3.3.11.
3.3.10 AT+HTTPFOTADL firmware upgrade via HTTP(S) server
If the upgrade package is stored on the HTTP server. This command can automatically execute the
download of the upgrade package and trigger the firmware upgrade after the download is complete. User
needs to select the correct upgrade package, and user can still choose the maximum value that prompts
the download progress during the download process.
AT+HTTPFOTADL Response
Set Command OK
AT+HTTPFOTADL=<HTTP_URL>[,<download +HTTPURC: "FOTA", "HTTPSTART"
_URC_max>] [+HTTPURC:
"FOTA","DOWNLOADING",<percent>
Maximum Response Time +HTTPURC:
Parameter Saving Mode "FOTA","DOWNLOADING",<percent>
...]
+HTTPURC: "FOTA","DOWNLOADED"
+QIND: "FOTA","UPDATING",<percent>
If there is any error, response:
+HTTP ERROR:<err>
25s
NO_SAVE
Parameter STRING TYPE
<HTTP_URL>
Must start with "http://" or https://. For
<HTTP_SERVER_URL>
<HTTP_PORT> example: "http://<HTTP_server_URL>: <HTTP_port>/<HTTP_file_path>"
<HTTP_FILE_PATH>
<ERR> String type
<DOWNLOAD_URC_MAX>
host or IP address of the HTTP(S) server
<PERCENT>
Integer type
HTTP(S) server's port. Default value: 80, Range:1~65535
String type
upgrade package file path and name
Integer type
Error code, refer to chapter 3.3.11.
Integer type,Maximum download progress
0 do not report download progress
50-100 range of maximum download progress
String type, Download or upgrade progress
3.3.11 Summary of <err> Codes
Code of <err> Description
0 Operation successful
1 Parameter error
2 Input timeout
3 URL is not set
4 Operation not support
5 No GET/POST requests
6 Request processing
7 Filename too long
8 File not found
9 Memory not enough
10 Ssl config error
11 URL parse error
12 DNS resolution failed
13 Protocol error
14 Socket error
15 PDP context bind failed
16 Socket connect timeout
17 Socket connect error
18 Socket connect close
19 Ssl error
20 Request timeout
21 Internal error
22 URL format error
100 Data receive complete
3.3.12 HTTP(S) response code
HTTP(S) server's response code. Description
OK
<httprspcode> Bad Request
200 Forbidden
400 Not Found
403 Method Not Allowed
404 Confilict
405 Length Required
409
411
500 Internal Sever Error
3.4 SSL Commands
3.4.1 AT+SSLCFG Configure SSL related parameters
This command is used to configure the cipher suite of the SSL context, CA certificate path,
authentication mode, client certificate path, client key and other SSL configuration. These parameters
will be used in the handshake process. If the third parameter is default, it means to query the current
configuration.
<SSL_ctxID> is the index of the SSL context. The module supports up to six SSL contexts. Multiple SSL
connections can be established based on one SSL context.
AT+SSLCFG Response
Test Command +SSLCFG: "sslversion",( range of supported
AT+SSLCFG=? <SSL_ctxID>),( range of supported <sslversion>)
+SSLCFG: "ciphersuite",( range of supported
Set Command <SSL_ctxID>),( range of supported <cipher_suites>)
AT+SSLCFG="sslversion",<S +SSLCFG: "cacert",( range of supported
SL_ctxID>[,<SSL_version>] <SSL_ctxID>),<cacertpath>
+SSLCFG: "clientcert",( range of supported
<SSL_ctxID>),<client_cert_path>
+SSLCFG: "clientkey",( range of supported
<SSL_ctxID>),<client_key_path>
+SSLCFG: "seclevel",( range of supported
<SSL_ctxID>),( range of supported <serclevel>)
+SSLCFG: "session_cache",( range of supported
<SSL_ctxID>),( range of supported <session_cache_enable>)
+SSLCFG: "sni",( range of supported <SSL_ctxID>),( range of
supported <sni>)
OK
Response
If the optional parameter is omitted, query the SSL version of the
specified SSL context:
+SSLCFG: "sslversion",<SSL_ctxID>,<SSL_version>
OK
If optional parameters are specified, configure the
SSL version of the specified SSL context:
OK
or
+SSL ERROR: <err>
Set Command Response
AT+SSLCFG="ciphersuit If the optional parameter is omitted, query the cipher suite of the
e",<SSL_ctxID>[,<ciph specified SSL context:
er_suites>] +SSLCFG: "ciphersuite",<SSL_ctxID>,<cipher_suites>
OK
Set Command If optional parameters are specified, configure the cipher suite of the
AT+SSLCFG="cacert",<S specified SSL context:
SL_ctxID> OK
[,<cacertpath>] or
+SSL ERROR: <err>
Set Command Response
AT+SSLCFG="clientcert If the optional parameter is omitted, query the CA certificate path of
" ,<SSL_ctxID>[,<clie the specified SSL context:
nt_cert_path>] +SSLCFG: "cacert",<SSL_ctxID>,<cacertpath>
OK
Set Command If optional parameters are specified, configure the CA certificate path
AT+SSLCFG="clientkey" of the specified SSL context:
,<SSL_ctxID>[,<client OK
_key_path>] or
+HTTP ERROR: <err>
Set Command Response
AT+SSLCFG="seclevel" If the optional parameter is omitted, query the client certificate path of
,<SSL_ctxID>[,< the specified SSL context:
+SSLCFG: "clientcert" ,<SSL_ctxID>,<client_cert_pat
h>
OK
If optional parameters are specified, configure the client certificate
path of the specified SSL context:
OK
or
+SSL ERROR: <err>
Response
If the optional parameter is omitted, query the client key path of the
specified SSL context:
+SSLCFG: "clientkey" ,<SSL_ctxID>,<client_key_path>
OK
If optional parameters are specified, configure the client key path of
the specified SSL context:
OK
or
+SSL ERROR: <err>
Response
If the optional parameter is omitted, query the authentication mode of
the specified SSL context:
seclevel >] +SSLCFG: "seclevel" ,<SSL_ctxID>,<seclevel>
OK
Set Command If optional parameters are specified, configure the authentication
AT+SSLCFG="session_ca mode of the specified SSL context:
che" ,<SSL_ctxID>[,<s OK
ession_cache_enable>] or
+SSL ERROR: <err>
Set Command Response
AT+SSLCFG="sni" ,<SSL_ct If the optional parameter is omitted, query the session resumption
xID>[,<SNI>] function of the specified SSL context:
+SSLCFG: "session_cache",<SSL_ctxID>,<session_cache_
Maximum Response Time enable>
Parameter Saving Mode OK
If optional parameters are specified, configure the session resumption
function of the specified SSL context:
OK
or
+SSL ERROR: <err>
Response
If the optional parameter is omitted, query the server name indication
function of the specified SSL context:
+SSLCFG: "session_cache",<SSL_ctxID>,<session_cache_enable>
OK
If optional parameters are specified, configure the server name
indication function of the specified SSL context:
OK
or
+SSL ERROR: <err>
5s
SAVE
Parameter Integer type
<SSL_ctxID> SSL context identifier. Range:0~5
<SSL_version>
Integer type
<cipher_suites>
0 SSL 3.0
1 TLS 1.0
2 TLS 2.0
3 TLS 3.0
4 all support
Hexadecimal number. SSL cipher suites
0xc0ad TLS_ECDHE_ECDSA_WITH_AES_256_CCM
0xc09f TLS_DHE_RSA_WITH_AES_256_CCM
See section 1.1 for details
<cacertpath> String type
<client_cert_path>
<client_key_path> CA certification path
<seclevel>
String type
<session_cache_enable
> client certification path
<sni>
String type
<err>
client key path
Integer type. authentication mode
0 No authentication
1 Perform server authentication
2 If required by the remote server, perform server and client
authentication
Integer type
0 Close the session resumption function
1 Open the session resumption function
Integer type
0 Close the server name indication function
1 Open the server name indication function
Integer Error code. Refer to Chapter 5
type
3.4.2 AT+SSLOPEN Connect to the remote server and handshake
This command is used to establish an SSL socket connection with a remote server. During the client and
server handshake, use the AT+SSLCFG configuration parameter. After the handshake is complete, the
module can send or receive data through this SSL connection.
AT+SSLOPEN Response
Test Command +SSLOPEN: (range of supported <PDP_ctxID>), range of
AT+SSLOPEN=? supported <SSL_ctxID>), (range of supported
<clientID>),
Set Command <serveraddr>,<server_port[>,(range of
AT+SSLOPEN=<PDP_ctxID>,<SSL_c supported <access_mode>)]
txID>,<clientID>,<serveraddr> OK
,<server_port[>,<access_mode> Response
] If the SSL connection is successfully established:
if the <access_mode> is direct push mode:
OK
If the <access_mode> is transparent mode:
CONNECT
If there is any error, response:
+SSL ERROR: <err>
Maximum Response Time 150s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
PDP context identifier. Range: 1~15.
<PDP_CTXID>
<SSL_CTXID> Integer type
SSL context identifier. Range: 0~5.
<CLIENTID> Integer type
SSL client index. Range: 0~11.
<SERVERADDR> String type
Remote server address, maximum length: 256 bytes
<SERVER_PORT> Integer type
Remote server listen port.
<ACCESS_MODE> Integer type
0 Direct push mode
1 Transparent access mode
<ERR> Error code. Refer to Chapter 3.4.8
3.4.3 AT+SSLSEND send data
After the SSL connection is established, the module can send data.
AT+SSLSEND Response
Test Command +SSLSEND: (range of supported <clientID>),
AT+SSLSEND=? range of supported <sendlen>
OK
Set Command Response
AT+SSLSEND=<clientID>,<sendlen> If the parameter format is correct
>
Maximum Response Time Enter the data until the length of the data reaches the
Parameter Saving Mode <sendlen>.
If the data is sent successfully:
OK
If sending fails:
+SSL ERROR: <err>
Depends on the input time to send data
NO_SAVE
Parameter Integer type
SSL CLIENT INDEX. Range:0~11.
<clientID> Integer type
Length of data. Range:1~1460. Unit: byte.
<sendlen>
Integer type
<err> Error code. Refer to Chapter 3.4.8.
3.4.4 AT+SSLCLOSE Close the SSL connection
This command is used to close the SSL connection.
AT+SSLCLOSE Response
Test Command + SSLCLOSE: (range of supported
AT+SSLCLOSE=? <clientID>)
OK
Set Command Response
AT+SSLCLOSE=<clientID> If the SSL connection is successfully closed:
OK
Maximum Response Time If there is any error, response:
Parameter Saving Mode +SSL ERROR:<err>
25s
NO_SAVE
Parameter Integer type
SSL client index. Range:0~11.
<clientID> Integer type
Error code. Refer to Chapter 3.4.8.
<err>
3.4.5 AT+SSLSTATE Query the status of the socket connection
This command is used to query the status of the socket connection. If the SSL connection has been
disconnected, only OK will be returned.
AT+SSLSTATE Response
Test Command OK
AT+SSLSTATE=? Response
Set Command
AT+SSLSTATE=<clien +SSLSTATE:
tID> <clientID>,<IP_address>,<remote_port>,<socket_state>,<
SSL_ctxID>
Maximum Response OK
Time If there is any error, response:
Parameter Saving Mode +SSL ERROR:<err>
25s
NO_SAVE
Parameter Integer type
SSL client index. Range:0~11.
<clientID> String type
<IP_address> Remote server IP address
<remote_port> Integer type
<socket_state> Remote server port
<SSL_ctxID> Integer type
<err> 1 "Connected"
Integer type
SSL context identifier. Range: 0~5.
Integer type
Error code. Refer to Chapter 3.4.8.
3.4.6 +SSLURC: "recv" the received data
+SSLURC
+SSLURC: "closed",<clientID>
Parameter Integer type
SSL client index. Range:0~11.
<clientID> Integer type
The length of the data received. Unit: byte.
<recvlength> Integer type
data received.
<data>
3.4.7 +SSLURC: "closed" notify disconnect
The URC is used to notify MCU that the connection has been disconnected. The disconnection may be
caused by many reasons, for example, the remote server actively disconnects or the network connection
is closed. The module will release the context of the SSL connection.
+SSLURC
+SSLURC: "closed",<clientID>
Parameter Integer type
SSL client index. Range:0~11.
<clientID>
3.4.8 Summary of <err> Codes
Code of <err> Description
0 Operation successful
1 Parameter error
2 SSL configure error
3 SSL error
4 SSL connect error
5 SSL client already has connect
6 SSL client no connect
7 Internal error
3.5 MQTT Commands
3.5.1 AT+ECMTCFG
The command configs a MQTT client.
AT+ECMTCFG Response
Set Command
Configure the keep alive time OK
AT+ECMTCFG="keepalive",<tcpconnectID>[,<keep If <keep-alive time> is omitted,
query the keep-alive time:
-alive time>]
+ECMTCFG: "keepalive",<keep-
alive time>
Set Command OK
Configure the session type
If there is any error, response:
AT+ECMTCFG="session",<tcpconnectID>[,<clean_
session>] ERROR
Set Command Response
Configure the timeout of message delivery
OK
AT+ECMTCFG="timeout",<tcpconnectID>[,<pkt_ti
meout>[,<retry_times>][,<timeout_notice>]] If <clean_session> is omitted,
query the session type:
Set Command
Configure the Will information +ECMTCFG:
"session",<clean_session>
AT+ECMTCFG="will",<tcpconnectID>[,<will_fg>[ OK
,<will_qos>,<will_retain>,"<will_topic>","<w
ill_msg>"]] If there is any error, response:
Set Command ERROR
Configure the MQTT protocol version to be used
Response
AT+ECMTCFG="version",<tcpconnectID>[,<versio
n>] OK
If <pkt_timeout>, retry_times>,
<timeout_notice> are omitted,
query the timeout value of
message delivery:
+ECMTCFG:
"timeout",<pkt_timeout>,<retr
y_times>,<timeout_notice>
OK
If there is any error, response:
ERROR
Response
OK
If <will_fg>, <will_qos>,
<will_retain>, <will_topic> and
<will_msg> are omitted, query the
Will information:
+ECMTCFG:
"will",<will_fg>[,<will_qos>,
<will_retain>,<will_topic>,<w
ill_msg>]
OK
If there is any error, response:
ERROR
Response
OK
If <version> is omitted, query the
MQTT protocol version:
+ECMTCFG: "version",<version>
OK
If there is any error, response:
Set Command ERROR
Configure the device information for Ali cloud
Response
AT+ECMTCFG="aliauth",<tcpconnectID>[,"<produ
ct_key>","<device_name>","<device_secret>"] OK
Set Command If "<product_key>",
Configure the cloud type and the format of sent data "<device_name>",
for the cloud "<device_secret>" are omitted,
query the device information:
AT+ECMTCFG="cloud",<tcpconnectID>,<cloud
type>,<data type> +ECMTCFG:
"aliauth",<product_key>,<devi
ce_name>,<device_secret>
OK
If there is any error, response:
ERROR
Response
OK
If there is any error, response:
ERROR
Test Command Response
AT+ECMTCFG=? +ECMTCFG:
+ECMTCFG: "keepalive",(0),(0-
3600)
+ECMTCFG: "session",(0),(0,1)
+ECMTCFG: "timeout",(0),(1-
60),(1-10),(0,1)
+ECMTCFG:
"will",(0),(0,1),(0-
2),(0,1),"will_topic","will_m
sg"
+ECMTCFG: "version",(0),(3,4)
+ECMTCFG:
"aliauth",(0),"productkey","d
evicename","devicesecret"
+ECMTCFG: "cloud",(0-255),
(0-255) OK
Maximum Response Time 5s
Parameter Saving Mode NO_SAVE
Parameter STRING TYPE
MQTT socket identifier, the value is 0
<TCPCONNECTID> Integer type.
<KEEP-ALIVE
TIME> The range is 0-3600. The default value is 120. Unit: second. It defines the
maximum time interval between messages received from a client. If the server
<CLEAN_SESSION> does not receive a message from the client within 1.5 times of the keep-alive
<PKT_TIMEOUT> time period, it disconnects the client as if the client has sent a DISCONNECT
<RETRY_TIMES> message.
<TIMEOUT_NOTICE> Integer type. Configure the session type
<WILL_FG> 0 The server must store the subscriptions of the client after it disconnects.
<WILL_QOS> 1 The server must discard any previously maintained information about the
<WILL_RETAIN> client and treat the connection as "clean".
Integer type.
<WILL_TOPIC> Timeout of the packet delivery. The range is 1-60. The default value is 10.
<WILL_MSG> Unit: second.
<VERSION> Integer type. (not supported)
<PRODUCT_KEY> Retry times when packet delivery times out. The range is 0-10. The default
<DEVICE_NAME> value is 3.
Integer type. (not supported)
0 Not report timeout message when transmitting packet
1 Report timeout message when transmitting packet
Integer type. Configure the Will flag
0 Ignore the Will flag configuration
1 Require the Will flag configuration
Integer type. Quality of service for message delivery
0 At most once
1 At least once
2 Exactly once
Integer type. The Will retain flag is only used on PUBLISH messages.
0 When a client sends a PUBLISH message to a server, the server will not
hold on to the message after it has been delivered to the current subscribers
1 When a client sends a PUBLISH message to a server, the server should
hold on to the message after it has been delivered to the current subscribers
Integer type.
Will topic string, The maximum size is 255 bytes
Integer type.
The Will message defines the content of the message that is published to the
will topic if the client is unexpectedly disconnected. It can be a zero-length
message. , The maximum size is 255 bytes
Integer type. Version of MQTT protocol, the default is MQTT v3.1.1
3 MQTT v3.1
4 MQTT v3.1.1
Integer type.
Product key issued by Ali Cloud, The maximum size is 32 bytes
Integer type.
Device name issued by Ali Cloud, The maximum size is 32 bytes
<DEVICE_SECRET> Integer type.
<CLOUD TYPE > Device secret key issued by Ali Cloud, The maximum size is 64 bytes
Integer type
<DATA TYPE> 0 mosquitto
1 OneNet
2 alibaba
3-255 is reserved for customers
Integer type, the range is 0-255
For OneNet cloud
1 OneNet data type1
2 OneNet data type2
3 OneNet data type3
4 OneNet data type4
5 OneNet data type5
6 OneNet data type6
For Ali Cloud
1 Json data
2 string data
For other, data format insensitive
3.5.2 AT+ECMTOPEN
The command is used to open a network for MQTT client.
AT+ECMTOPE Response
Set Command
OK
AT+ECMTOPEN=<tcpconnectID>,"<host_name>", +ECMTOPEN:
<port> <tcpconnectID>,<result>
Test Command If there is any error, response:
AT+ECMTOPEN=? ERROR
Read Command Response
AT+ECMTOPEN? +ECMTOPEN: (list of supported
<tcpconnectID>s),"<host_name>",(list of
Maximum Response Time supported <port>s)
OK
Response
[+ECMTOPEN:
<tcpconnectID>,"<host_name>",<po
rt>]
OK
5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
MQTT socket identifier. The value is 0
<TCPCONNECTID> String type
<HOST_NAME> The address of the server. It could be an IP address or a domain name. The
maximum size is 100 bytes
<PORT> Integer type
<RESULT> The port of the server. The range is 1-65535
Integer type, Result of the command execution
-1 Failed to open network
0 Opened network successfully
3.5.3 AT+ECMTCLOSE
The command is used to close mqtt client.
AT+ECMTCLOSE Response
Set Command
OK
AT+ECMTCLOSE=<tcpconnectID> +ECMTCLOSE: <tcpconnectID>,<result>
Test Command If there is any error, response:
AT+ECMTCLOSE=? ERROR
Maximum Response Time Response
Parameter Saving Mode
+ECMTCLOSE: (list of supported
<tcpconnectID>s)
OK
5s
NO_SAVE
Parameter INTEGER TYPE
MQTT socket identifier. The value is 0
<TCPCONNECTID> Integer type, Result of the command execution
-1 Failed to close mqtt
<RESULT> 0 Close network successfully
3.5.4 AT+ECMTCONN
The command send MQTT connect packet.
AT+ECMTCONN Response
Set Command
OK
AT+ECMTCONN=<tcpconnectID>,"<clientID>" +ECMTCONN:
[,"<username>"[,"<password>"]] <tcpconnectID>,<result>[,<ret_code
>]
Test Command
If there is any error, response:
AT+ECMTCONN=?
ERROR
Read Command
Response
AT+ECMTCONN?
+ECMTCONN: (list of supported
Maximum Response Time <tcpconnectID>s),"<clientID>"[,"<u
Parameter Saving Mode sername>"[,"<password>"]]
OK
Response
[+ECMTCONN:
<tcpconnectID>,<state>]
OK
5s
NO_SAVE
Parameter INTEGER TYPE
MQTT socket identifier. The value is 0
<TCPCONNECTID> String type
<CLIENTID> The client identifier, The maximum size is 48 bytes
<USERNAME> String type
User name of the client. It can be used for authentication, The maximum size is
<PASSWORD> 48 bytes
String type
<RESULT> Password corresponding to the user name of the client. It can be used for
authentication, The maximum size is 96 bytes
<RET_CODE> Integer type
0 send data successfully and received ACK from server
1 send data successfully and received error ACK from server
2 send data fail
Integer type
0 connect accepted
1 connect refused � incorrect protocol version
2 connect refused � invalid client identifier
3 connect refused � server unavailable
4 connect refused � bad user name or password
5 connect refused � not authorised
6 connect fail
3.5.5 AT+ECMTDISC
The command send MQTT disconnect packet.
AT+ECMTDISC Response
Set Command
OK
AT+ECMTDISC=<tcpconnectID> +ECMTDISC: <tcpconnectID>,<result>
Test Command If there is any error, response:
AT+ECMTDISC=? ERROR
Maximum Response Time Response
Parameter Saving Mode
+ECMTDISC: (list of supported
<tcpconnectID>s)
OK
5s
NO_SAVE
Parameter INTEGER TYPE
MQTT socket identifier. The value is 0
<TCPCONNECTID> Integer type, Result of the command execution
-1 Failed to disconnect network
<RESULT> 0 Disconnect network successfully
3.5.6 AT+ECMTSUB
The command send MQTT subscribe packet.
AT+ECMTSUB Response
Set Command
OK
AT+ECMTSUB=<tcpconnectID>,<msgID>,"<topi +ECMTSUB:
c>",<qos> <tcpconnectID>,<msgID>,<result>[,
<value>]
If there is any error, response:
Test Command ERROR
AT+ECMTSUB=? Response
Maximum Response Time +ECMTSUB: (list of supported
Parameter Saving Mode <tcpconnectID>s),(list of
supported
<msgID>s),"<topic>",(list of
supported <qos>s)
OK
5s
NO_SAVE
Parameter INTEGER TYPE
MQTT socket identifier. The value is 0
<TCPCONNECTID> Integer type
<MSGID> Message identifier of packet. The range is 1-65535
<TOPIC> String type
Topic that the client wants to subscribe to or unsubscribe from. The maximum
<QOS> length is 255 bytes
<RESULT> Integer type
Message QoS, can be 0,1 or 2
<VALUE> Integer type
0 send data successfully and received ACK from server
1 send data successfully and received error ACK from server
2 send data fail
Integer type
It is granted qos levels
3.5.7 AT+ECMTUNS
The command send MQTT unsubscribe packet.
AT+ECMTUNS Response
Set Command
OK
AT+ECMTUNS=<tcpconnectID>,<msgID>,"<topic> +ECMTUNS:
" <tcpconnectID>,<msgID>,<result
>
Test Command
If there is any error, response:
AT+ECMTUNS=?
ERROR
Response
+ECMTUNS: (list of supported
Maximum Response Time <tcpconnectID>s),(list of
Parameter Saving Mode supported <msgID>s),"<topic>"
OK
5s
NO_SAVE
Parameter INTEGER TYPE
MQTT socket identifier. The value is 0
<TCPCONNECTID> Integer type
<MSGID> Message identifier of packet. The range is 1-65535
<TOPIC> String type
Topic that the client wants to subscribe to or unsubscribe from. The maximum
<RESULT> length is 255 bytes
Integer type
0 send data successfully and received ACK from server
1 send data successfully and received error ACK from server
2 send data fail
3.5.8 AT+ECMTPUB
The command send MQTT publish packet .
AT+ECMTPUB Response
Set Command
OK
AT+ECMTPUB=<tcpconnectID>,<msgID>,<qos>,<retai +ECMTPUB:
n>,"<topic>","<payload>" <tcpconnectID>,<msgID>,<res
ult>[,<value>]
Test Command
If there is any error, response:
AT+ECMTPUB=?
ERROR
Maximum Response Time
Response
+ECMTPUB: (list of
supported
<tcpconnectID>s),(list of
supported <msgID>s),(list
of supported <qos>s),(list
of supported
<retain>s),"<topic>","<msg>
"
OK
5s
Parameter Saving Mode NO_SAVE
Parameter INTEGER TYPE
<TCPCONNECTID> MQTT socket identifier. The value is 0
<MSGID>
Integer type
<QOS>
<RETAIN> Message identifier of packet. The range is 0-65535. It will be 0 only when
<TOPIC> <qos>=0
<PAYLOAD>
Integer type
<RESULT>
Message QoS, can be 0,1 or 2
<VALUE>
Integer type
0 Server should not retain the message
1 Server should retain the message
String type
Topic that needs to be published. The maximum length is 255 bytes
String type or Hex type
Message that needs to be published. Maximum length is 1024 bytes. If in data
mode, the maximum length is 1024 bytes
Integer type
0 send data successfully and received ACK from server
1 send data successfully and received error ACK from server
2 send data fail
Integer type
It is granted qos levels
3.5.9 +ECMTSTAT
This is an unsolicited status to indicate MQTT client connect to MQTT server.
+ECMTSTAT
+ECMTSTAT: <tcpconnectID>,<err_code>
Parameter INTEGER TYPE
MQTT socket identifier. The value is 0
<TCPCONNECTID> Integer type. Error code
1 Connection is closed or reset by peer
<ERR_CODE>
3.5.10 +ECMTRECV
This is an unsolicited message to indicate MQTT client receive data from MQTT server.
+ECMTRECV
+ECMTRECV: <tcpconnectID>,<msgID>,<topic>,<data>
Parameter INTEGER TYPE
MQTT socket identifier. The value is 0
<TCPCONNECTID> String type
<MSGID> The message identifier of packet
<TOPIC> string type
<DATA> The topic that received from MQTT server
String type
Receive data from server
3.6 Socket Command(solution B)
3.6.1 AT+ECSOCR
The command creates a socket on the UE and associates with specified protocol. If the port
is set, receiving is enabled and "+ECSONMI" unsolicited messages will appear for any
message that is received on that port.
AT+ECSOCR Response
Set Command <socket_id>
AT+ECSOCR=<type>,<protocol>[,<listen_port>[,<receive_control OK
>[,<af_type>[,<ip_address>]]]]
If there is any
Test Command error, response:
AT+ECSOCR=?
+CME ERROR:
<err>
Response
+ECSOCR: (list of
supported <
type>), (list of
supported <
protocol>),(list
of supported <
listen_port>),
(list of supported
<receive_cont
rol>),(list of
supported<
af_type>), (list
of supported <
af_type>),(<ip_
addr>)
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<TYPE> STRING TYPE
DGRAM UDP
STREAM TCP
<PROTOCOL> Integer type
Standard internet protocol definition. UDP is 17, and
TCP is 6.
<LISTEN_PORT> Integer type
A number in the range of 0-65535. This is the local port that will be
included in sent messages and on which messages will be received. If it
is 0 or omitted, the module will assign a random <listen_port> for this
socket
<RECEIVE_CONTROL> Integer type
0 the incoming messages will be ignored
1 the default value, the incoming messages will be received
<AF_TYPE> String type
AF_INET the default value. IPv4
AF_INET6 IPv6
<IP_ADDRESS> String type
IP address. The IP address of the network assigned to UE.
<SOCKET_ID> Integer type
0-11 A maximum of 12 sockets are supported, but other serviced may
reduce this number.
Example
AT+ECSOCR="DGRAM",17,2233,1,"AF_INET"
1
OK
3.6.2 AT+ECSOST
Send a UDP datagram containing length bytes of data to <remote_port> on <remote_addr> .
The command sends a UDP datagram containing length bytes of data to the specified host and port.
It will return with the socket that it was sent on, and the number of bytes of data sent. If the amount
of data is larger than the largest datagram that can be sent, return value of AT+ECSOST will indicate
how much of the data was successfully sent.
AT+ECSOST
Set Command Response
AT+ECSOST=<socket_id>,<remote_addr>,<remote_port>,<length>,<da <socket_id>
ta>[,<sequence>[,<segment_id>,<segment_num>]] ,<length>
OK
If there is any
error,
response:
+CME ERROR:
<err>
Test Command Response
AT+ECSOST=? +ECSOST: (list
of supported <
socket_id>),
(list of
supported
<remote_add
r >), (list of
supported<
remote_port
>), (list of
supported <
length>),(<da
ta>), (list of
supported <
sequence>),(li
st of supported
<
segment_id
>),(list of
supported <
segment_num
>)
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter INTEGER TYPE
<SOCKET_ID>
<REMOTE_ADDR> 0-11 Socket Id returned by AT+ECSOCR
<REMOTE_PORT>
<LENGTH> String type
<DATA>
<SEQUENCE> Remote IP address
<SEGMENT_ID> Integer type
<SEGMENT_NUM>
<STATUS> 0-65535 This is the remote port on which messages will be received
Integer type
1-1400 Decimal length of data to be sent
String type
data be sent in hex string format
Integer type
1-255 If it is omitted, data sent will not be reported. If not omitted, when
datagram is sent over RF or is discarded, then the result will be reported:
+ECSOSTR: <socket_id>,<sequence>,<status>
Integer type
1-4 One segment index of a segment message.
Integer type
2-4 The total number which the messages will fragment.
Integer type
0 the sent status of datagram is fail
1 the sent status of datagram is success
Example
AT+ECSOST=1,"180.167.122.150",5002,2,"ABAB"
1,2
OK
3.6.3 AT+ECSOSTT
Send a UDP datagram containing length bytes of data to <remote_port> on <remote_addr> with
transparent mode.
The command sends a UDP datagram containing length bytes of data to the specified host and port.
It will return with the socket that it was sent on, and the number of bytes of data sent. If the amount
of data is larger than the largest datagram that can be sent, return value of AT+ECSOSTT will
indicate how much of the data was successfully sent.
If the command contain the parameter of "length", It need input enough data with hex string format
after ">" output. If the command did not contain the parameter of "length", the input of data must end
with "CTRL+Z".
AT+ECSOST Response
Set Command
AT+ECSOSTT=<socket_id>,<remote_addr>,<remote_port>[,<lengt <socket_id>,<le
h>[,<sequence>]] ngth>
OK
If there is any
error, response:
+CME ERROR:
<err>
Test Command Response
AT+ECSOSTT=? +ECSOSTT: (list of
supported <
socket_id>), (list
of supported
<remote_addr >),
(list of supported<
remote_port >),
(list of supported <
length>), (list of
supported <
sequence>)
OK
Maximum Response Time 60s
Parameter Saving Mode SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
<REMOTE_ADDR> String type
Remote IP address
<REMOTE_PORT> Integer type
0-65535 This is the remote port on which messages will be received
<LENGTH> Integer type
1-1400 Decimal length of data to be sent
<DATA> String type
data be sent in hex string format
<SEQUENCE> Integer type
1-255 If it is omitted, data sent will not be reported. If not omitted, when
datagram is sent over RF or is discarded, then the result will be reported:
+ECSOSTR: <socket_id>,<sequence>,<status>
<STATUS> Integer type
2 the sent status of datagram is fail
3 the sent status of datagram is success
Example
AT+ECSOSTT=1,"180.167.122.150",5002,2
>ABAB
1,2
OK
AT+ECSOSTT=1,"180.167.122.150",5002
>ABAB
1A
1,2
OK
3.6.4 AT+ECSOSTF
Send a UDP datagram containing length bytes of data to <remote_port> on <remote_addr> and
allows meta-data flags to be sent.
The command sends a UDP datagram containing length bytes of data to the specified host:port. It will
return with the socket that it was sent on, and the number of bytes of data sent. If the amount of data
is larger than the largest datagram that can be sent, return value of AT+ECSOSTF will indicate how
much of the data was successfully sent.
AT+ECSOSTF
Set Command Response
AT+ECSOSTF=<socket_id>,<remote_addr>,<remote_port>,<flag>,<len <socket_id
gth>,<data>[,<sequence>[,<segment_id>,<segment_num>]] >,<length>
OK
If there is
any error,
response:
+CME
ERROR:
<err>
Test Command Response
AT+ECSOSTF=? +ECSOSTF:
(list of
supported
<socket_id
>), (list of
supported
<remote_ad
dr>),(list of
supported
<remote_po
rt>), (list of
supported
<flag>), (list
of supported <
length>),(<d
ata>), (list of
supported <
sequence>),(l
ist of
supported
<segment_i
d>),(list of
supported <
segment_nu
m>)
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
Socket Id returned by AT+ECSOCR
<REMOTE_ADDR> String type
Remote IP address
<REMOTE_PORT> Integer type
0-65535 This is the remote port on which messages will be received
<FLAG> Integer type
Specifies the type of message transmission. Values of this argument
are in hex format and are formed by logically OR'ing zero or more of the
following flags:
0x100 Exception Message: Send messages with high priority
0x200 Release Indicator: indicate release after next message
0x400 Release Indicator: indicate release after next messages has
been replied to
If no flags are set, a value of 0 should be provided
<LENGTH> Integer type
1-1400 Decimal length of data to be sent
<DATA> String type
data be sent in hex string format
<SEQUENCE> Integer type
1-255 If it is omitted, data sent will not be reported. If not omitted, when
datagram is sent over RF or is discarded, then the result will be reported:
+ECSOSTR: <socket_id>,<sequence>,<status>
<SEGMENT_ID> Integer type
1-4 One segment index of a segment message.
<SEGMENT_NUM> Integer type
2-4 The total number which the messages will fragment.
<STATUS> Integer type
0 the sent status of datagram is fail
1 the sent status of datagram is success
Example
AT+ECSOSTF=1,"180.167.122.150",5002,0x100,2,"ABAB"
1,2
OK
3.6.5 AT+ECSOSTFT
Send a UDP datagram containing length bytes of data to <remote_port> on <remote_addr> and
allows meta-data flags to be sent with transparent mode.
The command sends a UDP datagram containing length bytes of data to the specified host:port. It will
return with the socket that it was sent on, and the number of bytes of data sent. If the amount of data
is larger than the largest datagram that can be sent, return value of AT+ECSOSTFT will indicate
how much of the data was successfully sent.
If the command contain the parameter of "length", It need input enough data with hex string format
after ">" output. If the command did not contain the parameter of "length", the input of data must end
with "CTRL+Z".
AT+ECSOSTFT Response
Set Command <socket_id>,<l
AT+ECSOSTFT=<socket_id>,<remote_addr>,<remote_port>,<flag>[ ength>
,<length>[,<sequence>]] OK
Test Command If there is any
AT+ECSOSTFT=? error, response:
+CME ERROR:
<err>
Response
+ECSOSTFT: (list
of supported
<socket_id>),
(list of supported
<remote_addr>),
(list of supported
<remote_port>),
(list of supported
<flag>), (list of
supported <
length>),(list of
supported <
sequence>)
OK
Maximum Response Time 60s
Parameter Saving Mode SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
<REMOTE_ADDR> String type
Remote IP address
<REMOTE_PORT> Integer type
0-65535 This is the remote port on which messages will be received
<FLAG> Integer type
Specifies the type of message transmission. Values of this argument
are in hex format and are formed by logically OR'ing zero or more of the
following flags:
0x100 Exception Message: Send messages with high priority
0x200 Release Indicator: indicate release after next message
0x400 Release Indicator: indicate release after next messages has
been replied to
If no flags are set, a value of 0 should be provided
<LENGTH> Integer type
1-1400 Decimal length of data to be sent
<DATA> String type
data be sent in hex string format
<SEQUENCE> Integer type
1-255 If it is omitted, data sent will not be reported. If not omitted, when
datagram is sent over RF or is discarded, then the result will be reported:
+ECSOSTR: <socket_id>,<sequence>,<status>
<STATUS> Integer type
2 the sent status of datagram is fail
3 the sent status of datagram is success
Example
AT+ECSOSTFT=1,"180.167.122.150",5002,0x100,2
>ABAB
1,2
OK
AT+ECSOSTFT=1,"180.167.122.150",5002,0x100
>ABAB
1A
1,2
OK
3.6.6 AT+ECQSOS
The command queries the list of the pending upstream message.
AT+ECQSOS
Set Command Response
AT+ECQSOS=<socket_id>[,<socket_id>[,<socket_id>[,< [+ECQSOS:<socket_id>,<s
socket_id>[...]]]] equence>]
[...]
OK
If there is any error,
response:
+CME ERROR: <err>
Test Command Response
AT+ECQSOS=? +ECQSOS: (list of supported <
socket_id>)
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
<SEQUENCE> Integer type
1-255 If it is omitted, data sent will not be reported. If not omitted, when
datagram is sent over RF or is discarded, then the result will be reported:
+ECSOSTR: <socket_id>,<sequence>,<status>
Example
AT+ECQSOS=1
+ECQSOS:1,2
OK
3.6.7 AT+ECSORF
The command can read up to <req_length> characters of data from <socket>, and returned length is
the actual number of characters returned.
The command is use to receive data on a socket. When data arrives, a "+ECSONMI" response will
be generated to indicate the socket the message was received on and also the amount of data. The
AT+ECSORF command takes a length, which is the maximum amount of data that will be returned.
If the requested length is larger than the actual size of the returned data, only the length of returned
data is provided, and the remaining length is returned as 0. If the requested length is less than the
amount of data returned, only the requested amount of data will be returned, plus an indication of the
number of bytes remaining. Once a message has been fully read, a new "+ECSONMI" notification will
be sent if there is another message to process.
If messages arrive faster than they are read, and the internal message buffer is full, the most recent
message will be discarded.
AT+ECSORF
Set Command Response
AT+ECSORF=<socket_id>,<re <socket_id>,<ip_addr>,<port>,<length>,<data>,<re
q_length> maining_length>
OK
If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+ECSORF=? +ECSORF: (list of supported <socket_id>), (list of supported
<req_length>)
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
<IP_ADDR> String type
Remote IP address
<PORT> Integer type
0-65535 This is the remote port on which messages will be sent
from
<REQ_LENGTH> Integer type
1-1357 Decimal length of data which want to read
<LENGTH> Integer type
1-1358 Decimal length of data to be read
<DATA> String type
data be sent in hex string format
<REMAINING_LENGTH> Integer type
0-1357 Amount of data left to read for this message as a decimal byte
length. Remaining length is always 0. The remaining data is readable.
Example
AT+ECSORF=1,4
1,"180.167.122.150",5002,4,"ABABABAB",0
OK
3.6.8 AT+ECSOCO
The command connect a TCP server to the specified host and port. if the socket connection connect
success, it will indicate the success result with the URC "+ECSOCO". If the socket connection connect
fail, it will indicate the fail result with the URC "+ECSOCLI"
AT+ECSOCO
Set Command Response
AT+ECSOCO=<socket_id>,<remote_addr>,<remote_port> OK
If there is any error,
response:
+CME ERROR: <err>
Test Command Response
AT+ECSOCO=? +ECSOCO: (list of
supported
<socket_id>), (list of
supported
<remote_addr>),( list
of supported
<remote_port >)
OK
Maximum Response Time 30s
Parameter Saving Mode SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
<REMOTE_ADDR> String type
The remote IP address
<REMOTE_PORT> Integer type
0-65535 This is the remote port to be connected to
Example
AT+ECSOCO=1,"180.167.122.150",5002
OK
+ECSOCO: 1
3.6.9 AT+ECSOSD
The command sends a TCP datagram to the TCP server. It will return with the socket that it was sent
on, and the number of bytes of data sent. If the amount of data is larger than the largest datagram
that can be sent, then AT+ECSOSD return value will indicate how much the data was successfully
sent.
The If <sequence> is not omitted, when datagram is asked for by the server or is discarded by UE,
the result will be reported.
AT+ECSOSD
Set Command Response
AT+ECSOSD=<socket_id>,<length>,<data>[,<flag>[,<sequenc <socket_id>,<lengt
e>]] h>
OK
If there is any error,
response:
+CME ERROR: <err>
Test Command Response
AT+ECSOSD=? +ECSOSTF: (list of
supported
<socket_id>), (list of
supported
<length>),(<data>),( li
st of supported <flag>)
(list of supported
<sequence>)
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
<LENGTH> Integer type
1-1400 Decimal length of data to be sent
<DATA> String type
data be sent in hex string format
<FLAG> Integer type
Specifies the type of message transmission. Values of this argument
are in hex format and are formed by logically OR'ing zero or more of the
following flags:
0x100 Exception Message: Send messages with high priority
0x200 Release Indicator: indicate release after next message
0x400 Release Indicator: indicate release after next messages has
been replied to
If no flags are set, a value of 0 should be provided
<SEQUENCE> Integer type
1-255 If it is omitted, data sent will not be reported. If not omitted, when
datagram is sent over RF or is discarded, then the result will be reported:
+ECSOSTR: <socket_id>,<sequence>,<status>
<STATUS> Integer type
0 the sent status of datagram is fail
1 the sent status of datagram is success
Example
AT+ECSOSD=1,2,"ABAB"
1,2
OK
3.6.10 AT+ECSOSDT
The command sends a TCP datagram to the TCP server with transparent mode. It will return with the
socket that it was sent on, and the number of bytes of data sent. If the amount of data is larger than
the largest datagram that can be sent, then AT+ECSOSDT return value will indicate how much the
data was successfully sent.
The If <sequence> is not omitted, when datagram is asked for by the server or is discarded by UE,
the result will be reported.
If the command contain the parameter of "length", It need input enough data with hex string format
after ">" output. If the command did not contain the parameter of "length", the input of data must end
with "CTRL+Z".
AT+ECSOSDT Response
Set Command <socket_id>,<length
AT+ECSOSDT=<socket_id>[,<length>[,<flag>[,<sequence>]] >
] OK
Test Command If there is any error,
AT+ECSOSDT=? response:
Maximum Response Time +CME ERROR: <err>
Response
Parameter Saving Mode +ECSOSDT: (list of
supported
<socket_id>), (list of
supported
<length>),( list of
supported <flag>) (list of
supported <sequence>)
OK
60s
SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
<LENGTH> Integer type
1-1400 Decimal length of data to be sent
<DATA> String type
data be sent in hex string format
<FLAG> Integer type
Specifies the type of message transmission. Values of this argument
are in hex format and are formed by logically OR'ing zero or more of the
following flags:
0x100 Exception Message: Send messages with high priority
0x200 Release Indicator: indicate release after next message
0x400 Release Indicator: indicate release after next messages has
been replied to
If no flags are set, a value of 0 should be provided
<SEQUENCE> Integer type
<STATUS> 1-255 If it is omitted, data sent will not be reported. If not omitted, when
Example datagram is sent over RF or is discarded, then the result will be reported:
AT+ECSOSDT=1,2 +ECSOSTR: <socket_id>,<sequence>,<status>
>ABAB
1,2 Integer type
OK
2 the sent status of datagram is fail
AT+ECSOSDT=1
>ABAB 3 the sent status of datagram is success
1A
1,2
OK
3.6.11 AT+ECSOCL
The command is used to close the specified socket. If there are pending messages to be read, they
will be dropped. No further unsolicited "+ECSONMI" notification will be generated. If the socket has
already been closed, or was never created, an error will be returned.
AT+ECSOCL
Set Command Response
AT+ECSOCL=<socket_id> OK
If there is any
error, response:
+CME ERROR:
<err>
Test Command Response
AT+ECSOCL=? +ECSOSTF: (list
Maximum Response Time of supported
<socket_id>)
Parameter Saving Mode OK
5s
SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
Example
AT+ECSOCL=1
OK
3.6.12 AT+ECSONMI
The write command is used to set the unsolicited result code "+ECSONMI" to indicate arrived socket
messages(the socket were not configure as private socket by AT+ECSONMIE command):
If <mode>=1, the UE will receive an unsolicited result code: "+ECSONMI: <socket>,<length>".
If <mode>=2, the UE will receive an unsolicited result code: "+ECSONMI: <socket>,<remote_ad
dr>,<remote_port>,<length>,<data>".
If <mode>=3, the UE will receive an unsolicited result code: "+ECSONMI: <socket>,<length>,<data>".
The read command returns the current setting of the command.
The write command is also used to set the public max downlink buffer size and the public max
messages number
AT+ECSONMI
Set Command Response
AT+ECSONMI=<mode>[,<max_public_dl_buffer>[,<max OK
_public_dl_pkg_num>]] If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+ECSONMI=? +ECSONMI: (list of supported
<mode>s), (list of supported <
max_public_dl_buffer>),( list
of supported <
max_public_dl_pkg_num >)
OK
Read Command Response
AT+ECSONMI? +ECSONMI:<mode>,<
max_public_dl_buffer >,<max_publi
c_dl_pkg_num>
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
INTEGER TYPE
<MODE>
Control downlink data format.
<SOCKET_ID>
<LENGTH> 0 Disable indication messages unsolicited result code.
<REMOTE_ADDR>
<REMOTE_PORT> 1 Enable indication messages unsolicited result code:
<DATA>
<MAX_PUBLIC_DL_BUFFER "+ECSONMI: <socket_id>,<length>"
>
<MAX_PUBLIC_DL_PKG_NU 2 Enable indication messages unsolicited result code:
M>
"+ECSONMI:
<socket_id>,<remote_addr>,<remote_port>,<length>,<
data>
3 Enable indication messages unsolicited result code:
"+ECSONMI: <socket_id>,<length>,<data>"
Integer type
0-11 Socket Id returned by AT+ECSOCR
Integer type
1-1358 Number of bytes of data in the first message
string type
The remote IP address which the message is sent from
Integer type
0-65535 The remote port which the message if sent from
string type
Data received in hex string format. Maximum length of received data is
1358 bytes
Integer type
1358-3072 The maximum downlink buffer total size for all sockets
created by AT+ECSOCR which is not configure as private mode socket
with the command "AT+ECSONMIE". The default value is 2048
Integer type
8-16 The maximum downlink buffer message total number for all
sockets created by AT+ECSOCR which is not configure as private
mode socket with the command "AT+ECSONMIE". The default value is
8
Example
AT+ECSONMI=2,1500,9
OK
3.6.13 AT+ECSONMIE
The write command is used to set the unsolicited result code "+ECSONMI" to indicate arrived
messages of a specified socket, the default mode is 3 (If enable ref macro, the default mode is 1):
If <mode>=1, the UE will receive an unsolicited result code: "+ECSONMI: <socket>,<length>".
If <mode>=2, the UE will receive an unsolicited result code: "+ECSONMI: <socket>,<remote_ad
dr>,<remote_port>,<length>,<data>".
If <mode>=3, the UE will receive an unsolicited result code: "+ECSONMI: <socket>,<length>,<data>".
The read command returns the current setting of the command.
The write command is also used to set the max downlink buffer size and the max messages number
for the specified socket
AT+ECSONMIE
Set Command Response
AT+ECSONMIE=<socket_id>,<mode>[,<max_private_dl_bu OK
ffer>[,<max_private_dl_pkg_num>]] If there is any error,
response:
+CME ERROR: <err>
Test Command Response
AT+ECSONMIE=? +ECSONMIE: (list of supported
<socket_id>s), (list of
supported <mode>s), (list of
supported <
max_private_dl_buffer>),
( list of supported <
max_private_dl_pkg_num
>)
OK
Read Command Response
AT+ECSONMIE? [+ECSONMIE:
<socket_id>,<mode>,<
max_public_dl_buffer >,<max_
public_dl_pkg_num>]
[...]
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<MODE> INTEGER TYPE
Control downlink data format.
0 Disable indication messages unsolicited result code for the
specified socket.
1 Enable indication messages unsolicited result code for the
specified socket: "+ECSONMI: <socket_id>,<length>"
2 Enable indication messages unsolicited result code for the
specified socket: "+ECSONMI:
<socket_id>,<remote_addr>,<remote_port>,<length>,<data>
3 Enable indication messages unsolicited result code for the
specified socket: "+ECSONMI:<socket_id>,<length>,<data>"
255 reset the mode setting which configure by the command
"AT+ECSONMI" for the speceified socket
<SOCKET_ID> Integer type
<LENGTH>
<REMOTE_ADDR> 0-11 Socket Id returned by AT+ECSOCR
<REMOTE_PORT>
<DATA> Integer type
<MAX_PRIVATE_DL_BUFFER> 1-1358 Number of bytes of data in the first message
<MAX_PRIVATE_DL_PKG_NUM> string type
The remote IP address which the message is sent from
Integer type
0-65535 The remote port which the message if sent from
string type
Data received in hex string format. Maximum length of received
data is 1358 bytes
Integer type
1358-2048 The maximum downlink buffer size for the specified
socket. The default value is 1358
Integer type
1-8 The maximum downlink buffer message number for the
specified socket. The default value is 4
Example
AT+ECSONMIE=2,1500,6
OK
3.6.14 +ECSOCLI
This is an unsolicited message to notify that a socket has been closed. It returns the socket number
and error code
+ECSOCLI
+ECSOCLI: <socket_id>,<errno>
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
<ERRNO> Integer type Posix Errno defines
12 Out of memory error
105 No buffer space available
62 Timer expired
113 No route to host
115 Operation now in progress
22 Invalid argument
11 Operation would block
107 Transport endpoint is not connected
103 Software caused connection abort
104 Connection reset by peer
Example
+ECSOCLI:1,104
3.6.15 +ECSOSTR
This is an unsolicited message to notify that one uplink datagram sent status with sequence
+ECSOSTR
+ECSOSTR: <socket_id>,<sequence>,<status>
Parameter INTEGER TYPE
<SOCKET_ID> 0-11 Socket Id returned by AT+ECSOCR
<SEQUENCE>
Integer type
<STATUS>
1-255 If it is omitted, data sent will not be reported. If not omitted, when
datagram is sent over RF or is discarded, then the result will be
reported
Integer type
0 the sent status of datagram is fail
1 the sent status of datagram is success
Example
+ECSOSTR:1,101,1
3.6.16 +ECSOCO
This is an unsolicited message to notify that the TCP connection has connected success
+ECSOCO
+ECSOSO: <socket_id>
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
Example
AT+ECSOCO=1,"180.167.122.150",5002
OK
+ECSOCO:1
3.6.17 Error code for socket command(solution B)
Code of <err> Description
402 Parameter invalid
403 Too much socket instance
404 Create socket error
405 operation not supported
406 Cannot find the socket
407 Socket Connect fail
408 Socket bind fail
409 Send data fail
410 The socket status is not connected
411 The socket status is already connected
412 The socket status is invalid
413 The socket connect timeout
414 The socket close fail
415 The socket happen fatal error
416 Can not allocate more memory
417 No more DL buffer resource
418 The socket is connecting
419 UL sequence is invalid
420 Send request fail
421 Unknown error
3.7 Socket Command(TCP Server Mode)
3.7.1 AT+ECSRVSOCRTCP
The command creates a TCP server socket on the UE and associates with specified protocol. If the
TCP server socket create success, "+ECSRVSOCCRTCP" unsolicited messages with "socket_id" will
appear.
The TCP server socket can accept no more than three TCP clients, and the total number of TCP
server and TCP client must be not bigger than nine.
If the remote TCP client connect the TCP server success, "+ECACCEPTTCPCLIENTSOCKET"
unsolicited messages will appear with the TCP client information.
If the TCP server socket create repeatly, It will notify that the TCP server socket has create with the
URC "+ECSRVSOCCRTCP".
AT+ECRVSOCRTCP
Set Command Response
AT+ECSRVSOCRTCP=<listen_port>[,<af_type>[,<ip_address>] OK
] +ECSRVSOCRTCP:
<socket_id>,OK
,OK
If there is any error,
response:
+CME ERROR: <err>
Test Command Response
AT+ECSRVSOCRTCP=? +ECSRVSOCRTCP: (list
of supported
<listen_port>), (list
of supported<
af_type>),(<ip_addr>
)
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<LISTEN_PORT> INTEGER TYPE
A number in the range of 10000-10015. This is the local port that will be
included in sent messages and on which port will the TCP client connect.
<AF_TYPE> String type
AF_INET the default value. IPv4
AF_INET6 IPv6
<IP_ADDRESS> String type
IP address. The IP address of the network assigned to UE.
<SOCKET_ID> Integer type
0-11 A maximum of 5 sockets are supported, but other serviced may
reduce this number.
Example
AT+ECSRVSOCRTCP=10001,"AF_INET"
OK
+ECSRVSOCRTCP: 1,OK
AT+ECSOCR="STREAM",6,10002,1,"AF_INET"
2
OK
AT+ECSOCO=2,"127.0.0.1",10001
OK
+ECSOCO: 2
+ECACCEPTTCPCLIENTSOCKET:1,3,127.0.0.1,10002
3.7.2 AT+ECSRVSOCLTCPLISTEN
The command close a TCP server socket on the UE. When the TCP server socket close, the TCP
clients which accept by the TCP server will be close auto.
AT+ ECSRVSOCLTCPLISTEN
Set Command Response
AT+ECSRVSOCLTCPLISTEN=<socket_id> OK
If there is any error,
response:
+CME ERROR: <err>
Test Command Response
AT+ECSRVSOCLTCPLISTEN=? +ECSRVSOCLTCPLISTEN:
(list of supported
<socket_id>)
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 A maximum of 12 sockets are supported, but other serviced may
reduce this number.
Example
AT+ECSRVSOCRTCP=10001,"AF_INET"
OK
+ECSRVSOCRTCP: 1,OK
AT+ECSRVSOCLTCPLISTEN=1
OK
3.7.3 AT+ECSRVSOCLTCPCLIENT
The command close a TCP client connection which accept by TCP server socket.
If the command contain the parameter of "client_socket_id", it just close one TCP client connection.
If the command did not contain the parameter of "client_socket_id", it just close all TCP client
connections which accept by the TCP server.
AT+ ECSRVSOCLTCPCLIENT
Set Command Response
AT+ECSRVSOCLTCPLISTEN=<server_socket_id>[,<client_socke OK
t_id>] If there is any error,
response:
+CME ERROR: <err>
Test Command Response
AT+ECSRVSOCLTCPCLIENT=? +ECSRVSOCLTCPCLIEN
T: (list of supported
<server_socket_id>
), (list of supported
<client_socket_id>
)
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<SERVER_SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSRVSOCRTCP
<CLIENT_SOCKET_ID> Integer type
0-11 Socket Id returned by +ECACCEPTTCPCLIENTSOCKET
Example
AT+ECSRVSOCLTCPCLIENT=1,3
OK
3.7.4 AT+ECSRVSOTCPSENDCLT
Send a containing length bytes of data to the TCP client connection which accept by the TCP server
socket.
AT+ECSRVSOTCPSENDCLT Response
OK
Set Command If there is any error, response:
AT+ECSRVSOTCPSENDCLT=<socket_id>,<data +CME ERROR: <err>
len>,<data>[,<rai info>[,<except Response
info>]] +ECSRVSOTCPSENDCLT: (list of supported
Test Command <socket_id>s), (list of supported <data
AT+ECSRVSOTCPSENDCLT=? len>s), (<data>), (list of supported <rai
info>s), (list of supported <expect info>s)
Maximum Response Time OK
5s
Parameter Saving Mode NO_SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by +ECACCEPTTCPCLIENTSOCKET
<DATA LEN> Integer type
length of data in hex string format, the max length is 1400
<DATA> Integer type
Data in hex string
<RAI INFO> Integer type (option)
0-2 release assistance indication
0 no rai info
1 no further uplink or downlink data transmission subsequent to the uplink
data transmission subsequent to the uplink data transmission is
expected
2 only a single downlink data transmission and no further uplink data
transmission subsequent to the uplink data transmission is expected
Note: default value: 0
<EXCEPT Integer type (option)
INFO> 0-1 expect data indication
0 disable expect data indication
1 enable expect data indication
Note: default value: 0
Example
Send data:23456
AT+ECSRVSOTCPSENDCLT=0,5,3233343536
OK
3.7.5 AT+ECSRVSOTCPSENDCLTT
Send a containing length bytes of data with transparent mode to the TCP client connection which accept
by the TCP server socket.
If the command contain the parameter of "data_len", It need input enough data with hex string
format after ">" output. If the command did not contain the parameter of "date_len", the input of data
must end with "CTRL+Z".
AT+ECSRVSOTCPSENDCLT
Set Command Response
AT+ECSRVSOTCPSENDCLT=<socket_id>[,<data OK
len>[,<rai info>[,<except info>]]] If there is any error, response:
+CME ERROR: <err>
Test Command Response
AT+ECSRVSOTCPSENDCLT=? +ECSRVSOTCPSENDCLT: (list of supported
<socket_id>s), (list of supported <data
Maximum Response Time len>s)(list of supported <rai info>s), (list of
Parameter Saving Mode supported <expect info>s)
OK
5s
NO_SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by +ECACCEPTTCPCLIENTSOCKET
<DATA LEN> Integer type
length of data in hex string format, the max length is 1400
<DATA> Integer type
Data in hex string
<RAI INFO> Integer type (option)
0-2 release assistance indication
0 no rai info
1 no further uplink or downlink data transmission subsequent to the uplink
data transmission subsequent to the uplink data transmission is
expected
2 only a single downlink data transmission and no further uplink data
transmission subsequent to the uplink data transmission is expected
Note: default value: 0
<EXCEPT Integer type (option)
INFO> 0-1 expect data indication
0 disable expect data indication
1 enable expect data indication
Note: default value: 0
Example
Send data:23456
AT+ECSRVSOTCPSENDCLT=1,5
>3233343536
OK
AT+ECSRVSOTCPSENDCLT=1
>3233343536
1A
OK
3.7.6 AT+ECSRVSOTCPLISTENSTATUS
The command query the TCP server socket status.
If the command contain the parameter of "socket_id", it will return the TCP socket status by the URC
"+ECSRVSOTCPLISTENSTATUS".
AT+ ECSRVSOTCPLISTENSTATUS
Set Command Response
AT+ECSRVSOTCPLISTENSTATUS=<socket_id> +ECSRVSOTCPLISTENSTATUS:
<socket_id>,<status>
OK
If there is any error,
response:
+CME ERROR: <err>
Test Command Response
AT+ECSRVSOTCPLISTENSTATUS=? +ECSRVSOTCPLISTENSTATUS:
(list of supported
<socket_id>)
OK
Read Command Response
AT+ECSRVSOTCPLISTENSTATUS? +ECSRVSOTCPLISTENSTATUS:
<socket_id>,<status>
OK
Maximum Response Time 5s
Parameter Saving Mode SAVE
Parameter
<SOCKET_ID> INTEGER TYPE
0-11 A maximum of 12 sockets are supported, but other serviced may
reduce this number.
<STATUS> string
Listening the TCP server socket is listening
Not Listening the TCP server socket is not listening
Example
AT+ECSRVSOTCPLISTENSTATUS=1
+ECSRVSOTCPLISTENSTATUS: 1,Listening
OK
3.7.7 +ECACCEPTTCPCLIENTSOCKET
This is an unsolicited message to notify that one TCP client is accepted by TCP server
+ECACCEPTTCPCLIENTSOCKET
+ECACCEPTTCPCLIENTSOCKET:
<server_socket_id>,<client_socket_id>,<client_ip_addr>,<client_port>
Parameter INTEGER TYPE
<SERVER_SOCKET_ID> 0-11 Socket Id returned by AT+ECSRVSOCRTCP
<CLIENT_SOCKET_ID>
<CLIENT_IP_ADDR> Integer type
<CLIENT_PORT>
0-11 Socket Id returned by +ECACCEPTTCPCLIENTSOCKET
String type
The IP address of the TCP client
Integer type
1-65535 The port number of the TCP client
Example
AT+ECSRVSOCRTCP=10001,"AF_INET"
OK
+ECSRVSOCRTCP: 1,OK
AT+ECSOCR="STREAM",6,10002,1,"AF_INET"
2
OK
AT+ECSOCO=2,"127.0.0.1",10001
OK
+ECSOCO: 2
+ECACCEPTTCPCLIENTSOCKET:1,3,127.0.0.1,10002
3.7.8 +ECSRVSOTCPCLTRCV
This is an unsolicited message to notify that TCP server receive some packet from the TCP client
+ECSRVSOTCPCLTRCV
+ECSRVSOTCPCLTRCV: <client_socket_id>,<length>,<data>
Parameter INTEGER TYPE
<CLIENT_SOCKET_ID> 0-11 Socket Id returned by +ECACCEPTTCPCLIENTSOCKET
<LENGTH> Integer type
<DATA> 1-1358 The length of receiving data
Hex string type
The receiving data
Example
AT+ECSRVSOCRTCP=10001,"AF_INET"
OK
+ECSRVSOCRTCP: 1,OK
AT+ECSOCR="STREAM",6,10002,1,"AF_INET"
2
OK
AT+ECSOCO=2,"127.0.0.1",10001
OK
+ECSOCO: 2
+ECACCEPTTCPCLIENTSOCKET:1,3,127.0.0.1,10002
AT+ECSOSD=2,2,"1111"
2,2
OK
+ECSRVSOTCPCLTRCV:3,2,"1111"
3.7.9 +ECSRVSOCCLIENTCPCLOSE
This is an unsolicited message to notify that TCP client is closed
+ECSRVSOCCLIENTCPCLOSE
+ECSRVSOCCLIENTCPCLOSE: <client_socket_id>,<errno>
Parameter
<CLIENT_SOCKET_ID> INTEGER TYPE
0-11 Socket Id returned by AT+ECSOCR
<ERRNO> Integer type Posix Errno defines
12 Out of memory error
105 No buffer space available
62 Timer expired
113 No route to host
115 Operation now in progress
22 Invalid argument
11 Operation would block
107 Transport endpoint is not connected
103 Software caused connection abort
104 Connection reset by peer
Example
AT+ECSRVSOCRTCP=11111,"AF_INET"
OK
+ECSRVSOCRTCP: 1,OK
AT+ECSOCR="STREAM",6,22222,1,"AF_INET"
2
OK
AT+ECSOCO=2,"127.0.0.1",11111
OK
+ECSOCO: 2
+ECACCEPTTCPCLIENTSOCKET:1,3,127.0.0.1,22222
AT+ECSOCL=2
OK
+ECSRVSOCCLIENTCPCLOSE:3,107
3.8 FILE Commands
3.8.1 AT+FOPEN
This command is used to open a file, and gets a file handle
AT+FOPEN Response
Set Command
+FOPEN:<filehandle>
AT+FOPEN=<filename>[,<mode>]
OK
Test Command
If there is any error, response:
AT+FOPEN=?
ERROR
Response
+FOPEN:<filename>[,<mode>]
OK
If there is any error, response:
ERROR
Read Command Response
AT+FOPEN? +FOPEN:<filename>,
<filehandle>,<mode>,<size>
[+FOPEN:<filename>,
<filehandle>,<mode>,<size>
[...]]
Maximum Response Time OK
Parameter Saving Mode
If there is any error, response:
ERROR
5s
NO_SAVE
Parameter STRING TYPE
The name of the open file, with a maximum length of 80 bytes
<FILENAME> Integer type
<FILEHANDLE> The file handle
<MODE> Integer type
0 If the file does not exist, a new file will be created; If the file exists, open the
<SIZE> file directly. The files in both cases are readable and writable
1 If the file does not exist, a new file will be created; If the file exists, the file is
cleared and overwritten. The files in both cases are readable and writable
2 If the file exists, open the file and the file is only readable; If the file does not
exist, the response is incorrect
Integer type
file data length
3.8.2 AT+FREAD Response
This command is used to read data from file CONNECT <read_length>
AT+FREAD
Set Command <length>
OK
AT+FREAD=<filehandle>[,<length>]
If there is any error, response:
Test Command
ERROR
Response
AT+FREAD=? +FREAD:<filehandle>[,<length>]
Maximum Response Time OK
Parameter Saving Mode
If there is any error, response:
ERROR
5s
NO_SAVE
Parameter INTEGER TYPE
The file handle
<FILEHANDLE> Integer type
Expected file length to read
<LENGTH> Integer type
Actual read file length
<READ_LENGTH>
3.8.3 AT+FWRITE
This command is used to write data
AT+FWRITE Response
Set Command
CONNECT
AT+FWRITE=<filehandle>[,<length>[,<ti
meout>]] <length><timeout>
+FWRITE
<written_length>,<total_length>
Test Command OK
AT+FWRITE=? If there is any error, response:
ERROR
Response
+FWRITE:<filehandle>[,<length>[,<tim
eout>]]
Maximum Response Time OK
Parameter Saving Mode
If there is any error, response:
ERROR
5s
NO_SAVE
Parameter INTEGER TYPE
The file handle
<FILEHANDLE> Integer type
<LENGTH> The expected length of the written file. The default maximum length is 10K
<TIMEOUT> Integer type
<WRITTEN_LENGTH> Waiting time for input data
<TOTAL_LENGTH> Integer type
Length of data actually written
Integer type
Total file length
3.8.4 AT+FSEEK
This command is used to set file pointer
AT+FSEEK Response
Set Command
OK
AT+FSEEK=<filehandle>,<offset>[,<position
>] If there is any error, response:
Test Command ERROR
AT+FSEEK=? Response
+FSEEK:
<filehandle>,<offset>[,<position
>]
OK
Maximum Response Time If there is any error, response:
Parameter Saving Mode
ERROR
5s
NO_SAVE
Parameter INTEGER TYPE
The file handle
<FILEHANDLE> Integer type
The offset of the file pointer from the initial position
<OFFSET> Integer type
<POSITION>
0 File initial location
1 Current location of file pointer
2 Final file location
3.8.5 AT+FPOSITION
This command is used to get file position offset
AT+FPOSITION Response
Set Command
+FPOSITION:<offset>
AT+FPOSITION=<filehandle>
Test Command OK
AT+FPOSITION=? If there is any error, response:
ERROR
Response
+FPOSITION:<filehandle>
Maximum Response Time OK
Parameter Saving Mode
If there is any error, response:
ERROR
5s
NO_SAVE
Parameter INTEGER TYPE
The file handle
<FILEHANDLE> Integer type
The offset of the file pointer from the initial position
<OFFSET>
3.8.6 AT+FTUCAT Response
This command is used to tucat a file OK
AT+FTUCAT
Set Command
AT+FTUCAT=<filehandle>
Test Command If there is any error, response:
AT+FTUCAT=? ERROR
Maximum Response Time Response
Parameter Saving Mode
+FTUCAT:<filehandle>
Parameter INTEGER TYPE OK
The file handle
<FILEHANDLE> If there is any error, response:
3.8.7 AT+FERASE ERROR
This command is used to erase a file 5s
NO_SAVE
AT+FERASE
Set Command Response
AT+FERASE=<filehandle> OK
Test Command If there is any error, response:
AT+FERASE=? ERROR
Maximum Response Time Response
Parameter Saving Mode
+FERASE:<filehandle>
OK
If there is any error, response:
ERROR
5s
NO_SAVE
Parameter INTEGER TYPE
The file handle
<FILEHANDLE>
3.8.8 AT+FRENAME Response
This command is used to rename a file OK
AT+FRENAME If there is any error, response:
Set Command
ERROR
AT+FRENAME=<filename>,<newfilename>
Response
Test Command
+FREAME:<filename>,<newfilename>
AT+FRENAME=? OK
Maximum Response Time If there is any error, response:
Parameter Saving Mode
ERROR
Parameter STRING TYPE
File name 5s
<FILENAME> String type NO_SAVE
New file name
<NEWFILENAME> Response
3.8.9 AT+FCLOSE OK
This command is used to close file If there is any error, response:
AT+FCLOSE ERROR
Set Command
Response
AT+FCLOSE=<filehandle>
+FCLOSE:<filehandle>
Test Command OK
AT+FCLOSE=?
Maximum Response Time If there is any error, response:
Parameter Saving Mode
ERROR
Parameter INTEGER TYPE
The file handle 5s
<FILEHANDLE> NO_SAVE
3.8.10 AT+FDELETE Response
This command is used to delete file OK
AT+FDELETE If there is any error, response:
Set Command
ERROR
AT+FDELETE=<filehandle>
Response
Test Command
+FDELETE:<filehandle>
AT+FDELETE=? OK
Maximum Response Time If there is any error, response:
Parameter Saving Mode
ERROR
5s
NO_SAVE
Parameter INTEGER TYPE
The file handle
<FILEHANDLE>
4 Error Values
If the AT command not implemented or format dose not match, it will output "ERROR".
For general control commands compliant with the 3Gpp specifications. Please refer to 3GPP
TS 27007 V14.5.0, sub-clause 9.2 for all possible <err> values. If an error occurs, it will output
"+CME ERROR: <err>". Some common values are listed in the table below.
General Errors(27.007) Description
MT not connection
Code of <err> MT link reserved
1 operation not allowed
2 operation not supported
3 PH-SIM PIN required
4 PH-FSIM PIN required
5 PH-FSIM PUK required
6 SIM not inserted
7 SIM PIN required
10 SIM PUK required
11 SIM failure
12
13
14 SIM busy
15 SIM wrong
16 incorrect password
17 SIM PIN2 required
18 SIM PUK2 required
20 memory full
21 invalid index
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 timeout
32 network not allowed - emergency call 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
49 EAP method not support
50 incorrect Parameters
51 command implemented but currently disabled
52 command aborted by user
53 not attached to network due to MT functionality restrictions
54 modem not allowed - MT restricted to emergency calls only
55 operation not allowed because of MT functionality restrictions
56 fixed dial number only allowed - called number is not a fixed
dial number
57 temporarily out of service due to other MT usage
58 language/alphabet not supported
59 unexpected data value
60 system failure
61 data missing
62 call barred
63 message waiting indication subscription failure
100 unknown
103 illegal MS
106 illegal ME
107 GPRS services not allowed
108 GPRS services and non GPRS services not allowed
111 PLMN not allowed
112 location area not allowed
113 roaming not allowed in this location area
114 GPRS services not allowed in this plmn
115 No suitable cells in location area
122 Congestion
126 Insufficient resources
127 Mission or unknown APN
128 Unknown PDP address or PDP type
129 User authentication failed
130 Active reject by GGSN services gw or PDN gw
131 Active reject unspecified
132 service option not supported
133 requested service option not subscribed
134 service option temporarily out of order
140 Feature not supported
141 Semantic errors in the TFT operation
142 Syntactical errors in the TFT operation
143 Unknown PDP context
144 Semantic errors in packet filters
145 Syntactical errors in packet filters
146 PDP context without TFT already activated
148 unspecified GPRS error
149 PDP authentication failure
150 invalid mobile class
171 Last PDN disconnection not allowed
172 Semantically incorrect message
173 Mandatory information element error
174 Information element non existent or not implemented
175 Conditional ie error
176 Protocol error unspecified
177 Operator determined barring
178 Max number of PDP contexts reached
179 Requested APN not supported in current rat and plmn
combination
180 Request rejected bearer control mode violation
181 Unsupported oci value
182 User data transmission via control plane is congested
301 Internal error base
302 UE busy
303 Not power on
304 PDN not active
305 PDN not valid
306 PDN invalid type
307 PDN no parameter
308 UE fail
309 PDN type and APN duplicate used
For general control commands compliant with 3GPP TS 27005. If an error occurs, it will output
"+CMS ERROR: <err>". Some common values are listed in the table below.
General Errors(27.005)
Code of <err> Description
300 ME failure
301 SMS service of ME reserved
302 operation not allowed
303 operation not supported
304 invalid PDU mode parameter
305 invalid text mode parameter
310 USIM not inserted
311 USIM PIN required
312 PH-(U)SIM PIN required
313 USIM failure
314 USIM busy
315 USIM wrong
316 USIM PUK required
317 USIM PIN2 required
318 USIM PUK2 required
320 memory failure
321 invalid memory index
322 memory full
330 SMSC address unknown
331 no network service
332 network timeout
340 no +CNMA acknowledgement expected
500 unknown error
Annex AChange history
Date Subject/Comment New Owner
version
2021-06-18 Initial 1.1
2021-11-24
2021-11-30 Add SSL configure parameter session cache 1.1
2021-12-02
2021-12-06 Add AT+ECNETCFG/AT+ECNETDEVCTL 1.1 xlhu
flxing
2021-12-13 Add PowerAttachWithIMSIPowerAttachWoEia in AT+ECCFG 1.1 fwang
2021-12-24
2021-12-24 Add EnableDataCounter in AT+ECCFG and AT+ECGDCNT / 1.1 wli
2022-01-08 hwang
2022-01-14 AT+ECAUGDCNT yjzhong
2022-01-14 xlhu
Add comment about auto baud feature for AT+IPR 1.1 wqzhao
2022-01-19 jcweng
Add AT+ECCMGR/AT+ECCMGS for concatenated SMS 1.1
2022-01-22 wli
2022-02-10 Change the http parameter contextid's range and default value 1.1
2022-02-11 hwang
2022-02-18 Add PIN2/PUK2 status and remaining retries query 1.1 xlhu
2022-02-18 flxing
Add ECLEDMODE for Netlight 1.1 hwang
2022-02-23 flxing
Update ECCFG: a) "Epco" default value set to 0, b) 1.1
2022-03-04 flxing
2022-3-22 "AttachEpsCid" range change to [1-15], and default value set
fwang
2022-03-31 to 1 flxing
2022-04-22
2022-04-28 Update ECPCFG, rename dumpToATPort to uartDumpPort to 1.1 yjzhong
yjzhong
2022-05-07 extend function hwang
2022-05-10 Add "UpdateLociCtrl" and "RoamService" in AT+ECCFG 1.1 flxing
2022-05-26 Add AT+CPOL and AT+CPLS 1.1 flxing
2022-06-16 Update AT+CMGS and AT+ECSMSSEND for PDU mode 1.1 yjzhong
2022-06-27
Add "SavePlmnSelMode" in AT+ECCFG 1.1 fwang
2022-07-18 fwang
Enable AT+CCIOTOPT set command 1.1
xlhu
Add AT+CSODCP/AT+CRTDCP
Update AT+CGDCONT for support Non-IP
Add "EmergencyCamp" in AT+ECCFG 1.1
Change default value of "PsSoftReset" to 1 in AT+ECCFG
Add ATO/ATH/ATD for PPP feature 1.1
Add comment for value 0 in AT+CCIOTOPT parameter 1.1
<support_UE_opt>
add HTTP URL format error 1.1
modify HTTP and SSL command's errors 1.1
Add AT+CSCB for selecting which types of Cell Broadcast 1.1
Messages are to be received
Modify AT+CIPCA=? 1.1
Modify AT+CPOL=?
Modify AT+CGACT? 1.1
Modify AT+CGDATA=?
Change SSL command's the range of supported <clientID>, 1.1
add transparent access mode
Delete invalid AT+CNMPSD command 1.1
Add AT&C/AT&D/AT+ECURCCFG 1.1
Update AT&F
Update AT&W
Add SIM slot selection by AT+ECSIMCFG="SimSlot",0/1 1.1
2022-07-25 Update "UpdateLociCtrl" in AT+ECCFG 1.1 hwang
fwang
2022-07-28 Expand AT+ECNETCFG to support set <pppauthselect> 1.2 fwang
hwang
2022-08-23 Modify the format of AT+ECURC set command 1.2 fwang
xlhu
2022-08-26 Add "ECSMSFULL" in AT+ECURC 1.2 eysun
2022-08-30 Add AT+ECSCLKEX 1.2
2022-09-26 Add SoftSIM selection by AT+ECSIMCFG="SoftSIM",0/1 1.2
2022-09-28 Add AT+ECCFG="WeakCellOpt" / "QRxLevMin" 1.2
Reference in New Issue View Git Blame Copy Permalink