AT Fax Class2 Commands
AT Fax Class2 Commands AT Fax Class2 Commands
AT Fax Class2 Commands AT Fax Class2 Commands
User Manual: AT Fax Class2 Commands
Open the PDF directly: View PDF .
Page Count: 269
Download | |
Open PDF In Browser | View PDF |
AT commands interface 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 : 8.5 ATI Version : 58 Date : September 1th,2000 Reference : WCOM/GSM/SW/SII015.D87 This confidential document is the property of WAVECOM and may not be copied or circulated without permission AT commands interface DOCUMENT AMENDMENTS Version Date STATUS AUTHOR COMMENTS 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 P P P P P P P P P P P P 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 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 N. Higelin R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec R. Madec 16-10-1997 P F. Desnoues Network & SIM lock (+CLCK, +CPWD) 21-12-1997 P SIM Phonebook management F. Desnoues (+CPBS, +CPBR, +CPBF, +CPBW) FAX management document 10-02-1998 P F. Desnoues 31-03-1998 P F. Desnoues ATV and ATQ commands 30-04-1998 P F. Desnoues 7.7 30-06-1998 P O.Capron New commands +CPINC,+CCID,+CNUM, +WAIP , +CPBP, +CPBN (phonebook) 7.8 29-10-1998 P O.Capron SMS commands (+CMGW, +CMSS) F.Desnoues New formats of Suppl Serv commands (+CLCK,+CCWA,+CCFC) 7.3 7.4 7.5 7.6 R.Dorey Advice Of Charge management (+CAOC, +CACM, +CAMM, +CPUC) Cell Broadcast Msg management (+CSCB, +WCBM) and Incoming bearer (+CICB) Add comments pertaining +IPR,+CBST,+ICF and fax setup. This confidential document is the property of WAVECOM and may not be copied or circulated without permission to i 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 8.3 21-06-1999 P 27-09-1999 P C. Amiens 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) This confidential document is the property of WAVECOM and may not be copied or circulated without permission ii AT commands interface 8.4 18-11-1999 P C. Amiens 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. 17-02-2000 P J. Berdin New: +WHWV, +WDOP, +CNMA. Modification: +CSMS. 07-03-2000 P C. AMIENS New: +WVGS Modification +VGT 29-03-2000 P JP. BIOU New: +WSTR 30-03-2000 P J. Berdin New: +WSCAN Modification : +CNMA 11-04-2000 P J. Berdin Add +CMS ERROR: 340 Add +CME ERROR: 500 13-04-2000 P J. Berdin Modification : +CNMA This confidential document is the property of WAVECOM and may not be copied or circulated without permission iii AT commands interface 04-05-2000 P JP. BIOU New : +WRIM 10-05-2000 P JP. BIOU Modification : +ADC 05-06-2000 P C. AMIENS 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 UCS2 for call management +CLCC, +CCWA,+COLP,+CLIP 09-06-2000 P JP. BIOU Modification : +CHLD (Added Explicit Call Transfer) 13-06-2000 P J. BERDIN New : +CCLK, +CALA, +CSNS, %D2, +CRMP, +CRSL. New Phone-Books (LD,MC,RC,ME,MT,SN) Modifications : +CSMP, +CPBS, +CPBW 14-06-2000 P J. BERDIN Modifications : +CRMP, +CRSL, +COPS. 19-06-2000 P J. BERDIN Modification : +CPBF. This confidential document is the property of WAVECOM and may not be copied or circulated without permission iv AT commands interface 28-06-2000 P J. BERDIN Modifications : +CRMP, +CRSL, +WAIP. 06-07-2000 P C. AMIENS Modifications : +ECHO 13-07-2000 P J. BERDIN New : +W32K This confidential document is the property of WAVECOM and may not be copied or circulated without permission v AT commands interface CONTENTS 1 INTRODUCTION........................................................................................................... 12 SCOPE OF THIS DOCUMENT ....................................................................................... 12 RELATED DOCUMENTS .............................................................................................. 12 ETSI SECRETARIAT .................................................................................................. 13 DEFINITIONS............................................................................................................. 13 1.1 1.2 1.3 1.4 2 AT COMMANDS FEATURES ....................................................................................... 14 WAVECOM LINE SETTINGS ......................................................................................... 14 COMMAND LINE ........................................................................................................ 14 INFORMATION RESPONSES AND RESULT CODES.......................................................... 14 2.1 2.2 2.3 3 GENERAL BEHAVIORS .............................................................................................. 15 SIM INSERTION, SIM REMOVAL ................................................................................ 15 BACKGROUNG INITIALISATION ................................................................................... 16 3.1 3.2 4 GENERAL COMMANDS .............................................................................................. 17 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 5 5.1 5.2 5.3 MANUFACTURER IDENTIFICATION +CGMI ................................................................. 17 REQUEST MODEL IDENTIFICATION +CGMM ............................................................... 17 REQUEST REVISION IDENTIFICATION +CGMR ............................................................ 18 PRODUCT SERIAL NUMBER +CGSN ......................................................................... 18 SELECT TE CHARACTER SET +CSCS ....................................................................... 19 REQUEST IMSI +CIMI ............................................................................................. 20 CARD IDENTIFICATION +CCID .................................................................................. 21 CAPABILITIES LIST +GCAP....................................................................................... 22 REPEAT LAST COMMAND A/ ..................................................................................... 22 POWER OFF +CPOF ................................................................................................ 23 SET PHONE FUNCTIONALITY +CFUN......................................................................... 23 PHONE ACTIVITY STATUS +CPAS ............................................................................. 25 REPORT MOBILE EQUIPEMENT ERRORS +CMEE ....................................................... 25 KEYPAD CONTROL +CKPD ...................................................................................... 26 CLOCK MANAGEMENT +CCLK................................................................................. 27 ALARM MANAGEMENT +CALA................................................................................. 27 RING MELODY PLAYBACK +CRMP........................................................................... 28 RINGER SOUND LEVEL +CRSL ................................................................................ 30 CALL CONTROL COMMANDS.................................................................................... 31 DIAL COMMAND D..................................................................................................... 31 HANG-UP COMMAND H ............................................................................................ 34 ANSWER A CALL A .................................................................................................. 35 This confidential document is the property of WAVECOM and may not be copied or circulated without permission vi AT commands interface 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 6 6.1 6.2 6.3 6.4 6.5 7 7.1 7.2 7.3 7.4 7.5 8 8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 9 9.1 9.2 9.3 REMOTE DISCONNECTION ......................................................................................... 35 EXTENDED ERROR REPORT +CEER.......................................................................... 36 DTMF SIGNALS +VTD, +VTS .................................................................................. 37 REDIAL LAST TELEPHONE NUMBER ATDL ................................................................. 39 AUTOMATIC DIALING WITH DTR AT%DN ................................................................. 39 AUTOMATIC ANSWER ATS0 ..................................................................................... 41 INCOMING CALL BEARER +CICB............................................................................. 41 SINGLE NUMBERING SCHEME +CSNS ...................................................................... 43 GAIN CONTROL +VGR, +VGT .................................................................................. 44 MICROPHONE MUTE CONTROL +CMUT .................................................................... 46 SPEAKER & MICROPHONE SELECTION +SPEAKER .................................................. 47 ECHO CANCELLATION +ECHO................................................................................. 48 SIDETONE MODIFICATION +SIDET............................................................................ 50 INITIALIZE VOICE PARAMETERS +VIP....................................................................... 51 NETWORK SERVICE COMMANDS ............................................................................. 52 SIGNAL QUALITY +CSQ........................................................................................... 52 OPERATOR SELECTION +COPS ............................................................................... 52 NETWORK REGISTRATION +CREG ............................................................................ 56 READ OPERATOR NAME +WOPN.............................................................................. 58 PREFERRED OPERATOR LIST +CPOL....................................................................... 59 SECURITY COMMANDS.............................................................................................. 62 ENTER PIN +CPIN .................................................................................................. 62 ENTER PIN2 +CPIN2 ............................................................................................... 65 PIN REMAINING ATTEMPT NUMBER +CPINC ............................................................. 67 FACILITY LOCK +CLCK ........................................................................................... 68 CHANGE PASSWORD +CPWD .................................................................................. 70 PHONEBOOK COMMANDS ........................................................................................ 72 SELECT PHONEBOOK MEMORY STORAGE +CPBS ..................................................... 72 READ PHONEBOOK ENTRIES +CPBR ........................................................................ 73 FIND PHONEBOOK ENTRIES +CPBF.......................................................................... 74 WRITE PHONEBOOK ENTRY +CPBW......................................................................... 75 PHONEBOOK PHONE SEARCH +CPBP ...................................................................... 77 MOVE ACTION IN PHONEBOOK +CPBN ..................................................................... 79 SUBSCRIBER NUMBER +CNUM ................................................................................ 82 AVOID PHONEBOOK INIT +WAIP ............................................................................... 83 SHORT MESSAGES COMMANDS .............................................................................. 84 PARAMETERS DEFINITION.......................................................................................... 84 SELECT MESSAGE SERVICE +CSMS ......................................................................... 85 NEW MESSAGE ACKNOWLEDGEMENT +CNMA ......................................................... 86 This confidential document is the property of WAVECOM and may not be copied or circulated without permission vii AT commands interface 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 PREFERRED MESSAGE STORAGE +CPMS ............................................................... 89 PREFERRED MESSAGE FORMAT +CMGF.................................................................. 91 SAVE SETTINGS +CSAS .......................................................................................... 93 RESTORE SETTINGS +CRES .................................................................................... 93 SHOW TEXT MODE PARAMETERS +CSDH.................................................................. 94 NEW MESSAGE INDICATION +CNMI........................................................................... 94 READ MESSAGE +CMGR ......................................................................................... 97 LIST MESSAGE +CMGL ........................................................................................... 99 SEND MESSAGE +CMGS ....................................................................................... 100 WRITE MESSAGE TO MEMORY +CMGW ................................................................. 101 SEND MESSAGE FROM STORAGE +CMSS .............................................................. 102 SET TEXT MODE PARAMETERS +CSMP ................................................................. 103 DELETE MESSAGE +CMGD.................................................................................... 105 SERVICE CENTER ADDRESS +CSCA ....................................................................... 107 SELECT CELL BROADCAST MESSAGE TYPES +CSCB ............................................. 108 CELL BROADCAST MESSAGE IDENTIFIERS +WCBM ................................................ 109 MESSAGE STATUS MODIFICATION +WMSC ............................................................. 110 MESSAGE OVERWRITING +WMGO ......................................................................... 110 10 SUPPLEMENTARY SERVICES COMMANDS..................................................... 112 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 CALL FORWARDING +CCFC................................................................................... 112 CALL BARRING +CLCK ......................................................................................... 113 MODIFY SS PASSWORD +CPWD............................................................................ 115 CALL WAITING +CCWA ......................................................................................... 115 CALLING LINE IDENTIFICATION RESTRICTION +CLIR................................................. 117 CALLING LINE IDENTIFICATION PRESENTATION +CLIP.............................................. 118 CONNECTED LINE IDENTIFICATION PRESENTATION +COLP ...................................... 120 ADVICE OF CHARGE +CAOC.................................................................................. 121 ACCUMULATED CALL METER +CACM..................................................................... 122 ACCUMULATED CALL METER MAXIMUM +CAMM ..................................................... 123 PRICE PER UNIT AND CURRENCY TABLE +CPUC...................................................... 124 CALL RELATED SUPPLEMENTARY SERVICES +CHLD ............................................... 125 LIST CURRENT CALLS +CLCC................................................................................. 126 SUPPLEMENTARY SERVICE NOTIFICATIONS +CSSN ................................................. 127 UNSTRUCTURED SUPPLEMENTARY SERVICE DATA +CUSD ...................................... 129 CLOSED USER GROUP +CCUG............................................................................... 131 11 . DATA COMMANDS ........................................................................................... 133 11.1 11.2 11.3 11.4 11.5 11.6 BEARER TYPE SELECTION +CBST.......................................................................... 133 SELECT MODE +FCLASS ...................................................................................... 135 SERVICE REPORTING CONTROL +CR ...................................................................... 136 CELLULAR RESULT CODES +CRC........................................................................... 136 DTE-DCE LOCAL RATE REPORTING +ILRR ............................................................ 137 RADIO LINK PROTOCOL PARAMETERS +CRLP......................................................... 138 This confidential document is the property of WAVECOM and may not be copied or circulated without permission viii AT commands interface 11.7 11.8 11.9 11.10 11.11 OTHERS RADIO LINK PARAMETERS +DOPT............................................................. 139 SELECT DATA COMPRESSION %C ........................................................................... 140 V42 BIS DATA COMPRESSION +DS ......................................................................... 141 V42 BIS DATA COMPRESSION REPORT +DR ............................................................ 143 SELECT DATA ERROR CORRECTING MODE \N........................................................... 144 12 FAX COMMANDS ................................................................................................ 146 12.1 12.2 12.3 12.4 12.5 12.6 12.7 TRANSMIT SPEED +FTM......................................................................................... 146 RECEIVE SPEED +FRM .......................................................................................... 147 HDLC TRANSMIT SPEED +FTH............................................................................... 148 HDLC RECEIVE SPEED +FRH ................................................................................ 148 STOP TRANSMISSION AND WAIT +FTS..................................................................... 149 RECEIVE SILENCE +FRS ........................................................................................ 150 SETTING UP THE PC FAX APPLICATION: ................................................................... 151 13 FAX CLASS 2 COMMANDS ................................................................................ 152 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 TRANSMIT DATA +FDT .......................................................................................... 152 RECEIVE DATA +FDR ............................................................................................ 152 TRANSMIT PAGE PUNCTUATION +FET..................................................................... 153 PAGE TRANSFER STATUS PARAMETERS +FPTS ...................................................... 153 TERMINATE SESSION +FK...................................................................................... 154 PAGE TRANSFER BIT ORDER +FBOR...................................................................... 154 BUFFER SIZE REPORT +FBUF ................................................................................ 155 COPY QUALITY CHECKING +FCQ ............................................................................ 155 CAPABILITY TO RECEIVE +FCR .............................................................................. 156 CURRENT SESSIONS PARAMETERS +FDIS .............................................................. 156 DCE CAPABILITIES PARAMETERS +FDCC .............................................................. 159 LOCAL ID STRING +FLID ....................................................................................... 160 PAGE TRANSFER TIMEOUT PARAMETER +FPHCTO ................................................. 161 FAX CLASS 2 INDICATION MESSAGES ...................................................................... 161 14 V24-V25 COMMANDS ......................................................................................... 163 14.1 14.2 14.3 14.4 14.5 14.6 14.7 14.8 14.9 14.10 14.11 14.12 FIXED DTE RATE +IPR .......................................................................................... 163 DTE-DCE CHARACTER FRAMING +ICF................................................................... 164 DTE-DCE LOCAL FLOW CONTROL +IFC ................................................................ 165 SET DCD SIGNAL &C ............................................................................................ 167 SET DTR SIGNAL &D............................................................................................. 167 SET DSR SIGNAL &S............................................................................................. 168 BACK TO ONLINE MODE O ...................................................................................... 168 RESULT CODE SUPPRESSION Q .............................................................................. 169 DCE RESPONSE FORMAT V ................................................................................... 169 DEFAULT CONFIGURATION Z .................................................................................. 170 SAVE CONFIGURATION &W .................................................................................... 170 AUTO-TESTS &T.................................................................................................... 171 This confidential document is the property of WAVECOM and may not be copied or circulated without permission ix AT commands interface 14.13 14.14 14.15 14.16 ECHO E................................................................................................................. 172 RESTORE FACTORY SETTINGS &F........................................................................... 172 DISPLAY CONFIGURATION &V................................................................................. 173 REQUEST IDENTIFICATION INFORMATION I ............................................................... 173 15 SPECIFIC AT COMMANDS ................................................................................. 176 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 CELL ENVIRONMENT DESCRIPTION +CCED ............................................................. 176 AUTOMATIC RXLEV INDICATION +CCED ................................................................. 177 GENERAL INDICATIONS +WIND.............................................................................. 178 ANALOG DIGITAL CONVERTERS MEASUREMENTS +ADC........................................... 180 MOBILE EQUIPMENT EVENT REPORTING +CMER..................................................... 181 READ LANGUAGE PREFERENCE +WLPR ................................................................ 182 WRITE LANGUAGE PREFERENCE +WLPW.............................................................. 183 READ GPIO VALUE +WIOR ................................................................................... 184 WRITE GPIO VALUE +WIOW ................................................................................. 184 ABORT COMMAND +WAC ...................................................................................... 185 PLAY TONE +WTONE............................................................................................ 185 PLAY DTMF TONE +WDTMF................................................................................. 187 WAVECOM DOWNLOADING +WDWL....................................................................... 188 WAVECOM VOICE RATE +WVR .............................................................................. 189 DATA RATE +WDR............................................................................................... 191 HARDWARE VERSION +WHWV .............................................................................. 193 DATE OF PRODUCTION +WDOP............................................................................. 193 WAVECOM SELECT VOICE GAIN +WSVG ................................................................ 194 WAVECOM STATUS REQUEST +WSTR .................................................................... 195 WAVECOM SCAN +WSCAN.................................................................................... 196 WAVECOM RING INDICATOR MODE +WRIM ............................................................. 197 WAVECOM 32KHZ POWERDOWN MODE +W32K ...................................................... 198 16 SIM TOOLKIT....................................................................................................... 200 16.1 16.2 16.3 OVERVIEW OF SIM APPLICATION TOOLKIT .............................................................. 200 EXCHANGED MESSAGES DURING A SIM TOOLKIT OPERATION................................... 203 SIM TOOLKIT COMMANDS ................................................................................ 204 17 OTHER AT COMMANDS ..................................................................................... 223 17.1 17.2 17.3 V.25 TER RECOMMANDATION .................................................................................. 223 GSM 07.05 RECOMMANDATION .............................................................................. 223 GSM 07.07 RECOMMANDATION .............................................................................. 223 18 APPENDICES ...................................................................................................... 224 18.1 18.2 18.3 ME ERROR RESULT CODE : +CME ERROR:............................................ 224 MESSAGE SERVICE FAILURE RESULT CODE: +CMS ERROR : ......................... 225 SPECIFIC ERROR RESULT CODES ............................................................................. 226 This confidential document is the property of WAVECOM and may not be copied or circulated without permission x AT commands interface 18.4 18.5 18.6 18.7 18.8 18.9 18.10 18.11 18.12 FAILURE CAUSE FROM GSM 04.08 RECOMMANDATION (+CEER)............................. 226 SPECIFIC FAILURE CAUSE FOR +CEER ................................................................... 228 GSM 04.11 ANNEX E-2: MOBILE ORIGINATING SM-TRANSFER ................................ 228 UNSOLICITED RESULT CODES .................................................................................. 231 FINAL RESULT CODES ............................................................................................. 232 INTERMEDIATE RESULT CODES ................................................................................ 232 PARAMETERS STORAGE .......................................................................................... 233 GSM SEQUENCES LIST ........................................................................................... 235 OPERATOR NAMES ................................................................................................. 238 19 APPENDIX A (INFORMATIVE) ............................................................................ 245 19.1 19.2 19.3 19.4 INFORMATIVE EXAMPLE ABOUT THE PIN REQUIRED .................................................. 245 INFORMATIVE EXAMPLE ABOUT PHONEBOOKS .......................................................... 251 INFORMATIVE EXAMPLE ABOUT SHORT MESSAGES ................................................... 254 INFORMATIVE EXAMPLE ABOUT FAX CLASS 2 ........................................................... 255 20 APPENDIX B: SUPPORT OF SIM TOOLKIT BY THE M.E.................................. 259 21 APPENDIX C: STRUCTURE OF TERMINAL PROFILE....................................... 260 22 APPENDIX D: COMMAND TYPE AND NEXT ACTION 23 APPENDIX E: CODING OF ALPHA FIELDS IN THE SIM FOR UCS2................. 264 24 APPENDIX F: SPECIFICATION OF POWER DOWN CONTROL VIA RS232 ..... 267 INDICATOR................ 263 This confidential document is the property of WAVECOM and may not be copied or circulated without permission xi AT commands interface 1 Introduction 1.1 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 12 AT commands interface 1.3 ETSI secretariat The following addresses can be useful to get the latest GSM recommendations. Postal address : F-06921 Sophia Antipolis CEDEX – France Office address : 650 Route des Lucioles – Sophia Antipolis – Valbonne – France Internet : secretariat@etsi.fr Tel : +33 4 92 94 42 00 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 13 AT commands interface 2 AT commands features 2.1 Wavecom line settings A serial link handler is set with these default values (factory settings) : - 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 character. 2.3 Information responses and result codes Responses start and end with , 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 : or +CMS ERROR : 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 and will be intentionally omitted. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 14 AT commands interface 3 General behaviors 3.1 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 15 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) ADN 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 16 AT commands interface 4 General commands 4.1 Manufacturer identification +CGMI 4.1.1 Description : This command gives the manufacturer identification. 4.1.2 Syntax : Command syntax : AT+CGMI Command AT+CGMI Possible responses WAVECOM MODEM OK Note : Get manufacturer identification Note : Command valid, Wavecom modem 4.2 Request model identification +CGMM 4.2.1 Description : 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 17 AT commands interface 4.2.2 Syntax : Command syntax : AT+CGMM Command AT+CGMM Possible responses 900P OK Note : Get hardware version Note : GSM 900 MHz primary band, or “900E” (extended band), “1800” (DCS), “1900” (PCS) or “MULTIBAND” 4.3 Request revision identification +CGMR 4.3.1 Description : This command is used to get the revised software version. 4.3.2 Syntax : Command syntax : AT+CGMR Command AT+CGMR Possible responses 310_G250.51 806216 032199 17:04 OK Note : Get software version Note : Software release 3.10, revision 51 generated on the 21st March 1999 4.4 Product Serial Number +CGSN 4.4.1 Description : 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 18 AT commands interface 4.4.2 Syntax : Command syntax : AT+CGSN Command AT+CGSN Possible responses 135790248939 OK Note : Request IMEI Note : IMEI present in EEPROM AT+CGSN +CME ERROR: 22 Note : Request IMEI Note : IMEI not found in EEPROM 4.5 Select TE character set +CSCS 4.5.1 Description : 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. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 19 AT commands interface 4.5.2 Syntax : Command syntax : AT+CSCS Command Possible responses AT+CSCS=”GSM” OK Note : GSM default alphabet Note : Command valid AT+CSCS=”PCCP437” OK Note : PC character set code page 437 Note : Command valid 4.6 Request IMSI +CIMI 4.6.1 Description : 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.6.2 Syntax Command syntax : AT+CIMI Command Possible responses AT+CIMI 208200120320598 Note : Read the IMSI Note : IMSI value (15 digits), starting with MCC (3 digits) / MNC (2 digits, 3 for PCS 1900) See appendice 18.12 for MCC / MNC description. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 20 AT commands interface 4.7 Card Identification +CCID 4.7.1 Description : This command orders the module to read the EF-CCID file on the SIM card. 4.7.2 Syntax : Command syntax : AT+CCID Command Possible responses AT+CCID +CCID : “123456789AB111213141” Note : Get card id Note : EF-CCID is present, hexadecimal format AT+CCID ? +CCID : “123456789AB111213141” Note : Get current value Note : Same result as +CCID AT+CCID= ? OK Note : Get possible value Note : No parameter but this command is valid In case of absent EF-CCID file on the SIM, the +CCID will not be sent. But the OK will be present. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 21 AT commands interface 4.8 Capabilities list +GCAP 4.8.1 Description : This command gives the complete capabilities list. 4.8.2 Syntax : Command syntax : AT+GCAP Command AT+GCAP Possible responses +GCAP: +CGSM +FCLASS OK Note : Get capabilities list Note : Supports GSM commands and FAX 4.9 Repeat last command A/ 4.9.1 Description : Only A/ command can not be repeated. This command repeats the previous executed command. 4.9.2 Syntax : Command syntax : A/ Command Possible responses A/ Note : Repeat last command This confidential document is the property of WAVECOM and may not be copied or circulated without permission 22 AT commands interface 4.10 Power off +CPOF 4.10.1 Description : This specific command stops the GSM software stack as well as the hardware layer. The AT+CFUN=0 command is equivalent to +CPOF 4.10.2 Syntax : Command syntax : AT+CPOF Command Possible responses AT+CPOF OK Note : Stop GSM stack Note : Command valid 4.11 Set phone functionality +CFUN 4.11.1 Description : 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 confidential document is the property of WAVECOM and may not be copied or circulated without permission 23 AT commands interface 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. 4.11.2 Syntax : Command syntax : AT+CFUN Command Possible responses AT+CFUN? +CFUN: 1 Note : Ask for current functionality level OK Note : Full functionality AT+CFUN=0 OK Note : Set minimum functionality, IMSI detach procedure Note : Command valid AT+CFUN=1 OK Note : Set the full functionality mode with a complete software reset Note : Command valid This confidential document is the property of WAVECOM and may not be copied or circulated without permission 24 AT commands interface 4.12 Phone activity status +CPAS 4.12.1 Description : This command returns the activity status of the mobile equipment. 4.12.2 Syntax : Command syntax : AT+CPAS Command Possible responses AT+CPAS +CPAS: Note : Current activity status OK 4.12.3 Defined values : 0 : ready (allow commands from TA/TE) 1 : unavailable (does not allow cmds) 2 : unknown 3 : ringing (ringer is active) 4 : call in progress 5 : asleep (low functionality) 4.13 Report Mobile Equipement errors +CMEE 4.13.1 Description : This command disables or enables the use of result code “+CME ERROR : ” or “+CMS ERROR : ” instead of simply “ERROR”. See appendice 18.1 for +CME ERROR result codes description and appendice 18.2 for +CMS ERROR result codes. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 25 AT commands interface 4.13.2 Syntax : Command syntax : AT+CMEE Command AT+CMEE=0 Possible responses OK Note : Disable ME error reports, use only « ERROR » AT+CMEE=1 OK Note : Enable «+CME ERROR: » Or «+CMS ERROR: » 4.14 Keypad control +CKPD 4.14.1 Description : Execution command emulates ME keypad by giving each keystroke as a character in a string . The supported GSM sequences are listed in appendice 18.11. If emulating fails in an ME error, +CME ERROR: is returned. If emulating succeeds, the result depends on the GSM sequence. : string of following characters (0-9,*,#). 4.14.2 Syntax : Command syntax : AT+CKPD Command AT+CKPD=”*#21#” Possible responses +CCFC: 0,7 Note : Check every call forwarding status AT+CKPD=”1234” +CME ERROR 3 Note : Sequence not allowed This confidential document is the property of WAVECOM and may not be copied or circulated without permission 26 AT commands interface 4.15 Clock Management +CCLK 4.15.1 Description : 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). 4.15.2 Syntax : Command syntax : AT+CCLK Command Possible responses AT+CCLK=”00/06/09,17:33:00” OK Note : set date to June 9th, 2000 and time to 5:33 pm Note : Date/Time stored AT+CCLK=”00/13/13,12:00:00” +CME ERROR 3 Note : Bad month is entered AT+CCLK? +CCLK: “00/06/09,17:34:23” Note : get current date and time Note : current date is June 9th, 2000 current time is 5:34:23 pm 4.16 Alarm Management +CALA 4.16.1 Description : 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. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 27 AT commands interface 4.16.2 Syntax : Command syntax : AT+CALA Command Possible responses AT+CALA=”00/06/09,07:30” OK Note : set an alarm for June 9th, 2000 at 7:30 am Note : Alarm stored AT+CALA=”99/03/05,13:00:00” +CME ERROR 3 Note : set an alarm for March 5th, 1999 at 1:00 pm Note : Invalid alarm (date/time expired) AT+CALA? +CALA: “00/06/08,15:25:00”,0 +CALA: “00/06/09,07:30:00”,1 Note : list all alarms Note : two alarms are set (index 0 and 1) +CALA: “00/06/08,15:25:00”,0 Note : an alarm occur (index 0) 4.17 Ring Melody Playback +CRMP 4.17.1 Description : This command allows to play a melody. All melodies are manufacturer defined. For incomming voice, data or fax call, 10 manufacturer-defined melodies could be playback (in loop). For incomming short message, 2 manufacturer-defined sounds could 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 field set to 0 (example: +CRMP=0,,,0). When parameter is given, this overwrites value of +CRSL command. If parameter is not given, value of +CRSL is used as default value. 4.17.2 Syntax : Command syntax : AT+CRMP= [, , , ] This confidential document is the property of WAVECOM and may not be copied or circulated without permission 28 AT commands interface Command Possible responses AT+CRMP=0,7,0,2 OK Note : Play voice call melody index 2 with volume level 7. Note : Melody Playback. AT+CRMP=0,,,0 OK Note : Stop the melody. Note : The melody is stopped. AT+CRMP=? +CRMP: (0-3),(0-15),0,(0-10) Note : supported parameters OK 4.17.3 Defined values : 0 : Incomming voice call 1 : Incomming data call 2 : Incomming fax call 3 : Incomming short message (SMS) 0 : Min volume … 6 : Default volume … 15 : Max volume 0 : Manufacturer Defined (default) 0 : Stop Melody Playback 1-10 : Melody ID for voice/data/fax call type (default : 1) 1-2 : Melody ID for short message (default : 1) This confidential document is the property of WAVECOM and may not be copied or circulated without permission 29 AT commands interface 4.18 Ringer Sound Level +CRSL 4.18.1 Description : This command allows to set/get the sound level.of the incomming call ringer. Set command change default value of +CRMP command. 4.18.2 Syntax : Command syntax : AT+CRSL= Command Possible responses AT+CRSL=0 OK Note : Set volume to Min. Note : Current ring playing with Min. volume. AT+CRSL=15 OK Note : Set volume to Max. Note : Current ring playing with Max. volume. AT+CRSL? +CRSL: 15 OK Note : get current ringer sound level Note : Current level is 15 (max.) AT+CRSL=? +CRSL: (0-15) Note : supported parameters OK 4.18.3 Defined values : 0 : Min volume 6 : Default volume (default) 15 : Max volume This confidential document is the property of WAVECOM and may not be copied or circulated without permission 30 AT commands interface 5 Call Control commands 5.1 Dial command 5.1.1 D Description : 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 where 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 ; where 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 31 AT commands interface The answer to the ATD command can be one of the following: Verbose result code Numeric (V0 set) Description OK 0 if the call succeeds, for voice call only CONNECT 10,11,12,13,14,15 if the call succeeds, for data calls only, takes the value negotiated by the GSM module. BUSY 7 If the called party is already in communication NO ANSWER 8 If no hang up is detected after a fixed network timeout NO CARRIER 3 Call setup failed or remote user release. Use the AT+CEER command to know the failure cause See paragraph 18.8 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 command : ATD> ; for calling from the selected phonebook (by +CPBS command) ATD> “BILL”; for calling “BILL” from the the selected phonebook ATD> mem (mem is “SM","LD","MC","ME","RC","MT" or "SN", see +CPBS command) is a way to dial directly from a phonebook number. Don’t work with "ON" mem. 5.1.2 Syntax : Command syntax : AT+CPBS Command Possible responses AT+CPBS? +CPBS:”FD”,5,10 Note : Which phonebook is selected ? Note : FDN phonebook is selected, 5 locations are used and 10 locations are available ATD>SM6; Note : Call index 6 from ADN phonebook OK Note : Call succeeds This confidential document is the property of WAVECOM and may not be copied or circulated without permission 32 AT commands interface 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). It’s 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, +CME ERROR: is returned. See paragraph 18.11 to have the list of supported sequences. Command Possible responses ATD*#21# +CCFC: 0,7 Note : Check any call forwarding status Note : No call forwarding ATD**61*+33146290800**25# OK Note : Register call forwarding on no reply, with no Note : done reply timer fixed at 25 s. ATD*2# +CME ERROR 3 Note : Bad sequence This confidential document is the property of WAVECOM and may not be copied or circulated without permission 33 AT commands interface 5.2 Hang-Up command H 5.2.1 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 : Command syntax : ATH Command Possible responses ATH OK Note : Ask for disconnection ATH1 Note : Every calls, if any, are released OK Note : Ask for outgoing call disconnection Note : Outgoing call, if any, is released This confidential document is the property of WAVECOM and may not be copied or circulated without permission 34 AT commands interface 5.3 Answer a call A 5.3.1 Description : When the GSM module receives a call, it sets the RingInd signal and sends to the application the ASCII string “RING” or “+CRING: ” if cellular result code (+CRC) is enabled. Then it waits for the application to accept the call. 5.3.2 Syntax : Command syntax : ATA Command Possible responses RING Note : Incoming call ATA OK Note : Answer to this incoming call Note : Call accepted ATH NO CARRIER Note : Disconnect call Note : Call disconnected 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 35 AT commands interface 5.5 Extended error report +CEER 5.5.1 Description : This command gives the reason of the call release when the last call setup (originating or answering) failed. 5.5.2 Syntax : Command syntax : AT+CEER Command Possible responses ATD123456789 ; NO CARRIER Note : Outgoing voice call Note : Call setup failure AT+CEER +CEER : Error OK Note : Ask for reason of release Note : 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 36 AT commands interface 5.6 DTMF signals +VTD, +VTS 5.6.1 +VTD Description : 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= where *100 gives the duration in ms. If n < 4 the tone duration is 300 ms. 5.6.2 +VTD Syntax : Command syntax : AT+VTD Command Possible responses AT+VTD=6 OK Note : To define 600 ms tone length Note : Command valid AT+VTD=0 OK 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= where 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 37 AT commands interface 5.6.4 +VTS Syntax : Command syntax : AT+VTS Command AT+VTS=A Possible responses OK Note : Command valid AT+VTS=11 +CME ERROR: 4 Note : To set the manufacturer default value Note : If the is wrong AT+VTS=4 +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 38 AT commands interface 5.7 Redial last telephone number ATDL 5.7.1 Description : 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 : Command syntax : ATDL Command Possible responses ATDL 0146290800; Note : Redial last number OK Note : Last call was a speech call. Command valid 5.8 Automatic dialing with DTR AT%Dn 5.8.1 Description : This command allows to activate and deactivate : the automatic dialing of the phone number stored in the first location of ADN 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 39 AT commands interface 5.8.2 Syntax : Command syntax : AT%D [ ;] Command Possible responses AT%D1; OK Note : Activates DTR number dialing Note : Command has been executed DTR is OFF DTR switches ON Note : The number in the first location of the ADN is dialed automatically DTR switches OFF Note : The module goes on-hook AT%D2 OK Note : Activates DTR sort message sending Note : Command has been executed 5.8.3 Defined values : (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. AT%D0 Deactivates automatic DTR number dialing / message sending AT%D1; Activates automatic DTR dialing if DTR switches from OFF to ON; Dials the phone number in the first location of ADN phonebook. Speech call. AT%D1 Activates automatic DTR dialing if DTR switches from OFF to ON; Dials the phone number in the first location of ADN phonebook. Data or Fax call. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 40 AT commands interface AT%D2 Activates automatic DTR message sending if DTR switches from OFF to ON 5.9 Automatic answer ATS0 5.9.1 Description : This S0-parameter determines and controls the automatic answering feature of the mobile. 5.9.2 Syntax : Command syntax : ATS0= Command ATS0=2 Possible responses OK Note : Automatic answer after 2 rings ATS0? 002 OK Note : Current value Note : always 3 characters with leading zeros ATS0=0 OK Note : No automatic answer Note : Command valid All others S-parameters (S6,S7,S8 …) are not implemented. 5.10 Incoming Call Bearer +CICB 5.10.1 Description : 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 41 AT commands interface 5.10.2 Syntax : Command syntax : AT+CICB Command Possible responses AT+CICB=1 OK Note : If no incoming bearer, force a fax call Note : Command accepted AT+CICB=2 OK Note : If no incoming bearer, force a speech call Note : Command accepted AT+CICB? +CICB: 2 Note : Interrogate value Note : Default incoming bearer: speech call AT+CICB=? +CICB: (0-2) Note : Test command Note : Speech, data or fax default incoming bearer 5.10.3 Defined values : 0 : Data 1 : Fax 2 : Speech This confidential document is the property of WAVECOM and may not be copied or circulated without permission 42 AT commands interface 5.11 Single Numbering Scheme +CSNS 5.11.1 Description : 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 : Command syntax : AT+CSNS Command Possible responses AT+CSNS=2 OK Note : force a fax call Note : Command accepted AT+CSNS=2 OK Note : force a voice call Note : Command accepted AT+CSNS? +CSNS: 0 Note : Interrogate value Note : Default incoming bearer: voice call AT+CSNS=? +CSNS: (0,2,4) Note : Test command Note : Voice, data or fax default incoming bearer 5.11.3 Defined values : 0 : Voice 2 : Fax 4 : Data This confidential document is the property of WAVECOM and may not be copied or circulated without permission 43 AT commands interface 5.12 Gain control +VGR, +VGT 5.12.1 Description : 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= for the receive gain AT+VGT= for the AT+VGT= for the transmit gain transmit gain Controler 1 controler 1 Controler 2 controler 2 0 to 15 +6 db 0 to 31 +30 db 0 0 db 16 to 31 +4 db 32 to 63 +33 db 1 0,5 db 32 to 47 +2 db 64 to 95 +36 db 2 1 db 48 to 63 +0 db 96 to 127 +39 db 3 1,5 db 64 to 79 -2 db 128 to 159 +42 db … 80 to 95 -4 db 160 to 191 +45 db 19 9,5 db 96 to 111 -6 db 192 to 223 +48 db 20 10 db 112 to 127 -8 db 224 to 255 +51 db 21 to 60 30 db 128 to 143 -10 db 61 30,5 db 144 to 159 -12 db 62 31 db 160 to 175 -14 db … … 176 to 191 -16 db 101 50,5 db 192 to 207 -18 db 102 to 127 51 db 208 to 223 -20 db 128 to 243 -6,5 db 224 to 239 -22 db 244 -6 db 240 to 255 -24 db 245 -5,5 db 246 -5 db … … 255 -0,5 db This confidential document is the property of WAVECOM and may not be copied or circulated without permission 44 AT commands interface 5.12.2 Syntax : Command syntax : AT+VGR AT+VGT Command AT+VGR=25 Possible responses OK Note : Command valid AT+VGT=45 OK Note : Command valid AT+VGR? +VGR: 64 Note : Interrogate value Note : Default receive gain AT+VGR=? +VGR : (0-255) Note : Test command Note : Possibles values AT+VGT? +VGT: 64 Note : Interrogate value Note : Default transmit gain.l AT+VGT=? +VGT : (0-255) Note : Test command Note : Possibles values This confidential document is the property of WAVECOM and may not be copied or circulated without permission 45 AT commands interface 5.13 Microphone Mute Control +CMUT 5.13.1 Description : 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 : Command syntax : AT+CMUT= Command AT+CMUT=? Possible responses +CMUT : (0,1) OK Note : Test command Note : Enable / disable mute AT+CMUT? +CMUT : 0 OK Note : Ask for current value Note : Current value is OFF AT+CMUT=1 OK Note : Mute ON (call active) Note : Command valid AT+CMUT? +CMUT : 1 OK Note : Ask for current value Note : Mute is active (call active) AT+CMUT=0 +CME ERROR:3 Note : Mute OFF (call not active) Note : Command not valid 5.13.3 Defined values : 0 : microphone mute off (default value). This confidential document is the property of WAVECOM and may not be copied or circulated without permission 46 AT commands interface 1 : microphone mute on. 5.14 Speaker & Microphone selection +SPEAKER 5.14.1 Description This specific command is used to choose the speaker and the microphone. 5.14.2 Syntax : Command syntax : AT+SPEAKER= Command Possible responses AT+SPEAKER=0 OK Note : Speaker ONE and Micro ONE Note : Command valid AT+SPEAKER? +SPEAKER: 0 OK Note : Speaker ONE and Micro ONE are active 5.14.3 Defined values : 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 47 AT commands interface 5.15 Echo Cancellation +ECHO 5.15.1 Description : This specific command is used to activate, deactivate or configure the Echo Cancellation functions (for voice calls, in small rooms, cars…) 5.15.2 Syntax : Command syntax : AT+ECHO = [, , , , , , , ] Command AT+SPEAKER? Possible responses + SPEAKER:0 OK Note : Speaker ONE and Micro ONE are active AT+ECHO? +ECHO: 0,1,0,3,10,7 Note : Read current settings OK AT+ECHO=1,1,0,3,10,7 OK Note : Active Echo cancellation for Mic/Speak one. AT+ECHO? +ECHO: 1,1,0,3,10,7 Note : Read current settings OK 5.15.3 Defined values: 0: Deactivate Echo 1: Activate Echo 1: Echo cancellation (switch attenuation) This confidential document is the property of WAVECOM and may not be copied or circulated without permission 48 AT commands interface Echo cancellation (4 parameters) : The parameter specifies the maximum attenuation of the switch 0 : 31 db (default) 1 : 29 db 2 : 27 db 3 : 25 db ..: … … 14: 3 db 15: 1 db The parameter specifies the attenuation step between attenuation and no attenuation. 0: 1: 2: 3: 1 db 2 db 3 db 4 db (default) The parameter specifies the relative threshold between max and min energy information. The allowed range is [ 0 ; 31 ]. (10 default) The parameter specifies threshold of max energy information. The allowed range is [ 0 ; 31 ]. (7 default) Read Command: AT+ECHO? This command returns the current settings of the Echo cancelation. Returns:+ECHO: , , , , , , , 0 1 2 3 Echo Deactivated. Echo Activated for Mic/Speak one. Echo Activated for Mic/Speak two. Reset the module. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 49 AT commands interface 5.16 SideTone modification +SIDET 5.16.1 Description : 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 : Command syntax : AT+SIDET= , Command AT+SIDET=1,0 Possible responses OK Note : Command valid AT+SIDET? +SIDET: 1,0 Note : Current value OK Note : Command valid 5.16.3 Defined values : 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 50 AT commands interface 5.17 Initialize Voice Parameters +VIP 5.17.1 Description : This command allows to restore the factory settings about the voice parameters from EEPROM. These voice parameters include : • • • • • 5.17.2 Gain control, Microphone mute control, Speaker & Microphone selection, Echo cancelation, Side tone modification. Syntax : Command syntax : AT+VIP= Command Syntax Return AT+VIP= AT+VIP=? +VIP: 1 AT+VIP? +VIP: (1) 1 Restore all voice parameters. Command AT+VIP? Possible responses +VIP: 1 OK AT+VIP=2 +CME ERROR: 3 Note : Syntax error AT+VIP=1 OK Note : Restore the factory settings in EEPROM Note : The command has been executed AT+VIP=1 CME ERROR: 519 Note : Restore the factory settings in EEPROM with the current Echo cancellation algo different of the default algo. AT+VIP=? Note : List of supported s Note : Reset the module to accept the new algo. +VIP: (1) OK This confidential document is the property of WAVECOM and may not be copied or circulated without permission 51 AT commands interface 6 Network service commands 6.1 Signal Quality +CSQ 6.1.1 Description : This command is used to know the received signal strength indication ( ) and the channel bit error rate ( ) with or without any SIM card inserted. 6.1.2 Syntax : Command syntax : AT+CSQ Command Possible responses AT+CSQ +CSQ: , OK Note : and as defined below 6.1.3 Defined values : : 0 1 2..30 31 99 : -113 dBm or less : -111 dBm : -109 to –53 dBm : -51dBm or greater : not known or not detectable : 0…7 : as RXQUAL values in the table GSM 05.08 99 : not known or not detectable 6.2 Operator selection +COPS 6.2.1 Description : To select the operator, three possibilities exist : This confidential document is the property of WAVECOM and may not be copied or circulated without permission 52 AT commands interface 1- 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. 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= , [ [ , ] ] Possible responses for AT+COPS= : OK (Network is selected in full service) +CME ERROR: 30 (No network service), +CME ERROR: 32 (Network not allowed – emergency calls only) +CME ERROR: 3 +CME ERROR: 4 (Wrong parameters) Response syntax for AT+COPS?: +COPS: [, , ] Response syntax for AT+COPS=?: +COPS: [list of supported ( , long alphanumeric , short alphanumeric s, numeric ) s] If an incomming call occur during an ask plmn list, the operation is aborted (+CME ERROR: 520) and the unsolicited RING appears. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 53 AT commands interface Command Possible responses AT+COPS? +COPS: 0,2,20801 Note : Ask for current PLMN OK Note : Home PLMN is France Telecom Itinéris AT+COPS=? +COPS: (2,”F Itinéris”,”Itline”,”20801”), (3,”F SFR”,”SFR”,”20810”) OK Note : Ask for PLMN list Note : Home PLMN is France Telecom SFR network has been detected AT+COPS=1,2,20810 +CME ERROR: 32 Note : Ask for registration on SFR network Note : Network not allowed – emergency calls only AT+COPS=1,1,20810 +CME ERROR: 3 Note : Ask for registration on SFR network Note : Operation not allowed AT+COPS=0,2 OK Note : Ask for registration on home network Note : Succeeded AT+COPS? +COPS: 0,0”F Itinéris” OK Note : Ask for current PLMN Note : Home PLMN is France Telecom Itinéris! So the attempt to register on SFR Network has failed but the automatic selection on Home PLMN has succedeed This confidential document is the property of WAVECOM and may not be copied or circulated without permission 54 AT commands interface 6.2.3 Defined values : The parameters values are the following ones: 0: automatic (default value) 1: manual 3: set only (for read command AT+COPS?) 4: manual / automatic ( shall be present), if manual selection fails, automatic mode is entered. : format of field 0: long format alphanumeric 1: short format alphanumeric 2: numeric (default value) : status of 0: unknown 1: available 2: current 3: forbidden : 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 55 AT commands interface 6.3 Network registration +CREG 6.3.1 Description This command is used by the application to know the registration status of the mobile. 6.3.2 Syntax : Command syntax : AT+CREG= Response syntax : +CREG : , [ , , ] for AT+CREG? Command only Command AT+CREG? Possible responses +CREG: , OK Note : As defined before AT+CREG=0 OK Note : Disable network registration unsollicited result code Note : Command valid AT+CREG=1 OK Note : Enable network registration unsollicited result code Note : Command valid AT+CREG=2 OK Note : Enable network registration and location information unsollicited result code Note : Command valid AT+CREG=? +CREG: (0-2) Note : 0,1,2 values are supported 6.3.3 Defined values : 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 56 AT commands interface 1: Enable network registration code result code +CREG : 2: Enable network registration and location information unsolicited result code +CREG: , , if there is a change of the network cell. 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 : string type; two byte location area code in hexadecimal format (e.g. “00C3” equals 195 in decimal) : 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 57 AT commands interface 6.4 Read operator name +WOPN 6.4.1 Description : This specific command returns the operator name in alphanumeric format when given the numeric format. 6.4.2 Syntax : Command syntax: AT+WOPN= , Response syntax: +WOPN: , Command AT+WOPN=? Possible responses OK Note : Test command AT+WOPN=0,20801 +WOPN : 0,”F Itinéris” Note : Give an operator in numeric format OK Note : Alphanumeric answer AT+WOPN=0,99999 +CME ERROR: 22 Note : Give a wrong operator Note : Not found 6.4.3 Defined values : is the required format. Only long (0) and short (1) alphanumeric formats are supported. is the operator in numeric format. 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 58 AT commands interface 6.5 Preferred operator list +CPOL 6.5.1 Description : This command is used to edit the SIM preferred list of networks. 6.5.2 6.5.2 Syntax : Command syntax: AT+CPOL= [ ][ , [ , ] ] The different possibilities are: - AT+CPOL = - AT+CPOL = , to delete an entry. to set the format used by the read command (AT+CPOL?). - AT+CPOL = , , to put in the next free location. - AT+CPOL = , , to write in the at the . 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 Note : Preferred list of networks in numeric format AT+CPOL=,0 OK 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 This confidential document is the property of WAVECOM and may not be copied or circulated without permission 59 AT commands interface AT+CPOL=7,2,20801 OK Note : Add a network to the list AT+CPOL? +CPOL: 1,0,”D1-TELEKOM” +CPOL: 6,0,”F SFR” +CPOL: 7,0,”F Itinéris” OK Note : Give a wrong operator Note : Preferred list of networks in long alphanumeric format AT+CPOL=7 OK Note : Delete 7th location AT+CPOL? +CPOL: 1,0,”D1-TELEKOM” +CPOL: 6,0,”F SFR” OK Note : Ask for preferred list of networks Note : Preferred list of networks in long alphanumeric format AT+CPOL=8,2,77777 OK Note : Add an inexistent network to the list AT+CPOL? +CPOL: 1,0,”D1-TELEKOM” +CPOL: 6,0,”F SFR” +CPOL: 8,2,77777” OK Note : Ask for preferred list of networks 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 Itinéris” 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 60 AT commands interface AT+CPOL? +CPOL: 1,0,”D1-TELEKOM” +CPOL: 6,0,”F SFR” +CPOL: 8,2,77777” +CPOL: 9,0,”F Itinértis” OK Note : Ask for preferred list of networks Note : Preferred list of networks in long alphanumeric format This confidential document is the property of WAVECOM and may not be copied or circulated without permission 61 AT commands interface 7 Security commands 7.1 Enter PIN 7.1.1 +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). It’s up to the application to validate the PIN after each reset or power on if the PIN was enabled 7.1.2 Syntax : Command syntax : AT+CPIN= Command Possible responses AT+CPIN=1234 OK Note : Enter PIN Note : PIN code is correct AT+CPIN=5678 +CME ERROR : 3 Note : Enter PIN Note : Operation not allowed, PIN previously entered 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= , Command Possible responses This confidential document is the property of WAVECOM and may not be copied or circulated without permission 62 AT commands interface AT+CPIN=00000000,1234 +CME ERROR: 16 Note : Enter PUK and new PIN Note : Incorrect PUK AT+CPIN=12345678,1234 OK Note : Enter PUK and new PIN, 2nd attempt 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 ME is not pending for any password +CPIN: SIM PIN CHV1 is required +CPIN: SIM PUK PUK1 is required +CPIN: SIM PIN2 CHV2 is required +CPIN: SIM PUK2 PUK2 is required +CPIN: PH-SIM PIN SIM lock (phone-to-SIM) is required +CPIN: PH-NET PIN Network personnalisation is required +CME ERROR: 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? Read the PIN status +CPIN: SIM PIN The GSM module requires SIM PIN AT+CPIN=1235 First attempt to enter a SIM PIN +CME ERROR: 16 Bad PIN This confidential document is the property of WAVECOM and may not be copied or circulated without permission 63 AT commands interface AT+CPIN=1236 Second attempt +CME ERROR: 16 Bad PIN AT+CPIN=1237 Third attempt +CME ERROR: 16 Bad PIN AT+CPIN? Read PIN state +CPIN: SIM PUK The GSM module requires PUK AT+CPIN=99999999,5678 The PUK is entered, the new PIN shall be 5678 PUK validation is OK. New Pin is 5678 OK AT+CPIN? Read PIN state +CPIN: READY GSM module is ready 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” Possible responses OK Note : Choose FDN AT+CPBW=5,”01290917”,129,”Jacky” +CME ERROR: 17 Note : Write in FDN at location 5 Note : SIM PIN2 is required AT+CPIN? SIM PIN2 Note : SIM PIN2 is required AT+CPIN=5678 OK This confidential document is the property of WAVECOM and may not be copied or circulated without permission 64 AT commands interface Note : Enter SIM PIN2 AT+CPBW=2,”01290917”,129,”Jacky” OK Note : Write in FDN at location 5 Note : Now writing in FDN is allowed Please note that the GSM module only ask once PIN2 or PUK2, so if they aren’t 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 Enter PIN2 +CPIN2 7.2.1 Description : 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 : AT+CPIN2= Command Possible responses AT+CPIN2=1234 OK Note : Enter PIN2 AT+CPIN2=5678 Note : PIN2 code is correct +CME ERROR: 3 Note : Enter PIN2 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 65 AT commands interface AT+CPIN2= , Command Possible responses AT+CPIN2=00000000,1234 +CME ERROR: 16 Note : Enter PUK2 and new PIN2 Note : Incorrect Password (PUK2) AT+CPIN2=12345678,1234 OK Note : Enter PUK2 and new PIN2, 2nd attempt 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 No PIN2 is needed +CPIN2: SIM PIN2 PIN2 is required +CPIN2: SIM PUK2 PUK2 is required +CME ERROR: Absent (10) etc… This confidential document is the property of WAVECOM and may not be copied or circulated without permission 66 AT commands interface 7.3 PIN remaining attempt number 7.3.1 +CPINC Description : 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 : Command syntax : AT+CPINC Response syntax : +CPINC : , , , Command Possible responses AT+CPINC +CPINC : 2,3,10,10 Note : Ask remaining tries Note : First CHV1 attempt was a failure AT+CPINC? +CPINC : 2,3,10,10 Note : Ask current values Note : First attempt was a failure AT+CPINC=? OK Note : Ask possible values 7.3.3 Defined values , are the remaining tries of PIN1, PIN2 (0 = blocked, 3 max) , 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 67 AT commands interface 7.4 Facility lock +CLCK 7.4.1 Description : This command shall be used by the application to lock, unlock or interrogate a ME or network facility . 7.4.2 Syntax : Command syntax: AT+CLCK= , [, [, ] ] Response syntax: +CLCK: [ , ] +CLCK: , […]] Command Possible responses AT+CLCK=”SC”,1,1234 OK Note : Enable PIN Note : PIN was right AT+CLCK? +CLCK: (“PS”, 0), (“PN,0),(“FD”,0) Note : Read PIN status OK Note : PIN is enables, no SIM lock, no network lock, no informati n on Call barring (no longer supported in GSM 07.07) AT+CLCK=”SC”,0,5555 +CME ERROR: 16 Note : Disable PIN Note: PIN was wrong AT+CPIN=1234 OK Note : Enter PIN Note : PIN was good AT+CLCK=? +CLCK!“PS”,”SC”,”AO”,”OI”,”OX”,”AI”,”IR”,”AB” ,”AC”,”FD”,”PN”) Note : Request supported facilities OK Note : Supported facilities AT+CLCK=”PN”,1,12345678 OK This confidential document is the property of WAVECOM and may not be copied or circulated without permission 68 AT commands interface Note : Activate network lock Network lock activated AR+CLCK=”AO”,1,1234,2 OK Note : Activate all outgoing calls barring for data calls Note : Call barring is activate AT+CLCK=”AO”,2 +CLCK : 1,2 Note : Query BAOC status OK Note : BAOC activate for data calls only 7.4.3 Defined values : The following values are supported: “PS” : SIM lock facility with a 8 digits password. « SC » : PIN enable ( = 1) / disable ( = 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). “FD”: SIM Fixed Dialling Numbers (FDN) memory feature (PIN2 is required as ) 0 : unlock the facility 1 : lock the facility 2 : query status This confidential document is the property of WAVECOM and may not be copied or circulated without permission 69 AT commands interface : A facility status can be changed for only one class, or for all classes (7 or omitted). 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 Change password +CPWD 7.5.1 Description This command shall be used by the application to change a password (PIN, call barring, NCK…). The facility values ( ) 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 : Command syntax : AT+CPWD= , , Command AT+CPWD=? Note : Possible values Possible responses +CPWD: (“PS”,8),(“SC”,8),(“AO”,4),(“OI”,4),(“OX”,4), (“AI”,4),(“IR,4),(“AB”,4),(“AG”,4),(“AC”,4), (“P2”,8),(“FD”,8),(“PN”,8) OK Note : CHV1/CHV2 must be on 8 digits maximum (4mn) For call barring, on 4 digits maximum This confidential document is the property of WAVECOM and may not be copied or circulated without permission 70 AT commands interface AT+CPWD=”SC”,1234,5555 OK Note : Change PIN Note : PIN was good AT+CPWD=”SC”,1234,5555 +CME ERROR: 16 Note : Change PIN Note: PIN was wrong AT+CPIN=5555 OK Note : Enter PIN Note : PIN was good AT+CPWD=”PN”,12345678,00000000 OK Note : Change NCK Note : NCK changed for net lock This confidential document is the property of WAVECOM and may not be copied or circulated without permission 71 AT commands interface 8 Phonebook commands 8.1 Select phonebook memory storage +CPBS 8.1.1 Description : This command selects phonebook memory storage. The available phonebooks are: “SM” : ADN (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 : Command syntax : AT+CPBS Command Possible responses AT+CPBS=”SM” OK Note : Select ADN phonebook Note : ADN phonebook is selected AT+CPBS=? +CPBS: ("SM","LD","MC","ON","ME","RC","MT", "SN") Note : Possible values This confidential document is the property of WAVECOM and may not be copied or circulated without permission 72 AT commands interface OK Note : only “EN” phonebook is not supported with this SIM card. AT+CPBS? +CPBS :”SM”,10,20 Note : Status OK Note: ADN phonebook selected, 10 used locations, 20 locations available The ADN phonebook could not be selected is FDN is active. 8.2 Read phonebook entries +CPBR 8.2.1 Description : This command returns phonebook entries for a location range from the current phonebook memory storage selected with +CPBS. 8.2.2 Syntax : Command syntax : AT+CPBR Command Possible responses AT+CPBR=? +CPBR: (1-50),20,10 Note : Test command OK Note : 50 locations (from 1 to 50), max length of 20 for phone, 10 charcters max for the associated text AT+CPBR=12,14 +CPBR : 12,”112”,129,”Emergency” Note : Read entries from 12 to 14 +CPBR : 13,”+331290909”,145,”Fred” +CPBR : 14,”0146290808”,129,”Zazi” OK Note : Display locations 12,13,14 with location, This confidential document is the property of WAVECOM and may not be copied or circulated without permission 73 AT commands interface number, type (TON/NPI), Text AT+CPBR=10 +CPBR :10,”0146290921”,129,”Rob” Note : Read entry 10 OK Note: Display location 10 AT+CPBR=11 +CPBR :11,”0146290921”,129,”8000010002FFFF” Note : Read entry 11 (UCS2 format) OK Note: Display location 11 AT+CPBR=52 +CME ERROR: 21 Note : Read entry 52 (wrong) Note : Invalid index 8.3 Find phonebook entries +CPBF 8.3.1 Description : 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. 8.3.2 Syntax : Command syntax : AT+CPBF Command Possible responses AT+CPBF=? +CPBF: 20,10 Note : Test command OK Note : Max length of 20 for phone, 10 characters for the text This confidential document is the property of WAVECOM and may not be copied or circulated without permission 74 AT commands interface AT+CPBF= “E” +CPBF : 12,”112”,129,”Emergency” Note : Read entries with “E” +CPBF : 15,”+331290101”,145,”Eric” OK Note : Display locations with text field starting with “E” AT+CPBF=”H” +CME ERROR: 22 Note : Read entries with “H” Note: Entry not found AT+CPBF=”800001FFFF” +CPBF : 11, ”0146290921”,129,”8000010002FFFF” Note : Read entries with “800001” (UCS2 format) OK Note : Display locations with text field starting with “800001” 8.4 Write phonebook entry +CPBW 8.4.1 Description : This command writes phonebook entry in location number in the current phonebook memory storage. This command is not allowed for “EN”, “LD”, “MC”, “RC”, “MT”, “SN” phonebooks, which are not writable. 8.4.2 Syntax : Command syntax : AT+CPBW= [, [, [, ]]] Command Possible responses AT+CPBW=? +CPBW: (1-50),20,(129,145),10 Note : Test command OK Note : 50 locations, phone length = 20, TON/NPI of 129 or 145, text length = 10 AT+CPBW= 3 OK Note : Erase location 3 Note : Location 3 erased This confidential document is the property of WAVECOM and may not be copied or circulated without permission 75 AT commands interface AT+CPBW=5,”112”,129,”SOS” OK Note : Write at location 5 Note: Location 5 written AT+CPBW=5,”01290917”,129,”Jacky” OK Note : Overwrite location 5 Note : Location 5 overwritten AT+CPBW=6,”01292349”,129,”8000410042” OK Note : write location 6 (UCS2 format for the Note : Location 6 is written field) AT+CPBW=,”+33145221100”,145,”SOS” OK Note : Write at the first free location Note : Free location is written AT+CPBW=,”0345221100”,129,”SOS” +CME ERROR: 20 Note : Write at the first free location Note : Phonebook full AT+CPBW=57,”112”,129,”WM” +CME ERROR: 21 Note : Write at location 57 (wrong) 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 Note : Text too long 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” Possible responses OK This confidential document is the property of WAVECOM and may not be copied or circulated without permission 76 AT commands interface Note : Choose FDN AT+CPBW=5,”01290917”,129,”Jacky” +CME ERROR: 17 Note : Write in FDN at location 5 Note : SIM PIN2 is required AT+CPIN? SIM PIN2 Note: SIM PIN2 is required AT+CPIN=5678 OK Note : Enter SIM PIN2 AT+CPBW=5,”01290917”,129,”Jacky” OK Note : Write in FDN at location 5 Note : Now writing in FDN is allowed 8.4.3 Defines values : integer type value depend of capacity of phonebook memory. Phone number in ASCII format. TON/NPI (Type of address octet in integer format). string type. REM: For the parameter 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). The +CSCS (Select Character set) command not affect the format for the phonebook entries. 8.5 Phonebook phone search +CPBP 8.5.1 Description : This specific command orders the module to look in the phonebook for an item having the same phone number that defined in parameter. This confidential document is the property of WAVECOM and may not be copied or circulated without permission 77 AT commands interface 8.5.2 Syntax : Command syntax : AT+CPBP= is coded like all phone numbers in GSM 07.07 or GSM 07.05 . Command Possible responses AT+CPBP=”+331290101” +CPBP : 15,”+331290101”,145,”Eric” Note : Read entries with this phone number OK Note : Display location with this phone number AT+CPBP=”+331290101” +CPBP : 15,”+331290101”,145,”Eric” Note : Read entries with this phone number OK Note : Display location with this phone number AT+CPBP=”+331290101” +CPBP : 15,”+331290101”,145,”Eric” Note : Read entries with this phone number OK Note : Display location with this phone number AT+CPBP=”+331290101” +CPBP : 15,”+331290101”,145,”Eric” Note : Read entries with this phone number OK Note : Display location with this phone number AT+CPBP=”+331288575” +CPBP : 15,”+331290101”,145,”8045682344FFFF” (UCS2 format) Note : Read entries with this phone number OK Note : Display location with this phone number AT+CPBP=”0129” +CME ERROR: 22 Note : Read entries with this phone number Note : Entry not found This confidential document is the property of WAVECOM and may not be copied or circulated without permission 78 AT commands interface 8.6 Move action in phonebook +CPBN 8.6.1 Description 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 : Command syntax : AT+CPBN = Command Possible responses AT+CPBN=? +CPBN: (0-3) Note : Test command OK Note : Possible modes AT+CPBN=0 +CPBN : 15,”+331290101”,145,”Eric” Note : Read the first location OK Note : Display the first location AT+CPBN=2 +CPBN : 5,”+33147658987”,145,”Frank” Note : Read the next location OK Note : Display the second location AT+CPBN=2 +CPBN : 6,”+331290302”,145,”Marc” Note : Read the next location OK Note : Display the third location AT+CPBN=3 +CPBN : 5,”+33147658987”,145,”Frank” Note : Read the previous location OK Note : Display the second location This confidential document is the property of WAVECOM and may not be copied or circulated without permission 79 AT commands interface AT+CPBN=1 +CPBN : 6,”+331290302”,145,”Marc” Note : Read the last location OK Note : Display the last location AT+CPBN=2 +CPBP : 15,”+331290101”,145,”Eric” Note : Read the next location OK Note : Display the first location Using mode 4 and 5 with +CPBF command and CPBW : Command Possible responses AT+CPBF=”Er” +CPBF : 15,”+331290101”,145,”Eric” Note : Find ”Er” in phonebook OK Note : Display this location AT+CPBN=2 +CPBN : 5,”+33147658987”,145,”Frank” Note : Read the next location OK Note : Display the following location AT+CPBF=”Er” +CPBF : 15,”+331290101”,145,”Eric” Note : Find”Er” in phonebook OK Note : Display this location AT+CPBN=4 +CPBF : 15,”+331290101”,145,”Eric” Note : Read the last read location OK Note : Display the last read location AT+CPBW=,”0146290800”,129,”WM” OK Note : Write an item at the first free location Note : No information about 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 80 AT commands interface Note : Read the last read location 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 AT+CPBN=38,”0146290800,129,”WM” Note : Read the last read item Note : Now the last read item is the last writen item too AT+CPBF=”800041FFFF” +CPBF : 15,”+3312345”,145,”8000414339FFFF” Note : Find”800041” in phonebook OK Note : Display this location AT+CPBN=4 +CPBF : 15,”+3312345”,145,”8000414339FFFF” Note : Read the last read location OK Note : Display the last read 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 : 0 : First item 1 : Last item 2 : Next valid item in alphabetical order 3 : Previous valid item in alphabetical order 4 : Last read item 5 : Last written item This confidential document is the property of WAVECOM and may not be copied or circulated without permission 81 AT commands interface 8.7 Subscriber number +CNUM 8.7.1 Description : This command returns the MSISDN(s) related to the subscriber. If the subscriber has different MSISDNs for different services, each MSISDN is returned in a separate line. 8.7.2 Syntax : Command syntax : Response syntax : AT+CNUM +CNUM : , , +CNUM : , , …. Command AT+CNUM Possible responses +CNUM :”Phone”, “0612345678”,129 +CNUM :”Fax”, “0687654321”,129 Note : Get MSISDN(s) +CNUM : “80001002FFFF”, “+0183773”, 145 (UCS2 format) Note : MSISDNs AT+CNUM=? 8.7.3 OK Defined values : optional alphanumeric string associated with string type phone number of format specified by type of adress octet in integer format This confidential document is the property of WAVECOM and may not be copied or circulated without permission 82 AT commands interface 8.8 Avoid phonebook init +WAIP 8.8.1 Description : This specific command allows to inhibit the initialization of all phonebooks during the next boots. 8.8.2 Syntax : Command syntax : AT+WAIP= Command AT+WAIP? Possible responses +WAIP :0 OK Note : Current values ? Note : Default value (init phonebooks) AT+WAIP=? +WAIP : (0,1) Note : Possible values ? OK Note : Disable / enable AT+WAIP =1 OK Note : Inhibit initialization of phonebooks (next boot) Note : no answer AT&W Note : Save modifications in EEPROM Be careful: The given value should be stored in EEPROM, so the command AT&W must be used to save the new 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 : 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 83 AT commands interface 9 Short Messages commands 9.1 Parameters definition Destination Address, coded like GSM 03.40 TP-DA Data Coding Scheme, coded like in document [5]. Discharge Time in string format : “yy/MM/dd,hh :mm :ss±zz” (Year [00-99], Month [01-12], Day [01-31], Hour, Minute, Second and Time Zone [quarters of an hour] ) First Octet, coded like SMS-SUBMIT first octet in document [4], default value is 17 for SMS-SUBMIT Place of storage in memory. Text mode (+CMGF=1): number of characters PDU mode (+CMGF=0): length of the TP data unit in octets Memory used to list, read and delete messages (+CMGL, +CMGR and +CMGD). Memory used to write and send messages (+CMGW, +CMSS). CBM Message Identifier. Message Reference. Originator Address. Protocol Identifier. For SMS : GSM 04.11 SC address followed by GSM 03.40 TPDU in hexadecimal format, coded as specified in doc [4] For CBS : GSM 03.41 TPDU in hexadecimal format