Multi-Tech Systems MTSMC-G, MTMMC-G User Manual

Wireless GSM/GPRS Modems
MultiModem® GPRS (MTCBA-G)
MMCModem GPRS
SocketModem
®
GPRS (MTSMC-G)
AT Commands
Reference Guide
Copyright and Technical Support
AT Commands for Wireless GSM/GPRS Modems
Reference Guide
These Commands Apply to the Following Products:
MultiModem® GPRS (MTCBA-G) MultiModem® GPRS-USB (MTCBA-G-U) MultiModem® GPRS with Ethernet Interface (MTCBA-G-EN) MMCModem GPRS (MTMMC-G) SocketModem® GPRS (MTSMC-G)
PN S000293I, Revision I
Copyright
This publication may not be reproduced, in whole or in part, without prior expressed written permission from Multi-Tech Systems, Inc. All rights reserved. Copyright © 2003-2008, by Multi-Tech Systems, Inc.
Multi-Tech Systems, Inc. makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. Furthermore, Multi-Tech Systems, Inc. reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of Multi-Tech Systems, Inc. to notify any person or organization of such revisions or changes.
Revisions
Revision Level Date Description
A 07/15/03 Initial release.
B 03/08/04 Added Values to each command. Added new commands. C 09/28/04 Changed data/fax call to ATD<nb>; and voice call to ATD<nb> Changed Autobauding is supported (operating from 2400 to 115200) D 08/04/05 Added “Length of Phone Numbers” section to Chapter 3. Changed maximum length of
phone numbers to 60 digits. Added <mode> to +CMGF values. Added new command, +CMMS. Removed values 2 and 4 from \N. Increased I/O ports to ten in the index value
of +WIOR and +WIOW. Added more text to +WRIM. Removed one note from +CGCONT. Changed the font size from 10 point to 9 point; this brought the manual under 200 pages. E 01/23/06 Added ®and ™ to products listed on the cover. F 05/10/07 Added the +WMBS, a command that supports quad band builds. Updated the Technical
Support contact list. G 08/24/07 Updated the +WIND command. H 01/16/08 Updated the cover and MMCModem product name. I 09/25/08 Updated the +ECHO commands and removed Fax commands. Removed all references to
HR (Half Rate). Added four new Phonebook commands: WCOS, WPGW, WPGR, WPGS.
Added SMS Command: WMCP. Updated to version 6.57d.
Trademarks
MultiModem, SocketModem, and the Multi-Tech logo are registered trademarks of Multi-Tech Systems, Inc. MMCModem is a trademark of Multi-Tech Systems, Inc.
Technical Support
Country By Email By Phone
Europe, Middle East, Africa: support@multitech.co.uk +(44) 118 959 7774 U.S., Canada, all others: support@multitech.com 800-972-2439 or 763-717-5863
World Headquarters
Multi-Tech Systems, Inc. 2205 Woodale Drive Mounds View, Minnesota 55112 Phone: 763-785-3500 or 800-328-9717 Fax: 763-785-9874 Internet Address: http://www.multitech.com
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 2
Table of Contents
Contents
Chapter 1 – Introduction ................................................................................................................................................ 9
Scope of This Document ............................................................................................................................................ 9
Related Documents .................................................................................................................................................... 9
Definitions .................................................................................................................................................................. 9
Chapter 2 – AT Command Features ........................................................................................................................... 10
Line Settings ............................................................................................................................................................ 10
Command Line ......................................................................................................................................................... 10
Information Responses and Result Codes ............................................................................................................... 10
Chapter 3 – General Behaviors ................................................................................................................................... 11
SIM Card Insertion and Removal Procedures .......................................................................................................... 11
Background Initialization .......................................................................................................................................... 11
About the Length of Phone Numbers ....................................................................................................................... 11
Chapter 4 – General AT Commands ........................................................................................................................... 13
Manufacturer Identification +CGMI ......................................................................................................................... 13
Request Model Identification +CGMM .................................................................................................................... 13
Request Revision Identification +CGMR ................................................................................................................ 13
Product Serial Number +CGSN .............................................................................................................................. 14
Select TE Character Set +CSCS ............................................................................................................................ 14
Phonebook Character Set +WPCS ........................................................................................................................ 14
Request IMSI +CIMI ............................................................................................................................................... 15
Card Identification +CCID ....................................................................................................................................... 15
Capabilities List +GCAP ......................................................................................................................................... 15
Repeat Last Command A/ ....................................................................................................................................... 15
Power Off +CPOF ................................................................................................................................................... 16
Set Phone Functionality +CFUN ............................................................................................................................ 16
Phone Activity Status +CPAS ................................................................................................................................. 17
Report Mobile Equipment Errors +CMEE ............................................................................................................... 17
Keypad Control +CKPD ......................................................................................................................................... 17
Clock Management +CCLK .................................................................................................................................... 18
Alarm Management +CALA .................................................................................................................................... 18
Chapter 5 – Call Control Commands .......................................................................................................................... 19
Dial Command D .................................................................................................................................................... 19
Hang-Up Command H ............................................................................................................................................ 20
Answer a Call A ...................................................................................................................................................... 21
Remote Disconnection ............................................................................................................................................. 21
Extended Error Report +CEER .............................................................................................................................. 21
DTMF Signals +VTD, +VTS ................................................................................................................................... 21
Redial Last Telephone Number DL ........................................................................................................................ 22
Automatic Dialing with DTR %D ............................................................................................................................. 23
Automatic Answer S0 ............................................................................................................................................. 23
Incoming Call Bearer +CICB .................................................................................................................................. 24
Single Numbering Scheme +CSNS ........................................................................................................................ 24
Gain Control +VGR, +VGT ..................................................................................................................................... 24
Microphone Mute Control +CMUT .......................................................................................................................... 26
Speaker & Microphone Selection +SPEAKER ....................................................................................................... 26
Echo Cancellation +ECHO ..................................................................................................................................... 27
SideTone Modification +SIDET .............................................................................................................................. 30
Initialize Voice Parameters +VIP ............................................................................................................................ 30
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 3
Table of Contents
Chapter 6 – Network Service Commands .................................................................................................................. 31
Signal Quality +CSQ ............................................................................................................................................... 31
Operator Selection +COPS .................................................................................................................................... 31
Network Registration +CREG ................................................................................................................................. 33
Operator List Management +WOLM ...................................................................................................................... 33
Read Operator Name +WOPN ................................................................................................................................ 34
Selection of Preferred PLMN List +CPLS ............................................................................................................... 36
Preferred Operator List +CPOL .............................................................................................................................. 37
Read Operator Name +COPN ................................................................................................................................ 39
Chapter 7 – Security Commands ................................................................................................................................ 40
Enter PIN +CPIN .................................................................................................................................................... 40
Enter PIN2 +CPIN2 ................................................................................................................................................ 42
PIN Remaining Attempt Number +CPINC .............................................................................................................. 42
Facility Lock +CLCK ............................................................................................................................................... 43
Change Password +CPWD .................................................................................................................................... 44
Chapter 8 – Phonebook Commands .......................................................................................................................... 45
Introduction to Phonebook Commands .................................................................................................................... 45
About the Parameters .............................................................................................................................................. 45
Select Phonebook Memory Storage +CPBS ........................................................................................................... 46
Read Phonebook Entries +CPBR .......................................................................................................................... 47
Write Phonebook Entry +CPBW ............................................................................................................................. 49
Find Phonebook Entries +CPBF ............................................................................................................................ 52
Phonebook Phone Search +CPBP ......................................................................................................................... 53
Move Action in Phonebook +CPBN ........................................................................................................................ 54
Subscriber Number +CNUM ................................................................................................................................... 55
Avoid Phonebook Initialization +WAIP ................................................................................................................... 56
Delete Calls Phonebook +WDCP ........................................................................................................................... 56
Set Voice Mail Number +CSVM .............................................................................................................................. 56
Contact Selector +WCOS ........................................................................................................................................ 57
Create and Delete a Phonebook Group +WPGW ................................................................................................... 57
Read a Phonebook Group +WPGR ........................................................................................................................ 58
Settings of a Phonebook Group +WPGS ................................................................................................................ 59
Chapter 9 – Short Messages ....................................................................................................................................... 60
Parameters Definition ............................................................................................................................................... 60
Select Message Service +CSMS ............................................................................................................................ 61
New Message Acknowledgement +CNMA ............................................................................................................. 61
Preferred Message Storage +CPMS ...................................................................................................................... 63
Preferred Message Format +CMGF ....................................................................................................................... 64
Save Settings +CSAS ............................................................................................................................................ 65
Restore Settings +CRES ........................................................................................................................................ 65
Show Text Mode Parameters +CSDH ..................................................................................................................... 65
New Message Indication +CNMI ............................................................................................................................ 66
Read Message +CMGR ......................................................................................................................................... 68
List Message +CMGL ............................................................................................................................................. 69
Send Message +CMGS ......................................................................................................................................... 70
Write Message to Memory +CMGW ....................................................................................................................... 71
Send Message from Storage +CMSS .................................................................................................................... 72
Set Text Mode Parameters +CSMP ........................................................................................................................ 72
Delete Message +CMGD ....................................................................................................................................... 73
Service Center Address +CSCA ............................................................................................................................ 74
Select Cell Broadcast Message Types +CSCB ...................................................................................................... 74
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 4
Table of Contents
Cell Broadcast Message Identifiers +WCBM .......................................................................................................... 75
Message Status Modification +WMSC ................................................................................................................... 75
Message Overwriting +WMGO ............................................................................................................................... 76
Change or Do Not Change SMS Status +WUSS ................................................................................................... 77
Copy Messages +WMCP ....................................................................................................................................... 78
More Messages to Send +CMMS .......................................................................................................................... 79
Chapter 10 – Supplementary Services Commands .................................................................................................. 80
Call Forwarding +CCFC .......................................................................................................................................... 80
Call Barring +CLCK ................................................................................................................................................ 81
Modify SS Password +CPWD ................................................................................................................................ 81
Call Waiting +CCWA .............................................................................................................................................. 82
Calling Line Identification Restriction +CLIR .......................................................................................................... 83
Calling Line Identification Presentation +CLIP ....................................................................................................... 83
Connected Line Identification Presentation +COLP ............................................................................................... 84
Advice of Charge +CAOC ...................................................................................................................................... 85
Accumulated Call Meter +CACM ............................................................................................................................ 85
Accumulated Call Meter Maximum +CAMM ........................................................................................................... 86
Price Per Unit and Currency Table +CPUC ............................................................................................................ 86
Call Related Supplementary Services +CHLD ....................................................................................................... 87
List Current Calls +CLCC ....................................................................................................................................... 88
Supplementary Service Notifications +CSSN ......................................................................................................... 89
Unstructured Supplementary Service Data +CUSD ............................................................................................... 90
Closed User Group +CCUG .................................................................................................................................... 91
Chapter 11 – Data Commands .................................................................................................................................... 92
Using AT Commands During a Data Connection ..................................................................................................... 92
Bearer Type Selection +CBST ............................................................................................................................... 93
Select Mode +FCLASS .......................................................................................................................................... 94
Service Reporting Control +CR ............................................................................................................................... 94
Cellular Result Codes +CRC .................................................................................................................................. 95
DTE-DCE Local Rate Reporting +ILRR.................................................................................................................. 95
Radio Link Protocol Parameters +CRLP ................................................................................................................ 96
Other Radio Link Parameters +DOPT ..................................................................................................................... 96
Select Data Compression %C ................................................................................................................................. 97
V42bis Data Compression +DS .............................................................................................................................. 97
V42bis Data Compression Report +DR .................................................................................................................. 98
Select Data Error Correcting Mode \N .................................................................................................................... 98
Chapter 12 – V.24 and V.25 Commands ..................................................................................................................... 99
Fixed DTE Rate +IPR ............................................................................................................................................. 99
DTE-DCE Character Framing +ICF ...................................................................................................................... 100
DTE-DCE Local Flow Control +IFC ...................................................................................................................... 101
Set DCD Signal &C .............................................................................................................................................. 101
Set DTR Signal &D ............................................................................................................................................... 102
Set DSR Signal &S ............................................................................................................................................... 102
Back to Online Mode O ......................................................................................................................................... 102
Result Code Suppression Q ................................................................................................................................. 102
DCE Response Format V ..................................................................................................................................... 103
Default Configuration Z ........................................................................................................................................ 103
Save Configuration &W ......................................................................................................................................... 103
Auto-Tests &T ...................................................................................................................................................... 104
Echo E .................................................................................................................................................................. 104
Restore Factory Settings &F ................................................................................................................................ 104
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 5
Table of Contents
Display Configuration &V ..................................................................................................................................... 105
Request Identification Information I ...................................................................................................................... 105
Multiplexing Mode +WMUX ................................................................................................................................... 106
Chapter 13 – Specific AT Commands ...................................................................................................................... 107
Cell Environment Description +CCED .................................................................................................................. 107
General Indications +WIND .................................................................................................................................. 109
Analog Digital Converter Measurements +ADC .................................................................................................... 111
Mobile Equipment Event Reporting +CMER ........................................................................................................ 112
Read Language Preference +WLPR .................................................................................................................... 113
Write Language Preference +WLPW ................................................................................................................... 113
Read GPIO Value +WIOR ..................................................................................................................................... 114
Write GPIO Value +WIOW ................................................................................................................................... 114
Input/Output Management +WIOM ...................................................................................................................... 115
Abort Command +WAC ........................................................................................................................................ 116
Play Tone +WTONE ............................................................................................................................................. 117
Play DTMF Tone +WDTMF .................................................................................................................................. 118
Downloading +WDWL .......................................................................................................................................... 118
Voice Rate +WVR ................................................................................................................................................. 119
Data Rate +WDR ................................................................................................................................................. 120
Select Voice Gain +WSVG ................................................................................................................................... 121
Status Request +WSTR ....................................................................................................................................... 121
Scan +WSCAN ..................................................................................................................................................... 122
Ring Indicator Mode +WRIM ................................................................................................................................ 122
32kHz Power Down Mode +W32K ....................................................................................................................... 123
Change Default Melody +WCDM ......................................................................................................................... 123
Custom Character Set +WCCS ............................................................................................................................ 124
Lock +WLCK ........................................................................................................................................................ 125
CPHS Command +CPHS ..................................................................................................................................... 126
Unsolicited Result: Voice Mail Indicator +WVMI ................................................................................................... 128
Unsolicited Result: Diverted Call Indicator +WDCI ............................................................................................... 128
Network Operator Name +WNON ........................................................................................................................ 129
CPHS Information +WCPI .................................................................................................................................... 129
Customer Service Profile +WCSP ......................................................................................................................... 130
Customer Storage Mirror +WMIR ......................................................................................................................... 130
Change Default Player +WCDP ............................................................................................................................ 130
CPHS Mail Box Number +WMBN ........................................................................................................................ 131
Alternate Line Service +WALS ............................................................................................................................. 132
Wavecom Open AT Control Command +WOPEN ............................................................................................... 133
Reset +WRST ...................................................................................................................................................... 135
Set Standard Tone +WSST .................................................................................................................................. 135
Hang-up +WATH .................................................................................................................................................. 136
Multi-Band Selection +WMBS .............................................................................................................................. 137
Chapter 14 – SIM Toolkit ........................................................................................................................................... 138
Overview of SIM Application Toolkit ....................................................................................................................... 138
Messages Exchanged During a SIM Toolkit Operation .......................................................................................... 139
SIM Toolkit Commands .......................................................................................................................................... 140
SIM Toolkit Set Facilities +STSF .......................................................................................................................... 140
SIM Toolkit Indication +STIN or +STRIL .............................................................................................................. 142
SIM Toolkit Get Information +STGI ...................................................................................................................... 143
Unsolicited Result: SIM Toolkit Control Response +STCR .................................................................................. 146
SIM Toolkit Give Response +STGR ..................................................................................................................... 146
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 6
Table of Contents
Chapter 15 – GPRS commands ................................................................................................................................ 149
Define PDP Context +CGDCONT ........................................................................................................................ 149
Quality of Service Profile Requested +CGQREQ .................................................................................................. 151
Quality of Service Profile Minimum Acceptable +CGQMIN .................................................................................. 154
GPRS Attach or Detach +CGATT ........................................................................................................................ 155
PDP Context Activate or Deactivate +CGACT ..................................................................................................... 156
Enter Data State +CGDATA ................................................................................................................................. 157
GPRS Mobile Station Class +CGCLASS ............................................................................................................. 158
Select Service for MO SMS Messages +CGSMS ................................................................................................ 159
GPRS Event Reporting +CGEREP ...................................................................................................................... 160
GPRS Network Registration Status +CGREG ...................................................................................................... 161
Request GPRS IP Service D ................................................................................................................................ 162
Network Requested PDP Context Activation .......................................................................................................... 163
Automatic Response to a Network Request for PDP Context Activation +CGAUTO ........................................... 164
Manual Response to a Network Request for PDP Context Activation +CGANS .................................................. 165
Show PDP Address +CGPADDR ......................................................................................................................... 166
Cellular Result Codes +CRC ................................................................................................................................ 166
Service Reporting Control +CR ............................................................................................................................ 167
Extended Error Report +CEER ............................................................................................................................ 167
GPRS Parameters Customization +WGPRS ....................................................................................................... 168
Examples of Full GPRS AT Commands ................................................................................................................. 170
Chapter 16 – Other AT Commands ........................................................................................................................... 171
V.25ter Recommendation ....................................................................................................................................... 171
GSM 07.05 Recommendation ................................................................................................................................ 171
GSM 07.07 Recommendation ............................................................................................................................... 171
Appendix A – Result Codes, Failure Causes, Other Tables ................................................................................... 172
Chapter Summary .................................................................................................................................................. 172
ME Error Result Code: +CME ERROR: <error> ................................................................................................... 173
Message Service Failure Result Code +CMS ERROR ......................................................................................... 174
Specific Error Result Codes ................................................................................................................................... 174
Failure Cause from GSM 04.08 Recommendation +CEER ................................................................................... 176
Specific Failure Cause for +CEER ......................................................................................................................... 177
GSM 04.11 Annex E-2: Mobile Originating SM-Transfer ....................................................................................... 178
Unsolicited Result Codes ....................................................................................................................................... 179
Final Result Codes ................................................................................................................................................. 179
Intermediate Result Codes ..................................................................................................................................... 179
Parameter Storage Mode ....................................................................................................................................... 180
GSM Sequences List .............................................................................................................................................. 182
CPHS Information Field .......................................................................................................................................... 184
CSP Constants ....................................................................................................................................................... 185
Appendix B - ME SIM Toolkit Support ...................................................................................................................... 187
Appendix C – Structure of the Terminal Profile ...................................................................................................... 188
Appendix D – Command Type and Next Action Indicator ..................................................................................... 190
Appendix E – Coding of Alpha fields in the SIM for UCS2 ..................................................................................... 191
Appendix F – Command Execution and Dependence on SIM ................................................................................ 193
General Commands ............................................................................................................................................... 193
Call Control Commands ......................................................................................................................................... 193
Network Service Commands .................................................................................................................................. 194
Security Commands ............................................................................................................................................... 194
Phonebook Commands .......................................................................................................................................... 194
Short Messages Commands .................................................................................................................................. 194
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 7
Table of Contents
Supplementary Services Commands ..................................................................................................................... 195
Data Commands .................................................................................................................................................... 195
V24-V25 Commands .............................................................................................................................................. 195
Specific AT Commands .......................................................................................................................................... 196
SIM Toolkit Commands .......................................................................................................................................... 196
GPRS Commands .................................................................................................................................................. 197
Index ........................................................................................................................................................................... 198
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 8
Chapter 1 – Introduction
Chapter 1 – Introduction
Scope of This Document
This document describes the AT-command based messages exchanged between an application and the Multi-Tech Systems, Inc. products in order to manage GSM-related events or services.
Related Documents
This interface specification is based on the following recommendations: [1] ETSI GSM 07.05: Digital cellular telecommunications system (Phase 2);
Use of DTE-DCE interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) [2] ETSI GSM 07.07: Digital cellular telecommunications system (Phase 2);
AT command set for GSM Mobile Equipment (ME) [3] ITU-T Recommendation V.25 ter: Serial asynchronous automatic dialing and co ntrol [4] ETSI GSM 03.40: Digital cellular telecommunications system (Phase 2);
Technical implementation of the Short Message Service (SMS) Point-to-Point (PP) [5] ETSI GSM 03.38: Digital cellular telecommunications system (Phase 2);
Alphabets and language-specific information [6] ETSI GSM 04.80: Digital cellular telecommunications system (Phase 2):
Mobile radio interface layer 3, Supplementary service specification, Formats and coding
Definitions
The words, “Mobile Station” (MS) or “Mobile Equipment” (ME) are used for mobile terminals supporting GSM services. Terminal Equipment (TE) is the Man-Machine Interface of a GSM device (modem or handset). A TE can be a hanset
MMI or the AT Command interface. A call from a GSM mobile station to the PSTN is called a “mobile originated call” (MOC) or “outgoing call”, and a call
from a fixed network to a GSM mobile station is called a “mobile terminated call” (MTC) or “incoming call”. In this document, the word “product” refers to any Multi-Tech product supporting the AT commands interface.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 9
Chapter 2 – AT Command
Features
Line Settings
A serial link handler is set with the following default values (factory settings):
Autobaud
8 bits data
1 stop bit
no parity
RTS/CTS flow control
Please use the +IPR, +IFC and +ICF commands to change these settings.
Command Line
Commands always start with AT (which means ATtention) and finish with a <CR> character.
Chapter 2 – AT Command Features
Information Responses and Result Codes
Responses start and end with <CR><LF>, except for the ATV0 DCE response format and the ATQ1 (result code suppression) commands.
If the command syntax is incorrect, an ERROR string is returned.
If the command syntax is correct but transmitted with the wrong parameters, the +CME ERROR: <Err> or +CMS
ERROR: <SmsErr> strings are returned with adequate error codes if the CMEE was previously set to 1. By default, CMEE us set to 0, and the error message is only “ERROR”.
If the command line has been performed successfully, an OK string is returned.
In some cases, such as “AT+CPIN?” or (unsolicited) incoming events, the product does not return the OK string as a response.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 10
Chapter 3 – General Behaviors
A
Chapter 3 – General Behaviors
SIM Card Insertion and Removal Procedures
SIM card Insertion and Removal procedures are supported. Software functions rely on positive reading of the hardware SIM detect pin. This pin state (open/closed) is permanently monitored.
When the SIM detect pin indicates that a card is present in the SIM connector, the product tries to set up a logical SIM session. The logical SIM session will be set up or not depending on whether the detected card is a SIM Card or not. The AT+CPIN? command delivers the following responses:
If the SIM detect pin indicates “absent”, the response to AT+CPIN? is “+CME ERROR 10” (SIM not inserted).
If the SIM detect pin indicates “present”, and the inserted Card is a SIM Card, the response to AT+CPIN? is
“+CPIN: xxx” depending on SIM PIN state.
If the SIM detect pin indicates “present”, and the inserted Card is not a SIM Card, the response to AT+CPIN? is
CME ERROR 10.
These last two states are not given immediately due to background initialization. Between the hardware SIM
detect pin indicating “present” and the previous results the AT+CPIN? sends “+CME ERROR: 515” (Please wait, init in progress).
When the SIM-detect pin indicates card absence, and if a SIM Card was previously inserted, an IMSI detach procedure is performed, all user data is removed from the product (Phonebooks, SMS etc.). The product then switches to emergency mode.
When the hardware SIM detect pin is not managed, the software cannot know the state of the SIM (SIM inserted or SIM removed) except for the initialization of the modem. In this case, the SIM must be present in the rack before the initialization of the modem can be taken into account.
If the SIM is removed and it had been detected at the time of initialization of the modem, the following message is displayed: +CME ERROR: 13. If the SIM is inserted in the rack and it was not present at the time of the initialization of the modem, the state of the SIM remains unchanged (SIM removed). It will have to initialize the modem again so that it is detected.
Background Initialization
After entering the PIN (Personal Identification Number), some SIM user data files are loaded into the product (Phonebooks, SMS status, etc.). Please be aware that it might take some time to read a large phonebook.
The AT+CPIN? command response comes just after the PIN is checked. After this response user data is loaded (in background). This means that some data may not be available just after PIN entry is confirmed by ’OK’. The reading of phonebooks will then be refused by “+CME ERROR: 515” or “+CMS ERROR: 515” meaning, “Please wait, service is not available, init in progress”.
This type of answer may be sent by the product at several points:
When trying to execute another AT command before the previous one is completed (before response),
When switching from ADN to FDN (or FDN to ADN) and trying to read the relevant phonebook immediately,
When asking for +CPIN? status immediately after SIM insertion and before the product has determined if the
inserted card is a valid SIM Card.
About the Length of Phone Numbers
Phone numbers can consist of up to 60 digits. The first 20 digits are stored in the SIM in the phonebook file (EF or EF EF
Example:
If there are no more free records in the EF
) corresponding to the selected phonebook. The next digits are stored in other extension SIM files (EF
LND
).
EXT2
Number of Digits Nb of Records in EF
1 to 20 1 0 21 to 40 1 1 41 to 60 1 2
, the behavior is:
if the user tries to store an entry that exceeds 20 digits: +CME: 20
if the user tries to dial an number that exceeds 20 digits: +CME: 20
EXT1
Nb of Records in EF
DN
EXT1
ADN
EXT1
, EF or
FDN
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 11
Since the maximum length for the numbers in the ADN, FDN, and LND phonebooks is 60 digits:
if the user tries to dial a number that exceeds 60 digits: +CME: 3
Before the user can perform a call, the number of free records in the EF
is checked for availability of free space to
EXT1
store this number.
If there are free records left, the call is setup.
Otherwise, +CME: 20 error is returned (Memory Full).
See Recommendation 3GPP 11.11 for more details.
Chapter 3 – General Behaviors
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 12
Chapter 4 – General AT Commands
Chapter 4 – General AT
Commands
Manufacturer Identification +CGMI
Description: Displays the manufacturer identification. Values: No parameters Syntax: AT+CGMI
Command Possible responses
AT+CGMI Note: Get manufacturer identification
Request Model Identification +CGMM
Description: Displays the supported frequency bands. With multi-band products the response may be a combination
of different bands.
Values: No parameters Syntax: AT+CGMM
Command Possible responses
AT+CGMM Note: Get hardware version AT+CGMM
Note: Get hardware version AT+CGMM
Note: Get hardware version AT+CGMM
Note: Get hardware version AT+CGMM
Note: Get hardware version AT+CGMM
Note: Get hardware version
MULTIBAND 900E 1800 OK Note: Multiband: GSM 900 MHz extended band and DCS 1800 (default configuration) 900E OK Note: 900 Extended 1800 OK Note: DCS 1900 OK Note: PCS G850 OK Note: GSM 850 MULTIBAND G850 1900 OK Note: Multiband: GSM 850 and PCS
WAVECOM MODEM OK Note: Command valid, Wavecom modem
Request Revision Identification +CGMR
Description: Displays the revised soft ware version. Values: No parameters Syntax: AT+CGMR
Command Possible responses
AT+CGMR Note: Get software version
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 13
657_09gg.Q2406B 2015268 100506 17:01 OK Note: Software release 6.57, generated on the 5th of October 2006
Chapter 4 – General AT Commands
Product Serial Number +CGSN
Description: Allows the user application to get the IMEI (Interrnational Mobile Equipment Identity, 15-digit number) of
the product.
Values: No parameters Syntax: AT+CGSN
Command Possible responses
AT+CGSN Note: Get the IMEI
AT+CGSN Note: Get the IMEI
012345678901234 OK Note: IMEI read from EEPROM +CME ERROR: 22 Note: IMEI not found in EEPROM
Select TE Character Set +CSCS
Description: Informs the modem which character set is used by the DTE. The modem can convert each character of
entered or displayed strings. This is used to send, read or write short messages. See also +WPCS for the phonebooks’ character sets.
Values: <Character Set>
GSM GSM default alphabet. PCCP437 PC character set code page 437. CUSTOM User defined character set (cf. +WCCS command). HEX Hexadecimal mode. No character set used; the user can read or write hexadecimal
values.
Default: GSM alphabet Syntax: AT+CSCS=<Character Set>
Command Possible responses
AT+CSCS=”GSM” Note: GSM default alphabet AT+CSCS=”PCCP437” Note: PC character set code AT+CSCS=?
Note: Get possible values
OK Note: Command valid OK Note: Command valid +CSCS: ("GSM","PCCP437","CUSTOM","HEX") OK Note: Possible values
Phonebook Character Set +WPCS
Description: Informs the modem which character set is used by the DTE for the phonebooks. The modem can
convert each character of entered or displayed strings. This is used to read or write phonebook entries. See also +CSCS for the short messages character sets.
Values: <Character Set>
TRANSPARENT Transparent mode. The strings are displayed and entered as they are stored in
SIM or in ME.
CUSTOM User defined character set (cf. +WCCS command). HEX Hexadecimal mode. No character set used; the user can read or write
hexadecimal values.
Syntax: AT+WPCS=<Character Set>
Command Possible responses
AT+WPCS=”TRANSPARENT” Note: Transparent mode AT+WPCS=”CUSTOM” Note: Custom character set AT+WPCS=?
Note: Get possible values
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 14
OK Note: Command valid OK Note: Command valid +WPCS: ("TRANSPARENT","HEX","CUSTOM") OK Note: Possible values
Chapter 4 – General AT Commands
Request IMSI +CIMI
Description: Reads and identifies the IMSI (International Mobile Subscriber Identity) of the SIM card. The PIN may
need to be entered before reading the IMSI.
Values: No parameters Syntax: AT+CIMI
Command Possible responses
AT+CIMI Note: Read the IMSI
208200120320598 OK Note: IMSI value (15 digits), starting with MCC (3 digits) / MNC (2 digits, 3 for PCS 1900)
Card Identification +CCID
Description: Orders the product to read the EF-CCID file on the SIM card. Values: No parameters Syntax: AT+CCID
Command Possible responses
AT+CCID Note: Get card ID AT+CCID? Note: Get current value
AT+CCID= ? Note: Get possible value
Note: If there is no EF-CCID file present on the SIM, the +CCID answer will not be sent, but the OK message will
be returned.
+CCID: “123456789AB111213141” Note: EF-CCID is present, hexadecimal format + CCID: “123456789AB111213141” Note: Same result as +CCID
OK Note: No parameter but this command is valid
Capabilities List +GCAP
Description: Displays the complete list of capabilities. Values: No parameters Syntax: AT+GCAP
Command Possible responses
AT+GCAP Note: Get capabilities list
+GCAP: +CGSM +FCLASS OK Note: Supports GSM and FAX commands
Repeat Last Command A/
Description: Repeats the previous command. Only the A/ command itself cannot be repeated. Values: No parameters Syntax: A/
Command Possible responses
A/ Note: Repeat last command
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 15
Chapter 4 – General AT Commands
Power Off +CPOF
Description: Stops the GSM software stack as well as the hardware layer or modem activity. The AT +CFUN=0
command is equivalent to +CPOF.
Values: No parameters Syntax: AT+CPOF[=1]
Command Possible responses
AT+CPOF Note: Stop GSM stack AT+CPOF=1 Note: Stop the modem
Note: After AT+CPOF[=1], the modem will not respond to AT commands. To reset it, use the hard
reset.
Note: I n autobaud mode, after an AT+CPOF, unsolicited information that wakes up the modem is
sent at 9600 bps until an AT command is sent. When an AT command is sent, the modem will synchronize to the sender’s speed.
Caution: When starting up, if autobauding is enabled and no AT command has yet been received, the
product sends all unsolicited responses (like RING) at 9600 baud.
OK Note: Command valid OK Note: Command valid
Set Phone Functionality +CFUN
Description: Selects the mobile station’s level of functionality. When the applicati on wants to stop the product with a
power off, or if the application wants to force the product to execute an IMSI DETACH procedure, then it must send: AT+CFUN=0 (equivalent to AT+CPOF).
This command executes an IMSI DETACH and makes a backup copy of some internal parameters in
SIM and in EEPROM. The SIM card cannot then be accessed.
If the mobile equipment is not powered off by the application after this command has been sent, a re-
start command (AT+CFUN=1) will have to issued to restart the whole GSM registration process.
If the mobile equipment is turned off after this command, then a power on will automatically restart the
whole GSM process.
The AT+CFUN=1 command restarts the entire GSM stack and GSM functionality: a complete software
reset is performed. All parameters are reset to their previous values if AT&W was not used.
If you write entries in the phonebook (+CPBW) and then reset the product directly (AT+CFUN=1, with
no previous AT+CFUN=0 command), some entries may not be written (the SIM task does not have enough time to write entries in the SIM card).
In addition, the OK response will be sent at the last baud rate defined by the +IPR command. With the
autobauding mode the response can be at a different baud rate, it is therefore preferable to save the defined baud rate with AT&W before directly sending the AT+CFUN=1 command.
Values: <functionality level>
0 Set minimum funtionality; IMSI detach procedure
1 Set the full functionality mode with a complete software reset
Syntax: AT+CFUN=<functionality level>
Command Possible responses
AT+CFUN? Note: Ask for current functionality level
AT+CFUN=0 Note: Set minimum functionality, IMSI detach procedure AT+CFUN=1 Note: Set the full functionality mode with a complete software reset
+CFUN: 1 OK Note: Full functionality OK Note: Command valid OK Note: Command valid
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 16
Chapter 4 – General AT Commands
Phone Activity Status +CPAS
Description: Returns the activity status of the mobile equipment. Values: <pas>
0 ready (allow commands from TA/TE) 1 unavailable (does not allow commands) 2 unknown 3 ringing (ringer is active) 4 call in progress 5 asleep (low functionality)
Syntax: AT+CPAS
Command Possible responses
AT+CPAS Note: Current activity status
+CPAS: <pas> OK
Report Mobile Equipment Errors +CMEE
Description: Disables or enables the use of the “+CME ERROR: <xxx>” or “+CMS ERROR:< xxx>” result code
instead of simply “ERROR”. See the Appendix for +CME ERROR Result Codes description and +CMS ERROR result codes.
Values: <error reporting flag> 0 Disable ME error reports; use only << ERROR >> 1 Enable <<+CME ERROR: <xxx> >> or
<< +CMS ERROR: <xxx> >> Syntax: AT+CMEE=<error reporting flag>
Command Possible responses
AT+CMEE=? AT+CMEE=0
Note: Disable ME error reports, use only << ERROR >> AT+CMEE=1 Note: Enable << +CME ERROR: <xxx> << or << +CMS ERROR: <xxx> >>
+CMEE: (0,1) OK OK
OK
Keypad Control +CKPD
Description: Emulates the modem keypad by sending each keystroke as a character in a <keys> string. The supported GSM sequences are listed in the Appendix A.
If emulation fails, a +CME ERROR: <err> is returned. If emulation succeeds, the result depends on the GSM sequence activated. Note: In the case where the FDN phonebook is activated, the sequences concerning “call forwarding”
are allowed only if the entire sequence is written in the FDN. Values: <keys> Keyboard sequence; string of the following characters (0-9, *, #)
Syntax: AT+CKPD=<keys>
Command Possible responses
AT+CKPD=”*#21#” Note: Check every call forwarding status AT+CKPD=”1234” Note: Sequence not allowed
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 17
+CCFC: 0,7 +CME ERROR 3
Chapter 4 – General AT Commands
Clock Management +CCLK
Description: Sets or gets the current date and time of the ME real-time clock. Values: <date and time string>
String format for date/time is “yy/MM/dd,hh:mm:ss” Note: Valid years are 98 (for 1998) to 97 (for 2097). The second field is not mandatory. Default
date/time is “98/01/01,00:00:00” (January 1
Syntax: AT+CCLK=<date and time string>
Command Possible responses
AT+CCLK=”00/06/09,17:33:00” Note: set date to June 9th, 2000, and time to 5:33pm
AT+CCLK=”00/13/13,12:00:00” Note: Incorrect month entered
AT+CCLK? Note: Get current date and time
st
, 1998 / midnight).
OK Note: Date/Time stored
+CME ERROR 3
+CCLK: “00/06/09,17:34:23” OK Note: current date is June 9th, 2000 current time is 5:34:23 pm
Alarm Management +CALA
Description: Sets the alarm date/time in the modem. The maximum number of alarms is 16. Note: The date/time should be set with the AT+CCLK command prior to using AT+CALA. Values: <date and time string> String format for alarms: “yy/MM/dd,hh:mm:ss” (see +CCLK)
Note: Seconds are taken into account. <index> Offset in the alarm list, range 1 to 16
Syntax: AT+CALA=<date and time string> (set alarm) AT+CALA=””,<index> (delete alarm)
Command Possible responses
AT+CALA=”00/06/09,07:30” Note: set an alarm for June 9 AT+CALA=”99/03/05,13:00:00” Note: set an alarm for March 5 AT+CALA?
Note: list all alarms +CALA: “00/06/08,15:25:00”,1 AT+CALA=””,3
Note: delete alarm index 3 AT+CALA? Note: list all alarms
th
, 2000 at 7:30 am
th
, 1999 at 1:00 pm
OK Note: Alarm stored +CME ERROR 3 Note: Invalid alarm (date/time expired) +CALA: “00/06/08,15:25:00”,1 +CALA: “00/06/09,07:30:00”,2 +CALA: “00/06/10,23:59:00”,3 Note: three alarms are set (index 1, 2, 3)
Note: an alarm occurs (index 1) OK Note: Alarm index 3 deleted +CALA: “00/06/09,07:30:00”,2 Note: Only one alarm (index 2)
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 18
Chapter 5 – Call Control Commands
V
Chapter 5 – Call Control
Commands
Dial Command D
Description: The ATD command sets a voice or data call. As per GSM 02.30, the di al command also controls
supplementary services.
Data Calls
For a data call, the application sends the following ASCII string to the product (the bearer must be
previously selected with the +CBST command): ATD<nb> where <nb> is the destination phone number. Note: If a GPRS PPP session is already
running, the setting of CSD (GSM data call) is not supported.
Voice Calls
For a voice call, the application sends the following ASCII string to the product: (the bearer may be
selected previously, if not a default bearer is used). ATD<nb>; where <nb> is the destination phone number.
Emergency Calls
For emergency calls:
These Emergency Numbers are available without
000, 08, 110, 112, 118, 119, 911 and 999.
These Emergency Numbers are available with a SIM card:
When EF_ECC file is missing from SIM: 112 and 911. When SIM includes an EF_ECC file: 112, 911 and any emergency numbers available in the
EF_ECC file.
International Numbers For an international number, the local international prefix does not need to be set (usually 00) but does
need to be replaced by the ‘+’ character. Example: to set up a voice call to Multi-Tech offices from another country, the AT command is:
“ATD+17637853600;” Some countries/regions may have specific numbering rules for their GSM handset numbering.
Values: <nb> Destination phone number <I> Optional parameter. <I> means “invocation” (restrict CLI presentation) <i> means “suppresssion” (allow CLI presentation) <mem> Phonebook (one of SM, LD, MC, ON, ME, RC, MT or SN). A default value can be selected
by using the +CPBS command. <index> Call number at indicated offset from the phonebook selected by the +CPBS command. <name> Call number corresponding to given name from the phonebook selected by the +CPBS
command.
The response to the ATD command is one of the following:
erbose result code Numeric code
(with ATV0 set)
OK 0 if the call succeeds, for voice call only CONNECT <speed> 10,11,12,13,14,15 if the call succeeds, for data calls only, <speed> takes
BUSY 7 If the called party is already in communication NO ANSWER 8 If no hang up is detected after a fixed network time-out NO CARRIER 3 Call setup failed or remote user release. Use the
Description
the value negotiated by the product.
AT+CEER command to know the failure cause
a SIM card:
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 19
Chapter 5 – Call Control Commands
Direct Dialing from a Phonebook (stored in the SIM card) can be performed with the following commands:
ATD> <index>; to call <index> from the selected phonebook (by the +CPBS command) ATD> “BILL”; to call “BILL” from the selected phonebook ATD> mem <index> allows direct dialing from a phonebook number
<mem> is SM, LD, MC, ME, RC, MT or SN. See +CPBS command
Syntax: ATD<nb>[<I>][;]
ATD>[<mem>]<index>[<I>][;] ATD>[<mem>]<name>[<I>][;]
Command Possible responses
AT+CPBS? Note: Which phonebook is selected ?
ATD>SM6; Note: Call index 6 from AND phonebook
When the FDN phonebook has been locked, only numbers beginning with the digits of FDN
phonebook entries can be called.
For example, if “014629” is entered in the FDN phonebook all the phone numbers beginni ng with these
6 digits can be called. The CLIR supplementary service subscription can be ove rridden for this call only. “I” means “invocation” (restrict CLI presentation). “i” means “suppression” (allow CLI presentation). Control of CUG supplementary service information by “G” or “g” is allowed for this call only. The
index and info values set with the +CCUG command are used. An outgoing call attempt could be refused if the AOC service is active and credit has expired (NO
CARRIER). When trying to set up an outgoing call while there is an active call, the active call is first put on hold,
then the call set up is carried out. As per GSM 02.30, GSM sequences may be controlled using dial commands. These sequences can
contain “*”, “#”, but “;” is forbidden. If the sequence is not supported or fails, +CME ERROR: <err> is returned. In the case, where the FDN
phonebook is activated, the sequences concerning call forwarding are allowed only if they are written in
the FDN. See Codes and Values Appendix for the list of supported sequences.
+CPBS:”SM”,8,10 Note: ADN phonebook is selected, 8 locations are used and 10 locations are available OK Note: Call succeeds
Command Possible responses
ATD*#21# Note: Check any call forwarding status ATD**61*+33146290800**25# Note: Register call forwarding on no reply, with no reply timer fixed at 25 s. ATD*2# Note: Bad sequence
+CCFC: 0,7 Note: No call forwarding OK Note: done
+CME ERROR 3
Hang-Up Command H
Description: The ATH (or ATH0) command disconn ects the remote user. In the case of multiple calls, all calls are
released (active, on-hold and waiting calls). The specific ATH1 command has been appended to
disconnect the current outgoing call, only in dialing or alerting state (i.e., ATH1 can be used only after
the ATD command, and before its terminal response (OK, NO CARRIER, ...)
It can be useful in the case of multiple calls.
Values: <n>
0 Ask for disconnection (default value) 1 Ask for outgoing call disconnection
Syntax: ATH<n>
Command Possible responses
ATH Note: Ask for disconnection ATH1 Note: Ask for outgoing call disconnection
OK Note: Every call, if any, is released OK Note: Outgoing call, if any, is released
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 20
Chapter 5 – Call Control Commands
Answer a Call A
Description: When the product receives a call, it sets the RingInd signal and sends the ASCII “RING” or “+CRING:
<type>” string to the application (+CRING if the cellular result code +CRC is enabled). Then it waits for
the application to accept the call with the ATA command.
Values: No parameters. Syntax: ATA
Command Possible responses
ATA Note: Answer to this incoming call ATH Note: Disconnect call
RING Note: Incoming call OK Note: Call accepted OK Note: Call disconnected
Remote Disconnection
This message is used by the product to inform the application that an active call has been released by the remote user. The product sends “NO CARRIER” to the application and sets the DCD signal.
In addition, for AOC, the product can release the call if credit has expired (release cause 68 with +CEER command).
Extended Error Report +CEER
Description: This command gives the cause of call release when the last call set up (originating or answering) failed. Values: No parameters Syntax: AT+CEER
Command Possible responses
ATD123456789; Note: Outgoing voice call
AT+CEER Note: Ask for reason of release
Note: “NO CARRIER” indicates that the AT+CEER information is available for failure diagnosis.
NO CARRIER Note: Call setup failure
+CEER: Error <xxx> OK Note: <xxx>is the cause information element values from GSM recommendation 04.08 or specific Call accepted
DTMF Signals +VTD, +VTS
+VTD
Description: The product enables the user application to send DTMF tones over the GSM network. This command is
used to define tone duration (the default value is 70 ms ± 5 ms according to 3GPP 23.014). Values: <n> tone duration.
This refers to an integer <n> that defines the length of tones emitted as a result of the +VTS command. This does not affect the D command. A value different than zero causes a tone of duration <n> *100 milliseconds. A value of zero (default value) causes a tone duration of 70 ms ± 5 ms. Note: The value is used modulo 256.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 21
Chapter 5 – Call Control Commands
Syntax: AT+VTD=<n>
Command Possible responses
AT+VTD=6 Note: To define 600 ms tone duration AT+VTD=0 Note: To set the default value (70 ms ± 5 ms) AT+VTD? Note: Query current tone duration AT+VTD=? AT+VTD: <0-255>
OK Note: Command valid OK
AT+VTD: <n> OK
OK
+VTDS
Description: The product enables the user application to send DTMF tones over the GSM network. This command
enables tones to be transmitted only when there is an active call.
Values: <Tone> DTMF tone to transmit. Tone is in {0-9, *, #, A, B, C, D}
Syntax: Command Syntax: AT+VTS=<Tone>
Command Possible responses
AT+VTS=A AT+VTS=11
Note: To set the default value AT+VTS=4
AT+VTS=”1”;+VTS=”3”;+VTS=”#” OK Note: Sed tone sequence 13#
OK Note: Command valid +CME ERROR: 3 Note: If the <Tone> is wrong +CME ERROR: 3 Note: If there is no communication
Redial Last Telephone Number DL
Description: This command redials the last number used in the ATD command. The last number dialed is displayed
followed by “;” for voice calls only.
Values: No parameters Syntax: ATDL
Command Possible responses
ATDL Note: Redial last number
0146290800; OK Note: Last call was a voice call. Command valid
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 22
Chapter 5 – Call Control Commands
Automatic Dialing with DTR %D
Description: This command enables and disables:
Automatic dialing of the phone number stored in the first location of the ADN phonebook, (or
FDN phonebook, if it is activated using the +CLCK command).
Automatic sending of the short message (SMS) stored in the first location of the SIM.
The number is dialed when the DTR OFF switches ON. The short message is sent when DTR OFF switches ON.
Values: <n> (0-2) Enables or disables automatic message transmission or number dialing. Informs the
product that the number is a voice number rather than a data number.
%D0 Disables automatic DTR number dialing / message transmission. %D1; Enables automatic DTR dialing if DTR switches from OFF to ON. Dials the phone number
in the first location of the ADN phonebook (or FDN phonebook, if it is activated using the +CLCK command). Voice call with semicolon.
%D1 Activates automatic DTR dialing if DTR switches from OFF to ON. Dials the phone
number in the first location of the ADN phonebook (or FDN phonebook, if it is activated using the +CLCK command). Data call without semicolon.
%D2 Activates automatic DTR message transmission if DTR switches from OFF to ON. Sends
the short message in the first location of the SIM. Note: If the first location is empty:
AT%D1 and AT%D2 commands will receive an OK response.
The DTR ON event will trigger a CME ERROR: 21 or a CMS ERROR: 321
Syntax: Command Syntax: AT%D<n>[;]
Command Possible responses
AT%D1; Note: Activates DTR number dialing
DTR is OFF DTR switches ON
Note: Number in the ADN’s first location is dialed automatically
DTR switches OFF
Note: The product goes on-hook AT%D2 Note: Activates DTR short message sending
DTR is OFF DTR switches ON
Note: The first short message is being sent AT%D1; OK
DTR is OFF DTR switches ON
Note: No phone number in the ADN phonebook’s first location (or FDN phonebook if it’s activated using the +CLCK command) AT%D2; OK
DTR is OFF DTR switches ON
Note: No short message in the first location of the SIM
OK Note: Command has been executed
OK
OK Note: Command has been executed
+CMSS: x
+CME ERROR: 21
+CME ERROR: 321
Automatic Answer S0
Description: This S0 parameter determines and controls the product automatic answering mode. Values: <value> The number of rings before an automatic answer (3 characters padded with zeros)
Range of values is 0 to 255.
Syntax: Command Syntax: ATS0=<value>
Command Possible responses
ATS0=2 Note: Automatic answer after 2 rings ATS0?
Note: Current value ATS0=0 Note: No automatic answer
All others S-parameters (S6,S7,S8 …) are not implemented.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 23
OK 002
OK Note: always 3 characters padded with zeros OK Note: Command valid
Chapter 5 – Call Control Commands
Incoming Call Bearer +CICB
Description: This command sets the type of incoming calls when no incoming bearer is given (see +CSNS).
Note: Setting the +CICB command affects the current value of +CSNS.
Values: <mode>
0 Data 2 Speech
Syntax: AT+CICB=<mode>
Command Possible responses
AT+CICB=2 Note: If no incoming bearer, force a voice call AT+CICB? Note: Interrogate value
AT+CICB=? Note: Test command
OK Note: Command accepted +CICB: 2 OK Note: Default incoming bearer: voice call +CICB: (0-2) OK Note: Speech or data default incoming bearer
Single Numbering Scheme +CSNS
Description: Selects the bearer to be used when an modem single numberi ng scheme call is set up (see +CICB).
Note: Setting the +CSNS command affects the current value of +CICB.
Values: <mode>
0 Voice 4 Data Syntax: AT+CSNS
Command Possible responses
AT+CSNS=0 Note: force a voice call OK Note: Command accepted AT+CSNS? Note: Interrogate value +CSNS: 0 Note: Default incoming bearer: voice call AT+CSNS=? Note: Test command +CSNS: (0,2,4) Note: Voice or data default incoming
bearer
Gain Control +VGR, +VGT
Description: This command is used by the application to tune the receive gain of the speaker and the transmit gain
of the microphone.
Values: <Rgain> is the reception gain <Tgain> is the transmission gain
Syntax: AT+VGR=<Rgain> and AT+VGT=<Tgain>
Command Possible responses
AT+VGR=25 AT+VGT=45 OK Note: Command valid
AT+VGR? Note: Interrogate value AT+VGR=? Note: Test command AT+VGT? Note: Interrogate value AT+VGT=? Note: Test command
Note: For the AT+VGT? command with controller 1, the value is the lower value of range; whereas,
with controller 2, the value corresponds to the entered value using AT+VGT=xx.
OK Note: Command valid
+VGR: 128 OK Note: Default receive gain +VGR: (0-255) OK Note: Possible values +VGT: 32 OK Note: Default transmit gain +VGT: (0-255) OK Note: Possible values
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 24
The application sends the following:
AT+VGR=<val> for receive gain AT+VGT=<val> 0 to 15 +6 db 0 to 31 +30 db 0 +0 db
16 to 31 +4 db 32 to 63 +33 db 1 +0,5 db 32 to 47 +2 db 64 to 95 +36 db 2 +1 db 48 to 63 +0 db 96 to 127 +39 db 3 +1,5 db 64 to 79 -2 db 128 to 159 +42 db … 80 to 95 -4 db 160 to 191 +45 db 19 +9,5 db 96 to 111 -6 db 192 to 223 +48 db 20 +10 db 112 to 127 -8 db 224 to 255 +51 db 21 +10.5 db 128 to 143 -10 db 22 +11 db 144 to 159 -12 db 23 +11.5 db 160 to 175 -14 db 176 to 191 -16 db 58 +29 db 192 to 207 -18 db 59 +29.5 db 208 to 223 -20 db 60 +30 db 224 to 255 -22 db 61 +30,5 db 62 +31 db … … 101 +50,5 db 102 to 127 +51 db 128 to 243 -6,5 db 244 -6 db 245 -5,5 db 246 -5 db 255 -0,5 db
The gain values listed here are relative, for absolute (electrical) values please refer to the specific hardware documentation of the module used in the application.
Controller 1
for transmit gain Controller 1
Chapter 5 – Call Control Commands
AT+VGT=<val>
Controller 2
for transmit gain Controller 2
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 25
Chapter 5 – Call Control Commands
Microphone Mute Control +CMUT
Description: This command mutes the microphone input on the product (for the active microph one set with the
+SPEAKER command). This command is only allowed during a call.
Values: <mode>
0 microphone mute off (default value). 1 microphone mute on.
Syntax: AT+CMUT=<mode>
Command Possible responses
AT+CMUT=? Note: Test command
AT+CMUT? Note: Ask for current value
AT+CMUT=1 Note: Mute ON (call active) AT+CMUT?
Note: Ask for current value AT+CMUT=0 Note: Mute OFF (call not active)
+CMUT: (0,1) OK Note: Enable / disable mute +CMUT: 0 OK Note: Current value is OFF OK Note: Command valid +CMUT: 1 OK Note: Mute is active (call active) +CME ERROR:3 Note: Command not valid
Speaker & Microphone Selection +SPEAKER
Description: This specific command selects the speaker and the microphone set.
Values: <ActiveSpkMic>
0 Speaker One, Micro One 1 Speaker Two, Micro Two
Syntax: AT+SPEAKER=<ActiveSpkMic>
Command Possible responses
AT+SPEAKER=0 Note: Speaker ONE and Micro ONE AT+SPEAKER?
AT+SPEAKER=? +SPEAKER: (0,1)
OK Note: Command valid +SPEAKER: 0 OK Note: Speaker ONE and Micro ONE are active
OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 26
Chapter 5 – Call Control Commands
A
Echo Cancellation +ECHO
Description: This command enables, disables or configures the Echo Cance llation functions for voice calls (in rooms,
in cars, etc.).
It is necessary to tune the Microphone gain (AT+VGT) and the Speaker gain (AT+VGR) before
activating the Echo Cancellation.
Notes:
You can activate/deactivate the echo cancellation during a call without resetting the product if
the <Algold> parameter is not changed, but have to used the syntax with all parameters: AT+ECHO=1,6,30,8000,256 for instance.
To use Echo Cancellation 6, the ECHO feature must be activated.
Note that Echo Cancellation algorithms may not be available on some modems:
Modem
Q24 Plus (AMR) Yes No
Values: <mode>
0 Deactivate Echo 1 Activate Echo
When mode = 1 is choosen, AlgoId is mandatory. <status>
0 Echo Deactivated 1 Echo Activated for Mic/Spk One 2 Echo Activated for Mic/Spk Two 3 Reset the product Note: <Status> does not indicate the currently selected speaker. If Echo is activated, it indicates
the speaker for which Echo parameters are set. Echo can be activated on a non-selected speaker.
<AlgoId>
1 Echo cancellation 1 6 Echo cancellation 6: AEC algorithm
Note that Echo Cancellation algorithms may not be available on some modems. Refer to the description above.
Echo Cancellation 1 (4 parameters): <Volout> Specifies the maximum attenuation of the switch
0 31 db (default) 1 29 db 2 27 db 3 25 db
14 3 db 15 1 db
<Step> Specifies the attenuation step between attenuation and no attenuation.
0 1 db 1 2 db 2 3 db 3 4 db (default)
<PcmThRel> Specifies the relative threshold between max and min energy information.
The allowed range is [0 - 31]. Default = 10.
<PcmThMax> Specifies threshold of max energy information.
The allowed range is [0 - 31]. Default = 7.
lgorithm 6 SupportAlgorithm 3 Support
Echo Cancellation 6 (12 parameters): <AlgoParam> High value leads to high echo attenuation but the full-duplex quality will be
less efficient. The allowed range is [ 0 - 63 ]. (30 by default)
<NoiseThres> indicates the noise threshold. Low value leads to high noise attenuation.
The threshold 32767 indicates no noise attenuation. The allowed range is [0 - 32767]. T
he default is
<NmbTaps> indicates the Number of Taps of the Adaptive Filter. The allowed range is [2 -
256]. The default is 256. 64 taps = short Echo 256 taps = long Echo
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 27
50. The values above 512 have no effect (noise reduction will be disabled)
Chapter 5 – Call Control Commands
<ConvergenceTime1> Convergence time in quiet condition:
This parameter expresses duration as the number of GSM speech frames (20 ms each) containing far end speech, upon which the switch only mechanism must run in quiet conditions. The allowed range is [162 - 32767]. The default is 200.
<ConvergenceTime2> Convergence time in noise condition:
This parameter is the same as ConvergenceTime1 but for the noise condition. T he allowed range is [162 - 32767]. The default is 550.
Important Note: <ConvergenceTime2> must be greater than or equ al to <ConvergenceTime1>
<NoiseLevelMAX> Upper bound of the noise floor estimate:
This parameter is expressed as an integer of 16 bits and corresponds to the rounded value of the noise floor estimate expressed in dB (log2). The allowed range is [NOISE_LEVEL_MIN+1 - 31] with NOISE_LEVEL_MIN being a constant (NOISE_LEVEL_MIN=4 in the current implementation). The default is 15.
<DetectionThreshold> Far-end speech detection threshold:
In order to detect far end speech on the loudspeaker's signal, the SNR is computed regarding the far end signal power and the far end signal noise floor level. This parameter specifies a threshold on the SNR above which the switch mechanism will be activated. This parameter is expressed as an integer of 16 bits and must be in the range [0 - 32767]. The default is 32767.
<CNGAdjust> Comfort noise volume gain:
Although the comfort noise volume will self adjust to the estimated ambient noise level, it is possible to artificially reduce its level. This parameter is expressed in fixed point as a signed Q15, meaning that 32767 stands for 1.0, and 0 for 0.0. It ranges fro 0 to 32767. Setting this value to 0 means no comfort noise. The default is 32767.
<CNGParam1>, <CNGParam2>: 16 bits comfort noise AR2 coefficients:
The user will set the AR2 coefficients for a specific car. Their value will be estimated on a recorded noise sequence by means of a tool provided by Wavecom (C or Matlab source code) The recorded sequence shall be made in the noisy conditions and contain noise only. The allowed range is [0 - 65535]. The default for CNGParam1 is 27484. The default for CNGParam2 is 38697.
<CNGGain>: 16 bits comfort noise AR2 gain coefficients:
This specifies the gain of the AR2 filter used for comfort noise generation. It will be estimated by the same tools use to estimate <CNGParam1> and <CNGParam2>. It is represented as a Q15 of 16 bits. The allowed range is [0 - 32767]. The default is 7311.
<SOMValue>: Switch attenuation value at the beginning of the call:
This parameter will range from 1 to 16 and set the depth of the attenuation of the transmit audio signal when speech is detected on the distant side. T
he default is 4.
<NoiseEstimate>: Value of the noise floor estimate written by the DSP (only in case
of active communication):
The allowed range is [0 - 32] when a communication is active. Otherwise, the returned value is 65535.
Notes:
The field <NoiseEstimate> is present only for Algold 6 and only in the response to
AT+ECHO?
When a new algoid is selected, AT+ECHO? returns 3 for the mode. The changes will
be taken into account after a reset.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 28
Syntax: Command Syntax:
For Algold=1:
AT+ECHO=<mode>[,<Algold>[,<VolOut>,<Step>,<PcmThRel>,<PcmThMax>]]
For Algold=6:
AT+ECHO=<mode>[,<Algold>[,<AlgoParam>,<NoiseThres>,<NmbTaps>,<ConvergenceTime 1>,<ConvergenceTime2>,<NoiseLevelMAX>,<DetectionThreshold>,<CNGAdjust>,<CNGPara m1>,<CNGParam2>,<CNGGain>,<NmbDelay>]]
Response Syntax:
For Algold=1:
ECHO: <status>,<Algold>,<VolOut>,<Step>,<PcmThRel>,<PcmThMax>
For Algold=6:
ECHO: <status>,<Algold>,<AlgoParam>,<NoiseThres>,<NmbTaps>,<ConvergenceTime1>, <ConvergenceTime2>,<NoiseLevelMAX>,<DetectionThreshold>,<CNGAdjust>,<CNGParam1 >,<CNGParam2>,<CNGGain>,<NmbDelay>,<NoiseEstimate>
Command Possible responses
AT+CMEE=1 Note: Enables the use of result code AT+SPEAKER?
AT+SIDET=0 Note: Deactivate the Sidetone AT+SIDET? +SIDET: 0,0 AT+ECHO? Note: Read current settings AT+ECHO=1,1,0,6,10,7 Note: Active Echo cancellation 1 for Mic/Spk one. AT+ECHO? Note: Read current settings AT+ECHO=1,6,30,8000,256 Note: Activate the Echo cancellation 6
AT+ECHO? Note: Read the Echo cancellation settings AT+CFUN=1 Note: Reset the product AT+ECHO? Note: Read current settings AT+ECHO=0 Note: Deactivate the Echo Cancellation AT+ECHO=0 Note: Deactivate the Echo Cancellation AT+ECHO=1,6,30,50,256,200, 550,15,32767,27484,38697,7311,2 Note: Activate the Echo Cancellation 6 AT+ECHO? Note: Read the Echo Cancellation settings
AT+CFUN=1 Note: Reset the product AT+ECHO? Note: Read the Echo Cancellation settings
Chapter 5 – Call Control Commands
OK + SPEAKER: 0
OK Note: Speaker ONE and Micro ONE are active OK
+ECHO: 0,1,0,6,10,7 OK OK
+ECHO: 1,1,0,3,10,7 OK +CME ERROR: 519 Note: The new algorithm will be activated after a reset of the product +ECHO: 6,30,8000,256 OK OK
+ECHO: 1,6,30,8000,256 OK OK
OK +CME ERROR:519
Note: The new algorithm will be activated after a reset of the product +ECHO: 6,30,50,256,200,550,15,32767,32767, 27484,38697,7311,2,65535 OK OK
+ECHO: 1,6,30,50,256,200,550,15,32767,32767, 27484,38697,7311,2,65535 OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 29
Chapter 5 – Call Control Commands
SideTone Modification +SIDET
Description: This command sets the level of audio feedback in the speaker (microphone feedback in the speaker).
Values: <val1>
0 SideTone is disabled 1 SideTone is enabled
<val2> (default value 0 will be used if this parameter is not given) 0 0 db 1 - 6 db 2 - 12 db 3 - 18 db
Syntax: AT+SIDET=<val1>,<val2>
Command Possible responses
AT+SIDET=1,0 OK
Note: Command valid AT+SIDET? Note: Current value
AT+SIDET=? +SIDET: (0-1),(0-3)
+SIDET: 1,0
OK
Note: Command valid
OK
Initialize Voice Parameters +VIP
Description: This command allows factory settings for voice parameters to be restored from EEPROM. These voice parameters include:
Gain control (+VGR & +VGT commands)
Gain controller (+WSVG command)
Microphone mute control (+CMUT command)
Speaker & Microphone selection (+SPEAKER command)
Echo cancellation (+ECHO command)
Side tone modification (+SIDET command)
Values: <n>
1 Restore all voice parameters.
Other values are not supported.
Syntax: AT+VIP=<n>
Command Possible responses
AT+VIP? +VIP: 1
OK AT+VIP=2 Note: Syntax error AT+VIP=1 Note: Restore the factory settings from EEPROM AT+VIP=1 Note: Restore the factory settings from EEPROM with the current Echo cancellation algorithm (different of the default algorithm). AT+VIP=? Note: List of supported <n>s
+CME ERROR: 3
OK
Note: The command has been executed
CME ERROR: 519
Note: Reset the product to accept the new
algorithm.
+VIP: (1)
OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 30
Chapter 6 – Network Service Commands
Chapter 6 – Network Service
Commands
Signal Quality +CSQ
Description: This command determines the received signal strength indi cation (<rssi>) and the channel bit error rate
(<ber>) with or without a SIM card inserted.
Values: <rssi>:
0 -113 dBm or less 1 -111 dBm 2 to 30 -109 to –53 dBm 31 -51dBm or greater 99 not known or not detectable
<ber>: 0…7: as RXQUAL values in the table GSM 05.08 99 not known or not detectable
Syntax: AT+CSQ
Command Possible responses
AT+CSQ +CSQ: <rssi>,<ber>
OK (Note: <rssi> and <ber> as defined below)
Operator Selection +COPS
Description: There are three possible ways of selecting a Public L an d Mobil e Network (PLMN) operator:
The product is in manual mode. It then tries to find the operator specified by the application
and if found, tries to register.
The product is in automatic mode. It then tries to find the home operator and if found, tries to
register. If not found, the product automatically searches for another network.
The product enters into manual/automatic mode, and then tries to find an operator as
specified by the application (as in manual mode). If this attempt fails, it enters automatic mode. If this is successful, the operator specified by the application is selected. The mobile equipment then enters into automatic mode.
Note: The read command returns the current mode and the currently selected operator. In manual
mode, this PLMN may not be the one set by the application (as it is in the search phase). These commands are not allowed during communication.
Values: <mode>
0 automatic (default value) 1 manual 2 deregistration; ME will be unregistered until <mode>=0 or 1 is selected. 3 set only <format> (for read command AT+COPS?) 4 manual / automatic (<oper> shall be present), if manual selection fails, automatic mode is
entered.
<format> <format>: format of <oper> field
0 long alphanumeric format <oper> 1 short alphanumeric format <oper> 2 numeric <oper> (default value)
<stat> Status of operator 0 unknown 1 available 2 current 3 forbidden
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 31
Chapter 6 – Network Service Commands
<oper> Operator identifier (MCC/MNC in numeric format only for operator selection) The long alphanumeric format can be up to 16 characters long (see Codes and Values Appendi x
for operator names description, field is “Name”). The short alphanumeric format can be up to 8 characters long.
Syntax: To force an attempt to select and register on a network, the application must send this command:
Command Syntax: AT+COPS=<mode>, [<format> [ , <oper> ] ]
Possible Responses for AT+COPS=<mode>
Possible Responses Meaning
OK Network is selected with full service +CME ERROR: 30 No network service +CME ERROR: 32 Network not allowed – emergency calls only +CME ERROR: 3 Not allowed during communication +CME ERROR: 4 Incorrect parameters +CME ERROR: 527 Please wait, and retry your selection later +CME ERROR: 528 Location update failure – emergency calls only +CME ERROR: 529 Selection failure – emergency calls only +CME ERROR: 546 Emergency call is not allowed without SIM +CME ERROR: 547 Emergency call is allowed without SIM
Note: The error codes +CME ERROR: 546 and +CME ERROR: 547 are only returned if the SIM is not present. The fact that network support emergency call (+CME ERROR: 547) does not imply that emergency call without the SIM is working. To find out if it is working is to use the ATD112 command.
Response Syntax for AT+COPS?: +COPS: <mode> [, <format>, <oper> ] Response Syntax for AT+COPS=?: +COPS: [list of supported (<stat>, long alp hanumeric <oper>,
short alphanumeric <oper>s, numeric <oper>) s]
Notes:
If an incoming call occurs during a PLMN list request, the operation is aborted
(+CME ERROR: 520) and the unsolicited RING appears.
If SPN (Service Provider Name) is present in the SIM, it will be returned in both long and short
alphanumeric <oper> fields. The string in the “short” field will be the SPN truncated to the appropriate character number.
The following operations are allowed with the SIM inserted or the PIN activated: AT+COPS? Get Current PLMN AT+COPS=? List allowed PLMN AT+COPS=1,2,<plmn> Manually set current PLMN
Command Possible responses
AT+COPS? Note: Ask for current PLMN
AT+COPS=?
Note: Ask for PLMN list
AT+COPS=1,2,20810 Note: Ask for registration on SFR network AT+COPS=1,2,23433 Note: Ask for registration on UK Orange network AT+COPS=0 Note: Ask for registration in automatic mode AT+COPS=3,0 Note: Set <format> to long alphanumeric AT+COPS?
Note: Ask for current PLMN AT+COPS=2 Note: Ask for deregistration from network AT+COPS? Note: Ask for current PLMN
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 32
+COPS: 0,2,20801 OK Note: Home PLMN is France Telecom Orange +COPS: (2,”F SFR”,”SFR”,”20801”), (3,”F-BOUYGUES TELECOM”,”BYTEL”,”20820”),(3,”Orange F”,”Orange”,”20801” OK Note: Home PLMN is France Telecom SFR, BYTEL and Orange networks have been detected +CME ERROR: 32 Note: Network not allowed – emergency calls only +CME ERROR: 529 Note: Selection failed – emergency calls only
OK Note: Succeeded OK
+COPS: 0,0,”Orange F” OK Note: Home PLMN is France Telecom Orange OK Note: Succeeded +COPS: 2 Note: ME is unregistered until <mode>=0 or 1 is selected
Chapter 6 – Network Service Commands
Network Registration +CREG
Description: This command is used by the application to ascertain the registration status of the product.
Values: <mode>
0 Disable network registration unsolicited result code (default) 1 Enable network registration code result code +CREG: <stat> 2 Enable network registration and location information unsolicited result code +CREG:
<stat>,<lac>,<ci> if there is a change of network cell.
<stat>
0 Not registered, ME is not currently searching for a new operator. 1 Registered, home network. 2 Not registered, ME currently searching for a new operator to register to. 3 Registration denied. 4 Unknown. 5 Registered, roaming.
<lac>: String type; two byte location area code in hexadecimal format (e.g., “00C3” equals 195 in
decimal).
<ci>: String type; two byte cell ID in hexadecimal format.
Syntax: Command Syntax: AT+CREG= <mode> Response syntax: +CREG: <mode>, <stat> [ ,<lac>,<ci> ] for AT+CREG? Command only
Command Possible responses
AT+CREG?
AT+CREG=0 Note: Disable network registration unsolicited result code AT+CREG=1 Note: Enable network registration unsolicited result code AT+CREG=2 Note: Enable network registration and location information unsolicited result code AT+CREG=? +CREG: (0-2)
+CREG: <mode>,<stat> OK Note: As defined here-above OK Note: Command valid OK Note: Command valid OK Note: Command valid
Note: 0,1,2 <mode> values are supported
Operator List Management +WOLM
Description: This command allows a new or modified operator to be added to the PLMN list. Up to 10 PLMNs can be
created and stored in the flash memory. Please note that if two entries with the same network (MCC+MNC), but have different names, are
entered, the first entry will be used.
Values: <mode>
0 Delete 1 Write 2 Read
<loc>
Location. If this parameter is not filled with <mode>=1, the location will be the first emply one.
<NumOper>
Operator in numeric format.
<short name>
The short name of the PLMN.
<long name>
The long name of the PLMN.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 33
Chapter 6 – Network Service Commands
Syntax: Command Syntax: AT+WOLM=<mode>,<loc>,[,<NumOper>,<short name>,<long name>
Response Syntax for AT+WOLM=? OK Response Syntax for AT+WOLM? (lists all the available PLMN)
Command Possible responses
AT+WOLM=1,1,20812,”WM”,”WM PLMN” Note: Add a new PLMN at location 1 AT+WOLM=2,1 Note: Read the PLMN at location 1 AT+WOLM=2,11 Note: Read the PLMN at location 11 AT+WOLM=1,1,20812,”WM1”,”WM1 PLMN” Note: Modify and existing PLMN AT+WOLM=? Note: Test command AT+WOLM? Note: Display current list
AT+WOLM=1,,20813,”PLMN2”,PLMN2 LONG” Note: Add a new PLMN at available location
AT+WOLM=0,1 Note: Delete an entry at location 1 AT+WOLM=0,11 Note: Delete an entry at location 11
OK +WOLM: 1,20812,”WM”,”WM PLMN”
OK +CME ERROR: 21 Note: Invalid index OK Done OK
+WOLM: 1,20812,”WM1”,”WM1 PLMN” OK Note: List the created PLMN in flash OK Or +CME ERROR: 20 Note: Error returns if no more PLMN can be created OK
+CME ERROR: 21 Note: Invalid index
Read Operator Name +WOPN
Description: This command returns the operator name in alphanumeric format when given the numeric format being
given.
With the E-ONS (Enhanced Operator Name Service) feature, <lac> is an optional parameter to read
names from OPL/PNN sim files. If it is not entered, name will be given with current <lac>. Note that in limited service, current <lac> is set to 0.
It also allows the erasing of NITZ PLMN names stored in the flash memory by using AT+WOPN=3,0”. When the modem receives a NITZ (Network Information and Time Zone) message with Long Name or
Short Name information, an entry with registered PLMN and names in the message is created in the flash memory. These names will then be used with +COPS, +COPN, +WOPN and +CPOL with the priority order defined in 3GPP TS 22.101. The modem supports only network names with the GSM default alphabet coding schemes.
The user can choose which of the following methods will be used for getting PLMN names using the command: AT+WOPN=4,<PlmnOns>.
The priority order is:
1 E-ONS First entry if on Home PLMN or matching entry if existing in OPL/PNN SIM files. 2 CPHS If on Home PLMN, use SIM file CPHS ONS (0x6F14) for Long Name if present and SIM
file CPHS SONS (0x6F18) for Short Name if present; if not present, reuse SIM file CPHS ONS.
3 SPN If on Home PLMN, use SIM file SPN (0x6F46) if present. 4 NITZ If there is a matching entry in the list of names received so far, use it. Note that in
France, for example, all the operators use the NITZ message for the Date and Time feature, but not for PLMN names, so the list is always empty. In France, the NITZ message is sent on a GPRS attachment.
FLASH If there is a matching entry in the flash PLMN list (created by +WOLM), use it. 5 ROM PLMN names in the ROM defined according to MoU SE.13 and NAPRD Operator
Names documents.
Note: Once a long name is found following this priority order, it is given as a response to the
AT command.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 34
Chapter 6 – Network Service Commands
Values: <mode>
0 Use long alphanumeric format 1 Use short alphanumeric format 2 Reserved for future use 3 Erase NITZ PLMN list if <NumOper> = 0 4 Access to EEPROM to read or write the method to use for getting PLMN names
Read access if <NumOper> omitted Write access if <NumOper>(=<PlmnOns>) provided.
<NumOper> is the operator in numeric format. <AlphaOper> is the operator in long or short alphanumeric format (see Codes and Values for Operator
Names in the Appendix).
<lac> is the two byte Location Area Code to be used to get the PLMN name. If it is not entered, the
current lac will be used (0 if limited service). It is provided as an integer value.
<PlmnOns> is a bit-field with the following coding:
Bit 0 E-ONS Bit 1 CPHS Bit 2 SPN Bit 3 NITZ Bit 4 FLASH
Bit 4 (FLASH) Bit 3 (NITZ) Bit 2 (SPN) Bit 1 (CPHS) Bit 0 (E-ONS)
Bit value is 1 for Activate and 0 for Deactivate the method. <PlmnOns> value should be provided as a decimal value.
1 1 1 1 1
Example: <PlmnOns>=31 means that the four methods will be used for PLMN names (bit-field value is 1111 or 0x1F).
Operation Flow for Field PlmnOns
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 35
Syntax: Command syntax: AT+WOPN=<format>,<NumOper>[,<lac>] Response syntax: +WOPN: <format>,<AlphaOper>
Command Possible responses
AT+WOPN=? Note: Test command AT+WOPN=0,20801 Note: Give an operator in numeric format
AT+WOPN=0,99999 Note: Give a wrong operator AT+WOPN=0,2081,36 Note: Give an operator in numeric format for lac 36
AT+WOPN=3,0 Note: Erase NITZ PLMN names stored in flash memory. AT+WOPN=4 Note: Read from EEPROM which method will be used for PLMN names. AT+WOPN=4,<PlmnOns> Note: Write to EEPROM which method will be used for PLMN names.
OK +WOPN: 0,”Orange F”
OK Note: Alphanumeric answer +CME ERROR: 22 Note: Not found +WOPN: 0, “OrangeF” OK Note: Alphanumeric answer OK
+WOPN:31 OK
OK
Chapter 6 – Network Service Commands
Selection of Preferred PLMN List +CPLS
Description: This command selects one PLMN selector with access technology list in the SIM card that is used by
AT+CPOL command.
Values: <List>:
0 User controlled PLMN selector with access technology EF_PLMNwAct Note: if this file is not found EF_PLMNSel will be selected 1 Operator controlled PLMN selector with access technology EF_OPLMNwAct 2 Home PLMN selector with access technology EF_HPLMNwAct Syntax: AT+CPLS= <List>
Command Possible responses
AT+CPLS? Note: Ask for selection of the SIM file
AT+CPLS=0 Note: selection of EF_PLMNwAct AT+CPLS=1 Note: selection of EF_OPLMNwAct AT+CPLS=? Note: Get possible values
AT+CPLS=? Note: Get possible values
+CPLS: 1 OK Note: EF_OPLMNwAct is selected Note: if EF_PLMNwAct is not present, EF_PLMNsel will be selected +CME ERROR: 3 Note: EF_OPLMNwAct is not present +CPLS: (0,1,2) OK Note: The 3 files with Acces technology are present and can be selected +CPLS: (0) OK Note: Only EF_PLMNwAct or EF_PLMNsel can be selected
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 36
Chapter 6 – Network Service Commands
Preferred Operator List +CPOL
Description: This command edits (or updates) the SIM preferred list of networks. This list is read in the SIM file selected by the command AT+CPLS.
Values: <index>: position of the operator record in the Sim preferred operator list. Use AT+CPOL=? to view the
maximum index of the selected EF.
<format>
0 long alphanumeric format for <oper> 1 short alphanumeric format for <oper> 2 numeric format for <oper>
<oper>: characterstring or integer (see <format>) indicating operator identifier. <GSM_AcT>: GSM access technology <GSMcomp_Act>: GSM compact access technology <Utran_Act>: UTRA access technology
0 access technology not selected 1 access technology selected
Syntax: AT+CPOL= [<index>] [,<format>[,<oper>[,<GSM_AcT>,<GSMcomp_Act>,<Utran_Act>]]] The different possibilities are:
AT+CPOL = <index> to delete an entry. AT+CPOL = , <format> to set the format used by the read command (AT+CPOL?). AT+CPOL = , <format>, <oper> to put <oper> in the next free location. AT+CPOL = <index> , <format> , <oper> to write <oper> in the <format> at the <index>. AT+CPOL = <index>,<format>,<oper>, <GSM_AcT>,<GSMcp_Act>,<Utran_Act>
To write <oper> in the <format> at the <index> precising the access technology (in the case of
EF_PLMNwact, EF_HPLMNwact or EF_OPLMNwact is present).
Note: Per default if Acces technology parameters are not given, the GSM access technology will be
chosen. The supported format are those of the +COPS command. The length of this list is limited to 85 entries for EF_PLMNsel, and 51 for EF_PLMNwAct,
EF_OPLMNwAct, EF_HPLMNwAct.
(See table on next page)
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 37
Chapter 6 – Network Service Commands
Command Possible responses
AT+CPOL? Note: Ask for preferred list of networks
With only EF_PLMNsel present
+CPOL:1,2,26201 +CPOL: 6,2,20810 OK Note: Preferred list of networks in numeric format (read in EF_PLMNsel)
AT+CPOL?
Note: Ask for preferred list of networks With EF_PLMNwAct selected and present
+CPOL:1,2,26201,1,0,0 +CPOL: 6,2,20810,1,0,0 OK Note: Preferred list of networks in numeric format (read in EF_PLMNwAct) GSM acces technology selected GSM compact acces technology not selected Utran acces technology not selected
AT+CPOL=,0
OK Note: Select long alphanumeric format AT+CPOL?
Note: Ask for preferred list of networks With only EF_PLMNsel present AT+CPOL=7,2,20801 Note: Add a network to the list AT+CPOL?
Note: Ask for preferred list of networks With only EF_PLMNsel present
+CPOL: 1,0,”D1-TELEKOM”
+CPOL: 6,0,”F SFR”
OK
Note: Preferred list of networks in long alphanumeric format
OK
+CPOL: 1,0,”D1-TELEKOM”
+CPOL: 6,0,”F SFR”
+CPOL: 7,0,”Orange F”
OK
Note: Preferred list of networks in long alphanumeric format AT+CPOL=7 Note: Delete 7
th
location
AT+CPOL? Note: Ask for preferred list of networks
With only EF_PLMNsel present AT+CPOL=8,2,77777 Note: Add a new network to the list
OK
+CPOL: 1,0,”D1-TELEKOM”
+CPOL: 6,0,”F SFR”
OK
Note: Preferred list of networks in long alphanumeric format
OK With only EF_PLMNsel present
AT+CPOL=8,2,77777,0,0,1 Note: Add a new network to the list
OK
Note: Acces technology UTRAN is selected With EF_PLMNwact present AT+CPOL=8,2,77777 Note: Add a new network to the list
OK
Note: Per default Acces technology GSM is selected With EF_PLMNwact present AT+CPOL?
Note: Ask for preferred list of networks With only EF_PLMNsel present
+CPOL: 1,0,”D1-TELEKOM”
+CPOL: 6,0,”F SFR”
+CPOL: 8,2,77777”
OK
Note: Preferred networks list in long alphanumeric format; 8th
entry is unknown so the product edits it in the numeric format AT+CPOL=9,0,”Orange F” Note: Add a new network to the list (text format) AT+CPOL?
Note: Ask for preferred list of networks With only EF_PLMNsel present
+CPOL: 1,0,”D1-TELEKOM”
+CPOL: 6,0,”F SFR”
+CPOL: 8,2,77777”
+CPOL: 9,0,”Orange F”
OK
Note: Preferred list of networks in long alphanumeric format AT+CPOL=? +CPOL: (1-16),(0-2)
OK
Note: The EF can accept 16 records. Supported formats are
0, 1, or 2.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 38
Chapter 6 – Network Service Commands
Read Operator Name +COPN
Description: This command returns the list of all operator names (in numeric and alphanumeric format) stored in the
module.
Values: <NumOper>: is the operator in numeric format <AlphaOper>: is the operator in long alphanumeric format
Syntax: Command Syntax: AT+COPN Response Syntax: +COPN: <NumOper>,<AlphaOper>
Command Possible responses
AT+COPN Note: Ask for list of operators
AT+COPN=? OK
+COPN: 23201,”A1” +COPN: 23203,”Amax.” +COPN: 23207,”A tele.ring” +COPN: 23205,”one” … OK
+CME ERROR: <err>
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 39
Chapter 7 – Security Commands
Chapter 7 – Security
Commands
Enter PIN +CPIN
Description: This command enters the ME passwords (CHV1 / CHV2 / PUK1 / PUK2, etc.), that are required before
any ME functionality can be used. CHV1/CHV2 is between 4 and 8 digits long, PUK1/PUK2 is only 8
digits long.
If the user application tries to make an outgoing call before the SIM PIN code (CHV1) has been
confirmed, then the product will refuse the “ATD” command with a “+CME ERROR: 11” (SIM PIN required).
The application is responsible for checking the PIN after each reset or power on - if the PIN was
enabled.
Values: <pin> is the Personal Identification Number. A four-digit number. <puk> is the Personal Unblocking Key needed to change the PIN. An eight-digit number.
Syntax: AT+CPIN=<pin>
Command Possible responses
AT+CPIN=1234 Note: Enter PIN AT+CPIN=5678 Note: Enter PIN
After 3 unsuccessful attempts to enter the PIN (Personal Identification Number), the PUK (Personal
Unblocking Key) will be required.
PUK validation forces the user to enter a new PIN code as a second parameter and this will be the new
PIN code if PUK validation succeeds. CHV1 is then enabled if PUK1 is correct. The application therefore uses this command:
AT+CPIN=<Puk>,<NewPin>
Command Possible responses
AT+CPIN=00000000,1234 Note: Enter PUK and new PIN AT+CPIN=12345678,1234 Note: Enter PUK and new PIN, 2nd attempt
To determine which code must be entered (or not), the following query command can be used: AT+CPIN? The possible respons es are:
+CPIN: READY ME is not pending for any password +CPIN: SIM PIN CHV1 is required +CPIN: SIM PUK PUK1 is required +CPIN: SIM PIN2 CHV2 is required +CPIN: SIM PUK2 PUK2 is required +CPIN: PH-SIM PIN SIM lock (phone-to-SIM) is required +CPIN: PH-NET PIN Network personnalisation is required +CME ERROR: <err> SIM failure (13) absent (10) etc.
OK Note: PIN code is correct +CME ERROR: 3 Note: Operation not allowed, PIN previously entered
+CME ERROR: 16 Note: Incorrect PUK OK Note: PUK correct, new PIN stored
Please note that in this case the mobile equipment does not end its response with the OK string. The response +CME ERROR: 13 (SIM failure) is returned after 10 unsuccessful PUK attempts. The SIM
card is then out of order and must be replaced by a new one.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 40
Chapter 7 – Security Commands
Example:
Three failed PIN validations + one successful PUK validation
AT+CPIN? +CPIN: SIM PIN
AT+CPIN=1235 +CME ERROR: 16
AT+CPIN=1236 +CME ERROR: 16
AT+CPIN=1237 +CME ERROR: 16
AT+CPIN? +CPIN: SIM PUK
AT+CPIN=99999999,5678 OK AT+CPIN? +CPIN: READY
If the user tries to do something which requires PIN2 (CHV2), the product will refuse the action with a “+CME
ERROR: 17” (SIM PIN2 required). The product then waits for SIM PIN2 to be given. Of course, if SIM PIN2 is blocked, SIM PUK2 is required instead of SIM PIN2. For example, the product needs PIN2 to write in the fixed dialing phonebook (FDN) , so if SIM PIN2 authentication
has not been performed during the current session, SIM PIN2 is required
Command Possible responses
AT+CPBS=”FD” Note: Choose FDN AT+CPBW=5,”01290917”,129,”Jacky” Note: Write in FDN at location 5 AT+CPIN? SIM PIN2
AT+CPIN=5678 Note: Enter SIM PIN2 AT+CPBW=2,”01290917”,129,”Jacky” Note: Write in FDN at location 5
Please note that the product only requests PIN2 or PUK2 once. Therefore, if they are not entered properly, the next
+CPIN? command will return “+CPIN: READY”.
Read the PIN status The product requires SIM PIN
First attempt to enter a SIM PIN Wrong PIN
Second attempt Wrong PIN
Third attempt Wrong PIN
Read PIN state The product requires PUK
The PUK is entered, the new PIN shall be 5678 PUK validation is OK. New Pin
is 5678 Read PIN state The product is ready
OK +CME ERROR: 17
Note: SIM PIN2 is required Note: SIM PIN2 is required
OK OK
Note: Now writing in FDN is allowed
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 41
Chapter 7 – Security Commands
Enter PIN2 +CPIN2
Description: This command validates the PIN2 code (CHV2) or the PUK2 code (UNBLOCK CHV2) and defines a
new PIN2 code.
Of course, the +CPIN command allows PIN2 or PUK2 codes to be validated, but only when the last
command executed resulted in PIN2 authentication failure.
PIN2 length is between 4 and 8 digits; PUK2 length is 8 digits only.
Values: <pin2> is the personal identification number 2
<puk2> is the personal unblocking key 2 needed to change the PIN 2
<newpin2>
Note: PIN2 length is between 4 and 8 digits; PUK2 length is 8 digits only. Syntax: AT+CPIN2=<pin2>
Command Possible responses
AT+CPIN2=1234 Note: Enter PIN2 AT+CPIN2=5678 Note: Enter PIN2
After 3 unsuccessful attempts, PUK2 will be required. PUK2 validation forces the user to enter a new PIN2 code as a second parameter and this will be the new PIN2 code if PUK1 validation succeeds. The application uses this command:
AT+CPIN2=<puk2>,<NewPin2>
Command Possible responses
AT+CPIN2=00000000,1234 Note: Enter PUK2 and new PIN2 AT+CPIN2=12345678,1234 Note: Enter PUK2 and new PIN2, 2
To determine which code must be entered (or not), the following query command can be used:
AT+CPIN2?
The possible responses are:
+CPIN2: READY No PIN2 is needed +CPIN2: SIM PIN2 PIN2 is required +CPIN2: SIM PUK2 PUK2 is required +CME ERROR: <err> Absent (10) etc…
OK Note: PIN2 code is correct +CME ERROR: 3 Note: Operation not allowed, PIN2 previously entered
+CME ERROR: 16 Note: Incorrect Password (PUK2)
nd
attempt
OK Note: PUK2 correct, new PIN2 stored
PIN Remaining Attempt Number +CPINC
Description: This command gets the number of valid attempts for PIN1 (CHV1), PIN2 (CHV2), PUK1 (UNBLOCK
CHV1) and PUK2 (UNBLOCK CHV2) identifiers.
Values <n1>, <n2> are the attempts left for PIN1, PIN2 (0 = blocked, 3 max) <k1>, <k2> are the attempts left for PUK1, PUK2 (0 = blocked, 10 max)
For this to work, the card should be present at the time of initialization; otherwise, an error will be sent
(+CME ERROR: 10).
Syntax: Command Syntax: AT+CPINC
Response syntax: +CPINC: <n1>,<n2>,<k1>,<k2>
Command Possible responses
AT+CPINC Note: Get the number of attempts left
AT+CPINC? Note: Get current values
AT+CPINC=? Note: Get possible values
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 42
+CPINC: 2,3,10,10 OK Note: First CHV1 attempt was a failure +CPINC: 2,3,10,10 OK Note: First attempt was a failure OK
Chapter 7 – Security Commands
Facility Lock +CLCK
Description: This command locks, unlocks or interrogates an ME or network facility <fac>.
Note: Test SIM cards (with MCC=001 & MNC=01) do not check “PS”, “PN”, “PU”, “PP” and “PC” locks.
Values: <fac> supported facilities:
“PS”: SIM lock facility with an 8-digit password. “SC“: PIN enabled (<mode> = 1) / disabled (<mode> = 0) “AO”: BAOC (Barr All Outgoing Calls) “OI”: BOIC (Barr Outgoing International Calls) “OX”: BOIC-exHC (Barr Outgoing. International Calls except to Home Country) “AI”: BAIC (Barr All Incoming Calls) “IR”: BIC-Roam (Barr Inc. When Roaming outside Home Country) “AB”: All Barring services “AG”: All outGoing barring services “AC”: All inComing barring services “PN”: Network lock with an 8-digit password (NCK). “PU”: Network Subset lock with an 8-digit password (NSCK). “PP”: Service Provider lock with an 8-digit password (SPCK). “PC”: Corporate lock with an 8-digit password (CCK). “FD”: SIM Fixed Dialing Numbers (FDN) memory feature (PIN2 is required as <password>)
<mode>
0 unlock the facility 1 lock the facility 2 query status
<class> A facility status can be changed for only one class, or for all classes (7 or omitted).
1 Voice (telephony) 2 Data (apply to all bearer services) 4 Fax (facsimile services) 8 Short Message service 7 Equal to all classes (Default value)
Any attempt to combine different classes will result in activation / deactivation / interrogation of Voice and Data.
If <class> is omitted, the default value 7 will be used. Password maximum length is given with the AT+CPWD=? Command.
Note: It will not possible to lock the FDN phonebook if this one is not loaded.
Syntax: Command syntax: AT+CLCK= <fac>,<mode>[,<passwd>[,<class>] ]
Response syntax: +CLCK: <status> [ ,<class1> ]<CR><LF>+CLCK: <status>,<class2> [ … ] ]
Command Possible responses
AT+CLCK=”SC”,1,1234 Note: Enable PIN AT+CLCK? Note: Read PIN status
AT+CLCK=”SC”,0,5555 Note: Disable PIN AT+CPIN=1234 Note: Enter PIN AT+CLCK=? Note: Request supported facilities AT+CLCK=”PN”,1,12345678 Note: Activate network lock AR+CLCK=”AO”,1,1234,2 Note: Activate all outgoing calls except data calls AT+CLCK=”AO”,2 Note: Query BAOC status AT+CLCK=”SC”,0,0000 Note: Disable PIN
OK Note: PIN was correct +CLCK:(“PS”,0),(“SC”,0),(“FD”,0),(“PN“,0),(“PU“,0),(“PP“,0),(“PC“,0) OK Note: PIN is enabled, no SIM lock, no network lock, no information on Call barring (no longer supported in GSM Technical Specification 07.07) +CME ERROR: 16 Note: PIN was wrong OK Note: PIN was good +CLCK: (“PS”,”SC”,”AO”,”OI”,”OX”,”AI”,”IR”,”AB”,”AC”, ”FD”,"PN","PU","PP",”PN”) OK Note: Supported facilities OK Network lock activated OK Note: Call barring is activate
+CLCK: 1,2 OK Note: BAOC activate for data calls only +CME ERROR: 521 Note: PIN deactivation is forbidden with this SIM card
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 43
Chapter 7 – Security Commands
Change Password +CPWD
Description: This command changes a password (PIN, call barring, NCK, etc.). The facility values (<fac>) are the
same as for the +CLCK command with a “P2” facility to manage SIM PIN2.
For the network lock (“PN”), unlocking is forbidden after 10 failed attempts to disable (unlock) the
network lock with an incorrect password.
Values: <fac> supported facilities:
“PS”: SIM lock facility with an 8-digit password. “SC“: PIN enabled (<mode> = 1) / disabled (<mode> = 0) “AO”: BAOC (Barr All Outgoing Calls) “OI” : BOIC (Barr Outgoing International Calls) “OX”: BOIC-exHC (Barr Outgoing. International Calls except to Home Country) “AI” : BAIC (Barr All Incoming Calls) “IR” : BIC-Roam (Barr Inc. When Roaming outside Home Country) “AB”: All Barring services “AG”: All outGoing barring services “AC”: All inComing barring services “P2”: “FD”: SIM Fixed Dialing Numbers (FDN) memory feature (PIN2 is required as <password>) “N” “U” “P” “C”
<oldpwd>,<newpwd> 4 or up to 8 or 16 digits according to the facility.
Syntax: AT+CPWD= <fac>, <oldpwd>, <newpwd>
Command Possible responses
AT+CPWD=? Note: Possible values
AT+CPWD=”SC”,1234,5555 Note: Change PIN AT+CPWD=”SC”,1234,5555 Note: Change PIN AT+CPIN=5555 Note: Enter PIN AT+CPWD=”PN”,12345678,00000000 Note: Change NCK
+CPWD: (“PS”,8),(“SC”,8),(“AO”,4),(“OI”,4),(“OX”,4), (“AI”,4),(“IR,4),(“AB”,4),(“AG”,4),(“AC”,4), (“P2”,8),(“FD”,8),("PN",8),("PU",8),("PP",8), ("PC",8) OK Note: CHV1/CHV2 must be on 8 digits maximum (4minimum) For call barring, on 4 digits maximum OK Note: PIN was correct +CME ERROR: 16 Note: PIN was wrong OK Note: PIN was correct OK Note: NCK changed for net lock
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 44
Chapter 8 – Phonebook Commands
Chapter 8 – Phonebook
Commands
Introduction to Phonebook Commands
A phonebook group can hold up to 100 entries. These entries can come from different phone books (SIM and/or Flash phonebook).
When a SIM is inserted, the phonebook selected by default is set by the command +CPBS.
About the Parameters
SIM Contact Structure
<num_Home> Home phone number <Name> Name
Extended SIM Contact Structure
<num_Home> Home phone number <Name> Name <Phb_Group> Phonebook group
This structure can be used to write and read contacts in mode extended (+WCOS=1) and with ADN phonebook selected (+CPBS=”SM”).
Extended Contact Structure
<num_Home> Home phone number <Name> Name <num_Mobile> Mobile phone number <num_Work> Work phone number <num_Data> Data phone number <Email> E-Mail address <Address> Postal address <Phb_Group> Phonebook group
The structure including <num_Mobile>, <num_Work>, <num_Data>, <Email>, and <Address> will be represented by <Contact> in the rest of the document.
Phonebook Groups Parameter Definition
<index> Group index <name> Group name <phb_entry_index> Phon ebook entry index <restrict call> Restrict call mode for incoming calls
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 45
Chapter 8 – Phonebook Commands
Select Phonebook Memory Storage +CPBS
Description: This command selects phonebook memory storage.
Note on ADN and FDN activation: When FDN has been activated with the +CLCK command, the
selection of ADN phonebook is possible only if ADN staus bit3 is set to 1 (EF file “is readable and can be updated when invalidated”). Please refer to Recommendation 3GPP 11.11 for more details.
Note: The previously selected phonebook remains the same when the modem is switched on or reset, even if the new SIM card is inserted. However, in the case when the replacemnet SIM card does not contain any slected phonebook, the ADN phonebook is selected.
Values: <pb> Phonebook “SM” ADN Abbreviated Dialing Numbers (SIM phonebook)
“FD” FDN Fixed Dialing Numbers (SIM restricted phonebook) “ON” MSISDN (SIM own numbers) “EN” ECC Emergenc y Call Codes (SIM or Mobile Equipment) “LD” LND Last Number Dial “MC” Mobile Equipment missed (unanswered received) calls list “ME” Mobile Equipment phonebook “MT” Combined Moblile Equipment and SIM phonebook (ME + SM) “RC” Mobile Equipment received calls list “SN” SDN Services Dialin g Numb ers (SIM special service numbers)
Notes: “EN” will be available even if ECC SIM file is not present.
When the SIM is not present, the following emergency numbers are available:
000, 08, 112, 110, 118, 119, 911, 999
When the SIM is present, the following emergency numbers are available:
112, 911, emergency number from ECC SIM files (if existing)
<pin2> Personal Identification Number 2
Notes: The following emergency numbers are stored in E2P:
112, 911, 999, 08
<EN> will be availa ble even if ECC SIM file is not present.
Maximum Entries: The maximum number of entries for the Mobile Equipment phonebook is 500.
Syntax: AT+CPBS=<pb>[,<pin2>]
Command Possible responses
AT+CPBS=”SM” Note: Select ADN phonebook AT+CPBS=? Note: Possible values
AT+CPBS? Note: Status
Selection of the ADN phonebook when FDN is active is SIM dependent. Selection of the “FD” phonebook with <pin2>, when <pin2> is already verified, will give the error:
CME ERROR:3
OK Note: ADN phonebook is selected +CPBS: ("SM","LD","MC","ON","ME","RC","MT","SN","EN”) OK Note: only “EN” phonebook is not supported with this SIM card. +CPBS:”SM”,10,20
OK Note: ADN phonebook selected, 10 locations used, 20 locations
available
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 46
Chapter 8 – Phonebook Commands
Read Phonebook Entries +CPBR
Description: This command returns phonebook entries for a range of locations from the current phonebook memory
storage selected with +CPBS.
Note: For all phonebook read commands (+CPBR, +CPBF, +CPBN, +CPBP, +CNUM), the
TON/NPI MSB of each number is set to 1 (ex: a TON/NPI stored as 17 is displayed as 145). If the AT+WCOS =1 command has been used, the response will include <Contact> structure.
Values: <first_entry>,<last_entry> Location or range of locations of the phonebook entry or entries.
<type (TON/NP)> Type of address byte in integer format. Value is 145 if the dialing string (<number>
response value) includes the international access code character + ; otherwise, the value is 129.
Syntax: Command Syntx: AT+CPBR
Response Syntax:
The entry is stored in the ADN phonebook and AT+WCOS=0
<CR><LF>+CPBR: <loc>,<num>,<type>,<name> [<CR><LF>+CPBR: <loc>,<num>,<type>,<name>[...]]
The entry is stored in the ADN phonebook and AT+WCOS=1
<CR><LF>+CPBR: <loc>,<num>,<type>,<name>,<Phb_group> [<CR><LF>+CPBR: <loc>,<num>,<type>,<name>,<Phb_group>[...]]
The entry is stored in the Mobile Equipment phonebook and AT+WCOS=0
<CR><LF>+CPBR: <loc>,<num>,<type>,<name> [<CR><LF>+CPBR: <loc>,<num>,<type>,<name>[...]]
The entry is stored in the Mobile Equipment phonebook and AT+WCOS=1
<CR><LF>+CPBR: <loc>,<num>,<type>,<name>,<Contact>,<Phb_group> [<CR><LF>+CPBR: <loc>,<num>,<type>,<name>,<Contact>, <Phb_group>[...]]
Command Possible responses
AT+CPBR=? Note: Test command
AT+WCOS? Note: Test command
AT+CPBR=12,14 Note: Read entries from 12 to 14
AT+CPBR=10 Note: Read entry 10
AT+CPBR=11 Note: Read entry 11 (UCS2 format) AT+CPBR=52 Note: Read entry 52 (wrong) AT+CPBS=”ME” Note: Flash memory AT+WCOS=1
AT+CPBR=13 Note: Read entry
+CPBR: (1-50),20,10 OK Note: 50 locations (from 1 to 50), max length for phone number is 20 digits, 10 characters max for the text +WCOS: 0 OK Note: Contact not selected +CPBR: 12,”112”,129,”Emergency” +CPBR: 13,”+331290909”,145,”Fred” +CPBR: 14,”0146290808”,129,”Zazi” OK Note: Display locations 12,13,14 with location, number, type (TON/NPI), Text +CPBR:10,”0146290921”,129,”Rob” OK Note: Display location 10 +CPBR:11,”0146290921”,129,”8000010002FFFF” OK Note: Display location 11 +CME ERROR: 21 Note: Invalid index OK
OK Note: Contact selected +CPBR:13,”+331290909”,145,”Fred”, ”0141284549”, 129, “0600003210”, 129, ”0141280000”, 129, “019876543210”, 129, fred@mail_address.com, “Becker Street London”,1 OK Note: Display locations 13 with location, number, type (TON/NPI), Text and Contact and Phonebook Group n1
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 47
Chapter 8 – Phonebook Commands
CPBR Command Table Continued
Command Possible responses
AT+CPBS=”SM” Note: ADN phonebook AT+CPBR=1 +CPBR=1,”0123456”,129,”test”
AT+CPBW=1,”0123456”,, ”test”,1 Note: Add an external entry in the SIM with group number (1) AT+CPBR=1 +CPBR=1”0123456”,129,”test”,1
OK
OK OK
OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 48
Chapter 8 – Phonebook Commands
Write Phonebook Entry +CPBW
Description: This command writes a phonebook entry in location number <index> in the current phonebook memory
storage.
Notes:
“RC” and “MC” phonebooks could be erased only by +CPBW. Adding a field and/or modifying a
field is not allowed for these phonebooks.
This command is not allowed for “EN”, “LD”, “MC”, “RC”, “MT”, and “SN” phonebooks (they
cannot be written).
If the AT+WCOS=1 command was used, the request would include the “Contact” structure.
Values: <index> Integer type value depending on the capacity of the phonebook memory. <number> Phone number in ASCII format. <type> TON/NPI (Type of address octet in integer format).
Note: The value is 145 if the dialing string (<number> response value) includes the
international access code character +; otherwise, the value is 129 (Example: a <t ype> value of 17 will be written as 145).
<text> String type. Maximum length of <text> field is:
For the Mobile Equipment phonebook, 30 ASCII characters.
For the ADN phonebook, SIM dependent (use AT+CPBW=?)
Notes:
For the <text> parameter all strings starting with “80”, “81” or “81” are
considered in UCS2 format.
The +CSCS (Select Character Set) command does not affect the format for
phonebook entries.
<contact> Contact structure. <Phb_Group> Phonebook group number in which the entry should be saved.
The range is 1 to 10. If the entry must not be saved in a group, <Phb_Group> = 0 or can be omitted.
Syntax: Command Syntax:
For ADN phonebook with AT+WCOS=0
AT+CPBW=<index>[,<number>[,<type>[,<text>]]]
For ADN phonebook with AT+WCOS=1
AT+CPBW=<index>[,<number>[,<type>[,<text> [,Phb_group>]]]]
For the Mobile Equipment phonebook with AT+WCOS=0
AT+CPBW=<index>[,<number>[,<type>[,<text>]]]
For the Mobile Equipment phonebook with AT+WCOS=1
AT+CPBW=<index>[,<number>[,<type>[,<text> [<contact> [,Phb_group>]]]]]
Command Possible responses
AT+CPBS=”SM” Note: ADN phonebook AT+CPBS? Note: Which phonebook is selected
AT+WCOS=0 Note: phonebook not extended AT+CPBW=? Note: Test command
AT+CPBW=5,”112”,129,”SOS” Note: Write at location 5 AT+CPBR=5 Note: Read the entry at location 5 AT+CPBS? Note: Which phonebook is selected
OK +CPBS:”SM”,1,10
OK Note: ADN phonebook is selected, 1 location is used and 10 locations are available. OK
+CPBW: (1-50),20,(129,145),10 OK Note: 50 locations, phone number = 20 digits max, TON/NPI of 129 or 145, text length = 10 OK Note: Location 5 written +CPBR=5,”112”,129,”SOS” Note: Location 5 written +CPBS:”SM”,2,10 OK Note: ADN phonebook is selected, 2 locations are used and 10 locations are available.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 49
Chapter 8 – Phonebook Commands
+CPBW Command Table Continued
Command Possible responses
AT+CPBW=5,”01290917”,129,”Jacky” Note: Overwrite location 5 AT+CPBW=6,”01292349”,129,”8000410042” Note: write location 6 (UCS2 format for the <text> field) AT+CPBW=8,”01292349”,129,”80xyz” Note: write location
AT+CPBW=5,”01290917”,129,”Jacky” Note: write an extended entry AT+WCOS=1 Note: Phonebook extended AT+CPBW=5,”01290917”,129,”Jacky”1 Note: Write an extended entry AT+WCOS=0 Note: Phonebook not extended AT+CPBS=”ME” Note: ME Phonebook AT+CPBS? Note: How many entries are used
AT+CPBW=1,”0123456798”,129,”first entry” Note: Write a not extended entry AT+CPBW=1,”0123456798”,129,”first entry”,”9876543210”,129 Note: Write an extended entry AT+CPBR=1 Note: Read the first entry AT+WCOS=1 Note: Phonebook extended AT+CPBW=1,”0123456798”,129,”first entry” Note: Write an entry not extended AT+CPBW=2,”9876543210”,129,”second entry”,”6543210987”,129 Note: Write an extended entry AT+CPBR=1,2 Note: Read entry 1 and 2 AT+CPBW=13,”+331290909”,145,”Fred”, ”0141284549”,129,“0600003210”,129,”0141280000”, 129,“019876543210”,129, fred@mail_address.com, “Becker Street London”,1 Note: Write location with Contact and Phonebook Group n1 AT+CPBW=,”+33145221100”,145,”SOS” Note: Write at the first location available AT+CPBW=,”+0345221100”,145,”SOS” Note: Write at the first location available AT+CPBW=57,”112”,129,”WM” Note: Write at location 57 (wrong) AT+CPBW=7,”012345678901234567890”,129,”WAVE” Note: Write at location 7 a phone number exceeding the limit (21 digits) AT+CPBW=7,”0122334455”,129,”WAVECOMTEL” Note: Write at location 7 along text (11 characters) AT+CPBS=”SM” Note: ADN phonebook AT+WCOS? +WCOS: 1
AT+CPBR=1 AT+CPBW=1,”0123456,,”test”,1
Note: Add an extended entry in SIM with group number 1
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 50
OK Note: Location 5 overwritten OK Note: Location 6 is written OK Note: Location 8 is written. The string has a wrong UCS2 format. It is, therefore, considered as an ASCII string. +CME ERROR: 3 Note: Error because +WCOS: 0 OK
OK OK OK +CPBS: “ME”,2,500
Note: in ME phonebook, 2 locations are used and 500 locations are available. OK
+CME ERROR: 3 Note: Error because +WCOS: 0
+CPBR: 1,”0123456798”,129,”first entry” OK OK OK
+CPBR: 1,”0123456798”,129,”first entry” OK
Note: Location 13 is written
OK Note: First location available is written +CME ERROR: 20 Note: Phonebook full +CME ERROR: 21 Note: Invalid index +CME ERROR: 26
Note: Phone number too long +CME ERROR: 24 Note: Text too long OK
OK Note: Extended phonebook +CPBR:1,”0123456”,129,”test” OK OK
Chapter 8 – Phonebook Commands
+CPBW Command Table Continued
Command Possible responses
AT+CPBR=1 +CPBR:1,”0123456,”129,”test”
OK AT+CPBW=1,”0123456,,”test”,1 Note: Add an extended entry in SIM with group number 1 AT+CPBR=1 +CPBR:1,”0123456,”129,”test”,1
AT+CPBW=13,”+331290909”,145,”Fred”, ”0141284549”,129,“0600003210”,129,”0141280000”, 129, “019876543210”,129, fred@mail_address.com, “Becker Street London”,1 Note: Save the entry in the phonebook group #1 AT+CPBW=13,”+331290909”,145,”Fred”, ”0141284549”,129,“0600003210”,129,”0141280000”, 129, “019876543210”,129, fred@mail_address.com, “Becker Street London” Note: Save the entry in the phonebook without a group AT+CPBW=13,”+331290909”,145,”Fred”, ”0141284549”,129,“0600003210”,129,”0141280000”, 129, “019876543210”,129, fred@mail_address.com, “Becker Street London”,0 Note: Save the entry in the phonebook without a group
This command is not allowed when the fixed dialing phonebook (FDN) is locked. Moreover, when the FDN is unlocked, PIN2 is required to write in the FDN phonebook.
But if PIN2 authentication has been performed during the current session, the +CPBW command with FDN is allowed.
Command Possible responses
AT+CPBS=”FD” Note: Choose FDN AT+CPBW=5,”01290917”,129,”Jacky ” Note: Write in FDN at location 5 AT+CPIN?
AT+CPIN=5678 Note: Enter SIM PIN2 AT+CPBW=5,”01290917”,129,”Jacky ” Note: Write in FDN at location 5
OK +CME ERROR: 17
Note: SIM PIN2 is required +CPIN: SIM PIN2
Note: SIM PIN2 is required OK
OK Note: Writing in FDN is now allowed
OK
OK
OK
OK
OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 51
Chapter 8 – Phonebook Commands
Find Phonebook Entries +CPBF
Description: This command returns phonebook entries with alphanumeric fields starting with a given string. The
AT+CPBF= “” command can be used to display all phonebook entries sorted in alphabetical order.
This command is not allowed for "LD", "RC", "MC" phonebooks and for the “EN” phonebook, which
does not contain alphanumeric fields.
It is possible to use this command with UCS2 strings. If a wrong UCS2 format is entered, the string is
considered as an ASCII string.
Values: <string> Searched pattern string (depends on the format of the data stored in the phonebooks) <loc> Location number (20 digits maximum) <num> Phone number (20 digits maximum) <type> TON/NPI (Type of address byte in integer format) <contact> Extended contact structure
Syntax: Command Syntax: AT+CPBF=<string>
Response Syntax:
The entry is stored in the ADN phonebook and AT+WCOS=0
<CR><LF> +CPBF=<loc>,<num>,<type>,<name>
The entry is stored in the ADN phonebook with AT+WCOS=1
<CR><LF> +CPBF=<loc>,<num>,<type>,<name>,<Phb_group>
The entry is stored in the Mobile Equipment phonebook with AT+WCOS=0
<CR><LF> +CPBF=<loc>,<num>,<type>,<name>
The entry is stored in the Mobile Equipment phonebook with AT+WCOS=1
<CR><LF> +CPBF=<loc>,<num>,<type>,<name>,<Contact>,<Phb_group>
Command Possible responses
AT+CPBF=? Note: Test command
AT+CPBF=“E” Note: Read entries with “E”
AT+CPBF=”H” Note: Read entries with “H” AT+CPBF=”800001” Note: Read entries starting with 0001 UCS2 character AT+CPBF=”8045C” Note: Read entries with “8045C” (ASCII format) AT+CPBS=”SM” Note: ADN phonebook AT+WCOS=0 Note: Phonebook not extended AT+CPBF=”Test” Note: Read entries with “Test” AT+WCOS=1 Note: Phonebook extended AT+CPBF=”Test” Note: Read entries with “Test” AT+CPBS=”ME” Note: ADN phonebook AT+WCOS=0 Note: Phonebook not extended AT+CPBF=”Test” Note: Read entries “Test” AT+WCOS=1 Note: Phonebook extended AT+CPBF=”Test” Note: Read entries with “Test”
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 52
+CPBF: 20,10 OK Note: Maximum length for a phone number is 20 digits; 14 characters for the text +CPBF: 12,”112”,129,”Emergency” +CPBF: 15,”+331290101”,145,”Eric” OK Note: Display locations with text field starting with “E” +CME ERROR: 22 Note: Entry not found +CPBF: 11, ”0146290921”,129,”8000010002FFFF” OK Note: Display locations with text field starting with 0001 UCS2 character +CME ERROR: 22 Note: Entry not found. The string has a wrong UCS2 format; it is therefore considered as an ASCII string OK
OK +CPBF: 1,”0123456789”,129,”Test ADN”
Note: Display locations with text field starting with “Test” OK
+CPBF: 1,”0123456789”,129,”Test ADN”,0 Note: Display locations with text field starting with “Test”, extended entry. OK
OK +CPBF: 1,”0123456789”,129,”Test ME”
Note: Display locations with text field starting with “Test” OK
+CPBF: 1,”0123456789”,129,”Test ME”,”9876543210”,129,””,””,””,email@mail_address.com, ”post address’,0 Note: Display locations with text field starting with “Test”, extended entry.
Chapter 8 – Phonebook Commands
Phonebook Phone Search +CPBP
Description: This command orders the product to search the phonebook for an item with the same phone number as
that defined in the parameter.
The searched phone number is the FIRST one that the user can enter with AT+CPBW. For example,
with this command strin, we can search only the phone number (+331290909): AT+CPBW=13,”+331290909”,145,”Fred”,”0141284549”,129,“0600003210”,129,”0141280000”, 129,
“019876543210”,129,fred@mail_address.com, “Becker Street London”,0
Values: <PhoneNumber> Phone number (coded according to any GSM 07.07 or GSM 07.05 phone number) <loc> Location number
<num> Phone number <type> TON/NPI (type of address octet in integer format) <contact> Contact structure
Syntax: Command Syntax: AT+CPBP=<PhoneNumber> Response Syntax:
The entry is stored in the ADN phonebook and AT+WCOS=0
<CR><LF> +CPBP=<loc>,<num>,<type>,<name>
The entry is stored in the ADN phonebook with AT+WCOS=1
<CR><LF> +CPBP=<loc>,<num>,<type>,<name>,<Phb_group>
The entry is stored in the Mobile Equipment phonebook with AT+WCOS=0
<CR><LF> +CPBP=<loc>,<num>,<type>,<name>
The entry is stored in the Mobile Equipment phonebook with AT+WCOS=1
<CR><LF> +CPBP=<loc>,<num>,<type>,<name>,<Contact>,<Phb_group>
Command Possible responses
AT+CPBP=? Note: Test command
AT+CPBP=”+331290101” Note: Search entries corresponding to this phone number AT+CPBP=”+331290101” Note: Search entries corresponding to this phone number AT+CPBP=”01290202” Note: Search entries corresponding to this phone number AT+CPBP=”+331288575” Note: Search entries corresponding to this phone number AT+CPBP=”0129” Note: Search entries corresponding to this phone number AT+CPBS=”SM” Note: ADN phonebook AT+WCOS=0 Note: Phonebook not extended AT+CPBP=”0123456789” Note: Search entries correspondeing to this phone number AT+WCOS=1 Note: Phonebook extended AT+CPBP=”0123456789” Note: Search entries correspondeing to this phone number AT+CPBS=”ME” Note: ADN phonebook AT+WCOS=0 Note: Phonebook not extended AT+CPBP=”0123456789” Note: Search entries correspondeing to this phone number
Continued on next page
+CPBP: (1-50),20,10 OK Note: 50 locations (from 1 to 50), maximum length for phone
number is 20 digits, 10 characters maximum for the text. +CPBP: 15,”+331290101”,145,”Eric” OK Note: Display the entry corresponding to the specified phone number +CPBP: 15,”01290101”,129,”Eric” OK Note: Display the entry corresponding to the specified phone number +CPBP: 15,”+331290202”,145,”David” OK Note: Display the entry corresponding to the specified phone number +CPBP: 15,”+331290101”,145,”8045682344FFFF” OK Note: Display entry corresponding to the specified phone number (UCS2 format) +CME ERROR: 22 Note: Entry not found
OK OK +CPBP: 1,”0123456789”,129,”Test ADN”
Note: Display the entry corresponding to the specified phone number OK +CPBF: 1,”0123456789”,129,”Test ADN”,0
Note: Display locations with text field starting with “Test”, extended entry. OK OK +CPBP: 1,”0123456789”,129,”Test ME”
Note: Display locations with text field starting with “Test”
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 53
Chapter 8 – Phonebook Commands
AT+CPBP=<PhoneNumber> continued
Command Possible responses
AT+WCOS=1 Note: Phonebook extended AT+CPBP=”Test” Note: Read entries with “Test”
OK +CPBF: 1,”0123456789”,129,”Test
ME”,”9876543210”,129,””,””,””,email@mail_address.com,”post address’,0 Note: Display locations with text field starting with “Test”, extended entry.
Move Action in Phonebook +CPBN
Description: This specific command performs a forward or backward move in the phonebook (in alphabetical order).
It is not allowed in the “EN” phonebook since it does not contain alphanumeric fields.
Values: <mode>
0 First item 1 Last item 2 Next valid item in alphabetical order 3 Previous valid item in alphabetical order 4 Last item read (usable only if a read operation has been performed on the current
phonebook since the end of initialization
5 Last item written (usable only if a write operation has been performed on the current
phonebook since the end of initialization
<loc> Location number <num> Phone number <type> TON/NPI (Type of address octet in integ er format) <contact> Contact structure
Syntax: Command Syntax: AT+CPBN=<mode>
Response Syntax:
The entry is stored in the ADN phonebook and AT+WCOS=0
<CR><LF> +CPBN=<loc>,<num>,<type>,<name>
The entry is stored in the ADN phonebook with AT+WCOS=1
<CR><LF> +CPBN=<loc>,<num>,<type>,<name>,<Phb_group>
The entry is stored in the Mobile Equipment phonebook with AT+WCOS=0
<CR><LF> +CPBN=<loc>,<num>,<type>,<name>
The entry is stored in the Mobile Equipment phonebook with AT+WCOS=1
<CR><LF> +CPBN=<loc>,<num>,<type>,<name>,<Contact>,<Phb_group>
Command Possible responses
AT+CPBN=? Note: Test command AT+CPBS=”SM” Note: ADN phonebook AT+WCOS=0 Note: Phonebook not extended AT+CPBN=0 Note: Read the first location AT+WCOS=1 Note: Phonebook extended AT+CPBN=2 Note: Read the next location
AT+CPBN=2 Note: Read the next location AT+WCOS=0 Note: Phonebook not extended AT+CPBN=3 Note: Read the previous location AT+CPBN=1 Note: Read the last location AT+CPBN=2 Note: Read the next location
+CPBN: (0-5) OK Note: Possible modes OK
OK +CPBN: 15,”+331290101”,145,”Eric”
OK Note: Display the first location OK
+CPBN: 5,”+33147658987”,145,”Frank”,0 OK Note: Display the second location, extended entry +CPBN: 6,”+331290302”,145,”Marc”,0 OK Note: Display the third location, extended entry OK
+CPBN: 5,”+33147658987”,145,”Frank” OK Note: Display the second location +CPBN: 6,”+331290302”,145,”Marc” OK Note: Display the last location +CPBP: 15,”+331290101”,145,”Eric” OK Note: Display the first location
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 54
Chapter 8 – Phonebook Commands
Using mode 4 and 5 with +CPBF command and CPBW:
Command Possible responses
AT+CPBF=”Er” Note: Find ”Er” in phonebook
AT+CPBN=2 Note: Read the next location
AT+CPBF=”Er” Note: Find ”Er” in phonebook
AT+CPBN=4 Note: Get the last location read
AT+CPBW=,”0146290800”,129,”WM” Note: Write an item at the first location available AT+CPBN=4 Note: Get the last location read
AT+CPBN=5 Note: Display the last item written with its location AT+CPBN=4 Note: Get the last item read AT+CPBF=”800041FFFF” Note: Find”800041” in phonebook
AT+CPBN=4 Note: Get the last location read
Note: The AT+CPBN=5 command is useful after an AT+CPBW command is used without a location.
+CPBF: 15,”+331290101”,145,”Eric” OK Note: Display the location +CPBN: 5,”+33147658987”,145,”Frank” OK Note: Display the following location +CPBF: 15,”+331290101”,145,”Eric” OK Note: Display the location +CPBF: 15,”+331290101”,145,”Eric” OK Note: Display the last location read OK Note: No information about this location
+CPBF: 15,”+331290101”,145,”Eric” OK Note: Display the last location read AT+CPBN=38,”0146290800,129,”WM” Note: Display the last item written with its location
AT+CPBN=38,”0146290800,129,”WM” Note: Now the last item read is the last written item too +CPBF: 15,”+3312345”,145,”8000414339FFFF” OK Note: Display this location +CPBF: 15,”+3312345”,145,”8000414339FFFF” OK Note: Display the last location read
Subscriber Number +CNUM
Description: This command returns the subscriber MSISDN(s). If the subscriber has different MSISDNs for different
services, each MSISDN is returned in a separate line.
Values: <alphax> optional alphanumeric string associated with <numberx> <numberx> string type phone number with format as specified by <typex> <typex> type of address byte in integer format
Syntax: Command syntax: AT+CNUM Response syntax: +CNUM: <alpha1>, <number1>, <type1> <CR><LF> +CNUM: <alpha2>,
<number2>, <type2> ….
Command Possible responses
AT+CNUM Note: Get MSISDN(s)
AT+CNUM=? OK
+CNUM:”Phone”, “0612345678”,129 +CNUM:”Fax”, “0687654321”,129 +CNUM: “80001002FFFF”, “+0183773”, 145 (UCS2 format) OK Note: MSISDNs
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 55
Chapter 8 – Phonebook Commands
Avoid Phonebook Initialization +WAIP
Description: This specific command allows the initialization of all phonebooks to be inhibited during subsequent
boots.
Values: <mode>
0 Normal initialization (with phonebooks) 1 No phonebook initialization
Syntax: Command Syntax: AT+WAIP=<mode>
Command Possible responses
AT+WAIP? Note: Current values ?
AT+WAIP=? Note: Possible values ?
AT+WAIP =1 Note: Inhibit initialization of phonebooks (next boot) AT&W Note: Save modifications in EEPROM
Caution: The given value should be stored in EEPROM. Therefore, the AT&W command must be used to save the
new <mode> value.
Note: No phonebook commands are allowed if +WAIP=1 (after boot). If a phonebook command is entered, a “+CME
ERROR: 3” is returned.
+WAIP:0 OK Note: Default value (init phonebooks) +WAIP: (0,1) OK Note: Disable / enable OK Note: no answer
Delete Calls Phonebook +WDCP
Description: This specific command deletes the calls listed in some phonebooks.
Values: <calls phonebook>
“LD” SIM (ME extended) Last dialing phonebook “MC” ME missed calls list phonebook “RC” ME received calls list phonebook
Syntax: Command Syntax: +WDCP=<calls phonebook>
Command Possible responses
AT+WDCP? OK AT+WDCP=?
Note: Possible values ? AT+WDCP=”LD” Note: Delete all the content of Last Dialing phonebook.
+WDCP: ("LD","MC","RC") OK Note: Identifiers of the phonebooks supporting a list of calls OK Note: Last Dialing phonebook is now empty.
Set Voice Mail Number +CSVM
Description: This commands sets/gets and enables/disables the voice mail n umber in memory.
Values: <mode>
0 Disable the voice mail number 1 Enable the voice mail number <number> Phone number in ASCII format. <type> TON/NPI (Type of address byte in integer format).
Note: The value is 145 if the dialing string includes the international access code character
‘+’. Otherwise, the value is 129. Example: A <type> value of 17 will be written as 145.
Syntax: Command Syntax: AT+CSVM=<mode>[,<number>[,<type>]]
Command Possible responses
AT+CSVM? Note: Get mail number AT+CSVM=?
Note: Possible values ? AT+CSVM=0,”888”,129 Note: Disable Voice Mail number and change value to “888”.
+CSVM: 1,”660”,129 OK Note: Voice mail number “660” is activated +CSVM: (0-1),(129,145) OK Note: activation/deactivation and format 129 & 145 are supported OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 56
Contact Selector +WCOS
Description: This commands enables/disables the displaying of extended contact.
Values: <mode>
0 Select the SIM contacts 1 Select the extended contacts for phonebook entries 2 Internal use only. 3
Syntax: Command Syntax: AT+WCOS=<mode>
Command Possible responses
AT+WCOS? Note: Test command
AT+WCOS=? Note: List all possible values
AT+WCOS=0 Note: Contact not selected AT+WCOS=3 +CME ERROR: 3
+WCOS: 1 OK Note: Extended contact selected +WCOS: (0-2) OK Note: Displays all possible responses OK
Note: Mode not allowed
Chapter 8 – Phonebook Commands
Create and Delete a Phonebook Group +WPGW
Description: This commands creates or deletes a phonebook group. Values: <index> Index a new group
<name> Name of the group. It can be up to 30 ASCII characters or 13 UCS2 characters long Syntax: Command Syntax: AT+WPGW=<index>[,<name>]
Command Possible responses
AT+WPGW=? Note: Test command
AT+WPGW=1,”group 1” Note: Create group #1 AT+WPGW=1,”phb group 1” Note: Rename group #1 AT+WPGW=1 Note: Delete group #1
+WPGW: (1-10),30 OK Note: 10 possible groups, group name can be 30 characters maximum OK Note: Group 1 created OK Note: Group 1 created OK Note: Group 1 deleted
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 57
Chapter 8 – Phonebook Commands
Read a Phonebook Group +WPGR
Description: This commands reads the phonebook group entries, the phonebook group name or the number or used
records in a group.
Values: <mode>
1 Read the name of one phonebook group 2 Read the names of all phonebook groups
3 List all entries of one phonebook group 4 Read the number of used records in a phonebook group
<index>
Index of the group (for use with mode = 3 or mode = 4) Syntax: Command Syntax: AT+WPGR=<mode>,<index>
Command Possible responses
AT+WPGR=? Note: Test command
AT+WPGR=1,1 Note: Read the name of phonebook group 1 AT+WPGR=2 Note: Read the name of all phonebook groups
AT+WCOS=0 Note: Phonebook not extended AT+WPGR=3,1 Note: List all entries of phonebook group 1
AT+WCOS=1 Note: Phonebook extended AT+WPGR=3,1 Note: List all extended entries of phonebook group 1
Note: The entries list displayed with AT+WPGR=3,1 contains records from both the Mobile Equipment and the SIM phonebooks (MT phonebook).
+WPGR: (1-4),(1-10) OK Note: 10 possible groups +WPGR: 1,”group 1” OK +WPGR: 1,”group 1” +WPGR: 2,”group 2” OK OK
+WPGR: 1,”+33123456789”,145,”John” +WPGR: 2,”+33567891234”,145,”Elvis” +WPGR: 31,”+331290909”,145,”Fred” +WPGR: 32,”+0123456789”,129,”Test” OK Note: SIM entries: index 1 and 2; Flash entries; index 31 and 32 (The SIM supports 30 entries in this example) OK
+WPGR: 1,”+33123456789”,145,”John”, 1 +WPGR: 2,”+33567891234”,145,”Elvis”,1 +WPGR: 31,”+331290909”,145,”Fred”,”0141284549”,
129,”060003210”,129,”0141280000”,129, ”019876543210”,129,fred@mail_address.com, ”Becker Street London”,1
+WPGR: 32,”+0123456789”,129,”Test”,0141284549”,
129,”0600003210”,129,0141280000”,129,
”6549873210”,129,test@mail_address.com,””,1 OK Note: SIM entries: index 1 and 2; Flash entries; index 31 and 32 (The SIM supports 30 entries in this example)
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 58
Settings of a Phonebook Group +WPGS
Description: This commands sets the parameters of a phonebook group .
Values: <mode>
0 Read group settings 1 Write group settings
<index>
Index of the group
<restrict call>
Parameter is optional if <mode.=0. It is mandatory if <mode>=1.
0 All refused. Incoming call is forwarded to the voice mailbox 1 All accepted. Incoming call is received (RING message is displayed)
Syntax: Command Syntax: AT+WPGS=<mode>,<index>[,<restrict call>]
Command Possible responses
AT+WPGS=1,1,1 Note: Set restrict call to “All Accepted” AT+WPGS=0,1 Note: Read group 1 settings
AT+WPGS=? Note: Test command
OK +WPGS: 1,
OK Note: Group1: all accepted +WPGS: (0-1),(1-10),(0-1) OK
Chapter 8 – Phonebook Commands
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 59
Chapter 9 – Short Messages Commands
Chapter 9 – Short Messages
Parameters Definition
<da> Destination Address, coded according to the GSM Technical Specification 03.40 TP-DA <dcs> Data Coding Scheme, coded according to document [5] <dt> Discharge Time in string format:
“yy/MM/dd,hh:mm:ss±zz”(Year [00-99], Month [01-12], Day [01-31], Hour, Minute, Second and Time Zone [quarters of an hour] ) <fo> First Byte, coded according to SMS-SUBMIT first byte in document [4], default value is 17 for SMS-
SUBMIT
<index> Place of storage in memory <length> Text mode (+CMGF=1): number of characters PDU mode (+CMGF=0): length of the TP data unit in
bytes
<mem1> Memory used to list, read and delete messages (+CMGL, +CMGR and +CMGD) <mem2> Memory used to write and send messages (+CMGW, +CMSS) <mem3> Preferred memory to which received SMS are to be stored <mid> CBM Message Identifier <mr> Message Reference <oa> Originator Address <pid> Protocol Identifier <pdu> For SMS: GSM 04.11 SC address followed by GSM Technical Specification 03.40 TPDU in
hexadecimal format, coded as specified in doc [4] For CBS: GSM Technical Specification 03.41 TPDU in hexadecimal format
<ra> Recipient Address <sca> Service Center Address <scts> Service Center Time Stamp in string format: “yy/MM/dd,hh:mm:ss±zz”
(Year/Month/Day,Hour:Min:Seconds±TimeZone)
<sn> CBM Serial Number <st> Status of a SMS-STATUS-REPORT <stat> Status of message in memory <tooa> Type-of-Address of <oa> <tora> Type-of-Address of <ra> <tosca> Type-of-Address of <sca> <total1> Number of locations for messages in <mem1> <total2> Number of locations for messages in <mem2> <total3> Number of locations for messages in <mem3> <used1> Total number of messages in <mem1> <used2> Total number of messages in <mem2> <used3> Total number of messages in <mem3> <vp> Validity Period of the short message, default value is 167
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 60
Chapter 9 – Short Messages Commands
Select Message Service +CSMS
Description: The Supported Services include originated (SMS-MO) and terminated short messages (SMS-MT) as
well as Cell Broadcast Message (SMS-CB) services.
Values: <service> 0 SMS AT commands are compatible with GSM 07.05 Phase 2 version 4.7.0. 1 SMS AT commands are compatible with GSM 07.05 Phase 2 + version .
Syntax: Command Syntax: AT+CSMS=<service>
Command Possible responses
AT+CSMS=0 Note: SMS AT command Phase 2
version 4.7.0 AT+CSMS=1 Note: SMS AT command Phase 2 + AT+CSMS? Note: Current values ?
AT+CSMS=? Note: Possible services
+CSMS: 1,1,1 OK Note: SMS-MO, SMS-MT and SMS-CB supported +CSMS: 1,1,1 Note: SMS-MO, SMS-MT and SMS-CB supported +CSMS: 0,1,1,1 OK Note: GSM 03.40 and 03.41 (SMS AT command Phase 2
version 4.7.0 +CSMS: (0,1) OK
New Message Acknowledgement +CNMA
Description: This command allows reception of a new message routed directly to the DTE to be acknowledged.
In TEXT mode, only positive acknowledgement to the network (RP-ACK) is possible.
In PDU mode, either positive (RP-ACK) or negative (RP-ERROR) acknowledgement to the
network is possible.
Acknowledgement with +CNMA is possible only if the +CSMS parameter is set to 1 (+CSMS=1) when a
+CMT or +CDS indication is shown (see +CNMI command).
If no acknowledgement occurs within the network timeout, an RP-ERROR is sent to the network. The
<mt> and <ds> parameters of the +CNMI command are then reset to zero (do not show new message indication).
Values:
<n>: Type of acknowledgement in PDU mode 0 send RP-ACK without PDU (same as TEXT mode) 1 send RP-ACK with optional PDU message 2 send RP-ERROR with optional PDU message
<length>: Length of the PDU message
Syntax:
Command syntax in text mode: AT+CNMA Command syntax in PDU mode: AT+CNMA [ = <n> [ , <length> [ <CR>
Note: PDU is entered using <ackpdu> format instead of <pdu> format (e.g., SMSC address field is not
present). PDU is entered <ctrl-Z / ESC> ] ] ]
Example of New Message Acknowledgement in TEXT Mode
Command Possible responses
AT+CSMS=1 Note: SMS AT Commands compatible with GSM 07.05 Phase 2 + version AT+CMGF=1 Note: Set TEXT mode AT+CNMI=2,2,0,0,0 Note: <mt>=2
AT+CNMA Note: acknowledge the message received AT+CNMA Note: try to acknowledge again
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 61
OK
OK Note: TEXT mode valid OK
+CMT: “123456”,”98/10/01,12:30 00+00”,129,4 ,32,240, “15379”,129,5<CR><LF>
Received message
Note: message received OK Note: send positive acknowledgement to the network +CMS ERROR: 340 Note: no +CNMA acknowledgment expected
Example of New Message Acknowledgement in PDU Mode:
Command Possible responses
AT+CSMS=1 Note: SMS AT Commands compatible with GSM 07.05 Phase 2 + version AT+CMGF=0 Note: Set PDU mode AT+CNMI=2,2,0,0,0 Note: <mt>=2
AT+CNMA=2,2 <CR> >00D3 <Ctrl-Z> Note: Negative ACK to the SMS. Reason is: memory capacity exceeded AT+CNMA=2,2 <CR> >00D3 <Ctrl-Z> Note: Negative ACK to the SMS. Reason is: SIM memory storage is full AT+CNMA=2,2 <CR> >00D3 <Ctrl-Z> Note: Negative ACK to the SMS. Reason is: Error in modem AT+CNMA=2,2 <CR> >00FF <Ctrl-Z> Note: Negative ACK to the SMS. Unspecified error
OK
OK Note: PDU mode valid OK
+CMT: ,29 07913366003000F1240B913366920547F30000003003419404800 B506215D42ECFE7E17319 Note: message received OK
OK
OK
OK
Chapter 9 – Short Messages Commands
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 62
Chapter 9 – Short Messages Commands
Preferred Message Storage +CPMS
Description: This command allows the message storage area to be selected (for readi ng, writing, etc). Values: <mem1>: Memory used to list, read and delete messages. It can be:
SM SMS message storage in SIM (default) ME SMS message storage in Flash
BM CBM message storage (in volatile memory). SR Status Report message storage (in SIM if the EF-SMR file exists, otherwise in the ME non
volatile memory)
Note: SR ME non-volatile memory is cleared when another SIM card is inserted. It is kept,
even after a reset, while the same SIM card is used.
<mem2>: Memory used to write and send messages SM SMS message storage in SIM (default)
ME SMS message storage in Flash
<mem3>: Memory to which received S M S are preferred to be stored SM SMS message storage in SIM (default)
ME SMS message storage in Flash
If the command is correct, the following message indication is sent:
+CPMS: <used1>,<total1>,<used2>,<total2> , < used3> ,< total3> When <mem1> is selected, all following +CMGL, +CMGR and +CMGD commands are related to the
type of SMS stored in this memory. The maximum number of SMS is Flash is 99. When the modem is switched on, <mem1>,<mem2>, and <mem3> are initialized to SM.
Syntax: Command Syntax: AT+CPMS=<mem1>,[<mem2>],[<mem3>]
Command Possible responses
AT+CPMS=? Note: Possible message storages AT+CPMS? Note: Read AT+CPMS= “SM”,”ME”,“SM”
Note: Select SM for reading, ME for writing and SM for storing AT+CPMS=”AM” Note: Select false message storage AT+CPMS=”BM”
Note: Select CBM message storage AT+CPMS?
Note: Read CMTI: “SM”,4
AT+CPMS= “ME”,”ME”,“ME” Note: Select ME for reading, ME for writing and ME for storing AT+CPMS?
Note: Read CMTI: “ME”,4
AT+CPMS= “AM” Note: Select wrong message storage
+CPMS: ((“SM”,”ME”,”BM”,”SR”),(“SM”,”ME”),(“SM”,”ME”)) OK Note: Read, list, delete: SMS or SMS Status Report Write, send: SMS +CPMS: “SM”,3, 10,”SM”,3,10,”SM”,3,10 OK Note: Read, write…SMS from/to SIM 3 SMS are stored in SIM. 10 is the total memory available in SIM +CPMS: 3,10,3,99,3,10 OK
+CMS ERROR: 302 +CPMS: 2,20,3,10
OK Note: Read, list, delete CBM from RAM 2 CBM are stored in RAM +CPMS: “SM”,3,10,”ME”,3,99,“SM”,3,10, OK Note: Read, store...SMS from/to flash, write SMS to flash. 3SMS are stored in flash. 99 is the total memory available in flash
+CPMS: 3,99,3,99,3,99 OK
+CPMS: “ME”,3,99,”ME”,3,99,”ME”,3,99 OK Note: Read, write, store SMS from/to flash. 3 SMS are stored in flash. 99 is the total memory available in flash
Note: Receive an SMS stored in flash at location 4 +CMS ERROR: 302
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 63
Chapter 9 – Short Messages Commands
Command Syntax: AT+CPMS=<mem1>,[<mem2>],[<mem3>] continued
Command Possible responses
AT+CPMS= “SM” Note: Selecting SM for reading, writing and storing has not changed AT+CPMS? +CPMS: “SM”,4,10,”ME”,4,99,”ME”,4,99
+CPMS: “4,10,4,99,4,99 OK
OK Note: Read SMS from SIM. Write and store SMS from/to flash
Preferred Message Format +CMGF
Description: The message formats supported are text mode and PDU mode. In PDU mode, a complete SMS Message including all header information is given as a binary string (in
hexadecimal format). Therefore, only the following set of characters is allowed:
{‘0’,’1’,’2’,’3’,’4’,’5’,’6’,’7’,’8’,’9’, ‘A’, ‘B’,’C’,’D’,’E’,’F’}. Each pair of characters is converted to a byte (e.g., ‘41’ is converted to the ASCII character ‘A’, whose ASCII
code is 0x41 or 65). In Text mode, all commands and responses are in ASCII characters. The format selected is stored in EEPROM by the +CSAS command.
Values: <mode> PDU or Text Mode
0 PDU mode 1 Text mode
The <pdu> message is composed of the SC address (00 means no SC address given, use default
SC address, read with +CSCA command) and the TPDU message.
In this example, the length of bytes
Specification 03.40.
In this case, the TPDU is: 0x01 0x03 0x06 0x91 0x21 0x43 0x65 0x00 0x00 0x04 0xC9 0xE9 0x34
0x0B, which is GSM 03.40:
<fo> 0x01 (SMS-SUBMIT, no validity period) <mr> (TP-MR) 0x03 (Message Reference) <da> (TP-DA) 0x06 0x91 0x21 0x43 0x65 (destination address +123456) <pid> (TP-PID) 0x00 (Protocol Identifier) <dcs> (TP-DCS) 0x00 (Data Coding Schem e: 7 bits alphabet) <length> (TP-UDL) 0x04 (User Data Length, 4 characters of text) TP-UD 0xC9 0xE9 0x34 0x0B (User Data: ISSY)
TPDU in hexadecimal format must be converted into two ASCII characters; e.g., an byte with
hexadecimal value 0x2A is presented to the ME as two characters ‘2’ (ASCII 50) and ‘A’ (ASCII 65).
Syntax: Command Syntax: AT+CMGF<mode>
Command Possible responses
AT+CMGF ? Note: Current message format
AT+CMGF=? Note: Possible message format
of the TPDU buffer is 14, coded according to GSM Technical
+CMGF: 1 OK Note: Text mode +CMGF: (0,1) OK Note: Text or PDU modes are available
Example: Sending an SMS Message in PDU mode:
Command Possible responses
AT+CMGF=0
Note: Set PDU mode
AT+CMGS=14<CR> 0001030691214365000004C9E9340B
Note: Send complete MSG in PDU mode, no SC address
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 64
OK
Note: PDU mode valid
+CMGS: 4 OK
Note: MSG correctly sent, <mr> is returned
Chapter 9 – Short Messages Commands
Save Settings +CSAS
Description: All settings specified by the +CSCA and +CSMP commands are stored in EEPROM if the SIM card is a
Phase 1 card or in the SIM card if it is a Phase 2 SIM card.
Values: No parameters Syntax: Command Syntax: AT+CSAS
Command Possible responses
AT+CSAS Note: Store +CSCA and +CSMP parameters
OK Note: Parameters saved
Restore Settings +CRES
Description: All settings specified in the +CSCA and +CSMP commands are restored from EEPROM if the SIM card
is Phase 1 or from the SIM card if it is a Phase 2 SIM card.
Values: No parameters Syntax: Command Syntax: AT+CRES
Command Possible responses
AT+CRES Note: Restore +CSCA and +CSMP parameters
OK Note: Parameters restored
Show Text Mode Parameters +CSDH
Description: This command gives additional information about text mode result codes. This information can be found
in the description of the +CMT, +CMGR, +CMGL commands.
Values: <n>: show indicator 0 do not show header values 1 show the values in result codes
Syntax: Command Syntax: AT+CSDH
Command Possible responses
AT+CSDH=0 Note: Set value to “do not how” AT+CSDH? Note: Current value
OK +CSDH: 0
OK Note: Do not show header values
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 65
Chapter 9 – Short Messages Commands
New Message Indication +CNMI
Description: This command selects the procedure for message reception from the network. Values: <mode> Controls the processing of unsolicited result codes
Important Note: Only <mode>=2 is supported.
Any other value for <mode> (0,1 or 3) is accepted (return code will be OK), but
the processing of unsolicited result codes will be the same as with <mode>=2.
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 T A-TE link
is reserved. Otherwise forward them directly to the TE
2 Buffer unsolicited result codes in the TA when TA-TE link is reserved 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 used to embed
result codes and data when TA is in on-line data mode
<mt> Sets the result code indication routing for SMS-DELIVERs. Default is 1. 0 No SMS-DELIVER indications are routed. 1 SMS-DELIVERs are routed using unsolicited code: +CMTI: “SM”,<index>
2 SMS-DELIVERs (except class 2 messages) are routed using unsolicited code:
If PDU mode:
+CMT: [<alpha>,] <length> <CR> <LF> <pdu>
If text mode:
+CMT: <oa>,[<alpha>,] <scts> [,<tooa>, <fo>, <pid>, <dcs>, <sca>, <tosca>, <length>] <CR><LF><data>
3 Class 3 SMS-DELIVERs are routed directly using code in <mt>=2 ; Message of other classes
result in indication <mt>=1
<bm> Sets the rules for storing the received CBMs (Cell Broadcast Message) types. They depend on
the coding scheme (text or PDU) and the setting of Select CBM Types (+CSCB command). Default is 0.
0 No CBM indications are routed to the TE. The CBMs are stored. Default. 1 The CBM is stored and an indication of the memory location is routed to the customer
application using unsolicited result code: +CBMI: “BM”, <index>
2 New CBMs are routed directly to the DTE using an unsolicited result code.
If PDU mode:
+CBM: <length><CR><LF><pdu> (PDU mode)
If text mode:
+CBM:<sn>,<mid>,<dcs>,<page>,<pages>(Text mode) <CR><LF> <data>
3 Class 3 CBMs: as <bm>=2. Other classes CBMs: as <bm>=1. <ds> Used for SMS-STATUS-REPORTs. Default is 0.
0 No SMS-STATUS-REPORTs are routed. 1 SMS-STATUS-REPORTs are routed using unsolicited code:
If PDU mode:
+CDS: <length> <CR> <LF> <pdu>
If text mode:
+CDS: <fo>,<mr>, [<ra>] , [<tora>], <scts>,<dt>,<st>
2 SMS-STATUS-REPORTs are stored and routed using the u nsolicited result code: +CDSI:
“SR”,<index>
<bfr> Default is 0. 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 enter
ed
.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 66
Syntax: Command Syntax: AT+CNMI=<mode>,<mt>,<bm>,<ds>,<bfr>
Command Possible responses
AT+CNMI=2,1,0,0,0 Note: <mt>=1 AT+CMTI: “SM”,1
AT+CNMI=2,2,0,0,0 Note: <mt>=2 +CMT: “123456”,”98/10/01,12:30 00+00”,129,4,32,240,
AT+CNMI=2,0,0,1,0 Note: <ds>=1 AT+CMGS=”+33146290800”<CR> Happy Birthday! <ctrl-Z> Note: Send a message in text mode
OK
Note: message received OK
“15379”,129,5<CR><LF> Note: message received OK
+CMGS: 7 OK Note: Successful transmission
+CDS: 2, 116, ”+33146290800”, 145, “98/10/01,12:30:07+04”, “98/10/01 12:30:08+04”, 0 Note: message was correctly delivered
Chapter 9 – Short Messages Commands
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 67
Chapter 9 – Short Messages Commands
Read Message +CMGR
Description: This command allows the application to read stored messages. The messa ges are read from the
memory selected by the +CPMS command.
Syntax: Command syntax: AT+CMGR=<index>
Response syntax for text mode:
For SMS-DELIVER only
+CMGR: <stat>,<oa>,[<alpha>,] <scts> [,<tooa>,<fo>,<pid>,<dcs>,<sca>,<tosca>,<length>] <CR><LF> <data>
For SMS-SUBMIT only
+CMGR: <stat>,<da>,[<alpha>,] [,<toda>,<fo>,<pid>,<dcs>, [<vp>], <sca>, <tosca>,<length>]<CR><LF> <data>
For SMS-STATUS-REPORT only)
+CMGR: <stat>,<fo>,<mr>,[<ra>],[<tora>],<scts>,<dt>,<st>
Response syntax for PDU mode:
+CMGR: <stat>, [<alpha>] ,<length> <CR><LF> <pdu>
Notes: A message re ad with status “REC UNREAD” will be updated in memory with the status “REC READ”.
The <stat> parameter for the SMS Status Reports is always “READ”.
Syntax: Command Syntax: AT+CMGR=<index>
Command Possible responses
AT+CMGR=1 Note: Read the message
AT+CMGR=1 Note: Read the message again
AT+CMGR=2 AT+CMGF=0 ;+CMGR=1 Note: In PDU mode
AT+CMGF=1;+CPMS=”SR”;+CNMI=,,,2 Reset to text mode, set read memory to “SR”, and allow storage of further SMS Status Report into “SR” memory AT+CMSS=3 Send an SMS previously stored +CDSI: “SR”,1
AT+CMGR=1 Read the SMS Status Report
AT+CMTI: “SM”,1 Note: New message received +CMGR: “REC UNREAD”,”0146290800”, ”98/10/01,18:22:11+00”,<CR><LF> ABCdefGHI OK +CMGR: “REC UNREAD”,”0146290800”, ”98/10/01,18:22:11+00”,<CR><LF> ABCdefGHI OK Note: Message is read now OK Note: Location empty +CMGR: 2,,<length> <CR><LF><pdu> OK Note: Message is stored but unsent, no <alpha>field OK
+CMSS: 160 OK
New SMS Status Report stored in “SR” memory at index 1 +CMGR: "REC UNREAD",6,160, "+33612345678",129, "01/05/31,15:15:09+00", "01/05/31,15:15:09+00",0 OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 68
Chapter 9 – Short Messages Commands
List Message +CMGL
Description: This command allows the application to read stored messages, by indicating the type of the message to
read. The messages are read from the memory selected by the +CPMS command.
Values: <stat> possible values (status of messages in memory):
Text mode possible values
“REC UNREAD” 0 received unread messages “REC READ” 1 received read messages “STO UNSENT” 2 stored unsent messages “STO SENT” 3 stored sent messages “ALL” 4 all messages
Note: For SMS Status Reports, only “ALL” / 4 and “READ” / 1 values of the <stat> parameter
will list messages; other values will only return OK.
Syntax:
Command syntax: AT+CMGL=<stat>
Response syntax for text mode:
+CMGL: <index>,<stat>,<da/oa>[,<alpha>], [<scts>, <tooa/toda>, <length>] <CR><LF><data> (for SMS-DELIVER and SMS-SUBMIT. May be followed by other <CR><LF>+CMGL:<index>…)
+CMGL: <index>,<stat>,<fo>,<mr>,[<ra>],[<tora>],<scts>,<dt>,<st> (for SMS-STATUS-REPORT only. May be followed by other <CR><LF>+CMGL:<index>…)
Response syntax for PDU mode:
+CMGL: <index>,<stat>, [<alpha>], <length> <CR><LF> <pdu> (for SMS-DELIVER, SMS-SUBMIT and SMS-STATUS-REPORT. May be followed by other <CR><LF>+CMGL:<index>…)
Command Possible responses
AT+CMGL=“REC UNREAD” Note: List unread messages in text mode
AT+CMGL=”REC READ” Note: List read messages in text mode AT+CMGL=”STO SENT” Note: List stored and sent messages in text mode AT+CMGL=1 Note: List read messages in PDU mode
PDU mode possible values
+CMGL: 1,”REC UNREAD”,”0146290800”, <CR><LF> I will be late +CMGL: 3,”REC UNREAD”, “46290800”, <CR><LF>See you tonight! OK Note: 2 messages are unread, these messages will then have their status changed to “REC READ” +CMGL: 2,”REC READ”,”0146290800”,<CR><LF>
Keep cool
OK OK Note: No message found
+CMGL: 1,1,,26 <CR><LF> 07913366003000F3040B913366920547F400130011904125 30400741AA8E5A9C5201 OK
Status of messages in memory
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 69
Chapter 9 – Short Messages Commands
Send Message +CMGS
Description: The <address> field is the address of the terminal to which the message is sent. To send the message,
simply type, <ctrl-Z> character (ASCII 26). The text can contain all existing characters except <ctrl-Z> and <ESC> (ASCII 27).
This command can be aborted using the <ESC> character when entering text. In PDU mode, only
hexadecimal characters are used (‘0’…’9’,’A’…’F’).
Values: See the Parameters Definition list at the beginning this chapter.
Syntax: Command syntax in text mode:
AT+CMGS= <da> [ ,<toda> ] <CR>
Text is entered: <ctrl-Z / ESC >
Command syntax in PDU mode:
AT+CMGS= <length> <CR>
PDU is entered: <ctrl-Z / ESC >
Command Syntax: AT+CMGS
Command Possible responses
AT+CMGS=”+33146290800”<CR>
-----------------------------------------------­Please call me soon, Fred. <ctrl-Z> Note: Send a message in text mode
------------------------------------------------
AT+CMGS=<length><CR> Note: Send a message in PDU mode (1/3)
-------------------------------------------------------­<pdu> Note: Enter message in PDU mode (2/3)
-------------------------------------------------------­<ctrl-Z> Note: End the message (3/3)
The message reference <mr> is returned to the application and allocated by the product. T his number begins with 0, is incremented by one for each outgoing message (successes and failures), and is cyclic on one byte (0 follows 255).
Note: This number is not a storage number. Outgoing messages are not stored.
>
---------------------------------------
--------------------------------------­+CMGS: <mr> OK Note: Successful transmission >
---------------------------------------
----------------------------------------­+CMGS: <mr> OK Note: Successful transmission
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 70
Chapter 9 – Short Messages Commands
Write Message to Memory +CMGW
Description: This command stores a message in memory (either SMS-SUBMIT or SMS-DELIVERs). The memory location <index> is returned (no choice possible as with phonebooks +CPBW).
Text or PDU is entered as described for the Send Message +CMGS command.
Values: <oa/da> Originating or Destination Address Val ue in string format <tooa/toda> Type of Originating / Destination Address <stat> Integer type in PDU mode (default 2 for +CMGW) or string type in text mode (default
STO UNSENT for +CMGW). Indicates the status of message in memory. If <stat> is omitted, the stored message is considered as a message to send
0 “REC UNREAD”
1 “REC READ” 2 “STO UNSENT” 3 “STO SENT”
<length>: Length of the actual data unit in bytes Syntax: Command syntax in text mode: (<index> is returned in both cases)
AT+CMGW= <oa/da> [,<tooa/toda> [,<stat> ] ] <CR>
Enter text: <ctrl-Z / ESC>
Command syntax in PDU mode:
AT+CMGW= <length> [,<stat>] <CR>
Give PDU: <ctrl-Z / ESC>
Response syntax:
+CMGW: <index> or +CMS ERROR: <err> if writing fails
Command Syntax: +CMGW
Command Possible responses
AT+CMGW=”+33146290800”<CR>
-----------------------------------------------­Hello how are you ? <ctrl-Z> Note: Write a message in text mode
---------------------------------------------------
AT+CMGW=<length><CR><pdu><ctrl-Z> Note: Write a message in PDU mode (1/3)
----------------------------------------------------------­<pdu> Note: Enter message in PDU mode (2/3)
-----------------------------------------------------------­<ctrl-Z> Note: End the message (3/3)
>
------------------------------------------
------------------------------------------­+CMGW: 4 OK Note: Message stored in index 4 >
-----------------------------------------------
----------------------------------------------­+CMGW: <index> OK Note: Message stored in <index>
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 71
Chapter 9 – Short Messages Commands
V
V
Send Message from Storage +CMSS
Description: This command sends a message stored at location value <index>. Values: <index> Location of stored message
<da> Desination address <toda> Type of destination address <mr> Message reference
Syntax: Command syntax: AT+CMSS=<index>[,<da> [,<toda>] ] Response syntax: +CMSS: <mr> or +CMS ERROR: <err> if sending fails
If a new recipient address <da> is given, it will be used instead of the one stored with the message.
Command Possible responses
AT+CMGW=0660123456<CR>
Today is my birthday
AT+CMSS=5, 0680654321 Note: Send the message 5 to a different destination number
+CMGW: 5 OK Note: Message stored with index 5 AT+CMSS:<mr> OK Note: Successful transmission
Set Text Mode Parameters +CSMP
Description: This command selects values for <vp>, <pid>, and <dcs>. Values: <fo> byte comprises 6 different fields:
b7 b6 b5 b4 b3 b2 b1 b0
RP UDHI SRR VPF RD MTI
Note: <fo> must be entered in DECIMAL format. Hexadecimal format would lead to
irrelevant results
RP Reply Path, not used in text mode. UDHI User Data Header Information, b6=1 if the beginning of the User Data field contains a
Header in addition to the short message. This option is not supported in +CSMP command, but can be used in PDU mode (+CMGS).
SRR Status Report Request, b5=1 if a status report is requested. This mode is supported. VPF Validity Period Format
b4=0 & b3=0 -> <vp> field is not present b4=1 & b3=0 -> <vp> field is present in relative format
Others formats (absolute & enhanced) are not supported. RD Reject Duplicates, b2=1 to instruct the SC to reject an SMS-SUBMIT for an SM still
held in the SC that has the same <mr> and <da> as the previously submitted SM from the same <oa>.
MTI Message Type Indicator
b1=0 & b0=0 -> SMS-DELIVER (in the direction SC to MS) b1=0 & b0=1 -> SMS-SUBMIT (in the direction MS to SC)
In text mode <vp> is only coded in “relative” format. The default value is 167 (24 hours). This means that one byte can describe different values:
P value
0 to 143 (VP + 1) x 5 minutes (up to 12 hours) 144 to 167 12 hours + ( (VP – 143) x 30 minutes ) 168 to 196 (VP – 166) x 1 day 197 to 255 (VP – 192) x 1 week
alidity period value
<pid> T his is used to indicate the higher layer protocol being used or indicates interworking with a
certain type of telematic device. For example, 0x22 is for group 3 telefax, 0x24 is for voice telephone, 0x25 is for ERMES (European Radio Messaging System).
<dcs> This is used to determi ne the way the information is encoded. Compressed text is not
supported. Only GSM default alphabet, 8 bit data and UCS2 alphabet are supported.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 72
Chapter 9 – Short Messages Commands
Syntax: Command Syntax: AT+CSMP=<fo>, <vp>, <pid>,<dcs>
Command Possible responses
AT+CSMP? Note: current values AT+CMPS=17,23,64,244
Note: <vp> = 23 (2 hours, relative format)
<dcs> = GSM 8 bits alphabet
Reminder: Enter <fo> value in decimal format
+CSMP: 0,0,0,0 OK Note: No validity period <dcs>= PCCP437 alphabet (8 bits Æ 7 bits) OK Note: Command correct
Delete Message +CMGD
Description: This command deletes one or several messages from preferred message storage (“BM” SMS CB ‘RAM
storage’, “SM” SMSPP storage ‘SIM storage’ or “SR” SMS Status-Report storage). Refer to the Preferred Message Storage +CPMS command.
Values: <index> If <DelFlag>=0
(1-20) If the preferred message storage is “BM”
Sim dependent integer values (in the ran ge of SIM location number) if the preferred
message storage is “SM” or “SR”.
If <DelFlag> is > 0, <index> is ignored.
<DelFlag>
0 Delete message at location <index>. 1 Delete All READ messages 2 Delete All READ and SENT messages 3 Delete All READ, SENT and UNSENT messages 4 Delete All messages.
Notes: If <DelFlag> is omitted, default value is used. When the preferred message storage is “SR”, as SMS status reports are assumed to have a “READ”
status, if <DelFlag> is greater than 0, all SMS status reports will be deleted.
Syntax: Command Syntax: AT+CMGD=<Index> [,<DelFalg>]
Command Possible responses
+CMTI:”SM”,3
Note: New message received AT+CMGR=3 Note: Read it
AT+CMGD=3 Note: Delete it AT+CMGD=1,0 OK
AT+CMGD=1,1 OK AT+CMGD=1,2 OK AT+CMGD=1,3 OK AT+CMGD=1,4 OK
+CMGR: “REC UNREAD”,”0146290800”,
“98/10/01,18:19:20+00” <CR><LF>
Message received!
Note: Unread message received from 0146290800 on the 01/10/1998 at 18H19m
20s
OK
Note: Message deleted
Note: The message from the preferred message storage at the location 1 is deleted
Note: All READ messages from the preferred message storage are deleted
Note: All READ messages and SENT mobile originated messages are deleted
Note: All READ, SENT and UNSENT messages are deleted
Note: All messages are deleted
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 73
Chapter 9 – Short Messages Commands
Service Center Address +CSCA
Description: This command indicates the service center to which the me ssage must be sent. The product has no default value for this address. If the application tries to send a message without
having indicated the service center address, an error will be generated.
Therefore, the application must indicate the SC address when initializing the SMS. This address is then
permanently valid. The application may change it if necessary.
Values: <sca> service center address Syntax: Command Syntax: AT+CSCA=<sca>
Command Possible responses
AT+CMGS= “+33146290800”<CR> Hello, how are you?<ctrl-Z> Note: Send a message AT+CSCA=”0696741234” Note: Service center initialization AT+CMGS=”+33146290800”<CR> Happy Birthday ! <ctrl-Z> Note:
+CMS ERROR: 330 Note: service center unknown
OK +CMGS: 1
OK Note: Successful transmission
Select Cell Broadcast Message Types +CSCB
Description: This command selects which types of CBMs are to be received by the ME. This command is allo wed in
both PDU and text modes.
Values: The <bm> parameter of +CNMI command controls the message indication. The activation of CBM reception (<mode>=0) can select only specific Message Indentifiers (list in
<mids>) for specific Languages (list in <dcss>), but the deactivation stops any reception of CBMs (only AT+CSCB=1 is allowed).
Message Identifiers (<mids> parameter) indicates the type of message identifiers for which the ME
should listen. <dcss> Supported languages
0 for German 8 for Portuguese 1 for English 9 for Finnish 2 for Italian 10 for Norwegian 3 for French 11 for Greek 4 for Spanish 12 for Turkish 5 for Dutch 13 for Hungarian 6 for Swedish 14 for Polish 7 for Danish 32 for Czech
Syntax: Command Syntax: AT+CSCB= <mode>, [ <mids>, [ <dcss> ] ] Important Note: Test/read command AT+CSCB? is not supported.
Command Possible responses
AT+CSCB=0,”15-17,50,86”,” ” Note: Accept SMS-CB types, 15,16,17,50 and 86 in any language +CBM: 10<CR><LF>
AT+CSCB=1 Note: Deactivate the reception of CBMs
OK Note: CBMs can be received
00112233445566778899 Note: CBM length of a received Cell Broadcast message (SMS-CB), CBM bytes in PDU mode OK Note: CBM reception is completely stopped
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 74
Chapter 9 – Short Messages Commands
Cell Broadcast Message Identifiers +WCBM
Description: This specific command is used to read the EF-CBMI SIM file. The EF-CBMI file is not used with the +CSCB command.
The application should read this file (using AT+WCBM ?) and combine the Message Identifiers with
those required by the application.
Values: <mids> message identifiers Syntax: Command Syntax: AT+WCBM= <mids>
Command Possible responses
AT+WCBM=”10,100,1000,10000” Note : Write 4 messages identifiers in EFCBMI AT+WCBM? Note : Read the CBMIs in EF-CBMI
OK Note : CBMIs are stored in EF-CBMI +WCBM=”10,100,1000,100000” OK Note : 4 CBMIs are stored in EF-CBMI
Message Status Modification +WMSC
Description: This command allows the manipulation of a message status. The accepted status changes are from
READ to NOT READ and vice versa, and also from SENT to NOT SENT and vice versa.
Values: <loc> Location number of the stored message <interger> <status> New status to be stored, as in the +CMGL command
PDU Mode Text Mode
0 “REC UNREAD” 1 “REC READ” 2 “STO UNSENT” 3 “STO SENT”
Syntax: Command Syntax: AT+WMSC= <loc>, <status>
Command Possible responses
AT+CMGR=2 +CMGR: “REC READ”,”+336290918”,,”99/05/01
14:19:44+04” <CR><LF>
Hello All of you!
OK AT+WMSC=2,”REC UNREAD” AT+CMGR=2 +CMGR: “REC UNREAD”,”+336290918”,,”99/05/01
Possible responses:
OK If the location is valid +CMS ERROR: 321 If <loc> is invalid or free
+CMS ERROR: 302 If the new <status> and the previous one are incompatible (1)
Note: If all parameters are correct, the product overwrites the whole SMS in SIM. Only the first byte (Status byte) is changed.
14:19:44+04” <CR><LF>
Hello All of you!
OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 75
Chapter 9 – Short Messages Commands
Message Overwriting +WMGO
Description: The +CMGW command specifies a locatio n in the SMS or Flash memory for the next SMS to be stored
when the +CMGW indicates a message is ready to be stored. The defined location is used only once: +WMGO has to used again to perform another overwrite.
Important Notes:
If the external application specifies a free location and an incoming message is received before the
AT+CMGW command occurs, the product may store the incoming message at the specified available location. If the user then issues an AT+CMGW command without changing the location with another AT+WMGO, the received message will be overwritten.
The location number is not kept over a software reset.
Values: <loc> Location number of the SIM record to write or overwrite. The number depends on the SIM or
Flash memory capacity.
Syntax: Command Syntx: AT+WMGO= <loc>
Command Possible responses
AT+CPMS? Note: Check the storage area AT+CMGW=”+33146290800”<CR> Hello how are you?<ctrl-Z>
Note: Write a message in text mode
AT+WMGO=? +WMGO: (1-10)
AT+WMGO=4 AT+CMGW=”+33146299704”<CR> You are overwritten<ctrl-Z>
AT+WMGO? +WMGO: 4
AT+WMGO=4 OK AT+CPMS=”SM”,”ME,””SM” +CPMS: 3,10,0,99,3,10
AT+WMGO? +WMGO: (1-99)
AT+WMGO? +WMGO: 0
AT+WMGO=999 +CMS ERROR: 321
Note: If the storage area is changed with the AT+CPMS command, the value of WMGO will be reset to
zero.
+CPMS: “SM”,3,10,”SM”,3,10,”SM”,3,10 +CMGW: 4
OK
Note: Message stored in index 4 in the SIM
OK
Note: Possible values for the SIM
+CMGW: 4 OK Note: New Message stored in index 4
OK
Note: The value was used, so re-initialization
OK
Note: Change the storage area from SIM to Flash
OK
Note: Possible values for Flash
OK
Note: We changed the storage area, so the value was reinitialized
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 76
Chapter 9 – Short Messages Commands
Change or Do Not Change SMS Status +WUSS
Description: The +WUSS command allows the SMS Status to be kept at UNREAD after the +CMGR or +CMGL
commands are used.
Values: <mode>
0 The SMS Status will change 1 The SMS Status will not change
Syntax: Command Syntax: AT+WUSS=<mode>
Command Possible responses
AT+WUSS=? +WUSS: (0-1)
OK AT+WUSS=1 OK +CMTI: “SM”,10
Note: SMS has been received in index 10 AT+CMGR=10 +CMGR: “REC UNREAD”,”+33660669023”,,”03/02/13,18:36:35+00”<CR><LF>
Do you want to change state?
OK AT+CMGR=10
AT+WUSS=0 OK +CMTI: ”SM”,11
AT+CMGR=11 +CMGR: “REC UNREAD”,”+33660669023”,,”03/02/13,18:56:55+00”<CR><LF>
AT+CMGR=11 +CMGR: “REC UNREAD”,”+33660669023”,,”03/02/13,18:56:55+00”<CR><LF>
AT+WUSS? +WUSS: 0 AT+CMGR=10 +CMGR: “REC READ”,”+33660669023”,,”03/02/13,18:56:55+00”<CR><LF>
AT+WUSS? +WUSS: 0
+CMGR: “REC UNREAD”,”+33660669023”,,”03/02/13,18:36:35+00”<CR><LF>
Do you want to change state?
OK
Note: The state hasn’t been updated
Note: SMS has been received in index 11
It is me again.
OK
It is me again.
OK
Note: The state has been updated.
OK
It is me again.
OK
Note: The state has been updated
OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 77
Chapter 9 – Short Messages Commands
Copy Messages +WMCP
Description: This command copies the SMS from the SIM to the Flash or from the Flash to the SIM. Values: <mode>
0 From SIM to the Flash 1 From the Flash to the SIM
<loc> Location of the SMS to copy (mandatory for <mode>=1)
If this location is not defined, all the SMS will be copied
Note: The SMS copied will be placed in the first free location
Syntax: Command Syntx: AT+WMCP=<mode>[,<loc>]
Command Possible responses
AT+WMCP=?
AT+CPMS? Note: Read the SMS storage
AT+CMGR=1 Note: Read the first SMS from the
SIM AT+WMCP=0,1 Note: Copy the SMS at location 1 in the SIM to the Flash AT+CPMS?
Note: Read the SMS storage
AT+CPMS=“ME”,”ME”,“ME” Note: Select ME for reading, ME for writing and ME for storing AT+CMGR=1
Note: Read the first SMS from the Flash AT+CMGW=”+33146290800”<CR>
Other test message: SMS in the Flash at location 2
<ctrl-Z> Note: Write a message in text mode AT+CPMS?
Note: Read the SMS storage AT+WMCP=1,2
Note: Copy the SMS at location 2 in the Flash to the SIM AT+CPMS=“SM”,”ME”,“SM” Note: Select SM for reading, ME for writing and SM for storing AT+CMGR=4
Note: Read the first SMS from the SIM
Continued on the next page.
+WMCP: 0,(1-12) +WMCP: 1,(1-99) OK Note: The location of the SMS that can be copied from the SIM to the Flash is 1 to 12 (maximum available in the SIM). The location of the SMS that can be copied from the Flash to the SIM is 1 to 99 (the maximum available in the Flash). +CPMS: “SM”,3,10,”ME”,0,99,”SM”,3,10 OK Note: Read, write...SMS from/to SIM. 3 SMS are stored in the SIM. 10 is the total memory available in SIM. No SMS in Flash. +CMGR: “REC UNREAD”,”0146290800”, “98/10/01,18:22:11+00”, <CR><LF>
My test message: SMS in the SIM at location 1
OK OK
+CPMS: “SM”,3,10,”ME”,0,99,”SM”,3,10 OK Note: Read, write...SMS from/to SIM. 3 SMS are stored in the SIM. 10 is the total memory available in SIM. No SMS in Flash. +CPMS: 1,99,1,99,1,99 OK
+CMGR: “REC READ”,”0146290800”, “98/10/01,18:22:11+00”, <CR><LF>
My test message: SMS in the SIM at location 1
OK +CMGW: 2 OK Note: Message stored in index 2in the Flash
+CPMS: “ME”,2,99,”ME”,2,99,”ME”,2,99 OK Note: Read, write...SMS from/to the Flash. 2 SMS are stored in the Flash. OK
+CPMS: 4,10,2,99,4,10 OK
+CMGR: “REC UNREAD”,”+33146290800”, “98/10/01,8:22:11+00”,<CR><LF>
Other test message: SMS in the Flash at location 2
OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 78
Chapter 9 – Short Messages Commands
Command Syntx: AT+WMCP=<mode>[,<loc>] Continued
Command Possible responses
AT+CPMS=”ME” Note: Select ME for reading AT+CMGD=0,4
Note: Erase all the SMS stored in the Flash AT+CPMS?
Note: Read the SMS storage AT+WMCP=0 Note: Copy all the SMS from the SIM to the Flash AT+CPMS?
Note: Read the SMS storage
+CPMS: 2,99,2,99,4,10 OK OK
+CPMS: “ME”,0,99,”ME”,0,99,”SM”,4,10 OK Note: No SMS is stored in the Flash OK
+CPMS: “ME”,4,99,”ME”,4,99,”SM”,4,10 OK Note: 4 SMS are stored in the Flash
More Messages to Send +CMMS
Description: This short message service-oriented AT command allows the link to be kept open while sending several
short messages with only a short delay.
Values: <mode>
0 Disable feature 1 Keep link opened while messages are sent. If the delay between two mes sages exceeds 5
seconds, the link is closed and the mode is reset to 0: the feaure is disabled.
2 Keep link opened while messages are sent. If the delay between two mes sages exceeds 5
seconds, the link is closed but the mode remains set to 2: the feaure is still enabled.
Notes:
IMPORTANT: Before sending the last SMS in the link, you must use the AT+CMSS=0
command. This command will indicate that the FOLLOWING SMS will be the last one.
The delay of 5 seconds complies with Rec 3GPP 27.005...3.5.6
Syntax: Command Syntax: AT+CMMS=<mode>
Command Possible responses
AT+CMMS=0 Note: Disable feature AT+CMMS=1 Note: Enable feature 1 time AT+CMMS=2 Note: Enable feature AT+CMMS? +CMMS: 2
AT+CMMS=? +CMMS: (0-2)
OK Note: Feature is disabled OK Note: Feature is enabled; link is open OK Note: Feature is enabled; link is open
OK OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 79
Chapter 10 – Supplementary Services Commands
Chapter 10 – Supplementary
Services Commands
Call Forwarding +CCFC
Description: This commands allows control of the "call forwarding" supplementary service.
Values: <reason>
0 Unconditional 1 Mobile busy 2 No reply 3 Not reachable 4 All call forwarding 5 All conditional call forwarding
<mode>
0 Disable 1 Enable 2 Interrogate 3 Registration 4 Erasure
<type> TON/NPI (Type of address byte in integer format) (default 145 when dialing string includes
international access code character “+”; otherwise, 129).
<class>
1 Voice 2 Data 3 Fax 4 Short Messages 5 All classes
Note: The combination of different classes is not supported, it will only result in the activation /
deactivation / status request of all classes (7).
In the case where the FDN phonebook is activated, the registration is restricted to the phone
numbers written in the FDN.
If <Class> parameter is not given in the command, 7 is used as the default value.
<subaddr> not managed <satype> not managed
<time> For <reason> = 2 (No reply), 4 (all call forwarding) and 5 (all conditional call forwarding),
time to wait (1 to 30) in seconds before call is forwarded. Default value is 20.
<status>
0 not active 1 active
Syntax: Command syntax: AT+CCFC= <reason>, <mode> [, <number> [,<type> [,<class>
[,<subaddr>[,<satype>[,<time> ] ] ] ] ] ]
Response syntax: +CCFC: <status>, <class1> [, <number>, <type> [,<subaddr>, <satype> [,<time> ] ]
] [ <CR><LF>+CCFC: <status>, <class2> [, <number>, <type> [,<subaddr>, <satype>
[,<time> ] ] ] [ … ] ]
Command Possible responses
AT+CCFC=0,3,”0146290800” Note: Register to an unconditional call forwarding AT+CCFC=0,2 Note: Interrogate unconditional call forwarding
AT+CCFC=0,4 Note: Erase unconditional call forwarding
+CCFC responses are not sorted by <class> parameter, but only by the order of network response.
OK Note: Command valid +CCFC:1,1,”0146290800”,129 Note: Call forwarding active for voice <CR><LF>+CCFC:1,2,”0146290802”,129 Note: Call forwarding active for data <CR><LF>+CCFC:1,4,”0146290804”,129 OK Note: Call forwarding active for fax OK Note: Command valid
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 80
Chapter 10 – Supplementary Services Commands
Call Barring +CLCK
Description: This command allows control of the call barring supplementary service. Locking, unlocking or querying
the status of call barring is possible for all classes or for a specific class, but not for a combination of some.
Values: <fac>
“AO”, “OI”, “OX” barring outgoin g calls “AI”, “IR” barring incoming calls “AG”, “AC”, “AB barring all calls (<mode>=0 only)
<mode> 0 Unlocks the facility 1 Locks the facility 2 Query status
<class> See description for the +CLCK command (Facility Lock) or +CCFC (Call forwarding). Note: A combination of different classes is not supported. It will only result in the
activation/deactivation/status_request for all classes (7).
<status>
0 Not active 1 Active
Syntax: Command Syntax: AT+CLCK= <fac>, <mode> [, <password> [, <class> ] ] Response Syntax: (for <mode>=2 and command successful)
+CLCK: <status> [, <class1> [ <CR><LF>+CLCK: <status>, <class2> [… ] ]
Command Possible responses AT+CLCK=”AO”,1,1234 OK
Note: Command valid
AT+CLCK=”AO”,0,5555 +CME ERROR: 16
Note: Wrong password
AT+CLCK=”AO”,0,1234 OK
Note: Command valid
Modify SS Password +CPWD
Description: This command changes the supplementar y service password. Values: <fac> See +CLCK command with only “P2” facility adde d (SIM PIN2).
Note: Regardless of the specified facility, the change of password applies to barring all calls. <OldPassword>, (NewPassword> The password code is over 8 digits for P2 facility (4 to 8 digits)
The password code is over 4 digits for other facilities (1 to 4 digits)
Syntax: Command Syntax: AT+CPWD=<fac>,<OldPassword>,<NewPassword>
Command Possible responses
AT+CPWD=”AO”,1234,5555 Note: Change Call Barring password AT+CPWD=”AO”,1234,5555 Note: Change password AT+CPWD=”AO”,5555,1234 Note: Change password
OK Note: Password changed +CME ERROR: 16 Note: Wrong password OK Note: Password changed
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 81
Chapter 10 – Supplementary Services Commands
Call Waiting +CCWA
Description: This command controls the call waiting supplementary serv ice. The product will send a +CCWA unsolicited result code when the call waiting service is enabled.
Values: <n>: result code presentation status in the TA
0 Disable 1 Enable
<mode>
0 Disable 1 Enable 2 Query status
<type>
0 Type of address byte in integer format (refer to Rec GSM 04.08 [8] sub clause 10.5.4.7)
<class>
1 Voice 2 Data 8 Short Messages 7 All classes (voice, data)
Note: A combination of different classes is not supported. It will only result in the activation /
deactivation / status request for all classes (7).
<status>
0 Not Active 1 Active
<alpha>: Optional string type alphanumeric representation of <number> corresponding to the entry
found in the ADN or FDN phonebook.
Syntax: Command Syntax: AT+CCWA=<n>, [ <mode> [, <class> ] ] Response Syntax: (for <mode>=2 and command successful)
+CCWA: <status> [, <class1> [ <CR><LF>+CCWA: <status>, <class2> [ … ] ]
Unsolicited Result: +CCWA: <number>, <type>, <class> [ ,<alpha>] (when waiting service is
enabled)
Command Possible responses
AT+CCWA=1,1,1 Note: Enable call waiting for voice calls AT+CCWA=1,2 Note: Interrogate call waiting
+CCWA:”0146290800”,145,1,”FREDDY”
AT+CCWA=1,0,7 Note: Erase call waiting +CCWA:,,1
AT+CCWA? +CCWA: <n> AT+CCWA=? +CCWA: List of supported <n>
OK Note: Command valid
+CCWA:1,1 OK Note: Call waiting active for voice calls
Note: Number and name of the waiting voice call or +CCWA:”0146290800”,145,1,”8023459678FFFF” (UCS2 format) OK Note: Command valid
Note: voice call waiting (no number) OK OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 82
Chapter 10 – Supplementary Services Commands
Calling Line Identification Restriction +CLIR
Description: This command controls the Calling Line Identification restriction supplementary service. Values: <n> Sets the line ID restriction for outgoing calls
0 Presentation indicator is used according to the subscription of the CLIR service 1 CLIR invocation 2 CLIR suppression
<m> Shows the subscriber CLIR status in the network
0 CLIR not provisioned 1 CLIR provisioned in permanent mode 2 Unknown (no network…) 3 CLIR temporary mode presentation restricted 4 CLIR temporary mode presentation allowed
Syntax: Command syntax: AT+CLIR=<n> Response syntax: +CLIR:<n>,<m> (for AT+CLIR ?)
Command Possible responses
AT+CLIR=2 AT+CLIR ?
Note: Ask for current functionality
OK Note: Command valid +CLIR:<n>,<m> OK Note: <n> and <m> as defined above
Calling Line Identification Presentation +CLIP
Description: This command controls the calling line identific ation presentation supplementary service. When
presentation of the CLI (Calling Line Identification) is enabled (and calling subscriber allows), +CLIP response is returned after every RING (or +CRING) result code.
Values: <n> Parameter sets/shows the result code presentation in the TA
0 Disable 1 Enable
<m> parameter shows the subscriber CLIP service status in the network
0 CLIP not provisioned 1 CLIP provisioned 2 Unknown (no network…)
Syntax: Command syntax: AT+CLIP=<n> Response syntax: +CLIP: <n>,<m> (as response to AT+CLIP)
+CLIP: <number>, <type>[ ,<subaddr>, <satype>, <alpha> ] (for an incoming call, after each RING or +CRING indication)
Command Possible responses
AT+CLIP=1 Note: Enable CLIP AT+CLIP? Note: Ask for current functionality
RING
RING
AT+CLIP=0 Note: Disable CLIP presentation
OK Note: CLIP is enabled +CLIP:<n>,<m> OK Note: <n> and <m> defined as below
Note: Incoming call +CLIP: “0146290800”,129,1,,,”FRED” Note: Incoming call with number and name presentation
Note: Incoming call +CLIP: “0146290800”,129,1,, “8000204212FFFF” Note: Incoming call with number and name presentation (UCS2 format) OK Note: Command valid
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 83
Chapter 10 – Supplementary Services Commands
Connected Line Identification Presentation +COLP
Description: This command controls the connected line identification presentation suppl ementary service - useful for
call forwarding of the connected line.
Values: <n> Parameter sets/shows the result code presentation status in the TA
0 Disable 1 Enable
<m> Parameter shows the subscriber COLP service status in the network
0 COLP not provisioned 1 COLP provisioned 2 Unknown (no network)
Syntax: Command syntax: AT+COLP=<n> Response syntax: +COLP: <n>,<m> (as response to AT+COLP?)
+COLP: <number>,<type> [ ,<subaddr>, <satype>, <alpha> ] After ATD command, before OK or CONNECT <speed>
Command Possible responses
AT+COLP=1 Note: Activate COLP AT+COLP? Note: Ask for current functionality ATD146290928; Note: Outgoing call
AT+COLP=0 Note: Deactivate COLP
OK Note: Command valid +COLP:1,1 OK Note: COLP is enabled and provisioned +COLP:”0146290928”,129,,,”JOE” or +COLP:“0146290800”,129,1,,,”8000204212FFFF” (UCS2 format) OK Note: Connected outgoing line number and name presentation OK Note: Command valid
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 84
Chapter 10 – Supplementary Services Commands
Advice of Charge +CAOC
Description: This refers to the Advice of Charge supplementary service (GSM 02.24 and GSM 02.86), which enables
the subscriber to obtain information on call cost. With <mode>=0, the command returns the current call
meter value (CCM) from the modem (ME). If AOC is supported, the command can also enable unsolicited event reporting on CCM information. The unsolicited result code +CCCM: <ccm> is sent when the CCM value changes. Deactivation of
unsolicited event reporting is performed with the same command. If AOC is supported, the Read command indicates whether unsolicited reporting is activated or not.
Values: <mode>
0 Query CCM value 1 Deactivate the unsolicited reporting of CCM value 2 Activate the unsolicited reporting of CCM value
<ccm>
String type; three bytes of the current call meter value in hexadecimal format (e.g., “00001E”
corresponds to the decimal value 30); value is in home units and bytes are coded in a similar way as the ACMmax value in SIM
Syntax: Command syntax: AT+CAOC= <mode>
Command Possible responses
AT+CAOC=0
Note: Query CCM value
AT+CAOC=1
Note: Deactivate unsolicited report of CCM value
AT+CAOC=2
Note: Activate unsolicited report of CCM value
AT+CAOC ?
Note: Request mode
AT+CAOC=?
Note: Request supported modes
+CAOC: “000A08” OK Note: Display Current Call Meter value (CCM=2568) OK Note: CCM report deactivated OK Note: CCM report activated +CAOC:<mode> OK Note: Display unsolicited report mode (1 or 2) +CAOC: (0-2) OK Note: 0,1,2 modes supported
Accumulated Call Meter +CACM
Description: This command resets the Advice of Charge for accumulated call meter value in SIM file EF
ACM contains the total number of home units for both the current and preceding calls. SIM PIN2 is
required to reset the value. If setting fails in an ME error, +CME ERROR: <err> is returned. The Read command returns the current value of the ACM. The ACM value (entered or displayed) is in hexadecimal format with 6 digits.
Values: <pin2 passwd> string type <acm value> string type coded as <ccm> under +CAOC
Syntax: Command Syntax: AT+CACM=<pin2 passwd>
Possible Response: +CACM: <acm value>
Command Possible responses
AT+CACM? Note: Request ACM value
AT+CACM= 1234 Note: Request ACM reset, real PIN2 is “1234” AT+CACM= 0000 Note: Request ACM reset with wrong PIN2 value AT+CACM ? Note: Request ACM value
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 85
+CACM: “000400” OK Note: Display ACM value (ACM=1024) OK Note: ACM value is reset +CME ERROR: 16 Note: Incorrect password +CACM: “000000” OK Note: Display ACM value (ACM = 0)
ACM
. The
Chapter 10 – Supplementary Services Commands
Accumulated Call Meter Maximum +CAMM
Description: The set command sets the Advice of Charge related to accumulated call meter maximum value in SIM
file EF
consume. When ACM (see +CACM) reaches ACMmax, calls are prohibited. SIM PIN2 is required to set
the value. If setting fails in an ME error, +CME ERROR: <err> is returned. The Read command returns the current value of ACMmax. The ACMmax value (entered or displayed) is in hexadecima l format with 6 digits.
Values: <ACMmax> String type coded as <ccm> under +CAOC. Value 0 disables ACMmax feature. <pin2 passwd> String type
Syntax: Command syntax: AT+CAMM:<ACMmax>,<pin2 passwd>
Command Possible responses
AT+CAMM=”000400”,1234 Note: Request ACMmax update, PIN2 is “1234” AT+CAMM=”000400”,0000 Note: Request ACMmax update, PIN2 is “1234” AT+CAMM ? Note: Request ACMmax value
. ACMmax contains the maximum number of home units the subscriber is allowed to
ACMmax
OK Note: ACMmax updated to 1024 +CME ERROR: 16 Note: Incorrect password +CAMM: “000400” OK Note: ACMmax = 1024
Price Per Unit and Currency Table +CPUC
Description: The set command sets the parameters for Advice of Charge related to pr ice per unit and the currency
table in SIM file EF
+CACM and +CAMM) into currency units. SIM PIN2 is required to set the parameters. If setting fails in
an ME error, +CME ERROR: <err> is returned..
Values: <currency> String type <ppu> String type <pin2 passwd> String type
Syntax: Command syntax: AT+CPUC <currency>,<ppu>,<pin2 passwd>
Command Possible responses
AT+CPUC=”FFR”,”0.82”,1234 Note: Request Currency and Price per unit update AT+CPUC=”FFR”,”0.82”,1111 Note: Request Currency and PPU update (wrong PIN2) AT+CPUC? Note: Request Currency and Price
. PUCT information can be used to convert the home units (as used in +CAOC,
PUCT
OK + CME ERROR: 16
Note: Incorrect password +CPUC:”FFR”,”0.82” OK Note: Currency= “FFR” Price per unit= “0.82”
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 86
Chapter 10 – Supplementary Services Commands
Call Related Supplementary Services +CHLD
Description: This command manages call hold and multip arty conversation (conference call). Calls can be put on
hold, recovered, released or added to a conversation.
Values: <n>
0 Release all held calls or set User Determined User Busy (UDUB) for a waiting call. 1 Release all active calls (if any exist) and accepts the other (held or waiting) call. 1x Release a specific call X (active, held or waiting) 2 Place all active calls (if any exist) on hold and accepts the other (held or waiting) call. 2x Place all active calls on hold except call X with which communication is supported. 3 Adds a held call to the conversation. 4 Connects the two calls and disconnects the subscriber from both calls (Explicit Call Transfer).
Syntax: Command syntax: AT+CHLD=< n >
Command Possible responses
AT+CHLD=<n> OK
Note: If n is within the defined values
AT+CHLD=? +CHLD: (0-4, 11-17, 21-27)
OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 87
Chapter 10 – Supplementary Services Commands
List Current Calls +CLCC
Description: This command returns a list of current calls. Values: <idx> integer type, call identification as described in GSM 02.30
<dir> direction of the call
0 mobile originated (MO) call 1 mobile terminated (MT) call
<stat> (state of the call):
0 active 1 held 2 dialing (MO call) 3 alerting (MO call) 4 incoming (MT call) 5 waiting (MT call)
<mode> (teleservice):
0 voice 1 data 2 fax 9 unknown
<mpty>
0 call is not one of multiparty (conference) call parties 1 call is one of multiparty (conference) call parties
<number> string type phone number in format specified by <type>
<type> type of address byte in integer format
<alpha> optional string type alphanumeric representation of <number>
corresponding to the entry found in phonebook. (for UCS2 format see commands examples +CLIP, +CCWA or +COLP)
Syntax: Command syntax: AT+CLCC Response syntax: OK (if no calls are available)
Else: +CLCC: <id1>,<dir>,<stat>,<mode>,<mpty>[,<number>,<type> [<alpha>] ] [<CR><LF> +CLCC: <id2>,<dir>,<stat>,<mode>,<mpty>[,<number>,<type>[<alpha>] ] [. . . ] ] ] <CR><LF> OK
Command Possible responses
RING Note: Incoming call AT+CLCC +CLCC: 1,1,4,0,0,”0146294079”,129
ATA Note: Answering the call AT+CLCC +CLCC: 1,1,1,0,0,”0146294079”,129
ATD0146299704 Note: Outgoing Call AT+CLCC Note: Before the phone called is ringing AT+CLCC Note: The phone called is ringing AT+CLCC Note: The call is being answered
OK OK
OK OK
+CLCC: 1,0,2,0,0,”0146294079”,129 OK +CLCC: 1,0,3,0,0,”0146294079”,129 OK +CLCC: 1,0,0,0,0,”0146294079”,129 OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 88
Chapter 10 – Supplementary Services Commands
Supplementary Service Notifications +CSSN
Description: This command refers to supplementary service related network initiated notifications. Values: <n> Parameter sets/shows the +CSSI result code presentation status
0 disable 1 enable
<m> Parameter sets/sho ws the +CSSU result code presentation status
0 disable 1 enable
<code1>
0 unconditional call forwarding is active 1 some of the conditional call forwardings are active 4 closed User Group call, with CUG <index> 5 outgoing calls are barred 6 incoming calls are barred 7 CLIR suppression rejected
<code2>
0 this is a forwarded call (MT call setup) 1 closed User Group call, with CUG <index> 2 call has been put on hold (during a voice call, <number> & <type> fields may be present) 3 call has been retrieved (during a voice call, <number> & <type> fields may be present) 4 multiparty call entered (during a voice call, <number> & <type> fields may be present) 5 call on hold has been released (during a voice call) 7 call is being connected (alerting) with the remote party in alerting state in Explicit Call Transfer
operation (during a voice call)
8 call has been connected with the other remote party in Explicit Call Transfer operation (during a
voice call, <number> & <type> fields may be present)
<index> Closed User Group index
<number> String type phone number
<type> Type of address Syntax: Command syntax: AT+CSSN= <n>, <m>
When <n>=1 and a supplementary service notification is received after a mobile
originated call setup, intermediate result code +CSSI:<code1>[,<index>] is sent before any other MO call setup result codes.
When <m>=1 and a supplementary service notification is received during a call,
unsolicited result code +CSSU:<code2>[,<index>[,<number>,<type>]] is sent.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 89
Chapter 10 – Supplementary Services Commands
Unstructured Supplementary Service Data +CUSD
Description: The USSD supplementary service is described in GSM 02.90. It is based on sequences of digits which
may be entered by a mobile user with a handset. A sequence entered is sent to the network which
replies with an alphanumerical string, for display only, or for display plus request for the next sequence. This command is used to:
Enable or disable the CUSD indication sent to the application by the product when an incoming
USSD is received
Send and receive USSD strings
Values: <n>
0 Disable the result code presentation 1 Enable the result code presentation 2 Cancel session (not applicable to read command response)
<m>
0 no further user action required (network initiated USSD-Notify, or no further information needed
after mobile initiated operation)
1 further user action required (network initiated USSD-Request, or further information needed after
mobile initiated operation)
2 USSD terminated by network
4 Operation not supported <str> is network string, converted in the selected character set <dcs> is the data coding scheme received (GSM TS 03.38).
Syntax: Command syntax: AT+CUSD = <n> [ ,<str> [ <dcs> ] ] Note: In case of enabled presentation, a +CUSD (as direct answer to a send
USSD) is then indicated with:
+CUSD: <m> [,<str>,<dcs> ]
Command Syntax To Send and Receive USSD: AT+CUSD= <n> [,<str> [,<dcs>]]
Note: Please be aware that the send USSD command needs the user to re-enter
the <n> parameter!
Values for Send and Receive USSD
<str> The USSD string to be sent. <dcs> The default alphabet and the UCS2 a lphabet are supported.
When the product sends a USSD, an OK response is first returned, the intermediate +CUSD indication comes subsequently. In case of error, a +CUSD: 4 indication is returned.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 90
Chapter 10 – Supplementary Services Commands
Closed User Group +CCUG
Description: The Closed User Group Supplementary Service enabl es subscribers to form closed user groups with
restricted access (both access to and from).
The CUG supplementary service is described in GSM 02.85. This service is provided on prior
arrangement with the service provider. Subscription options should be selected at implementation.
The +CCUG command is used to:
Activate/deactivate the control of CUG information for all following outgoing calls
Select a CUG index
Suppress outgoing access (OA). OA allows a member of a CUG to place calls outside the CUG
Suppress the preferential CUG. Preferential is the default CUG used by the network when it does
not receive an explicit CUG index
Values: <n>
0 Disable CUG mode (default)
1 Enable CUG mode <index>
0-9 CUG index (0 default),
10 Preferred CUG
<info>
0 No information (default)
1 Suppress OA
2 Suppress preferential CUG
3 Suppress OA and preferential CUG
Note: To activate the control of the CUG information by call, add [G] or [g] to the ATD command.
Index and info values will be used.
Syntax: Command syntax: AT+CCUG = <n> [ ,<index> [ <info> ] ]
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 91
Chapter 11 – Data Commands
Chapter 11 – Data Commands
Using AT Commands During a Data Connection
To use AT Commands during a data connection (such as while the product is in online mode), it is necessary either to switch to offline mode, or to use the +WMUX command to enable Commands / Data multiplexing.
Switch from Online to Offline Mode
To switch from online mode to offline mode, the “+++” sequence must be sent. Following this, the product gets back to offline mode with an “OK” response, and an AT command can be sent.
Note: The “+++” sequence only works with the +ICF command using the following settings:
8 data bits, with no parity
7 data bits, with even parity
Switch from Offline to Online Mode
See the ATO command description.
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 92
Chapter 11 – Data Commands
Bearer Type Selection +CBST
Description: This command applies to both outgoing and incoming data calls, but in a dif ferent way. For an outgoing
call, the two parameters (e.g., <speed> and <ce>) apply; whereas, for an incoming call, only the <ce> parameter applies.
Notes:
For incoming calls, if <ce> is set to T, only and the network offers NT onl y or vice versa. Then the
call is released.
The values 2 and 3 for the <ce> parameter are equivalent to the former values of 100 and 101.
Those values are managed for compatibility purposes, but the y should n o lo nger be used in the new code (2 as former 100 and 3 as former 101).
Values: <speed>
0 (default) Autobauding (modem type: none) 1 300 bps (modem type: V.21) 2 1200 bps (modem type: V.22) 3 1200/75 bps (modem type: V.23) 4 2400 bps (modem type: V.22bis) 5 2400 bps (modem type: V.26ter) 6 4800 bps (modem type: V.32) 7 9600 bps (modem type: V.32)
8 Specific 12 9600 bps (modem type: V.34) 14(*) 1400 bps (modem type: V.34) 65 300 bps (modem type: V.110) 66 1200 bps (modem type: V.110) 68 2400 bps (modem type: V.110) 70 4800 bps (modem type: V.110) 71 9600 bps (modem type: V.110) 75(*) 14400 bps (modem type: V.110)
(*) This speed configures data and fax 14.4 kbps bearers.
<name> No data compression is provided and only asynchronous mod em is supported (<name> = 0). <ce> Connection element
0 Transparent only
1 (default) Non transparent only
2 Transparent preferred
3 Non transparent preferred
Syntax: Command syntax: AT+CBST= <speed>, <name>, <ce>
Command Possible responses
AT+CBST=? Note: Test command
AT+CBST=? Note: Test command
AT+CBST=7,0,1 Note: Ask for a bearer AT+CBST?
Note: Current values AT+CBST=81,0,0 Note: Ask for a bearer
+CBST: (0-8,65,66,68,70,71),(0),(0-3) OK Note: Data 14,4 kbps not supported +CBST: (0­8,12,14,65,66,68,70,71,75),(0),(0-3) OK Note: Data 14,4 kbps not supported OK Note: Bearer supported +CBST:7,0,1 OK Note: Command valid +CME ERROR: 4 Note: Bearer not supported
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 93
Chapter 11 – Data Commands
Select Mode +FCLASS
Description: This command puts the product into a particular operating mode (data or fax).
Values: <n>
0 Data
Syntax: Command syntax: AT+FCLASS= <n>
Command Possible responses
AT+FCLASS=? Note: Test command
AT+FCLASS=? Note: Test command AT+FCLASS=0 Note: Data mode requested OK
AT+FCLASS? Note: Current value
+FCLASS: (0) OK Note: Fax class 2 not supported +FCLASS: (0) OK OK Note: Command valid
Note: Command valid +FCLASS: OK Note: Command valid
Service Reporting Control +CR
Description: This command enables a more detailed type of service reporting in the case of incoming or outgoing
data calls. Before sending the CONNECT response to the application, the product will specify the type of data connection that has been set up.
These report types are:
+CR: ASYNC For asynchronous transparent +CR: REL ASYNC For asynchronous non-transparent
Values: <mode>
0 Disable extended reports
1 Enable extended reports
Syntax: Command syntax: AT+CR=<mode>
Command Possible responses
AT+CR=0 Note: Extended reports disabled AT+CR=1 Note: Extended reports enabled AT+CR? +CR: 1
AT+CR=? +CR: (0,1)
OK Note: Command valid OK Note: Command valid
OK OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 94
Chapter 11 – Data Commands
Cellular Result Codes +CRC
Description: This command shows more detailed ring information for an incoming call (voice or data). Instead of the
string “RING”, an extended string is used to indicate which type of call is ringing (e.g. +CRING: VOICE).
These extended indications are: +CRING: ASYNC for asynchronous transparent
+CRING: REL ASYNC for asynchronous non-transparent +CRING: VOICE for normal speech.
Values: <mode>
0 Disable extended reports
1 Enable extended reports
Syntax: Command syntax: AT+CRC=<mode>
Command Possible responses
AT+CRC=0 Note: Extended reports disabled AT+CRC=1 Note: Extended reports enabled AT+CRC? +CRC: 1
AT+CRC=? +CRC: (0,1)
OK Note: Command valid OK Note: Command valid
OK OK
DTE-DCE Local Rate Reporting +ILRR
Description: This parameter controls whether or not the extended-format “+ILRR:<rate>” information text is
transmitted from the DCE to the DTE. The <rate> reported represents the current (negotiated or renegotiated) DTE-DCE rate.
If enabled, the intermediate result code is transmitted in an incoming or outgoing data call, after any
data compression report, and before any final result code (CONNECT).
Values: <value>
0 Disable local port rate report
1 Enable local port rate report
<rate> Can take the following values: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200
Kbps.
Syntax: Command syntax: AT+ILRR = <value>
Command Possible responses
AT+ILRR=0 Note: Local port rate report disabled AT+ILRR=1 Note: Local port rate report enabled AT+ILRR? +ILRR: 1
AT+ILRR=? +ILRR: (0,1)
OK Note: Command valid OK Note: Command valid
OK OK
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 95
Chapter 11 – Data Commands
Radio Link Protocol Parameters +CRLP
Description: This command changes the radio link protocol parameters used for non transparent data transmission.
Values: Value: Range: Description:
<iws> 0-61 Down window size, (default is 61) <mws> 0-61 Up window size, (default is 61) <T1> 40-255 Ackno wledgem ent timer in units of 10ms, (default is 48) <N2> 1-255 Retransmission attempts, (default is 6)
<ver> 0-1 Version number
0 V42bis is not supported 1 V42bis is supported
Syntax: Command syntax: AT+CRLP=<iws>,<mws>,<T1>,<N2>, <ver>
Command Possible responses
AT+CRLP=? Note: Test command
AT+CRLP=? Note: Test command
AT+CRLP=61,61,48,6,0 Note: Set new parameters AT+CRLP? Note: Current values
+CRLP: (0-61),(0-61),(40-255),(1,255),(0) OK Note: V42bis not supported +CRLP: (0-61),(0-61),(40-255),(1,255),(0,1) OK Note: V42bis supported OK Note: Command valid AT+CRLP: 61,61,48,6,0 Note: Command valid
Other Radio Link Parameters +DOPT
Description: This command modifies some supplementary radio link protocol parameters.
Values: <reset_allowed>
0 Data communication is hung up in case of bad radio link.
1 Default. Data communication continues in case of bad radio link (possible loss of data)
<dtx_allowed>
0 Normal mode
1 Default. Economic battery mode (not supported by all networks)
Syntax: Command syntax: AT+DOPT=< reset_allowed>,<dtx_allowed>
Command Possible responses
AT+DOPT=1 Note: Set new parameters (2 AT+DOPT+? Note: Test command
AT+DOPT=1,1 Note: Set new parameters AT+DOPT? Note: Current values
nd
value is the default)
OK Note: Command valid (0,1),(0,1) OK Note: DTX is supported OK Note: Command valid 1,1 OK Note: Command valid
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 96
Chapter 11 – Data Commands
Select Data Compression %C
Description: This command enables or disables data com pression negotiation if this feature is supported on the
product.
Values: <n>
0 no compression (default)
2 V42bis compression if supported
Syntax: Command syntax: AT%C<n>
Command Possible responses
AT%C0 Note: Command AT%C2 Note: Command AT%C? Note: Current value 2 OK
OK Note: Feature supported OK Note: V42bis supported
Note: Command valid
V42bis Data Compression +DS
Description: This command enables or disables V.42bis data compression if this feature is supported on the product.
Note that the product allows only the MNP2 protocol.
Values: < dir > Specifies the desired direction(s) of operation of the data compression function; from the
DTE point of view, (default is 3)
0 Negotiated … no compression 1 Transmit only 2 Receive only 3 Both directions, accept any direction. Default.
< neg > Specifies whether or not the DCE should continue to operate if the desired result is not
obtained, (default is 0) 0 Do not disconnect if V.42 bis is not negotiated by the remote DCE as specified in <dir>.
Default.
1 Disconnect if V.42 bis is not negotiated by the remote DCE as specified in <dir>
< P1 > Specifies the maximum number of dictionary entries that should be negotiated, Range is 512 to 2048. Default is 2048.
< P2 > Specifies the maximum string length to be negotiated. Range is 6 to 250. Default is 20.
Syntax: Command syntax: AT+DS=[[<dir>][,[<neg>][,[<P1>][,[<P2>]]]]
Command Possible responses
AT+DS=? Note: Test command AT+DS=3,0,2048,250 Note: Set new parameters AT+DS? Note: Current values
+DS: (0-3),(0,1),(512-2048),(6-250) OK OK Note: Command valid +DS: 3,0,2048,20 OK Note: Command valid
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 97
Chapter 11 – Data Commands
V42bis Data Compression Report +DR
Description: This command determines whether or not the use of V42bis is allowed for an incoming or outgoing data
call, if this feature is provided by the product. The intermediate result code represents current DCE-DCE data compression type. The format of this result code is as follows:
+DR: NONE Data compression is not in use
+DR: V42B Rec. V.42 bis is in use in both directions
+DR: V42B RD Rec. V.42 bis is in use in receive direction only
+DR: V42B TD Rec. V.42 bis is in use in transmit direction only
The +DR intermediate result code, if enabled, is issued before the final result code, befo re the +ILRR intermediate report and after the service report control +CR.
Values: <status> State of the V42bis
0 Disable. Default value.
1 Enable
Syntax: Command syntax: AT+DR=<status>
Command Possible responses
AT+DR=? Note: Test command AT+DR=1 Note: Reporting enabled AT+DR? Note: Current value
+DR: (0-1) OK OK Note: Command valid +DR: 1 OK Note: Command valid
Select Data Error Correcting Mode \N
Description: If this feature is provided by the product, this command controls the preferred error correcting mode for
a data connection. It can only be used for transparent data transmission.
If the MNP2 feature is provided, the product authorizes MNP error correction mode.
Values: <n>
0 Default. Disables error correction mode
5 Selects MNP error correction mode
Note: +E prefixed commands of V.25 ter are not used.
Syntax: Command syntax: AT\N<n>
Command Possible responses
AT\N0 Note: no error correction AT\N? Note: Current value
AT\N4 +CME ERROR: 3
OK 0
OK Note: Command valid
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 98
Chapter 12 – V.24 and V.25 Commands
Chapter 12 – V.24 and V.25
Commands
Important
All commands described hereafter will to the currently selected (and used) UART.
Fixed DTE Rate +IPR
Description: This commands specifies the data rate at which the DCE will accept commands.
Notes:
The serial autobauding feature is supported and covers the following serial speeds only:
2400, 4800, 9600, 19200, 38400, 57600 bps. Beyond those serial speeds, proper operation of the modem is not guaranteed.
Any AT command issued by the DTE must start with both capital ‘A’ and ‘T’ (or ‘/’) or both lower
case ‘a’ and ‘t’ (or ‘/’); otherwise, the DCE may return some garbage characters and become desynchronized. Should this happen, the DTE simply issues ‘AT\r’ (at 2400 or 4800 bauds) once or twice or just ‘AT’ (at 9600 bauds) to resynchronize the modem.
The DTE waits for 1ms after receiving the last character of the AT response (which is always ‘\n’
or 0x0A) to send a new AT command at either the same rate or a new rate. Should this delay be ignored, the DCE can become desynchronised. Once again, sending ’AT\r’ once or twice or just ‘AT’ causes the DCE to recover.
Caution: When starting up, if autobauding is enabled and no AT command has yet been received, the
product sends all unsolicited responses (like RING) at 9600 bauds.
Values: <value> Baud rates that can be used by the DCE
0 Enables autobauding
300 600 1200 2400 4800 9600 19200 38400 57600
115200
Syntax: Command syntax: AT+IPR=<value>
Command Possible responses
AT+IPR?
AT+IPR=?
AT+IPR=38400 OK AT+IPR=0
+IPR: 9600 OK Note: Current rate is 9600 bps +IPR: (0,2400,4800,9600,19200,38400,57600,115200), (300,600,1200) OK Note: Possible values, according to V25ter Recommendation: The first set of values indicates the range of auto-detectable baud rates (including
0). The second set of values indicates the baud rates supported by the DCE but not auto-detectable.
Note: Disable autobauding and set rate to 38400 bps OK Note: Enable autobauding
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 99
Chapter 12 – V.24 and V.25 Commands
DTE-DCE Character Framing +ICF
Description: This command determines the local serial port start-stop (asynchronous) character framing that the
DCE uses.
Values: <format>
0 Autodetect (not supported) 1 8 Data 2 Stop (supported)
<parity> parameter is ignored 2 8 Data 1 Parity 1 Stop (supported)
If no <parity> provided, 3 is used by default as <parity> value 3 8 Data 1 Stop (supported)
<parity> parameter is ignored
4 7 Data 2 Stop (supported) <parity> parameter is ignored
5 7 Data 1 Parity 1 Stop (supported) If no <parity> provided, 3 is used by default as <parity> value
6 7 Data 1 Stop (supported) <parity> parameter is ignored
<parity>
0 Odd (supported) 1 Even (supported) 2 Mark (supported) 3 Space (supported) 4 None (supported)
Note: All character framing formats settings of the serial interface (i.e., 801, 8E1, 8S1, 8N1, 7N1, 7O1,
7E1, 7S1 and 7N2) are supported on autobauding operation.
Syntax: Command syntax: AT+ICF= <format>[, <parity>]
Command Possible responses
AT+ICF?
AT+ICF=?
AT+ICF=2,0
+ICF: 3,4 OK
Note: Current values
+ICF: (1-6),(0-4) OK
Note: Possible values
OK
Note: New values
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 100
Loading...