Zte ME3000_V2 Installation manual

GSM Module
AT Command Manual
For ZTE Corporation’s ME3000_V2 Module
Version: V1.5
ZTE CORPORATION

GSM Module
Copyright Statement
Copyright © 2010 by ZTE Corporation
All rights reserved.
No part of this publication may be excerpted, reproduced, translated or utilized in any form
or by any means, electronic or mechanical, including photocopying and microfilm, without
the prior written permission of ZTE Corporation.
is the registered trademark of ZTE Corporation. All other trademarks appeared
in this manual are owned by the relevant companies.
ZTE Corporation reserves the right to make modifications on print errors or update
specifications in this manual without prior notice.
ZTE Corporation keeps the right to make the final explanation to this manual.
1

GSM Module
With strong technical force, ZTE Corporation can provide CDMA/GPRS module customers
with the following all-around technical support:
1. Provide complete technical documentation;
2. Provide the development board used for R&D, test, production, after-sales, etc.
3. Provide evaluations and technical diagnosis for principle diagram, PCB, test scenarios;
4. Provide test environment;
ZTE Corporation provides customers with onsite supports, and also you could get supports
through telephone, website, instant communication, E-mail, etc.
The module website module.ztemt.com.cn provides the relevant industry information and
module technical documentation. The authorized module customers could download the
latest technical documentation from our website. If you have more requirements, you could
send an E-mail to module@zte.com.cn. You can also call us at 0755-86360280 for technical
support.
2

GSM Module
Preface
Target Readers
This manual is mainly applicable for the following engineers:
System designing engineers
Hardware engineers
Software engineers
Test engineers
Update History
V1.0
Realize ME3000_V2 module’s self-defined AT commands;
V1.2
Add the function of network LED, complete and verify the server’s function;
V1.3
Modify the commands of ZPPPCLOSE, ZIPSEND, IFC, IPR, ZDNSGETIP, etc.
Adjust the description of CNMI command;
Add the description of CLCC and CSCS command;
Complete the description of ZIPSETUP(U) command;
V1.4
Modify the format of ZMICGB command;
Delete VTD command;
Support ATD>”ZTK01234568#&$” and the call of special symbol;
Add pas=1(not ready, unable to receive AT commands) in CPAS;
Modify the timeout for TCP return succeeded from 20s to 75s;
Prompt of inputting PUK after entering wrong PIN for three times
Do not display the characters transmitted excessively through AT+ZIPSEND command;
V1.5
1. Add new commands: ZBCCH, ZOPT, ZCALIST & ZBAND
2. Support baud rate 19200 in IPR command;
3. Add the command of ztcptimeout and ziptimeout;
4. Add the function of supporting 3G card;
5. Modify the server’s function and support 2 users connected;
3

GSM Module
Contents
1General Description ....................................................... 8
1.1 Description of AT Commands .......................................................8
1.1.1 Type of AT Commands .......................................................8
1.1.2 Returned Format of AT Commands ...........................................8
1.1.3 AT Command Format ........................................................ 8
1.2 Abbreviations...................................................................... 9
2AT Commands ........................................................... 12
2.1 Common Commands .............................................................12
2.1.1 A/: repeat..................................................................12
2.1.2 ATA: answer ................................................................12
2.1.3 ATD: dial ................................................................... 12
2.1.4 ATDL: dial last ..............................................................13
2.1.5 ATE: enable ................................................................13
2.1.6 ATH: hang up............................................................... 13
2.1.7 ATI: Information.............................................................14
2.1.8 ATQ: set whether or not to display the returned value. ........................14
2.1.9 +++: switch from data mode to command mode............................. 14
2.1.10 ATO: switch from command mode to data mode ............................14
2.1.11 ATP: pulse .................................................................. 15
2.1.12 ATS0: auto answer setting ................................................... 15
2.1.13 +CRC: set ringer type ....................................................... 15
2.1.14 +CLVL: volume level ........................................................ 16
2.1.15 +CLIP: Calling Line Identification Presentation ................................ 16
2.1.16 +ZSETMUTE: mute control ....................................................16
2.1.17 +CIMI: International Mobile Identification..................................... 17
2.1.18 +CGMR: get product version ................................................ 17
2.1.19 +ECHO: echo remove ......................................................17
2.1.20 +(C)GSN: get current IMEI ................................................... 17
2.1.21 +ZVERS: get current software version ......................................... 18
2.1.22 +CLCK: lock ................................................................18
2.1.23 +CCFC: call forwarding number and conditions ..............................19
2.1.24 +CCWA: call waiting........................................................21
2.1.25 +CHLD: call hold............................................................ 22
2.1.26 *TSIMINS: check SIM card status.............................................. 22
2.1.27 +CPWD: change password.................................................. 23
2.1.28 +CGMI: inquire manufacturer’s information .................................. 23
2.1.29 ATZ: reset................................................................... 23
2.1.30 +CSCS: character set selection ..............................................24
2.1.31 +CLCC: check call status ...................................................24
2.2 DTMF Command..................................................................26
2.2.1 +VTS: send DTMF............................................................ 26
4

