Part Number Hot Search : 
OM6228SS 580087 ZC931 74HC1650 F6626 AZ7809T T6401D 1N5518
Product Description
Full Text Search
 

To Download XT65 Datasheet File

  If you can't view the Datasheet, Please click here to try to view without PDF Reader .  
 
 


  Datasheet File OCR Text:
 s
www..com
XT65
Siemens Cellular Engine Version: DocId: 01.001 XT65_ATC_V01.001
AT Command Set
XT65 AT Command Set
s
Document Name: Version: Date: DocId:
www..com
XT65 AT Command Set
01.001 January 9, 2007 XT65_ATC_V01.001 Confidential / Released
Status
General Notes 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 thirdparty 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 (c) Siemens AG 2007 Trademark notice BluetoothTM is a registered trademark of Bluetooth SIG Inc.
XT65_ATC_V01.001 Confidential / Released
Page 2 of 588
1/9/07
XT65 AT Command Set
Contents
s
Contents
Introduction............................................................................................................................................ 14 1.1 Scope of the document ................................................................................................................. 14 1.2 Related documents ....................................................................................................................... 15 1.3 Document conventions.................................................................................................................. 16 1.3.1 Quick reference table..................................................................................................... 16 1.3.2 Superscript notation for parameters and values ............................................................ 17 www..com 1.4 AT Command Syntax .................................................................................................................... 18 1.4.1 Using Parameters .......................................................................................................... 18 1.4.2 Combining AT commands on the same command line ................................................. 19 1.5 Supported character sets .............................................................................................................. 20 1.5.1 GSM alphabet tables and UCS2 character values ........................................................ 22 1.5.2 UCS2 and GSM data coding and conversion for SMS text mode ................................. 24 1.5.2.1 Implementing output of SIM data to Terminal (direction TA to TE) ................................ 24 1.5.2.2 Implementing input of Terminal data to SIM (direction TE to TA)................................... 25 1.6 Serial Interface Flow Control ......................................................................................................... 26 1.6.1 Software Flow Control (XON/OFF Handshake)............................................................. 26 1.6.2 Hardware Flow Control (RTS/CTS Handshake) ............................................................ 26 1.7 Communication between Customer Application and XT65 ........................................................... 28 1.8 Unsolicited Result Code Presentation........................................................................................... 29 1.9 Common PCN Handset Specification (CPHS) .............................................................................. 30 1.10 Errors and Messages .................................................................................................................... 31 2. Configuration Commands..................................................................................................................... 32 2.1 AT&F Set all current parameters to manufacturer defaults ......................................................... 32 2.2 AT&V Display current configuration ............................................................................................ 33 2.2.1 AT&V responses............................................................................................................ 34 2.3 AT&W Stores current configuration to user defined profile ......................................................... 36 2.4 ATQ Set result code presentation mode ..................................................................................... 37 2.5 ATV Set result code format mode ............................................................................................... 38 2.5.1 Verbose and numeric result codes ................................................................................ 38 2.6 ATX Set CONNECT result code format and call monitoring ....................................................... 39 2.7 AT\V Set CONNECT result code format ..................................................................................... 40 2.8 ATZ Set all current parameters to user defined profile................................................................ 41 2.9 AT+CFUN Set phone functionality .............................................................................................. 42 2.9.1 Wake up the ME from SLEEP mode ............................................................................. 45 2.10 AT^SMSO Switch off mobile station............................................................................................ 46 2.11 AT+GCAP Request complete TA capabilities list........................................................................ 47 2.12 AT+CMEE Mobile Equipment Error Message Format ................................................................ 48 2.12.1 CME/CMS Error Code Overview ................................................................................... 49 2.13 AT+CSCS Select TE character set ............................................................................................. 54 2.14 AT^SCFG Extended Configuration Settings ............................................................................... 55 2.15 AT^SM20 Set M20 compatibility mode ....................................................................................... 79 Status Control Commands ................................................................................................................... 80 3.1 AT+CMER Mobile Equipment Event Reporting .......................................................................... 80 3.2 AT+CIND Indicator control .......................................................................................................... 82 1.
3.
XT65_ATC_V01.001 Confidential / Released
Page 3 of 588
1/9/07
XT65 AT Command Set
Contents
s
3.3 3.4
www..com
3.5 3.6 3.7 4.
AT^SIND Extended Indicator Control .......................................................................................... 85 AT+CEER Extended Error Report............................................................................................... 92 3.4.1 Cause Location ID for the extended error report ........................................................... 93 3.4.2 SIEMENS L2 cause ....................................................................................................... 94 3.4.3 GSM release cause for L3 Radio Resource (RR).......................................................... 94 3.4.4 SIEMENS release cause for L3 Radio Resource (RR).................................................. 94 3.4.5 GSM release cause for Mobility Management (MM) or Session Management (SM)..... 95 3.4.6 SIEMENS release cause for L3 Mobility Management (MM) ........................................ 96 3.4.7 GSM release cause for L3 Call Control (CC)................................................................. 96 3.4.8 SIEMENS release cause for L3 Call Control (CC)......................................................... 98 3.4.9 GSM Release cause for Supplementary Service Call ................................................... 98 3.4.10 GSM release cause for Session Management (SM) ..................................................... 99 3.4.11 GSM cause for L3 Protocol module or other local cause ........................................... 100 3.4.12 SIEMENS release cause for GPRS API ...................................................................... 100 3.4.13 SIEMENS release cause for PPP/IP-Stack ................................................................. 100 ATS18 Extended call release report.......................................................................................... 101 AT+CPAS Mobile equipment activity status .............................................................................. 103 AT+WS46 Select wireless network ........................................................................................... 104
Serial Interface Control Commands................................................................................................... 105 4.1 AT\Q Flow control...................................................................................................................... 105 4.2 AT&C Set Data Carrier Detect (DCD) Line mode ..................................................................... 106 4.3 AT&D Set circuit Data Terminal Ready (DTR) function mode................................................... 107 4.4 AT&S Set circuit Data Set Ready (DSR) function mode ........................................................... 108 4.5 ATE Enable command echo...................................................................................................... 109 4.6 AT+ICF Serial Interface Character Framing.............................................................................. 110 4.7 AT+IFC Set Flow Control separately for data directions ........................................................... 112 4.8 AT+ILRR Set TE-TA local rate reporting ................................................................................... 114 4.9 AT+IPR Set fixed local rate ....................................................................................................... 116 4.9.1 Autobauding................................................................................................................. 117 4.10 AT+CMUX Enter multiplex mode .............................................................................................. 119 4.10.1 Restrictions on Multiplex mode.................................................................................... 120 4.11 AT^STPB Transmit Parity Bit (for 7E1 and 7O1 only) ............................................................... 122 Security Commands ............................................................................................................................ 123 5.1 AT+CPIN PIN Authentication .................................................................................................... 123 5.1.1 What to do if PIN or password authentication fails? .................................................... 125 5.2 AT+CPIN2 PIN2 Authentication ................................................................................................ 127 5.3 AT^SPIC Display PIN counter ................................................................................................... 129 5.4 AT+CLCK Facility lock .............................................................................................................. 133 5.5 AT^SLCK Facility lock ............................................................................................................... 138 5.6 AT+CPWD Change Password .................................................................................................. 139 5.7 AT^SPWD Change Password ................................................................................................... 143 5.8 AT^SCSL Customer SIM Lock .................................................................................................. 145 Identification Commands.................................................................................................................... 149 6.1 ATI Display product identification information ........................................................................... 149 6.2 AT+CGMI Request manufacturer identification......................................................................... 150 6.3 AT+GMI Request manufacturer identification ........................................................................... 150 6.4 AT+CGMM Request model identification .................................................................................. 151
5.
6.
XT65_ATC_V01.001 Confidential / Released
Page 4 of 588
1/9/07
XT65 AT Command Set
Contents
s
6.5 6.6 6.7 6.8 6.9 6.10 7.
AT+GMM Request model identification..................................................................................... 151 AT+CGMR Request revision identification of software status................................................... 152 AT+GMR Request revision identification of software status ..................................................... 152 AT+CGSN Request International Mobile Equipment Identity (IMEI) ......................................... 153 AT+GSN Request International Mobile Equipment Identity (IMEI) ........................................... 153 AT+CIMI Request International Mobile Subscriber Identity (IMSI)............................................ 154
Call related Commands....................................................................................................................... 155 7.1 Call Status Information ................................................................................................................ 155 7.2 ATA Answer a call ..................................................................................................................... 156 7.3 ATD Mobile originated call to specified number ........................................................................ 157 www..com 7.4 ATD> Mobile originated call using specific memory and index number ................. 159 7.5 ATD> Mobile originated call from active memory using index number ............................... 161 7.6 ATD> Mobile originated call from active memory using corresponding field .................... 162 7.7 ATDI Mobile originated call to ISDN number............................................................................. 163 7.8 ATDL Redial last number used ................................................................................................. 164 7.9 ATH Disconnect existing connection......................................................................................... 165 7.10 AT+CHUP Hang up call ............................................................................................................ 166 7.11 AT^SHUP Hang up call(s) indicating a specific GSM04.08 release cause ............................... 167 7.12 ATS0 Set number of rings before automatically answering a call ............................................. 169 7.13 ATS6 Set pause before blind dialing ......................................................................................... 170 7.14 ATS7 Set number of seconds to wait for connection completion .............................................. 171 7.15 ATS8 Set number of seconds to wait for comma dialing modifier............................................. 172 7.16 ATS10 Set disconnect delay after indicating the absence of data carrier ................................. 173 7.17 ATO Switch from command mode to data mode / PPP online mode........................................ 174 7.18 +++ Switch from data mode to command mode ....................................................................... 175 7.19 AT+CBST Select bearer service type ....................................................................................... 176 7.20 AT+CRLP Select radio link protocol parameters for originated non-transparent data calls ...... 178 7.21 AT+CLCC List current calls of ME ............................................................................................ 179 7.22 AT^SLCC Siemens defined command to list current calls of ME.............................................. 181 7.23 AT+CR Service reporting control .............................................................................................. 186 7.24 AT+CRC Set Cellular Result Codes for incoming call indication .............................................. 187 7.25 AT+CSNS Single Numbering Scheme ...................................................................................... 188 7.26 AT^SCNI List Call Number Information ..................................................................................... 189 7.27 AT^SLCD Display Last Call Duration ........................................................................................ 190 7.28 AT^STCD Display Total Call Duration....................................................................................... 191 7.29 ATP Select pulse dialing ........................................................................................................... 192 7.30 ATT Select tone dialing ............................................................................................................. 192 8. Network Service Commands .............................................................................................................. 193 8.1 AT+COPN Read operator names ............................................................................................. 193 8.2 AT+COPS Operator Selection .................................................................................................. 194 8.3 AT^SOPS Extended Operator Selection ................................................................................... 197 8.4 AT+CREG Network registration ................................................................................................ 199 8.5 AT+CSQ Signal quality ............................................................................................................. 202 8.6 AT^SMONC Cell Monitoring...................................................................................................... 203 8.7 AT^SMOND Cell Monitoring...................................................................................................... 205 8.8 AT^SFNUR Select the fixed network user rate ......................................................................... 208 8.9 AT^MONI Monitor idle mode and dedicated mode ................................................................... 209 8.9.1 AT^MONI responses.................................................................................................... 210
XT65_ATC_V01.001 Confidential / Released
Page 5 of 588
1/9/07
XT65 AT Command Set
Contents
s
8.9.2 Service states .............................................................................................................. 211 8.10 AT^MONP Monitor neighbour cells ........................................................................................... 212 8.10.1 AT^MONP responses .................................................................................................. 213 8.11 AT^SMONG GPRS Monitor ...................................................................................................... 214 8.11.1 AT^SMONG Cell Info Table......................................................................................... 215 8.12 AT^SALS Alternate Line Service............................................................................................... 216 8.13 AT^SHOM Display Homezone .................................................................................................. 218 8.14 AT^SPLM Read the PLMN list .................................................................................................. 219 8.15 AT+CPOL Preferred Operator List ............................................................................................ 221 8.16 AT^SPLR Read entry from the preferred operators list............................................................. 222 www..com 8.17 AT^SPLW Write an entry to the preferred operators list ........................................................... 223 9. Supplementary Service Commands .................................................................................................. 224 9.1 AT+CACM Accumulated call meter (ACM) reset or query ........................................................ 224 9.2 AT^SACM Advice of charge and query of ACM and ACMmax ................................................. 225 9.3 AT+CAMM Accumulated call meter maximum (ACMmax) set or query.................................... 227 9.4 AT+CAOC Advice of Charge information .................................................................................. 228 9.5 AT+CCUG Closed User Group ................................................................................................. 229 9.6 AT+CCFC Call forwarding number and conditions control ....................................................... 231 9.7 AT+CCWA Call Waiting ............................................................................................................ 235 9.8 AT+CHLD Call Hold and Multiparty........................................................................................... 239 9.9 AT+CLIP Calling Line Identification Presentation ..................................................................... 241 9.10 AT+CLIR Calling Line Identification Restriction ........................................................................ 243 9.11 AT+COLP Connected Line Identification Presentation ............................................................. 244 9.12 AT+CPUC Price per unit and currency table............................................................................. 246 9.13 AT+CSSN Supplementary service notifications ........................................................................ 248 9.14 AT+CUSD Unstructured supplementary service data ............................................................... 250 Internet Service Commands ............................................................................................................... 252 10.1 AT^SICS Internet Connection Setup Profile.............................................................................. 255 10.1.1 Example: Default values of a CSD connection profile ................................................. 258 10.1.2 Example: GPRS connection profile ............................................................................. 259 10.2 AT^SICI Internet Connection Information.................................................................................. 260 10.2.1 Checking Connection Profile Status ............................................................................ 261 10.3 AT^SISS Internet Service Setup Profile .................................................................................... 262 10.4 AT^SISI Internet Service Information ........................................................................................ 271 10.5 AT^SISO Internet Service Open ............................................................................................... 273 10.5.1 Example: Accepting / Rejecting Socket Connection Request from Remote Client ..... 276 10.6 AT^SISC Internet Service Close ............................................................................................... 278 10.7 AT^SISR Internet Service Read Data ....................................................................................... 279 10.7.1 Example: Socket Host Reads Small Amounts of UDP Data Packets (URC Mode)..... 281 10.8 AT^SISW Internet Service Write Data....................................................................................... 282 10.8.1 Usage of parameter ................................................................................... 284 10.9 AT^SICO Internet Connection Open ......................................................................................... 286 10.10 AT^SICC Internet Connection Close ......................................................................................... 288 10.11 AT^SISX Internet Service Execution ......................................................................................... 289 10.11.1 Example: Ping.............................................................................................................. 291 10.12 AT^SISE Internet Service Error Report ..................................................................................... 292 10.13 Internet Service URC "^SIS" ....................................................................................................... 293 10.13.1 Information Elements Related to the Service Application............................................ 294
10.
XT65_ATC_V01.001 Confidential / Released
Page 6 of 588
1/9/07
XT65 AT Command Set
Contents
s
10.13.2 Information Elements Related to FTP Service............................................................. 295 10.13.3 Information Elements Related to HTTP Service .......................................................... 296 10.13.4 Information Elements Related to POP3 Service.......................................................... 296 10.13.5 Information Elements Related to SMTP Service ......................................................... 296 10.14 Examples of how to Configure and Use Internet Service Profiles............................................... 297 10.14.1 Selecting URC Mode or Polling Mode ......................................................................... 297 10.14.2 Configuring Socket Listener......................................................................................... 297 10.14.3 Configuring Socket Client for Calling a Socket Listener on Another Host ................... 298 10.14.4 Socket Client Sends Data via TCP Connection (Polling Mode)................................... 298 10.14.5 Socket client sends data via TCP connection with URCs............................................ 299 www..com 10.14.6 Socket Scenario with UDP Endpoint ........................................................................... 299 10.14.7 Configuring and Using FTP Download (URC Mode) ................................................... 301 10.14.8 Configuring and Using FTP Upload (URC Mode)........................................................ 301 10.14.9 Configuring SMPT Service Profile ............................................................................... 302 10.14.10 Sending Email (URC Mode) ........................................................................................ 303 10.14.11 Sending Email (Polling Mode) ..................................................................................... 303 10.14.12 Configuring POP3 Service Profile................................................................................ 304 10.14.13 Retrieving Email (URC Mode) ..................................................................................... 306 10.14.14 Retrieving Email (Polling Mode) .................................................................................. 306 10.14.15 HTTP POST (Polling Mode) ........................................................................................ 307 10.14.16 HTTP GET (Polling Mode)........................................................................................... 308 11. GPRS Commands ................................................................................................................................ 309 11.1 AT+CGACT PDP context activate or deactivate ....................................................................... 309 11.2 AT+CGANS Manual response to a network request for PDP context activation ...................... 311 11.3 AT+CGATT GPRS attach or detach ......................................................................................... 313 11.4 AT+CGAUTO Automatic response to a network request for PDP context activation ............... 314 11.5 AT+CGDATA Enter data state .................................................................................................. 316 11.5.1 Automatic deactivation of PDP context during dial-up PPP......................................... 317 11.6 AT+CGDCONT Define PDP Context ........................................................................................ 318 11.7 AT+CGEQMIN 3G Quality of Service Profile (Minimum acceptable) ........................................ 320 11.8 AT+CGEQREQ 3G Quality of Service Profile (Requested) ...................................................... 324 11.9 AT+CGPADDR Show PDP address ......................................................................................... 328 11.10 AT+CGQMIN Quality of Service Profile (Minimum acceptable) ................................................ 329 11.11 AT+CGQREQ Quality of Service Profile (Requested) .............................................................. 333 11.12 AT+CGREG GPRS Network Registration Status...................................................................... 337 11.13 AT+CGSMS Select service for MO SMS messages ................................................................. 339 11.14 AT^SGACT Query all PDP context activations ......................................................................... 340 11.15 AT^SGAUTH Set type of authentication for PPP connection.................................................... 342 11.16 AT^SGCONF Configuration of GPRS related Parameters ...................................................... 343 11.17 ATA Manual response to a network request for PDP context activation................................... 344 11.18 ATD*99# Request GPRS service.............................................................................................. 345 11.19 ATD*98# Request GPRS IP service ......................................................................................... 346 11.20 ATH Manual rejection of a network request for PDP context activation.................................... 347 11.21 ATS0 Automatic response to a network request for PDP context activation............................. 348 11.22 Using GPRS AT commands (Examples)..................................................................................... 349 11.23 Using the GPRS dial command ATD .......................................................................................... 351 FAX Commands ................................................................................................................................... 352 12.1 FAX parameters .......................................................................................................................... 352
12.
XT65_ATC_V01.001 Confidential / Released
Page 7 of 588
1/9/07
XT65 AT Command Set
Contents
s
12.2 12.3 12.4 12.5 12.6 12.7 12.8 13.
12.1.1 Fax Result Codes ........................................................................................................ 352 AT+FCLASS Fax: Select, read or test service class ................................................................. 353 AT+FRH Receive Data Using HDLC Framing .......................................................................... 354 AT+FRM Receive Data ............................................................................................................. 355 AT+FRS Receive Silence.......................................................................................................... 356 AT+FTH Transmit Data Using HDLC Framing .......................................................................... 357 AT+FTM Transmit Data............................................................................................................. 358 AT+FTS Stop Transmission and Wait ....................................................................................... 359
Short Message Service (SMS) Commands........................................................................................ 360 13.1 SMS parameters ......................................................................................................................... 360 www..com 13.2 AT+CMGC Send an SMS command......................................................................................... 365 13.3 AT+CMGD Delete short message............................................................................................. 366 13.4 AT+CMGF Select SMS message format .................................................................................. 367 13.5 AT+CMGL List SMS messages from preferred store................................................................ 368 13.6 AT+CMGR Read SMS messages ............................................................................................. 370 13.7 AT+CMGS Send Short Message .............................................................................................. 372 13.8 AT+CMGW Write Short Messages to Memory ......................................................................... 374 13.9 AT+CMSS Send short messages from storage ........................................................................ 376 13.10 AT+CNMA New Message Acknowledgement to ME/TE, only phase 2+ .................................. 377 13.11 AT+CNMI New short Message Indication ................................................................................. 378 13.12 AT+CPMS Preferred SMS message storage ............................................................................ 381 13.13 AT+CSCA SMS Service Center Address .................................................................................. 383 13.14 AT+CSCB Select Cell Broadcast Message Indication .............................................................. 384 13.15 AT+CSDH Show SMS text mode parameters........................................................................... 385 13.16 AT+CSMP Set SMS text Mode Parameters.............................................................................. 386 13.17 AT+CSMS Select Message Service.......................................................................................... 388 13.18 AT^SCML List Concatenated Short Messages from preferred store ........................................ 390 13.19 AT^SCMR Read Concatenated Short Messages ..................................................................... 391 13.20 AT^SCMS Send Concatenated Short Messages ...................................................................... 392 13.21 AT^SCMW Write Concatenated Short Messages to Memory ................................................... 393 13.22 AT^SLMS List SMS Memory Storage ....................................................................................... 394 13.23 AT^SMGL List Short Messages from preferred store without setting status to REC READ ..... 395 13.24 AT^SMGO Set or query SMS overflow presentation mode or query SMS overflow ................. 396 13.25 AT^SMGR Read short message without setting status to REC READ ..................................... 398 13.26 AT^SSCONF SMS Command Configuration ........................................................................... 399 13.27 AT^SSDA Set SMS Display Availability .................................................................................... 400 13.28 AT^SSMSS Set Short Message Storage Sequence ................................................................. 401 14. SIM related Commands ....................................................................................................................... 402 14.1 AT+CRSM Restricted SIM Access ............................................................................................ 402 14.2 AT+CSIM Generic SIM Access ................................................................................................. 405 14.3 AT^SATR Query SIM's Answer to Reset Data.......................................................................... 407 14.4 AT^SXSM Extended SIM Access.............................................................................................. 408 14.5 AT^SCKS Query SIM and Chip Card Holder Status ................................................................. 410 14.6 AT^SSET Indicate SIM data ready............................................................................................ 412 14.7 AT^SCID Display SIM card identification number ..................................................................... 413 14.8 AT+CXXCID Display card ID..................................................................................................... 414
XT65_ATC_V01.001 Confidential / Released
Page 8 of 588
1/9/07
XT65 AT Command Set
Contents
s
15.
Remote SIM Access (RSA) Commands ............................................................................................. 415 15.1 AT^SRSA Remote SIM Access Activation ................................................................................ 418 15.2 AT^SRSM Remote SIM Access Message ................................................................................ 422 15.2.1 SAP Request Message Parameters ............................................................................ 425 15.2.2 SAP Response Message Parameters ......................................................................... 425 15.3 Related AT Commands ............................................................................................................... 426 15.3.1 Establishing an RSA Connection in a PC Environment............................................... 426 15.3.2 Bluetooth scenario (SAP) ............................................................................................ 426 15.3.3 Serial Interface Scenario (XSAP) ................................................................................ 427 Application Toolkit (SAT) Commands........................................................................................ 428 16.1 AT^SSTA SAT Interface Activation ........................................................................................... 428 16.2 ^SSTN SAT Notification ............................................................................................................ 430 16.3 AT^SSTGI SAT Get Information ............................................................................................... 431 16.4 AT^SSTR SAT Response ......................................................................................................... 432
16. SIM www..com
17.
Phonebook Commands....................................................................................................................... 433 17.1 Sort Order for Phonebooks ......................................................................................................... 433 17.2 AT+CNUM Read own numbers................................................................................................. 434 17.3 AT+CPBR Read from Phonebook............................................................................................. 435 17.4 AT+CPBS Select phonebook memory storage ......................................................................... 438 17.5 AT+CPBW Write into Phonebook ............................................................................................. 440 17.6 AT^SPBW Write into Phonebook with location report ............................................................... 443 17.7 AT^SDLD Delete the 'last number redial' memory .................................................................... 446 17.8 AT^SPBC Find first matching entry in sorted phonebook ......................................................... 447 17.9 AT^SPBD Purge phonebook memory storage .......................................................................... 448 17.10 AT^SPBG Display phonebook entries in alphabetical order ..................................................... 449 17.11 AT^SPBS Step through the selected phonebook alphabetically ............................................... 452 Audio Commands ................................................................................................................................ 456 18.1 Audio programming model .......................................................................................................... 456 18.2 ATL Set monitor speaker loudness ........................................................................................... 457 18.3 ATM Set monitor speaker mode................................................................................................ 457 18.4 AT+CLVL Loudspeaker volume level........................................................................................ 458 18.5 AT+CMUT Mute control ............................................................................................................ 459 18.6 AT+VTD Tone duration ............................................................................................................. 460 18.7 AT+VTS DTMF and tone generation......................................................................................... 461 18.8 AT^SAIC Audio Interface Configuration .................................................................................... 462 18.9 AT^SNFA Set or query of microphone attenuation .................................................................. 464 18.10 AT^SNFD Set audio parameters to manufacturer default values ............................................. 466 18.11 AT^SNFI Set microphone path parameters .............................................................................. 467 18.12 AT^SNFM Set microphone audio path and power supply......................................................... 468 18.13 AT^SNFO Set audio output (= loudspeaker path) parameter ................................................... 470 18.14 AT^SNFPT Set progress tones ................................................................................................. 472 18.15 AT^SNFS Select audio hardware set ........................................................................................ 473 18.16 AT^SNFTTY Signal TTY/CTM audio mode capability............................................................... 476 18.17 AT^SNFV Set loudspeaker volume ........................................................................................... 477 18.18 AT^SNFW Write audio setting in non-volatile store .................................................................. 478 18.19 AT^SRTC Ring tone configuration ............................................................................................ 479
18.
XT65_ATC_V01.001 Confidential / Released
Page 9 of 588
1/9/07
XT65 AT Command Set
Contents
s
Hardware Related Commands............................................................................................................ 481 19.1 AT+CCLK Real Time Clock....................................................................................................... 481 19.2 AT+CALA Set alarm time ......................................................................................................... 482 19.3 AT^SBC Battery Charge Control ............................................................................................... 485 19.3.1 Responses returned by read command....................................................................... 487 19.4 AT^SBV Battery/Supply Voltage ............................................................................................... 488 19.5 AT^SCTM Set critical operating temperature presentation mode or query temperature........... 489 19.6 AT^SSYNC Configure SYNC Pin .............................................................................................. 492 19.6.1 ME status indicated by status LED patterns ................................................................ 493 19.7 AT^SSPI Serial Protocol Interface ............................................................................................ 495 www..com 19.7.1 Specifying Delay Time for IC ...................................................................................... 497 19.7.2 Selecting SPI Mode ..................................................................................................... 498 19.7.3 Transmitting Data over AT Interface............................................................................ 499 19.7.3.1 Structure of Messages on the IC Bus ......................................................................... 500 19.7.3.2 Structure of Messages on the SPI ............................................................................... 501 19.7.4 Error Handling on the IC Bus...................................................................................... 501 19.7.5 Example: Using IC Bus............................................................................................... 503 19.7.6 Example: Transfer and Response Messages on SPI .................................................. 504 19.8 AT^SWDAC Configure and Read PWM Signal for DAC ........................................................... 505 19.9 AT^SRADC Configure and Read ADC Measurement............................................................... 507 20. GPIO Commands ................................................................................................................................. 510 20.1 AT^SPIO General Purpose IO Driver Open/Close .................................................................... 510 20.2 AT^SCPIN Pin Configuration .................................................................................................... 511 20.3 AT^SCPOL Polling Configuration.............................................................................................. 513 20.4 AT^SCPORT Port Configuration ............................................................................................... 515 20.5 AT^SDPORT Delete a Port Configuration................................................................................. 516 20.6 AT^SGIO Get IO state of a specified pin or port ....................................................................... 517 20.7 AT^SSIO Set IO state of a specified pin or port ........................................................................ 518 20.8 AT^SCCNT Configure Pulse Counter ....................................................................................... 519 20.8.1 Using the Pulse Counter in Limit Counter Mode.......................................................... 520 20.9 AT^SSCNT Start and Stop Pulse Counter ................................................................................ 521 20.9.1 Using the Pulse Counter in Start-Stop Counter Mode ................................................. 522 Java related Commands ..................................................................................................................... 523 21.1 AT^SJRA Run Java Application ................................................................................................ 523 21.2 AT^SJNET Set Dialup Network Access Parameters................................................................. 524 21.3 AT^SJOTAP Over The Air Application Provisioning ................................................................. 527 21.4 AT^SJSEC Write Binary Java Security Data............................................................................. 529 GPS Commands................................................................................................................................... 531 22.1 GPS parameters.......................................................................................................................... 533 22.2 AT^SGPSS GPS Switch ........................................................................................................... 537 22.3 AT^SGPSC GPS Configuration ................................................................................................ 540 22.4 AT^SGPSP GPS URC presentation mode ............................................................................... 544 22.5 AT^SGPSR GPS Read ............................................................................................................. 545 Miscellaneous Commands.................................................................................................................. 546 23.1 A/ Repeat previous command line ............................................................................................ 546 23.2 ATS3 Set command line termination character......................................................................... 547 23.3 ATS4 Set response formatting character .................................................................................. 548
19.
21.
22.
23.
XT65_ATC_V01.001 Confidential / Released
Page 10 of 588
1/9/07
XT65 AT Command Set
Contents
s
23.4 ATS5 Write command line editing character ............................................................................. 549 23.5 AT^SFDL Enter Firmware Download Mode .............................................................................. 550 Appendix .............................................................................................................................................. 552 24.1 Restricted access to SIM data after SIM PIN authentication....................................................... 552 24.2 Star-Hash (*#) Network Commands............................................................................................ 553 24.3 Available AT Commands and Dependency on SIM PIN ............................................................. 556 24.4 Availability of AT Commands Depending on Operating Mode of ME.......................................... 564 24.5 AT Command Settings storable with AT&W................................................................................ 572 24.6 Factory Default Settings Restorable with AT&F .......................................................................... 575 24.7 Summary of Unsolicited Result Codes (URC)............................................................................. 578 www..com 24.8 AT Commands not usable for USB ............................................................................................. 581 24.9 Alphabetical List of AT Commands ............................................................................................. 582 24.
XT65_ATC_V01.001 Confidential / Released
Page 11 of 588
1/9/07
XT65 AT Command Set
List of Tables
s
List of Tables
Table 1.1: Table 1.2: Table 1.3: Table 1.4: Table 1.5: Table 2.1: Table 2.2: www..com Table 2.3: Table 2.4: Table 2.5: Table 2.6: Table 2.7: Table 2.8: Table 2.9: Table 4.1: Table 4.2: Table 10.1: Table 10.2: Table 12.1: Table 19.1: Table 19.2: Table 19.3: Table 19.4: Table 19.5: Table 22.1: Table 24.1: Table 24.2: Table 24.3: Table 24.4: Table 24.5: Table 24.6: Table 24.7: Table 24.8: Table 24.9: Table 24.10: Table 24.11: Table 24.12: Symbols used to mark the type of parameters ........................................................................... 17 Symbols used to indicate the correlations with other commands ............................................... 17 Symbols used to mark different types of default values of parameters ..................................... 17 Types of AT commands and responses .................................................................................... 18 Examples for character definitions depending on alphabet ........................................................ 21 Current configuration on ASC0 / MUX channel 1 / USB (example)............................................ 34 Current configuration on MUX channels 2 and 3 (example) ...................................................... 35 Wake-up events in NON-CYCLIC and CYCLIC SLEEP modes ................................................. 45 General "CME ERROR" Codes (GSM 07.07) .......................................................................... 49 General "CME ERROR" Codes (SIEMENS) ............................................................................ 50 GPRS related "CME ERROR" Codes (GSM 07.07) ................................................................. 50 GPRS related "CME ERROR" Codes (SIEMENS) ................................................................... 50 SMS related "CMS ERROR" Codes (GSM 07.05) ................................................................... 51 GPS related "CME ERROR" Codes (SIEMENS) ...................................................................... 53 Availability of AT Commands on Virtual Channels .................................................................. 120 Summary of AT commands with Different Behavior in Multiplex Mode ................................... 121 Applicability of AT^SICS values ................................................................... 255 Applicability of AT^SISS values ................................................................... 262 Fax Result Codes ..................................................................................................................... 352 Modes of the LED and indicated ME functions......................................................................... 493 Values for calculating the delay ................................................................................................ 497 Special characters for ASCII coding ......................................................................................... 499 Structure of Transfer and Response Messages on the IC bus................................................ 500 Structure of Transfer and Response Messages for SPI ........................................................... 501 Applicability of AT^SGPSC values ............................................................. 540 Star-Hash (*#) Command Overview ........................................................................................ 553 Abbreviations of Codes and Parameters used in Table 24.1 .................................................. 554 Star-Hash Command Response Parameters .......................................................................... 555 Star-Hash Commands for Supplementary Services ................................................................ 555 Available AT Commands and Dependency on SIM PIN........................................................... 556 Availability of AT Commands Depending on Operating Mode of ME ....................................... 564 Settings Stored to User Profile on ASC0 / MUX Channel 1...................................................... 572 Settings Stored to User Profile on MUX Channels 2 and 3 ...................................................... 573 Factory Default Settings Restorable with AT&F ....................................................................... 575 Summary of Unsolicited Result Codes (URC) .......................................................................... 578 AT Commands not usable for USB........................................................................................... 581 Alphabetical List of AT Commands........................................................................................... 582
XT65_ATC_V01.001 Confidential / Released
Page 12 of 588
1/9/07
XT65 AT Command Set
List of Figures
s
List of Figures
Figure 1.1: Figure 1.2: Figure 15.1: Figure 15.2: Figure 15.3: Figure 15.4: Figure 18.1: www..com Figure 19.1: Figure 19.2: Figure 19.4: Figure 19.3: Main character table of GSM 03.38 alphabet ............................................................................. 22 Extension character table of GSM 03.38 alphabet ..................................................................... 23 Basic Remote SIM Access Usage Scenario via Bluetooth ....................................................... 415 Basic Remote SIM Access usage scenario via RS232 ............................................................ 415 SIM usage states of SAP server............................................................................................... 416 SIM usage states of SAP client ................................................................................................ 417 Audio programming model for XT65 Module ............................................................................ 456 Formula for calculating the delay.............................................................................................. 497 Delay time on IC after Write .................................................................................................... 497 SPI modes selectable on SPI ................................................................................................... 498 Delay time on IC after Read .................................................................................................... 498
XT65_ATC_V01.001 Confidential / Released
Page 13 of 588
1/9/07
XT65 AT Command Set
1. Introduction
s
1.
1.1
Introduction
Scope of the document
This document presents the AT Command Set for the Siemens Cellular Engine XT65 Release 01.001. Before using the Cellular Engine or upgrading to a new firmware version please read the latest product information provided in the Release Notes [1].
www..com
More information is available at the Siemens Website: http://www.siemens.com/wm.
XT65_ATC_V01.001 Confidential / Released
Page 14 of 588
1/9/07
XT65 AT Command Set
1.2 Related documents
s
1.2
Related documents
[1] XT65 Release Notes, Version 01.001 [2] XT65 Hardware Interface Description, Version 01.001 [3] Java User's Guide [4] Remote-SAT User's Guide [5] GPRS Startup User's Guide [6] Multiplexer User's Guide [7] Multiplex Driver Developer's Guide for Windows 2000 and Windows XP
www..com [8] Multiplex
Driver Installation Guide for Windows 2000 and Windows XP
[9] Application Note 02: Audio Interface Design [10] Application Note 16: Updating XT65 Firmware [11] Application Note 17: Over-The-Air Firmware Update [12] Application Note 24: Application Developer's Guide [13] Application Note 22: Using TTY / CTM equipment with XT65 [14] Application Note 32: Integrating USB into GSM Applications [15] Application Note 36: GSM Applications with Integrated GPS Receiver [16] SIM Access Profile Interoperability Specification (Revision 1.0), issued by the Bluetooth Special Interest
Group
[17] ISO/IEC10646: "Universal Multiple-Octet Coded Character Set (UCS)"; UCS2, 16 bit coding [18] ITU-T Recommendation V.24: List of definitions for interchange circuits between data terminal equipment
(DTE) and data circuit-terminating equipment (DCE)
[19] ITU-T Recommendation V.250: Serial asynchronous automatic dialling and control [20] 3GPP TS 100 918/EN 300 918 (GSM 02.04): General on supplementary services [21] 3GPP TS 100 907 (GSM 02.30): Man-Machine Interface (MMI) of the Mobile Station (MS) [22] 3GPP TS 23.038 (GSM 03.38): Alphabets and language specific information [23] 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)
[24] 3GPP TS 27.007 (GSM 07.07): AT command set for User Equipment (UE) [25] 3GPP TS 27.060 (GSM 07.60): Mobile Station (MS) supporting Packet Switched Services [26] 3GPP TS 51.011 (GSM 11.11): Specification of the Subscriber Identity Module - Mobile Equipment (SIM -
ME) interface
[27] 3GPP TS 11.14 (GSM 11.14): Specification of the SIM Application Toolkit for the Subscriber Identity Module
- Mobile Equipment (SIM - ME) interface
[28] 3GPP TS 22.101 (GSM 22.101): Service principles [29] Common PCN Handset Specification (CPHS) v4.2 [30] USB.ORG: www.usb.org/developers/docs/USB_LANGIDs.pdf
XT65_ATC_V01.001 Confidential / Released
Page 15 of 588
1/9/07
XT65 AT Command Set
1.3 Document conventions
s
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).
www..com
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 24.3, Available AT Commands and Dependency on SIM PIN uses the same symbols. ASC0: Is the AT command supported on the physical serial interface ASC0? + Yes No Note: In the case of XT65 only "Yes" applies. 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 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 AIRPLANE mode? + Yes No In AIRPLANE mode, not all described functions are available. For example, the test or read command is usable, the write or execute command is not. Furthermore, only some of the listed parameters can be changed in AIRPLANE mode. A typical example is AT^SCFG that controls different features. 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 USB MUX1 MUX2 MUX3 Charge Last
-
+
+
+
-
-
XT65_ATC_V01.001 Confidential / Released
Page 16 of 588
1/9/07
XT65 AT Command Set
1.3 Document conventions
s
1.3.2
Table 1.1:
Superscript notation for parameters and values
Symbols used to mark the type of parameters
Parameter type
Table 1.2:
(num) (str)
Meaning Parameter value must be numeric type Parameter value must be string type
Symbols used to indicate the correlations with other commands
Parameter option www..com
Table 1.3:
(&W) (&V) (SNFW) (+CSCS)
Meaning Parameter value will be stored with AT&W Parameter value will be displayed with AT&V Parameter value will be stored with AT^SNFW Parameter value has to be (is) coded according to current setting of (see AT+CSCS for details)
Symbols used to mark different types of default values of parameters
Value option [x] x x x
(&F) (P) (D)
Meaning Default value: if the parameter is omitted, the value 'x' will be assumed Factory default value, will be restored to 'x' with AT&F Powerup default value of a parameter which is not stored at power down Delivery default value of a parameter which cannot be restored automatically
XT65_ATC_V01.001 Confidential / Released
Page 17 of 588
1/9/07
XT65 AT Command Set
1.4 AT Command Syntax
s
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 Test command
www..com
Syntax AT+CXXX=?
Function The mobile equipment returns the list of parameters and value ranges set with the corresponding Write command or by internal processes. This command returns the currently set value of the parameter or parameters. This command sets user-definable parameter values. The execution command reads non-variable parameters determined by internal processes in the GSM engine.
Read command Write command Exec(ution) command
AT+CXXX? AT+CXXX=<...> AT+CXXX
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. Query current setting Set only the middle parameter Query new setting
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
Example 2: Using default parameter values for optional parameters AT+CFUN=7,0 OK AT+CFUN? +CFUN: 7 OK AT+CFUN= OK +CFUN: 1 OK Activate CYCLIC SLEEP mode, don't reset ME Query ME mode Set ME back to normal (default parameters: 1,0)
XT65_ATC_V01.001 Confidential / Released
Page 18 of 588
1/9/07
XT65 AT Command Set
1.4 AT Command Syntax
s
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 V.250 commands
www..com
Comment with FAX commands (Prefix AT+F) with Siemens commands, Prefix AT^S) To be used standalone To be used standalone To be used standalone
GSM 7.07 commands GSM 7.05 commands (SMS) Commands starting with AT& AT+IPR
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.
XT65_ATC_V01.001 Confidential / Released
Page 19 of 588
1/9/07
XT65 AT Command Set
1.5 Supported character sets
s
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. www..com * 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. The behavior when encountering characters that are not valid characters of the supported alphabets is undefined. Due to the constraints described below it is recommended to prefer the USC2 alphabet in any external application. If the GSM alphabet is selected all characters sent over the serial line (between TE and TA) are in the range from 0 to 127 (7 Bit range). CAUTION: ASCII alphabet (TE) is not GSM alphabet (TA/ME) ! Several problems resulting from the use of GSM alphabet with ASCII terminal equipment: * "@" character with GSM alphabet value 0 is not printable by an ASCII terminal program (e.g. Microsoft(c) Hyperterminal(R)). * "@" 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 "o" (as in "Borse") is assumed to be "|" in ASCII, thus resulting in "B|rse". This is because both alphabets mean different characters with values hex. 7C or 00 and so on. * In addition, decimal 17 and 19 which are used as XON/XOFF control characters when software flow control is activated, are interpreted as normal characters in the GSM alphabet. When you write characters differently coded in ASCII and GSM (e.g. A, O, U), 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.
XT65_ATC_V01.001 Confidential / Released
Page 20 of 588
1/9/07
XT65 AT Command Set
1.5 Supported character sets
s
Table 1.5:
Examples for character definitions depending on alphabet
GSM 03.38 character O " @
GSM character hex. value 5C 22 00
Corresponding ASCII character \ " NULL
ASCII Esc sequence \5C \22 \00
Hex Esc sequence 5C 35 43 5C 32 32 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 meswww..com sages which may contain differently coded characters.
XT65_ATC_V01.001 Confidential / Released
Page 21 of 588
1/9/07
XT65 AT Command Set
1.5 Supported character sets
s
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)
www..com
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 XT65 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 "o" character in GSM alphabet.
XT65_ATC_V01.001 Confidential / Released
Page 22 of 588
1/9/07
XT65 AT Command Set
1.5 Supported character sets
s
www..com
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.
XT65_ATC_V01.001 Confidential / Released
Page 23 of 588
1/9/07
XT65 AT Command Set
1.5 Supported character sets
s
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
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.
www..com
1.5.2.1
Implementing output of SIM data to Terminal (direction TA to TE)
DCS = 7 bit GSM Case 1 GSM (1:1) DCS = 8 bit Data Case 2 8 bit to IRA (1:2) DCS = 16 bit UCS2 Case 3 UCS2 to IRA (2:4) Case 6 UCS2 to IRA (2:4)
Used character set GSM UCS2
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 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"
XT65_ATC_V01.001 Confidential / Released
Page 24 of 588
1/9/07
XT65 AT Command Set
1.5 Supported character sets
s
1.5.2.2
Implementing input of Terminal data to SIM (direction TE to TA)
DCS = 7 bit GSM Case 1 GSM (1:1) DCS = 8 bit Data Case 2 IRA to 8 bit (2:1) DCS = 16 bit UCS2 Case 3 IRA to 16 bit (4:2)
Used character set GSM 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 www..com 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.
XT65_ATC_V01.001 Confidential / Released
Page 25 of 588
1/9/07
XT65 AT Command Set
1.6 Serial Interface Flow Control
s
1.6
Serial Interface Flow Control
Flow control is essential to prevent loss of data or avoid errors when, in a data or fax call, the sending device is transferring data faster than the receiving side is ready to accept. When the receiving buffer reaches its capacity, the receiving device should be capable to cause the sending device to pause until it catches up. There are basically two approaches to regulate data flow: Software flow control and hardware flow control. The High Watermark (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.
www..com
1.6.1
Software Flow Control (XON/OFF Handshake)
Software flow control sends different characters to stop (XOFF, decimal 19) and resume (XON, decimal 17) data flow. The only advantage of software flow control is that three wires would be sufficient on the serial interface.
1.6.2
Hardware Flow Control (RTS/CTS Handshake)
Hardware flow control sets or resets the RTS/CTS wires. This approach is faster and more reliable, and therefore, the better choice. When the 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 or AT+IFC 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 * * Serial interface (ASC0) of the XT65 uses two buffers, one for the uplink and one for the downlink. Each buffer has a capacity of minimum 1024 bytes. Uplink direction (where ME is receiving data from host application): CTS control is based on the filling level of the ME's receive buffer. When the application detects that CTS is being deactivated it must instantly stop sending data to the ME's receive buffer. But still, after deactivation of CTS, the receive buffer of the ME can accept another 512 bytes. Downlink direction (where ME is sending data to host application): The transmit buffer of the ME can hold at least 1024 bytes. After deactivation of RTS the ME sends max. 2 more bytes and then stops transferring data to the application. The maximum time RTS can be kept inactive without losing data is determined by the buffer size and the maximum possible over-the-air data rate. In any case, the local data rate between DCE and DTE (AT+IPR) should be set to a value higher than the maximum possible over-the-air data rate. Buffer size recommended for the host application: Just like the ME, the host application should include send and receive buffers for each serial interface. To handle large amounts of data at high speed a buffer capacity of 1024 bytes is recommended. If the host application is designed mainly for one direction (uplink or downlink) a lower buffer size will do for the direction where less data is transferred. In fact, the optimal size of the host application buffers is a matter of finding the balance between the amount
*
*
XT65_ATC_V01.001 Confidential / Released
Page 26 of 588
1/9/07
XT65 AT Command Set
1.6 Serial Interface Flow Control
s
of data, data throughput, reaction time of the application when handling the buffer, processor performance and available memory. To give an example, a small buffer size (such as 256 bytes) increases the frequency of deactivating RTS/CTS and the frequency of flushing the buffer, thus diminishing the efficiency of the application. Also, please consider that RTS/CTS flow control cannot stop the data stream coming from the network, e.g. in a GPRS or fax connection. So the lack of appropriate hardware flow control increases the risk of losing data packets if, like in the case of UDP, the connection protocol has no or only minimum error handling functions. Other network protocols are using high level flow control mechanisms. For example, to prevent loss of data the TCP protocol uses retransmission algorithms, fax applications usually repeat the transfer of faulty pages.
www..com
XT65_ATC_V01.001 Confidential / Released
Page 27 of 588
1/9/07
XT65 AT Command Set
1.7 Communication between Customer Application and XT65
s
1.7
Communication between Customer Application and XT65
Leaving hardware flow control unconsidered the Customer Application (TE) is coupled with the XT65 (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 XT65 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 www..com gives the XT65 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 XT65 using activated echo (ATE1), i.e. the XT65 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.
XT65_ATC_V01.001 Confidential / Released
Page 28 of 588
1/9/07
XT65 AT Command Set
1.8 Unsolicited Result Code Presentation
s
1.8
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 24.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 www..com 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 stronglyrecommended to use the multiplex mode to map logical communication channels onto the serial line of the XT65, for details refer to [6] 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" If autobauding is enabled (AT+IPR=0), URCs generated after restart will be output with 115200 bps until the ME has detected the current bit rate. The URCs "^SYSSTART", "^SYSSTART ", however, are not presented at all. For details please refer to Section 4.9.1, Autobauding. To avoid problems we recommend to configure a fixed bit rate rather than using autobauding.
XT65_ATC_V01.001 Confidential / Released
Page 29 of 588
1/9/07
XT65 AT Command Set
1.9 Common PCN Handset Specification (CPHS)
s
1.9
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 Alternate Line Service Voice Message Waiting Indication
www..com
Description/Remarks Using two phone numbers with one SIM card.
AT command AT^SALS
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" Read specific Elementary Files (6F14h, 6F18h) from SIM. AT+CRSM
Operator (Service provider) name from SIM
Network and Service Pro- Lock/Unlock an ME to specific HPLMN and service provider. AT+CLCK, vider Lock (AT+CPIN) Call Forwarding Customer Service Profile (CSP) Information numbers Get and set diverted call status. Access specific Elementary File (6F13h) from SIM. Setting services and their menu entries depending on customer profiles. Hierarchically structured service numbers phonebook on SIM according to CPHS 4.2 (mandatory). AT+CCFC, AT+CRSM AT+CRSM AT+CRSM
XT65_ATC_V01.001 Confidential / Released
Page 30 of 588
1/9/07
XT65 AT Command Set
1.10 Errors and Messages
s
1.10
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 www..com wrong command syntax may result in errors: For example, using the execute command syntax although the command has no execute format, causes "ERROR" to be returned. Likewise, using the write command syntax although the command has no write format causes "+CME ERROR: " to be returned.
See also: * Section 2.12.1, CME/CMS Error Code Overview * Section 2.5.1, Verbose and numeric result codes * Section 3.4, AT+CEER
XT65_ATC_V01.001 Confidential / Released
Page 31 of 588
1/9/07
XT65 AT Command Set
2. Configuration Commands
s
2.
Configuration Commands
The AT Commands described in this chapter allow the external application to determine the XT65's behaviour under various conditions.
2.1
AT&F sets www..com
AT&F Set all current parameters to manufacturer defaults
all current parameters to the manufacturer defined profile. All defined GPRS contexts which are not activated or not online will be undefined if the non volatile storage of CGDCONT settings is not activated by the AT^SCFG parameter "GPRS/PersistentContexts" (see AT+CGDCONT).
Syntax
Exec Command
AT&F[]
Response(s)
OK
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
Parameter Description
(num) [0] Set all TA parameters to manufacturer defaults
Notes
* * * List of parameters reset to manufacturer default can be found in Section 24.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.
XT65_ATC_V01.001 Confidential / Released
Page 32 of 588
1/9/07
XT65 AT Command Set
2.2 AT&V
s
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 www..com
PROFILE: ... (see Section 2.2.1, AT&V responses) OK
PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
Reference(s)
V.250
-
+
+
+
-
+
-
Parameter Description
(num) [0] Profile number
Notes
* * The value of \Q (flow control) is also determined by the AT+IFC command. In case the value set by AT+IFC cannot be represented by a \Q equivalent, \Q255 will be displayed. The parameters of AT^SMGO can only be displayed after the SMS data from the SIM have been read successfully for the first time. Reading starts after successful SIM authentication has been performed, and may take up to 30 seconds depending on the SIM used. While the read process is in progress, an attempt to read the parameter will result in empty values. The parameter of AT+CSDH will only be displayed in SMS PDU mode, see AT+CMGF.
*
XT65_ATC_V01.001 Confidential / Released
Page 33 of 588
1/9/07
XT65 AT Command Set
2.2 AT&V
s
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 / USB (example)
PIN authentication done ACTIVE PROFILE: E1 Q0 V1 X4 &C1 &D2 &S0 \Q0 \V1 S0:000 S3:013 S4:010 S5:008 S6:000 S7:060 S8:000 S10:002 S18:000 www..com 7,0,1 +CBST: +CRLP: 61,61,78,6 +CR: 0 +FCLASS: 0 +CRC: 0 +CMGF: 1 +CSDH: 0 +CNMI: 0,0,0,0,1 +ICF: 3 +IFC: 0,0 +ILRR: 0 +IPR: 115200 +CMEE: 2 ^SMGO: 0,0 +CSMS: 0,1,1,1 ^SACM: 0,"000000","000000" ^SLCC: 0 ^SCKS: 0,1 ^SSET: 0 +CREG: 0,1 +CLIP: 0,2 +CAOC: 0 +COPS: 0,0,"operator" +CGSMS: 3 OK
No PIN authentication ACTIVE PROFILE: E1 Q0 V1 X4 &C1 &D2 &S0 \Q0 \V1 S0:000 S3:013 S4:010 S5:008 S6:000 S7:060 S8:000 S10:002 S18:000 +CBST: 7,0,1 +CRLP: 61,61,78,6 +CR: 0 +FCLASS: 0 +ICF: 3 +IFC: 0,0 +ILRR: 0 +IPR: 115200 +CMEE: 2 ^SCKS: 0,1 ^SSET: 0 OK
XT65_ATC_V01.001 Confidential / Released
Page 34 of 588
1/9/07
XT65 AT Command Set
2.2 AT&V
s
Table 2.2:
Current configuration on MUX channels 2 and 3 (example)
PIN authentication done ACTIVE PROFILE: E1 Q0 V1 X4 &C1 &D0 &S0 \Q0 \V1 S0:000 S3:013 S4:010 S5:008 +CR: 0 +CRC: 0 +CMGF: 1 +CSDH: 0 +CNMI: 0,0,0,0,1 +ICF: 3 +IFC: www..com0,0 +ILRR: 0 +IPR: 115200 +CMEE: 2 ^SMGO: 0,0 +CSMS: 0,1,1,1 ^SACM: 0,"000000","000000" ^SLCC: 0 ^SCKS: 0,1 ^SSET: 0 +CREG: 0,1 +CLIP: 0,2 +CAOC: 0 +COPS: 0,0,"operator" +CGSMS: 3 OK
No PIN authentication ACTIVE PROFILE: E1 Q0 V1 X4 &C1 &D0 &S0 \Q0 \V1 S0:000 S3:013 S4:010 S5:008 +CR: 0 +ICF: 3 +IFC: 0,0 +ILRR: 0 +IPR: 115200 +CMEE: 2 ^SCKS: 0,1 ^SSET: 0 +CGSMS: 3 OK
XT65_ATC_V01.001 Confidential / Released
Page 35 of 588
1/9/07
XT65 AT Command Set
2.3 AT&W
s
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 www..com
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
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 24.5, AT Command Settings storable with AT&W.
XT65_ATC_V01.001 Confidential / Released
Page 36 of 588
1/9/07
XT65 AT Command Set
2.4 ATQ
s
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: www..com OK If =1: (none)
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
Parameter Description
(num)(&W)(&V) [0](&F) 1 DCE transmits result code Result codes are suppressed and not transmitted
Note
* If Java is running, the firmware will ignore the command. Responses will be invalid or result in "ERROR". See also "XT65 Java User's Guide" [3], Section "Configuring serial interface".
XT65_ATC_V01.001 Confidential / Released
Page 37 of 588
1/9/07
XT65 AT Command Set
2.5 ATV
s
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 www..com ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
Parameter Description
(num)(&W)(&V) [0] 1(&F) Information response: Short result code format: Information response: Long result code format:
2.5.1
OK CONNECT RING NO CARRIER ERROR NO DIALTONE BUSY
Verbose and numeric result codes
Numeric format 0 1 2 3 4 6 7 47 48 49 50 Meaning Command executed, no errors Link established Ring detected Link not established or disconnected Invalid command or command line too long No dial tone, dialling impossible, wrong mode Remote station busy Link with 2400 bps and Radio Link Protocol Link with 4800 bps and Radio Link Protocol Link with 9600 bps and Radio Link Protocol Link with 14400 bps and Radio Link Protocol Alerting at called phone Mobile phone is dialing
Verbose format
CONNECT 2400/RLP CONNECT 4800/RLP CONNECT 9600/RLP CONNECT 14400/RLP ALERTING DIALING
XT65_ATC_V01.001 Confidential / Released
Page 38 of 588
1/9/07
XT65 AT Command Set
2.6 ATX
s
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 www..com ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
Parameter Description
(num)(&W)(&V) [0] 1 2 3 4(&F) CONNECT result code only returned, dial tone and busy detection are both disabled. CONNECT result code only returned, dial tone and busy detection are both disabled. CONNECT result code returned, dial tone detection is enabled, busy detection is disabled. CONNECT result code returned, dial tone detection is disabled, busy detection is enabled. CONNECT result code returned, dial tone and busy detection are both enabled.
XT65_ATC_V01.001 Confidential / Released
Page 39 of 588
1/9/07
XT65 AT Command Set
2.7 AT\V
s
2.7
Syntax
AT\V Set CONNECT result code format
Exec Command
AT\V[]
Response(s)
OK ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
www..com V.250
-
+
+
+
-
-
-
+
-
Parameter Description
(num)(&W)(&V) [0] 1
(&F)
CONNECT result code returned without RLP trailer CONNECT result code returned with RLP trailer
Notes
* * For circuit switched data calls only. Output only if ATX parameter is set with value > 0.
XT65_ATC_V01.001 Confidential / Released
Page 40 of 588
1/9/07
XT65 AT Command Set
2.8 ATZ
s
2.8
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 if the non volatile storage of CGDCONT settings is not activated by the AT^SCFG parameter "GPRS/PersistentContexts" (see AT+CGDCONT). The user defined profile is stored to the non-volatile memory.
Syntax
Exec Command
www..com ATZ[]
Response(s)
OK
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
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.
XT65_ATC_V01.001 Confidential / Released
Page 41 of 588
1/9/07
XT65 AT Command Set
2.9 AT+CFUN
s
2.9
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 on the GSM unit of the ME or toreturn to full functionality. Intended for power saving, SLEEP mode reduces the functionality of the ME to a minimum and thus minimizes the current consumption. The XT65 employs two power saver systems, one for the GSM unit and one for the GPS receiver. On the GSM unit, power saving is controlled by AT+CFUN as described below. On the GPS receiver it can be set using the AT^SGPSS command in AT command mode, or the UBX protocol in Transparent mode. For an efficent power saving scheme the needs of both systems and their correlations shall be taken into consideration. For example, it is important to know that power saving does not take effect if set only on the GSM unit (AT+CFUN=0 or 7 or 9), and not www..com on the GPS receiver. Please refer to the "Application Note 36: GSM Applications with Integrated GPS Receiver" which discusses various strategies to minimize the module's power consumption. Further information, particularly power supply ratings during the various operating modes and the timing of hardware signals in GSM SLEEP mode can be found in the "XT65 Hardware Interface Description, Version 01.001". On the ME's GSM unit, SLEEP mode falls in two categories: * NON-CYCLIC SLEEP mode =0 * and CYCLIC SLEEP modes, selectable as = 7 or 9. NON-CYCLIC SLEEP mode permanently blocks the serial interface. The benefit of the CYCLIC SLEEP mode is that the serial interface remains accessible and that, in intermittent wake-up periods, characters can be sent or received without terminating the selected mode. This allows the ME to wake up for the duration of an event and, afterwards, to resume power saving. Please refer to Section 2.9.1, Wake up the ME from SLEEP mode for a summary of all SLEEP modes and the different ways of waking up the module. For CYCLIC SLEEP mode both the ME and the application must be configured to use hardware flow control. This is necessary since the CTS signal is set/reset every 0.9-2.7 seconds in order to indicate to the application when the UART is active. The default setting of hardware flow control is AT\Q0 which must be altered to AT\Q3. For use after restart you are advised to add it to the user profile saved with AT&W. SLEEP mode management if Java is started: The Java Virtual Machine remains active, but also enters the SLEEP mode. AT commands can be sent from the Java application to the serial interface, no matter which SLEEP mode was selected. This allows you to control the ME even if it is in NON-CYCLIC SLEEP mode. 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
XT65_ATC_V01.001 Confidential / Released
Page 42 of 588
1/9/07
XT65 AT Command Set
2.9 AT+CFUN
s
PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
Reference(s)
GSM 07.07
-
+
+
-
+
-
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.
www..com
If the ME is configured to enter the Airplane mode after restart or reset the following URC is received on bootup: "^SYSSTART AIRPLANE MODE". In this mode, only the AT commands listed in Section 24.4, Availability of AT Commands Depending on Operating Mode of ME can be used. For details please refer to the AT^SCFG command, parameter .
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 is the AT interface fully accessible. Only the AT commands listed in Section 24.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. Due to the fact that the serial interface is disabled, this mode cannot be used if a Remote SIM Access (RSA) connection is ongoing (reason: during RSA connections the SIM communication is routed via a serial channel). The first wake-up event stops power saving and takes the ME back to full functionality level =1. 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. If the ME is NON-CYCLIC SLEEP mode, =1 can also be sent by the Java application. 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. 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. 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). The ME exits SLEEP mode only, if AT+CFUN=1 is entered. The benefit of AT+CFUN=9 is that it provides two additional features: * Waking up the ME temporarily by asserting RTS.
[1](&F)(P)
7
9
XT65_ATC_V01.001 Confidential / Released
Page 43 of 588
1/9/07
XT65 AT Command Set
2.9 AT+CFUN
s
* Waking up the ME temporarily by an internal interrupt driven from the GPS receiver when GPS is run in Transparent mode. This option makes AT+CFUN=9 the best choice for the XT65 module to minimize the power consumption both on the GSM unit and on the GPS receiver. To take advantage of this function first activate power saving on the GSM unit with AT+CFUN=9, then set all UBX protocol parameters required for power saving in Transparent mode. Please note that the interrupt is effective only in Transparent mode, but not in AT command mode. For further detail please refer to the "Application Note 36: GSM Applications with Integrated GPS Receiver".
(num)
www..com
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] 1 Placeholder for as stated above. ME resets and restarts to full functionality. After reset and restart, PIN 1 authentication is necessary (AT+CPIN). If autobauding is enabled, it is recommended to wait 3 to 5 seconds before entering the first AT command. For details on autobauding refer to Section 4.9.1, Autobauding.
Notes
* * 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 [6], Section "Power saving control". If the host application uses the USB interface, power saving must be configured both on the XT65 module and on the USB host, i.e. the USB host must be set to Suspend mode (usually Selective or Global Suspend). Otherwise, if you change only the AT+CFUN parameters, the selected level will be accepted but the active USB keeps the module alive and thus prevents power saving until the USB plug is disconnected. Vice versa, if the module is in SLEEP mode restarting the USB will cause the module to stop power saving although the selected CFUN level does not change. When a circuit-switched call is in progress, =7 or 9 can be activated without terminating the call. However, setting =0 during a circuit-switched call immediately disconnects this call. To check whether power saving is on, you can query the status with the read command AT+CFUN? only if the module is in full functionality mode or in CYCLIC SLEEP mode. If available, you can also take advantage of the status LED controlled by the SYNC pin (see AT^SSYNC and [2]). With AT^SSYNC you can select different modes of LED signalization during SLEEP modes (see Section 19.6.1, ME status indicated by status LED patterns for details). However, the module can wake up temporarily from power saving without leaving its CYCLIC SLEEP mode (without changing +CFUN ""), e.g. for a network scan after a loss of radio coverage, or after receipt of serial data during CYCLIC SLEEP mode. During this "temporary wakeup state" the LED will operate as if the ME was in full functionality mode. Recommendation: In NON-CYCLIC SLEEP mode, you can set an RTC alarm to wake up the ME and return to full functionality. This is a useful approach because, in this mode, the AT interface is not accessible.
*
* *
*
XT65_ATC_V01.001 Confidential / Released
Page 44 of 588
1/9/07
XT65 AT Command Set
2.9 AT+CFUN
s
2.9.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.
Wake-up events in NON-CYCLIC and CYCLIC SLEEP modes
www..com
Table 2.3:
Event Ignition line RTS0
Selected mode: =0 No effect Quit
Selected mode: =7 or 9 No effect Mode 7: No effect (RTS is only used for flow control) Mode 9: Temporary Mode 7: Interrupt not effective Mode 9: Temporary Temporary Temporary Temporary
Internal interrupt driven by GPS receiver Unsolicited Result Code (URC) Incoming voice or data call Any AT command (incl. outgoing SMS, voice or data call) Incoming SMS (AT+CNMI is set to 0,0 (this is the default setting) Incoming SMS (AT+CNMI is set to 1,1) GPRS data transfer
Interrupt not effective Quit Quit From Java: Yes Without Java: Not possible (UART disabled) No effect Quit From Java: Yes Without Java: Not possible (UART disabled) Quit From Java: Yes Without Java: Not possible (UART disabled) Quit
No effect Temporary Temporary
RTC alarm line AT+CFUN=1
Temporary Quit
Java terminates
Temporary
XT65_ATC_V01.001 Confidential / Released
Page 45 of 588
1/9/07
XT65 AT Command Set
2.10 AT^SMSO
s
2.10
AT^SMSO Switch off mobile station
AT^SMSO initiates the power-off procedure. High level of the module's PWR_IND 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 PWR_IND is high or until the URC "^SHUTDOWN" is displayed. Otherwise, you run the risk of losing data. For further details on how to turn off the module see the [2].
Syntax
Test Command
AT^SMSO=?
www..com Response(s)
OK
Exec Command
AT^SMSO
Response(s)
^SMSO: MS OFF OK ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
SIEMENS
-
+
+
+
+
+
-
+
+
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 the module is in NORMAL mode and the charger is connected to the VCHARGE line, the AT^SMSO command causes the module to shut down shortly and then start into the CHARGE ONLY mode. If the module is in CHARGE ONLY mode the AT^SMSO command is not supported at all. In both cases, the module can only be switched off by disconnecting the charger. See also [2].
*
XT65_ATC_V01.001 Confidential / Released
Page 46 of 588
1/9/07
XT65 AT Command Set
2.11 AT+GCAP
s
2.11
AT+GCAP Request complete TA capabilities list
AT+GCAP returns a list of additional capabilities.
Syntax
Test Command
AT+GCAP=?
Response(s)
OK
www..com Exec Command
AT+GCAP
Response(s)
+GCAP: OK
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
Parameter Description
(str) e.g.: +CGSM,+FCLASS
Note
* +CGSM: The response text shows which GSM commands of the ETSI standard are supported.
XT65_ATC_V01.001 Confidential / Released
Page 47 of 588
1/9/07
XT65 AT Command Set
2.12 AT+CMEE
s
2.12
AT+CMEE Mobile Equipment Error Message Format
AT+CMEE controls the format of the error result codes that indicates errors related to XT65 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.8, 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.
www..com Syntax
Test Command
AT+CMEE=?
Response(s)
+CMEE: (list of supporteds) OK
Read Command
AT+CMEE?
Response(s)
+CMEE: OK
Write Command
AT+CMEE=
Response(s)
OK ERROR +CME ERROR:
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
GSM 07.07
-
+
+
+
+
+
-
+
-
Parameter Description
(num)(&W)(&V) 0(&F)(D) 1 2 Disable result code, i.e. only "ERROR" will be displayed. Enable error result code with numeric values. Enable error result code with verbose (string) values.
Example
To obtain enhanced error messages it is recommended to choose =2. AT+CMEE=2 OK
XT65_ATC_V01.001 Confidential / Released
Page 48 of 588
1/9/07
XT65 AT Command Set
2.12 AT+CMEE
s
2.12.1
Table 2.4:
CME/CMS Error Code Overview
General "CME ERROR" Codes (GSM 07.07)
Code 0 1 2 3 4
www..com
Text (if AT+CMEE=2) phone failure no connection to phone phone-adapter link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy SIM wrong Incorrect password SIM PIN2 required SIM PUK2 required Memory full invalid index not found Memory failure text string too long invalid characters in text string dial string too long invalid characters in dial string no network service Network timeout Network not allowed emergency calls only Network personalization PIN required Network personalization PUK required Network subset personalization PIN required Network subset personalization PUK required service provider personalization PIN required service provider personalization PUK required Corporate pe sonalization PIN required Corporate personalization PUK required Master Phone Code required unknown service option not supported
5 6 7
10 11 12 13 14 15 16 17 18 20 21 22 23 24 25 26 27 30 31 32 40 41 42 43 44 45 46 47 48 100 132
XT65_ATC_V01.001 Confidential / Released
Page 49 of 588
1/9/07
XT65 AT Command Set
2.12 AT+CMEE
s
Code 133 134 256 257 258 259 260
www..com
Text (if AT+CMEE=2) requested service option not subscribed service option temporarily out of order Operation temporary not allowed call barred phone busy user abort invalid dial string ss not executed SIM blocked Invalid Block
General "CME ERROR" Codes (SIEMENS)
261 262 263
Table 2.5:
Code 615 616 639 640 764 765 767 769 770 771 772
Table 2.6:
Text (if AT+CMEE=2) network failure network is down service type not yet available operation of service temporary not allowed missing input value invalid input value operation failed unable to get control of required module SIM invalid - network reject call setup in progress SIM powered down
GPRS related "CME ERROR" Codes (GSM 07.07)
Code 103 106 107 111 112 113 148 149 150
Table 2.7:
Text (if AT+CMEE=2) Illegal MS Illegal ME GPRS services not allowed PLMN not allowed Location area not allowed Roaming not allowed in this location area unspecified GPRS error PDP authentication failure invalid mobile class
GPRS related "CME ERROR" Codes (SIEMENS)
Code 578 588 594 595
Text (if AT+CMEE=2) GPRS - unspecified activation rejection GPRS - feature not supported GPRS - invalid address length GPRS - invalid character in address string
XT65_ATC_V01.001 Confidential / Released
Page 50 of 588
1/9/07
XT65 AT Command Set
2.12 AT+CMEE
s
Code 596 607 625 630 632 633 643
www..com
Text (if AT+CMEE=2) GPRS - invalid cid value GPRS - missing or unknown APN GPRS - pdp type not supported GPRS - profile (cid) not defined GPRS - QOS not accepted GPRS - QOS validation fail GPRS - unknown PDP address or type GPRS - unknown PDP context GPRS - QOS invalid parameter
SMS related "CMS ERROR" Codes (GSM 07.05)
644 646
Table 2.8:
Code 1 8 10 21 27 28 29 30 38 41 42 47 50 69 81 95 96 97 98 99 111 127 128 129 130 143 144 145 159 160
Text (if AT+CMEE=2) Unassigned (unallocated) number Operator determined barring Call barred Short message transfer rejected Destination out of service Unidentified subscriber Facility rejected Unknown subscriber Network out of order Temporary failure Congestion Resources unavailable, unspecified Requested facility not subscribed Requested facility not implemented Invalid short message transfer reference value Invalid message, unspecified Invalid mandatory information Message type non-existent or not implemented Message not compatible with short message protocol state Information element non-existent or not implemented Protocol error, unspecified Interworking, unspecified Telematic interworking not supported Short message Type 0 not supported Cannot replace short message Unspecified TP-PID error Data coding scheme (alphabet) not supported Message class not supported Unspecified TP-DCS error Command cannot be actioned
XT65_ATC_V01.001 Confidential / Released
Page 51 of 588
1/9/07
XT65 AT Command Set
2.12 AT+CMEE
s
Code 161 175 176 192 193 194 195
www..com
Text (if AT+CMEE=2) Command unsupported Unspecified TP-Command error TPDU not supported SC busy No SC subscription SC system failure Invalid SME address Destination SME barred SM Rejected-Duplicate SM TP-VPF not supported TP-VP not supported D0 SIM SMS storage full No SMS storage capability in SIM Error in MS Memory Capacity Exceeded SIM Application Toolkit Busy SIM data download error Unspecified error cause ME failure SMS service of ME reserved Operation not allowed Operation not supported Invalid PDU mode parameter Invalid text mode parameter SIM not inserted SIM PIN required PH-SIM PIN required SIM failure SIM busy SIM wrong SIM PUK required SIM PIN2 required SIM PUK2 required Memory failure Invalid memory index Memory full SMSC address unknown no network service Network timeout NO +CNMA ACK EXPECTED Unknown error User abort
196 197 198 199 208 209 210 211 212 213 255 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 322 330 331 332 340 500 512
XT65_ATC_V01.001 Confidential / Released
Page 52 of 588
1/9/07
XT65 AT Command Set
2.12 AT+CMEE
s
Code 513 514 515 516 517 519 520
www..com
Text (if AT+CMEE=2) unable to store invalid status invalid character in address string invalid length invalid character in pdu invalid length or character invalid character in text timer expired Operation temporary not allowed SIM not ready Cell Broadcast error unknown PS busy invalid parameter incorrect PDU length invalid message type indication (MTI) invalid (non-hex) chars in address incorrect PDU length (UDL) incorrect SCA length
GPS related "CME ERROR" Codes (SIEMENS)
521 522 532 534 535 538 549 550 551 553 554
Table 2.9:
Code 780 781 782 783 784 785
Text (if AT+CMEE=2) GPS - Invalid parameter GPS - Busy GPS - general error GPS - invalid mode GPS - invalid data GPS - No satellite data
XT65_ATC_V01.001 Confidential / Released
Page 53 of 588
1/9/07
XT65 AT Command Set
2.13 AT+CSCS
s
2.13
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
www..com AT+CSCS=?
Response(s)
+CSCS: (list of supporteds) OK
Read Command
AT+CSCS?
Response(s)
+CSCS: OK
Write Command
AT+CSCS=[]
Response(s)
OK
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
GSM 07.07, GSM 11.11
-
+
+
+
+
+
-
+
-
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. 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.
"UCS2"
XT65_ATC_V01.001 Confidential / Released
Page 54 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
2.14
AT^SCFG Extended Configuration Settings
AT^SCFG can be used to query and configure various settings of the XT65. 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 character set, 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. www..com * "+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: incorrect password" A given password was not correct. * "+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: "AutoExec" , (list of supported ), (list of supported ), (list of supported ), (list of supported ), (max. string length of ), (time range of ) ^SCFG: "GPRS/ATS0/withAttach", (list of supported s) ^SCFG: "GPRS/AutoAttach", (list of supported s) ^SCFG: "GPRS/PersistentContexts", (list of supported s) ^SCFG: "GPRS/RingOnIncomingData", (list of supported s) ^SCFG: "MEopMode/Airplane", (list of supported s) ^SCFG: "MEopMode/Airplane/OnStart", (list of supported s) ^SCFG: "MEShutdown/OnIgnition", (list of supported s) ^SCFG: "PowerSaver/Mode9/Timeout", (list of supported s) ^SCFG: "Radio/Band", (list of supported s), (list of supported s) ^SCFG: "Radio/OutputPowerReduction", (list of supported s) ^SCFG: "Serial/USB/DDD" , (list of supported s) , (list of supported s) , (max. string length of ) , (max. string length of ) , (max. string length of ) , (max. string length of ) , (max. string length of ) , (max. string length of ) ^SCFG: "Tcp/BufSize", (list of supported ) ^SCFG: "Tcp/IRT", (list of supported ) ^SCFG: "Tcp/MR", (list of supported ) ^SCFG: "Tcp/OT", (list of supported ) ^SCFG: "Tcp/WithURCs", (list of supported ) ^SCFG: "Trace/Syslog/OTAP", (list of supported ) ^SCFG: "URC/CallStatus/CIEV", (list of supported s) ^SCFG: "URC/CallStatus/SLCC", (list of supported s) ^SCFG: "URC/Datamode/Ringline", (list of supported s) ^SCFG: "URC/Ringline", (list of supported s)
XT65_ATC_V01.001 Confidential / Released
Page 55 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(Continued)
Test Command
AT^SCFG=?
Response(s)
^SCFG: "URC/Ringline/ActiveTime", (list of supported s) ^SCFG: "Userware/Autostart", (list of supported s) ^SCFG: "Userware/Autostart/AppName", (max. string lengths of ) ^SCFG: "Userware/Autostart/Delay", (list of supported s) ^SCFG: "Userware/Passwd", (max. string length of ) ^SCFG: "Userware/DebugInterface", (), (), () ^SCFG: "Userware/Mode", (list of supported ), (length of ), (range of supported values) www..com ^SCFG: "Userware/Stdout", (list of supported ), (list of supported ), (), (list of supported ) OK
Read Command
AT^SCFG?
Response(s)
^SCFG: "AutoExec" , , , , , [, , ] ^SCFG: "GPRS/ATS0/withAttach", ^SCFG: "GPRS/AutoAttach", ^SCFG: "GPRS/PersistentContexts", ^SCFG: "GPRS/RingOnIncomingData", ^SCFG: "MEopMode/Airplane", ^SCFG: "MEopMode/Airplane/OnStart", ^SCFG: "MEShutdown/OnIgnition", ^SCFG: "PowerSaver/Mode9/Timeout", ^SCFG: "Radio/Band", , ^SCFG: "Radio/OutputPowerReduction", ^SCFG: "Serial/USB/DDD" , , , , , , , , ^SCFG: "Tcp/BufSize", ^SCFG: "Tcp/IRT", ^SCFG: "Tcp/MR", ^SCFG: "Tcp/OT", ^SCFG: "Tcp/WithURCs", ^SCFG: "Trace/Syslog/OTAP", ^SCFG: "URC/CallStatus/CIEV", ^SCFG: "URC/CallStatus/SLCC", ^SCFG: "URC/Datamode/Ringline", ^SCFG: "URC/Ringline", ^SCFG: "URC/Ringline/ActiveTime", ^SCFG: "Userware/Autostart", ^SCFG: "Userware/Autostart/AppName", ^SCFG: "Userware/Autostart/Delay", ^SCFG: "Userware/Passwd" ^SCFG: "Userware/DebugInterface", , , ^SCFG: "Userware/Mode" ^SCFG: "Userware/Stdout", [, [, [, ]]] OK
XT65_ATC_V01.001 Confidential / Released
Page 56 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
Write Command
Automatic AT command execution AT^SCFG="AutoExec" , , , [, , [, ]]
Response(s)
^SCFG: "AutoExec" , , , , , [, , ] OK ERROR +CME ERROR
Write Command www..com
GPRS ATS0 with automatic attach AT^SCFG="GPRS/ATS0/withAttach"[, ]
Response(s)
^SCFG: "GPRS/ATS0/withAttach", OK ERROR +CME ERROR
Write Command
Automatic GPRS attach AT^SCFG="GPRS/AutoAttach"[, ]
Response(s)
^SCFG: "GPRS/AutoAttach", OK ERROR +CME ERROR
Write Command
Persistent GPRS contexts AT^SCFG="GPRS/PersistentContexts"[, ]
Response(s)
^SCFG: "GPRS/PersistentContexts", OK ERROR +CME ERROR
Write Command
Ring on incoming GPRS IP data packets AT^SCFG="GPRS/RingOnIncomingData"[, ]
Response(s)
^SCFG: "GPRS/RingOnIncomingData", OK ERROR +CME ERROR
Write Command
Enable/disable Airplane mode during operation AT^SCFG="MEopMode/Airplane"[, ]
Response(s)
^SCFG: "MEopMode/Airplane", OK
XT65_ATC_V01.001 Confidential / Released
Page 57 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(Continued)
Write Command
Enable/disable Airplane mode during operation AT^SCFG="MEopMode/Airplane"[, ]
Response(s)
ERROR +CME ERROR
Write Command
Airplane mode upon ME restart AT^SCFG="MEopMode/Airplane/OnStart"[, ]
Response(s) www..com
^SCFG: "MEopMode/Airplane/OnStart", OK ERROR +CME ERROR
Write Command
Enable/disable shutdown by ignition line AT^SCFG="MEShutdown/OnIgnition"[, ]
Response(s)
^SCFG: "MEShutdown/OnIgnition", 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
Radio output power reduction AT^SCFG="Radio/OutputPowerReduction"[, ]
Response(s)
^SCFG: "Radio/OutputPowerReduction", OK ERROR +CME ERROR
Write Command
Radio band selection AT^SCFG="Radio/Band"[, ][, ]
Response(s)
^SCFG: "Radio/Band", , OK ERROR +CME ERROR
XT65_ATC_V01.001 Confidential / Released
Page 58 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
Write Command
Configuration of TCP parameter 'BufSize': AT^SCFG="Tcp/BufSize"[, ]
Response(s)
^SCFG: "Tcp/BufSize", OK ERROR +CME ERROR
Write Command
www..com
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
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
Tracing: AT^SCFG="Trace/Syslog/OTAP"[, ]
Response(s)
^SCFG: "Trace/Syslog/OTAP", SYSLOG ENABLED ERROR +CME ERROR
XT65_ATC_V01.001 Confidential / Released
Page 59 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
Write Command
USB Device Descriptor: AT^SCFG="Serial/USB/DDD" [, , [], [], , , [], [], []]
Response(s)
^SCFG: "Serial/USB/DDD" , , , , , , , , OK ERROR +CME ERROR
Write Command www..com
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
Write Command
Duration of active RING line for URC indications: AT^SCFG="URC/Ringline/ActiveTime"[, ]
Response(s)
^SCFG: "URC/Ringline/ActiveTime", OK
XT65_ATC_V01.001 Confidential / Released
Page 60 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(Continued)
Write Command
Duration of active RING line for URC indications: AT^SCFG="URC/Ringline/ActiveTime"[, ]
Response(s)
ERROR +CME ERROR
Write Command
Userware autostart status: AT^SCFG="Userware/Autostart"[, , ]
Response(s) www..com
^SCFG: "Userware/Autostart"[, ] OK ERROR +CME ERROR
Write Command
Userware autostart application: AT^SCFG="Userware/Autostart/AppName"[, , ]
Response(s)
^SCFG: "Userware/Autostart/AppName"[, ] OK ERROR +CME ERROR
Write Command
Userware autostart delay: AT^SCFG="Userware/Autostart/Delay"[, , ]
Response(s)
^SCFG: "Userware/Autostart/Delay"[, ] OK ERROR +CME ERROR
Write Command
Userware configuration password: AT^SCFG="Userware/Passwd"[, old, new, new]
Response(s)
^SCFG: "Userware/Passwd" OK ERROR +CME ERROR
Write Command
Userware debug interface: AT^SCFG="Userware/DebugInterface"[, , [, ]]
Response(s)
^SCFG: "Userware/DebugInterface", , , OK ERROR +CME ERROR
XT65_ATC_V01.001 Confidential / Released
Page 61 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
Write Command
Userware mode: AT^SCFG="Userware/Mode"[, , , ]
Response(s)
^SCFG: "Userware/Mode", , , OK ERROR +CME ERROR
Write Command
www..com
Standard output of userware AT^SCFG="Userware/Stdout"[, [, ][, ][, ]]
Response(s)
^SCFG: "Stdout" , [, [, [, ]]] OK ERROR +CME ERROR
PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
-
+
+
+
+
+
-
Unsolicited Result Codes
URC 1
^SCFG: "AutoExec", , , , , If the event specified with occurs and the related AT command line is executed this URC is issued.
URC 2
^SYSSTART AIRPLANE MODE This URC is issued each time the Airplane mode is activated, no matter whether Airplane mode is set with parameter ="on" or ="on". The URC notifies the user that only the AT commands supported in Airplane mode are accessible. After leaving the Airplane mode the URC "^SYSSTART" indicates that the ME has returned to Normal mode and the full set of AT commands is accessible again.
Parameter Description
(str)(+CSCS) AutoExec Command This parameter serves to switch the Autoexec function on or off. If it is switched off (=0), parameters following are ignored and all settings at the given index are restored to their default values. Value will be saved while switching off the XT65 via AT commands (e.g. AT+CFUN or AT^SMSO) and restored on next power up. "0" "1" Disable automatic execution of the AT command(s) specified with at a given . Enable automatic execution of the AT command(s) specified with at a given . Not allowed for =0 (DTR line activation) while multiplex mode is active, refer to AT+CMUX.
XT65_ATC_V01.001 Confidential / Released
Page 62 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) AutoExec Event Type This parameter selects the kind of event used to automatically launch the AT command(s) specified with . Value will be saved while switching off the XT65 via AT commands (e.g. AT+CFUN or AT^SMSO) and restored on next power up. "0" "1"
www..com
Autoexec activity is driven by ASC0 DTR line activation (OFF-ON transition). Autoexec activity is timer driven. To specify the time span use .
(str)(+CSCS) AutoExec Command Index This parameter specifies the command storage index. The following table shows the index ranges supported for each variant of . Value will be saved while switching off the XT65 via AT commands (e.g. AT+CFUN or AT^SMSO) and restored on next power up. value 0 1 (str)(+CSCS) AutoExec Command Mode 0...255 This parameter specifies details regarding the behavior of the XT65 when the AT command starts to be executed. Value is interpreted as a bit field, unused bits are reserved for future use (RFU) and shall be set to 0. When a call is released by an Autoexec activity, no release indication may be issued on the first logical channel. Value will be saved while switching off the XT65 via AT commands (e.g. AT+CFUN or AT^SMSO) and restored on next power up. Bit D0 D1 D2 D3 D4 D5 D6 D7 Maskhex 0x00 0x01 0x02 0x03 0x04 0x08 0x10 0x20 0x40 0x80 Maskdec 0 1 2 3 4 8 16 32 64 128 Control 00: Ignore ongoing calls 01: Wait until all calls have ended 10: Dismiss any ongoing call 11: RFU 0: One shot action 1: Periodic action (for "AutoExec/Period" only) RFU RFU RFU RFU RFU event Autoexec activity is driven by ASC0 DTR line activation Autoexec activity is timer driven. Valid Indices 0 0-2
XT65_ATC_V01.001 Confidential / Released
Page 63 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) AutoExec AT command String This parameter specifies the AT command(s) to be launched automatically. Each AT command is executed in the same way as if it were entered online, this means that command concatenation is possible if supported by the given commands. If serial multiplex mode is activated (AT+CMUX) the first logical channel is used, i.e. CSD calls (data or fax) could be set up. If the XT65 is busy on the serial channel command execution will be delayed until ongoing action is finished. The first two characters of the automatically launched AT command shall be "at". Please refer to examples below. Value will be saved while switching off the XT65 via AT commands (e.g. AT+CFUN or AT^SMSO) and restored on next www..com power up. (str)(+CSCS) AutoExec Command Period Parameter specifies the period after which will be executed. Format is "hhh:mm:ss", where characters indicate hours, minutes and seconds. This parameter applies to =1 only. Value will be saved while switching off the XT65 via AT commands (e.g. AT+CFUN or AT^SMSO) and restored on next power up. When using this feature with running java applications, please consider the minimum time for the execution of AT+CFUN or AT^SMSO is 15 seconds. 000:00:05...240:00:00 (str)(+CSCS) AutoExec Command Period Left This parameter shows the amount of time left until will be executed. Format is "hhh:mm:ss", where characters indicate hours, minutes and seconds. This parameter applies to =1 only. Due to the internal activity and network signaling an execution delay of several seconds may occur for the overall procedure. 000:00:00...240:00:00 (str)(+CSCS) AutoExec Command Status This parameter is part of the Autoexec URC which is presented when a scheduled Autoexec activity is being performed. "1" The value 1 indicates that the Autoexec activity specified with is currently executed.
(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) "off" When the ATS0= (>0) command is received, the MT will attempt to perform a GPRS attach. When the ATS0= (>0) command is received, the MT will not attempt to perform a GPRS attach.
XT65_ATC_V01.001 Confidential / Released
Page 64 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) GPRS with AutoAttach This parameter can be used to control whether the ME will perform a GPRS attach immediately after power-up and registering to the network or not. If the setting is changed to "enabled" and the ME is not attached yet, it will not initiate an attach immediately but after the next power-up and registration to the network. Parameter is global for all interfaces, non volatile and will not be reset by AT&F. "disabled"(D) "enabled"
www..com (str)(+CSCS)
GPRS auto attach is disabled GPRS auto attach is enabled
GPRS with persistent contexts This parameter can be used to control whether the ME will store the GPRS context information defined by the AT+CGDCONT volatile or non volatile. Parameter is global for all interfaces, non volatile and will not be reset by AT&F. "0"(D) "1" (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 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" (). RING line is not activated for incoming IP packets. GPRS context definitions are volatile. GPRS context definitions are non-volatile and will not be reset by AT&F.
"off"(P) (str)(+CSCS)
MEopMode/Airplane: Enable/disable Airplane mode during operation The two parameters and can be used to enable/disable the Airplane mode. Airplane mode shuts down the radio part of the ME (PA and receiver), causes the ME to log off from the GSM/GPRS network and disables all AT commands whose execution requires a radio connection. A list of AT commands supported during Airplane mode can be found in Section 24.4, Availability of AT Commands Depending on Operating Mode of ME. The benefit of Airplane mode is that, at locations where no RF emission is allowed (typically airplanes, hospitals etc.), the subscriber can continue using network-independent features rather than powering off the entire device (e.g. a PDA or smartphone). If the subscriber tries to use an AT command not available in Airplane mode the response "+CME ERROR: Unsupported AT command" is returned. Parameter allows entering or leaving the Airplane mode any time during operation, eliminating the need to enter the SIM PIN again. It can be used no matter whether the parameter is "on" or "off". Parameter is global for all interfaces, volatile and will not be reset by AT&F. "on" "off"(P) Activates Airplane mode and shuts down the radio part of the ME. The URC "^SYSSTART AIRPLANE MODE" appears. Deactivates Airplane mode, wakes up the radio part of the ME and restores access to network-dependent AT commands. The URC "^SYSSTART" appears.
XT65_ATC_V01.001 Confidential / Released
Page 65 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) MEopMode/Airplane: Airplane mode upon ME restart There are two ways to enter Airplane mode upon restart: One is using AT^SCFG with as described below. Another approach is configuring the ME to restart into Airplane mode at a scheduled time. In this case, use the AT+CALA command, set an alarm time and then switch the ME off. When the alarm time is reached the ME wakes up to Airplane mode, no matter whether was set "on" or "off". Parameter is global for all interfaces, non volatile and will not be reset by AT&F. "on"
www..com
Causes the ME to enter the Airplane mode each time the ME is restarted or reset. After restart or reset, the URC "^SYSSTART AIRPLANE MODE" appears and parameter is "on". The SIM PIN can be entered using the AT+CPIN command. This enables the ME to read data from the SIM and give access to SIM PIN dependent AT commands which are available in Airplane mode, such as phonebook commands or several SMS commands. To notify the user when SIM data are accessible it is recommended to activate the "^SSIM READY" URC and store its presentation mode to the user profile with AT&W. To return from Airplane mode to Normal mode set the parameter to "off" as described above. If PIN authentication was already done, the ME will try now to register to the GSM network. Airplane mode will not be activated after ME restart or reset.
"off"(P) (str)(+CSCS)
MEShutdown/OnIgnition: Enable/disable shutdown by IGT line The parameter specifies two different switching modes of the ignition line IGT: The line may either be used only to switch on the ME, or to switch it on and off. By factory default the module's IGT line is configured only for switching on the ME. We recommend that great care be taken before changing the switch mode of IGT. It is of vital importance that the following conditions are met to ensure that IGT works properly as ON/OFF switch: Switch-on condition: If the ME is off the IGT line must be asserted for at least 400 ms and then released. Switch-off condition: If the ME is on the IGT line must be asserted for at least 1 s and then released. The switchoff routine is identical with the shutdown procedure initiated by the AT^SMSO command, i.e. the ME performs an orderly shutdown and issues the "^SHUTDOWN" URC. Before switching off the ME wait at least 2 seconds after startup. Furthermore, particular attention shall be given to the USB interface and the DTR signal: The USB interface and the DTR line shall either be decoupled from IGT to avoid unintentional shutdown of the ME, or require special precautions if you wish to restart the ME by plugging the USB cable or to toggle IGT from DTR. For further details please refer to [2]. Parameter is global for all interfaces, non-volatile and will not be reset by AT&F. "on" "off" (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 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. Ignition line (IGT) can be used to switch on and off the ME. Ignition line (IGT) can be used to switch on the ME.
XT65_ATC_V01.001 Confidential / Released
Page 66 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) Allowed radio band(s) The feature "Radio/Band" with its parameters , and can be used to set and query preferences for selecting frequency bands. The XT65 normally uses an automode algorithm designed to recognize automatically the radio bands of the current country, typically a combination of two bands. Commonly used dual-band combinations are, for example, 900/1800 MHz in European countries or 850/1900 MHz in North America. The standard radio band combination of a country depends on the ARFCNs (Absolute Frequency Channel Number) and the MCCs (Mobile Country Code) visible at the air interface. This enables the ME to easily find the standard band or band combination of a country every time after power-up and, thus, usually eliminates the need for the subscriber to make any changes. So, if automode is used and the allowed bands are not restricted with the response parameter www..com shows the standard band(s) of the current area. As an alternative, if any bands other than those automatically selected by the ME are needed, the automode can be influenced using the AT^SCFG command. This may be necessary, for example, when running tests of GSM applications, when access to specific radio bands shall be restricted or when the final product is not intended for operation in certain countries. Before changing the parameters or ensure that no network activity occurs. The write command cannot be executed when making a call, or sending / receiving short messages. Execution of the write command causes the ME to deregister from and re-register to the network, no matter whether the selected or setting really changes. Therefore, it is useful to have the URC "+CREG" enabled. The status of the SIM PIN authentication remains unchanged, eliminating the need to enter the SIM PIN again after the change. The parameter is intended to restrict the allowed bands to less than four bands. By default, all four bands are allowed. Each band not contained in is generally disabled. All bands of must be contained in the range set with . The response parameter will never show a value outside the range. has precedence over and . The value of may be one of the single bands listed below or all valid combinations from the values 1, 2, 4 and 8. Thus, the value range of is "1".."15". To select or deselect a band calculate the sum of the values of all desired bands and enter the resulting value. For example, for 1800 MHz (2) and 850 MHz (8) please enter the value (10). Parameter is global for the ME, non-volatile and will not be reset by AT&F. "1" "2" "4" "8" "3" "5" "10" "12" "15" (str)(+CSCS) Preferred radio band(s) The write command will trigger the band selection, starting with the user preference specified by . This means bands contained in will be searched first, regardless of the standard band combination of the current country. The final result of the band selection can be read from . If was a band or band combination which differs from the standard band(s) and the requested band(s) are not visible at the air interface the ME reverts to the standard band(s) of this country. Please note that the band selection procedure is independent of the registration procedure, i.e. the ME selects a band no matter whether or not there is a PLMN (Public Land Mobile Network) the ME can register to. So, if the was a band or band combination supported by the country, but currently no PLMN can be found, the ME will select the "preferred" band (indicated by ) without registering to the network. To avoid registration problems, for example when the settings are configured for testing the GSM application it is recommended that the tester first activates the desired band(s) on the test equipment and then executes the AT^SCFG write command. Besides XT65_ATC_V01.001 Confidential / Released Page 67 of 588 1/9/07 GSM 900 MHz GSM 1800 MHz GSM 1900 MHz GSM 850 MHz GSM 900 MHz + GSM 1800 MHz GSM 900 MHz + GSM 1900 MHz GSM 850 MHz + GSM 1800 MHz GSM 850 MHz + GSM 1900 MHz all bands
XT65 AT Command Set
2.14 AT^SCFG
s
remember that the network registration also depends on the settings made with AT+COPS. The is volatile and cannot be read back with the AT^SCFG read command. This is because the value is used only for triggering one single search operation. The parameter may be one of the single bands or one of the four dualband combinations listed below. All preferred bands must be contained in the range of allowed bands set with , invalid combinations are not accepted. To give priority to a certain single band or band combination and suppress all others simply select the same value both for and . The value range of is "1...12", but only the bands or band selections listed below are allowed. Trying to set an unsupported value will be denied with "ERROR". To select or deselect a band calculate the sum of the values of all desired bands and enter the resulting value. For example, for GSM 1800 MHz (2) and GSM 850 MHz (8) please enter the value (10). "1"
www..com
GSM 900 MHz GSM 1800 MHz GSM 1900 MHz GSM 850 MHz GSM 900 MHz + GSM 1800 MHz GSM 900 MHz + GSM 1900 MHz GSM 850 MHz + GSM 1800 MHz GSM 850 MHz + GSM 1900 MHz
"2" "4" "8"
"3" "5" "10" "12" (str)(+CSCS) Currently selected radio band(s)
is the single band or dual band combination currently used by the ME, found either by the automode algorithm or after the network search was triggered with . The value is saved on power down. When restarted next time the ME tries to select the same band(s) if these are visible. If the band(s) stored with are not visible the ME uses the standard band(s) of the current country and consequently updates the value. is only a response parameter returned either after sending the read command AT^SCFG? or writing AT^SCFG="Radio/Band". In addition to and to allow the subscriber to be notified whenever the selected band changes it is recommended to activate the "+CIEV: band" (see Section 3.3, AT^SIND). "1" "2" "4" "8" "3" "5" "10" "12" (str)(+CSCS) Radio Output Power Reduction According to 3GPP Rel99, output power reduction for multiple TX slots is a mandatory feature. The amount of power reduction is configurable up to 3.0dB for 2TX, 4.8dB for 3Tx to 6dB for 4TX. To optimize heat dissipation, power consumption and SAR values it is recommended to use full power reduction (value "3"). Parameter is global for all interfaces, volatile and will not be reset by AT&F. "1" Medium Reduction at GMSK (0dB reduction for 1TX and 2TX, 1.8dB for 3TX and 3dB for 4TX) GSM 900 MHz GSM 1800 MHz GSM 1900 MHz GSM 850 MHz GSM 900 MHz + GSM 1800 MHz GSM 900 MHz + GSM 1900 MHz GSM 850 MHz + GSM 1800 MHz GSM 850 MHz + GSM 1900 MHz
XT65_ATC_V01.001 Confidential / Released
Page 68 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
Maximal Reduction at GMSK (0dB reduction for 1TX, 3dB for 2TX, 4.8dB for 3TX and 6dB for 4TX) Maximal Reduction at GMSK (0dB reduction for 1TX, 3dB for 2TX, 4.8dB for 3TX and 6dB for 4TX)
"2" "3"(P)
(str)(+CSCS) BufferSize This value defines the default size of the TCP receive queue in bytes. Higher values allow higher throughput but less number of parallel connections. The total throughput is limited by the GPRS/EDGE network resources and cannot exceed the theoretical maximum gross throughput of 230Kbit. Parameter is global for the ME and non-volatile. Use of default value is recommended. If changed the new value www..com takes effect the next time you start an Internet service with AT^SISO. 3000...5200(&F)(D)...20000 Size of TCP receive buffer in bytes. Possible number of parallel socket connections depending on buffer size: - 5200 bytes (default): max. 8 connections - 10000 bytes (medium): max. 4 connections - 20000 bytes (high): max. 2 connections
(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. 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 while the service is in connected state. If the service is still connecting (connection setup) another algorithm applies. 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) 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-
XT65_ATC_V01.001 Confidential / Released
Page 69 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
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.
www..com (&F)(D)
"on"
Enable URCs related to Internet service commands. Throughout the Chapter "Internet Service AT Commands" the mode is also referred to as URC mode. 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.
"off"
(str)(+CSCS) OTAP tracer This parameter enables a trace output of the Java Over The Air procedure. The tracer is useful for obtaining additional information when setting up an OTAP scenario. The output is provided on the interface on which the command was entered. While the tracer is enabled the interface is used for trace output only, meaning that no AT commands can be entered. The tracer will be switched off only by a reset of the module, e.g. after a completed OTAP procedure. "1" (str)(+CSCS) Device Descriptor This parameter determines whether to use the Siemens standard USB Device Descriptor configuration (default) or a Device Descriptor configuration customized by the application manufacturer. Parameter is global, stored non-volatile in ME and not reset by AT&F. Setting will be active after XT65 restart. "0"(D) Siemens standard USB Device Descriptor. If =0 is set all other parameters related to "Serial/USB/DDD" cannot be changed. For use in a Windows environment, the "usbmodem.inf" file delivered with XT65 shall be present. Note that whenever the XT65 firmware is updated over the USB interface the Siemens standard configuration must be present. Therefore, before starting a XT65 firmware download be sure that =0 is activated and, under Windows, the Siemens "usbmodem.inf" file can be found. Remember to restart the ME after reverting to =0 and before starting the firmware download. Customer specific USB Device Descriptor. If =1 is set all other parameters related to "Serial/USB/DDD" can be changed. Customizing the USB Device Descriptor configuration requires a unique Vendor ID obtained from the USB Implementers Forum. For information please refer to http://www.usb.org. For use under Windows a customized INF file for the USB modem must be present. An easy way to create this file is copying the Siemens "usbmodem.inf" file and overwriting the equivalent values changed with AT^SCFG, usually at least the Vendor ID, Product ID and, optionally, the manufacturer string. This is because the strings given for the customized "Serial/USB/DDD" parameters must be identical with those contained in the INF file. Page 70 of 588 1/9/07 Enable OTAP tracer.
"1"
XT65_ATC_V01.001 Confidential / Released
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) Descriptor Index As the XT65 shall be capable of holding 0 - 3 customized Device Desciptor configurations, the allows to create and select different parameter sets consisting of the parameters listed below. Please note that XT65 Release 01.001 supports only one parameter set associated to value 0. Parameter is global, stored non-volatile in ME and not reset by AT&F. Setting will be active after XT65 restart. "0"(D) "1" "2"
www..com
Index for the first descriptor definition. Future use. Future use. Future use.
"3"
(str)(+CSCS) Language ID Please refer to USB.ORG [30] to find the language IDs currently defined for USB devices. If parameter is not specified, the default value of the Siemens standard USB Device Descriptor configuration applies (US English). Parameter is global, stored non-volatile in ME and not reset by AT&F. Setting will be active after XT65 restart. Parameter length: maximum 4 characters. (str)(+CSCS) Vendor ID This parameter represents the Vendor ID obtained from the USB Implementers Forum. The Vendor ID will, together with the Product ID, be transmitted to the host during initialization. The given Vendor ID must be included in the INF file needed for Windows. Parameter is global, stored non-volatile in ME and not reset by AT&F. Setting will be active after XT65 restart. Parameter length: maximum 4 characters. (str)(+CSCS) Product ID Product ID (PID) defined by the application manufacturer to identify the USB device. The Product ID will, together with the Vendor ID, be transmitted to the host during initialization. The given Product ID must be included in the INF file needed for Windows. Parameter is global, stored non-volatile in ME and not reset by AT&F. Setting will be active after XT65 restart. Parameter length: maximum 4 characters. (str)(+CSCS) Manufacturer name Optional manufacturer string defined by the application manufacturer. If specified with the same string shall be included in the INF file needed for Windows. Parameter is global, stored non-volatile in ME and not reset by AT&F. Setting will be active after XT65 restart. Parameter length: maximum 63 characters. (str)(+CSCS) Product string Optional product name defined by the application manufacturer. If specified with it is recommended to include the same string into the INF file. Parameter is global, stored non-volatile in ME and not reset by AT&F. Setting will be active after XT65 restart. Parameter length: maximum 63 characters.
XT65_ATC_V01.001 Confidential / Released
Page 71 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) Device's serial number Optional serial number. Empty string if not used, like in the case of the Siemens standard USB Device Descriptor configuration. A serial number has several advantages. For example, it enables the host to assign the same virtual COM port to same USB device even though the device is connected to another USB port. This eliminates the need for the host to load the driver again. Parameter is global, stored non-volatile in ME and not reset by AT&F. Setting will be active after XT65 restart. If parameter is not specified, the default value of Siemens standard USB Device Descriptor applies. Parameter length: maximum 63 characters.
www..com
(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. 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.
"verbose"
(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 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.
"verbose"(P)
(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" "local"
(P)
URC is not indicated by RING. URC will be indicated by an activated RING line of the interface on which the URC appears URC is indicated by an activated RING0 line.
"asc0"
XT65_ATC_V01.001 Confidential / Released
Page 72 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(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) "on"
www..com
URC will be indicated by BREAK 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" "1" "2"
(P)
RING line will be activated for a time between 4.6 and 9.2 ms. RING line will be activated for about 100ms. RING line will be activated for about 1s.
(str)(+CSCS) Userware Autostart Specifies if the userware is started automatically on power-up. If autostart is enabled, it is no longer possible to use the multiplexer (see AT+CMUX). If the Java application starts, all current calls will be terminated. The Userware/Autostart mechanism takes effect also in Airplane modeand CHARGE-ONLY-MODE. Parameter is global, stored non-volatile in ME and not reset by AT&F. "0"(D) "1" (str)(+CSCS) Userware Autostart AppName Specifies the absolute path of the userware (the jar/jad file containing the desired application) to be started automatically on power-up. The local flash file system is identified by: "A:", directory separator is "/" (002Fh). The underline character "_" (005Fh) will not be supported. Parameter is global, stored non-volatile in ME and not reset by AT&F. Parameter length: maximum 100 characters. (str)(+CSCS) Userware Autostart Delay 0(D)...10000 Specifies the delay time (in 100ms) when the userware is started automatically after power-up. Parameter is global, stored non-volatile in ME and not reset by AT&F. Userware autostart disabled Userware autostart enabled
XT65_ATC_V01.001 Confidential / Released
Page 73 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) Userware Password Password used to change values of userware parameters. Parameter is global, stored non-volatile in ME and not reset by AT&F. The maximum length of a given password is 8 characters. It is allowed to have an empty password (this is the value on delivery of the module). CAUTION: Be careful not to lose the password. There is no way to reset or recover a forgotten password or to obtain a new password from the manufacturer. (str)(+CSCS)
www..com
Userware Debug Interface Local IP address Local IP address of the module used by the userware debugger. Parameter is global, volatile and not reset by AT&F. (str)(+CSCS)
Userware Debug Interface Remote IP address IP address of the host running the userware debugger. Parameter is global, volatile and not reset by AT&F. (str)(+CSCS) Default interface flag for IP connections Flag to select if the userware debug interface is the default interface for IP connections. Parameter is global, volatile and not reset by AT&F. ["0"] "1" (str)(+CSCS) Userware Mode Parameter is global, volatile and not reset by AT&F. ["normal"] "debug" "test" (str)(+CSCS) Userware Mode: Location Use of parameter depends on selected userware mode. Parameter is global, volatile and not reset by AT&F. If = "normal": Parameter is ignored. If = "debug": File name of application stored on module. Maximum length: 126 characters. If = "test": URL of the test server. Maximum length: 126 characters. (str)(+CSCS) Userware Mode: Port Use of parameter depends on selected userware mode. Parameter is global, volatile and not reset by AT&F. 0...65535 If = "normal": Parameter is ignored. If = "debug": Port number used by debugger. If = "test": Port number of the test server. Userware is started by AT command or autostart option. Userware is started by debugger on host side. Userware is loaded from test server. Debug interface is not the default. Debug interface is default for IP connections.
XT65_ATC_V01.001 Confidential / Released
Page 74 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) Interface for Java System.out This parameter specifies the interface to be used for the Java standard output System.out. The selected interface must be supported by the hardware. "ASC0" System.out is routed to the first serial interface. The interface is shared between Java CommConnection and System.out. The baud rate set for CommConnection applies also to System.out. The value is global, stored non-volatile in ME and is not reset by AT&F. System.out is routed to the Universal Serial Bus interface.
(D)
"USB"
www..com "NULL"
Discard data. The value is global, stored non-volatile in ME and is not reset by AT&F. System.out is routed to a UDP socket. The parameter requires that the port number be given with . "UDP" is intended only for use with the Java IDE and will be set automatically each time you start the debugging emulator of the XT65 (on-device debugging). Closing the debugger causes the ME to reboot and automatically resets the value last selected. This eliminates any need for manually setting "UDP" with AT^SCFG, and, besides, allows you to select another System.out target to be used when not debugging. Due to this, the value "UDP" is volatile unlike all other values, and switching to "UDP" is not supported while Java is running. System.out is written into a file. Requires additional parameters , and . Because excessive writing to the ME's flash file system decreases the life time of the flash memory, we recommend using the "FILE" interface only during development phases. The value is global, stored non-volatile in ME and is not reset by AT&F.
"UDP"
"FILE"
(str)(+CSCS) This parameter is required only if parameter for the Java System.out is set to "UDP" or "FILE". Parameter is global, stored non-volatile in ME and not reset by AT&F. 1...65535 If = "UDP": UDP port number. It is recommended to use a number greater than 1023. If = "FILE": Size of the log file in bytes, values less then 1024 are not supported.
(str)(+CSCS) This parameter is required only if parameter for the Java System.out is set to "FILE". It specifies the absolute path and the file name of the log. The local Flash File system is identified by: "A:", directory separator is "/" (002Fh). The underline character "_" (005Fh) is not supported. The log is split into two concatenated files, each using half of the entire log size set with parameter . Each file name consists of the name specified with parameter and the numeric extension "0" or "1" automatically appended, for example "a:/java/log.txt.0" for the first part of the log and "a:/ java/log.txt.1" for the second part. When the first log file reaches half of the log size, the System.out is written to the second file. When the second file is used up, the ME starts to overwrite the first one. Parameter is global, stored non-volatile in ME and not reset by AT&F. Parameter length: maximum 125 characters.
XT65_ATC_V01.001 Confidential / Released
Page 75 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
(str)(+CSCS) This parameter is required only if parameter for the Java System.out is set to "FILE". The parameter selects the mode of writing System.out data to file. Parameter is global, stored non-volatile in ME and not reset by AT&F. "buffered"(D) "secure" Uses a buffer and a timer and acts like a write cache. Writes all output data byte by byte to the file.
Notes
www..com
*
Any changes to parameters of the Autoexec function will be saved and restored on next power-up only when the ME is switched off via AT commands (e.g. AT+CFUN or AT^SMSO).
*
Please keep in mind, that each time the ME is restarted the timers of all autoexec actions configured with =1 and will be reinitialized and restarted. As a result, an autoexec action configured at a time later then a scheduled automatic restart would never be executed. Be careful using =1 with small period values and shutdown or reset AT commands, since only little time remains to change these settings again after XT65 restart. If uses AT commands containing secret data, this information may be retrieved with AT^SCFG?. For instance, this applies if using AT+CPIN. Parameters "GPRS/ATS0/withAttach" () and "GPRS/RingOnIncomingData" () are available only for modules supporting GPRS.
* * *
Examples
EXAMPLE 1
Usage of "AutoExec": Enable sending of a short message (SMS) on next DTR activation (OFF-ON transition). Sent SMS is assumed to be stored at first location of storage selected with AT+CPMS and AT^SSMSS, i.e. SMS may be sent either from SIM or ME storage. Also refer to AT+CMSS and AT+CMGW. Since SMS transmission and ongoing calls are possible at the same time there is no need to wait until all calls have ended (=0). AT+CMGF=1 OK AT+CNMI=1,1 Enable SMS text mode. Enable "+CMTI:" URC to be indicated when a short message is received.
OK AT+CMGD=1 Delete first SMS location. OK AT+CMGW="01522400045",145 Start writing a short message. >Test-SMS to be sent from storage! Enter the text of the message. Finish with CTRL-Z. +CMGW: 1 Confirms that message is stored to first location. OK AT^SCFG="AutoExec",1,0,0,0,"AT+CMSS=1" Enable execution on next DTR activation. ^SCFG: "AutoExec","1","0","0","0","at+cmss=1" ^SCFG: "AutoExec","0","1","0","0","","000:00:00","000:00:00" ^SCFG: "AutoExec","0","1","1","0","","000:00:00","000:00:00" ^SCFG: "AutoExec","0","1","2","0","","000:00:00","000:00:00" OK If a DTR activation has occured the ME issues the URC "^SCFG: " followed by the response of the executed command; the message reference in this case: ^SCFG:"AutoExec",0,0,1,0,"AT+CMSS=1" OK +CMSS: 16
EXAMPLE 2
Confirms that AT+CMSS=1 has been issued.
Usage of "AutoExec": XT65_ATC_V01.001 Confidential / Released Page 76 of 588 1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
Configure XT65 to perform a reset every 10 hours. The execution of the reset command shall be deferred until after any calls have ended. For details regarding software controlled power down refer to AT+CFUN and AT^SMSO. AT^SCFG="AutoExec",1,1,2,5,"AT+CFUN=0,1","010:00:00" ... OK After ten hours: ^SCFG:"AutoExec",1,1,2,5,"AT+CFUN=0,1" OK SYSSTART
www..com
EXAMPLE 3
Confirms that AT+CFUN=0,1 has been issued. XT65 has restarted. Remember that the "^SYSSTART" URC will not appear if autobauding is enabled.
Usage of "AutoExec": Switch off the ME after three minutes without restarting it. For details regarding software controlled power down refer to AT+CFUN and AT^SMSO. Please keep in mind that if the GSM alphabet is enabled special characters within the executed AT command shall be issued as escape sequences. A list of typical escape sequences can be found in Section 1.5.1, GSM alphabet tables and UCS2 character values. For example, the caret character "^" included in all Siemens defined AT commands shall be given as "\1B\14". AT^SCFG="AutoExec",1,1,0,0,"AT\1B\14SMSO","000:03:00" ^SCFG: "AutoExec","0","0","0","0","" ^SCFG: Please note that the indication of the escape "AutoExec","1","1","0","0","ATSMSO","000: sequence in the write command response depends 03:00","000:02:59" on the used program. ^SCFG: "AutoExec","0","1","1","0","","000:00:00","000:00:00" ^SCFG: "AutoExec","0","1","2","0","","000:00:00","000:00:00" OK After three minutes: ^SCFG:"AutoExec",0,1,1,0,"AT^SMSO" ^SMSO: MS OFF OK ^SHUTDOWN
EXAMPLE 4
Indicates that AT^SMSO was successfully executed. The ME enters the POWER DOWN mode.
Usage of "AutoExec": Deactivate a timer-driven Autoexec function configured at 2 (such as the periodic automatic reset or the automatic switch-off functions configured in the preceding examples): AT^SCFG="AutoExec",0,1,2 ... OK
EXAMPLE 5
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" Switch to GSM character set. 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).
XT65_ATC_V01.001 Confidential / Released
Page 77 of 588
1/9/07
XT65 AT Command Set
2.14 AT^SCFG
s
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. 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/Datamode/Ringline","on" OK AT^SCFG="URC/Ringline","asc0" ^SCFG:"URC/Ringline","asc0"
OK AT^SCFG="URC/Datamode/Ringline","off" ^SCFG:"URC/Datamode/Ringline","off"
www..com
OK AT^SCFG="URC/Ringline" ^SCFG:"URC/Ringline","off" OK
XT65_ATC_V01.001 Confidential / Released
Page 78 of 588
1/9/07
XT65 AT Command Set
2.15 AT^SM20
s
2.15
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 XT65.
Syntax
Test Command
AT^SM20=?
www..com Response(s)
OK
Read Command
AT^SM20?
Response(s)
^SM20:, OK
Write Command
AT^SM20=[, ]
Response(s)
OK
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
SIEMENS
-
+
+
+
+
+
-
-
-
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. 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.
1(&F)
(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. 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.
1(&F)
XT65_ATC_V01.001 Confidential / Released
Page 79 of 588
1/9/07
XT65 AT Command Set
3. Status Control Commands
s
3.
Status Control Commands
The AT Commands described in this chapter allow the external application to obtain various status information from the XT65.
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 www..com
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 supporteds), (list of supported s), (list of supported s), (list of supported s), (list of supported s) OK
Read Command
AT+CMER?
Response(s)
+CMER: , , , , OK
Write Command
AT+CMER=[[, [, [, [, ]]]]]
Response(s)
OK ERROR +CME ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
GSM 07.07
-
+
+
+
+
+
-
+
-
Unsolicited Result Code
+CIEV: , 1[, 2][, [,...]] A value of an indicator has changed. For more details see AT^SIND.
XT65_ATC_V01.001 Confidential / Released
Page 80 of 588
1/9/07
XT65 AT Command Set
3.1 AT+CMER
s
Parameter Description
(num) 0(&F) 1 2 Discard "+CIEV" and "^SLCC" URCs. Discard "+CIEV" and "^SLCC" URCs when TA-TE link is reserved, e.g. in online data mode. Otherwise they are forwarded directly to the TE. Buffer "+CIEV" and "^SLCC" URCs in the TA while TA-TE link is reserved, e.g. in online data mode, and flush them to the TE afterwards. Otherwise they are forwarded directly to the TE. Forward "+CIEV" and "^SLCC" URCs directly to the TE. If XT65 is in online data mode, URCs are signaled via sending BREAK and stored in a buffer. Once it is back in command mode e.g. after +++ was entered, all URCs stored in the buffer will be output.
3
www..com
(num) 0(&F) (num) 0(&F) (num) 0(&F) 2 (num) 0(&F) TA buffer of URCs defined within this command is cleared when 1..3 is entered. Disable indicator event reporting. Enable indicator event reporting. Display event reporting is not supported by XT65. Keypad event reporting is not supported by XT65.
(str) Name of indicator; for a list of all supported indicators please refer to AT+CIND and AT^SIND. (num) Value of indicator; for a list of all values for the supported indicators please refer to AT+CIND and AT^SIND.
Notes
* If the ME operates on different instances (MUX channels 1, 2, 3) avoid different settings for routing and indicating SMS. For example, if messages shall be routed directly to one instance of the TE (set with AT+CNMI, AT^SSDA), it is not possible to activate the presentation of URCs with AT+CMER or AT+CNMI on another instance. Any attempt to activate settings that conflict with existing settings on another interface, will result in CME ERROR, or accordingly CMS ERROR. It is recommended that priority be given to AT+CMER= 2 or 3. Otherwise, if equals 1, URCs will be discarded in case of long running AT commands or an active data connectiion.
*
XT65_ATC_V01.001 Confidential / Released
Page 81 of 588
1/9/07
XT65 AT Command Set
3.2 AT+CIND
s
3.2
AT+CIND Indicator control
The AT+CIND command controls the presentation of Indicator Event Reports related to various functions such as battery charge level, signal quality, service availability, sound generation, indication of unread short messages, full SMS storage, call in progress or roaming activities. Use of AT+CIND has become outdated. Rather we recommend the more powerful AT^SIND command which is easier to use and provides additional indicators. All indicators provided by AT+CIND can be handled with AT^SIND as well. AT+CIND supports two ways to get the values related to indicators: * One approach is to query the current status of each indicator by using the read command AT+CIND?. It returns the status no matter whether the indicator has been registered with the write command www..com AT+CIND=[[,[,...]]]. * The other way is an event-driven notification based on the "+CIEV" URCs. In this case, the ME will automatically send a message to the application, whenever the value of an indicator changes. The application should be designed to react adequately when receiving a URC. The presentation of these URCs depends on two settings: The indicators must be registered with the write command AT+CIND=[[,[,...]]]. When the ME is switched on all of them are in registered mode. Any indicator can be excluded if deregistered with =0. To register or deregister an indicator the AT+CIND write command requires to type the value =1 or 0 exactly at the position where the indicator is located in the list. This is not necessary with AT^SIND which allows to specify indicators by name. See examples below. The presentation of the registered indicators must be enabled with AT+CMER.
-
Syntax
Test Command
AT+CIND=?
Response(s)
+CIND: (, list of supported s)[, (, list of supported s)[, ...]] OK
Read Command
AT+CIND?
Response(s)
+CIND: [, [, ...]] OK ERROR +CME ERROR:
Write Command
AT+CIND=[, [, ...]]
Response(s)
OK ERROR +CME ERROR:
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
GSM 07.07
-
+
+
+
+
+
-
+
-
Parameter Description
(num) Integer type value, which shall be in range of corresponding
XT65_ATC_V01.001 Confidential / Released
Page 82 of 588
1/9/07
XT65 AT Command Set
3.2 AT+CIND
s
(str) String values and their ranges. More indications are available via AT^SIND. Therefore use of AT^SIND for control of all indications is recommended. The following indications are accessible via AT+CIND: "battchg" "signal"
www..com
Battery charge level 0..4 or 5 if no measuring is performed, e.g because no battery is connected. Also refer to AT^SBC. Signal quality (0..7) The indicated value is the bit error rate of the signal received. Bit errors are estimated values. See also AT+CSQ. Service availability (0-1) 0: Not registered to any network 1: Registered to home network or, if "roam"=1 then registered to another network Sounder activity (0-1) Reports every event that causes the ME to generate a tone. Value 1 means for example: Incoming call - ME is ringing. Note that the URC "+CIEV: sounder" will be output only if ringing tones are activated with AT^SRTC. Waiting call - ME generates waiting call tone (if call waiting is enabled). Outgoing call - ME generates Call Progress tone. Outgoing call - ME generates BUSY tone. The value changes to 0 when the tone stops. Unread short message at memory location (0-1); refer to AT+CPMS Call in progress (0-1). Indicator value is "1" if at least one call is in state "active" or "held". Depending on the parameter selected with AT^SCFG the indicator "call" will be issued * * when a state transition ends in state "active" or state "unknown", if ="restricted", 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, if ="verbose".
"service"
"sounder"
"message" "call"
Also refer to Section 7.1, Call Status Information. "roam" Roaming indicator (0-1) 0: Registered to home network or not registered 1: Registered to other network A short message memory storage in the MT has become full (1) or memory locations are available (0), i.e. range is (0-1) Received signal (field) strength (0..5) 0: signal strength -112 dBm 1-4: signal strength in 15 dB steps 5: signal strength -51 dBm Received signal (field) strength can also be obtained with AT+CSQ. However, the signal strength is scaled to value range 0..31 by this command.
"smsfull" "rssi"
(num) 0 [1](&F)(P) Indicator is deregistered. The indicator will not be presented as "+CIEV" URC, but can be queried with AT+CIND?. Indicator is registered, indicator event report allowed.
XT65_ATC_V01.001 Confidential / Released
Page 83 of 588
1/9/07
XT65 AT Command Set
3.2 AT+CIND
s
Notes
* Due to its restrictive value range, indicator "call" does not clearly reflect specific call states (such as alerting, active, held etc.), but rather serves to trigger the application to retrieve the new call status from the list of current calls with the AT commands AT^SLCC, AT+CLCC or AT^SCNI. If AT^SCFG setting ="verbose", indicator "call" will be issued also when a traffic channel is established, or when a call enters states "terminating" or "dropped" (see Call Status Information). In these cases, the relevant information about the cause of the display is available only from AT command AT^SLCC.
*
Examples
www..com 1 EXAMPLE
^SYSSTART AT+CPIN=9999 OK AT+CIND? +CIND: 5,0,1,0,0,0,0,0
The battery is either full or no battery is connected to the ME. The bit error rate of the signal quality is not available (since there is no call in progress). The ME is registered to its home network. Now activate the Indicator Event Report with AT+CMER.
OK AT+CMER=2,0,0,2 OK +CIEV: battchg,5 +CIEV: signal,0 +CIEV: service,1 +CIEV: sounder,0 +CIEV: message,0 +CIEV: call,0 +CIEV: roam,0 +CIEV: smsfull,0 +CIEV: rssi,5 ATD0123456; OK +CIEV: sounder,1 +CIEV: call,1 +CIEV: sounder,0 +CIEV: call,0 NO CARRIER AT+CIND=,,,0,,0 OK ATD0123456; OK NO CARRIER
EXAMPLE 2
Full receive signal strength. Make a call. A set of "+CIEV" URCs is received. Called party hangs up. Deregister the indicators "sounder" and "call". Dial the same call. This time, no URCs are displayed. Called party hangs up.
Deactivation of indicator "sounder" via AT+CIND AT+CIND? +CIND: 5,0,1,0,1,0,0,0,4 OK AT+CIND=,,,0 OK
EXAMPLE 3
Query the current status of indicators. To deactivate indicator "sounder" (= fourth item in list of indicators).
Deactivation of indicator "sounder" via AT^SIND AT^SIND="sounder",0 ^SIND: sounder,0,0 OK XT65_ATC_V01.001 Confidential / Released To deactivate indicator "sounder".
Page 84 of 588
1/9/07
XT65 AT Command Set
3.3 AT^SIND
s
3.3
AT^SIND Extended Indicator Control
Designed for extended event indicator control AT^SIND * offers greater flexibility than the standard command AT+CIND, * offers several extra indicators, * can show the current status of all indicators supported by AT+CIND and AT^SIND, * can be used to register or deregister the indicators of both commands, * displays all indicator event reports via "+CIEV" URCs. Presentation mode of the generated URCs is controlled via AT+CMER.
www..com The AT^SIND
read command provides a list of all indicators supported by AT+CIND and AT^SIND. Each indicator is represented with its registration mode and current value. The AT^SIND write command can be used to select a single indicator in order to modify its registration and to view the current value.
Syntax
Test Command
AT^SIND=?
Response(s)
^SIND: (, list of supported s)[, (, list of supported s)[, ...]], (list of supported s) OK
Read Command
AT^SIND?
Response(s)
^SIND: , , ^SIND: , , , , ^SIND: , , , , [^SIND: , , ] ... OK ERROR +CME ERROR:
Write Command
AT^SIND=,
Response(s)
^SIND: , , In case of: ="eons" and =2 ^SIND: , , , , In case of: ="nitz" and =2 ^SIND: , , , , OK ERROR +CME ERROR:
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
SIEMENS
-
+
+
+
+
+
-
+
-
XT65_ATC_V01.001 Confidential / Released
Page 85 of 588
1/9/07
XT65 AT Command Set
3.3 AT^SIND
s
Unsolicited Result Codes
URC 1
Format of the standard indicator: +CIEV: , Value related to an indicator has changed.
URC 2
Format of the "adnread" indicator issued when accessing the ADN phonebook records stored on the SIM: +CIEV: , , , , +CIEV: , "READY" One URC is issued for every used Abbreviated Dialing Number (ADN) phonebook record. After the last record of the ADN phonebook was read, a URC with "READY" tag signals end of processing. Format of the Voice Message indicator, if the number of waiting messages is delivered by the network: +CIEV: , , If the number of waiting messages is not delivered the standard indicator applies.
URC 4
www..com
URC 3
Format of the "eons" indicator: +CIEV: , , , One URC is issued for each new LAI (Location Area Information) broadcast by the network.
URC 5
Format of the "nitz" indicator: +CIEV: , , ,
Parameter Description
(str) String values and their ranges. All indicators supported by AT+CIND are accessible with this command, too. A detailed description of these indicators can be found there. The following indicators are accessible via AT^SIND only: "audio" Activity of the built-in audio unit. 0 Audio unit not active. 1 Audio unit is active, for example: MO voice call: Indicator is output with value 1 when dialing starts. MT voice call: Indicator is output with value 1 when call is ringing. Voice Message Waiting Indication for line 1 0 The value 0 notifies that no new voice message is available, and is provided by the service center to clear the voice message indication after the subscriber has retrieved all voice messages. 1 The value 1 notifies the subscriber that the mailbox contains one or several messages. "vmwait1" and "vmwait2" indicate the receipt of a special short message with a Voice Message Waiting Indicator. The service must be provisioned by the operator. The numbers 1 or 2 in "vmwait1" and "vmwait2" are related to the two lines of the Alternate Line Service (ALS), also defined in CPHS Phase 2 standard. For further details refer to the AT^SALS command. The presentation mode of the indicator varies with the operator: If more than one message are waiting, some operators only indicate the first one, others deliver the indicator each time a new voice message is put into the mailbox.
"vmwait1"
XT65_ATC_V01.001 Confidential / Released
Page 86 of 588
1/9/07
XT65 AT Command Set
3.3 AT^SIND
s
After the subscriber has retrieved all voice messages the service center automatically sends another message indication which provides the value 0. Some operators may also send the number of waiting voice messages along with the indication. In this case, the number will be displayed by the XT65 as part of the URC. For example, "+CIEV: vmwait1,1,5" notifies that five new voice messages are waiting. However, it should be noted that neither the read command AT^SIND? nor the write command AT^SIND=,2 display the number of waiting messages. The "vmwait" indicators do not apply if a network provider signals new voice mail(s) via standard SMS. In this case the indicator "message" will be displayed (see AT+CIND).
www..com
"vmwait2"
Voice Message Waiting Indication for line 2 0 See description of "vmwait1". 1 See description of "vmwait1". Ciphering Status Change Indication 0 Current call or SMS is not ciphered. 1 Current call or SMS is ciphered. As stated in GSM specifications 02.07 and 02.09 the ciphering indicator feature allows the XT65 to detect that ciphering is not switched on and to indicate this to the user. The ciphering indicator feature may be disabled by the home network operator setting data in the "administrative data" field (EFAD) in the SIM, as defined in GSM 11.11. If this feature is not disabled by the SIM, then whenever a connection is in place, which is, or becomes unenciphered, an indication shall be given to the user. This enables the user's decision how to proceed. Read command returns valid ciphering status only if a call is in progress or active. If EFAD setting disables the ciphering indicator feature read command always indicates a ciphered link and no URC presentaion will take place. The following restrictions apply if the same serial channel is used for AT^SIND "ciphcall" indication and for the action triggering this URC. In general, the recommended solution is to use a dedicated channel for all status signalling via URCs. * If an unciphered mobile originated SMS is performed, AT^SIND "ciphcall" URCs on the same serial channel will be issued after the related "OK" and indicate the ciphering state at this time. If an unciphered mobile originated data call is performed, AT^SIND "ciphcall" URCs on the same serial channel will be issued after the interface is not longer blocked by the call (call is released or temporarily stopped) and indicate the ciphering state at this time.
"ciphcall"
*
"adnread"
Abbreviated Dialing Number (ADN) Phonebook Read Indication 0 Phonebook reading is not finished. 1 Phonebook reading is finished. Every time after entering the AT+CPIN the module starts reading the ADN phonebook. This can be used to enable the TE to output the phonebook records as URCs. The advantage is that the user does not need to wait until the phonebook read command AT+CPBR is accessible after entering the SIM PIN (depending on the SIM card this may take up to 30 seconds without RSA or 2 minutes with RSA). If =1 all used ADN phonebook records stored on the SIM will be output as URCs after SIM PIN authentication has been performed successfully. A URC with "READY" tag issued at the end of the list indicates that XT65 has finished reading the phonebook. Note that the settings of AT^SIND and AT+CMER will be restored to their default values when restarting the XT65. Therefore it is recommended that the settings be enabled before entering the SIM PIN. This can be done, for example, after rebooting the XT65.
XT65_ATC_V01.001 Confidential / Released
Page 87 of 588
1/9/07
XT65 AT Command Set
3.3 AT^SIND
s
"eons"
www..com
Enhanced Operator Name String (EONS) Indication The Enhanced Operator Name String indicator feature allows the XT65 to output various operator names for different PLMN identities via URC. It also allows the output of a different operator name based on a subset of the registered network by using a range of Location Area Codes (LACs) or a single LAC. The presentation of the "eons" indicator is determined by network activity. For example, the indicator appears every time a location update occurs or a NITZ information is sent, no matter whether or not the status of the EONS information has changed. This means that the same EONS information may be reported several times. The EONS tables are stored in the SIM card and will be read at power-up. Following are the SIM Elementary Files that are affected by the introduction of EONS feature in the SIM card: EFSST (SIM Service Table) - describes which features are active. EFOPL (Operator PLMN List) - contains the PLMN identification and location ID together with the index of the corresponding PNN record EFPNN (PLMN Network Name) - contains the full and short form version of the network name for the registered PLMN If the Operator Name Source is CPHS Operator Name String long and short form, refer to , the following two SIM Elementary Files will be used: EFONString (Operator Name String) - contains the name of the PLMN operator who issued the SIM. EFOPShort (Operator Name Short form) - contains a short form of the name of the PLMN operator who issued the SIM. Network Identity and Time Zone indication This indicator shows the time relevant information elements of an MM Information (MMI) or GMM Information (GMMI) message received from the network (see GSM 24.008, ch. 9.2.15a and 9.4.19). The network usually sends a NITZ indicator when the mobile attaches to the network, when it enters a location area with different time zone or when a daylight change occurs. A NITZ indicator may consist of the following parameters: Universal Time (UT), local Time Zone (TZ), Daylight Saving Time (DST). All information elements of MMI/GMMI are optional and therefore, the presentation of the parameters , , varies with the network. For example, the network may send all three parameters UT, TZ, DST, or only UT and TZ or only TZ. UT is indicated in usual date/time format and represents the current world time (GMT) at the moment when sent. TZ is given as a positive (east) or negative (west) offset from UT in units of 15 minutes. DST shows the number of hours added to the local TZ because of daylight saving time (summertime) adjustment. Usually DST is 1 hour but it can be also 2 hours in certain locations. Example for time and time zone with DST: +CIEV: nitz,"04/07/23,13:39:20",-28,1 In this example TZ is -28, showing a time offset of -7 hours (west) to Universal Time/GMT (which never changes for DST). DST is 1 which indicates that one hour was added to TZ because of Daylight Saving Time. If a network does not send the DST parameter the TZ value would be -32 (8 hours west) as would be done in winter: +CIEV: nitz,"04/11/23,13:39:20",-32 Please be aware that despite the last NITZ value can be looked up again via "AT^SIND=nitz,2" the returned values may be out of date. Especially the UT value is obsolete because there is no internal NITZ clock and therefore no continuation of UT. NITZ values are lost when the module detaches from network. Also when a
"nitz"
XT65_ATC_V01.001 Confidential / Released
Page 88 of 588
1/9/07
XT65 AT Command Set
3.3 AT^SIND
s
manual network selection fails and the module automatically falls back to the previous network the NITZ values cannot be recalled. Nevertheless an indicated time zone is valid until a new MMI/GMMI will trigger another NITZ indication.
"simstatus"
www..com
SIM Status Indication The SIM Status indicator allows the XT65 to output the status of the subscriber identity module (SIM) via URC. 0 SIM card removed. Note: Another way to verify the SIM card connection is the "^SCKS" URC enabled with AT^SCKS. For use after restart, its presentation mode can be stored to the user profile with AT&W. 1 SIM card inserted. 2 SIM PIN1 not required - SIM card unlocked. XT65 automatically registers to the GSM network without requesting SIM PIN1. 3 SIM PIN1 required - SIM card locked. SIM PIN1 must be entered to enable XT65 to register to the GSM network. 4 Personalization info ready - CHV (Card Holder Verification) data have been verified (if required). 5 SIM initialization completed - ME has finished reading SIM data. Note: Another way to notify the user when SIM data are accessible is the "^SSIM READY" URC enabled with AT^SSET. For use after restart, its presentation mode can be stored to the user profile with AT&W. Currently selected frequency band or band combination. 1...12 Identical with of AT^SCFG. The value indicates the band(s) currently available for network selection, depending on the network configuration either a single band or a dualband combination. The URC appears whenever the status of the currently available band(s) changes, for example after using the AT^SCFG command to change the "Radio/Band" parameters or . Please see AT^SCFG for further detail about the feature "Radio/Band" selection. Availability of the SIM card, physically connected 0 SIM removed. 1 SIM inserted. If RSA is active: The AT^SIND "simlocal" URC refers to the unused local SIM. The status of the remote SIM card currently used for the RSA connection is controlled by AT^SCKS. If RSA is inactive: The AT^SIND "simlocal" URC refers to the currently used local SIM. In this case the value is identical to the AT^SCKS value, except for AT^SCKS value 2.
"band"
"simlocal"
(num) Integer type value in the range stated above for the corresponding . Notes specific to the EONS feature: If the indicator is "eons", the is a type associated to the operator name according to GSM 22.101 [28]. This type depends on the source of the operator name. Priority of types associated to the operator names is defined as follows (the type listed first has the highest priority). If a type cannot be indicated the next one will be used. 0 Not registered. 1 EF-OPL and EF-PNN (alphanumeric format, can contain up to 24 characters.) 2 Operator Name String in long and short format according to Common PCN Handset Specification (CPHS) [29] (alphanumeric format, can contain up to 16 characters). 3 Name information received by the NITZ service long and short form (alphanumeric format, can contain up to 16 characters). The short form will be displayed only if EFOPShort from CPHS is available. 4 Any operator name stored internal to the ME (alphanumeric format, can contain up to 16 characters). XT65_ATC_V01.001 Confidential / Released Page 89 of 588 1/9/07
XT65 AT Command Set
3.3 AT^SIND
s
5
Broadcast MCC-MNC (numeric format which consists of a 3-digit country code plus a 2- or 3-digit network code). The name information received by the NITZ service (type 3) is stored non-volatile. It replaces the operator name of the registered PLMN (type 4) or its numeric form (type 5) stored in the ME. But if the ME, after restart, registers to another PLMN that is not equal to the saved NITZ name information, the NITZ name information must be invalidated. If the type is 2, 4 or 5, AT+COPS with the appropriate displays the same operator name. (num) 0 Indicator is deregistered, i.e. no such indicator event report (URC) will be issued. =0 is power-up and factory default of indicators defined by AT^SIND only. Indicator is registered. * * Indicator event reports are controlled via AT+CMER. All indicators can be registered or deregistered via AT^SIND, but different default settings apply: Power-up and factory default of the indicators supported by AT+CIND is =1, while, as stated above, indicators defined by AT^SIND only are set to =0.
www..com 1
2 (num)
Query the registration status and the current value of a single indicator type.
ADN phonebook record number on the SIM. (str) Phone number, for further details see AT+CPBR. (num) Address type, for further details see AT+CPBR. 145 209 129 (str) Text assigned to a phone number. For further details see AT+CPBR. If delivered by the network: Number of new voice messages sent as part of the Voice Message Waiting Indicator. Refer to . Operator in format which depends on the type associated to the operator name. Refer to . (str) Service Provider Name according to the status settings (SIM Service No. 17) in the SIM Service Table (SST) of the SIM. Universal Time delivered as part of the "nitz" Indicator. Refer to . Dialing string includes international access code character '+'. Dialing string contains printable non-alphabetic non-digit characters saved with the number string. otherwise
XT65_ATC_V01.001 Confidential / Released
Page 90 of 588
1/9/07
XT65 AT Command Set
3.3 AT^SIND
s
Time Zone delivered as part of the "nitz" Indicator. Refer to . Adjustment for Daylight Saving Time as part of the "nitz" Indicator. Refer to .
Example
Activation and use of indicator "audio":
www..com
AT^SIND="audio",1 ^SIND: audio,1,0 OK AT+CMER=2,,,2 OK
You register the indicator "audio". You activate the Indicator Event Report with AT+CMER. A set of all registered URCs is presented. (Please note that the example includes the indicators registered due to the power-up default settings of AT+CIND.)
+CIEV: battchg,5 +CIEV: signal,0 +CIEV: service,1 +CIEV: sounder,0 +CIEV: message,1 +CIEV: call,0 +CIEV: roam,0 +CIEV: smsfull,0 +CIEV: rssi,4 +CIEV: audio,0 ATD030123456 OK +CIEV: audio,1 +CIEV: sounder,1 +CIEV: call,1 +CIEV: signal,0 +CIEV: sounder,0 ATH OK +CIEV: call,0 +CIEV: rssi,3 +CIEV: audio,0 +CIEV: signal,0 +CIEV: rssi,4
You make a call.
You hang up.
XT65_ATC_V01.001 Confidential / Released
Page 91 of 588
1/9/07
XT65 AT Command Set
3.4 AT+CEER
s
3.4
AT+CEER Extended Error Report
AT+CEER returns an extended error report regarding the reason of the last * call release * failure to set up a call (both mobile originated or terminated) * failure to modify a call by using Supplementary Services * failed attempt to activate, register, query, deactivate or deregister a Supplementary Service * unsuccessful GPRS attach or unsuccessful PDP context activation * GPRS detach or PDP context deactivation The release cause report is presented in numeric format. Default output in case of a none-error-situation is www..com +CEER: 0,0,0. A description associated with each number can be found in the tables given in the following subclauses and the relevant GSM specifications. The first parameter serves to locate the other two parameters. Depending on the failure or release cause either or are applicable, i.e. if 0, then = 0. Vice versa, if = 0, then may be 0. In addition to AT+CEER, the command ATS18 can be used to check especially the status of fax and data calls.
Syntax
Test Command
AT+CEER=?
Response(s)
OK ERROR +CME ERROR
Exec Command
AT+CEER
Response(s)
+CEER: , , OK ERROR +CME ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
GSM 07.07
+
+
+
+
+
+
-
+
-
Parameter Description
(num) Location ID as number code. Location IDs are listed in Section 3.4.1, Cause Location ID for the extended error report. Each ID is related with another table that contains a list of s or s. (num) Reason for last call release as number code. The number codes are listed in several tables, sorted by different categories in the following subclauses. The tables can be found proceeding from the Location ID given in Section 3.4.1, Cause Location ID for the extended error report. (num) Release cause for last Supplementary Service call (listed in Section 3.4.9, GSM Release cause for Supplementary Service Call)
XT65_ATC_V01.001 Confidential / Released
Page 92 of 588
1/9/07
XT65 AT Command Set
3.4 AT+CEER
s
Examples
EXAMPLE 1
ATD"01751223344"; NO CARRIER AT+CEER +CEER: 8,21,0 OK
EXAMPLE 2
A mobile originated call is rejected by the remote party. Call setup is terminated with NO CARRIER. To check the cause, the caller enters AT+CEER. The Location ID 8 in Section 3.4.1 points to Section 3.4.7, where 21 = "Call rejected". 0 = "No error" refers to parameter that is not applicable.
The user attempts to activate call barring, but uses a wrong password.
www..com AT+clck=oi,1,"0000",3
+CME ERROR: incorrect password AT+CEER +CEER: 35,0,38 The Location ID 35 in Section 3.4.1 points to Section 3.4.9, where 38 = "NegativePWCheck" may mean that a wrong password was tried for the OK first time. 0 = "No error" refers to parameter that is not applicable.
3.4.1
ID 0 1 2 3 4 5 6 8 9 12 13 14 16 17 21 22 33 34 35 48 49 50 127 128
Cause Location ID for the extended error report
Description No error (default) SIEMENS L2 cause GSM cause for L3 Radio Resource Sublayer (GSM 04.08 annex F) SIEMENS cause for L3 Radio Resource Sublayer GSM cause for L3 Mobility Management (GSM 04.08 annex G) SIEMENS cause for L3 Mobility Management GSM cause for L3 Mobility Management via MMR-SAP (GSM 04.08 annex G) GSM cause for L3 Call Control (GSM 04.08 10.5.4.11 and annex H) SIEMENS cause for L3 Call Control GSM cause for L3 SMS CP Entity SIEMENS cause for L3 SMS CP Entity GSM cause for L3 SMS RL Entity GSM cause for L3 SMS TL Entity SIEMENS cause for L3 SMS TL Entity GSM cause for L3 Call-related Supplementary Services SIEMENS cause for L3 Call-related Supplementary Services SIEMENS cause for Supplementary Services Manager Network cause for Supplementary Services (GSM 04.08 10.5.4.11 and annex H) Supplementary Services network error (GSM 04.80 3.6.6) GSM cause for GPRS Mobility Management (GSM 04.08 annex G.6) SIEMENS cause for GPRS Mobility Management GSM cause for Session Management (GSM 04.08 annex I) SIEMENS cause for protocol module or other local cause Supplementary Services general problem (GSM 04.80 3.6.7)
XT65_ATC_V01.001 Confidential / Released
Page 93 of 588
1/9/07
XT65 AT Command Set
3.4 AT+CEER
s
ID 129 130 131 241 243
Description Supplementary Services invoke problem (GSM 04.80 3.6.7) Supplementary Services result problem (GSM 04.80 3.6.7) Supplementary Services error problem (GSM 04.80 3.6.7) SIEMENS cause for GPRS API SIEMENS cause for PPP/IP-Stack
www..com
3.4.2
249
SIEMENS L2 cause
Description L2 Error
Number
3.4.3
Number 0 1 2 3 4 5 8 9 10 65 95 96 97 98 100 101 111
GSM release cause for L3 Radio Resource (RR)
Description Normal event Abnormal release, unspecified Abnormal release, channel unacceptable Abnormal release, timer expired Abnormal release, no activity on the radio path Pre-emptive release Handover impossible, timing advance out of range Channel mode unacceptable Frequency not implemented Call already cleared Semantically incorrect message Invalid mandatory information Message type non-existent or not implemented Message type not compatible with protocol state Conditional information element error No cell allocation available Protocol error unspecified
3.4.4
Number 1 2 3 4 5
SIEMENS release cause for L3 Radio Resource (RR)
Description Racchs not answered Racchs rejected Access class of the SIM is barred by the network provider SABM failure Radio link counter expiry or PerformAbnormalRelease
XT65_ATC_V01.001 Confidential / Released
Page 94 of 588
1/9/07
XT65 AT Command Set
3.4 AT+CEER
s
Number 6 7 8 9 10 11 12
www..com
Description Confirm ABORT of the MM Respond to DEACT REQ Loss of coverage Reestablishment not possible T3122_STILL_RUNNING CELL_SELECTION_IN_PROGRESS RESPONDING_TO_PAGING LOCATION_AREA_CODE_HAS_CHANGED CIRCUIT_SWITCHED_NOT_AVAILABLE
13 14
3.4.5
GSM release cause for Mobility Management (MM) or Session Management (SM)
Description IMSI unknown in HLR Illegal MS IMSI unknown in VLR IMEI not accepted Illegal ME PLMN not allowed Location Area not allowed Roaming not allowed in this location area Network failure Congestion PDP context is deactivated because of a LLC or SNDCP failure Service option not supported Requested service option not subscribed Service option temporarily out of order Call cannot be identified Semantically incorrect message Invalid mandatory information Message type non-existent or not implemented Message not compatible with protocol state Information element non-existent or not implemented Conditional information element error Messages not compatible with protocol state
Number 2 3 4 5 6 11 12 13 17 22 25 32 33 34 38 95 96 97 98 99 100 101
Causes related to MS identification
Cause related to subscription options
Causes related to PLMN specific network failures and congestion
Causes related to nature of request
Causes related to invalid messages
XT65_ATC_V01.001 Confidential / Released
Page 95 of 588
1/9/07
XT65 AT Command Set
3.4 AT+CEER
s
Number 111 7 8 9 10 14
www..com
Description Protocol error, unspecified GPRS services not allowed GPRS services not allowed in combination with non-GPRS services MS identity cannot be identified by the network Implicitly detached GPRS services not allowed in current PLMN MSC temporarily unreachable
Causes related to GPRS
16
3.4.6
Number 1 8 9 11 17 18 19 20 21 22 23 24 25 26 27 28
SIEMENS release cause for L3 Mobility Management (MM)
Description No SIM available No MM connection Authentification failure MM performs detach Registration failed and will be re-attempted in a short term CM connection establishment failed Registration failed and will be re-attempted in a long term RR connection is released MS tries to register SPLMN is not available An MTC is in progress A PLMN scan is in progress The MM is detached, the MS is in MS class C GPRS only The maximum numbers of CM connections is exceeded The MM is not registered The MM state is incompatible
3.4.7
Number Normal class 1 3 6 8 16 17 18
GSM release cause for L3 Call Control (CC)
Description Unassigned (unallocated) number No route to destination Channel unacceptable Operator determined barring Normal call clearing User busy No user responding
XT65_ATC_V01.001 Confidential / Released
Page 96 of 588
1/9/07
XT65 AT Command Set
3.4 AT+CEER
s
Number 19 21 22 25 26 27 28
www..com
Description User alerting, no answer Call rejected Number changed Pre-emption Non-selected user clearing Destination out of order Invalid number format (incomplete number) Facility rejected Response to STATUS ENQUIRY Normal, unspecified No circuit/channel available Network out of order Temporary failure Switching equipment congestion Access information discarded Requested circuit/channel not available Resource unavailable, unspecified Quality of service unavailable Requested facility not subscribed Incoming calls barred within the CUG Bearer capability not authorized Bearer capability not presently available Service or option not available, unspecified Bearer service not implemented ACM equal or greater than ACMmax Requested facility not implemented Only restricted digital information bearer capability is available service or option not implemented, unspecified Invalid transaction identifier value User not member of CUG Incompatible destination Invalid transit network selection Semantically incorrect message Invalid mandatory information Message type non-existant or not implemented Message type not comaptible with protocol state Information element non-existent or not implemented
29 30 31 34 38 41 42 43 44 47 49 50 55 57 58 63 65 68 69 70 79 81 87 88 91 95 96 97 98 99
Resource unavailable class
Service or option not available class
Service or option not implemented
Invalid message (e.g. parameter out of range) class
Protocol error (e.g. unknown message) class
XT65_ATC_V01.001 Confidential / Released
Page 97 of 588
1/9/07
XT65 AT Command Set
3.4 AT+CEER
s
Number 100 101 102 111 127
Description Conditional information element error Message not compatible with protocol Recovery on timer expiry Protocol error, unspecified Interworking, unspecified
Interworking class
www..com
3.4.8
2 3 4 7 10
SIEMENS release cause for L3 Call Control (CC)
Description Service not available Hold procedure not available Temporary no service, previous procedure not yet finished Mobile received a release (complete) message during a modify procedure (modify reject) Number not included in FDN list Called party barred incoming call
Number
Notifications 300
3.4.9
Number 0 1 9 10 11 12 13 15 16 17 18 19 20 21 27 29 30 34 35
GSM Release cause for Supplementary Service Call
Description No error (default) UnknownSubscriber IllegalSubscriber BearerServiceNotProvisioned TeleserviceNotProvisioned IllegalEquipment CallBarred CUGReject IllegalSSOperation SSErrorStatus SSNotAvailable SSSubscriptionViolation SSIncompatibility FacilityNotSupported AbsentSubscriber ShortTermDenial LongTermDenial SystemFailure DataMissing
XT65_ATC_V01.001 Confidential / Released
Page 98 of 588
1/9/07
XT65 AT Command Set
3.4 AT+CEER
s
Number 36 37 38 43 71 72 126
www..com
Description UnexpectedDataValue PWRegistrationFailure NegativePWCheck NumberOfPWAttemptsViolation UnknownAlphabet USSDBusy MaxNumsOfMPTYCallsExceeded ResourcesNotAvailable Unrecognized Component Mistyped Component Badly Structured Component Duplicate Invoke ID Unrecognized Operation Mistyped Parameter Resource Limitation Initiating Release Unrecognized Linked ID Linked Response Unexpected Unexpected Linked Operation Unrecognize Invoke ID Return Result Unexpected Mistyped Parameter Unrecognized Invoke ID Return Error Unexpected Unrecognized Error Unexpected Error Mistyped Parameter
127 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318
General Problem Codes
Invoke Problem Codes
Return Result Problem Codes
Return Error Problem Codes
3.4.10
Number 102
GSM release cause for Session Management (SM)
Description Recovery on timer expiry
XT65_ATC_V01.001 Confidential / Released
Page 99 of 588
1/9/07
XT65 AT Command Set
3.4 AT+CEER
s
3.4.11
Number 10 14 15 16
GSM cause for L3 Protocol module or other local cause
Description Unspecified RLP Error unreliable data link or if the peer instance is not RLP SREJ timed out REMAP procedure timed out
www..com
3.4.12
Number 0 1 2 3 4 5 9 255
SIEMENS release cause for GPRS API
Description Regular deactivation of the call Action temporarily not allowed Wrong connection type Specified data service profile invalid PDP type or address is unknown FDN Check was not successful; GPRS Attach and PDP Context Activation blocked GPRS service not available Undefined
3.4.13
Number 0 1 255
SIEMENS release cause for PPP/IP-Stack
Description Regular call deactivation LCP stopped Undefined
XT65_ATC_V01.001 Confidential / Released
Page 100 of 588
1/9/07
XT65 AT Command Set
3.5 ATS18
s
3.5
ATS18 Extended call release report
ATS18 controls the presentation of extended call release reports for circuit switched fax and data calls. Extended call release reports related to voice calls are controlled via AT+CEER. The call release report is presented in numeric format and shows as follows: +CAUSE: : If enabled the message will be reported every time a fax or data call is released or fails to be established.
Syntax
www..com Read Command
ATS18?
Response(s)
OK
Write Command
ATS18=
Response(s)
OK ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
-
-
-
+
-
Parameter Description
(num)(&W)(&V) An odd number enables the presentation of the extended call release report. Any even number disables this feature. 0(&F)...255 (num) Location ID as number code, see also of AT+CEER. Location IDs are listed in Section 3.4.1, Cause Location ID for the extended error report. Each ID is related to another table that contains a list of s. (num) Reason for last call release as number code (see also of AT+CEER). numbers and the associated descriptions are listed in several tables, sorted by different categories at AT+CEER. The tables can be found proceeding from the Location IDs listed in Section 3.4.1, Cause Location ID for the extended error report.
XT65_ATC_V01.001 Confidential / Released
Page 101 of 588
1/9/07
XT65 AT Command Set
3.5 ATS18
s
Examples
EXAMPLE 1
ATS18=1 OK ATD03012345678 +CAUSE: 8:17 BUSY
EXAMPLE 2
Enables the presentation of extended call release reports. Now, a mobile originated data call fails. An extended error report is output, followed by the result code BUSY. The Location ID 8 stated in Section 3.4.1 points to Section 3.4.7, with 17 = "User busy". Enables the presentation of extended call release reports. Now, a mobile originated data call is set up. Call ends after remote party hung up. Normal call release is reported, followed by the result code NO CARRIER. The Location ID 8 stated in Section 3.4.1 points to Section 3.4.7, with 16 = "Normal call clearing".
www..com
ATS18=1 OK ATD03012345678 CONNECT 9600/RLP Hello,.... +++ +CAUSE: 8:16 NO CARRIER
XT65_ATC_V01.001 Confidential / Released
Page 102 of 588
1/9/07
XT65 AT Command Set
3.6 AT+CPAS
s
3.6
AT+CPAS Mobile equipment activity status
The AT+CPAS execute command indicates the activity status of the ME.
Syntax
Test Command
AT+CPAS=?
Response(s)
+CPAS: (list of supporteds) OK www..com
Exec Command
AT+CPAS
Response(s)
+CPAS: OK
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
GSM 07.07
-
+
+
+
+
+
-
+
-
Parameter Description
(num) 0 3 4 Ready Incoming call (ringing) Call in progress or call hold
XT65_ATC_V01.001 Confidential / Released
Page 103 of 588
1/9/07
XT65 AT Command Set
3.7 AT+WS46
s
3.7
Syntax
AT+WS46 Select wireless network
Test Command
AT+WS46=?
Response(s)
+WS46: (list of supporteds) OK
Read Command
AT+WS46? www..com
Response(s)
OK
Write Command
AT+WS46=[]
Response(s)
OK ERROR +CME ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
GSM 07.07
-
+
+
+
+
+
-
+
-
Parameter Description
(num) 12 GSM digital cellular
XT65_ATC_V01.001 Confidential / Released
Page 104 of 588
1/9/07
XT65 AT Command Set
4. Serial Interface Control Commands
s
4.
Serial Interface Control Commands
The AT Commands described in this chapter allow the external application to determine various settings related to the XT65's serial interface.
4.1
Syntax
AT\Q Flow control
www..com Exec Command
AT\Q[]
Response(s)
OK
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
SIEMENS
-
+
-
-
+
-
Parameter Description
(num)(&W)(&V) [0](&F) 1 2 3 Disable flow control XON/XOFF software flow control Only CTS by DCE (TA) RTS/CTS hardware flow control Recommended for the following procedures: incoming or outgoing data calls, fax calls, MUX mode. Often, the initialization routine of Fax programs includes enabling RTS/CTS handshake, eliminating the need to issue AT\Q3 once again.
Notes
* When using XON/XOFF flow control (AT\Q1) in online mode, +++ should not be used while the data transmission is paused with XOFF. Before entering the command mode with +++ the paused transmission should be resumed using the XON character. For compatibility reasons, the AT\Q command can be used in Multiplex mode, though the settings will not take effect. However, be aware that whenever you use the AT\Q write command in Multiplex mode and then save the current configuration to the user profile with AT&W, the changed AT\Q setting will become active after restart. With AT+IFC, flow control can be set separately for each data direction, while AT\Q applies to both directions. The two commands influence each other, i.e. settings made with AT\Q apply to AT+IFC and, vice versa, AT+IFC changes the AT\Q setting.
*
*
XT65_ATC_V01.001 Confidential / Released
Page 105 of 588
1/9/07
XT65 AT Command Set
4.2 AT&C
s
4.2
AT&C Set Data Carrier Detect (DCD) Line mode
The AT&C command determines how the state of the DCD line (circuit 109) reflects the XT65's internal activity.
Syntax
Exec Command
AT&C[]
Response(s)
OK
www..com Reference(s)
PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250 , SIEMENS
-
+
+
+
+
+
-
+
-
Parameter Description
(num)(&W)(&V) [0] 1
(&F)
DCD line shall always be on. DCD line shall be on only when data carrier signal is present. DCD line shall be on when one or more Internet services defined on the related serial channel are in state "Connecting" or "Up" as described below. For details on the various service states refer to AT^SISI, parameter or AT^SISO, parameter . * * SOCKET, HTTP, SMTP, POP3: ="Connnecting" or "Up" DCD shall be on when
2
FTP: DCD shall be on when data channel is connected, i.e. ="Up"
XT65_ATC_V01.001 Confidential / Released
Page 106 of 588
1/9/07
XT65 AT Command Set
4.3 AT&D
s
4.3
AT&D Set circuit Data Terminal Ready (DTR) function mode
The AT&D determines how the TA responds when circuit 108/2 (DTR) is changed from ON to OFF during data mode.
Syntax
Exec Command
AT&D[]
Response(s)
OK www..com
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
Parameter Description
(num)(&W)(&V) [0] 1 2(&F) TA ignores status of DTR. ON->OFF on DTR: Change to command mode while retaining the connected call. ON->OFF on DTR: Disconnect data call, change to command mode. During state DTR = OFF auto-answer is off.
XT65_ATC_V01.001 Confidential / Released
Page 107 of 588
1/9/07
XT65 AT Command Set
4.4 AT&S
s
4.4
AT&S Set circuit Data Set Ready (DSR) function mode
The AT&S command determines how the TA sets circuit 107 (DSR) depending on the communication state of the TA interfacing TE.
Syntax
Exec Command
AT&S[]
Response(s)
OK www..com
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
Parameter Description
(num)(&W)(&V) [0](&F) 1 DSR line is always ON TA in command mode: DSR is OFF. TA in data mode: DSR is ON.
XT65_ATC_V01.001 Confidential / Released
Page 108 of 588
1/9/07
XT65 AT Command Set
4.5 ATE
s
4.5
ATE Enable command echo
The ATE command determines whether or not the TA echoes characters received from TE during command state.
Syntax
Exec Command
ATE[]
Response(s)
OK www..com
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
+
+
+
+
-
+
-
Parameter Description
(num)(&W)(&V) [0] 1
(&F)
Echo mode off Echo mode on
Notes
* * In case of using the command without parameter, is set to 0. When a Java application is running there is no echo available, existing settings are ignored and attempts to change the settings are disregarded.
XT65_ATC_V01.001 Confidential / Released
Page 109 of 588
1/9/07
XT65 AT Command Set
4.6 AT+ICF
s
4.6
AT+ICF Serial Interface Character Framing
The command AT+ICF controls the serial interface character framing format and parity used for receiving and transmitting. The following settings are supported: * 7 bits, even parity, 1 stop bit (AT+ICF=5,1) * 7 bits, odd parity, 1 stop bit (AT+ICF=5,0) * 8 bits, even parity, 1 stop bit (AT+ICF=2,1) * 8 bits, no parity, 1 stop bit (AT+ICF=3) www..com odd parity, 1 stop bit (AT+ICF=2,0) * 8 bits, * 8 bits, no parity, 2 stop bits (AT+ICF=1)
Syntax
Test Command
AT+ICF=?
Response(s)
+ICF: (list of supported s), (list of supported s) OK
Read Command
AT+ICF?
Response(s)
+ICF: [, ] OK
Write Command
AT+ICF=[[, ]]
Response(s)
OK ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
-
-
+
-
Parameter Description
(num)(&W)(&V) Specifies the character format used for receiving and transmitting. 1 2 [3] 5 (num)(&W)(&V) Specifies the method of calculating the parity bit, if a parity bit is supported by . If does not support parity, this parameter has to be omitted. 0 1 odd even
(D)
8 data 0 parity 2 stop 8 data 1 parity 1 stop 8 data 0 parity 1 stop 7 data 1 parity 1 stop
XT65_ATC_V01.001 Confidential / Released
Page 110 of 588
1/9/07
XT65 AT Command Set
4.6 AT+ICF
s
Notes
* * * If AT+ICF modes 7E1 or 7O1 are set, the parity bit will by default not be transmitted over the air. If the remote party expects the parity bit to be transmitted, additional settings are required via AT^STPB. When using a bit rate of 300 bps there must be a delay of 500ms before entering the next command. At bit rates of 1200 bps the delay must be 300ms. For higher bit rates use of the default delay is sufficient. XT65's autobaud feature detects the bit rate currently used by the TE. However, this detection suffers some limitations described in Section 4.9.1, Autobauding. If autobauding is enabled, the AT+ICF read command does not show the current character framing, but the character framing that will be used when autobauding is disabled.
For compatibility reasons, the command can be used in Multiplex mode, though the settings will not take effect. Please note that changes made on multiplex channel 1 will be saved with AT&W and will become active www..com restarting the ME after AT^SMSO. when * * To start the multiplexer it is necessary to set the character framing to 8 bits, no parity and 1 stop bit. If a is selected without parity (e.g. =3) and you try to activate a format with parity (e.g. =2), you need to explixitly set the parameter (e.g. AT+ICF=2,1). Otherwise you will get '+CME ERROR: invalid index'. This is because for =3, the parameter is set to the internal value 'no parity' which is not supported by =2. (Remember that if an optional parameter is omitted for which no default is stated in this specification, the value of the parameter remains unchanged).
*
XT65_ATC_V01.001 Confidential / Released
Page 111 of 588
1/9/07
XT65 AT Command Set
4.7 AT+IFC
s
4.7
AT+IFC Set Flow Control separately for data directions
The command AT+IFC can be used to set or query the data flow control separately for each data direction. In contrast to this, flow control settings made with AT\Q are valid in both data directions.
Syntax
Test Command
AT+IFC=?
Response(s)
+IFC: www..com OK
(list of supported s), (list of supported s)
Read Command
AT+IFC?
Response(s)
+IFC: , OK
Write Command
AT+IFC=,
Response(s)
OK ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
-
-
+
-
Parameter Description
(num)(&W) Specifies the method used by the TE when receiving data from the TA. [0](&F) 1 2 3 none XON/XOFF, terminate flow control in the Cellular Engine RTS line XON/XOFF, evaluate flow control in the Cellular Engine and pass it through (over the air) to the opposite TE
(num)(&W) Specifies the method used by the TA when receiving data from the TE. [0](&F) 1 2 none XON/XOFF CTS line
XT65_ATC_V01.001 Confidential / Released
Page 112 of 588
1/9/07
XT65 AT Command Set
4.7 AT+IFC
s
Notes
* When using XON/XOFF flow control (AT+IFC=1,x or AT+IFC=3,x) in data mode, +++ should not be used while the data transmission is paused with XOFF. Before entering the command mode with +++ the paused transmission should be resumed using the XON character. For compatibility reasons, the AT+IFC command can be used in Multiplex mode, though the settings will not take effect. However, be aware that whenever you use the AT+IFC write command in Multiplex mode and then save the current configuration to the user profile with AT&W, the changed AT+IFC setting will become active after restart. The two commands AT+IFC and AT\Q influence each other, i.e. settings made with AT\Q apply to AT+IFC and, vice versa, AT+IFC changes the AT\Q setting.
*
*
www..com
XT65_ATC_V01.001 Confidential / Released
Page 113 of 588
1/9/07
XT65 AT Command Set
4.8 AT+ILRR
s
4.8
AT+ILRR Set TE-TA local rate reporting
The command AT+ILRR controls whether or not the intermediate result code "+ILRR" is transmitted from the TA to the TE while a connection is being set up. The result code indicates the local rate. It is issued before the final result code of the connection, e.g. CONNECT, is transmitted to the TE.
Syntax
Test Command
AT+ILRR=?
Response(s) www..com
+ILRR: (list of supported s) OK
Read Command
AT+ILRR?
Response(s)
+ILRR: OK
Write Command
AT+ILRR=
Response(s)
OK ERROR +CME ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
+
+
-
+
-
-
-
+
-
Intermediate Result Code
+ILRR: Indicates local port rate setting upon connection setup.
Parameter Description
(num)(&W)(&V) 0(&F) 1 (num) Port rate setting upon connection setup (bps) 0 300 600 1200 2400 4800 9600 14400 Autobauding (see Section 4.9.1, Autobauding). Not usable with Java. Disables reporting of local port rate Enables reporting of local port rate
XT65_ATC_V01.001 Confidential / Released
Page 114 of 588
1/9/07
XT65 AT Command Set
4.8 AT+ILRR
s
19200 28800 38400 57600 115200 230400 460800
www..com
XT65_ATC_V01.001 Confidential / Released
Page 115 of 588
1/9/07
XT65 AT Command Set
4.9 AT+IPR
s
4.9
AT+IPR Set fixed local rate
The command AT+IPR can be used to set or query the TE-TA interface bit rate.
Syntax
Test Command
AT+IPR=?
Response(s)
+IPR: (list of supported auto-detectable s) , (list of supported fixed-only s) OK www..com
Read Command
AT+IPR?
Response(s)
+IPR: OK
Write Command
AT+IPR=
Response(s)
OK ERROR +CME ERROR
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
V.250
-
+
-
-
+
-
Command Description
The test command returns the values of the supported automatically detectable bit rates and the values of the supported fixed bit rates. The read command returns the current bit rate of the interface. The write command specifies the bit rate to be used for the interface. When you set a fixed rate, make sure that both TE (DTE) and TA (DCE) are configured to the same rate. The setting is stored in the non-volatile memory and will be used when the ME is powered up again. However, in case of autobaud mode (AT+IPR=0) the detected TA bit rate will not be saved and, therefore, needs to be resynchronized after restarting the ME (see Section 4.9.1, Autobauding).
Parameter Description
(num)(&V) bit rate per second (bps) 0 300 600 1200 2400 4800 9600 14400 Activates autobauding. Not usable with Java. See Section 4.9.1, Autobauding for further details.
XT65_ATC_V01.001 Confidential / Released
Page 116 of 588
1/9/07
XT65 AT Command Set
4.9 AT+IPR
s
19200 28800 38400 57600 115200 230400 460800
Notes
www..com
*
Delivery value for is 115200bps. It will not be restored with AT&F.
* *
The current setting of AT+IPR will be preserved when you download firmware (i.e. a firmware update does not restore the factory setting) or in the event of power failure. Generally, AT+IPR should be used as a standalone command. If nevertheless combinations with other commands on the same command line cannot be avoided, there are several constraints to be considered: Avoid combinations with the AT commands listed in Section 1.4.2, Combining AT commands on the same command line. Take into account, that a pause of 100ms is required between the response to the last command (e.g. OK) and the next command. When local echo is active (ATE1) and you enter AT+IPR=x with other commands you may encounter the following problem: if switching to the new bit rate takes effect while a response is being transmitted, the last bytes may be sent with the new bit rate and thus, not properly transmitted. The following commands will be correctly sent at the new bit rate.
* * * *
In order to account for greater amounts of data it is recommended to choose a minimum bit rate of 2400 bps. If the ME shall be operated in Multiplex mode we suggest a minimum bit rate of 4800bps. In Multiplex mode, the write command AT+IPR= will not change the bit rate currently used, but the new bit rate will be stored and becomes active, when the module is restarted. A selected bit rate takes effect after the write commands returns OK. If Java is running, the firmware will ignore any settings made with AT+IPR. Responses to the read, write or test command will be invalid or deliver "ERROR". See also "XT65 Java User's Guide" [3], Section "Configuring serial interface".
4.9.1
*
Autobauding
To take advantage of autobaud mode specific attention must be paid to the following requirements: Synchronization between TE and TA: Ensure that TE and TA are correctly synchronized and the bit rate used by the TE is detected by the TA. To allow the bit rate to be synchronized simply use an "AT" or "at" string. This is necessary when you start up the ME while autobauding is enabled. It is recommended to wait 3 to 5 seconds before sending the first AT character. Otherwise undefined characters might be returned. Restrictions on autobauding operation: If you switch to autobaud mode, then autobauding does not take effect immediately after the write command AT+IPR=0 ends. Instead the old bitrate remains active. The autobaud mode is activated with the next restart of the TA. This is indicated by any following AT+IPR read command which still returns the old baudrate until the next restart. Before you activate autobauding switch on the local echo with ATE1. To verify if autobauding has become effective after restart first send only the characters "AT" or "at" and check that they are echoed within 100ms. In some cases you may need to repeat this several times, until both characters are properly echoed within 100ms. Please note that after the successful synchronization between TE and TA the autobauding mechanism of the TA is deactivated until next restart. So, while autobauding is enabled you will need to restart the TA each time after changing the bit rate of the TE.
*
XT65_ATC_V01.001 Confidential / Released
Page 117 of 588
1/9/07
XT65 AT Command Set
4.9 AT+IPR
s
*
The TA cannot distinguish between 1 and 2 stop bits. Therefore, 1 stop bit will be used by the TA. The command A/ cannot be used. Only the first "AT" or "at" after restart of the module can be detected (neither "At" nor "aT"). This means that all the AT commands have to use the same bit rate and frame type. Autobauding cannot be used if the ME operates with Java. URCs that may be issued before the ME detects a new bit rate (by receiving the first AT character) will be sent at the previously detected bit rate or, after ME restart, at 115200 bps.
Autobauding and bit rate after restart: Unless the bit rate is determined, the following constraints apply: -
An incoming CSD call or a network initiated GPRS request cannot be accepted. This must be taken into account when autobauding and autoanswer mode (ATS0 0) are enabled at the same time, escpecially www..com if SIM PIN 1 authentication is done automatically and the setting ATS0 0 is stored to the user profile with AT&W. Until the bit rate is found, URCs generated after restart will be output at 115200 bps. This applies only to user defined URCs, such as "+CREG", "CCWA", "^SCKS" etc. The URCs "^SYSSTART", "^SYSSTART CHARGE-ONLY MODE" and "^SYSSTART AIRPLANE MODE" will not be indicated when autobauding is enabled.
Note: To avoid any problems caused by undetermined bit rates in the direction from TA to TE we strongly recommend to configure a fixed bit rate rather than autobauding. * Autobauding and multiplex mode: If autobauding is active you cannot switch to multiplex mode (see AT+CMUX).
XT65_ATC_V01.001 Confidential / Released
Page 118 of 588
1/9/07
XT65 AT Command Set
4.10 AT+CMUX
s
4.10
AT+CMUX Enter multiplex mode
Multiplex mode according to GSM 07.10 and 3G TS 27.010 enables one serial asynchronous interface to be partitioned into three virtual channels. This allows you to take advantage of up to 3 simultaneous sessions running on one interface. For example, you can send or receive data or make a call on the first channel, while the other two channels are free to control the module with AT commands. The XT65 module incorporates an internal multiplexer and thus integrates all the functions needed to implement full-featured multiplex solutions. For the application on top, customers have the flexibility to create their own multiplex programs conforming to the multiplexer protocol. To help system integrators save the time and expense of designing multiplexer applications, SIEMENS AG offers WinMUX2k, a ready-to-use multiplex driver for Windows 2000 and Windows XP. Another approach is to develop customized solutions based on the sources of the WinMux2k driver. www..com Refer to [6] which provides a detailed description of the multiplex architecture and step-by-step instructions of how to install and configure the multiplex mode. The WinMUX2k driver and its source files can be supplied on request. Please contact your local distributor to obtain the latest installation software and user's guide.
Syntax
Test Command
AT+CMUX=?
Response(s)
+CMUX: (list of supporteds) OK
Read Command
AT+CMUX?
Response(s)
+CMUX: OK ERROR +CME ERROR:
Write Command
AT+CMUX=
Response(s)
OK ERROR +CME ERROR:
Reference(s) PIN ASC0 USB MUX1 MUX2 MUX3 Charge Last
GSM 07.07, GSM 07.10
-
+
+
-
-
-
-
+
+
Parameter Description
(num) Multiplexer transparency mechanism 0 (num) Subparameters defined in GSM07.07 are adjusted for control and logical channels as follows 0 UIH frames used only (control channel) Basic option
XT65_ATC_V01.001 Confidential / Released
Page 119 of 588
1/9/07
XT65 AT Command Set
4.10 AT+CMUX
s
Notes
* The write command is used to enter the multiplex mode. The setup of the logical channels is initiated by the TE, i.e. the TE acts as initiator. This means that the TE shall ensure that logical channels are established before any further actions on the channels can be started. There is a timeout of five seconds, if the multiplexer protocol is enabled and no multiplexer control channel is established. The GSM engine returns to AT command mode. The parameter maximum frame size (N1) of AT+CMUX in GSM 07.10 is set to 98 bytes by default. All other parameters are not available. See [6] for further details on the frame size. The Multiplex feature is not relevant for Java applications. The mode cannot be started if the ME is Java controlled. If Java autostart is enabled with AT^SCFG, it is not possible to activate Multiplex mode on ASC0 or USB. Multiplexer mode requires character framing to be set to 8 bits, no parity and 1 stop bit. The setting can be made using (AT+ICF=3).
* * *
www..com
*
4.10.1
Restrictions on Multiplex mode
In Multiplex mode, CSD and fax calls can only be set up on logical channel 1. Due to this restriction, AT commands have a different behavior on channels 2+3 compared to channel 1. Several commands are not available, others return different responses. This section summarizes the concerned commands. For general rules and restrictions to be considered in Multiplex mode please refer to [6].
Table 4.1: Availability of AT Commands on Virtual Channels
Command +++ AT+CBST AT+CRLP AT+CG... (GPRS commands) AT+F... (Fax commands) AT&S ATA ATD ATDI ATL ATM ATO ATS6 ATS7 ATS8
1) 1) 1) 1) 1)
Behavior on channel 1 not usable, but see note as described as described as described as described as described as described as described as described as described as described as described as described as described as described as described as described
2)
Behavior on channel 2+3 not usable, but see note 2) not usable not usable see note 3) not usable not usable no Data Calls no Data Calls not usable not usable not usable not usable not usable not usable not usable not usable not usable
ATS10 ATS18
1) Siemens GSM engines support the registers S0 - S29. You can change S0,S3,S4,S5,S6,S7,S8,S10 and S18 using the related ATSn commands (see starting from ATS0). The other registers are read-only and for internal use only! 2) The applicability of the +++ escape sequence depends on the customer's external application based on the Mulitplexer Protocol. Recommendations for implementing an appropriate modem status command (MSC) are provided in [6], Section "Escape Sequence". 3) PDP contexts can be defined on any channel, but are visible and usable only on the channel on which they are defined (thus it is not possible to define a context on channel 2 and activate it on channel 3). GPRS connections can be established on two channels at a time.
XT65_ATC_V01.001 Confidential / Released
Page 120 of 588
1/9/07
XT65 AT Command Set
4.10 AT+CMUX
s
Table 4.2:
Summary of AT commands with Different Behavior in Multiplex Mode
Command AT\Q
Description It is recommended to use hardware flow control (AT\Q3). XON/XOFF flow control (AT\Q1) is not supported in Multiplex mode. See note regarding AT\Qn settings stored with AT&W if Multiplex mode is active. Different default configurations on channels 1, 2 and 3. Different user profiles can be stored on each channel. Before you start Multiplex mode, it is recommended to set the ME to 57600 bps (minimum should be 4800 bps). For GPRS we suggest to use 115200 bps or 230400 bps. In Multiplex mode, the write command AT+IPR= will not change the bit rate currently used, but the new bit rate will be stored and becomes active, when the module is restarted. Multiplex mode cannot be activated while autobauding is enabled. On each channel an individual message can be stored. but only one time setting applies to all channels. This means an alarm