" <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>=<…>

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. www.simcom.com 14 / 331

SIM7020 Series_AT Command Manual_V1.05

Execution Command

AT+<x>

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:

ATE1Q0S0=1S3=13V1X4;+IFC=0,0;+IPR=115200.

The Command line buffer can accept a maximum of 2048 characters (counted from the first command without "AT" or "at" prefix). 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 Supported character sets

The SIM7020 Series AT Command interface defaults to the IRA character set. The SIM7020 Series supports the following character sets:

GSM format

UCS2

IRA

The character set can be set and interrogated using the "AT+CSCS" Command (3GPP TS 27.007). The character set is defined in GSM specification 3GPP TS 27.005.

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.6 Flow control

Flow control is very important for correct communication between the GSM engine and DTE. For in the case such as a data or fax call, the sending device is transferring data faster than the receiving side is ready www.simcom.com 15 / 331

SIM7020 Series_AT Command Manual_V1.05 to accept. When the receiving buffer reaches its capacity, the receiving device should be capable to cause the sending device to pause until it catches up.

There are basically two approaches to achieve data flow control: software flow control and hardware flow control. SIM7020 Series support both two kinds of flow control.

In Multiplex mode, it is recommended to use the hardware flow control.

1.6.1 Software flow control (XON/XOFF flow control)

Software flow control sends different characters to stop (XOFF, decimal 19) and resume (XON, decimal 17) data flow. It is quite useful in some applications that only use three wires on the serial interface.

The default flow control approach of SIM7020 Series is hardware flow control (RTS/CTS flow control), to enable software flow control in the DTE interface and within GSM engine, type the following AT Command:

AT+IFC=1,1

Ensure that any communications software package (e.g. Hyper terminal) uses software flow control.

NOTE

Software Flow control should not be used for data calls where binary data will be transmitted or received (e.g. TCP/IP) as the DTE interface may interpret binary data as flow control characters.

1.6.2 Hardware flow control (RTS/CTS flow control)

Hardware flow control achieves the data flow control by controlling the RTS/CTS line. When the data transfer should be suspended, the CTS line is set inactive until the transfer from the receiving buffer has completed. When the receiving buffer is ok to receive more data, CTS goes active once again.

To achieve hardware flow control, ensure that the RTS/CTS lines are present on your application platform.

1.7 Definitions

1.7.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 www.simcom.com 16 / 331

SIM7020 Series_AT Command Manual_V1.05 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.

 AT&W_SAVE : The parameter of the current AT command will be kept in NVRAM by sending the command of "AT&W".

 : "-" means this AT command doesn't care the parameter saving mode.

1.7.2 Max Response Time

Max response time is estimated maximum time to get response, the unit is seconds.

"-" means this AT command does not care the response time. www.simcom.com 17 / 331

SIM7020 Series_AT Command Manual_V1.05

2 AT Commands According to

V.25TER

2.1 Overview of AT Commands According to V.25TER

Command

ATE

ATI

ATL

ATM

ATN1

ATS10

ATS12

ATS25

ATS95

ATV

ATX

ATZ

AT&C

AT&D

AT&F

AT&K

ATO

ATQ

ATS0

ATS1

ATS2

ATS3

ATS4

ATS5

ATS6

ATS7

ATS8

Description

Set command echo mode

Display product identification information

Set monitor speaker loudness

Set monitor speaker mode

Some PC modem driver initial setting to handshake at highest speed larger than S37

Switch from command mode to data mode

Set result code presentation mode

Set number of rings before automatically answering the call

Ring counter

Set escape sequence character

Set command line termination character

Set response formatting character

Set command line editing character

Pause before blind dialling

Set number of seconds to wait for connection completion

Set number of seconds to wait for comma dial modifier encountered in dial string of D command

Set disconnect delay after indicating the absence of data carrier

Set escape code guard time

Set DTR change time

Some PC modem driver initial setting to enable extended result codes

TA response format

Set connect result code format and monitor call progress

Reset default configuration

Set DCD function mode

Set DTR function mode

Factory defined configuration

Flow control setting www.simcom.com 18 / 331

AT&V

AT&W

AT+GMI

AT+GMM

AT+GMR

AT+GOI

AT+GSN

AT+ICF

AT+IFC

AT+IPR

SIM7020 Series_AT Command Manual_V1.05

Display current configuration

Store Active Profile

Request manufacturer identification

Request TA model identification

Request TA revision identification of software release

Request global object identification

Request TA serial number identification (IMEI)

Set TE-TA control character framing

Set TE-TA local data flow control

Set TE-TA fixed local rate

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.

NO_SAVE

Max Response Time

Reference

Defined Values

<value>

0 Echo mode off

1 Echo mode on

Example

ATE0

OK www.simcom.com 19 / 331

SIM7020 Series_AT Command Manual_V1.05

2.2.2 ATI Display Product Identification Information

ATI Display Product Identification Information

Execution Command

ATI

Parameter Saving Mode

Response

TA issues product information text.

Example:

SIM7020 R1752

NO_SAVE

Max Response Time -

Reference

Example

ATI

SIM7020 R1752

2.2.3 ATL Set Monitor Speaker Loudness

ATL Set Monitor Speaker Loudness

Execution Command

ATL<value>

Parameter Saving Mode

Response

NO_SAVE

- Max Response Time

Reference

Defined Values

<value>

Example

ATL0

0..3 Volume www.simcom.com 20 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 No effect in GSM

2.2.4 ATM Set Monitor Speaker Mode

ATM Set Monitor Speaker Mode

Execution Command

ATM<value>

Parameter Saving Mode

Response

Parameters

<value> 0..2 Mode

NO_SAVE

- Max Response Time

Reference

Example

ATM0

NOTE

 No effect in GSM

2.2.5 ATN1 Some PC Modem Driver Initial Setting to Handshake at Highest Speed

Larger Than S37

ATN1 Some PC Modem Driver Initial Setting to Handshake at Highest Speed

Larger Than S37

Execution Command Response

ATN1

Parameter Saving Mode

NO_SAVE

Max Response Time

Reference

- www.simcom.com 21 / 331

SIM7020 Series_AT Command Manual_V1.05

Example

ATN1

2.2.6 ATO Switch from Command Mode to Data Mode

ATO Switch from Command Mode to Data Mode

Execution Command

ATO[n]

Parameter Saving Mode

Response

TA resumes the connection and switches back from command mode to data mode.

CONNECT

If connection is not successfully resumed

ERROR else

TA returns to data mode from command mode CONNECT <text>

Note: <text> only if parameter setting ATX>0

NO_SAVE

- Max Response Time

Reference

Defined Values

<n>

Example

ATO

CONNECT 150000000

0 Switch from command mode to data mode

2.2.7 ATQ Set Result Code Presentation Mode

ATQ Set Result Code Presentation Mode

Execution Command

ATQ<n>

Response

This parameter setting determines whether or not the TA transmits any www.simcom.com 22 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode result code to the TE. Information text transmitted in response is not affected by this setting.

If <n> =0:

If <n> =1:

(none)

NO_SAVE

Max Response Time

Reference

Defined Values

<n>

0 TA transmit result code

1 Result codes are suppressed and not transmitted

Example

ATQ1

NOTE

 This command only affects V.250 AT commands and not all other AT commands in this specification (either 3GPP or MediaTek proprietary).

2.2.8 ATS0 Set Number of Rings before Automatically Answering the call

ATS0 Set Number of Rings before Automatically Answering the call

Read Command

ATS0?

Write Command

ATS0=<n>

Parameter Saving Mode

Response

<n>

Response

This parameter setting determines the number of rings before auto-answer.

OK or

ERROR

- www.simcom.com 23 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time -

Reference

Defined Values

<n> 0 Automatic answering is disabling.

1-255 Number of rings the modem will wait for before answering the phone if a ring is detected.

Example

ATS0?

ATS0=3

NOTE

 If <n> is set too high, the calling party may hang up before the call can be answered automatically.

 If using cmux port, ATH and AT+CHUP can hang up the call (automatically answering) only in the

CMUX channel 0.

 If using dual-physical serial port, ATH and AT+CHUP can hang up the call (automatically answering) only in UART1.

2.2.9 ATS1 Ring Counter

ATS1 Ring Counter

Read Command

ATS1?

Write Command

ATS1=<n>

Response

<n>

Response

This command will not alert the RING counter,but simply display

OK or

ERROR www.simcom.com 24 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode AT&W_SAVE

Max Response Time

Reference

Defined Values

<n>

The number of "RING" strings sent to the TE as a result of receiving an incoming call.

0-255

Example

ATS1?

ATS1=3

NOTE

 If "RING" is not displayed on a particular channel due to other settings (such as suppression of all unsolicited events (ATQ)) then this value should not be incremented. This value is reset to 0 when receiving a new incoming call. Note that this command should also be made channel specific as with other ATS<x> commands.

2.2.10 ATS2 Set Escape Sequence Character

ATS2 Set Escape Sequence Character

Read Command

ATS2?

Write Command

ATS2=<n>

Response

<n>

Response

This parameter setting determines the character recognized by the TA to indicate the escape sequence.

OK or

ERROR www.simcom.com 25 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

V.25ter

Defined Values

<n>

AT&W_SAVE

0-43-255 escape sequence character

Note: default 43='+'

Example

ATS2?

ATS2=43

2.2.11 ATS3 Set Command Line Termination Character

ATS3 Set Command Line Termination Character

Read Command

ATS3?

Write Command

ATS3=<n>

Parameter Saving Mode

Response

<n>

Response

This parameter setting determines the character recognized by TA to terminate an incoming command line. The TA also returns this character in output.

OK or

ERROR

Max Response Time

Reference

Defined Values

- www.simcom.com 26 / 331

SIM7020 Series_AT Command Manual_V1.05

<n>

Example

ATS3?

0-13-127 Command line termination character

ATS3=13

NOTE

 Default 13=CR. It only supports default value.

2.2.12 ATS4 Set Response Formatting

ATS4 Set Response Formatting

Read Command

ATS4?

Write Command

ATS4=<n>

Parameter Saving Mode

Response

<n>

Response

This parameter setting determines the character generated by the TA for result code and information text.

OK or

ERROR

Note

Max Response Time

Reference

Defined Values

<n>

Example

0-10-127 Response formatting character www.simcom.com 27 / 331

SIM7020 Series_AT Command Manual_V1.05

ATS4?

ATS4=10

NOTE

 Default 10=LF. It only supports default value.

2.2.13 ATS5 Set Command Line Editing Character

ATS5 Set Command Line Editing Character

Read Command

ATS5?

Write Command

ATS5=<n>

Parameter Saving Mode

Response

<n>

Response

This parameter setting determines the character recognized by TA as a request to delete from the command line the immediately preceding character.

OK or

ERROR

- Max Response Time

Reference

Defined Values

<n>

Example

ATS5?

0-8-127 Response formatting character www.simcom.com 28 / 331

SIM7020 Series_AT Command Manual_V1.05

ATS5=8

NOTE

 Default 8=Backspace

2.2.14 ATS6 Pause Before Blind Dialling

ATS6 Pause Before Blind Dialling

Read Command

ATS6?

Write Command

ATS6=<n>

Parameter Saving Mode

Response

<n>

Response

OK or

ERROR

AT&W_SAVE

- Max Response Time

Reference

Defined Values

<n>

Example

ATS6?

ATS6=2

NOTE

0-2-10 Time www.simcom.com 29 / 331

SIM7020 Series_AT Command Manual_V1.05

 No effect in GSM

2.2.15 ATS7 Set Number of Seconds to Wait for Connection Completion

ATS7 Set Number of Seconds to Wait for Connection Completion

Read Command

ATS7?

Write Command

ATS7=<n>

Parameter Saving Mode

Response

<n>

Response

This parameter setting determines the amount of time to wait for the connection completion in case of answering or originating a call.

OK or

ERROR

AT&W_SAVE

- Max Response Time

Reference

Defined Values

<n>

Example

ATS7?

1-60-255 Number of seconds to wait for connection completion

ATS7=60

NOTE

 If called party has specified a high value for ATS0=<n>, call setup may fail.The correlation between

ATS7 and ATS0 is important www.simcom.com 30 / 331

SIM7020 Series_AT Command Manual_V1.05

 Example: Call may fail if ATS7=30 and ATS0=20.

 ATS7 is only applicable to data call.

2.2.16 ATS8 Set Number of Seconds to Wait for Comma Dial Modifier Encountered in

Dial String of D Command

ATS8 Set Number of Seconds to Wait for Comma Dial Modifier Encountered in Dial

String of D Command

Read Command

ATS8?

Response

<n>

Write Command

ATS8=<n>

Parameter Saving Mode

Response

OK or

ERROR

- Max Response Time

Reference

Defined Values

<n> 0 no pause when comma encountered in dial string

1-2-255 The value of this register determines how long the modem should pause when it sees a comma in the dialing string.

Example

ATS8?

ATS8=2

NOTE

 No effect in GSM www.simcom.com 31 / 331

SIM7020 Series_AT Command Manual_V1.05

2.2.17 ATS10 Set Disconnect Delay after indicating the Absence of Data Carrier

ATS10 Set Disconnect Delay after indicating the Absence of Data Carrier

Read Command

ATS10?

Write Command

ATS10=<n>

Parameter Saving Mode

Response

<n>

Response

This parameter setting determines the amount of time that the TA will remain connected in absence of data carrier. If the data carrier is once more detected before disconnecting, the TA remains connected.

OK or

ERROR

Max Response Time

Reference

Defined Values

<n>

Example

ATS10?

1-15-254 Number of tenths seconds of delay

ATS10=15

NOTE

 This command is not used, as there have been issues with in-band DCD dropping unexpectedly for

CSD calls on some networks. www.simcom.com 32 / 331

SIM7020 Series_AT Command Manual_V1.05

2.2.18 ATS12 Set Escape Code Guard Time

This command sets the escape code guard time in fiftieths of a second. The escape guard time is used to measure when to detect the +++ escape sequence has been entered by the PC in order to drop out of data mode back to AT command mode.

The guard time determines the time that forms a guard period before and after three escape sequence characters. In order to distinguish an escape sequence from just three escape sequence characters in the data stream there is timing associated to the three escape sequence characters of an escape sequence.

The time between the last byte of the data stream and the first escape sequence character must be at least the guard time and the time between each escape sequence character of the escape sequence must be less than the guard time and no other byte is received after the third escape sequence character for the time of the guard time. If an escape sequence is detected, the OK result code will be sent to the DTE.

Otherwise, the DCE will stay in data mode.

For example: "<Guard time>+++<Guard time>"

ATS12 Set Escape Code Guard Time

Read Command

ATS12?

Write Command

ATS12=<n>

Parameter Saving Mode

Response

<n>

NB: <n> is in 3 decimal digits format (e.g. Default value is given as

050).

If error is related to wrong AT syntax:

+CME ERROR: <err>

Response

OK or

ERROR

AT&W_SAVE

- Max Response Time

Reference

Defined Values

<n>

Example

ATS12?

0-50-255 Number of 20 ms. www.simcom.com 33 / 331

SIM7020 Series_AT Command Manual_V1.05

ATS12=50

2.2.19 ATS25 Set DTR Change Time

This command sets the S-register 25 Detect DTR change time that contain the threshold for noticing a change in DTR. This time permits to the modem to ignore DTR before taking action specified by &Dn (See

AT&D Circuit 108 behavior).

The value unit is in 1/100 seconds. Default value is set to 5 (50ms delay after a DTR drop before the modem acts on it).

ATS25 Set DTR Change Time

Read Command

ATS25?

Write Command

ATS25=<n>

Parameter Saving Mode

Response

<n>

NB: <n> is in 3 decimal digits format (e.g. Default value is given as

000).

If error is related to wrong AT syntax:

+CME ERROR: <err>

Response

OK or

ERROR

Parameters

<n> 0-5-255 Number of 10 ms.

AT&W_SAVE

- Max Response Time

Reference

Defined Values

<n>

Example

ATS25?

ATS25=5

0-5-255 Number of 10 ms. www.simcom.com 34 / 331

SIM7020 Series_AT Command Manual_V1.05

2.2.20 ATS95 Some PC Modem Driver Initial Setting to Enable Extended Result Codes

ATS25 Some PC Modem Driver Initial Setting to Enable Extended Result Codes

Read Command

ATS95?

Write Command

ATS95=<n>

Parameter Saving Mode

Response

<n>

Response

Some standard PC modem drivers will send this AT command to initialize the setting, but it is meaningless in the 3GPP standard. So we just return "OK" and no effect for the setting.

Parameters

<n> 0-255 Meaningless for the GSM, and GPRS/Packet

Domain setting.

AT&W_SAVE

- Max Response Time

Reference

Defined Values

<n>

Example

ATS95?

000

ATS95=100

0-255 Meaningless for the GSM, and GPRS/Packet Domain setting.

2.2.21 ATV TA Response Format

ATV TA Response Format www.simcom.com 35 / 331

SIM7020 Series_AT Command Manual_V1.05

Execution Command

ATV<value>

Response

This parameter setting determines the contents of the header and trailer transmitted with result codes and information responses.

When <value> =0

When <value> =1

AT&W_SAVE

Parameter Saving Mode

Max Response Time

Reference

ATV1 ATV0 Description

CONNECT

RING

NO CARRIER

ERROR

NO DIALTONE

BUSY

NO ANSWER

Acknowledges execution of a Command

A connection has been established; the DCE is moving from Command state to online data state

The DCE has detected an incoming call signal from network

The connection has been terminated or the attempt to establish a connection failed

Command not recognized, Command line maximum length exceeded, parameter value invalid, or other problem with processing the Command line

No dial tone detected

Engaged (busy) signal detected

"@" (Wait for Quiet Answer) dial modifier was used, but remote ringing followed by five seconds of silence was not detected before expiration of the connection timer

(S7)

An AT command is being processed PROCEEDING 9

CONNECT <text> Manufacturer-specific Same as CONNECT, but includes manufacturer-specific text that may specify DTE speed, line speed, error control, data compression, or other status

Defined Values

<value> 0 Information response: <text><CR><LF>

Short result code format: <numeric code><CR>

1 Information response: <CR><LF><text><CR><LF>

Long result code format: <CR><LF><verbose code><CR><LF>

The result codes, their numeric equivalents and brief descriptions of the use of each are listed in the following table. www.simcom.com 36 / 331

SIM7020 Series_AT Command Manual_V1.05

Example

ATV0

ATV1

2.2.22 ATX Set CONNECT Result Code Format and Monitor Call Progress

ATV Set CONNECT Result Code Format and Monitor Call Progress

Execution Command

ATX<value>

Parameter Saving Mode

Response

This parameter setting determines whether or not the TA detected the presence of dial tone and busy signal and whether or not TA transmits particular result codes.

OK or

ERROR

AT&W_SAVE

Max Response Time -

Note Reference

Defined Values

<value> 0 CONNECT result code only returned, dial tone and busy detection are both disabled.

1 CONNECT<text> result code only returned, dial tone and busy detection are both disabled.

2 CONNECT<text> result code returned, dial tone detection is enabled, busy detection is disabled.

3 CONNECT<text> result code returned, dial tone detection is

disabled, busy detection is enabled.

4 CONNECT<text> result code returned, dial tone and busy detection are both enabled.

Example

ATX1

ATX2 www.simcom.com 37 / 331

SIM7020 Series_AT Command Manual_V1.05

2.2.23 ATZ Reset Default Configuration

ATZ Reset Default Configuration

Execution Command

ATX[<value>]

Parameter Saving Mode

Response

TA sets all current parameters to the user defined profile.

OK or

ERROR

NO_SAVE

Note

Max Response Time

Reference

Defined Values

<value>

Example

ATZ0

0 Restore profile 0

2.2.24 AT&C Set DCD Function Mode

AT&C Set DCD Function Mode

Execution Command

AT&C<value>

Parameter Saving Mode

Max Response Time

Reference

V.25ter

Response

This parameter determines how the state of circuit 109 (DCD) relates to the detection of received line signal from the distant end.

OK or

ERROR

NO_SAVE

Note www.simcom.com 38 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<value> 0 DCD line is always ON

1 DCD line is ON only in the presence of data carrier

Example

AT&C1

AT&C0

2.2.25 AT&D Set DTR Function Mode

AT&D Set DTR Function Mode

Execution Command

AT&D<value>

Parameter Saving Mode

Response

This parameter determines how the TA responds when circuit 108/2

(DTR) is changed from the ON to the OFF condition during data mode.

OK or

ERROR

NO_SAVE

- Max Response Time

Reference

Defined Values

<value> 0 TA ignores status on DTR.

1 ON->OFF on DTR: Change to Command mode with remaining the connected call.

2 ON->OFF on DTR: Disconnect call, change to Command mode.

During state DTR=OFF is auto-answer off.

Example

AT&D1

AT&D0 www.simcom.com 39 / 331

SIM7020 Series_AT Command Manual_V1.05

2.2.26 AT&F Factory Defined Configuration

AT&F Factory Defined Configuration

Execution Command

AT&F[<value>]

Parameter Saving Mode

Response

TA sets all current parameters to the manufacturer defined profile.

OK or

ERROR

NO_SAVE

Max Response Time

Reference

Defined Values

<value>

Example

AT&F0

0 Set all TA parameters to manufacturer defaults.

2.2.27 AT&K Flow Control Setting

AT&K Flow Control Setting

Execution Command

AT&K[<value>]

Parameter Saving Mode

Response

NO_SAVE

Max Response Time

Reference

Defined Values

- www.simcom.com 40 / 331

SIM7020 Series_AT Command Manual_V1.05

<value> 0 No flow control

3 RTS /CTS flow control (hardware)

4 XON/XOFF flow control (software)

Example

AT&K0

NOTE

This command does not store anything in the profile data because it sets the AT+IFC settings when used:

 AT&K0 is equivalent of entering AT+IFC=0,0

 AT&K3 is equivalent of entering AT+IFC=2,2

 AT&K4 is equivalent of entering AT+IFC=1,1

2.2.28 AT&V Display Current Configuration

AT&V Display Current Configuration

Execution Command

AT&V[<n>]

Parameter Saving Mode

Response

TA returns the current parameter setting.

<current configurations text>

OK or

ERROR

NO_SAVE

Max Response Time

Reference

Defined Values

<n>

Example

0 Responses in numeric format www.simcom.com 41 / 331

SIM7020 Series_AT Command Manual_V1.05

AT&V

ACTIVE PROFILE

E: 1

L: 0

M: 0

Q: 0

V: 1

X: 4

S0: 0

S1: 0

S2: 43

S3: 13

S4: 10

S5: 8

S6: 2

S7: 60

S8: 2

S10: 15

S12: 50

S25: 5

+CR: 0

+CMEE: 0

+IFC: 0,0

+ICF: 3,3

+CSCS: "IRA"

+IPR: 0

&C: 1

&D: 2

+CGEREP: 0

+CEER: 0

+CGPIAF: 0,0,0,0

+CPSMSTATUS: 1

+CMGF: 0

+CSDH: 0

+CSMINS: 0

+CMUX: 0,0,0,31,10,3,30,10,2

2.2.29 AT&W Store Active Profile

AT&W Store Active Profile

Execution Command

AT&W[<n>]

Response

TA stores the current parameter setting in the user defined profile. www.simcom.com 42 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Parameter stored by &W

Command

ATS0

ATS3

ATS4

ATS5

ATS6

ATS7

ATS8

ATS10

ATV

ATE

ATQ

ATX

AT&C

AT&D

AT+CREG

AT+CGREG

AT+CMEE

AT+CSCS

AT+CSMINS

AT+EXUNSOL

Defined Values

<n>

Example

AT&W

<current configurations text>

OK or

ERROR

NO_SAVE

Parameter name

<num>

<char>

<short>

<time>

<echo>

<n>

<chest>

<n>

0 Store the current configuration in profile 0

Displayedby &v

Y www.simcom.com 43 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 The user defined profile is stored in non volatile memory.

2.2.30 AT+GMI Request Manufacturer Identification

AT+GMI Request Manufacturer Identification

Test Command

AT+GMI=?

Execution Command

AT+GMI

Parameter Saving Mode

Response

TA reports one or more lines of information text which permit the user to identify the manufacturer.

SIMCOM_Ltd

NO_SAVE

Max Response Time -

Note Reference

Example

AT+GMI

SIMCOM_Ltd

2.2.31 AT+GMM Request TA Model Identification

AT+GMM Request TA Model Identification

Test Command

AT+GMM=?

Execution Command

AT+GMM

Response

TA reports one or more lines of information text which permit the user to identify the specific model of device.

Model www.simcom.com 44 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<model>

Example

AT+GMM

SIM7020C

NO_SAVE

Note

Product model identification text

2.2.32 AT+GMR Request TA Revision Identification of Software Release

AT+GMR Request TA Revision Identification of Software Release

Test Command

AT+GMR=?

Execution Command

AT+GMR

Response

TA reports one or more lines of information text which permit the user to identify the revision of software release.

<revision>

NO_SAVE

Note

Parameter Saving Mode

Max Response Time

Reference

Defined Values

< revisiom >

Example

Revision of software release www.simcom.com 45 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+GMR

1752B01V01SIM7020C

2.2.33 AT+GOI Request Global Object Idenitification

AT+GOI Request Global Object Idenitification

Test Command

AT+GOI=?

Execution Command

AT+GOI

Parameter Saving Mode

Response

TA reports one or more lines of information text which permit the user to identify the device, based on the ISO system for registering unique object identifiers.

<Object Id>

NO_SAVE

Max Response Time

Reference

Defined Values

< Object Id >

Note

Identifier of device type see X.208, 209 for the format of <Object Id>

Example

AT+GOI

SIM7020C

2.2.34 AT+GSN Request TA Serial Number Identification(IMEI)

AT+GSN Request TA Serial Number Identification(IMEI)

Test Command Response www.simcom.com 46 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+GSN=?

Execution Command

AT+GSN

Parameter Saving Mode

Response

TA reports the IMEI (international mobile equipment identifier) number in information text which permit the user to identify the individual ME device.

<sn>

NO_SAVE

Max Response Time

Reference

Defined Values

<sn>

IMEI of the telephone(International Mobile station Equipment Identity)

Example

AT+GSN

0000000000000000

NOTE

 The serial number (IMEI) is varied by individual ME device.

2.2.35 AT+ICF Set TE-TA Control Character Framing

AT+ICF Set TE-TA Control Character Framing

Test Command

AT+ICF=?

Read Command

AT+ICF?

Response

+ICF: (list of supported <format> s),(list of supported <parity> s)

Response

+ICF: <format>,<parity>

OK www.simcom.com 47 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+ICF=<formate>,[<parity>

]

Parameter Saving Mode

Response

This parameter setting determines the serial interface character framing format and parity received by TA from TE.

AT&W_SAVE

Max Response Time

Reference

Defined Values

< format >

<parity>

1 8 data 0 parity 2 stop

2 8 data 1 parity 1 stop

3 8 data 0 parity 1 stop

4 7 data 0 parity 2 stop

5 7 data 1 parity 1 stop

6 7 data 0 parity 1 stop

0 odd

1 even

2 mark(1)

3 space (0)

Example

AT+ICF?

+ICF:3,3

AT+ICF=3,3

NOTE

 The Command is applied for Command state;

 In <format> parameter, "0 parity" means no parity;

 The <parity> field is ignored if the <format> field specifies no parity and string "+ICF: <format>,255" will be response to "AT+ICF?" Command

2.2.36 AT+IFC Set TE-TA Local Data Flow Control www.simcom.com 48 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+IFC Set TE-TA Local Data Flow Control

Test Command

AT+IFC=?

Read Command

AT+IFC?

Write Command

AT+IFC=<dce_by_dte>,[<dte

_by_dce>]

Parameter Saving Mode

Response

+IFC: (list of supported <dce_by_dte> s),(list of supported

<dte_by_dce> s)

Response

+IFC: <dce_by_dte>,<dte_by_dce>

Response

This parameter setting determines the data flow control on the serial interface for data mode.

Parameters

<dce_by_dte> Specifies the method will be used by TE at receive of data from TA

0 No flow control

1 Software flow control

2 Hardware flow control

<dte_by_dce> Specifies the method will be used by TA at receive of data from TE

0 No flow control

1 Software flow control

2 Hardware flow control

NO_SAVE

Note

Max Response Time

Reference

Defined Values dce_by_dte

<dte_by_dce>

Specifies the method will be used by TE at receive of data from TA

0 No flow control

1 Software flow control

2 Hardware flow control

Specifies the method will be used by TA at receive of data from TE

0 No flow control

1 Software flow control

2 Hardware flow control

Example

AT+IFC? www.simcom.com 49 / 331

SIM7020 Series_AT Command Manual_V1.05

+ICF:0,0

AT+IFC=0,0

2.2.37 AT+IPR Set TE-TA Fixed Local Rate

AT+IPR Set TE-TA Fixed Local Rate

Test Command

AT+IPR=?

Read Command

AT+IPR?

Write Command

AT+IPR=<rate>

Parameter Saving Mode

Response

+IPR: (list of supported auto detectable <rate> s),(list of supported fixed-only <rate> s)

Response

+IPR: <rate>

Response

This parameter setting determines the data rate of the TA on the serial interface. The rate of Command takes effect following the issuance of any result code associated with the current Command line.

AUTO_SAVE

- Max Response Time

Reference

Defined Values

<rate> Baud rate per second

110

300

1200

2400

4800

9600

19200

38400

57600

115200 www.simcom.com 50 / 331

230400

460800

921600

3000000

Example

AT+IPR?

+IPR:0

AT+IPR=0

NOTE

 Factory setting is "AT+IPR=0"(auto-bauding).

SIM7020 Series_AT Command Manual_V1.05 www.simcom.com 51 / 331

SIM7020 Series_AT Command Manual_V1.05

3 AT Commands According to 3GPP

TS 27.007

3.1 Overview of AT Commands According to 3GPP TS 27.007

Command

AT+CEER

AT+CSCS

AT+CSQ

AT+CMUX

AT+CNUM

AT+CPOL

AT+CFUN

AT+CCLK

AT+CSIM

AT+CBC

AT+CTZR

AT+CTZU

AT+CPLS

AT+CPSMS

AT+CGMI

AT+CGMM

AT+CGMR

AT+CGOI

AT+CGSN

AT+CSCS

AT+CIMI

AT+CLCK

AT+CMEE

AT+COPS

AT+CPIN

AT+CPWD

AT+CR

AT+CREG

AT+CRSM

Description

Extended error report

Request manufacturer identification

Request model identification

Request TA revision identification of software release

Request global object identification

Request product serial number identification (identical with +GSN)

Select TE character set

Request international mobile subscriber identity

Facility lock

Report mobile equipment error

Operator selection

Enter PIN

Change password

Service reporting control

Network registration

Restricted SIM access

Select TE character set

Signal quality report

Multiplexer control

Subscriber number

Preferred operator list

Set phone functionality

Clock

Generic SIM access

Battery charge

Time zone reporting

Automatic time zone update

Selection of preferred PLMN list

Power saving mode selection www.simcom.com 52 / 331

AT+CIPCA

AT+CEDRXS

AT+CEDRXRDP

AT+CCHO

AT+CCHC

AT+CGLA

AT+CPINR

AT+CGATT

AT+CGDCONT

AT+CGACT

AT+CGPADDR

AT+IPCONFIG

AT+CGEREP

AT+CGREG

AT+CGCONTRDP

AT+CGPIAF

AT+CGDEL

AT+CGAUTH

AT*MCGDEFCONT

AT+CEREG

AT+CGDATA

AT*MGCOUNT

SIM7020 Series_AT Command Manual_V1.05

Enable/disable activation of PDN connection on attach. eDRX setting eDRX read dynamic parameters

Open UICC logical channel

Close UICC logical channel

Generic UICC logical channel access

Remaining PIN retries

GPRS/Packet Domain attach or detach

Define PDP context

PDP context activate or deactivate

Show PDP address

Show the Complete PDP Address

Packet Domain Event Reporting

Network registration status

PDP Context Read Dynamic Parameters

Printing IP Address Format

Delete Non-Active PDP Contexts

Define PDP Context Authentication Parameters

Set Default PSD Connection Settings

EPS Network Registration Status

Enter Data State

GPRS/Packet Domain Packet Counters

3.2 Detailed Description of AT Commands According to 3GPP TS

27.007

3.2.1 AT+CEER Extended Error Report

AT+CEER Extended Error Report

Test Command

AT+CEER=?

Read Command

AT+CEER?

Response

+CEER: (list of supported <n> s)

Parameters

See Write Command

Response

+CEER: <n> www.simcom.com 53 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CEER=<n>

Execution Command

AT+CEER

Parameters

See Write Command

Response

TA returns an extended report of the reason for the last call release.

+CEER: <report>

NO_SAVE

Note

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<n>

<report>

<c>(number) <s>(string)

0 The reason for last call release as text code

1 The reason for last call release as number code

If AT+CEER=0, return <s>

<s> a string that represents the Cause

If AT+CEER=1, return Cause: <c>

<c> number representing the Cause

0 (No cause)

1 (unassigned (unallocated) number)

3 (no route to destination)

6 (channel unacceptable)

8 (operator determined barring)

16 (normal call clearing)

17 (user busy)

18 (no user responding)

19 (user alerting, no answer)

21 (call rejected)

22 (number changed)

26 (non-selected user clearing)

27 (destination out of order)

28 (invalid number format (incomplete number))

29 (facility rejected)

30 (response to STATUS ENQUIRY)

31 (normal, unspecified)

34 (emergency call not possible)

38 (network out of order)

41 (temporary failure)

42 (switching equipment congestion) www.simcom.com 54 / 331

SIM7020 Series_AT Command Manual_V1.05

43 (access information discarded)

44 (requested circuit/channel not available)

47 (resource unavailable, unspecified)

49 (quality of service unavailable)

50 (Requested facility not subscribed)

55 (Incoming calls barred within the CUG)

57 (bearer capability not authorized)

58 (bearer capability not presently available)

63 (service or option not available, unspecified)

68 (ACM equal to or greater than ACMmax)

65 (bearer service not implemented)

69 (Requested facility not implemented)

70 (only restricted digital information bearer capability is available)

79 (service or option not implemented,unspecified)

81 (invalid transaction identifier value)

87 (user not member of CUG)

88 (incompatible destination)

91 (invalid transit network selection)

95 (semantically incorrect message)

96 (invalid mandatory information)

97 (message type non-existent or not implemented)

98 (message type not compatible with protocol state)

99 (information element non-existent or not implemented)

100 (conditional IE error)

101 (message not compatible with protocol state)

102 (recovery on timer expiry)

111 (protocol error, unspecified)

127 (interworking, unspecified)

Example

AT+CEER?

+CEER:0

AT+CEER=0

NOTE

 Only part of projects support this command, please refer to chapter 22 for details. www.simcom.com 55 / 331

SIM7020 Series_AT Command Manual_V1.05

3.2.2 AT+CGMI Request Manufacturer Identification

AT+CGMI Request Manufacturer Identification

Test Command

AT+CGMI=?

Execution Command

AT+CGMI

Parameter Saving Mode

Response

TA returns manufacturer identification text.

<manufacturer>

NO_SAVE

Note

Max Response Time

Reference

Defined Values

<manufacturer>

Example

AT+CGMI=?

AT+CGMI

SIMCOM_Ltd

The ID of manufacturer

3.2.3 AT+CGMM Request Model Identification

AT+CGMM Request Model Identification

Test Command

AT+CGMM=?

Execution Command

AT+CGMM

Response

TA returns manufacturer identification text.

<model>

OK www.simcom.com 56 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<model>

Example

AT+CGMM=?

AT+CGMI

SIM7020C

NO_SAVE

Product model identification text

3.2.4 AT+CGMR Request TA Revision Identification of Software Release

AT+CGMR Request TA Revision Identification of Software Release

Test Command

AT+CGMR=?

Execution Command

AT+CGMR

Parameter Saving Mode

Response

TA returns manufacturer identification text.

<revision>

NO_SAVE

- Max Response Time

Reference

Defined Values

<revision>

Example

AT+CGMR=?

Product software version identification text www.simcom.com 57 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CGMR

1752B01V01SIM7020C

3.2.5 AT+CGOI Request Global Object Identification

AT+CGOI Request Global Object Identification

Test Command

AT+CGOI=?

Execution Command

AT+CGOI

Parameter Saving Mode

Response

TA returns manufacturer identification text.

<Object Id>

NO_SAVE

Max Response Time

Reference

Defined Values

<Object Id>

Example

AT+CGOI=?

AT+CGOI

SIM7020C

Identifier of device type

3.2.6 AT+CGSN Request Product Serial Number Identification

AT+CGSN Request Product Serial Number Iden tification

Test Command

AT+CGSN=?

Response

OK www.simcom.com 58 / 331

SIM7020 Series_AT Command Manual_V1.05

Execution Command

AT+CGSN

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<sn>

Example

AT+CGSN

0000000000000000

Response see +GSN

<sn>

NO_SAVE

International mobile equipment identity (IMEI)

3.2.7 AT+CIMI Request International Mobile Subscriber Identity

AT+CIMI Request International Mobile Subscriber Identity

Test Command

AT+CIMI=?

Execution Command

AT+CIMI

Parameter Saving Mode

Response

TA returns <IMSI> for identifying the individual SIM which is attached to

ME.

<IMSI>

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

20s www.simcom.com 59 / 331

SIM7020 Series_AT Command Manual_V1.05

<MISI>

Example

AT+CIMI=?

AT+CIMI

460028216590952

International Mobile Subscriber Identity (string without double quotes)

3.2.8 AT+CLCK Facility Lock

AT+CLCK Facility Lock

Test Command

AT+CLCK=?

Write Command

AT+CLCK=<fac>,<mode>,[< password>[,<class>]]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

Response

+CLCK: (list of supported <fac> s)

Response

This Command is used to lock, unlock or interrogate a ME or a network facility <fac>.

Password is normally needed to do such actions. When querying the status of a network service ( <mode> =2) the response line for 'not active' case ( <status> =0) should be returned only if service is not active for any <class>.

If <mode>

≠2 and Command is successful

If <mode> =2 and Command is successful

+CLCK: <status>[,<class1>[<CR><LF>+CLCK:

<status>,<class2>[…]]

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

15s www.simcom.com 60 / 331

SIM7020 Series_AT Command Manual_V1.05

<fac>

<mode>

<passwd>

<class>

<status>

"SC" SIM (lock SIM/UICC card) (SIM/UICC asks password in MT power-up and when this lock command issued) Correspond to PIN1 code

0 unlock

1 lock

2 query status

String type (Shall be the same as password specified for the facility from the MT user interface or with command Change Password

Field not required for NB-IOT, so will be ignored

0 Not active

1 Active

Example

AT+CLCK=?

+CLCK: ("SC")

AT+CLCK=”SC”,2

+CLCK: 0

NOTE

 CME errors if SIM not inserted or PIN is not entered.

3.2.9 AT+CMEE Report Mobile Equipment Error

AT+CMEE Report Mobile Equipment Error

Test Command

AT+CMEE=?

Read Command

AT+CMEE?

Response

+CMEE: (list of supported <n> s)

Response

+CMEE: <n>

OK www.simcom.com 61 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CMEE=[<n>]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<n>

Response

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.

If error is related to ME functionality:

+CME ERROR: <err>

AT&W_SAVE

0 Disable +CME ERROR: <err> result code and use ERROR instead.

1 Enable +CME ERROR: <err> result code and use numeric

<err>

2 Enable +CME ERROR: <err> result code and use verbose <err> values

Example

AT+CMEE=?

+CMEE: (0-2)

AT+CMEE=0

3.2.10 AT+COPS Operator Selection

AT+COPS Operator Selection

Test Command

AT+COPS=?

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.

+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)] www.simcom.com 62 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+COPS?

Write Command

AT+COPS=<mode>[,<format

>[,<oper>]]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<stat>

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>]

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 further read commands (AT+COPS?).

If error is related to ME functionality:

+CME ERROR: <err>

AUTO_SAVE

<oper>

<mode>

<format>

<AcT>

0 Unknown

1 Operator available

2 Operator current

3 Operator forbidden

Refer to [27.007] operator in format as per <format>

0 Automatic mode; <oper> field is ignored

1 Manual ( <oper> field shall be present, and <AcT> optionally)

2 Manual deregister from network

3 Set only <format> (for read Command +COPS?) - not shown in

Read Command response

4 Manual/automatic ( <oper> field shall be present); if manual selection fails, automatic mode ( <mode> =0) is entered

0 Long format alphanumeric <oper>

1 Short format alphanumeric <oper>

2 Numeric <oper> ; GSM Location Area Identification number

9 NB-IoT www.simcom.com 63 / 331

SIM7020 Series_AT Command Manual_V1.05

Example

AT+COPS=?

+COPS: (2,"CHINA MOBILE","CMCC","46000",0),(1,"CHINA

MOBILE","CMCC","46000",9),(3,"CHN-UNICOM","UNICOM","46001",0),(1,"CHN-CT","CT","46011",

9),(3,"CHN-UNICOM","UNICOM","46001",9),,(0,1,2,3,4),(0,1,2)

AT+COPS?

+COPS: 0,0,"CHINA MOBILE CMCC",0

AT+COPS=0

3.2.11 AT+CPIN Enter PIN

AT+CPIN Enter PIN

Test Command

AT+CPIN=?

Read Command

AT+CPIN?

Write Command

AT+CPIN=<pin>[,<newpin>]

Parameter Saving Mode

Response

TA returns an alphanumeric string indicating whether some password is required or not.

+CPIN: <code>

Response

TA stores a required password (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 and an error message, +CME ERROR, is returned to TE.

If the PIN required is SIM PUK or SIM PUK2, the second pin is required. This second pin, <new pin> , is used to replace the old pin in the SIM.

When a new password is set, a third optional parameter may also be specified. This extra parameter is compared to the new password to check they are equivalent as an additional security feature.

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE www.simcom.com 64 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time

Reference

Defined Values

<code>

<pin>

<new pin>

Example

AT+CPIN=?

AT+CPIN?

+CPIN: READY

AT+CPIN=1234

3.2.12 AT+CPWD Change Password

AT+CPWD Change Password

Test Command Response

An alphanumeric string indicating whether some password is required or not

READY MT is not pending for any password

SIM PIN MT is waiting SIM PIN to be given

SIM PUK MT is waiting for SIM PUK to be given

PH_SIM PIN ME is waiting for phone to SIM card (antitheft)

PH_SIM PUK ME is waiting for SIM PUK (antitheft)

SIM PIN2 PIN2, e.g. for editing the FDN book possible only if preceding Command was acknowledged with +CME ERROR:17

SIM PUK2 Possible only if preceding Command was acknowledged with error +CME ERROR: 18.

PH-SIM PIN ME is waiting for phone to SIM card (antitheft)

PH-NET PIN Network personalization password is required.

PH-NETSUB PIN Network subset is required.

PH-SP PIN Service provider personalization password is required.

PH-CORP PIN Corporate personalization password is required.

String type; password

String type; If the PIN required is SIM PUK or SIMPUK2: new password www.simcom.com 65 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CPWD=?

Write Command

AT+CPWD=<fac>,<oldpwd>,

<newpwd>

Parameter Saving Mode

TA returns a list of pairs which present the available facilities and the maximum length of their password.

+CPWD: (list of supported <fac> s, list of supported <pwdlength> s)

Response

TA sets a new password for the facility lock function.

NO_SAVE

Max Response Time

Reference

Defined Values

<fac>

15s

<pwdlength>

"SC" SIM (lock SIM/UICC card) (SIM/UICC asks password in MT power-up and when this lock command issued) Correspond to PIN1 code.

Integer max. length of password

<oldpwd>

<newpwd>

Example

AT+CPWD=?

+CPWD: ("SC",8)

AT+CPWD ="SC","1234","4321"

String type (string should be included in quotation marks): password specified for the facility from the user interface or with command. If an old password has not yet been set, <oldpwd> is not to enter.

String type (string should be included in quotation marks): new password

3.2.13 AT+CREG Network Registration

AT+CREG Network Registration

Test Command

AT+CREG=?

Response

+CREG: (list of supported <n> s)

OK www.simcom.com 66 / 331

Read Command

AT+CREG?

Write Command

AT+CREG=<n>

SIM7020 Series_AT Command Manual_V1.05

Response

TA returns the status of result code presentation and an integer <stat> which shows whether the network has currently indicated the registration of the ME. Location information elements <lac> and <ci> are returned only when <n> =2 and ME is registered in the network.

+CREG: <n>,<stat>[,<lac>,<ci>[,<AcT>]]

If error is related to ME functionality:

+CME ERROR: <err>

Response

TA controls the presentation of an unsolicited result code +CREG:

<stat> when <n> =1 and there is a change in the ME network registration status.

If error is related to ME functionality:

+CME ERROR: <err>

Unsolicited Result Code

If <n> =1 and there is a change in the MT network registration status

+CREG: <stat>

If <n> =2 and there is a change in the MT network registration status or a change of the network cell:

+CREG: <stat>[,<lac>,<ci>[,<AcT>]]

- Parameter Saving Mode

Max Response Time

Reference

Defined Values

<n>

<stat>

0 Disable network registration unsolicited result code

1 Enable network registration unsolicited result code

+CREG: <stat>

2 Enable network registration unsolicited result code with location information +CREG: <stat>[,<lac>,<ci>[,<AcT>]]

0 Not registered, MT is not currently searching a new operator to register to

1 Registered, home network

2 Not registered, but MT is currently searching a new operator to register to

3 Registration denied

4 Unknown

5 Registered, roaming

6 Registered for "SMS only", home network (applicable only when

<Act> indicates NB-IOT www.simcom.com 67 / 331

SIM7020 Series_AT Command Manual_V1.05

<lac>

<ci>

7 Registered for "SMS only", roaming (applicable only when <Act> indicates NB-IOT

String type (string should be included in quotation marks); two byte location area code in hexadecimal format

String type (string should be included in quotation marks); four byte cell ID in hexadecimal format

Access technology of the registered network 9 NB-IoT <AcT>

Example

AT+CREG=?

+CREG: (0-2)

AT+CREG?

+CREG: 0,2

AT+CREG=2

3.2.14 AT+CRSM Restricted SIM Access

AT+CRSM Restricted SIM Access

Test Command

AT+CRSM=?

Write Command

AT+CRSM=<Command>[,<fi leId>[,<P1>,<P2>,<P3>[,<dat a>[,<pathid>]]]]

Parameter Saving Mode

Response

+CRSM: <sw1>,<sw2>[,<response>]

ERROR

If error is related to ME functionality:

+CME ERROR: <err>

NO_SVAE

Max Response Time

Reference

Defined Values

<Command>

176 READ BINARY www.simcom.com 68 / 331

SIM7020 Series_AT Command Manual_V1.05

<fileId>

<data>

<sw1>,<sw2>

<response>

<pathid>

178 READ RECORD

192 GET RESPONSE

214 UPDATE BINARY

220 UPDATE RECORD

242 STATUS

All other values are reserved; refer GSM 11.11.

Integer type; this is the identifier for an elementary data file on SIM.

Mandatory for every command except STATUS

<P1>,<P2>,<P3> 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)

String type; contains the path of an elementary file on the SIM/UICC in hexadecimal format as defined in ETSI TS 102.211 (e.g. "7F205F70" in SIM and UICC case). The <pathid> only used in the mode "select path from MF" as defined in ETSI TS 102.211.

Example

AT+CRSM=?

AT+CRSM=242

+CRSM:

144,0,"62358202782183023F00A509800171830400080F608A01058B032F0611C6189001BC9501008

3011183010183010A83010B83010C83010D"

3.2.15 AT+CSCS Select TE Character Set

AT+CSCS Select Character Set

Test Command

AT+CSCS=?

Response

+CSCS: (list of supported <chset> s)

OK www.simcom.com 69 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CSCS?

Write Command

AT+CSCS=<chset>

Response

+CSCS: <chset>

Response

Sets which character set <chset> are used by the TE. The TA can then convert character strings correctly between the TE and ME character sets.

If error is related to ME functionality:

+CME ERROR: <err>

AT&W_SVAE Parameter Saving Mode

Max Response Time

Reference

Defined Values

<chset> Character type

"GSM" GSM 7 bit default alphabet (3GPP TS 23.038);

"UCS2" 16-bit universal multiple-octet coded character set

(ISO/IEC10646); UCS2 character strings are converted to hexadecimal numbers from 0000 to FFFF; e.g. "004100620063" equals three 16-bit characters with decimal values 65, 98 and 99

"IRA" International reference alphabet (ITU-T T.50)

"HEX" Character strings consist only of hexadecimal numbers from 00 to FF;

"PCCP" PC character set Code

"PCDN" PC Danish/Norwegian character set

"8859-1" ISO 8859 Latin 1 character set

Example

AT+CSCS=?

+CSCS:

("GSM","HEX","IRA","PCCP","PCDN","UCS2","8859-1")

AT+CSCS?

+CSCS: “IRA”

AT+CSCS=”IRA”

OK www.simcom.com 70 / 331

SIM7020 Series_AT Command Manual_V1.05

3.2.16 AT+CSQ Signal Quality Report

AT+CSQ Signal Quality Report

Test Command

AT+CSQ=?

Execution Command

AT+CSQ

Parameter Saving Mode

Response

+CSQ: (list of supported <rssi> s),(list of supported <ber> s)

Response

+CSQ: <rssi>,<ber>

If error is related to ME functionality:

+CME ERROR: <err>

Execution Command returns received signal strength indication

<rssi> and channel bit error rate <ber> from the ME. Test Command returns values supported by the TA.

NO_SVAE

Max Response Time

Reference

Defined Values

<rssi>

<ber>

Integer type. Rx signal strength level

0 -110 dBm or less

1 -109 dBm <=rssi<-107 dBm

2 -107 dBm <=rssi<-105 dBm

3…30 -105dBm <=rssi<-48 dBm

31 -48dBm <=rssi

99 Not known or not detectable

(in percent):

0...7 As RXQUAL values in the table in GSM 05.08 [20] subclause

7.2.4

99 Not known or not detectable

Example

AT+CSQ=?

+CSQ: (0-31,99),(0-7,99) www.simcom.com 71 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CSQ

+CSQ: 0,0

3.2.17 AT+CMUX Multiplexer Control

AT+CMUX Multiplexer Control

Test Command

AT+CMUX=?

Read Command

AT+CMUX?

Write Command

AT+CMUX=<mode>[,<subse t>[,<port_speed>[,<N1>[,<T

1>[,<N2>[,<T2>[,<T3>[,<k>]]

]]]]]]]

Parameter Saving Mode

Response

+CMUX: (list of supported <mode> s),(list of supported

<subset> s),(list of supported <port_speed> s),(list of supported <N1> s),(list of supported <T1> s),(list of supported <N2> s),(list if supported <T2> s),(list of supported

<T3> s),<list of supported <k> s)

Response

+CMUX:

[<mode>[,<subset>[,<port_speed>[,<N1>[,<T1>[,<N2>[,<T2>[,<T3

>[,<k>]]]]]]]]]

OK or

ERROR

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SVAE

Max Response Time

Reference

Defined Values

<mode>

<subset>

<port_speed>

0 27.010 multiplexer

The way in which the multiplexer control channel is set up

0 UIH frames used only

Transmission rate

0 autobaud www.simcom.com 72 / 331

SIM7020 Series_AT Command Manual_V1.05

<N1>

<T1>

<N2>

<T2>

<T3>

<k>

1 110

2 300

3 1200

4 2400

5 4800

6 9600

7 19200

8 38400

9 57600

10 115200

11 230400

12 460800

Proprietary values, available if MUX NEW PORT SPEED FTR is activated

Max frame size

31-4096 (default value 31 for basic option)

Acknowledgement timer in units of ten milliseconds

1-254 Default:10 (100 ms)

Max number of re-transmissions

0-100 Default:3

Max Response Timer for the multiplexer control channel in units of ten milliseconds

Wake up Max Response Timers in seconds

1-255 Default:10

Window size, for Advanced operation with Error Recovery options

1-7 Default:2

Example

AT+CMUX=?

+CMUX: (0),(0),(0-12),(31-4096),(1-254),(0-100),(2-255),(1-255),(1-7)

AT+CMUX?

+CMUX: 0,0,0,31,10,3,30,10,2

NOTE

 The values of <subset>,<port_speed>,<N1>,<T>,<N2>,<T2>,<T3>,<k> are only relevent to the

27.010 MUX control channel.

 <port_speed> set to 0 will set the MUX port rate at whatever the AT+IPR setting is for the channel. www.simcom.com 73 / 331

SIM7020 Series_AT Command Manual_V1.05

3.2.18 AT+CNUM Subscriber Number

AT+CNUM Subscriber Number

Test Command

AT+CNUM=?

Execution Command

AT+CNUM

Parameter Saving Mode

Response

+CNUM:

[<alpha1>],<number1>,<type1>[<CR><LF>+CNUM:[<alpha2>],<n umber2>,<type2>

[...]]

If error is related to ME functionality:

+CME ERROR: <err>

NO_SVAE

Max Response Time

Reference

Defined Values

<alphax>

<numberx>

<typex>

Example

AT+CNUM=?

AT+CNUM

+CNUM: "","13817825065",129

Optional alphanumeric string associated with <numberx> ; used character set should be the one selected with Command Select TE

Character Set +CSCS

String type (string should be included in quotation marks) phone number of format specified by <typex>.

Type of address octet in integer format (refer GSM04.08[8] subclause

10.5.4.7) www.simcom.com 74 / 331

SIM7020 Series_AT Command Manual_V1.05

3.2.19 AT+CPOL Preferred Operator List

AT+CPOL Preferred Operator List

Test Command

AT+CPOL=?

Read Command

AT+CPOL?

Write Command

AT+CPOL=<inder>[,<format

>,<oper>]

Parameter Saving Mode

Response

+CPOL: (list of supported <index> s),(list of supported <format> s)

Response

+CPOL:

<index1>,<format>,<oper1>[,<GSM_AcT1>,<GSMcomp_AcT1>,<

UTRAN_AcT1>,<E-UTRAN_Act1][<CR><LF>+CPOL:

<index2>,<format>,<oper2>[,<GSM_AcT2>,<GSMcomp_AcT2>,<

UTRAN_AcT2,<E-UTRAN_AcT2>]

If error is related to ME functionality:

+CME ERROR: <err>

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SVAE

Max Response Time

Reference

Defined Values

<index>

<format>

<oper>

<GSM_AcTn>

<GSM_Comp_AcTn>

<UTRAN_AcTn>

Integer type: order number of operator in SIM preferred operator list

Indicates whether alphanumeric or numeric format used (see +COPS

Command)

0 Long format alphanumeric <oper>

1 Short format alphanumeric <oper>

2 Numeric <oper>

String type(string should be included in quotation marks)

GSM Access technology

0 Access technology not selected

1 Access technology selected

GSM compact Access technology

0 Access technology not selected

1 Access technology selected

UTRA Access technology

0 Access technology not selected

1 Access technology selected www.simcom.com 75 / 331

SIM7020 Series_AT Command Manual_V1.05

<E-UTRAN_AcTn> E-UTRAN Access technology

0 Access technology not selected

1 Access technology selected

Example

AT+CPOL=?

+CPOL: (1-80),(0-2)

AT+CPOL?

+CPOL: 1,2,"46000",1,0,1,0

NOTE

 Not all USIMs support the preferred operator list.

3.2.20 AT+CFUN Set Phone Functionality

AT+CFUN Set Phone Functionality

Test Command

AT+CFUN=?

Read Command

AT+CFUN?

Write Command

AT+CFUN=<fun>[,<rst>]

Parameter Saving Mode

Response

+CFUN: (list of supported <fun> s),(list of supported <rst> s)

Response

+CFUN: <fun>

If error is related to ME functionality:

+CME ERROR: <err>

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SVAE

Max Response Time

Reference

- www.simcom.com 76 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<fun>

<rst>

0 Minimum functionality

1 Full functionality (Default)

4 Disable phone both transmit and receive RF circuits.

7 Disable phone SIM only. Transmit and receive circuits still active

0 Set it to <fun> power level now, but do not reset the MT

1 Do not set it to <fun> power level, either do not reset the MT before rebooting

2 Set it to <fun> power level now, and reset the MT after rebooting

Example

AT+CFUN=?

+CFUN: (0,1,4,7),(0-2)

AT+CFUN?

+CFUN: 1

AT+CFUN=1,1

RDY

+CFUN: 1

+CPIN: READY

SMS Ready

3.2.21 AT+CLCK Clock

AT+CLCK Clock

Test Command

AT+CLCK=?

Read Command

AT+CLCK?

Response

+CCLK: <time>

OK www.simcom.com 77 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CLCK=<time>

Parameter Saving Mode

If error is related to ME functionality:

+CME ERROR: <err>

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SVAE

Max Response Time

Reference

Defined Values

<time>

String type, format is: yy/MM/dd,hh:mm:ss±zz, where characters indicate year (two last digits),month, day, hour, minutes, seconds and time zone. E.g. 10/05/06,00:01:52+08.

Example

AT+CCLK=?

AT+CCLK?

+CCLK: 00/01/01,00:18:15+32

AT+CCLK="20/03/20,15:34:15+32"

AT+CCLK?

+CCLK: 20/03/20,15:34:33+32

NOTE

 If MT does not support time zone information then the three last characters of <time> are not returned by +CCLK?. www.simcom.com 78 / 331

SIM7020 Series_AT Command Manual_V1.05

3.2.22 AT+CSIM Generic SIM Access

AT+CSIM Generic SIM Access

Test Command

AT+CSIM=?

Write Command

AT+CSIM=<length>,<Comm and>

Parameter Saving Mode

Response

+CSIM: <length>,<response>

If error is related to ME functionality:

+CME ERROR: <err>

NO_SVAE

Max Response Time

Reference

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>.

Example

AT+CSIM=?

3.2.23 AT+CBC Battery Charge

AT+CBC Battery Charge

Test Command

AT+CBC=?

Execution Command

AT+CBC

Response

+CBC: (list of supported <bcl> ),( <voltage> )

Response

+CBC: <bcl>,<voltage> www.simcom.com 79 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<bcl>

If error is related to ME functionality:

+CME ERROR: <err>

NO_SVAE

Battery connection level

0...100 battery has 1-100 percent of capacity remaining vent

Battery voltage(mV) <voltage>

Example

AT+CBC=?

+CBC: (0-100),(voltage)

AT+CBC

+CBC: 88,3418

3.2.24 AT+CTZR Time Zone Reporting

AT+CTZR Time Zone Reporting

Test Command

AT+CTZR=?

Read Command

AT+CTZR?

Response

+CTZR: (list of supported <onoff> s)

Response

+CTZR: <onoff>

If error is related to ME functionality:

+CME ERROR: <err>

Write Command

AT+CTZR=<onoff>

Response

If error is related to ME functionality:

+CME ERROR: <err> www.simcom.com 80 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<onoff>

<zone>

Unsolicited result code:

+CTZV: <zone>

AUTO_SAVE_REBOOT

0 Disable time zone event reporting

1 Enable time zone event reporting

String type value; On behalf of the time zone, range -47...+48.The eastern region is denoted as "+32".

Example

AT+CTZR=?

+CTZR: (0-1)

AT+CTZR?

+CTZR: 0

AT+CTZR=1

3.2.25 AT+CTZU Automatic Time Update

AT+CTZU Automatic Time Update

Test Command

AT+CTZU=?

Read Command

AT+CTZU?

Write Command

Response

+CTZU: (list of supported <onoff> s)

Response

+CTZU: <onoff>

If error is related to ME functionality:

+CME ERROR: <err>

Response www.simcom.com 81 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CTZU=<onoff>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<onoff>

Example

AT+CTZU=?

+CTZU: (0-1)

AT+CTZU?

+CTZU: 0

AT+CTZU=1

If error is related to ME functionality:

+CME ERROR: <err>

AUTO_SAVE_REBOOT

0 Disable automatic time update via NITZ

1 Automatic time update via NITZ

3.2.26 AT+CPLS Selection of preferred PLMN List

AT+CPLS Selection of preferred PLMN List

Test Command

AT+CPLS=?

Read Command

AT+CPLS?

Write Command

AT+CPLS=<list>

Response

+CPLS: (list of supported <list> s)

Response

+CPLS: <list>

If error is related to ME functionality:

+CME ERROR: <err>

Response

OK www.simcom.com 82 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<list>

0 User controlled PLMN selector with Access Technology

EFPLMNwAcT, if not found in the SIM/UICC then PLMN preferred list

EFPLMNSel (this file is only on SIM card or GSM application in UICC.

1 Operator controlled PLMN selector with Access Technology

EFOPLMNwAcT

2 HPLMN selector with Access Technology EFHPLMNwACT

Example

AT+CPLS=?

+CPLS: (0,1,2)

AT+CPLS?

+CPLS: 0

AT+CPLS=0

NOTE

 Only part of projects support this command, please refer to chapter 22 for details.

3.2.27 AT+CPSMS Power Saving Mode Setting

AT+CPSMS Power Saving Mode Setting

Test Command Response www.simcom.com 83 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CPSMS=?

Read Command

AT+CPSMS?

+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)

Response

+CPSMS:

<mode>[,<Requested_Periodic-RAU>][,<Requested_GPRS-READ

Y-timer>][,<Requested_Periodic-TAU>][,<Requested_Active-Time

If error is related to ME functionality:

+CME ERROR: <err>

Response

If error is related to ME functionality:

+CME ERROR: <err>

Write Command

AT+CPSMS=[<mode>[,<Req uested_Periodic-RAU>[,<Re quested_GPRS-READY-time r>[,<Requested_Periodic-TA

U>[,<Requested_Active-Tim e>]]]]

Parameter Saving Mode AUTO_SAVE

Max Response Time -

Reference

Defined Values

<mode> 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.

<Requested_Periodic-RAU> N/A for NB-IoT

<Requested_GPRS-READYtimer>

N/A for NB-IoT

<Requested_Periodic-TAU> 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 Table 10.5.163a/3GPP TS

24.008. See also 3GPP TS 23.682 and 3GPP TS 23.401. The default www.simcom.com 84 / 331

SIM7020 Series_AT Command Manual_V1.05 value, if available, is manufacturer specific.

<Requested_Active-Time> 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 Table 10.5.163/3GPP TS 24.008. See also 3GPP TS 23.682,

3GPP TS 23.060 and 3GPP TS 23.401. The default value, if available, is manufacturer specific.

Example

AT+CPSMS=?

+CPSMS: (0-2),,,("00000000"-"11011111"),("00000000"-"11111111")

AT+CPSMS?

+CPSMS: 0

AT+CPSMS=1

3.2.28 AT+CCIOTOPT CIoT optimization configuration

AT+CPSMS Power Saving Mode Setting

Test Command

AT+CCIOTOPT=?

Read Command

AT+CCIOTOPT?

Write Command

AT+CCIOTOPT=[<n>[,<supp orted

UE_opt>[,<preferred_UE_op

Response

+CCIOTOPT: (list of supported <n> s),(list of supported

<supported_UE_opt> s),(list of supported <preferred_UE_opt> s)

Response

+CCIOTOPT: <n>,<supported_UE_opt>,<preferred_UE_opt>

If error is related to ME functionality:

+CME ERROR: <err>

Response

If error is related to ME functionality:

+CME ERROR: <err> www.simcom.com 85 / 331

SIM7020 Series_AT Command Manual_V1.05 t>]]]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<n>

NO_SAVE

<supported_UE_opt>

<preferred_UE_opt>

Example

AT+CCIOTOPT=?

+CCIOTOPT: (0-2),(1,3),(0-2)

AT+CCIOTOPT?

+CCIOTOPT: 1,1,1

AT+CCIOTOPT=1,1,1

3.2.29 AT+CEDRXS eDRX Setting

AT+CEDRXS eDRX Setting

Test Command Response

Integer type, enables or disables reporting of unsolicited result code

+CCIOTOPTI.

0 Disable reporting.

1 Enable reporting.

2 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.

1 Support for control plane CIoT EPS optimization.

3 Support for both control plane CIoT EPS optimization and user plane CIoT EPS optimization.

Integer type; indicates the UE's preference for CIoT EPS optimizations.

0 No preference

1 Preference for control plane CIoT EPS optimization

2 Preference for user plane CIoT EPS optimization www.simcom.com 86 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CEDRXS=?

Read Command

AT+CEDRXS?

Write Command

AT+CEDRXS=<mode>[,<Ac

T-type>[,<Requested_eDRX

_value>]]

Parameter Saving Mode

+CEDRXS: (list of supported <mode> s),(list of supported

<AcT-type> s),(list of supported <Requested_eDRX_value> s)

Response

[+CEDRXS:

<AcT-type>,<Requested_eDRX_value>[<CR><LF>+CEDRXS:

<AcT-type>,<Requested_eDRX_value>

[...]]]

If error is related to ME functionality:

+CME ERROR: <err>

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time -

Reference

Defined Values

<mode> Integer type, indicates to disable or enable the use of eDRX in the UE.

This parameter is applicable to all specified types of access technology, i.e. the most recent setting of <mode> will take effect for all specified values of <AcT>.

0 Disable the use of eDRX

1 Enable the use of eDRX

2 Enable the use of eDRX and enable the unsolicited result code

+CEDRXP:

<AcT-type>

<AcT-type>[,<Requested_eDRX_value>[,<NW-provided_eDRX_va lue>[,<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)

<Requested_eDRX_value> String type; half a byte in a 4-bit format. The eDRX value refers to bit 4 to 1 of octet 3 of the Extended DRX parameters information element

(see 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. The default www.simcom.com 87 / 331

SIM7020 Series_AT Command Manual_V1.05 value, if available, is manufacturer specific.

<NW-provided_eDRX_value

<Paging_time_window>

Example

AT+CEDRXS=?

+CEDRXS: (0-3),(5),("0000"-"1111")

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 paging time window refers to bit 8 to 5 of octet 3 of the Extended DRX parameters information element (see sub-clause 10.5.5.32 of 3GPP TS 24.008).

For the coding and the value range, see the Extended DRX parameters information element in 3GPP TS 24.008 Table

10.5.5.32/3GPP TS 24.008.

AT+CEDRXS?

+CEDRXS: 5,"0000"

AT+CEDRXS=1

3.2.30 AT+CEDRXRDP eDRX Read Dynamic Parameters

AT+CEDRXRDP eDRX Read Dynamic Parameters

Test Command

AT+CEDRXRDP=?

Execution Command

AT+CEDRXRDP

Parameter Saving Mode

Response

+CEDRXRDP:

<AcT-type>[,<Requested_eDRX_value>[,<NW-provided_eDRX_va lue>[,<Paging_time_window>]]]

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time - www.simcom.com 88 / 331

SIM7020 Series_AT Command Manual_V1.05

Reference

Defined Values

<AcT-type> Integer type, indicates the type of access technology. This

AT-command is used to specify the relationship between the type of access technology and the requested eDRX value.

0 Access technology is not using eDRX

5 E-UTRAN (NB-S1 mode)

<Requested_eDRX_value> String type; half a byte in a 4-bit format. The eDRX value refers to bit 4 to 1 of octet 3 of the Extended DRX parameters information element

<NW-provided_eDRX_value

<Paging_time_window>

(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 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 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.

Example

AT+CEDRXRDP=?

AT+CEDRXRDP

+CEDRXRDP: 0

3.2.31 AT+CCHO Open UICC Logical Channel

AT+CCHO Open UICC Logical Channel

Write Command

AT+CCHO=<dfname>

Response

+CCHO: <sessionid> www.simcom.com 89 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<dfname>

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

<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

Example

AT+CCHO=

3.2.32 AT+CCHC Close UICC Logical Channel

AT+CCHC Close UICC Logical Channel

Write Command

AT+CCHC=<sessionid>

Parameter Saving Mode

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<sessionid>

Integer type; a session Id to be used to target a specific application on the smart card (e.g. (U)SIM, WIM, ISIM) using logical channels mechanism www.simcom.com 90 / 331

SIM7020 Series_AT Command Manual_V1.05

Example

AT+CCHO=

3.2.33 AT+CGLA Generic UICC Logical Channel Access

AT+CGLA Generic UICC Logical Channel Access

Write Command

AT+CGLA=<sessionid>,<len gth>,<command>

Parameter Saving Mode

Response

+CGLA: <length>,<response>

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<sessionid>

<length>

<command>

<response>

Integer type; this is the identifier of the session used to send the APDU commands to the UICC. It is mandatory to send commands to the

UICC when targeting applications on the smart card using a logical channel other than the default channel (channel "0").

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 (hexadecimal character format)

Response to the command passed on by the UICC to the MT in the format as described in 3GPP TS 31.101 (hexadecimal character format)

Example

AT+CCHO=

OK www.simcom.com 91 / 331

SIM7020 Series_AT Command Manual_V1.05

3.2.34 AT+CPINR Remaining PIN Retries

AT+CPINR Remaining PIN Retries

Test Command

AT+CPINR=?

Write Command

AT+CPINR[=<sel_code>]

Parameter Saving Mode

Response

[+CPINR:

<code>,<retries>[,<default_retries>][<CR>,<LF>+CPINR:

<code>,<retries>[,<default_retries>]

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<sel_code>

<retries>

<default_retries>

<code>

String type. Same values as for the <code> parameter. These values are strings and shall be indicated within double quotes.

Wildcard match by '*', meaning match any (sub-)string, or '?' meaning an character can be used.

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".

Example

AT+CPINR=?

AT+CPINR

+CPINR: "SIM PIN",3,3

+CPINR: "SIM PUK",10,10

+CPINR: "SIM PIN2",3,3

+CPINR: "SIM PUK2",10,10

OK www.simcom.com 92 / 331

SIM7020 Series_AT Command Manual_V1.05

3.2.35 AT+CGATT GPRS/Packet Domain Attach or Detach

Example

AT+CGATT=?

+CGATT: (0-1)

AT+CGATT?

+CGATT: 0

AT+CGATT=1

AT+CGATT GPRS/Packet Domain Attach or Detach

Test Command

AT+CGATT=?

Read Command

AT+CGATT?

Write Command

AT+CGATT=<state>

Parameter Saving Mode

Response

+CGATT: (list of supported <state> s)

Response

+CGATT: <state>

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<state>

Indicates the state of GPRS/Packet Domain attachment

0 Detached

1 Attached

Other values are reserved and will result in an ERROR response to the Write Command. www.simcom.com 93 / 331

SIM7020 Series_AT Command Manual_V1.05

3.2.36 AT+CGDCONT Define PDP Context

AT+CGDCONT Define PDP Context

Test Command

AT+CGDCONT=?

Read Command

AT+CGDCONT?

Write Command

AT+CGDCONT=<cid>[,<PDP

_type>[,APN>[,<PDP_addr>[

,<d_comp>[,<h_comp>]]]]]

Parameter Saving Mode

Response

+CGDCONT: (range of supported <cid> s), <PDP_type> ,,,(list of supported <d_comp> s),(list of supported <h_comp> s),(list of supported <IPv4AddrAlloc> s),(list of supported

<request_type> s),(list of supported <P-CSCF_discovery> s),(list of supported <IM_CN_Signalling_Flag_Ind> s),(list of supported

<NSLPI> s),(list of supported <securePCO> s),(list of supported

<IPv4_MTU_discovery> s),(list of supported

<Local_Addr_Ind> s),(list of supported <Non-IPMTUdiscovery> s)

[<CR><LF>+CGDCONT: (range of supported

<cid> s), <PDP_type> ,,,(list of supported <d_comp> s),(list of supported <h_comp> s),(list of supported <IPv4AddrAlloc> s),(list of supported <request_type> s),(list of supported

<P-CSCF_discovery> s),(list of supported

<IM_CN_Signalling_Flag_Ind> s),(list of supported <NSLPI> s),(list of supported <securePCO> s),(list of supported

<IPv4_MTU_discovery> s),(list of supported

<Local_Addr_Ind> s),,(list of supported

<Non-IP_MTU_discovery> s) [...]]

Response

+CGDCONT:

<cid>,<PDP_type>,<APN>,<PDP_addr>,<d_comp>,<h_comp>[,<I

Pv4AddrAlloc>[,<request_type>[,<P-CSCF_discovery>[,<IM_CN_

Signalling_Flag_Ind>[,<NSLPI>[,<securePCO>[,<IPv4_MTU_disc overy>[,<Local_Addr_Ind>[,<Non-IP_MTU_discovery>]]]]]]]]]]

[<CR><LF>

+CGDCONT:

<cid>,<PDP_type>,<APN>,<PDP_addr>,<d_comp>,<h_comp>[,<I

Pv4AddrAlloc>[,<request_type>[,<P-CSCF_discovery>[,<IM_CN_

Signalling_Flag_Ind>[,<NSLPI>[,<securePCO>[,<IPv4_MTU_disc overy>[,<Local_Addr_Ind>[,<Non-IP_MTU_discovery>]]]]]]]]]

Response

OK or

ERROR

NO_SAVE

Max Response Time - www.simcom.com 94 / 331

SIM7020 Series_AT Command Manual_V1.05

Reference

Defined Values

<cid>

<PDP_type>

<APN>

<PDP_addr>

<d_comp>

<h_comp>

(PDP Context Identifier) a numeric parameter that specifies a particular PDP context definition.

The parameter is local to the UE-TE interface and is used in other

PDP context-related commands.

The range of permitted values (minimum value=1 or if the initial PDP context is supported minimum value=0) is returned by the test form of the command.

(Packet Data Protocol type) a string parameter which specifies the type of packet data protocol:

IP Internet Protocol (IETF STD 5)

IPV6 Internet Protocol, version 6 (IETF RFC 2460)

IPV4V6 Virtual <PDP_type>) introduced to handle dual IP stack UE capability (see 3GPP Technical Specifications 24.301).

Non-IP Transfer of Non-IP data to external packet data Network

(see 3GPP Technical Specifications 24.301).

(Access Point Name) a string parameter, a logical name to select the GGSN or the external packet data network. If the value is null or omitted, then the subscription value will be requested.

A string parameter that identifies the UE in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a dynamic address will be requested. The read form of the command will continue to return the null string even if an address has been allocated during the PDP startup procedure. The allocated address may be read using the +CGPADDR command.

NOTE: For EPS, this field is omitted.

A numeric parameter that controls PDP data compression (applicable for SNDCP only) (refer 3GPP TS 04.65)

0 off (default if value is omitted)

1 on (manufacturer preferred compression)

2 V.42bis

Other values are reserved.

A numeric parameter that controls PDP header compression (refer

3GPP TS 04.65)

0 off (default if value is omitted)

1 on (manufacturer preferred compression)

2 RFC1144 (applicable for SNDCP only)

3 RFC 2507

4 RFC 3095 (ROHC) (applicable for PDCP only)

Other values are reserved. www.simcom.com 95 / 331

SIM7020 Series_AT Command Manual_V1.05

<IPv4_MTU_discovery> Integer type; influences how the MT/TA requests to get the IPv4 MTU size, see 3GPP TS 24.008 sub-clause 10.5.6.3.

0 Preference of IPv4 MTU size discovery not influenced by

+CGDCONT

1 Preference of IPv4 MTU size discovery through NAS signaling

<Non-IP_MTU_discovery> Integer type; influences how the MT/TA requests to get the Non-IP

MTU size, see 3GPP TS 24.008 sub-clause 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 signaling

Example

AT+CGDCONT=?

+CGDCONT: (1-15),"IP",,,(0-2),(0-4),(0),,,,(0-1),,(0-1),,(0-1)

+CGDCONT: (1-15),"IPV6",,,(0-2),(0-4),(0),,,,(0-1),,(0-1),,(0-1)

+CGDCONT: (1-15),"IPV4V6",,,(0-2),(0-4),(0),,,,(0-1),,(0-1),,(0-1)

+CGDCONT: (1-15),"Non-IP",,,(0-2),(0-4),(0),,,,(0-1),,(0-1),,(0-1)

AT+CGDCONT?

AT+CGDCONT=1

3.2.37 AT+CGACT PDP Context Active or Deactive

AT+CGACT PDP Context Active or Deactive

Test Command

AT+CGACT=?

Read Command

AT+CGACT?

Write Command

AT+CGACT=<state>[,<cid>]

Response

+CGACT: (list of supported <state> s)

Response

+CGACT: <cid>,<state>[<CR><LF>+CGACT: <cid>,<state>…]

Response

If error is related to ME functionality:

+CME ERROR: <err> www.simcom.com 96 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode NO_SAVE

Max Response Time 150 Seconds

Reference

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 to the 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.

Example

AT+CGACT=?

+CGACT: (0-1)

AT+CGACT?

+CGACT: 0

AT+CGACT=1

NOTE

 If context is deactivated successfully, NO CARRIER is returned

 If <cid> =0 for PDN activated during attach is enabled, then AT+CGACT=<0> or <1> , 0 will cause

ERROR response.

3.2.38 AT+CGPADDR Show PDP Address

AT+CGPADDR Show PDP Address

Test Command

AT+CGPADDR=?

Response

+CGPADDR: (list of defined <cid> s) www.simcom.com 97 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CGPADDR=[<cid>[,<cid

>[,…]]]

Parameter Saving Mode

OK or

Response

+CGPADDR: <cid>[,<PDP_addr>][<CR><LF>+CGPADDR:

<cid>[,<PDP_addr>][…]]

OK or

ERROR

NO_SAVE

Max Response Time

Reference

Defined Values

<cid>

<PDP_addr>

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>. is omitted if none is available. <PDP_address>

Example

NOTE

 Write command returns address provided by the network if a connection has been established.

3.2.39 AT+IPCONFIG Show the Complete PDP Address www.simcom.com 98 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+IPCONFIG Show the Complete PDP Address

Execution Command

AT+IPCONFIG

Parameter Saving Mode

Response

[+IPCONFIG: <PDP_addr>]

NO_SAVE

Max Response Time

Reference

Defined Values

<PDP_addr>

A string that identifies the MT in the address space applicable to the

PDP. The address may be static or dynamic. For a static address, it will be the one set by the +CGDCONT command when the context was defined.

Example

NOTE



Write command returns address provided by the network if a connection has been established.

3.2.40 AT+CGEREP Packet Domain Event Reporting

AT+CGEREP Packet Domain Event Reporting

Test Command

AT+CGEREP=?

Read Command

AT+CGEREP?

Write Command

AT+CGEREP=<mode>

Response

+CGEREP: ( list of supported <mode> s ),( list of supported <bfr> s )

Response

+CGEREP: <mode>,<bfr>

Response

OK www.simcom.com 99 / 331

SIM7020 Series_AT Command Manual_V1.05 or

ERROR

Unsolicited Result Codes supported:

For network attachment, the following unsolicited result codes and the corresponding events are defined:

+CGEV: NW DETACH

The network has forced a PS detach. This implies that all active contexts have been deactivated. These are not reported separately.

+CGEV: ME DETACH

The mobile termination has forced a PS detach. This implies that all active contexts have been deactivated. These are not reported separately.

For PDP context activation, the following unsolicited result codes and the corresponding events are defined:

+CGEV: NW PDN ACT <cid>

The network has activated a context. The context represents a

Primary PDP context in GSM/UMTS. The <cid> for this context is provided to the TE. The format of the parameter <cid> is found in command +CGDCONT.

NOTE 1: This event is not applicable for EPS.

+CGEV: ME PDN ACT <cid>[,<reason>[,<cid_other>]]

The mobile termination has activated a context. The context represents a PDN connection in NB-IOT. The <cid> for this context is provided to the TE. This event is sent either in result of explicit context activation request (+CGACT), or in result of implicit context activation request associated to attach request (+CGATT=1). The format of the parameter <cid> and <cid other> are found in command +CGDCONT.

For PDP context deactivation, the following unsolicited result codes and the corresponding events are defined:

+CGEV: NW PDN DEACT <cid>

The network has deactivated a context. The context represents a PDN connection in NB-IOT. The associated <cid> for this context is provided to the TE. The format of the parameter <cid> is found in command +CGDCONT.

NOTE 2: Occurrence of this event replaces usage of the event

+CGEV: NW DEACT <PDP_type>,<PDP_addr>,[<cid>]

+CGEV: ME PDN DEACT <cid>

The mobile termination has deactivated a context. The context represents a PDN connection in NB-IOT. The <cid> for this context is provided to the TE. The format of the parameter <cid> is found in command +CGDCONT.

NOTE 3: Occurrence of this event replaces usage of the event

+CGEV: ME DEACT <PDP_type>,<PDP_addr>,[<cid>] www.simcom.com 100 / 331

SIM7020 Series_AT Command Manual_V1.05

For other PDP context handling, the following unsolicited result codes and the corresponding events are defined:

+CGEV: REJECT <PDP_type>,<PDP_addr>

A network request for context activation occurred when the UE was unable to report it to the TE with a +CRING unsolicited result code and was automatically rejected. The format of the parameters <PDP_type> and <PDP_addr> are found in command +CGDCONT.

NOTE 6: This event is not applicable for EPS.

+CGEV: NW REACT <PDP_type>,<PDP_addr>,[<cid>]

The network has requested a context reactivation. The <cid> that was used to reactivate the context is provided if known to the UE. The format of the parameters <PDP_type>,<PDP_addr> and <cid> are found in command +CGDCONT.

NOTE 7: This event is not applicable for EPS.

NO_SAVE Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mode>

<bfr>

<PDP_addr>

<cid>

<class>

<event_type>

0 buffer unsolicited result codes in the UE; if UE result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE.

1 discard unsolicited result codes when UE-TE link is reserved (e.g. in on-line data mode); otherwise forward them directly to the TE

2 buffer unsolicited result codes in the UE when UE-TE link is reserved (e.g. in on-line data mode) and flush them to the TE when

UE-TE link becomes available; otherwise forward them directly to the

0 UE buffer of unsolicited result codes defined within this command is cleared when <mode> 1 or 2 is entered

1 UE buffer of unsolicited result codes defined within this command is flushed to the TE when <mode> 1 or 2 is entered (OK response shall be given before flushing the codes)

Packet Data Protocol address (see +CGDCONT command}

Context Id (see +CGDCONT command)

Note: <cid> only given if known to the UE.

GPRS mobile class (see +CGCLASS command)

Integer type parameter indicates whether this is an informational event of whether the TE as acknowledged it.

0 Informational event

1 Information request: Acknowledgement required. The

Acknowledgement can be accept or reject, see AT+CGANS.

Integer type parameter indicates what kind of change occurred. <change_reason> www.simcom.com 101 / 331

SIM7020 Series_AT Command Manual_V1.05

<reason>

<cid_other>

1 TFT only changed

2 QoS only changed

3 Both TFT and QoS changed

Integer type parameter indicates the reason why the context activation request for PDP type IPV4V6 was not granted. This parameter is only included if the requested PDP type associated with

<cid> is IPV4V6, and the PDP type assign by the network for <cid> is either IPV4 or IPV6

0 IPV4 only allowed

1 IPV6 only allowed

2 single address bearers only allowed

3 single address bearers only allowed and MT initiated context activation for a second address type bearer was not successful

Indicated the context identifier allocated by MT for an MT initiated context of a second address type. MT shall only include this parameter if < reason > parameter indicates single address bearers only allowed, and MT support MT initiated context activation of a second address type without additional commands from the TE, and MT has activated the PDN connection or PDP context associated with < cid_other >.

Example

AT+CGEREP=?

+CGEREP: (0-1),(0)

AT+CGEREP?

+CGEREP: 0,0

AT+CGEREP=0

3.2.41 AT+CGREG Network Registration Status

AT+CGREG Network Registration Status

Test Command

AT+CGREG=?

Read Command

AT+CGREG?

Response

+CGREG: ( list of supported <n> s )

Response

+CGREG: <n>,<stat>[,<lac>,<ci>,<AcT>,<rac>] www.simcom.com 102 / 331

Write Command

AT+CGREG=<n>

SIM7020 Series_AT Command Manual_V1.05

If error is related to ME functionality:

+CME ERROR: <err>

Response

OK or

ERROR

- Parameter Saving Mode

Max Response Time

Reference

Defined Values

<n>

<stat>

<lac>

<ci>

<AcT>

<rac>

Example

AT+CGREG=?

+CGREG: (0-2)

0 Disable network registration unsolicited result code

1 Enable network registration unsolicited result code

+CGREG: <stat>

2 Enable network registration and location information unsolicited result code +CGREG: <stat>[,<lac>,<ci>,<AcT>,<rac>]

0 Not registered, MT is not currently searching an operator to register to.

1 Registered, home network.

2 Not registered, but MT is currently trying to attach or searching an operator to register to.

3 Registration denied.

4 Unknown

5 Registered, roaming

6 Registered for "SMS only", home network (applicable only when

<Act> indicates E-UTRAN)

7 Registered for "SMS only", roaming (applicable only when

<Act> indicates E-UTRAN)

String type; two byte location area code in hexadecimal format (e.g.

"00C3" equals 195 in decimal)

String type; four byte UTRAN/GERAN/E-UTRAN cell ID in hexadecimal format

Access technology of the registered network

9 NB-IoT

String type; one byte routing area code in hexadecimal format www.simcom.com 103 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CGREG?

+CGREG: 0,2

AT+CGREG=2

3.2.42 AT+CGCONTRDP PDP Context Read Dynamic Parameters

AT+CGCONTRDP PDP Context Read Dynamic Parameters

Test Command

AT+CGCONTRDP=?

Write Command

AT+CGCONTRDP=[<cid>]

Parameter Saving Mode

Response

+CGCONTRDP: ( list of <cid> s associated with active contexts )

OK or

Response

+CGCONTRDP: <cid>,<bearer_id>,<apn>[,<local address and subnet mask>[,<gw_addr>[,<DNS_prim_addr>[,<DNS_sec_addr>[,<P_C

SCF_prim_addr>[,<P_CSCF_sec_addr>[,<IM_CN_Signalling_Flag

>[,<LIPA_indication>[,<IPv4_MTU>[,<WLAN_Offload>[,<Local_A ddr_Ind>[,<Non-IP_MTU>[,<Serving_PLMN_rate_control_value>]]

]]]]]]]]]]]

[<CR><LF>+CGCONTRDP: <cid>,<bearer_id>,<apn>[,<local address and subnet mask>[,<gw_addr>[,<DNS_prim_addr>[,<DNS_sec_addr>[,<P_C

SCF_prim_addr>[,<P_CSCF_sec_addr>[,<IM_CN_Signalling_Flag

>[,<LIPA_indication>[,<IPv4_MTU>[,<WLAN_Offload>[,<Local_A ddr_Ind>[,<Non-IP_MTU>[,<Serving_PLMN_rate_control_value>]]

]]]]]]]]]]]

[…]]

OK or

If error is related to ME functionality:

+CME ERROR: <err>

Max Response Time

Reference

- www.simcom.com 104 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<cid>

<bearer_id>

<APN>

<local address and subnet mask>

<gw_addr>

<DNS_prim_addr>

<DNS_sec_addr>

<IPv4_MTU>

<Non-IP_MTU>

<Serving_PLMN_rate_contr ol_value>

A numeric parameter which specifies a particular primary PDP context definition. The parameter is local to the TE-UE interface and is used in other PDP context-related commands.

A numeric parameter which identifies the bearer, EPS Bearer in EPS and NSAPI in UMTS/GPRS.

A string parameter which is a logical name that was used to select the

GGSN or the external packet data network.

A string parameter which shows the IP Address and subnet mask of the UE. 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.m

3. m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15.m16", for IPv6.

A string parameter which shows the Gateway Address of the UE. The string is given as dot-separated numeric (0-255) parameters.

A string parameter which shows the IP Address of the primary DNS

Server.

A string parameter which shows the IP address of the secondary DNS

Server.

Integer type;show the IPv4 MTU size in octets.

Integer type; show 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 sub-clause 9.9.4.28.

Example

AT+CGREG=?

+CGREG: (0-2)

AT+CGREG?

+CGREG: 0,2

AT+CGREG=2

OK www.simcom.com 105 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 <P_CSCF_prim_addr>,<P_CSCF_sec_addr>,<IM_CN_Signalling_Flag>,<LIPA_indication>,<WLAN_

Offload>,<Local_Addr_Ind> are not displayed for MTK NB-IOT solution.

3.2.43 AT+CGPIAF Printing IP Address Format

AT+CGPIAF Printing IP Address Format

Test Command

AT+CGPIAF=?

Read Command

AT+CGPIAF?

Write Command

AT+CGPIAF=[IPv6_Address

Format>[,<IPv6_SubnetNota tion>[,<IPv6_LeadingZeros>

[,<IPv6_CompressZeros>]]]]

Parameter Saving Mode

Response

+CGPIAF: ( list of supported <IPv6_AddressFormat> s ),( list of supported <IPv6_SubnetNotation> s ),( list of supported

<IPv6_LeadingZeros> s ),( list of supported

<IPv6_CompressZeros> s )

Response

+CGPIAF:

<IPv6_AddressFormat>,<IPv6_SubnetNotation>,<IPv6_LeadingZ eros>,<IPv6_CompressZeros>

OK or

+CME ERROR: <err>

Response

If error is related to ME functionality:

+CME ERROR: <err>

Max Response Time

Reference

Defined Values

<IPv6_AddressFormat>

Integer type, decides the IPV6 address format.

Relevant for all AT command parameters that can hold an IPV6 address.

0 Use IPV4-like dot-notation. IP address, and Subnetwork mask if applicable, are dot-separated. www.simcom.com 106 / 331

SIM7020 Series_AT Command Manual_V1.05

<IPv6_SubnetNotation>

<IVv6_LeadingZeros>

<IPv6_CompressZeros>

Example

AT+CGPAIF=?

+CGPIAF: (0,1),(0,1),(0,1),(0,1)

AT+CGPIAF?

+CGPIAF: 0,0,0,0

Example:

For < source address and subnet mask >:

"32.1.13.184.0.0.205.48.0.0.0.0.0.0.0.0.255.255.255.255.255.255.255

.240.0.0.0.0.0.0.0.0"

For other IP address parameters:

"32.1.13.184.0.0.205.48.0.0.0.0.0.0.0.0"

1 Use IPV6-like colon notation. IP address, and subnetwork mask if applicable and when given explicitly, are separated by a space.

Example:

For < source address and subnet mask >:

"2001:0DB8:0000:CD30:0000:0000:0000:0000 FFFF:

FFFF:FFFF:FFF0:0000:0000:0000:0000"

For other IP address parameters:

"2001:0DB8:0000:CD80:0000:0000:0000:0000"

Integer type, decides the subnet-notation for <source Address and subnet mask>. Setting does not apply

If <IPVv6_AddressFormat>=0.

0 Both IP Address and subnet mask are stated.Explicitly, separated by a space. (Example:

"2001:0DB8:0000:CD30:0000:0000:0000:0000 FFFF:

FFFF:FFFF:FFF0:0000:0000:0000:0000")

1 The printout format is applying / (forward slash) subnet-prefix

Classless Inter-Domain Routing (CIDR) notation. (Example:

"2001:0DB8:0000:CD30:0000:0000:0000:0000/60" )

Integer type, decides whether leading zeros are

Omitted or not. Setting does not apply if <IPv6_AddressFormat>=0.

0 Leading zeros are omitted. (Example:

"2001:DB8:0:CD30:0:0:0:0")

1 Leading zeros are included. (Example:

"2001:0DB8:0000:CD30:0000:0000:0000:0000")

Integer type, decides whether 1-n instances of

16 bit zero-values are replaced by only "..". This applies only once.

Setting does not apply if <IPv6_AddressFormat>=0.

0 No zero compression. (Example: "2001:DB8:0:CD30:0:0:0:0")

1 Use zero compression. (Example: "2001:DB8:0:CD30::") www.simcom.com 107 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CGPIAF=0,0,0,0

3.2.44 AT+CGDEL Delete Non-Active PDP Contexts

AT+CGDEL Delete Non-Active PDP Contexts

Test Command

AT+CGDEL=?

Write Command

AT+CGDEL=[<cid>]

Parameter Saving Mode

Response

+CGDEL: <cid>[,<cid>[,…]]

If error is related to wrong AT syntax:

+CME ERROR: <err>

Max Response Time

Reference

Defined Values

<cid>

A numeric parameter which specifies a particular PDP context definition.

3.2.45 AT+CGAUTH Define PDP Context Authentication Parameters

AT+CGAUTH Define PDP Context Authentication Parameters

Test Command

AT+CGAUTH=?

Read Command

AT+CGAUTH?

Response

+CGAUTH: ( range of supported <cid> s ),( list of supported

<auth_prot> s ),( range of supported <userid> s ),( range of supported

<password> s )

Response

[+CGAUTH:

<cid>,<auth_prot>,<userid>,<password>][<CR><LF>+CGAUTH:

<cid>,<auth_prot>,<userid>,<password>

[…]] www.simcom.com 108 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CGAUTH=<cid>[,<auth_ prot>[,<userid>[,<password

>]]]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<cid>

Response

When <auth_prot>/<username>/<password> set:

When no <auth_prot>/<username>/<password> set displays current auth_prot username and password for <cid>:

+CGAUTH: <cid>,<auth_prot>,<username>,<password>

If error is related to wrong AT syntax:

+CME ERROR: <err>

<auth_prot>

<userid>

<password>

A numeric parameter which specifies a particular PDP context definition (see the +CGDCONT and +CGDSCONT commands).

Numeric parameter. Authentication protocol used for this PDP context.

0 None. Used to indicate that no authentication protocol is used for this PDP context. Username and password are removed if previously specified.

1 PAP

String type. User name for access to the IP network.

String type. Password for access to the IP network.

3.2.46 AT*MCGDEFCONT Set Default PSD Connection Settings

AT*MCGDEFCONT Set Default PSD Connection Settings

Test Command

AT*MCGDEFCONT=?

Read Command

AT*MCGDEFCONT?

Write Command

AT*MCGDEFCONT=<PDP_t ype>[,<APN>[,<username>[,

Response

*MCGDEFCONT: ( list of supported <PDP_type>)

Response

*MCGDEFCONT: <PDP_type>[,<APN>,<username>,<password>]

Response

If error is related to wrong AT syntax: www.simcom.com 109 / 331

SIM7020 Series_AT Command Manual_V1.05

<password>]]]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<PDP_type>

+CME ERROR: <err>

AUTO_SAVE_REBOOT

<APN>

(Packet Data Protocol type) a string parameter which specifies the type of packet data protocol:

IP Internet Protocol (IETF STD 5)

IPV6 Internet Protocol, version 6 (IETF RFC 2460)

IPV4V6 Virtual <PDP_type) introduced to handle dual IP stack UE capability(see 3GPP TS 24.301).

Non-IP Transfer of Non-IP data to external packet data Network

(see 3GPP TS 24.301).

(Access Point Name) a string parameter that is 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 value. Username for the connection to the service provider.

String value. Password for the connection to the service provider

<username>

<password>

3.2.47 AT+CEREG EPS Network Registration Status

AT+CEREG EPS Network Registration Status

Test Command

AT+CEREG=?

Read Command

AT+CEREG?

Response

+CEREG: ( list of supported <n> s )

Response when < n >=0, 1, 2 or 3 and command successful:

Write Command

AT+CEREG=<n>

+CEREG: <n>,<stat>[,[<tac>],[<ci>],[<AcT>[,<cause_type>,<rejec t_cause>]]] when < n >=4 or 5 and command successful:

+CEREG: <n>,<stat>[,[<tac>],[<ci>],[<AcT>][,[<cause_type>],[<rej ect_cause>][,[<Active-Time>],[<Periodic-TAU>]]]]

If error is related to wrong AT syntax or operation not allowed:

+CME ERROR: <err>

Response

If error is related to wrong AT syntax:

+CME ERROR: <err> www.simcom.com 110 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<n>

<stat>

<tac>

<ci>

NO_SAVE

0 Disable network registration unsolicited result code

1 Enable network registration unsolicited result code

+CEREG: <stat>

2 Enable network registration and location information unsolicited

result code +CEREG: <stat>[,[<tac>],[<ci>],[<AcT>]]

3 Enable network registration, location information and EMM cause value information unsolicited result code

+CEREG: <stat>[,[<tac>],[<ci>],[<AcT>][,<cause_type>,<rejec t_cause>]]

4 For a UE that wants to apply PSM, enable network registration and location information unsolicited result code

+CEREG: <stat>[,[<tac>],[<ci>],[<AcT>][,,[,[<Active-Time>],[<

Periodic-TAU>]]]]

5 For a UE that wants to apply PSM, enable network registration, location information and EMM cause value information unsolicited result code

+CEREG: <stat>[,[<tac>],[<ci>],[<AcT>][,[<cause_type>],[<rej ect_cause>][,[<Active-Time>],[<Periodic-TAU>]]]]

EPS registration status

0 Not registered, ME is not currently searching a new operator to register to

1 Registered, home network

2 Not registered, but ME is currently searching for a new operator to register to

3 Registration denied

4 Unknown

5 Registered, roaming

6 Registered for "SMS only", home network (applicable only when

<Act> indicates NB-IOT

7 Registered for "SMS only", roaming (applicable only when

<Act> indicates NB-IOT

100 Network has been found but attach is pended,ME is waiting for

AT+CGATT=1 to perform attach procedure

String type; two byte tracking area code in hex adecimal format (e.g.

"00C3" equals 195 in decimal).

String type; four byte GERAN/UTRAN/E-UTRAN cell ID in hexadecimal format www.simcom.com 111 / 331

SIM7020 Series_AT Command Manual_V1.05

<AcT>

<cause_type>

<reject_cause>

<Active-Time>

<Periodic-TAU>

Access technology of the registered network

9 NB-IoT

Integer type; indicates the type of <reject_cause>

0 Indicates that <reject_cause> contains an EMM cause value, see

3GPP TS 24.301 Annex A.

1 Indicates that <reject_cause> contains a manufacturer-specific cause.

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.

Example

AT+CEREG=?

+CGREG: (0-5)

AT+CEREG?

+CGREG: 0,0

AT+CEREG=0

NOTE

 For NB-IoT product, only <AcT> value of 9 is valid. www.simcom.com 112 / 331

SIM7020 Series_AT Command Manual_V1.05

3.2.48 AT+CGDATA Enter Data State

AT+CGDATA Enter Data State

Test Command

AT+CGDATA=?

Write Command

AT+CGDATA=[<L2P>[,<cid>

[,<cid>[,...]]]]

Parameter Saving Mode

Response

+CGDATA: ( list of supported <L2P> s )

Response

OK or

ERROR

NO_SAVE

Max Response Time

Reference

Defined Values

<L2P>

<cid>

A string parameter that indicates the layer 2 protocol to be used between the TE and MT.

M-PT Packet Transport Mechanism protocol for a PDP such as IP

Other values are not supported and will result in an ERROR response to the write command.

A numeric parameter which specifies a particular PDP context definition (see +CGDCONT command).

NOTE

 The command will enter data state once the PDP context has been activated < L2P > value M-PT is

MTK proprietary and represents no < L2P > but raw IP packet transfer.

3.2.49 AT*MGCOUNT GPRS/Packet Domian Packet Counters

AT*MGCOUNT GPRS/Packet Domain Packet Counters

Test Command

AT*MGCOUNT=?

Response

*MGCOUNT: (list of supported < actions >s),(list of supported

< cid >s),(list of supported < period >s)

OK www.simcom.com 113 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT*MGCOUNT?

Write Command

AT*MGCOUNT=<action>,<ci d>[,<period>]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

< action >

Response

*MGCOUNT: <cid>,<state>[,<period>][<CR><LF>*MGCOUNT:

<cid>,<state>[,<period>][…]]

Response

OK or

ERROR

NO_SAVE

<cid>

< period uc uu un dc du

> indicates the action to be performed

0 reset counter for specified <cid>

1 read counter for specified <cid>

2 start reporting counter periodically for specified <cid> defined by <period>. Counter is also reported on context deactivation.

3 report counter on context deactivation for specified <cid>

4 stop reporting counter on specified <cid> a numeric parameter which specifies a particular PDP context definition (see +CGDCONT command) period for periodic packet counter reporting in seconds

Unsolicited Result

Once a counter has been setup for a <cid> the counter will be displayed as

Following either periodically or when the context has been deactivated:

*MGCOUNT: <cid>,<uc>,<uu>,<un>,<dc>,<du>,<dn>

A numeric 32 bit parameter which indicates the number of compressed bytes transferred in the uplink direction displayed in decimal format

A numeric 32 bit parameter which indicates the number of uncompressed bytes transferred in the uplink direction displayed in decimal format

A numeric 32 bit parameter which indicates the number of N-PDUs

(i.e. IP packets) transferred in the uplink direction displayed in decimal format

A numeric 32 bit parameter which indicates the number ofcompressed bytes transferred in the downlink direction displayed in decimal format

A numeric 32 bit parameter which indicates the number of uncompressed bytes transferred in the downlink direction displayed in www.simcom.com 114 / 331

SIM7020 Series_AT Command Manual_V1.05

< dn > decimal format

A numeric 32 bit parameter which indicates the number of N-PDUs

(i.e. IP packets) transferred in the downlink direction displayed in decimal format

Note that the current counter values will be displayed immediately this command is entered for any action (i.e. even stopping the counter display will generate the above unsolicited result code for the cancelled <cid>).

NOTE

 This command displays byte and IP packet counters for PDP contexts. It is proprietary to

MediaTek.

 If counters are displayed periodically, they will only be displayed if: there is a separate multiplexer channel for unsolicited result codes, or the user switches to command mode using the “+++” escape sequence Entering <action> range 0 to 3 will lock the counter for the specified <cid> to the channel on which the AT command was entered. Entering <action> of 4 will unlock the counter for the specified <cid> from the channel on which the AT command was entered. www.simcom.com 115 / 331

SIM7020 Series_AT Command Manual_V1.05

4 AT Commands According to 3GPP

TS 27.005

The 3GPP TS 27.005 commands are for performing SMS and CBS related operations for both Text and

PDU modes.

4.1 Overview of AT Commands According to 3GPP TS 27.005

Command

AT+CMGD

AT+CMGF

AT+CMGL

AT+CMGR

AT+CMGS

AT+CMGW

AT+CMSS

AT+CMGC

AT+CNMI

AT+CPMS

AT+CSCA

AT+CSDH

AT+CSMP

AT+CSMS

AT+CNMA

Description

Delete SMS message

Select SMS message format

List SMS messages from preferred store

Read SMS message

Send SMS message

Write SMS message to memory

Send SMS message from storage

Send SMS Command

New SMS message indications

Preferred SMS message storage

SMS service center address

Show SMS text mode parameters

Set SMS text mode parameters

Select message service

New SMS Message Acknowledgment

4.2 Detailed Description of AT Commands According to 3GPP TS

27.005

4.2.1 AT+CMGD Delete SMS Message www.simcom.com 116 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CMGD Delete SMS Message

Test Command

AT+CMGD=?

Write Command

AT+CMGD=<index>[,<delfla g>]

Parameter Saving Mode

Max Response Time

Response

+CMGD: ( list of supported <index> s )

Response

TA deletes message from preferred message storage < mem1 > location < index >.

OK or

ERROR

If error is related to ME functionality:

+CMS ERROR: <err>

NO_SAVE

5s （ delete 1 message ）

25s （ delete 50 messages ）

25s （ delete 150 messages ）

Reference

Defined Values

<index>

<delflag>

Integer type; value in the range of location numbers supported by the associated memory,This value is only used if <DelFlag>=0.

0 Delete message at location <index> (Default value)

1 Delete all read messages

2 Delete all READ and SENT messages

3 Delete all READ, SENT and UNSENT messages

4 Delete all messages

Example

AT+CGMD=?

+CMGD: (1-50)

AT+CGMD=0

OK www.simcom.com 117 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 When the MT2625 software has concatenated SMS handling in modem enabled (see AT command AT*MFTRCFG) the user can delete a concatenated text SMS up to 1024 characters in length. A concatenated SMS is stored on the SIM as number of smaller SMSs. (This is not possible when MMI is present).

 When the MT2625 software does not have concatenated SMS handling in the modem enabled, the maximum text SMS length is restricted depending on the data coding scheme (160 for 7-bit, 140 for 8-bit, 80 for 16-bit).

 An attempt to delete anything other than the first segment of a concatenated SMS, when concat

SMS is enabled, will result in ERROR response.

Deleting an empty entry will result in OK response rather than ERROR.

4.2.2 AT+CMGF Select SMS Message Format

AT+CMGF Select SMS Message Format

Test Command

AT+CMGF=?

Read Command

AT+CMGF?

Write Command

AT+CMGF=[<mode>]

Parameter Saving Mode

Response

+CMGF: ( list of supported <mode> s )

Response

+CMGF: <mode>

Response

TA sets parameter to denote which input and output format of messages to use.

AT&W_SAVE

Max Response Time

Reference

Defined Values

<mode>

0 PDU mode

1 Text mode www.simcom.com 118 / 331

SIM7020 Series_AT Command Manual_V1.05

Example

AT+CMGF=?

+CMGF: (0-1)

AT+CMGF=1

AT+CMGF?

+CMGF: 1

4.2.3 AT+CMGL List SMS Message from Preferred Store

AT+CMGL List SMS Message from Preferred Store

Test Command

AT+CMGL=?

Write Command

AT+CMGL=<stat>

Response

+CMGL: ( list of supported <stat> s )

Response

TA returns messages with status value < stat > from message storage

< mem1 > to the TE. If status of the message is 'received unread', status in the storage changes to 'received read'.

1) If text mode ( +CMGF=1 ) and Command successful: for SMS-SUBMITs and/or SMS-DELIVERs:

+CMGL:

<index>,<stat>,<oa/da>[,<alpha>][,<scts>][,<tooa/toda>,<length>]

<CR><LF><data>[<CR><LF>+CMGL:

<index>,<stat>,<da/oa>[,<alpha>][,<scts>][,<tooa/toda>,<length>]

<CR><LF><data>[...]]

If SMS-STATUS-REPORT and text mode:

+CMGL: <index>,<stat>,<fo>,<mr>,[<ra>],

[<tora>],<scts>,<dt>,<st>[<CR><LF>+CMGL:

<index>,<stat>,<fo>,<mr>,[<ra>],[<tora>],<scts>,<dt>,<st> [...]]

2) If PDU mode ( +CMGF=0 ) and Command successful:

+CMGL:

<index>,<stat>[,<alpha>],<length><CR><LF><pdu><CR><LF>+C www.simcom.com 119 / 331

Execution Command

AT+CMGL

SIM7020 Series_AT Command Manual_V1.05

MGL: <index>,<stat>[,alpha],<length><CR><LF><pdu>[...]]

3)If error is related to ME functionality:

+CMS ERROR: <err>

1) If text mode: the same as AT+CMGL="REC UNREAD",received unread messages.

2) If PDU mode: the same as AT+CMGL=0, received unread messages.

See more messages please refer to Write Command.

NO_SAVE

20s(list 50 messages)

20s(list 150 messages)

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<stat>

< alpha da > data >

If text mode:

"REC UNREAD" Received unread messages

"REC READ" Received read messages

"STO UNSENT" Stored unsent messages

"STO SENT" Stored sent messages

"ALL" All messages

If PDU mode:

0 Received unread messages

1 Received read messages

2 Stored unsent messages

3 Stored sent messages

4 All messages

String type alphanumeric representation of <da> or <oa> corresponding to the entry found in MT phonebook; implementation of this feature is manufacturer specific

3GPP 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters; type of address given by <toda>

In the case of SMS: 3GPP 23.040 TP-User-Data in text mode responses; format: if <dcs> indicates that 3GPP 23.038 default alphabet is used and <fo> indicates that 3GPP 23.040 TP-User-Data-Header-Indication is not set: ME/TA converts GSM alphabet into current TE character set according to rules of Annex A if <dcs> indicates that 8-bit or UCS2 data coding scheme is used, or

<fo> indicates that 3GPP 23.040 TP-User-Data-Header-Indication is www.simcom.com 120 / 331

SIM7020 Series_AT Command Manual_V1.05

< length >

< index >

< oa >

< pdu >

< scts >

< toda >

< tooa > set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to

TE as two characters 2A (IRA 50 and 65))

In the case of CBS: 3GPP 23.041 CBM Content of Message in text mode responses; format: if <dcs> indicates that 3GPP 23.038 default alphabet is used:

ME/TA converts GSM alphabet into current TE character set according to rules of Annex A. if <dcs> indicates that 8-bit or UCS2 data coding scheme is used:

ME/TA converts each 8-bit octet into two IRA character long hexadecimal number.

Integer type value indicating in the text mode (+CMGF=1) the length of the message body <data> (or <cdata>) in characters; or in PDU mode (+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length)

Integer type; value in the range of location numbers supported by the associated memory

3GPP 23.040 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters; type of address given by <tooa>

In the case of SMS: 3GPP 24.011 SC address followed by 3GPP

23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). In the case of CBS: 3GPP 23.041 TPDU in hexadecimal format.

3GPP 23.040 TP-Service-Center-Time-Stamp in time-string format

(refer <dt>)

3GPP 24.011 TP-Destination-Address Type-of-Address octet in integer format (when first character of <da> is + (IRA 43) default is

145, otherwise default is 129)

3GPP 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer<toda>)

Example

AT+CMGL=?

+CMGL: (0-4)

AT+CMGL=?

+CMGL: ("REC UNREAD","REC READ","STO UNSENT","STO

SENT","ALL")

//PDU mode

//Text mode www.simcom.com 121 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CMGL=4

+CMGL: 1,2,,18

0891683108200105F011640B813118662902F40011A70441E19008

+CMGL: 2,2,,19

0891683108200105F011000D91683118662902F40018010400410042

4.2.4 AT+CMGR Read SMS Message

AT+CMGR Read SMS Message

Test Command

AT+CMGR=?

Write Command

AT+CMGR=<index>

Parameter Saving Mode

Response

TA returns SMS message with location value <index> from message storage <mem1> to the TE. If status of the message is 'received unread', status in the storage changes to 'received read'.

If text mode (+CMGF=1) and command successful: for SMS-DELIVER:

+CMGR:

<stat>,<oa>,[<alpha>],<scts>[,<tooa>,<fo>,<pid>,<dcs>,<sca>,<t osca>,<length>]<CR><LF><data>

OK for SMS-SUBMIT:

+CMGR:

<stat>,<da>,[<alpha>][,<toda>,<fo>,<pid>,<dcs>,[<vp>],<sca>,<to sca>,<length>]<CR><LF><data>

If SMS-STATUS-REPORT and text mode:

+CMGR: <stat>,<fo>,<mr>,[<ra>],[<tora>],<scts>,<dt>,<st>

If PDU mode (+CMGF=0) and command successful:

+CMGR: <stat>,[<alpha>],<length><CR><LF><pdu>

If error is related to ME functionality:

+CMS ERROR: <err>

NO_SAVE www.simcom.com 122 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time

Reference

Defined Values

<index>

< alpha da data dcs fo

> length

< mid >

< oa >

Integer type; value in the range of location numbers supported by the associated memory

String type alphanumeric representation of <da> or <oa> corresponding to the entry found in MT phonebook; implementation of this feature is manufacturer specific

3GPP 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters; type of address given by <toda>

<fo> indicates that 3GPP 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to

TE as two characters 2A (IRA 50 and 65))

In the case of CBS: 3GPP 23.041 CBM Content of Message in text mode responses; format: if <dcs> indicates that 3GPP 23.038 default alphabet is used:

ME/TA converts GSM alphabet into current TE character set according to rules of Annex A. if <dcs> indicates that 8-bit or UCS2 data coding scheme is used:

ME/TA converts each 8-bit octet into two IRA character long hexadecimal number.

Depending on the command or result code: 3GPP 23.038 SMS Data

Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format.

Depending on the command or result code: first octet of 3GPP 23.040

SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND (default 2) in integer format

Integer type value indicating in the text mode (+CMGF=1) the length of the message body <data> (or <cdata>) in characters; or in PDU mode

(+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length)

3GPP 23.041 CBM Message Identifier in integer format

3GPP 23.040 TP-Originating-Address Address-Value field in string www.simcom.com 123 / 331

SIM7020 Series_AT Command Manual_V1.05

< pdu >

< sca >

< scts >

< stat >

< toda >

< tooa >

< tosca >

< vp >

< mr >

< ra >

< tora > format; BCD numbers (or GSM default alphabet characters) are converted characters of the currently selected TE character set

(specified by +CSCS);; type of address given by <tooa>.

In the case of SMS: 3GPP 24.011 SC address followed by 3GPP

23.040 TPDU in hexadecimal format: ME/TA converts each octet of

TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A

(IRA 50 and 65)). In the case of CBS: 3GPP 23.041 TPDU in hexadecimal format.

3GPP 24.011 RP SC address Address-Value field in string format;

BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by

+CSCS); type of address given by <tosca>

3GPP 23.040 TP-Service-Centre-Time-Stamp in time-string format

(refer <dt>)

0 "REC UNREAD" Received unread messages

1 "REC READ" Received read messages

2 "STO UNSENT" Stored unsent messages

3 "STO SENT" Stored sent messages

4 "ALL" All messages

3GPP 24.011 TP-Destination-Address Type-of-Address octet in integer format (when first character of <da> is + (IRA 43) default is

145, otherwise default is 129)

3GPP 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer<toda>)

3GPP 24.011 RP SC address Type-of-Address octet in integer format

(default refer <toda>)

Depending on SMS-SUBMIT <fo> setting: 3GPP 23.040

TP-Validity-Period either in integer format (default 167) or in time-string format (refer <dt>)

Message reference. Integer format.

Recipient address. String type.

Type of address of <ra>.

145 International number

129 National number

Discharge time. String format: "yy/MM/dd,hh:mm:ss+/-zz"

(Year/Month/Dat,Hour:Seconds+/TimeZone)

Status of an SMS-STATUS-REPORT. Integer format.

< dt >

< st >

Example

AT+CMGR=?

AT+CMGR=1 www.simcom.com 124 / 331

SIM7020 Series_AT Command Manual_V1.05

+CMGR: "STO UNSENT","13816692204",

ABCD

4.2.5 AT+CMGS Send SMS Message

AT+CMGS Send SMS Message

Test Command

AT+CMGS=?

Write Command

1) If text mode (+CMGF=1):

Response

TA sends message from a TE to the network (SMS-SUBMIT).

+CMGS=<da>[,<toda>] Message reference value < mr > is returned to the TE on successful

<CR>text is entered +CSMS <service> value is 1 and

<ctrl-Z/ESC>

ESC quits without sending

2) If PDU mode (+CMGF=0):

+CMGS=<length> network supports) < scts > is returned. Values can be used to identify message upon unsolicited delivery status report result code.

1) If text mode(+CMGF=1) and sending successful:

+CMGS: <mr>

<ctrl-Z/ESC>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<da>

2) If PDU mode(+CMGF=0) and sending successful:

+CMGS: <mr>

3)If error is related to ME functionality:

+CMS ERROR: <err>

NO_SAVE

60s

<toda>

<length>

3GPP 23.040 TP-Destination-Address Address-Value field in string format;BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set

(specified by +CSCS ); type of address given by <toda>

3GPP 24.011 TP-Destination-Address Type-of-Address octet in integer format (when first character of <da> is + (IRA 43) default is

145, otherwise default is 129)

Integer type value indicating in the text mode (+CMGF=1) the length of the message body <data> (or <cdata>) in characters; or in PDU mode

(+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP www.simcom.com 125 / 331

SIM7020 Series_AT Command Manual_V1.05

<mr>

Example

AT+CMGS=?

AT+CMGS="13816692204"

> 451212SFACDS#4

+CMGS: 213

OK layer SMSC address octets are not counted in the length)

3GPP 23.040 TP-Message-Reference in integer format

4.2.6 AT+CMGW Write SMS Message to Memory

AT+CMGW Write SMS Message to Memory

Test Command

AT+CMGW=?

Write Command

1) If text mode (+CMGF=1):

Response

TA transmits SMS message (either SMS-DELIVER or SMS-SUBMIT)

AT+CMGW=<oa/da>[,<tooa/t oda>][,<stat>] from TE to memory storage < mem2 >. Memory location < index > of the stored message is returned. By default message status will be set to

<CR> text is entered stat > allows also other status values

<ctrl-Z/ESC>

<ESC> quits without sending to be given.

If writing is successful:

2) If PDU mode (+CMGF=0):

AT+CMGW=<length>[,<stat

+CMGW:

<index>

<ctrl-Z/ESC>

Execution Command

AT+CMGW

+CMS ERROR: <err>

Response

TA transmits SMS message (either SMS-DELIVER or SMS-SUBMIT) from TE to memory storage < mem2 >. Memory location < index > of the stored message is returned. By default message status will be set to

'stored unsent', but parameter < stat > allows also other status values to be given.

If writing is successful:

+CMGW: <index> www.simcom.com 126 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<oa>

If error is related to ME functionality:

+CMS ERROR: <err>

NO_SAVE

<da>

<tooa>

<toda>

<length>

<pdu>

3GPP 23.040 TP-Originating-Address Address-Value field in string format(string should be included in quotation marks); BCD numbers

(or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by +CSCS);type of address given by < tooa >

3GPP 23.040 TP-Destination-Address Address-Value field in string format;BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set

(specified by +CSCS ); type of address given by <toda>

3GPP 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer < toda >)

3GPP 24.011 TP-Destination-Address Type-of-Address octet in integer format (when first character of <da> is + (IRA 43) default is

145, otherwise default is 129)

Integer type value indicating in the text mode ( +CMGF=1 ) the length of the message body <data> (or <cdata> ) in characters; or in PDU mode ( +CMGF=0 ), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length)

In the case of SMS: GSM 04.11 SC address followed by GSM 03.40

TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and

65)). In the case of CBS: GSM 03.41 TPDU in hexadecimal format.

Index of message in selected storage < mem2 > <index>

4.2.7 AT+CMSS Send SMS Message From Storage

AT+CMSS Send SMS Message From Storage

Test Command

AT+CMSS=?

Write Command

AT+CMSS=<index>[,<da>,<t

Response

TA sends message with location value < index > from message storage www.simcom.com 127 / 331

SIM7020 Series_AT Command Manual_V1.05 oda>] < mem2 > to the network (SMS-SUBMIT). If new recipient address

< da > is given, it shall be used instead of the one stored with the message. Reference value < mr > is returned to the TE on successful message delivery. Values can be used to identify message upon unsolicited delivery status report result code.

1) If text mode( +CMGF=1 ) and sending successful:

+CMSS: <mr>

2) If PDU mode( +CMGF=0 ) and sending successful:

+CMSS: <mr>

3)If error is related to ME functionality:

+CMS ERROR: <err>

NO_SAVE

60s

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<index>

<da>

<toda>

Integer type; value in the range of location numbers supported by the associated memory

3GPP 23.040 TP-Destination-Address Address-Value field in string format;BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set

(specified by +CSCS ); type of address given by <toda>

3GPP 24.011 TP-Destination-Address Type-of-Address octet in integer format (when first character of < da > is + (IRA 43) default is

145, otherwise default is 129)

3GPP 24.011 TP-Destination-Address Type-of-Address octet in integer format (when first character of <da> is + (IRA 43) default is

145, otherwise default is 129)

3GPP 23.040 TP-Message-Reference in integer format <mr>

4.2.8 AT+CMGC Send SMS Command

AT+CMSS Send SMS Command

Test Command

AT+CMGC=?

Execute command

Response

Response www.simcom.com 128 / 331

SIM7020 Series_AT Command Manual_V1.05

1) If text mode (+CMGF=1):

AT+CMGC=<fo>,<ct>[<pid>[

,<mn>[,<da>[,<toda>]]]]<CR

> text is entered

<ctrl-Z/ESC>

ESC quits without sending

2) If PDU mode (+CMGF=0):

AT+CMGC=<length><CR>

PDU is given <ctrl-Z/ESC>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<fo>

TA transmits SMS Command message from a TE to the network

(SMS-COMMAND). Message reference value <mr> is returned to the

TE on successful message delivery. Value can be used to identify message upon unsolicited delivery status report result code.

If text mode (+CMGF=1) and sending successful:

+CMGC: <mr>

If PDU mode (+CMGF=0) and sending successful:

+CMGC: <mr>

If error is related to ME functionality:

+CMS ERROR: <err>

NO_SAVE

60s

<ct>

<pid>

<mn>

<da>

<toda>

<length>

< mr >

First octet of 3GPP 23.040 SMS-COMMAND (default 2) in integer format

3GPP 23.040 TP-Command-Type in integer format (default 0)

3GPP 23.040 TP-Protocol-Identifier in integer format (default 0)

3GPP 23.040 TP-Message-Number in integer format

3GPP 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set

(specified by +CSCS); type of address given by < toda >

3GPP 24.011 TP-Destination-Address Type-of-Address octet in integer format (when first character of < da > is + (IRA 43) default is

145, otherwise default is 129)

Integer type value indicating in PDU mode ( +CMGF=0 ), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length)

3GPP 23.040 TP-Message-Reference in integer format

4.2.9 AT+CNMI New SMS Message Indications www.simcom.com 129 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CNMI New SMS Message Indications

Test Command

AT+CNMI=?

Read Command

AT+CNMI?

Write Command

AT+CNMI=<mode>[,<mt>[,< bm>[,<ds>[,<bfr>]]]]

Response

+CNMI: ( list of supported <mode> s ),( list of supported <mt> s ),( list of supported <bm> s ),( list of supported <ds> s ),( list of supported <bfr> s )

Response

+CNMI: <mode>,<mt>,<bm>,<ds>,<bfr>

Response

TA selects the procedure for how the receiving of new messages from the network is indicated to the TE when TE is active, e.g. DTR signal is

ON. If TE is inactive (e.g. DTR signal is OFF), message receiving should be done as specified in 3GPP 23.038.

OK or

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mode>

ERROR

AT&W_SAVE

<mt>

0 Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications.

1 Discard indication and reject new received message unsolicited result codes when TA-TE link is reserved (e.g. in on-line data mode).

Otherwise forward them directly to the TE.

2 Buffer unsolicited result codes in the TA when TA-TE link is reserved (e.g. in on-line data mode) and flush them to the TE after reservation. Otherwise forward them directly to the TE.

3 Forward unsolicited result codes directly to the TE. TA-TE link specific inband technique used to embed result codes and data when

TA is in on-line data mode.

(the rules for storing received SMs depend on its data coding scheme

(refer 3GPP 23.038 [2]), preferred memory storage (+CPMS) setting and this value):

0 No SMS-DELIVER indications are routed to the TE.

1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE using unsolicited result code: +CMTI:

<mem>,<index> www.simcom.com 130 / 331

SIM7020 Series_AT Command Manual_V1.05

<bm>

<ds>

2 SMS-DELIVERs (except class 2) are routed directly to the TE using unsolicited result code:

+CMT: [<alpha>],<length><CR><LF><pdu> (PDU mode enabled) or

+CMT:

<oa>,[<alpha>],<scts>[,<tooa>,<fo>,<pid>,<dcs>,<sca>,<tosca>,< length>]<CR><LF><data> (text mode enabled; about parameters in italics, refer Command Show Text Mode Parameters +CSDH). Class 2 messages result in indication as defined in < mt >=1.

3 Class 3 SMS-DELIVERs are routed directly to TE using unsolicited result codes defined in < mt >=2. Messages of other classes result in indication as defined in < mt >=1.

(the rules for storing received CBMs depend on its data coding scheme (refer 3GPP 23.038 [2]), the setting of Select CBM Types

(+CSCB) and this value):

0 No CBM indications are routed to the TE

0 No SMS-STATUS-REPORTs are routed to the TE.

1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code: +CDS: <length><CR><LF><pdu> (PDU mode enabled) or +CDS: <fo>,<mr>[,<ra>][,<tora>],<scts>,<dt>,<st> (text mode enabled)

2 SMS status reports are stored and indication of memory location

<bfr>

< mem > routed to TE using unsolicited result +CDSI: "SR",<index>

0 TA buffer of unsolicited result codes defined within this Command is flushed to the TE when < mode > 1...3 is entered (OK response shall be given before flushing the codes).

1 TA buffer of unsolicited result codes defined within this command is cleared when < mode > 1…3 is entered

Memory storage (for + CMTI and + CBMI indications)

< index >

" SM " SMS message storage in SIM

" SR " status report message storage (in SIM if EF-SMR file present) or in MMI NVRAM if MMI present.

Integer type indicating storage location (for +CMTI and +CBMI indications)

NOTE

 CB messages are not supported for NB-IoT.

4.2.10 AT+CPMS Preferred SMS Message Storage www.simcom.com 131 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CPMS Preferred SMS Message Storage

Test Command

AT+CPMS=?

Read Command

AT+CPMS?

Write Command

AT+CPMS=<mem1>[,<mem

2>[,<mem3>]]

Parameter Saving Mode

Response

+CPMS: ( list of supported <mem1> s ),( list of supported

<mem2> s ),( list of supported <mem3> s )

Response

+CPMS:

<mem1>,<used1>,<total1>,<mem2>,<used2>,<total2>,<mem3>,< used3>,<total3>

OK or

ERROR

Response

TA selects memory storages <mem1>,<mem2> and <mem3> to be used for reading, writing, etc.

+CPMS: <used1>,<total1>,<used2>,<total2>,<used3>,<total3>

OK or

ERROR

NO_SAVE

Max Response Time

Reference

Defined Values

<mem1>

<mem2>

<mem3>

<usedx>

<totalx>

Messages to be read and deleted from this memory storage

"SM" SIM message storage

"SR" Status Report message storage (EF-SMR if available on

SIM).

SR in SIM are only associated with SMSs stored on SIM.

If EF-SMR not available and MMI is present then status reports are stored in NVRAM. In addition MMI can store status reports in

NVRAM as well as ones stored on SIM (EF-SMR file), if available.

Messages will be written and sent to this memory storage

"SM" SIM message storage

Received messages will be placed in this memory storage if routing to

PC is not set ("+CNMI")

"SM" SIM message storage

Integer type; Number of messages currently in <memx>

Integer type; Number of messages storable in <memx> www.simcom.com 132 / 331

SIM7020 Series_AT Command Manual_V1.05

4.2.11 AT+CSCA SMS Service Center Address

AT+CSCA SMS Service Center Address

Test Command

AT+CSCA=?

Read Command

AT+CSCA?

Write Command

AT+CSCA=<sca>[,<tosca>]

Parameter Saving Mode

Response

+CSCA: <sca>,<tosca>

Response

TA updates the SMSC address, through which mobile originated SMS are transmitted. In text mode, setting is used by send and writes commands. In PDU mode, setting is used by the same commands, but only when the length of the SMSC address coded into <pdu> parameter equals zero.

Note: The Command writes the parameters in NON-VOLATILE memory.

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<sca>

<tosca>

3GPP 24.011 RP SC address Address-Value field in string format(string should be included in quotation marks); BCD numbers

(or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by +CSCS); type of address given by <tosca>

Service center address format 3GPP 24.011 RP SC address

Type-of-Address octet in integer format (default refer <toda>)

4.2.12 AT+CSDH Show SMS Text Mode Parameters

AT+CSDH Show SMS Text Mode Parameters

Test Command Response www.simcom.com 133 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CSDH=?

Read Command

AT+CSDH?

Write Command

AT+CSDH=[<show>]

+CSDH: ( list of supported <show> s )

Response

+CSDH: <show>

Response

TA determines whether detailed header information is shown in text mode result codes.

NO_SAVE Parameter Saving Mode

Max Response Time

Reference

Defined Values

<show> 0 Do not show header values defined in commands +CSCA and

+CSMP (<sca>,<tosca>,<fo>,<vp>,<pid> and <dcs>) nor

<length>,<toda> or <tooa> in +CMT, +CMGL, +CMGR result codes for

SMS-DELIVERs and SMS-SUBMITs in text mode

1 Show the values in result codes

4.2.13 AT+CSMP Set SMS Text Mode Parameters

AT+CSMP Set SMS Text Mode Parameters

Test Command

AT+CSMP=?

Read Command

AT+CSMP?

Write Command

AT+CSMP=[<fo>[,<vp>,<pid

>,<dcs>]]

Parameter Saving Mode

Max Response Time

Reference

Response

+CSMP: <fo>,<vp>,<pid>,<dcs>

Response

TA selects values for additional parameters needed when SM is sent to the network or placed in a storage when text mode is selected

(+CMGF=1). It is possible to set the validity period starting from when the SM is received by the SMSC (< vp > is in range 0... 255) .

NO_SAVE www.simcom.com 134 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

< fo >

< vp >

< pid >

< dcs > first octet of 3GPP 23.040 SMS-DELIVER, SMS-SUBMIT in integer format. The following fields can be modified:

TP-Message-Type-Indicator (bits 0-1) (SMS-DELIVER or

SMS-SUBMIT)

TP-Reject-Duplicates (bit 2)

TP-Validity-Period-Format (bits 3-4)

TP-Status-Report-Request (bit 5)

TP-User-Data-Header-Indicator (bit 6)

TP-Reply-Path (bit 7).

Default value is 17 (SMS-SUBMIT and Validity Period in relative format)

When concatenated SMS is supported by MT2625, attempts to change the following fields from the default will produce an ERROR :

TP-User-Data-Header-Indicator (bit 6) – the UDHI field is used for concatenated SMSs and is set by the Background Layer where appropriate.

3GPP 23.040 TP-Validity-Period in integer format (default 167)

3GPP 23.040 TP-Protocol-Identifier in integer format (default 0)

3GPP 23.038 SMS Data Coding Scheme in Integer format (default 0 i.e. 7-bit coding).

NOTE



The command writes the settings < vp >,< pid > and < dcs > in SIM memory. < fo > field is not stored anywhere.



On startup, the settings < vp >,< pid > and < dcs > are read from the SIM and used for SMS AT commands. If they cannot be found in the SIM they are set to the default values.

 The < fo > field is always set to the default value at startup.

4.2.14 AT+CSMS Select Message Service

AT+CSMS Select Message Service

Test Command

AT+CSMS=?

Response

+CSMS: (list of supported < service >s)

OK www.simcom.com 135 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CSMS?

Write Command

AT+CSMS=<service>

Parameter Saving Mode

Response

+CSMS: <service>,<mt>,<mo>,<bm>

Response

+CSMS: <mt>,<mo>,<bm>

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<service>

<mt>

<mo>

<bm>

0 3GPP 23.040 and 23.041.

1 3GPP 23.040 and 23.041, with a requirement that a message routed directly to TE should be acknowledged via +CNMA.

128 SMS PDU mode - TPDU only used for sending/receiving SMSs

Mobile Terminated Messages:

0 Type not supported

1 Type supported

Mobile Originated Messages:

0 Type not supported

1 Type supported

Broadcast Type Messages:

0 Type not supported

NOTE



<service> value 128 is MediaTek proprietary

 <bm> message type is not supported

4.2.15 AT+CNMA New Message Acknowledgement to ME/TA

AT+CNMA New Message Acknowledgement to ME/TA

Test Command

AT+CNMA=?

Response www.simcom.com 136 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CNMA[=<n>[,<length[<C

If PDU mode ( +CMGF=0 ):

+CNMA: (list of supported <n> s)

If Text mode ( +CMGF=1 ):

Response

After SMS is routed to the TA (based on message class and +CNMI

<CTRL-Z/ESC]]]

Execution Command

AT+CNMA

Parameter Saving Mode

Max Response Time

Reference

Defined Values

< n > to the network. Note: this functionality shall be used only when

+CSMS parameter < service > equals 1.

If command is executed but no acknowledgement is expected, or some other error ME related error occurs:

+CMS ERROR: <err>

If PDU mode (+CMGF=0):

If Text mode (+CMGF=1):

ERROR

Response

If command is executed but no acknowledgement is expected, or some other error ME related error occurs:

+CMS ERROR: <err>

NO_SAVE

< length >

0 Operates similarly as defined for text mode (if ME doesn’t get acknowledgement within required time, ME should respond as specified in 3GPP 24.011, and ME shall automatically disable routing to TE setting both <mt> and <ds>values of CNMI to zero).

1 Send positive acknowledgement to the network with optional PDU message

2 Send negative acknowledgement to the network with optional

PDU message

Length of the optional PDU message. Integer type www.simcom.com 137 / 331

SIM7020 Series_AT Command Manual_V1.05

5 AT Commands Special for SIMCom

5.1 Overview of AT Commands for SIMCom

Command

AT+CPOWD

AT+CADC

AT+CLTS

AT+CBAND

AT+CBANDSL

AT+CENG

AT+CCID

AT+EXUNSOL

AT+GSV

AT*CELLLOCK

AT+SLEDS

AT+CNETLIGHT

AT+CSMINS

AT+CSPCHSC

AT+CPSMSTATUS

AT+CSCLK

AT+CRESET

AT+CREVHEX

AT+CDISAUPDN

AT+CNWRCCFG

AT+CURTC

AT+CHOMENW

AT+CBATCHK

AT+CGPIO

AT*MEDRXCFG

AT+CNBIOTDT

AT+CNBIOTRAI

AT+ICCID

AT+CTRJ

AT+NIDD

Description

Power off

Read ADC

Get local timestamp

Get and set mobile operation band

Set modem NB-IOT search prefer band list

Switch on or off engineering mode

Show ICCID

Enable or disable proprietary unsolicited indications

Display product identification information

Set the list of ARFCN which needs to be locked

Set the timer period of net light

Close the net light or open it to shining

SIM inserted status reporting

Set Scrambling Algorithm for NPDSCH

Enable Deep Sleep Wakeup Indication

Configure Slow Clock

Trigger WDT Reset

Control the Data Output Format

Control the Auto PDN Status

Network Recovery Configure

Control CCLK Show UTC Or RTC Time

Display Home Network Information

Set VBAT checking feature ON/OFF

Control the GPIO by PIN index eDRX configuaration

NB-IOT Data Type

NB-IOT Release Assistance Indication

Show ICCID

Inquire the Value of Timer 3346

Send NIDD(Non-IP Data Delivery) www.simcom.com 138 / 331

SIM7020 Series_AT Command Manual_V1.05

Indicate RI When Using URC AT+CFGRI

5.2 Detailed Description of AT Commands Special for SIMCom

5.2.1 AT+CPOWD Power Off

AT+CPOWD Power Off

Write Command

AT+CPOWD=<n>

Parameter Saving Mode

Response

[NORMAL POWER DOWN]

NO_SAVE

Max Response Time

Reference

Defined Values

< n >

0 Power off urgently (Will not send out NORMAL POWER DOWN)

1 Normal power off (Will send out NORMAL POWER DOWN)

5.2.2 AT+CADC Read ADC

AT+CADC Read ADC

Test Command

AT+CADC=?

Read Command

AT+CADC?

Parameter Saving Mode

Max Response Time

Reference

Defined Values

Response

+CADC: (list of supported < status >s),(list of supported < value >s)

Response

+CADC: <status>,<value>

NO_SAVE

2S www.simcom.com 139 / 331

SIM7020 Series_AT Command Manual_V1.05

<status>

<value>

1 Success

0 Fail

Integer 0-1400

5.2.3 AT+CLTS Get Local Timestamp

AT+CLTS Get Local Timestamp

Test Command

AT+CLTS=?

Response

+CLTS: ( list of supported <mode> s )

Read Command

AT+CLTS?

Write Command

AT+CLTS=<mode>

Response

+CLTS: <mode>

Response

If error is related to wrong AT syntax:

+CME ERROR: <err>

Unsolicited Result Code

+CLTS: <time>

AUTO_SAVE_REBOOT Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mode>

< time >

0 Disable

1 Enable

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. E.g 10/05/06,00:01:52+32.

If there is daylight saving time on the network then display:

+CLTS: 18/06/22,09:27:49+32,"DST +2 in use" or

+CLTS: 18/06/22,09:27:49+32,"DST +1 in use" .

5.2.4 AT+CBAND Get and Set Mobile Operation Band www.simcom.com 140 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CBAND Get and Set Mobile Operation Band

Test Command

AT+CBAND=?

Response

+CBAND: ( list of supported <band> s )

Read Command

AT+CBAND?

Write Command

AT+CBAND=<op_band>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<op_band>

Response

+CBAND: <op_band>

Response

If error is related to ME functionality:

+CME ERROR: <err>

AUTO_SAVE_REBOOT

Integer value indicating current selected NB-IOT band

Valid values: <band> response of test command.

Integer value indicating supported band. <band>

5.2.5 AT+CBANDSL Set Modem NB-IOT Search Prefer Band List

AT+CBANDSL Set Modem NB-IOT Search Prefer Band List

Test Command

AT+CBANDSL=?

Response

+CBANDSL: ( list of supported <enable> s ),( list of supported <band number> s ),( list of supported <band> s )

Write Command

AT+CBANDSL=<enable>[,< band number>,<band1>[,<band2>

[,<band3>[,<ban4>]]]]

Read Command

AT+CBANDSL?

Parameter Saving Mode

Response

If error is related to ME functionality:

+CME ERROR: <err>

Response

[+CBANDSL: <band>]

AUTO_SAVE www.simcom.com 141 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time

Reference

Defined Values

<enable>

<band number>

<bandn>

Integer value indicating search prefer band list enable or disable

0 Disable

1 Enable

Integer value indicating search prefer band number.

Valid values: 1,2,3,4

Integer value indicating current search prefer NB-IOT band.

Valid values: < band > response of test command.

5.2.6 AT+CENG Report Network State

AT+CENG Report Network State

Test Command

AT+CENG=?

Response

TA returns the list of supported modes.

+CENG: ( list of supported <mode> s )

Read Command

AT+CENG?

Response

<mode>=0 display serving cell and up to 4 neighbor cell information:

+ CENG :

<sc_earfcn>,<sc_earfcn_offset>,<sc_pci>,<sc_cellid>[,<sc_rsrp>

][,<sc_rsrq>][,<sc_rssi>][,<sc_snr>],<sc_band>,<sc_tac>[,<sc_e cl>][,<sc_tx_pwr>][,<sc_re_rsrp>][<CR><LF>+CENG:

<nc_earfcn>,<nc_earfcn_offset>,<nc_pci>,<nc_rsrp>

[…]]

<mode>=1 display data transfer information only if modem in

RRC-CONNECTED state:

+ CENG :

<RLC_UL_BLER>,<RLC_DL_BLER>,<MAC_UL_BLER>,<MAC_D

L_BLER>,<MAC_UL_total_bytes>,<MAC_DL_total_bytes>,<MAC

_UL_total_HARQ_TX>,<MAC_DL_total_HARQ_TX>,<MAC_UL_H

ARQ_re_TX>,<MAC_DL_HARQ_re_TX>,<RLC_UL_tput>,<RLC_D

L_tput>,<MAC_UL_tput>,<MAC_DL_tput> www.simcom.com 142 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CENG=<mode>

<sc_pci>

<sc_cellid>

<sc_rsrp>

<sc_rsrq>

<sc_rssi>

<sc_snr>

<sc_band>

<sc_tac>

<sc_ecl>

<sc_tx_pwr>

< sc_re_rsrp >

If error is related to wrong AT syntax or incorrect <mode> or UE in incorrect state

+CME ERROR: <err>

Response

OK or

ERROR

NO_SAVE Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mode>

<sc_earfcn>

<sc_earfcn_offset>

Integer value indicating requested engineering information.

0 Radio information for serving and neighbor cells

1 Serving Cell/Neighbor Cell information

Integer value indicating the EARFCN for serving cell. Range 0-

262143

Integer value indicating the EARFCN offset for serving cell:

0 Offset of -2

1 Offset of -1

2 Offset of -0.5

3 Offset of 0

4 Offset of 1

Integer value indicating the serving cell physical cell ID. Range 0-503.

String type; four byte (28 bit) cell ID in hexadecimal format for serving cell.

Signed integer indicating serving cell RSRP value in units of dBm (can be negative value). Available only in RRC-IDLE state.

Signed integer indicating serving cell RSRQ value in units of dB (can be negative value). Available only in RRC-IDLE state.

Signed integer indicating serving cell RSSI value in units of dBm (can be negative value). Available only in RRC-IDLE state.

Signed integer value. Last SNR value for serving cell in units of dB.

Available only in RRC-IDLE state.

Integer value; current serving cell band

String type; two byte tracking area code (TAC) in hexadecimal format

(e.g. "00C3" equals 195 in decimal).

Integer value. Last Coverage Enhanced Level (CE Level) value for serving cell. Range 0-2.

Signed integer value indicating current UE transmit power. Units of cBm Centibels relative to one milliwatt (can be negative value).

Signed integer indicating serving cell RSRP value (the modified) in www.simcom.com 143 / 331

<nc_earfcn>

<nc_pci>

<nc_rsrp>

<nc_earfcn_offset>

<RLC_UL_BLER>

<RLC_DL_BLER>

<MAC_UL_BLER>

<MAC_DL_BLER>

SIM7020 Series_AT Command Manual_V1.05 units of dBm (can be negative value). Available only in RRC-IDLE state.

Integer value indicating the EARFCN for neighbor cell. Range

0-262143

Integer value indicating the EARFCN offset for neighbor cell:

0 Offset of -2

1 Offset of -1

2 Offset of -0.5

3 Offset of 0

4 Offset of 1

Integer value indicating the neighbor cell physical cell ID. Range

0-503.

Signed integer indicating neighbor cell RSRP value in units of dBm

(can be negative value).

Data Transfer Information: s

Integer value. Represented in % value (range 0 to 100). UL block error rate (as per IRQ) in RLC. Calculated over all established RLC AM radio bearers. Calculated from the beginning of successfully established/resumed RRC connection or since previous AT+CENG query with <mode>=1, whichever is later. Only valid in

RRC-CONNECTED state.

Integer value Represented in % value (range 0 to 100). DL block error rate (as per ARQ) in RLC. Calculated over all established RLC AM radio bearers. Calculated from the beginning of successfully established / resumed RRC connection, or since previous AT+CENG query with <mode>=1, whichever is later. Available only in

RRC-CONNECTED state.

Integer value. Represented in % value (range 0 to 100). UL block error rate (as per HARQ) in MAC for UL-SCH. Calculated from the beginning of successfully established / resumed / re-established RRC connection, or since previous AT+CENG query with <mode>=1, whichever is later. Available only in RRC-CONNECTED state.

Integer value. Represented in % value (range 0 to 100). DL block error rate (as per HARQ) in MAC for DL-SCH, excluding BCCH. Calculated from the beginning of successfully established / resumed / re-established RRC connection, or since previous AT+CENG query with < mode >=1, whichever is later. Available only in

RRC-CONNECTED state.

<MAC_UL_total_bytes> Integer value. Total number of transport block bytes (re)transmitted on UL-SCH. Calculated for UL-SCH over all

HARQ transmissions and retransmissions. Calculated from the beginning of successfully established / resumed / re-established RRC connection, or since previous AT+CENG query with <mode>=1, whichever is later. Available only in RRC-CONNECTED state. Unit: bytes www.simcom.com 144 / 331

SIM7020 Series_AT Command Manual_V1.05

<MAC_DL_total_bytes> Integer value. Total number of transport block bytes (re)transmitted on

DL-SCH, excluding BCCH. Calculated from the beginning of successfully established / resumed / re-established

RRC connection, or since previous AT+CENG query with <mode>=1, whichever is later. Available only in RRC-CONNECTED state. Unit: bytes

<MAC_UL_total_HARQ_TX> Integer value. Total number of HARQ

(re)transmissions for transport blocks on UL-SCH.

Calculated from the beginning of successfully established / resumed / re-established RRC connection, or since previous AT+CENG query with < mode >=1, whichever is later. Available only in

RRC-CONNECTED state. Unit: (re)transmissions

<MAC_DL_total_HARQ_TX> Integer value. Total number of HARQ

(re)transmissions for transport blocks on DL-SCH, excluding BCCH.

Calculated from the beginning of successfully established / resumed / re-established RRC connection, or since previous AT+CENG query with < mode >=1, whichever is later. Available only in

RRC-CONNECTED state. Unit: (re)transmissions

<MAC_UL_HARQ_re_TX> Integer value. Number of HARQ retransmissions for transport blocks on UL-SCH. Calculated from the beginning of successfully established

/ resumed / re-established RRC connection, or since previous

<MAC_DL_HARQ_re_TX>

<RLC_UL_tput>

<RLC_DL_tput>

<MAC_UL_tput>

AT+CENG query with <mode>=1, whichever is later. Available only in

RRC-CONNECTED state. Unit: retransmissions

Integer value. Number of HARQ retransmissions for transport blocks on DL-SCH, excluding BCCH.

Calculated from the beginning of successfully established / resumed / re-established RRC connection, or since previous AT+CENG query with < mode >=1, whichever is later. Available only in

RRC-CONNECTED state. Unit: retransmissions.

Integer value. RLC uplink throughput. Calculated over all established

RLC AM radio bearers. Calculated from the beginning of successfully established / resumed RRC connection, or since previous AT+CENG query with < mode >=1, whichever is later. Available only in

RRC-CONNECTED state. Unit: kbits / s

Integer value. RLC downlink throughput. Calculated over all established RLC AM radio bearers Calculated from the beginning of successfully established / resumed RRC connection, or since previous

AT+CENG query with < mode >=1, whichever is later. Available only in

RRC-CONNECTED state. Unit: kbits / s

Integer value. UL throughput in MAC for UL-SCH.

Calculated from the beginning of successfully established / resumed / re-established RRC connection, or since previous AT+CENG query with < mode >=1, whichever is later. Available only in

RRC-CONNECTED state. Unit: kbits / s www.simcom.com 145 / 331

SIM7020 Series_AT Command Manual_V1.05

<MAC_DL_tput> Integer value. DL throughput in MAC for DL-SCH, excluding BCCH.

Calculated from the beginning of successfully established / resumed / re-established RRC connection, or since previous AT+CENG query with < mode >=1, whichever is later. Available only in

RRC-CONNECTED state. Unit: kbits / s

NOTE

 If modem is not in RRC-CONNECTED state then +CENG will not be generated for < mode >=1.

Only OK response will be generated.

5.2.7 AT+CCID Show ICCID

AT+CBANDSL Set Modem NB-IOT Search Prefer Band List

Test Command

AT+CCID=?

Response

Execution Command

AT+CCID

Parameter Saving Mode

Max Response Time

Reference

Response

Ccid data [ex. 898600810906F8048812]

NO_SAVE

5.2.8 AT+EXUNSOL Enable or Disable Proprietary Unsolicited Indications

AT+EXUNSOL Enable or Disable Proprietary Unsolicited Indications

Test Command

AT+EXUNSOL=?

Response

+EXUNSOL: ( list of supported <exunsol> s )

Write Command

AT+EXUNSOL=<exunsol>,< mode>

Response

If < mode >=2

+EXUNSOL: <mode>

OK www.simcom.com 146 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<exunsol>

If error is related to ME functionality:

+CME ERROR: <err>

AT&W_SAVE

<mode>

String type(string should be included in quotation marks). values are currently reserved by the present document

"SQ" Signal Quality Report

Displays signal strength and channel bit error rate (similar to

AT+CSQ) in form +CSQN: <rssi>,<ber> when values change.

0 Disable

1 Enable

2 Query

5.2.9 AT+GSV Display Product Identification Information

AT+GSV Display Product Identification Information

Execution Command

AT+GSV

Response

TA returns product information text

Example:

SIMCOM_Ltd

SIM7020C

Revision: 1752B01SIM7020C

Parameter Saving Mode

Max Response Time

Reference

NO_SAVE

5.2.10 AT*CELLLOCK Set the List of ARFCN Which Needs to Be Locked

AT*CELLLOCK Set the List of ARFCN Which Needs to Be Locked

Test Command

AT*CELLLOCK=?

Response

Read Command

Response www.simcom.com 147 / 331

SIM7020 Series_AT Command Manual_V1.05

AT*CELLLOCK?

<earfcn>

<earfcn_offset>

<pci>

Write Command

AT*CELLLOCK=<lock>[,<ea rfcn>,<earfcn_offset>[,<pci

>]]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<lock>

*CELLLOCK: <lock>[,<earfcn>,<earfcn_offset>[,<pci>]]

Response

If error is related to wrong AT syntax or incorrect parameters.

ERROR

NO_SAVE

Integer value indicating whether to activate lock, or remove lock:

0 Remove lock

1 Activate lock

Integer value indicating requested EARFCN on which to lock. Range

0- 262143. Value of 0 indicates to remove any lock for EARFCN and

Cell.

Integer value indicating requested EARFCN offset:

0 Offset of -2

1 Offset of -1

2 Offset of -0.5

3 Offset of 0

4 Offset of 1

Integer value: Physical cell ID. Range: 0-503

5.2.11 AT+SLEDS Set the Timer Period of Net Light

AT+SLEDS Set the Timer Period of Net Light

Test Command

AT+SLEDS=?

Response

+SLEDS: (1-3),(0,40-65535),(0,40-65535)

Read Command

AT+SLEDS?

Write Command

AT+SLEDS=<mode>,<timer

_on>,<timer_off>

Parameter Saving Mode

Response

+SLEDS: <mode>,<timer_on>,<timer_off>

Response

ERROR

AUTO_SAVE www.simcom.com 148 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time

Reference

Defined Values

<mode>

< timer_on >

< timer_off >

NOTE

The default value is:

<mode>,<timer_on>,<timer_off>

1,64,800

2,64,3000

3,64,300

1 Set the timer period of net light while SIM7020 series does not register to the network

2 Set the timer period net light while SIM7020 series has already registered to the network

3 Set the timer period net light while SIM7020 series is in the state of

PPP communication

Timer period of "LED ON" in decimal format which range is 0 or

40-65535(ms)

Timer period of "LED OFF" in decimal format which range is 0 or

40-65535(ms)

5.2.12 AT+CNETLIGHT Close the Net Light or Open it to shining

AT+CNETLIGHT Close the Net Light or Open it to shining

Test Command

AT+CNETLIGHT=?

Response

+CNETLIGHT: ( 0,1)

Read Command

AT+CNETLIGHT?

Write Command

AT+CNETLIGHT=<mode>

Response

+CNETLIGHT: <mode>

Response

OK or

ERROR www.simcom.com 149 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mode>

AUTO_SAVE

0 Close the net light

1 Open the net light to shining

5.2.13 AT+CSMINS SIM Inserted Status Reporting

AT+CSMINS SIM Inserted Status Reporting

Test Command

AT+CSMINS=?

Read Command

AT+CSMINS?

Write Command

AT+CSMINS=<n>

Parameter Saving Mode

Response

+CSMINS: ( list of supported <n> s )

Response

+CSMINS: <n>,<SIM inserted>

Response

OK or

ERROR

If error is related to ME functionality:

+CME ERROR: <err>

AT&W_SAVE

Max Response Time

Reference

Defined Values

<n>

<SIM inserted>

A numeric parameter to show an unsolicited event code indicating whether the SIM has been inserted or removed.

0 Disable

1 Enable

A numeric parameter which indicates whether SIM card has been inserted.

0 Not inserted

1 Inserted www.simcom.com 150 / 331

SIM7020 Series_AT Command Manual_V1.05

5.2.14 AT+CSPCHSC Set Scrambling Algorithm for NPDSCH

AT+CSPCHSC Set Scrambling Algorithm for NPDSCH

Test Command

AT+CSPCHSC=?

Read Command

AT+CSPCHSC?

Write Command

AT+CSPCHSC=<mode>

Parameter Saving Mode

Response

+CSPCHSC: (0-1)

Response

+CSPCHSC: <mode>

Response

If error is related to wrong AT syntax or incorrect parameters.

ERROR

AUTO_SAVE

Max Response Time

Reference

Defined Values

<mode>

0 Close scrambling algorithm

1 Open scrambling algorithm

5.2.15 AT+CPSMSTATUS Enbale Deep Sleep Wakeup Indication

AT+CPSMSTATUS Enable Deep Sleep Wakeup Indication

Test Command

AT+CPSMSTATUS=?

Read Command

AT+CPSMSTATUS?

Write Command

AT+CPSMSTATUS=<enable

Response

+CPSMSTATUS: (0-1)

Response

+CPSMSTATUS: <enable>

Response

If error is related to wrong AT syntax or incorrect parameters.

ERROR www.simcom.com 151 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<enable>

AT&W_SAVE

0 Disable indication on this channel when modem wakes up from deep sleep

1 Enable indication on this channel when modem wakes up from

Deep sleep

5.2.16 AT+CSCLK Configure Slow Clock

AT+CSCLK Configure Slow Clock

Test Command

AT+CSCLK=?

Read Command

AT+CSCLK?

Write Command

AT+CSCLK=<n>

Parameter Saving Mode

Response

+CSCLK: ( list of supported <n> s )

Response

+CSCLK: <n>

Response

OK or

ERROR

AUTO_SAVE

Max Response Time

Reference

Defined Values

<n>

0 Disable slow clock, module will not enter sleep mode.

1 Enable slow clock, it is controlled by DTR. When DTR is high, module can enter sleep mode. When DTR changes to low level, module can quit sleep mode.

2 Enable slow clock automatically. When there is no interrupt (on air and hardware such as GPIO interrupt or data in serial port), module can enter sleep mode. Otherwise, it will quit sleep mode.

NOTE www.simcom.com 152 / 331

SIM7020 Series_AT Command Manual_V1.05

 Only UART1 can enable csclk as 1 or 2.

 There are two caveats when you want to quit sleep mode in mode 2:

1, You should input some characters (at least one) to awake module

2, An interval time of 100ms more is necessary between waking characters and following AT commands,otherwise the waking characters will not be discarded completely,and messy codes will be produced which may leads to UART baudrate re-adaptation.

 Scope of parameter < n > is different among SIM7020 series project, please refer to chapter 22 for details.

5.2.17 AT+CRESET Trigger WDT Reset

AT+CRESET Trigger WDT Reset

Test Command

AT+CRESET=?

Execution Command

AT+CRESET

Parameter Saving Mode

Response

If it succeeds, the system will reboot immediately.

NO_SAVE

Max Response Time

Reference

5.2.18 AT+CREVHEX Control the Data Output Format

AT+CREVHEX Control the Data Output Format

Test Command

AT+CREVHEX=?

Read Command

AT+CREVHEX?

Write Command

AT+CREVHEX=<n>

Parameter Saving Mode

Max Response Time

Response

+CREVHEX: ( list of supported <n> s )

Response

+CREVHEX: < n>

Response

If error is related to wrong AT syntax or incorrect parameters.

ERROR

AUTO_SAVE

- www.simcom.com 153 / 331

SIM7020 Series_AT Command Manual_V1.05

Reference

Defined Values

<n> 0 The data output format is raw data.

1 The data output format is hexadecimal.

5.2.19 AT+CDISAUPDN Control the Auto PDN Status

AT+CDISAUPDN Control the Auto PDN Status

Test Command

AT+CDISAUPDN=?

Read Command

AT+CDISAUPDN?

Write Command

AT+CDISAUPDN=<n>

Parameter Saving Mode

Response

+CDISAUPDN: ( list of supported <n> s )

Response

+CDISAUPDN: < n>

Response

If error is related to wrong AT syntax or incorrect parameters.

ERROR

AUTO_SAVE

Max Response Time

Reference

Defined Values

<n>

0 Diable auto PDN, should reboot the module to check.

1 Enable auto PDN, should reboot the module to check.

5.2.20 AT+CNWRCCFG Network Recovery Configure

AT+CNWRCCFG Network Recovery Configure

Test Command

AT+CNWRCCFG=?

Response

+CNWRCCFG:

(5-28800),(5-28800),(5-28800),(5-28800),(5-28800),(5-28800) www.simcom.com 154 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CNWRCCFG?

Write Command

AT+CNWRCCFG=<recovery

_internal1>,<recovery_inter nal2>,<recovery_internal3>,

<recovery_internal4>,<reco very_internal5>,<recovery_i nternal6>

Parameter Saving Mode

Response

+CNWRCCFG:

<recovery_internal1>,<recovery_internal2>,<recovery_internal3>

,<recovery_internal4>,<recovery_internal5>,<recovery_internal6

Response

If error is related to ME functionality:

+CME ERROR: <err>

AUTO_SAVE

Max Response Time

Reference

Defined Values

< recovery_internal1 >

< recovery_internal2 recovery_internal3

< recovery_internal4 >

1 step network searching interval after out of service

Range: 5-28800(s) Default: 5(s)

2 step network searching interval after out of service

Range: 5-28800(s) Default: 10(s)

3 step network searching interval after out of service

Range: 5-28800(s) Default: 10(s)

4 step network searching interval after out of service

< recovery_internal5 recovery_internal6

Range: 5-28800(s) Default: 1(s)

5 step network searching interval after out of service

Range: 5-28800(s) Default: 120(s)

6 step network searching interval after out of service

Range: 5-28800(s) Default: 7200(s)

NOTE

 The config will effect after rebooting.

5.2.21 AT+CURTC Control CCLK Show UTC Or RTC Time www.simcom.com 155 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CURTC Control CCLK Show UTC Or RTC Time

Test Command

AT+CURTC=?

Read Command

AT+CURTC?

Write Command

AT+CURTC=<opt>

Parameter Saving Mode

Response

+CURTC: (0,1)

Response

+CURTC: <opt>

Response

+CURTC: <opt>

AUTO_SAVE_REBOOT

Max Response Time

Reference

Defined Values

<opt>

A numeric parameter.

0 CCLK show UTC time after network time synchronization

1 CCLK show RTC time after network time synchronization

5.2.22 AT+CHOMENW Display Home Network Information

AT+CHOMENW Display Home Network Information

Test Command

AT+CHOMENW=?

Read Command

AT+CHOMENW?

Parameter Saving Mode

Response

UE returns the home network information (extracted form the IMSI)in long alpha,short alpha and numeric formats.

+CHOMENW: <oper_long>,<oper_short>,<oper_numeric>

Max Response Time

Reference

Defined Values

- www.simcom.com 156 / 331

SIM7020 Series_AT Command Manual_V1.05

<oper_long>

<oper_short>

<oper_numeric>

Home operator in long alphanumeric format

Home operator in short alphanumeric format

Home operator in numeric GSM Loation Area Identification number format

5.2.23 AT+CBATCHK Set VBAT Checking Feature ON/OFF

AT+CBATCHK Set VBAT Checking Feature ON/OFF

Test Command

AT+CBATCHK=?

Read Command

AT+CBATCHK?

Write Command

AT+CBATCHK=<mode>

Parameter Saving Mode

Response

+CBATCHK: (0,1)

Response

+CBATCHK: <mode>

Response

If failed:

+CME ERROR: <err>

AUTO_SAVE

Max Response Time

Reference

Defined Values

<mode>

0 Close the function of VBAT checking

1 Open the function of VBAT checking

5.2.24 AT+CGPIO Control the GPIO by PIN Index

AT+CGPIO Control the GPIO by PIN Index

Test Command

AT+CGPIO=?

Write Command

AT+CGPIO=<operation>,<pi n>,<function>,<level>

Response

+CGPIO: (0-1),( list of supported < pin >s ),(0-1),(0-1)

Response

OK or www.simcom.com 157 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<operation>

ERROR

<pin>

<function>

<level>

0 Set the GPIO function including the GPIO output .

1 Read the GPIO level. Please note that only when the gpio is set as input, user can use parameter 1 to read the GPIO level, otherwise the module will return " ERROR ".

The PIN index you want to be set. (It has relations with the hardware, please refer to the hardware manual)

Only when < operation > is set to 0, this option takes effect.

0 Set the GPIO to input

1 Set the GPIO to output

0 Set the GPIO low level

1 Set the GPIO high level

5.2.25 AT*MEDRXCFG eDRX Configuration

AT*MEDRXCFG eDRX Configuration

Test Command

AT*MEDRXCFG=?

Read Command

AT*MEDRXCFG?

Write Command

AT*MEDRXCFG=[<mode>[,<

AcT-type>[,<Requested_eD

RX_value>[,<Requested_Pa

Response

*MEDRXCFG: ( list of supported < mode >s ),( list of supported

< AcT-type >s ),( list of supported < Requested_eDRX_value >s ),( list of supported < Requested_Paging_time_window_value >s )

Response

[*MEDRXCFG:

< AcT-type > , < Requested_eDRX_value >[ , < Requested_Paging_tim e_window_value >] [<CR><LF>*MEDRXCFG:

< AcT-type > , < Requested_eDRX_value >[ , < Requested_Paging_tim e_window_value >]

[…]]]

Response

OK or

+CME ERROR: <err> www.simcom.com 158 / 331

SIM7020 Series_AT Command Manual_V1.05 ging_time_window_value>]]

]]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

< mode > Integer type, indicates to disable or enable the use of eDRX in the UE.

This parameter is applicable to all specified types of access technology, i.e. the most recent setting of <mode> will take effect for all specified values of <AcT>.

0 Disable the use of eDRX

1 Enable the use of eDRX

2 Enable the use of eDRX and enable the unsolicited result code

+CEDRXP:

<AcT-type>[,<Requested_eDRX_value>[,<NW-provided_eDRX_va lue>[,<Paging_time_window>]]]

< AcT-type >

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.

0 Access technology is not using eDRX. This parameter value is only use in the unsolicited result code.

5 E-UTRAN (NB-S1 mode)

< Requested_eDRX_value > String type; half a byte in a 4-bit format. The eDRX value refers to bit 4 to 1 of octet 3 of the Extended DRX parameters information element

(see sub-clause 10.5.5.32 of 3GPP TS 24.008). For the coding and

< window_value

Requested_Paging_time_

NW-provided_eDRX_value

Paging_time_window > the value range, see Extended DRX parameters information element in 3GPP TS 24.008 Table 10.5.5.32/3GPP TS 24.008. The default value, if available, is manufacturer specific.

String type; half a byte in a 4-bit format. The paging time window refers to bit 8 to 5 of octet 3 of the Extended DRX parameters information element (see sub-clause 10.5.5.32 of 3GPP TS 24.008).

For the coding and the value range, see the Extended DRX parameters information element in 3GPP TS 24.008 Table

10.5.5.32/3GPP TS 24.008

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 paging time window www.simcom.com 159 / 331

SIM7020 Series_AT Command Manual_V1.05 refers to bit 8 to 5 of octet 3 of the Extended DRX parameters information element (see sub-clause 10.5.5.32 of 3GPP TS 24.008).

For the coding and the value range, see the Extended DRX parameters information element in 3GPP TS 24.008 Table

10.5.5.32/3GPP TS 24.008.

NOTE

 Only part of projects support this command, please refer to chapter 22 for details.

5.2.26 AT+CNBIOTDT NB-IOT Data Type

AT+CNBIOTDT NB-IOT Data Type

Test Command

AT+CNBIOTDT=?

Read Command

AT+CNBIOTDT?

Write Command

AT+CNBIOTDT=<type>[,<ci d>[,<cid>[,…]]]

Parameter Saving Mode

Response

+CNBIOTDT: ( list of supported <type> s )

Response

Displays <type> for all active PDP contexts:

[+CNBIOTDT: <cid>,<type>][<CR><LF>+CNBIOTDT:

<cid>,<type>]

[…]]

Response

If error is related to wrong AT syntax:

+CME ERROR: <err>

Max Response Time

Reference

Defined Values

<type>

Integer type

0 Normal data

1 Exceptional data www.simcom.com 160 / 331

SIM7020 Series_AT Command Manual_V1.05

<cid> Integer type. Specifies a particular PDP context definition.

If no < cid >s are specified the command sets < type > for all active PDP contexts.

NOTE

 The UE will not remember this setting over sleep cycles (i.e. the UE will fall back to default setting after sleep)

5.2.27 AT+CNBIOTRAI NB-IOT Release Assistance Indication

AT+CNBIOTRAI NB-IOT Release Assistance Indication

Test Command

AT+CNBIOTRAI=?

Read Command

AT+CNBIOTRAI?

Write Command

AT+CNBIOTRAI=<rai>

Parameter Saving Mode

Response

+CNBIOTRAI: ( list of supported <rai> s )

Response

+CNBIOTRAI: <rai>

Response

If error is related to wrong AT syntax:

+CME ERROR: <err>

Max Response Time

Reference

Defined Values

<rai>

Integer type. Specifies release assistance information.

0 No information available (or none of the other options apply)

1 TE will send only 1 UL packet and no DL packets expected

2 TE will send only 1 UL packet and only 1 DL packet expected

NOTE

 This command may never be required as it is likely that the TE will not www.simcom.com 161 / 331

SIM7020 Series_AT Command Manual_V1.05 know this information.

 Modem applies specified <rai> value only to next UL packet sent by TE.

 TE will not remember this setting over sleep cycles (i.e. will fall back to default after sleep).

5.2.28 AT+ICCID Show ICCID

AT+ICCID Show ICCID

Test Command

AT+ICCID=?

Execution Command

AT+ICCID

Parameter Saving Mode

Response

Ccid data [ex. 898600810906F8048812]

NO_SAVE

Max Response Time

Reference

5.2.29 AT+CTRJ Inquire the Value of Timer 3346

AT+CTRJ Inquire the Value of Timer 3346

Test Command

AT+CTRJ=?

Read Command

AT+CTRJ?

Parameter Saving Mode

Response

+CTRJ: <t3346>

NO_SAVE

Max Response Time -

Reference

Defined Values

< t3346 > The value of Timer 3346

NOTE

 Customer can use it to inquiry the value of Timer 3346, Refer to 3GPP, T3346 is sent to UE when www.simcom.com 162 / 331

SIM7020 Series_AT Command Manual_V1.05 the base station reject the attach request from UE. While T3346 is running, the module will not send attach request after booting up until it is expired.

5.2.30 AT+NIDD Send NIDD(Non-IP Data Delivery)

AT+NIDD Send NIDD(Non-IP Data Delivery)

Write Command

AT+NIDD=<mode>,<apn>,[< send data>]

Parameter Saving Mode

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<mode>

<apn>

Operation type

1 Creat NIDD

2 Send data via NIDD

A string parameter which indicates the GPRS access point name. The max length is 32 bytes.

The data need to send via NIDD <send data>

NOTE

 When <mode>=1

The command is creat NIDD.

Send this quickly, need before attach complete

 When<mode>=2

The command is send data via NIDD

 When NIDD receive data there will be a URC report on serial port

+NIDD: 4,"id","length","index","data"

5.2.31 AT+CFGRI Indicate RI When Using URC www.simcom.com 163 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CFGRI Indicate RI When Using URC

Test Command

AT+CFGRI=?

Read Command

AT+CFGRI?

Write Command

AT+CFGRI=<status>

Parameter Saving Mode

Response

+CFGRI: (0-2)

Response

+CFGRI: <status>

Response

If error is related to ME functionality:

+CME ERROR: <err>

AUTO_SAVE

- Max Response Time

Reference

Defined Values

<status> 0 Off

1 On(TCPIP, HTTP, LWM2M, COAP, ONENET, MQTT, TLS, SMS)

2 On(only TCPIP control RI pin)

NOTE

 The RI will be pulled down 120ms by default. www.simcom.com 164 / 331

SIM7020 Series_AT Command Manual_V1.05

6 AT Command for TCPIP

Application

6.1 Overview of AT Commands for TCPIP Application

Command

AT+CSOC

AT+CSOCON

AT+CSOB

AT+CSOLIS

AT+RETENTION

AT+CSOSEND

AT+CSODSEND

AT+CSOCL

AT+CSOSENDFLAG

AT+CSORCVFLAG

AT+CSOSTATUS

AT+CSOACK

AT+CSOALIVE

AT+CSORXGET

+CSONMI

+CSOERR

Description

Create a TCP/UDP socket

Connect socket to remote address and port

Bind local address and local port

Open Listening Function of the Server

Retention of socket scence

Send data to remote via socket

Send data to remote via socket with data mode

Close socket

Set TCP send flag

Set receive flag

Get socket status

Query previous connection data transmitting state

Set TCP keepalive parameters

Get Data from Network Manually

Socket message arrived indicator

Socket error indicator

6.2 Detailed Description of AT Commands for TCPIP App;ication

6.2.1 AT+CSOC Creat a TCP/UDP Socket

AT+CSOC Creat a TCP/UDP Socket

Test Command

AT+CSOC=?

Response

+CSOC: (1-2),(1-3),(1-2) www.simcom.com 165 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CSOC?

Write Command

AT+CSOC=<domain>,<type

>,<protocol>[,<cid>]

Response

OK or

+CSOC: <socket_id>,<domain>,<type>,<protocol>[<CR><LF>+C

SOC: <socket_id>[...]]

Response

+CSOC: <socket_id>

NO_SAVE Parameter Saving Mode

Max Response Time

Reference

Defined Values

<socket_id>

<domain>

<type>

<protocol>

Integer socket_id. Range is 0-4.

Integer

1 IPv4

2 IPv6

Integer

1 TCP

2 UDP

3 RAW

Integer

1 IP

2 ICMP

Integer, PDP context ID, AT+CGACT response. [option] <cid>

6.2.2 AT+CSOCON Connect Socket to Remote Address and Port

AT+CSOCON Connect Socket to Remote Address and Port

Test Command

AT+CSOCON=?

Read Command

AT+CSOCON?

Response

OK or

If connection exist.

+CSOCON: <socket_id>,<type>[<CR><LF>+CSOCON: <socket_i www.simcom.com 166 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CSOCON=<socket_id>,

<remote_port>,<remote_ad dress>

- d>,<type>[...]]

Response

If format is wrong or connection exists:

ERROR

If connection is failed:

ERROR

+CSOERR: <socket_id>,<error_code>

NO_SAVE Parameter Saving Mode

Max Response Time

Reference

Defined Values

<socket_id>

<remote_port>

<remote_address>

<type>

Integer, socket_id, response of AT+CSOC.

Integer, remote port.(1-65535)

String, remote address.

Integer

1 TCP

2 UDP

3 RAW

Reference section 5.2.16. < error_code >

6.2.3 AT+CSOB Bind Local Address and Local Port

AT+CSOB Bind Local Address and Local Port

Test Command

AT+CSOB=?

Read Command

AT+CSOB?

Write Command

AT+CSOB=<socket_id>,<po rt>[,<address>]

Parameter Saving Mode

Response

NO_SAVE

Max Response Time

Reference

- www.simcom.com 167 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<socket_id>

<port>

<address>

Integer type, socket_id, AT+CSOC's response.

Integer type, port,(1-65535).

String type, address.

6.2.4 AT+CSOLIS Open Listening Function of the Server

AT+CSOLIS Open Listening Function of the Server

Test Command

AT+CSOLIS=?

Read Command

AT+CSOLIS?

Write Command

AT+CSOLIS=<socket_id>

Parameter Saving Mode

Response

NO_SAVE

Max Response Time

Reference

Defined Values

<socket_id>

Integer type, socket_id, AT+CSOC's response.

6.2.5 AT+RETENTION Rentention of Soctet Scene

AT+RETENTION Retention of Socket Scene

Test Command

AT+RETENTION=?

Read Command

AT+RETENTION?

Write Command

AT+RETENTION=<retention

_socket>

Parameter Saving Mode

Response

+RETENTION: (0-1)

Response

+RETENTION: <retention_socket>

Response

NO_SAVE www.simcom.com 168 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time

Reference

Defined Values

<retention_socket> Integer type

0 Not recovery scene when module exited PSM mode

1 Recovery scene when module exited PSM mode

NOTE

 AT+CPSMS should be set before this command.

6.2.6 AT+CSOSEND Send Data to Remote Via Socket

AT+CSOSEND Send Data to Remote Via Socket

Test Command

AT+CSOSEND=?

Write Command

AT+CSOSEND=<socket_id>

,<data_len>,<data>

Parameter Saving Mode

Response

If CSOSENDFLAG is 0.

If CSOSENDFLAG is 1 and socket type is TCP.

SEND: <socket_id>,<len>

NO_SAVE

Max Response Time

Reference

Defined Values

<socket_id>

<data_len>

<data>

<len>

Integer type, socket_id, AT+CSOC's response.

Integer type, length of data

Raw_data, data context.

Max data size is 512 bytes.

If < data_len > is 0 you can send str to remote socket with double quotation, otherwise the format of data should be hex and the length must be equal to the < data_len >.

Integer type, length of data www.simcom.com 169 / 331

SIM7020 Series_AT Command Manual_V1.05

6.2.7 AT+CSODSEND Send Data to Remote Via Socket With Data Mode

AT+CSOSEND Send Data to Remote Via Socket With Data Mode

Test Command

AT+CSODSEND=?

Write Command

AT+CSODSEND=<socket_id

>,<data_len> response">", then tap data for send

Execution Command

AT+CSODSEND=<socket_id

> response">", then tap data for send, tap CTRL+Z to send, tap ESC to cancel the operation

Parameter Saving Mode

Response

If CSOSENDFLAG is 0.

DATA ACCEPT: <len>

If CSOSENDFLAG is 1 and socket type is TCP.

DATA ACCEPT: <len>

SEND: <socket_id>,<len>

Response

If CSOSENDFLAG is 0.

DATA ACCEPT: <len>

If CSOSENDFLAG is 1 and socket type is TCP.

DATA ACCEPT: <len>

SEND: <socket_id>,<len>

NO_SAVE

Max Response Time

Reference

Defined Values

<socket_id>

<data_len>

<len>

Integer type, socket_id, AT+CSOC's response.

Integer type, length of data

6.2.8 AT+CSOCL Close Socket

AT+CSOCL Close Socket

Test Command

AT+CSOCL=?

Response

Write Command

AT+CSOCL=<socket_id>

Parameter Saving Mode

Response

NO_SAVE www.simcom.com 170 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time

Reference

Defined Values

<socket_id>

Integer socket_id, AT+CSOC's response.

6.2.9 AT+CSOSENDFLAG Set TCP Send Flag

AT+CSOSENDFLAG Set TCP Send Flag

Test Command

AT+CSOSENDFLAG=?

Response

+CSOSENDFLAG: (0,1)

Read Command

AT+CSOSENDFLAG?

Write Command

AT+CSOSENDFLAG=<flag>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<flag>

Response

+CSOSENDFLAG: <flag>

Response

AUTO_SAVE

TCP send flag

0 Disable send flag feature

1 Enable this feature

6.2.10 AT+CSORCVFLAG Set Receive Flag

AT+CSORCVFLAG Set Receive Flag

Test Command

AT+CSORCVFLAG=?

Response

+CSORCVFLAG: (0,1)

OK www.simcom.com 171 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CSORCVFLAG?

Write Command

AT+CSORCVFLAG=<flag>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<flag>

Response

+CSORCVFLAG: <flag>

Response

AUTO_SAVE

TCP receive flag

0 Receive data form remote socket with hex.

1 Receive data form remote socket with string

6.2.11 AT+CSOSTATUS Get Socket Status

AT+CSOSTATUS Get Socket Status

Test Command

AT+CSOSTATUS=?

Write Command

AT+CSOSTATUS=<socket_i d>

Parameter Saving Mode

Response

+CSOSTATUS: (0-4)

Response

+CSOSTATUS: <socket_id>,<status>

Max Response Time

Reference

Defined Values

<socket_id>

<status>

Integer type, socket id, AT+CSOC’s response.

Integer type.

0 None socket

1 Socket create but not connect

2 Connected www.simcom.com 172 / 331

SIM7020 Series_AT Command Manual_V1.05

6.2.12 AT+CSOACK Query Previous Connection Data Transmitting State

AT+CSOACK Query Previous Connection Data Transmitting State

Test Command

AT+CSOACK=?

Write Command

AT+CSOACK=<socket_id>

Execution Command

AT+CSOACK

Parameter Saving Mode

Response

+CSOACK: (0-4)

Response

+CSOACK: <socket_id>,<txlen>,<acklen>,<nacklen>

Response

+CSOACK: <socket_id>,<txlen>,<acklen>,<nacklen>[<CR><LF>

+CSOACK: <socket_id>,<txlen>,<acklen>,<nacklen>[...]]

Max Response Time

Reference

Defined Values

<socket_id>

<txlen>

<acklen>

<nacklen>

Integer type, socket id, AT+CSOC’s response.

The data amount which has been sent

The data amount confirmed successfully by the server

The data amount without confirmation by the server

6.2.13 AT+CSOALIVE Set TCP Keepalive Parameters

AT+CSOALIVE Set TCP Keepalive Parameters

Test Command

AT+CSOALIVE=?

Read Command

AT+CSOALIVE?

Response

+CSOALIVE: (0-4),(0-1),(30-7200),(30-600),(1-9)

Response

+CSOALIVE:

<socket_id>,<mode>[,<keepIdle>,<keepInterval>,<keepCount>][<

CR><LF> +CSOALIVE:

<socket_id>,<mode>[,<keepIdle>,<keepInterval>,<keepCount>][

…]] www.simcom.com 173 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CSOALIVE=<socket_id>

,<mode>[,<keepIdle>[,<keep

Interval>[,<keepCount>]]]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<socket_id>

<mode>

<keepIdle>

<keepInterval>

<keepCount>

Response

If error is related to ME functionality:

ERROR

Integer type, socket id, AT+CSOC’s response.

Set TCP keepalive option.

0 Disable TCP keep alive mechanism

1 Enable TCP keep alive mechanism

If < mode >=0, executing "AT+CSOALIVE=<socket_id>,<mode>".

Integer type; Idle time (in second) before TCP send the initial keepalive probe.

30-7200 Default: 7200

Interval time (in second) between keepalive probes retransmission.

30-600 Default: 75

Integer type; Max number of keepalive probes to be sent.

1-9 Default: 9

6.2.14 AT+CSORXGET Get Data from Network Manually

AT+CSORXGET Get Data from Network Manually

Test Command

AT+CSORXGET=?

Read Command

AT+CSORXGET?

Write Command

AT+CSORXGET=<mode>[,<i d>[,<reqlength>]]

Response

+CSORXGET: ( list of supported <mode> s ),( list of supported

<id> s ),( list of supported <reqlength>)

Response

+CSORXGET: <mode>

Response

OK or

ERROR if <mode>=1 www.simcom.com 174 / 331

SIM7020 Series_AT Command Manual_V1.05

+CSORXGET: 1,<id> if <mode> = 2

+CSORXGET: 2,<id>,<reqlength>,<cnflength>

1234567890…

OK if <mode> = 3

+CSORXGET: 3,<id>,<reqlength>,<cnflength>

5151…

OK if <mode>=4

+CSORXGET: 4,<id>,<cnflength>

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mode>

<id>

<reqlength>

<cnflength>

0 Disable getting data from network manually, the module is set to normal mode, data will be pushed to TE directly.

1 Enable getting data from network manually.

2 The module can get data, but the length of output data can not exceed 1460 bytes at a time.

3 Similar to mode 2, but in HEX mode, which means the module can get 730 bytes maximum at a time.

4 Query how many data are not read with a given ID.

A numeric parameter which indicates the connection number

Requested number of data bytes (1-1460 bytes)to be read

Confirmed number of data bytes to be read, which may be less than

<length>. 0 indicates that no data can be read.

6.2.15 +CSONMI Socket Message arrived indicator

+CSONMI Socket Message arrived indicator

Response

Indicated there is received some data from network. www.simcom.com 175 / 331

SIM7020 Series_AT Command Manual_V1.05

+CSONMI: <socket_id>,<data_len>,<data>

Defined Values

<socket_id>

<data_len>

<data>

Integer socket_id,AT+CSOC's response

Integer, length of data

Raw_data, data context.

6.2.16 +CSOERR Socket Error indicator

+CSOERR Socket Error indicator

Response

Indicated there is some error.

+CSOERR: <socket_id>,<error_code>

Defined Values

<socket_id>

< error_code >

Integer socket_id,AT+CSOC's response

-1 Common error

1 Route error

2 Connection abort error

3 Reset error

4 Connected error

5 Value error

6 Buffer error

7 Block error

8 Addr in use error

9 ALR connecting error

10 ALR connected error

11 NETIF error

12 PARAMETER error www.simcom.com 176 / 331

SIM7020 Series_AT Command Manual_V1.05

7 AT Commands for TCPIP

Application to Compatible with

SIM800 Serials

7.1 Overview of AT Commands

Command

AT+CIPMUX

AT+CIPSTART

AT+CIPSEND

AT+CIPQSEND

AT+CIPACK

AT+CIPCLOSE

AT+CIPSHUT

AT+CLPORT

AT+CSTT

AT+CIICR

AT+CIFSR

AT+CIPSTATUS

AT+CDNSCFG

AT+CDNSGIP

AT+CIPHEAD

AT+CIPHEXS

AT+CIFSREX

AT+CIPATS

AT+CIPSPRT

AT+CIPSERVER

AT+CIPCSGP

AT+CIPSRIP

AT+CIPSHOWTP

AT+CIPUDPMODE

AT+CIPRXGET

AT+CIPTKA

AT+CIPMODE

Description

Start Up multi-IP connection

Start Up TCP or UDP connection

Send data through TCP or UDP connection

Select data transmitting mode

Query previous connection data transmitting state

Close TCP or UDP connection

Deactivate GPRS PDP context

Set local port

Start task and set APN, user name, password

Bring up wireless connection

Get local IP address

Query current connection status

Configure domain name server

Query the IP address of given domain name

Add an IP head at the beginning of a package received

Show data in hex mode of a package received

Get local IP address

Set auto sending timer

Set prompt of ‘>’ when module sends data

Configure module as server

Set CSD or GPRS for connection mode

Show remote IP address and port when received data

Display transfer protocol in IP head when received data

UDP extended mode

Get data from network manually

Set TCP keep alive parameters

Open transparent mode www.simcom.com 177 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CIPCHAN Enter transparent mode

7.2 Detailed Descriptions of Commands

7.2.1 AT+CIPMUX Start Up Multi-IP Connection

AT+CIPMUX Start Up Multi-IP Connection

Test Command

AT+CIPMUX=?

Read Command

AT+CIPMUX?

Write Command

AT+CIPMUX=<n>

Parameter Saving Mode

Response

+CIPMUX: <n>

Response

NO_SAVE

Max Response Time

Reference

Defined Values

<n>

Example

AT+CIPMUX=?

+CIPMUX: (0,1)

AT+CIPMUX?

+CIPMUX: 0

0 Single IP connection

1 Multi IP connection www.simcom.com 178 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 Only in IP initial state, AT+CIPMUX=1 is effective

 Only when multi IP connection and GPRS application are both shut down, AT+CIPMUX=0 is effective

7.2.2 AT+CIPSTART Start Up TCP or UDP Connection

AT+CIPSTART Start Up TCP or UDP Connection

Test Command

AT+CIPSTART=?

Response

1) If AT+CIPMUX=0

+CIPSTART: ( list of supported <mode>),(<IP address>),(<port>)

+CIPSTART: ( list of supported <mode>),(<domain name>),(<port>)

2) If AT+CIPMUX=1

+CIPSTART: ( list of supported <n>),( list of supported <mode>),(<IP address>),(<port>)

+CIPSTART: ( list of supported <n>),( list of supported

<mode>),(<domain name>),(<port>)

Write Command

1)If single IP connection 1)If single IP connection (+CIPMUX=0)

(+CIPMUX=0)

Response

If format is right response

AT+CIPSTART=<mode>,<IP address>,<port> or

AT+CIPSTART=<mode>,<do

OK otherwise response

If error is related to ME functionality:

+CME ERROR <err>

Response when connection exists main name>,<port>

2)If multi-IP connection

(+CIPMUX=1)

AT+CIPSTART=<n>,<mode>

ALREADY CONNECT

CONNECT OK

Otherwise

Response when connection is successful

,<address>,<port> or

AT+CIPSTART=<n>,<mode>

,<domain name>,<port>

AT+CIPMUX=<n>

STATE: <state>

CONNECT FAIL

2)If multi-IP connection(+CIPMUX=1)

If format is right

OK otherwise response www.simcom.com 179 / 331

SIM7020 Series_AT Command Manual_V1.05

If error is related to ME functionality:

+CME ERROR <err>

Response when connection exists

<n>,ALREADY CONNECT

If connection is successful

<n>,CONNECT OK

Otherwise

<n>,CONNECT FAIL

NO_SAVE

When mode is multi-IP state, the max response time75 seconds.

When mode is single state, and the state is IP INITIAL, the max response time is 160 seconds.

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<n>

<mode>

<IP address>

<port>

<domain name>

<state>

Connection number

0..5 A numeric parameter which indicates the connection number

A string parameter which indicates the connection type

"TCP" Establish a TCP connection

"UDP" Establish a UDP connection

A string parameter which indicates remote server IP address

Remote server port,(1-65535).

A string parameter which indicates remote server domain name

A string parameter which indicates the progress of connecting

In single IP state :

0 IP INITIAL

1 IP START

2 IP CONFIG

3 IP GPRSACT

4 IP STATUS

5 TCP CONNECTING/UDP CONNECTING/

SERVER LISTENING

6 CONNECT OK

7 TCP CLOSING/UDP CLOSING

8 TCP CLOSED/UDP CLOSED

9 PDP DEACT

In Multi-IP state:

0 IP INITIAL

1 IP START

2 IP CONFIG

3 IP GPRSACT

4 IP STATUS www.simcom.com 180 / 331

SIM7020 Series_AT Command Manual_V1.05

5 IP PROCESSING

9 PDP DEACT

Example

AT+CIPSTART=?

+CIPSTART: ("TCP","UDP"),("(0-255).(0-255).(0-255).(0-255)"),(1-65535)

+CIPSTART: ("TCP","UDP"),("DOMAIN NAME"),(1-65535)

NOTE

 This command allows establishment of a TCP/UDP connection only when the state is IP_INITIAL or IP_STATUS or IP_CLOSED when it is in single state. In multi-IP state, the state is in IP_STATUS only, or, if the module is deactivating. So it is necessary to process "AT+CIPSHUT" before user establishes a TCP/UDP connection with this command when the state is not IP INITIAL or IP

STATUS.

 When module is in multi-IP state, before this command is executed, it is necessary to process

"AT+CSTT, AT+CIICR, AT+CIFSR".

7.2.3 AT+CIPSEND Send Data Through TCP or UDP Connection

AT+CIPSEND Send Data Through TCP or UDP Connection

Test Command

AT+CIPSEND=?

Read Command

AT+CIPSEND?

1) For single IP connection (+CIPMUX=0)

+CIPSEND: <length>

2) For multi IP connection (+CIPMUX=1)

+CIPSEND: (0-5),<length>

1) For single IP connection (+CIPMUX=0)

+CIPSEND: <size>

2) For multi IP connection (+CIPMUX=1) www.simcom.com 181 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

1) If single IP connection

(+CIPMUX=0)

AT+CIPSEND=<length>

2) If multi IP connection

(+CIPMUX=1)

AT+CIPSEND=<n>[,<length

>] response">", then tap data for send

+CIPSEND: <n>,<size>

Response

This Command is used to send changeable length data

If single IP is connected (+CIPMUX=0)

If connection is not established or module is disconnected:

If error is related to ME functionality:

+CME ERROR <err>

If sending is successful:

When +CIPQSEND=0

SEND OK

When +CIPQSEND=1

DATA ACCEPT: <length>

If sending fails:

SEND FAIL

If multi IP connection is established (+CIPMUX=1)

If connection is not established or module is disconnected:

If error is related to ME functionality:

+CME ERROR <err>

If sending is successful:

When +CIPQSEND=0

<n>,SEND OK

When +CIPQSEND=1

DATA ACCEPT: <n>,<length>

If sending fails:

<n>,SEND FAIL

Response

This Command is used to send changeable length data.

If single IP connection is established (+CIPMUX=0)

If connection is not established or module is disconnected: Execution Command

1)If single IP connection If error is related to ME functionality:

(+CIPMUX=0)

AT+CIPSEND

2)If multi IP connection

+CME ERROR <err>

If sending is successful:

When +CIPQSEND=0

SEND OK

(+CIPMUX=1)

AT+CIPSEND=<n> response">", then tap data for send, tap CTRL+Z to send, tap ESC to cancel the operation

When +CIPQSEND=1

DATA ACCEPT: <length>

If sending fails:

SEND FAIL

If multi IP connection is established (+CIPMUX=1)

If connection is not established or module is disconnected:

If error is related to ME functionality:

+CME ERROR <n>,<err> www.simcom.com 182 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

If sending is successful:

When +CIPQSEND=0

<n>,SEND OK

When +CIPQSEND=1

DATA ACCEPT: <n>,<length>

If sending fails:

<n>,SEND FAIL

When mode is multi-IP state, the max response time75 seconds.

When mode is single state, and the state is IP INITIAL, the max response time is 160 seconds.

NO_SAVE

When +CIPQSEND=0 and the remote server no response, after 645 seconds, "CLOSE" will be reported.

Defined Values

<n> A numeric parameter which indicates the connection number

<size>

<length>

A numeric parameter which indicates the data length sent at a time.

The value of < size > is 1460 if the connection is successful; otherwise

< size > is 0.

A numeric parameter which indicates the length of sending data, it must be less than <size>.

Example

AT+CIPSEND=?

+CIPSEND: <length>

AT+CIPSEND?

+CIPSEND: 0

NOTE

 The data length which can be sent depends on network status.

 Set the time that send data automatically with the command of AT+CIPATS.

 Only send data at the status of established connection .

www.simcom.com 183 / 331

SIM7020 Series_AT Command Manual_V1.05

7.2.4 AT+CIPQSEND Select Data Transmitting Mode

AT+CIPQSEND Select Data Transmitting Mode

Test Command

AT+CIPQSEND=?

Read Command

AT+CIPSEND?

Write Command

AT+CIPQSEND=<n>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<n>

Response

+CIPQSEND: (0,1)

Response

+CIPQSEND: <n>

Response

NO_SAVE

0 Normal mode. When the server receives TCP data, it will response

SEND OK .

1 Quick send mode. When the data is sent by module, it will response

DATA ACCEPT: <length> (For single IP connection (+CIPMUX=0)) or

DATA ACCEPT: <n>,<length> (For multi IP connection (+CIPMUX=1)) while not responding SEND OK .

Example

AT+CIPQSEND=?

+CIPQSEND: (0,1)

AT+CIPSEND?

+CIPSEND: 0

OK www.simcom.com 184 / 331

SIM7020 Series_AT Command Manual_V1.05

7.2.5 AT+CIPACK Query Previous Connection Data Transmitting State

AT+CIPACK Query Previous Connection Data Transmitting State

Test Command

AT+CIPACK=?

Response

Write Command

If in multi IP connection

(+CIPMUX=1)

Response

+CIPACK: <txlen>,<acklen>,<nacklen>

AT+CIPACK=<n> OK

Execution Command

If in single IP connection +CIPACK: <txlen>,<acklen>,<nacklen>

(+CIPMUX=0)

Response

AT+CIPACK OK

Parameter Saving Mode

Max Response Time

NO_SAVE

Reference

Defined Values

<n>

<txlen>

<acklen>

<nacklen>

A numeric parameter which indicates the connection number

The data amount which has been sent

The data amount confirmed successfully by the server

The data amount without confirmation by the server

Example

AT+CIPACK=?

7.2.6 AT+CIPCLOSE Close TCP or UDP Connection

AT+CIPCLOSE Close TCP or UDP Connection

Test Command

AT+CIPCLOSE=?

Write Command

1) If single IP connection

(+CIPMUX=0)

AT+CIPCLOSE=<n>

Response

1) For single IP connection (+CIPMUX=0)

CLOSE OK

2) For multi IP connection (+CIPMUX=1) www.simcom.com 185 / 331

SIM7020 Series_AT Command Manual_V1.05

2) If multi IP connection

(+CIPMUX=1)

AT+CIPCLOSE=<id>[,<n>]

Execution Command

AT+CIPCLOSE

Parameter Saving Mode

Max Response Time

<id>,CLOSE OK

Response

If close is successfully:

CLOSE OK

If close fails:

ERROR

NO_SAVE

Reference

Defined Values

<n>

<id>

Close type

0 Slow close

1 Quick close

A numeric parameter which indicates the connection number

Example

AT+CIPCLOSE=?

NOTE

 AT+CIPCLOSE only closes connection at corresponding status of TCP/UDP stack. To see the status use AT+CIPSTATUS command. Status should be:

TCP CONNECTING, UDP CONNECTING, SERVER LISTENING or CONNECT OK in single-connection mode (see < state > parameter);

CONNECTING or CONNECTED in multi-connection mode (see < client state >);

OPENING or LISTENING in multi-connection mode (see < server state >).

Otherwise it will return ERROR.

7.2.7 AT+CIPSHUT Deactivate GPRS PDP Context

AT+CIPSHUT Deactivate GPRS PDP Context www.simcom.com 186 / 331

SIM7020 Series_AT Command Manual_V1.05

Test Command

AT+CIPSHUT=?

Execution Command

AT+CIPSHUT

Response

If close is successful:

SHUT OK

If close fails:

ERROR

NO_SAVE

65 seconds

Parameter Saving Mode

Max Response Time

Reference

Example

AT+CIPSHUT=?

NOTE

 If this command is executed in multi-connection mode, all of the IP connection will be shut.

 User can close GPS PDP context by AT+CIPSHUT. After it is closed, the status is IP INITIAL.

 If "+PDP: DEACT" URC is reported which means the GPRS is released by the network, then user still needs to execute "AT+CIPSHUT" command to make PDP context come back to original state.

7.2.8 AT+CLPORT Set Local Port

AT+CLPORT Set Local Port

Test Command

AT+CLPORT=?

Read Command

AT+CLPORT?

Response

1) For single IP connection (+CIPMUX=0)

+CLPORT: ("TCP","UDP"),(0-65535)

2) For multi IP connection (+CIPMUX=1)

+CLPORT: (0-5),("TCP","UDP"),(0-65535)

Response

1) For single IP connection (+CIPMUX=0)

+CLPORT: <TCP port>,<UDP port> www.simcom.com 187 / 331

SIM7020 Series_AT Command Manual_V1.05

2) For multi IP connection (+CIPMUX=1)

+CLPORT: 0,<TCP port>,<UDP port>

+CLPORT: 1,<TCP port>,<UDP port>

+CLPORT: 2,<TCP port>,<UDP port>

+CLPORT: 3,<TCP port>,<UDP port>

+CLPORT: 4,<TCP port>,<UDP port>

+CLPORT: 5,<TCP port>,<UDP port>

Write Command

1) For single IP connection

(+CIPMUX=0)

Response

If set fail

AT+CLPORT=<mode>,<port

2) For multi IP connection

ERROR

(+CIPMUX=1)

AT+CLPORT=<n>,<mode>,< port>

Parameter Saving Mode NO_SAVE

Max Response Time -

Reference

Defined Values

<n>

<mode>

<port>

Example

AT+CLPORT=?

+CLPORT: ("TCP","UDP"),(0-65535)

0..5 A numeric parameter which indicates the connection number this used in multi IP connection

A string parameter which indicates the connection type

"TCP" TCP local port

"UDP" UDP local port

A numeric parameter which indicates the local port. A port can be dynamically allocated a port. If users want to set a port, the value is

1-65535.

0-65535 Port number www.simcom.com 188 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CLPORT?

+CLPORT: 0,0

NOTE

 This command will be effective when module is set as a client.

7.2.9 AT+CSTT Start Task and Set APN,USER NAME,PASSWORD

AT+CSTT Start Task and Set APN,USER NAME,PASSWORD

Test Command

AT+CSTT=?

Read Command

AT+CSTT?

Write Command

AT+CSTT=<apn>,<user name>,<password>

Parameter Saving Mode

Response

+CSTT: "APN","USER","PWD"

Response

+CSTT: <apn>,<user name>,<password>

Response

If set fail

ERROR

NO_SAVE

Max Response Time

Execution Command

AT+CSTT

Response

OK or

ERROR

Reference

Defined Values

<apn>

<user name>

<password>

A string parameter which indicates the GPRS access point name. The max length is 32 bytes.

Default value is " ctnb " .(option)

A string parameter which indicates the GPRS user name. The max length is 32 bytes.(option)

A string parameter which indicates the GPRS password. The max www.simcom.com 189 / 331

SIM7020 Series_AT Command Manual_V1.05 length is 32 bytes.(option)

Example

AT+CSTT=?

+CSTT: "APN","USER","PWD"

AT+CSTT?

+CSTT: "","",""

NOTE

 The write command and execution command of this command is valid only at the state of IP

INITIAL. After this command is executed, the state will be changed to IP START.

7.2.10 AT+CIICR Bring Up Wireless Connection

AT+CIICR Bring Up Wireless Connection

Test Command

AT+CIICR=?

Execution Command

AT+CIICR

Parameter Saving Mode

Max Response Time

Response

If bring up fail

ERROR

NO_SAVE

85 seconds

Reference

Example

AT+CIICR=?

OK www.simcom.com 190 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 AT+CIICR only activates moving scene at the status of IP START, after operating this Command is executed, the state will be changed to IP CONFIG.

 After module accepts the activated operation, if it is activated successfully, module state will be changed to IP GPRSACT, and it responds OK, otherwise it will respond ERROR .

7.2.11 AT+CIFSR Get Local IP Address

AT+CIFSR Get Local IP Address

Test Command

AT+CIFSR=?

Execution Command

AT+CIFSR

Parameter Saving Mode

Response

<IP address>

If get fail

ERROR

NO_SAVE

Max Response Time -

Reference

Defined Values

<IP address> A string parameter which indicates the IP address assigned from

GPRS or CSD.

Example

AT+CIFSR=?

NOTE

 Only after PDP context is activated, local IP address can be obtained by AT+CIFSR, otherwise it will respond ERROR. To see the status use AT+CIPSTATUS command. Status should be:

IP GPRSACT, TCP CONNECTING, UDP CONNECTING, SERVER LISTENING, IP STATUS,

CONNECT OK, TCP CLOSING, UDP CLOSING, TCP CLOSED, UDP CLOSED in www.simcom.com 191 / 331

SIM7020 Series_AT Command Manual_V1.05 single-connection mode (see <state> parameter);

IP STATUS, IP PROCESSING in multi-connection mode (see <state> parameter).

7.2.12 AT+CIPSTATUS Query Current Connection Status

AT+CIPSTATUS Query Current Connection Status

Test Command

AT+CIPSTATUS=?

Response

Write Command

AT+CIPSTATUS=<n>

Response

If multi IP connection mode +CIPSTATUS:

(+CIPMUX=1) <n>,<bearer>,<TCP/UDP>,<IPaddress>,<port>,<client st ate>

Execution Command

AT+CIPSTATUS

Response

1 ） If in single connection mode (+CIPMUX=0)

STATE: <state>

2) If in multi-connection mode (+CIPMUX=1)

STATE: <state>

If the module is set as server

S: 0,<bearer>,<port>,<server state>

If the module is set as client

C: <n>,<bearer>,<TCP/UDP>,<IP address>,<port>,<client state>

Parameter Saving Mode NO_SAVE

- Max Response Time

Reference

Defined Values

<n>

<bearer>

<server state>

<client state>

0-5 A numeric parameter which indicates the connection number

1 GPRS bearer, default is null

Server state

OPENING

LISTENING

CLOSING

Client state www.simcom.com 192 / 331

SIM7020 Series_AT Command Manual_V1.05

<server state>

INITIAL

CONNECTING

CONNECTED

REMOTE CLOSING

CLOSING

CLOSED

A string parameter which indicates the progress of connecting

0 IP INITIAL

1 IP START

2 IP CONFIG

3 IP GPRSACT

4 IP STATUS

5 TCP CONNECTING/UDP CONNECTING

/SERVER LISTENING

6 CONNECT OK

7 TCP CLOSING/UDP CLOSING

8 TCP CLOSED/UDP CLOSED

9 PDP DEACT

In Multi-IP state:

0 IP INITIAL

1 IP START

2 IP CONFIG

3 IP GPRSACT

4 IP STATUS

5 IP PROCESSING

9 PDP DEACT

Example

AT+CIPSTATUS=?

7.2.13 AT+CDNSCFG Configure Domain Name Server

AT+CDNSCFG Configure Domain Name Server

Test Command

AT+CDNSCFG=?

Read Command

AT+CDNSCFG?

Response

+CDNSCFG: ("Primary DNS"),("Secondary DNS")

Response

PrimaryDns: <pri_dns> www.simcom.com 193 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CDNSCFG=<pri_dns>[,< sec_dns>]

Parameter Saving Mode

Max Response Time

SecondaryDns: <sec_dns>

Response

ERROR

NO_SAVE

Reference

Defined Values

<pri_dns>

<sec_dns>

A string parameter which indicates the IP address of the primary domain name server. Default value is 208.67.222.222.

A string parameter which indicates the IP address of the secondary domain name server. Default value is 0.0.0.0.

When you are on the network,< pri_dns >< sec_dns > will use the DNS server address from the network, and the default DNS server address if the network is not.

Example

AT+CDNSCFG=?

+CDNSCFG: ("Primary DNS"),("Secondary DNS")

AT+CDNSCFG?

PrimaryDns: 114.114.114.114

SecondaryDns: 119.29.29.29

7.2.14 AT+CDNSGIP Query the IP Address of Given Domain Name

AT+CDNSGIP Query the IP Address of Given Domain Name

Test Command

AT+CDNSGIP=?

Write Command

AT+CDNSGIP=<domain name>

Response

If query fail www.simcom.com 194 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<domain name>

<IPI>

ERROR

If successful, return:

+CDNSGIP: 1,<domain name>,<IP1>[,<IP2>]

If fail, return:

+CDNSGIP: 0,<dns error code>

NO_SAVE

<IP2>

<dns error code>

A string parameter which indicates the domain name.

A string parameter which indicates the first IP address corresponding to the domain name.

A string parameter which indicates the second IP address corresponding to the domain name.

A numeric parameter which indicates the error code

8 DNS COMMON ERROR

3 NETWORK ERROR

There are some other error codes as well.

Example

AT+CDNSGIP=?

7.2.15 AT+CIPHEAD Add an IP Head at the Beginning of a Package Received

AT+CIPHEAD Add an IP Head at the Beginning of a Package Received

Test Command

AT+CIPHEAD=?

Read Command

AT+CIPHEAD?

Write Command

AT+CIPHEAD=<mode>

Response

+CIPHEAD: ( list of supported < mode >s )

Response

+CIPHEAD: < mode >

Response

OK www.simcom.com 195 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time or

ERROR

NO_SAVE

Reference

Defined Values

< mode > A numeric parameter which indicates whether an IP header is added to the received data or not.

0 Not add IP header

1 Add IP header, the format is:

1) For single IP connection (+CIPMUX=0)

+IPD,<data length>:

2) For multi IP connection (+CIPMUX=1)

+RECEIVE,<n>,<data length>:

Example

AT+CIPHEAD=?

+CIPHEAD: (0-NO HEADER,1-ADD HEADER)

7.2.16 AT+CIPHEXS Show Data in Hex Mode of a Package Received

AT+CIPHEXS Show Data in Hex Mode of a Package Received

Read Command

AT+CIPHEXS?

Write Command

AT+CIPHEXS=<mode>

Parameter Saving Mode

Response

+CIPHEXS: < mode >

Response

OK or

ERROR

NO_SAVE

Max Response Time

Reference

- www.simcom.com 196 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

< mode > A numeric parameter which indicates whether show data in hex mode or not.

0-1 Not show data in hex mode.

2 Show data in hex mode.

While AT+CIPHEAD=1, if<mode>=1 or 2: add 0d0a at the end of data.

Example

AT+CIPHEXS?

+CIPHEXS: 0

NOTE

 The command is effective only if AT+CIPRXGET=0.

7.2.17 AT+CIFSREX Get Local IP Address

AT+CIFSREX Get Local IP Address

Test Command

AT+CIFSREX=?

Execution Command

AT+CIFSREX

Parameter Saving Mode

Max Response Time

Reference

Defined Values

Response

+CIFSREX: <IP address>

OK or

ERROR

NO_SAVE www.simcom.com 197 / 331

SIM7020 Series_AT Command Manual_V1.05

< IP address > A string parameter which indicates the IP address assigned from

GPRS or CSD.

Example

AT+CIFSREX=?

NOTE

 The command is effective only if AT+CIPRXGET=0.

 Only after PDP context is activated, local IP address can be obtained by AT+CIFSREX, otherwise it will respond ERROR. To see the status use AT+CIPSTATUS command. Status should be:

IP GPRSACT, TCP CONNECTING, UDP CONNECTING, SERVER LISTENING, IP STATUS,

CONNECT OK, TCP CLOSING, UDP CLOSING, TCP CLOSED, UDP CLOSED in single-connection mode (see <state> parameter);

IP STATUS, IP PROCESSING in multi-connection mode (see <state> parameter).

7.2.18 AT+CIPATS Set Auto Sending Time

AT+CIPATS Set Auto Sending Time

Test Command

AT+CIPATS=?

Read Command

AT+CIPATS?

Write Command

AT+CIPATS=<mode>[,<time

Parameter Saving Mode

Response

+CIPATS: ( list of supported <mode> s ),( list of supported <time >)

Response

+CIPATS: <mode>,<time>

Response

OK or

ERROR

NO_SAVE

Max Response Time

Reference

- www.simcom.com 198 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

< IP address >

< time >

A numeric parameter which indicates whether set timer when module is sending data

0 Not set timer when module is sending data

1 Set timer when module is sending data

A numeric parameter which indicates the seconds after which the data will be sent. If <mode> is 1, <time> is 1-100. otherwise <time> is 0 .

Example

AT+CIPATS=?

+CIPATS: (0-NOT AUTO SEND,1-AUTO SEND),(1-100)

AT+CIPATS=?

+CIPATS: 0,0

7.2.19 AT+CIPSPRT Set Prompt of ‘>’ When Module Sends Data

AT+CIPSPRT Set Prompt of ‘>’ When Module Sends Data

Test Command

AT+CIPSPRT=?

Read Command

AT+CIPSPRT?

Write Command

AT+CIPSPRT=<send prompt>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

Response

+CIPSPRT: ( list of supported <send prompt> s )

Response

+CIPSPRT: <send prompt>

Response

OK or

ERROR

NO_SAVE

- www.simcom.com 199 / 331

SIM7020 Series_AT Command Manual_V1.05

< send prompt > A numeric parameter which indicates whether to echo prompt ‘>’ after module issues AT+CIPSEND command.

0 It shows "send ok" but does not prompt echo ‘>’ when sending is successful.

1 It prompts echo ‘>’ and shows "send ok" when sending is successful.

2 It neither prompts echo ‘>’ nor shows "send ok" when sending is successful.

Example

AT+CIPSPRT=?

+CIPSPRT: (0,1,2)

AT+CIPSPRT?

+CIPSPRT: 1

7.2.20 AT+CIPCSGP Set CSD or GPRS for Connection Mode

AT+CIPCSGP Set CSD or GPRS for Connection Mode

Test Command

AT+CIPCSGP=?

Read Command

AT+CIPCSGP?

Write Command

AT+CIPCSGP=<mode>[,(<a pn>,<user name>,<password>),(<dial number>,<user name>,<password>,<rate>)]

Parameter Saving Mode

Response

+CIPCSGP: 0-CSD,DIALNUMBER,USER NAME,PASSWORD,

RATE(0-3)

+CIPCSGP: 1-GPRS,APN,USER NAME,PASSWORD

Response

+CIPCSGP: <mode>,<apn>,<user name>,<password>[,<rate>]

Response

OK or

ERROR

NO_SAVE www.simcom.com 200 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time

Reference

Defined Values

< mode >

< apn >

< use name >

< password >

< dial number >

< user name >

< password >

< rate >

A numeric parameter which indicates the wireless connection mode

0 Set CSD as wireless connection mode

1 Set GPRS as wireless connection mode

A string parameter which indicates the access point name

A string parameter which indicates the user name

A string parameter which indicates the password CSD parameters.

A string parameter which indicates the CSD dial numbers

A string parameter which indicates the CSD user name

A string parameter which indicates the CSD password

A numeric parameter which indicates the CSD connection rate

0 2400

1 4800

2 9600

3 14400

Example

AT+CIPSPRT=?

+CIPSPRT: (0,1,2)

AT+CIPSPRT?

+CIPSPRT: 1

7.2.21 AT+CIPSRIP Show Remote IP Address and Port When Received Data

AT+CIPSRIP Show Remote IP Address and Port When Received Data

Test Command

AT+CIPSRIP=?

Read Command

Response

+CIPSRIP: ( list of supported <mode> s )

Response www.simcom.com 201 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CIPSRIP?

Write Command

AT+CIPSRIP=<mode>

+CIPSRIP : <mode>

Response

OK or

ERROR

NO_SAVE Parameter Saving Mode

Max Response Time

Reference

Defined Values

< mode > A numeric parameter which shows remote IP address and port.

0 Do not show the prompt

1 Show the prompt, the format is as follows:

1) For single IP connection (+CIPMUX=0)

+RECV FROM: <IP ADDRESS>:<PORT>

2) For multi IP connection (+CIPMUX=1)

+RECEIVE,<n>,<data length>,<IP ADDRESS>:<PORT>

Example

AT+CIPSRIP=?

+CIPSRIP: (0,1)

AT+CIPSRIP?

+CIPSRIP: 0

7.2.22 AT+CIPSHOWTP Display Transfer Protocol in IP Head When Received Data

AT+CIPSHOWTP Display Transfer Protocol in IP Head When Received Data

Test Command

AT+CIPSHOWTP=?

Response

+CIPSHOWTP: ( list of supported <mode> s )

OK www.simcom.com 202 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CIPSHOWTP?

Write Command

AT+CIPSHOWTP=<mode>

Parameter Saving Mode

Max Response Time

Response

+CIPSHOWTP: <mode>

Response

OK or

ERROR

NO_SAVE

Reference

Defined Values

< mode > A numeric parameter which indicates whether to display transfer protocol in IP header to received data or not

0 Not display transfer protocol

1 Display transfer protocol, the format is "+IPD,<data size>,<TCP/UDP>:<data>"

Example

AT+CIPSHOWTP=?

+CIPSHOWTP: (0,1)

AT+CIPSHOWTP?

+CIPSHOWTP: 0

NOTE

 This command will be effective only in single connection mode (+CIPMUX=0).

 Only when +CIPHEAD is set to 1, the setting of this command will work. www.simcom.com 203 / 331

SIM7020 Series_AT Command Manual_V1.05

7.2.23 AT+CIPUDPMODE UDP Extended Mode

AT+CIPUDPMODE UDP Extended Mode

Test Command

AT+CIPUDPMODE=?

Read Command

AT+CIPUDPMODE?

Write Command

1) For single IP connection

(+CIPMUX=0)

AT+CIPUDPMODE=<mode>[

,<IP address>,<Port>]

2) For multi IP connection

(+CIPMUX=1)

AT+CIPUDPMODE=<n>,<mo de>[,<IP address>,<Port>]

Parameter Saving Mode

Response

1) For single IP connection (+CIPMUX=0)

+CIPUDPMODE: (0-2),("(0-255).(0-255).(0-255).(0-255)"),(0-65535)

2) For multi IP connection (+CIPMUX=1)

+CIPUDPMODE:(0-5),(0-2),("(0-255).(0-255).(0-255).(0-255)"),(0-65

535)

Response

1) For single IP connection (+CIPMUX=0)

+CIPUDPMODE: <mode>[,<IP address>,<Port>]

2) For multi IP connection (+CIPMUX=1)

+CIPUDPMODE: 0,<mode>[,<IP address>,<Port>]

+CIPUDPMODE: 1,<mode>[,<IP address>,<Port>]

+CIPUDPMODE: 2,<mode>[,<IP address>,<Port>]

+CIPUDPMODE: 3,<mode>[,<IP address>,<Port>]

+CIPUDPMODE: 4,<mode>[,<IP address>,<Port>]

+CIPUDPMODE: 5,<mode>[,<IP address>,<Port>]

Response

OK or

ERROR

NO_SAVE

- Max Response Time

Reference

Defined Values

< n > A numeric parameter which indicates the connection number.

www.simcom.com 204 / 331

SIM7020 Series_AT Command Manual_V1.05

0-5

< mode >

< IP address >

Mode type

0 UDP Normal Mode

1 UDP Extended Mode

2 Set UDP address to be sent

A string parameter which indicates remote IP address

< port > Remote port.

Default value is 0, if users want to set a port; the value is

1-65535.

Example

AT+CIPUDPMODE=?

+CIPUDPMODE: (0-2),("(0-255).(0-255).(0-255).(0-255)"),(0-65535)

AT+CIPUDPMODE?

+CIPUDPMODE: 0

7.2.24 AT+CIPRXGET Get Data from Network Manually

AT+CIPRXGET Get Data from Network Manually

Test Command

AT+CIPRXGET=?

Read Command

AT+CIPRXGET?

Write Command

1) If single IP connection

(+CIPMUX=0)

Response

If single IP connection (+CIPMUX=0)

+CIPRXGET: ( list of supported <mode> s ),( list of supported

< reqlength >)

If multi IP connection (+CIPMUX=1)

+CIPRXGET: ( list of supported <mode> s ),( list of supported

<id> s ),( list of supported < reqlength >)

Response

+CIPRXGET: <mode>

Response

OK or www.simcom.com 205 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CIPRXGET=<mode>[,<r eqlength>]

ERROR

1)For single IP connection

If "AT+CIPSRIP=1" is set, IP address and port are contained.

2) If multi IP connection if <mode>=1

(+CIPMUX=1) +CIPRXGET: 1[,<IP ADDRESS>:<PORT>]

AT+CIPRXGET=<mode>[,<i d>[,<reqlength>]] if <mode> = 2

+CIPRXGET: 2,<reqlength>,<cnflength>[,<IP ADDRESS>:<P

ORT>]

1234567890…

OK if <mode> = 3

+CIPRXGET: 3,<reqlength>,<cnflength>[,<IP ADDRESS>:<P

ORT>]

5151…

OK if <mode>=4

+CIPRXGET: 4,<cnflength>

2)For multi IP connection

If "AT+CIPSRIP=1" is set, IP address and port is contained. if <mode>=1

+CIPRXGET: 1,<id>[,<IP ADDRESS>:<PORT>] if <mode> = 2

+CIPRXGET: 2,<id>,<reqlength>,<cnflength>[,<IP ADDRESS>:<P

ORT>]

1234567890…

OK if <mode> = 3

+CIPRXGET: 3,<id>,<reqlength>,<cnflength>[,<IP ADDRESS>:<P

ORT>]

5151…

OK if <mode>=4

+CIPRXGET: 4,<id>,<cnflength>

If error is related to ME functionality:

+CME ERROR: <err>

Parameter Saving Mode NO_SAVE

Max Response Time - www.simcom.com 206 / 331

SIM7020 Series_AT Command Manual_V1.05

Reference

Defined Values

< mode >

< id >

< reqlength >

0 Disable getting data from network manually, the module is set to normal mode, data will be pushed to TE directly.

1 Enable getting data from network manually.

2 The module can get data, but the length of output data can not exceed 1460 bytes at a time.

3 Similar to mode 2, but in HEX mode, which means the module can get 730 bytes maximum at a time.

4 Query how many data are not read with a given ID.

A numeric parameter which indicates the connection number

Requested number of data bytes (1-1460 bytes)to be read

< cnflength > Confirmed number of data bytes to be read, which may be less than

<length>. 0 indicates that no data can be read.

Example

AT+CIPRXGET=?

+CIPRXGET: (0-4),(1-1460)

AT+CIPRXGET?

+CIPRXGET: 0

NOTE

 To enable this function, parameter <mode> must be set to 1 before connection.

7.2.25 AT+CIPTKA Set TCP Keepalive Parameters

AT+CIPTKA Set TCP Keepalive Parameters

Test Command

AT+CIPTKA=?

Response

If single IP connection (+CIPMUX=0) www.simcom.com 207 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CIPTKA?

Write Command

1)If single IP connection

(+CIPMUX=0)

AT+CIPTKA=<mode>[,<kee pIdle>[,<keepInterval>[,<kee pCount>]]]

2) If multi IP connection

(+CIPMUX=1)

AT+CIPTKA=<n>,<mode>[,< keepIdle>[,<keepInterval>[,< keepCount>]]]

Parameter Saving Mode

Max Response Time

Reference

Defined Values

< n >

< mode >

< keepIdle >

+CIPTKA: (list of supported <mode> s) , (list of supported

<keepIdle> s) , (list of supported <keepInterval> ) , (list of supported

<keepCount> s)

If multi IP connection (+CIPMUX=1)

+CIPTKA: (list of supported <id> s) , (list of supported <mode> s) , (list of supported <keepIdle> s) , (list of supported <keepInterval> ) , (list of supported <keepCount> s)

Response

If single IP connection (+CIPMUX=0)

+CIPTKA: <mode>[,<keepIdle>,<keepInterval>,<keepCount>]

If multi IP connection (+CIPMUX=1)

+CIPTKA: 0,<mode>[,<keepIdle>,<keepInterval>,<keepCount>]

+CIPTKA: 1,<mode>[,<keepIdle>,<keepInterval>,<keepCount>]

+CIPTKA: 2,<mode>[,<keepIdle>,<keepInterval>,<keepCount>]

+CIPTKA: 3,<mode>[,<keepIdle>,<keepInterval>,<keepCount>]

+CIPTKA: 4,<mode>[,<keepIdle>,<keepInterval>,<keepCount>]

+CIPTKA: 5,<mode>[,<keepIdle>,<keepInterval>,<keepCount>]

Response

If error is related to ME functionality:

ERROR

NO_SAVE

A numeric parameter which indicates the connection

0-5

Set TCP keepalive option.

0 Disable TCP keep alive mechanism

1 Enable TCP keep alive mechanism

Integer type; Idle time (in second) before TCP send the initial www.simcom.com 208 / 331

SIM7020 Series_AT Command Manual_V1.05

< keepInterval >

< keepCount > keepalive probe.

30-7200 Default: 7200

Interval time (in second) between keepalive probes retransmission.

30-600 Default: 75

Integer type; Max number of keepalive probes to be sent.

1-9 Default: 9

Example

AT+CIPTKA=?

+CIPTKA: (0-1),(30-7200),(30-600),(1-9)

AT+CIPTKA?

+CIPTKA: 0

NOTE

 If < keepIdle >,< keepInterval > and < keepCount > is not set, module will use the default values when < mode >=1.

7.2.26 AT+CIPMODE Open Transparent Mode

AT+CIPMODE Open Transparent Mode

Test Command

AT+CIPMODE=?

Read Command

AT+CIPMODE?

Execution Command

AT+CIPMODE=<mode>

Response

+CIPMODE: (0-NORMAL MODE,1-TRANSPARENT MODE)

Response

+CIPMODE: <mode>

Response

If set fail

ERROR www.simcom.com 209 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

NO_SAVE

Reference

Defined Values

< mode > Transparent mode

0 Disable transparent mode

1 Enable transparent mode

Example

AT+CIPMODE=?

+CIPMODE: (0-NORMAL MODE,1-TRANSPARENT MODE)

AT+CIPMODE?

+CIPMODE: 0

NOTE

 The execution command of this command is valid only activates moving scene at the status of

IP_INITIAL or IP_CLOSED

 The execution command of this command is valid only for single connection

7.2.27 AT+CIPCHAN Enter Transparent Mode

AT+CIPCHAN Enter Transparent Mode

Test Command

AT+CIPCHAN=?

Execution Command

AT+CIPCHAN

Parameter Saving Mode

Response

CONNECT or

ERROR

NO_SAVE www.simcom.com 210 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time -

Reference

Defined Values

< mode > Transparent mode

0 Disable transparent mode

1 Enable transparent mode

Example

AT+CIPCHAN=?

NOTE

 This command is executed in single-connection mode.

 Before execute this command, "AT+CIPMODE=1" must be executed and the connection must be established successfully.

 When module is in transparent mode, if user tapped "+++", module would exit transparent mode.

 When user tapped "+++" to exit transparent mode, user can execute the command of "ATO" to return transparent mode. www.simcom.com 211 / 331

SIM7020 Series_AT Command Manual_V1.05

8 AT Commands for HTTP(S)

Application

8.1 Overview of AT Commands for HTTP

(

S) Application

Command

AT+CHTTPCREATE

Description

Create a HTTP client instance

AT+CHTTPCREATEEXT Create a HTTPS client instance by multi packages for a long size command

Establish the HTTP(S) connection AT+CHTTPCON

AT+CHTTPDISCON

AT+CHTTPDESTROY

AT+CHTTPSEND

AT+CHTTPSENDEXT

Close the HTTP(S) connection

Destroy the HTTP(S) client instance

Send HTTP(S) package

Send HTTP(S) package by multi packages for a long size command

AT+CHTTPPARA

AT+CHTTPTOFS

Set parameter for AT command of AT+CHTTPSEND

Download File to Module System

AT+CHTTPCLRMULCRTBUF Clear multi create buffer of AT+CHTTPCREATEEXT

AT+CHTTPCLRMULSNDBUF Clear multi send buffer of AT+CHTTPSENDEXT

AT+CHTTPRESUMESEND

+CHTTPNMIH

+CHTTPNMIC

+CHTTPERR

+CHTTPTOFS

+CHTTPTOFSOK

Set resume send package or not when HTTP(S) disconnected

Header of the response from host

Content of the response from host

HTTP(S) client connection error indicator

HTTP(S) download indicate from host

HTTP(S) download finished indicate

8.2 Detailed Descriptions of AT Commands for HTTP(S) Application

8.2.1 AT+CHTTPCREATE Create a HTTP Client Instance

AT+CHTTPCREATE Create a HTTP Client Instance www.simcom.com 212 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CHTTPCREATE?

Write Command

AT+CHTTPCREATE=<host>[

,<auth_user>,<auth_passw ord>

Parameter Saving Mode

Response

+CHTTPCREATE: <httpclient_id>,<state>,<host>[<CR><LF>

+CHTTPCREATE: <httpclient_id>,<state>,<host>

[...]]

Response

Create an HTTP or HTTPS client instance and set configuration. If the

<host> is start with "https://", our device will create an HTTPS client.

+CHTTPCREATE: <httpclient_id>

OK or

ERROR

NO_SAVE

Max Response Time

Reference

Defined Values

<host>

HTTP server host

<auth_user>

<auth_password>

Authorization name [option]

Authorization password [option]

<httpclient_id> An indicator of HTTP client instance created by the command.

<state> The create state of the httpclient_id

1 Successfully

0 Failed

Example

AT+CHTTPCREATE?

+CHTTPCREATE: 0,0,(null)

+CHTTPCREATE: 1,0,(null)

+CHTTPCREATE: 2,0,(null)

+CHTTPCREATE: 3,0,(null)

+CHTTPCREATE: 4,0,(null)

NOTE

 All optional parameter should be exist or not exist in one command. www.simcom.com 213 / 331

SIM7020 Series_AT Command Manual_V1.05

8.2.2 AT+CHTTPCREATEEXT Create a HTTPS Client Instance by Multi Packages for a Long Size Command

AT+CHTTPCREATEEXT Create a HTTPS Client Instance by Multi Packages for a

Long Size Command

Read Command Response

AT+CHTTPCREATEEXT?

Write Command

AT+CHTTPCREATEEXT=<fl ag>,<total_len>,<len>,<host

>[<auth_user>,<auth_pass word>,<server_cert_len>,<s erver_cert>,<client_cert_len

>,<client_cert>,<client_pk_l en>,<client_pk>]

Parameter Saving Mode

+CHTTPCREATEEXT: <httpclient_id>,<state>,<host>[<CR><LF>

+CHTTPCREATEEXT: <httpclient_id>,<state>,<host>

[...]]

Response

Create an HTTP or HTTPS client instance and set configuration. If the

<host> is start with "https://", our device will create an HTTPS client.

+CHTTPCREATEEXT: <httpclient_id>

OK or

ERROR

NO_SAVE

- Max Response Time

Reference

Defined Values

<flag>

<total_len>

<len>

<host>

<auth_user>

<auth_password>

<server_cert_len>

<server_cert>

<client_cert_len>

<client_cert>

<client_pk_len>

<client_pk>

1 Means there are more packages,

0 Means this package is the last one

The total length of the command

The length of current package

HTTP server host

Authorization name [option]

Authorization password [option]

Server certification length, for https [option]

Server certification, for https [option]

Client certification length, for https [option]

Client certification, for https [option]

Client private key length, for https [option]

Client private key, for https [option] www.simcom.com 214 / 331

SIM7020 Series_AT Command Manual_V1.05

<httpclient_id> An indicator of HTTP client instance created by the command.

<state> The create state of the httpclient_id

1 Successfully

0 Failed

Example

AT+CHTTPCREATEEXT?

+CHTTPCREATEEXT: 0,0,(null)

+CHTTPCREATEEXT: 1,0,(null)

+CHTTPCREATEEXT: 2,0,(null)

+CHTTPCREATEEXT: 3,0,(null)

+CHTTPCREATEEXT: 4,0,(null)

NOTE

 All optional parameter should be exist or not exist in one command.

8.2.3 AT+CHTTPCON Establish the HTTP(S) Connection

AT+CHTTPCON Establish the HTTP(S) Connection

Test Command

AT+CHTTPCON=?

Read Command

AT+CHTTPCON?

Write Command

AT+CHTTPCON=<httpclient

_id>

Parameter Saving Mode

Response

+CHTTPCON: (0-4)

Response

+CHTTPCON: <httpclient_id>,<con_state>,<host>[<CR><LF>

+CHTTPCON: <httpclient_id>,<con_state>,<host>

[...]]

Response

Use the created HTTP instance to connect to target host.

OK or

ERROR

NO_SAVE

Max Response Time

Reference

- www.simcom.com 215 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<httpclient_id>

<con_state>

<host>

The indicator of HTTP client instance created by the

AT+CHTTPCREATE command.

The connected state of the httpclient_id

1 OK

0 FAIL

HTTP server host

Example

AT+CHTTPCON=?

+CHTTPCON: (0-4)

AT+CHTTPCON?

+CHTTPCON: 0,0,(null)

+CHTTPCON: 1,0,(null)

+CHTTPCON: 2,0,(null)

+CHTTPCON: 3,0,(null)

+CHTTPCON: 4,0,(null)

NOTE

 AT+CHTTPCREATE should be set before this command.

8.2.4 AT+CHTTPDISCON Close the HTTP(S) Connection

AT+CHTTPDISCON Close the HTTP(S) Connection

Test Command

AT+CHTTPDISCON=?

Write Command

Response

+ CHTTPDISCON : (0-4)

Response www.simcom.com 216 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CHTTPDISCON=<httpcli ent_id>

Parameter Saving Mode

Use the created HTTP instance to disconnect the connection with host. After disconnected and before destroy the HTTP instance, you can use AT+CHTTPCON to connect it again.

OK or

ERROR

NO_SAVE

Max Response Time -

Reference

Defined Values

<httpclient_id> The indicator of HTTP client instance created by the

AT+CHTTPCREATE command.

Example

AT+CHTTPDISCON=?

+CHTTPDISCON: (0-4)

NOTE

 AT+CHTTPCON should be set before this command .

8.2.5 AT+CHTTPDESTROY Destroy the HTTP(S) Client Instance

AT+CHTTPDESTROY Destroy the HTTP(S) Client Instance

Test Command

AT+CHTTPDESTROY=?

Read Command

AT+CHTTPDESTROY?

Response

+CHTTPDESTROY: (0-4)

Response

+CHTTPDESTROY:

<httpclient_id>,<state>,<host>[<CR><LF>+CHTTPDESTROY:

<httpclient_id>,<state>,<host> www.simcom.com 217 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CHTTPDESTROY=<http client_id>

Parameter Saving Mode

[...]]

Response

Use the created HTTP instance to disconnect the connection with host.

OK or

ERROR

NO_SAVE

Max Response Time -

Reference

Defined Values

<httpclient_id>

<state>

The indicator of HTTP client instance created by the

AT+CHTTPCREATE command.

The create state of the httpclient_id

1 Successfully

0 Failed

HTTP server host <host>

Example

AT+CHTTPDESTROY=?

+CHTTPDESTROY: (0-4)

NOTE

 AT+CHTTPCREATE should be set before this command

8.2.6 AT+CHTTPSEND Send HTTP(S) Package

AT+CHTTPSEND Send HTTP(S) Package

Test Command Response www.simcom.com 218 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CHTTPSEND=?

Write Command

AT+CHTTPSEND=<httpclien t_id>,<method>,<path>[,<cu stomer_header>,<content_t ype>,<content_string>]

Parameter Saving Mode

+CHTTPSEND:

(0-4),(0-3),"path","http header","http content type","http content"

Response

OK or

ERROR

NO_SAVE

Max Response Time -

Reference

Defined Values

<httpclient_id>

<method>

<path>

The indicator of HTTP client instance created by the

AT+CHTTPCREATE command.

HTTP method

0 HTTPCLIENT_GET

1 HTTPCLIENT_POST

2 HTTPCLIENT_PUT

3 HTTPCLIENT_DELETE

The resource path on server, ex. " /html/login/index.html

" means the url full path is "<host>/html/login/index.html".

The string converted from customer header hex data. <customer_header>

<content_type> A string indicates the content type of the content, if the method is not

POST and PUT, it must be empty.

The string converted from content hex data. <content_string>

Example

AT+CHTTPSEND=?

+CHTTPSEND: (0-4),(0-3),"path","http header","http content type","http content"

NOTE

 AT+CHTTPCON should be set before this command www.simcom.com 219 / 331

SIM7020 Series_AT Command Manual_V1.05

8.2.7 AT+CHTTPSENDEXT Send HTTP(S) Package by Multi Packages for a Long

Size Command

AT+CHTTPSENDEXT Send HTTP(S) Package by Multi Packages for a Long Size

Command

Test Command Response

AT+CHTTPSENDEXT=?

Write Command

AT+CHTTPSENDEXT=<flag

>,<total_len>,<len>,<httpcli ent_id>,<method>,<path_le n>,<path>,<customer_head er_len>,<customer_header>

,<content_type_len>,<conte nt_type_len>,<content_strin g_len>,<content_string>

Parameter Saving Mode

+CHTTPSENDEXT:

(0-1),"total_len","current_len",(0-4),(0-3),"path_len","path",

"header_len","header","content_type_len","content_type","cont ent_string_len","content_string"

Response

OK or

ERROR

NO_SAVE

- Max Response Time

Reference

Defined Values

<flag>

<total_len>

<len>

<httpclient_id>

<method>

<path_len>

<path>

1 Means there are more packages

0 Means this package is the last one

The total length of the command

The length of current package

The indicator of HTTP client instance created by the

AT+CHTTPCREATE command.

HTTP method

0 HTTPCLIENT_GET

1 HTTPCLIENT_POST

2 HTTPCLIENT_PUT

3 HTTPCLIENT_DELETE length of path

The resource path on server, ex. " /html/login/index.html

" means the url full path is "<host>/html/login/index.html". www.simcom.com 220 / 331

SIM7020 Series_AT Command Manual_V1.05

<customer_header_len>

<customer_header>

Length of customer_header

The string converted from customer header hex data.

<content_type_len>

<content_type>

<content_string_len>

The length of Content_type

A string indicate the content type of the content, if the method is not

POST and PUT, it must be empty.

The length of Content_string

The string converted from content hex data. <content_string>

Example

AT+CHTTPSENDEXT=?

+CHTTPSENDEXT:

(0-1),"total_len","current_len",(0-4),(0-3),"path_len","path","header_len","header"," content_type_len","content_type","content_string_len","content_string"

NOTE

 AT+CHTTPCON should be set before this command

8.2.8 AT+CHTTPPARA Set Parameter for AT Command of AT+CHTTPSEND

AT+CHTTPPARA Set Parmeter for AT Command of AT+CHTTPSEND

Test Command

AT+CHTTPPARA=?

Read Command

AT+CHTTPPARA?

Write Command

AT+CHTTPPARA=<value>

Parameter Saving Mode

Max Response Time

Reference

Response

+CHTTPPARA: (0-1)

Response

+CHTTPPARA: <value>

Response

OK or

ERROR

AUTO_SAVE www.simcom.com 221 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<value> The parameter for sending

1 Can send AT+CHTTPSEND continuously

0 Can not send AT+CHTTPSEND continuously, until the server response

Example

AT+CHTTPPARA=?

+CHTTPPARA: (0-1)

AT+CHTTPPARA?

+CHTTPPARA: 0

NOTE

 Use this command for setting send parameter, so that you can send " AT+CHTTPSEND " continuously, and no care of the response.

8.2.9 AT+CHTTPTOFS Download File to Module System

AT+CHTTPTOFS Download File to Module System

Test Command

AT+CHTTPTOFS=?

Write Command

AT+CHTTPTOFS=<httpclien t_id>,<path>

Parameter Saving Mode

Response

+ CHTTPTOFS : (0-4),"path"

Response

Use the created HTTP instance to connect to target host.

OK or

ERROR

NO_SAVE www.simcom.com 222 / 331

SIM7020 Series_AT Command Manual_V1.05

Max Response Time

Reference

Defined Values

<httpclient_id>

<path>

The indicator of HTTP client instance created by the

AT+CHTTPCREATE command

The resource path on server, it should begin with "/". ex.

" /html/login/index.html

" means the url full path is

"<host>/html/login/index.html".

Example

AT+CHTTPTOFS=?

+CHTTPTOFS: (0-4),"path"

NOTE

 AT+CHTTPCON should be set before this command.

8.2.10 AT+CHTTPCLRMULCRTBUF Clear Multi Create Buffer of

AT+CHTTPCREATEEXT

AT+CHTTPCLRMULCRTBUF Clear Multi Create Buffer of AT+CHTTPCREATEEXT

Execution Command

AT+CHTTPCLRMULCRTBU

Parameter Saving Mode

Response

OK or

ERROR

NO_SAVE

Max Response Time -

Reference

NOTE

 Clear multi create buffer of AT+CHTTPCREATEEXT. When you do not AT+CHTTPCREATEEXT www.simcom.com 223 / 331

SIM7020 Series_AT Command Manual_V1.05 the last package, but you want to AT+CHTTPCREATEEXT the new command, you can

AT+CHTTPCLRMULCRTBUF.

8.2.11 AT+CHTTPCLRMULSNDBUF Clear Multi Send Buffer of AT+CHTTPSENDEXT

AT+CHTTPCLRMULSNDBUF Clear Multi Send Buffer of AT+CHTTPSENDEXT

Execution Command

AT+CHTTPCLRMULSNDBU

Parameter Saving Mode

Response

OK or

ERROR

NO_SAVE

Max Response Time -

Reference

NOTE

 Clear multi send buffer of AT+CHTTPSENDEXT. When you do not AT+CHTTPSENDEXT the last package, but you want to AT+CHTTPSENDEXT the new command, you can

AT+CHTTPCLRMULSNDBUF.

8.2.12 AT+CHTTPRESUMESEND Set Resume Send Package or not when HTTP(S)

Disconnected

AT+CHTTPRESUMESEND Set Resume Send Package or not when HTTP(S)

Disconnected

Test Command

AT+CHTTPRESUMESEND=

Response

+CHTTPRESUMESEND: (0-1)

Read Command

AT+CHTTPRESUMESEND?

Write Command

AT+CHTTPRESUMESEND=< value>

Response

+CHTTPRESUMESEND: <value>

Response

OK or www.simcom.com 224 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<value>

ERROR

AUTO_SAVE

Example

AT+CHTTPRESUMESEND=?

+CHTTPRESUMESEND: (0-1)

Resume send package or not when HTTP disconnected.

1 Can resume send packages by AT+CHTTPSENDEXT when HTTP disconnected

0 Cannot resume send packages by AT+CHTTPSENDEXT when

HTTP disconnected. Once HTTP disconnected, multi send buffer of

AT+CHTTPSENDEXT is cleared automatically, you should always

AT+CHTTPSENDEXT the first package

8.2.13 +CHTTPNMIH Header of the Response from Host

+CHTTPNMIH Header of the Response from Host

Response

The response from host has 2 parts. This is the header part and content part will follow this URC.

+CHTTPNMIH:

<httpclient_id>,<response_code>,<header_length>,<header>

Defined Values

<httpclient_id>

<response_code>

The indicator of HTTP client instance created by the

AT+CHTTPCREATE command

The HTTP response code

100 Continue

101 Switching Protocols

200 OK www.simcom.com 225 / 331

SIM7020 Series_AT Command Manual_V1.05

201 Created

202 Accepted

203 Non-Authoritative Information

204 No Content

205 Reset Content

206 Partial Content

300 Multiple Choices

301 Moved Permanently

302 Found

303 See Other

304 Not Modified

305 Use Proxy

307 Temporary Redirect

400 Bad Request

401 Unauthorized

402 Payment Required

403 Forbidden

404 Not Found

405 Method Not Allowed

406 Not Acceptable

407 Proxy Authentication Required

408 Request Time-out

409 Conflict

410 Gone

411 Length Required

412 Precondition Failed

413 Request Entity Too Large

414 Request-URI Too Large

415 Unsupported Media Type

416 Requested Range Not Satisfiable

417 Expectation Failed

500 Internal Server Error

501 Not Implemented

502 Bad Gateway

503 Service Unavailable

504 Gateway Time-out

505 HTTP Version not supported

The length (buffer size) of the header string

Header data of response

<header_length>

<header>

8.2.14 +CHTTPNMIC Content of The Response from Host www.simcom.com 226 / 331

SIM7020 Series_AT Command Manual_V1.05

+CHTTPNMIC Content of The Response from Host

Response

The response from host has 2 parts. This is the content part and follows by the header part URC. And there are multi content URC follow one header URC.

+CHTTPNMIC:

<httpclient_id>,<flag>,<total_length><content_package_len>,<co ntent_package_string>

Defined Values

<httpclient_id>

<flag>

<total_length>

The indicator of HTTP client instance created by the

AT+CHTTPCREATE command

The flag to indicate if there are more data of the HTTP content.

1 Means there are more packages

0 Means this package is the last one

The total length of the content. It is get from header "Content-Length: xxx", so if the response is not 200 OK, maybe the value is -1.

Content data length of current URC. <content_package_len>

<content_package_string> Content data string which is converted from content hex data. The length must be original content hex data size/2.

8.2.15 +CHTTPERR HTTP(S) Client Connection Error Indicator

+CHTTPERR HTTP Client Connection Error Indicator

Response

When the URC send, there is some error happen on the HTTP client.

Normally is TCP connection is disconnected.

+CHTTPERR: <httpclient_id>[,<error_code>]

Defined Values

<httpclient_id>

<error_code>

The indicator of HTTP client instance created by the

AT+CHTTPCREATE command

-1 Means disconnected

-2 Connection was closed by a remote host.

-3 An unknown error occurred.

-4 A protocol error occurred.

-5 Could not resolve the hostname.

-6 A URL parse error occurred. www.simcom.com 227 / 331

SIM7020 Series_AT Command Manual_V1.05

If the URC send out, the HTTP client will be disconnected automatically. If user want to send HTTP message to server, he must use AT+CHTTPCON command to connect.

8.2.16 +CHTTPTOFS HTTP(S) Download Indicate from Host

+CHTTPTOFS HTTP(S) Download Indicate from Host

Response

HTTP download progress indicate

+CHTTPTOFS: <httpclient_id>,<flag>,<content_len>,<len>

Defined Values

<httpclient_id>

<flag>

<content_len>

<len>

The indicator of HTTP(S) client instance created by the

AT+CHTTPCREATE command

The flag to indicate if there are more data of the HTTP content

1 Means there are more packages

0 Means this package is the last one

Total length of content data

The length of all downloaded content data

8.2.17 +CHTTPTOFSOK HTTP(S) Download Finished Indicate

+CHTTPTOFSOK HTTP Download Finished Indicate

Response

+CHTTPTOFSOK: <httpclient_id>,<contend_len>,<len>

Defined Values

<httpclient_id>

<content_len>

<len>

The indicator of HTTP client instance created by the

AT+CHTTPCREATE command

Total length of content data

The length of all downloaded content data www.simcom.com 228 / 331

SIM7020 Series_AT Command Manual_V1.05

9 AT Commands for PING

Application

9.1 Overview of AT Commands for PING Application

Command

AT+CIPPING

Description

Test IP network connectivity to a remote host

9.2 Detailed Descriptions of AT Commands for PING Application

9.2.1 AT+CIPPING Test IP Network Connectivity to A Remote Host

AT+CIPPING Test IP Network Connectivity to A Remote Host

Test Command

AT+CIPPING=?

Read Command

AT+CIPPING?

Write Command

AT+CIPPING=<IPaddr>[,<ret ryNum>[,<dataLen>[,<timeo ut>]]]

Response

+CIPPING: ( list of supported <retryNum> s ),( list of supported

< dataLen >s ),( list of supported < timeout >s )

Response

+CIPPING: <retryNum>,<dataLen>,<timeout>

Response

+CIPPING : <replyId>,<Ip

Address>,<replyTime>,<ttl>[<CR><LF>+CIPPING : <replyId>,<Ip

Address>,<replyTime>,<ttl>

[...]] or

BUSY (When previous command unfinished, AT+CIPPING again) or

ERROR www.simcom.com 229 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<IPaddr>

<retryNum>

- or

+CME ERROR: <err>

NO_SAVE

<dataLen>

<timeout>

<replyId>

<IP Address>

<replyTime>

IP address of the remote host, string type.

The number of Ping Echo Request to send

1-100 Default: 4

The length of Ping Echo Request data

0-5120 Default: 32

The timeout, in units of 100ms, waiting for a single Echo Reply

1-600 Default: 100(10 seconds)

Echo Reply number

IP Address of the remote host

Time, in units of 100ms, required to receive the response

<ttl> Time to live

Example

AT+CIPPING=?

+CIPPING: (1-100),(0-5120),(1-600)

AT+CIPPING?

+CIPPING: 4,32,100

NOTE

 Before sending PING Request the PDP context must be activated.

 When the Echo Request timeout expires (no reply received on time), the response will contains

< replyTime > setting to 100(default timeout) www.simcom.com 230 / 331

SIM7020 Series_AT Command Manual_V1.05

10 AT Commands for LwM2M

Application

10.1 Overview of AT Commands for LwM2M Application

Command

AT+CLMCONF

AT+CLMADDOBJ

AT+CLMDELOBJ

AT+CLMREAD

AT+CLMWRITE

AT+CLMEXECUTE

AT+CLMNOTIFY

AT+CLMDEL

+CLMOBSERVE

+CLMPARAMETER

+CLMERR

Description

Configure LwM2M instance and create the connection

Add LwM2M object

Delete LwM2M object

Read notification and command

Write notification and command

Execute notification and command

Notify data change

Delete LwM2M instance

Indicated an observe command

Indicated an observer's parameter

Indicated there are some errors

10.2 Detailed Descriptions of AT Commands for LwM2M Application

10.2.1 AT+CLMCONF Configure LwM2M Instance and Create the Connection

AT+CLMCONF Configure LwM2M Instance and Create the Connection

Write Command

AT+CLMCONF=<ip_addr>,< port>,<local_port>,<name>,

<domain>,<lifetime>[,<pski d>,<psk>][,<binding_mode>

]

Parameter Saving Mode

Response

+CLMCONF: <lwm2m_id>

NO_SAVE

Max Response Time - www.simcom.com 231 / 331

SIM7020 Series_AT Command Manual_V1.05

Reference

Defined Values

<ip_addr>

<port>

<local_port>

<name>

<domain>

<lifetime>

<pskid>

<psk>

<binding_mode>

String, LwM2M server IP address.

Integer, LwM2M server port.

Integer, local port.

String, Username for show in server.

String, specifies the type of packet data protocol:

IPv4 Internet Protocol (IETF STD 5)

IPv6 Internet Protocol, version 6 (IETF RFC 2460).

Integer, lifetime to register LwM2M server. The unit is second.

String, Mandatory for DTLS register.

Integer, binding mode supported by LwM2M client/server.

1 UDP mode

2 UDP queue mode

10.2.2 AT+CLMADDOBJ Add LwM2M Object

AT+CLMADDOBJ Add LwM2M Object

Write Command

AT+CLMADDOBJ=<lwm2m_ id>,<object_id>,<instance_i d>,<resource_count>,<reso urce_id>,<resource_id>,…

Parameter Saving Mode

Response

NO_SAVE

- Max Response Time

Reference

Defined Values

<lwm2m_id>

<object_id>

<instance_id>

<resource_count>

<resource_id>

Integer, LwM2M id, AT+CLMCONF’s response. Range is 0-32.

Integer, object id. range is 0-65535.

Integer, instance id. Range is 0-32.

Integer, resource count. Range is 0-32.

Integer, resource id. Range is 0-32. www.simcom.com 232 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 AT+CLMCONF should be set before this command.

10.2.3 AT+CLMDELOBJ Delete LwM2M Object

AT+CLMDELOBJ Delete LwM2M Object

Write Command

AT+CLMDELOBJ=<lwm2m_ id>,<object_id>

Parameter Saving Mode

Response

NO_SAVE

Max Response Time

Reference

Defined Values

<lwm2m_id> Integer, LwM2M id, AT+CLMCONF’s response.

<object_id> Integer, object id.

NOTE

 AT+CLMADDOBJ should be set before this command.

10.2.4 AT+CLMREAD Read Notification and Command

AT+CLMREAD Read Notification and Command

Write Command

AT+CLMREAD=<lwm2m_id

>,<object_id>,<instance_id>

,<resource_cnt>,<resource_ id>,<value_type>,<len>,<val ue>,<resource_id>,<value_t ype>,<len>,<value>,<resour ce_id>,<value_type>,<len>,

Response

This command used to indicated there is received a read operation.

And then using this command to send the read operation result.

+CLMREAD:

<lwm2m_id>,<object_id>,<instance_id>,<count>,<resource_id>,< resource_id>,<resource_id> www.simcom.com 233 / 331

SIM7020 Series_AT Command Manual_V1.05

<value>,…

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<lwm2m_id>

<object_id>

<instance_id>

<resource_cnt>

<resource_id>

<value_type>

NO_SAVE

Integer, LwM2M id, AT+CLMCONF’s response.

Integer, object id.

Integer, instance id.

Integer, if it is 0, means all readable resources of the instance.

Integer, if count is 0, the resource id is not exist.

Char, value type.

I Integer

F Float

B Boolean

D UINT8 array data

S String

Integer, value length.

Value type, value context.

<len>

<value>

10.2.5 AT+CLMWRITE Write Notification and Command

AT+CLMWRITE Write Notification and Command

Write Command

AT+CLMWRITE=<lwm2m_id

>,<result>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

Response

This command used to indicated there is received a write operation.

And then using this command to send the write operation result.

+CLMWRITE:

<lwm2m_id>,<object_id>,<instance_id>,<resource_cnt>,<resour ce_id>,<value_type>,<len>,<value>,<resource_id>,<value_type>,

<len>,<value>,<resource_id>,<value_type>,<len>,<value>,...

NO_SAVE www.simcom.com 234 / 331

SIM7020 Series_AT Command Manual_V1.05

<lwm2m_id>

<result>

<object_id>

<instance_id>

<resource cnt>

<resource_id>

<value_type>

<len>

<value>

Integer, LwM2M id, AT+CLMCONF’s response .

I Integer, write result, result of write command, error code.

0 Success

Other value is error code in Spec.

Integer, object id.

Integer, instance id.

Integer, if resource_id==-1, there will be set count.

Integer, resource id.

-1 All of resource about the instance.

Char, value type.

I Integer

F Float

B Boolean

D UINT8 array data

S String

Integer, value length.

Value type, value context.

10.2.6 AT+CLMEXECUTE Execute Notification and Command

AT+CLMEXECUTE Execute Notification and Command

Write Command

AT+CLMEXECUTE=<lwm2m

_id>,<result>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<lwm2m_id>

<result>

Response

This command used to indicated there is received a execute operation. And then using this command to send the execute operation result.

+CLMEXECUTE:

<lwm2m_id>,<object_id>,<instance_id>,<resource_id>,<len>,<bu ffer>

NO_SAVE

Integer, LwM2M id, AT+CLMCONF’s response.

Integer, result of write command, error code.

0 Success

Other value is error code in Spec. www.simcom.com 235 / 331

SIM7020 Series_AT Command Manual_V1.05

<object_id>

<instance_id>

<resource_id>

<len>

<buffer>

Integer, object id.

Integer, instance id.

Integer, resource id.

-1 All of resource about the instance.

Integer, data size.

Raw data in hex value but char format, execute command.

10.2.7 AT+CLMNOTIFY Notify Data Change

AT+CLMNOTIFY Notify Data Change

Write Command

AT+CLMNOTIFY=<lwm2m_i d>,<object_id>,<instance_id

>,<resource_id>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<lwm2m_id>

<object_id>

<instance_id>

<resource_id>

Response

NO_SAVE

Integer, LwM2M id, AT+CLMCONF’s response

Integer, object id

Integer, instance id

Integer, resource id

10.2.8 AT+CLMDEL Delete LwM2M Instance

AT+CLMDEL Delete LwM2M Instance

Write Command

AT+CLMDEL=<lwm2m_id>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

Response

NO_SAVE www.simcom.com 236 / 331

SIM7020 Series_AT Command Manual_V1.05

<lwm2m_id> Integer, LwM2M id, AT+CLMCONF’s response

10.2.9 +CLMOBSERVE Indicated an observe command

+CLMOBSERVE Indicated an observe command

Response

This command used to indicated there is received an observe command.

+CLMOBSERVE:

<lwm2m_id>,<code>,<object_id>[,<instance_id>],<resource_id>

Defined Values

<lwm2m_id>

<code>

<object_id>

<instance_id>

<resource_id>

Integer, LwM2M id, AT+CLMCONF’s response.

Integer,

0 Add observe

1 Cancel observe

Integer, object id.

Integer, instance id.

-1 All of instances of the object.

Integer, resource id.

-1 All of resource about the instance.

10.2.10 +CLMPARAMETER Indicated an observer's parameter

+CLMPARAMETER Indicated an observer's parameter

Response

This command used to indicated there is received an observer's parameter command.

+CLMPARAMETER:

<lwm2m_id>,<object_id>,<instance_id>,<resource_id>,<toSet>,< toClear>,<minPeriod>,<maxPeriod>,<greaterThan>,<lessThan>,< step>

Defined Values

<lwm2m_id> AT+CLMCONF result www.simcom.com 237 / 331

SIM7020 Series_AT Command Manual_V1.05

<object_id>

<instance_id>

<resource_id>

<toSet>

<toClear>

<minPeriod>

<maxPeriod>

<greaterThan>

<lessThan>

<step>

Object id.

Instance id

-1 All of instances and resources

Resource id

-1 All of resource about the instance

Integer, to Set value

Integer, to Clear value

Integer, min Period

Integer, max Period

Float, greater than

Float, less than

Float, step

10.2.11 +CLMERR Indicated there are Some Errors

+CLMERR Indicated there are Some Errors

Response

This command Indicated there are some errors.

+CLMERR: <lwm2m_id>,<error_code>

Defined Values

<lwm2m_id>

<error_code>

Integer, LwM2M id, AT+CLMCONF's response.

Integer, error code.

1 Reset by peer point

2 Network disconnect www.simcom.com 238 / 331

SIM7020 Series_AT Command Manual_V1.05

11 AT Commands for MQTT

Application

11.1 Overview of AT Commands for MQTT Application

Command

AT+CMQNEW

AT+CMQCON

AT+CMQDISCON

AT+CMQSUB

AT+CMQUNSUB

AT+CMQPUB

+CMQDISCON

AT+CMQALICFG

AT+CMQALICON

AT+CMQTTSNEW

AT+CMQTTSNEWEXT

AT+CMQAZURECFG

AT+CMQAZURECON

AT+CMQTSYNC

Description

New MQTT

Send MQTT Connection Packet

Disconnect MQTT

Send MQTT Subscribe Packet

Send MQTT Unsubscribe Packet

Send MQTT Publish Packet

MQTT Disconnect Indication

Configure Alibaba Cloud Parameters

Send MQTT Connection Packet to Alibaba Cloud

New MQTTS

New a MQTTS Instance by Multi Packages for a Long Size Command

Configure Microsoft Azure IoT Parameters

Send MQTT Connection Packet to Azure IoT

Configure MQTT Synchronization Mode

11.2 Detailed Descriptions of AT Commands for MQTT Application

11.2.1 AT+CMQNEW New MQTT

AT+CMQNEW New MQTT

Test Command

AT+CMQNEW=?

Response

+CMQNEW: "server" , "port" , (list of supported

<command_timeout_ms> s ) , (list of supported <bufsize> s )

OK www.simcom.com 239 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CMQNEW?

Write Command

AT+CMQNEW=<server>,<po rt>,<command_timeout_ms

>,<bufsize>[,<cid>]

Parameter Saving Mode

Response

+CMQNEW: <mqtt_id>,<used_state>, <server>

Response

+CMQNEW: <mqtt_id>

NO_SAVE

Max Response Time

Reference

Defined Values

<mqtt_id>

<used_state>

<server>

<port>

<command_timeout_ms>

<bufsize>

Integer, MQTT id

The used result of mqtt_id

0 Not used

1 Used

String, null or server IP address(or MQTT server name).

Max length is

50.

String, MQTT server port, can be from 0 to 65535.

Integer, AT command timeout (ms), can be from 0 to 60000.

Integer, buffer size, can be from 20 to 1132.

<cid> Integer, PDP context ID, AT+CGACT response. [option]

Example

AT+CMQNEW=?

+CMQNEW: "Server name or IP address",(0-65535),(0-60000),(20-1132)

11.2.2 AT+CMQCON Send MQTT Connection Packet

AT+CMQCON Send MQTT Connection Packet

Test Command

AT+CMQCON=?

Response

+CMQCON:

<mqtt_id>,<version>,<client_id>,<keepalive_interval>,<cleanses sion>,<will_flag> www.simcom.com 240 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CMQCON?

Response

+CMQCON: <mqtt_id>,<connected_state>,<server>

Response

Write Command

AT+CMQCON=<mqtt_id>,<v ersion>,<client_id>,<keepali ve_interval>,<cleansession

>,<will_flag>[,<will_options

>][,<username>,<password

Parameter Saving Mode NO_SAVE

Max Response Time

Reference

Defined Values

<mqtt_id>

<connected_state>

<server>

<version>

<client_id>

<keepalive_interval>

<cleansession>

<will_flag>

<will_option>

Integer, MQTT id, AT+CMQNEW's response

The connected result of mqtt_id,

0 Not connected

1 Connected

String, null(not connect) or MQTT server IP address

Integer, MQTT version.

3 MQTT 3.1

4 MQTT 3.1.1

String, client ID, should be unique. Max length is 120.

Integer, keep alive interval, don't suggest to set it to a small value because server may disconnect the device for some reason, can be from 0 to 64800. Unit is second.

Integer, clean session, can be 0 or 1.

Integer, will flag, can be 0 or 1.

String, will options, mandatory if <will_flag> is 1, the format is as follows:

topic=xxx,QoS=xxx,retained=xxx,message_len=xxx,message=xxx

String, user name (option). Max length is 100

String, password (option). Max length is 100

<username>

<password>

Example

AT+CMQCON=?

+CMQCON: (0-0),(3,4),"client ID",(0-64800),(0,1),(0,1) www.simcom.com 241 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CMQCON?

+CMQCON: 0,0,null

NOTE

 AT+CMQNEW should be set before this command.

 If <will_flag> is 0, then we don’t need input <will_options>.

11.2.3 AT+CMQDISCON Disconnect MQTT

AT+CMQDISCON Disconnect MQTT

Test Command

AT+CMQDISCON=?

Response

+CMQDISCON: <mqtt_id>

Response

Write Command

AT+CMQDISCON=<mqtt_id

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mqtt_id>

Example

AT+CMQDISCON=?

+CMQDISCON: (0-0)

NO_SAVE

Integer type, MQTT id, AT+CMQNEW’s response. www.simcom.com 242 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 AT+CMQCON should be set before this command.

11.2.4 AT+CMQSUB Send MQTT Subscribe Packet

AT+CMQSUB Send MQTT Subscribe Packet

Test Command

AT+CMQSUB=?

Response

+CMQSUB: <mqtt_id>,<topic>,<QoS>

Response

Write Command

AT+CMQSUB=<mqtt_id>,<t opic>,<QoS>

Parameter Saving Mode NO_SAVE

Max Response Time

Reference

Defined Values

<mqtt_id>

Integer, MQTT id, AT+CMQNEW’s response.

<topic>

<Qos>

Example

AT+CMQSUB=?

+CMQSUB: (0-0),"topic",(0-2)

String, topic of subscribe message.

Max length is 128.

Integer, message QoS, can be 0, 1 or 2.

11.2.5 AT+CMQUNSUB Send MQTT Unsubscribe Packet

AT+CMQUNSUB Send MQTT Unsubscribe Packet

Test Command Response www.simcom.com 243 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CMQUNSUB=?

Write Command

AT+CMQUNSUB=<mqtt_id>,

<topic>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mqtt_id>

<topic>

Example

AT+CMQUNSUB=?

+CMQUNSUB: (0-0),"topic"

+CMQUNSUB: <mqtt_id>,<topic>

Response

NO_SAVE

Integer, MQTT id, AT+CMQNEW’s response.

String, topic of subscribe message. Max length is 128

11.2.6 AT+CMQPUB Send MQTT Publish Packet

AT+CMQPUB Send MQTT Publish Packet

Test Command

AT+CMQPUB=?

Write Command

AT+CMQPUB=<mqtt_id>,<t opic>,<QoS>,<retained>,<d up>,<message_len>,<mess age>

Parameter Saving Mode

Max Response Time

Response

+CMQPUB:

<mqtt_id>,<topic>,<QoS>,<retained>,<dup>,<message_len>,<me ssage>

Response

Unsolicited result code:

If the topic has been subscribed, then return:

+CMQPUB:

<mqtt_id>,<topic>,<QoS>,<retained>,<dup>,<message_len>,<me ssage>

NO_SAVE

- www.simcom.com 244 / 331

SIM7020 Series_AT Command Manual_V1.05

Reference

Defined Values

<mqtt_id>

<topic>

<Qos>

<retained>

<dup>

Integer, MQTT id, AT+CMQNEW’s response.

String, topic of publish message. Max length is 128

Integer, message QoS, can be 0, 1 or 2.

Integer, retained flag, can be 0 or 1.

Integer, duplicate flag, can be 0 or 1.

<message_len>

<message>

Integer, length of publish message, can be from 2 to 1000.If message is HEX data streaming, then <message_len > should be even.

Default should be a hex data streaming, but if we set

AT+CREVHEX=0 then we can send a RAW data message. And if we want to send a HEX data streaming again, we can set

AT+CREVHEX=1.

Example

AT+CMQPUB=?

+CMQPUB: (0-0),"topic",(0-2),(0,1),(0,1),(2-1000),"message"

11.2.7 +CMQDISCON MQTT Disconnect Indication

+CMQDISCON MQTT Disconnect Indication

Response

When the URC send, there is some error happen on the MQTT connection. This is probably because the MQTT server has disconnected the device for some reasons.

+CMQDISCON: <mqtt_id>

11.2.8 AT+CMQALICFG Configure Alibaba Cloud Parameters

AT+CMQALICFG Configure Alibaba Clound Parameters

Test Command

AT+CMQALICFG=?

Response

+CMQALICFG: www.simcom.com 245 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CMQALICFG=<mqtt_id>

,<productKey>,<deviceNam e>,<deviceSecret>

Parameter Saving Mode

<mqtt_id>,<productKey>,<deviceName>,<deviceSecret>

Response

NO_SAVE

Max Response Time

Reference

Defined Values

<mqtt_id>

<productKey>

Integer, MQTT id, AT+CMQNEW's response

Product Key, get it from Alibaba Cloud.

Length from 1 to 20.

<deviceName>

<deviceSecret>

Device Name, get it from Alibaba Cloud. Length from 1 to 32.

Device Secret, get it from Alibaba Cloud.

NOTE

 AT+CMQNEW should be set before this command.

 This command is a special command to connect to Alibaba Cloud.

Length from 1 to 40.

11.2.9 AT+CMQALICON Send MQTT Connection Packet to Alibaba Cloud

AT+CMQALICON Send MQTT Connection Packet to Alibaba Cloud

Test Command

AT+CMQALICON=?

Response

+CMQALICON: <mqtt_id>,<keepalive_interval>,<cleansession>

Response

Write Command

AT+CMQALICON=<mqtt_id>

,<keepalive_interval>,<clea nsession>

Parameter Saving Mode

Max Response Time

Reference

NO_SAVE

- www.simcom.com 246 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<mqtt_id> Integer, MQTT id, AT+CMQNEW's response

<keepalive_interval> Integer, keep alive interval, don't suggest to set it to a small value because server may disconnect the device for some reason, can be from 0 to 64800.

Integer, clean session, can be 0 or 1 <cleansession>

Example

AT+CMQALICON=?

+CMQALICON: (0-0),(0-64800),(0,1)

NOTE

 AT+CMQNEW and AT+CMQALICFG should be set before this command.

 This command is a special command to connect to Alibaba Cloud.

11.2.10 AT+CMQTTSNEW New MQTTS

AT+CMQTTSNEW New MQTTS

Test Command

AT+CMQTTSNEW=?

Read Command

AT+CMQTTSNEW?

Write Command

AT+CMQTTSNEW=<server>

,<port>,<command_timeout

_ms>,<bufsize>

Parameter Saving Mode

Max Response Time

Response

+CMQTTSNEW: "server","port", (list of supported

<command_timeout_ms> s ), (list of supported <bufsize> s )

Response

+CMQTTSNEW: <mqtt_id>,<used_state>,<server>

Response

+CMQTTSNEW: <mqtt_id>

NO_SAVE

- www.simcom.com 247 / 331

SIM7020 Series_AT Command Manual_V1.05

Reference

Defined Values

<mqtt_id>

<used_state>

<server>

<port>

<command_timeout_ms>

<bufsize>

Integer, MQTT id

The used result of mqtt_id

0 Not used

1 Used

String, null or server IP address(or MQTT server name). Max length is 50.

String, MQTT server port, can be from 0 to 65535.

Integer, AT command timeout (ms), can be from 0 to 60000.

Integer, buffer size, can be from 20 to 1132.

Example

AT+CMQTTSNEW=?

+CMQTTSNEW: "Server name or IP address",(0-65535),(0-60000),(20-1132)

AT+CMQTTSNEW?

+CMQTTSNEW: 0,0,null

NOTE

 AT+CSETCA should be set before this command, we need to set the certificates first!

11.2.11 AT+CMQTTSNEWEXT NEW a MQTTS Instance by Multi Packages for a Long

Size Command

AT+CMQTTSNEWEXT New a MQTTS Instance by Multi Packages for a Long Size

Command

Read Command

AT+CMQTTSNEWEXT?

Response

+CMQTTSNEWEXT: <mqtt_id>,<used_state>,<server> www.simcom.com 248 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+CMQTTSNEWEXT=<flag

>,<total_len>,<len>,<server

>,<port>,<command_timeou t_ms>,<bufsize>,<server_ce rt_len>,<server_cert>,<clien t_cert_len>,<client_cert>,<c lient_pk_len>,<client_pk>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<flag>

<total_len>

<len>

<server>

<port>

<command_timeout_ms>

<bufsize>

<server_cert_len>

<server_cert>

<client_cert_len>

<client_cert>

<client_pk_len>

<client_pk>

<mqtt_id>

<used_state>

Response

+CMQTTSNEWEXT: <mqtt_id>

OK or

ERROR

NO_SAVE

1 Means there are more packages

0 Means this package is the last one

The total length of the command

The length of current package

String, null or server IP address(or MQTT server name).

Max length is

50.

String, MQTT server port, can be from 0 to 65535.

Integer, AT command timeout (ms), can be from 0 to 60000.

Integer, buffer size, can be from 20 to 1132.

Server certification length, for mqtts.

Server certification, for mqtts, should be HEX format.

Client certification length, for mqtts.

Client certification, for mqtts, should be HEX format.

Client private key length, for mqtts.

Client private key, for mqtts, should be HEX format.

Integer, MQTT id.

The used result of mqtt_id

0 Not used

1 Used

Example

AT+CMQTTSNEWEXT?

+CMQTTSNEWEXT: 0,0,null

OK www.simcom.com 249 / 331

SIM7020 Series_AT Command Manual_V1.05

11.2.12 AT+CMQAZURECFG Configure Microsoft Azure IoT Parameters

AT+CMQAZURECFG Configure MicroSoft Azure IoT Parameters

Test Command

AT+CMQAZURECFG=?

Response

+CMQAZURECFG:

<mqtt_id>,<hostName>,<deviceId>,<deviceKey>,<expiry_time>

Response

Write Command

AT+CMQAZURECFG=<mqtt

_id>,<hostName>,<deviceId

>,<deviceKey>,<expiry_time

Parameter Saving Mode NO_SAVE

Max Response Time

Reference

Defined Values

<mqtt_id>

<hostName>

<deviceId>

<deviceKey>

<expiry_time>

Integer, MQTT id, AT+CMQTTSNEW 's response

Host Name, get it from Azure IoT Connection String.

Device Id, get it from Azure IoT.

Device Primary Key, get it from Azure IoT.

Expiration Time, from 0 to 31536000.

Example

AT+CMQAZURECFG=?

+CMQAZURECFG: (0-0),"hostName","deviceID","deviceKey",(0-31536000)

NOTE

 AT+CMQTTSNEW should be set before this command.

 This command is a special command to connect to Azure IoT. www.simcom.com 250 / 331

SIM7020 Series_AT Command Manual_V1.05

11.2.13 AT+CMQAZURECON Send MQTT Connection Packet to Azure IoT

AT+CMQAZURECON Send MQTT Connection Packet to Azure IoT

Test Command

AT+CMQAZURECON=?

Response

+CMQAZURECON:

<mqtt_id>,<keepalive_interval>,<cleansession>

Response

Write Command

AT+CMQAZURECON=<mqtt

_id>,<keepalive_interval>,< cleansession>

Parameter Saving Mode NO_SAVE

Max Response Time

Reference

Defined Values

<mqtt_id>

<keepalive_interval>

Integer, MQTT id, AT+CMQTTSNEW 's response

Integer, keep alive interval, don't suggest to set it to a small value because server may disconnect the device for some reason, can be from 0 to 64800.

Integer, clean session, can be 0 or 1 <cleansession>

Example

AT+CMQAZURECON=?

+CMQAZURECON: (0-0),(0-64800),(0,1)

NOTE

 AT+CMQTTSNEW and AT+CMQAZURECFG should be set before this command.

 This command is a special command to connect to Azure IoT. www.simcom.com 251 / 331

SIM7020 Series_AT Command Manual_V1.05

11.2.14 AT+CMQTSYNC Configure MQTT Synchronization Mode

AT+CMQTSYNC Configure MQTT Synchronization Mode

Test Command

AT+CMQTSYNC=?

Read Command

AT+CMQTSYNC?

Write Command

AT+CMQTSYNC=<n>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<n>

Response

+CMQTSYNC: ( list of supported <n> s )

Response

+CMQTSYNC: <n>

Response

If error is related to wrong AT syntax or incorrect parameters.

ERROR

AUTO_SAVE

0 Disable MQTT synchronization mode

1 Enable MQTT synchronization mode

Example

AT+CMQTSYNC=?

+CMQTSYNC: (0,1)

AT+CMQTSYNC?

+CMQTSYNC: 0

OK www.simcom.com 252 / 331

SIM7020 Series_AT Command Manual_V1.05

12 AT Commands for CoAP

Application

12.1 Overview of AT Commands for CoAP Application

Command

AT+CCOAPNEW

AT+CCOAPSEND

AT+CCOAPCSEND

AT+CCOAPDEL

+CCOAPNMI

Description

Create a CoAP client instance

Send CoAP data

Destroy the CoAP client instance

Content from CoAP server

12.2 Detailed Descriptions of AT Commands for CoAP Application

12.2.1 AT+CCOAPNEW Create a CoAP Client Instance

AT+CCOAPNEW Create a CoAP Client Instance

Test Command

AT+CCOAPNEW=?

Write Command

AT+CCOAPNEW=<ip_addr>

,<port>,<cid>

Parameter Saving Mode

Response

+CCOAPNEW: (0-255).(0-255).(0-255).(0-255),(0-65535),(0-10)

Response

+CCOAPNEW: <coap_id>

NO_SAVE

Max Response Time

Reference

Defined Values

- www.simcom.com 253 / 331

SIM7020 Series_AT Command Manual_V1.05

<ip_addr>

<port>

<cid>

<coap_id>

String, CoAP server IP address.

Integer, CoAP server port(spec default 5683).

Integer, PDP context ID, AT+CGACT response.

Integer, CoAP client instance id created by the command.

Example

AT+CCOAPNEW=?

+CCOAPNEW: (0-255).(0-255).(0-255).(0-255),(0-65535),(0-10)

12.2.2 AT+CCOAPSEND Send CoAP Data

AT+CCOAPSEND Send CoAP Data

Test Command

AT+CCOAPSEND=?

Write Command

AT+CCOAPSEND=<coap_id

>,<data_len>,<data>

Parameter Saving Mode

Response

+CCOAPSEND: (1-2),(4-512),"data"

Response

NO_SAVE

Max Response Time

Reference

Defined Values

<coap_id>

<data_len>

<data>

Integer, CoAP client instance id created by the AT+CCOAPNEW command.

Integer, Send data length (by byte).

String, the hex data streaming.

Example

AT+CCOAPSEND=?

+CCOAPSEND: (1-2),(4-512),"data" www.simcom.com 254 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 AT+CCOAPNEW should be set before this command.

12.2.3 AT+CCOAPCSEND Send CoAP Data

AT+CCOAPCSEND Send CoAP Data

Test Command

AT+CCOAPCSEND=?

Response

+CCOAPCSEND:

(1-2),(1),(0-3),(0-7),(0-31),"token","option",(0-512),"data"

Response

Write Command

AT+CCOAPCSEND=<coap_i d>,<version>,<type>,<h_co de>,<l_code>,<token>,<opti on>,<data_len>,<data>

Parameter Saving Mode NO_SAVE

- Max Response Time

Reference

Defined Values

<coap_id>

<version>

<type>

<h_code>

<l_code>

Integer, CoAP client instance id created by the AT+CCOAPNEW command.

Integer, version information, the current value is 1.

Integer, the message type.

0 CON, confirmable message (requires ACK/RST).

1 NON, non-confirmable message (one-shot message).

ACK, used to acknowledge confirmable messages.

3 RST, indicates error in received messages.

Integer, the first three bits of the <code> value.

0 Empty message or request

1 Reserved

2-5 Response

6-7 Reserved

Integer, the last five bits of the <code> value (0-31). www.simcom.com 255 / 331

SIM7020 Series_AT Command Manual_V1.05

<token>

<code> Function code or response code. Code takes different forms in

CoAP request message and response message. Code takes one byte and is divided into two parts, the first three bits <h_code> and the last five bits <l_code> In order to describe it conveniently, it is written into c.dd structure(such as 0.01,2.01,4.02 and so on).

For example, if <h_code> is 4 and <l_code> is 12, so <code> is 4.12.

Request:

[0.01]GET method, get resource

[0.02]POST method, create resource

[0.03]PUT method, update resource

[0.04]DELETE method, delete resource

Response:

[2.01]Created

[2.02]Deleted

[2.03]Valid

[2.04]Changed

[2.05]Content.

[4.00]Bad Request.

[4.01]Unauthorized.

[4.02]Bad Option.

[4.03]Forbidden.

[4.04]Not Found.

[4.05]Method Not Allowed.

[4.06]Not Acceptable.

[4.12]Precondition Failed.

[4.15]Unsupported Content-Type.

[5.00]Internal Server Error.

[5.01]Not Implemented.

[5.02]Bad Gateway.

[5.03]Service Unavailable.

[5.04]Gateway Timeout.

[5.05]Proxying Not Supported.

String, the hex data streaming, request id, relate the response to the request (option).

String, the hex data streaming, zero or more options (option).

Integer, Send data length (by byte).

String, the hex data streaming (payload).

<option>

<data_len>

<data>

Example

AT+CCOAPCSEND=?

+CCOAPCSEND: (1-2),(1),(0-3),(0-7),(0-31),"token","option",(0-512),"data"

OK www.simcom.com 256 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 AT+CCOAPNEW should be set before this command.

12.2.4 AT+CCOAPDEL Destroy the CoAP Client Instance

AT+CCOAPDEL Destory the CoAP Client Instance

Test Command

AT+CCOAPDEL=?

Write Command

AT+CCOAPDEL=<coap_id>

Parameter Saving Mode

Response

+CCOAPDEL: (1-2)

Response

NO_SAVE

Max Response Time

Reference

Defined Values

<coap_id> Integer, CoAP client instance id created by the

AT+CCOAPNEW command.

Example

AT+CCOAPDEL=?

+CCOAPDEL: (1-2)

NOTE

 AT+CCOAPNEW should be set before this command. www.simcom.com 257 / 331

SIM7020 Series_AT Command Manual_V1.05

12.2.5 +CCOAPNMI Content from CoAP server

+CCOAPNMI Content from CoAP server

Response

+CCOAPNMI: <coap_id>,<data_len>,<data>

Defined Values

<coap_id>

<data_len>

<data>

Integer, CoAP client instance id created by the

AT+CCOAPNEW command.

Integer, data length (by byte).

String, the hex data streaming. www.simcom.com 258 / 331

SIM7020 Series_AT Command Manual_V1.05

13 AT Commands for SNTP

Application

13.1 Overview of AT Commands for SNTP Application

Command

AT+CSNTPSTART

AT+CSNTPSTOP

+CSNTP

Description

Start to query network time

Stop to query network time

Received network time

13.2 Detailed Descriptions of AT Commands for SNTP Application

13.2.1 AT+CSNTPSTART Start to Query Network Time

AT+CSNTPSTART Start to Query Network Time

Write Command

AT+CSNTPSTART=<url>[,zo ne]

Parameter Saving Mode

Response

NO_SAVE

- Max Response Time

Reference

Defined Values

<url>

<zone>

A string of SNTP server name or IP address.

String type value; On behalf of the time zone, range -47...+48.The eastern region is denoted as "+32". www.simcom.com 259 / 331

SIM7020 Series_AT Command Manual_V1.05

13.2.2 +CSNTP Received Network Time

+CSNTP Received Network Time

Response

Indicated there is received some data from network.

+CSNTP: <time>[,zone]

Defined Values

<time>

<zone>

String type value; format is yy/MM/dd, hh:mm:ss:ms, where characters indicate year (two last digits),month, day, hour, minutes, seconds and millisecond . E.g 10/05/06,00:01:52:62

String type value; On behalf of the time zone, range -47...+48.The eastern region is denoted as "+32". www.simcom.com 260 / 331

SIM7020 Series_AT Command Manual_V1.05

14 AT Commands for TLS

Application

14.1 Overview of AT Commands for TLS Application

Command

AT+CTLSCFG

AT+CTLSCONN

AT+CTLSCLOSE

AT+CTLSSEND

AT+CTLSRECV

AT+CSETCA

AT+CSETCIPHER

Description

Configure TLS parameters

Create a TLS connection

Close a TLS connection

Send data

Receive data

Set the certificate parameters

Set the encryption suite used by the TLS handshake

14.2 Detailed Descriptions of AT Commands for TLS Application

14.2.1 AT+CTLSCFG Configure TLS Parameters

AT+CTLSCFG Configure TLS Parameters

Write Command

AT+CTLSCFG=<tid>,<type>,

<value>[,<type>,<value>[,<t ype>,<value>[…]]]

Parameter Saving Mode

Response

NO_SAVE

Max Response Time

Reference

Defined Values

<tid>

Integer type. It is the identifier of the TLS connection to be created. www.simcom.com 261 / 331

SIM7020 Series_AT Command Manual_V1.05

<type>

The values(1-6).

Integer type. It is the type of the parameter to be configured.

1 Server name (string)

2 Port (int, default value is 443)

3 Socket type (0-tcp, tcp supported only, default value is 0)

4 Auth_mode (int, 0-none, 1-optional, 2-required, default value is 2)

5 Debug level (int, 0~4, 0-no log, 4-all log enabled, default value is

6 Server CA (<size><more><certificate>, size (int)-total size of the certificate without the terminate null; more(int)-is there more certificate content needed to be sent, 1-yes, 0-no; certificate (string)-the total or partial of the certificate content. default value for type 6 is null)

7 Client certificate (same as 6-server CA, default value for type 7 is null)

8 Client private key (<size><more><private-key>, size and more is the same as 6-server CA, private-key (string)-the total or partial of the private-key, default value for type 8 is null)

Integer type. It is the value of the parameter to be configured. <value>

14.2.2 AT+CTLSCONN Create a TLS Connection

AT+CTLSCONN Create a TLS Connection

Write Command

AT+CTLSCONN=<tid>,<cid>

Parameter Saving Mode

Response

+CTLSCONN: <tid>,<ret>

NO_SAVE

Max Response Time

Reference

Defined Values

<tid>

<ret>

Integer type. It is the identifier of the TLS connection to be created. It should be the same as the one in CTLSCFG.

Integer type. It tells the result of the TLS connection. If the connection succeeds, it is 1.Otherwise,it is the error code. See 20.4 Summary of

TLS ERROR Codes for details. www.simcom.com 262 / 331

SIM7020 Series_AT Command Manual_V1.05

14.2.3 AT+CTLSCLOSE Close a TLS Connection

AT+CTLSCLOSE Close a TLS Connection

Write Command

AT+CTLSCLOSE=<tid>

Parameter Saving Mode

Response

+CTLSCLOSE: <tid>,<ret>

NO_SAVE

Max Response Time

Reference

Defined Values

<tid>

<cid>

<ret>

Integer type. It is the identifier of the TLS connection to be created. It should be the same as the one in CTLSCFG.

Integer type. It is a numeric parameter specifying a particular PDP context returned by CGACT.

Integer type. It tells the result of the TLS connection closure. If the closure succeeds, it is 1.Otherwise, it is the error code. See 20.4

Summary of TLS ERROR Codes for details.

14.2.4 AT+CTLSSEND Send Data

AT+CTLSSEND Send Data

Write Command

AT+CTLSSEND=<tid>,<data

_len>,<data>[,<encod_meth od>]

Parameter Saving Mode

Response

+CTLSSEND: <tid>,<ret>

NO_SAVE

- Max Response Time

Reference

Defined Values

<tid>

<data_len>

<data>

Integer type. It is the identifier of the TLS connection to be created. It should be the same as the one in CTLSCFG.

Integer type. It is the length of the <data>. Max length of a single transmission 1024.

It is the data sent. www.simcom.com 263 / 331

SIM7020 Series_AT Command Manual_V1.05

<encod_method>

<ret>

Integer type. It is the encode method used for <data>.

801 String encoding and it is the default value which can be omitted.

802 Hex encoding

803 Base64 encoding

Integer type. It tells the result of the data sending. If it is greater than 0, it is the actual number of data send. Otherwise, it is the error code.

See 20.4 Summary of TLS ERROR Codes for details.

14.2.5 AT+CTLSRECV Receive Data

AT+CTLSRECV Receive Data

Write Command

AT+CTLSRECV=<tid>,<max

_num>[,<encod_method>]

Parameter Saving Mode

Response

+CTLSRECV: <tid>,<ret>[,<data>[,<encode_method>]]

NO_SAVE

- Max Response Time

Reference

Defined Values

<tid>

<max_num>

<encod_method>

<ret>

Integer type. It is the identifier of the TLS connection to be created. It should be the same as the one in CTLSCFG.

Integer type. It is the maximum number of plain data without encoding that could be received. When encod_method=801,the maximum receiving length of a single time is 1024, Otherwise the maximum receiving length of a single time is 512.

Integer type. It is the encode method used for <data>.

801 String encoding and it is the default value which can be omitted.

802 Hex encoding.

803 Base64 encoding.

Integer type. If it is greater than 0, it is the length of data received after encoding .Otherwise, it is the error code. See 20.4 Summary of TLS

ERROR Codes for details.

It is the data received with encoding. <data>

14.2.6 AT+CSETCA Set the Certificate Parameters www.simcom.com 264 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+CSETCA Set the Certificate Parameters

Read Command

AT+CSETCA?

Write Command

AT+CSETCA=<type>,<total_ len>,<is_end>,<encod_meth od>,<ca_data>

Parameter Saving Mode

Response

<type>: <total_len>

Response

NO_SAVE

- Max Response Time

Reference

Defined Values

<type>

<total_len>

<is_end>

<encod_method>

<ca_data>

Example

AT+CSETCA?

String type.

0 Root CA, root certificate.

1 Client CA, client certificate.

2 Client Private Key.

3 PSKID

4 PSK

Integer type. The total length of the certificate.

Is there more certificate content needed to be sent.

0 No

1 Yes

Integer type. It is the encode method used for <ca_data>.

0 String encoding

1 Hex encoding

String type. Content of the certificate.

14.2.7 AT+CSETCIPHER Set the Encryption Suite Used by the TLS Handshake

AT+CSETCIPHER Set the Encryption Suite Used by the TLS Handshake

Read Command

AT+CSETCIPHER?

Response

<type>: <num> www.simcom.com 265 / 331

SIM7020 Series_AT Command Manual_V1.05

Execution Command

AT+CSETCIPHER

Write Command

AT+CSETCIPHER=<enable>

,<num>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<enable>

Response

List of all currently supported encryption suites

Response

NO_SAVE

Whether to enable the set encryption suite function

0 Close

1 Open

Encryption package number selected. <num>

Example

AT+CSETCIPHER?

+CETCIPHER: 0,0

OK www.simcom.com 266 / 331

SIM7020 Series_AT Command Manual_V1.05

15 AT Commands for OneNet

Application

15.1 Overview of AT Commands for OneNet Application

Command

AT+MIPLCREATE

Description

Create a OneNet instance

AT+MIPLCREATEEXT

AT+MIPLDELETE

AT+MIPLOPEN

AT+MIPLCLOSE

Another method to Create a OneNet instance

Delete a OneNet instance

Deregister to OneNet

Add an object AT+MIPLADDOBJ

AT+MIPLDELOBJ

AT+MIPLUPDATE

AT+MIPLREADRSP

AT+MIPLWRITERSP

AT+MIPLEXECUTERSP

AT+MIPLOBSERVERSP

Delete an object

Update registration

Read response from user

Write response from user

Execute response from user

Observe response from user

AT+MIPLDISCOVERRSP Discover response from user

AT+MIPLPARAMETERRSP Set parameter from user

AT+MIPLNOTIFY

AT+MIPLVER

Notify data value change from user

Read version

+MIPLREAD

+MIPLWRITE

+MIPLEXECUTE

+MIPLOBSERVE

Read request to user

Write request to user

Execute request to user

Observe request to user

+MIPLDISCOVER

+MIPLPARAMETER

+MIPLEVENT

Discover request to user

Set parameter request to user

Event indication to user

15.2 Detailed Descriptions of AT Commands OneNet Application

www.simcom.com 267 / 331

SIM7020 Series_AT Command Manual_V1.05

15.2.1 AT+MIPLCREATE Create a OneNet Instance

AT+MIPLCREATE Create a OneNet Instance

Test Command

AT+MIPLCREATE=?

Read Command

AT+MIPLCREATE?

Write Command

AT+MIPLCREATE=<totalsiz e>,<config>,<index>,<curre ntsize>,<flag>

Execution Command

AT+MIPLCREATE

Parameter Saving Mode

Response

+ MIPLCREATE : (list of supported < totalsize >) ,(list of supported

< config >), (list of supported < index >), (list of supported

< currentsize >),(list of supported < flag >)

Response

+MIPLCREATE: <id>,<used_state>

Response

--message received correctly if index not equals to 0

+MIPLCREATE: <id>

--message received correctly and return OneNet instance or

+CIS ERROR: <err>

Response

+MIPLCREATE: <id>

OK or

+CIS ERROR: <err>

Create OneNet default configuration as host of "183.230.40.39" with bootstrap.

NO_SAVE

- Max Response Time

Reference

Defined Values

<totalsize>

<config>

<index>

<currentsize>

<flag>

Integer, configuration file total size(it is byte size)

Hex string, configuration file, ex: 130033f1……

Integer, configuration file index, from 0 to 1024

Integer, configuration file size in current AT command(it is byte size)

Integer, message flag

1 First message

2 Middle message www.simcom.com 268 / 331

SIM7020 Series_AT Command Manual_V1.05

<id>

0 Last message

Integer, create OneNet id

<used_state> Integer, the used result of AT+MIPLCREATE

0 Not used

1 Used

Example

AT+MIPLCREATE=?

+MIPLCREATE: (0-1024),"config",(0-1024),(0-512),(0-2)

AT+MIPLCREATE=?

+MIPLCREATE: 0,0

15.2.2 AT+MIPLCREATEEXT Another Method to Create a OneNet Instance

AT+MIPLCREATEEXT Another Method to Create a OneNet Instance

Test Command

AT+MIPLCREATEEXT=?

Read Command

AT+MIPLCREATEEXT?

Write Command

AT+MIPLCREATEEXT=<add r>,<bs>

Parameter Saving Mode

Response

+ MIPLCREATEEXT : (0-255).(0-255).(0-255).(0-255),(0,1)

Response

+MIPLCREATEEXT: <id>,<used_state>

Response

+MIPLCREATEEXT: <id>

--message received correctly and return OneNet instance or

+CIS ERROR: <err>

NO_SAVE

Max Response Time

Reference

- www.simcom.com 269 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<addr>

<bs>

<id>

String. OneNet host IP address

Integer. OneNet host bootstrap value

0 Bootstrap disabled

1 Bootstrap enabled

Such as: 183.230.40.39, bs value is set to 1

183.230.40.40, bs value is set to 0

Integer, Create OneNet id

<used_state> Integer.The used result of AT+MIPLCREATE

0 Not used

1 Used

Example

AT+MIPLCREATEEXT=?

+MIPLCREATEEXT: (0-255).(0-255).(0-255).(0-255),(0-1)

AT+MIPLCREATEEXT?

+MIPLCREATEEXT: 0,0

NOTE

 The parameter of "BS" is necessary from OneNet Version 2.2.0, but it is needless before OneNet

Ver2.2.0.

15.2.3 AT+MIPLDELETE Delete a OneNet Instance

AT+MIPLDELETE Delete a OneNet Instance

Test Command

AT+MIPLDELETE=?

Write Command

AT+MIPLDELETE=<id>

Response

+ MIPLDELETE : (list of supported < id >)

Response

OK www.simcom.com 270 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<id>

Example

AT+MIPLDELETE=?

+MIPLDELETE: (0)

- or

+CIS ERROR: <err>

NO_SAVE

Integer, OneNet instance returned by AT+MIPLCREATE

15.2.4 AT+MIPLOPEN Register to OneNet

AT+MIPLOPEN Register to OneNet

Test Command

AT+MIPLOPEN=?

Read Command

AT+MIPLOPEN?

Write Command

AT+MIPLOPEN=<id>,<lifeti me>[,<param>]

Parameter Saving Mode

Response

+MIPLOPEN: (list of supported < id >),(list of supported

< lifetime >),(list of supported < param >)

Response

+MIPLOPEN: <id>,<connected_state>

Response

OK or

+CIS ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

- www.simcom.com 271 / 331

SIM7020 Series_AT Command Manual_V1.05

<id>

<lifetime>

<param>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, lifetime to register ONENET server. The unit is second.

Reserved

<connected_state> The connected result of AT + MIPLOPEN

0 Not connected

1 Connected

Example

AT+MIPLOPEN=?

+MIPLOPEN: (0),(15-268435455),(0-1024)

AT+MIPLOPEN?

+MIPLOPEN: 0,0

15.2.5 AT+MIPLCLOSE Deregister to OneNet

AT+MIPLCLOSE Deregister to OneNet

Test Command

AT+MIPLCLOSE=?

Write Command

AT+MIPLCLOSE=<id>

Parameter Saving Mode

Response

+MIPLCLOSE: (list of supported <id>)

Response

OK or

+CIS ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<id>

Example

Integer, OneNet instance returned by AT+MIPLCREATE www.simcom.com 272 / 331

SIM7020 Series_AT Command Manual_V1.05

AT+MIPLCLOSE=?

+MIPLCLOSE: (0)

15.2.6 AT+MIPLADDOBJ Add an Object

AT+MIPLADDOBJ Add an Object

Test Command

AT+MIPLADDOBJ=?

Read Command

AT+MIPLADDOBJ?

Write Command

AT+MIPLADDOBJ=<id>,<ob jectid>,<instancecount>,<in stancebitmap>,<attributeco unt>,<actioncount>

Parameter Saving Mode

Response

+MIPLADDOBJ: (list of supported <id>), (list of supported

<objectid>), (list of supported <instancecount>), (list of supported

<instancebitmap>), (list of supported <attributecount>), (list of supported <actioncount>)

Response

+MIPLADDOBJ: <object_num>

Response

OK or

+CIS ERROR: <err>

NO_SAVE

- Max Response Time

Reference

Defined Values

<id>

<objectid>

<instancecount>

<instancebitmap>

<attributecount>

<actioncount>

<object_num>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, object id

Integer, instance count

Binary string, instance bitmap, ex: "00101" (5 instances, only instance 1 & 3 are available)

Integer, attribute count(The Object that has read or write operation, has the attribute)

Integer, action count(The Object that has execute operation, has the action)

Current OneNet object number www.simcom.com 273 / 331

SIM7020 Series_AT Command Manual_V1.05

Example

AT+MIPLADDOBJ=?

+MIPLADDOBJ: (0),(0-4294967295),(1-64),"instancebitmap",(0-1024),(0-1024)

AT+MIPLADDOBJ?

+MIPLADDOBJ: 0

15.2.7 AT+MIPLDELOBJ Delete an Object

AT+MIPLDELOBJ Delete an Object

Test Command

AT+MIPLDELOBJ=?

Write Command

AT+MIPLDELOBJ=<id>,<obj ectid>

Parameter Saving Mode

Response

+ MIPLDELOBJ : (list of supported < id >), (list of supported < objectid >)

Response

OK or

+CIS ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<id>

<objectid>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, object id

Example

AT+MIPLDELOBJ=?

+MIPLDELOBJ: (0),(0-4294967295)

OK www.simcom.com 274 / 331

SIM7020 Series_AT Command Manual_V1.05

15.2.8 AT+MIPLUPDATE Update Registration

AT+MIPLUPDATE Update Registration

Test Command

AT+MIPLUPDATE=?

Write Command

AT+MIPLUPDATE=<id>,<life time>,<withObjectFlag>

Parameter Saving Mode

Response

+ MIPLUPDATE : (list of supported < id >), (list of supported

< lifetime > ) ,( list of supported <withObjectFlag> )

Response

OK or

+CIS ERROR: <err>

NO_SAVE

Max Response Time -

Reference

Defined Values

<id> Integer, OneNet instance returned by AT+MIPLCREATE.

<lifetime> Integer, lifetime to update registration. The unit is second.

<withObjectFlag> Integer, whether to update objects

0 Not update objects

1 Update objects

Example

AT+MIPLUPDATE=?

+MIPLUPDATE: (0),(15-268435455),(0-1)

15.2.9 AT+MIPLREADRSP Read Response from User

AT+MIPLREADRSP Read Response from User

Test Command

AT+MIPLREADRSP=?

Response

+ MIPLREADRSP : (list of supported < id >), (list of supported www.simcom.com 275 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT+MIPLREADRSP=<id>,< msgid>,<result>,<objectid>,

<instanceid>,<resourceid>,

<valuetype>,<len>,<value>,

<index>,<flag>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<id>

<msgid>

<result>

<objectid>

<instanceid>

<resourceid>

<valuetype>

<len>

<value>

<index>

< msgid >), (list of supported < result >), (list of supported

< objectid >), (list of supported < instanceid >) , (list of supported

< resourceid >),(list of supported < valuetype >),(list of supported

< len >),(list of supported < value >),(list of supported < index >),(list of supported < flag >)

Response

OK or

+CIS ERROR: <err>

NO_SAVE

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, message id, the same to +MIPLREAD

Integer, read result, 1 indicates read success, should provide read content in the same time

1 Read/Observe/Discover OK

2 Write/Execute/ Set parameter OK

11 400 Bad request

12 401 Unauthorized

13 404 Not Found

14 405 Method Not Allowed

15 406 Not Acceptable

Integer, object id

Integer, instance id

Integer, resource id

Integer, read data value type

1 String

2 Opaque

3 Integer

4 Float

5 Bool

Integer, read data length. It can be omitted, if valuetype is Integer or

Float, or Bool

Integer, read data value

Integer, message index, from 0 to 1024 www.simcom.com 276 / 331

SIM7020 Series_AT Command Manual_V1.05

<flag> Integer, message flag

1 First message

2 Middle message

0 Last message

Example

AT+MIPLREADRSP=?

+MIPLREADRSP:

(0),(0-4294967295),(1-2,11-15),(0-4294967295),(0-63),(0-4294967295),(1-5),(0-1024),"v alue",(0-1024),(0-2)

15.2.10 AT+MIPLWRITERSP Write Response from User

AT+MIPLWRITERSP Write Response from User

Test Command

AT+MIPLWRITERSP=?

Write Command

AT+MIPLWRITERSP=<id>,< msgid>,<result>

Parameter Saving Mode

Response

+ MIPLWRITERSP : (list of supported < id >), (list of supported

< msgid >), (list of supported < result >)

Response

OK or

+CIS ERROR: <err>

NO_SAVE

- Max Response Time

Reference

Defined Values

<id>

<msgid>

<result>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, message id, the same to +MIPLWRITE

Integer, write result, 2 indicates write success

1 Read/Observe/Discover OK

2 Write/Execute/ Set parameter OK

11 400 Bad request

12 401 Unauthorized

13 404 Not Found www.simcom.com 277 / 331

SIM7020 Series_AT Command Manual_V1.05

14 405 Method Not Allowed

15 406 Not Acceptable

Example

AT+MIPLWRITERSP=?

+MIPLWRITERSP: (0),(0-4294967295),(1-2,11-15)

15.2.11 AT+MIPLEXECUTERSP Execute Response from User

AT+MIPLEXECUTERSP Execute Response from User

Test Command

AT+MIPLEXECUTERSP=?

Write Command

AT+MIPLEXECUTERSP=<id

><msgid>,<result>

Parameter Saving Mode

Response

+MIPLEXECUTERSP: (list of supported <id>), (list of supported

<msgid>), (list of supported <result>)

Response

OK or

+CIS ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<id>

<msgid>

<result>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, message id, the same to +MIPLEXECUTE

Integer, execute result, 2 indicates execute success

1 Read/Observe/Discover OK

2 Write/Execute/ Set parameter OK

11 400 Bad request

12 401 Unauthorized

13 404 Not Found

14 405 Method Not Allowed

15 406 Not Acceptable www.simcom.com 278 / 331

SIM7020 Series_AT Command Manual_V1.05

Example

AT+MIPLEXECUTERSP=?

+MIPLEXECUTERSP: (0),(0-4294967295),(1-2,11-15)

15.2.12 AT+MIPLOBSERVERSP Observe Response from User

AT+MIPLOBSERVERSP Observe Response from User

Test Command

AT+MIPLOBSERVERSP=?

Write Command

AT+MIPLOBSERVERSP=<id

><msgid>,<result>

Parameter Saving Mode

Response

+ MIPLOBSERVERSP : (list of supported < id >), (list of supported

< msgid >), (list of supported < result >)

Response

OK or

+CIS ERROR: <err>

NO_SAVE

Max Response Time -

Reference

Defined Values

<id>

<msgid>

<result>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, message id, the same to +MIPLOBSERVE

Integer, (cancel) observe result, 1 indicates (cancel) observe success

1 Read/Observe/Discover OK

2 Write/Execute/ Set parameter OK

11 400 Bad request

12 401 Unauthorized

13 404 Not Found

14 405 Method Not Allowed

15 406 Not Acceptable

Example

AT+MIPLOBSERVERSP=?

+MIPLOBSERVERSP: (0),(0-4294967295),(1-2,11-15) www.simcom.com 279 / 331

SIM7020 Series_AT Command Manual_V1.05

15.2.13 AT+MIPLDISCOVERRSP Discover Response from User

AT+MIPLDISCOVERRSP Discover Response from User

Test Command

AT+MIPLDISCOVERRSP=?

Write Command

AT+MIPLDISCOVERRSP=<i d>,<msgid>,<result><length

>,<valuestring>

Parameter Saving Mode

Response

+ MIPLDISCOVERRSP : (list of supported < id >), (list of supported

< msgid >), (list of supported < result >), (list of supported < length >), (list of supported < valuestring >)

Response

OK or

+CIS ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<id>

<msgid>

<result>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, message id, the same to +MIPLDISCOVER

Integer, discover result, 1 indicates discover success

1 Read/Observe/Discover OK

2 Write/Execute/Set parameter OK

11 400 Bad request

12 401 Unauthorized

13 404 Not Found

14 405 Method Not Allowed

15 406 Not Acceptable

Integer, length of value string <length>

<valuestring> String, value string (resourceId; resourceId; …; resourceId), must start with '"' and end with '"'

Example

AT+MIPLDISCOVERRSP=?

+MIPLDISCOVERRSP: (0),(0-4294967295),(1-2,11-15),(0-1024),"valuestring" www.simcom.com 280 / 331

SIM7020 Series_AT Command Manual_V1.05

15.2.14 AT+MIPLPARAMETERRSP Set Parameter from User

AT+MIPLPARAMETERRSP Set Parameter from User

Test Command

AT+MIPLPARAMETERRSP=

Write Command

AT+MIPLPARAMETERRSP=

<id>,<msgid>,<result>

Parameter Saving Mode

Response

+ MIPLPARAMETERRSP : (list of supported < id >), (list of supported

< msgid >), (list of supported < result >)

Response

OK or

+CIS ERROR: <err>

NO_SAVE

Max Response Time -

Reference

Defined Values

<id>

<msgid>

<result>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, message id, the same to +MIPLPARAMETER

Integer, set parameter result, 2 indicates set parameter success

1 Read/Observe/Discover OK

2 Write/Execute/Set parameter OK

11 400 Bad request

12 401 Unauthorized

13 404 Not Found

14 405 Method Not Allowed

15 406 Not Acceptable

Example

AT+MIPLPARAMETERRSP=?

+MIPLPARAMETERRSP: (0),(0-4294967295),(1-2,11-15)

OK www.simcom.com 281 / 331

SIM7020 Series_AT Command Manual_V1.05

15.2.15 AT+MIPLNOTIFY Notify Data Value Change from User

AT+MIPLNOTIFY Notify Data Value Change from User

Test Command

AT+MIPLNOTIFY=?

Write Command

AT+MIPLNOTIFY=<id>,<ms gid>,<objectid>,<instanceid

>,<resourceid>,<valuetype>

,<len>,<value>,<index>,<fla g>[,<ack>]

Parameter Saving Mode

Response

+ MIPLNOTIFY : (list of supported < id >), (list of supported

< msgid >), (list of supported < objectid >), (list of supported

< instanceid >), (list of supported < resourceid >), (list of supported

< valuetype >),(list of supported < len >),(list of supported < value >),(list of supported < index >),(list of supported < flag >),(list of supported

< ack >)

Response

OK or

+CIS ERROR: <err>

NO_SAVE

- Max Response Time

Reference

Defined Values

<id>

<msgid>

<objectid>

<instanceid>

<resourceid>

<valuetype>

<len>

<value>

<index>

<flag>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, message id

Integer, object id

Integer, instance id

Integer, resource id

Integer, read data value type

1 String

2 Opaque

3 Integer

4 Float

5 Bool

Integer, write data length. It can be omitted, if valuetype is Integer or

Float, or Bool

Integer, write data value

Integer, message index, from 0 to 1024

Integer, message flag

1 First message

2 Middle message www.simcom.com 282 / 331

SIM7020 Series_AT Command Manual_V1.05

0 Last message

<ack> Integer, ack id [option]

If omit it, there is no result URC after this command

Example

AT+MIPLNOTIFY=?

+MIPLNOTIFY:

(0),(0-4294967295),(0-4294967295),(0-63),(0-4294967295),(1-5),(0-1024),"value",(0-102

4),(0-2),(0-4294967294)

15.2.16 AT+MIPLVER Read Version

AT+MIPLVER Read Version

Read Command

AT+MIPLVER?

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<version>

Example

AT+MIPLVER?

+MIPLVER: 2.3.0

Response

+MIPLVER: < version >

NO_SAVE

OneNet version, such as 2.2.0 www.simcom.com 283 / 331

SIM7020 Series_AT Command Manual_V1.05

15.2.17 +MIPLREAD Read Request to User

+MIPLREAD Read Request to User

Response

MIPLREAD: <id>,<msgid>,<objectid>,<instanceid>,<resourceid>

Defined Values

<id>

<msgid>

<objectid>

<instanceid>

<resourceid>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, message id

Integer, object id

Integer, instance id, read all resources of all instances of the object if instanceid equals -1

Integer, resource id, read all resources of the instance if resourceid equals -1

15.2.18 +MIPLWRITE Write Request to User

+MIPLWRITE Write Request to User

Response

+MIPLWRITE:

<id>,<msgid>,<objectid>,<instanceid>,<resourceid>,<valuetype>

,<len>,<value>,<flag>,<index>

Defined Values

<id> Integer, OneNet instance returned by AT+MIPLCREATE

<msgid>

<objectid>

Integer, message id

Integer, object id

<instanceid>

<resourceid>

<valuetype>

<len>

Integer, instance id

Integer, resource id

Integer, write data value type

1 String

2 Opaque

3 Integer

4 Float

5 Bool

Integer, write data length. It can be omitted, if valuetype is Integer or www.simcom.com 284 / 331

SIM7020 Series_AT Command Manual_V1.05

<value>

<flag>

Float, or Bool

Integer, write data value

Integer, message flag

1 First message

2 Middle message

0 Last message

Integer, message index, from 0 to 1024 <index>

15.2.19 +MIPLEXECUTE Execute Request to User

+MIPLEXECUTE Execute Request to User

Response

+MIPLEXECUTE:

<id>,<msgid>,<objectid>,<instanceid>,<resourceid>,<len>,<argu ments>

Defined Values

<id>

<msgid>

<objectid>

<instanceid>

<resourceid>

<len>

<arguments>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, message id

Integer, object id

Integer, instance id

Integer, resource id

Integer, parameter length

String, parameter string

15.2.20 +MIPLOBSERVE Observe Request to User

+MIPLOBSERVE Observe Request to User

Response

+MIPLOBSERVE:

<id>,<msgid>,<flag>,<objectid>,<instanceid>,<resourceid>

Defined Values

<id> Integer, OneNet instance returned by AT+MIPLCREATE www.simcom.com 285 / 331

SIM7020 Series_AT Command Manual_V1.05

<msgid>

<flag>

<objectid>

<instanceid>

<resourceid>

Integer, message id

Integer, observe flag.

1 Indicates observe

0 Indicates cancel observe

Integer, object id

Integer, instance id, observe all resources of all instances of the object if instanceid equals -1

Integer, resource id, observe all resources of the instance if resourceid equals -1

15.2.21 +MIPLDISCOVER Discover request to User

+MIPLDISCOVER Discover request to User

Response

+MIPLDISCOVER: <id>,<msgid>,<objectid>

Defined Values

<id> Integer, OneNet instance returned by AT+MIPLCREATE

<msgid>

<objectid>

Integer, message id

Integer, object id

15.2.22 +MIPLPARAMETER Set Parameter Request to User

+MIPLPARAMETER Set Parameter Request to User

Response

+MIPLPARAMETER:

<id>,<msgid>,<objectid>,<instanceid>,<resourceid>,<len>,<para meter>

Defined Values

<id> Integer, OneNet instance returned by AT+MIPLCREATE

<msgid>

<objectid>

Integer, message id

Integer, object id

<instanceid> Integer, instance id, observe all resources of all instances of the object if instanceid equals -1 www.simcom.com 286 / 331

SIM7020 Series_AT Command Manual_V1.05

<resoreceid>

<len>

<parameter>

Integer, resource id, observe all resources of the instance if resourceid equals -1

Integer, parameter length

String, parameter string, must start with "and end with" pmin=xxx; pmax=xxx; gt=xxx; lt=xxx; stp=xxx

15.2.23 +MIPLEVENT Event Indication to User

+MIPLEVENT Event Indication to User

Response

+MIPLEVENT: <id>,<evtid>[,<extend>]

Defined Values

<id>

<evtid>

<extend>

Integer, OneNet instance returned by AT+MIPLCREATE

Integer, event id

1 BOOTSTRAP_START

2 BOOTSTRAP_SUCCESS

3 BOOTSTRAP_FAILED

4 CONNECT_SUCCESS

5 CONNECT_FAILED

6 REG_SUCCESS

7 REG_FAILED

8 REG_TIMEOUT

9 LIFETIME_TIMEOUT

10 STATUS_HALT

11 UPDATE_SUCCESS

12 UPDATE_FAILED

13 UPDATE_TIMEOUT

14 UPDATE_NEED

15 UNREG_DONE

20 RESPONSE_FAILED

21 RESPONSE_SUCCESS

25 NOTIFY_FAILED

26 NOTIFY_SUCCESS

Integer, extend parameter [option]

The events of RESPONSE_FAILED and NOTIFY_FAILED can take msgid

The events of UPDATE_NEED can take LIFETIME(unit is second)

The events of RESPONSE_SUCCESS can take ack www.simcom.com 287 / 331

SIM7020 Series_AT Command Manual_V1.05

16 AT Commands for NVRAM

Application

16.1 Overview of AT Commands for NVRAM Application

Command

AT+CNVMR

AT+CNVMW

AT+CNVMIVD

AT+CNVMGET

Description

Read data from NVRAM

Write data to NVRAM

Invalidate a specific data item in NVRAM

Get all Customer Data Item IDs from NVRAM

16.2 Detailed Descriptions of AT Commands for NVRAM Application

16.2.1 AT+CNVMR Read Data from NVRAM

AT+CNVMR Read Data from NVRAM

Test Command

AT+CNVMR=?

Write Command

AT+CNVMR=<data_item_na me>

Parameter Saving Mode

Response

+CNVMR: "Data item name"

Response

+CNVMR:

<read_status>[,<data_item_name>,<length>,<nvram_data>]

OK or

ERROR

NO_SAVE

Max Response Time

Reference

- www.simcom.com 288 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<read_status>

<data_item_name>

<length>

<nvram_data>

Example

AT+CNVMR=?

+CNVMR: "Data item name"

If the succeeds, it is 0.Otherwise, it is the error code.

0 Success

-4 Means the data item wasn't found by the NVRAM.

There may be other error codes.

A string parameter which indicates the NVRAM data item name, the string length can be from 1 to 20.

Integer, the length of the <data_item_name> item NVRAM Data.

A string parameter which indicates the NVRAM data.

16.2.2 AT+CNVMW Write Data to NVRAM

AT+CNVMW Write Data to NVRAM

Test Command

AT+CNVMW=?

Write Command

AT+CNVMW=<data_item_na me>,<nvram_data>,<length

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<write_status>

Response

+CNVMW: "Data item name","Data item value",(1-1024)

Response

+CNVMR: +CNVMW: <write_status>

OK or

ERROR

NO_SAVE

If the succeeds, it is 0.Otherwise, it is the error code.

0 Success www.simcom.com 289 / 331

SIM7020 Series_AT Command Manual_V1.05

<data_item_name>

<nvram_data>

-7 Means no enough customers NVRAM space.

There may be other error codes.

A string parameter which indicates the data item name you want to write, the string length can be from 1 to 20.

A string parameter which indicates the data you want to write in to

NVRAM, the data length can be from 1 to 1024.

Integer, the length of the <nvram_data>,can be from 1 to 1024. <length>

Example

AT+CNVMW=?

+CNVMW: "Data item name","Data item value",(1-1024)

16.2.3 AT+CNVMIVD Invalidate a Specific Data Item in NVRAM

AT+CNVMIVD Invalidate a Specific Data Item in NVRAM

Test Command

AT+CNVMIVD=?

Write Command

AT+CNVMIVD=<data_item_ name>

Parameter Saving Mode

Response

+CNVMIVD: "Data item name"

Response

+CNVMIVD: <status>

OK or

ERROR

NO_SAVE

- Max Response Time

Reference

Defined Values

<status>

<data_item_name>

If the succeeds, it is 0.Otherwise,it is the error code.

0 Success

-4 Means the data item wasn't found by the NVRAM.

There may be other error codes.

A string parameter which indicates the data item name you want to write, the string length can be from 1 to 20. www.simcom.com 290 / 331

SIM7020 Series_AT Command Manual_V1.05

Example

AT+CNVMIVD=?

+CNVMW: "Data item name","Data item value",(1-1024)

16.2.4 AT+CNVMGET Get all Customer Data Item IDs from NVRAM

AT+CNVMGET Get all Customer Data Item IDs from NVRAM

Execution Command

AT+CNVMGET

Parameter Saving Mode

Response

If successful, return:

+CNVMGET: <id>,<group_name>,<data_item_name>

If no customer NVRAM data item, return:

+CNVMGET: NULL

OK or

ERROR

NO_SAVE

- Max Response Time

Reference

Defined Values

<id>

<group_name>

<data_item_name>

The id of the data item.

A string parameter which indicates the group name you have wrote in to NVRAM.

A string parameter which indicates the data item name you have wrote in to NVRAM with AT+CNVMW. www.simcom.com 291 / 331

SIM7020 Series_AT Command Manual_V1.05

17 AT Commands for CT IOT Platform

17.1 Overview of AT Commands for CT IOT Platform

Command

AT+CM2MCLINEW

AT+CM2MCLISEND

AT+CM2MCLIDEL

AT+CM2MCLIGET

AT+CCTUPNUM

AT+CCTLASTSTAT

+CM2MCLI

+CM2MCLIRECV

Description

Send data to CT IOT Platform

Deregister to CT IOT Platform

Get the latest 6 received data

Set update registration retry times

Query the latest status of IoT

CT IOT client notification

Receive data from CT IOT platform

17.2 Detailed Descriptions of AT Commands for CT IOT Platform

17.2.1 AT+CM2MCLINEW Register to CT IOT Platform

AT+CM2MCLINEW Register to CT IOT Platform

Write Command

AT+CM2MCLINEW=<server

>,<port>,<endpoint>[,<lifeti me>[,<pskid>,<psk>]]

Parameter Saving Mode

Response

+CM2MCLI: 1

+CM2MCLI: 4 or

ERROR

NO_SAVE

Max Response Time

Reference

- www.simcom.com 292 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<server>

<port>

<endpoint>

<lifetime>

<pskid>

String, LwM2M server IP address of CT IOT platform.

Integer, LwM2M server port of CT IOT platform.

String, Endpoint name, the format should be "xxx", xxx is the IMEI of device.

Integer, The time interval to send "update registration" to CT IOT platform, Don't update by default.

String, Mandatory for DTLS register, use device's IMEI for CT IOT platform.

String, Mandatory for DTLS register, supply by CT IOT platform. <psk>

17.2.2 AT+CM2MCLISEND Send Data to CT IOT Platform

AT+CM2MCLISEND Send Data to CT IOT Platform

Write Command

AT+CM2MCLISEND=<data>

Parameter Saving Mode

Response

+CM2MCLI: 5 or

ERROR

NO_SAVE

- Max Response Time

Reference

Defined Values

<data> String, HEX format, should be even, the supported characters are

0~9, A~F, a~f.

17.2.3 AT+CM2MCLIDEL Deregister to CT IOT Platform

AT+CM2MCLIDEL Deregister to CT IOT Platform

Execute Command

AT+CM2MCLIDEL

Response

+CM2MCLI: 3 or www.simcom.com 293 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

ERROR

NO_SAVE

17.2.4 AT+CM2MCLIGET Get the Latest 6 Received Data

AT+CM2MCLIGET Get the Latest 6 Received Data

Read Command

AT+CM2MCLIGET?

Parameter Saving Mode

Response

No Data!

OK or

+CM2MCLIRECV: <data>

[[+CM2MCLIRECV: <data>]

...]

OK or

ERROR

NO_SAVE

Max Response Time

Reference

Example

AT+CM2MCLIGET?

No Data!

17.2.5 AT+CCTUPNUM Set Update Registration Retry Times

AT+CCTUPNUM Set Update Registration Retry Times

Test Command

AT+CCTUPNUM=?

Response

+CCTUPNUM: (range of supported <num> s )

OK www.simcom.com 294 / 331

SIM7020 Series_AT Command Manual_V1.05

Read Command

AT+CCTUPNUM?

Write Command

AT+CCTUPNUM=<num>

Response

+CCTUPNUM: <num>

Response

OK or

ERROR

NO_SAVE Parameter Saving Mode

Max Response Time

Reference

Defined Values

<num> Integer, retry times when update registration fail.

0-100

Example

AT+CCTUPNUM=?

+CCTUPNUM: (0-100)

AT+CCTUPNUM=?

+CCTUPNUM: 0

17.2.6 AT+CCTLASTSTAT Query the Latest Status of IoT

AT+CCTLASTSTAT Query the Latest Status of IoT

Read Command

AT+CCTLASTSTAT?

Parameter Saving Mode

Response

+CCTLASTSTAT: <status>

NO_SAVE

Max Response Time

Reference

- www.simcom.com 295 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<status>

Example

AT+CCTLASTSTAT?

+CCTLASTSTAT: 0

Integer, see the following IoT client notification chapter.

17.2.7 +CM2MCLI CT IOT Client Notification

+CM2MCLI CT IOT Client Notification

Response

+CM2MCLI: <n>

Defined Values

<n> Integer, Notification.

0 Response error

1 Device registered to CT IOT platform successfully

2 Device updated registration to CT IOT platform successfully

3 Device deregistered to CT IOT platform successfully

4 Device received object 19 observation successfully from CT

IOT platform

5 Device sent data to CT IOT platform

6 Reserve, define later

7 Device registered to CT IOT platform failed

17.2.8 +CM2MCLIRECV Receive data from CT IOT Platform

+CM2MCLIRECV Receive data from CT IOT platform

Response

+CM2MCLIRECV: <data> www.simcom.com 296 / 331

SIM7020 Series_AT Command Manual_V1.05

Defined Values

<data> String, HEX format, should be even, the supported characters are

0~9, A~F, a~f. www.simcom.com 297 / 331

SIM7020 Series_AT Command Manual_V1.05

18 AT Commands for DM Application

18.1 Overview of AT Commands for DM Application

Command

AT+DMCONFIGEXT

AT+DMSET

Description

Configure parameters for DM

Set DM state

18.2 Detailed Descriptions of AT Commands for DM Application

18.2.1 AT+DMCONFIGEXT Configure parameters for DM

AT+DMCONFIGEXT Configure parameters for DM

Test Command

AT+DMCONFIGEXT=?

Write Command

AT+DMCONFIGEXT=<addr>

,<bs>,<appkey>,<pwd>,<life time>

Parameter Saving Mode

Response

+DMCONFIGEXT: (0-255).(0-255).(0-255).(0-255), (0,1), "appkey",

"pwd",( list of supported <lifetime>)

Response

OK or

ERROR

AUTO_SAVE

Max Response Time

Reference

Defined Values

<addr>

<bs>

String, DM host IP address

Integer, DM host bootstrap value

0 Bootstrap disabled www.simcom.com 298 / 331

SIM7020 Series_AT Command Manual_V1.05

<appkey>

<pwd>

<lifetime>

1 Bootstrap enabled

Such as: 117.161.2.7, bs value is set to 0

String, appkey for register DM

String, secret key for register DM

Integer, lifetime for register DM

Example

AT+DMCONFIGEXT=?

+DMCONFIGEXT:

(0-255).(0-255).(0-255).(0-255),(0-1),"appkey","pwd",(15-268435455)

18.2.2 AT+DMSET Set DM State

AT+DMSET Set DM State

Test Command

AT+DMSET=?

Read Command

AT+DMSET?

Write Command

AT+DMSET=<value>

Parameter Saving Mode

Response

+DMSET: (0-1)

Response

+DMSET: (value)

Response

OK or

ERROR

AUTO_SAVE_REBOOT

Max Response Time

Reference

Defined Values

<value>

Integer, set DM on or off state

0 DM off

1 DM on www.simcom.com 299 / 331

Example

AT+DMSET=?

+DMSET: (0-1)

AT+DMSET?

+DMSET: 0

SIM7020 Series_AT Command Manual_V1.05 www.simcom.com 300 / 331

SIM7020 Series_AT Command Manual_V1.05

19 AT Commands for FOTA

Application

19.1 Overview of AT Commands for FOTA Application

Command

AT+CFOTA

AT+CFLE

AT+CFLW

AT+CFLR

Description

FOTA Operation

Flash Erase

Flash Write

Flash Read

19.2 Detailed Descriptions of AT Commands for FOTA Application

19.2.1 AT+CFOTA FOTA Operation

AT+CFOTA FOTA Operation

Write Command

AT+CFOTA=<mode>[,versio n][,<len>,<md5>]

Parameter Saving Mode

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

- Max Response Time

Reference

Defined Values

<mode> Operation type

1 Download and update differential package by TCP

2 Download differential package by TCP, not update

3 Update differential package after <mode>=2 www.simcom.com 301 / 331

SIM7020 Series_AT Command Manual_V1.05

<len>

<md5>

4 Report update result to FOTA server

5 Update differential package after local download

The update differential package length

The update differential package MD5 check value

NOTE

 When < mode >=1 or 2

The PDP connect should be OK.

Domain name resolution should be OK.

 < version > The new version which customer want to update, if you omit it, the module will update to the newest version in the OTA server. The < version > just support when < mode >=1 or 2.

 When < mode >=5 need parameter < len > and < md5 >.

Local download need use AT+CFLE and AT+CFLW.

19.2.2 AT+CFLE Flash Erase

AT+CFLE Flash Erase

Write Command

AT+CFLE=<mode>,<addr>,< num>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mode>

Response

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

<addr>

<num>

0 Erase FOTA update partition

1 Erase flash reserved partition

Erase address

0 FOTA partition address is fixed when <mode>=0

138346496-138412032 Flash reserved partition valid address area

(0x083F0000-0x08400000), the value should be decimal format, when

<mode>=1.

Flash block number

1-145 Flash block number when <mode>=0

1-16 Flash block number when <mode>=1 www.simcom.com 302 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 FOTA partition 0x0830F000-0x083A5000,600KB

 FOTA update partition 0x08313000- 0x083A4000,580KB

 FLASH reserved partition 0x083F0000-0x08400000,64KB

 The size one flash block is 4KB

19.2.3 AT+CFLW Flash Write

At+CFLW Flash Write

Write Command

AT+CFLW=<mode>,<addr>,

<len>,<offset>,<timeout>

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<mode>

Response

">",

Then enter data mode for inputting data until <len> is meet, and write data to flash.

If <timeout> expired, cancel the operation

ERROR

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

<addr>

<len>

<offset>

<timeout>

0 Write FOTA update partition

1 Write Flash reserved partition

Write address

0 FOTA partition address is fixed when <mode>=0

138346496-138412032 Flash reserved partition valid address area

(0x083F0000-0x08400000), the value should be decimal format

The data-length for writing, maximum 512 bytes each time

The offset added for writing not exceeding 580KB when < mode >=0 not exceeding 64KB when < mode >=1

Timeout for writing, unit: s, maximum 100s www.simcom.com 303 / 331

SIM7020 Series_AT Command Manual_V1.05

NOTE

 Before write flash, should erase flash first

19.2.4 AT+CFLR Flash Read

AT+CFLR Flash Read

Write Command

AT+CFLR=<addr>,<len>

Parameter Saving Mode

Response

+CFLR: <data>

If error is related to ME functionality:

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<addr>

<len>

<data>

138346496-138412032 Flash reserved partition valid address area

(0x083F0000-0x08400000), the value should be decimal format.

137441280-138035200 FOTA update partition

(0x08313000-0x083A4000), the value should be decimal format.

The data-length for reading, maximum 512 bytes each time

The data which is read will be putted out by UART port

NOTE

 FOTA update partition not support read. www.simcom.com 304 / 331

SIM7020 Series_AT Command Manual_V1.05

20 AT Commands for SIM Toolkit

Application

20.1 Overview of AT Commands for SIM Toolkit Application

Command

AT*MSTLOCK

AT*MSTPD

AT*MSTMODE

AT*MSTICREC

AT*MSTICIMG

AT*MSTGC

AT*MSTCR

AT*MSTMS

AT*MSTEV

Description

APP Registering for SIM Toolkit (And Locking To A Channel)

SIM Toolkit Terminal Profile Download

Setting Format for SIM Toolkit Output

Obtaining Icon Records

Obtaining Icon Image

APP Request for Parameters Associated with a Previously Reported

Proactive Command

APP Informing PS of Response to Proactive Command

Menu Selection by User

APP Specific Monitored Event Occurrence

20.2 Detailed Descriptions of AT Commands for SIM Toolkit Application

20.2.1 AT*MSTLOCK APP Registering for SIM Toolkit (and locking to a channel)

AT*MSTLOCK APP Registering for SIM Toolkit (and locking to a channel)

Write Command

AT*MSTLOCK=<data>[,<tim eout>]

This command registers/de-registers the CI task with the SIMAT task so it receives any relevant SIM toolkit activity. The channel on which this AT command is received is used as the channel allocation for the unsolicited results and data. A further optional parameter supplies the length of time to set the modem user response timer.

Response

OK or www.simcom.com 305 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<data>

+CME ERROR: <err>

+STC: 0

NO_SAVE

<timeout>

Decimal digit

0 Applications processor de-registers for SIM Toolkit activity

1 Register applications processor for SIM toolkit activity. (The same channel used for this command will be used for all unsolicited result codes from receipt of this.)

User response timer – time set in seconds. Max timeout value is 3600 seconds. When enabled the timeout value remains operational until the command is re-entered with a timeout value of 0 or the ME is powered down(default 0).

20.2.2 AT*MSTPD SIM Toolkit Terminal Profile Download

AT*MSTPD SIM Toolkit Terminal Profile Download

Write Command

AT*MSTPD=<length>[,<data

Parameter Saving Mode

AT command to provide/modify MMI specific terminal profile parameters to the CI Task. The MMI profile is stored in NVRAM on the modem and read at start-up. The value stored in NVRAM may be changed using this command. If this is modified after SAT initialization the modified value will not be sent to the (U)SIM until after a power cycle.

Response

OK or

+CME ERROR: <err>

+STC: 0

NO_SAVE

Max Response Time

Reference

Defined Values

<length>

Integer, determines the number of bytes of <data> used for the APP www.simcom.com 306 / 331

SIM7020 Series_AT Command Manual_V1.05

<data> data for the terminal profile.

Hexadecimal representation of the <length> number of bytes with bits set by APP to indicates which of the parameters in the byte definition table given above are to be enabled in the terminal profile.

20.2.3 AT*MSTMODE Setting format for SIM Toolkit Output

AT*MSTMODE Setting format for SIM Toolkit Output

Test Command

AT*MSTMODE=?

Read Command

AT*MSTMODE?

Write Command

AT*MSTMODE=<mode>

Parameter Saving Mode

AT Command for setting the format of SIM Application Toolkit output.

The format may be set to PDU or Text Mode.

Response

*MSTMODE: (list of supported < mode >s) or

+CME ERROR: <err>

Response

*MSTMODE: <mode> or

+CME ERROR: <err>

Response

OK or

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<mode>

Integer

0 PDU Mode

1 Text Mode

2 CMGF Mode (default, will use AT+CMGF setting)

Example

AT*MSTMODE=?

*MSTMODE: (0-2)

OK www.simcom.com 307 / 331

SIM7020 Series_AT Command Manual_V1.05

AT*MSTMODE?

*MSTMODE: 2

20.2.4 AT*MSTICREC Obtaining Icon records

AT*MSTICREC Obtaining Icon records

Read Command

AT*MSTICREC?

Write Command

AT*MSTICREC=<rNum>

Parameter Saving Mode

AT command for obtaining ICON image record information. – proactive commands may include an icon record in command data – this should be displayed as part of any user interaction for the proactive command.

Response

*MSTICREC: <number of icon records on the SIM/UICC> or

+CME ERROR: <err>

Response

*MSTICREC: <rNum>,<numInstances>,[<CR><LF>*MSTICREC:

<width>,<height>,<cs>,<efId>,<offset>,<length>[...]] or

+CME ERROR: <err>

NO_SAVE

- Max Response Time

Reference

Defined Values

<rNum>

<numInstances>

<width>

<height>

<cs>

<efId>

<offset>

<length>

Integer, the number of the icon record to be read from the SIM/UICC.

Integer, the number of instance data records within this image record.

Integer, width of this image instance expressed in raster image points.

Integer, height of this image instance expressed in raster image points.

Integer, coding scheme.

0 basic coding(default)

1 color coding

Hexadecimal representation of the Image Instance file to be read on the SIM/UICC – two bytes of data ordered MSB LSB.

Integer, number of bytes offset from start of the file to begin reading.

Integer, number of bytes to be read. www.simcom.com 308 / 331

SIM7020 Series_AT Command Manual_V1.05

20.2.5 AT*MSTICIMG Obtaining Icon image

AT*MSTICIMG Obtaining Icon image

Write Command

AT*MSTICIMG=<efID>[,<offs et>],<length>

Parameter Saving Mode

AT command to get ICON image instance data. This image instance data is referenced in the icon record to make up the icon to display.

Response

*MSTICIMG: <length>,<data> or

+CME ERROR: <err>

NO_SAVE

- Max Response Time

Reference

Defined Values

<efId>

<offset>

<length>

<data>

Hexadecimal representation of the Image Instance file to be read on the SIM/UICC – two bytes of data ordered MSB LSB.

Integer, Number of bytes offset from start of the file to begin reading from.

Integer, Number of bytes of image instance data to read/was read.

String containing a list of hex values for bytes of image instance data.

20.2.6 AT*MSTGC APP request for parameters associated with a previously reported Proactive Command

AT*MSTGC APP request for parameters associated with a previously reported

Proactive Command

Write Command

AT*MSTGC=<cmdId>

AT command to Get Command parameters for a proactive SIM command from the CI Task. This will be sent from the application after unsolicited result code *MSTC: <cmdId> informs it the SIM has issued a proactive SIM command which requires user interaction.

Response

*MSTGC: <cmdId>,<data> or

+CME ERROR: <err> www.simcom.com 309 / 331

SIM7020 Series_AT Command Manual_V1.05

Parameter Saving Mode

Max Response Time

Reference

Defined Values

<cmdId>

<data>

NO_SAVE

Decimal notation, Command Type value.

Proactive command specific data, dependent on <cmdId>.

20.2.7 AT*MSTCR APP Informing PS of Response to Proactive Command

AT*MSTCR APP Informing PS of Response to Proactive Command

Write Command

AT*MSTCR=<cmdId>,<resul t>[,<data>]

Parameter Saving Mode

AT command to provide Command Response parameters for a previously fetched proactive SIM command. Its purpose is to relay response data to the lower layers of the protocol stack to allow the

Terminal Response SIM command to be returned to the SIM for the current proactive command.

Response

OK or

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<cmdId>

<result>

<data>

Decimal notation, Command Type value.

Decimal notation, dependent on the command type – see following sections for each proactive command supported.

Additional data provided for certain commands, as required for the

Terminal Response returned to the SIM after processing a proactive

SIM command.

20.2.8 AT*MSTMS Menu Selection by User www.simcom.com 310 / 331

SIM7020 Series_AT Command Manual_V1.05

AT*MSTMS Menu Selection by User

Test Command

AT*MSTMS=?

Write Command

AT*MSTMS=<item>[,<help>]

Parameter Saving Mode

AT Command for selecting a menu option. On power-up the SIM will send the Set-Up-Menu proactive indication. The Application Processor

(M4) loads and displays the menu structure. This AT command is used when an item from this menu is selected.

Response

*MSTMS: <first menu item id – last menu item id>,<0-1> or

+CME ERROR: <err>

Response

OK or

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<mode> Integer, identifying an item in the menu items list.

<help> Integer.

0 no help requested

1 help requested

NOTE

 For example, AT*MSTMS=2,1 will select item 2 from the main menu with help. (This response would result in an ENVELOPE command being passed to the SIM/UICC to indicate the item and that help is requested – as a result of this a proactive command – DISPLAY TEXT would be generated to supply the help information to the user)

20.2.9 AT*MSTEV APP specific monitored event occurrence

AT*MSTEV APP specific monitored event occurrence

Test Command

AT*MSTEV=?

This command is used to inform the MS that an MMI specific event has occurred.

Response www.simcom.com 311 / 331

SIM7020 Series_AT Command Manual_V1.05

Write Command

AT*MSTEV=<event>[,<langu age>][,<charsDownDisplay>

[,<sizingSupported>[,<char sAcrossDisplay>[,<variable

FontSupport>[,<displayResi ze>[,<textWrapping>[,<text

Scrolling>[,<menuWidthRed uction>]]]]]]]]

Parameter Saving Mode

*MSTEV: (supported <event> list) or

+CME ERROR: <err>

Response

OK or

+CME ERROR: <err>

NO_SAVE

Max Response Time

Reference

Defined Values

<event>

<language>

<charsDownDisplay>

<sizingSupported>

<charsAcrossDisplay>

Hex two digits.

05 User Activity Event*

06 Idle Screen Available Event*

08 Language Selection Event

0C Display Parameters Changed two character string representation of the language code. numeric type to indicate how many characters down are displayed

(1-15) numeric type 0 or 1 to indicate FALSE/TRUE. numeric type to indicate how many characters across are displayed

(1-127). numeric type 0 or 1 to indicate FALSE/TRUE. numeric type 0 or 1 to indicate FALSE/TRUE. numeric type 0 or 1 to indicate FALSE/TRUE.

<variableFontSupport>

<displayResize>

<textWrapping>

<textScrolling>

<menuWidthReduction> numeric type 0 or 1 to indicate FALSE/TRUE. numeric type to indicate the allowed menu size reduction (0-7).

NOTE

 The <language> parameter is applicable only to Language Selection Event. For example,

AT*MSTEV=08,”en” indicates that a language selection of English. The language code mapping is as per reference 11.

 The display parameters are only valid for the Display Parameters Changed event.

 * These events are only monitored for once – once they have occurred and are reported they www.simcom.com 312 / 331

SIM7020 Series_AT Command Manual_V1.05 should be removed from the Event List automatically.

20.2.10 *MSTC:<cmdId> Proactive Command Indication

*MSTC: <cmdId> Proactive Command Indication

*MSTC: <cmdId>

Parameter Saving Mode

Max Response Time

The unsolicited result code *MSTC: informs the application processor

(M4) that there is a proactive command that requires some APP activity awaiting retrieval.

NO_SAVE

Reference

Defined Values

<cmdId> Decimal format of Type of Command. Unique identifier for the current

SIM Toolkit proactive command issued by the SIM.

The following values are supported:

‘01’ Refresh

‘05’ Set Up Event List command

‘15’ Launch Browser command

‘20’ Play Tone command

‘21’ Display Text command

‘22’ Get Inkey command

‘23’ Get Input command

‘24’ Select Item command

‘25’ Set Up Menu command

‘28’ Set Up Idle Mode Text command

‘40’ Open Channel

‘42’ Receive Data

‘43’ Send Data

‘81’ End of proactive session

NOTE

 The special case *MSTC: 0 is issued when there are no SIM Toolkit applications accessible on the

SIM/UICC i.e. a non-proactive SIM is being used.

 Receipt of this result code by the application processor (M4) – except in the special cases of

*MSTC: 0 and *MSTC: 81 - should result in an AT*MSTGC=<cmdId> being sent by to request the associated proactive command information. This information is supplied in the AT command www.simcom.com 313 / 331

result.

SIM7020 Series_AT Command Manual_V1.05 www.simcom.com 314 / 331

SIM7020 Series_AT Command Manual_V1.05

21 Supported Unsolicited Result

Codes and Error Codes

21.1 Summary of CME ERROR Codes

Final result code +CME ERROR: <err> indicates different meaning. 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:

21.1.1 CME Error Codes Related to mobile equipment or network

Code of <err>

Meaning phone failure no connection to phone phone-adaptor 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 315 / 331

SIM7020 Series_AT Command Manual_V1.05

100 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

Incorrect Parameters

Unknown

21.1.2 CME Error Codes related to PSD and Packet Domain

106

107

111

112

113

132

133

134

148

149

150

151

Final result code +CME ERROR: <err> indicates an error related to PSD and Packet Domain. 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:

Code of <err> Meaning

103 Illegal MS

Illegal ME

GPRS services not allowed

PLMN not allowed

Location area not allowed

Roaming not allowed in this location area service option not supported requested service option not subscribed service option temporarily out of order unspecified GPRS error

PDP authentication failure invalid mobile class

Last PDN Disconnection not allowed www.simcom.com 316 / 331

PSD - activation rejected by GGSN

PSD - unspecified activation rejection

PSD - bad code or protocol rejection

PSD - can't modify address

PSD - CHAP close

PSD - profile ( cid

) currently unavailable

PSD - a profile ( cid

) is currently active

PSD - combined services not allowed

PSD - conditional IE error

PSD - context activation rejected

PSD - duplicate TI received

PSD - feature not supported

PSD - service not available

PSD - unknown IE from network

PSD - implicitly detached

PSD - insufficient resources

PSD - invalid activation state (0-1)

PSD - invalid address length

PSD - invalid character in address string

PSD - invalid cid value

PSD - invalid dial string length

PSD - mode value not in range

PSD - invalid MAND information

PSD - SMS service preference out of range

PSD - invalid TI value

PSD - IPCP negotiation timeout

PSD - LCP negotiation timeout

PSD - LLC error

PSD - LLC or SNDCP failure

PSD - lower layer failure

PSD - missing or unknown APN

PSD - mobile not ready

PSD- MS identity not in network

PSD- MSC temporarily not reachable

PSD- message incompatible with state

PSD- message type incompatible with state

PSD- unknown message from network

PSD- NCP close

PSD- network failure

PSD- no echo reply

PSD- no free NSAPIs

SIM7020 Series_AT Command Manual_V1.05

601

602

603

604

605

606

607

608

593

594

595

596

597

598

599

600

609

610

611

612

613

614

615

616

617

585

586

587

588

589

590

591

592

577

578

579

580

581

582

583

584 www.simcom.com 317 / 331

642

643

644

645

646

647

649

650

651

652

653

654

655

634

635

636

637

638

639

640

641

626

627

628

629

630

631

632

633

618

619

620

621

622

623

624

625

656

657

658

PSD- processing of multiple cids

not supported

PSD- no PDP context activated

PSD- normal termination

PSD- NSAPI already used

PSD- address element out of range

PSD- PAP close

PSD- PDP context w/o TFT already activated

PSD- pdp

type not supported

PSD- peer refuses our ACCM

PSD- peer refuses our IP address

PSD- peer refuses our MRU

PSD- peer re-requested CHAP

PSD- profile ( cid

) not defined

PSD- unspecified protocol error

PSD- QOS not accepted

PSD- QOS validation fail

PSD- too many RXJs overflow

SIM7020 Series_AT Command Manual_V1.05

PSD- reactivation required

PSD- regular deactivation

PSD- semantic error in TFT operation

PSD- semantic errors in packet filter

PSD- semantically incorrect message

PSD- service type not yet available

PSD- syntactical error in TFT operation

GPRS - syntactical errors in packet filter

PSD- unknown PDP address or type

PSD- unknown PDP context

PSD- user authorization failed

PSD- QOS invalid parameter

PSD- FDN failure

PSD- bad pdp

context parameters

PSD- PDP context already active

PSD- LCP termination negotiation timeout more than one double colon in IPv6 address

IPv6 address ended with part of an IPv4 address

IPv6 address used dotted-decimal form outside an IPv4 address in an IPv6 address, a byte of an IPv4 address was too big, causing in an IPv6 address, a byte of an IPv4 address was missing in an IPv6 address, a byte of an IPv4 address was more than 255 in an IPv6 address, a byte pair was more than hex ffff www.simcom.com 318 / 331

659

693

694

695

696

697

698

699

700

701

702

703

704

705

681

682

683

684

685

690

691

692

673

674

675

676

677

678

679

680

660

661

662

663

664

665

666

670

671

672 in an IPv6 address, a byte of an IPv4 address was too short or contained invalid characters an IPv6 address was too short or contained invalid characters in an IPv6 address, a byte pair was too big, causing overflow an IPv6 address started with a single colon an IPv6 address ended with a single colon an IPv6 address contained an IPv4 address other than at the end an IPv6 address was too long an IPv6 address was followed by invalid characters

PSD - operator Determined Barring

PSD - activation rejected by GW or PDNGW

PSD – PTI already in use

PSD – EPS Bearer Context without TFT already activated

PSD - PTI mismatch

PSD - PDN Type IPV4 only allowed

PSD – PDN Type IPV6 only allowed

PSD – single address bearers only allowed

PSD – ESM information not received

PSD – PDN connection does not exist

PSD – multiple PDN connection not allowed for one APN

PSD – collision with network initiated request

PSD – unsupported QCI value

PSD – invalid PTI value

PSD – incompatible APN restriction value

PSD – reactivation request

LTE - IMSI unknown in HSS

LTE - illegal UE

LTE - EPS service not allowed

LTE - EPS and non EPS Service not allowed

LTE - UE ID cannot be derived

LTE - EPS tracking area not allowed

LTE - roaming not allowed in TA

LTE - roaming not allowed in PLMN

LTE - no suitable cells in TA

LTE - CS domain not available

LTE - ESM failure

LTE - MAC failure

LTE - synch failure

LTE - congestion

SIM7020 Series_AT Command Manual_V1.05

LTE - UE security capability mismatch

LTE - security mode rejected, unspecified www.simcom.com 319 / 331

SIM7020 Series_AT Command Manual_V1.05

706

707

708

709

710

711

712

713

714

715

LTE - UE not authorized in CSG cell

LTE – non-EPS authorization unacceptable

LTE - CS domain temporarily unavailable

LTE - no EPS bearer context activated

PSD – PSD Mode not possible

PSD – invalid connection type

PSD – no free PSD bearer IDs

PSD – no free PSD PTIs

PSD – unable to open data connection

PSD- Incorrect username/password

21.1.3 CME Error Codes related to select TE character set

Final result code +CME ERROR: <err> indicates an error related to select TE character set. 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:

Code of <err> Meaning

737 +CSCS type not supported

+CSCS type not found 738

21.1.4 CME Error Codes related to preferred operator list

742

743

744

745

746

747

748

Final result code +CME ERROR: <err> indicates an error related to preferred operator list. 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:

Code of <err> Meaning

741 must include <format> with < oper > incorrect < oper > format

< oper > length too long

SIM full unable to change PLMN list network operator not recognized access technology missing access technology not supported www.simcom.com 320 / 331

SIM7020 Series_AT Command Manual_V1.05

21.1.5 CME Error Codes related to Restricted/Generic SIM Access

750

751

752

753

754

755

756

757

758

759

Final result code +CME ERROR: <err> indicates an error related to Restricted/Generic SIM Access. 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:

Code of <err> Meaning

749 invalid command length invalid input string command not allowed for 3G SIM

Invalid < pathid > parameter missing required command parameter invalid SIM command invalid File Id missing required P1/2/3 parameter invalid P1/2/3 parameter missing required command data invalid characters in command data

21.1.6 CME Error Codes related to Miscellaneous Proprietary

722

724

725

726

765

766

767

Final result code +CME ERROR: <err> indicates an error related to Miscellaneous Proprietary. 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:

Code of <err> Meaning

720

721

SIM toolkit menu has not been configured

SIM toolkit already in use

SIM toolkit not enabled

MMI profile not updated invalid SIM toolkit proactive command ID invalid SIM proactive command response data invalid input value unsupported value or mode operation failed www.simcom.com 321 / 331

SIM7020 Series_AT Command Manual_V1.05

768

769

770

772

773

794

795 multiplexer already active unable to get control of required

SIM invalid - network reject

SIM powered down

SIM File not present invalid input value

No valid GId

21.1.7 CME Error Codes related to report Network State

842

843

844

845

846

847

Final result code +CME ERROR: <err> indicates an error related to report Network State. 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:

Code of <err> Meaning

840

841

No Service state

In cell search state

ERRC is deactivated

In cell reselection state

In L1 test mode

In reestablishment state

In PSM state

No data transfer in idle state

21.1.8 CME Errors Codes related to SIM Toolkit Operations

The following CME errors are used for reporting of SIM Toolkit specific problems:

Description Verbose CME

Error

CME error code sim toolkit not enabled 707

Used in response to commands

MSTGC; MSTCR;

MSTEV; MSTMS;

There is no current SIM Toolkit session sim toolkit already in use sim toolkit menu has not been configured

706

705

MSTGC; MSTCR;

MSTEV; MSTMS;

MSTMS;

A proactive SIM Toolkit session is already running for a different entity.

Either there are no menu, or items in the STK menu or the menu has been removed www.simcom.com 322 / 331

APP profile not updated invalid SIM toolkit proactive command ID

709

710 invalid SIM proactive command response data

Invalid characters in text string

711

Invalid index 21

MSTPD;

MSTCR;

MSTMS;

SIM7020 Series_AT Command Manual_V1.05

MSTEV; MSTMS;

The new APP profile download has failed

The command id entered for the

MSTCR does not conform with the current proactive command

The input data associated with the current proactive command is not valid.

Invalid characters in string (i.e. characters in expected numeric string)

The operation failed because the menu or the help item index was not for a valid option

21.2 Summary of CMS ERROR Codes

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:

Code of <err> Meaning

1 Unassigned(unallocated) number

Operator determined barring

Call barred

Short message transfer rejected

Destination out of service

Unidentified subscriber

Facility rejected

Unknown subscriber

Network out of order

Temporary failure

Congestion

Resources unavailable, unspecified

Requested facility not subscribed

Requested facility not implemented

Invalid short message transfer reference value

Invalid message, unspecified

Invalid mandatory information www.simcom.com 323 / 331

331

332

340

500

512

513

515

516

315

316

317

318

320

321

322

330

517

518

519

528

529

530

531

532

533

303

304

305

310

311

312

313

314

111

127

300

301

302

Message type non-existent or not implemented

Message type not compatible with protocol state

Information element non-existent or not implemented

Protocol error, unspecified

Interworking, unspecified

ME failure

SMS reserved operation not allowed operation not supported invalid PDU mode parameter invalid text mode parameter

SIM not inserted

SIM pin necessary

PH SIM pin necessary

SIM failure

SIM busy

SIM wrong

SIM PUK required

SIM PIN2 required

SIM PUK2 required memory failure invalid memory index memory full

SMSC address unknown no network network timeout

No +CNMA acknowledgment expected

Unknown

SIM not ready unread records on SIM

PS busy

Couldn't read SMS parameters from SIM

SM BL not ready invalid parameter

ME temporary not available

Invalid (non-hex) chars in PDU

Incorrect PDU length

Invalid MTI

SIM7020 Series_AT Command Manual_V1.05

Invalid (non-hex) chars in address

Invalid address (no digits read)

Incorrect PDU length (UDL) www.simcom.com 324 / 331

534

536

537

538

539

540

SIM7020 Series_AT Command Manual_V1.05

Incorrect SCA length

Invalid First Octet (should be 2 or 34)

Invalid Command Type

SRR bit not set

SRR bit set

Invalid User Data Header IE

21.3 Summary of CIS ERROR Codes

Final result code +CIS ERROR: <err> indicates an error related to OneNet. 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:

Code of <err> Meaning

651 Memory error

652

653

654

655

Parameter error

Unsupported format

SDK error

Not find

21.4 Summary of TLS ERROR Codes

-67

-68

-69

-70

-72

-74

Final result code +TLS 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:

Code of <err> Meaning

-66 Failed to open a socket

Buffer is too small to hold the data

The connection to the given server / port failed

The context is invalid, e.g. because it was free

Binding of the socket failed

Could not listen on the socket

Could not accept the incoming connection www.simcom.com 325 / 331

-28928

-29056

-29184

- 29312

- 29440

- 29568

-29696

- 29824

-9856

-9984

-10112

-10240

-10368

-10496

-10624

-28800

-8832

-8960

-9088

-9216

-9344

-9472

-9600

-9728

-76

-78

-80

-82

-8320

-8448

-8576

-8704

- 29952

- 30080

- 30208

- 30336

- 30464

- 30592

- 30720

- 30848

Input invalid

Read/write of file failed

SIM7020 Series_AT Command Manual_V1.05

Reading information from the socket failed

Sending information through the socket failed

Connection was reset by peer

Failed to get an IP address for the given hostname

Unavailable feature, e.g. RSA hashing/encryption combination

Requested OID is unknown

The CRT/CRL/CSR format is invalid, e.g. different type expected

The CRT/CRL/CSR version element is invalid

The serial tag or value is invalid

The algorithm tag or value is invalid

The name tag or value is invalid

The date tag or value is invalid

The signature tag or value invalid

The extension tag or value is invalid

CRT/CRL/CSR has an unsupported version number

Signature algorithm (oid) is unsupported

Signature algorithms do not match

Certificate verification failed e.g. CRL, CA or signature check failed

Format not recognized as DER or PEM

Allocation of memory failed

Destination buffer is too small

The requested feature is not available

Bad input parameters to function

Verification of the message MAC failed

An invalid SSL record was received

The connection indicated an EOF

An unknown cipher was received

The server has no ciphersuites in common with the client

No RNG was provided to the SSL module

No client certification received from the client, but required by the authentication mode

Our own certificate(s) is/are too large to send in an SSL message

The own certificate is not set, but needed by the server.

The own private key or pre-shared key is not set, but needed

No CA Chain is set, but required to operate

An unexpected message was received from our peer

A fatal alert message was received from our peer

Verification of our peer failed

The peer notified us that the connection is going to be closed www.simcom.com 326 / 331

- 32000

- 32128

- 32256

-32384

-32512

-26624

-26496

-26368

-26240

- 26112

-16000

- 30976

- 31104

- 31232

- 31360

- 31488

- 31616

- 31744

- 31872

SIM7020 Series_AT Command Manual_V1.05

Processing of the ClientHello handshake message failed

Processing of the ServerHello handshake message failed

Processing of the Certificate handshake message failed

Processing of the CertificateRequest handshake message failed

Processing of the ServerKeyExchange handshake message failed

Processing of the ServerHelloDone handshake message failed

Processing of the ClientKeyExchange handshake message failed

Processing of the ClientKeyExchange handshake message failed in

DHM / ECDH Read Public

Processing of the ClientKeyExchange handshake message failed in

DHM / ECDH Calculate Secret

Processing of the CertificateVerify handshake message failed

Processing of the ChangeCipherSpec handshake message failed

Processing of the Finished handshake message failed

Memory allocation failed

The operation timed out

The client initiated a reconnect from the same port.

Record header looks valid but is not expected

The alert message received indicates a non-fatal error

Couldn't set the hash for verifying CertificateVerify

Incomplete or incorrect certificate

21.5 Summary of Unsolicited Result Codes

URC Description

*MATREADY: 1

+CREG: <stat>[,<lac>,<ci>]

There is a change in the MT network registration status or a change of the network cell.

+CSMINS: <n>,<SIM inserted> Indicates whether SIM card has been inserted.

+CENG: Report of network information.

<cell>,"<arfcn>,<rxl>,<rxq>,< mcc>,<mnc>,<bsic>,<cellid>,< rla>,<txp>,<lac>,<TA>"

+CPIN: <code>

+CPIN: NOT READY

Indicates whether some password is required or not.

SIM Card is not ready.

+CPIN: NOT INSERTED SIM Card is not inserted.

AT Command

AT+CREG=<n>

AT+CSMINS=1

AT+CENG=<mode>[

,<Ncell>]

<mode>=2

AT+CPIN www.simcom.com 327 / 331

SIM7020 Series_AT Command Manual_V1.05

+CSQN: <rssi>,<ber>

+CR: <serv>

Displays signal strength and channel bit error rate when <rssi>,<ber>values change.

An intermediate result code is transmitted during connect negotiation when the TA has determined the speed and quality of service to be used, before any error control or data compression reports are transmitted, and before any final result code (e.g.

NORMAL POWER DOWN

CONNECT) appears.

SIM7020 is powered down by the PWRKEY

UNDER-VOLTAGE POWER

DOWN pin or AT command "AT+CPOWD=1".

Under-voltage automatic power down.

UNDER-VOLTAGE WARNNING under-voltage warning

OVER-VOLTAGE POWER

DOWN

Over-voltage automatic power down.

OVER-VOLTAGE WARNNING over-voltage warning

+CDNSGIP: 1,<domain name>,<IP>[,<IP2>]