AT Commands Interface Guide 011
AT Commands Interface Guide - 011 AT Commands Interface Guide - 011
AT Commands Interface Guide - 011 AT Commands Interface Guide - 011
User Manual: AT Commands Interface Guide - 011
Open the PDF directly: View PDF .
Page Count: 337
Download | |
Open PDF In Browser | View PDF |
pochette MUSE 15/11/01 17:12 Page 1 GIVE W INGS TO YOUR IDEAS AT Commands Interface Guide Revision: 011 Date: June 2003 PLUG IN TO THE WIRELESS WORLD Page: 1 / 64 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. AT Commands Interface Guide Revision : 011 Date : 20 June 2003 Reference : WM_ASW_OAT_UGD_004 Page : 1 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 Level 001/9.1 002 Date 01/11/01 27/02/02 History of the evolution Full revision Updates : +VGR, +WSST, +WOPEN, +CMER, +CLCK, +WLCK, +WBW, +WBR Add: +WBM, +WBR, +WBW Modifications on Gpio and Bus commands New commands: +WATH, +WLOC add WIND level: level 11 for checksum of phonebooks level 12 for interrupt new fetures: “loca” and “interrupt” Correction : +ATO +WBW / +WBR parameters modification GPRS commands Add commands : +WIMEI, +CPLS Update : +CPOL +CMER +CPLW +CGSN +WFM, +WCDP, +CRMP, +ECHO, +VGT, +ICF, +VIP, +SPEAKER, +CCFC Add CME ERROR 27 Update DOPT description, add details for AT&F Correct AT%C default value Update Table 19.10 for +CPHS command. Update AT examples Correct AT+DR=? response Add optional lac parameter for AT+WOPN Update commands +VTD, +VTS, +CCFC, +CCWA, +SIDET, +CSQ, +WDTMF, +WBCI, +CIEV, +CMEC, +CIND, +COPN, +CMBS, +WSVN, +CMER, +WALS, +WNON, +WDCI, +WCPI, +WCSP, +CPHS, +WVMI, +WMBN, +WDCI, +CCFC, +WOPEN, +WFM, +CGEREP, +CGATT, \N, +CGDCONT, +CGSMS, +CGANS, +CGPADDR 003 27/02/02 004 005 05/04/02 Jul 02 006 Aug 02 007 Oct 02 008 Jan 03 009 03/03 010 20/05/03 Updates for X40a release. Update §19.10 Table for +IPR, +CGDCONT, +CPHS commands. Update examples for +WCDP, +CRLP. Update commands +VIP, +DS, +CIND, +CCLK. Update the network service codes (BS) in §19.11.2, Insert the HR_ECHO feature, Added Appendix H for interoperability commands 011 20/06/03 Additional detail corrections. Modify +WMBS, Add GPRS commands Update or correct +W32K, +WBM, +WBR, +WBW, +WCFM, +ILLR, +CR, +CRC, +CLIR, +DS, +CCWA, +CGSMS, +CGCLASS, +WGPRS, +CGACT, +WRST, +WALS, +CGREG, &F, +CMER, +ECHO, +WALS, +WCSP, +WMBS, +WFM Update GPIO configuration Update operator table Update parallel bus parameters Add alphabetical index for commands and responses Update operator names, presentation, add Overview paragraph Page : 2 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 Contents 1 Introduction ............................................................................. 11 1.1 Scope of this document.........................................................................11 1.2 Related documents................................................................................11 1.3 ETSI secretariat .....................................................................................12 1.4 Definitions .............................................................................................12 1.5 Presentation rules .................................................................................12 2 AT commands features............................................................. 13 2.1 Wavecom line settings ..........................................................................13 2.2 Command line .......................................................................................13 2.3 Information responses and result codes ................................................13 3 General behaviors ..................................................................... 14 3.1 SIM Insertion, SIM Removal ..................................................................14 3.2 Background initialization .......................................................................15 4 General commands ................................................................... 16 4.1 Manufacturer identification +CGMI ......................................................16 4.2 Request model identification +CGMM ..................................................16 4.3 Request revision identification +CGMR ................................................17 4.4 Product Serial Number +CGSN.............................................................17 4.5 Select TE character set +CSCS .............................................................18 4.6 Wavecom Phonebook Character Set +WPCS........................................19 4.7 Request IMSI +CIMI .............................................................................20 4.8 Card Identification +CCID .....................................................................21 4.9 Capabilities list +GCAP.........................................................................21 4.10 Repeat last command A/.......................................................................22 4.11 Power off +CPOF..................................................................................22 4.12 Set phone functionality +CFUN ............................................................23 4.13 Phone activity status +CPAS ................................................................24 4.14 Report Mobile Equipment errors +CMEE ..............................................25 4.15 Keypad control +CKPD .........................................................................26 4.16 Clock Management +CCLK ...................................................................27 Page : 3 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.17 Alarm Management +CALA..................................................................28 4.18 Ring Melody Playback +CRMP .............................................................29 4.19 Ringer Sound Level +CRSL ...................................................................30 5 Call Control commands ............................................................ 31 5.1 Dial command D....................................................................................31 5.2 Hang-Up command H...........................................................................33 5.3 Answer a call A ....................................................................................34 5.4 Remote disconnection ...........................................................................34 5.5 Extended error report +CEER................................................................35 5.6 DTMF signals +VTD, +VTS ..................................................................36 5.7 Redial last telephone number ATDL......................................................37 5.8 Automatic dialing with DTR AT%Dn .....................................................38 5.9 Automatic answer ATS0 ......................................................................39 5.10 Incoming Call Bearer +CICB .................................................................40 5.11 Single Numbering Scheme +CSNS .......................................................41 5.12 Gain control +VGR, +VGT.....................................................................42 5.13 Microphone Mute Control +CMUT .......................................................44 5.14 Speaker & Microphone selection +SPEAKER ........................................45 5.15 Echo Cancellation +ECHO.....................................................................46 5.16 SideTone modification +SIDET .............................................................49 5.17 Initialize Voice Parameters +VIP............................................................50 6 Network service commands ..................................................... 51 6.1 Signal Quality +CSQ.............................................................................51 6.2 Operator selection +COPS ....................................................................52 6.3 Network registration +CREG ................................................................54 6.4 Read operator name +WOPN ...............................................................55 6.5 Selection of Preferred PLMN list +CPLS................................................56 6.6 Preferred operator list +CPOL ...............................................................57 6.7 Read operator name +COPN ................................................................60 7 Security commands .................................................................. 61 7.1 Enter PIN +CPIN ...................................................................................61 7.2 Enter PIN2 +CPIN2 ...............................................................................63 7.3 PIN remaining attempt number +CPINC ...............................................65 7.4 Facility lock +CLCK ...............................................................................66 7.5 Change password +CPWD ...................................................................68 Page : 2 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 8 Phonebook commands ............................................................. 70 8.1 Select phonebook memory storage +CPBS...........................................70 8.2 Read phonebook entries +CPBR ...........................................................71 8.3 Find phonebook entries +CPBF ............................................................72 8.4 Write phonebook entry +CPBW............................................................73 8.5 Phonebook phone search +CPBP .........................................................75 8.6 Move action in phonebook +CPBN .......................................................76 8.7 Subscriber number +CNUM .................................................................78 8.8 Avoid phonebook init +WAIP................................................................79 8.9 Delete Calls Phonebook +WDCP............................................................80 8.10 Set Voice Mail Number +CSVM .............................................................81 9 Short Messages commands...................................................... 82 9.1 Parameters definition ............................................................................82 9.2 Select message service +CSMS ...........................................................83 9.3 New Message Acknowledgement +CNMA...........................................84 9.4 Preferred Message Storage +CPMS .....................................................86 9.5 Preferred Message Format +CMGF ......................................................87 9.6 Save Settings +CSAS ...........................................................................89 9.7 Restore settings +CRES........................................................................89 9.8 Show text mode parameters +CSDH....................................................90 9.9 New message indication +CNMI ..........................................................91 9.10 Read message +CMGR.........................................................................93 9.11 List message +CMGL ...........................................................................95 9.12 Send message +CMGS.........................................................................97 9.13 Write Message to Memory +CMGW.....................................................98 9.14 Send Message From Storage +CMSS...................................................99 9.15 Set Text Mode Parameters +CSMP ....................................................100 9.16 Delete message +CMGD ....................................................................102 9.17 Service center address +CSCA ...........................................................103 9.18 Select Cell Broadcast Message Types +CSCB.....................................104 9.19 Cell Broadcast Message Identifiers +WCBM.......................................105 9.20 Message status modification +WMSC................................................106 9.21 Message overwriting +WMGO ...........................................................107 9.22 Unchange SMS Status +WUSS ...........................................................108 Page : 3 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 10 Supplementary Services commands ....................................... 109 10.1 Call forwarding +CCFC .......................................................................109 10.2 Call barring +CLCK .............................................................................110 10.3 Modify SS password +CPWD.............................................................111 10.4 Call waiting +CCWA...........................................................................112 10.5 Calling line identification restriction +CLIR..........................................113 10.6 Calling line identification presentation +CLIP ......................................114 10.7 Connected line identification presentation +COLP ..............................115 10.8 Advice of charge +CAOC ....................................................................116 10.9 Accumulated call meter +CACM.........................................................117 10.10 Accumulated call meter maximum +CAMM .......................................118 10.11 Price per unit and currency table +CPUC ............................................119 10.12 Call related supplementary services +CHLD........................................119 10.13 List current calls +CLCC ......................................................................120 10.14 Supplementary service notifications +CSSN .......................................121 10.15 Unstructured supplementary service data +CUSD ..............................123 10.16 Closed user group +CCUG..................................................................124 11 Data commands ..................................................................... 125 11.1 Using AT Commands during a data connection...................................125 11.2 Bearer type selection +CBST ..............................................................125 11.3 Select mode +FCLASS........................................................................127 11.4 Service reporting control +CR .............................................................127 11.5 Cellular result codes +CRC .................................................................128 11.6 DTE-DCE local rate reporting +ILRR ......................................................129 11.7 Radio link protocol parameters +CRLP................................................130 11.8 Others radio link parameters +DOPT ..................................................131 11.9 Select data compression %C ...............................................................132 11.10 V42 bis data compression +DS ..........................................................132 11.11 V42 bis data compression report +DR ................................................133 11.12 Select data error correcting mode \N...................................................134 12 Fax commands ....................................................................... 135 12.1 Transmit speed +FTM ........................................................................135 12.2 Receive speed +FRM ..........................................................................136 12.3 HDLC transmit speed +FTH................................................................136 12.4 HDLC receive speed +FRH ..................................................................137 Page : 4 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 12.5 Stop transmission and wait +FTS ......................................................137 12.6 Receive silence +FRS..........................................................................138 12.7 Setting up the PC fax application:........................................................138 13 Fax class 2 commands............................................................ 139 13.1 Transmit Data +FDT...........................................................................139 13.2 Receive Data +FDR.............................................................................139 13.3 Transmit page ponctuation +FET .......................................................139 13.4 Page transfer status parameters +FPTS .............................................140 13.5 Terminate Session +FK.......................................................................140 13.6 Page transfer bit order +FBOR............................................................141 13.7 Buffer size report +FBUF ....................................................................141 13.8 Copy quality checking +FCQ...............................................................142 13.9 Capability to receive +FCR ..................................................................142 13.10 Current sessions parameters +FDIS ...................................................143 13.11 DCE capabilities parameters +FDCC ...................................................145 13.12 Local ID string +FLID ..........................................................................145 13.13 Page transfer timeout parameter +FPHCTO ........................................146 13.14 Fax Class 2 indication messages .........................................................147 14 V24-V25 commands ............................................................... 148 14.1 Fixed DTE rate +IPR ...........................................................................148 14.2 DTE-DCE character framing +ICF .......................................................149 14.3 DTE-DCE local flow control 14.4 Set DCD signal &C .............................................................................151 14.5 Set DTR signal &D..............................................................................151 14.6 Set DSR signal &S..............................................................................152 14.7 Back to online mode O........................................................................153 14.8 Result code suppression Q .................................................................153 14.9 DCE response format +IFC .......................................................150 V......................................................................154 14.10 Default configuration Z .......................................................................154 14.11 Save configuration &W.......................................................................155 14.12 Auto-tests &T.....................................................................................155 14.13 Echo E ................................................................................................156 14.14 Restore factory settings &F ................................................................156 14.15 Display configuration &V ....................................................................157 14.16 Request identification information I ....................................................158 14.17 Data / Commands Multiplexing +WMUX ............................................159 Page : 5 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 15 Specific AT commands ........................................................... 160 15.1 Cell environment description +CCED ..................................................160 15.2 General Indications +WIND ................................................................162 15.3 Analog digital converters measurements +ADC..................................165 15.4 Mobile Equipment event reporting +CMER.........................................167 15.5 Indicator control +CIND .......................................................................168 15.6 Mobile equipment control mode +CMEC .............................................170 15.7 Read Language Preference +WLPR.....................................................170 15.8 Write Language Preference +WLPW...................................................172 15.9 Read GPIO value +WIOR ....................................................................172 15.10 Write GPIO value +WIOW...................................................................173 15.11 Input/Output Management +WIOM....................................................173 15.12 Abort command +WAC ......................................................................175 15.13 Play tone +WTONE.............................................................................176 15.14 Play DTMF tone +WDTMF .................................................................178 15.15 Wavecom Downloading +WDWL .......................................................179 15.16 Wavecom Voice Rate +WVR ...............................................................179 15.17 Data Rate +WDR ...............................................................................180 15.18 Hardware Version +WHWV ................................................................181 15.19 Date of Production +WDOP ................................................................181 15.20 Wavecom Select Voice Gain +WSVG ...................................................182 15.21 Wavecom Status Request +WSTR ......................................................183 15.22 Wavecom Scan +WSCAN....................................................................184 15.23 Wavecom Ring Indicator Mode +WRIM...............................................185 15.24 Wavecom 32kHz Power down Mode +W32K ......................................186 15.25 Wavecom Change Default Melody +WCDM ........................................187 15.26 Wavecom Software version +WSSW..................................................188 15.27 Wavecom Custom Character Set +WCCS ............................................188 15.28 Wavecom LoCK +WLCK .....................................................................190 15.29 CPHS command: +CPHS .....................................................................191 15.30 Unsolicited result : Wavecom Voice Mail Indicator : +WVMI ...............194 15.31 Unsolicited result : Wavecom diverted call indicator: +WDCI...............195 15.32 Wavecom network operator name: +WNON........................................196 15.33 Wavecom CPHS information: +WCPI...................................................197 15.34 Wavecom customer service profile: +WCSP ........................................198 15.35 Wavecom Battery Charge Management +WBCM ...............................199 15.36 Unsolicited result : Wavecom Battery Charge Indication +WBCI..........201 Page : 6 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 15.37 Features Management +WFM............................................................202 15.38 Commercial Features Management +WCFM ......................................205 15.39 Wavecom Customer storage mirror +WMIR .......................................206 15.40 Wavecom Change Default Player +WCDP ..........................................207 15.41 Wavecom CPHS Mail Box Number: +WMBN ......................................208 15.42 Wavecom Alternate Line Service: +WALS............................................209 15.43 Wavecom Open AT control command +WOPEN ................................210 15.44 Wavecom Reset +WRST....................................................................212 15.45 Set Standard Tone +WSST.................................................................213 15.46 Wavecom Location +WLOC ................................................................213 15.47 Wavecom Bus Read +WBR ................................................................216 15.48 Wavecom Bus Write +WBW...............................................................218 15.49 Wavecom Bus Management +WBM ..................................................219 15.50 Wavecom Hang-up +WATH ...............................................................223 15.51 Write IMEI +WIMEI ............................................................................224 15.52 Write IMEI SVN: +WSVN .....................................................................225 15.53 Wavecom multi-band selection command: +WMBS............................226 16 SIM TOOLKIT .......................................................................... 227 16.1 Overview of SIM Application ToolKit ...................................................227 16.2 Messages exchanged during a SIM ToolKit operation. ........................229 16.3 SIM TOOLKIT COMMANDS.................................................................230 17 GPRS commands .................................................................... 242 17.1 Define PDP Context +CGDCONT .........................................................242 17.2 Quality of Service Profile (Requested) +CGQREQ .................................244 17.3 Quality of Service Profile (Minimum acceptable) +CGQMIN .................247 17.4 GPRS attach or detach +CGATT ..........................................................249 17.5 PDP context activate or deactivate +CGACT ........................................250 17.6 Enter data state +CGDATA ..................................................................251 17.7 GPRS mobile station class +CGCLASS ................................................252 17.8 Select service for MO SMS messages +CGSMS ..................................254 17.9 GPRS event reporting +CGEREP ..........................................................255 17.10 GPRS network registration status +CGREG .........................................256 17.11 Request GPRS IP service 'D' .................................................................258 17.12 Network requested PDP context activation ..........................................259 17.13 Automatic response to a network request for PDP context activation +CGAUTO .....................................................................................................260 Page : 7 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 17.14 Manual response to a network request for PDP context activation +CGANS ......................................................................................................261 17.15 Show PDP address +CGPADDR ..........................................................263 17.16 Cellular result codes +CRC ..................................................................264 17.17 Service reporting control +CR .............................................................265 17.18 Extended error report +CEER ..............................................................266 17.19 GPRS PARAMETERS CUSTOMIZATION: +WGPRS..............................266 17.20 Full AT GPRS commands examples.....................................................268 18 Other AT commands ............................................................... 270 18.1 V.25 ter recommendation ....................................................................270 18.2 GSM 07.05 recommendation...............................................................270 18.3 GSM 07.07 recommendation...............................................................270 19 Appendixes ............................................................................. 271 19.1 ME error result code : +CME ERROR:.....................................271 19.2 Message service failure result code: +CMS ERROR : ..................272 19.3 Specific error result codes ...................................................................273 19.4 Failure Cause from GSM 04.08 recommendation (+CEER)...................274 19.5 Specific Failure Cause for +CEER .........................................................275 19.6 GSM 04.11 Annex E-2: Mobile originating SM-transfer......................276 19.7 Unsolicited result codes.......................................................................278 19.8 Final result codes ................................................................................278 19.9 Intermediate result codes ....................................................................279 19.10 Parameters storage .............................................................................279 19.11 GSM sequences list.............................................................................283 19.12 Operator names...................................................................................285 19.13 Data / Commands multiplexing protocol ..............................................298 19.14 CPHS Information field ........................................................................301 19.15 CSP constants .....................................................................................302 20 APPENDIX A (informative) ...................................................... 305 20.1 Examples with the PIN required ..........................................................305 20.2 Examples where a voice call is originated. ...........................................306 20.3 Example with incoming calls ...............................................................306 20.4 Example of a call forwarding ...............................................................307 20.5 Example of a multiparty call.................................................................307 20.6 Examples about phonebooks ...............................................................308 Page : 8 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 20.7 Examples about short messages .........................................................309 20.8 Examples about Fax class 2 ................................................................310 21 APPENDIX B: Support of SIM ToolKit by the M.E. ................... 312 22 APPENDIX C: Structure of TERMINAL PROFILE ....................... 314 23 APPENDIX D: Command Type and Next Action Indicator. ....... 316 24 APPENDIX E: Coding of Alpha fields in the SIM for UCS2 ....... 317 25 APPENDIX F: Specification of Power Down Control via RS232 319 26 APPENDIX G: Conditions for command execution and dependence to SIM.......................................................................... 321 26.1 General commands..............................................................................321 26.2 Call Control commands .......................................................................322 26.3 Network service commands ................................................................322 26.4 Security commands.............................................................................322 26.5 Phonebook commands ........................................................................322 26.6 Short Messages commands ................................................................323 26.7 Supplementary Services commands ....................................................323 26.8 Data commands ..................................................................................324 26.9 Fax commands ....................................................................................324 26.10 Class 2 Commands..............................................................................324 26.11 V24-V25 commands............................................................................325 26.12 Specific AT commands ........................................................................325 26.13 SIM Toolkit commands........................................................................326 26.14 GPRS commands.................................................................................326 27 APPENDIX H: Interoperability commands always reply OK ...... 327 28 Alphabetical Index for AT commands and responses .............. 328 Page : 9 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 Overview The aim of this document is to provide WAVECOM customers with a full description of the AT commands associated with AT software release X40a. WAVECOM®, WISMO®, MUSE Platform™ are trademarks or registered trademarks of Wavecom S.A. in France or in other countries. All other company and/or product names mentioned may be trademarks or registered trademarks of their respective owners. WAVECOM S.A. may, at any time and without notice, make changes or improvements to the products and services offered and/or cease producing or commercializing them. This document is copyrighted material of WAVECOM S.A. © 2003. All rights reserved. Page : 10 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 1 Introduction 1.1 Scope of this document This document describes the AT-command based messages exchanged between an application and the WAVECOM products in order to manage GSM related events or services. Wavecom Module External Application AT Send AT command Receive AT response Serial Link 1.2 Related documents This interface specification is based on the following recommendations: [1] ETSI GSM 07.05: Digital cellular telecommunications system (Phase 2); Use of DTE-DCE interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) [2] ETSI GSM 07.07: Digital cellular telecommunications system (Phase 2); AT command set for GSM Mobile Equipment (ME) [3] ITU-T Recommendation V.25 ter: Serial asynchronous automatic dialling and control [4] ETSI GSM 03.40: Digital cellular telecommunications system (Phase 2); Technical implementation of the Short Message Service (SMS) Point-to-Point (PP) [5] ETSI GSM 03.38: Digital cellular telecommunications system (Phase 2); Alphabets and language-specific information Page : 11 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 [6] ETSI GSM 04.80: Digital cellular telecommunications system (Phase 2): Mobile radio interface layer 3, Supplementary service specification, Formats and coding 1.3 ETSI secretariat The following addresses may be of use in obtaining the latest GSM recommendations: Postal address: F-06921 Sophia Antipolis CEDEX – France Office address: 650 Route des Lucioles – Sophia Antipolis – Valbonne – France e-mail: secretariat@etsi.fr Tel: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 1.4 Definitions The words, “Mobile Station” (MS) or “Mobile Equipment” (ME) are used for mobile terminals supporting GSM services. A call from a GSM mobile station to the PSTN is called a “mobile originated call” (MOC) or “outgoing call”, and a call from a fixed network to a GSM mobile station is called a “mobile terminated call” (MTC) or “incoming call”. In this document, the word “product” refers to any Wavecom product supporting the AT commands interface. 1.5 Presentation rules In the following, the AT commands are presented with as much precision as possible, through three paragraphs. A “Description” paragraph provides general information on the AT command (or response) behaviour. A “Syntax”paragraph describes the way to use it, the possible answers, through a readable format. A “Defined values” paragraph provides parameters values, as well for the AT command as for the corresponding responses. Schemas are provided where necessary. Page : 12 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 2 AT commands features 2.1 Wavecom line settings A serial link handler is set with the following default values (factory settings): autobaud, 8 bits data, 1 stop bit, no parity, RTS/CTS flow control. Please use the +IPR, +IFC and +ICF commands to change these settings. 2.2 Command line Commands always start with AT (which means ATtention) and finish with a character. 2.3 Information responses and result codes Responses start and end with (except for the ATV0 DCE response format) and the ATQ1 (result code suppression) commands. • If command syntax is incorrect, the “ERROR” string is returned,. If command syntax is correct but transmitted with wrong parameters, • the +CME ERROR: or +CMS ERROR: strings is returned with adequate error codes if CMEE was previously set to 1. By default, CMEE is set to 0, and the error message is only “ERROR”. • If the command line has been executed successfully, an “OK” string is returned. In some cases, such as “AT+CPIN?” or (unsolicited) incoming events, the product does not return the “OK” string as a response. In the following examples and are intentionally omitted. Page : 13 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 3 General behaviors 3.1 SIM Insertion, SIM Removal SIM card Insertion and Removal procedures are supported. There are software functions relying on positive reading of the hardware SIM detect pin. This pin state (open/closed) is permanently monitored. When the SIM detect pin indicates that a card is present in the SIM connector, the product tries to set up a logical SIM session. The logical SIM session will be set up or not depending on whether the detected card is a SIM Card or not. The AT+CPIN? command delivers the following responses: • • • • If the SIM detect pin indicates “absent”, the response to AT+CPIN? is “+CME ERROR 10” (SIM not inserted). If the SIM detect pin indicates “present”, and the inserted card is a SIM card, the response to AT+CPIN? is “+CPIN: xxx” depending on SIM PIN state. If the SIM detect pin indicates “present”, and the inserted card is not a SIM card, the response to AT+CPIN? is “+CME ERROR 10”. These last two states are not provided immediately due to background initialization. Between the hardware SIM detect pin indicating “present” and the final results, the AT+CPIN? sends “+CME ERROR: 515” (Please wait, init in progress). When the SIM detect pin indicates card absence, and if a SIM Card was previously inserted, an IMSI detach procedure is performed, all user data is removed from the product (Phonebooks, SMS etc.). The product then switches to emergency mode. Page : 14 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 3.2 Background initialization After entering the PIN (Personal Identification Number), some SIM user data files are loaded into the product (phonebooks, SMS status, etc.). Please be aware that it might take some time to read a large phonebook. The AT+CPIN? command response occurs after the PIN checking. After this response user data is loaded in background. This means that some data may not be available just when PIN entry is confirmed by ’OK’. The reading of phonebooks will then be refused by “+CME ERROR: 515” or “+CMS ERROR: 515” meaning, “Please wait, service is not available yet, init in progress”. This type of answer may be sent by the product at several points: when trying to execute another AT command before the previous one is • completed (before response), • when switching from ADN to FDN (or FDN to ADN) and trying to read the relevant phonebook immediately, • when asking for +CPIN? status immediately after SIM insertion and before the product has determined if the inserted card is a valid SIM card. Page : 15 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 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 Note : Get manufacturer identification Possible responses WAVECOM MODEM OK Note : Command valid, Wavecom modem 4.1.3 Defined values : No parameter 4.2 Request model identification +CGMM 4.2.1 Description : This command is used to get the supported frequency bands. With multi-band products the response may be a combination of different bands. 4.2.2 Syntax : Command syntax : AT+CGMM Command AT+CGMM Note : Get hardware version Possible responses 900P OK Note : GSM 900 MHz primary band. Other possible answers: “900E” (extended band), “1800” (DCS), “1900” (PCS) or “MULTIBAND” 4.2.3 Defined values : No parameter Page : 16 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 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 Note : Get software version Possible responses 440_09gm.Q2406A 1266500 020503 17:06 OK Note : Software release 4.40, generated on the 05th of February 2003 4.3.3 Defined values : No parameter 4.4 Product Serial Number +CGSN 4.4.1 Description : This command allows the user application to get the IMEI (International Mobile Equipment Identity, 15 digits number) of the product. 4.4.2 Syntax : Command syntax : AT+CGSN Command AT+CGSN Possible responses 012345678901234 OK Note : Get the IMEI Note : IMEI read from EEPROM AT+CGSN +CME ERROR: 22 Note : Get the IMEI Note : IMEI not found in EEPROM 4.4.3 Defined values : No parameter Page : 17 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.5 Select TE character set +CSCS 4.5.1 Description : This command informs the ME which character set is used by the TE. The ME can convert each character of entered or displayed strings. This is used to send, read or write short messages. See also +WPCS for the phonebooks’ character sets. 4.5.2 Syntax : Command syntax : AT+CSCS= Command Possible responses AT+CSCS=”GSM” Note : GSM default alphabet AT+CSCS=”PCCP437” Note : PC character set code page 437 AT+CSCS=? Note : Get possible values OK Note : Command valid OK Note : Command valid +CSCS: ("GSM","PCCP437","CUSTOM","HEX") OK Note : Possible values 4.5.3 Defined values : “GSM” GSM default alphabet. “PCCP437” PC character set code page 437. “CUSTOM” User defined character set (cf. +WCCS command). “HEX” Hexadecimal mode. No character set used ; the user can read or write hexadecimal values. Page : 18 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.6 Wavecom Phonebook Character Set +WPCS 4.6.1 Description : This specific command informs the ME which character set is used by the TE for the phonebooks. The ME can convert each character of entered or displayed strings. This is used to read or write phonebook entries. See also +CSCS for the short messages character sets. 4.6.2 Syntax : Command syntax : AT+WPCS= Command Possible responses AT+WPCS=”TRANSPARENT” Note : Transparent mode AT+WPCS=”CUSTOM” Note : Custom character set AT+WPCS=? Note : Get possible values OK Note : Command valid OK Note : Command valid +WPCS: ("TRANSPARENT","HEX","CUSTOM") OK Note : Possible values 4.6.3 Defined values : “TRANSPARENT” “CUSTOM” “HEX” Transparent mode. The strings are displayed and entered as they are stored in SIM or in ME. User defined character set (cf. +WCCS command). Hexadecimal mode. No character set used ; the user can read or write hexadecimal values. Page : 19 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.7 Request IMSI +CIMI 4.7.1 Description : This command is used to read and identify the IMSI (International Mobile Subscriber Identity) of the SIM card. The PIN may need to be entered before reading the IMSI. 4.7.2 Syntax Command syntax : AT+CIMI Command AT+CIMI Note : Read the IMSI Possible responses 208200120320598 OK Note : IMSI value (15 digits), starting with MCC (3 digits) / MNC (2 digits, 3 for PCS 1900) See appendix 19.12 for MCC / MNC description. 4.7.3 Defined values : No parameter Page : 20 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.8 Card Identification +CCID 4.8.1 Description : This command orders the product to read the EF-CCID file on the SIM card. 4.8.2 Syntax : Command syntax : AT+CCID Command Possible responses AT+CCID +CCID: “123456789AB111213141” Note : Get card ID Note : Get current value Note : EF-CCID is present, hexadecimal format + CCID: “123456789AB111213141” Note : Same result as +CCID AT+CCID= ? OK AT+CCID? Note : Get possible value Note : No parameter but this command is valid 4.8.3 Defined values : No parameter If there is no EF-CCID file present on the SIM, the +CCID answer will not be sent, but the OK message will be returned. 4.9 Capabilities list +GCAP 4.9.1 Description : This command gets the complete list of capabilities. 4.9.2 Syntax : Command syntax : AT+GCAP Command AT+GCAP Note : Get capabilities list Possible responses +GCAP: +CGSM +FCLASS OK Note : Supports GSM and FAX commands 4.9.3 Defined values : No parameter Page : 21 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.10 Repeat last command A/ 4.10.1 Description : This command repeats the previous command. Only the A/ command itself cannot be repeated. 4.10.2 Syntax : Command syntax : A/ Command Possible responses A/ Note : Repeat last command 4.10.3 Defined values : No parameter 4.11 Power off +CPOF 4.11.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.11.2 Syntax : Command syntax : AT+CPOF Command Possible responses AT+CPOF OK Note : Stop GSM stack 4.11.3 Note : Command valid Defined values : No parameter Page : 22 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.12 Set phone functionality +CFUN 4.12.1 Description : This command selects the mobile station’s level of functionality. When the application wants to stop the product with a power off, or if the application wants to force the product to execute an IMSI DETACH procedure, then it must send: AT+CFUN=0 (equivalent to AT+CPOF) This command executes an IMSI DETACH and makes a backup copy of some internal parameters in SIM and in EEPROM. The SIM card cannot then be accessed. If the mobile equipment is not powered off by the application after this command has been sent, a re-start command (AT+CFUN=1) will have to issued to restart the whole GSM registration process. If the mobile equipment is turned off after this command, then a power on will automatically restart the whole GSM process. The AT+CFUN=1 command restarts the entire GSM stack and GSM functionality: a complete software reset is performed. All parameters are reset to their previous values if AT&W was not used. If you write entries in the phonebook (+CPBW) and then reset the product directly (AT+CFUN=1, with no previous AT+CFUN=0 command), some entries may not be written (the SIM task does not have enough time to write entries in the SIM card). In addition, the OK response will be sent at the last baud rate defined by the +IPR command. With the autobauding mode the response can be at a different baud rate, it is therefore preferable to save the defined baud rate with AT&W before directly sending the AT+CFUN=1 command. 4.12.2 Syntax : Command syntax : AT+CFUN= Command Possible responses AT+CFUN? Note : Ask for current functionality level +CFUN: 1 OK AT+CFUN=0 OK Note : Full functionality Note : Set minimum functionality, IMSI Note : Command valid detach procedure AT+CFUN=1 OK Note : Set the full functionality mode with a Note : Command valid complete software reset Page : 23 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.12.3 Defined values : 0 : Set minimum functionality, IMSI detach procedure 1 : Set the full functionality mode with a complete software reset 4.13 Phone activity status +CPAS 4.13.1 Description : This command returns the activity status of the mobile equipment. 4.13.2 Syntax : Command syntax : AT+CPAS Command AT+CPAS Note : Current activity status 4.13.3 Possible responses +CPAS: OK Defined values : 0 ready (allow commands from TA/TE) 1 unavailable (does not allow commands) 2 unknown 3 ringing (ringer is active) 4 call in progress 5 asleep (low functionality) Page : 24 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.14 Report Mobile Equipment errors +CMEE 4.14.1 Description : This command disables or enables the use of the “+CME ERROR : ” or “+CMS ERROR : ” result code instead of simply “ERROR”. See appendix 19.1 for +CME ERROR result codes description and appendix 19.2 for +CMS ERROR result codes. 4.14.2 Syntax : Command syntax : AT+CMEE= Command Possible responses AT+CMEE=0 Note : Disable ME error reports, use only « ERROR » AT+CMEE=1 Note : Enable «+CME ERROR: » or «+CMS ERROR: » 4.14.3 OK OK Defined values : 0 : Disable ME error reports, use only « ERROR » 1 : Enable «+CME ERROR: » or «+CMS ERROR: » Page : 25 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.15 Keypad control +CKPD 4.15.1 Description : This command emulates the ME keypad by sending each keystroke as a character in a string. The supported GSM sequences are listed in the appendix. If emulation fails, a +CME ERROR: is returned. If emulation succeeds, the result depends on the GSM sequence activated: Note: In the case where the FDN phonebook is activated, the sequences concerning “call forwarding” are allowed only if the entire sequence is written in the FDN. 4.15.2 Syntax : Command syntax : AT+CKPD= Command Possible responses AT+CKPD=”*#21#” +CCFC: 0,7 Note : Check every call forwarding status AT+CKPD=”1234” Note : Sequence not allowed 4.15.3 +CME ERROR 3 Defined values : Keyboard sequence : string of the following characters (0-9,*,#). Page : 26 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.16 Clock Management +CCLK 4.16.1 Description : This command is used to set or get the current date and time of the ME realtime clock. 4.16.2 Syntax : Command syntax : AT+CCLK= Command Possible responses AT+CCLK=”00/06/09,17:33:00” Note : set date to June 9th, 2000, and time to 5:33pm AT+CCLK=”00/13/13,12:00:00” Note : Incorrect month entered AT+CCLK? Note : Get current date and time 4.16.3 OK Note : Date/Time stored +CME ERROR 3 +CCLK: “00/06/09,17:34:23” OK Note : current date is June 9th, 2000 current time is 5:34:23 pm Defined values : String format for date/time is: “yy/MM/dd,hh:mm:ss”. Valid years are 98 (for 1998) to 97 (for 2097). The seconds field is not mandatory. Default date/time is “98/01/01,00:00:00” (January 1st, 1998 / midnight). Page : 27 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.17 Alarm Management +CALA 4.17.1 Description : This command is used to set alarms date/time in the ME. The maximum number of alarms is 16. 4.17.2 Syntax : Command syntax : AT+CALA= (set alarm) AT+CALA=””, (delete alarm) Command Possible responses AT+CALA=”00/06/09,07:30” Note : set an alarm for June 9th, 2000 at 7:30 am AT+CALA=”99/03/05,13:00:00” Note : set an alarm for March 5th, 1999 at 1:00 pm AT+CALA? Note : list all alarms AT+CALA=””,3 Note : delete alarm index 3 AT+CALA? Note : list all alarms 4.17.3 OK Note : Alarm stored +CME ERROR 3 Note : Invalid alarm (date/time expired) +CALA: “00/06/08,15:25:00”,1 +CALA: “00/06/09,07:30:00”,2 +CALA: “00/06/10,23:59:00”,3 Note : three alarms are set (index 1, 2, 3) +CALA: “00/06/08,15:25:00”,1 Note : an alarm occurs (index 1) OK Note : Alarm index 3 deleted +CALA: “00/06/09,07:30:00”,2 Note : Only one alarm (index 2) Defined values : String format for alarms : “yy/MM/dd,hh:mm:ss” (see +CCLK). Note : Seconds are not taken into account. offset in the alarm list, range 1 to 16. Page : 28 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.18 Ring Melody Playback +CRMP 4.18.1 Description This command allows a melody to be played. All melodies are manufacturer defined. For incoming voice, data or fax calls, 10 manufacturer-defined melodies can be played back (in a loop). For an incoming short message, 2 manufacturer-defined sounds can be played back (once). Melody #1: short beep / Melody #2: long beep. Note: loop melodies (for voice/data/fax call) must be stopped by a +CRMP command with the field set to 0 (example: +CRMP=0,,,0). When the parameter is given, this overwrites the value of the +CRSL command. If the parameter is not given, the value of +CRSL is used as default value. 4.18.2 Syntax : Command syntax : AT+CRMP= [, , , ] Command Possible responses AT+CRMP=0,7,0,2 Note : Play voice call melody index 2 with volume level 7. AT+CRMP=0,,,0 Note : Stop the melody. AT+CRMP=? Note : supported parameters 4.18.3 OK Note : Melody Playback. OK Note : The melody is stopped. +CRMP: (0-3),(0-15),0,(0-10) OK Defined values : 0 Incoming voice call 1 Incoming data call 2 Incoming fax call 3 Incoming 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) Page : 29 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 4.19 Ringer Sound Level +CRSL 4.19.1 Description : This command is used to set/get the sound level of the ringer on incoming calls. The set command changes the default value of the +CRMP command. 4.19.2 Syntax : Command syntax : AT+CRSL= Command Possible responses AT+CRSL=0 Note : Set volume to Min. AT+CRSL=15 Note : Set volume to Max. AT+CRSL? Note : get current ringer sound level AT+CRSL=? Note : supported parameters 4.19.3 OK Note : Current ring playing with Min. volume. OK Note : Current ring playing with Max. volume. +CRSL: 15 OK Note : Current level is 15 (max.) +CRSL: (0-15) OK Defined values : 0 Min volume 6 Default volume (default) 15 Max volume Page : 30 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5 Call Control commands 5.1 Dial command D 5.1.1 Description : The ATD command is used to set a voice, data or fax call. As per GSM 02.30, the dial command also controls supplementary services. For a data or a fax call, the application sends the following ASCII string to the product (the bearer must be previously selected with the +CBST command): ATD where is the destination phone number. For a voice call, the application sends the following ASCII string to the product: (the bearer may be selected previously, if not a default bearer is used). ATD ; where is the destination phone number. Please note that for an international number, the local international prefix does not need to be set (usually 00) but does need to be replaced by the ‘+’ character. Example: to set up a voice call to Wavecom offices from another country, the AT command is: “ATD+33146290800;” Note that some countries may have specific numbering rules for their GSM handset numbering. The response to the ATD command is one of the following: Verbose result Numeric code Description code (with ATV0 set) OK 0 if the call succeeds, for voice call only CONNECT 10,11,12,13,14, if the call succeeds, for data calls only, 15 takes the value negotiated by the product. BUSY 7 If the called party is already in communication NO ANSWER 8 If no hang up is detected after a fixed network time-out NO CARRIER 3 Call setup failed or remote user release. Use the AT+CEER command to know the failure cause Direct dialling from a phonebook (stored in the SIM card) can be performed with the following command: ATD> ; to call from the selected phonebook (by the +CPBS command) ATD> “BILL”; to call “BILL” from the selected phonebook ATD> mem (mem is “SM","LD","MC","ME","RC","MT" or "SN", see +CPBS command) allows direct dialling from a phonebook number. Does not function with "ON" mem. Page : 31 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.1.2 Syntax : Command syntax : ATD [][;] ATD>[ ] [][;] ATD>[ ] [][;] Command Possible responses AT+CPBS? Note : Which phonebook is selected ? ATD>SM6; Note : Call index 6 from AND phonebook +CPBS:”SM”,8,10 Note : ADN phonebook is selected, 8 locations are used and 10 locations are available OK Note : Call succeeds When the FDN phonebook has been locked, only numbers beginning with the digits of FDN phonebook entries can be called. For example, if “014629” is entered in the FDN phonebook all the phone numbers beginning with these 6 digits can be called. The CLIR supplementary service subscription can be overridden for this call only. “I” means “invocation” (restrict CLI presentation). “i” means “suppression” (allow CLI presentation). Control of CUG supplementary service information by “G” or “g” is allowed for this call only. The index and info values set with the +CCUG command are used. An outgoing call attempt could be refused if the AOC service is active and credit has expired (NO CARRIER). When trying to set up an outgoing call while there is an active call, the active call is first put on hold, then the call set up is carried out. As per GSM 02.30, GSM sequences may be controlled using dial commands. These sequences can contain “*”, “#”, but “;” is forbidden. If the sequence is not supported or fails, +CME ERROR: is returned. In the case where the FDN phonebook is activated, the sequences concerning call forwarding are allowed only if there are written in the FDN. See paragraph 19.11 to have the list of supported sequences. Command Possible responses ATD*#21# +CCFC: 0,7 Note : Check any call forwarding status ATD**61*+33146290800**25# Note : Register call forwarding on no reply, with no reply timer fixed at 25 s. ATD*2# Note : Bad sequence Note : No call forwarding OK Note : done +CME ERROR 3 5.1.3 Defined values : destination phone number (optional parameter) “I” means “invocation” (restrict CLI presentation). “i” means “suppression” (allow CLI presentation). Page : 32 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 phonebook (one of “SM","LD","MC","ME","RC","MT" or "SN"). A default value can be selected by +CPBS command. call number at indicated offset from the phonebook selected by the +CPBS command call number corresponding to given name from the phonebook selected by the +CPBS command 5.2 Hang-Up command H 5.2.1 Description : The ATH (or ATH0) command is used by the application to disconnect the remote user. In the case of multiple calls, all calls are released (active, on-hold and waiting calls). The specific Wavecom ATH1 command has been appended to disconnect the current outgoing call, only in dialing or alerting state (ie. ATH1 can be used only after the ATD command, and before its terminal response (OK, NO CARRIER, ...). It can be useful in the case of multiple calls. 5.2.2 Syntax : Command syntax : ATH Command Possible responses ATH OK Note : Ask for disconnection ATH1 Note : Ask for outgoing call disconnection Note : Every call, if any, are released OK Note : Outgoing call, if any, is released 5.2.3 Defined values : 0 : Ask for disconnection (default value) 1 : Ask for outgoing call disconnection Page : 33 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.3 Answer a call A 5.3.1 Description : When the product receives a call, it sets the RingInd signal and sends the ASCII “RING” or “+CRING: ” string to the application (+CRING if the cellular result code +CRC is enabled). Then it waits for the application to accept the call with the ATA command. 5.3.2 Syntax : Command syntax : ATA Command Possible responses RING Note : Incoming call ATA OK ATH OK Note : Answer to this incoming call Note : Disconnect call Note : Call accepted Note : Call disconnected 5.3.3 Defined values : No parameter 5.4 Remote disconnection This message is used by the product to inform the application that an active call has been released by the remote user. The product sends “NO CARRIER” to the application and sets the DCD signal. In addition, for AOC, the product can release the call if credit has expired (release cause 68 with +CEER command). Page : 34 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.5 Extended error report +CEER 5.5.1 Description : This command gives the cause of call release when the last call set up (originating or answering) failed. 5.5.2 Syntax : Command syntax : AT+CEER Command Possible responses ATD123456789; NO CARRIER Note : Outgoing voice call AT+CEER Note : Ask for reason of release Note : Call setup failure +CEER : Error OK Note : is the cause information element values from GSM recommendation 04.08 or specific Call accepted For the cause information element from GSM 04.08 see chapter 18.4 or 18.5. “NO CARRIER” indicates that the AT+CEER information is available for failure diagnosis. 5.5.3 Defined values : No parameter Page : 35 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.6 DTMF signals +VTD, +VTS 5.6.1 +VTD Description : The product enables the user application to send DTMF tones over the GSM network. This command is used to define tone duration (the default value is 300ms). 5.6.2 +VTD Syntax : Command syntax : AT+VTD= Command Possible responses AT+VTD=6 OK Note : To define 600 ms tone duration AT+VTD=0 Note : To set the default value AT+VTD? Note : interrogate current tone duration AT+VTD=? Note : Command valid OK +VTD : OK +VTD : (0-255) OK 5.6.3 Defined values : : tone duration *100 is the duration in ms. If n < 4, tone duration is 300 ms; if n > 255, the value is used modulo 256. Default value is 300 ms, that is = 3. Page : 36 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.6.4 +VTS Description : The product enables the user application to send DTMF tones over the GSM network. This command enables tones to be transmitted, only when there is an active call. 5.6.5 +VTS Syntax : Command syntax : AT+VTS= Command Possible responses AT+VTS=A OK AT+VTS=11 AT+VTS=4 Note : Command valid +CME ERROR: 4 Note : If the is wrong +CME ERROR: 3 Note : If there is no communication AT+VTS=1;+VTS=3;+VTS=# OK Note : send tone sequence 13# 5.6.6 Defined values : : DTMF tone to transmit is in {0-9,*,#,A,B,C,D} 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 number dialled is displayed followed by “;” for voice calls only 5.7.2 Syntax : Command syntax : ATDL Command ATDL Note : Redial last number Possible responses 0146290800; OK Note : Last call was a voice call. Command valid 5.7.3 Defined values : No parameter Page : 37 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.8 Automatic dialing with DTR AT%Dn 5.8.1 Description : This command enables and disables: automatic dialling of the phone number stored in the first location of the • ADN phonebook, automatic sending of the short message (SMS) stored in the first • location of the SIM. The number is dialled when DTR OFF switches ON. The short message is sent when DTR OFF switches ON. 5.8.2 Syntax : Command syntax : AT%D [ ;] Command Possible responses AT%D1; OK Note : Activates DTR number dialling DTR is OFF DTR switches ON Note : The number in the first location of the ADN is dialled automatically DTR switches OFF Note : The product goes on-hook AT%D2 Note : Activates DTR short message sending Note : Command has been executed OK Note : Command has been executed 5.8.3 Defined values : (0-2) to enable or disable automatic message transmission or number dialling. Informs the product that the number is a voice rather than a fax or data number. AT%D0 Disables automatic DTR number dialling / message transmission. AT%D1; Enables automatic DTR dialling if DTR switches from OFF to ON; Dials the phone number in the first location of the ADN phonebook. Voice call. AT%D1 Activates automatic DTR dialling if DTR switches from OFF to ON; Dials the phone number in the first location of the ADN phonebook. Data or Fax call. AT%D2 Activates automatic DTR message transmission if DTR switches from OFF to ON. Page : 38 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.9 Automatic answer ATS0 5.9.1 Description : This S0 parameter determines and controls the product automatic answering mode. 5.9.2 Syntax : Command syntax : ATS0= Command Possible responses ATS0=2 OK Note : Automatic answer after 2 rings ATS0? Note : Current value 002 OK Note : always 3 characters padded with zeros ATS0=0 OK Note : No automatic answer Note : Command valid All others S-parameters (S6,S7,S8 …) are not implemented. 5.9.3 Defined values : number of rings before automatic answer (3 characters padded with zeros). Range of values is 0 to 255. Page : 39 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.10 Incoming Call Bearer +CICB 5.10.1 Description : This specific command is used to set the type of incoming calls when no incoming bearer is given (see +CSNS). Note: setting the +CICB command affects the current value of +CSNS. 5.10.2 Syntax : Command syntax : AT+CICB= Command Possible responses AT+CICB=1 OK Note : If no incoming bearer, force a fax call AT+CICB=2 Note : If no incoming bearer, force a voice call AT+CICB? Note : Interrogate value AT+CICB=? Note : Test command 5.10.3 Note : Command accepted OK Note : Command accepted +CICB: 2 OK Note : Default incoming bearer: voice call +CICB: (0-2) OK Note : Speech, data or fax default incoming bearer Defined values : 0 : Data 1 : Fax 2 : Speech Page : 40 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.11 Single Numbering Scheme +CSNS 5.11.1 Description : This command selects the bearer to be used when an MT single numbering scheme call is set up (see +CICB). Note: setting the +CSNS command affects the current value of +CICB. 5.11.2 Syntax : Command syntax : AT+CSNS Command Possible responses AT+CSNS=2 OK Note : force a fax call AT+CSNS=0 Note : force a voice call AT+CSNS? Note : Interrogate value AT+CSNS=? Note : Test command 5.11.3 Note : Command accepted OK Note : Command accepted +CSNS: 0 OK Note : Default incoming bearer: voice call +CSNS: (0,2,4) OK Note : Voice, data or fax default incoming bearer Defined values : 0 : Voice 2 : Fax 4 : Data Page : 41 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.12 Gain control +VGR, +VGT 5.12.1 Description : This command is used by the application to tune the receive gain of the speaker and the transmit gain of the microphone. 5.12.2 Syntax : Command syntax : AT+VGR= AT+VGT= Command Possible responses AT+VGR=25 OK AT+VGT=45 AT+VGR? Note : Interrogate value AT+VGR=? Note : Test command AT+VGT? Note : Interrogate value AT+VGT=? Note : Test command Note : Command valid OK Note : Command valid +VGR: 64 OK Note : Default receive gain +VGR : (0-255) OK Note : Possible values +VGT: 64 OK Note : Default transmit gain +VGT : (0-255) OK Note : Possible values Note : For the AT+VGT ? command with controller 1 set, the value is the lower value of range, where as with controller 2, value correspond to the entered value with AT+VGT=xx. Page : 42 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.12.3 Defined values : : reception gain : transmission gain The application sends: AT+VGR= for receive AT+VGT= gain for transmit AT+VGT= gain for transmit gain Controller 1 Controller 1 Controller 2 Controller 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 (**) +10.5 db 128 to 143 -10 db 22 (**) +11 db 144 to 159 -12 db 23 (**) +11.5 db 160 to 175 -14 db … 176 to 191 -16 db 58 (**) +29 db 192 to 207 -18 db 59 (**) +29.5 db 208 to 223 -20 db 60 (**) +30 db 224 to 255 (*) -22 db 61 +30,5 db 62 +31 db … … 101 +50,5 db 102 +51 db 103 to 127 reserved 128 to 242 reserved 243 -6,5 db 244 -6 db 245 -5,5 db 246 -5 db … … 255 -0,5 db (*) For Wismo Quik Q22xx : 224 to 239 : -22db / 240 to 255 : -24db (**) For Wismo Quik Q22xx : 21 to 60 : +30db The gain values listed here are relative, for absolute (electrical) values please refer to the specific hardware documentation of the module used in the application. Page : 43 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.13 Microphone Mute Control +CMUT 5.13.1 Description : This command is used to mute the microphone input on the product (for the active microphone set with the +SPEAKER command). This command is only allowed during a call. 5.13.2 Syntax : Command syntax : AT+CMUT= Command AT+CMUT=? Note : Test command AT+CMUT? Note : Ask for current value Possible responses +CMUT : (0,1) OK Note : Enable / disable mute +CMUT : 0 OK Note : Current value is OFF AT+CMUT=1 OK AT+CMUT? +CMUT : 1 OK Note : Mute ON (call active) Note : Ask for current value AT+CMUT=0 Note : Mute OFF (call not active) 5.13.3 Note : Command valid Note : Mute is active (call active) +CME ERROR:3 Note : Command not valid Defined values : 0 : microphone mute off (default value). 1 : microphone mute on. Page : 44 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.14 Speaker & Microphone selection +SPEAKER 5.14.1 Description This specific command is used to select the speaker and the microphone set. 5.14.2 Syntax : Command syntax : AT+SPEAKER= Command Possible responses AT+SPEAKER=0 OK Note : Speaker ONE and Micro ONE AT+SPEAKER? AT+SPEAKER=? 5.14.3 Note : Command valid +SPEAKER: 0 OK Note : Speaker ONE and Micro ONE are active +SPEAKER: (0,1) OK Defined values : 0 : SPEAKER ONE, MICRO ONE 1 : SPEAKER TWO, MICRO TWO Page : 45 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.15 Echo Cancellation +ECHO 5.15.1 Description : This specific command is used to enable, disable or configure the Echo Cancellation functions for voice calls (in rooms, in cars, etc.). It is necessary to tune the Microphone gain (AT+VGT) and the Speaker gain (AT+VGR) before activating the Echo Cancellation. 5.15.2 Syntax : Command syntax : AT+ECHO= [, , , , , , , ] Command Possible responses AT+CMEE=1 Note: Enables the use of result code AT+SPEAKER? AT+SIDET=0 Note: Deactivate the Sidetone AT+SIDET? AT+ECHO? Note : Read current settings AT+ECHO=1,1,0,3,10,7 Note : Active Echo cancellation 1 for Mic/Spk one. AT+ECHO? Note : Read current settings AT+ECHO=1,3,30,8000,256 Note : Activate the Echo cancellation 3 AT+ECHO? Note : Read the Echo cancellation settings AT+CFUN=1 Note: Reset the product AT+ECHO? Note : Read current settings AT+ECHO=0 Note: Deactivate the Echo Cancellation OK + SPEAKER: 0 OK Note : Speaker ONE and Micro ONE are active OK +SIDET: 0,0 +ECHO: 0,1,0,3,10,7 OK OK +ECHO: 1,1,0,3,10,7 OK +CME ERROR: 519 Note : The new algorithm will be activated after a reset of the product +ECHO: 3,3,30,8000,256 OK OK +ECHO: 1,3,30,8000,256 OK OK Page : 46 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.15.3 Defined values: 0 : Deactivate Echo 1 : Activate Echo When mode = 1 is choosen, AlgoId is mandatory. 1 : Echo cancellation 1 3 : Echo cancellation 3 To use Echo cancellation 3, the ECHO feature must be activated. Echo cancellation 1 (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 db 1: 2 db 2: 3 db 3: 4 db (default) • The parameter specifies the relative threshold between max and min energy information. The allowed range is [ 0 ; 31 ]. (10 by default) The parameter specifies threshold of max energy information. The allowed range is [ 0 ; 31 ]. (7 by default) • Page : 47 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 Echo Cancellation 3 (3 parameters) : • high value leads to high echo attenuation but the fullduplex quality will be less efficient. The allowed range is [ 0 ; 63 ]. (30 by default) • indicates the noise threshold. Low value leads to high noise attenuation. The threshold 32767 indicates no noise attenuation. The allowed range is [0 ;32767]. (8000 default) • indicates the Number of Taps of the Adaptive Filter. The allowed range is [64 ;256]. (256 by default)-64 taps is for short Echo256 taps is for long Echo. Read Command: AT+ECHO? This command returns the current settings of the Echo cancellation. Returns: +ECHO: , , , , , , , The number of parameters displayed depends on the algorythm used. For Echo cancellation 1, 4 parameters are displayed, 3 parameters are displayed for Echo cancellation 3. 0 Echo Deactivated. 1 Echo Activated for Mic/Spk one. 2 Echo Activated for Mic/Spk two. 3 Reset the product. Note: You can activate/deactivate the echo cancellation during a call without resetting the product if the parameter is not changed. But you have to use the syntax with all parameters : AT+ECHO=1,3,30,8000,256 for instance. Page : 48 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.16 SideTone modification +SIDET 5.16.1 Description : This specific command is used to set the level of audio feedback in the speaker (microphone feedback in the speaker). 5.16.2 Syntax : Command syntax : AT+SIDET= [, ] Command Possible responses AT+SIDET=1,0 OK AT+SIDET? +SIDET: 1,0 OK Note : Current value AT+SIDET=? 5.16.3 Note : Command valid Note : Command valid +SIDET: (0-1),(0-3) OK Defined values : 0: SideTone is disabled 1: SideTone is enabled ( default value 0 will be used if this parameter is not given) 0: 0 db 1: - 6 db 2: - 12 db 3: - 18 db Page : 49 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 5.17 Initialize Voice Parameters +VIP 5.17.1 Description : This command allows factory settings for voice parameters to be restored from EEPROM. These voice parameters include: Gain control (+VGR & +VGT commands), • Gain controller (+WSVG command), • • Microphone mute control (+CMUT command), • Speaker & Microphone selection (+SPEAKER command), Echo cancellation (+ECHO command), • Side tone modification (+SIDET command). • 5.17.2 Syntax : Command syntax : AT+VIP= .Command Possible responses AT+VIP? +VIP: 1 OK AT+VIP=2 +CME ERROR: 3 Note : Syntax error AT+VIP=1 Note : Restore the factory settings from EEPROM AT+VIP=1 Note : Restore the factory settings from EEPROM with the current Echo cancellation algo (different of the default algo). AT+VIP=? Note : List of supported s 5.17.3 OK Note : The command has been executed CME ERROR: 519 Note : Reset the product to accept the new algo. +VIP: (1) OK Defined values : 1 : Restore all voice parameters Other values are not supported. Page : 50 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 6 Network service commands 6.1 Signal Quality +CSQ 6.1.1 Description : This command is used to ascertain the received signal strength indication ( ) and the channel bit error rate ( ) with or without a SIM card inserted. 6.1.2 Syntax : Command syntax : AT+CSQ Command AT+CSQ Possible responses +CSQ: , OK Note : and as defined below 6.1.3 Defined values : : 0: -113 dBm or less 1: -111 dBm 2 to 30: -109 to –53 dBm 31: -51dBm or greater 99: not known or not detectable : 0…7: as RXQUAL values in the table GSM 05.08 99: not known or not detectable Page : 51 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 6.2 Operator selection +COPS 6.2.1 Description : There are three possible ways of selecting an operator (PLMN): 1) The product is in manual mode. It then tries to find the operator specified by the application and if found, tries to register. 2) The product is in automatic mode. It then tries to find the home operator and if found, tries to register. If not found, the product automatically searches for another network. 3) The product enters into manual/automatic mode, and then tries to find an operator as specified by the application (as in manual mode). If this attempt fails it enters automatic mode. If this is successful, the operator specified by the application is selected. The mobile equipment then enters into automatic mode. Note: The read command returns the current mode and the currently selected operator. In manual mode, this PLMN may not be the one set by the application (as it is in the search phase). These commands are not allowed during one communication. 6.2.2 Syntax : To force an attempt to select and register on a network, the application must send the following command: Command syntax: AT+COPS= , [ [ , ] ] Possible responses for AT+COPS= : OK (Network is selected with full service) +CME ERROR: 30 (No network service), +CME ERROR: 32 (Network not allowed – emergency calls only) +CME ERROR: 3 (not allowed during one Communication) +CME ERROR: 4 (Incorrect parameters) +CME ERROR: 527 (Please wait, and retry your selection later) +CME ERROR: 528 (Location update failure – emergency calls only) +CME ERROR: 529 (Selection failure – emergency calls only) Response syntax for AT+COPS?: +COPS: [, , ] Response syntax for AT+COPS=?: +COPS: [list of supported ( , long alphanumeric , short alphanumeric s, numeric ) s] If an incoming call occurs during a PLMN list request, the operation is aborted (+CME ERROR: 520) and the unsolicited RING appears Page : 52 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 Command Possible responses AT+COPS? +COPS: 0,2,20801 OK Note : Ask for current PLMN Note : Home PLMN is France Telecom Orange 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,23433 +CME ERROR: 529 Note : Ask for registration on UK Orange Note : Selection failed – emergency calls network only AT+COPS=0 OK Note : Ask for registration on home network Note : Succeeded AT+COPS=3,0 OK Note : Set to long alphanumeric AT+COPS? +COPS: 0,0,”Orange F” OK Note : Ask for current PLMN Note : Home PLMN is France Telecom Orange AT+COPS=2 OK Note : Ask for deregistration from network Note : Succeeded AT+COPS? +COPS: 2 Note : Ask for current PLMN Note : ME is unregistered until =0 or 1 is selected 6.2.3 Defined values : The parameters values are the following ones: 0: automatic (default value) 1: manual 2: deregistration ; ME will be unregistered until =0 or 1 is selected. 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 alphanumeric format 1: short alphanumeric format 2: numeric (default value) Page : 53 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 : status of 0: unknown 1: available 2: current 3: forbidden : operator identifier (MCC/MNC in numeric format only for operator selection) The long alphanumeric format can be up to 16 characters long (see appendix 19.12 for operator names description, field is “Name”) The short alphanumeric format can be up to 8 characters long. 6.3 Network registration +CREG 6.3.1 Description This command is used by the application to ascertain the registration status of the product. 6.3.2 Syntax : Command syntax : AT+CREG= Response syntax : +CREG : , [ , , ] for AT+CREG? Command only Command Possible responses AT+CREG? +CREG: , OK AT+CREG=0 OK Note : As defined here-above Note : Disable network registration unsolicited result code AT+CREG=1 Note : Enable network registration unsolicited result code AT+CREG=2 Note : Enable network registration and location information unsolicited result code AT+CREG=? Note : Command valid OK Note : Command valid OK Note : Command valid +CREG: (0-2) Note : 0,1,2 values are supported Page : 54 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 6.3.3 Defined values : 0: Disable network registration unsolicited result code (default) 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 network cell. 0: not registered, ME is not currently searching for a new operator. 1: registered, home network. 2: not registered, ME currently searching for a new operator to register to. 3: registration denied. 4: unknown. 5: registered, roaming. : 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. 6.4 Read operator name +WOPN 6.4.1 Description : This specific command returns the operator name in alphanumeric format, the numeric format being given. With E-ONS feature, lac is an optional parameter to read names from OPL/PNN sim files. If it is not entered, name will be given with current lac. Note that in limited service, current lac is set to 0. 6.4.2 Syntax : Command syntax: Response syntax: Command AT+WOPN= , [ , ] +WOPN: , Possible responses AT+WOPN=? Note : Test command AT+WOPN=0,20801 Note : Give an operator in numeric format OK +WOPN : 0,”Orange F” OK Note : Alphanumeric answer AT+WOPN=0,99999 +CME ERROR: 22 AT+WOPN=0,20801,36 +WOPN : 0,”Orange F” OK Note : Give a wrong operator Note : Give an operator in numeric format for lac 36 Note : Not found Note : Alphanumeric answer Page : 55 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 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 appendix 19.12 for operator names description) is the two bytes Location Area Code to be used to get the PLMN name. If it is not entered, Current lac will be used (0 if limited service). 6.5 Selection of Preferred PLMN list +CPLS 6.5.1 Description : This command is used to select one PLMN selector with access technology list in the SIM card that is used by AT+CPOL command. 6.5.2 Syntax : Command syntax: AT+CPLS= Command Possible responses AT+CPLS? +CPLS: 1 OK Note : EF_OPLMNwAct is selected Note : Ask for selection of the SIM file AT+CPLS=0 Note : if EF_PLMNwAct is not present, EF_PLMNsel will be selected Note : selection of EF_PLMNwAct AT+CPLS=1 Note : selection of EF_OPLMNwAct AT+CPLS=? +CME ERROR: 3 Note : EF_OPLMNwAct is not present +CPLS: (0,1,2) OK Note : Get possible values AT+CPLS=? Note : The 3 files with Acces technology are present and can be selected +CPLS: (0) OK Note : Only EF_PLMNwAct or Note : Get possible values EF_PLMNsel can be selected Page : 56 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 6.5.3 Defined values :
: 0: User controlled PLMN selector with access technology EF_PLMNwAct Note: if this file is not found EF_PLMNSel will be selected 1: Operator controlled PLMN selector with access technology EF_OPLMNwAct 2: Home PLMN selector with access technology EF_HPLMNwAct 6.6 Preferred operator list +CPOL 6.6.1 Description : This command is used to edit (or update) the SIM preferred list of networks. This list is read in the SIM file selected by the command AT+CPLS. 6.6.2 Syntax : Command syntax : AT+CPOL= [
] [, [, [, , , ]]] The different possibilities are: AT+CPOL = to delete an entry. • AT+CPOL = , 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 . • AT+CPOL = , , , , , to write in the at the precising the acces technology (in the case of EF_PLMNwact, EF_HPLMNwact or EF_OPLMNwact is present). Note: per default if Acces technology parameters are not given, the GSM access technology will be choosen. The supported format are those of the +COPS command. The length of this list is limited to 85 entries for EF_PLMNsel, and 51 for EF_PLMNwAct, EF_OPLMNwAct, EF_HPLMNwAct. Page : 57 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 Command Possible responses AT+CPOL? +CPOL:1,2,26201 +CPOL: 6,2,20810 OK Note : Ask for preferred list of networks With only EF_PLMNsel present AT+CPOL? Note : Ask for preferred list of networks With EF_PLMNwAct selected and present AT+CPOL=,0 Note : Select long alphanumeric format AT+CPOL? Note : Ask for preferred list of networks With only EF_PLMNsel present AT+CPOL=7,2,20801 Note : Add a network to the list AT+CPOL? Note : Preferred list of networks in numeric format (read in EF_PLMNsel) +CPOL:1,2,26201,1,0,0 +CPOL: 6,2,20810,1,0,0 OK Note : Preferred list of networks in numeric format (read in EF_PLMNwAct) GSM acces technology selected GSM compact acces technology not selected Utran acces technology not selected OK +CPOL: 1,0,”D1-TELEKOM” +CPOL: 6,0,”F SFR” OK Note : Preferred list of networks in long alphanumeric format OK +CPOL: 1,0,”D1-TELEKOM” +CPOL: 6,0,”F SFR” +CPOL: 7,0,”Orange F” OK Note : Ask for preferred list of networks With only EF_PLMNsel present AT+CPOL=7 Note : Delete 7th location AT+CPOL? Note : Preferred list of networks in long alphanumeric format OK Note : Ask for preferred list of networks With only EF_PLMNsel present AT+CPOL=8,2,77777 Note : Add a new network to the list With only EF_PLMNsel present AT+CPOL=8,2,77777,0,0,1 Note : Add a new network to the list With EF_PLMNwact present AT+CPOL=8,2,77777 Note : Add a new network to the list With EF_PLMNwact present AT+CPOL? Note : Preferred list of networks in long alphanumeric format OK Note : Ask for preferred list of networks With only EF_PLMNsel present +CPOL: 1,0,”D1-TELEKOM” +CPOL: 6,0,”F SFR” OK OK Note: Acces technology UTRAN is selected OK Note: Per default Acces technology GSM is selected +CPOL: 1,0,”D1-TELEKOM” +CPOL: 6,0,”F SFR” +CPOL: 8,2,77777” OK Note : Preferred list of networks in long alphanumeric format but 8th entry is unknown so the product edits it in the numeric format Page : 58 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 Command Possible responses AT+CPOL=9,0,”Orange F” Note : Add a new network to the list (text format) AT+CPOL? Note : Ask for preferred list of networks With only EF_PLMNsel present AT+CPOL=? +CPOL: +CPOL: +CPOL: +CPOL: OK 1,0,”D1-TELEKOM” 6,0,”F SFR” 8,2,77777” 9,0,”Orange F” Note : Preferred list of networks in long alphanumeric format +CPOL: (1-16),(0-2) OK Note : The EF can accept 16 records, and supported format are 0,1 or 2. 6.6.3 Defined values : : position of the operator record in the sim preferred operator list. Do AT+CPOL=? to get the maximum index of the selected EF. : 0 long alphanumeric format for 1 short alphanumeric format for 2 numeric format for : characterstring or integer (see ) indicating operator identifier. : GSM access technology : GSM compact access technology : UTRA access technology 0 access technology not selected 1 access technology selected Page : 59 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 6.7 Read operator name +COPN 6.7.1 Description : This command return the list of all operator names (in numeric and alphanumeric format) stored in the module. 6.7.2 Syntax : Command syntax : Command response : Command AT+COPN +COPN: , Possible responses AT+COPN Note : Ask for preferred list of networks AT+COPN=? +COPN: +COPN: +COPN: +COPN: … OK 23201,"A1" 23203,"A max." 23207,"A tele.ring" 23205,"one" +CME ERROR: OK 6.7.3 Defined values : is the operator in numeric format. is the operator in long alphanumeric format (see appendix 19.12 for operator names description) Page : 60 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 7 Security commands 7.1 Enter PIN +CPIN 7.1.1 Description : This command is used to enter the ME passwords (CHV1 / CHV2 / PUK1 / PUK2, etc.), that are required before any ME functionality can be used. CHV1/CHV2 is between 4 and 8 digits long, PUK1/PUK2 is only 8 digits long. If the user application tries to make an outgoing call before the SIM PIN code (CHV1) has been confirmed, then the product will refuse the “ATD” command with a “+CME ERROR: 11” (SIM PIN required). The application is responsible for checking the PIN after each reset or power on - if the PIN was enabled. 7.1.2 Syntax : Command syntax: AT+CPIN= Command Possible responses AT+CPIN=1234 OK Note : Enter PIN AT+CPIN=5678 Note : Enter PIN Note : PIN code is correct +CME ERROR : 3 Note : Operation not allowed, PIN previously entered After 3 unsuccessful attempts to enter the PIN (Personal Identification Number), the PUK (Personal Unblocking Key) will be required. PUK validation forces the user to enter a new PIN code as a second parameter and this will be the new PIN code if PUK validation succeeds. CHV1 is then enabled if PUK1 is correct. The application therefore uses this command: AT+CPIN= , Command Possible responses AT+CPIN=00000000,1234 Note : Enter PUK and new PIN AT+CPIN=12345678,1234 Note : Enter PUK and new PIN, 2nd attempt +CME ERROR: 16 Note : Incorrect PUK OK Note : PUK correct, new PIN stored Page : 61 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 To ascertain which code must be entered (or not), the following query command can be used: AT+CPIN? The possible responses are : ME is not pending for any password +CPIN: READY +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 equipment does not end its response with the OK string. The response +CME ERROR : 13 (SIM failure) is returned after 10 unsuccessful PUK attempts. The SIM card is then out of order and must be replaced by a new one. Example: 3 failed PIN validations + 1 successful PUK validation AT+CPIN? Read the PIN status +CPIN: SIM PIN The product requires SIM PIN AT+CPIN=1235 +CME ERROR: 16 First attempt to enter a SIM PIN Wrong PIN AT+CPIN=1236 +CME ERROR: 16 Second attempt Wrong PIN AT+CPIN=1237 +CME ERROR: 16 Third attempt Wrong PIN AT+CPIN? +CPIN: SIM PUK Read PIN state The product requires PUK AT+CPIN=99999999,5678 OK The PUK is entered, the new PIN shall be 5678 PUK validation is OK. New Pin is 5678 Read PIN state The product is ready AT+CPIN? +CPIN: READY If the user tries to do something which requires PIN2 (CHV2), the product will refuse the action with a “+CME ERROR: 17” (SIM PIN2 required). The product then waits for SIM PIN2 to be given. Of course, if SIM PIN2 is blocked, SIM PUK2 is required instead of SIM PIN2. For example, the product needs PIN2 to write in the fixed dialling phonebook (FDN) , so if SIM PIN2 authentication has not been performed during the current session, SIM PIN2 is required Page : 62 / 335 confidential © This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable. WM_ASW_OAT_UGD_004- 011 20 June 2003 Command Possible responses AT+CPBS=”FD” OK Note : Choose FDN AT+CPBW=5,”01290917”,129,”Jacky” Note : Write in FDN at location 5 AT+CPIN? SIM PIN2 AT+CPIN=5678 OK AT+CPBW=2,”01290917”,129,”Jacky” OK Note : Enter SIM PIN2 Note : Write in FDN at location 5 +CME ERROR: 17 Note : SIM PIN2 is required Note : SIM PIN2 is required Note : Now writing in FDN is allowed Please note that the product only requests PIN2 or PUK2 once. Therefore, if they are not entered properly, the next +CPIN? command will return “+CPIN: READY”. 7.1.3 Defined values : Personal Identification Number. Personal Unblocking Key needed to change the PIN. See above conditions of use. 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, the +CPIN command allows PIN2 or PUK2 codes to be validated, but only when the last command executed resulted in PIN2 authentication failure. PIN2 length is between 4 and 8 digits, PUK2 length is 8 digits only. 7.2.2 Syntax : Command syntax : AT+CPIN2= Command Possible responses AT+CPIN2=1234 OK Note : Enter PIN2 AT+CPIN2=5678 Note : Enter PIN2 Note : PIN2 code is correct +CME ERROR: 3 Note : Operation not allowed, PIN2 previously entered After 3 unsuccessful attempts, PUK2 will then be required. PUK2 validation forces the user to enter a new PIN2 code as a second parameter and this will be the new PIN2 code if PUK1 validation succeeds. The application therefore uses this command: AT+CPIN2=