GSM Module
2.3 Network Service Command ....................................................... 26
2.3.1 +CREG: network registration and roaming....................................26
2.3.2 +COPS: network selection ...................................................27
2.4 Mobile Device Control and Status Report........................................... 28
2.4.1 +CPAS: check module’s status............................................... 28
2.4.2 +CFUN: set module’s function ...............................................28
2.4.3 +CMEE: mobile equipment errors ............................................ 28
2.4.4 +ZPWROFF: power off .......................................................29
2.4.5 +CPIN: input PIN ............................................................ 29
2.4.6 +CSQ: check signal strength................................................. 29
2.4.7 +CCLK: clock management.................................................30
2.5 Message Service Command....................................................... 31
2.5.1 +CSCA: SMS center number .................................................31
2.5.2 +CNMA: message acknowledgement ....................................... 31
2.5.3 +CMGF: SMS mode ......................................................... 31
2.5.4 +CNMI: message indication ................................................. 32
2.5.5 +CMGR: message read ..................................................... 34
2.5.6 +CSMS: select SMS service...................................................35
2.5.7 +CMGS: message send ..................................................... 36
2.5.8 +CPMS: preferred message storage..........................................36
2.5.9 +CMGD: message delete ...................................................37
2.5.10 +CMGL: message list........................................................38
2.5.11 +CMSS: messages saved in SIM card ......................................... 40
2.5.12 +ZSMGS: message full indication ............................................. 40
2.6 Phonebook Command............................................................ 41
2.6.1 +CPBS: phonebook storage ................................................. 41
2.6.2 +CPBR: phonebook read.................................................... 41
2.6.3 +CPBW: phonebook write ................................................... 42
2.6.4 +CPBF: phonebook find .....................................................43
2.6.5 +CNUM: owner’s number ................................................... 44
2.7 Data Compression Command ..................................................... 45
2.7.1 +IFC: flow control ........................................................... 45
2.7.2 &D: set DTR mode ..........................................................45
2.7.3 &C: set DCD mode .........................................................45
2.7.4 +IPR: set module’s baud rate ................................................ 45
2.7.5 &F: restore factory settings .................................................. 46
2.7.6 &W: save settings ........................................................... 46
2.8 GPRS Command.................................................................. 47
2.8.1 +CGDCONT: set PDP format................................................. 47
2.8.2 +CGACT: activate/deactivate PDP ..........................................47
2.8.3 +CGATT: set GPRS service ................................................... 47
2.8.4 +CGCLASS : GPRS device class .............................................. 48
2.9 ZTE Exclusive Commands ..........................................................49
2.9.1 +ZGPIO: read/write GPIO.................................................... 49
5

