MC55i AT Command Specification A75 Siemens
User Manual: A75
Open the PDF directly: View PDF 
.
Page Count: 479
| Download | |
| Open PDF In Browser | View PDF |
MC55i Siemens Cellular Engine Version: DocId: 01.003 MC55i_ATC_V01.003 AT Command Set s MC55i AT Command Set s Document Name: MC55i AT Command Set Version: 01.003 Date: February 28, 2008 DocId: MC55i_ATC_V01.003 Status Confidential / Released GENERAL NOTES - EXCLUSION OF LIABILITY PRODUCT IS DEEMED ACCEPTED BY RECIPIENT AND IS PROVIDED WITHOUT INTERFACE TO RECIPIENT'S PRODUCTS. THE DOCUMENTATION AND/OR PRODUCT ARE PROVIDED FOR TESTING, EVALUATION, INTEGRATION AND INFORMATION PURPOSES. THE DOCUMENTATION AND/OR PRODUCT ARE PROVIDED ON AN "AS IS" BASIS ONLY AND MAY CONTAIN DEFICIENCIES OR INADEQUACIES. THE DOCUMENTATION AND/OR PRODUCT ARE PROVIDED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, SIEMENS FURTHER DISCLAIMS ALL WARRANTIES, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF MERCHANTABILITY, COMPLETENESS, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT OF THIRD-PARTY RIGHTS. THE ENTIRE RISK ARISING OUT OF THE USE OR PERFORMANCE OF THE PRODUCT AND DOCUMENTATION REMAINS WITH RECIPIENT. THIS PRODUCT IS NOT INTENDED FOR USE IN LIFE SUPPORT APPLIANCES, DEVICES OR SYSTEMS WHERE A MALFUNCTION OF THE PRODUCT CAN REASONABLY BE EXPECTED TO RESULT IN PERSONAL INJURY. APPLICATIONS INCORPORATING THE DESCRIBED PRODUCT MUST BE DESIGNED TO BE IN ACCORDANCE WITH THE TECHNICAL SPECIFICATIONS PROVIDED IN THESE GUIDELINES. FAILURE TO COMPLY WITH ANY OF THE REQUIRED PROCEDURES CAN RESULT IN MALFUNCTIONS OR SERIOUS DISCREPANCIES IN RESULTS. FURTHERMORE, ALL SAFETY INSTRUCTIONS REGARDING THE USE OF MOBILE TECHNICAL SYSTEMS, INCLUDING GSM PRODUCTS, WHICH ALSO APPLY TO CELLULAR PHONES MUST BE FOLLOWED. SIEMENS OR ITS SUPPLIERS SHALL, REGARDLESS OF ANY LEGAL THEORY UPON WHICH THE CLAIM IS BASED, NOT BE LIABLE FOR ANY CONSEQUENTIAL, INCIDENTAL, DIRECT, INDIRECT, PUNITIVE OR OTHER DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION OR DATA, OR OTHER PECUNIARY LOSS) ARISING OUT THE USE OF OR INABILITY TO USE THE DOCUMENTATION AND/OR PRODUCT, EVEN IF SIEMENS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING LIMITATIONS OF LIABILITY SHALL NOT APPLY IN CASE OF MANDATORY LIABILITY, E.G. UNDER THE GERMAN PRODUCT LIABILITY ACT, IN CASE OF INTENT, GROSS NEGLIGENCE, INJURY OF LIFE, BODY OR HEALTH, OR BREACH OF A CONDITION WHICH GOES TO THE ROOT OF THE CONTRACT. HOWEVER, CLAIMS FOR DAMAGES ARISING FROM A BREACH OF A CONDITION, WHICH GOES TO THE ROOT OF THE CONTRACT, SHALL BE LIMITED TO THE FORESEEABLE DAMAGE, WHICH IS INTRINSIC TO THE CONTRACT, UNLESS CAUSED BY INTENT OR GROSS NEGLIGENCE OR BASED ON LIABILITY FOR INJURY OF LIFE, BODY OR HEALTH. THE ABOVE PROVISION DOES NOT IMPLY A CHANGE ON THE BURDEN OF PROOF TO THE DETRIMENT OF THE RECIPIENT. SUBJECT TO CHANGE WITHOUT NOTICE AT ANY TIME. THE INTERPRETATION OF THIS GENERAL NOTE SHALL BE GOVERNED AND CONSTRUED ACCORDING TO GERMAN LAW WITHOUT REFERENCE TO ANY OTHER SUBSTANTIVE LAW. Copyright Transmittal, reproduction, dissemination and/or editing of this document as well as utilization of its contents and communication thereof to others without express authorization are prohibited. Offenders will be held liable for payment of damages. All rights created by patent grant or registration of a utility model or design patent are reserved. Copyright © Siemens AG 2008 MC55i_ATC_V01.003 Confidential / Released Page 2 of 479 2/28/08 MC55i AT Command Set s Contents Contents 1. Introduction............................................................................................................................................ 13 1.1 Scope of the document ................................................................................................................. 13 1.2 Related documents ....................................................................................................................... 14 1.3 Document conventions.................................................................................................................. 15 1.3.1 Quick reference table..................................................................................................... 15 1.3.2 Superscript notation for parameters and values ............................................................ 16 1.4 AT Command Syntax .................................................................................................................... 17 1.4.1 Using Parameters .......................................................................................................... 17 1.4.2 Combining AT commands on the same command line ................................................. 18 1.5 Supported character sets .............................................................................................................. 19 1.5.1 GSM alphabet tables and UCS2 character values ........................................................ 21 1.5.2 UCS2 and GSM data coding and conversion for SMS text mode and Remote SAT..... 23 1.5.2.1 Implementing output of SIM data to Terminal (direction TA to TE) ................................ 23 1.5.2.2 Implementing input of Terminal data to SIM (direction TE to TA)................................... 24 1.6 Communication between Customer Application and MC55i ......................................................... 25 1.7 Unsolicited Result Code Presentation........................................................................................... 26 1.8 Errors and Messages .................................................................................................................... 27 1.9 Second Serial Interface ASC1....................................................................................................... 28 1.10 Serial Interface Flow Control ......................................................................................................... 29 1.10.1 Software Flow Control (XON/OFF Handshake)............................................................. 29 1.10.2 Hardware Flow Control (RTS/CTS Handshake) ............................................................ 29 1.11 Common PCN Handset Specification (CPHS) .............................................................................. 30 2. Configuration Commands..................................................................................................................... 31 2.1 AT&F Set all current parameters to manufacturer defaults ......................................................... 31 2.2 AT&V Display current configuration ............................................................................................ 32 2.2.1 AT&V responses............................................................................................................ 33 2.3 AT&W Stores current configuration to user defined profile ......................................................... 34 2.4 ATQ Set result code presentation mode ..................................................................................... 35 2.5 ATV Set result code format mode ............................................................................................... 36 2.5.1 Verbose and numeric result codes ................................................................................ 36 2.6 ATX Set CONNECT result code format and call monitoring ....................................................... 37 2.7 ATZ Set all current parameters to user defined profile................................................................ 38 2.8 AT+CFUN Set phone functionality .............................................................................................. 39 2.8.1 Wake up the ME from SLEEP mode ............................................................................. 43 2.9 AT^SMSO Switch off mobile station............................................................................................ 44 2.10 AT+GCAP Request complete TA capabilities list........................................................................ 45 2.11 AT+CMEE Mobile Equipment Error Message Format ................................................................ 46 2.11.1 CME/CMS Error Code Overview ................................................................................... 47 2.12 AT+CSCS Select TE character set ............................................................................................. 51 2.13 AT^SCFG Extended Configuration Settings ............................................................................... 52 2.14 AT^SM20 Set M20 compatibility mode ....................................................................................... 62 3. Status Control Commands ................................................................................................................... 63 3.1 AT+CMER Mobile Equipment Event Reporting .......................................................................... 63 3.2 AT+CIND Indicator control .......................................................................................................... 65 MC55i_ATC_V01.003 Confidential / Released Page 3 of 479 2/28/08 MC55i AT Command Set s Contents 3.3 3.4 3.5 3.6 3.7 AT^SIND Extended Indicator Control .......................................................................................... 68 AT+CEER Extended Error Report............................................................................................... 74 3.4.1 Cause Location ID for the extended error report ........................................................... 75 3.4.2 SIEMENS L2 cause ....................................................................................................... 76 3.4.3 GSM release cause for L3 Radio Resource (RR).......................................................... 76 3.4.4 SIEMENS release cause for L3 Radio Resource (RR).................................................. 77 3.4.5 GSM release cause for Mobility Management (MM) or Session Management (SM)..... 77 3.4.6 SIEMENS release cause for L3 Mobility Management (MM) ........................................ 78 3.4.7 GSM release cause for L3 Call Control (CC)................................................................. 79 3.4.8 SIEMENS release cause for L3 Call Control (CC)......................................................... 80 3.4.9 SIEMENS release cause for L3 Advice of Charge (AOC) ............................................. 81 3.4.10 GSM Release cause for Supplementary Service Call ................................................... 81 3.4.11 SIEMENS release cause for Call-related Supplementary Services (CRSS) ................. 82 3.4.12 SIEMENS release cause for Session Management (SM) ............................................. 83 3.4.13 GSM cause for L3 Protocol module or other local cause ............................................. 84 3.4.14 SIEMENS release cause for GPRS API ........................................................................ 84 3.4.15 SIEMENS release cause for PPP/IP-Stack ................................................................... 84 ATS18 Extended call release report............................................................................................ 85 AT+CPAS Mobile equipment activity status ................................................................................ 87 AT+WS46 Select wireless network ............................................................................................. 88 4. Serial Interface Control Commands..................................................................................................... 89 4.1 AT\Q Flow control........................................................................................................................ 89 4.2 AT&C Set Data Carrier Detect (DCD) Line mode ....................................................................... 90 4.3 AT&D Set Data Terminal Ready (DTR) line mode ...................................................................... 91 4.4 AT&S Set Data Set Ready (DSR) line mode............................................................................... 92 4.5 ATE Enable command echo........................................................................................................ 93 4.6 AT+ILRR Set TE-TA local rate reporting ..................................................................................... 94 4.7 AT+IPR Set Bitrate of local Asynchronous Serial Interface ........................................................ 96 4.7.1 Autobauding................................................................................................................... 97 4.8 AT+CMUX Enter multiplex mode ................................................................................................ 99 4.8.1 Restrictions on Multiplex mode.................................................................................... 100 5. Security Commands ............................................................................................................................ 102 5.1 AT+CPIN PIN Authentication .................................................................................................... 102 5.1.1 What to do if PIN or password authentication fails? .................................................... 104 5.2 AT+CPIN2 PIN2 Authentication ................................................................................................ 106 5.3 AT^SPIC Display PIN counter ................................................................................................... 108 5.4 AT+CLCK Facility lock .............................................................................................................. 112 5.5 AT^SLCK Facility lock ............................................................................................................... 117 5.6 AT+CPWD Change Password .................................................................................................. 118 5.7 AT^SPWD Change Password ................................................................................................... 122 6. Identification Commands.................................................................................................................... 123 6.1 ATI Display product identification information ........................................................................... 123 6.2 AT+CGMI Request manufacturer identification......................................................................... 124 6.3 AT+GMI Request manufacturer identification ........................................................................... 124 6.4 AT+CGMM Request model identification .................................................................................. 125 6.5 AT+GMM Request model identification..................................................................................... 125 6.6 AT+CGMR Request revision identification of software status................................................... 126 MC55i_ATC_V01.003 Confidential / Released Page 4 of 479 2/28/08 MC55i AT Command Set s Contents 6.7 6.8 6.9 6.10 AT+GMR Request revision identification of software status ..................................................... 126 AT+CGSN Request International Mobile Equipment Identity (IMEI) ......................................... 127 AT+GSN Request International Mobile Equipment Identity (IMEI) ........................................... 127 AT+CIMI Request International Mobile Subscriber Identity (IMSI)............................................ 128 7. Call related Commands....................................................................................................................... 129 7.1 Call Status Information ................................................................................................................ 129 7.2 ATA Answer a call ..................................................................................................................... 130 7.3 ATD Mobile originated call to specified number ........................................................................ 131 7.4 ATD>Mobile originated call using specific memory and index number ................. 133 7.5 ATD> Mobile originated call from active memory using index number ............................... 135 7.6 ATD> Mobile originated call from active memory using corresponding field .................... 136 7.7 ATDI Mobile originated call to ISDN number............................................................................. 137 7.8 ATDL Redial last number used ................................................................................................. 138 7.9 ATH Disconnect existing connection......................................................................................... 139 7.10 AT+CHUP Hang up call ............................................................................................................ 140 7.11 ATS0 Set number of rings before automatically answering a call ............................................. 141 7.12 ATS6 Set pause before blind dialing ......................................................................................... 142 7.13 ATS7 Set number of seconds to wait for connection completion .............................................. 143 7.14 ATS8 Set number of seconds to wait for comma dialing modifier............................................. 144 7.15 ATS10 Set disconnect delay after indicating the absence of data carrier ................................. 145 7.16 ATO Switch from command mode to data mode / PPP online mode........................................ 146 7.17 +++ Switch from data mode to command mode ....................................................................... 147 7.18 AT+CBST Select bearer service type ....................................................................................... 148 7.19 AT+CRLP Select radio link protocol parameters for originated non-transparent data calls ...... 149 7.20 AT+CLCC List of current calls ................................................................................................... 150 7.21 AT^SLCC Extended list of current calls .................................................................................... 152 7.22 AT+CR Service reporting control .............................................................................................. 157 7.23 AT+CRC Set Cellular Result Codes for incoming call indication .............................................. 158 7.24 AT+CSNS Single Numbering Scheme ...................................................................................... 159 7.25 AT^SCNI List Call Number Information ..................................................................................... 160 7.26 AT^SLCD Display Last Call Duration ........................................................................................ 161 7.27 AT^STCD Display Total Call Duration....................................................................................... 162 7.28 ATP Select pulse dialing ........................................................................................................... 163 7.29 ATT Select tone dialing ............................................................................................................. 163 7.30 ATS2 Set escape sequence character...................................................................................... 164 8. Network Service Commands .............................................................................................................. 165 8.1 AT+COPN Read operator names ............................................................................................. 165 8.2 AT+COPS Operator Selection .................................................................................................. 166 8.3 AT^SOPS Extended Operator Selection ................................................................................... 169 8.4 AT+CREG Network registration ................................................................................................ 171 8.5 AT+CSQ Signal quality ............................................................................................................. 174 8.6 AT^SMONC Cell Monitoring...................................................................................................... 175 8.7 AT^SMOND Cell Monitoring...................................................................................................... 177 8.8 AT^MONI Monitor idle mode and dedicated mode ................................................................... 180 8.8.1 AT^MONI responses.................................................................................................... 181 8.8.2 Service states .............................................................................................................. 182 8.9 AT^MONP Monitor neighbour cells ........................................................................................... 183 8.9.1 AT^MONP responses .................................................................................................. 184 MC55i_ATC_V01.003 Confidential / Released Page 5 of 479 2/28/08 MC55i AT Command Set s Contents 8.10 AT^SMONG GPRS Monitor ...................................................................................................... 185 8.10.1 AT^SMONG Cell Info Table......................................................................................... 186 8.11 AT^SALS Alternate Line Service............................................................................................... 187 8.12 AT^SHOM Display Homezone .................................................................................................. 189 8.13 AT^SPLM Read the PLMN list .................................................................................................. 190 8.14 AT+CPOL Preferred Operator List ............................................................................................ 191 8.15 AT^SPLR Read entry from the preferred operators list............................................................. 192 8.16 AT^SPLW Write an entry to the preferred operators list ........................................................... 193 9. Supplementary Service Commands .................................................................................................. 194 9.1 AT+CACM Accumulated call meter (ACM) reset or query ........................................................ 194 9.2 AT^SACM Advice of charge and query of ACM and ACMmax ................................................. 195 9.3 AT+CAMM Accumulated call meter maximum (ACMmax) set or query.................................... 197 9.4 AT+CAOC Advice of Charge information .................................................................................. 198 9.5 AT+CCUG Closed User Group ................................................................................................. 199 9.6 AT+CCFC Call forwarding number and conditions control ....................................................... 201 9.7 AT+CCWA Call Waiting ............................................................................................................ 205 9.8 AT+CHLD Call Hold and Multiparty........................................................................................... 209 9.9 AT+CLIP Calling Line Identification Presentation ..................................................................... 211 9.10 AT+CLIR Calling Line Identification Restriction ........................................................................ 213 9.11 AT+COLP Connected Line Identification Presentation ............................................................. 214 9.12 AT+CPUC Price per unit and currency table............................................................................. 216 9.13 AT+CSSN Supplementary service notifications ........................................................................ 218 9.14 AT+CUSD Unstructured supplementary service data ............................................................... 220 10. Internet Service Commands ............................................................................................................... 222 10.1 AT^SICS Internet Connection Setup Profile.............................................................................. 225 10.1.1 Example: Default values of a CSD connection profile ................................................. 227 10.1.2 Example: GPRS connection profile ............................................................................. 228 10.2 AT^SICI Internet Connection Information.................................................................................. 229 10.2.1 Checking Connection Profile Status ............................................................................ 230 10.3 AT^SISS Internet Service Setup Profile .................................................................................... 231 10.4 AT^SISI Internet Service Information ........................................................................................ 240 10.5 AT^SISO Internet Service Open ............................................................................................... 242 10.5.1 Example: Accepting / Rejecting Socket Connection Request from Remote Client ..... 245 10.6 AT^SISC Internet Service Close ............................................................................................... 247 10.7 AT^SISR Internet Service Read Data ....................................................................................... 248 10.7.1 Example: Socket Host Reads Small Amounts of UDP Data Packets (URC Mode)..... 249 10.8 AT^SISW Internet Service Write Data....................................................................................... 251 10.8.1 Usage of parameter ................................................................................... 253 10.9 AT^SISE Internet Service Error Report ..................................................................................... 254 10.10 Internet Service URC "^SIS" ....................................................................................................... 255 10.10.1 Information Elements Related to the Service Application............................................ 256 10.10.2 Information Elements Related to FTP Service............................................................. 257 10.10.3 Information Elements Related to HTTP Service .......................................................... 258 10.10.4 Information Elements Related to POP3 Service.......................................................... 258 10.10.5 Information Elements Related to SMTP Service ......................................................... 258 10.11 Examples of how to Configure and Use Internet Service Profiles............................................... 259 10.11.1 Selecting URC Mode or Polling Mode ......................................................................... 259 10.11.2 Configuring Socket Listener......................................................................................... 259 MC55i_ATC_V01.003 Confidential / Released Page 6 of 479 2/28/08 MC55i AT Command Set s Contents 10.11.3 10.11.4 10.11.5 10.11.6 10.11.7 10.11.8 10.11.9 10.11.10 10.11.11 10.11.12 10.11.13 10.11.14 10.11.15 Configuring Socket Client for Calling a Socket Listener on Another Host ................... 260 Socket Client Sends Data via TCP Connection (Polling Mode)................................... 260 Socket client sends data via TCP connection with URCs............................................ 261 Configuring and Using FTP Download (URC Mode) ................................................... 261 Configuring and Using FTP Upload (URC Mode)........................................................ 262 Configuring SMPT Service Profile ............................................................................... 262 Sending Email (URC Mode) ........................................................................................ 263 Sending Email (Polling Mode) ..................................................................................... 264 Configuring POP3 Service Profile................................................................................ 265 Retrieving Email (URC Mode) ..................................................................................... 266 Retrieving Email (Polling Mode) .................................................................................. 266 HTTP POST (Polling Mode) ........................................................................................ 267 HTTP GET (Polling Mode)........................................................................................... 268 11. GPRS Commands ................................................................................................................................ 269 11.1 AT+CGACT PDP context activate or deactivate ....................................................................... 269 11.2 AT+CGANS Manual response to a network request for PDP context activation ...................... 271 11.3 AT+CGATT GPRS attach or detach ......................................................................................... 273 11.4 AT+CGAUTO Automatic response to a network request for PDP context activation ............... 274 11.5 AT+CGEREP GPRS event reporting ........................................................................................ 276 11.6 AT+CGDATA Enter data state .................................................................................................. 278 11.6.1 Automatic deactivation of PDP context during dial-up PPP......................................... 279 11.7 AT+CGDCONT Define PDP Context ........................................................................................ 280 11.8 AT+CGPADDR Show PDP address ......................................................................................... 282 11.9 AT+CGQMIN Quality of Service Profile (Minimum acceptable) ................................................ 283 11.10 AT+CGQREQ Quality of Service Profile (Requested) .............................................................. 287 11.11 AT+CGREG GPRS Network Registration Status...................................................................... 291 11.12 AT+CGSMS Select service for MO SMS messages ................................................................. 293 11.13 AT^SGAUTH Set type of authentication for PPP connection.................................................... 294 11.14 AT^SGCONF Configuration of GPRS related Parameters ...................................................... 295 11.15 ATA Manual response to a network request for PDP context activation................................... 296 11.16 ATD*99# Request GPRS service.............................................................................................. 297 11.17 ATD*98# Request GPRS IP service ......................................................................................... 298 11.18 ATH Manual rejection of a network request for PDP context activation.................................... 299 11.19 ATS0 Automatic response to a network request for PDP context activation............................. 300 11.20 Using GPRS AT commands (Examples)..................................................................................... 301 11.21 Using the GPRS dial command ATD .......................................................................................... 303 12. FAX Commands ................................................................................................................................... 304 12.1 FAX parameters .......................................................................................................................... 304 12.1.1 Summary of Fax Class 2 URCs defined by EIA PN-2388 ........................................... 306 12.2 AT+FBADLIN Bad Line Threshold ............................................................................................ 307 12.3 AT+FBADMUL Error Threshold Multiplier ................................................................................. 308 12.4 AT+FBOR Query data Bit Order ............................................................................................... 309 12.5 AT+FCIG Query or set the Local Polling ID .............................................................................. 310 12.6 AT+FCLASS Fax: Select, read or test service class ................................................................. 311 12.7 AT+FCQ Copy Quality Checking .............................................................................................. 312 12.8 AT+FCR Capability to Receive ................................................................................................. 313 12.9 AT+FDCC Query or set capabilities .......................................................................................... 314 12.10 AT+FDFFC Data Compression Format Conversion ................................................................. 315 MC55i_ATC_V01.003 Confidential / Released Page 7 of 479 2/28/08 MC55i AT Command Set s Contents 12.11 12.12 12.13 12.14 12.15 12.16 12.17 12.18 12.19 12.20 12.21 12.22 12.23 12.24 12.25 12.26 12.27 12.28 AT+FDIS Query or set session parameters .............................................................................. 316 AT+FDR Begin or continue phase C Data Reception ............................................................... 317 AT+FDT Data Transmission...................................................................................................... 318 AT+FET End a page or document ............................................................................................ 319 AT+FK Kill operation, orderly FAX abort ................................................................................... 320 AT+FLID Query or set the Local Id setting capabilities ............................................................. 321 AT+FMDL Identify Product Model ............................................................................................ 322 AT+FMFR Request Manufacturer Identification ........................................................................ 323 AT+FOPT Set bit Order independently ..................................................................................... 324 AT+FPHCTO DTE Phase C Response Timeout....................................................................... 325 AT+FREV Identify Product Revision ......................................................................................... 326 AT+FRH Receive Data Using HDLC Framing .......................................................................... 327 AT+FRM Receive Data ............................................................................................................. 328 AT+FRS Receive Silence.......................................................................................................... 329 AT+FTH Transmit Data Using HDLC Framing .......................................................................... 330 AT+FTM Transmit Data............................................................................................................. 331 AT+FTS Stop Transmission and Wait ....................................................................................... 332 AT+FVRFC Vertical Resolution Format Conversion ................................................................. 333 13. Short Message Service (SMS) Commands........................................................................................ 334 13.1 SMS parameters ......................................................................................................................... 334 13.2 AT+CMGC Send an SMS command......................................................................................... 338 13.3 AT+CMGD Delete short message............................................................................................. 339 13.4 AT+CMGF Select SMS message format .................................................................................. 340 13.5 AT+CMGL List SMS messages from preferred store................................................................ 341 13.6 AT+CMGR Read SMS messages ............................................................................................. 343 13.7 AT+CMGS Send Short Message .............................................................................................. 345 13.8 AT+CMGW Write Short Messages to Memory ......................................................................... 347 13.9 AT+CMSS Send short messages from storage ........................................................................ 349 13.10 AT+CNMA New Message Acknowledgement to ME/TE, only phase 2+ .................................. 350 13.11 AT+CNMI New short Message Indication ................................................................................. 351 13.12 AT+CPMS Preferred SMS message storage ............................................................................ 354 13.13 AT+CSCA SMS Service Center Address .................................................................................. 356 13.14 AT+CSCB Select Cell Broadcast Message Indication .............................................................. 357 13.15 AT+CSDH Show SMS text mode parameters........................................................................... 358 13.16 AT+CSMP Set SMS text Mode Parameters.............................................................................. 359 13.17 AT+CSMS Select Message Service.......................................................................................... 361 13.18 AT^SLMS List SMS Memory Storage ....................................................................................... 363 13.19 AT^SMGL List Short Messages from preferred store without setting status to REC READ ..... 364 13.20 AT^SMGO Set or query SMS overflow presentation mode or query SMS overflow ................. 365 13.21 AT^SMGR Read short message without setting status to REC READ ..................................... 367 13.22 AT^SSCONF SMS Command Configuration ........................................................................... 368 13.23 AT^SSDA Set SMS Display Availability .................................................................................... 369 13.24 AT^SSMSS Set Short Message Storage Sequence ................................................................. 370 14. SIM related Commands ....................................................................................................................... 371 14.1 AT+CRSM Restricted SIM Access ............................................................................................ 371 14.2 AT^SXSM Extended SIM Access.............................................................................................. 373 14.3 AT^SCKS Query SIM and Chip Card Holder Status ................................................................. 375 14.4 AT^SCID Display SIM card identification number ..................................................................... 377 MC55i_ATC_V01.003 Confidential / Released Page 8 of 479 2/28/08 MC55i AT Command Set s Contents 14.5 AT+CXXCID Display card ID..................................................................................................... 378 15. SIM Application Toolkit (SAT) Commands........................................................................................ 379 15.1 AT^SSTA SAT Interface Activation ........................................................................................... 379 15.2 ^SSTN SAT Notification ............................................................................................................ 381 15.3 AT^SSTGI SAT Get Information ............................................................................................... 382 15.4 AT^SSTR SAT Response ......................................................................................................... 383 16. Phonebook Commands....................................................................................................................... 384 16.1 Sort Order for Phonebooks ......................................................................................................... 384 16.2 AT+CPBR Read from Phonebook............................................................................................. 385 16.3 AT+CPBS Select phonebook memory storage ......................................................................... 388 16.4 AT+CPBW Write into Phonebook ............................................................................................. 390 16.5 AT^SPBC Find first matching entry in sorted phonebook ......................................................... 393 16.6 AT^SPBD Purge phonebook memory storage .......................................................................... 394 16.7 AT^SPBG Display phonebook entries in alphabetical order ..................................................... 395 16.8 AT^SPBS Step through the selected phonebook alphabetically ............................................... 398 16.9 AT+CNUM Read own numbers................................................................................................. 402 16.10 AT^SDLD Delete the 'last number redial' memory .................................................................... 403 17. Audio Commands ................................................................................................................................ 404 17.1 Audio programming model .......................................................................................................... 404 17.2 ATL Set monitor speaker loudness ........................................................................................... 405 17.3 ATM Set monitor speaker mode................................................................................................ 405 17.4 AT+CLVL Loudspeaker volume level........................................................................................ 406 17.5 AT+CMUT Mute control ............................................................................................................ 407 17.6 AT+VTD Tone duration ............................................................................................................. 408 17.7 AT+VTS DTMF and tone generation......................................................................................... 409 17.8 AT^SAIC Audio Interface Configuration .................................................................................... 410 17.9 AT^SNFA Set or query of microphone attenuation .................................................................. 412 17.10 AT^SNFD Set audio parameters to manufacturer default values ............................................. 414 17.11 AT^SNFI Set microphone path parameters .............................................................................. 415 17.12 AT^SNFM Set microphone audio path and power supply......................................................... 416 17.13 AT^SNFO Set audio output (= loudspeaker path) parameter ................................................... 418 17.14 AT^SNFPT Set progress tones ................................................................................................. 420 17.15 AT^SNFS Select audio hardware set ........................................................................................ 421 17.16 AT^SNFTTY Signal TTY/CTM audio mode capability............................................................... 424 17.17 AT^SNFV Set loudspeaker volume ........................................................................................... 426 17.18 AT^SNFW Write audio setting in non-volatile store .................................................................. 427 17.19 AT^SRTC Ring tone configuration ............................................................................................ 428 18. Hardware Related Commands............................................................................................................ 430 18.1 AT+CCLK Real Time Clock....................................................................................................... 430 18.2 AT+CALA Set alarm time ......................................................................................................... 431 18.3 AT^SBC Battery Charge Control ............................................................................................... 434 18.3.1 Responses returned by read command....................................................................... 436 18.4 AT^SBV Battery/Supply Voltage ............................................................................................... 437 18.5 AT^SCTM Set critical operating temperature presentation mode or query temperature........... 438 18.5.1 Deferred shutdown ...................................................................................................... 440 18.6 AT^SSYNC Configure SYNC Pin .............................................................................................. 441 18.6.1 ME status indicated by status LED patterns ................................................................ 442 MC55i_ATC_V01.003 Confidential / Released Page 9 of 479 2/28/08 MC55i AT Command Set s Contents 19. Miscellaneous Commands.................................................................................................................. 443 19.1 A/ Repeat previous command line ............................................................................................ 443 19.2 ATS3 Set command line termination character......................................................................... 444 19.3 ATS4 Set response formatting character .................................................................................. 445 19.4 ATS5 Write command line editing character ............................................................................. 446 20. Appendix .............................................................................................................................................. 447 20.1 Restricted access to SIM data after SIM PIN authentication....................................................... 447 20.2 Star-Hash (*#) Network Commands............................................................................................ 448 20.3 Available AT Commands and Dependency on SIM PIN ............................................................. 451 20.4 Availability of AT Commands Depending on Operating Mode of ME.......................................... 458 20.5 AT Command Settings storable with AT&W................................................................................ 465 20.6 Factory Default Settings Restorable with AT&F .......................................................................... 468 20.7 Summary of Unsolicited Result Codes (URC)............................................................................. 471 20.8 Alphabetical List of AT Commands ............................................................................................. 474 MC55i_ATC_V01.003 Confidential / Released Page 10 of 479 2/28/08 MC55i AT Command Set s List of Tables List of Tables Table 1.1: Table 1.2: Table 1.3: Table 1.4: Table 1.5: Table 2.1: Table 2.2: Table 2.3: Table 2.4: Table 2.5: Table 2.6: Table 2.7: Table 4.1: Table 4.2: Table 10.1: Table 10.2: Table 12.1: Table 18.1: Table 20.1: Table 20.2: Table 20.3: Table 20.4: Table 20.5: Table 20.6: Table 20.7: Table 20.8: Table 20.9: Table 20.10: Table 20.11: Symbols used to mark the type of parameters ........................................................................... 16 Symbols used to indicate the correlations with other commands ............................................... 16 Symbols used to mark different types of default values of parameters ..................................... 16 Types of AT commands and responses .................................................................................... 17 Examples for character definitions depending on alphabet ........................................................ 19 Current configuration on ASC0 / MUX channel 1 (example) ...................................................... 33 Current configuration on ASC1 and MUX channels 2 and 3 (example) .................................... 33 Wake-up events in NON-CYCLIC and CYCLIC SLEEP modes ................................................. 43 General "CME ERROR" Codes (GSM 07.07) .......................................................................... 47 General "CME ERROR" Codes (SIEMENS) ............................................................................ 48 GPRS related "CME ERROR" Codes (GSM 07.07) ................................................................. 48 SMS related "CMS ERROR" Codes (GSM 07.05) ................................................................... 48 Availability of AT Commands on Virtual Channels .................................................................. 100 Summary of AT commands with Different Behavior in Multiplex Mode ................................... 101 Applicability of AT^SICS values ................................................................... 225 Applicability of AT^SISS values ................................................................... 231 Summary of Fax Class 2 URCs defined by EIA PN-2388 ........................................................ 306 Modes of the LED and indicated ME functions......................................................................... 442 Star-Hash (*#) Command Overview ........................................................................................ 448 Abbreviations of Codes and Parameters used in Table 20.1 .................................................. 449 Star-Hash Command Response Parameters .......................................................................... 450 Star-Hash Commands for Supplementary Services ................................................................ 450 Available AT Commands and Dependency on SIM PIN........................................................... 451 Availability of AT Commands Depending on Operating Mode of ME ....................................... 458 Settings Stored to User Profile on ASC0 / MUX Channel 1...................................................... 465 Settings Stored to User Profile on ASC1 / MUX Channels 2 and 3.......................................... 466 Factory Default Settings Restorable with AT&F ....................................................................... 468 Summary of Unsolicited Result Codes (URC) .......................................................................... 471 Alphabetical List of AT Commands........................................................................................... 474 MC55i_ATC_V01.003 Confidential / Released Page 11 of 479 2/28/08 MC55i AT Command Set s List of Figures List of Figures Figure 1.1: Figure 1.2: Figure 17.1: Main character table of GSM 03.38 alphabet ............................................................................. 21 Extension character table of GSM 03.38 alphabet ..................................................................... 22 Audio programming model for MC55i Module .......................................................................... 404 MC55i_ATC_V01.003 Confidential / Released Page 12 of 479 2/28/08 MC55i AT Command Set s 1. Introduction 1. Introduction 1.1 Scope of the document This document presents the AT Command Set for the Siemens Cellular Engine MC55i Release 01.003. Before using the Cellular Engine or upgrading to a new firmware version please read the latest product information provided in the Release Notes [1]. More information is available at the Siemens Website: http://www.siemens.com/wm. MC55i_ATC_V01.003 Confidential / Released Page 13 of 479 2/28/08 MC55i AT Command Set s 1.2 Related documents 1.2 Related documents [1] MC55i Release Notes, Version 01.003 [2] MC55i Hardware Interface Description, Version 01.003 [3] Remote-SAT User's Guide [4] GPRS Startup User's Guide [5] Multiplexer User's Guide [6] Multiplex Driver Developer's Guide for Windows 2000 and Windows XP [7] Multiplex Driver Installation Guide for Windows 2000 and Windows XP [8] Application Note 02: Audio Interface Design [9] Application Note 16: Updating MC55i Firmware [10] Application Note 22: Using TTY / CTM equipment with MC55i [11] Application Note 24: Application Developer's Guide [12] ISO/IEC10646: "Universal Multiple-Octet Coded Character Set (UCS)"; UCS2, 16 bit coding [13] ITU-T Recommendation V.24: List of definitions for interchange circuits between data terminal equipment (DTE) and data circuit-terminating equipment (DCE) [14] ITU-T Recommendation V.250: Serial asynchronous automatic dialling and control [15] 3GPP TS 100 918/EN 300 918 (GSM 02.04): General on supplementary services [16] 3GPP TS 100 907 (GSM 02.30): Man-Machine Interface (MMI) of the Mobile Station (MS) [17] 3GPP TS 23.038 (GSM 03.38): Alphabets and language specific information [18] 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) [19] 3GPP TS 27.007 (GSM 07.07): AT command set for User Equipment (UE) [20] 3GPP TS 27.060 (GSM 07.60): Mobile Station (MS) supporting Packet Switched Services [21] 3GPP TS 51.011 (GSM 11.11): Specification of the Subscriber Identity Module - Mobile Equipment (SIM - ME) interface [22] 3GPP TS 11.14 (GSM 11.14): Specification of the SIM Application Toolkit for the Subscriber Identity Module - Mobile Equipment (SIM - ME) interface [23] 3GPP TS 22.101 (GSM 22.101): Service principles [24] Common PCN Handset Specification (CPHS) v4.2 MC55i_ATC_V01.003 Confidential / Released Page 14 of 479 2/28/08 MC55i AT Command Set s 1.3 Document conventions 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) or 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 plainly '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). 1.3.1 Quick reference table Each AT command description includes a table similar to the example shown below. The table is intended as a quick reference to indicate the following functions: PIN: Is the AT command PIN protected? + Yes No ± Usage is dependent on conditions specified for the command, or not all command types are PIN protected (for example write command PIN protected, read command not). Note: The table provided in Section 20.3, Available AT Commands and Dependency on SIM PIN uses the same symbols. ASC0: Is the AT command supported on the first physical serial interface ASC0? + Yes No ASC1: Is the AT command supported on the second physical serial interface ASC1? + Yes No MUXn: Is the AT command usable on the Multiplexer channels MUX1, MUX2, MUX3? + Yes No ± AT command is usable, but under the restrictions specified in the section related to the command. Note: The columns MUX1, MUX2 and MUX3 are relevant only when the GSM engine operates in Multiplexer mode, that is, when the first physical serial interface is partitioned into 3 virtual channels by using the Multiplexer protocol. Usage is the same on ASC0 and MUX1. Is the AT command supported in ALARM mode? + Yes No Charge: Is the AT command supported in CHARGE ONLY mode? + Yes No ± AT command is usable, but under the restrictions specified in the section related to the command. Last: If commands are concatenated, this AT command must be the last one. + Yes No Note: See also Section 1.4, AT Command Syntax for details on concatenated AT commands. Example: PIN - ASC0 ASC1 + + MUX1 MUX2 MUX3 ± ± ± MC55i_ATC_V01.003 Confidential / Released Charge + - Last - Page 15 of 479 2/28/08 MC55i AT Command Set s 1.3 Document conventions 1.3.2 Table 1.1: Superscript notation for parameters and values Symbols used to mark the type of parameters Parameter type Meaning (num) Parameter value must be numeric type (str) Parameter value must be string type Table 1.2: Symbols used to indicate the correlations with other commands Parameter option Meaning (&W) Parameter value will be stored with AT&W (&V) Parameter value will be displayed with AT&V (ˆSNFW) Parameter value will be stored with AT^SNFW (+CSCS) Parameter value has to be (is) coded according to current setting of (see AT+CSCS for details) Table 1.3: Symbols used to mark different types of default values of parameters Value option Meaning [x] Default value: if the parameter is omitted, the value 'x' will be assumed x (&F) Factory default value, will be restored to 'x' with AT&F x (P) Powerup default value of a parameter which is not stored at power down x (D) Delivery default value of a parameter which cannot be restored automatically MC55i_ATC_V01.003 Confidential / Released Page 16 of 479 2/28/08 MC55i AT Command Set s 1.4 AT Command Syntax 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 command type Syntax Function Test command AT+CXXX=? The mobile equipment returns the list of parameters and value ranges set with the corresponding Write command or by internal processes. Read command AT+CXXX? This command returns the currently set value of the parameter or parameters. Write command AT+CXXX=<...> This command sets user-definable parameter values. Exec(ution) command AT+CXXX 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=5 OK AT+CFUN? +CFUN: 5 OK AT+CFUN= OK +CFUN: 1 OK MC55i_ATC_V01.003 Confidential / Released Activate CYCLIC SLEEP mode, don't reset ME Query ME mode Set ME back to normal (default parameters: 1,0) Page 17 of 479 2/28/08 MC55i AT Command Set s 1.4 AT Command Syntax 1.4.2 Combining AT commands on the same command line You may enter several AT commands on the same line. This eliminates the need to type the "AT" or "at" prefix before each command. Instead, it is only needed 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 Siemens commands, Prefix AT^S) GSM 7.05 commands (SMS) To be used standalone Commands starting with AT& To be used standalone AT+IPR To be used standalone 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 the associated responses is your concern, avoid concatenating commands on the same line. MC55i_ATC_V01.003 Confidential / Released Page 18 of 479 2/28/08 MC55i AT Command Set s 1.5 Supported character sets 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 an 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. When you enter characters that are not valid characters of the supported alphabets the behavior 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. 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. Regardless of the selected alphabet, keep in mind that, when software flow control is activated, decimal 17 and 19 are interpreted as XON/XOFF control characters. 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 \ \5C 5C 35 43 MC55i_ATC_V01.003 Confidential / Released Page 19 of 479 2/28/08 MC55i AT Command Set s 1.5 Supported character sets GSM 03.38 character GSM character hex. value Corresponding ASCII character ASCII Esc sequence Hex Esc sequence " 22 " \22 5C 32 32 @ 00 NULL \00 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. MC55i_ATC_V01.003 Confidential / Released Page 20 of 479 2/28/08 MC55i AT Command Set s 1.5 Supported character sets 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. (For related mapping definition see: http://www.unicode.org/Public/MAPPINGS/ETSI/GSM0338.TXT) Figure 1.1: Main character table of GSM 03.38 alphabet 1) This code is an escape to the following extension of the 7 bit default alphabet table. 2) This code is not a printable character and therefore not defined for the UCS2 alphabet. It shall be treated as the accompanying control character. 3) As the standard GSM alphabet does not provide a backspace functionality the MC55i is designed to use the GSM character 08 (hex 0x08) as backspace. This allows the user to easily erase the last character when using an ASCII terminal. On the other hand, this solution requires entering the escape sequence \08 for writing the "ò" character in GSM alphabet. MC55i_ATC_V01.003 Confidential / Released Page 21 of 479 2/28/08 MC55i AT Command Set s 1.5 Supported character sets 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. MC55i_ATC_V01.003 Confidential / Released Page 22 of 479 2/28/08 MC55i AT Command Set s 1.5 Supported character sets 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). 1.5.2 UCS2 and GSM data coding and conversion for SMS text mode and Remote SAT This section provides basic information on how to handle input and output character conversion for SMS text mode and Remote SAT if internal (TA) and external (TE) character representation differ, i.e. 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 set DCS = 7 bit GSM DCS = 8 bit Data DCS = 16 bit UCS2 GSM Case 1 GSM (1:1) Case 2 8 bit to IRA (1:2) Case 3 UCS2 to IRA (2:4) Case 4 Case 5 GSM to IRA (1:4) 8 bit to IRA (1:4) Note: The ratio of SIM bytes to output bytes is given in parentheses. Case 6 UCS2 to IRA (2:4) UCS2 Case 1 Every GSM character is sent to the 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 is sent to the 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 the 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 the 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 the 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 the 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" MC55i_ATC_V01.003 Confidential / Released Page 23 of 479 2/28/08 MC55i AT Command Set s 1.5 Supported character sets 1.5.2.2 Implementing input of Terminal data to SIM (direction TE to TA) Used character set DCS = 7 bit GSM DCS = 8 bit Data DCS = 16 bit UCS2 GSM Case 1 GSM (1:1) Case 2 IRA to 8 bit (2:1) Case 3 IRA to 16 bit (4:2) UCS2 Case 4 Case 5 Case 6 UCS2 to GSM (4:1) UCS2 to 8 bit (4:1) UCS2 to 16 bit (4:2) 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 standard terminal emulation, e.g. 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'H) Case 2 Every data byte is sent 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 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 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. MC55i_ATC_V01.003 Confidential / Released Page 24 of 479 2/28/08 MC55i AT Command Set 1.6 Communication between Customer Application and MC55i 1.6 s Communication between Customer Application and MC55i Leaving hardware flow control unconsidered the Customer Application (TE) is coupled with the MC55i (ME) via a receive and a transmit line. Since both lines are driven by independent devices collisions may (and will) happen. For example, if the TE issues an AT command the MC55i starts sending a URC. This will probably cause the TE to misinterpret 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 MC55i 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 MC55i using activated echo (ATE1), i.e. the MC55i 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. MC55i_ATC_V01.003 Confidential / Released Page 25 of 479 2/28/08 MC55i AT Command Set s 1.7 Unsolicited Result Code Presentation 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, i.e. 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 1 second, i.e. the RING line changes to the physical "Low" level. This allows the TE to stay in power saving mode until an ME related event requests service. If several URCs occur coincidently or in quick succession each URC triggers the RING line independently, although the line will not be deactivated between each URC. As a result, the RING line may stay low for more than 1 second. If an incoming call is answered within less than 1 second (with ATA or if autoanswering is set to ATS0=1) than 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 MC55i, 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. 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" and the Fax Class 2 URCs listed in Section 12.1, FAX parameters. If autobauding is enabled (as factory default mode or set withAT+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.7.1, Autobauding. To avoid problems we recommend to configure a fixed bit rate rather than using autobauding. MC55i_ATC_V01.003 Confidential / Released Page 26 of 479 2/28/08 MC55i AT Command Set s 1.8 Errors and Messages 1.8 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.11.1, CME/CMS Error Code Overview • Section 2.5.1, Verbose and numeric result codes • Section 3.4, AT+CEER MC55i_ATC_V01.003 Confidential / Released Page 27 of 479 2/28/08 MC55i AT Command Set s 1.9 Second Serial Interface ASC1 1.9 Second Serial Interface ASC1 The second serial interface ASC1 is designed as an auxiliary interface for applications which need multiple parallel access to the module (e.g. to query status information on ASC1 while a data connection is in progress on ASC0). Therefore the second interface provides only limited functionality: • Multiplex mode according to GSM 07.10 and 3G TS 27.010 is not supported on ASC1. • DTR, DSR, DCD, RING hardware lines do not exist on ASC1. AT commands for controlling the behavior of these lines (AT&D, AT&C, AT&S) are not allowed and return ERROR. • No presentation of ^SYSSTART URCs on ASC1. After restart or reset of the ME, either check that the URC has been sent on ASC0 or wait approximately 3 seconds before entering the first AT command on ASC1. • No CSD calls, so all related AT commands cannot be used and return ERROR, such as AT+CBST, ATS7, AT+CRLP. • No fax calls, so all AT+F commands cannot be used and return ERROR. • When you set up packet switched connections take care that your application uses only AT commands, parameters and signal lines supported on the ASC1 interface. For example, keep in mind that Microsoft Dialup connections are typically trying to request the DCD line status and that common modem drivers use to send commands such as AT+CBST, ATS7 (not supported on ASC1). • No Autobauding. The hardware is not capable of automatically detecting the baudrate on this interface, so the AT command which selects autobauding (AT+IPR=0) is not allowed and returns ERROR. ASC1 is disabled when the multiplexer is enabled on the first serial interface ASC0. Yet, both ASC1 and the multiplexer channel 2 are using the same parameters, and thus, the same user defined profile (if any). As a result, a user profile stored on multiplexer channel 2 takes effect on ASC1 after closing the multiplexer and starting up ASC1. Likewise, a user profile stored on ASC1 will be loaded on multiplexer channel 2. This may be a problem when ASC1 is not connected, but flow control (for example AT\Q1 or AT\Q3) is stored to the user profile on the multiplexer channel 2. In this case, flow control takes effect on ASC1, when the multiplexer is switched off. If then for example a large amount of URCs is generated, their transmission might be stopped due to the flow control. To avoid this problem we recommend that you do not activate flow control on multiplexer channel 2 when you set up a user profile with AT&W. MC55i_ATC_V01.003 Confidential / Released Page 28 of 479 2/28/08 MC55i AT Command Set s 1.10 Serial Interface Flow Control 1.10 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 (HWM) of the input/output buffer should be set to approximately 60% of the total buffer size, the Low Watermark (LWM) is recommended to be about 30%. The data flow should be stopped when the buffer 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. 1.10.1 Software Flow Control (XON/OFF Handshake) Software flow control can be used to control the data flow in both directions from DTE to MC55i and from MC55i to DTE. Software flow control uses different characters to stop (XOFF, decimal 19) and resume (XON, decimal 17) data flow. Hence, all data that represent XON or XOFF characters will be interpreted as control characters. This applies also to characters included within the data stream to be transmitted (usually plain ASCII text files do not inlude such characters). The only advantage of software flow control is that three wires would be sufficient on the serial interface. 1.10.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 HWM is reached, CTS is set inactive. When the LWM is passed, CTS goes active again. To achieve smooth data flow, ensure that the RTS/CTS lines are present on your application platform. Configuring hardware flow control • • • • Hardware flow control must be set on both sides: with AT\Q3 in the ME and an equivalent RTS/CTS handshake option in the host application. The default setting of the ME 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 rebooting the ME. AT\Q has no read command. To verify the current setting of AT\Q, 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. Buffer design considerations • After deactivating the RTS line, the ME may still send up to 264 bytes (worst case). This can be easily handled if the buffer of the host application is sufficiently sized, and if a hysteresis is implemented regarding its Rx buffer. For host applications that are required to handle a large amount of data at high speed, a total buffer capacity of 512 bytes is recommended. MC55i_ATC_V01.003 Confidential / Released Page 29 of 479 2/28/08 MC55i AT Command Set 1.11 Common PCN Handset Specification (CPHS) 1.11 s 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 Using two phone numbers with one SIM card. AT^SALS Voice Message Waiting Indication Indicate the receipt of a short message coded as Voice Mes- AT^SIND, sage Waiting Indicator as defined by the CPHS Phase 2 AT+CMER, indicators standard. "vmwait1" and "vmwait2" Operator (Service provider) name from SIM Read specific Elementary Files (6F14h, 6F18h) from SIM. AT+CRSM Network and Service Pro- Lock/Unlock an ME to specific HPLMN and service provider. AT+CLCK, vider Lock (AT+CPIN) Call Forwarding Get and set diverted call status. Access specific Elementary File (6F13h) from SIM. AT+CCFC, AT+CRSM Customer Service Profile (CSP) Setting services and their menu entries depending on customer profiles. AT+CRSM Information numbers Hierarchically structured service numbers phonebook on SIM according to CPHS 4.2 (mandatory). AT+CRSM MC55i_ATC_V01.003 Confidential / Released Page 30 of 479 2/28/08 MC55i AT Command Set s 2. Configuration Commands 2. Configuration Commands The AT Commands described in this chapter allow the external application to determine the MC55i's behaviour under various conditions. 2.1 AT&F Set all current parameters to manufacturer defaults 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). Syntax Exec Command AT&F[ ] Response(s) OK Reference(s) PIN V.250 - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (num) [0] Set 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. MC55i_ATC_V01.003 Confidential / Released Page 31 of 479 2/28/08 MC55i AT Command Set s 2.2 AT&V 2.2 AT&V Display current configuration 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). Syntax Exec Command AT&V[ ] Response(s) ACTIVE PROFILE: ... (see Section 2.2.1, AT&V responses) OK Reference(s) PIN V.250 - ASC0 ASC1 + ± MUX1 MUX2 MUX3 + ± ± Charge - - Last - Parameter Description (num) [0] Profile number Notes • 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 PDU mode, see AT+CMGF. MC55i_ATC_V01.003 Confidential / Released Page 32 of 479 2/28/08 MC55i AT Command Set s 2.2 AT&V 2.2.1 AT&V responses The following tables show four different kinds of responses depending on whether or not the PIN is entered and whether or not the Multiplex mode is enabled (see AT+CMUX). Table 2.1: Current configuration on ASC0 / MUX channel 1 (example) PIN authentication done No PIN authentication ACTIVE PROFILE: E1 Q0 V1 X4 &C1 &D2 &S0 \Q0 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: 1 +CSDH: 0 +CNMI: 0,0,0,0,1 +ILRR: 0 +IPR: 57600 +CMEE: 2 ^SMGO: 0,0 +CSMS: 0,1,1,1 ^SACM: 0,"000000","000000" ^SLCC: 0 ^SCKS: 0,1 +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 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 +ILRR: 0 +IPR: 57600 +CMEE: 2 ^SCKS: 0,1 OK Table 2.2: Current configuration on ASC1 and MUX channels 2 and 3 (example) PIN authentication done No PIN authentication ACTIVE PROFILE: E1 Q0 V1 X4 &C1 &D0 &S0 \Q0 S0:000 S3:013 S4:010 S5:008 +CR: 0 +CRC: 0 +CMGF: 1 +CSDH: 0 +CNMI: 0,0,0,0,1 +ILRR: 0 +IPR: 57600 +CMEE: 2 ^SMGO: 0,0 +CSMS: 0,1,1,1 ^SACM: 0,"000000","000000" ^SLCC: 0 ^SCKS: 0,1 +CREG: 0,1 +CLIP: 0,2 +CAOC: 0 +COPS: 0,0,"operator" +CGSMS: 3 OK ACTIVE PROFILE: E1 Q0 V1 X4 &C1 &D0 &S0 \Q0 S0:000 S3:013 S4:010 S5:008 +CR: 0 +ILRR: 0 +IPR: 57600 +CMEE: 2 ^SCKS: 0,1 +CGSMS: 3 OK MC55i_ATC_V01.003 Confidential / Released Page 33 of 479 2/28/08 MC55i AT Command Set s 2.3 AT&W 2.3 AT&W Stores current configuration to user defined profile AT&W stores the currently set parameters to a user defined profile in the non-volatile memory. Syntax Exec Command AT&W[ ] Response(s) OK ERROR/+CME ERROR Reference(s) PIN V.250 - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (num) [0] Number of 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. • AT&W stores all global settings and the current local 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. MC55i_ATC_V01.003 Confidential / Released Page 34 of 479 2/28/08 MC55i AT Command Set s 2.4 ATQ 2.4 ATQ Set result code presentation mode 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. Syntax Exec Command ATQ[ ] Response(s) If =0: OK If =1: (none) Reference(s) V.250 PIN ASC0 ASC1 - + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (num)(&W)(&V) [0](&F) DCE transmits result code 1 Result codes are suppressed and not transmitted MC55i_ATC_V01.003 Confidential / Released Page 35 of 479 2/28/08 MC55i AT Command Set s 2.5 ATV 2.5 ATV Set result code format mode This command determines the contents of 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. Syntax Exec Command ATV[ ] Response(s) OK ERROR Reference(s) PIN V.250 - ASC0 ASC1 + MUX1 MUX2 MUX3 + + + + Charge - - Last - Parameter Description (num)(&W)(&V) [0] Information response: Short result code format: 1(&F) Information response: Long result code format: 2.5.1 Verbose and numeric result codes Verbose format Numeric format Meaning OK 0 Command executed, no errors CONNECT 1 Link established RING 2 Ring detected NO CARRIER 3 Link not established or disconnected ERROR 4 Invalid command or command line too long NO DIALTONE 6 No dial tone, dialling impossible, wrong mode BUSY 7 Remote station busy CONNECT 2400/RLP 47 Link with 2400 bps and Radio Link Protocol CONNECT 4800/RLP 48 Link with 4800 bps and Radio Link Protocol CONNECT 9600/RLP 49 Link with 9600 bps and Radio Link Protocol CONNECT 14400/RLP 50 Link with 14400 bps and Radio Link Protocol ALERTING Alerting at called phone DIALING Mobile phone is dialing MC55i_ATC_V01.003 Confidential / Released Page 36 of 479 2/28/08 MC55i AT Command Set s 2.6 ATX 2.6 ATX Set CONNECT result code format and call monitoring 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. Syntax Exec Command ATX[ ] Response(s) OK ERROR Reference(s) V.250 PIN - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (num)(&W)(&V) [0] CONNECT result code only returned, dial tone and busy detection are both disabled. 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(&F) CONNECT result code returned, dial tone and busy detection are both enabled. MC55i_ATC_V01.003 Confidential / Released Page 37 of 479 2/28/08 MC55i AT Command Set s 2.7 ATZ 2.7 ATZ Set all current parameters to user defined profile 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). The user defined profile is stored to the non-volatile memory. Syntax Exec Command ATZ[ ] Response(s) OK Reference(s) PIN V.250 - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (num) [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. MC55i_ATC_V01.003 Confidential / Released Page 38 of 479 2/28/08 MC55i AT Command Set s 2.8 AT+CFUN 2.8 AT+CFUN Set phone functionality The AT+CFUN command serves to control the functionality level of the 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. Further information, particularly power supply ratings during the various operating modes and the timing of hardware signals in SLEEP mode can be found in the "MC55i Hardware Interface Description, Version 01.003". SLEEP mode falls in two categories: • NON-CYCLIC SLEEP mode =0 • and CYCLIC SLEEP modes, selectable as = 5, 6, 7, 8 or 9. NON-CYCLIC SLEEP mode permanently blocks the serial interface. The CYCLIC SLEEP mode, however, is a dynamic process which alternatingly enables and disables the serial interface. The major benefit of all CYCLIC SLEEP modes 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. The best choice is using = 7, 8 or 9, since in these modes MC55i automatically resumes power saving, after you have sent or received a short message or made a call. =5 or 6 do not offer this feature to the same extent and are only supported for compatibility with earlier releases. In all CYCLIC SLEEP modes, you can enter =1 to permanently wake up MC55i and take it back to full functionality. 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 ( = 5, 6, 7, 8 or 9) 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 time when the ME listens to a paging message from the base station. This is the way how the module indicates to the application when the UART is active. For detailed information on the timing of the CTS signal refer to [2]. 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. If both interfaces ASC0 and ASC1 are connected, hardware flow control must be set in either application. See notes below for further detail. The AT+CFUN test command returns the values of the supported parameters. The AT+CFUN read command returns the current functionality value. The AT+CFUN write command can be used to reset the ME, to choose one of the SLEEP modes or to return to full functionality. Syntax Test Command AT+CFUN=? Response(s) +CFUN: (list of supported s) , (list of supported s) OK Read Command AT+CFUN? Response(s) +CFUN: OK Write Command AT+CFUN=[ [, ]] Response(s) OK ERROR +CME ERROR MC55i_ATC_V01.003 Confidential / Released Page 39 of 479 2/28/08 MC55i AT Command Set s 2.8 AT+CFUN Reference(s) PIN GSM 07.07 - ASC0 ASC1 + + MUX1 MUX2 MUX3 ± ± ± Charge - - Last - 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. URC 2 ^SYSSTART CHARGE ONLY MODE Indicates that the ME has entered the CHARGE ONLY mode. This occurs if the charger is connected while the ME is in POWER DOWN mode. If autobauding is active (AT+IPR=0) the URC is not generated. In CHARGE ONLY mode the ME is neither registered to the GSM network nor are the serial interfaces fully accessible. Only the AT commands listed in Section 20.4, Availability of AT Commands Depending on Operating Mode of ME can be used. For further details on charging refer to the Hardware Interface Description [2]. Parameter Description (num) 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](&F)(P) Full functionality (no power saving). 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. 5 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 for 2 seconds after the last character was sent or received. 6 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 for 10 minutes after the last character was sent or received. To ensure that power saving takes effect immediately, the ME stays active for only 2 seconds after =6 was entered. 7 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 for 2 seconds after the last character was sent or received. The ME exits SLEEP mode only, if AT+CFUN=1 is entered. 8 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 for 10 minutes after the last character was sent or received. The ME exits SLEEP mode only, if AT+CFUN=1 is entered. To ensure that power saving takes effect immediately, the ME stays active for only 2 seconds after =8 was entered. MC55i_ATC_V01.003 Confidential / Released Page 40 of 479 2/28/08 MC55i AT Command Set s 2.8 AT+CFUN 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 modes 5,6,7 and 8 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", . RTS can be activated either from ASC0 or ASC1. The ME exits SLEEP mode only, if AT+CFUN=1 is entered. (num) 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. 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.7.1, Autobauding. Notes • The settings made with AT+CFUN apply to both serial interfaces ASC0 and ASC1. • CYCLIC SLEEP mode cannot be activated or resumed as long as data are buffered in one of the output buffers of the ME (ASC0 or ASC1). This should be taken into account, because RTS may be unintentionally asserted if, for example, one of the following scenarios occurs: a) Hardware flow control is set in the ME (AT\Q3), but not in the host application (RTS/CTS handshake). b) The two serial interfaces ASC0 and ASC1 are connected, but one of them is released, e.g. after closing or deactivating the application connected to this interface. In cases a) and b) data sent by the ME, such as URCs or outstanding AT command responses, will be buffered in the output buffer of this interface, signalized by the active RTS line until the buffer is emptied. Therefore, for CYCLIC SLEEP mode to work properly take care that the following requirements be met: Be sure that data sent by the ME are collected on both interfaces. Activate hardware flow control on ME (TA) and application side (TE). Avoid releasing one of the interfaces if any URCs are likely to occur on this interface. • CYCLIC SLEEP mode cannot be activated or resumed as long as data is buffered in one of the output buffers of the ME (ASC0 or ASC1). Therefore, ensure that the following requirements be met: a) If hardware flow control is set in the ME (AT\Q3), the host must also use hardware flow control. b) Remember that AT\Q3 takes effect only on the interface where the command was set. Therefore, if both interfaces ASC0 and ASC1 are connected ensure to set AT\Q3 on each interface. However, if only one interface shall be operated ensure that, on the unused interface, AT\Q3 is neither enabled and nor stored to the AT&W user profile. This is necessary to avoid that URCs, outstanding AT command responses or, after restart even the "^SYSSTART" URC might be buffered on the unused interface without being collected by the host application. • In Multiplex mode, the CFUN profile is shared by all multiplexer channels. • If the ME is in Multiplexer mode, it is not recommended to activate SLEEP mode with AT+CFUN= . The best approach to properly control SLEEP mode in this case is to issue the PSC messages described in [5], Section "Power saving control". • When a circuit-switched call is in progress, =7 or 8 or 9 can be activated without terminating the call. However, setting =0, 5 or 6 during a circuit-switched call immediately disconnects this call. • Please keep in mind that power saving works properly only when PIN authentication has been done. If you attempt to activate power saving while the SIM card is not inserted or the PIN is not correctly entered, the selected level will be set, though power saving does not take effect. For the same reason, power saving cannot be used if MC55i operates in Alarm mode. Furthermore, in order to accept incoming calls, SMS or network related URCs in SLEEP mode the ME must be registered when it enters the SLEEP mode. MC55i_ATC_V01.003 Confidential / Released Page 41 of 479 2/28/08 MC55i AT Command Set s 2.8 AT+CFUN • 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]). The LED remains "off" while the module is in any of the SLEEP modes. 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. Examples EXAMPLE 1 To check the level of functionality use the read command: AT+CFUN? +CFUN: 1 Default mode after ME was restarted Remember that the AT interface is notaccessible in NON-CYCLIC SLEEP mode. Consequently, the read command is only useful when the ME is set to full functionality or, when is set to 5, 6, 7, 8 or 9. AT+CFUN? +CFUN: 5 CYCLIC SLEEP mode EXAMPLE 2 To set the ME to NON-CYCLIC SLEEP mode enter AT+CFUN=0 OK When, for example, an SMS is being received and indicated by an unsolicited result code (URC), the ME wakes up to full operation. +CMTI: "SM",5 Note that the URC used in this example will appear only, if AT+CNMI=1,1 was configured before. After this, you may want to verify the operating status: AT+CFUN? +CFUN: 1 Indicates that ME has entered full functionality mode. EXAMPLE 3 To stop CYCLIC SLEEP mode and return to full functionality: AT+CFUN? +CFUN: 5 OK AT+CFUN=1 OK Remember that this approach is not applicable to the NON-CYCLIC SLEEP mode (since the serial interface is disabled). The NON-CYCLIC SLEEP mode ends with the first wake-up event. EXAMPLE 4 To reset and restart the ME: AT+CFUN=1,1 OK ^SYSSTART MC55i_ATC_V01.003 Confidential / Released or alternatively, AT+CFUN=0,1 or 5,1 or 6,1 or 7,1 or 8,1 or 9,1 The ^SYSSTART URC confirms that the ME has been rebooted. Note that ^SYSSTART appears only if AT+IPR ≠ 0. If the ME is in autobaud mode, it is recommended to wait 3 to 5 seconds before entering the first AT command. Remember to enter the SIM PIN after restart. Page 42 of 479 2/28/08 MC55i AT Command Set s 2.8 AT+CFUN 2.8.1 Wake up the ME from SLEEP mode A wake-up event is any event that causes the 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 Selected mode: =0 Selected mode: =5 or 6 Selected mode: =7 or 8 or 9 Ignition line No effect No effect No effect RTS0 or RTS1 activation Quit No effect (RTS is only used for flow control) Mode 7 and 8: No effect (RTS is only used for flow control) Mode 9: Temporary Unsolicited Result Code (URC) Quit Quit Temporary Incoming voice or data call Quit Quit Temporary Any AT command (incl. outgoing SMS, voice or data call) Not possible (UART disabled) Temporary Temporary Incoming SMS (AT+CNMI is set to 0,0 (this is the default setting) No effect No effect No effect Incoming SMS (AT+CNMI is set to 1,1) Quit Quit Temporary GPRS data transfer Not possible (UART disabled) Temporary Temporary RTC alarm line Quit Quit Temporary AT+CFUN=1 Not possible (UART disabled) Quit Quit MC55i_ATC_V01.003 Confidential / Released Page 43 of 479 2/28/08 MC55i AT Command Set s 2.9 AT^SMSO 2.9 AT^SMSO Switch off mobile station AT^SMSO initiates the power-off procedure. Low level of the module's VDD pin and the URC "^SHUTDOWN" notify that the procedure has completed and the module has entered the POWER DOWN mode. Therefore, be sure not to disconnect the operating voltage until VDD is low 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]. Syntax Test Command AT^SMSO=? Response(s) OK Exec Command AT^SMSO Response(s) ^SMSO: MS OFF OK ERROR Reference(s) PIN SIEMENS - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge + + Last + 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 Multiplex driver. • If both interfaces ASC0 and ASC1 are connected the URC appears on both of them. MC55i_ATC_V01.003 Confidential / Released Page 44 of 479 2/28/08 MC55i AT Command Set s 2.10 AT+GCAP 2.10 AT+GCAP Request complete TA capabilities list AT+GCAP returns a list of additional capabilities. Syntax Test Command AT+GCAP=? Response(s) OK Exec Command AT+GCAP Response(s) +GCAP: OK Reference(s) V.250 PIN - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (str) e.g.: +CGSM,+FCLASS Note • +CGSM: The response text shows which GSM commands of the ETSI standard are supported. MC55i_ATC_V01.003 Confidential / Released Page 45 of 479 2/28/08 MC55i AT Command Set s 2.11 AT+CMEE 2.11 AT+CMEE Mobile Equipment Error Message Format AT+CMEE controls the format of the error result codes that indicates errors related to MC55i 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.4, General "CME ERROR" Codes (GSM 07.07)Table 2.5, General "CME ERROR" Codes (SIEMENS)Table 2.6, GPRS related "CME ERROR" Codes (GSM 07.07) and Table 2.7, SMS related "CMS ERROR" Codes (GSM 07.05). In multiplex mode (refer AT+CMUX) the setting applies only to the logical channel where selected. The setting on the other channels may differ. Syntax Test Command AT+CMEE=? Response(s) +CMEE: (list of supported s) OK Read Command AT+CMEE? Response(s) +CMEE: OK Write Command AT+CMEE= Response(s) OK ERROR +CME ERROR: Reference(s) PIN GSM 07.07 - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (num)(&W)(&V) 0(&F)(D) 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 MC55i_ATC_V01.003 Confidential / Released Page 46 of 479 2/28/08 MC55i AT Command Set s 2.11 AT+CMEE 2.11.1 Table 2.4: CME/CMS Error Code Overview 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 MC55i_ATC_V01.003 Confidential / Released Page 47 of 479 2/28/08 MC55i AT Command Set s 2.11 AT+CMEE Code Text (if AT+CMEE=2) 133 requested service option not subscribed 134 service option temporarily out of order 256 Operation temporary not allowed 257 call barred 258 phone busy 259 user abort 260 invalid dial string 261 ss not executed 262 SIM blocked 263 Invalid Block Table 2.5: General "CME ERROR" Codes (SIEMENS) Code Text (if AT+CMEE=2) 615 network failure 616 network is down 639 service type not yet available 640 operation of service temporary not allowed 764 missing input value 765 invalid input value 767 operation failed Table 2.6: GPRS related "CME ERROR" Codes (GSM 07.07) Code Text (if AT+CMEE=2) 103 Illegal MS 106 Illegal ME 107 GPRS services not allowed 111 PLMN not allowed 112 Location area not allowed 113 Roaming not allowed in this location area 148 unspecified GPRS error 149 PDP authentication failure 150 invalid mobile class Table 2.7: SMS related "CMS ERROR" Codes (GSM 07.05) Code Text (if AT+CMEE=2) 1 Unassigned (unallocated) number 8 Operator determined barring 10 Call barred 21 Short message transfer rejected 27 Destination out of service 28 Unidentified subscriber 29 Facility rejected 30 Unknown subscriber MC55i_ATC_V01.003 Confidential / Released Page 48 of 479 2/28/08 s MC55i AT Command Set 2.11 AT+CMEE Code Text (if AT+CMEE=2) 38 Network out of order 41 Temporary failure 42 Congestion 47 Resources unavailable, unspecified 50 Requested facility not subscribed 69 Requested facility not implemented 81 Invalid short message transfer reference value 95 Invalid message, unspecified 96 Invalid mandatory information 97 Message type non-existent or not implemented 98 Message not compatible with short message protocol state 99 Information element non-existent or not implemented 111 Protocol error, unspecified 127 Interworking, unspecified 128 Telematic interworking not supported 129 Short message Type 0 not supported 130 Cannot replace short message 143 Unspecified TP-PID error 144 Data coding scheme (alphabet) not supported 145 Message class not supported 159 Unspecified TP-DCS error 160 Command cannot be actioned 161 Command unsupported 175 Unspecified TP-Command error 176 TPDU not supported 192 SC busy 193 No SC subscription 194 SC system failure 195 Invalid SME address 196 Destination SME barred 197 SM Rejected-Duplicate SM 198 TP-VPF not supported 199 TP-VP not supported 208 D0 SIM SMS storage full 209 No SMS storage capability in SIM 210 Error in MS 211 Memory Capacity Exceeded 212 SIM Application Toolkit Busy 213 SIM data download error 255 Unspecified error cause 300 ME failure 301 SMS service of ME reserved MC55i_ATC_V01.003 Confidential / Released Page 49 of 479 2/28/08 MC55i AT Command Set s 2.11 AT+CMEE Code Text (if AT+CMEE=2) 302 Operation not allowed 303 Operation not supported 304 Invalid PDU mode parameter 305 Invalid text mode parameter 310 SIM not inserted 311 SIM PIN required 312 PH-SIM PIN required 313 SIM failure 314 SIM busy 315 SIM wrong 316 SIM PUK required 317 SIM PIN2 required 318 SIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 no network service 332 Network timeout 340 NO +CNMA ACK EXPECTED 500 Unknown error 512 User abort 513 unable to store 514 invalid status 515 invalid character in address string 516 invalid length 517 invalid character in pdu 518 invalid parameter 519 invalid length or character 520 invalid character in text 521 timer expired 522 Operation temporary not allowed MC55i_ATC_V01.003 Confidential / Released Page 50 of 479 2/28/08 MC55i AT Command Set s 2.12 AT+CSCS 2.12 AT+CSCS Select TE character set The AT+CSCS write command informs the TA which character set is used by the TE. This enables the TA to convert character strings correctly between TE and ME character sets. See also Section 1.5, Supported character sets. Note that when the TA-TE interface is set to 8-bit operation and the used TE alphabet is 7-bit, the highest bit will be set to zero. Syntax Test Command AT+CSCS=? Response(s) +CSCS: (list of supported s) OK Read Command AT+CSCS? Response(s) +CSCS: OK Write Command AT+CSCS=[ ] Response(s) OK Reference(s) GSM 07.07, GSM 11.11 PIN - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (str) “GSM“(&F)(P) GSM default alphabet (GSM 03.38 subclause 6.2.1); Note: This setting may cause software flow control problems since the codes used to stop and resume data flow (XOFF = decimal 19, XON = decimal 17) are interpreted as normal characters. “UCS2“ 16-bit universal multiple-octet coded character set (ISO/IEC10646 [32]); UCS2 character strings are converted to hexadecimal numbers from 0000 to FFFF; e.g. "004100620063" equals three 16-bit characters with decimal values 65, 98 and 99. MC55i_ATC_V01.003 Confidential / Released Page 51 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG 2.13 AT^SCFG Extended Configuration Settings AT^SCFG can be used to query and configure various settings of the MC55i. The AT^SCFG read command returns a list of all supported parameters and their current values. The AT^SCFG write command queries a configuration parameter (if no value is entered) or sets its value(s). Input of parameter names is always coded in GSM characterset, parameter values are expected to be given as specified via AT+CSCS. The following error messages may be returned by the AT^SCFG write commands: • "+CME ERROR: operation temporary not allowed" Change of parameter value(s) temporarily not allowed. • "+CME ERROR: invalid index" Invalid parameter name or value(s). • "+CME ERROR: invalid characters in text string" Character set conversion of parameter value(s) failed. • "+CME ERROR: memory failure" Could not allocate necessary memory or storing a parameter failed. • "+CME ERROR: operation not allowed" Change of parameter value(s) not allowed • "+CME ERROR: unknown" Other error Syntax Test Command AT^SCFG=? Response(s) ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: OK "Audio/AMR", (list of supported s) "Audio/Loop", (list of supported s) "Call/SpeechVersion1", (list of supported s) "GPRS/ATS0/withAttach", (list of supported s) "GPRS/RingOnIncomingData", (list of supported s) "PowerSaver/Mode9/Timeout", (list of supported s) "Radio/Band/HandOver", (list of supported s) "Tcp/IRT", (list of supported ) "Tcp/MR", (list of supported ) "Tcp/OT", (list of supported ) "Tcp/WithURCs", (list of supported ) "URC/CallStatus/CIEV", (list of supported s) "URC/CallStatus/SLCC", (list of supported s) "URC/Datamode/Ringline", (list of supported s) "URC/Ringline", (list of supported s) "URC/Ringline/ActiveTime", (list of supported s) Read Command AT^SCFG? Response(s) ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: "Audio/AMR", 1[, 2[, 3...[ 10]]] "Audio/Loop", "Call/SpeechVersion1", "GPRS/ATS0/withAttach", "GPRS/RingOnIncomingData", "PowerSaver/Mode9/Timeout", "Radio/Band/HandOver", "Tcp/IRT", MC55i_ATC_V01.003 Confidential / Released Page 52 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG Read Command (Continued) AT^SCFG? Response(s) ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: ^SCFG: OK "Tcp/MR", "Tcp/OT", "Tcp/WithURCs", "URC/CallStatus/CIEV", "URC/CallStatus/SLCC", "URC/Datamode/Ringline", "URC/Ringline", "URC/Ringline/ActiveTime", Write Command Adaptive Multi Rate (AMR): AT^SCFG="Audio/AMR"[, ] Response(s) ^SCFG: "Audio/AMR", 1[, 2[, 3...[ 10]]] OK ERROR +CME ERROR Write Command Configure Audio Loop: AT^SCFG="Audio/Loop"[, ] Response(s) ^SCFG: "Audio/Loop", OK ERROR +CME ERROR Write Command Query/Configure SpeechVersion1 AT^SCFG="Call/SpeechVersion1"[, ] Response(s) ^SCFG: "Call/SpeechVersion1", OK ERROR +CME ERROR Write Command GPRS ATS0 with automatic attach AT^SCFG="GPRS/ATS0/withAttach"[, ] Response(s) ^SCFG: "GPRS/ATS0/withAttach", OK ERROR +CME ERROR MC55i_ATC_V01.003 Confidential / Released Page 53 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG Write Command Ring on incoming GPRS IP data packets AT^SCFG="GPRS/RingOnIncomingData"[, ] Response(s) ^SCFG: "GPRS/RingOnIncomingData", OK ERROR +CME ERROR Write Command Query/Set timeout value for power saving mode 9 AT^SCFG="PowerSaver/Mode9/Timeout"[, ] Response(s) ^SCFG: "PowerSaver/Mode9/Timeout", OK ERROR +CME ERROR Write Command Control Special Call Handover Setting AT^SCFG="Radio/Band/HandOver"[, ] Response(s) ^SCFG: "Radio/Band/HandOver", OK ERROR +CME ERROR Write Command Network selection mode AT^SCFG="Radio/NWSM"[, ] Response(s) ^SCFG: "Radio/NWSM", OK ERROR +CME ERROR Write Command Configuration of TCP parameter 'InitialRetransmissionTimeout': AT^SCFG="Tcp/IRT"[, ] Response(s) ^SCFG: "Tcp/IRT", OK ERROR +CME ERROR Write Command Configuration of TCP parameter 'MaxRetransmissions': AT^SCFG="Tcp/MR"[, ] Response(s) ^SCFG: "Tcp/MR", OK ERROR +CME ERROR MC55i_ATC_V01.003 Confidential / Released Page 54 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG Write Command Configuration of TCP parameter 'OverallTimeout': AT^SCFG="Tcp/OT"[, ] Response(s) ^SCFG: "Tcp/OT", OK ERROR +CME ERROR Write Command Configuration of Internet Service URCs: AT^SCFG="Tcp/WithURCs"[, ] Response(s) ^SCFG: "Tcp/WithURCs", OK ERROR +CME ERROR Write Command Configuration of URC "+CIEV: call" Call Status Indication AT^SCFG="URC/CallStatus/CIEV"[, ] Response(s) ^SCFG: "URC/CallStatus/CIEV", OK ERROR +CME ERROR Write Command Configuration of URC "^SLCC" Call Status Indication AT^SCFG="URC/CallStatus/SLCC"[, ] Response(s) ^SCFG: "URC/CallStatus/SLCC", OK ERROR +CME ERROR Write Command URC indication in datamode via Ring line: AT^SCFG="URC/Datamode/Ringline"[, ] Response(s) ^SCFG: "URC/Datamode/Ringline", OK ERROR +CME ERROR Write Command URC indication via Ring line: AT^SCFG="URC/Ringline"[, ] Response(s) ^SCFG: "URC/Ringline", OK ERROR +CME ERROR MC55i_ATC_V01.003 Confidential / Released Page 55 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG Write Command Duration of active RING line for URC indications: AT^SCFG="URC/Ringline/ActiveTime"[, ] Response(s) ^SCFG: "URC/Ringline/ActiveTime", OK ERROR +CME ERROR PIN - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (str)(+CSCS) Adaptive Multi Rate This parameter can be used to control the usage of the feature "Adaptive Multi Rate" (AMR). It is possible to enable or disable this feature for all network operators, or to enable it for selected operators (max. 10). If the feature is enabled for all operators, any request to enable it for a specific operator will result in a "+CME ERROR: operation temporary not allowed". Changes of this parameter become active with the next call. Parameter is global for all interfaces, volatile and will not be reset by AT&F. “enabled“(P) AMR is used for every operator. “disabled“ AMR is not used for any operator. 00000...999999 Enable AMR for the specified operator (in BCD or IRA format; see AT+COPS). (str) Audio Loop Setting This parameter can be used to configure an audio loop for performing a simple verification of audio connections. The intention of this audio loop is for testing only. Full audio processing will be performed. Audio parameterization capabilities remain nearly unrestricted. Microphone and loudspeaker ports can be selected with random access. The audio loop cannot be used in combination with the digital audio interface. Neither a SIM-card nor a GSM network is necessary to turn the audio loop on. Turning the audio loop on activates audio mode 0 which cannot be selected during normal operation of the module. Turning the audio loop off activates audio mode 1. The active audio mode can be verified via AT^SNFS. Audio mode 0 contains linear filters and neither echo canceller nor noise suppression are activated. It is also possible to select any other audio mode. These audio modes use the parameterization set as default during normal operation of the module. Activation of the audio loop turns sidetone off, even if sidetone is on in the selected audio mode during normal operation. Audio path can be selected via AT command AT^SAIC. Audio mode can be selected via AT command AT^SNFS. Parameter is global for all interfaces, volatile and will not be reset by AT&F. “0“(P) No audio loop active “1“ Audio loop active MC55i_ATC_V01.003 Confidential / Released Page 56 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG (str)(+CSCS) Call Speech Version1 This parameter can be used to query or configure the speech version 1 indication in the bearer capabilities in case of voice calls (see GSM 04.08). Speech version 2 (EFR) is always enabled; speech version 3 ( AMR) is not affected by this command. If you try to change this parameter as long as a circuit switched call is active, the command returns the new value and "OK", but the changes will not take effect before next call setup. Parameter is global for the ME, volatile and will not be reset by AT&F. “0“(P) FR and HR codecs are enabled for speech calls - full rate codec is preferred. “1“ FR and HR codecs are enabled for speech calls - half rate codec is preferred. “2“ Half rate codec is disabled for speech calls. (str)(+CSCS) GPRS ATS0 with Attach This parameter can be used to control the behaviour of ATS0. Parameter is global for all interfaces, volatile and will not be reset by AT&F. “on“(P) When the ATS0= ( >0) command is received, the MT will attempt to perform a GPRS attach. “off“ When the ATS0= ( >0) command is received, the MT will not attempt to perform a GPRS attach. (str)(+CSCS) Ring on incoming GPRS IP data packets This parameter can be used to control the behaviour of the RING line for incoming IP packets in GPRS online mode. Parameter is local for the interface, volatile and will not be reset by AT&F. “on“ If the ME is in power saving mode 7 or 8 or 9 (see AT+CFUN) and hardware flow control is in use (AT\Q3) and the RTS line is inactive and there are incoming IP packets for a GPRS context which is online, then the RING line will be activated once, for a time which is configured by the parameter "URC/Ringline/ ActiveTime" ( ). The RING line to be used can be configured with the parameter "URC/Ringline" ( ). “off“(P) RING line is not activated for incoming IP packets. (str)(+CSCS) Power saving mode 9 timeout This parameter can be used to query or configure the wake up time for power saving mode 9 (see AT+CFUN with parameter =9). Parameter is global for the ME, volatile and will not be reset by AT&F. 5...20(P)...36000 MC55i_ATC_V01.003 Confidential / Released The granularity of the timeout value is 100ms (i.e. a value of 10 equal 1 second). The minimum timeout value that can be applied is 5, but accuracy is only guaranteed for timeout values greater than 20. Page 57 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG (str)(+CSCS) Call Handover Status This parameter offers a workaround to prevent problems during call handover into the 1900 MHz (or 1800 MHz) band, caused by non-conforming configurations of the 1900 MHz (or 1800 MHz) GSM network. “0“(P) Disable workaround. “1“ Enable workaround. This value should be selected when handover into a 1900 MHz (or 1800 MHz) GSM network fails. If required for permanent use the value needs to be set each time the ME is restarted. (str)(+CSCS) Network Selection Mode This parameter allows network selection without considering the MCC. Parameter is global for all interfaces, volatile and will not be reset by AT&F. “0“(P) Network selection compliant with the 3GPP standards. “1“ Network selection without considering the MCC. (str)(+CSCS) Initial Retransmission Timeout (IRT) 1...3(&F)(D)...60 This parameter determines the time (in seconds) the TCP/IP stack will wait before starting the first retransmission of packets during the initial connection establishment phase. The TCP protocol ensures the retransmission of packets several times at increasing intervals until some upper limit is reached. This mechanism prevents packet loss and serious congestion problems. In addition, the parameters and can be set to further optimize this mechanism for special conditions depending on the mobile network. Parameter is global for the ME and non-volatile. Use of default value is recommended. If changed the new value takes effect the next time you start an Internet service with AT^SISO. (str)(+CSCS) Maximum Number of Retransmissions (MR) 1...10(&F)(D)...30 This parameter determines the maximum number of times to retransmit TCP packets. The value set with will be assumed as default for the "tcpMR" when a new service profile is created with AT^SISS. In each service profile, you can set another "tcpMR" value which has precedence over the global value set with AT^SCFG. Existing service profiles are not affected when you change the global value via AT^SCFG. Parameter is global for the ME and non-volatile. Use of default value is recommended. (str)(+CSCS) Overall TCP Timer for outstanding connections (tcpOT) 1...6000(&F)(D) MC55i_ATC_V01.003 Confidential / Released This parameter specifies the number of seconds to wait before closing a connection if TCP/IP packets are not acknowledged. Setting the maximum value is practically equivalent to deactivating the tcpOT mechanism because the maximum time would never be reached by the TCP/ IP stack. The value set with will be assumed as default for the "tcpOT" when a new service profile is created with AT^SISS. How- Page 58 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG ever, in each service profile, you can set another "tcpOT" value which has precedence over the global value set with AT^SCFG. Existing service profiles are not affected when you change the global value via AT^SCFG. Parameter is non-volatile. Use of default value is recommended. (str)(+CSCS) URC mode or polling mode for Internet service commands This parameter enables or disables the presentation of the following URCs related to Internet service commands: "^SISR" URC, "^SISW" URC and "^SIS" URC for parameter =0 (Internet service events). "^SIS" URCs with =1 or 2 used to indicate incoming Socket connections are always enabled. Parameter is global for the ME and non-volatile. “on“(&F)(D) Enable URCs related to Internet service commands. Throughout the Chapter "Internet Service AT Commands" the mode is also referred to as URC mode. “off“ Disable URCs related to Internet service commands. This requires the host application to employ polling techniques when using the Internet service AT commands: The host application is responsible to retrieve all status information needed to control an Internet session. The method is referred to as polling mode. (str)(+CSCS) CIEV Call Status Indication This parameter can be used to control the behaviour of URC "+CIEV: call". See also AT+CIND, AT+CMER and Section 7.1, Call Status Information. Parameter is global for all interfaces and will not be reset by AT&F. “restricted“(P) URC "+CIEV: call" will be issued only when a Call Status transition ends in state "active" or "unknown" (see Section 7.1, Call Status Information) for a call in the list of active calls. “verbose“ URC "+CIEV: call" will be issued when any state transition (including transitions beginning or ending in state "unknown") occurs in the list of active calls, or when a traffic channel is established. (str)(+CSCS) SLCC Call Status Indication This parameter can be used to control the behaviour of URC "^SLCC". See also AT^SLCC and Section 7.1, Call Status Information. Parameter is global for all interfaces and will not be reset by AT&F. “restricted“ URC "^SLCC" will be issued only when a Call Status transition ends in state "active" or "unknown" (see Section 7.1, Call Status Information) for a call in the list of active calls “verbose“(P) URC "^SLCC" will be issued when any state transition (including transitions beginning or ending in state "unknown") occurs in the list of active calls, or when a traffic channel is established. (str)(+CSCS) URC RING line This parameter can be used to control the behaviour of the RING line to indicate URCs (both for idle interfaces and, if configured by the parameter "URC/Datamode/Ringline", if link is reserved) and, if configured, the indicator for incoming IP packets (see parameter "GPRS/RingOnIncomingData" ( ). Parameter is local for the interface, volatile and will not be reset by AT&F. “off“ MC55i_ATC_V01.003 Confidential / Released URC is not indicated by RING. Page 59 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG “local“(P) URC will be indicated by an activated RING line of the interface on which the URC appears “asc0“ URC is indicated by an activated RING0 line. (str)(+CSCS) URC Datamode RING line This parameter specifies whether RING or BREAK is used for the signaling of URCs when the TA-TE link is reserved (e.g. during circuit-switched data calls, fax connections, in GPRS data mode or during the execution of an AT command). Parameter is global for all interfaces, volatile and will not be reset by AT&F. “off“(P) URC will be indicated by BREAK “on“ URC is indicated by an active RING line for a time which is configured by the parameter "URC/Ringline/ActiveTime" ( ). The RING line which will be used, can be configured by the parameter "URC/Ringline" ( ). (str)(+CSCS) URC RING line Active Time This parameter can be used to control how long the RING line is activated to indicate URCs (both for idle interfaces and, if configured by the parameter "URC/Datamode/Ringline" ( ), if link is reserved) and, if configured by the parameter "GPRS/RingOnIncomingData", to indicate incoming GPRS IP data packets ( ). Parameter is global for all interfaces, volatile and will not be reset by AT&F. “0“ RING line will be activated for a time between 4.6 and 9.2 ms. “1“ RING line will be activated for about 100ms. (P) “2“ RING line will be activated for about 1s. Note • Parameters "GPRS/ATS0/withAttach" ( ) and "GPRS/RingOnIncomingData" ( ) are available only for modules supporting GPRS. Examples EXAMPLE 1 Usage of "Audio/AMR": AT+CSCS="UCS2" Switch to UCS2 character set. OK AT^SCFG? Query all parameters. ... ^SCFG:"Audio/AMR","0065006E00610062006C00650064" ... OK AT+CSCS="GSM" OK AT^SCFG? ... ^SCFG:"Audio/AMR","enabled" AMR will be used for any operator. ... OK AT^SCFG="Audio/AMR","disabled" ^SCFG:"Audio/AMR","disabled" AMR is disabled for any operator. OK AT^SCFG="Audio/AMR","23405" MC55i_ATC_V01.003 Confidential / Released Page 60 of 479 2/28/08 MC55i AT Command Set s 2.13 AT^SCFG AMR is disabled for any operator, but enabled for operator "23405". ^SCFG:"Audio/AMR","23405" OK AT^SCFG="Audio/AMR","23203" ^SCFG:"Audio/AMR","23405","23203" AMR is disabled for any operator, but enabled for operators "23405" and "23203". OK AT^SCFG="Audio/AMR" ^SCFG:"Audio/AMR","23405","23203" OK Query parameter "Audio/AMR" EXAMPLE 2 Usage of "URC/Ringline" and "URC/Datamode/Ringline": AT+CSCS="GSM" OK AT^SCFG? ... ^SCFG:"URC/Datamode/Ringline","off" ^SCFG:"URC/Ringline","local" ... OK AT^SCFG="URC/Datamode/Ringline","on" ^SCFG:"URC/Datamode/Ringline","on" OK AT^SCFG="URC/Ringline","asc0" ^SCFG:"URC/Ringline","asc0" Query all parameters. While the TA-TE link is reserved URCs will be indicated by BREAK. URCs on this interface will be indicated by Ring line associated to the interface (e.g. RING0 for ASC0). While the TA-TE link is reserved URCs will be indicated by an activated "local" Ring line. URCs on this interface will be indicated by an activated RING0 no matter whether or not the TA-TE link is reserved. OK AT^SCFG="URC/Datamode/Ringline","off" ^SCFG:"URC/Datamode/Ringline","off" OK AT^SCFG="URC/Ringline" Switch to GSM character set. URCs on this interface will be indicated by an activated RING0 if the TA-TE link is not reserved and by BREAK if the TA-TE link is reserved. Disable any Ring line indication for URCs on this interface. ^SCFG:"URC/Ringline","off" OK MC55i_ATC_V01.003 Confidential / Released Page 61 of 479 2/28/08 MC55i AT Command Set s 2.14 AT^SM20 2.14 AT^SM20 Set M20 compatibility mode M20 is an earlier, widely used SIEMENS GSM engine. The AT^SM20 command selects different modes of responses returned upon execution of the commands ATD and sms commands like e.g. AT+CMGW. Please note that the AT^SM20 command has no effect on any other features and is not intended to adjust other differences between M20 and MC55i. Syntax Test Command AT^SM20=? Response(s) OK Read Command AT^SM20? Response(s) ^SM20: , OK Write Command AT^SM20= [, ] Response(s) OK Reference(s) PIN SIEMENS - ASC0 ASC1 + + MUX1 MUX2 MUX3 + + + Charge - - Last - Parameter Description (num) Call setup response mode Applies only to voice calls. 0 Set compatibility to Siemens mobile phones. ME will return "OK" immediately after attempting a call with the ATD command. In case of failure, additional call release indications, such as "NO DIAL TONE, "NO CARRIER", "BUSY" will follow. 1(&F) Default call setup mode, compatible to M20. ME will return "OK" in case of a successful connection, otherwise one of the call release indications "NO DIAL TONE, "NO CARRIER", "BUSY" are indicated. (num) Response mode for sending and writing short messages Applies to the sms commands like e.g. AT+CMGS and AT+CMGW command. 0 Set compatibility to Siemens mobile phones. ME will return +CMS ERROR: when writing or sending of short messages fails. 1(&F) Default mode for sending and writing short messages, compatible to M20. ME will return "OK", no matter whether or not sms command was successfully executed. MC55i_ATC_V01.003 Confidential / Released Page 62 of 479 2/28/08 MC55i AT Command Set s 3. Status Control Commands 3. Status Control Commands The AT Commands described in this chapter allow the external application to obtain various status information from the MC55i. 3.1 AT+CMER Mobile Equipment Event Reporting This command controls details of the "+CIEV" URC presentation related to AT^SIND and AT+CIND. If registered via these commands the URCs are sent whenever a value of the related indicator changes. In addition, AT+CMER controls "^SLCC" URCs related to AT^SLCC. For details refer to Call Status Information, AT^SLCC and AT^SCFG, parameter . The read command returns the URC presentation mode and among others, the indicator event reporting status . The write command enables and disables the presentation of "+CIEV: , 1[, 2]" URCs. refers to the name of a "+CIEV" indicator and is the new value of this indicator. After AT+CMER has been switched on, URCs for all registered indicators will be issued. See examples provided in Section 3.2, AT+CIND and Section 3.3, AT^SIND. Syntax Test Command AT+CMER=? Response(s) +CMER: (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s) OK Read Command AT+CMER? Response(s) +CMER: , , , ,