S000371B ATS18 GSM04 ATS10 918/EN 41E19058341E91 2400/RLP 4800/RLP 9600/RLP - Datasheet Archive

 

MultiModem EDGE with Bluetooth Interface (MTCBA-E-B) MultiModem EDGE with Ethernet Interface (MTCBA-E-EN) MultiModem EDGE with

 

Wireless EDGE Modems MultiModem EDGE with Bluetooth Interface (MTCBA-E-B) MultiModem EDGE with Ethernet Interface (MTCBA-E-EN) MultiModem EDGE with GPS Functionality (MTCBA-E-GP) MultiModem EDGE (MTCBA-E) MultiModem EDGE with USB (MTCBA-E-U) Embedded Wireless SocketModem EDGE (MTSMC-E) AT Commands Fax Commands IP Commands SIM Commands Audio Commands Reference Guide Copyright and Technical Support AT Commands for Multi-Tech EDGE Modems MultiModem EDGE with Bluetooth Interface (MTCBA-E-B) MultiModem EDGE with Ethernet Interface (MTCBA-E-EN) MultiModem EDGE with GPS Functionality (MTCBA-E-GP) MultiModem EDGE (MTCBA-E) MultiModem EDGE with USB (MTCBA-E-U) Embedded Wireless SocketModem EDGE (MTSMC-E) Reference Guide PN S000371B S000371B, Revision B 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 © 2005-2006, by Multi-Tech Systems, Inc. Multi-Tech Systems, Inc. makes no representations or warranties with respect to the contents hereof and specifically disclaim 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 A B Date 07/07/05 01/24/06 Description Initial release. Added trademarks and registered trademarks to the cover page. Added a product list and a command list. Removed the statement in 18.6 that the setting is stored non-volatile. Changed light blue non-hyperlinked text to black. Trademarks MultiModem, SocketModem, and the Multi-Tech logo are registered trademarks 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 France: India: U.K.: U.S. and Canada: Rest of the World: Internet Address: By Email support@multitech.fr support@multitechindia.com support@multitech.co.uk support@multitech.com support@multitech.com http://www.multitech.com By Phone (33) 1-64 61 09 81 91 (124) 6340778 (44) 118 959 7774 (800) 972-2439 (763) 717-5863 Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 2 Table of Contents Table of Contents Chapter 1. Introduction.9 1.1 Scope of the Document.9 1.2 Related Documents.9 1.3 Document Conventions .9 1.4 AT Command Syntax .10 1.4.1 Using Parameters .10 1.4.2 Combining AT Commands on the Same Command Line.10 1.5 Supported Character Sets.11 1.5.1 GSM Alphabet Tables and UCS2 Character Values .12 1.5.2 UCS2 and GSM Data Coding and Conversion for SMS Text Mode.14 1.6 Serial Interface Flow Control .16 1.6.1 Software Flow Control (XON/OFF Handshake) .16 1.6.2 Hardware Flow Control (RTS/CTS Handshake).16 1.7 Unsolicited Result Code Presentation.16 1.7.1 Communication between Customer Application and Multi-Tech Wireless Modem .17 1.8 Common PCN Handset Specification (CPHS) .18 1.9 Errors and Messages .18 Chapter 2. Configuration Commands.19 2.1 AT&F Set All Current Parameters to Manufacturer Defaults .19 2.2 AT&V Display Current Configuration.19 2.2.1 AT&V Responses.20 2.3 AT&W Stores Current Configuration .20 2.4 ATQ Set Result Code Presentation Mode.20 2.5 ATV Set Result Code Format Mode.21 2.5.1 Verbose and Numeric Result Codes .21 2.6 ATX Set CONNECT Result Code Format and Call Monitoring .22 2.7 AT\ V Set CONNECT Result Code Format .22 2.8 ATZ Set all Current Parameters to User Defined Profile .22 2.9 AT+CFUN Set Phone Functionality.23 2.9.1 Wake up the ME from SLEEP Mode .24 2.10 AT^SMSO Switch off Mobile Station .25 2.11 AT+GCAP Request Complete TA Capabilities List .25 2.12 AT+CMEE Mobile Equipment Error Message Format.25 2.12.1 CME/CMS Error Code Overview.26 2.13 AT+CSCS Select TE Character Set .29 2.14 AT^SCFG Extended Configuration Settings.29 Chapter 3. Status Control Commands .36 3.1 AT+CMER Mobile Equipment Event Reporting.36 3.2 AT+CIND Indicator control .37 3.3 AT^SIND Extended Indicator Control .39 3.4 AT+CEER Extended Error Report.43 3.4.1 Cause Location ID for the Extended Error Report.44 3.4.2 GSM Release Cause for L3 Radio Resource (RR) .44 3.4.3 GSM Release Cause for Mobility Management (MM) .45 3.4.4 GSM Release Cause for L3 Call Control (CC) .46 3.4.5 GSM Release Cause for Supplementary Service Call .47 3.4.6 GSM Cause for L3 Protocol Module or Other Local Cause.48 3.4.7 Release Cause for GPRS API .48 3.4.8 Release Cause for PPP/IP-Stack.48 3.5 ATS18 ATS18 Extended Call Release Report .49 3.6 AT+CPAS Mobile Equipment Activity Status.49 3.7 AT+WS46 Select Wireless Network .50 Chapter 4. Serial Interface Control Commands.51 4.1 AT\Q Flow Control.51 4.2 AT&C Set Circuit Data Carrier Detect (DCD) Function Mode.51 4.3 AT&D Set Circuit Data Terminal Ready (DTR) Function Mode .51 4.4 AT&S Set Circuit DSR Function Mode .52 4.5 ATE Enable Command Echo .52 4.6 AT+ICF Serial Interface Character Framing.52 4.7 AT+IFC Set Flow Control Separately for Data Directions.53 4.8 AT+ILRR Set TE-TA Local Rate Reporting .53 Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 3 Table of Contents 4.9 AT+IPR Set Fixed Local Rate .54 4.9.1 Autobauding.55 4.10 AT+CMUX Enter Multiplex Mode .56 4.10.1 Restrictions on Multiplex Mode .56 4.11 AT+STPB Transmit Parity Bit (for 7E1 & 7O1 Only).58 Chapter 5. Security Commands .59 5.1 AT+CPIN PIN Authentication .59 5.1.1 What to Do if PIN or Password Authentication Fails? .60 5.2 AT+CPIN2 PIN2 Authentication .61 5.3 AT^SPIC Display PIN Counter .62 5.4 AT+CLCK Facility Lock .65 5.5 AT^SLCK Facility Lock.68 5.6 AT+CPWD Change Password .68 5.7 AT^SPWD Change Password .70 Chapter 6. Identification Commands.71 6.1 ATI Display Product Identification Information.71 6.2 AT+CGMI Request Manufacturer Identification.71 6.3 AT+GMI Request Manufacturer Identification .71 6.4 AT+CGMM Request Model Identification .71 6.5 AT+GMM Request Model Identification.71 6.6 AT+CGMR Request Revision Identification .72 6.7 AT+GMR Request Revision Identification .72 6.8 AT+CGSN Request International Mobile Equipment Identity .72 6.9 AT+GSN Request International Mobile Equipment Identity.72 6.10 AT+CIMI Request International Mobile Subscriber Identity.73 Chapter 7. Call-Related Commands .74 7.1 Call Status Information .74 7.2 ATA Answer a Call .75 7.3 ATD Mobile Originated Call to a Specified Number .75 7.4 ATD> Mobile Originated Call Using Specific Memory and Index Number.77 7.5 ATD> Mobile Originated Call from Active Memory Using Index Number .78 7.6 ATD> Mobile Originated Call from Active Memory Using Corresponding Field.78 7.7 ATDI Mobile Originated Call to ISDN Number.79 7.8 ATDL Redial Last Number Used .79 7.9 ATH Disconnect Existing Connection.79 7.10 AT+CHUP Hang Up Call .80 7.11 AT^SHUP Hang Up Call(s) Indicating a Specific GSM04 GSM04.08 Release Cause .80 7.12 ATS0 Set Number of Rings before Automatically Answering a Call.81 7.13 ATS6 Set Pause before Blind Dialing.82 7.14 ATS7 Set Number of Seconds to Wait for Connection Completion.82 7.15 ATS8 Set Number of Seconds to Wait for Comma Dialing Modifier.82 7.16 ATS10 ATS10 Set Disconnect Delay after Indicating the Absence of Data Carrier .83 7.17 ATO Switch from Command Mode to Data Mode / PPP Online Mode .83 7.18 + Switch from Data Mode to Command Mode .83 7.19 AT+CBST Select Bearer Service Type .84 7.20 AT+CRLP Select Radio Link Protocol Parameters for Originated Non-Transparent Data Calls .84 7.21 AT+CLCC List Current Calls of ME .85 7.22 AT^SLCC List Current Calls of ME.86 7.23 AT+CR Service Reporting Control .89 7.24 AT+CRC Set Cellular Result Codes for Incoming Call Indication.90 7.25 AT+CSNS Single Numbering Scheme .90 7.26 AT^SCNI List Call Number Information .91 7.27 AT^SLCD Display Last Call Duration .91 7.28 AT^STCD Display Total Call Duration.91 7.29 ATP Select Pulse Dialing .92 7.30 ATT Select Tone Dialing .92 Chapter 8. Network Service Commands .93 8.1 AT+COPN Read Operator Names .93 8.2 AT+COPS Operator Selection .93 8.3 AT^SOPS Extended Operator Selection .95 8.4 AT+CREG Network Registration .96 8.5 AT+CSQ Signal Quality.97 8.6 AT^SMONC Cell Monitoring.98 8.7 AT^SMOND Cell Monitoring.99 8.8 AT^MONI Monitor Idle Mode and Dedicated Mode . 100 Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 4 Table of Contents 8.8.1 AT^MONI Responses .101 8.8.2 Service States .101 8.9 AT^MONP Monitor Neighbour Cells. 102 8.9.1 AT^MONP Responses .102 8.10 AT^SMONG GPRS Monitor . 103 8.10.1 AT^SMONG Cell Info Table .103 8.11 AT^SALS Alternate Line Service. 104 8.12 AT^SHOM Display Homezone . 104 8.13 AT^SPLM Read the PLMN List . 105 8.14 AT^CPOL Preferred Operator List. 105 8.15 AT^SPLR Read Entry from the Preferred Operators List . 106 8.16 AT^SPLW Write an Entry to the Preferred Operators List. 106 Chapter 9. Supplementary Service Commands.107 9.1 AT+CACM Accumulated Call Meter (ACM) Reset or Query . 107 9.2 AT^SACM Advice of Charge and Query of ACM and ACMmax.107 9.3 AT+CAMM Accumulated Call Meter Maximum (ACMmax) Set or Query. 108 9.4 AT+CAOC Advice of Charge Information. 108 9.5 AT+CCUG Closed User Group . 109 9.6 AT+CCFC Call Forwarding Number and Conditions Control . 110 9.7 AT+CCWA Call Waiting . 112 9.8 AT+CHLD Call Hold and Multiparty. 114 9.9 AT+CLIP Calling Line Identification Presentation. 116 9.10 AT+CLIR Calling Line Identification Restriction. 117 9.11 AT+COLP Connected Line Identification Presentation. 117 9.12 AT+CPUC Price Per Unit and Currency Table . 118 9.13 AT+CSSN Supplementary Service Notifications . 119 9.14 AT+CUSD Supplementary Service Notifications . 120 Chapter 10. Internet Service Commands .121 10.1 AT^SICS Internet Connection Setup Profile. 122 10.1.1 Example: Default Values of a CSD Connection Profile .124 10.1.2 Example: GPRS Connection Profile.124 10.2 AT^SISS Internet Service Setup Profile . 125 10.2.1 Example: Configuring Socket Listener .130 10.2.2 Example: Configuring Socket Client for Calling a Socket Listener on Another Host .131 10.2.3 Example: Configuring and Using FTP Download .131 10.2.4 Example: Configuring and Using FTP Upload.132 10.2.5 Example: Sending Email over GPRS .132 10.3 AT^SISO Internet Service Open. 134 10.3.1 Example: Accepting/Rejecting Socket Connection Request from Remote Client .135 10.4 AT^SISC Internet Service Close . 137 10.4.1 Effect of Parameter .137 10.5 AT^SISR Internet Service Read Data . 138 10.5.1 Example: Socket Host Reads Small Amounts of UDP Data Packets.139 10.6 AT^SISW Internet Service Write Data. 140 10.7 Information Elements Related to Internet Service URCs . 141 10.7.1 URC Information Elements Related to the Service Application.141 10.7.2 URC Information Elements Related to FTP Service.142 10.7.3 URC Information Elements Related to HTTP Service .142 10.7.4 URC Information Elements Related to POP3 Service.142 10.7.5 URC Information Elements Related to SMTP Service .142 Chapter 11. GPRS Commands .143 11.1 AT+CGACT PDP Context Activate or Deactivate. 143 11.2 AT+CGANS Manual Response to a Network Request for PDP Context Activation . 144 11.3 AT+CGATT GPRS Attach or Detach. 145 11.4 AT+CGAUTO Automatic Response to a Network Request for PDP Context Activation. 146 11.5 AT+CGDATA Enter Data State . 147 11.5.1 Automatic Deactivation of PDP Context During Dial-up PPP.147 11.6 AT+CGDCONT Define PDP Context . 148 11.7 AT+CGEQMIN 3G Quality of Service Profile (Minimum Acceptable) .149 11.8 AT+CGEQREQ 3G Quality of Service Profile (Requested). 152 11.9 AT+CGPADDR Show PDP Adress . 154 11.10 AT+CGQMIN Quality of Service Profile (Minimum Acceptable) . 155 11.11 AT+CGQREQ Quality of Service Profile (Requested). 157 11.12 AT+CGREG GPRS Network Registration Status . 159 11.13 AT+CGSMS Select Service for MO SMS Messages. 160 11.14 AT^SGACT Query All PDP Context Activations . 161 Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 5 Table of Contents 11.15 11.16 11.17 11.18 11.19 11.20 11.21 11.22 11.23 AT^SGAUTH Set Type of Authentication for PPP Connection. 162 AT^SGCONF Configuration of GPRS-Related Parameters . 162 ATA Manual Response to a Network Request for PDP Context Activation. 163 ATD*99# Request GPRS Service . 163 ATD*98# Request GPRS IP Service . 164 ATH Manual Rejection of a Network Request for PDP Context Activation. 164 ATS0 Automatic Response to a Network Request for PDP Context Activation. 165 Using GPRS AT Commands (Examples) . 166 Using the GPRS Dial Command ATD (Example). 167 Chapter 12. FAX Commands .168 12.1 FAX Parameters. 168 12.2 AT+FCLASS Fax: Select, Read or Test Service Class . 168 12.3 AT+FRH Receive Data Using HDLC Framing. 169 12.4 AT+FRM Receive Data . 169 12.5 AT+FRS Receive Silence. 169 12.6 AT+FTH Transmit Data Using HDLC Framing . 169 12.7 AT+FTM Transmit Data. 170 12.8 AT+FTS Stop Transmission and Wait . 170 Chapter 13. Short Message Service (SMS) Commands.171 13.1 SMS Parameters. 171 13.2 AT+CMGC Send an SMS Command . 174 13.3 AT+CMGD Delete SMS Message . 174 13.4 AT+CMGF Select SMS Message Format . 174 13.5 AT+CMGL List SMS Messages from Preferred Store . 175 13.6 AT+CMGR Read SMS Messages . 176 13.7 AT+CMGS Send SMS Message . 177 13.8 AT+CMGW Write Short Messages to Memory. 178 13.9 AT+CMSS Send Short Messages from Storage . 179 13.10 AT+CNMA New SMS Message Acknowledge to ME/TE Phase 2+ . 179 13.11 AT+CNMI New Short Message Indication. 180 13.12 AT+CPMS Preferred SMS Message Storage . 182 13.13 AT+CSCA SMS Service Center Address . 183 13.14 AT+CSCB Select Cell Broadcast Message Indication. 183 13.15 AT+CSDH Show SMS Text Mode Parameters . 184 13.16 AT+CSMP Set SMS Text Mode Parameters. 184 13.17 AT+CSMS Select Message Service. 185 13.18 AT^SCML List Concatenated Short Messages from Preferred Store. 186 13.19 AT^SCMR Read Concatenated Short Messages. 187 13.20 AT^SCMS Send Concatenated Short Messages . 188 13.21 AT^SCMW Write Concatenated Short Messages to Memory .188 13.22 AT^SLMS List SMS Memory Storage . 189 13.23 AT^SMGL List Short Messages from Preferred Store without Setting Status to REC READ . 189 13.24 AT^SMGO Set or Query SMS Overflow Pesentation Mode or Query SMS Overflow . 190 13.25 AT^SMGR Read Short Message without Setting Status to REC READ. 190 13.26 AT^SSCONF SMS Command Configuration . 191 13.27 AT^SSDA Set SMS Display Availability . 191 13.28 AT^SSMSS Set Short Message Storage Sequence . 192 Chapter 14. SIM-Related Commands.193 14.1 AT+CRSM Restricted SIM Access . 193 14.2 AT^SXSM Extended SIM Access. 195 14.3 AT^SCKS Query SIM and Chip Card Holder Status . 196 14.4 AT^SSET Indicate SIM Data Ready. 197 14.5 AT^SCID Display SIM Card Identification Number. 197 14.6 AT+CXXCID Display Card ID . 197 Chapter 15. SIM Application Toolkit (SAT) Commands .198 15.1 AT^SSTA SAT Interface Activation . 198 15.2 ^SSTN SAT Notification . 199 15.3 AT^SSTGI SAT Get Information. 200 15.4 AT^SSTR SAT Response . 200 Chapter 16. Phonebook Commands.201 16.1 Sort Order for Phonebooks . 201 16.2 AT+CNUM Read Own Numbers . 202 16.3 AT+CPBR Read from Phonebook. 202 16.4 AT+CPBS Select Phonebook Memory Storage . 204 Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 6 Table of Contents 16.5 AT+CPBW Write into Phonebook. 205 16.6 AT^SDLD Delete the `Last Number Redial Memory. 207 16.7 AT^SPBC Find First Matching Entry in Sorted Phonebook . 207 16.8 AT^SPBD Purge Phonebook Memory Storage . 208 16.9 AT^SPBG Display Phonebook Entries in Alphabetical Order. 209 16.10 AT^SPBS Step Through the Selected Phonebook Alphabetically. 211 Chapter 17. Audio Commands .213 17.1 Audio Programming Model. 213 17.2 ATL Set Monitor Speaker Loudness . 213 17.3 ATM Set Monitor Speaker Mode . 213 17.4 AT+CLVL Loudspeaker Volume Level . 214 17.5 AT+CMUT Mute Control. 214 17.6 AT+VTD Tone Duration. 215 17.7 AT+VTS DTMF and Tone Generation. 215 17.8 AT^SAIC Audio Interface Configuration . 216 17.9 AT^SNFA Set or Query of Microphone Attenuation . 217 17.10 AT^SNFD Set Audio Parameters to Manufacturer Default Values . 218 17.11 AT^SNFI Set Microphone Path Parameters . 218 17.12 AT^SNFM Set Microphone Audio Path . 219 17.13 AT^SNFO Set Audio Output (= Loudspeaker Path) Parameter. 220 17.14 AT^SNFPT Set Progress Tones. 221 17.15 AT^SNFS Select Audio Hardware Set . 221 17.16 AT^SNFTTY Signal TTY/CTM Audio Mode Capability. 222 17.17 AT^SNFV Set Loudspeaker Volume . 223 17.18 AT^SNFW Write Audio Setting in Non-Volatile Store . 223 17.19 AT^SRTC Ring Tone Configuration . 224 Chapter 18. Hardware-Related Commands.225 18.1 AT+CCLK Real Time Clock. 225 18.2 AT+CALA Set Alarm Time . 226 18.3 Intentionally Omitted . 228 18.4 Intentionally Omitted . 228 18.5 AT^SCTM Set Critical Operating Temperature Presentation Mode or Query Temperature . 228 18.6 AT^SSYNC Configure SYNC Pin . 230 18.6.1 ME Status Indicated by Status LED Patterns.230 Chapter 19. Miscellaneous Commands.232 19.1 A/ Repeat Previous Command Line . 232 19.2 ATS3 Set Command Line Termination Character . 232 19.3 ATS4 Set Response Formatting Character . 232 19.4 ATS5 Write Command Line Editing Character . 233 Chapter 20. Summary Tables .234 20.1 Restricted Access to SIM Data after SIM PIN Authentication. 234 20.2 Star-Hash (*#) Network Commands . 235 20.3 AT Commands and SIM PIN Dependency . 237 20.4 Availability of AT Commands Depending on Operating Mode of ME .241 20.5 AT Command Settings Storable with AT&W . 245 20.6 Factory Defaults Restorable with AT&F . 246 20.7 Summary of Unsolicited Result Codes (URC). 248 20.8 AT Commands Not Usable for USB . 249 20.9 Alphabetical List of AT Commands . 250 Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 7 Table of Contents Tables Table 1.4: Types of AT commands and responses . 10 Table 1.5: Examples for character definitions depending on alphabet . 11 Table 2.1: Current configuration on ASC0 / MUX channel 1 (example) . 20 Table 2.3: Wake-up events in NON-CYCLIC and CYCLIC SLEEP modes. 24 Table 2.4: General "CME ERROR" Codes (GSM 07.07) .26 Table 2.5: GPRS related "CME ERROR" Codes (GSM 07.07) . 27 Table 2.6: SMS related "CMS ERROR" Codes (GSM 07.05) . 27 Table 2.7: SMS related "CMS ERROR" Codes (GSM 07.05) . 27 Table 2.8: SMS related "CMS ERROR" Codes (GSM 07.05) . 27 Table 4.1: Availability of AT Commands on Virtual Channels .57 Table 4.2: Summary of AT commands with Different Behavior in Multiplex Mode . 57 Table 10.1 Applicability of AT^SICS values. 122 Table 18.2: Modes of the LED and indicated ME functions. 230 Table 18.3: Special characters for ASCII coding. 234 Table 18.4: Structure of Transfer and Response Messages on the I²C bus. 235 Table 20.1: Star-Hash (*#) Command Overview . 240 Table 20.2: Abbreviations of Codes and Parameters used in Table 20.1 . 241 Table 20.3: Star-Hash Command Response Parameters . 241 Table 20.4: Star-Hash Commands for Supplementary Services . 241 Table 20.5: Available AT Commands and Dependency on SIM PIN. 242 Table 20.6: Availability of AT Commands Depending on Operating Mode of ME. 246 Table 20.7: Settings Stored to User Profile on ASC0 / MUX Channel 1. 250 Table 20.8: Factory Default Settings Restorable with AT&F . 251 Table 20.9: Summary of Unsolicited Result Codes (URC) . 253 Table 20.10: Alphabetical List of AT Commands. 255 Figures Figure 1.1: Main character table of GSM 03.38 alphabet . 12 Figure 1.2: Extension character table of GSM 03.38 alphabet . 13 Figure 17.1: Audio programming model. 213 Figure 18.1: Formula for calculating delay time. 233 Figure 18.2: Delay time on 12C after Write. 233 Figure 18.3: Delay time on 12C after Read. 233 Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 8 Chapter 1 ­ Introduction Chapter 1. Introduction 1.1 Scope of the Document This document presents the AT Command set for the Multi-Tech Systems, Inc. wireless Edge devices. 1.2 Related Documents 1. ITU-T Recommendation V.24: List of definitions for interchange circuits between data terminal equipment (DTE) and data circuit-terminating equipment (DCE) 2. ITU-T Recommendation V.250: Serial asynchronous automatic dialing and control 3. 3GPP TS 100 918/EN 918/EN 300 918 (GSM 02.04): General on supplementary services 4. 3GPP TS 100 907 (GSM 02.30): Man-Machine Interface (MMI) of the Mobile Station (MS) 5. 3GPP TS 23.038 (GSM 03.38): Alphabets and language specific information 6. 3GPP TS 27.005 (GSM 07.05): Use of Data Terminal Equipment - Data Circuit terminating Equipment (DTE - DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) 7. 3GPP TS 27.007 (GSM 07.07): AT command set for User Equipment (UE) 8. 3GPP TS 27.060 (GSM 07.60): Mobile Station (MS) supporting Packet Switched Services 9. 3GPP TS 51.011 (GSM 11.11): Specification of the Subscriber Identity Module - Mobile Equipment (SIM ME) interface 10. 3GPP TS 11.14 (GSM 11.14): Specification of the SIM Application Toolkit for the Subscriber Identity Module - Mobile Equipment (SIM - ME) interface 11. 3GPP TS 22.101 (GSM 22.101): Service principles 12. Common PCN Handset Specification (CPHS) v4.2 1.3 Document Conventions Throughout the document, the GSM engines are referred to as: ME (Mobile Equipment) MS (Mobile Station) TA (Terminal Adapter) DCE (Data Communication Equipment) Facsimile DCE (FAX modem, FAX board) To control your GSM engine you can simply send AT Commands via its serial interface. The controlling device at the other end of the serial line is referred to as: TE (Terminal Equipment) DTE (Data Terminal Equipment) or `the application' (probably running on an embedded system). All abbreviations and acronyms used throughout this document are based on the GSM specifications. For definitions please refer to TR 100 350 V7.0.0 (1999-08), (GSM 01.04, version 7.0.0 release 1998). Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 9 Chapter 1 ­ Introduction 1.4 AT Command Syntax The "AT" or "at" prefix must be set at the beginning of each command line. To terminate a command line enter . Commands are usually followed by a response that includes "". Throughout this document, only the responses are presented, are omitted intentionally. Table 1.4: Types of AT commands and responses. AT Cmmand Type Test command Syntax AT+CXXX=? Read command Write command Exec(ution) command AT+CXXX? AT+CXXX= AT+CXXX Function The mobile equipment returns the list of parameters and value ranges set with the corresponding Write command or by internal processes. This command returns the currently set value of the parameter(s). This command sets user-definable parameter values. The execution command reads non-variable parameters determined by internal processes in the GSM engine. 1.4.1 Using Parameters · Optional parameters are enclosed in square brackets. If optional parameters are omitted, the current settings are used until you change them. · Optional parameters or subparameters can be omitted unless they are followed by other parameters. If you want to omit a parameter in the middle of a string it must be replaced by a comma. See also example 1. · A parameter value enclosed in square brackets represents the value that will be used if an optional parameter is omitted. See also example 2. · When the parameter is a character string; e.g., or , the string must be enclosed in quotation marks (e.g., "Charlie Brown" or "+49030xxxx"). Symbols in quotation marks will be recognized as strings. · All spaces will be ignored when using strings without quotaton marks. · It is possible to omit the leading zeros of strings which represent numbers. · If an optional parameter of a V.250 command is omitted, its value is assumed to be 0. Example 1: Omitting parameters in the middle of a string AT+CCUG? +CCUG: 1,10,1 OK AT+CCUG=,9 OK AT+CCUG? +CCUG: 1,9,1 OK Query current setting Set only the middle parameter Query new setting Example 2: Using default parameter values for optional parameters AT+CFUN=7,0 OK AT+CFUN? +CFUN: 7 OK AT+CFUN= OK +CFUN: 1 OK Activate CYCLIC SLEEP mode, don't reset ME Query ME mode Set ME back to normal (default parameters: 1,0) 1.4.2 Combining AT Commands on the Same Command Line You may enter several commands on the same line. This eliminates the typing of "AT" or "at" before each command. Instead, it is needed only once - at the beginning of the command line. Use a semicolon as command delimiter. The table below lists the AT commands you cannot enter together with other commands on the same line. Otherwise, the responses may not be in the expected order. AT Command Type Comment V.250 commands with FAX commands (Prefix AT+F) GSM 7.07 commands with AT commands, Prefix AT^S) GSM 7.05 commands (SMS) To be used as standalone commands Commands starting with AT& To be used as standalone commands AT+IPR To be used as standalone commands Note: When concatenating AT commands please keep in mind that the sequence of processing may be different from the sequential order of command input. Therefore, if the consecutive order of the issued commands and associated responses is your concern, avoid concatenating commands on the same line. Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 10 Chapter 1 ­ Introduction 1.5 Supported Character Sets The ME supports two character sets: GSM 03.38 (7 bit, also referred to as GSM alphabet or SMS alphabet) and UCS2 (16 bit, refer to ISO/IEC 10646). See AT+CSCS for information about selecting the character set. Character tables can be found below. Explanation of terms · International Reference Alphabet (IRA) IRA means that one byte is displayed as two characters in hexadecimal format. For example, the byte 0x36 (decimal 54) is displayed as "36" (two characters). IRA is used here for input 8-bit or 16-bit data via terminal devices using text mode. This means only characters `A'.F','a'.'f' and `0'.'9' are valid. · Escape sequences The escape sequence used within a text coded in the GSM default alphabet (0x1B) must be correctly interpreted by the TE, both for character input and output. To the module, an escape sequence appears like any other byte received or sent. · Terminal Adapter (TA) TA is used equivalent to Mobile Equipment (ME) which stands for the GSM module described here. It uses GSM default alphabet as its character set. · Terminal Equipment (TE) TE is the device connected to the TA via serial interface. In most cases TE is an ANSI/ASCII terminal that does not fully support the GSM default alphabet, for example MS Hyperterminal. · TE Character Set The character set currently used by Terminal Equipment is selected with AT+CSCS. · Data Coding Scheme (dcs) DCS is part of a short message and is saved on the SIM. When writing a short message to the SIM in text mode, the dcs stored with AT+CSMP is used and determines the coded character set. The behavior when encountering characters, that are not valid characters of the supported alphabets, is undefined. Due to the constraints described below it is recommended to prefer the USC2 alphabet in any external application. If the GSM alphabet is selected all characters sent over the serial line (between TE and TA) are in the range from 0 to 127 (7 Bit range). CAUTION: ASCII alphabet (TE) is not GSM alphabet (TA/ME) ! Several problems resulting from the use of GSM alphabet with ASCII terminal equipment: · "@" character with GSM alphabet value 0 is not printable by an ASCII terminal program (e.g., Microsoft© Hyperterminal®). · "@" character with GSM alphabet value 0 will terminate any C string! This is because the 0 is defined as C string end tag. Therefore, the GSM Null character may cause problems on application level when using a `C'- function as "strlen()". This can be avoided if it is represented by an escape sequence as shown in the table below. By the way, this may be the reason why even network providers often replace "@"with "@=*" in their SIM application. · Other characters of the GSM alphabet are misinterpreted by an ASCII terminal program. For example, GSM "ö" (as in "Börse") is assumed to be "|" in ASCII, thus resulting in "B|rse". This is because both alphabets mean different characters with values hex. 7C or 00 and so on. · In addition, decimal 17 and 19 which are used as XON/XOFF control characters when software flow control is activated, are interpreted as normal characters in the GSM alphabet. When you write characters differently coded in ASCII and GSM (e.g., Ä, Ö, Ü), you need to enter escape sequences. Such a character is translated into the corresponding GSM character value and, when output later, the GSM character value can be presented. Any ASCII terminal then will show wrong responses. Table 1.5: Examples for character definitions depending on alphabet GSM 03.38 character GSM character hex. value Corresponding ASCII character ASCII Esc sequence Hex Esc sequence Ö " ò @ 5C 22 08 00 \ " BSP NULL \5C \22 \08 \00 5C 35 43 5C 32 32 5C 30 38 5C 30 30 CAUTION: Often, the editors of terminal programs do not recognize escape sequences. In this case, an escape sequence will be handled as normal characters. The most common workaround to this problem is to write a script which includes a decimal code instead of an escape sequence. This way you can write, for example, short messages which may contain differently coded characters. Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 11 Chapter 1 ­ Introduction 1.5.1 GSM Alphabet Tables and UCS2 Character Values This section provides tables for the GSM 03.38 alphabet supported by the ME. Below any GSM character find the corresponding two byte character value of the UCS2 alphabet. Figure 1.1: Main character table of GSM 03.38 alphabet 1. 2. This code is an escape to the following extension of the 7 bit default alphabet table. This code is not a printable character and therefore not defined for the UCS2 alphabet. It shall be treated as the accompanying control character. Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 12 Chapter 1 ­ Introduction Figure 1.2: Extension character table of GSM 03.38 alphabet 1. This code value is reserved for the extension to another extension table. On receipt of this code, a receiving entity shall display a space until another extension table is defined. 2. This code represents the EURO currency symbol. The code value is the one used for the character `e'. Therefore a receiving entity which is incapable of displaying the EURO currency symbol will display the character `e' instead. 3. This code is defined as a Page Break character and may be used for example in compressed CBS messages. Any mobile which does not understand the 7 bit default alphabet table extension mechanism will treat this character as Line Feed. In the event that an MS receives a code where a symbol is not represented in Figure 1.2, Extension character table of GSM 03.38 alphabet the MS shall display the character shown in the main default 7 bit alphabet table (see Figure 1.1, Main character table of GSM 03.38 alphabet). Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 13 Chapter 1 ­ Introduction 1.5.2 UCS2 and GSM Data Coding and Conversion for SMS Text Mode This section provides basic information on how to handle input and output character conversion for SMS text mode and Remote-SAT if the internal (TA) and external (TE) character representation differ; e.g., if the Data Coding Scheme and the TE character use different coding. 1.5.2.1 Implementing Output of SIM Data to Terminal (Direction TA to TE) Used Character DCS = 7 bit DCS = 8 bit DCS = 16 bit Set GSM Data UCS2 GSM UCS2 Case 1 GSM (1:1) Case 4 GSM to IRA (1:4) Case 2 8 bit to IRA (1:2) Case 5 8 bit to IRA (1:4) Case 3 UCS2 to IRA (2:4) Case 6 UCS2 to IRA (2:4) Note: The ratio of SIM bytes to output bytes is given in parentheses. Case 1 Every GSM character is sent to TE as it is (8-bit value with highest bit set to zero). Example: 47'H, 53'H, 4D'H 47'H, 53'H, 4D'H, displayed as "GSM". Case 2 Every data byte will is sent to TE as 2 IRA characters each representing a halfbyte. Example: B8'H (184 decimal) 42'H, 38'H, displayed as "B8". Case 3 Every 16-bit UCS2 value is sent to TE as 4 IRA characters. Example: C4xA7'H (50343 decimal) 43'H, 34'H, 41'H, 37'H, displayed as "C4A7". Problem: An odd number of bytes leads to an error because there are always two bytes needed for each USC2 character. Case 4 Every GSM character is sent to TE as 4 IRA characters to show UCS2 in text mode. Example: 41'H ("A") 30'H, 30'H, 34'H, 31'H, displayed as "0041". Case 5 Every data byte is sent to TE as IRA representation of UCS2 (similar to case 4). Example: B2'H 30'H, 30'H, 42'H, 32'H, displayed as "00B2". Case 6 Every 16-bit value is sent to TE as IRA representation of it. It is assumed that number of bytes is even. Example: C3x46'H 43'H, 33'H, 34'H, 36'H, displayed as "C346". Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 14 Chapter 1 ­ Introduction 1.5.2.2 Implementing Input of Terminal Data to SIM (Direction TE to TA) Used Character DCS = 7 bit DCS = 8 bit DCS = 16 bit Set GSM Data UCS2 GSM UCS2 Case 1 GSM (1:1) Case 4 GSM to IRA (1:4) Case 2 IRA to 8 bit (2:1) Case 5 8 bit to IRA (1:4) Case 3 IRA to 16 bit (4:2) Case 6 UCS2 to IRA (2:4) Note: The ratio between the number of input characters and bytes stored on the SIM is given in parentheses. Case 1 Every character is sent from TE to TA as GSM character (or ASCII with Hyperterminal). Character value must be in range from 0 to 127 because of 7-bit GSM alphabet. To reach maximum SMS text length of 160 characters in 140 bytes space characters will be compressed on SIM. This must be set using the parameter of AT+CSMP (add 64). Example: "ABCDEFGH" typed is sent and stored uncompressed as 4142434445464748'H (stored compressed as 41E19058341E91 41E19058341E91'H). Case 2 Every data byte is sent to TA as 2 IRA characters. Maximum text length is 280 IRA characters which will be converted into 140 bytes SMS binary user data. Example: "C8" typed is sent as 43'H, 38'H stored as C8'H. Case 3 Every 16-bit value is sent to TA as 4 IRA characters. Maximum text length is 280 IRA characters which will be converted into 70 UCS2 characters (16-bit each). Number of IRA characters must be a multiple of four because always 4 half bytes are needed for a 16-bit value. Example: "D2C8" typed is sent as 44'H, 32'H, 43'H, 38'H stored as D2C8'H. Case 4 Every GSM character is sent to TA as 4 IRA characters representing one UCS2 character. Example: To store text "ABC" using UCS2 character set you have to type "004100420043". This is sent as 30'H,30'H,34'H,31'H, 30'H,30'H,34'H,32'H, 30'H,30'H,34'H,33'H detected as IRA representation of 3 UCS2 characters, converted to GSM character set and stored as 41'H, 42'H, 43'H. Maximum input is 640 IRA characters repesenting 160 UCS2 characters when compression is active. These are converted to 160 GSM 7-bit characters. Without compression only 140 GSM characters can be stored which are put in as 560 IRA characters. Values of UCS2 characters must be smaller than 80'H (128 decimal) to be valid GSM characters. Number of IRA characters must be a multiple of four. Problems: · "41" ¨ Error, there are four IRA characters (two bytes) needed · "0000" Error, not an UCS2 character · "4142" Error, value of UCS2 character > 7F'H · "008B" Error, value of UCS2 character > 7F'H This affects the maximum input length of a string) Case 5 Every UCS2 character is sent as 4 IRA characters and is converted into two 8-bit values. This means that the first two characters have to be `00'. Example: UCS2 character 009F'H typed as "009F" is sent as 30'H,30'H,39'H,46'H ¨ converted into 8-bit value 9F'H. Maximum number of UCS2 characters is 140 which are represented by 560 IRA characters. Number of IRA characters must be a multiple of four. Case 6 Every UCS2 character is sent as 4 IRA characters each and is converted into a 16-bit value again. Example: UCS2 character 9F3A'H typed as "9F3A" is sent as 39'H,46'H,33'H,41'H converted into 9F3A'H. Maximum number of UCS2 characters is 70 which are represented by 280 IRA characters. Number of IRA characters must be a multiple of four. Invalid UCS2 values must be prevented. Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 15 Chapter 1 ­ Introduction 1.6 Serial Interface Flow Control Flow control is essential to prevent loss of data or avoid errors when, in a data or fax call, the sending device is transferring data faster than the receiving side is ready to accept. When the receiving buffer reaches its capacity, the receiving device should be capable to cause the sending device to pause until it catches up. There are basically two approaches to regulate data flow: Software flow control and hardware flow control. The High Watermark of the input/output buffer should be set to approximately 60% of the total buffer size. The Low Watermark is recommended to be about 30%. The data flow should be stopped when the capacity rises close to the High Watermark and resumed when it drops below the Low Watermark. The time required to cause stop and go results in a hysteresis between the High and Low Watermarks. During Multiplex mode (AT+CMUX) it is recommended to use hardware flow control. 1.6.1 Software Flow Control (XON/OFF Handshake) Software flow control sends different characters to stop (XOFF, decimal 19) and resume (XON, decimal 17) data flow. The only advantage of software flow control is that three wires would be sufficient on the serial interface. 1.6.2 Hardware Flow Control (RTS/CTS Handshake) Hardware flow control sets or resets the RTS/CTS wires. This approach is faster and more reliable, and therefore, the better choice. When the High Watermark is reached, CTS is set inactive until the transfer from the buffer has completed. When the Low Watermark is passed, CTS goes active again. To achieve smooth data flow, ensure that the RTS/CTS lines are present on your application platform. The application should include options to enable RTS/CTS handshake with the GSM engine. This needs to be done with the AT command AT\Q3 - it is not sufficient to set RTS/CTS handshake in the used Terminal program only. The default setting of the GSM engine is AT\Q0 (no flow control) which must be altered to AT\Q3 (RTS/CTS hardware handshake on). The setting is stored volatile and must be restored each time after the GSM engine was switched off. AT\Q has no read command. To verify its current setting, simply check the settings of the active profile with AT&V. Often, fax programs run an intialization procedure when started up. The intialization commonly includes enabling RTS/CTS hardware handshake, eliminating the need to set AT\Q3 once again. However, before setting up a CSD call, you are advised to check that RTS/CTS handshake is set. RTS/CTS hardware handshake must also be set if you want to take advantage of the CYCLIC SLEEP modes. For further details refer to AT+CFUN. 1.7 Unsolicited Result Code Presentation URC stands for Unsolicited Result Code and is a report message issued by the ME without being requested by the TE; e.g., a URC is issued automatically when a certain event occurs. Hence, a URC is not issued as part of the response related to an executed AT command. Typical events leading to URCs are incoming calls ("RING"), waiting calls, received short messages, changes in temperature, network registration etc. A list of all URCs can be found in Section 20.7, Summary of Unsolicited Result Codes (URC). To announce a pending URC transmission the ME will do the following: · The ME activates its RING line (logic "1") for one second; i.e., the line changes to physical "Low" level. This allows the TE to stay in power saving mode until an ME-related event requests service. If several URCs occur conincidentally or in quick succession, each URC triggers the RING line independently, although the line will not be activated between each URC. As a result, the RING line may stay low for more than one second. If an incoming call is answered within less than one second (with ATA or if autoanswering is set to ATSO=1, then the RING line will be deactivated earlier. The "^SHUTDOWN" URC will not activate the RING line. · If the AT command interface is busy a "BREAK" will be sent immediately but the URC will not be issued until the line is free. This may happen if the URC is pending in the following cases: During the processing of an AT command (i.e., the time after the TE echoes back the first character "A" of an AT command just sent by itself until the ME responds with "OK" or "ERROR"). During a data call. Please note that AT command settings may be necessary to enable in-band signaling; e.g., refer to AT+CMER or AT+CNMI. It is strongly recommended to use the multiplex mode to map logical communication channels onto the serial line of the Multi-Tech wireless modem, for details refer to [5] and AT command AT+CMUX. Doing so it is possible to use one channel to still process URCs while having a data call active on another. Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 16 Chapter 1 ­ Introduction For most of these messages, the ME needs to be configured whether or not to send a URC. Depending on the AT command, the URC presentation mode can be saved to the user defined profile (see AT&W), or needs to be activated every time you reboot the ME. Several URCs are not user definable, such as "^SYSSTART", "^SYSSTART ", "^SHUTDOWN". If autobauding is enabled (as factory default mode or set with AT+IPR=0), URCs generated after restart will be output with 57600 bps until the ME has detected the current bit rate. The URCs "^SYSSTART", "^SYSSTART ", however, are not presented at all. For details please refer to Section 4.9.1, Autobauding. To avoid problems we recommend to configure a fixed bit rate rather than using autobauding. 1.7.1 Communication between Customer Application and Multi-Tech Wireless Modem Leaving hardware flow control unconsidered the Customer Application (TE) is coupled with the Multi-Tech wireless modem (ME) via a receive and a transmit line. Since both lines are driven by independent devices, collisions may (and will) happen; i.e., while the TE issues an AT command, the Multi-Tech wireless modem starts sending an URC. This will probably lead to the TE's misinterpretation of the URC being part of the AT command's response. To avoid this conflict the following measures must be taken: · If an AT command is finished (with "OK" or "ERROR") the TE shall always wait at least 100 milliseconds before sending the next one. This gives the Multi-Tech wireless modem the opportunity to transmit pending URCs and get necessary service. Note that some AT commands may require more delay after "OK" or "ERROR" response, refer to the following command specifications for details. · The TE shall communicate with the Multi-Tech wireless modem using activated echo (ATE1); i.e., the Multi-Tech wireless modem echoes characters received from the TE. Hence, when the TE receives the echo of the first character "A" of the AT command just sent by itself it has control both over the receive and the transmit paths. Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 17 Chapter 1 ­ Introduction 1.8 Common PCN Handset Specification (CPHS) The ME provides features to implement a device following the prerequisites of the Common PCN Handset Specification (CPHS) Phase 2. CPHS Feature Description/Remarks AT command Alternate Line Service Voice Message Waiting Indication Operator (Service provider) name from SIM Network and Service Provider Lock Call Forwarding Customer Service Profile (CSP) Information numbers Using two phone numbers with one SIM card. Indicate the receipt of a short message coded as Voice Message Waiting Indicator as defined by the CPHS Phase 2 standard. Read specific Elementary Files (6F14h, 6F18h) from SIM. AT^SALS AT^SIND, AT+CMER, indicators "vmwait1" and "vmwait2" AT+CRSM Lock/Unlock an ME to specific HPLMN and service provider. AT+CLCK, (AT+CPIN) Get and set diverted call status. Access specific Elementary File (6F13h) from SIM. Setting services and their menu entries depending on customer profiles. Hierarchically structured service numbers phonebook on SIM according to CPHS 4.2 (mandatory). AT+CCFC, AT+CRSM AT+CRSM AT+CRSM 1.9 Errors and Messages The command result codes "+CME ERROR: " and "+CMS ERROR: " indicate errors related to mobile equipment or network functionality. The format of can be either numeric or verbose and is selectable via AT+CMEE. A result error code terminates the execution of the command and prevents the execution of all remaining commands that may follow on the same command line. If so, neither "ERROR" nor "OK" result codes are returned for these commands. A 30 seconds timeout will deliver "ERROR" when the input of a command is not complete. Using the wrong command syntax may result in errors: For example, using the execute command syntax although the command has no execute format, causes "ERROR" to be returned. Likewise, using the write command syntax although the command has no write format causes "+CME ERROR: " to be returned. See also: · Section 2.12.1, CME/CMS Error Code Overview · Section 2.5.1, Verbose and numeric result codes · Section 3.4, AT+CEER Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 18 Chapter 2 ­ Configuration Commands Chapter 2. Configuration Commands The AT commands described in this chapter allow the external application to determine the modem's behavior under various conditions. 2.1 AT&F Set All Current Parameters to Manufacturer Defaults Description: AT&F sets all current parameters to the manufacturer defined profile. All defined GPRS contexts which are not activated or not online will be "undefined" (see AT+CGDCONT). AT&F[value] OK Exec Command Syntax: Response: Parameter Description: 0 Sets all TA parameters to manufacturer defaults. Notes: · List of parameters reset to manufacturer default can be found in Section 20.6, Factory Default Settings Restorable with AT&F. · In addition to the default profile, you can store an individual one with AT&W. To alternate between the two profiles enter either ATZ (loads user profile) or AT&F (restores factory profile). · Every ongoing or incoming call will be terminated. 2.2 AT&V Display Current Configuration Description: Exec Command Syntax: Response: AT&V returns the current parameter setting. The configuration varies depending on whether or not PIN authentication has been done and whether or not Multiplex mode is enabled (see AT+CMUX). AT&V[value] Active Profile (See Section 2.2.1 AT&V responses) OK Parameter Description: : 0 Profile number Notes: · The value of \Q (flow control) is also determined by the AT+IFC command. In case the value set by AT+IFC cannot be represented by a \Q equivalent, \Q255 will be displayed. The parameters of AT^SMGO can only be displayed after the SMS data from the SIM have been read successfully for the first time. Reading starts after successful SIM authentication has been performed, and may take up to 30 seconds depending on the SIM used. While the read process is in progress, an attempt to read the parameter will result in empty values. · The parameter of AT+CSDH will only be displayed in SMS text mode, see AT+CMGF. Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 19 Chapter 2 ­ Configuration Commands 2.2.1 AT&V Responses The following table shows different kinds of responses depending on whether or not the PIN is entered. Table 2.1: Current configuration on ASC0 channel 1 (example) PIN authentication done No PIN authentication ACTIVE PROFILE: E1 Q0 V1 X4 &C1 &D2 &S0 \Q0 \V1 S0:000 S3:013 S4:010 S5:008 S6:000 S7:060 S8:000 S10:002 S18:000 +CBST: 7,0,1 +CRLP: 61,61,78,6 +CR: 0 +FCLASS: 0 +CRC: 0 +CMGF: 0 +CSDH: 0 +CNMI: 0,0,0,0,1 +IFC:3 +IFC:0,0 +ILRR: 0 +IPR: 115200 +CMEE: 2 ^SMGO: 0,0 +CSMS: 0,1,1,1 ^SACM: 0,"000000","000000" ^SLCC: 0 ^SCKS: 0,1 ^SSET:0 +CREG: 0,1 +CLIP: 0,2 +CAOC: 0 +COPS: 0,0,"operator" +CGSMS: 3 OK ACTIVE PROFILE: E1 Q0 V1 X4 &C1 &D2 &S0 \Q0 \V1 S0:000 S3:013 S4:010 S5:008 S6:000 S7:060 S8:000 S10:002 S18:000 +CBST: 7,0,1 +CRLP: 61,61,78,6 +CR: 0 +FCLASS: 0 +IFC:3 +IFC:0,0 +ILRR: 0 +IPR: 115200 +CMEE: 2 ^SCKS: 0,1 ^SSET:0 OK Note: Table 2.2 has been intentionally omitted. 2.3 AT&W Stores Current Configuration Description: AT&W stores the currently parameters to a user-defined profile in the non-volatile memory. AT&W[value] OK Exec Command Syntax: Response: Parameter Values: 0 Number of the profile Notes: · The user defined profile will be restored automatically after power-up. Use ATZ to restore user profile and AT&F to restore factory settings. Until the first use of AT&W, ATZ works as AT&F. · User defined profiles in multiplex mode: AT&W stores all global settings and the current settings of the interface on which the command is executed. · A list of parameters stored to the user profile can be found in Section 20.5, AT Command Settings storable with AT&W. 2.4 ATQ Set Result Code Presentation Mode Description: This parameter setting determines whether or not the TA transmits any result code to the TE. Information text transmitted in response is not affected by this setting. Store this parameter with the AT&W command. Display this parameter with the AT&V command. Exec Command Syntax: ATQ Response: If = 0, then OK. Default If = 1, then (none). Parameter Values: 0 DCE transmits result code. Default. 1 Result codes are suppressed and not transmitted Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 20 Chapter 2 ­ Configuration Commands 2.5 ATV Set Result Code Format Mode Description: Exec Command Syntax: Response: Parameter Value: 0 1 This command determines the contents of the header and trailer transmitted with AT command result codes and information responses. Possible responses are described in Section 2.5.1, Verbose and numeric result codes. Store this parameter with the AT&W command. Display this parameter with the AT&V command. ATV OK ERROR Information response: Short result code format: Information response: Long result code format: 2.5.1 Verbose and Numeric Result Codes Verbose format OK CONNECT RING NO CARRIER ERROR NO DIALTONE BUSY CONNECT 2400/RLP 2400/RLP CONNECT 4800/RLP 4800/RLP CONNECT 9600/RLP 9600/RLP CONNECT 14400/RLP 14400/RLP ALERTING DIALING Numeric format 0 1 2 3 4 6 7 47 48 49 50 Meaning Command executed, no errors Link established Ring detected Link not established or disconnected Invalid command or command line too long No dial tone, dialing impossible, wrong mode Remote station busy Link with 2400 bps and Radio Link Protocol Link with 4800 bps and Radio Link Protocol Link with 9600 bps and Radio Link Protocol Link with 14400 bps and Radio Link Protocol Alerting at called phone Mobile phone is dialing Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 21 Chapter 2 ­ Configuration Commands 2.6 ATX Set CONNECT Result Code Format and Call Monitoring Description: ATX determines whether or not the TA detects the presence of dial tone and busy signal and whether or not TA transmits particular result codes. Store this parameter with the AT&W command. Display this parameter with the AT&V command. Exec Command Syntax: ATX Response: OK ERROR Parameter Description: 0 CONNECT result code only returned, dial tone and busy detection are both disabled. Default. 1 CONNECT result code only returned, dial tone and busy detection are both disabled. 2 CONNECT result code returned, dial tone detection is enabled, busy detection is disabled. 3 CONNECT result code returned, dial tone detection is disabled, busy detection is enabled. 4 CONNECT result code returned, dial tone and busy detection are both enabled. 2.7 AT\ V Set CONNECT Result Code Format Exec Command Syntax: AT\ V Response: OK ERROR Parameter Description: 0 CONNECT result code returned without RLP trailer. Default. 1 CONNECT result code returned with RLP trailer. Notes: · For circuit-switched data calls only · Output only if ATX parameter is set with value > 0. 2.8 ATZ Set all Current Parameters to User Defined Profile Description: ATZ sets all current parameters to the user profile stored with AT&W. If a connection is in progress, it will be terminated. All defined GPRS contexts which are not activated or not online will be undefined (see AT+CGDCONT, AT+CGQREQ and AT+CGQMIN command). The user defined profile is stored to the non-volatile memory. Exec Command Syntax: ATZ[value] Response: OK Parameter Description: : 0 Reset to user profile Notes: · First the profile will be set to factory default (see AT&F). If there is a valid user profile (stored with AT&W), this profile will be loaded afterwards. · Any additional commands on the same command line may be ignored. A delay of 300 ms is required before next command is sent, otherwise "OK" response may be corrupted. Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 22 Chapter 2 ­ Configuration Commands 2.9 AT+CFUN Set Phone Functionality Description: This command serves to control the functionality level of the mobile equipment (ME). It can be used to reset the ME, to choose one of the SLEEP modes, or to return to full functionality. Intended for power saving, SLEEP mode reduces the functionality of the ME to a minimum and thus minimizes the current consumption. SLEEP mode falls in two categories: · NON-CYCLIC SLEEP mode =0 · and CYCLIC SLEEP modes, selectable as = 7 or 9. NON-CYCLIC SLEEP mode permanently blocks the serial interface. The benefit of the CYCLIC SLEEP mode is that the serial interface remains accessible and that, in intermittent wake-up periods, characters can be sent or received without terminating the selected mode. This allows the ME to wake up for the duration of an event and, afterwards, to resume power saving. Please refer to Section 2.8.1, Wake up the ME from SLEEP mode for a summary of all SLEEP modes and the different ways of waking up the module. For CYCLIC SLEEP mode both the ME and the application must be configured to use hardware flow control. This is necessary since the CTS signal is set/reset every 0.9 to 2.7 seconds in order to indicate to the to the application when the UART is active. The default setting of hardware flow control is AT\Q0 which must be altered to AT\Q3. For use after restart you are advised to add it to the user profile saved with AT&W. Test Command Syntax: The test command returns the values of the supported parameters. AT+CFUN=? Response: +CFUN: (list of supported s) , (list of supported s) OK Read Command Syntax: The read command returns the current functionality value. AT+CFUN? Response: +CFUN: OK Write Command Syntax: The write command can be used to reset the ME, to choose one of the SLEEP modes or to return to full functionality. AT+CFUN=, Response: OK ERROR +CME ERROR Parameter Descriptions: 0 ­ NON-CYCLIC SLEEP mode: In this mode, the AT interface is not accessible. Consequently, after setting =0, do not send further characters. Otherwise these characters remain in the input buffer and may delay the output of an unsolicited result code. The first wake-up event stops power saving and takes the ME back to full functionality level =1. 1 ­ Full functionality. Default If the ME is in one of the CYCLIC SLEEP modes you can issue AT+CFUN=1 to stop power saving and return to full functionality. Keep in mind that, unlike the reset command described below, this action does not restart the ME but only changes the level of functionality. See parameter for details on the reset. 7 ­ CYCLIC SLEEP mode: In this mode, the serial interface is shortly enabled during paging. If characters are recognized on the serial interface, the ME stays active for 2 seconds after the last character was sent or received. ME exits SLEEP mode only, if AT+CFUN=1 is entered. 9 ­ CYCLIC SLEEP mode: In this mode, the serial interface is shortly enabled while CTS is active. If characters are recognized on the serial interface, the ME stays active after the last character was sent or received for at least the time, which can be configured by AT^SCFG="PowerSaver/Mode9/Timeout", (temporary wakeup). In contrast to SLEEP mode 7 assertion of RTS can also be used to temporarily wake up the ME. In this case too, activity time is at least the time set with AT^SCFG="PowerSaver/Mode9/Timeout",. ME exits SLEEP mode only, if AT+CFUN=1 is entered. Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 23 Chapter 2 ­ Configuration Commands The parameter can only be used if the serial interface is enabled. Due to the command syntax, you need to enter parameter , followed by , where is only a placeholder and has no effect. See examples below. 0 Placeholder for as stated above. Default. 1 ME resets and restarts to full functionality. After reset and restart, PIN 1 authentication is necessary (AT+CPIN). If autobauding is enabled, it is recommended to wait 3 to 5 seconds before entering the first AT command. For details on autobauding refer to Section 4.9.1, Autobauding. Unsolicited Result Codes: URC 1 ^SYSSTART Indicates that the ME has been started and is ready to operate. If autobauding is active (AT+IPR=0), the URC is not generated. If the ME is configured to enter the Airplane mode after restart or reset the following URC is received on bootup: "^SYSSTART AIRPLANE MODE". In this mode, only the AT commands listed in Section 20.4, Availability of AT Commands Depending on Operating Mode of ME can be used. For details please refer to the AT^SCFG command, parameter . Notes: · When a circuit-switched call is in progress, =7 or 9 can be activated without terminating the call. However, setting =0, during a circuit-switched call immediately disconnects this call. · To check whether power saving is on, you can query the status with the read command AT+CFUN? only if the module is in full functionality mode or in CYCLIC SLEEP mode. If available, you can also take advantage of the status LED controlled by the SYNC pin (see AT^SSYNC and [2]). With AT^SSYNC you can select different modes of LED signalization during SLEEP modes (See Section 18.6.1., ME Status Indicated by Status LED for details. However, the module can wake up temporarily from power saving without leaving its CYCLIC SLEEP mode (without changing +CFUN ""); e.g., for a network scan after a loss of radio coverage, or after receipt of serial data during CYCLIC SLEEP mode. During this "temporary wakeup state" the LED will operate as if the ME was in full functionality mode. · Recommendation: In NON-CYCLIC SLEEP mode, you can set an RTC alarm to wake up the ME and return to full functionality. This is a useful approach because, in this mode, the AT interface is not accessible. 2.9.1 Wake up the ME from SLEEP Mode A wake-up event is any event that causes the mobile equipment (ME) to draw more current. Depending on the selected mode, the wake-up event either switches the SLEEP mode off and takes the ME back to full functionality AT+CFUN=1, or activates the ME temporarily without terminating the selected SLEEP mode. Definitions of the state transitions described in Table 2.3: · Quit: ME exits SLEEP mode. · Temporary: ME becomes active temporarily for the duration of the event and the mode-specific follow-up time after the last character was sent or received on the serial interface. · No effect: Event is not relevant in the selected SLEEP mode. The ME does not wake up. Table 2.3: Wake-up Events in NON-CYCLIC and CYCLIC SLEEP Modes Event Ignition line /RTS0 or RTS1 activation Selected mode: =0 No effect Quit Unsolicited Result Code (URC) Incoming voice or data call Any AT command (incl. outgoing SMS, voice or data call) Incoming SMS (AT+CNMI is set to 0,0 (this is the default setting) Incoming SMS (AT+CNMI is set to 1,1) GPRS data transfer RTC alarm line AT+CFUN=1 Quit Quit Not possible (UART disabled) Selected mode: =7 or 9 No effect Mode 7: No effect (RTS is only used for flow control) Mode 9: Temporary Temporary Temporary Temporary No effect No effect Quit Not possible (UART disabled) Quit Not possible (UART disabled) Temporary Temporary Temporary Quit Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 24 Chapter 2 ­ Configuration Commands 2.10 AT^SMSO Switch off Mobile Station Description: AT^SMSO initiates the power-off procedure. High level of the module's PWR_IND and the URC "^SHUTDOWN" notifies that the procedure has completed and the module has entered the POWER DOWN mode. Therefore, be sure not to disconnect the operating voltage until PWR_IND is High or until the URC "^SHUTDOWN" is displayed. Otherwise, you run the risk of losing data. For further details on how to turn off the module see the [2]. Exec Command Syntax: ^SMSO Response(s): ^SMSO: MS OFF, OK Test Command Syntax: AT^SMSO=? Response: OK Unsolicited Result Code: ^SHUTDOWN Indicates that the power-off procedure is finished and the module will be switched off in less than 1 second. Notes: · Do not send any other AT command after AT^SMSO. · If AT^SMSO is entered on one of the Multiplexer channels, the ME closes the Multiplexer channels, terminates the Multiplexer, and deactivates all other functions. Then the URC "^SHUTDOWN" will be issued on the physical serial interface (ASC0). The URC will be transmitted at the bit rate last activated on ASC0 for use with the Multiplexer driver. 2.11 AT+GCAP Request Complete TA Capabilities List Description: AT+GCAP returns a list of additional capabilities. Exec Command Syntax: AT+GCAP Response(s): +GCAP: , OK Test Command Syntax: AT+GCAP=? Response: OK Parameter Description: e.g., +CGSM,+FCLASS Note: · +CGSM: The response text shows which GSM commands of the ETSI standard are supported. 2.12 AT+CMEE Mobile Equipment Error Message Format Description: AT+CMEE controls the format of the error result codes that indicates errors related to the Multi-Tech wireless modem's functionality. Format can be selected between plain "ERROR" output, error numbers or verbose "+CME ERROR: " and "+CMS ERROR: " messages. Possible error result codes are listed in Table 2.6, General "CME ERROR" Codes (GSM 07.07), Table 2.5, GPRS related "CME ERROR" Codes (GSM 07.07) and Table 2.8, SMS related "CMS ERROR" Codes (GSM 07.05). In Multiplexer mode, the setting applies only to the logical channel where selected. The setting on the other channels may differ. Test Command Syntax: AT+CMEE=? Response: +CMEE : (list of supporteds) OK Read Command Syntax: AT+CMEE? Response: +CMEE : OK Write Command Syntax: AT+CMEE= Response: OK ERROR +CME ERROR: Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 25 Chapter 2 ­ Configuration Commands Parameter Description: 0 Disable result code; i.e., only "ERROR" will be displayed. 1 Enable error result code with numeric values. 2 Enable error result code with verbose (string) values. Example: To obtain enhanced error messages it is recommended to choose =2: AT+CMEE=2 OK 2.12.1 CME/CMS Error Code Overview Table 2.4: General "CME ERROR" Codes (GSM 07.07) Code Text (if AT+CMEE=2) 0 phone failure 1 no connection to phone 2 phone-adapter link reserved 3 Operation not allowed 4 Operation not supported 5 PH-SIM PIN required 6 PH-FSIM PIN required 7 PH-FSIM PUK required 10 SIM not inserted 11 SIM PIN required 12 SIM PUK required 13 SIM failure 14 SIM busy 15 SIM wrong 16 Incorrect password 17 SIM PIN2 required 18 SIM PUK2 required 20 Memory full 21 Invalid index 22 not found 23 Memory failure 24 text string too long 25 invalid characters in text string 26 dial string too long 27 invalid characters in dial string 30 no network service 31 Network timeout 32 Network not allowed emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 service provider personalization PIN required 45 service provider personalization PUK required 46 Corporate pe sonalization PIN required 47 Corporate personalization PUK required 48 Master Phone Code required 100 unknown 132 service option not supported 133 requested service option not subscribed 134 service option temporarily out of order 126 Operation temporary not allowed 257 call barred 258 phone is busy 259 user abort 260 invalid dial string 261 ss not executed 262 SIM blocked 263 Invalid Block Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B S000371B) 26 Chapter 2 ­ Configuration Commands Table 2.5: General "CME ERROR" Codes Code 772 Text (if AT+CMEE=2) SIM powered down Table 2.6: GPRS related "CME ERROR" Codes (GSM 07.07) Code 103 106 107 111 112 113 148 149 150 Text (if AT+CMEE=2) illegal MS illegal ME GPRS services not allowed PLMN not allowed Location area not allowed Roaming not allowed in this location area unspecified GPRS error PDP authentication failure invalid mobile class Table 2.7: GPRS-related "CMES ERROR" Codes Code 578 588 594 595 596 607 625 630 632 633 643 644 646 Text (if AT+CMEE=2) GPRS ­ unspecified activation rejection GPRS ­ feature not supported GPRS ­ invalid address length GPRS ­ invalid character in address string GPRS ­ invalid cid value GPRS ­ missing or unknown APN GPRS ­ PDP type not supported GPRS ­ profile (cid) not defined GPRS ­ QOS not accepted GPRS ­ QOS validation fail GPRS ­ unknown PDP address or type GPRS ­ unknown PDP context GPRS ­ QOS invalid parameter Table 2.8: SMS related "CMS ERROR" Codes (GSM 07.05) Code 1 8 10 21 27 28 29 30 38 41 42 47 50 69 81 95 96 97 98 99 111 127 128 129 130 143 144 145 Text (if AT+CMEE=2) Unassigned (unallocated) number Operator determined barring Call barred Short message transfer rejected Destination out of service Unidentified subscriber Facility rejected Unknown subscriber Network out of order Temporary failure Congestion Resources unavailable, unspecified Requested facility not subscribed Requested facility not implemented Invalid short message transfer reference value Invalid message, unspecified Invalid mandatory information Message type non-existent or not implemented Message not compatible with short message protocol state Information element non-existent or not implemented Protocol error, unspecified Interworking, unspecified Telematic interworking not supported Short message Type 0 not supporte