GSM Module
2.9.2 +ZSTR: check module’s status ................................................49
2.9.3 +ZGETICCID: set ICCID ...................................................... 49
2.9.4 +ZCSQ: set auto display CSQ ................................................50
2.9.5 +ZEDT: set DTR inspection mode ............................................. 50
2.9.6 +ZDSLEEP: 32KHz Deep sleep mode .......................................... 51
2.9.7 +CUSD: send USSD data..................................................... 51
2.9.8 +ZRINGPINMODE: set RING PIN signal mode .................................. 53
2.10Network Parameter Commands ...................................................54
2.10.1 +ZPNUM: set APN, username and password .................................. 54
2.10.2 +ZPPPOPEN: open GPRS connection ......................................... 54
2.10.3 +ZPPPCLOSE: close GPRS connection ........................................ 54
2.10.4 +ZIPGETIP: check current IP address.......................................... 54
2.10.5 +ZDNSSERV: set DNS IP address ..............................................55
2.10.6 +ZDNSGETIP: obtain Internet Domain name’s IP address ....................... 55
2.11TCP Link Commands ..............................................................56
2.11.1 +ZIPSETUP: Set up TCP server link .............................................56
2.11.2 +ZIPSEND: send TCP data to target address................................... 56
2.11.3 +ZPPPSTATUS:check GPRS connection status ................................56
2.11.4 +ZIPCLOSE: close TCP link.................................................... 56
2.11.5 +ZIPSTATUS:check current TCP link status .................................... 57
2.11.6 +ZIPRECV: receive data from current data link................................ 57
2.12UDP Link Commands ..............................................................58
2.12.1 +ZIPSETUPU: set up UDP server link ............................................58
2.12.2 +ZIPSENDU: send data to UDP server ......................................... 58
2.12.3 +ZIPSTATUSU:check UDP status..............................................58
2.12.4 +ZIPCLOSEU: close UDP link .................................................. 58
2.12.5 +ZIPRECVU: receive UDP data ............................................... 59
2.13Server Commands ................................................................60
2.13.1 +ZTCPLISTEN: set port monitoring ............................................. 60
2.13.2 +ZTCPSENDP: send data through passively opened link........................ 60
2.13.3 +ZTCPCLOSEP: close monitored connection .................................. 61
2.13.4 +ZTCPRECV(P): receive data report .......................................... 61
2.13.5 +ZTCPSTATUSP: check passively opened link ..................................62
2.13.6 +ZIPTIMEOUT: set the timeout for connecting the server & sending data ........62
2.13.7 +ZTCPTIMEOUT: set the timeout for receiving data ............................ 63
2.14FTP Commands ...................................................................64
2.14.1 +ZFTPGET: download data from FTP server .................................... 64
2.14.2 +ZFTPPUT: upload data to FTP server ......................................... 65
2.15Relevant Audio Commands .......................................................67
2.15.1 +ZCALLTONE: set pick-up tone ............................................... 67
2.15.2 +ZDTMFTONE: set ZDTMF tone................................................67
2.15.3 +SPEAKER: audio channel switch command..................................68
2.15.4 +ZMICGB: set MIC audio parameters......................................... 68
2.16Relevant Base Station Commands ................................................. 71
6

GSM Module
2.16.1 +CCED: obtain cell information .............................................. 71
2.16.2 +ZBCCH: lock BCCH ........................................................72
2.16.3 +ZBAND: lock GSM band .................................................... 73
2.16.4 +ZOPT: lock network operator ...............................................74
2.16.5 +ZCALIST: read carrier wave list ..............................................75
3Application Cases and Precautions........................................ 76
3.1 SMS Application Case............................................................. 76
3.2 Phonebook Application Case .....................................................77
7

