AT Commands For GSM/GPRS Wireless Modems Reference Guide AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 2 AT Commands for GSM/GPRS Wireless Modems Reference Guide Products: MTCBA-G-F1/F2, MTMMC-G-F1/F2, and MTSMC-G-F1/F2 PN S000293C, Revision C Copyright This publication may not be reproduced, in whole or in part, without prior expressed written permission from Multi-Tech Systems, Inc. All rights reserved. Copyright © 2003, by Multi-Tech Systems, Inc. Multi-Tech Systems, Inc. makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. Furthermore, Multi-Tech Systems, Inc. reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of Multi-Tech Systems, Inc. to notify any person or organization of such revisions or changes. Revisions Revision Level Date Description A 07/15/03 Initial release. B 03/08/04 Add Values to each command. Add new commands. C 09/28/04 Change page 19 data/fax call to ATD<nb>; and voice call to ATD<nb> Change page 93 Autobauding is supported (operating from 2400 to 115200) Trademarks The Multi-Tech logo is a trademark of Multi-Tech Systems, Inc. World Headquarters Multi-Tech Systems, Inc. 2205 Woodale Drive Mounds View, Minnesota 55112 Phone: 763-785-3500 or 800-328-9717 Fax: 763-785-9874 Technical Support Country By Email By Phone France: support@multitech.fr (33) 1-64 61 09 81 India: support@multitechindia.com 91 (124) 6340778 U.K.: support@multitech.co.uk (44) 118 959 7774 U.S. and Canada: support@multitech.com (800) 972-2439 Rest of the World: support@multitech.com (763) 717-5863 Internet Address: http://www.multitech.com Table of Contents for AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 3 Contents Chapter 1 - Introduction 10 Scope of This Document 10 Related Documents 10 Definitions 10 Chapter 2 - AT command Features 11 Line Settings 11 Command Line 11 Information Responses and Result Codes 11 Chapter 3 - General be haviors 12 SIM Card Insertion and Removal Procedures 12 Background Initialization 12 Chapter 4 - General AT Commands 13 Manufacturer Identification +CGMI 13 Request Model Identification +CGMM 13 Request Revision Identification +CGMR 13 Product Serial Number +CGSN 14 Select TE Character Set +CSCS 14 Phonebook Character Set +WPCS 14 Request IMSI +CIMI 15 Card Identification +CCID 15 Capabilities List +GCAP 15 Repeat Last Command A/ 15 Power Off +CPOF 15 Set Phone Functionality +CFUN 16 Phone Activity Status +CPAS 16 Report Mobile Equipment Errors +CMEE 17 Keypad Control +CKPD 17 Clock Management +CCLK 17 Alarm Management +CALA 18 Chapter 5 – AT Call Control commands 19 Dial Command D 19 Hang-Up command H 20 Answer a Call A 21 Remote Disconnection 21 Extended Error Report +CEER 21 DTMF Signals +VTD, +VTS 22 Redial Last Telephone Number DL 22 Automatic Dialing with DTR %D 23 Automatic Answer S0 23 Incoming Call Bearer +CICB 24 Single Numbering Scheme +CSNS 24 Gain Control +VGR, +VGT 25 Microphone Mute Control +CMUT 26 Speaker & Microphone Selection +SPEAKER 26 Table of Contents for AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 4 Echo Cancellation +ECHO 27 SideTone Modification +SIDET 29 Initialize Voice Parameters +VIP 29 Chapter 6 - Network service commands 30 Signal Quality +CSQ 30 Operator Selection +COPS 31 Network Registration +CREG 33 Read Operator Name +WOPN 34 Selection of Preferred PLMN List +CPLS 34 Preferred Operator List +CPOL 35 Read Operator Name +COPN 37 Chapter 7 - Security commands 38 Enter PIN +CPIN 38 Enter PIN2 +CPIN2 40 PIN Remaining Attempt Number +CPINC 40 Facility Lock +CLCK 41 Change Password +CPWD 42 Chapter 8 - Phonebook commands 43 Select Phonebook Memory Storage +CPBS 43 Read Phonebook Entries +CPBR 44 Find Phonebook Entries +CPBF 44 Write Phonebook Entry +CPBW 45 Phonebook Phone Search +CPBP 46 Move Action in Phonebook +CPBN 46 Subscriber Number +CNUM 47 Avoid Phonebook Initialization +WAIP 48 Delete Calls Phonebook +WDCP 48 Set Voice Mail Number +CSVM 49 Chapter 9 - Short Messages Commands 50 Parameters Definition 50 Select Message Service +CSMS 51 New Message Acknowledgement +CNMA 51 Preferred Message Storage +CPMS 53 Preferred Message Format +CMGF 54 Save Settings +CSAS 54 Restore Settings +CRES 55 Show Text Mode Parameters +CSDH 55 New Message Indication +CNMI 56 Read Message +CMGR 57 List Message +CMGL 58 Send Message +CMGS 59 Write Message to Memory +CMGW 59 Send Message from Storage +CMSS 60 Set Text Mode Parameters +CSMP 60 Delete Message +CMGD 61 Service Center Address +CSCA 62 Table of Contents for AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 5 Select Cell Broadcast Message Types +CSCB 62 Cell Broadcast Message Identifiers +WCBM 63 Message Status Modification +WMSC 63 Message Overwriting +WMGO 64 Unchange SMS Status +WUSS 65 Chapter 10 – Supplementary Services Commands 66 Call Forwarding +CCFC 66 Call Barring +CLCK 67 Modify SS Password +CPWD 68 Call Waiting +CCWA 68 Calling Line Identification Restriction +CLIR 69 Calling Line Identification Presentation +CLIP 70 Connected Line Identification Presentation +COLP 71 Advice of Charge +CAOC 72 Accumulated Call Meter +CACM 72 Accumulated Call Meter Maximum +CAMM 73 Price Per Unit and Currency Table +CPUC 73 Call Related Supplementary Services +CHLD 74 List Current Calls +CLCC 75 Supplementary Service Notifications +CSSN 76 Unstructured Supplementary Service Data +CUSD 77 Closed User Group +CCUG 78 Chapter 11 - Data Commands 79 Using AT Commands During a Data Connection 79 Bearer Type Selection +CBST 80 Select Mode +FCLASS 81 Service Reporting Control +CR 81 Cellular Result Dodes +CRC 82 DTE-DCE Local Rate Reporting +ILRR 82 Radio Link Protocol Parameters +CRLP 83 Other Radio Link Parameters +DOPT 83 Select Data Compression %C 84 V42bis Data Compression +DS 84 V42bis Data Compression Report +DR 85 Select Data Error Correcting Mode \N 85 Chapter 12 - Fax Commands 86 Transmit speed +FTM 86 Receive Speed +FRM 86 HDLC Transmit Speed +FTH 86 HDLC Receive Speed +FRH 87 Stop Transmission and Wait +FTS 87 Receive Silence +FRS 87 Setting Up the PC Fax Application: 87 Chapter 13 - Fax Class 2 Commands 88 Transmit Data +FDT 88 Receive Data +FDR 88 Table of Contents for AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 6 Transmit Page Punctuation +FET 88 Page Transfer Status Parameters +FPTS 88 Terminate Session +FK 89 Page Transfer Bit Order +FBOR 89 Buffer Size Report +FBUF 89 Copy Quality Checking +FCQ 89 Capability to Receive +FCR 89 Current Sessions Parameters +FDIS 90 DCE Capabilities Parameters +FDCC 91 Local ID String +FLID 91 Page Transfer Timeout Parameter +FPHCTO 91 Fax Class 2 Indication Messages 92 Chapter 14 – V.24 and V.25 commands 93 Fixed DTE Rate +IPR 93 DTE-DCE Character Framing +ICF 94 DTE-DCE Local Flow Control +IFC 95 Set DCD Signal &C 95 Set DTR Signal &D 96 Set DSR Signal &S 96 Back to Online Mode O 96 Result Code Suppression Q 97 DCE Response Format V 97 Default Configuration Z 97 Save Configuration &W 97 Auto-Tests &T 98 Echo E 98 Restore Factory Settings &F 98 Display Configuration &V 99 Request Identification Information I 99 Multiplexing Mode +WMUX 100 Chapter 15 - Specific AT commands 101 Cell Environment Description +CCED 101 General Indications +WIND 103 Analog Digital Converter Measurements +ADC 104 Mobile Equipment Event Reporting +CMER 105 Indicator Control +CIND 106 Mobile Equipment Control Mode +CMEC 107 Read Language Preference +WLPR 107 Write Language Preference +WLPW 108 Read GPIO Value +WIOR 108 Write GPIO Value +WIOW 109 Input/Output Management +WIOM 109 Abort Command +WAC 110 Play Tone +WTONE 110 Play DTMF Tone +WDTMF 111 Downloading +WDWL 111 Table of Contents for AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 7 Voice Rate +WVR 112 Data Rate +WDR 112 Select Voice Gain +WSVG 113 Status Request +WSTR 113 Scan +WSCAN 114 Ring Indicator Mode +WRIM 114 32kHz Power Down Mode +W32K 115 Change Default Melody +WCDM 115 Custom Character Set +WCCS 116 Lock +WLCK 117 CPHS Command +CPHS 118 Unsolicited Result: Voice Mail Indicator +WVMI 120 Unsolicited Result: Diverted Call Indicator +WDCI 120 Network Operator Name +WNON 121 CPHS Information +WCPI 121 Customer Service Profile +WCSP 122 Customer Storage Mirror +WMIR 122 Change Default Player +WCDP 122 CPHS Mail Box Number +WMBN 123 Alternate Line Service +WALS 124 Open AT Control Command +WOPEN 124 Reset +WRST 125 Set Standard Tone +WSST 126 Hang-up +WATH 127 Chapter 16 - SIM ToolKit 128 Overview of SIM Application ToolKit 128 Messages Exchanged During a SIM ToolKit Operation 130 SIM Toolkit Commands Section 131 SIM ToolKit Set Facilities +STSF 131 SIM ToolKit Indication +STIN 133 SIM ToolKit Get Information +STGI 134 Unsolicited Result: SIM ToolKit Control Response +STCR 137 SIM ToolKit Give Response +STGR 137 Chapter 17 - GPRS commands 140 Define PDP Context +CGDCONT 140 Quality of Service Profile Requested +CGQREQ 142 Quality of Service Profile Minimum Acceptable +CGQMIN 144 GPRS Attach or Detach +CGATT 145 PDP Context Activate or Deactivate +CGACT 146 Enter Data State +CGDATA 147 GPRS Mobile Station Class +CGCLASS 148 Select Service for MO SMS Messages +CGSMS 149 GPRS Event Reporting +CGEREP 150 GPRS Network Registration Status +CGREG 151 Request GPRS IP Service D 152 Network Requested PDP Context Activation 152 Table of Contents for AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 8 Automatic Response to a Network Request for PDP Context Activation +CGAUTO 153 Manual Response to a Network Request for PDP Context Activation +CGANS 154 Show PDP Address +CGPADDR 155 Cellular Result Codes +CRC 156 Service Reporting Control +CR 156 Extended Error Report +CEER 157 GPRS Parameters Customization +WGPRS 157 Full GPRS AT Command Examples 158 GPRS-Related Errors +CME ERROR 159 Specific GPRS Failure Cause for +CEER 159 Chapter 18 - Other AT commands 160 V.25ter Recommendation 160 GSM 07.05 Recommendation 160 GSM 07.07 Recommendation 160 Appendix A – Result Codes, Failure Causes, Other Tables 161 ME Error Result Code: +CME ERROR: <error> 161 Message Service Failure Result Code +CMS ERROR: <er> 162 Specific Error Result Codes 162 Failure Cause from GSM 04.08 Recommendation (+CEER) 163 Specific Failure Cause for +CEER 164 GSM 04.11 Annex E-2: Mobile Originating SM-Transfer 164 Unsolicited Result Codes 165 Final Result Codes 165 Intermediate Result Codes 165 Parameter Storage Mode 166 GSM Sequences List 168 Operator Names 170 Appendix B - Data Commands and Multiplexing, CPHS Information Field, and CSP Constants 178 Data Commands and Multiplexing 178 CPHS Information Field 179 CSP Constants 180 Appendix C - AT Command Examples 182 Examples 182 Appendix D - ME SIM ToolKit Support 186 Appendix E - Structure of the Terminal Profile 188 Appendix F - Command Type and Next Action Indicator 190 Appendix G - Coding of Alpha fields in the SIM for UCS2 191 Appendix H - Specification of Power Down Control via RS232 192 Appendix I - Conditions for command execution and SIM dependence 193 General Commands 193 Call Control Commands 193 Network Service Commands 193 Security Commands 194 Phonebook Commands 194 Short Messages Commands 194 Supplementary Services Commands 194 Table of Contents for AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 9 Data Commands 195 Fax Commands 195 Class 2 Commands 195 V24-V25 Commands 195 Specific AT Commands 196 SIM ToolKit Commands 196 Index 197 Chapter 1 – Introduction Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 10 CHAPTER 1 - INTRODUCTION Scope of This Document This document describes the AT-command based messages exchanged between an application and the Multi-Tech Systems, Inc. products in order to manage GSM-related events or services. Related Documents This interface specification is based on the following recommendations: [1] ETSI GSM 07.05: Digital cellular telecommunications system (Phase 2); Use of DTE-DCE interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) [2] ETSI GSM 07.07: Digital cellular telecommunications system (Phase 2); AT command set for GSM Mobile Equipment (ME) [3] ITU-T Recommendation V.25 ter: Serial asynchronous automatic dialing and 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 [6] ETSI GSM 04.80: Digital cellular telecommunications system (Phase 2): Mobile radio interface layer 3, Supplementary service specification, Formats and coding Definitions The words, “Mobile Station” (MS) or “Mobile Equipment” (ME) are used for mobile terminals supporting GSM services. A call from a GSM mobile station to the PSTN is called a “mobile originated call” (MOC) or “outgoing call”, and a call from a fixed network to a GSM mobile station is called a “mobile terminated call” (MTC) or “incoming call”. In this document, the word “product” refers to any Multi-Tech product supporting the AT commands interface. [...]... 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 ... selection fails, automatic mode is entered : format of field 0: long alphanumeric format 1: short alphanumeric format 2: numeric (default value) : status of 0: unknown 1: available 2: current 3: forbidden : operator identifier (MCC/MNC in numeric format only for operator selection) The long alphanumeric format can be up to 16 characters... hexadecimal format Syntax: Command Syntax : AT+ CREG= Response syntax: +CREG: , [ ,, ] for AT+ CREG? Command only Command AT+ CREG? AT+ CREG=0 Note: Disable network registration unsolicited result code AT+ CREG=1 Note: Enable network registration unsolicited result code AT+ CREG=2 Note: Enable network registration and location information unsolicited result code AT+ CREG=? Multi-Tech... 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 Syntax: AT+ CPOL= [] [,[,[,,,]]]... 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 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... Appendix A for description) is the two byte 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) Syntax: Command syntax: AT+ WOPN=, Response syntax: +WOPN: , Command AT+ WOPN=? Note: Test command AT+ WOPN=0,20801 Note: Give an operator in numeric format AT+ WOPN=0,99999 Note: Give a wrong operator AT+ WOPN=0,2081,36... AT+ COPS=1,2,20810 Note: Ask for registration on SFR network AT+ COPS=1,1,23433 Note: Ask for registration on UK Orange network AT+ COPS=0 Note: Ask for registration on home network AT+ COPS=3,0 Note: Set to long alphanumeric AT+ COPS? Note: Ask for current PLMN AT+ COPS=2 Note: Ask for deregistration from network AT+ COPS? Note: Ask for current PLMN Possible responses +COPS: 0,2,20801 OK Note: Home PLMN is France... Wireless AT Commands - PN S000293B 32 Chapter 6 – Network Service Commands Network Registration +CREG Description: This command is used by the application to ascertain the registration status of the product Values: 0: Disable network registration unsolicited result code (default) 1: Enable network registration code result code +CREG: 2: Enable network registration and location information... 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 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... 27 Chapter 5 – AT Call Control Commands 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 . AT Commands For GSM/GPRS Wireless Modems Reference Guide AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands. Contents for AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless AT Commands - PN S000293B 7 Voice Rate +WVR 112 Data Rate +WDR 112 Select Voice Gain +WSVG 113 Status. Application: 87 Chapter 13 - Fax Class 2 Commands 88 Transmit Data +FDT 88 Receive Data +FDR 88 Table of Contents for AT Commands for GSM Wireless Modems Multi-Tech Systems, Inc. GSM Wireless