SIMCom SIM7022 Command Manual
Below you will find brief information for SIM7022 Series SIM7022. This LPWA module supports network registration, signal quality reporting, and data transmission. It allows configuration of parameters via AT commands, including setting echo mode, displaying product identification, and managing network connections. The manual details commands for power saving, extended DRX, time zone reporting, and more, to optimize the module's functionality.
Advertisement
Advertisement
SIM7022 Series_
AT Command Manual
LPWA Module
SIMCom Wireless Solutions Limited
SIMCom Headquarters Building, Building 3, No. 289 Linhong
Road, Changning District, Shanghai P.R. China
Tel: 86-21-31575100 [email protected]
www.simcom.com
SIM7022 Series_AT Command Manual_V1.00
Document Title:
Version:
Date:
Status:
SIM7022 Series_AT Command Manual
1.00
2021.05.19
Released
GENERAL NOTES
SIMCOM OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS, TO SUPPORT
APPLICATION AND ENGINEERING EFFORTS THAT USE THE PRODUCTS DESIGNED BY SIMCOM.
THE INFORMATION PROVIDED IS BASED UPON REQUIREMENTS SPECIFICALLY PROVIDED TO
SIMCOM BY THE CUSTOMERS. SIMCOM HAS NOT UNDERTAKEN ANY INDEPENDENT SEARCH
FOR ADDITIONAL RELEVANT INFORMATION, INCLUDING ANY INFORMATION THAT MAY BE IN THE
CUSTOMER’S POSSESSION. FURTHERMORE, SYSTEM VALIDATION OF THIS PRODUCT
DESIGNED BY SIMCOM WITHIN A LARGER ELECTRONIC SYSTEM REMAINS THE RESPONSIBILITY
OF THE CUSTOMER OR THE CUSTOMER’S SYSTEM INTEGRATOR. ALL SPECIFICATIONS
SUPPLIED HEREIN ARE SUBJECT TO CHANGE.
COPYRIGHT
THIS DOCUMENT CONTAINS PROPRIETARY TECHNICAL INFORMATION WHICH IS THE PROPERTY
OF SIMCOM WIRELESS SOLUTIONS LIMITED COPYING, TO OTHERS AND USING THIS DOCUMENT,
ARE FORBIDDEN WITHOUT EXPRESS AUTHORITY BY SIMCOM. OFFENDERS ARE LIABLE TO THE
PAYMENT OF INDEMNIFICATIONS. ALL RIGHTS RESERVED BY SIMCOM IN THE PROPRIETARY
TECHNICAL INFORMATION ， INCLUDING BUT NOT LIMITED TO REGISTRATION GRANTING OF A
PATENT , A UTILITY MODEL OR DESIGN. ALL SPECIFICATION SUPPLIED HEREIN ARE SUBJECT TO
CHANGE WITHOUT NOTICE AT ANY TIME.
SIMCom Wireless Solutions Limited
SIMCom Headquarters Building, Building 3, No. 289 Linhong Road, Changning District, Shanghai P.R.
China
Tel: +86 21 31575100
Email: [email protected]
For more information, please visit: https://www.simcom.com/download/list-863-en.html
For technical support, or to report documentation errors, please visit: https://www.simcom.com/ask/ or email to: [email protected]
Copyright © 2021 SIMCom Wireless Solutions Limited All Rights Reserved.
www.simcom.com
2/194
Version History
Version Date
V1.00
Chapter
2021.05.19 All
SIM7022 Series_AT Command Manual_V1.00
What is new
New version www.simcom.com
3/194
SIM7022 Series_AT Command Manual_V1.00
Contents
Version History
3
Contents
4
1 Introduction
9
2 AT Commands According to V.25TER
.......................................................................................
14
2.1 Overview of AT Commands According to V.25TER
..................................................................................
2.2 Detailed Description of AT Commands According to V.25TER
..............................................................
3 AT Commands According to 3GPP TS 27.007
........................................................................
16
3.1 Overview of AT Command According to 3GPP TS 27.007
.....................................................................
3.2 Detailed Descriptions of AT Command According to 3GPP TS 27.007
................................................
www.simcom.com
4/194
SIM7022 Series_AT Command Manual_V1.00
3.2.29 +CGEV Used to Indicate EPS PDN Connection and Bearer Resources Operations Status
..........................................................................................................................................................................
56
3.2.41 AT+CMTLRA Mobile Terminated Location Request Disclosure Allowance ........................
3.2.49 AT+CGEQOSRDP EPS Quality of Service Read Dynamic Parameters .............................
4 AT Commands for General Commands
....................................................................................
88
www.simcom.com
5/194
SIM7022 Series_AT Command Manual_V1.00
4.2.17 AT$QCCESQS Controls the Extended Signal Quality Change Event Reporting ..........
4.2.26 AT$QCSIMSLEEP Set UE to Allow SIM Card Sleep for Power Consumption ..................
4.2.28 AT$QCSAVEFAC Saves Related Regions to Default Reliable Region ..............................
4.2.31 AT$QCTASKHISTINFO Shows Most Recent Tasks’ Scheduling History ..........................
www.simcom.com
6/194
SIM7022 Series_AT Command Manual_V1.00
5 AT Commands for Socket
128
6 AT Commands for Ocean Connect
..........................................................................................
143
6.2.2 AT+CTM2MSETMOD Sends Command to Set UE Working Mode ......................................
7 AT Commands for OneNET
153
7.2.1 AT+MIPLCONFIG Configure Bootstrap Server Address or Access Server Address ........
7.2.2 AT+MIPLCREATE Creates an Instance of Communication to CMIoT OneNET Platform 156
7.2.3 AT+MIPLDELETE Deletes a Specified OneNET Communication Instance ........................
7.2.6 AT+MIPLADDOBJ Add an Object from a Specified OneNET Communication Instance ..
7.2.7 AT+MIPLDELOBJ Deletes an Object from a Specified OneNET Communication Instance
.......................................................................................................................................................................
159
www.simcom.com
7/194
SIM7022 Series_AT Command Manual_V1.00
7.2.11 AT+MIPLEXECUTERSP Return the Execute Result to OneNET .......................................
7.2.12 AT+MIPLOBSERVERSP Return the Observe Result to OneNET ......................................
7.2.13 AT+MIPLDISCOVERRSP Return All Resources of Object ID Specified in
+MIPLDISCOVER ......................................................................................................................................
165
7.2.14 AT+MIPLPARAMETERRSP Return the Execute Result to OneNET .................................
7.2.21 +MIPLPARAMETER Represent Remote Parameter Command .........................................
8 AT Commands for MQTT
172
8.2.4 AT$QCMTCONN Send MQTT Subscribe Packet.
...................................................................
9 AT Commands for HTTP
183
10 Error Codes and Reset Reasons
...........................................................................................
189
www.simcom.com
8/194
SIM7022 Series_AT Command Manual_V1.00
1 Introduction
1.1 Scope of the document
This document presents the AT Command Set for SIMCom SIM7022 Series, including SIM7022.
1.2 Related documents
You can visit the SIMCom Website using the following link: http:// www.simcom.com
1.3 Conventions and abbreviations
In this document, the GSM engines are referred to as following term:
ME (Mobile Equipment);
MS (Mobile Station);
TA (Terminal Adapter);
DCE (Data Communication Equipment) or facsimile DCE (FAX modem, FAX board);
In application, controlling device controls the GSM engine by sending AT Command via its serial interface.
The controlling device at the other end of the serial line is referred to as following term:
TE (Terminal Equipment);
DTE (Data Terminal Equipment) or plainly "the application" which is running on an embedded system;
1.4 AT Command syntax
The "AT" or "at" or "aT" or "At" prefix must be set at the beginning of each Command line. To terminate a
Command line enter <CR> .
www.simcom.com
9/194
SIM7022 Series_AT Command Manual_V1.00
Commands are usually followed by a response that includes.
"<CR><LF><response><CR><LF>"
Throughout this document, only the responses are presented,< CR><LF> are omitted intentionally.
1.4.1 Basic syntax
These AT commands have the format of " AT <x><n> ", or " AT&<x><n> ", where " <x> "is the Command, and
" <n> "is/are the argument(s) for that Command. An example of this is " ATE <n> ", which tells the DCE whether received characters should be echoed back to the DTE according to the value of " <n> ". " <n> " is optional and a default will be used if missing.
1.4.2 S Parameter syntax
These AT commands have the format of " ATS <n> = <m> ", where " <n> " is the index of the S register to set, and " <m> " is the value to assign to it. " <m> " is optional; if it is missing, then a default value is assigned.
1.4.3 Extended Syntax
These commands can operate in several modes, as in the following table:
Table 1: Types of AT commands and responses
Test Command
AT+ <x> =?
Read Command
AT+ <x> ?
Write Command
AT+<x>=<…>
Execution Command
AT+<x>
The mobile equipment returns the list of parameters and value ranges set with the corresponding Write Command or by internal processes.
This command returns the currently set value of the parameter or parameters.
This command sets the user-definable parameter values.
The execution command reads non-variable parameters affected by internal processes in the GSM engine.
1.4.4 Combining AT commands on the same Command line
You can enter several AT commands on the same line. In this case, you do not need to type the " AT " or " at " prefix before every command. Instead, you only need type " AT " or " at " the beginning of the command line.
Please note to use a semicolon as the command delimiter after an extended command; in basic syntax or S parameter syntax, the semicolon need not enter, for example: www.simcom.com
10/194
SIM7022 Series_AT Command Manual_V1.00
ATE1Q0S0=1S3=13V1X4;+IFC=0,0;+IPR=115200.
The Command line buffer can accept a maximum of 559 characters(counted from the first command without "AT" or "at" prefix) or 39 AT commands. If the characters entered exceeded this number then none of the Command will executed and TA will return " ERROR ".
1.4.5 Entering successive AT commands on separate lines
When you need to enter a series of AT commands on separate lines, please Note that you need to wait the final response (for example OK, CME error, CMS error) of last AT Command you entered before you enter the next AT Command.
1.5 AT Command Responses
When the AT Command processor has finished processing a line it will output either OK, ERROR or an error code indicating that it is ready to accept a new command. Solicited informational responses are sent before the final OK or ERROR. Unsolicited information responses will never occur between a solicited informational response and the final OK or ERROR.
For AT Commands aligned to the 3GPP 27.007 specification error codes are enabled with the CMEE command, else the ERROR message will be returned. For AT Commands aligned to the 3GPP 27.005
specification, a CMS error will be returned where specified.
Responses will be of the format:
<CR><LF>+CMD1: <parameters><CR><LF>
<CR><LF>OK<CR><LF> or
<CR><LF><parameters><CR><LF>
<CR><LF>OK<CR><LF>
1.6 AT Command definitions
<CR> Carriage return character
<LF> Line feed character
<..> Parameter name. Angle brackets do not appear on command line
[..] Option parameter. Square brackets do not appear on the command line.
www.simcom.com
11/194
SIM7022 Series_AT Command Manual_V1.00
1.7 3GPP Alignment
3GPP commands area ligned to 3GPPTS27.007v14.3.0 (2017-03).Forclarificationon3GPPcommands,please refertothisdocument.
1.8 Supported character sets
The SIM7022 Series AT Command interface defaults to the IRA character set. The SIM7022 Series supports the following character sets:
UCS2
IRA
The character set affects transmission and reception of SMS and SMS Cell Broadcast messages, the entry and display of phone book entries text field and SIM Application Toolkit alpha strings.
1.9 Definitions
1.9.1 Parameter Saving Mode
For the purposes of the present document, the following syntactical definitions apply:
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 rebooted.
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 rebooted.
: "-" means this AT command doesn’t care the parameter saving mode.
1.9.2 Max Response Time
Max response time is estimated maximum time to get response, the unit is seconds.
www.simcom.com
12/194
SIM7022 Series_AT Command Manual_V1.00
"-" means this AT command doesn’t care the response time.
www.simcom.com
13/194
SIM7022 Series_AT Command Manual_V1.00
2 AT Commands According to
V.25TER
2.1 Overview of AT Commands According to V.25TER
Command
ATE
ATI
Description
Set Command Echo Mode.
Display Product Identification Information.
2.2 Detailed Description of AT Commands According to V.25TER
2.2.1 ATE Set Command Echo Mode
ATE Set Command Echo Mode
Execution Command
ATE<value>
Parameter Saving Mode
Response
This setting determines whether or not the TA echoes characters received from TE during Command state.
OK
NO_SAVE
Maximum Response Time
Reference V.25ter
Defined Values
<value> 0 Echo mode off
1 Echo mode on
Example
ATE0 www.simcom.com
14/194
SIM7022 Series_AT Command Manual_V1.00
OK
(ATE1)
OK
AT
OK
2.2.2 ATI Display Product Identification Information
ATIDisplay Product Identification Information
Response
TA issues product information text.
Execution Command
ATI
Example:
SIM7022 R2110
Parameter Saving Mode
Maximum Response Time -
OK
NO_SAVE
Reference V.25ter
Example
ATI
SIM7022 R2110
OK www.simcom.com
15/194
SIM7022 Series_AT Command Manual_V1.00
3 AT Commands According to 3GPP
TS 27.007
3.1 Overview of AT Command According to 3GPP TS 27.007
Command
AT+CGMI
AT+CGMM
AT+CGMR
AT+CGSN
AT+CREG
AT+CEREG
AT+CSCON
AT+CSQ
AT+CESQ
AT+CGPADDR
AT+COPS
AT+CGATT
AT+CGACT
AT+CIMI
AT+CGDCONT
AT+CFUN
AT+CMEE
AT+CCLK
AT+CPSMS
AT+CEDRXS
AT+CEER
AT+CEDRXRDP
AT+CTZR
AT+CTZU
AT+CIPCA
AT+CGAPNRC
AT+CSODCP
AT+CRTDCP
AT+CGEREP
+CGEV www.simcom.com
Description
Request Manufacturer Identification
Request Model Identification
Request TA Revision Identification of Software Release
Request Product Serial Number Identification
Network Registration
EPS Network Registration Status
Signalling connection status
Signal Quality Report
Get Extended Signal Quality
Show PDP Address
Operator Selection
Attach or Detach from GPRS Service
PDP Context Activate or Deactivate
Request International Mobile Subscriber Identity
Define PDP Context
Set Phone Functionality
Report Mobile Equipment Error
Return current date & time
Power Saving Mode Setting
Extended-DRX Setting
Extended Error Report eDRX Read Dynamic Parameters
Time Zone Reporting
Automatic Time Zone Update
Initial PDP context activation
APN rate control
Sending of originating data via the control plane
Reporting of terminating data via the control plane
Packet Domain Event Reporting
Used to Indicate EPS PDN Connection and Bearer Resources Operations
Status
16/194
AT+CGCONTRDP
AT+CGAUTH
AT+CPIN
AT+CLCK
AT+CMOLR
AT+CPWD
AT+CPINR
AT+CCHO
AT+CCHC
AT+CGLA
AT+CMTLR
AT+CMTLRA
AT+CRCES
AT+CRSM
AT+CSIM
AT+CGDATA
AT+CCIOTOPT
AT+CGCMOD
AT+CGEQOS
AT+CGEQOSRDP
AT+CGTFT
AT+IPR
SIM7022 Series_AT Command Manual_V1.00
PDP Context Read Dynamic Parameters
Define PDP Context Authentication Parameters
Enter PIN
Facility Lock
Mobile Originated Location Request
Change Password
Remaining PIN Retries
Open Logical Channel
Close logical channel
Generic UICC Logical Channel Access
Mobile Terminated Location Request Notification
Mobile Terminated Location Request Disclosure Allowance
Reading Coverage Enhancement Status
Restricted SIM Access
Generic SIM Access
Enter Data State
CIoT optimization configuration
PDP context modify
Define EPS quality of service
EPS Quality of Service Read Dynamic Parameters
Traffic flow template
Set UE Baud Rate
3.2 Detailed Descriptions of AT Command According to 3GPP TS 27.007
3.2.1 AT+CGMI Request Manufacturer Identification
AT+CGMI Request Manufacturer Identification
Test Command
Response
+CGMI: <manufacturer_ID>
AT+CGMI=?
OK
Response
<manufacturer>
Execution Command
AT+CGMI OK or
+CMEERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time www.simcom.com
17/194
SIM7022 Series_AT Command Manual_V1.00
Reference 3GPP TS 27.007 [13]
Defined Values
<manufacturer_ID> The ID of manufacturer the total number of characters, including line terminators, in the information text shall not exceed 2048 characters.
Text shall not contain the sequence 0<CR> or OK<CR>
3.2.2 AT+CGMM Request Model Identification
AT+CGMM Request Model Identification
Test Command
Response
+CGMM:<list of supported technologies>,<model>
AT+CGMM=?
OK
Response
<model>
Execution Command
AT+CGMM OK
If error is related to ME functionality:
+CMEERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
3GPP TS 27.007 [13]
Defined Values
<model> Product model identification text the total number of characters, including line terminators, in the information text shall not exceed 2048 characters.
Text shall not contain the sequence 0<CR> or OK<CR>
3.2.3 AT+CGMR Request TA Revision Identification of Software Release
AT+CGMR Request TA Revision Identification of Software Release
Test Command
AT+CGMR=?
Response
OK
Execution Command
AT+CGMR
Response
This command returns the manufacturer revision. The text is human readable www.simcom.com
18/194
SIM7022 Series_AT Command Manual_V1.00
and is not intended for microcontroller parsing.
By default this will return the firmware revision – release and build.
<revision>
+CMEERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
OK
If error is related to ME functionality:
Reference
3GPP TS 27.007 [13]
Defined Values
<revision> Product software version identification text.
The total number of characters, including line terminators, in the information text shall not exceed 2048 characters.
Text shall not contain the sequence 0<CR> or OK<CR>
NOTE
<revision> will change format over time. It should be treated as an opaque identifier.
SECURITY PROTOCOL and APPLICATION is the core version and will update with the firmware version.
RADIO is the specific module calibration parameter, if the module has been calibrated during the production line then we'd better not to change it during the next operation.
SSB second stage bootloader version.
3.2.4 AT+CGSN Request Product Serial Number Identification
AT+CGSN Request Product Serial Number Identification (Identical with +GSN)
Test Command
AT+CGSN=?
Response when TE supports <snt> and command successful:
+CGSN : (list of supported < snt >s)
Execution Command
AT+CGSN[=<snt>]
OK
Response when <snt>=0 (or omitted) and command successful:
[+CGSN:]<sn> when <snt>=1 and command successful:
+CGSN: <imei> www.simcom.com
19/194
SIM7022 Series_AT Command Manual_V1.00
Max Response Time
Reference
3GPP TS 27.007 [13] when <snt>=2 and command successful:
+CGSN: <imeisv> when <snt>=3 and command successful:
+CGSN: <svn> or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
-
Defined Values
< snt >
< sn >
< imei >
< imeisv >
< svn >
Integer type indicating the serial number type that has been requested.
0 returns <sn>
1 returns the IMEI (International Mobile station Equipment Identity)
2 returns the IMEISV (International Mobile station Equipment Identity and
Software Version number)
3 returns the SVN (Software Version Number)
The 128-bit UUID of the UE. The total number of characters, including line terminators, in the information text shall not exceed 2048 characters. Text shall notcontain the sequence 0<CR> or OK<CR> 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;
3.2.5 AT+CREG Network Registration
AT+CREG Network Registration
Test Command
Response
+CREG: ( list of supported <n> s )
AT+CREG=?
Read Command
AT+CREG?
OK
Response
+CREG:
<n>,<stat>[,[<tac>],[<ci>],[<AcT>][,<cause_type>,<reject_cause>]]
Write Command
OK
Response
OK www.simcom.com
20/194
SIM7022 Series_AT Command Manual_V1.00
AT+CREG=[<n>]
Parameter Saving Mode -
Max Response Time -
Reference or
ERROR
Defined Values
< n >
<
< stat tac
< ci >
>
>
< AcT > www.simcom.com
1
2 integer type
0 disable network registration unsolicited result code enable network registration unsolicited result code +CEREG: <stat> enable network registration and location information unsolicited resultcode
3
+CEREG: <stat>[,[<tac>],[<ci>],[<AcT>]] enable network registration, location information and EMM cause value information unsolicitedresultcode
+CEREG:
<stat>[,[<tac>],[<ci>],[<AcT>][,<cause_type>,<reject_cause>]]
Integer type; indicates the EPS registration status
0 not registered, MT is not currently searching for an operator to register to
1 registered, home network
2 not registered, but MT is currently trying to attach or searching for 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
9 registered for "CSFB not preferred", home network (not applicable)
10 registered for "CSFB not preferred", roaming (not applicable) string type; two byte tracking area code in hexadecimal format (e.g. "00C3" equals 195 in decimal) string type; four byte 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)
21/194
< cause_type >
< reject_cause >
SIM7022 Series_AT Command Manual_V1.00
7 E-UTRAN
8 EC-GSM-IoT (A/Gb mode) (see NOTE 5) (not applicable)
9 E-UTRAN (NB-S1 mode) (see NOTE 6)
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.
Integer type; contains the cause of the failed registration. The value is of type as defined by <cause_type>.
NOTE
Set of <n> will save to NVM, and the default value is 0.
3.2.6 AT+CEREG EPS Network Registration Status
AT+CEREG EPS Network Registration Status
Test Command
Response
+CEREG: ( list of supported <n> s )
AT+CEREG=?
Read Command
AT+CEREG?
OK
Response when <n>=0, 1, 2 or 3 and command successful:
+CEREG:
<n>,<stat>[,[<tac>],[<ci>],[<AcT>[,<cause_type>,<reject_cause>]]] when <n>=4 or 5 and command successful:
+CEREG:
<n>,<stat>[,[<lac>],[<ci>],[<AcT>],[<rac>][,[<cause_type>],[<reject_ca use>][,[<Active- Time>],[<Periodic-TAU>]]]]
Write Command
AT+CEREG=<n>
If error is related to wrong AT syntax or operation not allowed:
+CME ERROR: <err>
Response
OK or
ERROR
Parameter Saving Mode -
Max Response Time -
Reference www.simcom.com
22/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
< n >
<
< stat tac
< ci >
>
>
< AcT > www.simcom.com
integer type
0 disable network registration unsolicited result code
1 enable network registration unsolicited result code +CEREG: <stat>
2 enable network registration and location information unsolicited resultcode
+CEREG: <stat>[,[<tac>],[<ci>],[<AcT>]]
3 enable network registration, location information and EMM cause value information unsolicitedresultcode
+CEREG:
<stat>[,[<tac>],[<ci>],[<AcT>][,<cause_type>,<reject_cause>]]
4 For a UE that wants to apply PSM, enable network registration and location information unsolicited resultcode
+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 resultcode
+CEREG:
<stat>[,[<tac>],[<ci>],[<AcT>][,[<cause_type>],[<reject_cause>][,[<Activ e-Time>],[<Periodic-TAU>]]]]
Integer type; indicates the EPS registration status
0 not registered, MT is not currently searching for an operator to register to
1 registered, home network
2 not registered, but MT is currently trying to attach or searching for 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
9 registered for "CSFB not preferred", home network (not applicable)
10 registered for "CSFB not preferred", roaming (not applicable) string type; two byte tracking area code in hexadecimal format (e.g. "00C3" equals 195 in decimal) string type; four byte 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)
23/194
< cause_type >
< reject_cause >
< Active-Time >
< Periodic-TAU >
SIM7022 Series_AT Command Manual_V1.00
7 E-UTRAN
8 EC-GSM-IoT (A/Gb mode) (see NOTE 5) (not applicable)
9 E-UTRAN (NB-S1 mode) (see NOTE 6)
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.
Integer type; contains the cause of the failed registration. The value is of type as defined by <cause_type>.
String type; one byte in an 8 bit format. Indicates the Active Time value
(T3324) allocated to the UE in E-UTRAN. The Active Time value is coded as one byte (octet 3) of the GPRS Timer 2 information element coded as bit format (e.g. "00100100" equals 4 minutes). For the coding and the value range, see the GPRS Timer 2 IE in 3GPP TS 24.008 Table 10.5.163/3GPP TS
24.008. See also 3GPP TS 23.682 and 3GPP TS 23.401
String type; one byte in an 8 bit format. Indicates the extended periodic TAU value (T3412) allocated to the UE in E-UTRAN. The extended periodic TAU value is coded as one byte (octet 3) of the GPRS Timer 3 information element coded as bit format (e.g. "01000111" equals 70 hours). For the coding and the value range, see the GPRS Timer 3 IE in 3GPP TS 24.008 Table
10.5.163a/3GPP TS 24.008. See also 3GPP TS 23.682 and 3GPP TS 23.401
NOTE
NOTE 1: If the EPS MT in GERAN/UTRAN/E-UTRAN also supports circuit mode services and/or
GPRS services, the +CREG command and +CREG: result codes and/or the +CGREG command and +CGREG: result codes apply to the registration status and location information for those services.
NOTE 2: 3GPP TS 24.008 and 3GPP TS 24.301 specify the condition when the MS is considered as attached for emergency bearer services.
NOTE 3: 3GPP TS 44.060 specifies the System Information messages which give the information about whether the serving cell supports EGPRS.
NOTE 4: 3GPP TS 25.331 specifies the System Information blocks which give the information about whether the serving cell supports HSDPA or HSUPA.
NOTE 5: 3GPP TS 44.018 [156] specifies the EC-SCH INFORMATION message which, if present, indicates that the serving cell supports EC-GSM-IoT.
NOTE 6: 3GPP TS 36.331 [86] specifies the System Information blocks which give the information about whether the serving cell supports NB-IoT, which corresponds to E-UTRAN (NB-S1 mode).
3.2.7 AT+CSCON Signalling Connection Status
AT+CSCON Signalling Connection Status
Test Command Response www.simcom.com
24/194
SIM7022 Series_AT Command Manual_V1.00
AT+CSCON=?
+CSCON: ( list of supported <n> s )
Read Command
OK
Response
+CSCON: <n>,<mode>[,<state>]
AT+CSCON?
Write Command
AT+CSCON=<n>
OK
Response
Sets which character set <n> are used by the TE. The TA can then convert character strings correctly between the TE and ME character sets.
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
3GPP TS 27.007 [13]
Defined Values
< n >
< mode >
< state >
< access >
Integer type
0 disable unsolicited result code
1 enable unsolicited result code +CSCON: <mode>
Integer type; indicates the signalling connection status
0 idle
1 connected
2-255 <reserved for future use>
2
3
4
0
1
Integer type; indicates the CS or PS state while in GERAN and the RRC state information if the MT is in connected Mode while in UTRAN and E-UTRAN.
UTRAN URA_PCH state
UTRAN Cell_PCH state
UTRAN Cell_FACH state
UTRAN Cell_DCH state
GERAN CS connected state
0
1
2
3
4
5
6
GERAN PS connected state
GERAN CS and PS connected state
7 E-UTRAN connected state
Integer type; indicates the current radio access type.
Indicates usage of radio access of type GERAN
Indicates usage of radio access of type UTRAN TDD
Indicates usage of radio access of type UTRAN FDD
Indicates usage of radio access of type E-UTRAN TDD
Indicates usage of radio access of type E-UTRAN FDD www.simcom.com
25/194
SIM7022 Series_AT Command Manual_V1.00
3.2.8 AT+CSQ Signal Quality Report
AT+CSQ Signal Quality Report
Test Command
Response
+CSQ: ( list of supported <rssi> s ),( list of supported <ber> s )
AT+CSQ=?
OK
Response
Execution command returns received signal strength indication <rssi> and
Execution Command channel bit error rate <ber> from the MT.
+CSQ: <rssi>,<ber>
AT+CSQ
OK
If error is related to ME functionality:
+CME ERROR: <err >
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference 3GPP TS 27.007 [13]
Defined Values
<rssi>
<ber>
0 - 113 dBm or less
1 - 111 dBm
2...30
- 109... - 53 dBm
31 - 51 dBm or greater
99 not known or not detectable integer type; channel bit error rate (in percent)
0...7 as RXQUAL values (refer to 3GPP specification)
99 Not known or not detectable
3.2.9 AT+CESQ Get Extended Signal Quality
AT+CESQ Get Extended Signal Quality
Test Command
AT+CESQ=?
Response
+CESQ: (list of supported < rxlev >s),(list of supported < ber >s, list of supported < rscp >s),(list of supported < ecno >s,(list of supported
< rsrq >s),(list of supported < rsrp >s)
Execution Command www.simcom.com
OK
Response
26/194
SIM7022 Series_AT Command Manual_V1.00
AT+CESQ +CESQ:
<rxlev>,<ber>,<rscp>,<ecno>,<rsrq>,<rsrp>
OK
Max Response Time
Reference
If error is related to ME functionality:
+CME ERROR: <err >
Parameter Saving Mode NO_SAVE
-
Defined Values
<rxlev>
<ber>
<rscp>
<ecno>
<rsrq>
<rsrp>
Integer type; not supported by NB-IoT
99 not known or not detectable
Integer type; not supported by NB-IoT
99 not known or not detectable
Integer type; not supported by NB-IoT
255 not known or not detectable
Integer type; not supported by NB-IoT
255 not known or not detectable
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
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
3.2.10 AT+CGPADDR Show PDP Address
AT+CGPADDR Show PDP Address
Test Command
AT+CGPADDR=?
Response
+CGPADDR: ( list of defined <cid> s ) www.simcom.com
27/194
SIM7022 Series_AT Command Manual_V1.00
OK or
OK
Response
+CGPADDR: <cid>[,<PDP_addr>][<CR><LF>+CGPADDR:
<cid>[,<PDP_addr>][…]]
Write Command
AT+CGPADDR[=<cid>[
,<cid>[,…]]]
[+CGPADDR:
<cid>[,<PDP_addr_1>[,<PDP_addr_2>]]][<CR><LF>+CGPADDR:
<cid>,[<PDP_addr_1>[,<PDP_addr_2>]]
[...]]
OK or
OK or
ERROR
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<cid>
<PDP_addr>
< cid >
< PDP_addr_1 > and
< PDP_addr_2 >
A numeric parameter which specifies a particular PDP context definition (see
+CGDCONT command). If no <cid> is specified, the addresses for all defined contexts are returned.
A string that identifies the MT in the address space applicable to the PDP. The address may be static or dynamic.
For a static address, it will be the one set by the +CGDCONT command when the context was defined.
For a dynamic address, it will be the one assigned during the last PDP context activation that used the context definition referred to by
<cid>.<PDP_address> is omitted if none is available.
Integer type; specifies a particular PDP context definition (see the
+CGDCONT command).
Each is a string type that identifies the MT in the address space applicable to the PDP. The address may be static or dynamic. For a static address, it will be the one set by the +CGDCONT command when the context was defined. For a dynamic address it will be the one assigned during the last PDP context activation that used the context definition referred to by <cid>. 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
IPv6addresses are assigned, with <PDP_addr_1> containing the IPv4 www.simcom.com
28/194
SIM7022 Series_AT Command Manual_V1.00
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.
When +CGPIAF is supported, its settings can influence the format of the IPv6 address in parameter <PDP_addr_1> or <PDP_addr_2> returned with the execute form of +CGPADDR.
NOTE
In dual-stack terminals (<PDP_type> IPV4V6), the IPv6 address will be provided in<PDP_addr_2>. For terminals with a single IPv6 stack (<PDP_type> IPv6) or due to backwardscompatibility, the IPv6 address can be provided in parameter <PDP_addr_1>.
3.2.11 AT+COPS Operator Selection
AT+COPS Operator Selection
Response
TA returns a list of quadruplets, each representing an operator present in the network. 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 SIM, and other networks.
Test Command
AT+COPS=?
+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 error is related to ME functionality:
+CME ERROR: <err>
Response
TA returns the current mode and the currently selected operator. If no operator is selected, <format> and <oper> are omitted.
+COPS: <mode>[,<format>,<oper>][,<AcT>] Read Command
AT+COPS?
Write Command
AT+COPS=<mode>,[<f ormat>[,<oper>[,<AcT
>]]]
OK
If error is related to ME functionality:
+CME ERROR: <err>
Response
TA forces an attempt to select and register the GSM network operator. If the selected operator is not available, no other operator shall be selected
(except <mode>=4). The selected operator name format shall apply to www.simcom.com
29/194
SIM7022 Series_AT Command Manual_V1.00
further read commands (AT+COPS?).
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time
OK
If error is related to ME functionality:
Test command: 45 seconds
Write command: 120 seconds
Reference
3GPP TS 27.007 [14]
Defined Values
<stat>
<oper>
<mode>
<format>
< Act > www.simcom.com
Integer type
0 Unknown
1 Operator available
2 Operator current
3 Operator forbidden
String type; <format> indicates if the format is alphanumeric or numeric; long alphanumeric format can be upto 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 Automatic mode; <oper> field is ignored
1 Manual(<oper>fieldshall bepresent, and <AcT> optionally)
2 Manual deregister from network
3 Set only <format> (for read Command +COPS?) - not shown in Read
Command response
4Manual/automatic(<oper>field shallbe present); if manual selection fails, automatic mode (<mode>=0) is entered
Integer type
0 Long format alphanumeric <oper>
1 Short format alphanumeric <oper>
2 Numeric <oper>
Integer type; access technology selected
0 GSM
1 GSM Compact
2 UTRAN
3 GSM w/EGPRS (see NOTE 1)
4 UTRAN w/HSDPA (see NOTE 2)
5 UTRAN w/HSUPA (see NOTE 2)
6 UTRAN w/HSDPA and HSUPA (see NOTE 2)
30/194
SIM7022 Series_AT Command Manual_V1.00
7 E-UTRAN
8 EC-GSM-IoT (A/Gb mode) (see NOTE 3)
9 E-UTRAN (NB-S1 mode) (see NOTE 4)
NOTE
NOTE 1: 3GPP TS 44.060 specifies the System Information messages which give the information about whether the serving cell supports EGPRS.
NOTE 2: 3GPP TS 25.331 specifies the System Information blocks which give the information about whether the serving cell supports HSDPA or HSUPA.
NOTE 3: 3GPP TS 44.018 [156] specifies the EC-SCH INFORMATION message which, if present, indicates that the serving cell supports EC-GSM-IoT.
NOTE 4: 3GPP TS 36.331 [86] specifies the System Information blocks which give the information about whether the serving cell supports NB-IoT, which corresponds to E-UTRAN(NB-S1 mode).
<Act>, if provided, must be set to 9
Only <format>=2 is supported
Only <mode>=0, <mode>=1 &<mode>=2 are supported
When <mode>=1 is used, the PLMN setting will not persist after the UE is rebooted
<mode>=1 is only for development use. <mode>=0 should be used in production, which the mode used when AUTOCONNECT is enabled.
The test command currently returns the configured values rather than performing a PLMN search.
Not return <ACT> for AT+COPS?
<oper> field couldn’t be present when <mode>=0;
AT+COPS=? will start background PLMN search when MT is idle state and wait searching result, other state will return ERROR.
Return the searched PLMN list in the network after searching.
And could be aborted by any characters when searching. See Chapter 9 for more details about abort.
3.2.12 AT+CGATT Attach or Detach from GPRS Service
AT+CGATT Attach or Detach from GPRS Service
Description
The execution command is used to attach the MT to, or detach the MT from, the Packet Domain service. After the command has completed, the MT remains in V.250 command state. 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, an ERROR or +CME ERROR response is returned.Refer to Chapter 9: Error Values for possible <err> values.
NOTE 1: If the initial PDP context is supported, the context with <cid>=0 is automatically defined at startup.
www.simcom.com
31/194
SIM7022 Series_AT Command Manual_V1.00
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.
NOTE 2: This command has the characteristics of both the V.250 action and parameter commands.
Test Command
Hence it has the read form in addition to the execution/set and test forms.
Response
+CGATT: ( list of supported <state> s )
AT+CGATT=?
Read Command
OK
Response
+CGATT: <state>
AT+CGATT?
OK
Response
Write Command
AT+CGATT=<state>
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
75 seconds
Defined Values
<state> Integer type; indicates the state of PDP context activation. The default value is manufacturer specific
0 Detached
1 Attached
Other values are reserved and will result in an ERROR response to the Write
Command.
NOTE
When <state>=1 is selected, +COPS=0 is automatically selected.
If a CGATT is in progress, further execution of the CGATT=command prior to the attach or detach completing will return error.
www.simcom.com
32/194
SIM7022 Series_AT Command Manual_V1.00
3.2.13 AT+CGACT PDP Context Activate or Deactivate
AT+CGACT PDP Context Activate or Deactivate
The execution command is used to activate or deactivate the specified PDP context (s). After the command has completed, the MT remains in V.250
command state. If any PDP context is already in the requested state, the state for that context remains unchanged. If the requested state for any specified context cannot be achieved, an ERROR or +CME ERROR response is returned. Extended error responses are enabled by the +CMEE command. 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 fails then the MT responds with ERROR or, if extended error responses are enabled, with the appropriate failure-to-attach error message. Refer to Chapter 9: Error
Values for possible <err> values.
For EPS, if an attempt is made to disconnect the last PDN connection, then the MT responds with ERROR or, if extended error responses are enabled, a +CME ERROR.
Description
Test Command
AT+CGACT=?
Read Command
AT+CGACT?
www.simcom.com
NOTE: If the initial PDP context is supported, the context with <cid>=0 is automatically defined at startup, see subclause 10.1.0.
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.
If no <cid>s are specified the activation form of the command activates all defined non-emergency contexts.
If no <cid>s are specified the deactivation form of the command deactivates all active contexts.
The read command returns the current activation states for all the defined
PDP contexts.
The test command is used for requesting information on the supported PDP context activation states.
NOTE. This command has the characteristics of both the V.250 action and parameter commands.
Hence it has the read form in addition to the execution/set and test forms.
Response
+CGACT: ( list of supported <state> s )
OK
Response
+CGACT: <cid>,<state>[<CR><LF>+CGACT: <cid>,<state>…]
OK
33/194
SIM7022 Series_AT Command Manual_V1.00
Write Command
AT+CGACT=<state>[,< cid>]
Response
OK
If error is related to ME functionality:
+CME ERROR:<err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
150 seconds
Defined Values
<state>
<cid>
Indicates the state of PDP context activation
0 Deactivated
1 Activated
Other values are reserved and will result in an ERROR response tothe Write
Command.
A numeric parameter which specifies a particular PDP context definition (see
+CGDCONT Command). If the <cid> is omitted, it only affects the first cid.
NOTE
Could only activate or deactivate one cid one time.
Could not be executed when PLMN searching, attaching or detaching.
Could disconnect the last PDN connection when MT and Core Network all support without PDN connection.
3.2.14 AT+CIMI Request International Mobile Subscriber Identity
AT+CIMI Request International Mobile Subscriber Identity
Description
Execution command causes the TA to return <IMSI>, which is intended to permit the TE to identify theindividual SIM card or active application in the
UICC (GSM or USIM) which is attached to MT.
Test Command
AT+CIMI=?
Response
OK
Response
TA returns <IMSI>for identifying the individual SIM which is attached to ME.
<IMSI>
Execution Command
AT+CIMI OK
If error is related to ME functionality:
+CME ERROR: <err> www.simcom.com
34/194
SIM7022 Series_AT Command Manual_V1.00
Parameter Saving Mode NO_SAVE
Max Response Time 20s
Reference
3GPP TS 27.007 [13]
Defined Values
<IMSI> International Mobile Subscriber Identity (string without double quotes)
NOTE
IMSI may not be displayed for a few seconds after power-on
3.2.15 AT+CGDCONT Define PDP Context
AT+CGDCONT Define PDP Context
The set command specifies PDP context parameter values for a PDP context identified by the (local) context identification parameter, <cid> and 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.
Refer to Chapter 9: Error Values for possible <err> values.
Description
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.
If the initial PDP context is supported, the context with <cid>=0 is automatically defined at startup, see 3GPP TS 27.007 V13.5.0, subclause
10.1.0. As all other contexts, the parameters for <cid>=0 can be modified with +CGDCONT. If the initial PDP context is supported, +CGDCONT=0 resets context number 0 to its particular default settings.
The read command returns the current settings for each defined context.
The test command returns values supported as compound values. If the MT www.simcom.com
35/194
SIM7022 Series_AT Command Manual_V1.00
Test Command
AT+CGDCONT=?
Read Command
AT+CGDCONT?
supports several PDP types, <PDP_type>, the parameter value ranges for each <PDP_type> are returned on a separate line.
Response
+CGDCONT: ( range of supported <cid>s),<PDP_type>,,,( list of supported <d_comp>s),( list of supported <h_comp>s),( list ofsupported <IPv4AddrAlloc>s),( list of supported <request_type>s),( list of supported <PCSCF_discovery>s),( list of supported <IM_CN_Signalling_Flag_Ind>s),( list ofsupported <NSLPI>s),( list of supported <securePCO>s),( list of supported <IPv4_MTU_discovery>s),( list of supported <Local_Addr_Ind>s),( list of supported <NonIP_MTU_discovery>s),( list of supported <Reliable_Data_Service>s)[<CR><LF>+CGDCONT: ( range of supported <cid>s),<PDP_type>,,,( list of supported <d_comp>s),( list of supported <h_comp>s),( list ofsupported <IPv4AddrAlloc>s),( list of supported <request_type>s),( list of supported <PCSCF_discovery>s),( list of supported <IM_CN_Signalling_Flag_Ind>s),( list ofsupported
<NSLPI>s),( list of supported <securePCO>s),( list of supported <IPv4_MTU_discovery>s),( list of supported <Local_Addr_Ind>s),( list of supported
<NonIP_MTU_discovery>s),( list of supported <Reliable_Data_Service>s)[...]]
OK
Response
[+CGDCONT:
<cid>,<PDP_type>,<APN>,<PDP_addr>,<d_comp>,<h_comp>[,<IPv4A ddrAlloc>[,<request_type>[,<PCSCF_discovery>[,<IM_CN_Signalling_
Flag_Ind>[,<NSLPI>[,<securePCO>[,<IPv4_MTU_discovery>[,<Local_
Addr_Ind>[,<Non-IP_MTU_discovery>[,<Reliable_Data_Service>]]]]]]]]]
]][<CR><LF>+CGDCONT:
<cid>,<PDP_type>,<APN>,<PDP_addr>,<d_comp>,<h_comp>[,<IPv4A ddrAlloc>[,<request_type>[,<PCSCF_discovery>[,<IM_CN_Signalling_
Flag_Ind>[,<NSLPI>[,<securePCO>[,<IPv4_MTU_discovery>[,<Local_
Addr_Ind>[,<Non-IP_MTU_discovery>[,<Reliable_Data_Service>]]]]]]]]]
]
[...]]
OK
Write Command
AT+CGDCONT=[<cid>[
,<PDP_type>[,<APN>[,
<PDP_addr>[,<d_com p>[,<h_comp>[,<IPv4A ddrA lloc>[,<request_type>[,
<P-CSCF_discovery>[,
Response
OK or
ERROR www.simcom.com
36/194
SIM7022 Series_AT Command Manual_V1.00
<IM_CN_Signalling_Fl ag_Ind>[,<NSLPI>[,<se curePCO>[,<IPv4_MTU
_discovery>][,<Local_
Addr_Ind>][,<Non-IP_
MTU_discovery>][,<Re liable_Data_Service>]]
]]]]]]]]]]]
Parameter Saving Mode AUTO_SAVE
Max Response Time -
Reference
Defined Values
< cid >
<
<
<
<
<
PDP_type
APN >
PDP_addr d_comp h_comp
>
>
>
> www.simcom.com
Integer type; specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values is returned by the test form of the command.
<cid> values of 0-10 are supported.
String type; specifies the type of packet data protocol. The default value is manufacturer specific.
X.25
ITU-T/CCITT X.25 layer 3 (Obsolete)
IP
IPV6
Internet Protocol (IETF STD 5 [103])
Internet Protocol, version 6
IPV4V6 Virtual<PDP_type> introduced to handle dual IP stack UE capability.
OSPIH Internet Hosted Octect Stream Protocol (Obsolete)
PPP Point to Point Protocol (IETF STD 51 [104])
NOTE 2: Only IP, IPV6 and IPV4V6 values are supported for EPS services.
NONIP None Ip
String type; a logical name that is used to select the GGSN or the external packet data network. If the value is null or omitted, then the subscription value will be requested.
String type; identifies the MT in the address space applicable to the PDP. This parameter can be left blank.
When +CGPIAF is supported, its settings can influence the format of this parameter returned with the read form of +CGDCONT.
NOTE 3: The value of this parameter is ignored with the set command. The
2
3
0
1 parameter is included in the set command for backwards compatibility reasons only.
Integer type; controls PDP data compression off on (manufacturer preferred compression)
V.42bis
V.44
Integer type; controls PDP header compression
0 off
37/194
SIM7022 Series_AT Command Manual_V1.00
<
<
<
>
<
IPv4AddrAlloc request_type
P-CSCF_discovery
NSLPI >
>
>
< IM_CN_Signalling_
Flag_Ind >
1
2
3 on (manufacturer preferred compression)
RFC 1144 [105] (applicable for SNDCP only)
RFC 2507 [107]
4 RFC 3095 [108] (applicable for PDCP only)
Integer type; controls how the MT/TA requests to get the IPv4 address information
0 IPv4 address allocation through NAS signalling
1 IPv4 address allocated through DHCP
Integer type; indicates the type of PDP context activation request for the PDP context, see 3GPP TS 24.301 (subclause 6.5.1.2) and 3GPP TS 24.008
subclause 10.5.6.17). If the initial PDP context is supported it is not allowed to assign <cid>=0 for emergency bearer services. According to 3GPP TS 24.008
(subclause 4.2.4.2.2 and subclause 4.2.5.1.4) and 3GPP TS 24.301
(subclause 5.2.2.3.3 and subclause 5.2.3.2.2), a separate PDP context must be established for emergency bearerservices.
NOTE 4: If the PDP context for emergency bearer services is the only activated context, only emergency calls are allowed, see 3GPP TS 23.401 subclause 4.3.12.9.
0 PDP context is for new PDP context establishment or for handover from a non-3GPP access network (how the MT decides whether the PDP context is for new PDP context establishment or for handover is implementation specific)
1 PDP context is for emergency bearer services
2 PDP context is for new PDP context establishment
3 PDP context is for handover from a non-3GPP access network
Integer type; influences how the MT/TA requests to get the P-CSCF address, see 3GPP TS 24.229 [89] annex B and annex L.
0 Preference of P-CSCF address discovery not influenced by +CGDCONT
1 Preference of P-CSCF address discovery through NAS signalling
2 Preference of P-CSCF address discovery through DHCP
Integer type; indicates to the network whether the PDP context is for IM CN subsystem-related signalling only or not.
0 UE indicates that the PDP context is not for IM CN subsystem-related signalling only
1 UE indicates that the PDP context is for IM CN subsystem-related signalling only
Integer type; indicates the NAS signalling 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 signalling low priority".
< securePCO >
3GPP TS 24.301 [83] and 3GPP TS 24.008 .
Integer type. Specifies if security protected transmission of PCO is requested or not www.simcom.com
38/194
SIM7022 Series_AT Command Manual_V1.00
< IPv4_MTU_discover y >
<
< very
<
Local_Addr_Ind
Non-IP_MTU_disco
Reliable_Data_Serv ice >
>
>
(applicable for EPS only)
0 Security protected transmission of PCO is not requested
1 Security protected transmission of PCO is requested
Integer type; influences how the MT/TA requests to get the IPv4 MTU size, see 3GPP TS 24.008 subclause 10.5.6.3.
0 Preference of IPv4 MTU size discovery not influenced by +CGDCONT
1Preference 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 (see 3GPP TS 24.301 [83] and 3GPP TS 24.008 [8] subclause 10.5.6.3).
0 indicates that the MS does not support local IP address in TFTs
1 indicates that the MS supports local IP address in TFTs
Integer type; influences how the MT/TA requests to get the Non-IP MTU size, see 3GPP TS 24.008 [8] subclause 10.5.6.3.
0 Preference of Non-IP MTU size discovery not influenced by
+CGDCONT
1 Preference of Non-IP MTU size discovery through NAS signalling
Integer type; indicates whether the UE is using Reliable Data Service for a
PDN connection or not, see 3GPP TS 24.301 [83] and 3GPP TS 24.008 [8] subclause 10.5.6.3.
0 Reliable Data Service is not being used for the PDN connection
1 Reliable Data Service is being used for the PDN connection
NOTE
Only <PDP_type>="IP","NONIP","IPV6","IPV4V6" are supported.
Only support +CGDCONT=<cid>,<PDP_type>,<APN>,,,,,,,,<NSLPI>,<securePCO>.
<cid> values of 0-10 are supported
Only <hcomp> and <dcomp> values of 0 are supported.
<cid> value of 7 can’t be set when bip is enabled.
The APN is a string of up to 63 characters.
3.2.16 AT+CFUN Set Phone Functionality
AT+CFUN Set Phone Functionality
Description
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.
Test Command
AT+CFUN=?
Response
+CFUN: ( list of supported <fun> s ),( list of supported <rst> s ) www.simcom.com
39/194
SIM7022 Series_AT Command Manual_V1.00
OK
If error is related to ME functionality:
+CME ERROR: <err>
Response
+CFUN: <fun>
Read Command
AT+CFUN?
OK
If error is related to ME functionality:
+CME ERROR:<err>
Response
Write Command
AT+CFUN=<fun>[,<rst
>]
OK
If error is related to ME functionality:
Parameter Saving Mode -
+ CME ERROR: <err>
Max Response Time 10s
Reference
3GPP TS 27.007 [13]
Defined Values
<fun>
<rst>
Integer type
0 Minimum functionality
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 before setting it to <fun> power level. (not supported and will be ignored)
3.2.17 AT+CMEE Report Mobile Equipment Error
AT+CMEE Report Mobile Equipment Error
Description
Set command disables or enables the use of final result code +CME
ERROR: <err> as an indication of an errorrelating to the functionality of the
MT. When enabled, MT related errors cause +CME ERROR: <err> final result code instead of the regular ERROR final result code. ERROR is returned normally when error is related to syntax, invalid parameters, or TA functionality.
Read command returns the current setting of <n>.
www.simcom.com
40/194
SIM7022 Series_AT Command Manual_V1.00
Test command returns values supported as a compound value.
Test Command
Response
+CMEE: ( list of supported <n> s )
AT+CMEE=?
Read Command
OK
Response
+CMEE: <n>
AT+CMEE?
Write Command
AT+CMEE=<n>
TA disables or enables the use of result code +CME ERROR: <err> as an indication of an error relating to the functionality of the ME.
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time
Reference
3GPP TS 27.007 [13]
-
OK
Response
Defined Values
<n> integer type
0 Disable +CME ERROR: <err> result code and use ERROR instead.
1 Enable+CME ERROR:<err>result codeandusenumeric <err>
2 Enable +CME ERROR: <err> result code and use verbose <err> values
3.2.18 AT+CCLK Return Current Date & Time
AT+CCLK Return CurrentDate&Time
Test Command
AT+CCLK=?
Response
OK
Response
+CCLK:[<yy/MM/dd,hh:mm:ss>[<zz>]]
Read Command
AT+CCLK?
Write Command
AT+CCLK=<time>
OK
If error is related to ME functionality:
+CME ERROR: <err>
Response
OK
If error is related to ME functionality: www.simcom.com
41/194
SIM7022 Series_AT Command Manual_V1.00
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time -
Reference
3GPP TS 27.007 [13]
Defined Values
<time> String type value; format is "yy/MM/dd,hh:mm:ss±zz",where characters indicate year (two last digits),month,day,hour,minutes,seconds and time zone
(indicates the difference, expressed in quarters of an hour,between the local time and GMT; range -96...+96). E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals to "94/05/06,22:10:00+08"
NOTE
No value will be returned before core network sent EMM INFORMATION.
Need to send AT+NITZ=0 first before set time.
If MT does not support time zone information then the three last characters of <time> are not returned by +CCLK?
3.2.19 AT+CPSMS Power Saving Mode Setting
AT+CPSMS Power Saving Mode Setting
The set command controls the setting of the UEs power saving mode (PSM) parameters. The command controls whether the UE wants to apply PSM or not, as well as the requested extended periodic RAU value and the
Description requested GPRS READY timer value in GERAN/UTRAN, the requested extended periodic TAU value in E-UTRAN and the requested Active Time value. See the unsolicited result codes provided by command +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 +CPSMS=2. In this form, the use of PSM will be disabled and data for all parameters in the command
+CPSMS will be removed or, if available, set to the manufacturer specific default values.
www.simcom.com
The read command returns the current parameter values.
The test command returns the supported <mode>s and the value ranges for
42/194
SIM7022 Series_AT Command Manual_V1.00
Test Command
AT+CPSMS=?
the requested extended periodic RAU value and the requested GPRS
READY timer value in GERAN/UTRAN, the requested extended periodic
TAU value in E-UTRAN and the requested Active Time value as compound values.
Response
+CPSMS: ( list of supported < mode >s),(list of supported
< Requested_Periodic-RAU >s),(list of supported
< Requested_GPRS-READY-timer >s),(list of supported
< Requested_Periodic-TAU >s),(list of supported
< Requested_Active-Time >s )
OK
Response
+CPSMS:<mode>,[<Requested_Periodic-RAU>],[<Requested_GPRS-R
EADY-timer>],[<Requested_Periodic-TAU>],[<Requested_Active-Time
>]
Read Command
AT+CPSMS?
OK
Write Command
AT+CPSMS=[<mode>[,
<Requested_Periodic-
RAU>[,<Requested_G
PRS-READY-timer>[,<
Requested_Periodic-T
AU>[,<Requested_Acti ve-Time>]]]]]
Response
OK
If failed:
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time -
Reference
Defined Values
< mode >
< Requested_Periodi c-RAU >
Integer type. Indication to disable or enable the 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 or, if available, reset to the manufacturer specific default values.
String type; one byte in an 8 bit format. Requested extended periodic RAU value (T3312) to be allocated to the UE in GERAN/UTRAN. The requested extended periodic RAU value is coded as one byte (octet 3) of the GPRS
Timer 3 information element coded as bit format (e.g. "01000111" equals 70 hours). For the coding and the value range, see the GPRS Timer 3 IE in 3GPP
TS 24.008 [8] Table 10.5.163a/3GPP TS 24.008. See also 3GPP TS 23.682
[149] and 3GPP TS 23.060 [47]. The default value, if available, is manufacturer specific.
www.simcom.com
43/194
SIM7022 Series_AT Command Manual_V1.00
< Requested_GPRS-
READY-timer >
< Requested_Periodi c-TAU >
< Requested_Active-
Time >
String type; one byte in an 8 bit format. Requested GPRS READY timer value
(T3314) to be allocated to the UE in GERAN/UTRAN. The requested GPRS
READY timer value is coded as one byte (octet 2) of the GPRS Timer information element coded as bit format (e.g. "01000011" equals 3 decihours or 18 minutes). For the coding and the value range, see the GPRS Timer IE in
3GPP TS 24.008 [8] Table 10.5.172/3GPP TS 24.008. See also 3GPP TS
23.060 [47]. The default value, if available, is manufacturer specific.
String type; one byte in an 8 bit format. Requested extended periodic TAU value (T3412) to be allocated to the UE in E-UTRAN. The requested extended periodic TAU value is coded as one byte (octet 3) of the GPRS Timer 3 information element coded as bit format (e.g. "01000111" equals 70 hours).
For the coding and the value range, see the GPRS Timer 3 IE in 3GPP TS
24.008 [8] Table 10.5.163a/3GPP TS 24.008. See also 3GPP TS 23.682 [149] and 3GPP TS 23.401 [82]. The default value, if available, is manufacturer specific.
String type; one byte in an 8 bit format. Requested Active Time value (T3324) to be allocated to the UE. The requested Active Time value is coded as one byte (octet 3) of the GPRS Timer 2 information element coded as bit format
(e.g. "00100100" equals 4 minutes). For the coding and the value range, see the GPRS Timer 2 IE in 3GPP TS 24.008 [8] Table 10.5.163/3GPP TS 24.008.
See also 3GPP TS 23.682 [149], 3GPP TS 23.060 [47] and 3GPP TS 23.401
[82]. The default value, if available, is manufacturer specific.
NOTE
RAU is not supported by NB-IOT. No value will be output, and any input will be ignored.
<Requested_Periodic-TAU> and <Requested_Active-Time> could be quoted.
3.2.20 AT+CEDRXS Extended-DRX Setting
AT+CEDRXS Extended-DRX Setting
The set command controls the setting of the UEs eDRX parameters. The command controls whether the UE wants to apply eDRX or not, as well as the requested eDRX value for each specified type of access technology.
Description www.simcom.com
The set command also controls the presentation of an unsolicited result code
+CEDRXP:
<AcT-type>[,<Requested_eDRX_value>[,<NW-provided_eDRX_value>[
,<Paging_time_window>]]] when<n>=2 and there is a change in the eDRX parameters provided by the network.
44/194
SIM7022 Series_AT Command Manual_V1.00
A special form of the command can be given as +CEDRXS=3. In this form, eDRX will be disabled and data for all parameters in the command
+CEDRXS will be removed or, if available, set to the manufacturer specific default values.
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.
Response
+CEDRXS: ( list of supported <mode> s ),( list of supported <AcT-type>s),( list of supported <Requested_eDRX_value>s)
Test Command
AT+CEDRXS=?
Read Command
OK
Response
+CEDRXS:<AcT-type>,<Requested_eDRX_value>
AT+CEDRXS?
Write Command
OK
Response
AT+CEDRXS=[<mode>
,[,<AcT-type>[,<Reque sted_eDRX_value>]]]
OK
If failed:
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time
Reference
-
Defined Values
<
< mode >
AcT-type >
< Requested_eDRX_v alue >
Integer type, indicates to disable or enable the use of eDRX in the UE. This parameter is applicable to all specified types of access technology, i.e. the most recent setting of <mode> will take effect for all specified values of
<AcT>.
0 Disable the use of eDRX
1 Enable the use of eDRX
2 Enable the use of eDRX and enable the unsolicited result code
+CEDRXP:<AcT-type>[,<Requested_eDRX_value>[,<NW-provided_eDRX_v alue>[,<Paging_time_window>]]]
3 Disable the use of eDRX and discard all parameters for eDRX or, if available, reset to the manufacturer specific default values.
Integer type, indicates the type of access technology. This AT-command is used to specify the relationship between the type of access technology and the requested eDRX value.
5 E-UTRAN (NB-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 (see subclause www.simcom.com
45/194
SIM7022 Series_AT Command Manual_V1.00
< NW-provided_eDRX
_value >
< Paging_time_windo w >
10.5.5.32 of 3GPP TS 24.008 [8]). For the coding and the value range, see
Extended DRX parameters information element in 3GPP TS 24.008 [8] Table
10.5.5.32/3GPP TS 24.008. The default value, if available, is manufacturer specific.
String type; half a byte in a 4 bit format. The eDRX value refers to bit 4 to 1 of octet 3 of the Extended DRX parameters information element (see subclause
10.5.5.32 of
3GPP TS 24.008 [8]). For the coding and the value range, see Extended DRX parameters information element in 3GPP TS 24.008 [8] Table 10.5.5.32/3GPP
TS 24.008.
String type; half a byte in a 4 bit format. The paging time window refers to bit 8 to 5 of octet 3 of the Extended DRX parameters information element (see subclause 10.5.5.32 of 3GPP TS 24.008 [8]). For the coding and the value range, see the Extended DRX parameters information element in 3GPP TS
24.008 [8] Table 10.5.5.32/3GPP TS 24.008.
3.2.21 AT+CEDRXRDP eDRX Read Dynamic Parameters
AT+CEDRXRDP eDRX Read Dynamic Parameters
The execution command returns <AcT-type> and
<Requested_eDRX_value>, <NW-provided_eDRX_value>
Description and<Paging_time_window> if eDRX is used for the cell that the MS is currently registered to. If the cell that the MS is currently registered to is not using eDRX, AcT-type=0 is returned.
Test Command
AT+CEDRXRDP=?
Response
OK
Execution Command
Response
+CEDRXRDP:
<AcT-type>[,<Requested_eDRX_value>[,<NW-provided_eDRX_value>[
,<Paging_time_window>]]]
AT+CEDRXRDP
Parameter Saving Mode -
+CME ERROR:<err>
Max Response Time -
Reference
OK
If error is related to ME functionality:
Defined Values
<AcT-type> www.simcom.com
Integer type,indicates the type of access technology.This AT-command is
46/194
SIM7022 Series_AT Command Manual_V1.00
<Requested_Edrx_v alue>
<NW-provided_eDRX
_value>
<Paging_time_windo w> used to specify the relationship between the type of access technology and the requested eDRX value
0 Access technology is not using eDRX
5 E-UTRAN(NB-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 (see sub-clause
10.5.5.32 of 3GPP TS 24.008).For the coding and the value range,see
Extended DRX parameters information element in 3GPP TS 24.008 Table
10.5.5.32/3GPP TS 24.008.
String type;half a byte in a 4-bit format.The eDRX value Refers to bit 4 to 1 of octet 3 of the Extended DRX parameters information element (see sub-clause
10.5.5.32 of 3GPP TS 24.008).For the coding and the value range,see the
Extended DRX parameters information element in 3GPP TS 24.008 Table
10.5.5.32/3GPP TS 24.008.
String type;half a byte in a 4-bit format.The paging time window refers to bit 8 to 5 octet 3of the Extended DRX. Parameters information element (see sub-clause 10.5.5.32 of 3GPP TS 24.008).For the coding and the value range,see the Extended DRX parameters information element in 3GPP TS
24.008 Table 10.5.5.32/3GPP TS 24.008.
3.2.22 AT+CTZR Time Zone Reporting
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
Description
+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.
Refer to Chapter 9: Error Values for possible <err> values.
Test Command
AT+CTZR=?
Read Command
AT+CTZR?
www.simcom.com
Read command returns the current reporting settings in the MT.
Test command returns supported <reporting>-values as a compound value.
Response
+CTZR: (list of supported < reporting >s)
OK
Response
+CTZR: <reporting>
OK
If error is related to ME functionality:
47/194
SIM7022 Series_AT Command Manual_V1.00
Write Command
+CME ERROR: <err>
Response
OK
If error is related to ME functionality: AT+CTZR=<reporting>
Unsolicited result code
+CME ERROR: <err>
+CTZV: <zone>
Parameter Saving Mode AUTO_SAVE_REBOOT
Max Response Time
Reference
3GPP TS 27.007 [13]
-
Defined Values
< reporting >
<
<
<
< tz > dst > time > utime > www.simcom.com
Integer type value indicating:
0 Disable time zone change event reporting.
1 Enable time zone change event reporting by unsolicited result code
+CTZV: <tz>.
2 Enable extended time zone and local time reporting by unsolicited result code(not support)
+CTZE: <tz>,<dst>,[<time>].
3 Enable extended time zone and universal time reporting by unsolicited result code
+CTZEU: <tz>,<dst>,[<utime>].
String type value 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".
Integer type value 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),
48/194
SIM7022 Series_AT Command Manual_V1.00
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.
3.2.23 AT+CTZU Automatic Time Zone Update
AT+CTZU Automatic Time Zone Update
Set command enables and disables automatic time zone update via NITZ. If
Description
Test Command
Response
+CTZU: ( lists of supported <onoff>s)
AT+CTZU=?
Read Command
AT+CTZU?
OK
Response
+CTZU: <onoff>
OK
Response
Write Command
AT+CTZU=<onoff>
OK or
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time
Reference
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.
Defined Values
<onoff> 0 Disable automatic time zone update via NITZ.
1 Enable automatic time zone update via NITZ.
3.2.24 AT+CIPCA Initial PDP context activation
AT+CIPCA Initial PDP context activation
Description
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 www.simcom.com
49/194
SIM7022 Series_AT Command Manual_V1.00
and whether the UE is attached to E-UTRAN with or without a PDN connection.
For <n>≠0, deactivating the last (active) PDP context can lead to a
(re)establishment of the initial PDP context. Changing setting of <n> from 0 to 1 will cause an immediate attempt to (re)establish the initial PDP context if no PDP context is active. Changing <n> from 0 to 2 will if not roaming cause an immediate attempt to (re)establish the initial PDP context if no other PDP context is active. The value of <n>=3 applies to E-UTRAN RATs and does not change the setting of PDP context activation in GERAN or
UTRAN RATs. Changing <n> will never cause a PDP context deactivation.
For <AttachWithoutPDN>=1, the EPS Attach is performed without a PDN connection.
NOTE: For this command, the term roaming corresponds to being registered to
Test Command a VPLMN which is not equivalent to HPLMN or EHPLMN.
The read command returns the current setting of the command. The test command returns values supported as a compound value.
Refer to Chapter 9: Error Values for possible <err> values
Response
+CIPCA :(list of supported < n >s),(list of supported < AttachWithoutPDN >s)
AT+CIPCA=?
Read Command
OK
Response
+CIPCA: <n>[,<AttachWithoutPDN>]
AT+CIPCA?
Write Command
AT+CIPCA=[<n>[,<Atta chWithoutPDN>]]
Parameter Saving Mode -
Max Response Time -
Reference
OK
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Defined Values
< n >
<AttachWithoutPDN
>
Integer type. Activation of PDP context upon attach.
0 Do not activate
1 Always activate
2 Activate when not roaming
3 No change in current setting
Integer type. EPS Attach with or without PDN connection.
0 EPS Attach with PDN connection
1 EPS Attach without PDN connection www.simcom.com
50/194
SIM7022 Series_AT Command Manual_V1.00
NOTE
Only <n>=3 is supported.
If <AttachWithoutPDN> is omitted, will use the default value 0.
3.2.25 AT+CGAPNRC APN Rate Control
AT+CGAPNRC APN Rate Control
This execution command returns the APN rate control parameters (see
Description
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.
Refer to Chapter 9: Error Values for possible <err> values.
Response
+CGAPNRC : (list of < cid >s associated with active contexts)
Test Command
AT+CGAPNRC=?
Write Command
AT+CGAPNRC[=<cid>]
OK or
+CME ERROR: <err>
Response
[+CGAPNRC:
<cid>[,<Additional_exception_reports>[,<Uplink_time_unit>[,<Maxim um_uplink_rate>]]][<CR><LF>+CGAPNRC:
<cid>[,<Additional_exception_reports>[,<Uplink_time_unit>[,<Maximu m_uplink_rate>]]][...]]]
OK
If error is related to ME functionality:
Parameter Saving Mode -
+CME ERROR: <err>
Max Response Time
Reference
-
Defined Values
< cid > Integer type; specifies a particular PDP context definition (see the
+CGDCONT command).
< Additional_excepti Integer type; indicates whether or not additional exception reports are allowed www.simcom.com
51/194
SIM7022 Series_AT Command Manual_V1.00
on_reports
<
>
Uplink_time_unit >
< Maximum_uplink_r ate > to be sent when the maximum uplink rate 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] 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 type; 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.
3.2.26 AT+CSODCP Sending of Originating Data via the Control Plane
AT+CSODCP Sending of Originating Data via the Control Plane
Description
Test Command
AT+CSODCP=?
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 [83].
Test command returns the maximum number of bytes of the user data container supported by the MT, supported <RAI>s and supported
<type_of_user_data>s as a compound value.
If <sequence>is not omitted, when datagram is sent by rf or discard, will report the result +CSODCPR: <cid>,<sequence>,<status> .
Response
+CSODCP :(rane of supported < cid >s),(maximum number of bytes of the
< cpdata_length >),(list of supported < RAI >s),(list of supported
< type_of_user_data >s),(list of supported < sequence >s) www.simcom.com
52/194
SIM7022 Series_AT Command Manual_V1.00
Write Command
AT+CSODCP=<cid>,<c pdata_length>,<cpdata
>[,<RAI>[,<type_of_us er_data>[,<sequence>]
]]
Parameter Saving Mode -
Max Response Time -
Reference
OK or
+CME ERROR: <err>
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameters
Defined Values
<
<
<
< cid cpdata_length cpdata
RAI
>
>
>
>
Integer type. A numeric parameter which specifies a particular PDP 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 command).
Integer type. Indicates the number of bytes 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 (""). This parameter shall not be subject to conventional character conversion as per +CSCS. The coding format of the user data container and the maximum length of <cpdata> are implementation specific.
Integer type. Indicates the value of the release assistance indication, refer
3GPP TS 24.301 [83] subclause 9.9.4.25.
0 No information available.
1 The MT expects that exchange of data will 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.
< type_of_user_data > Integer type. Indicates whether the user data that is transmitted is regular or exceptional.
< sequence >
0 Regular data.
1 Exception data.
Sequence of data, range 1-255.If omit, will not report data sent status.
< status >
NOTE: <sequence> is not defined by 3GPP but only used for HiSi.
The status of datagram.
0 Error
1 Sent www.simcom.com
53/194
SIM7022 Series_AT Command Manual_V1.00
NOTE
Maximum data length will be 1358 bytes when non-IP is used, otherwise will be 0.
Only one message will be buffered at any one time.
3.2.27 AT+CRTDCP Reporting of Terminating Data via the Control Plane
AT+CRTDCP Reporting of Terminating Data via the Control Plane
The set command is used to enable and disable reporting of data from the
Description 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. Read command returns the current settings.
Test command returns supported values as compound values.
Test Command
Refer to Chapter 9: Error Values for possible <err> values.
Response
+CRTDCP :(list of supported < reporting >s),(range of supported
< cid >s),(maximum number of octets of user data indicated by
< cpdata_length >)
AT+CRTDCP=?
OK or
+CME ERROR: <err>
Response
+CRTDCP : < reporting >
Read Command
AT+CRTDCP?
OK or
+CME ERROR: <err>
Response
Write Command
AT+CRTDCP=<reporti ng>
OK
If error is related to ME functionality:
Parameter Saving Mode -
+CME ERROR: <err>
Max Response Time
Reference
-
Defined Values
www.simcom.com
54/194
< reporting >
< cid >
< cpdata_length >
< cpdata >
SIM7022 Series_AT Command Manual_V1.00
Integer type, controlling reporting of mobile terminated control plane data events
0 Disable reporting of MT control plane data.
1 Enable reporting of MT control plane data by the unsolicited result code
+CRTDCP.
Integer type. A numeric parameter which specifies a particular PDP 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 command).
Integer type. Indicates the number of bytes 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 (""). This parameter shall not be subject to conventional character conversion as per +CSCS. The coding format of the user data container and the maximum length of <cpdata> are implementation specific.
NOTE
Maximum data length will be 1358 bytes when non-IP is used, otherwise will be 0.
Only one message will be buffered at any one time.
Terminating data via the control plane before enable reporting will be discarded.
3.2.28 AT+CGEREP Packet Domain Event Reporting
AT+CGEREP Packet Domain Event Reporting
Set command enables or disables sending of unsolicited result codes,
Description
Test Command
AT+CGEREP=?
+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.
Response
+CRTDCP :(list of supported < reporting >s),(range of supported
< cid >s),(maximum number of octets of user data indicated by www.simcom.com
55/194
SIM7022 Series_AT Command Manual_V1.00
< cpdata_length >)
OK or
+CME ERROR: <err>
Response
+CRTDCP : < reporting >
Read Command
AT+CGEREP?
OK or
+CME ERROR: <err>
Response
Write Command
AT+CGEREP=<mode>[
,<bfr>]
OK
If error is related to ME functionality:
Parameter Saving Mode -
+CME ERROR: <err>
Max Response Time
Reference
-
Defined Values
<mode>
<bfr>
0 buffer unsolicited result codes in the MT; if MT result code buffer is full, the oldest ones can be discarded.No codes are forwarded to the TE.
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.
0 MT buffer of unsolicited result codes defined within this command is cleared when <mode> 1 ; Only it now
3.2.29 +CGEV Used to Indicate EPS PDN Connection and Bearer Resources
Operations Status
+CGEV Used to Indicate EPS PDN Connection and BearerResources Operations Status
Description
This is an unsolicited message to indicate EPS PDN connection and bearer resources operations status
+CGEV: NW PDN DEACT <cid>
Defined Values
<cid> The format is found in command +CGDCONT.<cid> values of 1-11 are supported.
www.simcom.com
56/194
SIM7022 Series_AT Command Manual_V1.00
3.2.30 AT+CGCONTRDP PDP Context Read Dynamic Parameters
AT+CGCONTRDP PDP Context Read Dynamic Parameters
Description
The execution command returns the relevant information <bearer_id>,
<apn>,<local_addr and subnet_mask>,<gw_addr>,<DNS_prim_addr>,
<DNS_sec_addr>,<P-CSCF_prim_addr>,<P-CSCF_sec_addr>,<IM_CN_S ignalling_Flag>,<LIPA_indication>,<IPv4_MTU>,<WLAN_Offload>,<Non-IP
_MTU>,<Serving_PLMN_rate_control_value> and
<Reliable_Data_Service> for an active non secondary PDP context with the context identifier <cid>. If the MT indicates more than two IP addresses of
P-CSCF servers or more than two IP addresses of DNS servers, multiple lines of information per <cid> will be returned.
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 two IP addresses of P-CSCF servers or more than two IP addresses of DNS servers, multiple of such pairs of lines are returned.
NOTE: If the MT doesn't have all the IP addresses to be included in a line, e.g. in case the UE received four IP addresses of DNS servers and two IP addresses of
P-CSCF servers, the parameter value representing an IP address that can not be populated is set to an empty string or an absent string.
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.
Response
+CGCONTRDP: ( list of <cid> s associated with active contexts )
Test Command
AT+CGCONTRDP=?
Write Command
AT+CGCONTRDP[=<ci d>]
OK or
OK
Response
[+CGCONTRDP: <cid>,<bearer_id>,<apn>[,<local_addr and subnet_mask>[,<gw_addr>[,<DNS_prim_addr>[,<DNS_sec_addr>[,<P
CSCF_prim_addr>[,<PCSCF_sec_addr>[,<IM_CN_Signalling_Flag>[,<
LIPA_indication>[,<IPv4_MTU>[,<WLAN_Offload>[,<Local_Addr_Ind>[
,<Non-IP_MTU>[,<Serving_PLMN_rate_control_value>[,<Reliable_Dat a_Service]]]]]]]]]]]]]]][<CR><LF>+CGCONTRDP:
<cid>,<bearer_id>,<apn>[,<local_addr and subnet_mask>[,<gw_addr>[,<DNS_prim_addr>[,<DNS_sec_addr>[,<P
CSCF_prim_addr>[,<PCSCF_sec_addr>[,<IM_CN_Signalling_Flag>[,<
LIPA_indication>[,<IPv4_MTU>[,<WLAN_Offload>[,<Local_Addr_Ind>[
,<Non-IP_MTU>[,<Serving_PLMN_rate_control_value>[,<Reliable_Dat www.simcom.com
57/194
SIM7022 Series_AT Command Manual_V1.00
a_Service]]]]]]]]]]]]]]
[…]]
OK or
OK
If error is related to ME functionality:
Parameter Saving Mode -
+CME ERROR: <err>
Max Response Time
Reference
-
Defined Values
<
<
<
< cid apn
> bearer_id
>
> local_addr subnet_mask
<
<
<
<
>
<
> gw_addr >
>
DNS_prim_addr
DNS_sec_addr > and
>
P_CSCF_prim_addr
P_CSCF_sec_addr
Integer type; specifies a particular non secondary PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands (see the +CGDCONT command).
Integer type; identifies the bearer, i.e. the EPS bearer in EPS and the NSAPI in UMTS/GPRS.
String type; a logical name that was used to select the GGSN or the external packet data network.
String type; shows the IP address and subnet mask of the MT.The string is given as dot-separated numeric (0-255) parameters on the form:
"a1.a2.a3.a4.m1.m2.m3.m4" for IPv4 or
"a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a16.m1.m2.m3.m4.m
5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15.m16" for IPv6.
When +CGPIAF is supported, its settings can influence the format of this parameter returned with the execute form of +CGCONTRDP.
String type; shows the Gateway Address of the MT. The string is given as dot-separated numeric (0-255) parameters.
When +CGPIAF is supported, its settings can influence the format of this parameter returned with the execute form of +CGCONTRDP.
String type; shows the IP address of the primary DNS server.When +CGPIAF is supported, its settings can influence the format of this parameter returned with the execute form of +CGCONTRDP.
String type; shows the IP address of the secondary DNS server.When
+CGPIAF is supported, its settings can influence the format of this parameter returned with the execute form of +CGCONTRDP.
String type; shows the IP address of the primary P-CSCF server.When
+CGPIAF is supported, its settings can influence the format of this parameter returned with the execute form of +CGCONTRDP.
String type; shows the IP address of the secondary P-CSCF server.When
+CGPIAF is supported, its settings can influence the format of this parameter returned with the execute form of +CGCONTRDP.
www.simcom.com
58/194
SIM7022 Series_AT Command Manual_V1.00
< IM_CN_Signalling_
Flag
<
<
<
<
<
IPv4_MTU >
WLAN_Offload >
Reliable_Data_Serv ice >
>
LIPA_indication
Local_Addr_Ind
>
>
< Non-IP_MTU >
< Serving_PLMN_rate
_control_value >
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
Integer type; indicates that the PDP context provides connectivity using a LIPA
PDN connection. This parameter cannot be set by the TE.
0 indication not received that the PDP context provides connectivity using a
LIPA PDN connection
1 indication received that the PDP context provides connectivity using a
LIPA PDN connection
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. This refers to bits 1 and 2 of the WLAN offload acceptability IE as specified in 3GPP TS 24.008 [8] subclause
10.5.6.20.
0 offloading the traffic of the PDN connection via a WLAN when in S1 mode or when in Iu mode is not acceptable.
1 offloading the traffic of the PDN connection via a WLAN when in S1 mode is acceptable, but not acceptable in Iu mode.
2 offloading the traffic of the PDN connection via a WLAN when in Iu mode is acceptable, but not acceptable in S1 mode.
3 offloading the traffic of the PDN connection via a WLAN when in S1 mode or when in Iu mode is acceptable.
Integer type; indicates whether or not the MS and the network support local IP address in TFTs (see 3GPP TS 24.301 [83] and 3GPP TS 24.008 [8] subclause 10.5.6.3).
0 indicates that the MS or the network or both do not support local IP address in TFTs
1 indicates that the MS and the network support local IP address in TFTs
Integer type; shows the Non-IP MTU size in octets.
Integer type; indicates the maximum number of uplink messages the UE is allowed to send in a 6 minute interval. This refers to octet 3 to 4 of the Serving
PLMN rate control IE as specified in 3GPP TS 24.301 [8] subclause 9.9.4.28.
Integer type; indicates whether the UE is using Reliable Data Service for a
PDN connection or not, see 3GPP TS 24.301 [83] and 3GPP TS 24.008 [8] subclause 10.5.6.3.
0 Reliable Data Service is not being used for the PDN connection
1 Reliable Data Service is being used for the PDN connection
NOTE
Only support <cid>,<apn>,<DNS_prim_addr>,<DNS_sec_addr> now.
<DNS_prim_addr>,<DNS_sec_addr> could display only when <PDP_type> is "IP" or
"IPV6".
www.simcom.com
59/194
SIM7022 Series_AT Command Manual_V1.00
Could configure PDP context dynamic parameter items to read by +NCPCDPR.
3.2.31 AT+CGAUTH Define PDP Context Authentication Parameters
AT+CGAUTH Define PDP Context Authentication Parameters
Set command allows the TE to specify authentication parameters for a PDP
Description
Test Command
AT+CGAUTH=?
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 command, +CGAUTH is effectively as an extension to these commands.
The read command returns the current settings for each defined context.
The test command returns values supported as compound values.
Response
+CGAUTH: ( range of supported <cid> s ),( list of supported <auth_prot> s ),( range of supported <userid> s ),( range of supported <password> s )
Read Command
AT+CGAUTH?
OK
Response
[+CGAUTH:
<cid>,<auth_prot>,<userid>,<password>][<CR><LF>+CGAUTH:
<cid>,<auth_prot>,<userid>,<password>
[…]]
Write Command
AT+CGAUTH=<cid>[,< auth_prot>[,<userid>[,
<password>]]]
OK
Response
When <auth_prot>/<username>/<password> set:
OK
When no <auth_prot>/<username>/<password> set displays current auth_prot username and password for <cid>:
+CGAUTH: <cid>,<auth_prot>,<username>,<password>
Parameter Saving Mode -
+CME ERROR: <err>
Max Response Time -
OK
If error is related to wrong AT syntax:
Reference www.simcom.com
60/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
< cid >
< auth_prot >
< userid >
< password >
Integer type. Specifies a particular PDP context definition (see the
+CGDCONT command).
Integer type. Authentication protocol used for this PDP context.
0 None. Used to indicate that no authentication protocol is used for this
PDP context. Username and password are removed if previously specified.
1 PAP
2 CHAP
String type. User name for access to the IP network.
String type. Password for access to the IP network.
NOTE
<userid> is needed when <auth_prot> is 1 or 2.
Maximum <userid> string and <password> string length is 60.
3.2.32 AT+CPIN Enter PIN
AT+CPIN Enter PIN
Set command sends to the MT a password which is necessary before it can be operated (SIM PIN, SIM PUK,PH-SIM PIN, etc.). If the PIN is to be entered twice, the TA shall automatically repeat the PIN. If no PIN request is pending, no action is taken towards MT and an error message, +CME
ERROR, is returned to TE. Refer to Chapter 9 for possible <err> values.
Description
NOTE 1: SIM PIN, SIM PUK, PH-SIM PIN, PH-FSIM PIN, PH-FSIM PUK, SIM PIN2 and SIM PUK2 refer to the PIN of the selected application on the UICC. For example, in an UTRAN context, the selected application on the currently selected
UICC should be a USIM and the SIM PIN then represents the PIN of the selected
USIM. See 3GPP TS 31.101 [65] for further details on application selection on the
UICC.
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.
NOTE 2: Commands which interact with MT that are accepted when MT is pending SIM PIN, SIM PUK, or PH-SIM are: +CGMI, +CGMM, +CGMR, +CGSN, D112;
(emergency call), +CPAS, +CFUN,+CPIN, +CPINR, +CDIS (read and test command only), and +CIND (read and test command only). It is implementation specific whether additional commands can be accepted when MT is pending SIM PIN, SIM
PUK, or PH-SIM.
www.simcom.com
61/194
SIM7022 Series_AT Command Manual_V1.00
Read command returns an alphanumeric string indicating whether some password is required or not.
Test Command
AT+CPIN=?
Response
OK
Read Command
Response
+CPIN: <code>
AT+CPIN?
OK
Response
Write Command
AT+CPIN=<pin>[,<new pin>]
OK
If error is related to ME functionality:
+CME ERROR:<err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
3GPP TS 27.007 [13]
5s
Defined Values
<code>
<pin>
<new pin>
READY
SIM PIN
MT is not pending for any password
MT is waiting SIM PIN to be given
SIM PUK MT is waiting for SIM PUK to be given
SIM PUK BLOCKED
String type; password
String type; If the PIN required is SIM PUK or SIMPUK2: new password
NOTE
Set and read could execute only when power on.
3.2.33
AT+CLCK Facility Lock
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
Description 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.
www.simcom.com
62/194
SIM7022 Series_AT Command Manual_V1.00
Test Command
AT+CLCK=?
Response
OK
Write Command
AT+CLCK=<fac>,<mod e>[,<passwd>]
Response
OK or
+CME ERROR: <err>
When <mode>=2 and command successful:
+CLCK: <status>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<fac>
<mode>
<status>
<passwd>
“SC” SIM (lock SIM/UICC card installed in the currently selected card slot)
(SIM/UICC asks password in MT power-up and when this lock command issued)
0 Unlock
1 Lock
2 Query status
0 Not active
1 active
String type; shall be the same as password specified for the facility from the
MT user interface or with command Change Password +CPWD
3.2.34 AT+CMOLR Mobile Originated Location Request
AT+CMOLR Mobile Originated Location Request
Description
Set command initiates a mobile originated location request (MO-LR). The parameter <enable> enables or disables positioning and reporting by unsolicited result codes. Reporting can be performed in the format of GAD shapes <location_parameters> or in the format of NMEA strings
<NMEA-string> or both.
The unsolicited result codes that can be provided are +CMOLRG:
<location_parameters> and/or
+CMOLRN: <NMEA-string>.
Read command returns the current settings of the parameters <enable>,
<method>, <hor-acc-set>, <horacc>, <ver-req>, <ver-acc-set>, <ver-acc>,
<vel-req>, <rep-mode>, <timeout>, <interval><shape-rep>, <plane>,
<NMEA-rep> and <third-party-address>. The parameters <hor-acc>,
<veraccset>, <ver-acc> and <plane> are only applicable in certain www.simcom.com
63/194
SIM7022 Series_AT Command Manual_V1.00
Test Command
AT+CMOLR=?
Read Command
AT+CMOLR?
configurations. The parameter <interval>is only applicable if periodic reporting is specified. The parameter <NMEA-rep> is only applicable if reporting is specified by NMEA strings.The parameter <third-party-address> is only applicable if reporting to third party is specified.
Test command returns the supported values and ranges.
Response
+CMOLR: ( list of supported <enable>s),( list ofsupported <method>s),( list of supported <horacc-set>s),( list of supported <hor-acc>s),( list of supported <ver-req>s),( list of supported <veracc-set>s),( list of supported
<ver-acc>s),( listof supported <vel-req>s),( list of supported <repmode>s),( list of supported <timeout>s),( list of supported
<interval>s),( list of supported <shape-rep>s),( list of supported <plane>s),( list of supported <NMEA-rep>s),( list of supported
<third-party-address>s)
OK
Response
+CMOLR:
<enable>,<method>,<hor-accset>,[<hor-acc>],<ver-req>,[<ver-accset>
],[<ver-acc>],<vel-req>,<repmode>,<timeout>,[<interval>],<shaperep>,
[<plane>],[<NMEA-rep>],[<thirdparty-address>]
OK
Write Command
AT+CMOLR=[<enable>
[,<method>[,<hor-accs et>[,<hor-acc>[,<ver-re q>[,<ver-accset>[,<veracc>[,<vel-req>[,<repm ode>[,<timeout>[,<inte rval>[,<shaperep>[,<pl ane>[,<NMEA-rep>[,<t hirdparty-address>]]]]]
]]]]]]]]]]]
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
Defined Values
<enable> www.simcom.com
0 Disables reporting and positioning
1 Enables reporting of NMEA strings by unsolicited result code +CMOLRN:
<NMEA-string>.
Lack of data at each timeout is indicated by an unsolicited result code
64/194
<method>
<hor-acc-set>
<hor-acc>
<ver-req>
<ver-acc-set>
<ver-acc>
<vel-req>
<rep-mode>
<timeout>
<interval> www.simcom.com
SIM7022 Series_AT Command Manual_V1.00
+CMOLRE.
2 Enables reporting of GAD shapes by unsolicited result code +CMOLRG:
<location_parameters>.
Lack of data at each timeout is indicated by an unsolicited result code
+CMOLRE.
3 Enables reporting of NMEA strings and GAD shapes by unsolicited result codes
+CMOLRG: <location_parameters> and +CMOLRN: <NMEA-string>.
Lack of data at each timeout is indicated by an unsolicited result code
+CMOLRE.
0 Unassisted GPS. Autonomous GPS only, no use of assistance data.
1 Assisted GPS. 2 Assisted GANSS. 3 Assisted GPS and GANSS. 4 Basic
Self location (the network determines the position technology).
5 Transfer to third party. This method makes the parameters <shape-rep> and
<NMEA-rep> irrelevant (any values are accepted and disregarded).
The third party address is given in the parameter <thirdparty-address>.
6 Retrieval from third party. This method is to get the position estimate of the third party. The third party address is given in the parameter
<third-party-address>.
0 Horisontal accuracy not set/specified.
1 Horizontal accuracy set in parameter <hor-acc>.
Requested accuracy as horizontal uncertainty exponent. The value range is
0-127.
0 Vertical coordinate (altitude) is not requested, 2D location fix is acceptable.
The parameters <ver-accset> and <ver-acc> do not apply.
1 Vertical coordinate (altitude) is requested, 3D location fix is required.
0 Vertical accuracy not set/specified.
1 Vertical accuracy set/specified in parameter <ver-acc>.
Requested accuracy as vertical uncertainty exponent The value range is
0-127. The default value is implementation specific.
0 Velocity not requested.
1 Horizontal velocity requested.
2 Horizontal velocity and vertical velocity requested.
3 Horizontal velocity with uncertainty requested.
4 Horizontal velocity with uncertainty and vertical velocity with uncertainty requested.
0 Single report, the timeout for the MO-LR response request is specified by
<timeout>.
1 Periodic reporting, the timeout for each MO-LR response request is specified by <timeout> and the interval between each MO-LR is specified by
<interval>.
Indicates how long the MS will wait for a response after a MO-LR. The value range is in seconds from 1 to 65535.
The parameter is applicable to periodic reporting only. Determine the interval between periodic MO-LRs. The value range is in seconds from 1 to 65535,
65/194
SIM7022 Series_AT Command Manual_V1.00
<shape-req>
<plane>
<NMEA-rep>
<third-party-address
>
<location-parameter s> and must be greater than or equal to <timeout>.
This parameter is a sum of integers each representing a certain GAD shape that will be accepted in the unsolicited result code <location_parameters>.
Note that only one GAD shape is present per unsolicited result code.
1 Ellipsoid point.
2 Ellipsoid point with uncertainty circle.
4 Ellipsoid point with uncertainty ellipse.
8 Polygon.
16 Ellipsoid point with altitude.
32 Ellipsoid point with altitude and uncertainty ellipsoid.
64 Ellipsoid arc.
The parameter specifies whether the control plane or SUPL will be used for
MO-LR.
0 Control plane.
1 Secure user plane (SUPL).
The supported NMEA strings are specified as a comma separated values inside one string. If the parameter is omitted or an empty string is given, no restrictions apply and all NMEA strings are supported.
The parameter is applicable to reporting to third party only, andspecifies the address to the third party. This parameter has to be specified when <method> value is set to 5 or 6.
String type in UTF-8. This parameter provides XML-formatted strings of
GADshape positioning data as defined in table 8.50-2. This parameter shall not be subject to conventional character conversion as per +CSCS. The XML according to the DTD in table 8.50-2 may be provided in one or multipleunsolicited result codes.
3.2.35
AT+CPWD Change Password
AT+CPWD Change Password
Description
Command sets a new password for the facility lock function defined by command Facility Lock +CLCK. Test command returns a list of pairs which
Test Command
AT+CPWD=?
Write Command
AT+CPWD=<fac>,<old pwd>,<newpwd> present the available facilities and the maximum length of their password.
Response
+CPWD: list of supported (<fac>,<pwdlength>)s
OK or
+CME ERROR: <err>
Response
OK or
+CME ERROR: <err> www.simcom.com
66/194
SIM7022 Series_AT Command Manual_V1.00
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
Defined Values
<fac>
<oldpwd>,<newpwd
>
<pwdlength>
“SC” SIM (lock SIM/UICC card installed in the currently selected card slot)
(SIM/UICC asks password in MT power-up and when this lock command issued)
<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>
Integer type; maximum length of the password for the facility.
3.2.36 AT+CPINR Remaining PIN Retries
AT+CPINR Remaining PIN Retries
Execution 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 and +CPINRE:
Description
<ext_code>,<retries>[,<default_retries>] for manufacturer specific PINs.
One line with one intermediate result code is returned for every <code> or
<ext_code> selected by <sel_code>.
When execution command is issued without the optional parameter
<sel_code>, intermediate result codes are returned for all <code>s and
<ext_code>s.
In the intermediate result codes, the parameter <default_retries> is an optional (manufacturer specific) parameter, per <code> and <ext_code>.
Test Command
AT+CPINR=?
Response
OK
Write Command
Response
[+CPINR: <code>,<retries>[,<default_retries>][<CR>,<LF>+CPINR:
<code>,<retries>[,<default_retries>]
AT+CPINR[=<sel_code
>] OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
3GPP TS 27.007 [13]
www.simcom.com
67/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
< retries >
< default_retries >
< code >
< ext_code >
< sel_code >
Integer type. Number of remaining retries per PIN.
Integer type. Number of default/initial retries per PIN.
Type of PIN. All values listed under the description of the AT+CPIN command,
<code> parameter, except 'READY'.
Extended, manufacturer specific codes.
String type. Same values as for the <code> and <ext_code> parameters.
These values are strings and shall be indicated within double quotes. It is optional to support wildcard match by '*', meaning match any (sub-)string.
NOTE
Set and read could execute only when power on.
3.2.37 AT+CCHO Open Logical Channel
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
Description 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.
NOTE: The logical channel number is contained in the CLASS byte of an APDU command, thus implicitly contained in all APDU commands sent to a UICC. In this case it will be up to the MT to manage the logical channel part of the APDU CLASS byte and to ensure that the chosen logical channel is relevant to the <sessionid> indicated in the AT command. See 3GPP TS 31.101 [65] for further information on logical channels in APDU commands protocol.
Response
+CCHO: <sessionid>
Write Command
AT+CCHO=<dfname> OK
If error is related to ME functionality:
+CME ERROR: <err> www.simcom.com
68/194
SIM7022 Series_AT Command Manual_V1.00
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
3GPP TS 27.007 [13]
Defined Values
< dfname >
< sessionid >
String type in hexadecimal character format. All selectable applications in the
UICC are referenced by a DF name coded on 1 to 16 bytes
Integer type; a session Id to be used to target a specific application on the smart card (e.g. (U)SIM, WIM, ISIM) using logical channels mechanism.
See 3GPP TS 31.101 [65] for more information about defined values
3.2.38 AT+CCHC Close logical channel
AT+CCHC Close UICC Logical Channel
Description
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.
Write Command
AT+CCHC=<sessionid
>
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
3GPP TS 27.007 [13]
-
Defined Values
< sessionid > Integer type; the session used to target a specific application on the smart card (e.g. (U)SIM, WIM, ISIM) using logical channels mechanism
3.2.39 AT+CGLA Generic UICC Logical Channel Access
AT+CGLA Generic UICC Logical Channel Access
Description
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 www.simcom.com
69/194
SIM7022 Series_AT Command Manual_V1.00
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 [59] for USIM authenticate command definition.
NOTE: Compared to Restricted UICC Access command +CRLA, the definition of
+CGLA allows TE to take more control over the UICC-MT interface. The locking and unlocking of the interface may be done by a special <command> value or automatically by TA/MT (by interpreting <command> parameter). In case that TE application does not use the unlock command (or does not send a <command> causing automatic unlock) in a certain timeout value, MT may release the locking.
Response
+CGLA: <length>,<response> Write Command
AT+CGLA=<sessionid
>,<length>,<command
>
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
3GPP TS 27.007 [13]
-
Defined Values
< sessionid >
< length >
< command >
< response > www.simcom.com
Integer type; this is the identifier of the session to be used in order to send the
APDU 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 other than the default channel (channel "0").
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 passed on by the MT to the UICC in the format as described in
3GPP TS 31.101 [65] (hexadecimal character format; refer +CSCS)
Response to the command passed on by the UICC to the MT in the format as described in 3GPP TS 31.101 [65] (hexadecimal character format; refer
70/194
SIM7022 Series_AT Command Manual_V1.00
+CSCS)
3.2.40 AT+CMTLR Mobile Terminated Location Request Notification
AT+CMTLR Mobile Terminated Location Request Notification
Description
Set command enables Mobile Terminated Location Request (MT-LR) notifications to the TE. The parameter <subscribe> enables or disables notification by an unsolicited result code. It is possible to enable notification of MT-LR performed over the control plane or over SUPL or both. Relevant location request parameters are provided in the unsolicited result code
+CMTLR:<handle-id>,<notification-type>,<locationtype>,[<client-external-id
>],[<client-name>][,<plane>].
Read command returns the current value of <subscribe>.
Test Command
AT+CMTLR=?
Test command returns the supported values as a compound value.
Response
+CMTLR: (list of supported <
Read Command
AT+CMTLR?
+CMTLR: <subscribe>
OK
Response
Write Command
AT+CMTLR=[<subscri
OK or be>]
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time
Reference
-
OK
Response subscribe >s)
Defined Values
<subscribe>
<handle-id>
<notification-type>
Enables and disables the subscription for MT-LR notifications
0 Disables reporting and positioning.
1 Subscribe for notifications of MT-LR over control plane.
2 Subscribe for notifications of MT-LR over SUPL.
3 Subscribe for notifications of MT-LR over control plane and SUPL.
ID associated with each MT-LR used to distinguish specific request in case of multiple requests. The value range is 0-255.
Integer type. Information about the user's privacy.
www.simcom.com
71/194
<location-type>
<client-external-id>
<client-name>
<plane>
SIM7022 Series_AT Command Manual_V1.00
0 The subscription may stipulate that positioning the user by a third party is allowed and the network may choose to inform the user as a matter of courtesy.
1 Locating the user is permitted if the user ignores the notification.
2 Locating the user is forbidden if the user ignores the notification
Integer type. Indicates what type of the location is requested.
0 The current location.
1 The current or last known location.
2 The initial location.
String type. Indicates the external client where the location information is sent to (if required).
String type. Contains the string identifying the external client requesting the user's location
Integer type. The parameter specifies whether the MT-LR came over control plane or SUPL.
0 Control plane.
1 Secure user plane (SUPL).
3.2.41 AT+CMTLRA Mobile Terminated Location Request Disclosure Allowance
AT+CMTLRA Mobile Terminated Location Request Disclosure Allowance
Description
Set command allows or disallows disclosure of the location to the TE as a result of MT-LR by the parameter <allow>.
Read command returns the current values.
Test command returns the supported values.
Test Command
Response
+CMTLRA: ( lists of supported <allow> values )
AT+CMTLRA=?
Read Command
OK
Response
+CMTLRA: <allow>,<handle-id>
AT+CMTLRA?
OK
Response
Write Command
AT+CMTLRA=<allow>,
<handle-id>
OK or
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time
Reference
-
Defined Values
www.simcom.com
72/194
<allow>
<handle-id>
SIM7022 Series_AT Command Manual_V1.00
Integer type. Enables and disables the allowance for location disclosure.
0 Location disclosure allowed.
1 Location disclosure not allowed.
Integer type. ID associated with each MT-LR used to distinguish specific request in case of multiple requests. The value range is 0-255.
3.2.42 AT+CRCES Reading Coverage Enhancement Status
AT+CRCES Reading Coverage Enhancement Status
This command returns the coverage enhancement status of the MT. The
Description terminal can consider the coverage enhancement status prior to deciding to transmit data. Depending on the coverageenhancement 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.
Test Command
Response
+CRCES: <AcT>,<CE_level>,<CC>
AT+CRCES=?
Execution Command
AT+CRCES
OK
Response
OK
Parameter Saving Mode AUTO_SAVE
Max Response Time
Reference
-
Defined Values
<AcT>
<CE_level> www.simcom.com
Integer type; access technology of the serving cell.
0 Location disclosure allowed.
1 E-UTRAN.
2 EC-GSM-IoT (A/Gb mode)
3 E-UTRAN (NB-S1 mode)
Integer type; Coverage Enhancement (CE) level of the MT in the serving cell.
Applicable only if <Act>=1 (E-UTRAN) or <Act>=3 (E-UTRAN (NB-S1 mode)).
0 No Coverage Enhancement in the serving cell
1 Coverage Enhancement level 0
2 Coverage Enhancement level 1
3 Coverage Enhancement level 2
4 Coverage Enhancement level 3
73/194
<cc>
SIM7022 Series_AT Command Manual_V1.00
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.
3.2.43 AT+CRSM Restricted SIM Access
AT+CRSM Restricted SIM Access
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.
Test Command
AT+CRSM=?
Response
OK
Response
+CRSM: <sw1>,<sw2>[,<response>]
Write Command
AT+CRSM=<Command
>[,<fileId>[,<P1>,<P2>,
<P3>[,<data>]]]
OK or
ERROR
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
3GPP TS 27.007
GSM 11.11
Defined Values
<Command> www.simcom.com
(command passed on by the MT to the SIM; refer 3GPP TS 51.011 [28]):
176 READ BINARY
178 READ RECORD
192 GET RESPONSE
74/194
<fileId>
<P1>,<P2>,<P3>
<data>
<sw1>,<sw2>
<response>
SIM7022 Series_AT Command Manual_V1.00
214 UPDATE BINARY
220 UPDATE RECORD
242 STATUS
All other values are reserved
Integer type; this is the identifier for an elementary data file on SIM. Mandatory for every Command except STATUS
Integer type, range 0 – 255
Parameters to be passed on by the ME to the SIM; refer GSM 11.11.
Information which shall be written to the SIM (hex-decimal character format)
Integer type, range 0 - 255
Status 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; refer GSM 11.11.
Response of a successful completion of the Command previously issued (hexadecimal character format)
NOTE
<Command> does not support 203 and 219.
3.2.44 AT+CSIM Generic SIM Access
AT+CSIM Generic SIM Access
Set command transmits to the MT the <command> it then shall send as it is
Description 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.
NOTE: Compared to Restricted SIM Access command +CRSM, the definition of
+CSIM allows TE to take more control over the SIM-MT interface. The locking and unlocking of the interface may be done by a special <command> value or automatically by TA/MT (by interpreting <command> parameter). In case that TE application does not use the unlock command (or does not send a <command> causing automatic unlock) in a certain timeout value, MT may release the locking.
Test Command
AT+CSIM=?
Write Command
Response
OK
Response
+CSIM: <length>,<response>
AT+CSIM=<length>,<C ommand>
OK www.simcom.com
75/194
SIM7022 Series_AT Command Manual_V1.00
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
3GPP TS 27.007 [13]
Defined Values
<length>
<Command>
<response>
Integer type: length of characters sent to the TE in <Command> or
<response> (i.e. twice the number of octets in the raw data).
String type (string should be included in quotation marks): hex format: GSM
11.11 SIM Command sent from the ME to the SIM.
String type(string should be included in quotation marks): hex format: GSM
11.11 response from SIM to <Command>.
3.2.45 AT+CGDATA Enter Data State
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
Description 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
<L2P> protocols.
Response
Test Command +CGDATA: ( list of supported <L2P> s )
AT+CGDATA=?
OK
Response
Write Command
AT+CGDATA=[<L2P>[,
<cid>[,<cid>[,...]]]]
OK or
ERROR
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
activation request.
The test command is used for requesting information on the supported
Defined Values
www.simcom.com
76/194
< L2P >
< cid >
SIM7022 Series_AT Command Manual_V1.00
String type; indicates the layer 2 protocol to be used between the TE and MT.
M-PT Eigencomm specified protocol – PDP Type, such as
IP/IPV6/IPV4V6/Non-IP.
Integer type; specifies a particular PDP context definition (see the
+CGDCONT command).
NOTE
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>.The baud rate needs to be greater than or equal to 57600.
If PDP activation success, MT issues the result code: OK, not: CONNECT, as not support V.250
online data state now.
3.2.46 AT+CCIOTOPT CIoT Optimization Configuration
AT+CCIOTOPT CIoT Optimization Configuration
Description
The set command controls which CIoT EPS optimizations the UE indicates as supported and preferred in the ATTACH REQUEST and TRACKING
AREA UPDATE REQUEST messages. The command also allows reporting of the CIoT EPS optimizations that are supported by the network. A UE supporting CIoT functionality may support control plane CIoT EPS optimization or user plane CIoT EPS optimization or both (see 3GPP TS
24.301 [83], subclause 9.9.3.34). Based on the application characteristics the UE may prefer to be registered for control plane CIoT EPS optimization or for user plane CIoT EPS optimization (see 3GPP TS 24.301 [83], subclause 9.9.3.0B). Further the network may support control plane CIoT
EPS optimization or user plane CIoT EPS optimization or both (see 3GPP
TS 24.301 [83], subclause 9.9.3.12A).
The set command is used also to control the unsolicited result code
+CCIOTOPTI. An unsolicited result code
+CCIOTOPTI: <supported_Network_opt> is used to indicate the supported
CIoT EPS optimizations by the network.
Test Command
AT+CCIOTOPT=?
current status of unsolicited result code +CCIOTOPTI.
The test command returns values supported as compound values.
Response
+CCIOTOPT: (list of supported < n >s),(list of supported
< supported_UE_opt >s),(list of supported < preferred_UE_opt >s)
OK www.simcom.com
77/194
SIM7022 Series_AT Command Manual_V1.00
Response
+CCIOTOPT: <n>,<supported_UE_opt>,<preferred_UE_opt>
Read Command
AT+CCIOTOPT?
OK
If error is related to ME functionality:
+CME ERROR: <err>
Write Command
AT+CCIOTOPT=[<n>[,
<supported
UE_opt>[,<preferred_U
E_opt>]]]
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
3GPP TS 27.007 [13]
Defined Values
< n > Integer type. Enables or disables reporting of unsolicited result code
+CCIOTOPTI.
0 Disable reporting.
1 Enable reporting.
3 Disable reporting and reset the parameters for CIoT EPS optimization to the default values.
Integer type; indicates the UE's support for CIoT EPS optimizations.
0 No support.
< supported_UE_opt
>
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.
< preferred_UE_opt > Integer type; indicates the UE's preference for CIoT EPS optimizations.
0 No preference.
1 Preference for control plane CIoT EPS optimization.
< supported_Network
_opt >
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
www.simcom.com
78/194
SIM7022 Series_AT Command Manual_V1.00
AT+CCIOTOPT=?
+CCIOTOPT: (0,1,3),(1,3),(0,1,2)
OK
AT+CCIOTOPT?
+CCIOTOPT: 0,3,1
OK
3.2.47 AT+CGCMOD PDP Context Modify
AT+CGCMOD PDP Context Modify
Description
The execution command is used to modify the specified PDP context (s) with repect to QoS profiles and TFTs.
After the command has completed, the MT returns to V.250 online data state. If the requested modification for any specified context cannot be achieved, an ERROR or +CME ERROR response is returned. Extended error responses are enabled by the +CMEE command. Refer to Chapter 9:
Error Values for possible <err> values. For EPS, the modification request for an EPS bearer resource will be answered by the network by an EPS bearer modification request. The request must be accepted by the MT before the
PDP context is effectively changed.
Test Command
Response
+CGCMOD: (list of < cid >s associated with active contexts)
AT+CGCMOD=?
OK
Response
Write Command
AT+CGCMOD[=<cid>[,
<cid>[,...]]]
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
3GPP TS 27.007 [13]
-
If no <cid>s are specified the activation form of the command modifies all active contexts. The test command returns a list of <cid>s associated with active contexts
Defined Values
< cid > Integer type; specifies a particular PDP context definition (see the
+CGDCONT command).
www.simcom.com
79/194
SIM7022 Series_AT Command Manual_V1.00
NOTE
Could only modify one cid one time.
Will block other commands when processing.
3.2.48 AT+CGEQOS Define EPS Quality of Service
AT+CGEQOS Define EPS Quality ofService
The set command allows the TE to specify the EPS Quality of Service parameters <cid>, <QCI>, [<DL_GBR> and <UL_GBR>] and
Description
[<DL_MBR> and <UL_MBR>] for a PDP context or Traffic
Flows (see 3GPP TS 24.301 [83] and 3GPP TS 23.203 [85]). When in
UMTS/GPRS the MT applies a mapping function to
UTMS/GPRS Quality of Service. Refer to Chapter 9: Error Values for possible <err> values.
A special form of the set command, +CGEQOS=<cid> causes the values for context number <cid> to become undefined.
Test Command
AT+CGEQOS=?
The read command returns the current settings for each defined QoS.
The test command returns the ranges of the supported parameters as compound values.
Response
+CGEQOS : (range of supported < cid >s),(list of supported < QCI >s),(list of supported < DL_GBR >s),(list of supported < UL_GBR >s),(list of supported
< DL_MBR >s),(list of supported < UL_MBR >s)
Read Command
AT+CGEQOS?
OK
Response
[+CGEQOS:
<cid>,<QCI>,[<DL_GBR>,<UL_GBR>],[<DL_MBR>,<UL_MBR>]][<CR><
LF>+CGEQOS:
<cid>,<QCI>,[<DL_GBR>,<UL_GBR>],[<DL_MBR>,<UL_M BR>]
[...]]
OK
Write Command
AT+CGEQOS=[<cid>[,
<QCI>[,<DL_GBR>,<U
L_GBR>[,<DL_MBR>,<
UL_MBR]]]]
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
www.simcom.com
80/194
SIM7022 Series_AT Command Manual_V1.00
3GPP TS 27.007 [13]
Defined Values
< cid >
< QCI >
< DL_GBR >
< UL_GBR >
< DL_MBR >
< UL_MBR >
Integer type; specifies a particular EPS Traffic Flows definition in EPS and a
PDP Context definition in UMTS/GPRS (see the +CGDCONT command).
Integer type;specifies a class of EPS QoS
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 (see 3GPP TS 24.301 [83]).
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 (see 3GPP TS 24.301 [83]).
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 (see 3GPP TS 24.301 [83]).
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 (see 3GPP TS 24.301 [83]).
3.2.49 AT+CGEQOSRDP EPS Quality of Service Read Dynamic Parameters
AT+CGEQOSRDP EPS Quality of Service Read Dynamic Parameters
Description
Test Command
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-secondaryactive PDP contexts are returned.
The test command returns a list of <cid>s associated with secondary or non-secondary active PDP contexts
Response
+CGEQOSRDP: (list of < cid >s)
AT+CGEQOSRDP=?
Write Command
AT+CGEQOSRDP
[=<cid>]
OK
Response
+CGEQOSRDP:
<cid>,<QCI>,[<DL_GBR>,<UL_GBR>],[<DL_MBR>,<UL_MBR>][<DL_A
MBR>,<UL_AMBR>]
[<CR><LF>+CGEQOSRDP: www.simcom.com
81/194
SIM7022 Series_AT Command Manual_V1.00
<cid>,<QCI>,[<DL_GBR>,<UL_GBR>],[<DL_MBR>,<UL_MBR>][<DL_A
MBR>,<UL_AMBR>]
[...]]
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
OK
If error is related to ME functionality:
Reference
3GPP TS 27.007 [13]
Defined Values
< cid >
< QCI >
< DL_GBR >
< UL_GBR >
< DL_MBR >
< UL_MBR >
<DL_AMBR>
<UL_AMBR>
Integer type; specifies a particular EPS Traffic Flows definition in EPS and a
PDP Context definition in UMTS/GPRS (see the +CGDCONT command).
Integer type; specifies a class of EPS QoS (see 3GPP TS 23.203 [85] and
3GPP TS 24.301 [83]).
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-guarenteed bit rate Traffic Flows
79 value for non-guaranteed bit rate Traffic Flows
[128 – 254] value range for Operator-specific QCIs
The QCI values 65, 66, 69 and 70 are not allowed to be requested by the UE.
If the TE requests a QCI parameter 65, 66, 69 or 70, the MT responds with result code +CME ERROR: 181 (unsupported QCI value).
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 (see 3GPP TS 24.301 [83]).
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 (see 3GPP TS 24.301 [83]).
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 (see 3GPP TS 24.301 [83]).
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 (see 3GPP TS 24.301 [83]).
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.
NOTE
Could set <QCI> only and only <QCI>=0 & 5 & 6 & 7 & 8 & 9 & 79 are supported.
Could execute only when power on and pdp context defined.
www.simcom.com
82/194
SIM7022 Series_AT Command Manual_V1.00
3.2.50 AT+CGTFT Traffic Flow Template
AT+
CGTFT Traffic Flow Template
Description
Test Command
AT+CGTFT=?
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. The concept is further described in the 3GPP TS 23.060 [47]. 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>. The specified TFT will be stored in the
GGSN in UMTS/GPRS and Packet GW in EPS only at activation or
MS-initiated modification of the related context. Since this is the same parameter that is used in the +CGDCONT command, the +CGTFT command is effectively an extension to these commands. The Packet Filters consist of a number of parameters, each of which may be set to a separate value.
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 ERROR or +CME ERROR response is returned. Extended error responses are enabled by the +CMEE command. Refer to Chapter 9 for possible <err> values.
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 and
PPP only. For PDP-type PPP a TFT is applicable only when IP traffic is carried over PPP. If PPP carries header- compressed IP packets, then a
TFT cannot be used.
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),(list of supported < local address www.simcom.com
83/194
SIM7022 Series_AT Command Manual_V1.00
and subnet mask >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 of supported
< direction >s),(list of supported < local address and subnet mask >s)
[...]]
Read Command
AT+CGTFT?
OK
Response
[ +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>,<local address and subnet mask>] [<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>,<local address and subnet mask>
[...]]
OK
Write Command
AT+CGTFT=[<cid>,[<p acket filter identifier>,<evaluation precedence index>[,<remote address and subnet mask>[,<protocol number (ipv4) / next header (ipv6)>[,<local port range>[,<remote port range>[,<ipsec securityparameter index (spi)>[,<type of service (tos) (ipv4) and mask / traffic class
(ipv6) and mask>[,<flow label
(ipv6)>[,<direction>[,<l ocal address and subnet mask>]]]]]]]]]]]
Response
OK
If error is related to ME functionality:
+CME ERROR: <err> www.simcom.com
84/194
SIM7022 Series_AT Command Manual_V1.00
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
3GPP TS 27.007 [13]
Defined Values
<
< cid >
PDP_type >
Integer type. Specifies a particular PDP context definition (see the
+CGDCONT commans).
String type. Specifies the type of packet data protocol (see the +CGDCONT command).
For the following parameters, see also 3GPP TS 23.060 [47]:
< packet identifier >
< evaluation subnet mask > filter precedence index >
< remote address and
Integer type. Value range is from 1 to 16.
Integer type. The value range is from 0 to 255.
String type. The string is given as dot-separated numeric (0-255) parameters on the form:
"a1.a2.a3.a4.m1.m2.m3.m4" for IPv4 or
"a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a16.m1.m2.m3.m4.m
5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15.m16", for IPv6.
When +CGPIAF is supported, its settings can influence the format of this parameter returned with the read form of +CGTFT.
< protocol number
(ipv4) / next header
(ipv6) >
< local port range >
Integer type. Value range is from 0 to 255.
String type. The string is given as dot-separated numeric (0-65535) parameters on the form "f.t".
< remote port range > String type. The string is given as dot-separated numeric (0-65535) parameters on the form "f.t".
< ipsec parameter
(spi) > security index
< type of service (tos)
(ipv4) and mask / traffic class (ipv6) and mask >
< flow label (ipv6) >
< direction >
Numeric value in hexadecimal format. The value range is from 00000000 to
FFFFFFFF.
String type. The string is given as dot-separated numeric (0-255) parameters on the form "t.m".
Numeric value in hexadecimal format. The value range is from 00000 to
FFFFF. Valid for IPv6 only.
Integer type. Specifies the transmission direction in which the packet filter shall be applied.
0 Pre-Release 7 TFT filter (see 3GPP TS 24.008 [8], table 10.5.162)
1 Uplink
2 Downlink www.simcom.com
85/194
SIM7022 Series_AT Command Manual_V1.00
< local address and subnet mask >
3 Birectional (Up & Downlink)
String type. The string is given as dot-separated numeric (0-255) parameters on the form:
"a1.a2.a3.a4.m1.m2.m3.m4" for IPv4 or
"a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a16.m1.m2.m3.m4.m
5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15.m16", for IPv6.
When +CGPIAF is supported, its settings can influence the format of this parameter returned with the read form of +CGTFT.
Some of the above listed attributes may coexist in a Packet Filter while others mutually exclude each other, the possible combinations are shown in 3GPP
TS 23.060 [47].
NOTE
Could execute only when power on and PDP context defined.
<local address and subnet mask> is not supported yet.
3.2.51 AT+IP R Set UE Baud Rate
AT+IPR Set UE Baud Rate
Description
Set command sets the UE baud rate to be used.
Read command returns the current baud rate.
Test Command
AT+IPR=?
Test command returns baud rates supported by the UE.
Response
+IPR:( list of supported auto detectable <rate> values),( list of fixed-only <rate> values)
Read Command
AT+IPR?
OK
Response
+IPR:<rate>
Write Command
AT+IPR=<rate>
OK
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time
Reference
www.simcom.com
86/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
<rate> Baud rate at which the UE will accept commands.
NOTE
If <rate> is 0 for set command, UE will enter auto baud rate detection mode and ‘AT’ or ‘at’ shall be sent for baud rate detection.
www.simcom.com
87/194
SIM7022 Series_AT Command Manual_V1.00
4 AT Commands for General
Commands
4.1 Overview of AT Commands for General
Command
AT$QCBAND
AT$QCLOGDBVER
AT$QCCFG
AT$QCPING
AT$QCFREQ
AT$QCRMFPLMN
AT$QCATTBEARER
AT$QCSENDDATA
+RECVNONIP
AT$QCPMUCFG
AT$QCSMSSEND
AT$QCCGSN
AT$QCRFSTAT
AT$QCRST
AT$QCPSMR
AT$QCPLMNS
AT$QCCESQS
AT$QCSTATUS
AT$QCICCID
AT$QCBCINFO
AT$QCDNS
AT$QCDNSCFG
AT$QCEMMTIME
AT$CPCFG
AT$QCSLEEP
Description
Set Supported Network and Bands.
Database Version Information.
UE Extended Configuration
Test IP Network Connectivity to a Remote Host
Lock or Unlock Cell
Remove FPLMN in NVM or SIM
Configure the PDN Info Request to Establish.
Send Data Via Control Plane or User Plane
Indicate Downlink NON-IP Data.
Set PMU mode
Send one SMS
Sets the IMEI and SN
Shows the Status of RF Calibration
Restart the Chip
Report the Power Saving Mode Status
Used to trigger a PLMN
Controls the Extended Signal Quality Change Event Reporting
Returns Some Key Parameter in UE Side
Causes the TA to Return the ICCID of the UICC
Return the Basic Serving Cell Information
Get the IP Address for a Specific URL
Set the Default DNS Addresses Configuration
Report and Get the Emm Time State
Set Plat Configure
Power Consumption Test
AT$QCSIMSLEEP
AT$QCCGSNLOCK
AT$QCSAVEFAC
Set UE to Allow SIM Card Sleep for Power Consumption
Set Lock Flag for IMEI and SN
Saves Related Regions to Default Reliable Region
AT+DMCONFIG
AT$QCTASKINFO
Device Manager Platform of China Mobile
Returns All the Task’s Information
AT$QCTASKHISTINFO Shows Most Recent Tasks’ Scheduling History www.simcom.com
88/194
SIM7022 Series_AT Command Manual_V1.00
AT$QCSHOWMEM
AT$QCSYSTEST
AT$QCVOTECHK
AT$QCURC
AT$QCPTWEDRXS
+ECPIN
Shows Current Heap Memory Usage
Triggers a Test Feature
Analyze the Reason of Sleep Failure
Close/Open URC Report
Control Whether the UE
Indicate SIM PIN State
+ECPCFUN
+ECPADDR
AT$QCADC
AT$QCSWC
AT$QCIPR
Print PDP Address
Read ADC
Set the UE Operation SIM Counter
Operate the Baud Rate of UE
AT$CNPICFG
AT$QCPRODMODE
AT$QCLEDMODE
Operating NPI
Control NPI production mode
Enable the Netlight Function
AT$QCPOWERCLASS Sets the Band Power Class
4.2 Detailed Descriptions of Commands
4.2.1 AT$QCBAND Set Supported Network and Bands
AT$QCBAND Set Supported Network and Bands
Description The command sets the network mode and bands to be used.
Test Command
Response
$QCBAND: ( list of supported <mode>s),( list of supported <band>s)
AT$QCBAND=?
Read Command
OK
Response
$QCBAND: <mode>,<band1>,<band2>,…
AT$QCBAND?
Write Command
OK
Response
]
AT$QCBAND=<mode>
[,<band1>[,<band2>…]
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
Defined Values
www.simcom.com
89/194
SIM7022 Series_AT Command Manual_V1.00
<mode>
<band>
0 NB-IOT mode(current support NB-IoT only)
Band list in decimal number:<band> values of 1, 3, 5, 8 are supported.
NOTE
The default value is decided by RF Calibration table.
4.2.2 AT$QCLOGDBVER Database Version Information
AT$QCLOGDBVER Database Version Information
Description This read command returns current unilog database version information.
Read Command
Response
$QCLOGDBVER: <LogDbVserion>
AT$QCLOGDBVER?
OK
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
4.2.3 AT$QCCFG UE Extended Configuration
AT$QCCFG UE Extended Configuration
The command set UE extended configuration.
Description
Test Command
The read command return current setting of each parameters.
The test command returns values supported as a compound value.
Response
$QCCFG: ( list of supported <param>s)
AT$QCCFG=?
Read Command
AT$QCCFG?
OK
Response
$QCCFG:
<param1>,<value1>,<param2>,<value2>…<paramN>,<valueN>
Write Command
OK
Response www.simcom.com
90/194
SIM7022 Series_AT Command Manual_V1.00
AT$QCCFG=<param1>
,<value1>[,<param2>,< value2>[,<param3>,<v alue3>,[…]]]
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
Defined Values
<param>
“AutoApn”
“UsimPowerSave”
“UsimSimulator”
“Rohc”
“Ipv6RsDelay”
“PowerCfun”
“PsPowerOnMaxDel ay”
“SupportSms”
“TauForSms”
“PlmnSearchPowerL evel”
“Epco”
“T3324MaxValueS”
0 NB-IOT mode(current support NB-IoT only)
Whether UE auto set the attached APN according to the inserted SIM card.
Supported values: (0,1)
Enable/disable USIM power save. Supported values: (0,1)
Enable/disable virtual SIM card for instrument test, such as CMW500.
Supported values: (0,1)
Whether UE support ROHC. Supported values: (0,1)
Delay in seconds then UE trigger IPv6 NDP (RS) procedure to get IPv6 prefix address. Supported values: (0-65535)
Default CFUN state after UE power-on or reboot; Supported values: (0,1,4) a) If set to 0, UE remain CFUN0 state (neither turn on protocol/RF nor SIM) after power-on or reboot; And could turn on protocol/RF and SIM via
AT+CFUN=1 b) If set to1, UE auto turn on protocol, and connect the network after power-on or reboot; c) If set to 4, UE only turn on SIM, disable (turn off) protocol/RF, after power-on or reboot;
Max dealy in seconds after power on, UE will delay in a random value between 0 to max delay value.
Supported values: (0-65535)
Whether UE support SMS. Supported values: (0,1)
Whether need to trigger TAU procedure, if UE support SMS capability, while
NW not support. Supported values: (0,1)
Set the PLMN search level when UE OOS; Supported values: (0,1,2,3)
0 - OOS PLMN search interval: 30 sec, 1 min, 2 min
1 - OOS PLMN search interval: 5 min, 10 min, 15 min
2 - OOS PLMN search interval: 10 min, 30 min, 1 hour
3 - OOS PLMN search interval: 30 sec, then stop PLMN search, and let AT:
AT$QCPLMNS to start PLMN search
Whether UE need to use “EPCO” in “PDN CONNECTION REQUEST” carried in “ATTACH REQUEST”, and “ESM INFORMATION RESPONSE”; If set to 0, just use “PCO”. Supported values: (0,1)
Set user control T3324 value in second. Support values: (0-0xFFFFFF) a) If T3324MaxValues is smaller than 0xFFFF and network configured T3324 www.simcom.com
91/194
SIM7022 Series_AT Command Manual_V1.00
is equal to or greater than T3324MaxValues (or network not configured
T3324),use the configured T3324MaxValues b) If T3324MaxValues is smaller than 0xFFFF and network configured T3324 is smaller than T3324MaxValues , use the network configured value c) If T3324MaxValues is equal to or greater than0xFFFF,just means disable this feature(use network configured value)
Whether UE support multi-carrier feature.Support values: (0,1) “MultiCarrier”
“MultiTone” Whether UE support multi-tone feature.Support values: (0,1)
“SupportUpRai”
“DataInactTimer”
Whether UE support L2 (MAC layer) RAI feature, which only valid whether set to R14 version. Supported values: (0,1)
Set the value of “data inactivity timer” in seconds, if this timer is not configured by NW (in MAC-MainConfig-NB), just use this setting value. Supported value:
(0,40-254) a) Default value: 60 b) If set to 0, just means this timer is invalid, don’t need to start.
Set the value of “SearchDeltaP” in DB for RelexMonitor feature. If this value is “RelaxMonitorDeltaP
” not configured by NW (in SIB-NB), just use this setting value.
Supported values: (0-15). Default value: 6.
“DisableNCellMeas” Whether UE support NCell measuring feature.Supported values: (0,1)
Set the value of NB-IOT category. Supported values: (1,2) “NbCategory”
“RelVersion”
<value>
Set the NB release version. Supported values: (13,14)
Value of configuration.
4.2.4 AT$QCPING Test IP Network Connectivity to a Remote Host
AT$QCPING Test IP Network Connectivity to a Remote Host
Description
Test Command
AT$QCPING=?
The command sends an ICMP packet to the specified host address.
AT$QCPING 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.
Response
$QCPING: ( list of supported <ipaddr/Url/mode>s),( list of supported <count> s),( list of supported <size>s),( list of supported <timeout>s)
Write Command
AT$QCPING=[<ipaddr/
OK
Response
OK www.simcom.com
92/194
SIM7022 Series_AT Command Manual_V1.00
Url>/<mode>[,<count>[
,<size>[,<timeout>]]]] or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<mode>
<ipaddr/Url>
<count>
<size>
<timeout>
0 Stop ping
String type, IP address or URL ping times: 1-255 default value: 4. 255 means all the time payload size: 1-5000 default value: 32.
UE ping reply timeout after ping request (ms).
<timeout> values between 1000 to 600000 are supported, and default value:
20000.
NOTE
When one PING reply received in <timeout>, an unsolicited result code: $QCPING: SUCC, dest:
<dest_ip_addr>, RTT: <rtt_time>ms will sent to TE..
If no PING reply received in <timeout>, an unsolicited result code: $QCPING: FAIL, dest:
<dest_ip_addr>, time out: <timeout>ms will sent to TE.
If this is an ERROR meet during PING procedure, an unsolicited result code: $QCPING: ERROR, cause: <cause> will sent to TE.
When PING procedure is done, an unsolicited result code: $QCPING:
DONE<CR><LF>$QCPING: 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.
4.2.5 AT$QCFREQ Lock or Unlock Cell
AT$QCFREQ Lock or Unlock Cell
Description The command set prefer EARFCN list, lock or unlock cell.
Test Command
AT$QCFREQ=?
Response
$QCFREQ: ( list of supported <mode>s)
OK www.simcom.com
93/194
SIM7022 Series_AT Command Manual_V1.00
Read Command
AT$QCFREQ?
Response
If neither set prefer EARFCN list nor lock EARFCN/cell :
OK
If set prefer EARFCN list:
$QCFREQ: <1>,<arfcn1>,<arfcn2>,…
If lock EARFCN or lock cell:
$QCFREQ: <2>,<arfcn>,<phyCellId>
OK
If both set prefer EARFCN list and lock EARFCN/cell:
$QCFREQ: <1>,<arfcn1>,<arfcn2>,…
$QCFREQ: <2>,<arfcn>,<phyCellId>
OK
Write Command
AT$QCFREQ=<mode>
(mode=0)
AT$QCFREQ=<mode>[
,<earfcn1>[,<earfcn2>
…]](mode=1)
AT$QCFREQ=<mode>,
<earfcn>[,<phyCellId>]
(mode2)
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<mode>
<earfcn>
<phyCellId>
0 Cancel cell lock
1 Set prefer EARFCN list
2 EARFCN lock, or cell lock
3 Clear prefer EARFCN
E-UTRA Absolute Radio Frequency Channel Number
Physical cell ID
NOTE
AT+ECFREQ must be restricted to execute in power off or air plane state.
www.simcom.com
94/194
SIM7022 Series_AT Command Manual_V1.00
4.2.6 AT$QCRMFPLMN Remove FPLMN in NVM or SIM
AT$QCRMFPLMN Remove FPLMN in NVM or SIM
Description Set command remove FPLMN in NVM or SIM.
Test Command
Response
$QCRMFPLMN: ( list of supported <mode>s)
AT$QCRMFPLMN=?
OK
Response
Write Command
AT$QCRMFPLMN=<m ode>
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<mode> 0 Remove FPLMN in NVM file and in SIM card
1 Remove FPLMN in NVM file
2 Remove FPLMN in SIM card
4.2.7 AT$QCATTBEARER Configure the PDN Info Request to Establish
AT$QCATTBEARER Configure the PDN Info Request to Establish
The set command is used to configure the PDN info request to establish during the attach process, if attach with PDN required.
Description
Test Command
AT$QCATTBEARER=?
The read command is used to obtain the configuration of the PDN info request to establish during the attach process.
The test command returns values supported as a compound value.
Response
$QCATTBEARER: ( list of supported <PDP_type>s),( list of supported
<eitf>s),( list of supported <IPv4AddrAlloc>s),( list of supported <NSLPI>s),( list of supported <IPv4_MTU_discovery>s),( list of supported <NonIP_MTU_discovery>s),( list of supported <auth_proto>s),),((userId string),(password string)
OK www.simcom.com
95/194
SIM7022 Series_AT Command Manual_V1.00
Read Command
AT$QCATTBEARER?
Response
$QCATTBEARER:<pdnType>,<eitf>,<apnStr>,<ipv4allocType>,<NSLPI
>,<ipv4Mtu>,<nonIpMtu>,<auth_proto>,<userId>,<password>
OK
Write Command
AT$QCATTBEARER=<
PDP_type>[,<eitf>[,<ap n>[,<IPv4AddrAlloc>[,
<NSLPI>[,<IPv4_MTU_ discovery>[,<NonIP_M
TU_discovery>,[<auth
_proto[,<userId>,<pas
Response
OK or
+CME ERROR: <err> sword>]>]]]]]]]
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
Defined Values
<PDP_type>
<eitf>
<apn>
<IPv4AddrAlloc>
<NSLPI>
<IPv4_MTU_discover y>
<NonIP_MTU_discov ery>
<auth_proto>
<userid>
<password>
1 IPv4
2 IPv6
3 IPv4v6
5 NON IP
0 Security protected ESM information transfer not required
1 Security protected ESM information transfer required
Apn string, the max length is 99 characters;
0 IPv4 address allocate through NAS signaling
1 IPv4 address allocate through DHCP (not applicable)
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 is to be activated with the value for the low priority indicator set to "MS is not configured for NAS signaling low priority".
0 IPv4 MTU size discovery not influenced by +ECATTBEARER
1 IPv4 MTU size discovery through NAS signaling
0 Non-IP MTU size discovery not influenced by +ECATTBEARER
1 Non-IP MTU size discovery through NAS signaling
0 None. Used to indicate that no authentication protocol is used for this PDP
1 PAP userId string, the max length is 20 characters; password string, the max length is 20 characters; www.simcom.com
96/194
SIM7022 Series_AT Command Manual_V1.00
4.2.8 AT$QCSENDDATA Send Data Via Control Plane or User Plane
AT$QCSENDDATA Send Data Via Control Plane or User Plane
Description The set command could send data via control plane or user plane
Test Command
AT$QCSENDDATA=?
Response
$QCSENDDATA: ( range of supported <cid>s),( maximum number of octets of user data indicated by <data_length>),( list of supported <RAI>s),( list of supported <type_of_user_data>s)
Write Command
AT$QCSENDDATA=<ci d>,<data_length>,<da ta>[,<RAI>[,<type_of_u ser_data>]]
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
Defined Values
<cid>
<data_length>
Integer type; specifies a particular PDP context definition.
Integer type. Indicates the number of octets of the <data>information element.
The max length is 950.
String of octets.
<data>
<RAI> 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 with the receipt of a DL packet.
<type_of_user_data> 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.
www.simcom.com
97/194
SIM7022 Series_AT Command Manual_V1.00
4.2.9 +RECVNONIP Indicate Downlink NON-IP Data
+ECSOCLI Indicate Downlink NON-IP Data
Description
This is an unsolicited code message used to indicate downlink NON-IP data.
Parameter Saving Mode -
+RECVNONIP: <cid>,<data_length>,<data>
Max Response Time
Reference
-
Defined Values
<cid>
<data_length>
<data>
Integer type; specifies a particular PDP context definition. <cid> values of 1-11 are supported.
Integer type. Indicates the number of octets of the <data> information element.
string of octets.
4.2.10 AT$QCPMUCFG Set PMU mode
AT$QCPMUCFG Set PMU mode
The command set PMU mode.
Description
Test Command
Response
$QCPMUCFG: ( range of supported <enable>s),( list of supported <mode>s)
AT$QCPMUCFG=?
Read Command
OK
Response
$QCPMUCFG: <enable>[,<mode>]
AT$QCPMUCFG?
OK
Response
Write Command
AT$QCPMUCFG=<ena ble>[,<mode>]
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Read command returns the current setup.
Test command returns values supported as a compound value.
www.simcom.com
98/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
<ENABLE>
<MODE>
0 Disable the PMU ， <mode> will be ignored and only enter idle
1 Enable the PMU
0 Active
1 Idle
2 Sleep1
3 Sleep2
4 Hibernate
4.2.11 AT$QCSMSSEND Send one SMS
AT$QCSMSSEND Send one SMS
Description
The command is used to send one SMS. Currently we only support TEXT mode.
Write Command
AT$QECSMSSEND=< mode>,<da>,[<toda>,<t est_sms>]
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<mode>
<da>
<toda>
<test_sms>
1 TEXT mode destination for TXT mode integer type; Type of destination address
Message’s content for TXT mode
4.2.12 AT$QCCGSN Sets the IMEI and SN
AT$QCCGSN Sets the IMEI and SN
Description
The command is used to send one SMS. Currently we only support TEXT mode.
www.simcom.com
99/194
SIM7022 Series_AT Command Manual_V1.00
Max Response Time
Reference
Response
Test Command
AT$QCCGSN=?
$QCCGSN: ( list of supported
OK
Response
Write Command
AT$QCCGSN=<type>,< sn/imei>
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
<type>s),(data)
-
Defined Values
<type>
<sn/imei>
Can be “IMEI” or “SN”
SN(31bytes maximum as visable character)
4.2.13 AT$QCRFSTAT Shows the Status of RF Calibration
AT$QCRFSTAT Shows the Status of RF Calibration
Description The command shows the status of RF calibration.
Test Command
AT$QCRFSTAT
Response
$QCRFSTAT
OK
Response
$QCRFSTAT: calibrate done
Execute Command
AT$QCRFSTAT
$QCRFSTAT: not calibrate
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
OK
If RF is not calibrated, response: www.simcom.com
100/194
4.2.14 AT$QCRST Restart the Chip
AT$QCRST Restart the Chip
Description The command restart the chip.
Execution Command
AT$QCRST
Response
OK
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
SIM7022 Series_AT Command Manual_V1.00
4.2.15 AT$QCPSMR Report the Power Saving Mode Status
AT$QCPSMR Report the Power Saving Mode Status
Description The command report the power saving mode status.
Test Command
AT$QCPSMR=?
Response
$QCPSMR: ( range of supported
OK
Response
$QCPSMR: <n>,<mode>
Read Command
AT$QCPSMR?
OK or
+CME ERROR: <err>
Response
Write Command
AT$QCPSMR=<n>
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
<n>s)
Defined Values
<n>
<mode> www.simcom.com
0: disable unsolicited result code
1: enable unsolicited result code +QCPSMR: <mode>
0: normal mode
101/194
SIM7022 Series_AT Command Manual_V1.00
1: power saving mode
4.2.16 AT$QCPLMNS Used to trigger a PLMN
AT$QCPLMNS Used to trigger a PLMN
Set command is used to trigger a PLMN search while UE is out of service, if
UE is not out of service,
Description +CME ERROR: <err> is returned.
Read command returns the current PLMN search state, and the reset of time of PLMN search timer.
Test Command
AT$QCPLMNS=?
Response
OK
Read Command
AT$QCPLMNS?
Response
$QCPLMNS: <state>[,<oosTimeStep>]
OK
Response
Execute Command
AT$QCPLMNS
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<state>
<oosTimeStep>
0 Deactivated, no PLMN search is ongoing
1 Searching, PLMN search is ongoing
2 Selected, already selected a PLMN
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.
4.2.17 AT$QCCESQS Controls the Extended Signal Quality Change Event Reporting
AT$QCCESQS Controls the Extended Signal Quality Change Event Reporting www.simcom.com
102/194
SIM7022 Series_AT Command Manual_V1.00
Description
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
Test Command
AT$QCCESQS=?
error, +CME ERROR: <err> is returned.
Response
$QCCESQS: ( list of supported
Read Command
AT$QCCESQS?
OK
Response
$QCCESQS: <report level>
Execution Command
AT$QCCESQS=<report level>
OK
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
<report level>s)
<rxlev>
<ber>
<rscp>
<ecno>
<rsrp>
<rsrq>
<snr>
Defined Values
<report level> 0 disable unsolicited report.
1 report +CESQ: <rxlev>,<ber>,<rscp>,<ecno>,<rsrq>,<rsrp>
2 report +ECCESQ: RSRP,<rsrp>,RSRQ,<rsrq>,SNR,<snr>
99 not known or not detectable
99 not known or not detectable
255 not known or not detectable
255 not known or not detectable
For +CESQ reporting, refer to sub clause 2.2.9 AT+CESQ
For +ECCESQ reporting, the range is -34 dB to 2.5 dB
For +CESQ reporting, refer to sub clause 2.2.9 AT+CESQ
For +ECCESQ reporting, the range is -34 dB to 2.5 dB
The range is -30 dB to 30 dB
4.2.18 AT$QCSTATUS Returns Some Key Parameter in UE Side
www.simcom.com
103/194
SIM7022 Series_AT Command Manual_V1.00
AT$QCSTATUS Returns Some Key Parameter in UE Side
Description
Test Command
AT$QCSTATUS=?
This action command returns some key parameter in UE side.
Response
$QCCESQS: ( list of supported <report level>s)
OK
Response
$QCSTATUS: PHY, DlEarfcn:<dlEarfcn>, UlEarfcn:<ulEarfcn>,
PCI:<pci>, Band:<band>, RSRP:<rsrp>, RSRQ:<rsrq>, SNR:<snr>,
CeLevel:<ceLevel>, DlBler:<dlBler>, UlBler:<ulBler>,
DataInactTimerS:<dataInactTimers>,
RetxBSRTimerP:<retxBSRTimerO>, NBMode:<nbMode>
$QCSTATUS: L2, SrbNum:<srbNum>, DrbNum:<drbNum>
Execution Command
AT$QCSTATUS
$QCSTATUS: RRC, State:<rrcState>, TAC:<tac>, CellId:<cellId>
$QCSTATUS: EMM, EmmState:<emmState>, EmmMode:<emmMode>,
PTWMs:<ptwMs>, EDRXPeriodMs:<eDRXPeriodMs>,
PsmExT3412TimerS:<psmExT3412TimerS>,
T3324TimerS:<T3324TimerS>,
T3346RemainTimeS:<T3346RemainTimeS>
$QCSTATUS: PLMN, PlmnState:<plmnState>,
PlmnType:<plmnType>, SelectPlmn:<selectPlmn>
$QCSTATUS: ESM, ActBearerNum:<actBearerNum>, APN:<apn>,
IPv4:<ipaddr>
$QCSTATUS: CCM, Cfun:<cfun>, IMSI:<imsi>
OK
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<dlEarfcn>
<ulEarfcn>
<pci>
<band>
<rsrp>
<rsrq> www.simcom.com
Downlink earfcn, value range is 0~262143
Uplink earfcn, value range is 0~262143
Physical cell ID, value range is 0~503,255
Band, value range is 0~70
Value in dBm, range is -156dBm ~ -44dBm
Value in dB, range is -34dB ~ -2.5dB
104/194
SIM7022 Series_AT Command Manual_V1.00
<snr>
<ceLevel>
<dlBler>
<ulBler>
<dataInactTimerS>
<retxBSRTimerP>
<NBMode>
<srbNum>
<drbNum>
<rrcState>
<tac>
<cellId>
<emmState>
<emmMode>
<ptwMs>
<edrxPeriodMs>
<psmExT3412Timer
S>
<T3324TimerS>
<T3346RemainTimeS
>
<plmnState>
<plmnType>
<selectPlmn>
<actBearerNum>
<apn>
<Ipv4Addr ipv6Addr>
<fun>
<IMSI>
Value in dB, range is -30dB ~ 30dB
0 CE level 0
1 CE level 1
2 CE level 2
Downlink block error, value range is 0~10000
Uplink block error, value range is 0~10000
Data inactive timer in seconds, value range is 0~180
Timer for BSR reporting, value in number of PDCCH periods. Value pp4 corresponds to 4 PDCCH periods, pp16 corresponds to 16
PDCCH periods and so on.
Value range is “InBand Same PCI”,” InBand Diff PCI”,”
Guard Band”,” Stand alone”
Value range is 0~2
Value range is 0~2
Value range is “DEACT”,” OOS”,” IDLE”,” SUSPEND IDLE”,” CONNECTED”,”
UNKONWN
Value range is 0~65534
Value range is 0~268435455
Value range is “NULL”,” DEREG”,” REG INIT”,” REG”,” DEREG INIT”,” TAU
INIT”,” SR INIT”,” UNKNOWN”
Value range is “IDLE”,” PSM”,” CONNECTED”,” UNKNOWN” eDRX Paging Time Window in milliseconds eDRX period in milliseconds
Extended T3412 timer value in seconds
T3324 timer value in seconds
If T3346 is running, set to the remaining time, else set to 0
Value range is "NO PLMN", "SEARCHING", "SELECTED", "UNKNOWN"
Value range is "HPLMN", "EHPLMN", "VPLMN", "UPLMN", "OPLMN",
"UNKNOWN"
Selected PLMN activated bearer number access point name
Ipv4/Ipv6 address
0 Minimum functionality
1 Full functionality
4 Turn off RF
International Mobile Subscriber Identity (string with double quotes) www.simcom.com
105/194
SIM7022 Series_AT Command Manual_V1.00
4.2.19 AT$QCICCID Causes the TA to Return the ICCID of the UICC
AT$QCICCID Causes the TA to Return the ICCID of the UICC
Description Execution command causes the TA to return the ICCID of the UICC.
Test Command
AT$QCICCID=?
Response
OK
Response
$QCICCID: <ICCID>
Execution Command
AT$QCICCID
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
OK or
Defined Values
<ICCID> Integrated circuit card identification
4.2.20 AT$QCBCINFO Return the Basic Serving Cell Information
AT$QCBCINFO Return the Basic Serving Cell Information
Description
Execution command to return the basic serving cell information and neighbor cells information, mainly used for location service.
Test Command
AT$QCBCINFO=?
Response
OK
Response
$QCBCINFOSC:
<earfcn>,<pci>,<rsrp>,<rsrq>,<mcc>,<mnc>,<cellid>[<CR><LF>+ECB
Execution Command
AT$QCBCINFO
CINFONC: <earfcn>,<pci>,<rsrp>,<rsrq> […]]
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
www.simcom.com
106/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
<earfcn>
<pci>
<rsrp>
<rsrq>
<mcc>
<mnc>
<cellId>
Indicate the EARFCN of the cell. Range 0 ~ 262143
Indicate the physical cell ID. Range 0 ~ 503
Indicate the measurement of RSRP value, in unit of dBm. Range -
156 ~ -44
Indicate the measurement of RSRQ value, in unit of dB. Range -34 ~
25
Indicate the mobile country code
Indicate the mobile network code
Four byte E-UTRAN cell ID in hexadecimal format
4.2.21 AT$QCDNS Get the IP Address for a Specific URL
AT$QCDNS Get the IP Address for a Specific URL
Description
This command to get the IP address for a specific URL. As a limitation now, only one IP address is returned for a URL
Test Command
AT$QCDNS=?
Response
OK
Execution Command
AT$QCDNS=<url>
Response
$QCDNS: <ipaddr>
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<url>
<ipaddr>
Domain name
If IPv4 type, output is dot-notation format, such as: “32.1.13.184”
If IPv6 type, output is colon-notation format, such as:
“ 2001:0DB8:0000:CD30:0000:0000:0000:0002” www.simcom.com
107/194
SIM7022 Series_AT Command Manual_V1.00
4.2.22 AT$QCDNSCFG Set the Default DNS Addresses Configuration
AT$QCDNSCFG Set the Default DNS Addresses Configuration
Description
This command to get the IP address for a specific URL. As a limitation now, only one IP address is returned for a URL
Test Command
AT$QCDNSCFG=?
Response
OK
Read Command
AT$QCDNSCFG?
Response
$QCDNSCFG: <ipaddr1>[,<ipaddr2>[,<ipaddr3>[,<ipaddr4>]]]
Execution Command
AT$QCDNSCFG=<ipad dr1>[,<ipaddr2>[,<ipad
OK
Response
OK or dr3>[,<ipaddr4>]]] +CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time -
Reference
Defined Values
<ipaddr> If IPv4 type, output is dot-notation format, such as: “32.1.13.184”
If IPv6 type, output is colon-notation format, such as:
“ 2001:0DB8:0000:CD30:0000:0000:0000:0002”
4.2.23 AT$QCEMMTIME Report and Get the Emm Time State
AT$QCEMMTIME Report and Get the Emm Time State
Description
This command report and get the Emm Time State, include T3346 、 T3448 and T3412/extend T3412.
Test Command
AT$QCEMMTIME=?
Response
$QCEMMTIME: ( range of supported <bitmap>s)
Read Command
AT$QCEMMTIME?
OK
Response
$QCEMMTIME:0,<timeState>[,<remainTimeValue>]
$QCEMMTIME:1,<timeState>[,<remainTimeValue>]
$QCEMMTIME:2,<timeState>[,<remainTimeValue>]
OK www.simcom.com
108/194
SIM7022 Series_AT Command Manual_V1.00
Write Command
AT$QCEMMTIME=<bit
Response
OK or map>
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<bitmap>
<timeId> bit 0: enable/disable unsolicited result code T3346 bit 1: enable/disable unsolicited result code T3448 bit 2: enable/disable unsolicited result code T3412/ext T3412
0: Emm Timer: T3346
1: Emm Timer: T3448
2: Emm Timer: T412/ext T3412
<timeState> 0: Start
1: Stop
2: Expiry
<remainTimeValue> Time remain value in seconds, Only include when <timeState> is 0.
<timeValue> Time value in seconds, Only include when <timeState> is 0.
4.2.24 AT$QCPCFG Set Plat Configure
AT$QCPCFG Set Plat Config
Description
Set command is used to set plat config, if UE is not out of service, +CME
ERROR: <err> is returned.Read command returns the current plat config setting.
Test Command
AT$QCPCFG=?
Response
$QCPCFG:<mode>,<value>
Read Command
AT$QCPCFG?
OK
Response
$QCPCFG:
<mode>,<value>,<mode>,<value>,…
Write Command
AT$QCPCFG=<mode>,
<value>
OK
Response
OK or
+CME ERROR: <err> www.simcom.com
109/194
SIM7022 Series_AT Command Manual_V1.00
Parameter Saving Mode SAVE
Max Response Time -
Reference
Defined Values
<mode>
<value> faultAction Set the hardfault action mode dumpToATPort Set show assert dump in AT port or not startWDT logCtrl logLevel
Set watch dog mode
Set log control mode
Set log print level logBaudrate Set log print baud rate slpWaitTime Set sleep wait time
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.
For dumpToATPort, the values range is from 0 to 1
0: not dump to AT port
1: dump to AT port
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.
Default value is 3000000.
For slpWaitTime, the values range is from 0 to 0xffff
Default value is 0.
www.simcom.com
110/194
SIM7022 Series_AT Command Manual_V1.00
4.2.25 AT$QCSLEEP Power Consumption Test
AT$QCSLEEP Power Consumption Test
Description
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.
Response
$QCSLEEP: <state> Test Command
AT$QCSLEEP=?
Write Command
AT$QCSLEEP=<state>
OK
Response
$QCSLEEP: <mode>
OK or
+CME ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time -
Reference
Defined Values
<state>
<mode>
0 HIB2
1 HIB1
2 SLEEP2
3 SLEEP1
HIB2 Hibernate2 status
HIB1 Hibernate1 status
SLEEP2 Sleep2 status
SLEEP1 Sleep1 status
4.2.26 AT$QCSIMSLEEP Set UE to Allow SIM Card Sleep for Power Consumption
AT$QCSIMSLEEP Set UE to Allow SIM Card Sleep for Power Consumption
Description
The command set UE to allow SIM card sleep for power consumption.
The read command return current setting of each parameters.
Test Command
AT$QCSIMSLEEP=?
The test command returns values supported as a compound value.
Response
$QCSIMSLEEP: <mode> www.simcom.com
111/194
SIM7022 Series_AT Command Manual_V1.00
OK
Response
Write Command
AT$QCSIMSLEEP=<m ode>
OK or
+CME ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time
Reference
-
Defined Values
<mode> 0 Not allowed SIM sleep
1 Allowed SIM sleep
4.2.27 AT$QCCGSNLOCK Set Lock Flag for IMEI and SN
AT$QCCGSNLOCK Set Lock Flag for IMEI and SN
This command is used to set lock flag for IMEI and SN. If locked, IMEI and
Description
SN could not be write via AT$QCCGSN 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).
Test Command
AT$QCCGSNLOCK=?
Response
$QCCGSNLOCK: < list of support para>
OK
Response
$QCCGSNLOCK: <imeistatus,snstatus>
Read Command
AT$QCCGSNLOCK?
+CME ERROR: <err>
Response
Write Command
AT$QCCGSNLOCK=<p ara>
OK or
+CME ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time -
Reference
OK or www.simcom.com
112/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
<para>
<imeistatus>
<snstatus>
"IMEI"
"SN"
"IMEI LOCKED"
"IMEI NOT LOCKED "
"SN LOCKED"
"SN NOT LOCKED "
4.2.28 AT$QCSAVEFAC Saves Related Regions to Default Reliable Region
AT$QCSAVEFAC Saves Related Regions to Default Reliable Region
Description
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.
Test Command
Response
$SAVEFAC: <mode>
AT$QCSAVEFAC=?
OK
Response
Write Command
AT$QCSAVEFAC=<mo de>
OK or
+CME ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time
Reference
-
Defined Values
<mode> "all" All regions
"rfregion" Only RF regions
"other" Regions except RF, currently IMEI/SN region
4.2.29 AT+DMCONFIG Device Manager Platform of China Mobile
www.simcom.com
113/194
SIM7022 Series_AT Command Manual_V1.00
AT+DMCONFIG Device Manager Platform of China Mobile
The command set the parameters need by registering to the Device
Description
Read Command
AT+DMCONFIG?
Manager Platform of China Mobile.
The read command returns the relevant parameters that have been set.
Response
+DMCONFIG:
<mode>,<lifetime>,<appkey>,<secret>,<platform>
Set Command
AT+DMCONFIG=<mod e>,<lifetime>,<appkey
>,<secret>,<platform>
OK or
+CME ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time
Reference
-
OK
Response
Defined Values
<mode>
<lifetime>
<appkey>
<secret>
<platform>
0 Not register to DM platform
1 Register to DM platform
Lifetime, unit: minute
A sting of characters given by China Mobile
A sting of characters given by China Mobile
0 Register to commercial platform
1 Register to test platform
4.2.30 AT$QCTASKINFO Returns All the Task’s Information
AT$QCTASKINFO Returns All the Task’s Information
Description
The execution command returns all the task’s name, id, status, priority and stack information. This command is only for debug purpose.
Execution Command
AT$QCTASKINFO
Response
$QCTASKINFO: <task information>
OK
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
www.simcom.com
114/194
SIM7022 Series_AT Command Manual_V1.00
4.2.31 AT$QCTASKHISTINFO Shows Most Recent Tasks’ Scheduling History
AT$QCTASKHISTINFO Shows Most Recent Tasks’ Scheduling History
Description
The execution command shows most recent tasks’ scheduling history. This command is only for debug purpose.
Execution Command
AT$QCTASKHISINFO
Response
$QCTASKHISINFO: <task scheduling history>
OK
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
4.2.32 AT$QCSHOWMEM Shows Current Heap Memory Usage
AT$QCSHOWMEM Shows Current Heap Memory Usage
Description
Execution Command
AT$QCSHOWMEM
Response
$QCSHOWMEM: <curr_free_heap,min_free_heap>
OK
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
The execution command shows current heap memory usage. This command is only for debug purpose.
Defined Values
<curr_free_heap>
<min_free_heap>
0—heap size current remained free memory size in heap
0---heap size minimum heap memory size ever remaining in heap
4.2.33 AT$QCSYSTEST Triggers a Test Feature
AT$QCSYSTEST Triggers a Test Feature
Description
This command is only for debug purpose.
The test command returns option supported as a compound value.
The set command triggers a test feature..
www.simcom.com
115/194
SIM7022 Series_AT Command Manual_V1.00
Response
Test Command
AT$QCSYSTEST=?
$QCSYSTEST: <option>
Write Command
AT$QCSYSTEST=<opti on>
OK
Response
OK or
When <test>=”assert” or "fsassert" system assert
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
Defined Values
<option> handshake Perform handshake with UE assert Trigger a test assert testwdt fsassert hardfault
Trigger watch dog test
Trigger file system assert for test
Trigger a hardfault for test
4.2.34 AT$QCVOTECHK Analyze the Reason of Sleep Failure
AT$QCVOTECHK Analyze the Reason of Sleep Failure
This command shows current vote state, which can help to analyze the
Description
Write Command
AT$QCVOTECHK
Response
Sleep Vote Info:
<vote info detail>
OK
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
reason of sleep failure.
This command is only for debug purpose.
NOTE
Vote info detail shows comprehensive information which will affect sleep process in EC616 SDK.
Part1: user set sleep depth limitation.
Part2: EC internal sleep vote result.
www.simcom.com
116/194
SIM7022 Series_AT Command Manual_V1.00
Part3: application vote result.
Part4: user registered sleep depth callback.
Part5: driver vote result.
For more detail information, please refer to slpman_ec616.h in SDK and EC616 low power development manual.
4.2.35 AT$QCURC Close/Open URC Report
AT$QCURC Close/Open URC Report
Description
Test Command
AT$QCURC=?
The command close/open URC (unsolicited result code) report.
Response
$QCURC:“ALL”:(0-1),“CREG”:(0-1),“CEREG”:(0-1),“CEDRXP”:(0-1),“C
CIOTOPTI”:(0-1),“CSCON”:(0-1),“ECCESQ”:(0-1),“CGEV”:(0-1),“ECPS
MR”:(0-1),“PTWEDRX”:(0-1),“ECPTWEDRXP”:(0-1),“ECPIN”:(0-1),“EC
PADDR”:(0-1),“ECPCFUN”:(0-1)
Read Command
AT$QCURC?
OK
Response
$QCURC:
"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),"E
CPSMR":(0-1),"ECPTWEDRXP":(0-1),"ECPIN":(0-1),"ECPADDR":(0-1),"
ECPCFUN":(0-1)
OK
Write Command
AT$QCURC=<option>,
<value> or
+CME ERROR: <err>
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time
Reference
-
Defined Values
<option> “ ALL” All unsolicited result codes included as below
“ CREG” unsolicited result code +CREG
“ CEREG” unsolicited result code +CEREG www.simcom.com
117/194
<value>
SIM7022 Series_AT Command Manual_V1.00
“ CEDRXP” unsolicited result code +CEDRXP
“ CCIOTOPTI” unsolicited result code +CCIOTOPTI
“ CSCON” unsolicited result code +CSCON
“ CTZU” unsolicited result code +CTZU
“ 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
0 disable unsolicited result code report
1 enable unsolicited result code report
NOTE
Set of <value> will save to NVM, and the default value is 0.
4.2.36 AT$QCPTWEDRXS Control Whether the UE
AT$QCPTWEDRXS Control Whether the UE
A special form of the command can be given as AT$QCPTWEDRXS=3. In
Description
Test Command
AT$QCPTWEDRXS=?
this form, paging time window and eDRX will be disabled and data for all parameters in AT$QCPTWEDRXS command will be removed.
Response
$QCPTWEDRXS: ( list of supported <mode>s),( list of supported
<AcT-type>s),( list of supported <Requested_Paging_time_window>s),( list of supported <Requested_eDRX_value>s)
Read Command
AT$QCPTWEDRXS?
OK
Response
$QCPTWEDRXS:<AcT-type>,<Requested_Paging_time_window>,<Re quested_eDRX_value>[,<NW_provided_eDRX_VALUE>[,<Paging_time
_window>]]
Write Command
AT$QCPTWEDRXS=[< mode>[,<AcT-type>[,<
Requested_Paging_ti www.simcom.com
OK
Response
OK or
+CME ERROR: <err>
118/194
SIM7022 Series_AT Command Manual_V1.00
me_window>[,<Reque sted_eDRX_value>]]]]
Parameter Saving Mode AUTO_SAVE
Max Response Time
Reference
-
Defined Values
<mode>
<AcT-type>
<Requested_Paging
_time_window>
<Requested_eDRX_v alue>
<NW-provided_eDRX
_value>
<Paging_time_windo w>
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>[,<NWprovided_eDRX_value>[,<Paging_time_wi ndow>]]]
3 Disable the use of paging time window and eDRX and discard all parameters for pagint time window and eDRX.
5 NB IOT
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)
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)
4.2.37 $QCPIN Indicate SIM PIN State
+EPIN Indicate SIM PIN State
Description
This is an unsolicited result code used to indicate SIM PIN state. It’s controlled by AT$QCURC.
$QCPIN: <code>
Defined Values
www.simcom.com
119/194
<code>
SIM7022 Series_AT Command Manual_V1.00
READY MT is not pending for any password
SIM PIN MT is waiting SIM PIN to be given
SIM PUK MT is waiting SIM PUK to be given
SIM PUK BLOCKED The SIM is locked
SIM NOT READY The SIM is not ready.
4.2.38 $QPCFUN Power on status URC report
$QCPCFUN Power on status URC report
Description
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.
$QPCFUN: <fun>
Defined Values
<fun> 0 Minimum functionality
1 Full functionality
4 Turn off RF.
4.2.39 $QCPADDR Print PDP Address
$QCPADDR Print PDP Address
Description
This is an unsolicited result code used to indicate SIM PIN state. It’s controlled by AT$QCURC.
$QCPADDR: <cid>[,<PDP_addr_1>[,<PDP_addr_2>]]
Defined Values
<cid>
<PDP_addr_1>
<PDP_addr_2> specifies a particular PDP context definition (see the
+CGDCONT commands).
<cid> values of 1-11 are supported.
<PDP_addr_1> and <PDP_addr_2>: each is a string type that 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: www.simcom.com
120/194
SIM7022 Series_AT Command Manual_V1.00
a1.a2.a3.a4 for IPv4 and colon-separated hexadecimal parameter of the form:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx for IPv6.
4.2.40 AT$QCADC Read ADC
AT$QCADC Read ADC
Description
This command is used to get thermal temperature and VBAT values sampled by ADC.
Test Command
Response
$QCADC: <option>
AT$QCADC=?
Write Command
AT$QCADC=<option>
OK
Response
$QCADC: <option>,<value>[,<option>,<value>]
OK
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<option>
<value>
Temp Get current thermal temperature in unit of degree centigrade with 1 degree resolution.
Vbat Get current VBAT value in unit of mV.
All Get current thermal temperature and VBAT value.
Corresponding value of option
4.2.41 AT$QCSWC Set the UE Operation SIM Counter
AT$QCSWC Set the UE Operation SIM Counter
Description
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
Test Command
AT$QCSWC=?
Response
$QCSWC: (list of supported <mode>s) www.simcom.com
121/194
SIM7022 Series_AT Command Manual_V1.00
OK
Read Command
AT$QCSWC?
Write Command
AT$QCSWC=<mode>
Response
$QCSWC: <mode>
OK
Response
OK or
+CME ERROR: <err>
When <mode>=2 and command successful:
$QCSWC: <filename>,<counter>
$QCSWC: <filename>,<counter>
…
OK
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
-
Defined Values
<mode>
<filename>
<counter>
0 Disable the SIM write counter
1 Enable the SIM write counter
2 Query the SIM write counter
3 Reset all SIM write counter as 0
SIM EF name, referred to TS31.102, “null” means no file writed.
if overflow occurs, restart from 0.
4.2.42 AT$QCIPR Operate the Baud Rate of UE
AT$QCIPR Operate the Baud Rate of UE
Set command sets the UE baud rate to be used.
Description
Test Command
AT$QCIPR=?
Read command returns the current baud rate.
Test command returns baud rates supported by the UE.
Response
$QCIPR: ( list of fixed-only <rate> values )
Read Command
AT$QCIPR?
OK
Response
$QCIPR:<rate> www.simcom.com
122/194
SIM7022 Series_AT Command Manual_V1.00
Max Response Time
Reference
OK
Write Command
AT$QCIPR=<rate>
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
-
Defined Values
<rate> Baud rate at which the UE will accept commands.
4.2.43 AT$QCNPICFG Operating NPI
AT$QCNPICFG Operating NPI
Description
Test Command
AT$QCNPICFG=?
Set command is used to set NPI config
Read command returns the current NPI config setting.
Response
$QCNPICFG: <option>,<value>
Read Command
AT$QCNPICFG?
OK
Response
$QCNPICFG:
"rfCaliDone":<value>,”rfNSTDone”:<value>
Write Command
AT$QCNPICFG=<optio n>,<setting>
OK
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time -
Reference
Defined Values
www.simcom.com
123/194
<option>
<setting>
SIM7022 Series_AT Command Manual_V1.00
rfCaliDone Set RFCALI process status rfNSTDone Set RFNST process status
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
4.2.44 AT$QCPRODMODE Control NPI production mode
AT$QCPRODMODE Control NPI production mode
Description
Set command is used to control entering NPI production mode.
Read command returns the current NPI production mode status.
Test Command
AT$QCPRODMODE=?
Response
$QCPRODMODE: <status>
Read Command
AT$QCPRODMODE?
OK
Response
$QCPRODMODE:
"prodModeEnable":<value1>,”prodModeEnter ” :<value2>
OK
Response
Write Command
AT$QCPRODMODE=<s etting>
OK or
+CME ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time
Reference
-
Defined Values
<setting>
<value1>
<value2> www.simcom.com
prodModeEnable Enable production mode prodModeDisable Disable production mode prodModeEnter Enter production mode prodModeExit Exit production mode
0: prodMode is disabled
1: prodMode is enabled
0: prodMode isn’t entered
124/194
SIM7022 Series_AT Command Manual_V1.00
<status>
1: prodMode is entered reflects prodMode status
4.2.45 AT$QCLEDMODE Enable the Netlight Function
AT$QCLEDMODE Enable the Netlight Function
Description
Set command is used to control entering NPI production mode.
Read command returns the current NPI production mode status.
Test Command
Response
$QCLEDMODE: (0,1)
AT$QCLEDMODE=?
Read Command
OK
Response
$QCLEDMODE: <state>
AT$QCLEDMODE?
OK
Response
Write Command
AT$QCLEDMODE=<sta te>
OK or
+CME ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time
Reference
-
Defined Values
<state> 0 Netlight function disable
1 Netlight function enable
NOTE
In EC NB-IoT SDK, Netlight is set to PAD 30 using PWM Instance 5. It can be changed by rewrite
NetLightInit function (in bsp_custom.c).
Netlight function may cause extra power consumption
All sleep is disabled, until NB enter Idle/PSM
A pull-down resistor is needed to keep Pad low to avoid unwanted flickerl.
Netlight Indication Note NB Status
HighLevel 64ms(LED ON)/ LowLevel 800ms(LED OFF) Network searching
HighLevel 64ms(LED ON)/ LowLevel 2000ms(LED OFF) Network connected in NB Connect state www.simcom.com
125/194
SIM7022 Series_AT Command Manual_V1.00
Keep Low Level NB Idle/PSM or other
4.2.46 AT$QCPOWERCLASS Sets the Band Power Class
AT$QCPOWERCLASS Sets the Band Power Class
Description
The command sets the band power class.
Read command returns the current band and releated power class setting.
Test command returns the bands and releated power class supported by the
UE.
Test Command
AT$QCPOWERCLASS
=?
Response
$QCPOWERCLASS: <band1>,(list of supported <power class>s)
$QCPOWERCLASS: <band2>,(list of supported <power class>s)
…
Read Command
AT$QCPOWERCLASS
?
OK
Response
$QCPOWERCLASS: <band1>,<power class>
$QCPOWERCLASS: <band2>,<power class>
…
Write Command
AT$QCPOWERCLASS
=<band>,<powerclass
>
OK or
+CME ERROR: <err>
Parameter Saving Mode AUTO_SAVE
Max Response Time
Reference
-
OK
Response
Defined Values
<band>
<power class>
Band in decimal number.All bands supported by RF.
0 is to set power class of all bands.
3 UE maximum output power is 23dBm
5 UE maximum output power is 20dBm
6 UE maximum output power is 14dBm
NOTE www.simcom.com
126/194
SIM7022 Series_AT Command Manual_V1.00
AT$QECPOWERCLASS must be restricted to execute under power off or air plane state.Parameter
<power class> can only be set to 6 when ‘RelVersion’ in AT+ECCFG is 14.When set parameter <power class> to 6,parameter <band> must be set to 0.
www.simcom.com
127/194
SIM7022 Series_AT Command Manual_V1.00
5 AT Commands for Socket
5.1 Overview of AT Commands for Socket
Command
AT$QCSOCR
AT$QCSOST
AT$QCSOSTF
AT$QCQSOS
AT$QCSORF
AT$QCSOCO
AT$QCSOSD
AT$QCSOCL
+ECSONMI
+ECSOCLI
AT$QCSONMI
AT$QCSONMIE
Description
Create Socket
SendTo Command (UDP only)
SendTo Command with flags(UDP only)
Query Socket Messages Sent Pending Data List
Receive Command
Connect Command (TCP only)
Send Command (TCP only)
Close Socket
Socket message arrived indicator (Response Only)
Socket close indicator (Response Only)
Set the Public Max Downlink Buffer Size
Arrived messages of a specified socket
5.2 Detailed Descriptions of Commands
5.2.1 AT$QCSOCR Create Socket
AT$QCSOCR Create Socket
This command creates a socket on the UE. If the port is set, receiving is
Description enabled and unsolicited $QCSONMI messages will appear for any message that is received on that port. Refer to Chapter 9: Error Values for possible <err> values.
If a socket has already been created for a protocol, port combination,
$QCSOCR will fail if requested a second time.
Write Command
Response
<socket>
AT$QCSOCR=<type>,< protocol>[,<listen port>[,<receive control>[,<af_type>[,<i paddress>]]]]
OK
If failed:
+CME ERROR: <err> www.simcom.com
128/194
SIM7022 Series_AT Command Manual_V1.00
Write Command
AT$QCSOCR=?
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Response
$QCSOCR:( list of supported <type>s), ( list of supported <protocol>s),( list of supported <listen_port>s),( list of supported <receive_control>s),( list of supported <af_type>s),(<ip_addr>)
Defined Values
< type >
< protocol >
< listen port >
< socket >
< receive control >
< af_type >
< ip address >
Socket Type. DGRAM for UDP, STREAM for TCP
Standard internet protocol definition. For example, UDP is 17.
A number in the range 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, and used for TCP, LWIP will assign a random <listen port> for this socket.
This is a reference to the created socket. It is an integer greater than or equal to 0
Set to 1 if incoming messages should be received, 0 if incoming messages should be ignored. Defaults to 1 (messages will be received)
String type.
"AF_INET" IPv4 type
"AF_INET6" IPv6 type
The IP address NW assigned to MT.
NOTE
A maximum of 7 sockets are supported, but other services may reduce this number.
Only UDP(protocol 17), TCP(protocol 6) supported.
<listen port> value of 20000 for TCP can’t be set when bip is enabled.
5.2.2 AT$QCSOST SendTo Command (UDP only)
AT$QCSOST SendTo Command (UDP only)
This command sends a UDP datagram to the specified host:port. It will
Description return with the socket and the number of bytes of data to be sent. If the amount of data is larger than the largest datagram that can be sent, the
$QCSOST return value will indicate how much of the data was successfully sent.
If <sequence>is not omitted, when datagram is sent by rf or discard, will www.simcom.com
129/194
SIM7022 Series_AT Command Manual_V1.00
Write Command
AT$QCSOST=<socket
>,<remote_addr>,<rem ote_port>,<length>,<d ata>[,<sequence>,[<se gment_id>,<segment_ num]]
Test Command
AT$QCSOST=?
report the result.
Response
<socket>,<length>
OK
If failed:
+CME ERROR: <err>
If <sequence>is not omitted, when datagram is sent by rf or discard, will report the result.
$QCSOSTR:<socket>,<sequence>,<status>
Response
$QCSOST:( list of supported <socket>s),(<remote_addr>),( list of supported <remote_port>s),( list of supported <length>s),(<data>),( list of supported <sequence>s),( list of supported <segment_id>s),( list of supported <segment_num>s)
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
< socket >
< remote addr >
< remote port >
< length >
< data >
< sequence >
< status >
< segment_id >
< segment_num >
Socket number returned by $QCSOCR
IP address
A number in the range 0-65535. This is the remote port that messages will be received on
Decimal length of data to be sent.
Data to be transmitted in hex string format, or quoted string format.
Sequence of data, range 1-255.If omit, will not report data sent status.
The status of datagram.
0 Error
1 Sent
Integer type.
1-4 One segment index of a segment message.
Integer type.
2-4 The total number which the messages will fragment.
NOTE
Maximum data size is 1358 bytes.
<data> Only hex string format is supported
IP addresses can be specified in decimal, octal or hexadecimal notation.
www.simcom.com
130/194
SIM7022 Series_AT Command Manual_V1.00
Data can’t be transferred if MT don’t have address (could use +CGPADDR to get)
5.2.3 AT$QCSOSTF SendTo Command with Flags(UDP only)
AT$QCSOSTF SendTo Command with Flags(UDP only)
This command sends a UDP datagram to the specified host:port. It will return with the socket and the number of bytes of data to be sent. If the
Description
Write Command amount of data is larger than the largest datagram that can be sent, the
$QCSOSTF return value will indicate how much of the data was successfully sent.
Response
<socket>,<length>
AT$QCSOSTF=<socke t>,<remote_addr>,<re mote_port>,<flag>,<le ngth>,<data>[,<sequen ce>,[<segment_id>,<s egment_num]]
Test Command
AT$QCSOSTF=?
OK
If failed:
+CME ERROR: <err>
If <sequence>is not omitted, when datagram is sent by rf or discard, will report the result.
$QCSOSTR:<socket>,<sequence>,<status>
Response
$QCSOSTF:( list of supported <socket>s),(<remote_addr>),( list of supported <remote_port>s),( list of supported <flag>s),( list of supported
<length>s),(<data>),( list of supported <sequence>s),( list of supported
<segment_id>s),( list of supported <segment_num>s)
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
< socket >
< remote addr >
< remote port >
< flag > www.simcom.com
Socket number returned by $QCSOCR
IP address
A number in the range 0-65535. This is the remote port that messages will be received on
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 message with high priority
0x200 Release Indicator: indicate release after next message
131/194
< length >
< data >
< sequence >
< status >
<segment_id>
<segment_num>
SIM7022 Series_AT Command Manual_V1.00
0x400 Release Indicator: indicate release after next message has been replied to
If no flags are set, a value of 0 should be provided.
Decimal length of data to be sent.
Data to be transmitted in hex string format, or quoted string format.
Sequence of data, range 1-255.If omit, will not report data sent status.
The status of datagram.
0 Error
1 Sent
Integer type.
1-4 One segment index of a segment message.
Integer type.
2-4 The total number which the messages will fragment.
NOTE
Maximum data size is 1358 bytes.
<data> Only hex string format is supported
IP addresses can be specified in decimal, octal or hexadecimal notation.
Data can’t be transferred if MT don’t have address (could use +CGPADDR to get)
5.2.4 AT$QCQSOS Query Socket Messages Sent Pending Data List
AT$QCQSOS Query Socket Messages Sent Pending Data List
Description This command queries the list of the pending upstream message by MT.
Write Command
Response
[$QCQSOS:<socket>,<sequence><CR><LF>[$QCQSOS:<socket>,<se quence>][…]]
AT$QCQSOS=<socket
>[,<socket>[,<socket>[
...]]]
Test Command
AT$QCQSOS=?
Parameter Saving Mode -
OK
Max Response Time -
OK
If failed:
+CME ERROR: <err>
Response
$QCQSOS: ( list of supported <socket>s),( list of supported <socket>s),…
Reference
Defined Values
www.simcom.com
132/194
< socket >
< sequence >
SIM7022 Series_AT Command Manual_V1.00
Socket number.
The sequence of pending up steam message. Range 1-255.
5.2.5 AT$QCSORF Receive Command
AT$QCSORF ReceiveCommand
Reads up to <req length> characters of data from <socket>.
Returned length is the actual number of characters returned.
Receive data on a socket. When data arrives a +QCSONMI response will
Description be generated that indicates the socket the message was received on and the amount of data. The +QCSORF 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 +QCSONMI notification will be sent if there is another message to process.
Write Command
Refer to Chapter 9: Error Values for possible <err> values.
If messages arrive faster than they are read, and the internal message buffer is full, the most recent message will be discarded.
Response
<socket>,<ip_addr>,<port>,<length>,<data>,<remaining_length>
AT$QCSORF=<socket
>,<req_length>
Test Command
OK
If failed:
+CME ERROR: <err>
Response
$QCSORF: ( list of supported <socket>s),( list of supported <req_legth>s)
AT$QCSORF=?
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
< socket >
< req_length >
< remote addr > www.simcom.com
Socket number returned by $QCSOCR
Maximum amount of data to be returned as a decimal byte length.
Address of system sending the message
133/194
SIM7022 Series_AT Command Manual_V1.00
< remote port
< length >
> A number in the range 0-65535. This is the remote port that messages was sent from
Amount of data returned as a decimal byte length
< remaining_length > Amount of data left to read for this message as a decimal byte length
< data > Data received in hex string format
NOTE
Maximum data size is 1358 bytes.
Remaining length is always 0. The remaining data is readable.
5.2.6 AT$QCSOCO Connect Command (TCP only)
AT$QCSOCO Connect Command (TCP only)
This command Connect to a TCP sever to the specified host:port.
Description
If the socket connection connect success, it will indicate the success result with the URC “$QCSOCO”. If the socket connection connect fail ite will indicate the fail result with the URC “$QCSOCLI”
Refer to Chapter 9: Error Values for possible <err> values.
Write Command
AT$QCSOCO=<socket
>,<remote_addr>,<rem ote_port>
Test Command
Response
OK
If failed:
+CME ERROR: <err>
$QCSOCO: ( list of supported <socket>s),( list of supported
<remote_addr>s),( list of supported <remote_port>s)
AT$QCSOCO=?
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
< socket >
< remote_addr >
< remote_port >
Socket number returned by $QCSOCR
Address of system sending the message
A number in the range 0-65535. This is the remote port that connect to.
NOTE
IP addresses can be specified in decimal, octal or hexadecimal notation.
www.simcom.com
134/194
SIM7022 Series_AT Command Manual_V1.00
5.2.7 AT$QCSOSD Send Command (TCP only)
AT$QCSOSD Send Command (TCP only)
This 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, the
$QCSOSD return value will indicate how much of the data was successfully
Description sent.
If <sequence>is not omitted, when datagram is acked by server or discard by UE, will report the result.
$QCSOSTR:<socket>,<sequence>,<status>
Write Command
AT$QCSOSD=<socket
>,<length>,<data>[,<fla g>[,sequence]]
Test Command
AT$QCSOSD=?
Refer to Chapter 9: Error Values for possible <err> values.
Response socket, length
OK
If failed:
+CME ERROR: <err>
Response
$QCSOSD:( list of supported <socket>s),( list of supported
<length>s),(<data>),( list of supported <flag>s),( list of supported
<sequence>s)
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
< socket >
< length >
< data >
< flag > www.simcom.com
Socket number returned by $QCSOCR.
Decimal length of data to be sent.
Data to be transmitted in hex string format.
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 message with high priority
0x200 Release Indicator: indicate release after next message
0x400 Release Indicator: indicate release after next message has been replied to
135/194
< sequence >
< status >
SIM7022 Series_AT Command Manual_V1.00
If no flags are set, a value of 0 should be provided.
Sequence of data, range 1-255.If omit, will not report data sent status.
The status of datagram.
0 Error
1 Sent
NOTE
Maximum data size is 1358 bytes.
<data> Only hex string format is supported
IP addresses can be specified in decimal, octal or hexadecimal notation.
<flag> couldn’t work now.
5.2.8 AT$QCSOCL Close Socket
AT$QCSOCL Close Socket
Close the specified socket. If there are pending messages to be read, they will be dropped. No further unsolicited +QCSONMI notifications will be
Description generated. If the socket has already been closed, or was never created, an error will be returned. Refer to Chapter 9: Error Values for possible <err> values.
Response
Write Command
AT$QCSOCL=<socket
>
Test Command
OK
If failed:
+CME ERROR: <err>
Response
$QCSOCL:( list of supported <socket>s)
AT$QCSOCL=?
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
< socket > Socket number returned by $QCSOCR
5.2.9 $QCSONMI Socket Message Arrived Indicator (Response Only)
$QCSONMI Socket Message Arrived Indicator (Response Only) www.simcom.com
136/194
SIM7022 Series_AT Command Manual_V1.00
Description
Unsolicited message to notify that data has been received on a socket and is ready to be read. Returns socket number and number of bytes of data available to read for the first message that is queued. If another message is received on the same socket, it will only be notified when the preceding
Parameter Saving Mode -
Response
$QCSONMI:<socket>,<length>
Max Response Time
Reference
message has been completely read.
Refer to Chapter 9: Error Values for possible <err> values.
Defined Values
< socket >
< length >
Socket on which data is received. Decimal number returned by +ECSOCR
Number of bytes of data in the first message.
NOTE
This message can occur at any point if it is indicating a new message with no messages buffered. If there are buffered messages it will occur in the AT+ECSORF command before the data is returned.
5.2.10 $QCSOCLI Socket Close Indicator (Response Only)
$QCSOCLI Socket Close Indicator (Response Only)
Unsolicited message to notify that socket has been closed by LWIP
Description internally. Returns socket number.
Refer to Chapter 9: Error Values for possible <err> values.
Parameter Saving Mode -
Response
$QCSOCLI:<socket>,<errno>
Max Response Time
Reference
-
Defined Values
< socket >
<errno>
Socket on which is closed. Decimal number returned by $QCSOCR.
Integer type （ Posix Errno defines ）
12 Out of memory error
105 No buffer space available www.simcom.com
137/194
SIM7022 Series_AT Command Manual_V1.00
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
Only TCP could report +ECSOCLI.
5.2.11 AT$QCSONMI Set the Public Max Downlink Buffer Size
AT$QCSONMIE Set the Public Max Downlink Buffer Size
The write command is used to set the unsolicited result code “$QCSONMI” to indicate arrived socketmessages(the socket were not configure as private socket by AT$QCSONMIE command):
Description
If <mode>=1, the UE will receive an unsolicited result code: "$QCSONMI:
<socket>,<length>".
If <mode>=2, the UE will receive an unsolicited result code: "$QCSONMI:
<socket>,<remote_ad dr>,<remote_port>,<length>,<data>".
If <mode>=3, the UE will receive an unsolicited result code: "$QCSONMI:
<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
Write Command
AT$QCSONMI=<mode
>[,<max_public_dl_buf fer>[,<max_public_dl_ pkg_num>]]
Response
OK
If there is any error, response:
+CME ERROR: <err>
Test Command
AT$QCSONMI=?
Response
$QCSONMI: ( list of supported <mode>s), ( list of supported <max_public_dl_buffer>s),( list of supported <max_public_dl_pkg_num>s)
Read Command
OK
Response www.simcom.com
138/194
SIM7022 Series_AT Command Manual_V1.00
AT$QCSONMI?
[$QCSONMI:<mode>,<max_public_dl_buffer>,<max_public_dl_pkg_n um>]
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
<mode>
<socket>
<length>
<remote_addr>
<remote_port>
<data>
<max_private_dl_buf fer>
<max_private_dl_pk g_num>
Control downlink data format.
0 Disable indication messages unsolicited result code.
1 Enable indication messages unsolicited result code for the specified socket:
“$QCSONMI: <socket>,<length>”
2 Enable indication messages unsolicited result code for the specified socket:
“$QCSONMI: <socket>,<remote_addr>,<remote_port>,<length>,<data>
3 Enable indication messages unsolicited result code for the specified socket:
“$QCSONMI:<socket>,<length>,<data>”
Integer type1-7 Socket Id returned by AT$QCSOCR.
Number of bytes of data in the first message.
The remote IP address which the message is sent from
0-65535 The remote port which the message if sent from
Data received in hex string format. Maximum length of received data is 1358 bytes
1358-3072 The maximum downlink buffer size for the specified socket. The default value is 2048
8-16 The maximum downlink buffer message number for the specified socket.
The default value is 8
5.2.12 AT$QCSONMIE Arrived Messages of A Specified Socket
AT$QCSONMIE Arrived Messages of A Specified Socket
The write command is used to set the unsolicited result code “$QCSONMI” to indicate arrived messages of a specified socket, the default mode is 3:
Description
If <mode>=1, the UE will receive an unsolicited result code: "$QCSONMI:
<socket>,<length>".
If <mode>=2, the UE will receive an unsolicited result code: "$QCSONMI:
<socket>,<remote_ad dr>,<remote_port>,<length>,<data>".
If <mode>=3, the UE will receive an unsolicited result code: "$QCSONMI:
<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.
www.simcom.com
139/194
SIM7022 Series_AT Command Manual_V1.00
Write Command
AT$QCSONMIE=<sock et>,<mode>[,<max_pri vate_dl_bu ffer>[,<max_private_dl
_pkg_num>]]
Response
OK
If there is any error, response:
+CME ERROR: <err>
Test Command
AT$QCSONMIE=?
Response
$QCSONMIE: ( list of supported <socket>s),( list of supported <mode>s),( list of supported <max_private_dl_buffer>s),( list of supported <max_private_dl_pkg_num>s)
Read Command
AT$QCSONMIE?
Parameter Saving Mode -
OK
Max Response Time
Reference
-
OK
Response
[$QCSONMIE:
<socket>,<mode>,<max_public_dl_buffer>,<max_public_dl_pkg_num
>][…]
Defined Values
< socket
<mode>
> Socket on which data is received. Decimal number returned by +ECSOCR
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:
“$QCSONMI: <socket>,<length>”
2 Enable indication messages unsolicited result code for the specified socket: “$QCSONMI:
<socket>,<remote_addr>,<remote_port>,<length>,<data>
3 Enable indication messages unsolicited result code for the specified socket: “$QCSONMI:<socket>,<length>,<data>”
255 reset the mode setting which configure by the command
<length>
<remote_addr>
<remote_port>
<data>
“AT$QCSONMI ” for the specified socket
Number of bytes of data in the first message.
The remote IP address which the message is sent from
0-65535 The remote port which the message if sent from
Data received in hex string format. Maximum length of received data is 1358 bytes
<max_private_dl_buf fer>
1358-2048 The maximum downlink buffer size for the specified socket. The default value is 1358
<max_private_dl_pk 1-8 The maximum downlink buffer message number for the specified socket.
www.simcom.com
140/194
SIM7022 Series_AT Command Manual_V1.00
g_num> The default value is 4
NOTE
This message can occur at any point if it is indicating a new message with no messages buffered. If there are buffered messages it will occur in the AT+ECSORF command before the data is returned.
www.simcom.com
141/194
SIM7022 Series_AT Command Manual_V1.00
5.2.13 $QCSOCO Socket Connected Indicator
+ECSOCLI Socket Connected Indicator
Description
Unsolicited message to notify that the TCP Connection has connected success.
Response
Parameter Saving Mode -
$QCSOCO:<socket_id>
Max Response Time
Reference
-
Defined Values
< socket_id > Interger type
Socket id returned by AT$QCSOCR
NOTE
Only TCP could report +QCSOCLI.
www.simcom.com
142/194
SIM7022 Series_AT Command Manual_V1.00
6 AT Commands for Ocean Connect
6.1 Overview of AT Commands for Ocean Connect
Command
AT+CTM2MVER
AT+CTM2MSETMOD
AT+CTM2MSETPM
AT+CTM2MREG
AT+CTM2MUPDATE
AT+CTM2MDEREG
AT+CTM2MSEND
AT+CTM2MCMDRSP
+CTM2MRECV
+CTM2M
+CTM2MCMD
Description
Sends Request to Get CTM2M Version
Sends Command to Set UE Working Mode
Set the Parameters to Register
Register for China Telecom Iot Platform
Update binding Mode
Exit China Telecom Iot Platform
Send a Message to the IoT Platform
Response to China Telecom Iot Platform
Receive Async Notification
Receive Async Notification
Receive Messages from the Platform
6.2 Detailed Descriptions of Commands
6.2.1
AT+CTM2MVER Sends Request to Get CTM2M Version
AT+CTM2MVER Sends Request to Get CTM2M Version
Description This command sends request to get CTM2M version.
Response
+CTM2MVER: <lwm2m>,<ctm2m>,<ctmt>,<ctmv>
Read Command
AT+CTM2MVER?
OK or
Parameter Saving Mode -
+CME ERROR: <err>
Max Response Time www.simcom.com
143/194
SIM7022 Series_AT Command Manual_V1.00
Reference
Defined Values
<lwm2m>
<ctm2m>
<ctmt>
<ctmv>
String type, version of LWM2M
String type, version of LWM2M
String type, chip type: SIM7022
String type, software version of module.
Example
AT+CTM2MVER?
+CTM2MVER:
1.0,1.1.0,SIM7022,NB1.5,V001.028.000
OK
6.2.2 AT+CTM2MSETMOD Sends Command to Set UE Working Mode
AT+CTM2MSETMOD Sends Command to Set UE Working Mode
Description
Test Command
AT+CTM2MSETMOD=?
This command sends command to set UE working mode.
Response
+CTM2MSETMOD:( list supported <MOD_DATA>s) of supported <MOD_ID>s),( list
Read Command
AT+CTM2MSETMOD?
of
OK
Response
+CTM2MSETMOD:
<idAuthMode>,<autoUpdate>,<onUQMode>,<level2Policy>,<autoHeart beat>,<wakeupPolicy>,<protocolMode>
Write Command
OK
Response
AT+CTM2MSETMOD=<
MOD_ID>,<MOD_DAT
A>
Parameter Saving Mode -
OK or
+CME ERROR: <err>
Max Response Time
Reference
www.simcom.com
144/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
<MOD_ID>
<MOD_DATA>
Integer type
1---IDAuth_Mode
2--- Auto_TAUTimer_Update
3--- ON_UQMode
4--- ON_CELevel2Policy
5--- Auto_Heartbeat
6--- Wakeup_Notify
7--- Protocol_Mode
Integer type.
If MOD_ID=1:
1: default value, no authentication string
2: SIMD authentication string from outside of module
3: SM9 authentication string from outside of module
4: SIMD authentication string from inside of module
5: SM9 authentication string from inside of module
If MOD_ID=2:
1: default no action
2: notify MCU
3: not notify MCU, auto update inside of module
If MOD_ID=3:
1: UQ mode off
2: UQ mode on
If MOD_ID=4:
1: default send under CE level2
2: not send under CE level2
If MOD_ID=5:
1: no auto heartbeat
2: default auto heartbeat
If MOD_ID=6:
1: not notify to MCU
2: default notify to MCU
If MOD_ID=7:
1: normal
2: enhance
Example
AT+CTM2MSETMOD?
+CTM2MSETMOD: 1,1,1,1,2,2,1
OK www.simcom.com
145/194
SIM7022 Series_AT Command Manual_V1.00
AT+CTM2MSETMOD=1,1
OK
6.2.3 AT+CTM2MSETPM Set the Parameters to Register
AT+CTM2MSETPM Set the Parameters to Register
Description
This command sends command to set the parameters to register to the
China Telecom iot platform.
Test Command
AT+CTM2MSETPM=?
Response
+CTM2MSETPM: ( list supported <Port>),( range of of supported <Object_Instance_List>) supported <Sever_IP>),( supported range
<Lifetime>),( list of of
Read Command
AT+CTM2MSETPM?
OK
Response
+CTM2MSETPM:
<Sever_IP>,<Port>,<Lifetime>[,<Object_Instance_List>]
OK
Write Command
AT+CTM2MSETPM=<S ever_IP>,<Port>,<Lifeti me>[,<Object_Instance
_List>]
Response
OK or
+CTM2M ERROR: <err>
Parameter Saving Mode SAVE
Max Response Time
Reference
-
Defined Values
< status
<Port>
>
<Lifetime>
<Object_Instance_Li st>
String type, ip address for LWM2M server.
Integer type, port number for LWM2M server.
Integer type, lifetime for LWM2M server and unit is second with minimum value 300.
String typeObject&instance list supported by MCU, with format like
“</3303/0>,</3303/1>”
Example
AT+CTM2MSETPM=?
+CTM2MSETPM:
"<Sever_IP>",(1-65535),(300-2147483647)
[,"<Object_Instance_List>"] www.simcom.com
146/194
SIM7022 Series_AT Command Manual_V1.00
OK
AT+CTM2MSETPM=221.229.214.202,5683,38400
OK
AT+CTM2MSETPM?
+CTM2MSETPM: 221.229.214.202,5683,38400,0
OK
6.2.4 AT+CTM2MREG Register for China Telecom Iot Platform
AT+CTM2MREG Register for China Telecom Iot Platform
Description
This command sends command to register to the China Telecom iot platform.
Read Command
Response
+CTM2MREG:<status>
AT+CTM2MREG?
Execution Command
AT+CTM2MREG
OK
Response
OK or
+CTM2M ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
6.2.5 AT+CTM2MUPDATE Update binding Mode
AT+CTM2MUPDATE Update binding Mode
Description
Test Command
AT+CTM2MUPDATE=?
This command sends command to update binding mode to China Telecom iot platform.
Response
+CTM2MUPDATE: ( list of supported <Binding_Mode>),( list of supported <ObjectList>)
Write Command
AT+CTM2MUPDATE
[=<Binding_Mode>[,<O bjectList>]]
OK
Response
OK or
+CTM2M ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference www.simcom.com
147/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
<Binding_Mode>
<ObjectList>
0---Not set
1---UQ mode
2---U mode
String type, null---Not set
Example
AT+CTM2MUPDATE
OK
+CTM2M: update,0,1735
6.2.6 AT+CTM2MDEREG Exit China Telecom Iot Platform
AT+CTM2MDEREG Exit China Telecom Iot Platform
Description This command sends command to exit China Telecom iot platform.
Execution Command
Response
OK
+CTM2M: dereg,0
AT+CTM2MDEREG
Parameter Saving Mode or
+CTM2M ERROR: <err>
Max Response Time
Reference
-
6.2.7 AT+CTM2MSEND Send a Message to the IoT Platform
AT+CTM2MSEND Send a Message to the IoT Platform
Description
This command sends command to send business data to China Telecom iot platform.
Test Command
AT+CTM2MSEND=?
Response
+CTM2MSEND: ( list of supported <data>),( list of supported <mode>)
OK www.simcom.com
148/194
SIM7022 Series_AT Command Manual_V1.00
Response
Write Command
AT+CTM2MSEND=<dat a>[,<mode>]
+CTM2MSEND: <msgID>
OK or
+CTM2M ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
Defined Values
<data>
<mode>
String type, length should be less than 1024
Integer type
0---CON mode
1---NON mode
2---NON with RAI flag
3---CON with RAI flag
6.2.8 AT+CTM2MCMDRSP Response to China Telecom Iot Platform
AT+CTM2MCMDRSP Response to China Telecom Iot Platform
Description This command sends response to China Telecom iot platform.
Test Command
AT+CTM2MCMDRSP=?
Response
+CTM2MCMDRSP:( list of supported <Msgid>),( list of supported <Token>),( list of supported <Rspcode>),( listof supported
<Uri_str>),( list of supported <Observe>),( listof supported <Dataformat>),( list of supported <Data>)
OK
Write Command
AT+CTM2MCMDRSP=
<Msgid>,<Token>,<Rs pcode>,<Uri_str>,<Ob serve>[,<Dataformat
>,<Data>]
Response
OK or
+CME ERROR: <err>
Parameter Saving Mode NO_SAVE
Max Response Time -
Reference
Defined Values
www.simcom.com
149/194
<Msgid>
<Token>
<Rspcode>
<Uri_str>
<Observe>
<Dataformat>
< data >
SIM7022 Series_AT Command Manual_V1.00
It should be conform to the msgid of received message which needs to be replied.
It should be conform to the token value of received message which needs to be replied.
Message response code. Something like 204, 205 etc.
/object id/instance id/resource id
0--- set observe and no following parameters
1---cancel observe and no following parameters
8---just for response case
9---there are <Dataformat>,<data> parameters following
1--- TLV format(application/vnd.oma.lwm2m+tlv)
2---opaque format(application/octet-stream)
7---TEXT format(text/plain)
8---JSON format(application/vnd.oma.lwm2m+json)
9---Core Link Param format(application/link-format)
Data to be transmitted in hex string format.
6.2.9 +CTM2MRECV Receive Async Notification
+CTM2MRECV Receive Async Notification
Description
This is an unsolicited message to represent received data message from
China Telecom iot platform.
+CTM2MRECV: <data>
Parameter Saving Mode -
Max Response Time -
Reference
Defined Values
< data > String type, received data from platform
6.2.10 +CTM2M Receive Async Notification
+CTM2M Receive Async Notification
Description
This is an unsolicited message to represent received async notification from
China Telecom iot platform.
Response
+CTM2M: <operation>,<status code>[,<data1>,<data2>,<data3>]
OK www.simcom.com
150/194
SIM7022 Series_AT Command Manual_V1.00
Max Response Time
Reference or
Parameter Saving Mode -
+CME ERROR: <err>
-
Defined Values
<operation>
<status code>
<data1,2,3>
String type, can be one type of below operations: reg/obsrv/update/ping/dereg/send/lwstatus
0---success
1---timeout
2---not send out packet
9---receive platform RST packet and mean can’t send UL to platform
10---parameter error
11---other errors
13---authentication error
14---UE not login
22---iot protocol or lwm2m version mismatch
24---lwm2m session invalid
25---session load failure when quitting from sleep or after reboot
26---Engine abnormal, need reboot by MCU
28---TAU is due
31---packet is already sent out
32---object 19 not exist
Integer type data1---msgID data2---N/A data3---N/A
6.2.11 +CTM2MCMD Receive Messages from the Platform
+CTM2MCMD Receive Messages from the Platform
Description
This is a notification message from China Telecom iot platform to notify UE that some object operation is triggered and need to be replied.
+CTM2MCMD:
Parameter Saving Mode -
<msgid>,<cmdtype>,<token>,<uri_str>[,<observe>(,<dataformat>,<dat a>)]
Max Response Time
Reference
www.simcom.com
151/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
<msgid>
<cmdtype>
<token>
<uri_str>
<observe>
<dataformat>
<data>
Message ID
Integer type
0---Read
1---Observe
2---Write
3---Write-Partial
4---Write-Attribute
5---Discover
6---Execute
7---Create
8---Delete
Hex String type
Async message response ID
String type
/objectid/instanceid/resourceid
It is must when cmdtype=1
0---Set
1---Cancel
Integer type
1---TLV
6---CoAP Param
7---text/plain
8---JSON
String type
It is must when cmdtype=2 、 3 、 4 、 6 、 7
It is null when execute cmd has no arguments www.simcom.com
152/194
SIM7022 Series_AT Command Manual_V1.00
7 AT Commands for OneNET
7.1 Overview
Command
AT+MIPLCONFIG
AT+MIPLCREATE
AT+MIPLDELETE
AT+MIPLOPEN
AT+MIPLCLOSE
AT+MIPLADDOBJ
Description
Configure Bootstrap Server Address or Access Server Address.
Creates an Instance of Communication to CMIoT OneNET Platform.
Deletes a Specified OneNET Communication Instance.
Send Login Request to OneNET.
Send Logout Request to OneNET.
AT+MIPLDELOBJ
AT+MIPLNOTIFY
AT+MIPLREADRSP
AT+MIPLWRITERSP
AT+MIPLEXECUTERSP
AT+MIPLOBSERVERSP
AT+MIPLDISCOVERRSP
Add an Object from a Specified OneNET Communication Instance.
Deletes an Object from a Specified OneNET Communication Instance.
Notify OneNET that Specified Values Changed
Return the Read Result to OneNET.
Return the Write Result to OneNET.
Return the Execute Result to OneNET
Return the Observe Result to OneNET.
Return All Resources of Object ID Specified in +MIPLDISCOVER.
AT+MIPLPARAMETERRSP Return the Execute Result to OneNET.
AT+MIPLUPDATE Updates the Register Information
+MIPLREAD
+MIPLWRITE
Represent Remote Reading Command
Represent Remote Writing Command.
Represent Remote Executing Command.
+MIPLEXECUTE
+MIPLOBSERVE
+MIPLDISCOVER
+MIPLPARAMETER
+MIPLEVENT
Represent Remote Observe Command.
Represent Remote Discover Command.
Represent Remote Parameter Command
Report Status Event
7.2 Detailed Descriptions of Commands
www.simcom.com
153/194
7.2.1 AT+MIPLCONFIG
Address
SIM7022 Series_AT Command Manual_V1.00
Configure Bootstrap Server Address or Access Server
AT+MIPLCONFIG Configure Bootstrap Server Address or Access Server Address
Description
This command is used to enable/disable bootstrap mode and configure bootstrap server address or access server address.
Set Command
AT+MIPLCONFIG=<mo de>,<ip>,<port>
Test Command
AT+MIPLCONFIG=?
Response
OK or
+CIS ERROR: <err>
Response
+MIPLCONFIG: ( list of supported <mode>s),
<parameter1>[,<parameter2>
OK
+MIPLCONFIG: <mode>,<IP>,<port>
+MIPLCONFIG: <mode>,<rep_timeout>
+MIPLCONFIG: <mode>,<obs autoack>
Read Command
AT+MIPLCONFIG?
Parameter Saving Mode -
Max Response Time
Reference
-
+MIPLCONFIG: <mode>,<auth_code>
+MIPLCONFIG: <mode>,<psk>
+MIPLCONFIG: <mode>,<write_format>
+MIPLCONFIG: <mode>,<bug_cfg>,<buf_URC_mode>
Defined Values
<mode> www.simcom.com
0 Disable bootstrap, config server address and port
1 Enable bootstrap, config server address and port.
Bootstrap server IP is 183.230.40.39,port is 5683.
2 Set the ACK_TIMEOUT of coap ,default is 2
3 set whether to enable automatic response to subscription requests
4 set whether to enable authentication access and configure authentication code
5 set whether dtls mode is enabled and configure PSK
6 set the output format of receiving write data
7 configure downlink data cache
2
3
<mode>
0
1
<parameter1>
<IP>
<IP>
1
<obs_autoack>
<parameter2>
<port>
<port>
<rsp_timeout>
154/194
<ip>
<port>
<rsp_timeout>
<obs_autoack>
<auth_enable>
<auth_code>
<DTLS_enable>
<psk>
<write_format>
<buf_URC_mode>
SIM7022 Series_AT Command Manual_V1.00
4
5
6
7
<auth_enable>
<DTLS_enable>
<write_format>
<buf_cfg>
[<auth_code>]
[<psk>]
<buf_URC_mode>
When <mode>=0,<ip> represents access server IP
When <mode>=1,<ip> represents bootstrap server IP
When <mode>=0,<port> represents access server port
When <mode>=1,<port> represents bootstrap server port
Integer type
ACK_TIMEOUT,range is 2-20 seconds.
Integer type, Set enable automatic response to subscription requests
0 disable automatic response, terminal response by AT+MIPOBSERVERSP
1 enable automatic response, terminal don’t need to response.
Integer type, Set authentication access
0 disable
1 enable
String, authentication code, max length is 16
Integer type, switch of DTLS
0 disable
1 enable
String
PSK, max length is 16
Integer type, Downlink data cache configuration
0 Do not cache
1 Cache only downlink write operations
2 Cache only downlink execution data
3 Both write and execute data are cached at the same time
Integer type, Enable downlink data cache indication
0 Disable downlink data cache indication
1 Enable downlink data cache indication
When the data buffer is empty, the downlink data cache prompt is received:
URC “MIPLEVENT:”
NOTE
The command should be executed before the communication suite instance is created with
AT+MIPLCREATE command.
www.simcom.com
155/194
SIM7022 Series_AT Command Manual_V1.00
7.2.2 AT+MIPLCREATE Creates an Instance of Communication to CMIoT OneNET
Platform
AT+MIPLCREATE Creates an Instance of Communication to CMIoT OneNET Platform
Description
This command creates an instance of communication to CMIoT OneNET platform.
Read Command
AT+MIPLCREATE
Response
+MIPLCREATE:<ref> or
Parameter Saving Mode -
+CIS ERROR: <err>
Max Response Time
Reference
-
Defined Values
<ref> a specified OneNET communication instance id returned by +MIPLCREATE
7.2.3 AT+MIPLDELETE Deletes a Specified OneNET Communication Instance
AT++MIPLDELETE Deletes a Specified OneNET Communication Instance
Description This command deletes a specified OneNET communication instance.
Set Command
AT+MIPLDELETE=<ref
>
Response
OK or
+CIS ERROR: <err>
Response
Test Command
AT+MIPLDELETE=?
Parameter Saving Mode -
+MIPLDELETE: ( list of supported <ref>)
OK
Max Response Time
Reference
-
Defined Values
<ref> a specified OneNET communication instance id returned by +MIPLCREATE www.simcom.com
156/194
SIM7022 Series_AT Command Manual_V1.00
7.2.4 AT+MIPLOPEN Send Login Request to OneNET
AT+MIPLOPEN Send Login Request to OneNET
Description
Set Command
AT+MIPLOPEN=<ref>,< lifetime>
Test Command
AT+MIPLOPEN=?
This command send login request to OneNET.
Response
OK or
+CIS ERROR: <err>
Response
+MIPLOPEN: (list of supported< ref >),(range of supported< lifetime >),(range of supported< timeout >)
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
<ref>
<lifetime>
<timeout>
A specified OneNET communication instance id returned by +MIPLCREATE
Lifetime value in second of the client, in this time client need send update msg to OneNET range: 0xF-0x0FFFFFFF. unit: second
Timeout of registration range: 1-0xFFFF. unit: second
7.2.5 AT+MIPLCLOSE Send Logout Request to OneNET
AT+MIPLCLOSE Send Logout Request to OneNET
Description This command send logout request to OneNET.
Set Command
AT+MIPLCLOSE=<ref>
Response
OK or
+CIS ERROR: <err>
Response
Test Command +MIPLCLOSE: ( list of supported <ref>)
AT+MIPLCLOSE=?
Parameter Saving Mode -
OK
Max Response Time
Reference
www.simcom.com
157/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
<ref> A specified OneNET communication instance id returned by +MIPLCREATE
7.2.6 AT+MIPLADDOBJ Add an Object from a Specified OneNET Communication
Instance
AT+MIPLADDOBJ Add an Object from a Specified OneNET Communication instance.
Description
This command add an object from a specified OneNET communication instance.
Set Command
AT+MIPLADDOBJ=<ref
>,<objectid>,<instance count>,<instancebitma p>,<attributecount>,<a ctioncount>
Response
OK or
+CIS ERROR: <err>
Test Command
AT+MIPLADDOBJ=?
Response
+MIPLADDOBJ: ( list of supported <ref>),( range of supported <objectid>),( range of supported <instancecount>),"<instancebitmap>",( range of supported <attributecount>),( range of supported <actioncount><)
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
<ref>
<objectid>
<instancecount>
<instancebitmap>
<attributecount>
<actioncount>
Integer type a specified OneNET communication instance id returned by
+MIPLCREATE.
Integer type object id. range 0-0xFFFF
Integer type Number of instances. range 0-0xFFFF string type Instance bitmap, each bit represents an instance, 0 means not available, 1 means available
Integer type Number of attributes. range 0-0xFFFF
Integer type Number of actions. range 0-0xFFFF www.simcom.com
158/194
SIM7022 Series_AT Command Manual_V1.00
7.2.7 AT+MIPLDELOBJ Deletes an Object from a Specified OneNET Communication
Instance
AT+MIPLADELOBJ Deletes an Object from a Specified OneNET Communication Instance
Description
This command deletes an object from a specified OneNET communication instance.
Set Command
AT+MIPLDELOBJ=<ref
>,<objectid>
Response
OK or
Test Command
+CIS ERROR: <err>
Response
+MIPLDELOBJ: ( list of supported <ref>),( range of supported <objectid>)
AT+MIPLDELOBJ=?
Parameter Saving Mode -
Max Response Time -
Reference
OK
Defined Values
<ref>
<objectid> a specified OneNET communication instance id returned by +MIPLCREATE object id
7.2.8 AT+MIPLNOTIFY Notify OneNET that Specified Values Changed
AT+MIPLNOTIFY Notify OneNET that Specified Values Changed
Description This command notify OneNET that specified values changed.
Set Command
AT+MIPLNOTIFY=<ref>
,<msgid>,<objectid>,<i nstanceid>,<resourcei d>,<valuetype>,<len>,
<value>,<index>,<flag
>[,<ackid>[,raiflag]]
Response
OK or
+CIS ERROR: <err>
Test Command
AT+MIPLNOTIFY=?
Response
+MIPLNOTIFY: ( list of supported <ref>),( range of supported <msgid>),( range of supported <objectid>),( range of supported <instanceid>),( range of supported <resourceid>),( range of supported <valuetype>),( range of supported <len>),"<value>",( list of supported <index>),( list of supported <flag>),( list of supported <ackid>),( list of supported <raiflag>) www.simcom.com
159/194
SIM7022 Series_AT Command Manual_V1.00
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
<ref>
<msgid>
<objectid>
<instanceid>
<resourceid>
<valuetype>
<len>
<value>
<index>
<flag>
<ackid>
<raiflag> a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE. range 0-0xFFFFFFF
Range 0-0xFFFF. object id
Range 0-0xFFFF. instance id
Range 0-0xFFFF. resource id
1 string
2 opaque
3 Integer
4 float
5 bool valuetype len stringstring len opaquebyte len integer The number of bytes occupied by the integerOptional 2, 4, 8.
floatThe number of bytes occupied by the floatOptional 4, 8.
bool1
Range 0-0xFF.
valuetype value string string opaque Hex string interger interger float string bool 0:false; 1:true serial number, for one command may not be able to send the entire content.
It’s from N~0. 0 is last part of content.
1 First msg
2 Middle msg
0 Last msg
0 This notify will be sent in Non-confirmable(NON) message
0-0xFFFF This notify will be sent in Confirmable(CON) message and the value will indicated by “+MIPLEVENT”
0 (PS_SOCK_RAI_NO_INFO) disable RAI
1 (PS_SOCK_RAI_NO_UL_DL_FOLLOWED) enable RAI ， release after send
2 (PS_SOCK_ONLY_DL_FOLLOWED) enable RAI ， release after ACK has received www.simcom.com
160/194
SIM7022 Series_AT Command Manual_V1.00
7.2.9 AT+MIPLREADRSP Return the Read Result to OneNET
AT+MIPLREADRSP Return the Read Result to OneNET
Description After receive +MIPLREAD, This command return the read result to OneNET.
Set Command
AT+MIPLREADRSP=<r ef>,<msgid>,<result>[,
<objectid>,<instanceid
>,<resourceid>,<valuet ype>,<len>,<value>,<in dex>,<flag>[,raiflag]]
Response
OK or
+CIS ERROR: <err>
Test Command
AT+MIPLREADRSP=?
Response
+MIPLREADRSP: ( list of supported <ref>),( range of supported <msgid>),( range of supported <objectid>),
( range of supported <instanceid>),( range of supported <resourceid>),( range of supported <valuetype>),( range of supported <len>),"<value>",( list of supported <index>),( list of supported <flag>),( list of supported <ackid>),( list of supported <raiflag>)
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
<ref>
<msgid>
<result>
<objectid>
<instanceid>
<resourceid>
<valuetype> www.simcom.com
a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE. Range 0-0xFFFFFFF
1 205 content, read success
11 400 bad request
12 401 unauthorized
13 404 not found
14 405 method not allowed
15 406 not acceptable object id
Instance id
Resource id
1 string
2 opaque
3 Integer
161/194
<len>
<value>
<index>
<flag>
<ackid>
<raiflag>
SIM7022 Series_AT Command Manual_V1.00
4 float
5 bool valuetype len stringstring len opaquebyte len integer The number of bytes occupied by the integerOptional 2, 4, 8.
floatThe number of bytes occupied by the floatOptional 4, 8.
bool1 valuetype value string string opaque Hex string interger interger float string bool 0:false; 1:true serial number, for one command may not be able to send the entire content.
It’s from N~0. 0 is last part of content.
1 First msg
2 Middle msg
0 Last msg
0 This notify will be sent in Non-confirmable(NON) message
1-65535 This notify will be sent in Confirmable(CON) message and the value will indicated by “+MIPLEVENT”
0 (PS_SOCK_RAI_NO_INFO) disable RAI
1 (PS_SOCK_RAI_NO_UL_DL_FOLLOWED) enable RAI ， release after send
2 (PS_SOCK_ONLY_DL_FOLLOWED) enable RAI ， release after ACK has received
7.2.10 AT+MIPLWRITERSP Return the Write Result to OneNET
AT+MIPLWRITERSP Return the Write Result to OneNET
Description
Set Command
AT+MIPLWRITERSP=< ref>,<msgid>,<result>[
,raiflag]
Test Command
AT+MIPLWRITERSP=?
After receive +MIPLWRITE, This command return the write result to
OneNET.
Response
OK or
+CIS ERROR: <err>
Response
+MIPLWRITERSP: ( list of supported <ref>),( range of supported <msgid>),( list of supported <result>),( list of supported <raiflag>)
Parameter Saving Mode -
OK www.simcom.com
162/194
SIM7022 Series_AT Command Manual_V1.00
Max Response Time
Reference
-
Defined Values
<ref>
<msgid>
<result>
<raiflag> a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE. Range 0-0xFFFFFFF
2 204 changed, write success
11 400 bad request
12 401 unauthorized
13 404 not found
14 405 method not allowed
0 (PS_SOCK_RAI_NO_INFO) disable RAI
1 (PS_SOCK_RAI_NO_UL_DL_FOLLOWED) enable RAI ， release after send
2 (PS_SOCK_ONLY_DL_FOLLOWED) enable RAI ， release after ACK has received
7.2.11 AT+MIPLEXECUTERSP Return the Execute Result to OneNET
AT+MIPLEXECUTERSP Return the Execute Result to OneNET
Description
After receive +MIPLEXECUTE, This command return the execute result to
OneNET.
Set Command
AT+MIPLEXECUTERS
P=<ref>,<msgid>,<res ult>[,raiflag]
Test Command
AT+MIPLEXECUTERS
P=?
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Response
OK or
+CIS ERROR: <err>
Response
+MIPLEXECUTERSP: ( list of supported <ref>),( range of supported <msgid>),( list of supported <result>),( list of supported <raiflag>)
Defined Values
<ref>
<msgid>
<result> www.simcom.com
a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE. Range 0-0xFFFFFFF
2 204 changed, execute success
163/194
<raiflag>
SIM7022 Series_AT Command Manual_V1.00
11 400 bad request
12 401 unauthorized
13 404 not found
14 405 method not allowed
0 (PS_SOCK_RAI_NO_INFO) disable RAI
1 (PS_SOCK_RAI_NO_UL_DL_FOLLOWED) enable RAI ， release after send
2 (PS_SOCK_ONLY_DL_FOLLOWED) enable RAI ， release after ACK has received
7.2.12 AT+MIPLOBSERVERSP Return the Observe Result to OneNET
AT+MIPLOBSERVERSP Return the Observe Result to OneNET
Description
Set Command
AT+MIPLOBSERVERS
P=<ref>,<msgid>,<res ult>
Test Command
AT+MIPLOBSERVERS
P=?
After receive +MIPLOBSERVE, This command return the observe result to
OneNET. It also can response the cancel observe.
Response
OK or
+CIS ERROR: <err>
Response
+MIPLOBSERVERSP: ( list of supported <ref>),( range of supported <msgid>),( list of supported <result>),( range of supported <raiflag>)
Parameter Saving Mode -
OK
Max Response Time -
Reference
Defined Values
<ref>
<msgid>
<result>
<raiflag> www.simcom.com
a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE. Range 0-0xFFFFFFF
1 205 content, read success
11 400 bad request
12 401 unauthorized
13 404 not found
14 405 method not allowed
15 406 not acceptable
0 (PS_SOCK_RAI_NO_INFO) disable RAI
1 (PS_SOCK_RAI_NO_UL_DL_FOLLOWED) enable RAI ， release after send
2 (PS_SOCK_ONLY_DL_FOLLOWED) enable RAI ， release after ACK has
164/194
SIM7022 Series_AT Command Manual_V1.00
received
7.2.13 AT+MIPLDISCOVERRSP Return All Resources of Object ID Specified in
+MIPLDISCOVER
AT+MIPLDISCOVERRSP Return All Resources of Object ID Specified in +MIPLDISCOVER
Description
After receive +MIPLEXECUTE, This command return the execute result to
OneNET.
Set Command
AT+MIPLDISCOVERRS
P=<ref>,<msgid>,<res ult>,<length>,<valuestr ing>[,<raiflag>]
Response
OK or
+CIS ERROR: <err>
Test Command
AT+MIPLEXECUTERS
P=?
Response
+MIPLEXECUTERSP: ( list of supported <ref>s),( range of supported <msgid>s),( list of supported <result>s),( list of supported <raiflag>s)
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
<ref>
<msgid>
<result>
<len>
<valuestring>
<raiflag> a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE. Range 0-0xFFFFFFF.
1 205 content, read success
11 400 bad request
12 401 unauthorized
13 404 not found
14 405 method not allowed
15 406 not acceptable valuetype len stringstring len opaquebyte len integer The number of bytes occupied by the integerOptional 2, 4, 8.
floatThe number of bytes occupied by the floatOptional 4, 8.
bool1
Object’s resource id, multiple resources separated by “;”
0 (PS_SOCK_RAI_NO_INFO) disable RAI
1 (PS_SOCK_RAI_NO_UL_DL_FOLLOWED) enable RAI ， release after send www.simcom.com
165/194
SIM7022 Series_AT Command Manual_V1.00
2 (PS_SOCK_ONLY_DL_FOLLOWED) enable RAI ， release after ACK has received
7.2.14 AT+MIPLPARAMETERRSP Return the Execute Result to OneNET
AT+MIPLPARAMETERRSP Return the Execute Result to OneNET.
Description
After receive +MIPLEXECUTE, This command return the execute result to
OneNET.
Set Command
AT+MIPLPARAMETER
RSP=<ref>,<msgid>,<r esult>[,<raiflag>]
Test Command
AT+MIPLPARAMETER
RSP=?
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Response
OK or
+CIS ERROR: <err>
Response
+MIPLPARAMETERRSP: ( list of supported <ref>),( range of supported <msgid>),( list of supported <result>),( list of supported <raiflag>)
Defined Values
<ref>
<msgid>
<result>
<raiflag> a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE. Range 0-0xFFFFFFF
2 204 changed
11 400 bad request
12 401 unauthorized
13 404 not found
14 405 method not allowed
0 (PS_SOCK_RAI_NO_INFO) disable RAI
1 (PS_SOCK_RAI_NO_UL_DL_FOLLOWED) enable RAI ， release after send
2 (PS_SOCK_ONLY_DL_FOLLOWED) enable RAI ， release after ACK has received
7.2.15 AT+MIPLUPDATE Updates the Register Information
AT+MIPLUPDATE Updates the Register Information
Description This command updates the register information,such as lifetime www.simcom.com
166/194
SIM7022 Series_AT Command Manual_V1.00
Set Command
AT+MIPLUPDATE=<ref
>,<lifetime>,<withobje ctflag>[,
<raiflag>]
Test Command
AT+MIPLUPDATE=?
Response
OK or
+CIS ERROR: <err>
Response
+MIPLUPDATE: ( list of supported <ref>),( range of supported <lifetime>),( list of supported <withobjectflag>),( list of supported <raiflag>)
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
<ref>
<lifetime>
<withobjectflag>
<raiflag> a specified OneNET communication instance id returned by +MIPLCREATE lifetime value in second of the client. Range 0x0-0x0FFFFFFF
1 Update object info at the same time
0 Don’t update object info
0 (PS_SOCK_RAI_NO_INFO) disable RAI
1 (PS_SOCK_RAI_NO_UL_DL_FOLLOWED) enable RAI ， release after send
2 (PS_SOCK_ONLY_DL_FOLLOWED) enable RAI ， release after ACK has received
7.2.16 +MIPLREAD Represent Remote Reading Command
+MIPLREAD Represent Remote Reading Command
Description
This is an unsolicited message to represent remote reading command.
OneNET request device to upload specified resource value.
Parameter Saving Mode -
+MIPLREAD:
<ref>,<msgid>,<objectid>,<instanceid>,<resourceid>
Max Response Time
Reference
-
Defined Values
<ref> www.simcom.com
a specified OneNET communication instance id returned by +MIPLCREATE
167/194
<msgid>
<objectid>
<instanceid>
<resourceid>
SIM7022 Series_AT Command Manual_V1.00
Message id of this message object id
Instance id, -1 means read all the instance belong to the object
Resource id, -1 means read all the resources belong to the instance
7.2.17 +MIPLWRITE Represent Remote Writing Command
+MIPLWRITE Represent Remote Writing Command
Description
This is an unsolicited message to represent remote writing command.
OneNET request device to modify specified resource value.
Parameter Saving Mode -
Max Response Time -
+MIPLWRITE:<ref>,<msgid>,<objectid>,<instanceid>,<resourceid>,<v aluetype>,<len>,<value>,<flag>,<index>
Reference
Defined Values
<ref>
<msgid>
<objectid>
<instanceid>
<resourceid>
<valuetype>
<len>
<value>
<index>
<flag> a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE object id
Instance id
Resource id
1 string
2 opaque
3 Integer
4 float
5 bool
Value length value
Serial number, for one command may not be able to send the entire content.
It’s from N~0. 0 is last part of content.
1 First msg
2 Middle msg
0 Last msg
7.2.18 +MIPLEXECUTE Represent Remote Executing Command
www.simcom.com
168/194
SIM7022 Series_AT Command Manual_V1.00
+MIPLEXECUTE Represent Remote Executing Command
This is an unsolicited message to represent remote executing command.
Description OneNET request device to execute some predefined operations on specified resource.
+MIPLEXECUTE:
<ref>,<msgid>,<objectid>,<instanceid>,<resourceid>,<len>,<argument s>
Parameter Saving Mode -
Max Response Time -
Reference
Defined Values
<ref>
<msgid>
<objectid>
<instanceid>
<resourceid>
<len>
<arguments> a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE object id
Instance id
Resource id
Value length
Represent the operation
7.2.19 +MIPLOBSERVE Represent Remote Observe Command
+MIPLOBSERVE Represent Remote Observe Command
Description
This is an unsolicited message to represent remote observe command.
OneNET request device to upload the values of specified resource or all
Parameter Saving Mode -
<ref>,<msgid>,<flag>,<objectid>,<instanceid>,<resourceid>
Max Response Time resources of specified instance when they change.
+MIPLOBSERVE:
Reference
7.2.20 +MIPLDISCOVER Represent Remote Discover Command
+MIPLDISCOVER Represent Remote Discover Command
Description
This is an unsolicited message to represent remote discover command.
OneNET request device to upload the resource id list of specified object id.
www.simcom.com
169/194
SIM7022 Series_AT Command Manual_V1.00
+MIPLDISCOVER:
Parameter Saving Mode -
<ref>,<msgid>,<objectid>
Max Response Time
Reference
-
Defined Values
<ref>
<msgid>
<objectid> a specified OneNET communication instance id returned by +MIPLCREATE
Message id of this message object id
7.2.21 +MIPLPARAMETER Represent Remote Parameter Command
+MIPLPARAMETER Represent Remote Parameter Command
This is an unsolicited message to represent remote parameter command.
Description
Parameter Saving Mode r>
Max Response Time -
+MIPLPARAMETER:
<ref>,<msgid>,<objectid>,<instanceid>,<resourceid>,<len>,<paramete
Reference with this message, OneNET can set interval and threshold value of specified resource.
Defined Values
<ref>
<msgid>
<objectid>
<instanceid>
<resourceid>
<len>
<arguments> a specified OneNET communication instance id returned by +MIPLCREATE
Msg id, msg id carried in +MIPLOBSERVE object id
Instance id
Resource id
Value length
Strategy parameter, like pmin=xxx;pmax=xxx;lt=xxx;gt=xx;st=xxx www.simcom.com
170/194
SIM7022 Series_AT Command Manual_V1.00
7.2.22 +MIPLEVENT Report Status Event
+MIPLEVENT Report Status Event
Description This is an unsolicited message to report status event.
Parameter Saving Mode -
Max Response Time -
Reference
+MIPLEVENT: <ref>,<evtid>[,<extend>,<ackid>]
Defined Values
<ref>
<msgid>
<extend>
<ackid> a specified OneNET communication instance id returned by +MIPLCREATE
1 Bootstrap start
2 Bootstrap success
3 Bootstrap failed
4 Connect success
5 Connect failed
6 Registration success
7 Registration failed
8 Registration timeout
9 Lifetime timeout
10 Status halt
11 Update success
12 Update failed
13 Update timeout
14 Update need
15 Un-registration done
20 Response failed
21 Response success
25 Notify failed
26 Notify success
Extend parameter, if eventid is Response failed(20), extend is corresponding message id. If eventid is Update need(14), extend is lifetime remaining time(in seconds)
When the eventid is Notify success(26), the corresponding ackid issued when notify is carried.
www.simcom.com
171/194
SIM7022 Series_AT Command Manual_V1.00
8 AT Commands for MQTT
8.1 Overview
Command
AT$QCMTCFG
AT$QCMTOPEN
AT$QCMTCLOSE
AT$QCMTCONN
AT$QCMTDISC
AT$QCMTSUB
AT$QCMTUNS
AT$QCMTPUB
$QCMTSTAT
$QCMTRECV
Description
Creates a MQTT Client
Open a Network for MQTT Client.
Send MQTT Close Packet.
Send MQTT Subscribe Packet.
Send MQTT Disconnect Packet
Send MQTT Subscribe Packet.
Send MQTT Unsubscribe Packet
Send MQTT Publish Packet
Receive Data from MQTT Server
Receive Data from MQTT Server
8.2 Detailed Descriptions of Commands
8.2.1 AT$QCMTCFG Creates a MQTT Client
AT$QCMTCFG Creates a MQTT Client
Description The command creates a MQTT client.
Test Command
AT$QCMTCFG=?
Response
$QCMTCFG: "echomode",(0),(0,1)
"dataformat",(0),(0,1),(0,1)
"keepalive",(0),(0-3600),
"session",(0),(0,1)
"timeout",(0),(1-60),(1-10),(0,1)
"will",(0),(0,1),(0-2),(0,1),"will_topic","will_msg"
"version",(0),(3,4)
"aliauth",(0),"productkey","devicename","devicesecret"
"cloud",(0-256),(0-256) www.simcom.com
172/194
SIM7022 Series_AT Command Manual_V1.00
Write Command
AT$QCMTCFG=”mode
”,<value>,[…]
Write Command
AT$QCMTCFG=”echo mode”,<tcpconnectID>
,[<echo_mode>]
Write Command
AT$QCMTCFG=”datafo rmat”,<tcpconnectID>,
[<send_format>,[<recv
_format>]]
Write Command
AT$QCMTCFG=”keepa live”,<tcpconnectID>[,
<keep-alive time>]
Write Command
AT$QCMTCFG=”sessi on”,<tcpconnectID>[,< clean_session>]
Write Command
AT$QCMTCFG=”timeo ut”,<tcpconnectID>[,< pkt_timeout>[,<retry_ti mes>][,<timeout_notic e>]]
Write Command
AT$QCMTCFG=”will”,< tcpconnectID>[,<will_f g>[,<will_qos>,<will_re
OK
Response
OK or
ERROR
Response
OK
If <echo_mode> is omitted, query the data echo mode:
$QCMTCFG: "echomode",<echo_mode> or
ERROR
Response
OK
If <send_format> and recv_format> are both mitted, query the format of sent/received data:
$QCMTCFG: "dataformat",<send_format>,<recv_format>
OK or
ERROR
Response
OK
If <keep-alive time> is omitted, query the keep-alive time:
$QCMTCFG: "keepalive",<keep-alive time>
OK or
ERROR
Response
OK
If <clean_session> is omitted, query the session type:
$QCMTCFG: "session",<clean_session>
OK or
ERROR
Response
OK
If <pkt_timeout>, retry_times>, <timeout_notice> are omitted, query the timeout value of message delivery:
$QCMTCFG: "timeout",<pkt_timeout>,<retry_times>,<timeout_notice>
OK or
ERROR
Response
OK
If <will_fg>, <will_qos>, <will_retain>, <will_topic> and <will_msg> are omitted, query the Will information: www.simcom.com
173/194
SIM7022 Series_AT Command Manual_V1.00
tain>,“<will_topic>”,“< will_msg>”]]
$QCMTCFG:
"will",<will_fg>[,<will_qos>,<will_retain>,<will_topic>,<will_msg>]
OK or
ERROR
Write Command
AT$QCMTCFG=”versio n”,<tcpconnectID>[,<v ersion>]
Response
OK
If <version> is omitted, query the MQTT protocol version:
$QCMTCFG: "version",<version>
OK or
ERROR
Write Command
AT$QCMTCFG=”aliaut
Response
OK
If “<product_key>”, “ <device_name>”, “ <device_secret>” are omitted, query the device information: h”,<tcpconnectID>[,“< product_key>”,“<devic e_name>”,“<device_se cret>” ]
$QCMTCFG:
"aliauth",<product_key>,<device_name>,<device_secret>
OK or
ERROR
Write Command
AT$QCMTCFG=”cloud
”,<tcpconnectID>,<clo udtype>,<data type>
Parameter Saving Mode -
Response
OK or
ERROR
Max Response Time
Reference
-
Defined Values
<tcpconnectID>
<echo_mode>
<send_format>
<recv_format>
<keep-alive time>
<clean_session> www.simcom.com
MQTT socket identifier, the value is 0
0 Do not echo the input data to UART
1 Echo the input data to UART
0 Text mode
1 Hex mode
0 Text mode
1 Hex mode
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 does not receive a message from the client within 1.5 times of the keep-alive time period, it disconnects the client as if the client has sent a DISCONNECT message.
0 The server must store the subscriptions of the client after it disconnects.
174/194
<pkt_timeout>
<retry_times>
<timeout_notice>
<will_fg>
<will_qos>
<will_retain>
<will_topic>
<will_msg>
<version>
<product_key>
<device_name>
<device_secret>
<cloud type>
<data type>
SIM7022 Series_AT Command Manual_V1.00
1 The server must discard any previously maintained information about the
Timeout of the packet delivery. The range is 1-60. The default value is 10.
Unit: second.
Retry times when packet delivery times out. The range is 1-10. The default value is 3.
0 Not report timeout message when transmitting packet
1 Report timeout message when transmitting packet
0 Ignore the Will flag configuration
1 Require the Will flag configuration
0 At most once
1 At least once
2 Exactly once
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.
Will topic string
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.
Version of MQTT protocol, the default is MQTT v3.1.1
3 MQTT v3.1
4 MQTT v3.1.1
Product key issued by AliCloud
Device name issued by AliCloud
Device secret key issued by AliCloud
Integer 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 www.simcom.com
175/194
SIM7022 Series_AT Command Manual_V1.00
8.2.2 AT$QCMTOPEN Open a Network for MQTT Client
AT$QCMTOPEN Open a Network for MQTT Client
Description The command is used to open a network for MQTT client..
Test Command
AT$QCMTOPEN=?
Response
$QCMTOPEN: ( list of supported <tcpconnectID>s),“<host_name>”,( list of supported <port>s)
Read Command
AT$QCMTOPEN?
Write Command
AT$QCMTOPEN=<tcpc onnectID>,“<host_nam e>”,<port>
OK
Response
OK
$QCMTOPEN: <tcpconnectID>,<result> or
Parameter Saving Mode -
ERROR
Max Response Time -
Reference
OK
Response
Defined Values
<tcpconnectID>
<host_name>
<port>
<result>
MQTT socket identifier. The value is 0
The address of the server. It could be an IP address or a domain name. The maximum size is 100 bytes
The port of the server. The range is 1-65535
-1 Failed to open network
0 Opened network successfully
8.2.3 AT$QCMTCLOSE Send MQTT Close Packet
AT$QCMTCLOSE Send MQTT Close Packet
Description
Test Command
AT$QCMTCLOSE=?
The command send MQTT close packet.
Response
$QCMTCLOSE:( list of <tcpconnectID>s)
OK www.simcom.com
176/194
SIM7022 Series_AT Command Manual_V1.00
Write Command
AT$QCMTCLOSE=<tcp
Response
$QCMTCLOSE: <tcpconnectID>,<result> or connectID>
Parameter Saving Mode -
ERROR
Max Response Time
Reference
-
Defined Values
<tcpconnectID>
<result>
MQTT socket identifier. The value is 0
-1 Failed to open network
0 Opened network successfully
8.2.4 AT$QCMTCONN Send MQTT Subscribe Packet.
AT$QCMTCONN Send MQTT Subscribe Packet
Description The command send MQTT subscribe packet.
Test Command
AT$QCMTCONN=?
Response
$QCMTCONN: ( list of supported
<tcpconnectID>s),“<clientID>”[,“<username>”[,“<password>”]]
Read Command
AT$QCMTCONN?
Write Command
AT$QCMTCONN=<tcpc onnectID>,“<clientID>”
OK
Response
OK
Response
OK
$QCMTCONN: <tcpconnectID>,<result>[,<ret_code>]
[,“<username>”[,“<pas sword>”]]
Parameter Saving Mode or
ERROR
Max Response Time
Reference
-
Defined Values
<tcpconnectID>
<clientID>
<username> www.simcom.com
MQTT socket identifier. The value is 0
The client identifier
User name of the client. It can be used for authentication
177/194
<password>
<result>
<ret_code>
SIM7022 Series_AT Command Manual_V1.00
Password corresponding to the user name of the client. It can be used for
Authentication.
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
8.2.5 AT$QCMTDISC Send MQTT Disconnect Packet
AT$QCMTDISC Send MQTT Disconnect Packet
Description The command send MQTT disconnect packet.
Test Command
Response
$QCMTDISC: ( list of supported <tcpconnectID>s)
AT$QCMTDISC=?
Write Command
AT$QCMTDISC=<tcpc onnectID>
Parameter Saving Mode -
OK
Response
OK
$QCMTDISC: <tcpconnectID>,<result> or
ERROR
Max Response Time
Reference
-
Defined Values
<tcpconnectID>
<result>
MQTT socket identifier. The value is 0
-1 Failed to open network
0 Opened network successfully www.simcom.com
178/194
SIM7022 Series_AT Command Manual_V1.00
8.2.6 AT$QCMTSUB Send MQTT Subscribe Packet
AT$QCMTSUB Send MQTT Subscribe Packet
Description The command send MQTT subscribe packet.
Test Command
AT$QCMTSUB=?
Response
$QCMTSUB: ( list of supported <tcpconnectID>s),( list of supported
<msgID>s),“<topic>”,( list of supported <qos>s)
OK
Response
Write Command
AT$QCMTSUB=<tcpco
$QCMTSUB: ( list of supported <tcpconnectID>s),( list of supported <msgID>s),“<topic>”,( list of supported <qos>s) nnectID>,<msgID>,“<t opic>”,<qos>
Parameter Saving Mode -
OK
Max Response Time
Reference
-
Defined Values
<tcpconnectID>
<msgID>
<topic>
<qos>
MQTT socket identifier. The value is 0
Message identifier of packet. The range is 1-65535
Topic that the client wants to subscribe to or unsubscribe from. The maximum length is 255 bytes
Message QoS, can be 0,1 or 2
8.2.7 AT$QCMTUNS Send MQTT Unsubscribe Packet
AT$QCMTUNS Send MQTT Unsubscribe Packet
Description The command send MQTT unsubscribe packet.
Test Command
AT$QCMTUNS=?
Write Command
AT$QCMTUNS=<tcpco nnectID>,<msgID>,“<t opic> ”
Response
$QCMTUNS: ( list of supported <tcpconnectID>s),( list of supported <msgID>s),“<topic>”
OK
Response
OK
$QCMTUNS: <tcpconnectID>,<msgID>,<result> www.simcom.com
179/194
SIM7022 Series_AT Command Manual_V1.00
Max Response Time
Reference or
Parameter Saving Mode -
ERROR
-
Defined Values
<tcpconnectID>
<msgID>
<topic>
<result>
MQTT socket identifier. The value is 0
Message identifier of packet. The range is 1-65535
Topic that the client wants to subscribe to or unsubscribe from. The maximum length is 255 bytes
-1 Failed to open network
0 Opened network successfully
8.2.8 AT$QCMTPUB Send MQTT Publish Packet
AT$QCMTPUB Send MQTT Publish Packet
Description
Test Command
AT$QCMTPUB=?
The command send MQTT publish packet .
Response
$QCMTPUB: ( list of supported <tcpconnectID>s),( list of supported <msgID>s),( list of supported <qos>s),( list of supported <retain>s),“<topic>”,“<msg> ”
Write Command
AT$QCMTPUB=<tcpco nnectID>,<msgID>,<qo s>,<retain>,“<topic>”,“
OK
Response
OK
$QCMTDISC: <tcpconnectID>,<msgID>,<result> or
<payload>"
Parameter Saving Mode -
ERROR
Max Response Time -
Reference
Defined Values
<tcpconnectID>
<msgID> www.simcom.com
MQTT socket identifier. The value is 0
Message identifier of packet. The range is 1-65535.It will be 0 only when
<qos>=0
180/194
<qos>
<retain>
<topic>
<payload>
<result>
SIM7022 Series_AT Command Manual_V1.00
Message QoS, can be 0,1 or 2
0 Server should not retain the message
1 Server should retain the message
Topic that needs to be published. The maximum length is 255 bytes
Message that needs to be published. Maximum length is 700 bytes. If in data mode, the maximum length is 1024 bytes
-1 Failed to open network
0 Opened network successfully
8.2.9 $QCMTSTAT Receive Data from MQTT Server
$QCMTSTAT Receive Data from MQTT Server
Description
This is an unsolicited message to indicate MQTT client receive data from
MQTT server.
Parameter Saving Mode -
Max Response Time -
Reference
$QCMTSTAT: <tcpconnectID>,<err_code>
Defined Values
<tcpconnectID>
<err_code>
MQTT socket identifier. The value is 0
1 Connection is closed or reset by peer
8.2.10 $QCMTRECV Receive Data from MQTT Server
$QCMTRECV Receive Data from MQTT Server
Description
This is an unsolicited message to indicate MQTT client receive data from
MQTT server.
Parameter Saving Mode -
Max Response Time -
Reference
$QCMTRECV: <tcpconnectID>,<msgID>,<topic>,<data>
Defined Values
<tcpconnectID> www.simcom.com
MQTT socket identifier. The value is 0
181/194
<msgID>
<topic>
<data>
SIM7022 Series_AT Command Manual_V1.00
The message identifier of packet
The topic that received from MQTT server.
Receive data from server.
www.simcom.com
182/194
SIM7022 Series_AT Command Manual_V1.00
9 AT Commands for HTTP
9.1 Overview
Command
AT+HTTPCREATE
AT+HTTPCON
AT+HTTPDESTROY
AT+HTTPSEND
+HTTPRESPH
+HTTPRESPC
+HTTPERR
Description
Create a http client.
Create a socket and connects with a http server
Close a socket
Send data to the http server
Represent response header
Represent response content.
Epresent error message
9.2 Detailed Descriptions of Commands
9.2.1 AT+HTTPCREATE Creates a Http Client
AT+HTTPCREATE Create a http client.
Set command creates a http or https client instance. Configure host, server
Description
Test Command certification, etc. It can create most 5 instance at one time.
Test command returns values supported as a compound value.
Response
+HTTPCREATE: (list of supported
<flag>s),“<host>”,“<authuser>”,“<authpasswd>”
AT+HTTPCREATE=?
Write Command
AT+HTTPCREATE=<fla g>,<host>[,<authuser>
,<authpasswd>]
OK or
ERROR
Response if there are more commands need to enter:
+HTTP CMD: CONTIUE ENTER CMD
If all commands has enter:
+HTTPCREATE: <httpclientId> or www.simcom.com
183/194
SIM7022 Series_AT Command Manual_V1.00
ERROR
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
5S
Defined Values
<flag>
<host>
<authuser>
<authpasswd>
<httpclientId>
Integer type
1 not last part of command
0 last part of command string type, http server’s host name string type,Authentication user name string type,Authentication password
Integer type, http Client Id ,0-4
NOTE
Only one instance and http was fully verified. https and multiple instances will be test later.
9.2.2 AT+HTTPCON Create a Socket and Connects with a Http Server
AT+HTTPCON Create a socket and connects with a http server
Description
Set command creates a socket and connects with a http server. Then creates a task to receive data come from http server.
Test command returns values supported as a compound value.
Response
+HTTPCON: ( list of supported <httpclientId>)
Test Command
AT+HTTPCON=?
OK or
ERROR
Response
Write Command
AT+HTTPCON=<httpcli entId>
OK or
ERROR
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
40S www.simcom.com
184/194
SIM7022 Series_AT Command Manual_V1.00
Defined Values
<httpclientId> Integer type; http client id returned by +HTTPCREATE
9.2.3 AT+HTTPDESTROY Close a Socket
AT+HTTPDESTROY Close a socket
Description
Set command closes a socket, stops receive data from the http server and free the memory that was allocated by the client when creation.
Test command returns values supported as a compound value.
Response
+HTTPDESTROY: ( list of supported <httpclientId>)
Test Command
AT+HTTPDESTROY=?
OK or
ERROR
Response
Write Command
AT+HTTPDESTROY=<
OK or httpclientId>
ERROR
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
40S
Defined Values
<httpclientId> Integer type; http client id returned by +HTTPCREATE
9.2.4 AT+HTTPSEND SendData to the Http Server
AT+HTTPSEND Send data to the http server
Set command closes a socket, stops receive data from the http server and
Description
Test Command
AT+HTTPSEND=?
free the memory that was allocated by the client when creation.
Test command returns values supported as a compound value.
Response
+HTTPSEND: ( list of supported <httpclientId>),( list of supported <method>),( range of supported <pathlen>),“<path>”, ( range of supported <customheaderlen>),“<customheader>”,( range of supported <contentTypelen>),“<contentType>”,( rangeof www.simcom.com
185/194
SIM7022 Series_AT Command Manual_V1.00
supported <contentlen>),“<content>”
OK or
ERROR
Write Command
AT+HTTPSEND=<httpc lientId>,<method>,<pat hlen>,<path>,<custom headerlen>,<customhe ader>,<contentTypelen
Response
OK or
ERROR
>,<contentType>,<cont entlen>,<content>
Parameter Saving Mode NO_SAVE
Max Response Time
Reference
5S
Defined Values
<httpclientId>
<method>
Integer type; http client id returned by +HTTPCREATE
Integer type; http method
0 GET
1 POST
2 PUT
3 DELETE
4 HEAD
Integer type, Lenth of path,0-260 <pathlen>
<path>
<customheaderlen> Integer type, Length of custom header,0-255
<customheader> string type, Customheader in hex string
<contentTypelen>
<contentType>
<contentlen>
<content> string typePath
Integer type, Length of content type,0-64 string type, Content type
Integer type, Length of content, 0-1024
String type
User data need to send in hex string
9.2.5 +HTTPRESPH Represent response header
+HTTPRESPH Represent response header
Description This is an unsolicited message to represent response header.
www.simcom.com
186/194
SIM7022 Series_AT Command Manual_V1.00
Parameter Saving Mode -
Max Response Time -
Reference
+HTTPRESPH: <clientId>,<responseCode>,<headerlen>,<header>
Defined Values
<clientId>
<responseCode>
<headerlen>
<header>
Integer type,http client id returned by +HTTPCREATE
Integer type, http response code
Integer type, Length of http response header
Integer type, Header
9.2.6 +HTTPRESPC Represent response content
+HTTPRESPC Represent response content
Description This is an unsolicited message to represent response content.
Parameter Saving Mode -
+HTTPRESPC:<clientId>,<flag>,<contentlength>,<blockcontentlen>,< content>
Max Response Time
Reference
-
Defined Values
<clientId>
<flag>
<contentlength>
<blockcontentlen>
<content>
Integer type,http client id returned by +HTTPCREATE
Integer type, if has more data
0 No more data
1 Has more data
Integer type, Length of content
Integer type, Current block length string type content
9.2.7 +HTTPERR Indicate of error Message
+HTTPERR Indicate of error message www.simcom.com
187/194
SIM7022 Series_AT Command Manual_V1.00
Description
This is an unsolicited message to represent error message when error happen.
Parameter Saving Mode -
Max Response Time -
Reference
+HTTPERR: <clientId>,<errorcode>,[<rspcode>]
Defined Values
<clientId>
<errorcode>
Integer type,http client id returned by +HTTPCREATE
Integer type, if has more data
2 URL parse error
3 could not resolve DNS
4 Protocol error
5 HTTP 404 error,NOT FOUND
6 HTTP 403 error,REFUSED
7 HTTP xxx error,with specific rspcode for followed
8 Connection timeout
9 Connection error
10 Connection fatal error
11 Connection closed
13 Buffer overflow error www.simcom.com
188/194
SIM7022 Series_AT Command Manual_V1.00
10 Error Codes and Reset Reasons
10.1 Summary of CME ERROR Codes
Final result code +CME ERROR: <err> indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same Command line is executed. Neither ERROR nor OK result code shall be returned.
< err > values used by common messaging commands:
10.1.1 General Errors
20
21
22
16
17
18
23
13
14
15
10
11
12
5
6
7
2
3
Code of <err>
1
4
Error Text
MT not connection
MT link reserved operation not allowed operation not supported
PH-SIM PIN required
PH-FSIM PIN required
PH-FSIM PUK required
SIM not inserted
SIM PIN required
SIM PUK required
SIM failure
SIM busy
SIM wrong incorrect password
SIM PIN2 required
SIM PUK2 required memory full invalid index not found memory failure www.simcom.com
189/194
55
56
57
62
63
100
103
58
59
60
61
45
46
47
42
43
44
27
30
31
32
40
41
52
53
54
48
49
50
51
24
25
26
30
31
23
24
25
26
27 www.simcom.com
SIM7022 Series_AT Command Manual_V1.00
text string too long invalid characters in text string dial string too long invalid characters in dial string no network service network timeout memory failure text string too long invalid characters in text string dial string too long invalid characters in dial string no network service network timeout network not allowed - emergency call only network personalization PIN required network personalization PUK required network subset personalization PIN required network subset personalization PUK required service provider personalization PIN required service provider personalization PUK required corporate personalization PIN required corporate personalization PUK required hidden key required
EAP method not support incorrect Parameters command implemented but currently disabled command aborted by user not attached to network due to MT functionality restrictions modem not allowed - MT restricted to emergency calls only operation not allowed because of MT functionality restrictions fixed dial number only allowed - called number is not a fixed dial number temporarily out of service due to other MT usage language/alphabet not supported unexpected data value system failure data missing call barred message waiting indication subscription failure unknown illegal MS
190/194
112
113
114
115
122
126
106
107
108
111
127
128
129
130
131
146
148
149
150
171
172
173
174
175
132
133
134
140
141
142
143
144
145
176
177
178
179
180
181
182
301
302
303 www.simcom.com
SIM7022 Series_AT Command Manual_V1.00
illegal ME
GPRS services not allowed
GPRS services and non GPRS services not allowed
PLMN not allowed location area not allowed roaming not allowed in this location area
GPRS services not allowed in this plmn
No suitable cells in location area
Congestion
Insufficient resources
Mission or unknown APN
SIM PUK required
SIM failure
SIM busy
SIM wrong incorrect password requested service option not subscribed service option temporarily out of order
Feature not supported
Semantic errors in the TFT operation
Syntactical errors in the TFT operation
Unknown PDP context
Semantic errors in packet filters
Syntactical errors in packet filters
PDP context without TFT already activated unspecified GPRS error
PDP authentication failure invalid mobile class
Last PDN disconnection not allowed
Semantically incorrect message
Mandatory information element error
Information element nonexistent or not implemented
Conditional ie error
Protocol error unspecified
Operator determined barring
Max number of PDP contexts reached
Requested APN not supported in current rat and PLMN combination
Request rejected bearer control mode violation
Unsupported oci value
User data transmission via control plane is congested
Internal error base
UE busy
Not power on
191/194
304
305
306
307
308
309
PDN not active
PDN not valid
PDN invalid type
PDN no parameter
UE fail
PDN type and APN duplicate used
SIM7022 Series_AT Command Manual_V1.00
10.1.2 Error Code for Socket Command
415
416
417
418
419
420
421
410
411
412
413
414
406
407
408
409
Code of <err>
402
403
404
405
Error Text
Parameter invalid
Too much socket instance
Create socket error operation not supported
Cannot find the socket
Socket Connect fail
Socket bind fail
Send data fail
The socket status is not connected
The socket status is already connected
The socket status is invalid
The socket connect timeout
The socket close fail
The socket happen fatal error
Cannot allocate more memory
No more DL buffer resource
The socket is connecting
UL sequence is invalid
Send request fail
Unknown error
10.1.3 Error Code for CTM2M
4
8
2
3
Code of <err>
1
Error Text
Other errors
Parameter quantity error
Parameter value error command cannot be issued
The platform connection parameter is not initialized www.simcom.com
192/194
960
961
968
969
970
972
954
955
957
959
950
951
952
953
14
15
16
17
33
34
SIM7022 Series_AT Command Manual_V1.00
The Data field length exceeds the limit
The Object19 transport channel does not exist
Unable to obtain IMSI
Data fields are not even in length
Operation failed. Logged in
Failed to create LWM2M session
Engine exception, recovering
The connection is unavailable, the network is congested
Operation failed, overwrite level 2
Engine exception, need to restart
Operation failed, not logged in
Operation failed, log in
The connection is temporarily unavailable
The operation is not allowed, only if ON_UQMode=2
Operation failed. No authentication encryption string is set
Error setting allowed only when IDAuth_Mode=2/3
Functionality not supported or otherwise
Lifetime exceeds the limit
Cache queue overruns
Invalid Uri_str
10.2 Summary of CMS ERROR Codes
310
311
312
313
314
315
Code of <err>
300
301
302
303
304
305
Final result code +CMS ERROR: <err> indicates an error related to message service or network. The operation is similar to ERROR result code. None of the following commands in the same Command line is executed. Neither ERROR nor OK result code shall be returned.
< err > values used by common messaging commands:
Meaning
ME failure
SMS service of ME reserved operation not allowed operation not supported invalid PDU mode parameter invalid text mode parameter
USIM not inserted
USIM PIN required
PH-(U)SIM PIN required
USIM failure
USIM busy
USIM wrong www.simcom.com
193/194
321
322
330
331
332
340
500
316
317
318
320
SIM7022 Series_AT Command Manual_V1.00
USIM PUK required
USIM PIN2 required
USIM PUK2 required memory failure invalid memory index memory full
SMSC address unknown no network service network timeout no +CNMA acknowledgement expected unknown error
10.3 Summary of Unsolicited Result Codes
URC Description AT Command www.simcom.com
194/194
Download
Public link updated
The public link to your chat has been updated. You may view and manage your chat links after registration here.
Document public link
Advertisement
Key features
Supports network registration with detailed status reporting.
Offers signal quality reports for network monitoring.
Enables PDP context activation and deactivation.
Provides commands for power saving mode setting (PSMS).
Supports Extended-DRX configuration.
Allows time zone reporting and automatic update.
Includes socket commands for network communication.
Offers AT commands for MQTT and HTTP protocols.
CIoT optimization configuration support
Frequently asked questions
Use the AT+CREG command.
Use the AT+CPSMS command to configure power saving mode settings.
Use the AT+CGACT command to activate or deactivate a PDP context.
Use the AT+CSQ command to get a signal quality report.