GSM Module
1General Description
1.1 Description of AT Commands
ME3000_V2 provides AT command interfaces, through which the module could
communicate with the external devices conveniently. The AT commands set provided by
ME3000_V2 module not only covers the standard GSM voice call and SMS applications, but
adds some other commands based on GSM specification and some ZTE exclusive
commands for users to use conveniently.
1.1.1 Type of AT Commands
As a standard interface, the returned values and formats of AT commands are both fixed. As
a whole, the AT commands could be divided into four types:
Non-parameter commands: a type of simple commands with the format of
AT[+|&]<command>,e.g.: AT+CSQ, AT&W
Query commands: used to inquire the current setting value with the format of
AT[+|&]<command>?, e.g.: AT+CNMI?
Help commands: used to list the possible parameters of the command with the format of
AT[+|&]<command>=?, e.g.: AT+CMGL=?
Parameter commands: normally used format which provides strong flexibility with the
format of AT[+|&]<command>=<par1>,<par2>,<par3>…
The returned values of this type of commands are all the same. This will be clarified in details
later. The basic frame format of the returned value is:
<CR><LF><Response string><CR><LF>
<CR><LF><OK/ERROR>[ERROR INFO]<CR><LF>
1.1.2 Returned Format of AT Commands
The following describes the AT commands and returned descriptions supported by
ME3000_V2 module:
AT command returned format:
--<CR><LF><corresponding strings ><CR><LF>
--An exceptional case: e.g.: AT+ZPOWEROFF, directly return with “OK”
AT command status report (OK, ERROR):
--If there is error in AT command format, return with “ERROR”;
--If AT command executes successfully, return with “OK”;
1.1.3 AT Command Format
AT command starts with “AT” and ends with <CR>;
After the module runs, the serial port default setting will be: 8-digit data bit, 1-digit stop bit,
8

GSM Module
no parity check, no CTS/RTS, data rate 115200bps.
1.2 Abbreviations
A
ADC Analog-Digital Converter
AFC Automatic Frequency Control
AGC Automatic Gain Control
ARFCN Absolute Radio Frequency
Channel Number
ARP Antenna Reference Point
ASIC Application Specific Integrated
Circuit
B
BER Bit Error Rate
BTS Base Transceiver Station
C
CDMA Code Division Multiple Access
CDG CDMA Development Group
CS Coding Scheme
CSD Circuit Switched Data
CPU Central Processing Unit
D
DAI Digital Audio interface
DAC Digital-to-Analog Converter
DCE Data Communication Equipment
DSP Digital Signal Processor
DTE Data Terminal Equipment
DTMF Dual Tone Multi-Frequency
DTR Data Terminal Ready
E
EFR Enhanced Full Rate
EGSM Enhanced GSM
EMC Electromagnetic Compatibility
EMI Electro Magnetic Interference
ESD Electronic Static Discharge
ETS European Telecommunication
Standard
F
9

GSM Module
FDMA Frequency Division Multiple
Access
FR Full Rate
G
GPRS General Packet Radio Service
GSM Global Standard for Mobile
Communications
H
HR Half Rate
I
IC Integrated Circuit
IMEI International Mobile Equipment
Identity
ISO International Standards
Organization
ITU International
Telecommunications Union
L
LCD Liquid Crystal Display
LED Light Emitting Diode
M
MCU Machine Control Unit
MMI Man Machine Interface
MS Mobile Station
P
PCB Printed Circuit Board
PCL Power Control Level
PCS Personal Communication System
PDU Protocol Data Unit
PLL Phase Locked Loop
PPP Point-to-point protocol
R
RAM Random Access Memory
RF Radio Frequency
ROM Read-only Memory
10

GSM Module
RMS Root Mean Square
RTC Real Time Clock
S
SIM Subscriber Identification Module
SMS Short Message Service
SRAM Static Random Access Memory
T
TA Terminal adapter
TDMA Time Division Multiple Access
TE Terminal Equipment also referred
it as DTE
U
UART Universal asynchronous
receiver-transmitter
UIM User Identifier Management
USB Universal Serial Bus
V
VSWR Voltage Standing Wave Ratio
Z
ZTE ZTE Corporation
11

