At Commends
At Commends
At Commends
This document is the property of WAVECOM, and is transferred to ______________________________ under the conditions of the active Non-Disclosure Agreement dated __________. Use of this document is subject to the terms of this NDA. This document will be returned to WAVECOM under request.
Version : 9.0 ATI Version : 61 Date : July 26th, 2001 Reference : WCOM/GSM/SW/SII015.D90
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
AT commands interface
1.0 2.0 3.0 4.0 5.0 5.1 5.2 5.3 6.0 6.1 7.0 7.1 7.2 7.3
29-02-1996 18-03-1996 10-06-1996 08-07-1996 29-07-1996 25-09-1996 03-10-1996 21-10-1996 16-01-1997 10-02-1997 29-05-1997 24-07-1997
P P P P P P P P P P P P
N. Higelin R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec
Creation Add of new commands Add of new commands Add of new commands Add of new commands Modification of commands Add of new commands Add of V25 ter commands Add of new commands Modifications of +CBST, +CRLP, +SIDET Add of new commands Modifications for error codes
16-10-1997 P
F. Desnoues Network & SIM lock (+CLCK, +CPWD) SIM Phonebook management F. Desnoues (+CPBS, +CPBR, +CPBF, +CPBW) FAX management document F. Desnoues Advice Of Charge management (+CAOC, +CACM, +CAMM, +CPUC) Cell Broadcast Msg management (+CSCB, +WCBM) and Incoming bearer (+CICB) New commands +CPINC,+CCID,+CNUM, +WAIP , +CPBP, +CPBN (phonebook) SMS commands (+CMGW, +CMSS) New formats of Suppl Serv commands (+CLCK,+CCWA,+CCFC) Add comments pertaining +IPR,+CBST,+ICF and fax setup. to
7.7 7.8
R.Dorey
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
AT commands interface
7.9
10-02-1999 P
O.Capron F.Desnoues
8.0
15-04-1999 P 04-05-1999 P
F.Desnoues C.Amiens
8.1
16-06-1999 P
C.Foratier
New +CPIN2, +CIMI, +WIND, +CPOL, +WOPN (Operator Name), +WLPR, +WLPW, +WIOR, +WIOW (GPIO), AT&T Extension: +CCED (RxLev auto), +CPBS (Own Nb), +CLCK (FDN), ATD (Temporary CLIR) New: +CHLD, +CLCC, +CSSN, +CUSD, +WMGO, +WMSC Extension: ATD, ATH, ATA, +CCWA, +CLIP, +COLP, +WIND, +COPS Modification: +VGR levels New format of +ECHO?.command. New: +CCUG, AT&V, ATI, +DOPT Extension: ATD (Temporary CUG) Modification:+CRLP, +ILRR, +FCLASS, add fax class 1 commands, New: %D, +VIP, +WAC. New: +WTONE,+WDTMF,+CKPD Extension: EN phonebook Extension: ATD (GSM sequences) Extension: +ECHO (Add Switch Attenuation algo) compatible WISMO2C. Extension +WIND (Add indications for network service). Extension AT&Vx and AT&F (Add Switch Attenuation values).(WISMO2C only) Add +WDWL command (Compatible WISM02C only) Add +WVR command (Compatible WISM02C only) Add +WDR command (Compatible WISM02C only) Add Data 14.4 commands (Compatible WISM02C only) Add Fax class 2 commands (Compatible WISM02C only) Add default values WISMO2C Add SIM ToolKit commands. New: +WHWV, +WDOP, +CNMA. Modification: +CSMS.
C. Amiens C.Foratier
8.4
18-11-1999 P
C. Amiens
8.5
17-02-2000 P
J. Berdin
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
ii
AT commands interface
C. Amiens JP. Biou J. Berdin J. Berdin J. Berdin JP. Biou JP. Biou C. Amiens
New : +WSVG Modification +VGT New: +WSTR New: +WSCAN Modification : +CNMA Add +CMS ERROR: 340 Add +CME ERROR: 500 Modification : +CNMA New : +WRIM Modification : +ADC Modifications : SIM TOOLKIT +STSF (for Timeout ) +STGI (for GetInput) UCS2 format supported SMS +CMGD : multiple deletion UCS2 for phonebooks +CPBW: Store a record with a UCS2 name format +CPBR: Read a record with a UCS2 name format +CPBF: Find records in UCS2 format. +CPBP : Search +CPBN : Move to a record in UCS2 format
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
iii
AT commands interface
UCS2 for call management +CLCC, +CCWA,+COLP,+CLIP 09-06-2000 P 13-06-2000 P JP. Biou J. Berdin Modification : +CHLD (Added Explicit Call Transfer) New : +CCLK, +CALA, +CSNS, %D2, +CRMP, +CRSL. New Phone-Books (LD,MC,RC,ME,MT,SN) Modifications : +CSMP, +CPBS, +CPBW 14-06-2000 P 19-06-2000 P 28-06-2000 P 06-07-2000 P 13-07-2000 P 8.6 04-10-2000 P 05-10-2000 P 12-10-2000 P 12-10-2000 P 13-10-2000 P 18-10-2000 P 16-11-2000 P 28-11-2000 P J. Berdin J. Berdin J. Berdin C. Amiens J. Berdin D. Pochet C. Amiens Y. Sira J. Berdin D. Pochet D. Pochet D. Pochet D. Pochet Modifications : +CRMP, +CRSL, +COPS. Modification : +CPBF. Modifications : +CRMP, +CRSL, +WAIP. Modifications : +ECHO New : +W32K Modifications : +COPS, +WSTR Add execution conditions and SIM dependence of AT commands. Add new command : +WUSS New indication : +WIND: 9 (Audio ON) Modifications : +CPBF, +CPBW Modification of the PLMN list, with TSE13318-20.doc updates. Modifications : +WIOR, +WIOW, +CRMP, +CMGL Modifications : +DS, \N, GSM sequences list
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
iv
AT commands interface
8.7
19-09-2000 P 20-10-2000 P 10-11-2000 P 15-12-2000 P 27-12-2000 P 05-01-2001 P 10-01-2001 P 12-01-2001 P 12-01-2001 P 16-01-2001 P 19-01-2001 P 26-01-2001 P 09-02-2001 P 20-02-2001 P 27-02-2001 P 28-02-2001 P 08-03-2001 P 15-03-2001 P
D. Pochet D. Pochet D. Pochet D. Pochet D. Pochet D. Pochet Y. Sira D. Pochet J. Berdin D. Pochet D. Pochet D. Pochet D. Pochet D. Pochet J. Berdin D. Pochet D. Pochet J. Berdin
New : +WCDM Modifications : +STSF, +STIN Modifications : Sim Toolkit new features Add +CME ERROR: 526 Modifications : Sim Toolkit, +CLCK New : +WSSW, +WPCS, +WCCS Modification : +CSCS Modifications : D, +CSNS New : +WLCK Modification : +COPS Add +CME ERROR: 527, 528, 529 Correction : Reply after ATH is OK (not NO CARRIER) New : +CPHS Modification : +WCCS informative example Modification : AT&V Modification : parameters storage Modification : +CSSN Modification : +STGR Correction : 9.5.3, length 14 is an example Modification : +CSSN (ECT notifications) Modification : parameters storage, +VIP Modification : AT+CALA. Add delete-alarm functionality.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
AT commands interface
Modification : +WCDM (new parameter) Modification : +ECHO New commands : +WBCM (battery charge management) +WIOM (input/output management) +WFM (features management) +WMUX (datas/commands multiplexing) +WMIR (customer storage mirror) New error code : +CME ERROR: 531, for SMS commands
22-05-2001 P
D. Pochet
Using AT commands in a Data connection. New +WCFM command (commercial features management)
31-05-2001 P
D. Pochet
Modification : +CNMI, +CPMS, +CMGR, +CMGL and +CMGD (for SMS Status Report storage) New +CDSI unsolicited response
13-06-2001 P
J. Berdin
New indication : +WIND : 10 (SIM phonebooks reload status) Extension of +CPBW command to support RC and MC phonebooks (delete only). New command +WDCP (Delete Calls Phonebook) New command +CSVM (Set Voice Mail Number)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
vi
AT commands interface
06-07-2001 P
D. Pochet
Modifications for +WFM, +FDIS, +FDCC, +CSVM, +CPBW, +WMUX TON/NPI display in phonebook read commands New +RUI, +DUI, +HUI commands New Appendice for Data / Commands multiplexing protocol
Addition of CPHS feature to +WFM command Modification for +WIND: 10 indication. New command +WCDP (Change Default Player) New command +WMBN (CPHS Mail Box Number management) Extension of +CPHS command for Mail Box Number management Modifications: +COPS addon & execution condition
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
vii
AT commands interface
CONTENTS
1 1.1 1.2 1.3 1.4 2 2.1 2.2 2.3 3 3.1 3.2 4 INTRODUCTION .............................................................................................................15 SCOPE OF THIS DOCUMENT .........................................................................................15 RELATED DOCUMENTS ................................................................................................15 ETSI SECRETARIAT.....................................................................................................16 DEFINITIONS ...............................................................................................................16 AT COMMANDS FEATURES .........................................................................................17 WAVECOM LINE SETTINGS ...........................................................................................17 COMMAND LINE...........................................................................................................17 INFORMATION RESPONSES AND RESULT CODES ...........................................................17 GENERAL BEHAVIORS.................................................................................................18 SIM INSERTION, SIM REMOVAL ...................................................................................18 BACKGROUNG INITIALISATION .....................................................................................19 GENERAL COMMANDS.................................................................................................20 MANUFACTURER IDENTIFICATION +CGMI ...................................................................20 REQUEST MODEL IDENTIFICATION +CGMM.................................................................20 REQUEST REVISION IDENTIFICATION +CGMR..............................................................21 PRODUCT SERIAL NUMBER +CGSN ...........................................................................21 SELECT TE CHARACTER SET +CSCS .........................................................................22 WAVECOM SET PHONEBOOK CHARACTER SET +WPCS .............................................23 REQUEST IMSI +CIMI ................................................................................................24 CARD IDENTIFICATION +CCID ....................................................................................24 CAPABILITIES LIST +GCAP ........................................................................................25 REPEAT LAST COMMAND A/........................................................................................26 POWER OFF +CPOF ..................................................................................................26 SET PHONE FUNCTIONALITY +CFUN...........................................................................27 PHONE ACTIVITY STATUS +CPAS...............................................................................28 REPORT MOBILE EQUIPEMENT ERRORS +CMEE.........................................................29 KEYPAD CONTROL +CKPD ........................................................................................30 CLOCK MANAGEMENT +CCLK ...................................................................................30 ALARM MANAGEMENT +CALA...................................................................................31 RING MELODY PLAYBACK +CRMP.............................................................................32 RINGER SOUND LEVEL +CRSL ..................................................................................34
4.1 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10 4.11 4.12 4.13 4.14 4.15 4.16 4.17 4.18 4.19 5 5.1 5.2
CALL CONTROL COMMANDS ......................................................................................35 DIAL COMMAND D .......................................................................................................35 HANG-UP COMMAND H...............................................................................................38
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
viii
AT commands interface
5.3 5.4 5.5 5.6 5.7 5.8 5.9 5.10 5.11 5.12 5.13 5.14 5.15 5.16 5.17 5.18 5.19 5.20 6 6.1 6.2 6.3 6.4 6.5 7 7.1 7.2 7.3 7.4 7.5 8
ANSWER A CALL A .....................................................................................................39 REMOTE DISCONNECTION ............................................................................................39 EXTENDED ERROR REPORT +CEER............................................................................40 DTMF SIGNALS +VTD, +VTS.....................................................................................41 REDIAL LAST TELEPHONE NUMBER ATDL...................................................................43 AUTOMATIC DIALING WITH DTR AT%DN ....................................................................43 AUTOMATIC ANSWER ATS0 .......................................................................................45 INCOMING CALL BEARER +CICB................................................................................45 SINGLE NUMBERING SCHEME +CSNS ........................................................................47 GAIN CONTROL +VGR, +VGT ....................................................................................48 MICROPHONE MUTE CONTROL +CMUT......................................................................50 SPEAKER & MICROPHONE SELECTION +SPEAKER....................................................51 ECHO CANCELLATION +ECHO...................................................................................52 SIDETONE MODIFICATION +SIDET..............................................................................55 INITIALIZE VOICE PARAMETERS +VIP .........................................................................57 DIAL WITH ADDITIONAL USER INFO +DUI ....................................................................58 HANG-UP WITH ADDITIONAL USER INFO +HUI.............................................................58 RECEIVE ADDITIONAL USER INFO +RUI.......................................................................59
NETWORK SERVICE COMMANDS ...............................................................................61 SIGNAL QUALITY +CSQ .............................................................................................61 OPERATOR SELECTION +COPS .................................................................................61 NETWORK REGISTRATION+CREG ...............................................................................65 READ OPERATOR NAME +WOPN................................................................................67 PREFERRED OPERATOR LIST +CPOL .........................................................................68 SECURITY COMMANDS ................................................................................................71 ENTER PIN +CPIN.....................................................................................................71 ENTER PIN2 +CPIN2..................................................................................................74 PIN REMAINING ATTEMPT NUMBER +CPINC ...............................................................76 FACILITY LOCK +CLCK..............................................................................................77 CHANGE PASSWORD +CPWD ....................................................................................79 PHONEBOOK COMMANDS...........................................................................................81 SELECT PHONEBOOK MEMORY STORAGE +CPBS .......................................................81 READ PHONEBOOK ENTRIES +CPBR..........................................................................82 FIND PHONEBOOK ENTRIES +CPBF............................................................................83 WRITE PHONEBOOK ENTRY +CPBW...........................................................................84 PHONEBOOK PHONE SEARCH +CPBP ........................................................................87 MOVE ACTION IN PHONEBOOK +CPBN .......................................................................88 SUBSCRIBER NUMBER +CNUM ..................................................................................92 AVOID PHONEBOOK INIT +WAIP .................................................................................93 DELETE CALLS PHONEBOOK +WDCP.........................................................................94 SET VOICE MAIL NUMBER +CSVM..............................................................................95
8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 8.9 8.10
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
ix
AT commands interface
SHORT MESSAGES COMMANDS ................................................................................96 PARAMETERS DEFINITION ............................................................................................96 SELECT MESSAGE SERVICE +CSMS...........................................................................97 NEW MESSAGE ACKNOWLEDGEMENT +CNMA ...........................................................98 PREFERRED MESSAGE STORAGE +CPMS................................................................101 PREFERRED MESSAGE FORMAT +CMGF .................................................................103 SAVE SETTINGS +CSAS ..........................................................................................105 RESTORE SETTINGS +CRES ....................................................................................105 SHOW TEXT MODE PARAMETERS +CSDH .................................................................106 NEW MESSAGE INDICATION +CNMI...........................................................................106 READ MESSAGE +CMGR .........................................................................................109 LIST MESSAGE +CMGL............................................................................................111 SEND MESSAGE +CMGS..........................................................................................113 WRITE MESSAGE TO MEMORY +CMGW ...................................................................114 SEND MESSAGE FROM STORAGE +CMSS................................................................115 SET TEXT MODE PARAMETERS +CSMP ...................................................................116 DELETE MESSAGE +CMGD ......................................................................................118 SERVICE CENTER ADDRESS +CSCA .........................................................................120 SELECT CELL BROADCAST MESSAGE TYPES +CSCB ..............................................121 CELL BROADCAST MESSAGE IDENTIFIERS +WCBM .................................................122 MESSAGE STATUS MODIFICATION +WMSC ...............................................................123 MESSAGE OVERWRITING +WMGO ...........................................................................123 UNCHANGE SMS STATUS +WUSS ...........................................................................124 SUPPLEMENTARY SERVICES COMMANDS ......................................................125 CALL FORWARDING +CCFC.....................................................................................125 CALL BARRING +CLCK............................................................................................126 MODIFY SS PASSWORD +CPWD..............................................................................128 CALL WAITING +CCWA ...........................................................................................128 CALLING LINE IDENTIFICATION RESTRICTION +CLIR ..................................................130 CALLING LINE IDENTIFICATION PRESENTATION +CLIP ...............................................131 CONNECTED LINE IDENTIFICATION PRESENTATION +COLP........................................133 ADVICE OF CHARGE +CAOC ....................................................................................134 ACCUMULATED CALL METER +CACM.......................................................................135 ACCUMULATED CALL METER MAXIMUM +CAMM .......................................................136 PRICE PER UNIT AND CURRENCY TABLE +CPUC .......................................................137 CALL RELATED SUPPLEMENTARY SERVICES +CHLD.................................................138 LIST CURRENT CALLS +CLCC...................................................................................139 SUPPLEMENTARY SERVICE NOTIFICATIONS +CSSN ..................................................140 UNSTRUCTURED SUPPLEMENTARY SERVICE DATA +CUSD........................................141 CLOSED USER GROUP +CCUG.................................................................................144 DATA COMMANDS................................................................................................145 USING AT COMMANDS DURING A DATA CONNECTION .................................................145
9.1 9.2 9.3 9.4 9.5 9.6 9.7 9.8 9.9 9.10 9.11 9.12 9.13 9.14 9.15 9.16 9.17 9.18 9.19 9.20 9.21 9.22 10 10.1 10.2 10.3 10.4 10.5 10.6 10.7 10.8 10.9 10.10 10.11 10.12 10.13 10.14 10.15 10.16 11 11.1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
AT commands interface
11.2 11.3 11.4 11.5 11.6 11.7 11.8 11.9 11.10 11.11 11.12 12 12.1 12.2 12.3 12.4 12.5 12.6 12.7 13 13.1 13.2 13.3 13.4 13.5 13.6 13.7 13.8 13.9 13.10 13.11 13.12 13.13 13.14 14 14.1 14.2 14.3 14.4 14.5 14.6
BEARER TYPE SELECTION +CBST............................................................................145 SELECT MODE +FCLASS ........................................................................................148 SERVICE REPORTING CONTROL +CR ........................................................................149 CELLULAR RESULT CODES +CRC.............................................................................149 DTE-DCE LOCAL RATE REPORTING +ILRR ..............................................................150 RADIO LINK PROTOCOL PARAMETERS +CRLP ..........................................................151 OTHERS RADIO LINK PARAMETERS +DOPT ..............................................................152 SELECT DATA COMPRESSION %C .............................................................................153 V42 BIS DATA COMPRESSION +DS............................................................................154 V42 BIS DATA COMPRESSION REPORT +DR ..............................................................156 SELECT DATA ERROR CORRECTING MODE \N ............................................................157 FAX COMMANDS...................................................................................................159 TRANSMIT SPEED +FTM...........................................................................................159 RECEIVE SPEED +FRM.............................................................................................160 HDLC TRANSMIT SPEED +FTH.................................................................................161 HDLC RECEIVE SPEED +FRH...................................................................................161 STOP TRANSMISSION AND WAIT +FTS ......................................................................162 RECEIVE SILENCE +FRS ..........................................................................................163 SETTING UP THE PC FAX APPLICATION: .....................................................................164 FAX CLASS 2 COMMANDS ..................................................................................165 TRANSMIT DATA +FDT ............................................................................................165 RECEIVE DATA +FDR ..............................................................................................165 TRANSMIT PAGE PUNCTUATION +FET.......................................................................166 PAGE TRANSFER STATUS PARAMETERS +FPTS........................................................166 TERMINATE SESSION +FK........................................................................................167 PAGE TRANSFER BIT ORDER +FBOR........................................................................167 BUFFER SIZE REPORT +FBUF ..................................................................................168 COPY QUALITY CHECKING +FCQ ..............................................................................168 CAPABILITY TO RECEIVE +FCR ................................................................................169 CURRENT SESSIONS PARAMETERS +FDIS ................................................................169 DCE CAPABILITIES PARAMETERS +FDCC ................................................................172 LOCAL ID STRING +FLID..........................................................................................173 PAGE TRANSFER TIMEOUT PARAMETER +FPHCTO...................................................173 FAX CLASS 2 INDICATION MESSAGES ........................................................................174 V24-V25 COMMANDS............................................................................................176 FIXED DTE RATE +IPR.............................................................................................176 DTE-DCE CHARACTER FRAMING +ICF.....................................................................177 DTE-DCE LOCAL FLOW CONTROL +IFC ..................................................................178 SET DCD SIGNAL &C...............................................................................................180 SET DTR SIGNAL &D ...............................................................................................180 SET DSR SIGNAL &S ...............................................................................................181
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
xi
AT commands interface
14.7 14.8 14.9 14.10 14.11 14.12 14.13 14.14 14.15 14.16 14.17 15 15.1 15.2 15.3 15.4 15.5 15.6 15.7 15.8 15.9 15.10 15.11 15.12 15.13 15.14 15.15 15.16 15.17 15.18 15.19 15.20 15.21 15.22 15.23 15.24 15.25 15.26 15.27 15.28 15.29 15.30 15.31 15.32
BACK TO ONLINE MODE O ........................................................................................181 RESULT CODE SUPPRESSION Q ................................................................................182 DCE RESPONSE FORMAT V .....................................................................................182 DEFAULT CONFIGURATION Z.....................................................................................183 SAVE CONFIGURATION &W.......................................................................................183 AUTO-TESTS &T ......................................................................................................184 ECHO E ...................................................................................................................185 RESTORE FACTORY SETTINGS &F.............................................................................185 DISPLAY CONFIGURATION &V...................................................................................186 REQUEST IDENTIFICATION INFORMATION I .................................................................186 DATA / COMMANDS MULTIPLEXING +WMUX.............................................................188 SPECIFIC AT COMMANDS ...................................................................................189 CELL ENVIRONMENT DESCRIPTION +CCED...............................................................189 AUTOMATIC RXLEV INDICATION +CCED...................................................................190 GENERAL INDICATIONS +WIND ................................................................................191 DATA CIPHERING MODE BETWEEN ME AND MSC +ALEA..........................................194 DATA CIPHERING MODE +CRYPT .............................................................................194 KEY MANAGEMENT +EXPKEY .................................................................................195 INFORMATIONS ON PLMN +CPLMN.........................................................................196 ANALOG DIGITAL CONVERTERS MEASUREMENTS +ADC ............................................197 MOBILE EQUIPMENT EVENT REPORTING +CMER ......................................................198 READ LANGUAGE PREFERENCE +WLPR..................................................................199 WRITE LANGUAGE PREFERENCE +WLPW................................................................199 READ GPIO VALUE +WIOR .....................................................................................201 WRITE GPIO VALUE +WIOW ...................................................................................201 INPUT/OUTPUT MANAGEMENT +WIOM .....................................................................202 ABORT COMMAND +WAC.........................................................................................203 PLAY TONE +WTONE ..............................................................................................204 PLAY DTMF TONE +WDTMF ...................................................................................206 WAVECOM DOWNLOADING +WDWL ........................................................................208 WAVECOM VOICE RATE +WVR ................................................................................208 DATA RATE +WDR .................................................................................................210 HARDWARE VERSION +WHWV ................................................................................211 DATE OF PRODUCTION +WDOP ...............................................................................212 WAVECOM SELECT VOICE GAIN +WSVG ..................................................................213 WAVECOM STATUS REQUEST +WSTR ......................................................................214 WAVECOM SCAN +WSCAN ......................................................................................215 WAVECOM RING INDICATOR MODE +WRIM ...............................................................216 WAVECOM 32KHZ POWERDOWN MODE +W32K........................................................218 WAVECOM CHANGE DEFAULT MELODY +WCDM ......................................................219 WAVECOM SOFTWARE VERSION +WSSW.................................................................220 WAVECOM CUSTOM CHARACTER SET +WCCS .........................................................220 WAVECOM LOCK +WLCK .......................................................................................223 CPHS COMMAND +CPHS ........................................................................................224
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
xii
AT commands interface
15.33 15.34 15.35 15.36 15.37 15.38 16 16.1 16.2 16.3 17 17.1 17.2 17.3 18 18.1 18.2 18.3 18.4 18.5 18.6 18.7 18.8 18.9 18.10 18.11 18.12 18.13 19 19.1 19.2 19.3 19.4 20 21 22
WAVECOM BATTERY CHARGE MANAGEMENT +WBCM.............................................228 FEATURES MANAGEMENT +WFM .............................................................................231 COMMERCIAL FEATURES MANAGEMENT +WCFM.....................................................233 WAVECOM CUSTOMER STORAGE MIRROR +WMIR ....................................................235 WAVECOM CHANGE DEFAULT PLAYER +WCDP .......................................................235 WAVECOM CPHS MAIL BOX NUMBER +WMBN .......................................................236 SIM TOOLKIT .........................................................................................................238 OVERVIEW OF SIM APPLICATION TOOLKIT ................................................................238 EXCHANGED MESSAGES DURING A SIM TOOLKIT OPERATION. ...................................241 SIM TOOLKIT COMMANDS ...................................................................................242 OTHER AT COMMANDS .......................................................................................261 V.25 TER RECOMMANDATION ....................................................................................261 GSM 07.05 RECOMMANDATION.................................................................................261 GSM 07.07 RECOMMANDATION.................................................................................261 APPENDICES .........................................................................................................262 ME ERROR RESULT CODE : +CME ERROR: <ERROR> ..............................................262 MESSAGE SERVICE FAILURE RESULT CODE: +CMS ERROR : <ER>...........................263 SPECIFIC ERROR RESULT CODES ...............................................................................264 FAILURE CAUSE FROM GSM 04.08 RECOMMANDATION (+CEER) ..............................265 SPECIFIC FAILURE CAUSE FOR +CEER.....................................................................266 GSM 04.11 ANNEX E-2: MOBILE ORIGINATING SM-TRANSFER..................................267 UNSOLICITED RESULT CODES ....................................................................................270 FINAL RESULT CODES ...............................................................................................271 INTERMEDIATE RESULT CODES ..................................................................................272 PARAMETERS STORAGE ............................................................................................273 GSM SEQUENCES LIST..............................................................................................276 OPERATOR NAMES ....................................................................................................279 DATA / COMMANDS MULTIPLEXING PROTOCOL ...........................................................287 APPENDIX A (INFORMATIVE) ..............................................................................291 INFORMATIVE EXAMPLE ABOUT THE PIN REQUIRED ....................................................291 INFORMATIVE EXAMPLE ABOUT PHONEBOOKS ...........................................................297 INFORMATIVE EXAMPLE ABOUT SHORT MESSAGES .....................................................301 INFORMATIVE EXAMPLE ABOUT FAX CLASS 2.............................................................302 APPENDIX B: SUPPORT OF SIM TOOLKIT BY THE M.E. ..................................306 APPENDIX C: STRUCTURE OF TERMINAL PROFILE........................................308 APPENDIX D: COMMAND TYPE AND NEXT ACTION INDICATOR. ..................311
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
xiii
AT commands interface
23 24
APPENDIX E: CODING OF ALPHA FIELDS IN THE SIM FOR UCS2 .................312 APPENDIX F: SPECIFICATION OF POWER DOWN CONTROL VIA RS232 ......315
25 APPENDIX G: EXECUTION CONDITIONS AND SIM DEPENDENCE OF AT COMMANDS........................................................................................................................317 25.1 25.2 25.3 25.4 25.5 25.6 25.7 25.8 25.9 25.10 25.11 25.12 25.13 GENERAL COMMANDS ...............................................................................................317 CALL CONTROL COMMANDS ......................................................................................317 NETWORK SERVICE COMMANDS ................................................................................318 SECURITY COMMANDS ..............................................................................................318 PHONEBOOK COMMANDS ..........................................................................................319 SHORT MESSAGES COMMANDS .................................................................................319 SUPPLEMENTARY SERVICES COMMANDS ...................................................................320 DATA COMMANDS .....................................................................................................320 FAX COMMANDS........................................................................................................321 FAX CLASS 2 COMMANDS .........................................................................................321 V24-V25 COMMANDS ................................................................................................321 SPECIFIC AT COMMANDS ..........................................................................................322 SIM TOOLKIT COMMANDS .........................................................................................323
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
xiv
AT commands interface
1
1.1
Introduction
Scope of this document
This document describes the messages exchanged between an external application module and the WAVECOM GSM mobile station, based on AT commands in order to control incoming and outgoing calls. This document presents the AT-commands implemented for the voice call teleservice, the data teleservice and the short message teleservice.
1.2
Related documents
This interface specification is based on the following recommandations : [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 Recommandation V.25 ter : Serial asynchronous automatic dialling and control [4] ETSI GSM 03.40 : Digital cellular telecommunications system (phase 2) ; Technical realization 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 services specification, Formats and coding
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
15
AT commands interface
1.3
ETSI secretariat
The following addresses can be useful to get the latest GSM recommendations. F-06921 Sophia Antipolis CEDEX France 650 Route des Lucioles Sophia Antipolis Valbonne France
Fax : +33 4 93 65 47 16
1.4
Definitions
In the GSM vocabulary, a call from GSM mobile to the PSTN is named mobile originated call (MOC) or outgoing call, and a call from fixed network to a GSM mobile is called mobile terminated call (MTC) or incoming call.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
16
AT commands interface
2
2.1
AT commands features
Wavecom line settings
A serial link handler is set with these default values (factory settings) : 1 autobaud, 8 bits data, 1 bit stop, no parity, RTS/CTS flow control.
Please use the commands +IPR, +IFC, +ICF to change these settings.
2.2
Command line
The commands always start with AT (means Attention !) and finish with a <CR> character.
2.3
Responses start and end with <CR><LF>, except with the ATV0 (DCE response format) and ATQ1 (result code suppression) commands. If the syntax of the command is wrong, the string ERROR is sent. If the syntax command is correct but with some incorrect parameters, the strings +CME ERROR : <Err> or +CMS ERROR : <SmsErr> are sent with different error codes. If the command line has been performed successfully, the string OK is sent. In some cases like AT+CPIN?, AT+EXPKEY?, or incoming events (unsolicited) the module does not send back the string OK as a response. In the following examples <CR> and <CR><LF> will be intentionally omitted.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
17
AT commands interface
3
3.1
General behaviors
SIM Insertion, SIM Removal
The SIM card Insertion and Removal procedures are supported. There are software functions based on the reading of the hardware SIM presence pin. This pin state (open / closed) is continuously watched. When the SIM presence pin indicates a presence of a card in the SIM connector, the module tries to set a logical SIM session. Depending on the fact that the detected card is a SIM Card or not, the logical SIM session will be set or not. The AT+CPIN? Delivers the following answers : If SIM presence pin indicates nothing, the answer to AT+CPIN? Is +CME ERROR 10 (SIM not inserted) If SIM presence pin indicates something, and the inserted Card is a SIM Card, the answer to AT+CPIN? Is +CPIN: xxx depending on the SIM PIN state. If SIM presence pin indicates something, and the inserted Card is not a SIM Card, the answer to AT+CPIN? Is CME ERROR 10 These last two status are not immediately available due to the background initialisation. Between the hardware SIM presence pin indication of something and the previous results the AT+CPIN? Sends +CME ERROR: 515 (Please wait, init in progress) When the SIM presence pin indicates an absence, and if a SIM Card was previously inserted, an IMSI detach procedure is done, and all the user data are removed from the module (Phonebooks, SMS etc.). The module is then in emergency mode.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
18
AT commands interface
3.2
Backgroung initialisation
After the PIN entry, some SIM user data files are loaded in the module (Phonebooks, SMS status ), but it can take a long time for huge phonebooks reading. The AT+CPIN? Command answers just after verification of the PIN. User Datas are loaded after the answer in background. This means, that some datas may not be available just after the OK from the PIN Entry. The reading of phonebooks will then be refused by the following +CME ERROR: 515 or +CMS ERROR: 515 meaning please wait, service is not available, init in progress. That kind of answer may be sent by the module at several steps : When trying to execute another AT command before the end (response) of the previous one. When swapping from (or to) AND to (or from) FDN and trying to read immediately the concerned phonebook ; When asking for +CPIN? Status just after a SIM insertion when the module has not determined if the inserted card is a valid SIM Card.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
19
AT commands interface
4
4.1
4.1.1
General commands
Manufacturer identification +CGMI
Description :
This command gives the manufacturer identification.
4.1.2
Syntax :
AT+CGMI Command Possible responses WAVECOM MODEM OK
Command syntax :
AT+CGMI
4.2
4.2.1
This command is used to get the supported bands (GSM 900, DCS 1800 or PCS 1900). The answer could be a combination of different bands when multiband modules.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
20
AT commands interface
4.2.2
Syntax :
AT+CGMM Command Possible responses 900P OK
Command syntax :
AT+CGMM
Note : GSM 900 MHz primary band, or 900E (extended band), 1800 (DCS), 1900 (PCS) or MULTIBAND
4.3
4.3.1
4.3.2
Syntax :
AT+CGMR Command Possible responses 310_G250.51 806216 032199 17:04 OK
Command syntax :
AT+CGMR
Note : Software release 3.10, revision 51 generated on the 21st March 1999
4.4
4.4.1
This command allows the user application to know the IMEI (International Mobile Equipment Identity) of the GSM module.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
21
AT commands interface
4.4.2
Syntax :
AT+CGSN Command Possible responses 135790248939 OK
Command syntax :
AT+CGSN
Note : IMEI present in EEPROM +CME ERROR: 22 Note : IMEI not found in EEPROM
4.5
4.5.1
This command informs the ME on which character set is used by the TE. ME is then able to convert each character of entered or displayed string. This is used to send, read or write short messages. See also +WPCS for the phonebooks character sets.
4.5.2
Syntax :
AT+CSCS=<Character Set> Command Possible responses OK Note : Command valid OK Note : Command valid +CSCS: (GSM,PCCP437,CUSTOM,HEX) OK
Command syntax :
AT+CSCS=GSM Note : GSM default alphabet AT+CSCS=PCCP437 Note : PC character set code page 437 AT+CSCS=?
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
22
AT commands interface
4.5.3
Defined values :
<Character Set> GSM PCCP437 CUSTOM HEX GSM default alphabet. PC character set code page 437. User defined character set (cf. +WCCS command). Hexadecimal mode. No character set used ; the user read or write directly hexadecimal values.
4.6
4.6.1
This specific command informs the ME on which character set is used for the phonebooks by the TE. ME is then able to convert each character of entered or displayed string. This is used to read or write phonebooks entries. See also +CSCS for the short messages character sets.
4.6.2
Syntax :
AT+WPCS=<Character Set> Command Possible responses OK Note : Command valid OK Note : Command valid +WPCS: (TRANSPARENT,HEX,CUSTOM) OK
Command syntax :
AT+WPCS=TRANSPARENT Note : Transparent mode AT+WPCS=CUSTOM Note : Custom character set AT+WPCS=?
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
23
AT commands interface
4.6.3
Defined values :
<Character Set> TRANSPARENT Transparent mode. The strings are displayed and entered as they are stored in SIM or in ME. CUSTOM HEX User defined character set (cf. +WCCS command). Hexadecimal mode. No character set used ; the user read or write directly hexadecimal values.
4.7
4.7.1
This command is used to read and identify the IMSI (International Mobile Subscriber Identity) of the SIM card. The PIN should be entered if needed before reading the IMSI.
4.7.2
Syntax
AT+CIMI Command Possible responses 208200120320598 Note : IMSI value (15 digits), starting with MCC (3 digits) / MNC (2 digits, 3 for PCS 1900)
Command syntax :
AT+CIMI Note : Read the IMSI See appendice 18.12 for MCC / MNC description.
4.8
4.8.1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
24
AT commands interface
4.8.2
Syntax :
AT+CCID Command Possible responses +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
Command syntax :
AT+CCID Note : Get card id AT+CCID? Note : Get current value AT+CCID= ? Note : Get possible value
In case of absent EF-CCID file on the SIM, the +CCID will not be sent. But the OK will be present.
4.9
4.9.1
4.9.2
Syntax :
AT+GCAP Command Possible responses +GCAP: +CGSM +FCLASS OK
Command syntax :
AT+GCAP
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
25
AT commands interface
4.10
4.10.1
Only A/ command can not be repeated. This command repeats the previous executed command.
4.10.2
Syntax :
A/ Command Possible responses
Command syntax :
4.11
4.11.1
This specific command stops the GSM software stack as well as the hardware layer. The AT+CFUN=0 command is equivalent to +CPOF
4.11.2
Syntax :
AT+CPOF Command Possible responses OK Note : Command valid
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
26
AT commands interface
4.12
4.12.1
This command selects the level of functionality in the mobile station. When the application wants to stop the module to power off, or if the application wants to force the module to execute a IMSI DETACH procedure, then it has to send : AT+CFUN=0 (same as AT+CPOF) This command executes a IMSI DETACH and makes a backup of some internal parameters in the SIM and the EEPROM. Then no access to the SIM card is possible. If the mobile is not powered off after this command, it shall receive another command to re-start the whole GSM process. If the mobile is turned off after this command, then the power on will automatically execute the start of the whole GSM process. When the application wants to re-start the module (after having done a AT+CFUN=0 command, and without having cut the power supply), it has to send : AT+CFUN=1 This command starts again all the GSM stack and GSM functionality, a complete software reset is done. All parameters are reset to their previous E2P value if AT&W was not used. If you write entries in phonebook (+CPBW) and then reset the module directly (AT+CFUN=1, without any AT+CFUN=0 before), some entries may not be written (SIM task does not have the time to write entries in SIM card) Also, the OK response will be sent at the last defined baud rate defined by +IPR command. With autobauding the response can be at a different baud rate, so it is better to save the defined baud rate with AT&W before directly send the AT+CFUN=1 command.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
27
AT commands interface
4.12.2
Syntax :
AT+CFUN=<functionality level> Command Possible responses +CFUN: 1 OK Note : Full functionality
Command syntax :
AT+CFUN=0 Note : Set minimum functionality, IMSI detach procedure AT+CFUN=1 Note : Set the full functionality mode with a complete software reset
4.13
4.13.1
4.13.2
Syntax :
AT+CPAS Command Possible responses +CPAS : <pas> OK
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
28
AT commands interface
4.13.3
Defined values :
<pas> 0 1 1 1 1 1 ready (allow commands from TA/TE) unavailable (does not allow cmds) unknown ringing (ringer is active) call in progress asleep (low functionality)
4.14
4.14.1
This command disables or enables the use of result code +CME ERROR : <xxx> or +CMS ERROR :<xxx> instead of simply ERROR. See appendice 18.1 for +CME ERROR result codes description and appendice 18.2 for +CMS ERROR result codes.
4.14.2
Syntax :
AT+CMEE=<error reporting flag> Command Possible responses OK
Command syntax :
AT+CMEE=0 Note : Disable ME error reports, use only ERROR AT+CMEE=1 Note : Enable +CME ERROR: <xxx> Or +CMS ERROR: <xxx>
OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
29
AT commands interface
4.15
4.15.1
Execution command emulates ME keypad by giving each keystroke as a character in a string <keys>. The supported GSM sequences are listed in appendice 18.11. If emulating fails in an ME error, +CME ERROR: <err> is returned. If emulating succeeds, the result depends on the GSM sequence.<keys>: string of following characters (0-9,*,#).
4.15.2
Syntax :
AT+CKPD=<keys> Command Possible responses +CCFC: 0,7
Command syntax :
AT+CKPD=*#21# Note : Check every call forwarding status AT+CKPD=1234 Note : Sequence not allowed
+CME ERROR 3
4.16
4.16.1
This command is used to set or get the current date and time of the ME real-time clock. String format of date/time is : yy/MM/dd,hh:mm:ss. Valid years are 98 (for 1998) to 97 (for 2097). Seconds field is not mandatory. Default date/time is 98/01/01,00:00:00 (January 1st, 1998 / midnight).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
30
AT commands interface
4.16.2
Syntax :
AT+CCLK=<date and time string> Command Possible responses OK Note : Date/Time stored +CME ERROR 3
Command syntax :
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 : Bad month is entered AT+CCLK? Note : get current date and time
+CCLK: 00/06/09,17:34:23 Note : current date is June 9th, 2000 current time is 5:34:23 pm
4.17
4.17.1
This command is used to set alarms date/time in the ME. String format of alarm : yy/MM/dd,hh:mm:ss (refer +CCLK). Maximum number of alarms is 16. Seconds are not taken into account.
4.17.2
Syntax :
AT+CALA=<date and time string> AT+CALA=,<index> Command (delete alarm) Possible responses OK Note : Alarm stored +CME ERROR 3 (set alarm)
Command syntax :
AT+CALA=00/06/09,07:30 Note : set an alarm for June 9th, 2000 at 7:30 am AT+CALA=99/03/05,13:00:00
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
31
AT commands interface
Note : Invalid alarm (date/time expired) +CALA : 00/06/08,15 :25 :00,0 +CALA : 00/06/09,07 :30 :00,1 +CALA : 00/06/10,23 :59 :00,2 Note : three alarms are set (index 0, 1, 2) +CALA: 00/06/08,15:25:00,0 Note : an alarm occurs (index 0)
AT+CALA=,2 Note : delete alarm index 2 AT+CALA? Note : list all alarms again
OK Note : Alarm index 2 deleted +CALA: 00/06/09,07:30:00,1 Note : Only one alarm (index 1)
4.18
4.18.1
This command plays a melody on the modems buzzer. There are two types of melodies available : incoming voice, data or fax call melodies, and incoming short message sounds. For incoming voice, data or fax call melodies, 10 manufacturer-defined ones can be playback (in loop). For incoming short message sounds, 2 manufacturer-defined ones can be playback (one time). Melody #1 : short beep / Melody #2 : long beep. Note : loop melodies (for voice/data/fax call) must be stopped by +CRMP command with <index> field set to 0 (example: +CRMP=0,,,0). When <volume> parameter is given, this overwrites <sound level> value of +CRSL command. If <volume> parameter is not given, <sound level> value of +CRSL is used as default value.
4.18.2
Syntax :
AT+CRMP=<call type>[,<volume>,<type>,<index>]
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
32
AT commands interface
Command AT+CRMP=0,7,0,2 Note : Play voice call melody index 2 with volume level 7. AT+CRMP=0,,,0 Note : Stop the melody. AT+CRMP=? Note : supported parameters OK
Possible responses
4.18.3
Defined values :
<call type> 0 1 1 1 <volume> 0 1 1 <type> <index> 0 0 Max volume Manufacturer Defined (default) Stop Melody Playback Melody ID for voice/data/fax call type (default : 1) Melody ID for short message (default : 1) Default volume Incoming voice call Incoming data call Incoming fax call Incoming short message (SMS) Min volume
1.. . . . . . 1.. . . . . .
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
33
AT commands interface
4.19
4.19.1
This command allows to set/get the sound level.of the incoming call ringer. Set command change <volume> default value of +CRMP command.
4.19.2
Syntax :
AT+CRSL=<sound level> Command Possible responses OK Note : Current ring playing with Min. volume. OK Note : Current ring playing with Max. volume. +CRSL: 15 OK
Command syntax :
AT+CRSL=0 Note : Set volume to Min. AT+CRSL=15 Note : Set volume to Max. AT+CRSL?
Note : get current ringer sound level AT+CRSL=? Note : supported parameters
4.19.3
Defined values :
<sound level> 0 Min volume
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
34
AT commands interface
5
5.1
5.1.1
The ATD command is used to set a speech, data or fax call. According to GSM 02.30, dial command also controls supplementary services. For a data or fax call, the application sends to the GSM module the following ASCII string : (the bearer has to be previously selected with the +CBST command) ATD<nb> where <nb> is the called phone number. For a voice call, the application sends to the GSM module the following ASCII string : (the bearer may be previously selected, if not a default bearer is used) ATD<nb>; where <nb> is the called phone number. Please, notice that in case of international number, the local international prefix has not to be set (usually 00) but need to be replaced by the + character. Example : to establish a voice call to Wavecom from another country, the AT command shall be : ATD+33146290800; Notice that some country may have specific numbering rules for their GSM handset numbering.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
35
AT commands interface
The answer to the ATD command can be one of the following: Verbose result code Numeric (V0 set) OK CONNECT <speed> 0 Description if the call succeeds, for voice call only
10,11,12,13,14,15 successful if the call succeeds, for data calls only, <speed> takes the value negotiated by the GSM module. 7 8 3 If the called party is already in communication If no hang up is detected after a fixed network timeout Call setup failed or remote user release. Use the AT+CEER command to know the failure cause
See paragraph 0 for the description of all numeric result codes (ATV0) Direct dialling from a phonebook location (stored in SIM card) can be done with the following commands : ATD><index>; ATD>BILL; ATD>mem<index>; for calling <index> from the selected phonebook (by +CPBS command). for calling BILL from the selected phonebook. Not allowed with RC, MC, LD, EN and SN phonebooks. (mem represents a phonebook, see +CPBS command) is a way to dial directly from a phonebook number. Not allowed with ON phonebook. for calling BILL from the mem phonebook. Not allowed with RC, MC, LD, EN and SN phonebooks.
ATD>memBILL;
5.1.2
Syntax :
ATD<nb>[<I>][;] ATD>[<mem>]<index>[<I>][;] ATD>[<mem>]<name>[<I>][;]
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
36
AT commands interface
Possible responses +CPBS:SM,8,10 Note : SUCCESSFUL phonebook is selected, 8 locations are used and 10 locations are available OK Note : Call succeeds
When FDN phonebook has been locked only the numbers beginning with the digits of FDN phonebook entries can be called. For example, if 014629 is written in the FDN phonebook all the phone numbers beginning with these 6 digits can be called. It is allowed to override the CLIR supplementary service subscription for this call only. I means invocation (restrict CLI presentation) i means suppression (allow CLI presentation). Its allowed to control the CUG supplementary service information by G or g for this call only. The index and info values set with command +CCUG are used. An outgoing call attempt could be refused if the AOC service is active and the credit is expired (NO CARRIER) When trying to set an outgoing call while there is an active call, the active call is first put on hold, then the call setup is made. According to GSM 02.30, GSM sequences may be controlled using dial command. These sequences can contain *, #. But ; is forbidden. If the sequence is not supported or fails, it is considered as a phone number, and a new communication is started. See paragraph 18.11 to have the list of supported sequences.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
37
AT commands interface
Command ATD*#21# Note : Check any call forwarding status ATD**61*+33146290800**25# +CCFC: 0,7
Possible responses
Note : Register call forwarding on no reply, with no Note : done reply timer fixed at 25 s. ATD*2# Note : Bad sequence +CME ERROR 3
5.2
5.2.1
Hang-Up command H
Description :
The command ATH (or ATH0) is used by the application to disconnect the remote user. In case of multiple calls, every calls are released (active, held and waiting calls). The specific Wavecom command ATH1 has been appended to disconnect only the outgoing call. It can be useful in case of multi communication.
5.2.2
Syntax :
ATH Command Possible responses OK Note : Every calls, if any, are released OK Note : Outgoing call, if any, is released
Command syntax :
ATH Note : Ask for disconnection ATH1 Note : Ask for outgoing call disconnection
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
38
AT commands interface
5.3
5.3.1
Answer a call A
Description :
When the GSM module receives a call, it sets the RingInd signal and sends to the application the ASCII string RING or +CRING: <type> if cellular result code (+CRC) is enabled. Then it waits for the application to accept the call.
5.3.2
Syntax :
ATA Command RING Note : Incoming call Possible responses
Command syntax :
ATA Note : Answer to this incoming call ATH Note : Disconnect call
5.4
Remote disconnection
This message is used by the GSM module to indicate to the application that an active call has been released by the remote user. The GSM module sends NO CARRIER to the application, and set the DCD signal. Also, in AOC case, the module can stop the communication if the credit is over (release cause 68 with +CEER command)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
39
AT commands interface
5.5
5.5.1
This command gives the reason of the call release when the last call setup (originating or answering) failed.
5.5.2
Syntax :
AT+CEER Command Possible responses NO CARRIER Note : Call setup failure +CEER : Error <xxx> OK
Command syntax :
Note : <xxx>is the cause information element values form GSM recommandation 04.08 or specific Call accepted
The cause information element from GSM 04.08 is given below in chapter 18.4, or in chapter 18.5 for specific failure causes. The NO CARRIER indicates that the AT+CEER information is available for a failure diagnostic.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
40
AT commands interface
5.6
5.6.1
The GSM module offers the user application to send DTMF tones on the GSM network. This command is used to define the length of the tones (default value is 300 ms). To define this length, the application uses : AT+VTD=<n> where <n>*100 gives the duration in ms. If n < 4 the tone duration is 300 ms.
5.6.2
+VTD Syntax :
AT+VTD=<n> Command Possible responses OK Note : Command valid OK
Command syntax :
AT+VTD=6 Note : To define 600 ms tone length AT+VTD=0 Note : To set the manufacturer default value
5.6.3
+VTS Description :
The GSM module offers the user application to send DTMF tones on the GSM network. This command allows the transmission of the tones. To transmit DTMF tones (only when an active call exists), the application uses : AT+VTS=<Tone> where <Tone> is in {0-9,*,#,A,B,C,D}
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
41
AT commands interface
5.6.4
+VTS Syntax :
AT+VTS=<Tone> Command Possible responses OK Note : Command valid
Command syntax :
AT+VTS=A
+CME ERROR: 4 Note : If the <Tone> is wrong +CME ERROR: 3 Note : If there is no communication
5.6.5
Informative example :
To send the Tone sequence 13#, the application shall send : AT+VTS=1;+VTS=3;+VTS=# OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
42
AT commands interface
5.7
5.7.1
This command is used by the application to redial the last number used in the ATD command. The last dialled number is displayed followed by ; for speech calls only
5.7.2
Syntax :
ATDL Command Possible responses 0146290800; OK Note : Last call was a speech call. Command valid
Command syntax :
5.8
5.8.1
the automatic dialing of the phone number stored in the first location of AND phonebook the automatic sending of the short message (SMS) stored in the first location of the SIM. The number is dialed on DTR OFF to ON transition. The short message is sent on DTR OFF to ON transition.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
43
AT commands interface
5.8.2
Syntax :
AT%D<n>[ ;] Command Possible responses OK Note : Command has been executed
Command syntax :
AT%D1; Note : Activates DTR number dialing DTR is OFF DTR switches ON Note : The number in the first location of the SUCCESSFUL is dialed automatically DTR switches OFF Note : The module goes on-hook AT%D2 Note : Activates DTR sort message sending
5.8.3
Defined values :
<n> (0-2) : for activate or deactivate the automatic message sending or number dialing. Informs the module that the number is a voice rather than a fax or data number. Deactivates automatic DTR number dialing / message sending Activates automatic DTR dialing if DTR switches from OFF to ON; Dials the phone number in the first location of SUCCESSFUL phonebook. Speech call. Activates automatic DTR dialing if DTR switches from OFF to ON; Dials the phone number in the first location of SUCCESSFUL phonebook. Data or Fax call.
AT%D0 AT%D1;
AT%D1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
44
AT commands interface
AT%D2
5.9
5.9.1
This S0-parameter determines and controls the automatic answering feature of the mobile.
5.9.2
Syntax :
ATS0=<value> Command Possible responses OK
Command syntax :
002 OK
5.10
5.10.1
This specific command is used for incoming call type when no incoming bearer is given (single numbering scheme, see +CSNS). Note: set command +CICB affects +CSNS current value.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
45
AT commands interface
5.10.2
Syntax :
AT+CICB=<mode> Command Possible responses OK Note : Command accepted OK Note : Command accepted +CICB: 2 Note : Default incoming bearer: speech call +CICB: (0-2) Note : Speech, data or fax default incoming bearer
Command syntax :
AT+CICB=1 Note : If no incoming bearer, force a fax call AT+CICB=2 Note : If no incoming bearer, force a speech call AT+CICB? Note : Interrogate value AT+CICB=? Note : Test command
5.10.3
Defined values :
<mode> 0 : Data 1 : Fax 2 : Speech
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
46
AT commands interface
5.11
5.11.1
This command selects the bearer to be used when MT single numbering scheme call is established (Incoming Call Bearer, see +CICB). Note: set command +CSNS affects +CICB current value.
5.11.2
Syntax :
AT+CSNS Command Possible responses OK Note : Command accepted OK Note : Command accepted +CSNS: 0 Note : Default incoming bearer: voice call +CSNS: (0,2,4) Note : Voice, data or fax default incoming bearer
Command syntax :
AT+CSNS=2 Note : force a fax call AT+CSNS=0 Note : force a voice call AT+CSNS? Note : Interrogate value AT+CSNS=? Note : Test command
5.11.3
Defined values :
<mode> 1 0 : Voice 2 : Fax : Data
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
47
AT commands interface
5.12
5.12.1
This command shall be used by the application to tune the receive gain of the speaker and transmit gain of the microphone. The application shall send : AT+VGR=<val> for the receive gain +6 db +4 db +2 db +0 db -2 db -4 db -6 db -8 db -10 db -12 db -14 db -16 db -18 db -20 db -22 db -24 db AT+VGT=<val>
Controller 1
0 to 15 16 to 31 32 to 47 48 to 63 64 to 79 80 to 95 96 to 111 112 to 127 128 to 143 144 to 159 160 to 175 176 to 191 192 to 207 208 to 223 224 to 239 240 to 255
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
48
AT commands interface
5.12.2
Syntax :
AT+VGR=<Rgain> AT+VGT=<Tgain> Command Possible responses OK Note : Command valid
Command syntax :
AT+VGR=25
AT+VGT=45
AT+VGR? Note : Interrogate value AT+VGR=? Note : Test command AT+VGT? Note : Interrogate value AT+VGT=? Note : Test command
+VGR: 64 Note : Default receive gain +VGR : (0-255) Note : Possibles values +VGT: 64 Note : Default transmit gain.l +VGT : (0-255) Note : Possibles values
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
49
AT commands interface
5.13
5.13.1
This command orders the module to set the microphone mute or not for the active microphone (defined with+SPEAKER command). This command is only allowed during a call.
5.13.2
Syntax :
AT+CMUT=<mode> Command Possible responses +CMUT : (0,1) OK
Command syntax :
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)
Note : Mute is active (call active) +CME ERROR:3 Note : Command not valid
5.13.3
Defined values :
<mode> 0 : microphone mute off (default value).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
50
AT commands interface
5.14
5.14.1
This specific command is used to choose the speaker and the microphone.
5.14.2
Syntax :
AT+SPEAKER=<ActiveSpkMic> Command Possible responses OK Note : Command valid +SPEAKER: 0 OK Note : Speaker ONE and Micro ONE are active
Command syntax :
5.14.3
Defined values :
<mode> 0 : SPEAKER ONE, MICRO ONE 1 : SPEAKER TWO, MICRO TWO
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
51
AT commands interface
5.15
5.15.1
This specific command is used to activate, deactivate or configure the Echo Cancellation functions (for voice calls, in small rooms, cars) It is necessary to tune the Microphone gain (AT+VGT) and the Speaker gain (AT+VGR) before activating the Echo Cancellation.
5.15.2
Syntax :
AT+ECHO= <mode> [,<AlgoId>, <Param1>,<Param2>, <Param3>,<Param4>,<Param5>,<Param6>]
Command syntax :
Possible responses
AT+SIDET=0 Note: Deactivate the Sidetone AT+SIDET? AT+ECHO? Note : Read current settings AT+ECHO=1,1,0,3,10,7 Note : Active Echo cancellation 1 for Mic/Speak one.
OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
52
AT commands interface
AT+ECHO? Note : Read current settings AT+ECHO=1,3,30,8000,256 Note : Activate the Echo cancellation 3 AT+ECHO? Note : Read the Echo cancellation settings AT+CFUN=1 Note: Reset the module AT+ECHO? Note : Read current settings AT+ECHO=0 Note: Deactivate the Echo Cancellation
+ECHO: 1,1,0,3,10,7 OK +CME ERROR: 519 Note : The new algo will be activated after a reset the module +ECHO: 3,3,30,8000,256 OK OK
+ECHO: 1,3,30,8000,256 OK OK
5.15.3
Defined values:
<mode> 0 : Deactivate Echo 1 : Activate Echo <AlgoId> 1 : Echo cancellation 1 3 : Echo cancellation 3 (optional)
Echo cancellation 1 (4 parameters) : The parameter <Volout> specifies the maximum attenuation of the switch <Volout> 0 : 31 db (default) 1 : 29 db 2 : 27 db 3 : 25 db ..: 14: 3 db 15: 1 db
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
53
AT commands interface
The parameter <Step> specifies the attenuation step between attenuation and no attenuation. <Step> 0: 1: 2: 3: 1 db 2 db 3 db 4 db (default)
The parameter <PcmThRel> specifies the relative threshold between max and min energy information. The allowed range is [ 0 ; 31 ]. (10 default) The parameter <PcmThMax > specifies threshold of max energy information. The allowed range is [ 0 ; 31 ]. (7 default)
Echo Cancellation 3 (3 parameters) : <AlgoParam> high value leads to high echo attenuation but the fullduplex quality will be less efficient. The allowed range is [ 0 ; 63 ]. (30 default)
<NoiseThres>
indicate the noise threshold. Low value leads to high noise attenuation. The threshold 32767 indicates no noise attenuation The allowed range is [0 ;32767]. (8000 default)
<NmbTaps>
indicate the Number of Taps of the Adaptive Filter The allowed range is [64 ;256]. (256 default) -64 taps is for short Echo -256 taps is for long Echo.
Read Command:
AT+ECHO?
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
54
AT commands interface
Returns:+ECHO: <Status>,<AlgoId>, <Param1>,<Param2>, <Param3>, <Param4>, <Param5>,<Param6> The number of parameters displayed depend on algo used. For Echo cancellation 1 4 parameters are displayed, 3 parameters are displayed for Echo cancellation 3. <Status> 0 1 2 3 Echo Deactivated. Echo Activated for Mic/Speak one. Echo Activated for Mic/Speak two. Reset the module.
PS: You can activate/ deactivate the echo cancellation during a call without resetting the module if you dont change the AlgoId.
5.16
5.16.1
This specific command is used to get an echo of the voice in the speaker (to have a microphone feedback in the speaker)
5.16.2
Syntax :
AT+SIDET=<val1>,<val2>
Command syntax :
Command AT+SIDET=1,0 OK
Possible responses
Note : Command valid AT+SIDET? Note : Current value +SIDET: 1,0 OK Note : Command valid
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
55
AT commands interface
5.16.3
Defined values :
<val1> <val2> 0: SideTone is disabled 1: SideTone is enabled 0: 0 db 1: - 6 db 2: - 12 db 3: - 18 db
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
56
AT commands interface
5.17
5.17.1
This command allows to restore the factory settings about the voice parameters from EEPROM. These voice parameters include : Gain control (+VGR & +VGT commands), Microphone mute control (+CMUT command), Speaker & Microphone selection (+SPEAKER command), Echo cancellation (+ECHO command), Side tone modification (+SIDET command).
5.17.2
Syntax :
AT+VIP=<n> Return
Command syntax :
Command
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
57
AT commands interface
5.18
5.18.1
This specific command allows to setup a MO call, with sending of additional User Info.
5.18.2
Syntax
AT+DUI=<da>,<length>,<pd><CR> > <UserInfo> <Ctrl-Z> Command Possible responses
OK Communication is established, User Info string has been sent
Command Syntax :
AT+DUI=+33123456789,10,1<CR> >1234567890<Ctrl-Z>
Setup a call with additional info string
AT+DUI=?
Test command
OK
5.18.3
<da>
Defined Values
Destination address (Tel number) : cf ATD command. Length of the following additional User Info (max. 33). Protocol Discriminator (allowed range from 0 to 255). Ascii string for additional User Info.
5.19
5.19.1
This specific command allows to hang up a call, with sending of additional User Info.
5.19.2
Syntax
AT+HUI=<length>,<pd><CR> > <UserInfo> <Ctrl-Z>
Command Syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
58
AT commands interface
Possible responses
Communication is released, User Info string has been sent
AT+HUI=?
Test command
OK
5.19.3
Defined Values
Length of the following additional User Info (max. 33). Protocol Discriminator (allowed range from 0 to 255). Ascii string for additional User Info.
5.20
5.20.1
This specific command allows to display the +RUI unsolicited response, when the module receive a MT call setup indication with additional User Info, or when a call is released by the remote party with additional User Info.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
59
AT commands interface
5.20.2
Syntax
AT+RUI=<mode> +RUI: <UserInfo> Possible responses OK +RUI: 0 OK OK +RUI: ABCDEFG RING
An incoming call occurs, with additional User Info string
Command AT+RUI=?
Test Command
AT+RUI? AT+RUI=1
Enable the +RUI unsolicited response
5.20.3
Defined Values
0 1 disable the +RUI unsolicited response (default) enable the +RUI unsolicited response. Ascii string for additional User Info.
<mode> <UserInfo>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
60
AT commands interface
6
6.1
6.1.1
This command is used to know the received signal strength indication (<rssi>) and the channel bit error rate (<ber>) with or without any SIM card inserted.
6.1.2
Syntax :
AT+CSQ Command Possible responses +CSQ: <rssi>,<ber> OK Note : <rssi> and <ber> as defined below
Command syntax :
AT+CSQ
6.1.3
Defined values :
<rssi> : 0 1 2..30 31 99 : -113 dBm or less : -111 dBm : -109 to 53 dBm : -51dBm or greater : not known or not detectable
<ber> :
07 : as RXQUAL values in the table GSM 05.08 99 : not known or not detectable
6.2
6.2.1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
61
AT commands interface
The mobile enters the manual mode, and then tries to find an operator which is indicated by the application. If it finds and registers correctly, then the mobile stays in idle mode.
2- The mobile enters the automatic mode, and then tries to find the home operator. If it finds and registers correctly, then the mobile stays in idle mode ; if not, the mobile searches automatically another network. 3- The mobile enters the manual/automatic mode, and then tries to find an operator which is indicated by the application (like in manual mode) . If this attempt fails the automatic mode is entered. If this attempt is successful, the operator indicated by the application is selected and registered, then the mobile enters the automatic mode. Read command returns the current mode and the currently selected operator. If no operator is selected, <format> and <oper> are omitted. Just notice that in manual mode, this PLMN could not be the one the mobile has to register (searching phase).
6.2.2
Syntax :
To force an attempt to select and register a network operator, the application must send the following command : Command syntax : AT+COPS=<mode>[,<format>][,<oper>]
Possible responses for AT+COPS=<mode>[,<format>][,<oper>] : OK +CME ERROR: 30 +CME ERROR: 32 +CME ERROR: 3 +CME ERROR: 4 +CME ERROR: 527 +CME ERROR: 528 +CME ERROR: 529 Response syntax for AT+COPS? : +COPS : <mode> [, <format>, <oper> ] Response syntax for AT+COPS=? : +COPS: [list of supported (<stat>, long alphanumeric <oper>, short alphanumeric <oper>s, numeric <oper>) s] (Wrong parameters) (Please wait, and retry your selection later) (Location update failure emergency calls only) (Selection failure emergency calls only) (Network is selected in full service) (No network service), (Network not allowed emergency calls only)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
62
AT commands interface
If an incomming call occur during an ask plmn list, the operation is aborted (+CME ERROR: 520) and the unsolicited RING appears.
Possible responses +COPS: 0,2,20801 OK Note : Home PLMN is France Telecom Itinris
AT+COPS=?
Note : Ask for PLMN list AT+COPS=1,2,20810 Note : Ask for registration on SFR network AT+COPS=1,1,23433 Note : Ask for registration on UK Orange network AT+COPS=0 Note : Ask for registration on home network AT+COPS=3,0 Note : Set <format> to long alphanumeric AT+COPS?
Note : Home PLMN is France Telecom SFR network has 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
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
63
AT commands interface
AT+COPS=2 Note : Ask for deregistration from network AT+COPS? Note : Ask for current PLMN
6.2.3
Defined values :
The parameters values are the following ones: <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 of <oper> field <format> 0: long format alphanumeric <oper> 1: short format alphanumeric <oper> 2: numeric <oper> (default value)
<oper>: operator identifier (MCC/MNC in numeric format only for operator selection)., Long alphanumeric format can be up to 16 characters long (see appendice 18.12 for operator names description, field is Name) Short alphanumeric format can be up to 8 characters long.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
64
AT commands interface
6.3
6.3.1
Network registration+CREG
Description
This command is used by the application to know the registration status of the mobile.
6.3.2
Syntax :
AT+CREG= <mode> +CREG : <mode>, <stat> [ ,<lac>,<ci> ] for AT+CREG ? Command only Command Possible responses +CREG: <mode>,<stat> OK Note : As defined before
AT+CREG?
AT+CREG=0 Note : Disable network registration unsollicited result code AT+CREG=1 Note : Enable network registration unsollicited result code AT+CREG=2 Note : Enable network registration and location information unsollicited result code AT+CREG=?
OK Note : Command valid OK Note : Command valid OK Note : Command valid +CREG: (0-2) Note : 0,1,2 <mode> values are supported
6.3.3
Defined values :
<mode> 0: Disable network registration unsolicited result code (default)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
65
AT commands interface
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 the network cell. <stat> 0 : not registered, ME is not currently searching a new operator 1 : registered, home network 2 : not registered, ME currently searching 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
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
66
AT commands interface
6.4
6.4.1
This specific command returns the operator name in alphanumeric format when given the numeric format.
6.4.2
Syntax :
AT+WOPN=<format>,<NumOper> +WOPN: <format>,<AlphaOper> Command Possible responses OK
AT+WOPN=? Note : Test command AT+WOPN=0,20801 Note : Give an operator in numeric format
6.4.3
Defined values :
<format> is the required format. Only long (0) and short (1) alphanumeric formats are supported. <NumOper> is the operator in numeric format. <AlphaOper> is the operator in long or short alphanumeric format (see appendice 18.12 for operator names description)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
67
AT commands interface
6.5
6.5.1
6.5.2
6.5.2 Syntax :
AT+CPOL= [ <index> ][ , <format> [ , <oper> ] ]
Command syntax :
The different possibilities are: - AT+CPOL = <index> - AT+CPOL = , <format> to command (AT+CPOL?). 1 - AT+CPOL = set to delete an entry. the format used by the read
AT+CPOL = , <format>, <oper> to put <oper> in the next free location. <index> , <format> , <oper> to write <oper> in the <format> at the <index> .
The supported format are those of the +COPS command. The length of this list is limited to 8 entries . Command AT+CPOL? Possible responses +CPOL:1,2,26201 +CPOL: 6,2,20810 OK Note : Ask for preferred list of networks AT+CPOL=,0 Note : Select long alphanumeric format AT+CPOL? +CPOL: 1,0,D1-TELEKOM +CPOL: 6,0,F SFR OK Note : Give a wrong operator Note : Preferred list of networks in long alphanumeric format Note : Preferred list of networks in numeric format OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
68
AT commands interface
OK
Note : Give a wrong operator AT+CPOL=7 Note : Delete 7th location AT+CPOL?
Note : Ask for preferred list of networks AT+CPOL=8,2,77777 Note : Add an inexistent network to the list AT+CPOL?
Note : Preferred list of networks in long alphanumeric format but 8th entry is unknown so the module edits it in the numeric format
AT+CPOL=9,0,F Itinris Note : Add an inexistent network to the list format text
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
69
AT commands interface
AT+CPOL?
+CPOL: 1,0,D1-TELEKOM +CPOL: 6,0,F SFR +CPOL: 8,2,77777 +CPOL: 9,0,F Itinrtis OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
70
AT commands interface
7
7.1
7.1.1
Security commands
Enter PIN +CPIN
Description :
This command is used to enter ME passwords (CHV1 / CHV2 / PUK1 / PUK2) which are needed before the use of any other ME functionality. The CHV1/CHV2 length is between 4 and 8 digits, the PUK1/PUK2 length is 8 digits only. If the user application tries to set an outgoing call before having validated the SIM PIN code (CHV1), then the GSM module will refuse the ATD command with a +CME ERROR: 11 (SIM PIN required). Its up to the application to validate the PIN after each reset or power on if the PIN was enabled
7.1.2
Syntax :
AT+CPIN=<pin> Command Possible responses OK Note : PIN code is correct +CME ERROR : 3 Note : Operation not allowed, PIN previously entered
Command syntax :
After 3 unsuccessful codes, the PUK will then be required. The PUK validation forces the user to enter as a second parameter a new PIN code which will be the new PIN code if the PUK validation succeeds. The CHV1 is then enabled if the PUK1 is correct. The application shall therefore use the command : AT+CPIN=<Puk>,<NewPin> Command Possible responses
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
71
AT commands interface
AT+CPIN=00000000,1234 Note : Enter PUK and new PIN AT+CPIN=12345678,1234 Note : Enter PUK and new PIN, 2nd attempt
+CME ERROR: 16 Note : Incorrect PUK OK Note : PUK correct, new PIN stored
To know which code has to be entered (or not), the following interrogation command can be used : AT+CPIN? The possible responses are : +CPIN: READY +CPIN: SIM PIN +CPIN: SIM PUK +CPIN: SIM PIN2 +CPIN: SIM PUK2 +CPIN: PH-SIM PIN +CPIN: PH-NET PIN +CME ERROR: <err>
ME is not pending for any password CHV1 is required PUK1 is required CHV2 is required PUK2 is required SIM lock (phone-to-SIM) is required Network personnalisation is required SIM failure (13) absent (10) etc
Please note that in this case the mobile does not finish its response with the OK string. The response +CME ERROR : 13 (SIM failure) is returned after 10 unsuccessful PUK presentations. The SIM card is then out of order and shall be replaced by a new one. Example : 3 failed PIN validations + 1 successful PUK validation AT+CPIN? +CPIN: SIM PIN AT+CPIN=1235 +CME ERROR: 16
Read the PIN status The GSM module requires SIM PIN First attempt to enter a SIM PIN Bad PIN
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
72
AT commands interface
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
Second attempt Bad PIN Third attempt Bad PIN Read PIN state The GSM module requires PUK The PUK is entered, the new PIN shall be 5678 PUK validation is OK. New Pin is 5678
If the user tries to do something which requires PIN2 (CHV2) the GSM module will refuse his action with a +CME ERROR: 17 (SIM PIN2 required). Then the GSM module is waiting SIM PIN2 to be given. Of course if SIM PIN2 is blocked , SIM PUK2 is required instead of SIM PIN2. For instance, the GSM module needs PIN2 to write in the fixed dialling phonebook (FDN) , so if SIM PIN2 authentification has not been done during the current cession the SIM PIN2 is required: Command AT+CPBS=FD Note : Choose FDN AT+CPBW=5,01290917,129,Jacky Note : Write in FDN at location 5 AT+CPIN? +CME ERROR: 17 Note : SIM PIN2 is required SIM PIN2 Note : SIM PIN2 is required AT+CPIN=5678 OK OK Possible responses
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
73
AT commands interface
Note : Enter SIM PIN2 AT+CPBW=2,01290917,129,Jacky Note : Write in FDN at location 5 OK Note : Now writing in FDN is allowed
Please note that the GSM module only ask once PIN2 or PUK2, so if they arent entered correctly, the next +CPIN? Command will return +CPIN: READY. Remark In the way Application to GSM, an h character shall be added before the PIN value if cyphering mode (with D.E.S algorithm ) is on. See +EXPKEY command. Same remark for +CLCK and +CPWD commands.
7.2
7.2.1
Enter PIN2
Description :
+CPIN2
This specific command is used to validate the PIN2 code (CHV2), or to validate the PUK2 code (UNBLOCK CHV2) and to define a new PIN2 code. Of course +CPIN command allows to validate PIN2 or PUK2 codes but only when the last executed command resulted in PIN2 authentification failure. The PIN2 length is between 4 and 8 digits, the PUK2 length is 8 digits only.
7.2.2
Syntax :
Command syntax : Command AT+CPIN2=<pin2> Possible responses OK Note : PIN2 code is correct +CME ERROR: 3 Note : Operation not allowed, PIN2 previously entered
After 3 unsuccessful codes, the PUK2 will then be required. The PUK2 validation forces the user to enter as a second parameter a new PIN2 code which will be the new PIN2 code if the PUK1 validation succeeds. The application shall therefore use the command :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
74
AT commands interface
AT+CPIN2=<puk2>,<NewPin2> Command AT+CPIN2=00000000,1234 Note : Enter PUK2 and new PIN2 AT+CPIN2=12345678,1234 Note : Enter PUK2 and new PIN2, 2nd attempt Possible responses +CME ERROR: 16 Note : Incorrect Password (PUK2) OK Note : PUK2 correct, new PIN2 stored
To know which code has to be entered (or not), the following interrogation command can be used : AT+CPIN2? The possible responses are : +CPIN2: READY +CPIN2: SIM PIN2 +CPIN2: SIM PUK2 +CME ERROR: <err>
No PIN2 is needed PIN2 is required PUK2 is required Absent (10) etc
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
75
AT commands interface
7.3
7.3.1
+CPINC
This specific command instructs the module to display the number of valid tries for PIN1 (CHV1), PIN2 (CHV2), PUK1 (UNBLOCK CHV1) and PUK2 (UNBLOCK CHV2) identifiers.
7.3.2
Syntax :
AT+CPINC +CPINC : <n1>,<n2>,<k1>,<k2> Command Possible responses +CPINC : 2,3,10,10 Note : First CHV1 attempt was a failure +CPINC : 2,3,10,10 Note : First attempt was a failure OK
AT+CPINC Note : Ask remaining tries AT+CPINC? Note : Ask current values AT+CPINC=? Note : Ask possible values
7.3.3
Defined values
<n1>, <n2> are the remaining tries of PIN1, PIN2 (0 = blocked, 3 max) <k1>, <k2> are the remaining tries of PUK1, PUK2 (0 = blocked, 10 max) To make it run, the card should be present at the initialisation time, in the opposite case, an error will be sent (+CME ERROR : 10).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
76
AT commands interface
7.4
7.4.1
This command shall be used by the application to lock, unlock or interrogate a ME or network facility <fac>.
7.4.2
Syntax :
AT+CLCK= <fac>,<mode>[,<passwd>[,<class>] ] +CLCK: <status> [ ,<class1> ]<CR><LF>+CLCK: <status>,<class2> []] Command Possible responses OK Note : PIN was right +CLCK PS,0),(SC,0),(FD,0),(PN,0),(PU ,0),(PP,0),(PC,0) OK Note : PIN is enables, no SIM lock, no network lock, no information on Call barring (no longer supported in GSM 07.07)
AT+CLCK=SC,0,5555 Note : Disable PIN AT+CPIN=1234 Note : Enter PIN AT+CLCK=? Note : Request supported facilities
+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
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
77
AT commands interface
AT+CLCK=PN,1,12345678 Note : Activate network lock AR+CLCK=AO,1,1234,2 Note : Activate all outgoing calls barring for data calls AT+CLCK=AO,2 Note : Query BAOC status
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
7.4.3
Defined values :
The following <fac> values are supported: PS : SIM lock facility with a 8 digits password. SC : PIN enable (<mode> = 1) / disable (<mode> = 0) AO : BAOC (Barr All Outgoing Calls) OI : BOIC (Barr Outgoing International Calls) OX : BOIC-exHC (Barr Outg. Internat 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 a 8 digits password (NCK). PU : Network Subset lock with a 8 digits password (NSCK). PP : Service Provider lock with a 8 digits password (SPCK). PC : Corporate lock with a 8 digits password (CCK). FD: SIM Fixed Dialling Numbers (FDN) memory feature (PIN2 is required as <password>)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
78
AT commands interface
<mode>
<class> : A facility status can be changed for only one class, or for all classes (7 or omitted). <class> 1 : Voice (telephony) 2 : Data (refer to all bearer services) 3 : Fax (facsimile services) 4 : Short Message service 5: equal to all classes (Default value)
Any attempt to combine different classes will result in activation / desactivation / interrogation of all classes. The password maximum length is given with the AT+CPWD=? Command.
7.5
7.5.1
This command shall be used by the application to change a password (PIN, call barring, NCK). The facility values (<fac>) are the same as for +CLCK command, with a P2 facility to manage SIM PIN2. For the network lock (PN), the unlock is forbidden after 10 failed attempts to disable (unlock) the network lock with an incorrect password.
7.5.2
Syntax :
AT+CPWD= <fac>, <oldpwd>, <newpwd>
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
79
AT commands interface
OK Note : CHV1/CHV2 must be on 8 digits maximum (4mn) For call barring, on 4 digits maximum 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 OK Note : PIN was good +CME ERROR: 16 Note: PIN was wrong OK Note : PIN was good OK Note : NCK changed for net lock
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
80
AT commands interface
8
8.1
8.1.1
Phonebook commands
Select phonebook memory storage +CPBS
Description :
This command selects phonebook memory storage. The available phonebooks are: SM : SUCCESSFUL (SIM phonebook) FD : FDN (SIM fixdialling, restricted phonebook) ON : MSISDN (SIM own numbers) EN : EN (SIM emergency number) LD : LND (combined ME and SIM last dialling phonebook) MC : MSD (ME missed calls list) ME : ME (ME phonebook) MT : MT (combined ME and SIM phonebook) RC : LIC (ME received calls list) SN : SDN (Services dialling phonebook)
8.1.2
Syntax :
AT+CPBS Command Possible responses OK Note : SUCCESSFUL phonebook is selected +CPBS: (SM,LD,MC,ON,ME,RC,MT, SN)
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
81
AT commands interface
OK Note : only EN phonebook is not supported with this SIM card. AT+CPBS? Note : Status +CPBS :SM,10,20 OK Note: SUCCESSFUL phonebook selected, 10 used locations, 20 locations available
8.2
8.2.1
This command returns phonebook entries for a location range 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).
8.2.2
Syntax :
AT+CPBR Command Possible responses +CPBR: (1-50),20,10 OK Note : 50 locations (from 1 to 50), max length of 20 for phone, 10 charcters max for the associated text
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
82
AT commands interface
+CPBR : 14,0146290808,129,Zazi OK Note : Display locations 12,13,14 with location, number, type (TON/NPI), Text AT+CPBR=10 Note : Read entry 10 +CPBR :10,0146290921,129,Rob OK Note: Display location 10 AT+CPBR=11 Note : Read entry 11 (UCS2 format)
+CPBR :11,0146290921,129,8000010002FFFF
8.3
8.3.1
This command returns phonebook entries which alphanumeric field starts 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, SN phonebooks and for EN phonebook, which does not contain alphanumeric field. It is possible to use this command with UCS2 strings. If a bad UCS2 format is entered, the string is considered as an ASCII string.
8.3.2
Syntax :
AT+CPBF Command Possible responses +CPBF: 20,10
Command syntax :
AT+CPBF=?
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
83
AT commands interface
+CPBF : 12,112,129,Emergency +CPBF : 15,+331290101,145,Eric OK Note : Display locations with text field starting with E
AT+CPBF=H Note : Read entries with H AT+CPBF=800001FFFF Note : Read entries starting with 0001 UCS2 character
+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 bad UCS2 format, so it was considered as an ASCII string
8.4
8.4.1
This command writes phonebook entry in location number <index> in the current phonebook memory storage. RC and MC phonebooks could be only erased by +CPBW. Adding field and/or modifying field is not allowed for these phonebooks. This command is not allowed for EN, LD, MT, SN phonebooks, which are not writable.
8.4.2
Syntax :
AT+CPBW=<index>[,<number>[,<type>[,<text>]]] Command Possible responses
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
84
AT commands interface
+CPBW: (1-50),20,(129,145),10 OK Note : 50 locations, phone length = 20, TON/NPI of 129 or 145, text length = 10
AT+CPBW= 3 Note : Erase location 3 AT+CPBW=5,112,129,SOS Note : Write at location 5 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> Note : Location 6 is written field) AT+CPBW=,+33145221100,145,SOS Note : Write at the first free location AT+CPBW=,0345221100,129,SOS Note : Write at the first free location AT+CPBW=57,112,129,WM Note : Write at location 57 (wrong) OK Note : Free location is written +CME ERROR: 20 Note : Phonebook full +CME ERROR: 21 Note : Invalid index
AT+CPBW=7,012345678901234567890,129,W +CME ERROR: 26 AVE Note : Write at location 7 a long phone numbe (21 Note : Phone too long digits) AT+CPBW=7,0122334455,129,WAVECOM TEL Note : Write at location 7 along text (11 characters) +CME ERROR: 24
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
85
AT commands interface
OK Note : Location 8 is written. The string has a bad UCS2 format, so it is considered as an ASCII string
When the fixed dialling phonebook (FDN) is locked , this command is not allowed. Moreover , when FDN is unlocked , PIN2 is required to write in the FDN phonebook. But if PIN2 authentification has been done during the current cession , +CPBW command with FDN is allowed . Command AT+CPBS=FD Note : Choose FDN AT+CPBW=5,01290917,129,Jacky Note : Write in FDN at location 5 AT+CPIN? +CME ERROR: 17 Note : SIM PIN2 is required SIM PIN2 Note: SIM PIN2 is required AT+CPIN=5678 Note : Enter SIM PIN2 AT+CPBW=5,01290917,129,Jacky Note : Write in FDN at location 5 OK Note : Now writing in FDN is allowed OK OK Possible responses
8.4.3
Defines values :
<index> <number> <type> Note : integer type value depend of capacity of phonebook memory. Phone number in ASCII format. TON/NPI (Type of address octet in integer format). for <type> parameter, all values are allowed from 0 to 255, but the MSB will be set to 1 in all cases (ex : a <type> value of 17 will be written as 145). string type.
<text>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
86
AT commands interface
Note 1 : For the parameter <text> all string started by 80 , 81 or 81 are considered in UCS2 format. See the APPENDIX E (Coding of Alpha fields in the SIM for UCS2). Note 2 : The +CSCS (Select Character set) command not affect the format for the phonebook entries.
8.5
8.5.1
This specific command orders the module to look in the phonebook for an item having the same phone number that defined in parameter.
8.5.2
Syntax :
AT+CPBP=<PhoneNumber>
Command syntax :
<PhoneNumber> is coded like all phone numbers in GSM 07.07 or GSM 07.05 . Command AT+CPBP=+331290101 Note : Read entries with this phone number Possible responses +CPBP : 15,+331290101,145,Eric OK Note : Display location with this phone number AT+CPBP=+331290101 Note : Read entries with this phone number +CPBP : 15,01290101,129,Eric OK Note : Display location with this phone number AT+CPBP=01290202 Note : Read entries with this phone number +CPBP : 15,+331290202,145,David OK Note : Display location with this phone number AT+CPBP=+331288575 Note : Read entries with this phone number
+CPBP : 15,+331290101,145,8045682344FFFF (UCS2 format)
OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
87
AT commands interface
Note : Display location with this phone number AT+CPBP=0129 Note : Read entries with this phone number +CME ERROR: 22 Note : Entry not found
8.6
8.6.1
This specific command instructs the module to make a forward or a backward move in the phonebook (in alphabetical order). This command is not allowed for EN phonebook, which does not contain alphanumeric field.
8.6.2
Syntax :
AT+CPBN=<mode> Command Possible responses +CPBN : (0-5) OK Note : Possible modes
Command syntax :
AT+CPBN=2
+CPBN : 6,+331290302,145,Marc
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
88
AT commands interface
Using mode 4 and 5 with +CPBF command and CPBW : Command AT+CPBF=Er Note : Find Er in phonebook Possible responses +CPBF : 15,+331290101,145,Eric OK Note : Display this location AT+CPBN=2 Note : Read the next location +CPBN : 5,+33147658987,145,Frank OK Note : Display the following location AT+CPBF=Er Note : FindEr in phonebook +CPBF : 15,+331290101,145,Eric OK Note : Display this location AT+CPBN=4 +CPBF : 15,+331290101,145,Eric
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
89
AT commands interface
AT+CPBW=,0146290800,129,WM Note : Write an item at the first free location AT+CPBN=4 Note : Read the last read location
OK Note : No information about this location +CPBF : 15,+331290101,145,Eric OK Note : Display the last read location AT+CPBN=38,0146290800,129,WM Note : Display the last written item with its location
AT+CPBN=4 Note : Read the last read item AT+CPBF=800041FFFF Note : Find800041 in phonebook
AT+CPBN=38,0146290800,129,WM Note : Now the last read item is the last writen item too +CPBF : 15,+3312345,145,8000414339FFFF OK Note : Display this location
Please note that the AT+CPBN=5 command is useful after an AT+CPBW command used without a location.
8.6.3
Defined values :
<mode> 0 : First item 1 : Last item 2 : Next valid item in alphabetical order 3 : Previous valid item in alphabetical order 4 : Last read item (usable only if a read operation was performed on
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
90
AT commands interface
the current phonebook since the end of initialization (+WIND: 4)) 5 : Last written item (usable only if a write operation was performed on the current phonebook since the end of initialization (+WIND: 4))
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
91
AT commands interface
8.7
8.7.1
If the subscriber has different MSISDNs for different services, each MSISDN is returned in a separate line.
8.7.2
Syntax :
AT+CNUM +CNUM : <alpha1>, <number1>, <type1> <CR><LF> +CNUM : <alpha2>, <number2>, <type2> . Command Possible responses +CNUM :Phone, 0612345678,129 +CNUM :Fax, 0687654321,129
AT+CNUM
AT+CNUM=?
OK
8.7.3
Defined values :
<alphax> <numberx> <typex> optional alphanumeric string associated with <numberx> string type phone number of format specified by <typex> type of adress octet in integer format
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
92
AT commands interface
8.8
8.8.1
This specific command allows to inhibit the initialization of all phonebooks during the next boots.
8.8.2
Syntax :
AT+WAIP=<mode> Command Possible responses +WAIP :0 OK
Command syntax :
AT+WAIP?
Note : Default value (init phonebooks) +WAIP : (0,1) OK Note : Disable / enable
AT+WAIP =1 Note : Inhibit initialization of phonebooks (next boot) AT&W Note : Save modifications in EEPROM
OK Note : no answer
Be careful: The given value should be stored in EEPROM, so the command AT&W must be used to save the new <mode> value. Note: All phonebook commands are not allowed when +WAIP=1 (after boot). If phonebook command is entered, +CME ERROR: 3 is return.
8.8.3
Defined values :
<mode> 0 : Normal initialization (with phonebooks) 1 : No phonebook initialization
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
93
AT commands interface
8.9
8.9.1
8.9.2
Syntax :
AT+WDCP=<calls phonebook> Command Possible responses OK +WDCP : (LD,MC,RC) OK
Command syntax :
AT+WDCP? AT+WDCP=?
Note : Possible values ? AT+WDCP=LD Note : Delete all the content of Last Dialling phonebook.
Note : Names of supported calls list phonebooks OK Note : Last Dialling phonebook is now empty.
8.9.3
Defined values :
<calls phonebook> LD : SIM (ME extended) Last dialling phonebook MC : ME missed calls list phonebook RC : ME received calls list phonebook
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
94
AT commands interface
8.10
8.10.1
8.10.2
Syntax :
AT+CSVM=<mode>[,<number>[,<type>]] Command Possible responses +CSVM : 1,660,129 OK
Command syntax :
AT+CSVM?
Note : Possible values ? AT+CSVM=0,888,129 Note : Disable Voice Mail number and change value to 888.
8.10.3
Defined values :
0 1 Disable the voice mail number Enable the voice mail number Phone number in ASCII format. TON/NPI (Type of address octet in integer format). for <type> parameter, all values are allowed from 0 to 255, but the MSB will be set to 1 in all cases (ex : a <type> value of 17 will be written as 145).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
95
AT commands interface
9
9.1
<fo> <index> <length> <mem1> <mem2> <mid> <mr> <oa> <pid> <pdu>
<ra> <sca>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
96
AT commands interface
<scts>
Service Center Time Stamp in string format : yy/MM/dd,hh :mm :sszz (Year/Month/Day,Hour:Min:SecondsTimeZone) CBM Serial Number Status of a SMS-STATUS-REPORT Status of message in memory. Type-of-Address of <oa>. Type-of-Address of <ra>. Type-of-Address of <sca>. Number of message locations in <mem1>. Number of messages locations in <mem2. Total number of messages locations in <mem1>. Total number of messages locations in <mem2. Validity Period of the short message, default value is 167
<sn> <st> <stat> <tooa> <tora> <tosca> <total1> <total2> <used1> <used2> <vp>
9.2
9.2.1
The supported services are GSM originated (SMS-MO) and terminated short message (SMS-MT), Cell Broadcast Message (SMS-CB) services.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
97
AT commands interface
9.2.2
Syntax :
AT+CSMS=<service> Command Possible responses +CSMS: 1,1,1 OK
Command syntax :
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 ?
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
9.2.3
Defined 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 .
9.3
9.3.1
This command allows to acknowledge the reception of a new message routed directly to the TE.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
98
AT commands interface
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. Acknowledge with +CNMA is possible only if +CSMS parameter is set to 1 (+CSMS=1) when a +CMT or +CDS indication is shown (see +CNMI command). If no acknowledgement is given within the network-timeout, RP-ERROR is send to the network, then <mt> and <ds> parameters of +CNMI command are reset to zero (dont show new message indication).
9.3.2
Syntax :
Command syntax in text mode : AT+CNMA Command syntax in PDU mode : AT+CNMA [ = <n> [ , <length> [ <CR> PDU is entered <ctrl-Z / ESC> ] ] ]
nota : PDU is entered using <ackpdu> format instead of <pdu> format (i.e. SMSC address field is not present).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
99
AT commands interface
Example to acknowledge a new message in TEXT mode Command AT+CMGF=1 Note : TEXT message format AT+CNMI=2,2,0,0,0 Note : <mt>=2 +CMT : 123456,98/10/01,12 :30 00+00,129,4 ,32,240, 15379,129,5<CR><LF> Received message Note : message received AT+CNMA Note : acknowledge the message received AT+CNMA Note : try to acknowledge again OK Note : send positive acknowledgement to the network +CMS ERROR : 340 Note : no +CNMA acknowledgment expected OK Note : TEXT mode valid OK Possible responses
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
100
AT commands interface
Example to acknowledge a new message in PDU mode Command AT+CMGF=0 Note : PDU message format OK Note : PDU mode valid +CMT: ,29 07913366003000F1240B913366920547F300000030 03419404800B506215D42ECFE7E17319 Note : message received AT+CNMA=2,<length> <CR> Pdu message <Ctrl-Z/ESC> Note : negative acknowledgement for the message. OK Note : send a negative acknowledgement to the network (RP-ERROR) with PDU message (<ackpdu> format). Possible responses
9.3.3
Defined 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
9.4
9.4.1
This command allows to define the message storage area to be used for reading, writing
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
101
AT commands interface
9.4.2
Syntax :
AT+CPMS=<mem1>,[<mem2>] Command Possible responses +CPMS: ((SM,BM,SR),(SM)) OK
Command syntax :
AT+CPMS=?
Note : Read, list, delete: SMS, CBM or SMS Status Report Write, send: SMS
AT+CPMS?
Note : Read it
Note : Read, writeSMS from/to SIM 3 SMS are stored in SIM. 10 is the total available SIM memory +CMS ERROR: 302
+CPMS: 2,20,3,10 OK
Note : Read, list, delete CBM from RAM 2 CBM are stored in RAM +CPMS: BM,2,20,SM,3,10 OK
Note : Read it
Note : Read list, delete CBM from RAM Write SMS to SIM
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
102
AT commands interface
9.4.3
Defined values :
<mem1>: Memory used to list, read and delete messages. It can be: 1 SM : SMS message storage (in SIM) (default) - BM : CBM message storage (in volatile memory). - SR : Status Report message storage (in SIM if EF-SMR file exist, else in the ME no volatile memory) SR ME no volatile memory is cleared when another SIM card is inserted. It is kept, even after a reset, while the same SIM card is used.
Note :
<mem2>: Memory used to write and send messages - SM : SMS message storage (in SIM) (default). If the command is correct, the following indication message is sent: +CPMS: <used1>,<total1>,<used2>,<total2> When <mem1> is selected, all following +CMGL, +CMGR and +CMGD commands are related to the type of SMS stored in this memory.
9.5
9.5.1
In PDU mode, a complete SMS Message including all header information is passed as a binary string (in hexadecimal format, so only this set of characters is allowed : {0,1,2,3,4,5,6,7,8,9, A, B,C,D,E,F} ). Each pair or characters is converted to a byte (ex : 41 is converted to the ASCII character A, whoes ASCII code is 0x41 or 65). In Text mode, every commands and responses are in ASCII characters. The chosen format is stored in EEPROM by the command +CSAS.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
103
AT commands interface
9.5.2
Syntax :
AT+CMGF Command Possible responses +CMGF: 1 OK
Command syntax :
AT+CMGF ?
Example to send a SMS Message in PDU mode Command AT+CMGF=0 Note : PDU message format AT+CMGS=14<CR> 0001030691214365000004C9E9340B Note : Send complete MSG in PDU mode, no SC address OK Note : PDU mode valid +CMGS: 4 OK Note : MSG correctly sent, <mr> is returned Possible responses
9.5.3
Defined values :
The message <pdu> 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 octets of the TPDU buffer is 14, coded as GSM 03.40 In this case the TPDU is : 0x01 0x03 0x06 0x91 0x21 0x43 0x65 0x00 0x00 0x04 0xC9 0xE9 0x34 0x0B, which means regarding GSM 03.40 :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
104
AT commands interface
0x01 (SMS-SUBMIT, no validity period) 0x03 (Message Reference) 0x06 0x91 0x21 0x43 0x65 (destination address +123456) 0x00 (Protocol Identifier) 0x00 (Data Coding Scheme : 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. octet with hexadecimal value 0x2A is presented to the mobile as two characters 2 (ASCII 50) and A (ASCII 65).
9.6
9.6.1
All settings specified in command +CSCA and +CSMP are stored in EEPROM if the SIM card is a phase 1 card or in the SIM card if it is phase 2.
9.6.2
Syntax :
AT+CSAS Command Possible responses OK Note : Parameters are saved
Command syntax :
9.7
9.7.1
All settings specified in command +CSCA and +CSMP are restored from EEPROM if the SIM card is phase 1 or from the SIM card if it is a phase 2 SIM card.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
105
AT commands interface
9.7.2
Syntax :
AT+CRES Command Possible responses OK Note : Parameters are restored
Command syntax :
9.8
9.8.1
This commands gives more informations in text mode result codes. These informations are in brackets in commands +CMTI, +CMT, +CDS, +CMGR, +CMGL.
9.8.2
Syntax :
AT+CSDH Command Possible responses +CSDH: 0 OK Note : Do not show header values
Command syntax :
9.9
9.9.1
This command selects the procedure on how to receive the message from the network. The application must send the following command :
9.9.2
Syntax :
AT+CNMI=<mode>,<mt>,<bm>,<ds>,<bfr>
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
106
AT commands interface
Command
AT+CNMI=2,1,0,0,0 Note : <mt>=1 OK
Possible responses
9.9.3
Defined values :
<mode> : controls the processing of unsolicited result codes 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 unsollicited result codes will be the same than for <mode>=2.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
107
AT commands interface
<mode>
0 : Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications 1 : Discard indication and reject new received message unsolicited result codes when TA-TE link is reserved. 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. TATE 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 0. <mt> 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 unsollicited code : +CMT : [<alpha>,] <length> <CR> <LF> <pdu> (PDU mode) or +CMT : <oa>,[<alpha>,] <scts> [,<tooa>, <fo>, <pid>, <dcs>, <sca>, <tosca>, <length>] <CR><LF><data> (text mode) 3 : Class 3 SMS-DELIVERS are routed directly using code in <mt>=2 ; Message of other classes result in indication <mt>=1
<bm> : set the rules for storing received CBMs (Cell Broadcast Message) types depend on its coding scheme, the setting of Select CBM Types (+CSCB command) and <bm>. Default is 0. <bm> 0 : No CBM indications are routed to the TE. The CBMs are stored. 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>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
108
AT commands interface
2 : New CBMs are routed directly to the TE using unsolicited result code. +CBM : <length><CR><LF><pdu> (PDU mode) or +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> for SMS-STATUS-REPORTs. Default is 0. <ds> 0 : No SMS-STATUS-REPORTs are routed. 1 : SMS-STATUS-REPORTs are routed using unsolicited code : +CDS : <length> <CR> <LF> <pdu> (PDU mode) or +CDS : <fo>,<mr>, [<ra>] , [<tora>], <scts>,<dt>,<st> (Text mode) 2 : SMS-STATUS-REPORTs are stored and routed using the unsolicited result code : +CDSI: SR,<index> <bfr> Default is 0. <bfr> 0 : TA buffer of unsolicited result codes defined within this command is flushed to the TE when <mode> 13 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> 13 is entered.
9.10
9.10.1
This command allows the application to read stored messages. The messages are read from the memory selected by +CPMS command.
9.10.2
Syntax :
AT+CMGR=<index>
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
109
AT commands interface
+CMGR :<stat>,<oa>,[<alpha>,] <scts> [,<tooa>,<fo>, <pid>,<dcs>,<sca>,<tosca>,<length>] <CR><LF> <data> (for SMS-DELIVER only) +CMGR : <stat>,<da>,[<alpha>,] [,<toda>,<fo>,<pid>,<dcs>, [<vp>], <sca>, <tosca>,<length>]<CR><LF> <data> (for SMS-SUBMIT only) +CMGR : <stat>,<fo>,<mr>,[<ra>],[<tora>],<scts>,<dt>,<st> (for SMS-STATUS-REPORT only)
Response syntax for PDU mode : +CMGR: <stat>, [<alpha>] ,<length> <CR><LF> <pdu> A message read with status REC UNREAD will be updated in memory with the status REC READ because it has been read. Note : the <stat> parameter for SMS Status Reports is always READ. Example : Command Possible responses AT+CMTI: SM,1 Note : New message received AT+CMGR=1 Note : Read the message +CMGR: REC UNREAD,0146290800, 98/10/01,18 :22 :11+00,<CR><LF> ABCdefGHI OK AT+CMGR=1 Note : Read again the message +CMGR: REC UNREAD,0146290800, 98/10/01,18 :22 :11+00,<CR><LF> ABCdefGHI OK Note : Message is read now AT+CMGR=2 Note : Read a bad index +CMS ERROR: 321 Note : Error : invalid index
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
110
AT commands interface
AT+CMGF=0 ;+CMGR=1
AT+CMSS=3
Send a previously stored SMS
AT+CMGR=1
Read the SMS Status Report
9.11
9.11.1
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 +CPMS command.
9.11.2
Syntax :
AT+CMGL=<stat>
Command syntax :
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>)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
111
AT commands interface
+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 AT+CMGL=REC UNREAD Note : List unread messages in text mode Possible responses +CMGL: 1,REC UNREAD,0146290800, <CR><LF> Unread message ! +CMGL: 3,REC UNREAD, 46290800, <CR><LF> Another unread message ! OK Note : 2 messages are unread, these messages will then have their status changed to REC READ (+CSDH:0) AT+CMGL=REC READ Note : List read messages in text mode +CMGL: 2,REC READ,0146290800, <CR><LF> Keep cool OK AT+CMGL=STO SENT OK
Note : List stored and sent messages in text mode Note : No message found AT+CMGL=1 Note : List read messages in PDU mode +CMGL: 1,1,,26 <CR><LF> 07913366003000F3040B913366920547F40013 001190412530400741AA8E5A9C5201 OK
9.11.3
Defined values
<stat> possible values (status of messages in memory) :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
112
AT commands interface
Text mode possible values REC UNREAD REC READ STO UNSENT STO SENT ALL Note :
Status of messages in memory received unread messages received read messages stored unsent messages stored sent messages all messages
For SMS Status Reports, only ALL / 4 and READ / 1 values of the <stat> parameter will list messages ; other values will only return OK.
9.12
9.12.1
The <address> field is the address of the terminal network to whom the message is sent. To send the message, simply type <ctrl-Z> character (ASCII 26). The text can contain all existing character except <ctrl-Z> and <ESC> (ASCII 27). This command is abortable using the <ESC> character when entering text. In PDU mode, only hexadecimal characters are used (09,AF).
9.12.2
Syntax :
Command syntax in text mode : AT+CMGS= <da> [ ,<toda> ] <CR> text is entered Command syntax in PDU mode : AT+CMGS= <length> <CR> PDU is entered Command <ctrl-Z / ESC > Possible responses <ctrl-Z / ESC >
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
113
AT commands interface
AT+CMGS=+33146290800<CR> Please call me soon, Fred. <ctr-Z> Note : Send a message in text mode AT+CMGS=<length><CR><pdu><ctrl-Z> Note : Send a message in PDU mode
+CMGS: <mr> OK Note : Successful transmission +CMGS: <mr> OK Note : Successful transmission
The message reference <mr> which is returned back to the application is allocated by the GSM module. This number begins with 0 and is incremented by one for each outgoing message (successful and failure case) ; it is cyclic on one byte (0 follows 255). Note : this number is not a storage number outgoing messages are not stored.
9.13
9.13.1
This command stores a message to memory storage (either SMS-SUBMIT or SMSDELIVERS). The memory location <index> is returned (no choice possible as with phonebooks +CPBW). The entering of text or PDU is done similarly as specified in command Send Message +CMGS (see 0).
9.13.2
Syntax :
(<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>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
114
AT commands interface
Response syntax:
+CMGW: <index> or +CMS ERROR: <err> if writing fails Command Possible responses +CMGW: 4 OK Note : Message stored in index 4 +CMGW: <index> OK Note : Message stored in <index>
AT+CMGW=+33146290800<CR> Hello haw 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
9.13.3
Defined values :
Parameter Definition : <oa/da> : Originating or Destination Adress Value in string format. Type of Originating / Destination Adress. Integer type in PDU mode (default 2 for +CMGW), or string type in text mode (default STO UNSENT for +CMGW). It indicates the status of message in memory. If <stat> is omitted , the stored message is considered like a message to be send.
<tooa/toda> : <stat> :
0 : REC UNREAD 1 : REC READ 2 : STO UNSENT 3 : STO SENT <length> : The length of the actual data unit in octets
<stat>
9.14
9.14.1
This command sends message with location value <index> from storage to the network.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
115
AT commands interface
9.14.2
Syntax :
AT+CMSS=<index>[,<da> [,<toda>] ] +CMSS : <mr> or +CMS ERROR: <err> if sending fails
If new recipient address <da> is given, it will be used instead of the one stored with the message. Command AT+CMGW=0660123456<CR> Today is my birthday Note : AT+CMSS=5, 0680654321 +CMGW : 5 OK Note :Message stored in index 5 AT+CMSS :<mr> OK Note : Send the message 5 to a different GSM AT+CMSS=5, 0680654321 Note : Successful transmission +CMSS :<mr> OK Note : Send the message 5 to a different GSM Note : Successful transmission Possible responses
9.15
9.15.1
This command shall be used to select value for the <vp>, <pid>, the <dcs>.
9.15.2
Syntax ;
AT+CSMP=<fo>, <vp>, <pid>,<dcs> Command Possible responses +CSMP: 0,0,0,0
Command syntax :
AT+CSMP?
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
116
AT commands interface
OK Note : current values Note : No validity period <dcs>= PCCP437 alphabet (8 bits AT+CMPS=17,23,64,244 Note :<vp> = 23 (2 hours, relative format) <dcs> = GSM 8 bits alphabet OK Note : Command correct 7 bits)
9.15.3
Defined values :
UDHI SRR
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 which has the same <mr> and the same <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 octet can describe different values :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
117
AT commands interface
12 hours + ( (VP 143) x 30 minutes ) (VP 166) x 1 day (VP 192) x 1 week
<pid> 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. <dcs> is used to determine the way the information is encoded. Compressed text is not supported. Only GSM default alphabet, 8 bit data and UCS2 alphabet are supported.
9.16
9.16.1
This command is used to delete one or several messages from prefered message storage (BM SMS CB RAM storage, SM SMSPP storage SIM storage or SR SMS Status-Report storage).
9.16.2
Syntax :
AT+CMGD=<Index> [,<DelFalg>] Command Possible responses +CMTI:SM,3 Note : New message received
Command syntax :
+CMGR: REC UNREAD,0146290800,, 98/10/01,18 :19 :20+00 <CR><LF> Received Message ! Note : Unread message received from
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
118
AT commands interface
0146290800 on the 01/10/1998 at 18H19m 20s AT+CMGD=3 Note : Delete it AT+CMGD=1,0 OK Note : Message deleted OK Note : The message from the preferred message storage at the location 1 is deleted AT+CMGD=1,1 OK Note : All READ messages from the preferred message storage are deleted AT+CMGD=1,2 OK Note : All READ messages and SENT mobile originated messages are deleted AT+CMGD=1,3 OK Note : All READ, SENT and UNSENT messages are deleted AT+CMGD=1,4 OK Note : All messages are deleted
9.16.3
Defines values
<index> (1-20) When the preferred message storage is BM Integer type values in the range of location numbers of SIM Message memory when the preferred message storage is SM or SR. <DelFlag> 0 1 2 3 4 Delete the message at the location <index>. Delete All READ messages Delete All READ and SENT messages Delete All READ, SENT and UNSENT messages Delete All messages.
Note :
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.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
119
AT commands interface
9.17
9.17.1
This command shall be used to indicate to which service center the message has to be sent. The GSM module 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. So, the application has to indicate this address when initializing. This address is then valid all the time. The application may change it if needed.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
120
AT commands interface
9.17.2
Syntax :
AT+CSCA Command Possible responses +CMS ERROR: 330 Note : service center unknown
Command syntax :
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 :
9.18
9.18.1
Set command selects which types of CBMs are to be received by the ME, This command is allowed in both PDU and text modes.
9.18.2
Syntax :
AT+CSCB= <mode>, [ <mids>, [ <dcss> ] ]
Command syntax :
The <bm> parameter of +CNMI command controls the message indication. Test read command (AT+CSCB ?) is not supported. The activation of CBM reception (<mode>=0) can select only specific Message Identifiers (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 which type of message identifiers the ME should listen to.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
121
AT commands interface
Supported languages (<dcss> parameter) are : 0 for German, 1 for English, 2 for Italian, 3 for French, 4 for Spanish, 5 for Dutch, 6 for Swedish, 7 for Danish, 8 for Portugese, 9 for Finnish, 10 for Norwegian, 11 for Greek, 12 for Turkish, 13 for Hungarian, 14 for Polish and 32 for Czech. Command
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> 00112233445566778899 Note : CBM length of a received Cell Broadcast message (SMS-CB), CBM bytes in PDU mode AOK Note : CBM reception is completely stopped OK Note : CBMs can be received AT+CSCB=1 Note : Deactivate the reception of CBMs
Possible responses
9.19
9.19.1
This file is not used with +CSCB command, the application should read this file (AT+WCBM ?) and combine the Message Identifiers with those required for the application.
9.19.2
Syntax :
AT+WCBM= <mids> Command Possible responses
OK Note : CBMIs are stored in EF-CBMI
Command syntax :
AT+WCMB=10,100,1000,10000 Note : Write 4 messages identifiers in EF-CBMI AT+WCBM? Note : Read the CBMIs in EF-CBMI
+WCBM=10,100,1000,100000
Note : 4 CBMIs are stored in EF-CBMI
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
122
AT commands interface
9.20
9.20.1
Command syntax :
+CMS ERROR: 321 if <loc> is invalid or free +CMS ERROR: 302 if the new <status> and the previous one are incompatible (1) Note 1 : The accepted status changes are from READ to NOT READ and vice versa, and from SENT to NOT SENT and vice versa. If all the parameters are correct, the module overwrites the whole SMS in the SIM. Only the first byte (Status byte) is changed.
9.21
9.21.1
The +CMGW writes a SMS to the first free location. To write a SMS to a specified location, the +WMGO specific command forces the module to write a SMS (with +CMGW command) to the location specified with +WMGO, but just for one +CMGW command.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
123
AT commands interface
9.21.2
Syntax :
AT+WMGO= <loc>
Command syntax :
<loc> location number of the SIM record to write or overwrite Possible responses: OK if <loc> is a valid SMS location, for AT+WMGO=? And for AT+WMGO?
+CMS ERROR: 321 if <loc> is out of the SIM capacity range. +WMGO: <loc> for AT+WMGO?
Then on the next AT+CMGW command, the record number used will be the one specifed by AT+WMGO command. The location is then forgotten, and in order to make a second overwrting, the +WMGO has to be used again. If the external application specifies a free location, and if an incoming message is received before the AT+CMGW command, the module may store the incoming message in a free location, which could be unfortunately the one specified by +WMGO (the module does not prevent this case). Then if the user issues a AT+CMGW command, without changing the AT+WMGO location, the new message will be overwritten ! Be aware that this location number is not kept over a software reset.
9.22
9.22.1
9.22.1.1
Syntax :
AT+WUSS = <mode>
The SMS Status will not change. The SMS Status will change.
Possible responses: OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
124
AT commands interface
This commands allows the control of the call forwarding supplementary service.
10.1.2
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 AT+CCFC=0,3,0146290800 Note : Register call forwarding unconditional AT+CCFC=0,2 Note : Interrogate call forwarding unconditional 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 AT+CCFC=0,4 Note : Erase call forwarding unconditional Note : Call forwarding active for fax OK Note : Command valid Possible responses
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
125
AT commands interface
The +CCFC responses are not sorted depending of the <class> parameter, it only depends of the order of the network response.
10.1.3
Defined values
0 1 2 3 4 5 0 1 2 3 4 1 2 4 8 7 Unconditional Mobile busy No reply Not reachable All call forwarding All conditional call forwarding Disable Enable Interrogate Registration Erasure Voice Data Fax Short Messages All classes
<reason>
<mode>
<class>
The combination of different classes is not supported, it will only result in the activation / deactivation / status request of all classes (7). not managed not managed 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 : 20.
10.2
10.2.1
This commands allows the control of the call barring supplementary service. Locking, unlocking or querying the status of a call barring is possible for all or a specific class.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
126
AT commands interface
10.2.2
Syntax :
AT+CLCK= <fac>, <mode> [, <password> [, <class> ] ] (for <mode>=2 and command successful)
+CLCK: <status> [, <class1> [ <CR><LF>+CLCK: <status>, <class2> [ ] ] Command AT+CLCK=AO,1,1234 Note : AT+CLCK=AO,0,5555 Note : AT+CLCK=AO,0,1234 Note : OK Note : Command valid +CME ERROR: 16 Note : Wrong password OK Note : Command valid Possible responses
<fac>
AO, OI, OX : for outgoing calls barring AI, IR : for incoming calls barring AI, IR : for incoming calls barring AG, AC,AB : for all calls barring (<mode>=0 only) 0 : Unlocks the facility 1 : Locks the facility 2 : Query status
<mode>
<class> : see description for +CLCK command (Facility lock) or +CCFC(Call forwarding). The combination of different classes in not supported, it will only result in the activation / deactivation / status request of all classes (7). Password code must be on 4 digits maximum.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
127
AT commands interface
10.3
10.3.1
This command shall be used by the application to change the supplementary service password.
10.3.2
Syntax :
AT+CPWD=<fac>,<OldPassword>, <NewPassword>
Command Syntax:
for <fac> see +CLCK command with only P2 facility added (SIM PIN2). Command 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 Possible responses
Whatever the facility, the change of password is performed for all calls barring.
10.4
10.4.1
This command allows the control of the call waiting supplementary service. The module will send an unsolicited result code +CCWA when call waiting service is enabled.
10.4.2
Syntax :
AT+CCWA=<n>, [ <mode> [, <class> ] ]
Command Syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
128
AT commands interface
Response Syntax:
(for <mode>=2 and command successful) +CCWA: <status> [, <class1> [ <CR><LF>+CCWA: <status>, <class2> []] +CCWA: <number>, <type>, <class> [ ,<alpha>] service is enabled) Command (when waiting
Unsolicited result:
Possible responses OK Note : Command valid +CCWA:1,1 OK Note : Call waiting active for speech calls
AT+CCWA=1,1,1 Note : Enable call waiting for speech AT+CCWA=1,2 Note : Interrogate call waiting
+CCWA:0146290800,145,1,FREDDY or +CCWA:0146290800,145,1,8023459678FFFF (UCS2 format) Note : Number and name of the waiting voice call AT+CCWA=1,0,7 Note : Erase call waiting +CCWA:,,1
Note : Waiting voice call without number
Note :
10.4.3
Defined values :
<n> : result code presentation status in the TA <n> 0 : Disable 1 : Enable
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
129
AT commands interface
<class> 1 : Voice 2 : Data 4: Fax 8 : Short Messages 7 : All classes The combination of different classes is not supported, it will only result in the activation / deactivation / status request of all classes (7). <alpha> : optionnal string type alphanumeric representation of <number> corresponding to the entry found in the SUCCESSFUL or FDN phonebook.
10.5
10.5.1
This command allows control of the calling line identification restriction supplementary service.
10.5.2
Syntax :
AT+CLIR=<n> +CLIR :<n>,<m> Command (for AT+CLIR ?) Possible responses OK Note : Command valid +CLIR :<n>,<m> OK Note : <n> and <m> defined as below
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
130
AT commands interface
10.5.3
Defined values :
<n> : parameter sets the adjustment for outgoing calls <n> 0 : Presentation indicator is used according to the subscription of the CLIR service 1 : CLIR invocation 2 : CLIR suppression <m> : parameter shows the subscriber CLIR status in the network <m> 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
10.6
10.6.1
This command allows the control of the calling line identification presentation supplementary service. When the presentation of the CLI (Calling Line Identification) is enabled (and calling subcriber allows), +CLIP response is returned after every RING (or +CRING) result code.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
131
AT commands interface
10.6.2
Syntax :
AT+CLIP=<n> +CLIP: <n>,<m> for AT+CLIP?
+CLIP: <number>, <type>[ ,<subaddr>, <satype>, <alpha> ] for an incoming call, after each RING or +CRING indication Command AT+CLIP=1 Note : Enable CLIP AT+CLIP? Note : Ask for current functionality OK Note : CLIP is enabled +CLIP:<n>,<m> OK Note : <n> and <m> defined as below RING
Note : Incoming call
Possible responses
+CLIP: 0146290800,129,1,,,FRED or
+CLIP: 0146290800,129,1,,,8000204212FFFF (UCS2 format)
Note : Incoming call with number and name presentation AT+CLIP=0 Note : Disable CLIP presentation OK Note : Command valid
10.6.3
Defined values :
<n> : parameter sets/shows the result code presentation in the TA <n> 0 : Disable 1 : Enable
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
132
AT commands interface
<m> : parameter shows the subscriber CLIP service status in the network <m> 0 : CLIP not provisioned 1 : CLIP provisioned 2 : Unknown (no network)
10.7
10.7.1
This command allows control of the connected line identification presentation supplementary service, useful in case of call forwarding of the connected line.
10.7.2
Syntax :
AT+COLP=<n> +COLP: <n>,<m> for AT+COLP? +COLP: <number>,<type> [ ,<subaddr>, <satype>, <alpha> ] after ATD command, before OK or CONNECT <speed> Command Possible responses 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)
AT+COLP=1 Note : Activate COLP AT+COLP? Note : Ask for current functionality ATD146290928;
Note : Outgoing call
OK Note : Connected outgoing line number and name presentation AT+COLP=0 Note : Desactivate COLP OK Note : Command valid
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
133
AT commands interface
10.7.3
Defined values
<n> : parameter sets/shows the result code presentation status in the TA <n> 0 : Disable 1 : Enable
<m> : parameter shows the subscriber COLP service status in the network <m> 0 : COLP not provisioned 1 : COLP provisioned 2 : Unknown (no network)
10.8
10.8.1
This refers to Advice of Charge supplementary service (GSM 02.24 [] and GSM 02.86 []) which enables the subscriber to get information about the calls cost. With <mode>=0, the execute command returns the current call meter value (CCM) from the ME. If AOC is supported, the command also includes the possibility to enable an unsolicited event reporting of the CCM information. The unsolicited result code +CCCM: <ccm> is sent when the CCM value changes. Deactivation of the unsolicited event reporting is made with the same command. If AOC is supported, the Read command indicates whether the unsolicited reporting is activated or not.
10.8.2
Syntax :
AT+CAOC= <mode> Command Possible responses +CAOC: 000A08 OK Note : Display Current Call Meter value (CCM=2568)
Command syntax :
AT+CAOC=1
OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
134
AT commands interface
Note : Deactivate unsolicited report of CCM value Note : CCM report deactivated AT+CAOC=2
Note : Activate unsolicited report of CCM value
OK Note : CCM report activated +CAOC :<mode> OK Note : Display unsolicited report mode (1 or 2)
AT+CAOC=?
Note : Request supported modes
10.8.3
Defined values :
<mode> 0 : query CCM value 1 : deactivate the unsolicited reporting of CCM value 2 : activate the unsolicited reporting of CCM value string type; three bytes of the current call meter value in hexadecimal format. (e.g. 00001E indicates decimal value 30); value is in home units and bytes are similarly coded as ACMmax value in the SIM
<ccm>
10.9
10.9.1
Set command resets the Advice of Charge related accumulated call meter value in SIM file EFACM. 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. Read command returns the current value of ACM. Then ACM value (entered or displayed) is in hexadecimal format with 6 digits.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
135
AT commands interface
10.9.2
Syntax :
AT+CACM Command Possible responses +CACM: 000400 OK Note : Display ACM value (ACM=1024)
Command syntax :
AT+CACM= 1234 Note : Request ACM reset, real PIN2 is 1234 AT+CACM= 0000
Note : Request ACM reset with wrong PIN2 value
OK Note : ACM value is reset +CME ERROR : 16 Note : Incorrect password +CACM: 000000 OK Note : Display ACM value (ACM = 0)
Set command sets the Advice of Charge related accumulated call meter maximum value in SIM file EFACMmax. ACMmax contains the maximum number of home units the subscriber is allowed to consume. When ACM (refer +CACM) reaches ACMmax, then calls are prohibited. SIM PIN2 is required to set the value. If setting fails in an ME error, +CME ERROR: <err> is returned. Read command returns the current value of ACMmax. Then ACMmax value (entered or displayed) is in hexadecimal format with 6 digits.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
136
AT commands interface
10.10.2
Syntax :
AT+CAMM Command Possible responses OK Note : ACMmax updated to 1024 +CME ERROR : 16 Note : Incorrect password +CAMM : 000400 OK Note : ACMmax = 1024
Command syntax :
AT+CAMM=000400,1234 Note : Request ACMmax update, real PIN2 is 1234 AT+CAMM=000400,0000 Note : Request ACMmax update, real PIN2 is 1234 AT+CAMM ?
Note : Request ACMmax value
Set command sets the parameters of Advice of Charge related price per unit and currency table in SIM file EFPUCT. PUCT information can be used to convert the home units (as used in +CAOC, +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.
10.11.2
Syntax :
Command Possible responses OK Note : + CME ERROR : 16
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
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
137
AT commands interface
PIN2) AT+CPUC?
Note : Request Currency and Price
Note : Incorrect password +CPUC:FFR,0.82 OK Note : Currency= FFR Price per unit= 0.82
This command is used to manage call hold and multiparty conversation (conference call). Calls can be put on hold, recovered, released or added to conversation.
10.12.2
Syntax :
AT+CHLD= < n > +CHLD: (0-4, 11-17, 21-27) for AT+CHLD=?
10.12.3
Defined values
0: 1: 1X: 2: 2X : 3: 4: Release all held calls or set User Determined User Busy (UDUB) for a waiting call. Release all active calls (if any exist) and accepts the other (held or waiting) call. Release a specific call X (active, held or waiting) Place all active calls (if any exist) on hold and accepts the other (held or waiting) call. Place all active calls on hold except call X with which communication is supported. Adds a held call to the conversation. Connects the two calls and disconnects the subscriber from both calls (Explicit Call Transfer).
<n>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
138
AT commands interface
10.13.2
Syntax :
AT+CLCC OK if no calls are available
+CLCC : <id1>, <dir>, <stat>, <mode>, <mpty> [ ,<number>, <type> [ <alpha> ] ] [ <CR><LF> +CLCC: <id2>, <dir>, <stat>, <mode>, <mpty> [ ,<number>, <type> [ <alpha> ] ] [. . . ] ] ]
10.13.3
Defined values :
<idx> integer type, call identification as described in GSM 02.30 <dir> 0 : mobile originated (MO) call 1: mobile terminated (MT) call
<stat> (state of the call): <stat> 0 : active 1 : held 2 : dialing (MO call) 3 : alerting (MO call) 4 : incoming (MT call) 5 : waiting (MT call)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
139
AT commands interface
<mpty>
0 : call is not one of multiparty (conference) call parties 1 : call is one of multiparty (conference) call parties
string type phone number in format specified by <type> type of address octet in integer format optional string type alphanumeric representation of <number> corresponding to the entry found in phonebook. (for UCS2 format see commands examples +CLIP, +CCWA or +COLP)
This command refers to supplementary service related network initiated notifications. 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.
10.14.2
Syntax :
AT+CSSN= <n>, <m> +CSSN: <n>, <m> for AT+CSSN?
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
140
AT commands interface
10.14.3
Defined values
<n> (parameter sets/shows the +CSSI result code presentation status) : 0 : disable 1 : enable <m> (parameter sets/shows the +CSSU result code presentation status) : 0 : disable 1 : enable <code1> 4 : Closed User Group call, with CUG <index> 5 : outgoing calls are barred 6 : incoming calls are barred 7 : CLIR suppresssion rejected 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 Transfert operation (during a voice call) 8 : call has been connected with the other remote party in Explicit Call Transfert operation (during a voice call, <number> & <type> fields may be present) Closed User Group index String type phone number type of address
<code2>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
141
AT commands interface
It is based on digit sequences which may be entered by mobile user with a handset. An entered sequence is sent to the network which answers back with a alphanumerical string, only to display, or to display and to ask for a next sequence. This command is used to : - enable or disable the CUSD indication sent to the application by the module when a incomming USSD is received 1 send and receive USSD strings. For the first behavior, the syntax is :
10.15.2
Syntax :
AT+CUSD = <n> [ ,<str> [ <dcs> ] ]
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
142
AT commands interface
10.15.3
Defined values :
0 : Disable the result code presentation 1 : Enable the result code presentation 2 : Cancel session (not applicable to read command response)
<n>
In case of enabled presentation, a +CUSD (as direct answer to a send USSD) is then indicated with : +CUSD: <m> [,<str>,<dcs> ] <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 sheme received (GSM TS 03.38).
10.15.4
Command syntax:
Note : Please, be aware that the send command asks the user to re-enter the enable/disable (<n>) parameter !
10.15.5
<str> is the USSD string to be sent. <dcs> the default alphabet and the UCS2 alphabet are supported. When the module sends an USSD, an OK response is first returned. The intermediate +CUSD indication comes after. In case of error, a +CUSD: 4 indication is returned back.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
143
AT commands interface
The Closed User Group Supplementary Service enables subscribers to form closed user groups to and from which access is restricted. The CUG supplementary service is described by the GSM 02.85. This service shall be provided after prior arrangement with the service provider. At provision subscription options should be selected. +CCUG command is used to : activate/deactivate the control of the CUG information for all following outgoing calls. select a CUG index, suppress the outgoing access (OA). The OA allows a member of a CUG to place calls outside the CUG. Suppress the preferential CUG. The preferential is the default CUG used by the network when it does not receive explicit CUG index.
10.16.2
Syntax :
AT+CCUG = <n> [ ,<index> [ <info> ] ]
Command syntax:
10.16.3
Defined values :
<n> 0: 1: Disable CUG mode (default) Enable CUG mode
<index> 0-9 : CUG index (0 default), 1 : Preferred CUG <info> 0: 1: 2: 3: No information (default) Suppress OA Suppress preferential CUG Suppress OA and preferential CUG
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.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
144
AT commands interface
11 Data commands
11.1 Using AT Commands during a data connection
Using AT Commands during a data connection, while the module is in online mode, needs either to switch to offline mode, or to use specific +WMUX command to enable Commands / Data multiplexing mode.
11.1.1
For switching from online mode to offline mode, the +++ sequence must be entered. Then, the module is back on offline mode with an OK response, and AT commands can be entered as usual. Note : the +++ sequence only works with +ICF command following settings. 8 data bits, with no parity 7 data bits, with even parity
11.1.2
11.2
11.2.1
This command applies to both outgoing and incoming data calls but in a different way. For outgoing call the two parameters (e.g. <speed> and <ce>) apply, whereas for incoming call only the <ce> parameter applies. Note 1) as far as incoming calls are concerned, if <ce> is set to T only and the network proposes NT only or vice versa, then the call is released. Note 2) former values 100 and 101 for <ce> are retained for compatibility purpose but shall not be used anymore, values 2 and 3 shall be used instead.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
145
AT commands interface
11.2.2
Syntax :
AT+CBST= <speed>, <name>, <ce> Command Possible responses +CBST: (0-8,65,66,68,70,71),(0),(0-3) OK Note : Data 14,4 kbps not supported
Command syntax:
11.2.3
Defined values :
No data compression is provided and only asynchronous modem is supported (<name> = 0). <speed> 0(default) : Autobauding 1: 300 bps 2: 1200 bps 3: 1200/75 bps 4: 2400 bps 5: 2400 bps 6: 4800 bps 7: 9600 bps 8: Specific 12(*) : 9600 bps 14(**) : 1400 bps (Modem type : none) (Modem type : V.21) (Modem type V.22) (Modem type : V.23) (Modem type : V.22bis) (Modem type : V.26ter) (Modem type : V.32) (Modem type : V.32) (Modem type : V.34) (Modem type : V.34)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
146
AT commands interface
65 : 66 : 68 : 70 : 71 : 75(*) :
300 bps 1200 bps 2400 bps 4800 bps 9600 bps 14400 bps
(Modem type : V.110) (Modem type : V.110) (Modem type : V.110) (Modem type : V.110) (Modem type : V.110) (Modem type V.110)
(*) Available for WISMO2C only (**) Available for WISMO2C only. This speed configure the data and fax 14.4 kbps bearers.
<ce> : Connection element <ce> 0 : Transparent only 1 (default) : Non transparent only 2 : Transparent preferred 3 : Non transparent preferred
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
147
AT commands interface
11.3
11.3.1
11.3.2
Syntax :
AT+FCLASS= <n> Command Possible responses +FCLASS: (0,1) OK Note : Fax class 2 not supported +FCLASS: (0,1,2) OK Note : Fax class 2 supported OK Note : Command valid OK Note : Command valid +FCLASS: 1 OK
Command syntax:
AT+FCLASS=? Note : Test command AT+FCLASS=? Note : Test command AT+FCLASS=0 Note : Data mode asked AT+FCLASS=1 Note : Fax class 1 mode asked AT+FCLASS?
11.3.3
Defined values :
<n> 0 : Data 1 : Fax class 1 2(*) : Fax class 2
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
148
AT commands interface
11.4
11.4.1
This command enables a more detailed service reporting, in case of data incoming or outgoing call. Before sending the CONNECT response to the application, the GSM module will precise the type of data connection that have been established. These report types are : +CR: ASYNC +CR: REL ASYNC For asynchronous transparent For asynchronous non-transparent
11.4.2
Syntax :
AT+CR Command Possible responses OK Note : Command valid OK Note : Command valid
Command syntax :
AT+CR=0 Note : Extended reports disabled AT+CR=1 Note : Extended reports enabled
11.5
11.5.1
This command enables a more detailed ring indication, in case of 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 +CRING: REL ASYNC +CRING: VOICE for asynchronous transparent for asynchronous non-transparent for normal speech.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
149
AT commands interface
+CRING : FAX
11.5.2
Syntax :
AT+CRC Command Possible responses OK Note : Command valid OK Note : Command valid
Command syntax :
AT+CRC=0 Note : Extended reports disabled AT+CRC=1 Note : Extended reports enabled
11.6
11.6.1
This parameter controls whether or not the extended-format +ILRR:<rate> information text is transmitted from the DCE to the DTE. The <rate> reported shall represent the current (negotiated or renegotiated) DTE-DCE rate. If enabled, the intermediate result code is transmitted in a data incoming or outgoing call, after any data compression report, and before any final result code (CONNECT). <rate> can take the following values: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
150
AT commands interface
11.6.2
Syntax :
AT+ILRR Command Possible responses OK Note : Command valid OK Note : Command valid
Command syntax :
AT+ILRR=0 Note : Local port rate report disabled AT+ILRR=1 Note : Local port rate report enabled
11.7
11.7.1
This command allows to change the radio link protocol parameters used for non transparent data transmission.
11.7.2
Syntax :
AT+CRLP=<iws>,<mws>,<T1>,<N2>, <ver> Command Possible responses +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
Command syntax:
AT+CRLP?
Note : Current values
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
151
AT commands interface
11.7.3
Defined values :
This command accepts 5 parameters. <iws> <mws> <T1> <N2> <ver> 0-61 0-61 : 40-255 : 1-255 : 0-1 : Down window size, (default is 61), Up window size, (default is 61), Acknowledgement timer in units of 10ms, (default is 48), Retransmission attempts, (default is 6), Version number. If the V42bis is supported (Wismo2C) the version is 1. If the V42bis is not supported the version is 0
11.8
11.8.1
This Wavecom specific command allows to change some supplementary radio link protocol parameters.
11.8.2
Syntax :
AT+DOPT=<reset_allowed>,<dtx_allowed> Command Possible responses (0,1),(0) OK Note : DTX not supported (WISMO1B)
Command syntax:
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
152
AT commands interface
AT+DOPT+?
Note : Test command
11.8.3
Defined values :
<reset_allowed> 0: Data communication is hung up in case of bad radio link.
1(default) : Data communication goes on in case of bad radio link (possible loose of data) The <dtx_allowed> parameter is used for WISMO2C only. < dtx_allowed > 0 : Normal mode 1(default) : Economic battery mode (not supported by all networks)
11.9
11.9.1
This command enables or disables data compression negotiation if this feature is provided by the module. This command is available for WISMO2C only.
11.9.2
Syntax :
Command syntax : AT%C<n>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
153
AT commands interface
Possible responses OK Note : Feature supported OK Note : V42bis supported 2 OK Note : Command valid
11.9.3
Defined values :
<n> 0(default) : no compression 2: V42bis compression if supported
11.10
11.10.1
This command enables or disables V.42bis data compression if this feature is provided by the module. This command is available for WISMO2C only.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
154
AT commands interface
11.10.2
Syntax :
AT+DS=<dir>,<neg>,<P1>,<P2> Command Possible responses +DS: (0-3),(0,1),(512-4096),(6-250) OK Note :
Command syntax :
11.10.3
Defined values :
It accepts four numeric subparameters: < dir >:specifies the desired direction(s) of operation of the data compression function; from the DTE point of view, (default is 3), <dir> 0 : Negotiated no compression 1 : Transmit only 2 : Receive only 3 : Both directions, accept any direction
< neg >: specifies whether or not the DCE should continue to operate if the desired result is not obtained, (default is 0), < neg > 0 : Do not disconnect if V.42 bis is not negotiated by the remote DCE as specified in <dir> 1 : Disconnect if V.42 bis is not negotiated by the remote DCE as specified in <dir>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
155
AT commands interface
512-4096 : which specifies the maximum number of dictionary entries which should be negotiated, (default is 4096), 6-250 : which specifies the maximum string length to be negotiated, (default is 20),
If this feature is provided by the module, this command determines whether or not the use of V42bis is informed in a data incoming or outgoing call,. The intermediate result code shall represent the current DCE-DCE data compression type. The format of this result code is the following: +DR: NONE +DR: V42B +DR: V42B RD +DR: V42B TD Data compression is not in use Rec. V.42 bis is in use in both directions Rec. V.42 bis is in use in receive direction only 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,before the +ILRR intermediate report, and after the service report control +CR.
11.11.2
Syntax :
AT+DR Command Possible responses +DR: (0-1) OK Note :
Command syntax :
AT+DR=1
OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
156
AT commands interface
If this feature is provided by the module, this command controls the preferred error correcting mode in a data connection. It can only be used for transparent data transmission. This command is available for WISMO2C only. If V42 feature is provided, the module authorizes the LAPM error correction mode. If MNP2 feature is provided, the module authorizes the MNP error correction mode.
11.12.2
Syntax :
AT\N<n> Command Possible responses OK
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
157
AT commands interface
11.12.3
Defined values :
<n> 0(default) : Disables error correction mode 2 : Selects an auto reliable mode(LAPM connection,then MNP connection) 4 : Selects LAPM error correction mode 5 : Selects MNP error correction mode
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
158
AT commands interface
12 Fax commands
The fax service provided by the module is class 1 compatible. However only the core commands defined by ITU T.31 are supported. It means that commands like AT+FAR, +FCC, are not supported. Autobauding has to be enabled to set up the module for fax. All set commands below return an ERROR response code if they are not issued during the communication.
12.1
12.1.1
12.1.2
Syntax :
AT+FTM=<speed> Command Possible responses (24,48,72,96) OK Note : Fax 14.4 kbps not supported (WISMO1B)
Command syntax:
12.1.3
Defined values :
<speed> 24 48 : 2400 bps : 4800 bps (Modem type : V.27ter) (Modem type : V.27ter)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
159
AT commands interface
72 : 7200 bps 73(*) : 7200 bps (long) 74(*) : 7200 bps (short) 96 : 9600 bps 97(*) : 9600 bps (long) 98(*) : 9600 bps (short) 121(*) : 12000 bps (long) 122(*) : 12000 bps (short) 145(*) : 14400 bps (long) 146(*) : 14400 bps (short)
(*) Available for WISMO 2C only
(Modem type : V.29) (Modem type : V.17) (Modem type : V.17) (Modem type : V.29) (Modem type : V.17) (Modem type : V.17) (Modem type : V.17) (Modem type : V.17) (Modem type : V.17) (Modem type : V.17)
12.2
12.2.1
12.2.2
Syntax :
Command syntax: Command AT+FRM=<speed> Possible responses (24,48,72,96) OK Note : Fax 14.4 kbps not supported (WISMO1B)
12.2.3
Defined values :
The speed values are the same than these of +FTM command (see 12.1.3 Defined values).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
160
AT commands interface
12.3
12.3.1
This command sets the fax transmit speed, using the HDLC protocol.
12.3.2
: Syntax
Command syntax: Command AT+FTH=<speed> Possible responses (3) OK Note :
12.3.3
Defined values :
<speed> can only take the value 3, which corresponds to V.21 channels 300 bps.
12.4
12.4.1
This command sets the fax receive speed, using the HDLC protocol.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
161
AT commands interface
12.4.2
Syntax :
Command syntax: Command AT+FRH=<speed> Possible responses (3) OK Note :
12.4.3
Defined values :
<speed> can only take the value 3, which corresponds to V.21 channels 300 bps.
12.5
12.5.1
12.5.2
Syntax :
Command syntax: Command AT+FTS=<n> Possible responses (0-255) OK Note :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
162
AT commands interface
12.5.3
Defined values :
12.6
12.6.1
This command causes the modem to stop listening from the network and report back to the DTE after the specified period. It is aborted if any character is received from the application.
12.6.2
Syntax :
AT+FRS=<n> Command Possible responses (0-255) OK Note :
Command syntax:
12.6.3
Defined values :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
163
AT commands interface
12.7
It should be configured as follows (menu Setup/Fax Modem Setup) : Port: any com Model: Generic Class 1 (hardware flow control). A generic class 1 with software flow control can also be selected. Init: default string is suitable for the module Reset: default string is suitable for the module Maximum Transmit Rate: 9600 baud (if higher then rate will be automatically cut back to 9600 baud). Others settings are of no relevance for the GSM unit: they can be modified.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
164
AT commands interface
13.1
13.1.1
13.1.2
Syntax :
AT+FDT
Command syntax:
13.2
13.2.1
13.2.2
Syntax :
AT+FDR
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
165
AT commands interface
13.3
13.3.1
This command punctuates page and document transmission after +FDT commands. It indicates that the current page is complete, and whether or not there are additional pages to be sent.
13.3.2
Syntax :
AT+FET=<ppm>
Command syntax:
13.3.3
Defined values :
<ppm> 0 : Another page next, same document 1 : Another document next 2 : No more pages or documents 3 : Another partial page next 4 : Another page, procedure interrupt 5 : Another document, procedure interrrupt 6 : All done, procedure interrupt
13.4
13.4.1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
166
AT commands interface
13.4.2
Syntax :
AT+FPTS=<ppr>
Command syntax:
13.4.3
Defined values :
<ppm> 1 : Page good 2 : Page bad ; retrain requested 3 : page good ; retrain requested 4 : Page bad ; interrupt requested 5 : Page good ; interrupt requested
13.5
13.5.1
13.5.2
Syntax :
AT+FK
Command syntax:
13.6
13.6.1
This command sets the bit order for negociation and fax page transfer. The order is related to the bit order or radio link.
13.6.2
Syntax :
AT+FBOR=<n> Command Possible responses (0-3) OK Note :
Command syntax:
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
167
AT commands interface
13.6.3
Defined values :
<n> Bit order for negociation Same Same Reverse Reverse Bit order for page transfer Same Reverse Same Reverse
0(default) 1 2 3
13.7
13.7.1
This command request the size of the exchange buffer between the modem and the fax application. Only the read command is supported.
13.7.2
Syntax :
At+FBUF Command Possible responses 1024 OK Note : Command valid
Command syntax :
13.8
13.8.1
This command controls the Copy Quality checking for receiving faxs.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
168
AT commands interface
13.8.2
Syntax :
AT+FCQ=<n> Command Possible responses (0) OK Note :
Command syntax :
13.9
13.9.1
13.9.2
Syntax :
AT+FCR=<n> Command Possible responses (0,1) OK Note :
Command syntax:
13.9.3
Defined values :
<n> 0 : The modem will not accept incoming faxs. 1(default) : The modem will accept incoming faxs.
This command allows the DTE to parameter the capabilities used for the current session.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
169
AT commands interface
13.10.2
Syntax :
AT+FDIS=<vr>,<br>,<wd>,<ln>,<df>,<ec>,<bf>,<st> Command Possible responses (0,1),(0-5),(0-2),(0-2),(0-3),(0),(0),(0-7)
Command syntax:
AT+FDIS=? Note :
OK Note : Fax ECM not supported Fax 14,4 kbps supported (0,1),(0-3),(0-2),(0-2),(0-3),(0),(0),(0-7) OK Note : Fax ECM not supported Fax 14,4 kbps not supported
13.10.3
Defined values :
This command accepts eight numeric parameters (of the T30 standard): <vr> : Vertical Resolution, < vr > 0(default) : Normal: 98 lpi 1 : Fine: 196 lpi <br> : Bit Rate, < br > 0: 2400 bps 1: 4800 bps 2: 7200 bps 3: 9600 bps 4(*) : 12000 bps 5(*) : 14400 bps (Modem type : V.27 ter) (Modem type : V.27 ter) (Modem type : V.29) (Modem type : V.29, V.17) (Modem type : V.33, V.17) (Modem type : V.33, V.17)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
170
AT commands interface
< wd >
0(default) : 1728 pixels in 215 mm 1: 2048 pixels in 255 mm 2: 2432 pixels in 303 mm
<ln> : Page Length, < in > 0 : A4, 297 mm 1 : B4, 364 mm 2(default) : Unlimited
<df> : Data Compression Format, < df > 0(default) : 1-D modified huffman 1: 2-D modified read 2: 2-D uncompressed mode 3: 2-D modified modified read
<ec> : Error Correction, < ec > 0 : Disable Fax ECM 1(*) : Enable Fax ECM, 64 bytes/frame 2(*) : Enable Fax ECM, 256 bytes/frame
(*) Only when module supports fax Error Correction Mode feature
If this feature is supported, default is 2, else default is 0. <bf> : Binary File Transfer, Only <bf> set to 0 is supported.
<st> : Scan Time per line, <st> 0(default) 1 2 3 4 Description <vr>=0 0 ms 5 ms 10 ms 10 ms 20 ms Description <vr>=1 0 ms 5 ms 5 ms 10 ms 10 ms
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
171
AT commands interface
5 6 7
20 ms 40 ms 40 ms
20 ms 20 ms 40 ms
This command allows the DTE to parameter the capabilities used for anyl sessions.
13.11.2
Syntax :
AT+FDCC=<vr>,<br>,<wd>,<ln>,<df>,<ec>,<bf>,<st> Command Possible responses (0,1),(0-5),(0-2),(0-2),(0-3),(0-2),(0),(0-7) OK
Note : Fax ECM supported
Command syntax:
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
172
AT commands interface
OK
Note : Fax ECM not supported
13.11.3
Defined values :
The parameters and default values are the same as these of +FDIS command (see 13.10.3 Defined values).
13.12.2
Syntax :
AT+FLID=<string>
Command syntax:
The string has a limited size, and accepts any characters between 32 and 127. Command AT+FLID=? Note : Test command (20),(32-127) OK Possible responses
This command sets the period the modem waits for another page before it assumes there are no more pages and aborts.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
173
AT commands interface
13.13.2
Syntax :
AT+FPHCT0=<n> (default is 30) Command Possible responses (0-255) OK
Command syntax:
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
174
AT commands interface
+FET <ppm>: This response reports post page message response. The parameter is the same than the one of AT+FET command (see 13.3). +FHNG <cause>: This response reports the hangup cause. It indicates that the call has been terminated. <cause> 0 : Normal end of connection. 10 : Unspecified transmit phase A error. 20 : Unspecified transmit phase B error. 40 : Unspecified transmit phase C error. 50 : Unspecified transmit phase D error. 70 : Unspecified receive phase B error. 90 : Unspecified receive phase C error. 100 : Unspecified receive phase D error.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
175
AT commands interface
14
14.1
14.1.1
V24-V25 commands
Fixed DTE rate +IPR
Description :
This commands specifies the data rate at which the DCE will accept commands.
14.1.2
Syntax :
AT+IPR Command Possible responses +IPR: 9600 OK Note : Current rate is 9600 bps
Command syntax :
AT+IPR? Note :
AT+IPR=? Note :
OK Note : Disable autobauding and set rate to 38400 bps OK Note : Enable autobauding
Note (*) : first set of values indicates the range of autodetectable speeds. The second set of values indicates all the possible speeds which can be used by DCE.
An autobauding is provided which operates from 2400 to 19200 baud. However some constraints have to be dealt with :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
176
AT commands interface
any AT command issued by DTE must start with a capital A and T (or \). If not, DCE may send back some garbage characters and get de-synchronized. Shoud it happen, DTE shall just issue once or twice AT\r (at 2400 or 4800 baud) or just AT (at 9600 baud) to get the modem re-synchronized.
the DTE shall wait 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. Shoud this delay ignored, DCE can get de-synchronised. Once again, sending once or twice AT\r or just AT causes the DCE to recover. Be careful : when starting up if autobauding is enabled and no AT command has been received yet, the module sends all unsolicited responses (like RING) at 9600 baud.
14.2
14.2.1
This command is used to determine the local serial port start-stop (asynchronous) character framing that the DCE shall use.
14.2.2
Syntax :
AT+ICF= <format>, <parity> Command Possible responses +ICF: 3,4 OK Note : Current values
Command syntax:
AT+ICF? Note :
AT+ICF=? Note :
AT+IPR=38400 Note :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
177
AT commands interface
AT+ICF=0,0 Note :
14.2.3
Defined values :
<format> 0 : Autodetect 1 : 8 Data 2 Stop 2 : 8 Data 1 Parity 1 Stop 3 : 8 Data 1 Stop 4 : 7 Data 2 Stop 5 : 7 Data 1 Parity 1 Stop 6 : 7 Data 1 Stop 0 : Odd 1 : Even 2 : Mark 3 : Space 4 : None (not supported) (supported) (supported) (supported) (supported) (supported) (supported) (supported) (supported) (supported) (supported) (supported)
<parity>
Note 1) setting a character framing different from 8N1 will disable autobauding (in the case it was activated). However setting it back to 8N1 will not re-enable autobaud. Note 2) setting the framing to 8N1 will let the autobauding enabled, if it was already enabled (implying framing was already 8N1).
14.3
14.3.1
+IFC
This command is used to control the operation of local flow control between the DTE and DCE.
14.3.2
Syntax :
AT+IFC=<DCE_by_DTE>,<DTE_by_DCE> Command Possible responses +IFC: 2,2 OK
Command syntax :
AT+IFC? Note :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
178
AT commands interface
Note : Current values AT+IFC=? Note : +ICF: (0,2),(0,2) OK Note : Possible values AT+ICF=0,0 Note : OK Note : New values
14.3.3
Defined values :
< DCE_by_DTE > 0 : none 1 : Xon/Xoff local circuit 103 2 : RTS 3 : Xon/Xoff global on circuit 103 (Supported) (not supported) (Supported) (not supported)
Important note : when this parameter is set to 2 (DTE invokes flow control through RTS) the behavior of the DCE is the following : If the DCE has never detected RTS in high (or ON) condition since startup then it ignores RTS, assuming this signal is not connected. As soon as DCE detects RTS high, then this signal acts upon it. Therefore subsequent RTS transition to OFF will prevent DCE from sending any further data in online and in offline as well. This behavior allows the user to use the default settings (hardware flow control) and let RTS disconnected. In the case RTS is connected and is high at least once then it acts upon DCE.
When this parameter is set to 0 (none) then CTS is kept high all the time.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
179
AT commands interface
14.4
14.4.1
14.4.2
Syntax :
AT&C Command Possible responses OK Note : Command valid OK Note : Command valid
Command syntax :
AT&C0 Note : DCD always on AT&C1 Note : DCD matches state of the remote modems data carrier
14.5
14.5.1
14.5.2
Syntax :
AT&D Command Possible responses OK Note : Command valid OK
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
180
AT commands interface
Note : Modem switches from data to command mode when DTR switches from ON to OFF AT&D2
Note : Upon DTR switch from ON to OFF, the call Note : Command valid is cleardown
14.6
14.6.1
14.6.2
Syntax :
AT&S Command Possible responses OK Note : Command valid OK Note : Command valid
Command syntax :
AT&S0 Note : DSR always on AT&S1 Note : DSR off in command mode, DSR on in data mode
14.7
14.7.1
If you have established a connection and the mobile is in online command mode, this command allows to return to online data mode.
14.7.2
Syntax
ATO
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
181
AT commands interface
Command ATO
Return from online mode to offline mode
Possible responses OK
14.8
14.8.1
14.8.2
Syntax :
ATQ Command Possible responses OK Note : Command valid (none) Note : No response
Command syntax :
ATQ0 Note : DCE transmits result codes ATQ1 Note : Result codes are suppressed and not transmitted
14.9
14.9.1
This command determines the DCE response format, with or without header characters <CR><LF>, and with the use of numeric result codes. V0 Information responses <text><CR><LF> <CR><LF> <text><CR><LF> Result codes <numeric code><CR> <CR><LF> <verbose code><CR><LF> V1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
182
AT commands interface
14.9.2
Syntax :
ATV Command Possible responses 0
Command syntax :
ATV0
Note : DCE transmits limited headers and trailers Note : Command is valid (0 means OK) and numueric result codes ATV1 Note : DCE transmits full headers and trailers and verbose response text OK Note : Command valid
14.10.2
Syntax :
ATZ Command Possible responses Ok Note : Command valid
Command syntax :
ATZ Note :
This commands writes the active configuration to a non-volatile memory (EEPROM). Description of the stored parameters is in appendice 0
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
183
AT commands interface
14.11.2
Syntax :
AT&W Command Possible responses OK Note : Command valid
Command syntax :
AT&T0 is used to perform auto-tests. The response will be OK if no software problem is detected (EEPROM, RAM and ROM checksums), otherwise a simple ERROR response is sent. AT&T1 is used to close the audio loop, and AT&T2 is used to open the audio loop. This is used to validate the audio loop (microphone to speaker).
14.12.2
Syntax :
AT&T Command Possible responses OK Note : No software problem detected, all checksums are correct OK Note : Command valid OK Note : Command valid
Command syntax :
AT&T0 Note : Perform software auto-tests AT&T1 Note : Do the audio loop test (close) AT&T2 Note : Stop the audio loop test (open)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
184
AT commands interface
14.13 Echo E
14.13.1 Description :
This command is used to determines whether or not the modem echoes characters received by an external application (DTE).
14.13.2
Syntax :
ATE Command Possible responses OK Note : Done OK Note : Done
Command syntax :
ATE0 Note : Characters are not echoed ATE1 Note : Characters are echoed
This command is used to restore the factory settings from EEPROM. The settings which are restored are listed in appendice 18.10.
14.14.2
Syntax :
AT&F Command Possible responses OK Note : Done OK Note : Done
Command syntax :
AT&F Note : Ask for restoring the factory settings AT&F0 Note : Ask for restoring the factory settings
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
185
AT commands interface
This command is used to display modem configuration. &V &V0 &V1 &V2 : Display the modem configuration in RAM. : Display the modem configuration in EEPROM. : Display the factory modem configuration.
The parameters which are displayed are the following : Q, V, S0, S2, S3, S4, S5, +CR, +CRC, +CMEE, +CBST, +SPEAKER, +ECHO, &C, &D, %C +IPR, +ICF, +IFC
14.15.2
Syntax :
AT&V Command Possible responses Q:0 V:1 S0:000 S2:043 S3:013 S4:010 S5:008 +CR:0 +CRC:0 +CMEE:0 +CBST:0,0,1 +SPEAKER:0 +ECHO:0,0 &C:1 &D:2 %C:0 +IPR:9600 +ICF:3,4 +IFC:2,2 OK Note : Done For Echo the first value corresponds to Echo cancelation 1.
Command syntax :
This command causes the GSM module to transmit one or more lines of specific information text.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
186
AT commands interface
I0 I3 I4 I5 I6 I7
: Display the manufacturer followed by model identifications. This command is equivalent to +CGMI and +CGMM. : Display the revision identification (equivalent to +CGMR). : Display the modem configuration in RAM (equivalent to &V0). : Display the modem configuration in EEPROM (equivalent to &V1). : Display the modem data features. This command enumerates the supported data rates, data modes, and fax classes. : Display the modem voice features.
14.16.2
Syntax :
ATI Command Possible responses WAVECOM MODEM 900P OK Note : GSM 900 MHz primary band
Command syntax :
310_G250.51 806216 032199 17:04 OK Note : Software release 3.10 ,rvision 51 generated on the 21st of March 1999
DATA RATES: AUTOBAUD,300,1200,1200/75,2400,4800,9600 ,14400 DATA MODES : T/NT,ASYNCHRONOUS FAX CLASS 1,2 OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
187
AT commands interface
OK Note : Done
This specific command allows to manage the data / AT commands multiplexing mode. Cf appendice 18.13 for the Data / Commands multiplexing protocol description.
14.17.2
Syntax
AT+WMUX=<mode> Possible responses +WMUX: (0-1) OK +WMUX: 0 OK
Data / Commands multiplexing disabled.
Command syntax
AT+WMUX=1
Enable Data / Commands multiplexing.
OK
14.17.3
Defined values
0 1 Multiplexing disabled. While the module is on data communication in online mode, no AT command can be used (default). Multiplexing enabled. Data flows and AT commands are mulltiplexed on online mode, in data communication.
<mode>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
188
AT commands interface
15
15.1
15.1.1
Specific AT commands
Cell environment description +CCED
Description :
This command can be used by the application to retrieve the cell parameters of the main cell and of up to six neighbour cells. Two ways may exist for the external application to know these cell parameters : on request of the application, or automatically by the module every 5 seconds. The automatic mode is not supported during communication or registration.
15.1.2
Syntax :
AT+CCED=<mode>[, <requested dump>]
Command syntax:
15.1.3
Defined values :
<mode> 0 : One shot requested 1 : Automatic shots requested 2 : Stop automatic shots
<requested dump> 1 : Main Cell : if the Cell Identity is available MCC, MNC, LAC, CI, BSIC, BCCH Freq (absolute), RxLev, RxLev Full, RxLev Sub, RxQual, RxQual Full, RxQual Sub,Idle TS if the Cell Identity is not available MCC, MNC, LAC,, BSIC, BCCH Freq (absolute), RxLev, RxLev Full, RxLev Sub, RxQual, RxQual Full, RxQual Sub,Idle TS 2 : Neighbour1 to Neighbour6 : if the Cell Identity is available MCC, MNC, LAC, CI, BSIC, BCCH Freq (absolute), RxLev if the Cell Identity is not available
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
189
AT commands interface
MCC, MNC, LAC,, BSIC, BCCH Freq (absolute), RxLev 4 : Timing Advance Combination (addition of the values) of the requested dumped are supported. Notice that in idle mode, only RxLev measures (on the main cell and on the neighbour cells) are done. The value of these RxLev is set in the RxLev Full field for the main cell. The response will be : +CCED :<value>, , <value> OK Where <value> is the ASCII string of the values (in decimal except LAC and CI values are in hexadecimal) of the parameters. If a field can not be measured or has no sense the parameter is not filled (two consecutive commas are then found). If the <requested dump> parameter is absent, this of the last +CCED command (or 15 by default) will be taken. Values of MCC/MNC are set to 0 in case of No service
15.2
15.2.1
The CCED command has been extended to indicate the received signal strength indication (rssi) of the main cell. The principle of the command does not change :
15.2.2
Syntax :
AT+CCED=<mode>[, <requested dump>]
Command Syntax:
15.2.3
Defined values :
<mode> 0 : One shot requested 1 : Automatic shots requested 2 : Stop automatic shots 8 : Main cell RSSI indications (RxLev) from 0 to 31
<requested dump>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
190
AT commands interface
The response will be a +CSQ answer and not a +CCED answer. The 07.07 format for the +CSQ is respected. The <ber> is not evaluated by this command, so the <ber> value will always be 99. +CSQ :<rssi>, 99 OK This +CSQ answer, when automatic shots are selected, is sent every time the <rssi> measured by the module changes. This automatic shots are supported in idle mode and during communication. Combination (addition of the values) of the requested dumped (1,2,4,8) are supported but the activation or deactivation of this flow (8) does not affect the other flows. Both answer +CCED and +CSQ may be then generated. If the <requested dump> parameter is absent, the last +CCED command parameter (or 15 by default) will be taken.
15.3
15.3.1
Wavecom introduced a general mechanism to send unsollicited non standardized indication to the customer application. The yet identified unsollicited non standardized indications are : indication of a physical change on the SIM presence pin from connector (meaning SIM inserted, SIM removed) indication during a mobile originated call establishement, that the calling party is ringing. Indication of the availability of the module, after boot, to receive AT commands
15.3.2
Syntax :
AT+WIND= <IndLevel >
Command syntax:
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
191
AT commands interface
15.3.3
Defined values :
<IndLevel> 1 (bit-0) : Hardware SIM Insert / Remove indications (Rack open/close) or SIM presence after software reset Calling party alert indication Module is ready to treat AT commands (except phonebooks, AOC, SMS), but still in emergency mode. Indication that the module is ready to treat all AT commands, at the end of init or after swapping to SUCCESSFUL in case of FDN configuration Indication that a new call identifier has been created ( after an ATD command, +CCWA indication) Indication that an active, held or waiting call has been released by network or other party Network service available indication Network lost indication Audio ON indication SIM Phonebooks reload status
If <IndLevel> is equal to 0 (default value), no unsolicited +WIND: <IndNb> will occur. Combination (addition of the values) shall be used to allow more than one indication flow. 0 IndLevel 1023 The answer is OK if the value are in the previous range. The unsolicited answer will then be : +WIND : <event> [ ,<idx> ] <idx>: Call identifier, defined in +CLCC command.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
192
AT commands interface
Or for event #9 : +WIND : <event>,<phonebook>,<status>,,<phonebook>,<status> <phonebook> : SIM phonebook (SM, FD, ON, SN, EN) <status> : 0 Not Reloaded from SIM (no change since last init or SIM remove) 1 Reloaded from SIM to internal memory (at least one entry has changed) The supported events are: <event> 0 : The SIM presence pin has been detected as SIM removed (depending from the 0 bit flow) 1 : The SIM presence pin has been detected as SIM inserted 2 : Calling party is alerting 3 : Module is ready to treat AT commands (except phonebooks, AOC, SMS), at init or after AT+CFUN=1 4 : Module is ready to treat all AT commands, end of phonebook init or swap (FDN to SUCCESSFUL) 5 : Call <idx> has been created (after ATD or +CCWA) 6 : Call <idx> has been released, after a NO CARRIER, a +CSSU: 5 indication, or after the release of a call waiting 7 : The network service is available for an emergency call. 8 : The network is lost. 9 : Audio ON. 10 : Show reload status of each SIM phonebook after init phase (after Power-ON or SIM insertion). AT+WIND? Command is supported and indicates the <allowed bit flows>. AT+WIND is automatically stored in e2p. This means the &W command has not to be used. And the selected flows are always activated after boot. Default value is 0 : No flow activated. No indication. AT+WIND=? Indicates the possibles values. (0-1023)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
193
AT commands interface
15.4
15.4.1
This command is used to get a random value from the mobile station and to reenter its codes by the DES algorithm. In the way Application to GSM, a h character shall be added before the value.
15.4.2
Syntax :
AT+ALEA Command Possible responses AT+ALEA=1234567890123456 OK Note : Command valid
Command syntax :
15.5
15.5.1
This command enables or disables the data ciphering (D.E.S algorithm) of the PIN and a random value sent periodically in order to insure a more secure communication.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
194
AT commands interface
15.5.2
Syntax :
AT+CRYPT Command Possible responses OK Note : Command valid OK Note : Command valid
Command syntax :
15.6
15.6.1
This command is used to enter the key used in the D.E.S algorithm to cipher the data (PIN ). In the way Application to GSM, a h character shall be added before the value.
15.6.2
Syntax :
AT+EXPKEY Command Possible responses +EXPKEY: NO KEY Note : Key is absent OK Note : Command valid +EXPKEY: READY
Command syntax :
AT+EXPKEY? Note : Is a key stored in EEPROM ? AT+EXPKEY=h0111011101110111 Note : New key entered AT+EXPKEY?
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
195
AT commands interface
15.7
15.7.1
This command returns the status and the number of all PLMNs seen by the mobile. It also indicates the BCCH frequency number (absolute) of the strongest cell and its RxLev The response will be : +CPLMN : (<Status>,<PLMN>,<BCCHFreq>,<RxLev>) () OK
15.7.2
Syntax :
AT+CPLMN Command Possible responses +CPLMN: (2,20810,122,50),(1,20801,64,53) OK Note :
Command syntax :
AT+CPLMN=? Note :
15.7.3
Defined values :
<Status> 1: 2: available current.
The values <PLMN>, <BCCHFreq>, <RxLev> are ASCII strings (in decimal).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
196
AT commands interface
15.8
15.8.1
This command allows to get the (DC level * 1024) of ADC A and ADC B (those voltages are coded on 10 bits, see hardware specifications) or the (DC level * 1024) of ADC A, ADC B and ADC C (voltages coded on 10 bits) depending on the ADC mode. For ADC A, the value returned includes the resistor bridge. Those values are updated every 10 seconds. This command allows to set ADC mode. Mode 0 displays the values of the 2 first converters on 10 bits, mode 1 displays the values of the 3 converters coded on 10 bits as well.
15.8.2
Syntax :
AT+ADC Command Possible responses
Command syntax :
AT+ADC=<n> AT+ADC=0 OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
197
AT commands interface
mode 0 AT+ADC? +ADC: 712,698,997 OK Note : Ask the current values of converters in mode 1 Note: Adc A, Adc B, Adc C on 10 bits
15.9
15.9.1
This command enabled or disables sending of unsolicited result codes in the case of key pressing.
15.9.2
Syntax :
AT+CMER=<mode>,<keyp>,<disp>,<ind>,<bfr>
Command Syntax:
The parameters <mode>, <disp>, <ind> and <bfr> are not handled.
15.9.3
Defined values :
<keyp> (keypad) : 0 : No keypad event reporting. 1 : Keypad event reporting are routed using unsolicited
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
198
AT commands interface
5 10 15 20
6 11 16 21
7 12 17 22
8 13 18 23
9 14 19 24
Read a Language Preference value of EF-LP. The first indexes should have the highest priority.
15.10.2
Syntax :
AT+WLPR= <index > +WLPR: <value> Command Possible responses +WLPR: 4 OK Note : Four language preferences are available in EF-LP
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
199
AT commands interface
15.11.2
Syntax :
AT+WLPW=<index >,<value> OK or +CME ERROR: <err> Command Possible responses OK Note : EF-LP correctly updated
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
200
AT commands interface
Set the I/O port as an input and read the I/O pin value. Note : by default (after a reset), I/O ports configuration is set by +WIOM command.
15.12.2
Syntax
AT+WIOR=<index> +WIOR: <value> Command Possible responses +WIOR: 0 OK
GPIO number 2 is reset
AT+WIOR=2
Read I/O (number 2) value
15.12.3
Defined values
Eight I/O ports are available, so the <index> value is between [0 ; 7] range. 0 1 I/O port number <index> is reset. I/O port number <index> is set.
<index> <value>
Set the I/O port as an output and set the requested I/O pin value. Note : by default (after a reset), I/O ports configuration is set by +WIOM command.
15.13.2
Syntax
AT+WIOW=<index >,<value>
Command syntax:
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
201
AT commands interface
Command AT+WIOW=2,0
Reset I/O (number 2)
Possible responses OK
GPIO value is written
15.13.3
Defined values
Eight I/O ports are available, so the <index> value is between [0 ; 7] range. 0 1 I/O port number <index> is reset. I/O port number <index> is set.
<index> <value>
This specific command allows to set the default GPIO configuration (each GPIO direction (input or output) after reset, and each GPIO default value (if set as an output) after reset)
15.14.2
Syntax
AT+WIOM=[<GpioDir>],[<GpioVal>] Command Possible responses +WIOM: 255,0 OK
On reset, all GPIOs are set to 0, as an output.
Command Syntax
AT+WIOM?
AT+WIOM=?
+WIOM: (0-255),(0-255) OK
Parameters allowed range.
AT+WIOM=254
Set GPIO 0 as an input, and all others as an output.
OK OK +WIOM: 254,128 OK
AT+WIOM=,128
Set GPIO 7 default output value to 1.
AT+WIOM?
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
202
AT commands interface
15.14.3
Defined values
Bit table parameter (allowed range : [0 ; 255], default value : 255 (all GPIOs set as output)). Each bit represent correponding GPIO default direction : 0 for input, 1 for output. Bit table parameter (allowed range : [0 ; 255], default value : 0 (all GPIOs reset to 0)). Each bit represent corresponding GPIO default value, if it is set as an output : 0 for reset, 1 for set. GPIOs set as an input by <GpioDir> parameter do not care their corresponding value in <GpioVal> parameter.
<GpioDir>
<GpioVal>
15.15.2
Syntax
AT+WAC Return
Command syntax:
Command Syntax AT+WAC AT+WAC=? AT+WAC? Example : Command AT+COPS=? Note : Available PLMN AT+WAC Note : Abort the ask of PLMN list OK Note : OK OK
Possible responses
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
203
AT commands interface
This specific command allows to play a tone on the current speaker or on the buzzer. The frequency, gain and duration can be settled.
15.16.2
Syntax :
AT+WTONE=<mode>[,<dest>,<freq>,<gain>,<duration>] OK or +CME ERROR: <err>
Command AT+WTONE=1,1,300,9,50 Note : Play a tone AT+WTONE=0 Note : Stop playing AT+WTONE=? Note : Test command AT+WTONE? Note : Current value OK Note : Done OK Note : Done OK Note : Done ERROR Note :
Possible responses
15.16.3
Defined values :
<mode> 0: Stop playing. 1: Play a tone This parameter settles the destination (mandatory if <mode>=1) 1: Speaker 2: Buzzer
<dest> : <dest>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
204
AT commands interface
<freq> : This parameter settles the frequency (in Hz) of the tone (mandatory if <mode>=1). If <dest> is the speaker, the range is between 1Hz and 3999Hz. If <dest> is the buzzer, the range is between 1Hz and 50000Hz. <gain> (0-15) This parameter settles the gain of the tone. By default, the value is 9.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
205
AT commands interface
<gain> 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Speaker (db) 0 -0.5 -1 -1.5 -2 -3 -6 -9 -12 -15 -18 -24 -30 -36 -42 -infinite
Buzzer (db) -0.25 -0.5 -1 -1.5 -2 -3 -6 -9 -12 -15 -18 -24 -30 -40 -infinite -infinite
<duration> (0-50)
This parameter settles the duration of the tone (unit of 100 ms). When this parameter is equal to 0 (default value), the duration is infinite, and the tone can be stopped by AT+WTONE=0.
This specific command allows to play a DTMF tone on the current speaker. The DTMF, gain and duration can be settled. This command is only used to play a DTMF tone. To send a DTMF on the GSM network, use the command +VTS.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
206
AT commands interface
15.17.2
Syntax :
AT+WDTMF=<mode>[,<dtmf>,<gain>,<duration>] OK or +CME ERROR: <err> Command Possible responses OK Note : Done OK Note : Done +WDTMF: (0-1),(0-9,*,#,A,B,C,D),(0-15),(0-50) OK Note : Done
AT+WDTMF=1,*,9,100 Note : Play a DTMF tone AT+WDTMF=0 Note : Stop playing AT+WDTMF=? Note : Test command
ERROR Note :
15.17.3
Defined values :
<mode> <dtmf> <gain> 0: Stop playing. 1: Play a DTMF tone This parameter settles the DTMF to play in {0-9,*,#,A,B,C,D} (mandatory if <mode>=1) (0-15) This parameter settles the gain of the tone. The values are the same as these of +WTONE (speaker) command. By default, the value is 9. This parameter settles the duration of the tone (unit of 100 ms). When this parameter is equal to 0 (default value), the duration is infinite, and the DTMF tone can be stopped by AT+WDTMF=0.
<duration> (0-50)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
207
AT commands interface
This specific command allows to switch the module in downloading mode. The command is compatible with WISMO2C only. On WISMO 1B, ERROR is returned. The doawloding is realized with the 1K-XMODEM protocol.
15.18.2
Syntax :
AT+WDWL Command Possible responses +WDWL: 0 Note : Start of downloading Note : Downloading in progress AT+CFUN=1 Note : Reset the module at the end
Command syntax:
OK Note :
This specific command allows to configure the voice rate for the bearer voice.
(Available for outgoing call only)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
208
AT commands interface
15.19.2
Syntax :
AT+WVR=<n> Return
Command syntax :
If Half Rate available. +WVR: (0,2,3) If EFR available. +WVR: (0,1) If HR and EFR not available +WVR: (0) If HR and EFR available +WVR: (0-5)
AT+WVR?
+WVR : <n>
Command AT+WVR=1 Note : Configure voice type FR and EFR AT+WVR=6 Syntax error AT+WVR? Note : Ask the current value OK
Possible responses
OK Note :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
209
AT commands interface
15.19.3
Defined values :
<n> : Speech type. <n> 0 : FR 1 : FR and EFR 2 : FR, HR with HR prefered 3 : HR, FR with FR prefered 4 : EFR,HR with HR prefered 5 : HR,EFR with EFR prefered.
+WDR
This specific command allows to configure the data rate for the bearer data.
(Available for outgoing call only)
15.20.2
Syntax :
AT+WDR=<n> Return
Command syntax :
AT+WDR?
+WDR: <n>
Possible responses
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
210
AT commands interface
OK Note :
15.20.3
Defined values :
<n> : Data type. <n> 0 : FR 1 : FR, HR with HR prefered 2 : HR, FR with FR prefered
15.21.2
Syntax :
AT+WHWV Command Possible responses Hardware Version 4.14 OK
Command syntax :
AT+WHWV
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
211
AT commands interface
AT+WHWV
Hardware Version -. OK
This specific command allows to show the date of production. Format of the date is Week / Year.
15.22.2
Syntax :
AT+WDOP Command Possible responses Production date (W/Y): 01/2000 OK Note : Date of production present in EEPROM is WEEK: 01 / YEAR: 2000 (1st week of year 2000) Production date (W/Y) : --/---OK
Command syntax :
AT+WDOP
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
212
AT commands interface
The module dispose of 2 voice gain controlers, this specific command allows to select the microphone gain controler.
15.23.2
Syntax :
AT+WSVG = <n> Command Possible responses
Command syntax :
AT+WSVG=<n> AT+WSVG=0 OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
213
AT commands interface
15.23.3
Defined values
0 Controler 1 (Default) 1 Controler 2
<n> Controler
This specific command returns the state of a specified status. It has been created to check the state of the initialisation sequence ; the different return values are Not Started, On Going, Finished.
15.24.2
Syntax :
AT+WSTR=<status> +WSTR: <status>,<value> Command Possible responses +WSTR :<status>,<value> +WSTR: 1,2 OK
AT+WSTR=<status> AT+WSTR=1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
214
AT commands interface
15.24.3
Defined values
<status> 1 Initialisation sequence 0 Not started 1 On going 1 Finished
<value>
<status>
<value>
This specific command allows to show the received signal strenght indication (<rssi>) of a specified frequency (in absolute format).
15.25.2
Syntax :
AT+WSCAN=<absolute frequency> +WSCAN : <rssi>
Command AT+WSCAN=50 +WSCAN: 23 OK Note : Request <rssi> of absolute frequency 50 AT+WSCAN=1025 Note : Request power of absolute frequency 1025
Possible responses
Note : <rssi> is 23. CME ERROR: 3 Note : 1025 is not a valid absolute frequency
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
215
AT commands interface
15.25.3
Defined values
frenquency in absolute format : -113 dBm or less : -111 dBm
This specific command sets or returns the state of RI Mode. In pulse RI mode, an electrical pulse is sent on the Ring Indicator wire just before sending any unsolicited AT response in order not to loose these AT responses when client tasks are in sleep state. Still in this RI mode, when receiving incoming calls, electrical pulses are sent on the RI wire. In up-down RI mode, no pulse are sent before unsolicited AT response, and up-down signal are sent when receiving an incoming call.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
216
AT commands interface
15.26.2
Syntax :
AT+WRIM=<n> Command Possible responses
Command syntax:
AT+WRIM=<n> AT+WRIM=0 OK
15.26.3
Defined values
<n> 0 up-down RI mode 1 pulse RI mode
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
217
AT commands interface
This specific command allows to enable or disable the 32kHz powerdown mode. When powerdown mode is entered, the Wismo module uses 32kHz internal clock during inactivity stages. For more information about powerdown mode, see Appendix F.
15.27.2
Syntax :
AT+W32K=<mode> Command Possible responses OK Note : 32kHz powerdown mode is enabled OK Note : 32kHz powerdown mode is disabled
Command syntax :
AT+W32K=1 Note : Enable 32kHz powerdown mode AT+W32K=0 Note : Disable 32kHz powerdown mode
15.27.3
Defined values
<mode> 0 Disable 32kHz powerdown mode 1 Enable 32kHz powerdown mode
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
218
AT commands interface
This specific command allows to select a default manufacturer defined melody, which will be played on all further incoming voice calls, on the buzzer or on the speaker, according to the second parameter. If melody 0 is selected, no melody will be heard.
15.28.2
Syntax :
AT+WCDM=<melody>,<player> Command Possible responses OK
Command syntax :
AT+WCDM=0 Note : Select no melody AT+WCDM=5 Note : Select melody n5 AT+WCDM? Note : Ask the current melody
OK
+WCDM: 5,0 OK Note : Melody n5 is currently selected, and the buzzer is selected to play it. RING Note : An incoming call occurs, and the melody n5 is played on the buzzer.
OK
+WCDM: 5,1 OK Note : Now the speaker is selected to play the melody if an incoming call occurs.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
219
AT commands interface
15.28.3
Defined values
<melody> 0 110 <player> 0 No melody (default) Melody 1 to 10 Melody n<melody> will be played on the buzzer on all further incoming voice calls. (default) Melody n<melody> will be played on the speaker on all further incoming voice calls.
15.29.2
Syntax :
AT+WSSW Command Possible responses A00_00gm.2c 000000008F5DC6EA OK Note : internal software information
Command syntax :
This specific command allows to edit and display the custom character set tables. CUSTOM mode of +CSCS and +WPCS commands use this character set. In this mode, when the user enters a string, this string is converted into GSM alphabet using the Custom To GSM table. Similarly, when the user request a string display, the string is converted from GSM alphabet using the GSM To Custom table.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
220
AT commands interface
In edition mode, the edition session is terminated by <ctrl-Z>, or aborded by <ESC>. Only hexadecimal characters (09, AF) can be used. The number of characters entered must be equal to the edition range requested, or the command will abord with a +CME ERROR: 3 result.
15.30.2
Syntax :
AT+WCCS=<mode>,<table>,<char 1>[,<char 2>] Command Possible responses +WCCS: 11, 78797A2020202020097E05 OK Note : 11 characters displayed
Command syntax :
AT+WCCS=0,0,120,130 Note : Display from character 120 to character 130 of the Custom To GSM conversion table
AT+WCCS=1,0,115<CR> 20<ctrl-Z> Note : Edit character 115 of the Custom To GSM conversion table AT+WCCS=1,1,0,4<CR> 40A324A5E8<ctrl-Z> Note : Edit the 5 first characters of the GSM To Custom conversion table AT+WCCS=1,1,200
+CME ERROR: 3
Note : Edit character 200 of GSM To Custom Note : Index out of range conversion table
15.30.3
Defined values
<mode> 0 1 <table> 0 1 Display the table Edit the table Custom To GSM conversion table GSM To Custom conversion table
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
221
AT commands interface
Character range to display/edit. If only <char 1> is present, only this char is displayed/edited. for GSM To Custom conversion table for Custom To GSM conversion table
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
222
AT commands interface
15.31.2
Syntax :
AT+WLCK=<fac>,<passwd>,<NetId>[,<GID1>[,GID2]] +WLCK: <status> Command Possible responses OK Note : Network lock activated OK Note : SIM lock activated OK Note : Network Subset lock activated
AT+WLCK=PN,12345678,20810 Note : Activate network lock on SFR (208,10) AT+WLCK=PS,12345678,208105923568974 Note : Activate SIM lock AT+WLCK=PU,12345678,2081035 Note : Activate Network Subset lock on SFR
(208, 10, 35).
AT+WLCK=PU,12345678,20810
+CME ERROR: 3 Note: Need 7 digits of IMSI to perform a service provider lock
AT+WLCK=PP,12345678,20810,E5 Note : Activate Service Provider lock on SFR (208, 10) and GID1 (0xE5). AT+WLCK=PC,12345678,20810,E5,10 Note : Activate Corporate lock on SFR (208, 10), GID1 (0xE5) and GID2 (0x10).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
223
AT commands interface
The following <fac> values are supported : PS: PN: PU: PP: PC: SIM lock facility with a 8 digits password (PCK). Network lock with a 8 digits password (NCK). Network subset lock with a 8 digits password (NSCK). Service provider lock with a 8 digits password (SPCK). Corporate lock with a 8 digits password (CCK).
This specific command is used to activate, deactivate or interrogate a CPHS functionality (ie Voice Mail Indicator, Mail Box Number) Note : this command may answer +CME ERROR: 3 if CPHS feature is disabled (cf. +WFM command), or if the SIM card does not support the CPHS functionalities.
15.32.2
Syntax
AT+CPHS=<Mode>,<FctId> Possible responses OK +CME ERROR: 3 +CPHS: <FctId1>,<Status><CR<LF> +CPHS: <FctId2>,<Status><CR<LF>
Command syntax :
Command AT+CPHS=<Mode>,<FctId>
AT+CPHS?
+CPHS: <FctIdn>,<Status><CR<LF>
OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
224
AT commands interface
AT+CPHS=?
OK
15.32.3
Defined values:
0: Deactivate CPHS functionality 1: Activate CPHS functionality 2: Interrogate CPHS status
<Mode>
<FctId>
<Status>
15.32.4
15.32.4.1
Description :
This unsolicited indicates the status of the LINE 1, LINE 2, FAX or DATA. Syntax : Option : +WVMI: <LineId>,<Status> <LineId> 1 2 3 4 Line 1 Line 2 FAX DATA
<Status>
No message waiting.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
225
AT commands interface
15.32.5
Informative example
Interrogate the status of CPHS functionality The voice mail indicator functionality is deactivated The mail box number functionality is deactivated
Syntax error
AT+CPHS=1,1
Interrogate the status of CPHS functionality The voice mail indicator functionality is activated The mail box number functionality is deactivated
**** the message box contains 1 message ***** +WVMI: 1,1 ***** The message box contains a second message *** +WVMI: 2,1 A message is waitting on the line 2 A message is waiting on the line 1
Interrogate the status of voice mail indicator functionality a message is waiting on LINE 1 a message is waiting on LINE 2 no FAX waiting no datas waiting
AT+CPHS=1,2
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
226
AT commands interface
AT+CPHS? +CPHS: 1,1 +CPHS: 2,1 OK AT+CPHS=2,2 +WMBN: 1,"19254871234",129,1 +WMBN: 2,,,0 +WMBN: 3,,,0 +WMBN: 4,,,0 OK
Interrogate the status of CPHS functionality The voice mail indicator functionality is activated The mail box number functionality is activated
Query current mail box numbers in SIM Mail box number for Line 1 Mail box number for Line 2 Mail box number for Fax Line Mail box number for Data Line Only Line1 is updatable
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
227
AT commands interface
15.33.1.1
Description
This specific command allows to manage the charge battery (start and stop the charge, enable or disable unsolicited Battery Charge Indications (+WBCI), and set the battery charge parameters).
15.33.1.2
Syntax
AT+WBCM=<Mode>[,[<ChargeInd>][,[<BattLevelMax>], [<BattLevelMin>],[<TpulseInCharge>], [<TpulseOutCharge>],[<BattIntRes>]]] Possible responses OK OK
Command syntax :
Command AT+WBCM=0
Stop the battery charge.
AT+WBCM=1,1
Start the battery charge with indications of charge.
+WBCI: 2,4060
Unsolicited indication of charge : the current battery voltage is 4.06 V. Cf +WBCI description.
AT+WBCM=1,0
Start the battery charge without indications of charge.
OK
AT+WBCM=2
Get the battery voltage during the charge.
+WBCI: 2,4110 OK
See the description of +WBCI unsolicited response. The current battery voltage is 4.11 V.
+WBCI: 1
The battery voltage has reached the max level. The battery is considered as charged, and the charge is stopped.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
228
AT commands interface
AT+WBCM?
+WBCM: 0,0,4200,3300,100,5000,0 OK
Current values.
AT+WBCM=0,1
Enable the battery charge unsolicited indications out of charge.
OK
+WBCI: 3,4195
The current battery voltage is 4.195 V.
AT+WBCM=3,0,3800,3000,500,3000,0
Configure the battery charging parameters.
AT+WBCM=?
Get the parameters range.
15.33.1.3
<Mode>
Defined values
0 1 2 3 Stop the battery charge (default). Start the battery charge. Get the current battery voltage. Set the battery charge parameters.
Note :
with <Mode>s 0 and 1, only <ChargeInd> parameter is allowed ; <Mode> 2 does not allow any supplementary parameter ; <Mode> 3 allows all others parameters. 0 1 Disable the battery charge unsolicited indications (default). Enable the battery charge unsolicited indications (cf +WBCI description). Level max for the battery voltage. When it is reached, the battery is considered as charged. The allowed range is [4000 ; 5000]. (mV unit, default value : 4200) Level min for the battery voltage. When it is reached, the battery is considered as discharged, and the module is turned off (as for +CPOF command behaviour).
<ChargeInd>
<BattLevelMax>
<BattLevelMin>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
229
AT commands interface
The allowed range is [2800 ; 3800]. (mV unit, default value : 3300) Note : <BattLevelMax> and <BattLevelMin> parameters cannot be changed during the battery charge (when <Mode> = 1). Time between pulses for the pulsed charge. The pulse time is one second. When the battery charge is started with unsolicited charging indications (<ChargeInd> = 1), +WCBI responses are returned by the ME with a (<Pulse Time> (= 1s) + <TpulseInCharge>) period. The allowed range is [100 ; 10000]. (ms unit, default value : 100).
<TpulseInCharge>
<TpulseOutCharge> Time between +WBCI unsolicited responses, when the battery charge is stopped with charging indications requested (<ChargeInd> = 1). The allowed range is [100 ; 10000]. (ms unit, default value : 5000). <BattIntRes> Battery Internal Resistor. It must be set to have good reading values with +WBCI unsolicited results. The allowed range is [0 ; 255] ( unit, default value : 0) When the <BattIntRes> parameter is changed, the module must be resetted to take in account the modification.
Note :
15.33.2
15.33.2.1
Description
This unsolicited result returns informations about the battery charge (Level Max reached, battery current voltage, etc).
15.33.2.2
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
230
AT commands interface
15.33.2.3
Defined values
0 1 2 3 Note : Battery level min reached, and the battery is considered as discharged. The module is turned off (as for the +CPOF command behaviour). Battery level max reached, and the battery is considered as charged. The battery charge is stopped. Battery currently in charge. Battery currently out of charge.
<Status>
<Status> 2 and 3 are solicited by a AT+WBCM=2 command, or unsolicited when <ChargeInd> parameter of +WBCM command is set to 1. With these <Status> values, <BattLevel> parameter is also present. Battery current voltage during or out of the charge. The possible range is [2800 ; 5000]. (mV unit)
<BattLevel>
This specific command allows to enable or disable modules features, like the band mode, the SIM voltage, etc. Note : after a feature modification, the changes will be taken in account only after a reset of the module.
15.34.2
Syntax
AT+WFM=<mode>[,<FtrID>] +WFM: <FtrID>,<status>,<resetFlag> Possible responses +WFM: BI9001800,1,0 OK
Bi-band mode 900-1800 is enabled
Command AT+WFM=2,BI9001800
AT+WFM=1,11
Enable the Mono-band 900 mode
OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
231
AT commands interface
AT+WFM=0,61
+CME ERROR: 3
<mode> 0 is not allowed on <FtrID> values with 2 digits
AT+WFM=0,HR
Disable the Half Rate feature
OK +WFM: MONO900,1,1 +WFM: MONO1800,0,0 +WFM: MONO1900,0,0 +WFM: BI9001800,0,1 +WFM: BI9001900,0,0 +WFM: EFR,1,0 +WFM: HR,0,1 +WFM: DTXDATA,1,0 +WFM: DATA144,1,0 +WFM: SIM3VONLY,0,0 +WFM: SIM5VONLY,0,0 +WFM: SIM3AND5V,1,0 +WFM: SIMREMOVE,1,0 +WFM: NOOFFMODE,1,0 +WFM: QUICKOFF,0,0 +WFM: OFFWHENUNPLUG,0,0 +WFM: SWITCHATT,1,0 +WFM: CPHS,1,0 OK
The modified features have their <resetFlag> parameter set to 1
AT+WFM=2
Interrogate all <FtrID> status
15.34.3
Defined values
0 1 2 disable feature <FtrID> enable feature <FtrID> interrogate the status of feature <FtrID>. If <FtrID> parameter is not used, all features status are listed with several +WFM responses.
<mode>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
232
AT commands interface
<FtrID>
11 or MONO900 12 or MONO1800 13 or MONO1900 14 or BI9001800 15 or BI9001900 2 or EFR 3 or HR 4 or DTXDATA 5 or DATA144 61 or SIM3VONLY 62 or SIM5VONLY 63 or SIM3AND5V 7 or SIMREMOVE 81 or NOOFFMODE 82 or QUICKOFF 83 or OFFWHENUNPLUG 9 or SWITCHATT A or CPHS
Mono-band mode 900 MHz (def. 0) Mono-band mode 1800 MHz (def. 0) Mono-band mode 1900 MHz (def. 0) Bi-band mode 900 1800 MHz (def. 1) Bi-band mode 900 1900 MHz (def. 0) Ehanced Full Rate feature (def. 1) Half Rate feature (def. 1) Data with DTX feature (def. 1) Data 14.4 kbit/s feature (def. 1) 3V SIM voltage mode (def. 0) 5V SIM voltage mode (def. 0) Both 3 and 5V SIM voltage mode (def. 1) SIM removal feature (def. 1) No specific off mode (def. 1) Quick Off mode (def. 0) Off when unplug mode (def. 0) Switch Attenuation feature (def. 1) CPHS feature (def. 1)
Note 1 : +WFM response only use alphabetical values for <FtrID> parameter. Note 2 : for <FtrID> values with two digits (like 1x, 6x or 8x), <mode> 0 value is not allowed. Also, when a feature xa is enabled, the fact of enable an other feature xb will disable the feature xa (for example, the feature MONO900 is enabled. When we enable the feature BI9001800, the feature MONO900 is disabled). <status> <resetFlag> 0 1 0 1 the feature <FtrID> is disabled the feature <FtrID> is enabled the feature was not modified since the last module boot. the feature was modified since the last module boot ; the module has to be reset in order to take in account this modification.
Note :
If a feature is reset to its initial value after a modification, the <resetFlag> parameter will be reset to 0.
This command allows to enable or disable Wavecom specific features. Disable a feature is free, but enable one or more features needs a password. Note : after a successful feature enable or disable, the changes will be taken in account only after a reset of the module.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
233
AT commands interface
15.35.2
Syntax
AT+WCFM=<mode>,<FtrMask>[,<Password>]
Command syntax
Possible responses OK OK
AT+WCFM=1,0003,1234567890ABCDEF OK 1234567890ABCDEF1234567890ABCDEF The features are enabled (the password is correct) 1234567890ABCDEF
Enable features
15.35.3
Defined values
0 1 disable features from <FtrMask> enable features from <FtrMask>
16 bits hexadecimal string (4 characters from 0 to F) 256 bits hexadecimal string (64 characters from 0 to F)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
234
AT commands interface
This specific command allows to build the Customer storage mirror, from the current parameters values stored. In case of storage memory problem, if this mirror exist, it will be restored, else Wavecom Mirror is restored.
15.36.2
Syntax
AT+WMIR Possible responses OK OK
Command syntax
This specific command allows to select the default player of the melodies.
15.37.2
Syntax
AT+WCDP = <player>
Command syntax
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
235
AT commands interface
AT+WCDP?
+WCDP: 0
OK
15.37.3
Defined values :
<player> 0: Speaker 1: Buzzer
This specific command allows to set the different mailbox numbers in SIM. Use +CPHS command to know witch mailbox lines are updatable or not.
15.38.2
Syntax
AT+WMBN = <LineId>,<number>,<type>
Command syntax
Possible responses OK OK +WMBN: 1,"0123456789",129,1 +WMBN: 2,9876543210,129,1 +WMBN: 3,,,0 +WMBN: 4,,,0 OK
AT+WMBN=1,+33122334455,145
OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
236
AT commands interface
AT+WMBN=2,0166778899,129
Set mailbox number for line2.
OK
Mailbox number for Line2 is set.
AT+WMBN=3,0102030405,129
Set mailbox number for FAX Line.
+CME ERROR: 21
Invalid index: Fax Line mailbox number is not updatable with this SIM card..
AT+CPHS=2,2
Query again for current Mail Box Numbers
15.38.3
Defined values :
1 2 3 4 Line 1 Line 2 FAX DATA
<LineId>
Phone number in ASCII format. TON/NPI (Type of address octet in integer format). If query with AT+CPHS=2,2, indicate if number is updatable or not: 0 1 Not updatable Updatable
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
237
AT commands interface
16 SIM TOOLKIT
16.1
16.1.1
The SIM ToolKit, also known as SIM Application ToolKit introduces new functionalities, which open the way to a broad range of value added services. The principle is to allow service providers to develop new applications (i.e. for banking, travel, ticket booking ) for subscribers and to download them into the SIM. This solution allows future services to be accessible to the user by adding new SIMbased applications without modifying the handset.
16.1.2
11.14.
Functionality
SIM Toolkit refers to the functionalities described in the GSM Technical specification
It introduces about twenty five new commands for the SIM. Three classes of ToolKit functionalities have been defined, with class 1 offering a subset of commands and class 3 offering the full range of commands (See the table 1 in APPENDIX B). The SIM Application Toolkit supports: profile download, proactive SIM, data download into the SIM. menu selection, call control by SIM.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
238
AT commands interface
16.1.3
Profile download
The Profile Download instruction is sent by the customer application to the SIM as part of the initialization. It is used to indicate which SIM Application Toolkit features the customer application supports. The AT command used for this feature is +STSF (SIM ToolKit Set Facilities).
16.1.4
Proactive SIM
A proactive SIM provides a mechanism whereby the SIM can ask the customer application to perform certain actions. These actions include: display menu, display given text, get user input, send a short message, play the requested tone, set up a call, provide location information.
This mechanism allows SIM applications to generate powerful menu-driven sequences on the customer application and to use services available on the network. The commands used for this feature are: +STIN (SIM Toolkit Indication), +STGI (SIM Toolkit Get Information), +STGR (SIM Toolkit Give Response).
16.1.5
Data downloading to the SIM allows data (SMS, phonebook) or programs (Java applets) received by SMS or by Cell Broadcast to be transferred directly to the SIM Application. This feature does not need any AT command. It is transparent to the customer application.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
239
AT commands interface
16.1.6
Menu Selection
A set of menu items is supplied by the SIM Application ToolKit. The menu selection command can then be used to inform the SIM Application on which menu item is selected. The commands used for this feature are +STIN, +STGI and +STGR.
16.1.7
The call control mechanism allows the SIM to check all dialed numbers, supplementary service control strings and USSD strings before connecting to the network. This gives the SIM the ability to allow, bar or modify the string before the operation starts. The commands used for this feature are : +STCR (SIM Toolkit Control Response), +STGR (SIM Toolkit Give Response).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
240
AT commands interface
16.2
The following scheme shows the SIM Toolkit functionnalities commands and unsolicited results that will be implemented.
+STIN=X
STEP 2: SIM sends pro-active command
Customer Application
+STCR:X +STGR=X,XXXXXX
Step 4: User response is sent to the SIM.
On the first step the customer application informs the WAVECOM module which facilities are supported. This operation is performed with the +STSF (SIM ToolKit Set Facilities) command, which also allows to activate or deactivate the SIM Toolkit functionality. On the second step an unsolicited result +STIN (SIM ToolKit indication) is sent by the module, in order to indicate the customer application which command type the SIM Application Toolkit is running on the SIM card. The last SIM Toolkit indication can be requested by the +STIN? command. On the third step the customer application uses the +STGI (SIM ToolKit Get Information) command to get all the information about the SIM ToolKit command, given by +STIN. On the fourth step the customer application uses the +STGR (SIM Toolkit Give Response) to send its response (if any) to the SIM ToolKit Application.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
241
AT commands interface
The +STCR (SIM Toolkit Control response) indication is an unsolicited result sent by the SIM when Call control functionality is activated and before the customer application has performed any outgoing call,SMS, SS, or USSD.
16.3
16.3.1
16.3.1.1
Description
This command allows to activate, deactivate or configure the SIM ToolKit facilities.
16.3.1.2
Syntax
+STSF=<mode>[,<config>][,<Timeout>][,<AutoResponse>]
Command syntax :
Possible responses
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
242
AT commands interface
16.3.1.3
<mode>
Defined values
0 1 2 Deactivate the SIM Toolkit functionalities. Activate the SIM Toolkit functionalities. Configure the SIM Toolkit functionalities.
(hex format)
<Config> <Timeout>
(160060C01F 5FFFFFFF7F)
1-255 Timeout for user responses (muiltiple of 10 secondes). 0 1 Automatic response is not activated Automatic response is activated
<Autoresponse>
The activation or deactivation of the SIM Toolkit functionalities requires the use of +CFUN (Set phone functionality) command to reset the module (this operation is not necessary if PIN is not yet entered). The <Config> parameter contains the coding of TERMINAL PROFILE, precisely the list of SIM Application Toolkit facilities that are supported by customer application. The <Timeout> parameter contains the time (multiple of 10 secondes) dispose the user to answer (for select an item, input a text, etc). When the <Autoresponse> is activated, the +STIN indication for Play Tone (5), Refresh (7), Send SS (8), Send SMS (9) or Send USSD (10) is automatically followed by the corresponding +STGI response. Note: Some bits concerns the WAVECOM module and not the customer application. The WAVECOM module sets automatically these bits to either 0 or 1 whatever the user enters with +STSF command. Those values are given in Appendix C. Each facility is coded on 1 bit: bit = 1: facility supported by the customer application. bit = 0: facility not supported by the customer application.
Only the first five bytes of TERMINAL PROFILE (Class 2) can be configured, the other are set to 0. (See structure of TERMINAL PROFILE in APPENDIX C)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
243
AT commands interface
16.3.1.4
Error codes
+CME ERROR: 3 Operation not allowed. This error is returned when a wrong parameter is entered.
16.3.1.5
Informative example
AT+CMEE=1 OK AT+WIND=15 OK AT+CPAS +CPAS: 0 OK AT+STSF=? Test command SIM ToolKit Set Facilities Query ME Status ME is ready. Ask of Wavecom indications Enable the report mobile equipment errors
+STSF: (0-2), (160060C01F 5FFFFFFF7F),(1-255) OK AT+STSF? +STSF: 0,160060C000,3 OK AT+STSF=2,5FFFFFFF7F OK AT+STSF=3 +CME ERROR: 3 AT+STSF=1 OK AT+CFUN=1 OK AT+CPIN? +CPIN: SIM PIN AT+CPIN=0000 OK +WIND: 4 AT+STSF? +STSF: 1,5FFFFFFF7F,3 OK SIM ToolKit functionality activated with all facilities. Init phase is complete PIN Ok Is ME asking password? Yes, SIM PIN required Reboot Software. Activation of SIM ToolKit functionality Syntax Error Set all facilities SIM ToolKit (class 3). No activation of SIM ToolKit functionality
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
244
AT commands interface
16.3.2
16.3.2.1
Unsolicited result
In order to allow the customer application to identify the pro-active command sent by the SIM ToolKit, a mechanism of unsolicited SIM ToolKit indications (+STIN) will be implemented. Syntax : Option :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
245
AT commands interface
98 99
Indicates the timeout when no response from user. Indicates that a End Session has been sent from the SIM.
(*) if the automatic response parameter is activated, this indication is followed by the corresponding +STGI response.
16.3.2.2
The last SIM toolkit indication sent by the SIM can be requested by the AT+STIN? command. This command is only usable between the sent of STIN indication by the SIM (step 2 : see section 16.2) and the response of the user by the +STGI command (step 3). Command syntax : Command +STIN? Note : Ask for the last SIM toolkit indication sent by the SIM +STIN? Possible responses +STIN: 0 OK Note : the last SIM toolkit indication was a Setup Menu Note : Display the SIM toolkit application menu +CME ERROR: 4 Note : operation not supported, the +STGI command has been already used
+STGI=0 +STIN? Note : Ask for the last SIM toolkit indication sent by the SIM
16.3.3
16.3.3.1
Description
This command allows to get the information (text to display, Menu information, priorities) of a pro-active command sent from the SIM.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
246
AT commands interface
The information is returned only after receiving a SIM Toolkit indication (+STIN).
16.3.3.2
Syntax
+STGI=<CmdType> Possible responses See Table 1 +CME ERROR: <err> +STGI: (0-11)
+STGI=? OK
Table 1
Cmd Type Description Possible responses
+STGI: <Id1>,<NbItems>,<Alpha Id1 Label>,<Help Info>[,<NextActionId>]<CR><LF> +STGI: <Id2>,<NbItems>,<Alpha Id2 Label>,<Help Info>[,<NextActionId>]<CR><LF> []] No action expected from SIM.
Get information about Display text pro-active command. Get information about Get Inkey pro-active command.
+STGI: <Prior>,<Text>,<ClearMode> No action expected from SIM. +STGI: <Format>,<HelpInfo>[,<TextInfo>] SIM expects key pressed (+STGR). +STGI: <Format>,<EchoMode>,<SizeMin>,<SizeMax>, <HelpInfo>[,<TextInfo>] SIM expects key input (+STGR). +STGI: <Type>,<CalledNb>,<SubAddress>,<Class> SIM expects user authorization (+STGR).
Get information about Get Input pro-active command. Get information about Setupt call pro-active command.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
247
AT commands interface
+STGI: <Id1>,<NbItems>,<Alpha Id1 Label>,<Help Info>[,<NextActionId>]<CR><LF> +STGI: <Id2>,<NbItems>,<Alpha Id2 Label>,<Help Info>[,<NextActionId>]<CR><LF> []] SIM expects an item choice (+STGR).
Get information about Refresh pro-active command. Get information about Send SS pro-active command. Get information about Send SMS pro-active command. Get information about Send USSD pro-active command. Get information about SETUP EVENT LIST proactive command.
+STGI: <RefreshType> No action (Refresh done automatically by module). +STGI:<TextInfo> No action (Send SS done automatically by module). +STGI: <TextInfo> No action (Send SMS done automatically by module). +STGI: <TextInfo> No action (Send USSD done automatically by module). +STGI: <Evt>
10
11
16.3.3.3
Defined values
Values when CmdType=0 (Setup menu) <Alpha Idenitifer menu> <Idx> <NbItems> <Alpha Idx Label> <HelpInfo> 0 1 (1-255) (1-255) Alpha identifier of the main menu. Menu item Identifier. Number of items in the main menu. Alpha identifier label of items in ASCII format. No help information available. Help information available.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
248
AT commands interface
<NextActionId>
Compared to other commands the customer application can always get information about setup menu after having received the +STIN:0 indication.
Values when CmdType=1 (Display text) <Prior> <Text> <ClearMode> 0 1 0 1 Normal priority of display. High priority of display. Text to display in ASCII format. Clear message after a delay (3 seconds) Wait for user to clear message.
Values when CmdType=2 (Get Inkey) <Format> 0 1 2 0 1 Digit (0-9, *, #,and +) SMS alphabet default. UCS2 No help information available. Help information available. Text information in ASCII format.
<HelpInfo> <TextInfo>
Values when CmdType=3 (Get Input) <Format> 0 1 2 3 4 0 1 (1-255) (1-255) Digit (0-9, *, #,and +) SMS alphabet default. UCS2 Unpacked format. Packed format. Echo off. Echo on. Minimum length of input. Maximum length of input.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
249
AT commands interface
<HelpInfo> <TextInfo>
0 1
No help information available. Help information available. Text information in ASCII format.
Values when CmdType=4 (Setup Call) <Type> 0 1 2 <CalledNb> <SubAdress> <Class> 0 1 2 Set up call but only if not currently busy on another call. Set up call, putting all other calls (if any) on hold. Set up call, disconnecting all other calls (if any). Called party number in ASCII format. Called party sub-address in ASCII format. Voice call. Data call. Fax call
Values when CmdType=5 (Play tone) <ToneType> 0 1 2 3 4 5 6 7 8 9 Tone Dial. Tone Busy. Tone Congestion. Tone Radio ack Tone Dropped. Tone Error. Tone Call waiting. Tone Ringing. Tone General beep. Tone Positive beep.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
250
AT commands interface
Tone Negative beep. Time unit used is minutes. Time unit used is seconds. Time unit used is tenths of seconds. Time required expressed in units. Text information in ASCII format.
Values when CmdType=6 (Sel Item) <DefaultItem> (1-255) Default Item Identifier. Alpha identifier of the main menu. Identifier items. Number of items in the menu. Alpha identifier label of items in ASCII format. 0 1 No help information available. Help information available. Contains a pro-active command identifier. (see the table in APPENDIX D)
<Alpha Idenitifer menu> <Idx> <NbItems> <Alpha Idx Label> <HelpInfo> <NextActionId> (1-255) (1-255)
Values when CmdType=7 (Refresh) <RefreshType> 0 1 2 3 4 SlM initialization and full file change notification. File change notification. SIM initialization and file change notification. SIM initialization. SIM reset.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
251
AT commands interface
Values when CmdType=8 (Send SS) <TextInfo> Text information in ASCII format.
Values when CmdType=9 (Send SMS) <TextInfo> Text information in ASCII format.
Values when CmdType=10 (Send USSD) <TextInfo> Text information in ASCII format.
Values when CmdType=11 (Setup Event List) <Evt> 1 2 3 4 Reporting asked for an Idle Screen event. Reporting asked for an User Activity event. Reporting asked for Idle Screen and User Activity events. Cancellation of reporting event.
Rem :
For UCS2 format the texts are displayed in Hexa Ascii format. Example : When the SIM send a TextString contains 0x00 0x41 the text displayed is 0041.
16.3.3.4
Error codes
+ CME ERROR: 3 Operation not allowed. This error is returned when a wrong parameter is detected. Operation not supported. This error is returned when the user wants to get information about a SIM ToolKit pro-active
+CME ERROR: 4
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
252
AT commands interface
command.(With SIM ToolKit functionality not activated.) +CME ERROR: 518 SIM ToolKit indication not received. This error is returned when the SIM Toolkit indication (+STIN) has not been received.
16.3.3.5
Informative example
At the beginning, all facilities are activated, the PIN is not required and SIM toolkit functionality is activated.
AT+CMEE=1 OK AT+WIND=15 OK AT+STSF? +STSF: 1,5FFFFFFF7F,3 OK +STIN: 0 AT+STIN? +STIN: 0 OK AT+STGI=0 +STGI: SIM TOOLKIT MAIN MENU +STGI: 1,3,BANK,0 +STGI: 2,3,QUIZ,0 +STGI: 3,3,WEATHER,0 OK AT+STIN? +CME ERROR: 4 Get information about the main menu Main menu contains 3 items. The main menu has been sent from the SIM. SIM ToolKit functionality activated with all facilities. Ask of Wavecom indications Enable the report mobile equipment errors
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
253
AT commands interface
16.3.4
when the customer application makes an outgoing call or an outgoing SMS, if the call control facility is activated, CALL CONTROL and SMS CONTROL responses can be identified. It is also applicable to SS calls. Syntax : Option :
<Number>
<MODestAddr> <TextInfo>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
254
AT commands interface
16.3.5
16.3.5.1
Description
This command allows the application/user to select an item in the main menu, or to answer the following proactive commands : GET INKEY GET INPUT SELECT ITEM SETUP CALL DISPLAY TEXT SETUP EVENT LIST Key pressed from the user. Message entered by the user. Selected item. User confirmation. User confirmation to clear the message. Reporting events.
It is also possible to terminate the current proactive command session by sending a Terminal Response to the SIM, with the following parameters : BACKWARD MOVE BEYOND CAPABILITIES UNABLE TO PROCESS NO RESPONSE END SESSION Process a backward move Command beyond ME capabilities ME is currently unable to process command No response from the user User abort.
16.3.5.2
Syntax
+STGR=<CmdType>[,<Result>,<Data>]
Command syntax :
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
255
AT commands interface
Command +STGR=<CmdType>[,<Result>,<Data>] For GetInput with <Result>=1: +STGR=3,1<CR> <Data><Ctrl Z> For GetInkey with <Result>=1 +STGR=2,1,<Data> +STGR=?
Possible responses OK +CME ERROR: <err> OK +CME ERROR: <err> OK +CME ERROR: <err> OK
16.3.5.3
Defined values
0 1 2 3 4 6 11 95 96 97 98 99 Item selection in the main menu. User confirmation to clear a Disp Text. Response for a Get Inkey. Response for a Get Input. Response for a Setup call. Response for a Sel Item. Reponse for a Setup event list. Backward move Command beyond ME capabilities ME currently unable to process command No response from the user. User abort.
<CmdType>
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
256
AT commands interface
Values when CmdType=0 (Select an item from the main menu) <Result> 1 2 <Data> Item selected by the user. Help information required by user. Contains the item identifier of the item selected by the user.
Values when CmdType=2 (Get Inkey) <Result> 0 1 2 <Data> Session ended by user. Response given by the user. Help information required by user. Contains the key pressed by the user.
Values when CmdType=3 (Get Input) <Result> 0 1 2 <Data> Session ended by user. Given response given by the user. Help information required by user. Contains the string of characters entered by the user.
Rem : For Inputs in UCS2 format, the datas are entered in ASCII format. Example : For 8000410042FFFF entered, the SIM receive 0x00 0x41 0x00 0x42 with UCS2 DCS. (See the Appendix E about the different UCS2 syntaxes).
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
257
AT commands interface
Values when CmdType=4 (Setup call) <Result> 0 1 User refuse the call. User accept call.
Values when CmdType=6 (Select Item) <Result> 0 1 2 3 <Data> Session terminated by the user Item selected by the user Help information required by the user Return to the back item Contains the item identifier selected by the user
Values when CmdType=11 (Setup Event List) <Result> 1 2 Idle screen available. User activity event.
Sending a Terminal Response to the SIM : Values when CmdType=95 (Backward Move) Values when CmdType=96 (Command beyond ME capabilities) Values when CmdType=97 (ME currently unable to process command) Values when CmdType=98 (No response from the user)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
258
AT commands interface
Values when CmdType=99 (SIM Toolkit Session aborting by the user) No values. It is possible to send a Terminal Response after the +STIN indication (step 2, cf 16.2), or after the +STGI command (step 3). Note : for the SETUP MENU Proactive Command, it is only possible to send a Terminal Response after the +STIN: 0 indication, not after a +STGI=0 request. All of the Terminal Responses are not possible with all of the Proactive Commands. Compatibility between available Terminal Responses and Proactive Commands is given in Appendix B, Table 2. If a Terminal Response is attempted during a incompatible Proactive Command session, a +CME ERROR: 3 will be returned.
16.3.5.4
+CME ERROR: 4
16.3.5.5
Informative example
At the beginning all facilities are activated, the PIN is not required and SIM toolkit functionality is activated.
+STIN: 0 AT+STGI=0 +STGI: 1,3,BANK,0 +STGI: 2,3,QUIZ,0 +STGI: 3,3,WEATHER,0 OK AT+STGR=0,1,1 OK +STIN: 6 AT+STGI=6 The Sel item menu has been sent from the SIM. Get information about the BANK menu The item 2 of the main menu has been selected. The main menu has been sent from the SIM. Get information about the main menu The main menu contains 3 items.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
259
AT commands interface
+STGI: 1,BANK +STGI: 1,2,PERSONAL ACCOUNT ENQUIRY,1 +STGI: 2,2,NEWS,0 OK AT+STGR=6,1,1 OK +STIN: 3 AT+STGI=3 +STGI: 0,0,4,4,0,Enter Account Password: OK AT+STGR=3,1<CR> >0000<Ctrl Z> OK +STIN:1 AT+STGI=1 +STGI: 0,Password correct, please wait for response,0 OK +STIN: 9 AT+STGI=9 +STGI: Send account balance of user, authorization ok OK
Select Item 1.
User request to enter Password sent. Get information about this request.
A text info has been sent from the SIM. Get information about this text.
SIM requests for bank account update from bank via network (SEND SMS) Get all information about the SEND SMS
********* After a short period of time. ******** +STIN: 5 +STGI=5 +STGI: 9,1,1 +STIN: 1 AT+STGI=1 +STGI: 0,Your account balance is 1000 $,0 OK Display text indication Transaction is complete: BEEP Get information about the Tone
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
260
AT commands interface
17 Other AT commands
17.1 V.25 ter recommandation
Other remaining basic commands are not implemented, so an "ERROR" string will be sent back. All commands about modulation control, error control and data compression are not recognized. An "ERROR" string will be sent back.
17.2
All the remaining commands are not implemented, so an "ERROR" string will be sent back.
17.3
All the remaining commands are not implemented, so an "ERROR" string will be sent back.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
261
AT commands interface
18
18.1
<error>
3 4 5 10 11 12 13 16 17 18 20 21 22 24 26 30 32
Appendices
ME error result code : +CME ERROR: <error>
Meaning
Operation not allowed Operation not supported PH-SIM PIN required (SIM lock) SIM not inserted SIM PIN required SIM PUK required SIM failure Incorrect password SIM PIN2 required SIM PUK2 required Memory full Invalid index Not found Text string too long Dial string too long No network service Network not allowed emergency calls only
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
262
AT commands interface
40
18.2
<er> 1 to 127 301 302 303 304 305 310 311 312 313 316 317 318 321 322 330 340
+CSMS (with +CMS: ERROR 301) All SMS commands (+CMSS, +CMGL, +CPMS, +CSMP All SMS commands +CMGS, +CMGW +CMGS, +CMGW, +CMSS All SMS commands All SMS commands All SMS commands All SMS commands All SMS commands All SMS commands All SMS commands +CMGR, +CMSS, +CMGD +CMGW +CSCA?, +CMSS, +CMGS
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
263
AT commands interface
18.3
<error> 500 512 513 514 515 517 518 519
520
+COPS=?
526 527
+CLCK +COPS
528 529
+COPS +COPS
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
264
AT commands interface
531
SMS not sent : the <da> is not +CMGS, +CMSS (+CMS ERROR: 531) in FDN phonebook, and FDN lock is enabled. (for SMS)
18.4
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
265
AT commands interface
Invalid mandatory information Message type non-existent or not implemented Message type not compatible with protocol state Information element non-existent or not implemented Conditional IE error Message not compatible with protocol state Recovery on timer expiry Protocol error, unspecified Interworking, unspecified
All other values in the range 0 to 31 shall be treated as cause 31. All other values in the range 32 to 47 shall be treated as cause 47. All other values in the range 48 to 63 shall be treated as cause 63. All other values in the range 64 to 79 shall be treated as cause 79. All other values in the range 80 to 95 shall be treated as cause 95. All other values in the range 96 to 111 shall be treated as cause 111. All other values in the range 112 to 127 shall be treated as cause 127.
18.5
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
266
AT commands interface
18.6
These error causes could appear for SMS commands (+CMGS, +CMSS, +CMGD) Cause no 1: "Unassigned (unallocated) number" This cause indicates that the destination requested by the Mobile Station cannot be reached because, although the number is in a valid format, it is not currently assigned (allocated). Cause no 8: "Operator determined barring" This cause indicates that the MS has tried to send a mobile originating short message when the MS's network operator or service provider has forbidden such transactions. Cause no 10: "Call barred" This cause indicates that the outgoing call barred service applies to the short message service for the called destination. Cause no 21: "Short message transfer rejected" This cause indicates that the equipment sending this cause does not wish to accept this short message, although it could have accepted the short message since the equipment sending this cause is neither busy nor incompatible. Cause no 27: "Destination out of service" This cause indicates that the destination indicated by the Mobile Station cannot be reached because the interface to the destination is not functioning correctly. The term "not functioning correctly" indicates that a signalling message was unable to be delivered to the remote user; e.g., a physical layer or data link layer failure at the remote user, user equipment off-line, etc. Cause no 28: "Unidentified subscriber" This cause indicates that the subscriber is not registered in the PLMN (i.e. IMSI not known) Cause no 29: "Facility rejected" This cause indicates that the facility requested by the Mobile Station is not supported by the PLMN. Cause no 30: "Unknown subscriber"
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
267
AT commands interface
This cause indicates that the subscriber is not registered in the HLR (i.e. IMSI or directory number is not allocated to a subscriber). Cause no 38: "Network out of order" This cause indicates that the network is not functioning correctly and that the condition is likely to last a relatively long period of time; e.g., immediately reattempting the short message transfer is not likely to be successful. Cause no 41: "Temporary failure" This cause indicates that the network is not functioning correctly and that the condition is not likely to last a long period of time; e.g., the Mobile Station may wish to try another short message transfer attempt almost immediately. Cause no 42: "Congestion" This cause indicates that the short message service cannot be serviced because of high traffic. Cause no 47: "Resources unavailable, unspecified" This cause is used to report a resource unavailable event only when no other cause applies. Cause no 69: "Requested facility not implemented" This cause indicates that the network is unable to provide the requested short message service. Cause no 81: "Invalid short message transfer reference value" This cause indicates that the equipment sending this cause has received a message with a short message reference which is not currently in use on the MS-network interface. Cause no 95: "Invalid message, unspecified" This cause is used to report an invalid message event only when no other cause in the invalid message class applies. Cause no 96: "Invalid mandatory information" This cause indicates that the equipment sending this cause has received a message where a mandatory information element is missing and/or has a content error (the two cases are undistinguishable). Cause no 97: "Message type non-existent or not implemented"
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
268
AT commands interface
This cause indicates that the equipment sending this cause has received a message with a message type it does not recognize either because this is a message not defined or defined but not implemented by the equipment sending this cause. Cause no 98: "Message not compatible with short message protocol state" This cause indicates that the equipment sending this cause has received a message such that the procedures do not indicate that this is a permissible message to receive while in the short message transfer state. Cause no 99: "Information element non-existent or not implemented" This cause indicates that the equipment sending this cause has received a message which includes information elements not recognized because the information element identifier is not defined or it is defined but not implemented by the equipment sending the cause. However, the information element is not required to be present in the message in order for the equipment sending the cause to process the message. Cause no 111: "Protocol error, unspecified" This cause is used to report a protocol error event only when no other cause applies. Cause no 127: "Interworking, unspecified" This cause indicates that there has been interworking with a network which does not provide causes for actions it takes; thus, the precise cause for a message which is being send cannot be ascertained. All values other than specified should be treated as error Cause No 41
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
269
AT commands interface
18.7
Verbose result code +CALA: < time string>,<index> +CBM: <length><pdu> (PDU) or +CBM:<sn>,<mid>,<dcs>,<page>, <pages> (Text mode) +CBMI: BM,<index> +CCCM : <ccm> +CCED: <values> +CCWA :<number>,<type>, <class> [,<alpha>] +CDS: <fo>, <mr> (text mode) or +CDS: <length>, (PDU) +CDSI: <mem>,<index>
Cell Broadcast Message stored in mem at location <index> Current Call Meter value Cell Environment Description indication Call Waiting number SMS status report after sending a SMS Incoming SMS Status Report after sending a SMS, stored in <mem> (SR) at location <index> Key press or release Incoming Call Presentation Incoming message directly displayed Incoming message stored in <mem> (SM) at location <index> Network registration indication
As verbose
+CKEV: <keynb> +CLIP : <number>, <type> [,,,<alpha>] +CMT: <oa> (text mode)
or +CMT: [<alpha>,] (PDU) +CMTI: <mem>,<index> +CREG : <stat> [,<lac>,<ci>] as verbose As verbose
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
270
AT commands interface
+CRING : <type> +CSQ: <RxLev>,99 +CSSU: <code2>[<number>,<type>] +STIN: <ind> +WIND: <IndicationNb> [,<CallId>]
As verbose As verbose As verbose As verbose (specific) As verbose (specific) As verbose (specific) As Verbose (specific) 2
Incoming call type (VOICE, FAX ...) Automatic RxLev indication with AT+CCED=1,8 command Supplementary service notification during a call SIM Toolkit Indication Specific unsolicited indication (SIM Insert/Remove, End of init, Reset, Alerting, Call creation/release) Voice Mail Indicator notification (cf. +CPHS command) Receive additional User Info on a MT call setup, or a remote call release Incoming call signal from network
RING
18.8
Verbose result code +CME ERROR: <err> +CMS ERROR: <err> BUSY ERROR NO ANSWER NO CARRIER OK RING
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
271
AT commands interface
18.9
Verbose result code +COLP :<number>,<type> +CR : <type> +ILRR: <rate> CONNECT 300 CONNECT 1200 CONNECT 1200/75 CONNECT 2400 CONNECT 4800 CONNECT 9600 CONNECT 14400 +CSSI: <code1>[,<index>]
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
272
AT commands interface
General commands
X X X X
X X X X
PCCP437 --0 6
PCCP437 TRANSPARENT 0 6
X X X X X X X X
X X X X X X X X
0 0 (no auto-answer) 2 (speech) 0 (voice) 64 (speaker 1) 32 (speaker 2) 64 (mic 1 & ctrl 1) 0 (others) 0 (Spk 1 & Mic 1) 0,255,1000,5,500,63
0 0 (no auto-answer) 2 (speech) 0 (voice) 64 (speaker 1) 32 (speaker 2) 64 (mic 1 & ctrl 1) 0 (others) 0 (Spk 1 & Mic 1) ,1,0,3,10,7 (Algo ID 1) ,3,30,8000,256 (Algo ID 3)) 1,1
+SIDET
1,1
+COPS +CREG
X X
X X
0,2 0
0,2 0
Phonebook commands
+WAIP +CSVM
X X
X X
0 ---
0 0
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
273
AT commands interface
Parameters storage mode Command AT&W (E2P) Command (E2P) AT+CSAS (SIM, E2P) AT&F (SIM, E2P) Initial values WISMO1B Initial values WISMO2C
SMS commands
X X X X X X X X X X X
X X X X X X
Data commands
X X X X X
0 0 0 0,0 0 0,0,0
0 0 0 0,0 0 0,0,0
X X X X X X X X X X
X X X X X X X X X X
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
274
AT commands interface
Parameters storage mode Command AT&W (E2P) Command (E2P) AT+CSAS (SIM, E2P) AT&F (SIM, E2P) Initial values WISMO1B Initial values WISMO2C
X X X X X
X X X X X
0 0 1 0,5,0,0,2,0,0,0,0 30
X X X X X X X X X X
Specific commands
X X
+WIND +ADC +CMER +WIOM +WVR +WDR +WSVG +WRIM +WCDM +CPHS +WBCM
X X X X X X X X X X X
X X X
X X X X X
0 0 0 --5 2 0 0 -------
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
275
AT commands interface
Parameters storage mode Command AT&W (E2P) Command (E2P) AT+CSAS (SIM, E2P) AT&F (SIM, E2P) Initial values WISMO1B Initial values WISMO2C
+STSF
---
0,160060C01F,3,0
18.11.1
Security
**04*OLDPIN*NEWPIN*NEWPIN# **042*OLDPIN2*NEWPIN2*NEWPIN2# **05*PUK*NEWPIN*NEWPIN# **052*PUK2*NEWPIN2*NEWPIN2# *#06# Change PIN code Change PIN2 code Unlock PIN code Unlock PIN2 code Show the IMEI number
18.11.2
Call forwarding
*SC# **SC*PhoneNumber# or **SC*PhoneNumber*BS# or **SC*PhoneNumber*[BS]*T# *#SC# or *#SC**BS# #SC# ##SC# or ##SC**BS# Check status Deactivate Unregister and deactivate Activate Register and activate
The Service codes (SC) are the followings: 002 004 21 61 62 all call forwarding all conditional call forwarding call forwarding unconditional call forwarding on no answer call forwarding on not reachable
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
276
AT commands interface
67
call busy
The Network service codes (BS) are the followings: No code 10 11 12 13 16 19 20 21 22 24 25 26 27 All tele and bearer services All teleservices Telephony All data teleservices Fax services Short Message Services All teleservices except SMS All bearer services All asynchronous services All synchronous services All data circuit synchronous All data circuit asynchronous All dedicated packet access All dedicated PAD access
The no reply condition timer (T), is only used for SC = 002, 004 or 61.
18.11.3
Call barring
*SC*Password# or *SC*Password*BS# *#SC# or *#SC**BS# #SC*Password# or #SC*Password*BS# **03*330*OLDPWD*NEWPWD*NEWPWD# **03**OLDPWD*NEWPWD*NEWPWD# *03*330*OLDPWD*NEWPWD*NEWPWD# *03**OLDPWD*NEWPWD*NEWPWD# Activate Check status Deactivate Change password for call barring
The Service codes (SC) are the followings: 33 call barring of outgoing call
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
277
AT commands interface
all barring service (only for deactivation) call barring of outgoing international call call barring of outgoing international calls except to HPLMN all outgoing barring service (only for deactivation) call barring of incoming calls call barring of incoming calls if roaming all incoming barring service (only for deactivation)
The Network service codes (BS) are the same as these of the call forwarding sequences.
18.11.4
Call waiting
*43# *#43# #43# Activate Check status Deactivate
18.11.5
Number presentation
*#30# CLIP check status CLIR check status Invoke CLIR for a voice call Suppress CLIR for a voice call COLP check status
*#31#
*31#PhoneNumber #31#PhoneNumber *#76#
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
278
AT commands interface
Country Initials A A A A AL ALG AN AND AUS AUS AUS AUS AZE AZE B B BD BEL BG BGD BGD BHR BIH BIH BIH BRU BW BY CAN CH CH CH CHN CHN CI CI
MCC 232 232 232 232 276 603 344 213 505 505 505 505 400 400 206 206 470 206 284 470 470 426 218 218 218 528 652 257 302 228 228 228 460 460 612 612
MNC 01 03 05 07 01 01 30 03 01 02 03 08 01 02 10 20 03 01 01 01 02 01 03 05 90 11 01 01 37 01 02 03 00 01 03 05
Type of network GSM900 GSM900/1800 GSM1800 GSM1800 GSM900 GSM900 PCS1900 GSM900 GSM900/1800 GSM900 GSM900 GSM1800 GSM900 GSM900 GSM900 GSM1800 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 PCS1900 GSM900/1800 GSM900/1800 GSM1800 GSM900 GSM900 GSM900 GSM900
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
279
AT commands interface
730 730 624 625 280 230 230 262 262 262 262 238 238 238 238 214 214 214 248 248 248 602 602 636 208 208 208 340 547 647 244 244 244 244 542 282 282 620 620 266 611 202 202
01 10 02 01 01 01 02 01 02 03 07 01 02 20 30 01 03 07 01 02 03 01 02 01 01 10 20 01 20 10 03 05 09 91 01 01 02 01 02 01 02 01 05
CL ENTEL PCS CL ENTEL PCS Mobilis CPV MOVEL CY CYTAGSM PAEGAS- CZ EUROTEL - CZ T-D1 D2 E-Plus D Interkom DK TDK-MOBIL DK SONOFON TELIA DK DK mobilix E AIRTEL E AMENA MOVISTAR EE EMT GSM EE RLE EE Q GSM EGY MobiNiL EGY CLICK GSM ETH-MTN F Itineris F SFR F - BOUYGUES TELECOM F AMERIS F-VINI SFR REUNION FI TELIA FI RADIOLINJA FI FINNET FI SONERA VODAFONE FIJ GEO-GEOCELL MAGTI-GSM-GEO GH SPACEFON GH GTGSM GIBTEL GSM GN LAGUI GR COSMOTE GR PANAFON
ENTEL ENTEL CAM 02 CMOVEL CY-GSM PAEGAS ET - CZ T-D1 D2 E-Plus Ik TD MOB SONO TELIA #mbix AIRTL AMENA MSTAR EMT RLE Q GSM MobiNiL CLICK ET-MTN Itine SFR BYTEL AMERIS VINI SFR RU TELIA RL FINNET SONERA VODAFJ GCELL MAGTI SPACE GTGSM GIBTEL LAGUI C-OTE PAN
PCS1900 PCS1900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900/1800 GSM900 GSM1800 GSM1800 GSM900 GSM900/1800 GSM1800 GSM1800 GSM900 GSM1800 GSM900/1800 GSM900/1800 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900/1800 GSM900 GSM1800 GSM900 GSM900 GSM900 GSM1800 GSM900 GSM1800 GSM900/1800 GSM900 GSM900 GSM900/1800 GSM900 GSM900 GSM900 GSM900 GSM1800 GSM900
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
280
AT commands interface
GR GRL H H H HK HK HK HK HK HK HR HR I I I I IL INA INA INA INA INA INA INA INA INA INA INA INA INA INA INA INA IND IND IND IND IRL IRL IS IS JOR
202 238 216 216 216 454 454 454 454 454 454 219 219 222 222 222 222 425 404 404 404 404 404 404 404 404 404 404 404 404 404 404 404 404 510 510 510 404 272 272 274 274 416
10 01 01 30 70 00 04 06 10 12 16 01 10 01 10 88 98 01 01 07 10 11 12 14 15 20 21 27 30 41 42 43 46 60 01 10 11 44 01 02 01 02 01
GR TELESTET TELE Greenland H PANNON GSM H-WESTEL 900 Vodafone CABLE & WIRELESS HKT HK ORANGE HK SMARTONE HK NEW WORLD HK PEOPLES HK SUNDAY HR - CRONET HR VIP I TELECOM I -OMNITEL I WIND I BLU IL ORANGE INA ESSAR CELLPHONE INA - TATA CELLULAR INA-AIRTL INA ESSAR CELLPHONE INA - ESCOTEL MODICOM INA INA ESSAR CELLPHONE INA MaxTouch BPL MOBILE BPL MOBILE INA COMMAND INA RPG INA AIRCEL BPL MOBILE BPL MOBILE INA ESSAR CELLPHONE IND SATELINDOCEL IND TELKOMSEL IND GSM-XL IN-44 IRL Eircell IRL DIGIFONE IS SIMINN IS TAL Fastlink
TLSTET TELE GRL PANNON W-900 H-70 C&W HKT ORANGE HKSMC NWPCS PEOPLES SUNDAY CRON VIP TIM OMNI I WIND BLU ORANGE ESSARH TATA AIRTL ESSAR ESCOTL MODICO ESSARU MAXTCH BPL MOBILE BPL MOBILE COMMND RPG AIRCEL BPL MOB BPL MOB ESSARR SAT-C T-SEL EXCEL SPICE Eircell DIGI SIMINN TAL FSTLNK
GSM900 GSM900 GSM900 GSM900 GSM1800 GSM900/1800 GSM900/1800 GSM900/1800 GSM1800 GSM1800 GSM1800 GSM900 GSM900 GSM900/1800 GSM900/1800 GSM900/1800 GSM1800 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
281
AT commands interface
KGZ KHM KHM KSA KSA KT KT KZ KZ L L LAO LBR LSO LT LTU LV LV M MAC MD MDG MKD MOR MOR MOZ MRU MRU MV MW MW MY MY MY MY MY N N NCL NL NL NL NL
437 456 456 420 420 419 419 401 401 270 270 457 618 651 246 246 247 247 278 455 259 642 294 604 604 643 617 617 472 650 650 502 502 502 502 502 242 242 546 204 204 204 204
01 01 02 01 07 02 03 01 02 01 77 01 01 01 02 01 01 02 01 01 01 02 01 00 01 01 01 10 01 01 10 12 13 16 17 19 01 02 01 04 08 12 16
BITEL KGZ MOBITEL - KHM KHM-SAMART-GSM ALJAWWAL EAE-ALJAWWAL KT MTCNet KT WATANIYA KZ K-MOBILE KZ KCELL L LUXGSM L TANGO --LBR OMEGA VCL COMMS LT BITE GSM OMNITEL LT LV LMT GSM LV BALTCOM VODAFONE MLA MAC-CTMGSM MD VOXTEL MDG ANTARIS MKD-MOBIMAK MOR MEDITEL MOR IAM MOZ - mCel CELLPLUS-MRU EMTEL-MRU MV DHIMOBILE MW CP 900 CELTEL MW MY maxis mobile MY TMTOUCH MY DIGI 1800 MY - ADAM 017 MY CELCOM N Telenor N NetCom GSM NCL MOBILIS NL LIBERTEL NL KPN TELECOM NL TELFORT Ben NL
BITEL MT-KHM KHM-SM KSA EAE MTC WATANIYA K-MOBILE KCELL LUXGSM TANGO LAO GSM OMEGA VCLCOM BITE OMT LMT B-COM VODA M CTMGSM VOXTEL ANTARI MOBI-M MEDITEL IAM mCel CELL + EMTEL D-MOBILE CP 900 CELTEL maxis TMTOUCH MT18 ADAM CELCOM TELENOR N COM MOBNCL LIBTEL NL KPN TELFORT Ben NL
GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900/1800 GSM900 GSM900 GSM900/1800 GSM900/1800 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM1800 GSM1800 GSM1800 GSM900 GSM900/1800 GSM900 GSM900 GSM900 GSM900 GSM1800 GSM1800
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
282
AT commands interface
NL NZ OMN P P P PGY PH PH PH PL PL PL PSE QAT R RA RL RL RO RO ROC RUS RUS RUS RUS RUS RUS RUS RUS RUS RUS RUS RUS RUS RUS RUS S S S SA SA SDN
204 530 422 268 268 268 744 515 515 515 260 260 260 425 427 635 283 415 415 226 226 466 250 250 250 250 250 250 250 250 250 250 250 250 250 250 250 240 240 240 655 655 634
20 01 02 01 03 06 01 01 02 03 01 02 03 05 01 10 01 01 03 01 10 92 01 02 05 07 07 12 13 17 28 39 39 44 93 99 99 01 07 08 01 10 01
dutchtone VODAFONE NZ OMAN MOBILE P TELECEL P OPTIMUS P TMN HOLA PARAGUAY S.A. ISLACOM Globe Telecom-PH PH SMART PL-PLUS PL-ERA GSM PL IDEA JAWWAL-PALESTINE QAT-QATARNET R-CELL RA-ARMGSM RL Cellis RL LibanCell RO CONNEX RO dialog ROC LDTA GSM MTS-RUS North-West GSM RUS SCS RUS BMT RUS SMARTS RUS 12, Far East RUS Kuban-GSM RUS RUS 17 EXTEL RUS Uraltel RUS-SUCT RUS North Caucasian GSM --Bee Line GSM RUS Bee Line TELIA S S COMVIQ S EUROPOLITAN VodaCom-SA MTN-SA SDN MobiTel
Dtone VODA OMAN TLCL OPTIM TMN HPGYSA ISLA GLOBE SMART PLUS ERAGSM IDEA JAWWAL Q-NET RCELL ARMMO1 CLLIS LibCL CONNEX dialog LDGSM MTS NWGSM SCS BMT SMARTS FEast KUGSM ERMAK EXTEL UTL SUCT NC-GSM --Bee Line Bee Line TELIA IQ EURO VODA MTN SD-MOB
GSM1800 GSM900 GSM900 GSM900/1800 GSM900/1800 GSM900/1800 PCS1900 GSM900 GSM900 GSM900/1800 GSM900 GSM900 GSM1800 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM1800 GSM1800 GSM1800 GSM900/1800 GSM900 GSM900 GSM900 GSM900 GSM900
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
283
AT commands interface
SEZ SEZ SGP SGP SGP SGP SI SI SK SK SN SN SRI SRI SYR SZ TG TH TH TH TN TR TR TWN TWN TWN TWN TWN TZ TZ UA UA UA UAE UG UG UK UK UK UK UK UK UK
633 633 525 525 525 525 293 293 231 231 608 608 413 413 417 653 615 520 520 520 605 286 286 466 466 466 466 466 640 640 255 255 255 424 641 641 234 234 234 234 234 234 234
01 10 01 02 03 05 40 41 01 02 01 02 02 03 09 10 01 01 10 23 02 01 02 01 06 88 93 97 01 03 01 03 05 02 01 10 10 15 30 33 50 55 58
SEZ CELLULAR SERVICES SEZ AIRTEL ST-GSM-SGP ST-GSM1800-SGP M1-GSM-SGP STARHUB-SGP SI.MOBIL SI MOBITEL GSM SVK GT EUROTEL-SK SN ALIZE SN-SENTEL SG SRI DIALOG SRI - CELLTEL SYR MOBILE SYR Swazi-MTN TG-TOGO CELL TH AIS GSM TH WCS TH-HELLO TUNISIE TELECOM TR PTT/TURKCELL GSM TR TELSIM Far EasTone TWN Tuntex GSM 1800 KGT-Online TWN MOBITAI TWN GSM 1800 Tritel - TZ ZANTEL-TZ UA UMC UA-KYIVSTAR UA - GOLDEN TELECOM UAE ETISALAT UG CelTel MTN-UGANDA BTCELLNET UK VODAFONE ONE 2 ONE ORANGE JERSEY TELECOMS GSM UK GUERNSEY TEL UK MANX TELECOM PRONTO GSM
SEYCEL AIRTEL STGSM GSM1800 M1-GSM STARHUB SI.MOBIL SI-GSM SVK GT ET-SK ALIZE SENTEL DALOG CELLTEL MOBILE SwaziMTN TGCELL TH AIS TH WCS HELLO TT TCELL TELSIM FET TUNTEX KGT TW MOB PCC TRITEL ZANTEL UMC UA-KS UA-GT ETSLT CELTEL MTN-UG BTCNET VODA ONE2ONE ORANGE JT GSM GSY-TEL MANX
GSM900 GSM900 GSM900 GSM1800 GSM900 GSM1800 GSM900 GSM900 GSM900 GSM900/1800 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM1800 GSM1800 GSM900 GSM900 GSM900 GSM900/1800 GSM1800 GSM1800 GSM900 GSM1800 GSM900 GSM900/1800 GSM900 GSM900 GSM1800 GSM900 GSM900 GSM900 GSM900/1800 GSM900 GSM1800 GSM1800 GSM900 GSM900 GSM900
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
284
AT commands interface
UKR USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA
255 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310
02 010 011 012 013 020 030 031 040 050 060 070 080 090 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 380 390 400
FLASH-UKR USA MCI USA Wireless 2000 Telepho USA D&E Com USA MobileTel USA Sprint USA PCS PRIME USA-AERIAL USA PCS PRIME USA PCS PRIME USA PCS PRIME USA PCS PRIME USA PCS PRIME USA PCS PRIME USA PCS PRIME USA PCS PRIME USA PCS PRIME USA PCS PRIME USA PCS PRIME BellSouth Mobility DCS USA OMNIPOINT USA PAC BELL USA PAC BELL USA COX VoiceStream VoiceStream VoiceStream VoiceStream VoiceStream VoiceStream VoiceStream USA PowerTel, Inc. USA PowerTel USA PowerTel USA Aerial USA-AERIAL USA Aerial USA Aerial USA Aerial USA Aerial USA Pocket USA Pocket USA Pocket
FLASH WTTCKy
AERIAL
BSMDCS
AERIAL
GSM900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
285
AT commands interface
USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA USA UZB UZB VN VN VZ VZ YU ZW ZW ZW
310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 310 434 434 452 452 734 734 220 648 648 648
410 420 430 440 450 460 470 480 490 500 510 520 530 540 550 560 570 580 610 620 630 640 660 670 680 690 770 790 04 05 01 02 01 02 01 01 03 04
USA Pocket USA Pocket USA Pocket USA Pocket USA Pocket USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA OMNIPOINT USA Einstein USA DiGiPH USA WTTCKy USA NPI USA Conestoga Iowa Wireless USA USA PinPoint Wireless UZB DAEWOO-GSM UZB CSOCOM GSM VN MOBIFONE VN VINAFONE VZ INFO DIGITEL YU MOBTEL ZW NET*ONE TELECEL ZW ZW ECONET
IWS PnPt DW-GSM COSCOM VMS GPC INFONT DIGITEL MOBTEL NET*1 TELECEL ECONET
PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 PCS1900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900 GSM900
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
286
AT commands interface
The Wavecom multiplexing protocol operates between a WISMO (the DCE : Data Communication Equipment) and a DTE (Data Terminal Equipment). It allows a double sessions over a serial link interface : one for AT commands and one for DATA communications. AT+WMUX=1 activates the Multiplexing Mode. Within this mode, AT commands and DATA are encapsulated into packets. The header of these packets allows to recognize whether it is a DATA packet or an AT command packet. AT+WMUX=0 desactivates the Multiplexing Mode and go back to the default mode. This appendice presents how operates the multiplexage between the DATA flow and the AT commands flow. It also describes the format of DATA packets and AT command packets.
18.13.2
AT command packets
An AT command is encapsulated into a packet with a header which allows to separate it from DATA packets. This packet is formed by a header (3 bytes), the AT command and a checksum (1 byte) : B7 B6 B5 B4 B3 B2 B1 B0
Start pattern 0xAA AT command length LSB AT command pattern 0x1D AT command Checksum AT command length MSB
The 3 bytes of the header are decomposed like this : the first byte (0xAA) is used to identify the packet, the second byte represents the 8 LSB (Low Significant Bits) bits of the length of the AT command,
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
287
AT commands interface
the third byte is decomposed in 2 parts : the 3 LSB bits are the 3 MSB (Most Significant Bits) bits of the length of the AT command, the 5 MSB bits (0x1D which equals to 0xE8 with the 3 bits offset) are used to identify an AT command.
The maximum length of an AT command could be 2047 bytes which is greater than all the existing AT commands. The checksum is the addition (modulo 256) of all the transmitted bytes (header bytes and AT command bytes).
18.13.3
Data packets
Like AT commands, DATA are encapsulated into packets. These packets are composed of a header (3 bytes), the data bytes and the checksum (1 byte) : B7 B6 B5 B4 B3 B2 B1 B0
Start pattern 0xDD Data packet length LSB Data packet type Data Bytes Checksum Data packet length MSB
The 3 bytes of the header are decomposed like this : the first byte (0xDD) used to identify the packet, the second byte represents the 8 LSB bits of the length of the data field, the last byte is decomposed in 2 parts : the 3 LSB bits represent the 3 MSB bits of the length of the data field, the 5 MSB bits represent the packet type.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
288
AT commands interface
Data packets can have different values following the packet type : 0 DATA packet : the packet contains the data to transmit on the radio link or received from the radio link, 1 STATUS packet: the packet contains the status of SA, SB, X bits(1) and the break condition coding as follow : SA SB X BRK RI Spare Spare Spare
Formatted Formatted
the length of data for the status packet is always equals to 1, whenever a status changes (except break), all the status bits are included, these bits are off by default (and therefore the bits DTR and RTS), so it is necessary to send a status packet to the target at the beginning of the multiplexage to start the transmission,
2 READY packet : the packet indicates that the target is ready to received data : no data are transmitted in this packet (so the length is null),
3 BUSY packet : the packet indicates that the target is busy and can not receive data : like the ready packet, no data are transmitted,
other values : these values are not used currently (reserved for future enhancement).
The checksum is calculated like the AT command packet checksum (addition of all the transmitted bytes including the header bytes).
These status bits contain the V24 control information : - SA contains DTR (signal CT108 from terminal to IWF) and DSR (signal CT107 from terminal to IWF), - SB contains RTS (signal CT105 from terminal to IWF) and DCD (signal CT109 from IWF to terminal), - X contains CTS (signal CT106). For more information, refer to GSM 07.02
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
289
AT commands interface
18.13.4
Examples
18.13.4.1
When there is no encapsulation the AT command transmitted on the serial link is like this (in ASCII and hexadecimal) : AT\r\n 0x41 0x54 0x0D 0x0A
and the answer is like this : \r\nOK\r\n 0x0D 0x0A 0x4F 0x4B 0x0D 0x0A
With the encapsulation in the serial link, the packet transmitted is (in hexadecimal) :
0xAA 0x04 0xE8 0x41 0x54 0x0D 0x0A 0x42
18.13.4.2
When the Multiplexing Mode is activated (+WMUX=1), the WISMO send 2 Data packets after the establishment of a DATA call (after the CONNECT xxxx message) : 1 READY Packet and 1 STATUS Packet. To set the different signals to the right value, it is necessary to send a STATUS packet to the WISMO. Here are some examples of STATUS packets : 0xDD 0x01 0x08 0x40 0x26 bit RTS is on
to start a data call, all the bits should be on : 0xDD 0x01 0x08 0xC0 0xA6 bits DTR and RTS are on
18.13.5
Restriction
The autobauding mode is not available when the Multiplexing Mode is activated : the serial link speed must be set to a fixed rate.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
290
AT commands interface
19 APPENDIX A (informative)
This chapter illustrates informative examples about the general AT commands used for a communication.
19.1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
291
AT commands interface
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
292
AT commands interface
19.1.1
Example 3 : When the ME is powered on and the SIM PIN has been entered.
AT+CMEE=1 OK AT+WIND=63 OK AT+CPIN? +CPIN: READY ATD0607103543; +WIND: 5,1 +WIND: 2 OK Conversation ATH OK Release the call Is ME asking password? GSM module is ready Originate a voice call Indication about a call creation. Remote party is ringing. Call setup was successful Ask to display the general indications. Enable the report mobile equipment errors
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
293
AT commands interface
19.1.2
When the ME is powered on and the SIM PIN has been entered.
AT+CMEE=1 OK AT+WIND=63 OK AT+CLIP=1 OK AT+CRC=1 OK AT+CNUM +CNUM: Speech,+33608971019,145 OK Originate the number on another ME. +WIND: 5, 1 +CRING: VOICE +CLIP: "+33607103543",145,,,"John Panborn" +CRING: VOICE ATA OK Conversation NO CARRIER +WIND: 6,1 The call has been released by the remote user. Indication about call release. Answer the call. Indication about a call creation. (Ring) Type of call is VOICE. Identification about the remote user. Query own number (voice number) or MSISDN. Enable extended format of incoming indication. Enable the calling line identification presentation. Ask to display the general indications. Enable the report mobile equipment errors
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
294
AT commands interface
19.1.3
When the ME is powered on and the SIM PIN has been entered.
AT+CMEE=1 OK AT+CFCC=1,3,0607492638 OK AT+CCFC=2,3,0149293031,129 +CME ERROR: 30 AT+CCFC=1,2 +CCFC: 1,1,+33607492638,145 AT+CFCC=1,4 OK Registered a call forwarding when it does answer. No network service Interrogate Call forwarding active for a voice call. Delete call forwarding Mobile busy Registered a call forwarding when mobile is busy. Enable the report mobile equipment errors
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
295
AT commands interface
19.1.4
When the ME is powered on and the SIM PIN has been entered.
AT+CMEE=1 OK AT+WIND=63 OK AT+CCWA=1,1 OK ATD>John Panborn; +WIND: 5,1 +WIND: 2 OK Conversation +WIND: 5,2 +CCWA: +33595984834,145,Dolores Claiborne AT+CHLD=2 OK Conversation AT+CHLD=3 OK AT+CHLD=11 Release the first call (with John Panborn) and recover the second call (with Dolores Claiborne) Every calls are into a multiparty. Indication about another call creation. Another call is waiting. Put first call on hold and answer the second one. Indication about a of call creation. Remote ring. Call setup was successful Enable call waiting. Ask to display the general indications. Enable the report mobile equipment errors
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
296
AT commands interface
19.2
For each example illustrates in this section: in the start the ME is powered on and the SIM PIN has been entered.
19.2.1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
297
AT commands interface
19.2.2
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
298
AT commands interface
19.2.3
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
299
AT commands interface
19.2.4
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
300
AT commands interface
19.3
19.3.1
AT+CNMI=0,1,1,1,0 OK
AT+CSMP=17,169,0,0 OK
AT+CMGF=1 OK
AT+CSCA=+33608080706 OK AT+CMGS=0601290800
Send a SMS-SUBMIT to mobile phone Module sends a 4 characters sequence: 0x0D 0x0A 0x3E 0x20
This is the first text line This is the last text line +CMGS: 5
Edit first line and press carriage return (<CR>, 0x0D) Edit last line and send message by pressing <ctrl-Z> (0x1A) Success: message reference 5 is returned from the SMS Service Center
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
301
AT commands interface
19.3.2
AT+CMGF=1
AT+CMGL=ALL
+CMGL: 1,REC READ,+336290918,,99/05/01 14:15:10+04 This is the first message +CMGL: 2,REC UNREAD,+336290918,,99/05/01 14:19:44+04 This is the second message OK AT+CMGR=1 Read the first message
19.4
19.4.1
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
302
AT commands interface
OK AT+FDT +FDCS:0,3,0,2,0,0,0,0 CONNECT <0x11h> First page data terminated by <0x10h><0x03h> OK AT+FET=0 +FPTS:1 OK AT+FDT CONNECT <0x11h> Second page data terminated by <0x10h><0x03h> OK AT+FET=2 +FPTS:1 +FHNG:0 OK Page transmitted No more page First page acquitted Normal end of connection Send carrier Page transmitted Send another page First page acquitted Send carrier Begin of data
19.4.2
AT+FCR=1 OK AT+FLID="LocalFax" OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
303
AT commands interface
RING ATA +FCON [+FTSI:"RemoteFax"] +FDCS:0,3,0,2,0,0,0,0 OK AT+FDR +FCFR +FDCS:0,3,0,2,0,0,0,0 CONNECT <0x12h> First page data terminated by <0x10h><0x03h> OK +FPTS:1 +FET:0 OK AT+FDR +FDCS:0,3,0,2,0,0,0,0 CONNECT <0x12h>
Second page data terminated by <0x10h><0x03h> OK +FPTS:1 +FET:2 OK AT+FDR Page received First page acquitted No more page to receive
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
304
AT commands interface
+FHNG:0 OK
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
305
AT commands interface
X X X X X X X
X X X X X X
X X
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
306
AT commands interface
TABLE 2 - Compatibility between available Terminal Responses and Proactive Commands Proactive commands Terminal Reponses
Backward Move (95) Setup Display Menu Text (0) (1) Get Inkey (2) Get Input (3) Setup Call (4) Play Tone (5) Select Item (6) Refresh (7) Send SS (8) Send SMS (9) Send USSD (10) Setup event list (11)
Command beyond ME capabilities (96) ME currently unable to process command (97) No response from the user (98) SIM session terminated by the user (99)
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
307
AT commands interface
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
308
AT commands interface
module to 0
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
309
AT commands interface
Ninth byte:
b8 b7 b6 b5 b4 b3 b2 b1 Sustained DISPLAY TEXT (see 6.4.1) SEND DTMF command (see 6.4.24) RFU, RFU, RFU, RFU, RFU, RFU, bit bit bit bit bit bit = = = = = = 0 0 0 0 0 0 Force by WM module to 0 Force by WM module to 0
Subsequent bytes:
b8 b7 b6 b5 b4 b3 b2 b1 RFU, bit = 0
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
310
AT commands interface
'00' '01' '02' '03' '04' '05' '10' '11' '12' '13' '14' '20' '21' '22' '23' '24' '25' '26' '27' '28' '30' '31' '32' '33' '34' '81'
REFRESH MORE TIME POLL INTERVAL POLLING OFF SET UP EVENT LIST SET UP CALL SEND SS SEND USSD SEND SHORT MESSAGE SEND DTMF PLAY TONE DISPLAY TEXT GET INKEY GET INPUT SELECT ITEM SET UP MENU PROVIDE LOCAL INFORMATION TIMER MANAGEMENT SET UP IDLE MODEL TEXT PERFORM CARD APDU POWER ON CARD POWER OFF CARD GET READER STATUS RUN AT COMMAND End of the proactive session
X X X X X X X X X X
X
X X X X X not applicable
X X X X X
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
311
AT commands interface
1)
If the first octet in the alpha string is '80', then the remaining octets are 16 bit UCS2 characters, with the more significant octet (MSO) of the UCS2 character coded in the lower numbered octet of the alpha field, and the less significant octet (LSO) of the UCS2 character is coded in the higher numbered alpha field octet, i.e. octet 2 of the alpha field contains the more significant octet (MSO) of the first UCS2 character, and octet 3 of the alpha field contains the less significant octet (LSO) of the first UCS2 character (as shown below). Unused octets shall be set to 'FF', and if the alpha field is an even number of octets in length, then the last (unusable) octet shall be set to 'FF'. Example 1
Octet 1 '80' Octet 2 Ch1MSO Octet 3 Ch1LSO Octet 4 Ch2MSO Octet 5 Ch2LSO Octet 6 Ch3MSO Octet 7 Ch3LSO Octet 8 'FF' Octet 9 'FF'
2)
If the first octet of the alpha string is set to '81', then the second octet contains a value indicating the number of characters in the string, and the third octet contains an 8 bit number which defines bits 15 to 8 of a 16 bit base pointer, where bit 16 is set to zero, and bits 7 to 1 are also set to zero. These sixteen bits constitute a base pointer to a "half-page" in the UCS2 code space, to be used with some or all of the remaining octets in the string. The fourth and subsequent octets in the string contain codings as follows; if bit 8 of the octet is set to zero, the remaining 7 bits of the octet contain a GSM Default Alphabet character, whereas if bit 8 of the octet is set to one, then the remaining seven bits are an offset value added to the 16 bit base pointer defined earlier, and the resultant 16 bit value is a UCS2 code point, and completely defines a UCS2 character.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
312
AT commands interface
Example 2
Octet 1 '81' Octet 2 '05' Octet 3 '13' Octet 4 '53' Octet 5 '95' Octet 6 'A6' Octet 7 'XX' Octet 8 'FF' Octet 9 'FF'
In the above example; - Octet 2 indicates there 5 characters in the string - Octet 3 indicates bits 15 to 8 of the base pointer, and indicates a bit pattern of 0hhh hhhh h000 0000 as the 16 bit base pointer number. Bengali characters for example start at code position 0980 (0000 1001 1000 0000), which is indicated by the coding '13' in octet 3 (shown by the italicised digits). - Octet 4 indicates GSM Default Alphabet character 53, i.e. "S". - Octet 5 indicates a UCS2 character offset to the base pointer of '15', expressed in binary as follows 001 0101, which, when added to the base pointer value results in a sixteen bit value of 0000 1001 1001 0101, i.e. '0995', which is the Bengali letter KA. Octet 8 contains the value 'FF', but as the string length is 5, this a valid character in the string, where the bit pattern 111 1111 is added to the base pointer, yielding a sixteen bit value of 0000 1001 1111 1111 for the UCS2 character (i.e. '09FF'). 3) If the first octet of the alpha string is set to '82', then the second octet contains a value indicating the number of characters in the string, and the third and fourth octets contain a 16 bit number which defines the complete 16 bit base pointer to a "halfpage" in the UCS2 code space, for use with some or all of the remaining octets in the string. The fifth and subsequent octets in the string contain codings as follows; if bit 8 of the octet is set to zero, the remaining 7 bits of the octet contain a GSM Default Alphabet character, whereas if bit 8 of the octet is set to one, the remaining seven bits are an offset value added to the base pointer defined in octets three and four, and the resultant 16 bit value is a UCS2 code point, and defines a UCS2 character. Example 3
Octet 1 '82' Octet 2 '05' Octet 3 '05' Octet 4 '30' Octet 5 '2D' Octet 6 '82' Octet 7 'D3' Octet 8 '2D' Octet 9 '31'
In the above example - Octet 2 indicates there are 5 characters in the string - Octets 3 and 4 contain a sixteen bit base pointer number of '0530', pointing to the first character of the Armenian character set.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
313
AT commands interface
- Octet 5 contains a GSM Default Alphabet character of '2D', which is a dash "-". - Octet 6 contains a value '82', which indicates it is an offset of '02' added to the base pointer, resulting in a UCS2 character code of '0532', which represents Armenian character Capital BEN. - Octet 7 contains a value 'D3', an offset of '53', which when added to the base pointer results in a UCS2 code point of '0583', representing Armenian Character small PIWR.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
314
AT commands interface
Into the details : Whenever the DTE requests the DCE to enter the power down mode, the DTE drops (ON-toOFF transition) DTR. From this time on, the DTE must not send any more characters on the TX line i.e. even the TX FIFO must be empty. The DCE acknowledges entry in the power down mode by dropping CTS, which can occur at maximum 5s after the DTR drop. However during that latency period the DTE is prohibited from sending any more AT commands. AT responses can be sent back to the DTE even if the DCE is in power down mode (actually the DCE exits the power down mode, sends the AT response and enters back the power down mode). Therefore the DTE can drop DTR just after having sent an AT command and before receiving the AT response. The DCE is made to exit the power down mode by raising the DTR. DCE is not ready to receive further AT commands until it raises in turn CTS, which can take up to 2s from the DTR raise. Herebelow is a diagram depicting the handshaking:
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
315
AT commands interface
DTR CTS
2 4
TX RX
1 XXXX
Description of the stages: 1: the DTE sends an AT command 2: the DTE drops DTR to make the DCE enter the power down mode. Warning: this mode will not really entered until CTS is dropped (stage 4). The DTE could also have dropped DTR after receiving the AT response (stage 3). 3: the DCE sends back the AT response (if any) 4: the DCE drops CTS and does enter the power down mode. 5: the DCE sends back an unsolicited response (for instance a RING or +SMTI (incoming SMS indication)) 6: the DTE wants to reply to that unsolicited response so it causes the DCE to exit the power down mode by raising its DTR. 7: in turn the DCE acknowledges the exit of the power donw mode by raising CTS. 8) & 9) exchange of AT commands/responses.
Note 1): The DTE must not send any AT commands from stage 2 on up to stage 7. Note 2): During the latency period (between stages 2 and 4) should the DTE want to abort the power down mode, it raises DTR and should wait for 150us before assessing CTS. If CTS is still high than the DCE has aborted the power down mode and is ready to receive AT commands. The 150us wait should get around the race condition between DTR raise and CTS drop.
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
316
AT commands interface
25.2
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
317
AT commands interface
AT%D ATS0 AT+CICB AT+CSNS AT+VGR AT+VGT AT+CMUT AT+SPEAKER AT+ECHO AT+SIDET AT+VIP AT+DUI AT+HUI AT+RUI
Without Without Without Without Without Without Without Without Without Without Without PIN PIN PIN
N N N N N N N N N N N N N N
25.3
25.4
Security commands
AT commands AT+CPIN AT+CPIN2 AT+CPINC AT+CLCK AT+CPWD Execution conditions +WIND: 1 after PIN entered +WIND: 1 +WIND: 4 +WIND: 4 SIM dependence Y Y Y Y Y
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
318
AT commands interface
25.5
Phonebook commands
AT commands AT+CPBS AT+CPBR AT+CPBF AT+CPBW AT+CPBP AT+CPBN AT+CNUM AT+WAIP AT+CSVM Execution conditions +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 Without +WIND: 4 SIM dependence Y Y Y Y Y Y Y N N
25.6
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
319
AT commands interface
25.7
25.8
Data commands
AT commands AT+CBST AT+FCLASS AT+CR AT+CRC AT+ILRR AT+CRLP AT+DOPT AT%C AT+DS AT+DR \N Execution conditions Without Without Without Without +WIND: 4 Without Without Without Without Without Without SIM dependence N N N N N N N N N N N
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
320
AT commands interface
25.9
Fax commands
AT commands AT+FTM AT+FRM AT+FTH AT+FRH AT+FTS AT+FRS Execution conditions Without Without Without Without Without Without SIM dependence N N N N N N
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
321
AT commands interface
N N N N N
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
322
AT commands interface
This confidential document is the property of WAVECOM and may not be copied or circulated without permission
323