GSM Module
2AT Commands
2.1 Common Commands
2.1.1 A/: repeat
Description This command is used to repeat the previous command.
Format A/
AT+CSQ Inquire current signal strength
A/ Repeat AT+CSQ command
AT+CMGS=”13714393404”
>123→
Send a text message
Example
A/
>123→
Repeat AT+CMGS command
2.1.2 ATA: answer
Description This command is used to answer a call.
Format ATA
RING An incoming call rings.Example
ATA Answer the incoming call.
2.1.3 ATD: dial
Description This command is used to originate a voice call, data and fax call.
Format ATD<string>;
ATD><mem><n>;
ATD><n>;
ATD>”name”;
AT+CPBS="SM"
ATD13024540756;
Select SIM card phonebook as the
current phonebook
Search the number from SIM card
phonebook and dial
AT+CPBS="SM"
ATD>2;
OK
Select SIM card phonebook as the
current phonebook
Search the second phone number in
current phonebook
ATD>SM1; Dial the first number in SIM card
phonebook
Example
ATD13714393404; Directly dial the phone number
12

GSM Module
ATD>”name”; Search the phone number with
“name” in SIM card and nvram
Parameters <mem>: phonebook
“SM”: SIM card phonebook.
“ME”: local phonebook.
“LD”: last dialled calls in phonebook.
“MC”: missed calls
“RC”: received calls
<n>: the n-th option in phonebook.
<string>: the number of called party, e.g., *99#.
2.1.4 ATDL: dial last
Description This command is used to dial the last outgoing number.
Format ATDL
ATD34394036;
OK
Dial 34394036
ATH
OK
Hang up the call
Example
ATDL Dial 34394036 again
2.1.5 ATE: enable
Description This command is used to enable echo display.
Format ATE<n>
ATE0
OK
OK
ATE0, don’t display input command on
the terminal
Example
ATE1
OK
ATE1
OK
ATE1, displays input command on the
terminal
Parameters <n>=0 Disable echo display.
<n>=1 Enable echo display.
2.1.6 ATH: hang up
Description This command is used to hang up the call.
Format ATH
Example ATA
OK
Answer the call
13

GSM Module
ATH Hang up the call
2.1.7 ATI: Information
Description This command is used to display the module manufacturer’s information.
Format ATI
Example ATI
ZTE Mobile LTD
GSM/GPRS Mobile Station
Revision: 1.0
OK
display the module manufacturer’s
information.
2.1.8 ATQ: set whether or not to display the returned value.
Description This command is used to set whether or not to display the returned value.
Format ATQ<n>
ATQ0
OK
ATQ0
OK
Set the terminal displays the returned
value
Example
ATQ1
OK
ATQ1ATQ1
Set the terminal doesn’t display the
returned value.
2.1.9 +++: switch from data mode to command mode
Description This command is used to switch from data mode to command mode.
Format +++
Example ATD*99#
CONNECT
+++
……
AT
OK
Dial to enter data mode
Switch from data mode to command
mode
2.1.10ATO: switch from command mode to data mode
Description This command is used to switch from command mode to data mode.
Format ATO
14

GSM Module
Example ATD*99#
CONNECT
+++
……
ATO
……
Dial to enter GPRS data connection
Switch from data mode to command
mode
Switch from command mode to data
mode
2.1.11ATP: pulse
Description This command is used for pulse dialling.
Format ATP
Example ATP
OK
Set pulse dialling method
2.1.12ATS0: auto answer setting
Description This command is used to control the module’s auto answer mode.
Format ATS0=<value>
ATS0=2
OK
Auto answer after ringing twice
ATS0?
2
OK
Check current settings
Example
ATS0=0
OK
Cancel auto answer
Parameter <value>: ringing times
2.1.13+CRC: set ringer type
Description This command is used to display the type of ringer.
Format AT+CRC=<num>
Example AT+CRC=1
OK
+CRING:VOICE
Set RING as ringer type
Set CRC as ringer type
Parameter
s
<num>:
0: Do not display the type of ringer
1: display the type of ringer
Descriptions of ringer type:
15

GSM Module
VOICE: Voice
GPRS: GPRS service
FAX: Fax
2.1.14+CLVL: volume level
Description This command is used to set the volume level of the speaker.
Format AT+CLVL=<level>
Example AT+CLVL=100
OK
Set current receiver volume as 100
Parameters AT+CLVL?
+CLVL:100
Check the current receiver volume
<level> ranging 0~100, the lower the level is, the smaller the volume is.
2.1.15+CLIP: Calling Line Identification Presentation
Description This command is used to set CLIP. The default settings are to disable CLIP.
Format AT+CLIP=<mode>
+CLIP:<mode>: return from AT+CLIP?
+CLIP:<number>,<type>,<> CLIP format
AT+CLIP=1
OK
RING:+CLIP: “130********”,129,
“name”,“”,0
Enable CLIP
There is an incoming call, incoming
number is 130********
Example
AT+CLIP=0
OK
RING
Disable CLIP
No CLIP
Parameters <mode>:
0: disable CLIP
1: enable CLIP;
<number>: incoming number (need apply for relevant service)
<type>: 129.
2.1.16+ZSETMUTE: mute control
Description This command is used for mute control and it can be used only during
the call.
Format AT+ZSETMUTE=<Mode>
Example AT+ZSETMUTE=?
+ZSETMUT:(0-1)
OK
check the setting parameters
16

GSM Module
AT+ZSETMUTE=1
OK
Mute on
AT+ZSETMUTE=0
OK
Mute off
Parameters <Mode>:
0: Turn off mute
1: Turn on mute.
2.1.17+CIMI: International Mobile Identification
Description This command is used to read the International Mobile Identification of
SIM card and check current PIN.
Format AT+CIMI
Example AT+CIMI
460030916875923
OK
Check CIMI
Return CIMI
2.1.18+CGMR: get product version
Description This command is used to obtain the module’s current product version.
Format AT+CGMR
AT+CGMR=?
OK
No meaningExample
AT+CGMR
+CGMR: Revision: 1.0
OK
Return current module’s version
2.1.19+ECHO: echo remove
Description This command is used to remove the echo.
Format AT+ECHO=num
AT+ECHO?
+ECHO:1
OK
Check current echo settings
Example
AT+ECHO=0
OK
Cancel echo remove
Format Num: default value 1.
1: set echo remove function
0: cancel echo remove function
2.1.20+(C)GSN: get current IMEI
Description This command is used to get the current device’s IMEI.
17

GSM Module
Format AT+GSN
Example AT+GSN
N
OK
Return current IMEI
2.1.21+ZVERS: get current software version
Description This command is used to get the current software version.
Format AT+ZVERS
Example AT+ZVERS
+ZVERS: ***.bin
OK
get the current software version.
2.1.22+CLCK: lock
Description This command is used to lock the terminal or network function.
Format AT+CLCK=<fac>,<mode>[,<passwd>[,<class>]]
+CLCK:<status>
Example AT+CLCK=?
+CLCK:("PF","SC","AO","OI","OX","AI","IR","AB","AG","AC","FD","PN","PU","PP","PC")
OK
Parameters <fac>:
"SC" SIM card; "AO" all outgoing calls barring; "OI" Outgoing international
calls barring; "OX" Outgoing international calls barring except for local; "AI" all
incoming calls barring; "IR" Incoming roaming barring; "AB" all services
barring; "AG" barring of all outgoing calls;
"AC" barring of all incoming calls; "FD" Fixed dial; "PN" Personalized network;
"PU" Personalized sub network; "PP" Personalized provider; "PC" Personalized
corporate.
<mode>:
0 unlock
1 lock
2 check the status
<passwd>: password or operation code, character string type “***”.
<class>:
1 voice call
2 data
4 fax
7 All
<status>:
0: Disable
1: Enable
18

GSM Module
2.1.23+CCFC: call forwarding number and conditions
Description This command is used to set call forwarding number and conditions.
Format AT+CCFC=<reason>,<mode>[,<number>
[,<type>[,<class>[,<subaddr>[,<saytype>[,time]]]]]]
If mode!=2, setting successfully return: OK;
If mode=2, setting successfully return:
+CCFC:<status>,<class>
Example AT+CCFC=?
+CCFC: (0,1,2,3,4,5)
OK
Check call forwarding control setting
Return reason range.
19
Table of contents
Other Zte GSM/GPRS Module manuals