GPRS G3. AT Commands Reference Guide

Transcription

1 GPRS G3 AT s Reference Guide

2 COPYRIGHT AND TECHNICAL SUPPORT G3 AT s Reference Guide for the following products: MTSMC G3 xx, MTR G3 xx, MTC G3 xx Part Number S000545A, Revision A Copyright This publication may not be reproduced, in whole or in part, without prior expressed written permission from Multi Tech Systems, Inc. All rights reserved. Copyright 2013, by Multi Tech Systems, Inc. Multi Tech Systems, Inc. makes no representations or warranty with respect to the contents hereof and specifically disclaim any implied warranties of merchantability or fitness for any particular purpose. Furthermore, Multi Tech Systems, Inc. reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of Multi Tech Systems, Inc. to notify any person or organization of such revisions or changes. Trademarks Multi Tech and the Multi Tech logo are registered trademarks of Multi Tech Systems, Inc. Contacting Multi Tech Knowledge Base The Knowledge Base provides immediate access to support information and resolutions for all Multi Tech products. Visit Support Portal To create an account and submit a support case directly to our technical support team, visit: Technical Support Business Hours: M F, 9am to 5pm CT Country By By Phone Europe, Middle East, Africa: support@multitech.co.uk +(44) U.S., Canada, all others: support@multitech.com (800) or (763) World Headquarters Multi Tech Systems, Inc Woodale Drive Mounds View, Minnesota Phone: or Fax: Warranty To read the warranty statement for your product, please visit: AT s for GPRS G3 Modems 2

3 CONTENTS Contents Introduction Formatting Conventions Overview AT String Type Parameters Lines Information Responses and Result Codes Response Timeout Issuing Timing Storing Values by s Overview Factory Profile and User Profiles Format for Entering AT s Line Prefixes Starting A Line AT Last Automatic Repetition A/ Repeat Last AT#/ Remotely Issuing AT s Configuring SMS AT Run Example V.250 AT s Generic Modem Control to Factory Defined Configuration &F Soft Reset Z Select Active Service Class +FCLASS Default Reset Basic Profile Designation &Y Default Reset Full Profile Designation &P Store Current Configuration &W Store Telephone Number &Z Display Stored Numbers &N Manufacturer Identification +GMI Model Identification +GMM Revision Identification +GMR Capabilities List +GCAP Serial Number +GSN Display Configuration and Profile &V AT s for GPRS G3 Modems

4 CONTENTS Display Configuration and Profile &V S Registers Display &V Extended S Registers Display &V Display Last Connection Statistics &V Single Line Connect Message \V Country of Installation +GCI Master Reset +CMAR DTE Modem Interface Control Echo E Quiet Result Codes Q Response Format V Extended Result Codes X Identification Information I Data Carrier Detect (DCD) Control &C Data Terminal y (DTR) Control &D Standard Flow Control \Q Flow Control &K Data y (DSR) Control &S Ring (RI) Control \R Fixed DTE Interface Rate +IPR DTE Modem Local Flow Control +IFC DTE Modem Local Rate Reporting +ILRR DTE Modem Character Framing +ICF Call Control Dial D Return to on line mode O Answer A Disconnect H Compression Control Data Compression Reporting +DR S Parameters Number of Rings to Auto Answer S Ring Counter S Escape Character S Line Termination Character S Response Formatting Character S Line Editing Character S AT s for GPRS G3 Modems 4

5 CONTENTS Connection Completion Timeout S Escape Prompt Delay S Delay to DTR Off S Disconnect Inactivity Timer S Delay Before Forced Hang Up S GPP TS AT s General Request Manufacturer Identification +CGMI Request Model Identification +CGMM Request Revision Identification +CGMR Request Product Serial Number Identification +CGSN Select TE Character +CSCS International Mobile Subscriber Identity (IMSI) +CIMI Multiplexing Mode +CMUX Select Preferred MT Power Class +CPWC Call Control Hang Up Call +CHUP Select Bearer Service Type +CBST Radio Link Protocol +CRLP Service Reporting Control +CR Extended Error Report +CEER Cellular Result Codes +CRC Single Numbering Scheme +CSNS Voice Hang Up Control +CVHU Network Service Handling Subscriber Number +CNUM Operator Names +COPN Network Registration Report +CREG Operator Selection +COPS Facility Lock/Unlock +CLCK Change Facility Password +CPWD Calling Line Identification Presentation +CLIP Calling Line Identification Restriction +CLIR Call Forwarding Number and Conditions +CCFC Call Waiting +CCWA Call Holding Services +CHLD Unstructured Supplementary Service Data +CUSD AT s for GPRS G3 Modems

6 CONTENTS Advice of Charge +CAOC List Current Calls +CLCC SS Notification +CSSN Closed User Group +CCUG Preferred Operator List +CPOL Selection of preferred PLMN list +CPLS Call Deflection +CTFR Mobile Equipment Control Phone Activity Status +CPAS Phone Functions +CFUN Enter PIN +CPIN Signal Quality +CSQ Indicator Control +CIND Mobile Equipment Event Reporting +CMER Select Phonebook Memory Storage +CPBS Write Phonebook Entry +CPBW Phonebook Entries +CPBR Find Phonebook Entries +CPBF Clock Management +CCLK Alarm Management +CALA Delete Alarm +CALD ting Date Format +CSDF ting Time Format +CSTF Time Zone Reporting +CTZR Automatic Time Zone Update +CTZU Restricted SIM Access +CRSM Alert Sound Mode +CALM Ringer Sound Level +CRSL Loudspeaker Volume Level +CLVL Microphone Mute Control +CMUT Silence +CSIL Accumulated Call Meter +CACM Accumulated Call Meter Maximum +CAMM Price per Unit and Currency Table +CPUC Call Meter Maximum Event +CCWE Generic SIM Access +CSIM Mobile Equipment Errors AT s for GPRS G3 Modems 6

7 CONTENTS Report Mobile Equipment Error +CMEE CMEE Mode #CMEEMODE Voice Control DTMF Tones Transmission +VTS Tone Duration +VTD s for GPRS GPRS Mobile Station Class +CGCLASS GPRS Attach or Detach +CGATT GPRS Event Reporting +CGEREP GPRS Network Registration Status +CGREG Define PDP Context +CGDCONT Quality of Service Profile +CGQMIN Quality of Service Profile +CGQREQ PDP Context +CGACT Show PDP Address +CGPADDR Enter Data State +CGDATA Modify PDP Context +CGCMOD s for Battery Charger Battery Charge +CBC GPP TS AT s for SMS and CBS General Configuration Select Message Service +CSMS Preferred Message Storage +CPMS Message Format +CMGF Message Configuration Service Center Address +CSCA Text Mode Parameters +CSMP Show Text Mode Parameters +CSDH Select Cell Broadcast +CSCB Save tings +CSAS Restore tings +CRES Message Receiving and ing New Message Indications to Terminal Equipment +CNMI List Messages +CMGL Message +CMGR PDU Mode Message Sending and Writing AT s for GPRS G3 Modems

8 CONTENTS Send Message +CMGS Write Message to Memory +CMGW Send Message from Storage +CMSS Delete Message +CMGD Select Service for MO SMS Messages +CGSMS Custom AT s General Configuration AT s Network Selection Menu Availability +PACSP Manufacturer Identification #CGMI Model Identification #CGMM Revision Identification #CGMR Product Serial Number Identification #CGSN International Mobile Subscriber Identity (IMSI) #CIMI ICCID (Integrated Circuit Card Identification) #CCID Service Provider Name #SPN Extended Numeric Error Report #CEER Extended Error Report for Network Reject Cause #CEERNET Select Registration Operation Mode #REGMODE SMS s Operation Mode #SMSMODE PLMN List Selection #PLMNMODE Display PIN Counter #PCT Software Shut Down #SHDN Extended Reset #Z Periodic Reset #ENHRST Wake from Alarm Mode #WAKE Query Temperature Overflow #QTEMP Temperature Monitor #TEMPMON SMS Ring Indicator #E2SMSRI Analog/Digital Converter Input #ADC V24 Ouput Pins Mode #V24MODE V24 Output Pins Configuration #V24CFG V24 Output Pins Control #V RF Transmission Monitor Mode #TXMONMODE Battery and Charger Status #CBC GPRS Auto Attach Property #AUTOATT Multislot Class Control #MSCLASS Cell Monitor #MONI AT s for GPRS G3 Modems 8

9 CONTENTS Serving Cell Information #SERVINFO Network Survey of Timing Advance #CSURVTA Query SIM Status #QSS ATD Dialing Mode #DIALMODE Automatic Call #ACAL Extended Automatic Call #ACALEXT Extended Call Monitoring #ECAM SMS Overflow #SMOV Mailbox Numbers #MBN Message Waiting Indication #MWI Audio Codec #CODEC Network Timezone #NITZ Enhanced Network Selection #ENS Select Band #BND Automatic Band Selection #AUTOBND Lock to Single Band #BNDLOCK Skip Escape Sequence #SKIPESC Escape Sequence Guard Time #E2ESC PPP GPRS Connection Authentication Type #GAUTH PPP GPRS Parameters Configuration #GPPPCFG Enables/Disables PPP Compression # GPPPCFGEXT RTC Status #RTCSTAT GSM Antenna Detection #GSMAD SIM Detection Mode #SIMDET SIM Enhanced Speed #ENHSIM Subscriber number #SNUM SIM Answer to Reset #SIMATR CPU Clock Mode #CPUMODE GSM Context Definition #GSMCONT IPEGSM #GSMCONTCFG Show Address #CGPADDR Network Scan Time #NWSCANTMR Call Establishment Lock #CESTHLCK Phone Activity Status #CPASMODE ICCID SIM File ing Mode #FASTCCID Power Saving Mode Ring #PSMRI Software Level Selection #SWLEVEL AT s for GPRS G3 Modems

10 CONTENTS Mode Flow Control #CFLO Report Concatenated SMS Indexes #CMGLCONCINDEX Codec Information #CODECINFO Second Interface Instance #SII Select Language #LANG Call Forwarding Flags #CFF Hang Up Call #CHUP Encryption Algorithm #ENCALG Current Network Status #RFSTS CMUX Mode #CMUXMODE AT Interface and Trace Interface #PORTCFG AT Run s Enable SMS Run AT Service #SMSATRUN SMS Run AT Service Parameters #SMSATRUNCFG SMS AT Run White List #SMSATWL TCP Run AT Service Parameter #TCPATRUNCFG TCP Run AT Service in Listen Server Mode #TCPATRUNL TCP AT Run Firewall List #TCPATRUNFRWL TCP AT Run Authentication Parameters List #TCPATRUNAUTH TCP AT Run in Dial (Client) Mode #TCPATRUND Closing TCP Run AT Socket #TCPATRUNCLOSE TCP Run AT Sequence #TCPATCMDSEQ TCP Run AT Service to a Serial Port #TCPATCONSER Run AT Execution #ATRUNDELAY Event Monitor s Enable EvMoni Service #ENAEVMONI EvMoni Service Parameter #ENAEVMONICFG Event Monitoring #EVMONI Send Message #CMGS Write Message to Memory #CMGW CONSUME s Configure Consume Parameters #CONSUMECFG Enable Consume Functions #ENACONSUME Report Consume Statistics #STATSCONSUME Block or Unblock a Service Type #BLOCKCONSUME FOTA s OTA Network Access Point #OTASNAP AT s for GPRS G3 Modems 10

11 CONTENTS OTA User Answer #OTASUAN OTA Ring Indicator #OTASETRI Saves IP port and IP address for OTA over IP #OTAIPCFG Starts an OTA Update over IP #OTAIPUPD OTA IP port and address for OTA over IP #OTASNAPIP OTA Access Point Name for OTA over IP #OTASNAPIPCFG Multisocket AT s Socket Status #SS Examples Socket Info #SI Examples Context Activation #SGACT Socket Shutdown #SH Socket Configuration #SCFG Examples Socket Configuration Extended #SCFGEXT Examples Socket Configuration Extended 2 #SCFGEXT AT s for GPRS G3 Modems

12 CONTENTS Examples Socket Dial #SD Examples Socket Restore #SO Socket Listen #SL Examples Socket Listen UDP #SLUDP Examples Socket Accept #SA Receive Data in Mode #SRECV Examples Send Data in Mode #SSEND Examples Send Data in Mode Extended #SSENDEXT AT s for GPRS G3 Modems 12

13 CONTENTS Examples IP Stack Authentication Type #SGACTAUTH Context Activation and Configuration #SGACTCFG Context Activation and Configuration Extended #SGACTCFGEXT PAD Features #PADCMD PAD Forward Character #PADFWD Base64 Encoding/Decoding of Socket Sent/Received Data #BASE Examples Send UDP Data to a Specific Remote Host #SSENDUDP Examples Send UDP Data to Specific Remote Host Extended #SSENDUDPEXT Socket Type #ST AT s for GPRS G3 Modems

14 CONTENTS Examples Detect the Cause of Socket Disconnection #SLASTCLOSURE FTP AT s FTP Time Out #FTPTO FTP Open #FTPOPEN FTP Close #FTPCLOSE FTP Put #FTPPUT FTP Get #FTPGET FTP GET in Mode #FTPGETPKT FTP Type #FTPTYPE FTP Message #FTPMSG FTP Delete #FTPDELE FTP Print Working Directory #FTPPWD FTP Change Working Directory #FTPCWD FTP List #FTPLIST Get File Size #FTPFSIZE FTP Append #FTPAPP Send Data on FTP Data Port while in Mode #FTPAPPEXT Restart Position # FTPREST Receive Data in Mode #FTPRECV FTP Configuration # FTPCFG Single Socket AT s Socket Parameters Reset #SKTRST Example Enhanced IP Stack Extension AT s Query DNS #QDNS Example DNS Response Caching #CACHEDNS AT s for GPRS G3 Modems 14

15 CONTENTS Example Manual DNS Selection #DNS DNS from Network #NWDNS GPRS Context Activation #GPRS Socket Listen Ring Indicator #E2SLRI Firewall up #FRWL Data Volume #GDATAVOL Example ICMP Ping Support #ICMP Maximum TCP Payload Size #TCPMAXDAT TCP Reassembly #TCPREASS PING Request #PING Example E mail Management AT s E mail SMTP Server #ESMTP E mail Sender Address #EADDR AT s for GPRS G3 Modems

16 CONTENTS E mail Authentication User Name #EUSER E mail Authentication Password #EPASSW E mail Sending with GPRS Context Activation #S E mail GPRS Context Activation # ACT E mail Sending # D E mail Parameters Save #ESAV E mail Parameters Reset #ERST SMTP Message # MSG Send Mail with Attachment #SMTPCL Calculate and Update Date and Time #NTP Easy Scan Extension AT s Network Survey #CSURV Network Survey (Numeric Format) #CSURVC Network Survey of User Defined Channels #CSURVU Network Survey of User Defined Channels (Numeric Format) #CSURVUC BCCH Network Survey #CSURVB BCCH Network Survey (Numeric Format) #CSURVBC Network Survey Format #CSURVF Remove <CR><LF> on Easy Scan s Family #CSURVNLF Extended Network Survey #CSURVEXT PLMN Network Survey #CSURVP PLMN Network Survey (Numeric Format) #CSURVPC SIM Toolkit s SIM Toolkit Interface Activation #STIA SIM Tookit Get Information #STGI SIM Toolkit Send Response #STSR SIM Toolkit Terminal Attach #STTA Jammed Detect and Report AT s Jammed Detect and Report #JDR Jammed Detect and Report Enhanced #JDRENH Easy Script Extension Python Interpreter s Write Script #WSCRIPT Select Active Script #ESCRIPT Script Execution Start Mode #STARTMODESCR Execute Active Script #EXECSCR Script #RSCRIPT List Script Names #LSCRIPT AT s for GPRS G3 Modems 16

17 CONTENTS List Script Names #LCSCRIPT Delete Script #DSCRIPT Reboot #REBOOT MMS s Network Parameters for MMS #MMSSET General ting #MMSGS Create/Update MMS Message Mailing List #MMSTO Example Send a MMS Message #MMSSEND Example Add MMS Attachment #MMSATTD HTTP Last Message #MMSMSG Notification Handling #MMSSNH Example List Notifications #MMSLN Get MMS #MMSGET AT s for GPRS G3 Modems

18 CONTENTS Forward MMS #MMSFWD Delete MMS from the MMS Proxy Server #MMSDEL List MMS Files #MMSLIMG Delete Image File #MMSDIMG HTTP Client s Configure HTTP Parameters #HTTPCFG Send HTTP Get, Head, or Delete Request #HTTPQRY Sent HTTP POST or PUT Request #HTTPPSND Example Receive HTTP Server Data #HTTPPRCV SAP AT s Remote SIM Enable #RSEN Tones Configuration Signaling Tones Mode #STM Tone Playback #TONE AT s for GPRS G3 Modems 18

19 CONTENTS Extended Tone Generation #TONEEXT Tone Classes Volume #TSVOL User Defined Tone SET #UDTSET command User Defined Tone SAVE #UDTSAV command User Defined Tone Reset #UDTRST command Audio Profile s Audio Profile Selection #PSEL Audio Profile Configuration Save #PSAV Audio Profile Factory Configuration #PRST Audio Filter s Uplink Path Biquad Filters #BIQUADIN Extended Uplink Biquad Filters #BIQUADINEX Cascaded Filters #BIQUADOUT Extended Downlink Biquad Filters #BIQUADOUTEX Echo Canceller Configuration s Audio Profile ting #PSET Handsfree Configuration #HFCFG TX Noice Injector Configuration #TXCNI Handsfree Echo Canceller #SHFEC Handset Echo Canceller #SHSEC Echo Reducer Configuration #ECHOCFG Handset Automatic Gain Control #SHSAGC Handset Noise Reduction #SHSNR Handsfree Automatic Gain Control #SHFAGC Handsfree Noise Reduction #SHFNR Embedded DTMF Decoder s Embedded DTMF Decoder Enabling #DTMF Embedded DTMF Decoder Configuration #DTMFCFG Digital Voice Interface Digital Voiceband Interface #DVI Miscellaneous s PCM Play and Receive #SPCM TeleType Writer #TTY Emergency Call and ecall Management Dial an Emergency Call #EMRGD SSL s Configure SSL Socket General Parameters #SSLCFG AT s for GPRS G3 Modems

20 CONTENTS Opening a Socket SSL to a Remote Server #SSLD Enabling a Socket SSL #SSLEN Fast Redial of an SSL Socket #SSLFASTD Close an SSL Socket #SSLH Restore an SSL Socket after a +++ #SSLO Data from an SSL Socket #SSLRECV Reporting the status of an SSL Socket #SSLS Configure Security Parameters SSL Socket #SSLSECCFG Managing Security Data #SSLSECDATA Sending Data through an SSL Socket #SSLSEND AT Parser Abort CME Error List Mobile Equipment (ME) Error Result Code +CME ERROR: <err> CMS Error List Message Service Failure Result Code +CMS ERROR: <err> Acronyms AT s for GPRS G3 Modems 20

21 INTRODUCTION Introduction This guide describes the AT commands: V.250 general AT command set, in order to maintain the compatibility with existing SW programs. 3GPP TS specific AT command and GPRS specific commands. 3GPP TS specific AT commands for SMS (Short Message Service) and CBS (Cell Broadcast Service). GPS and Fax Class 1 compatible commands. Standard AT commands and proprietary AT commands help you control your product. Formatting Conventions Overview The following syntactical definitions apply: <CR> Carriage return character is the command line and result code terminator character, which value, in decimal ASCII between 0 and 255, is specified within parameter S3. Default: 13. <LF> Linefeed character is the character recognized as line feed character. Its value, in decimal ASCII between 0 and 255, is specified within parameter S4. The line feed character is output after carriage return character if verbose result codes are used (V1 option used) otherwise, if numeric format result codes are used (V0 option used) it does not appear in the result codes. Default: 10. <...> Name enclosed in angle brackets is a syntactical element. They do not appear in the command line. [...] Optional subparameter of a command or an optional part of Terminal Adapter (TA) information response is enclosed in square brackets. Brackets themselves do not appear in the command line. When subparameter is not given in AT commands which have a read command, new value equals its previous value. For AT commands that do not store the values of any of their subparameters which are called action type commands and do not have a read command action performed based on the recommended default setting of the subparameter. AT The syntax rules followed by commands in this guide are similar to those of standard basic and extended AT commands. There are two types of extended commands: Parameter type commands. This type of command may be: set to store a value or values for later use. read to determine the current value or values stored. test to determine ranges of values supported. Each has a test command (trailing =?) to give information about the type of its subparameters. The parameters also have a read command (trailing?) to check the current values of subparameters. Action type commands. This type of command may be executed or tested. executed to invoke a particular function of the equipment, which generally involves more than the simple storage of a value for later use. tested to determine: If subparameters are associated with the action, the ranges of subparameters values that are supported. If the command has no subparameters, issuing the corresponding test command (trailing =?) raises the result code ERROR. The response to the test command (trailing =?) may change in the future to allow the description of new values and functions. Note: Issuing the read command (trailing?) causes the command to be executed. 21 AT s for GPRS G3 Modems

22 INTRODUCTION Whether or not the equipment implements the action command (in this case issuing the corresponding test command trailing =? returns the result code), and, if subparameters are associated with the action, the ranges of subparameters values that are supported. Action commands do not store the values of any of their possible subparameters. Moreover: If all the subparameters of a parameter type command +CMD (or #CMD or $CMD) are optional, issuing AT+CMD=<CR> (or AT#CMD=<CR> or AT$CMD=<CR>) causes the result code to be returned and the previous values of the omitted subparameters to be retained. String Type Parameters A string, enclosed between quotes or not, is a valid string type parameter input. According to V.25ter, space characters are ignored on the command line and may be used freely for formatting purposes, unless they are embedded in numeric or quoted string constants. Therefore, a string containing a space character has to be enclosed between quotes to be considered a valid string type parameter. A string is always case sensitive. Some commands require you to always place the input string parameters within quotes. When this is required, the command descriptions explicitly tell you so. Lines A command line is made up of three elements: the prefix, the body, and the termination character. The command line prefix consists of the characters AT or at. To repeat the execution of the previous command line, use the characters A/ or a/ or AT#/ or at#/. Using parameter S3, you can select the termination character. The default is <CR>. The structures of the command line are: ATCMD1<CR> where AT is the command line prefix, CMD1 is the body of a basic command and <CR> is the command line terminator character. The name of the command never begins with the character + ATCMD2=10<CR> where 10 is a subparameter. AT+CMD1;+CMD2=,,10<CR> these are two extended command examples. They are delimited with semicolon. In the second command, the subparameter is omitted. The name of the command always begins with the character +. +CMD1?<CR> This is a read command for checking current subparameter values. +CMD1=?<CR> This is a test command for checking possible subparameter values. These commands might be performed in a single command line as shown below: ATCMD1 CMD2=10+CMD1;+CMD2=,,10;+CMD1?;+CMD1=?<CR> Separating basic commands and extended commands into different command lines is recommended. Avoid placing several action commands in the same command line. If one command fails, an error message is received. However, it is not possible to determine which command failed the execution. AT s for GPRS G3 Modems 22

23 INTRODUCTION If command V1 is enabled (verbose responses codes) and all commands in a command line performed successfully, result code <CR><LF><CR><LF> is sent from the TA to the TE. If subparameter values of a command are not accepted by the TA or command itself is invalid, or command cannot be performed for some reason, result code <CR><LF>ERROR<CR><LF> is sent and no subsequent commands in the command line are processed. If command V0 is enabled (numeric responses codes), and all commands in a command line performed successfully, result code 0<CR> is sent from the TA to the TE. If sub parameter values of a command are not accepted by the TA or command itself is invalid, or command cannot be performed for some reason, result code 4<CR> and no subsequent commands in the command line are processed. In case of errors depending on ME operation, ERROR (or 4) response may be replaced by +CME ERROR: <err> or +CMS ERROR: <err>. Note: The command line buffer accepts a maximum of 80 characters. If this number is exceeded none of the commands are executed and TA returns ERROR. Information Responses and Result Codes For the previous Example, if verbose response format is enabled the terminal adapter (TA) response might appear as: Information response to +CMD1? <CR><LF>+CMD1:2,1,10<CR><LF> Information response to +CMD1=? <CR><LF>+CMD1(0 2),(0,1),(0 15)<CR><LF> Final result code <CR><LF><CR><LF> Result codes according to ITU T V.25ter Two types of result codes include: Result codes that inform about progress of TA operation, for example connection establishment CONNECT. Result codes that indicate occurrence of an event not directly associated with issuance of a command from TE (for example ring indication RING). Numeric form Verbose form 0 1 CONNECT or CONNECT <text> where <text> can be 300, 1200, 2400, 4800, 9600, or 1200/75 2 RING 3 NO CARRIER 4 ERROR 6 NO DIALTONE 7 BUSY 8 NO ANSWER 23 AT s for GPRS G3 Modems

24 INTRODUCTION Response Timeout If response codes are enabled, which is the default setting, then every command issued to the module returns a result response. The time needed to process the given command and return the response varies depending on the command type. s that do not interact with the network, and only involve internal setups or readings, have a quicker response than commands that require network interaction. The table below lists the commands whose network interaction may lead to long response times. When not otherwise specified, timing is referred to set commands. For phonebook and SMS writing and reading related commands, timing is referred to commands issued after phonebook sorting completes. For DTMF sending and dialing commands, timing is referred to the module registered on the network ( AT+CREG? answer is +CREG: 0,1 or +CREG: 0,5 ). Estimated maximum time to get response (Seconds) +COPS +CLCK +CLAC 5 +CPWD +CLIP +CLIR +CCFC 15 +CCWA 15 +CHLD 30 +CPIN 5 +CPBS +CPBR +CPBF +CPBW 5 +CACM 5 +CAMM 5 +CPUC 5 +VTS +CSCA +CSAS 5 30 (test command) 25 (SS operation) 5 (FDN enabling/disabling) 15 (SS operation) 5 (PIN modification) 15 (read command) 15 (read command) 5 (FDN enabling/disabling) 5 (single reading) 15 (complete reading of a 250 records full phonebook) 10 (string present in a 250 records full phonebook) 5 (string not present) 20 (transmission of full *#ABCD string with no delay between tones, default duration) 5 (read and set commands) AT s for GPRS G3 Modems 24

25 INTRODUCTION Estimated maximum time to get response (Seconds) +CRES 5 +CMGS +CMSS +CMGW +CMGD +CMGR 5 +CMGL 100 +CGACT 150 +CGATT 10 D A H 30 +CHUP 5 +COPN 10 +CPOL +CRSM 5 #MBN 10 #TONE #ADC 5 # D 20 # ACT after CTRL Z for SMS not concatenated; 1 to get > prompt 60 after CTRL Z; 1 to get > prompt 60 after CTRL Z for SMS not concatenated; 1 to get > prompt 5 (single SMS cancellation) 25 (cancellation of 50 SMS) 30 (voice call) Timeout set with ATS7 (data call) 30 (voice call) Timeout set with ATS7 (data call) 10 (set command; read command of 84 records) 5 (if no duration specified) #S 170 ( context activation + DNS resolution ) #MSCLASS 15 #SPN 5 #STSR 10 #CCID 5 #GPRS 150 #QDNS 20 #FTPOPEN #FTPCLOSE #FTPTYPE #FTPDELE #FTPPWD #FTPCWD 500 (timeout set with AT#FTPTO, in case no response is received from server) 500 (timeout set with AT#FTPTO, in case no response is received from server) 500 (timeout set with AT#FTPTO, in case no response is received from server) 500 (timeout set with AT#FTPTO, in case no response is received from server) 500 (timeout set with AT#FTPTO, in case no response is received from server) 500 (timeout set with AT#FTPTO, in case no response is received from server) 25 AT s for GPRS G3 Modems

26 INTRODUCTION Estimated maximum time to get response (Seconds) #FTPLIST 500 (timeout set with AT#FTPTO, in case no response is received from server) + time to get listing #FTPFSIZE #FTPPUT #FTPAPP #FTPGET #FTPGETPKT #SGACT 150 #SH 3 #SD 500 (timeout set with AT#FTPTO, in case no response is received from server) 500 (timeout set with AT#FTPTO, in case no response is received from server) 500 (timeout set with AT#FTPTO, in case no response is received from server) 500 (timeout set with AT#FTPTO, in case no response is received from server) 500 (timeout set with AT#FTPTO, in case no response is received from server) 140 (DNS resolution + connection timeout set with AT#SCFG) #CSURV #CSURVC #CSURVU #CSURVUC #CSURVB #CSURVBC #CSURVP #CSURVPC #LSCRIPT 10 to start data output; 120 seconds to complete scan 10 to start data output; 120 seconds to complete scan 10 to start data output; 120 seconds to complete scan 10 to start data output; 120 seconds to complete scan 10 to start data output; 120 seconds to complete scan 10 to start data output; 120 seconds to complete scan 10 to start data output; 120 seconds to complete scan 10 to start data output; 120 seconds to complete scan 10 (40 files, 10 KB each) #REBOOT 5 #RSCRIPT #WSCRIPT #DSCRIPT seconds for a 100 KB file 30 seconds timeout and ERROR message if no bytes are received on the serial line 35 seconds for a 100 KB file 30 seconds timeout and ERROR message if no bytes are sent on the serial line and the file has not been completely sent Issuing Timing The chain > Response is always respected. You may not issue a new command until the module finishes sending all of its response result codes. This applies especially to applications that sense the text and therefore may send the next command before the complete code <CR><LF><CR><LF> is sent by the module. It is recommended to wait for at least 20ms between the end of the reception of the response and the issue of the next AT command. If the response codes are disabled, and as such, the module does not report responses to the command, then the 20ms pause time is respected. AT s for GPRS G3 Modems 26

27 INTRODUCTION Storing Values by s Overview Factory Profile and User Profiles The wireless module stores the values set by several commands in the internal, non volatile memory (NVM), allowing this setting to remain even after power off. In the NVM, these values are set either as factory profile or as user profiles. There are two customizable user profiles and one factory profile in the NVM of the device: By default, the device starts with user profile 0 equal to factory profile. For backward compatibility, each profile is divided into two sections: base section, which was historically the one that was saved and restored in early releases of code, and extended section, which includes all the remaining values. The &W command is used to save the actual values of both sections of profiles into the non volatile memory user profile. s &Y and &P are both used to set the profile to be loaded at startup. &Y instructs the device to load only the base section at startup. &P instructs the device to load, at startup, the full profile: base + extended sections. For commands in the base section, the &F command resets values to factory profile defaults. &F1 resets to factory profile values the full set of base + extended section commands. The values set by other commands are stored in non volatile memory outside the profile. Some values are always stored, without issuing &W. Other values are stored by issuing specific commands (+CSAS, #ESAV). All of these values are read at power up. The values set by the following commands are stored in the profile base section. They depend on the specific AT instance. GSM DATA MODE +CBST AUTOBAUD +IPR COMMAND ECHO E RESULT MESSAGES Q VERBOSE MESSAGES V EXTENDED MESSAGES X FLOW CONTROL OPTIONS &K, +IFC DSR (C107) OPTIONS &S DTR (C108) OPTIONS &D RI (C125) OPTIONS \R POWER SAVING +CFUN DEFAULT PROFILE &Y0 S REGISTERS S0;S2;S3;S4;S5;S7;S12;S25;S30;S38 CHARACTER FORMAT +ICF 27 AT s for GPRS G3 Modems

28 INTRODUCTION The values set by following commands are stored in the profile extended section. They depend on the specific AT instance (see +CMUX). +FCLASS +ILRR +DR +CSCS +CR +CRLP +CRC +CSNS +CVHU +CREG +CLIP +CLIR +CCWA +CUSD +CAOC +CSSN +CIND +CMER +CPBS +CMEE +CGREG +CGEREP +CMGF +CSDH +CNMI #QSS #ACAL #TEMPMON #ACALEXT #ECAM #SMOV #MWI #NITZ #SKIPESC #E2ESC #STIA +CSTF #CESTHLCK #CFLO +CTZR +CSDF +CTZU +CCWE #CFF +CSIL #CMEEMODE #MMSSNH ACAL depends on the CMUX 0 instance only #TEMPMON is partially stored in non volatile memory. See command description for details. The values set by following commands are stored in the profile extended section and don t depend on the specific AT instance (see +CMUX). +CALM +CRSL +CMUT +CLVL +VTD +CSCB #STM #DVI #E2SMSRI #SPKMUT #CODEC #SHFEC #SIMDET #NITZ #E2SLRI #SHSEC #TEMPMON #PSEL #SHFNR #TSVOL #SHFAGC #CPUMODE #PSMRI #SHSNR #TEMPMON is partially stored in non volatile memory. See command description for details. +CMUT, +CLVL, #CAP, #SRS, #SRP, #STM, and #SHFEC depend on the CMUX 0 instance only. For +CSBC, storing and restoring are accomplished with +CSAS and +CRES. AT s for GPRS G3 Modems 28

29 INTRODUCTION The values set by following commands are automatically stored in non volatile memory, without issuing any storing command and independently from the profile (unique values), and are automatically restored at startup. +CGDCONT +COPS +CGCLASS #REGMODE +CGQMIN +CGQREQ #DIALMODE #PLMNMODE #AUTOBND #ENS #BND #JDR #ENHSIM #SCFG #TXMONMODE #TTY #AUTOATT #GSMCONT #NWSCANTMR #ICMP #DNS #TCPMAXDAT #SMSMODE #SWLEVEL #CPASMODE #TCPREASS +CGSMS #V24MODE #FASTCCID +CPLS +COPS is partially stored in non volatile memory. See command description for details. The values set by following commands are stored in non volatile memory on demand, issuing specific commands and independently from the profile: +CSCA +CSMP +CSCB Stored by +CSAS command and restored by +CRES command. Note, that both +CSAS and +CRES deal with non volatile memory and SIM storage. #VAUX Stored by the #VAUSAV command #USERID #PASSW #PKTSZ #DSTO #SKTTO #SKTSET #SKTCT Stored by #SKTSAV command and automatically restored at startup. #SKTRST restores default values. #ESMTP #EADDR #EUSER #EPASSW Stored by #ESAV command and automatically restored at startup. #ERST restores default values. #BIQUADIN #BIQUADINEX #BIQUADOUT #BIQUADOUTEX Stored by $PSAV command and automatically restored at startup. #PRST command restores default values. 29 AT s for GPRS G3 Modems

30 Format for Entering AT s This chapter describes the general format you must use when entering AT commands. Line Prefixes Starting A Line AT FORMAT FOR ENTERING AT COMMANDS The prefix AT is a two character abbreviation for Attention. With one exception the AT#/ prefix you always use AT to start a command line that is sending commands from Terminal Equipment (TE) to Terminal Adapter (TA). If you want to learn more about this command, refer to the 3GPP TS specification. Last Automatic Repetition A/ If the prefix A/ or a/ is issued, the module immediately re executes the body of the preceding command line. No editing is possible and no termination character is necessary. A command line may be repeated multiple times through this mechanism, if desired. If A/ is issued before any command line is executed, the preceding command line is assumed to have been empty (that results in an result code). This command works only at fixed IPR. The A/ command is similar to the custom prefix AT#/, in that both prefixes cause the last command to be reexecuted. However, the prefix AT#/ does not need a fixed IPR. If you want to learn more about this command, refer to the V.25ter specification. Repeat Last AT#/ Use this prefix to re execute the last received command. AT s for GPRS G3 Modems 30

31 REMOTELY ISSUING AT COMMANDS Remotely Issuing AT s You can configure Multi Tech devices to accept AT commands issued remotely via SMS from another cellular device and to send AT command responses to that remote device. To do this, enable SMS AT Run and then use SMS AT Run White List to specify the phone number(s) that the device is allowed to process AT commands from. When you enable this feature, the AT command instance defined by AT#SMSATRUNCFG processes remote AT commands and is not available locally. Warnings Do not enable SMS AT Run with AT#SMSATRUNCFG set at the default value. The default AT#SMSATRUNCFG setting configures the SMS ATRN to occur over AT command instance 3. Enabling SMS AT Run with the default setting blocks local applications from communicating over the auxiliary AT command interface. Certain devices and applications may primarily communicate via the primary modem AT command port and use the secondary AT command port for queries such as signal or registration or for sending SMS. Enabling SMS AT Run in these scenarios adversely affects device operation; the device will not respond to any command sent to the auxiliary AT command port. If your application or hardware communicates over only one AT command instance and it is the same AT command instance defined by AT#SMSATRUNCFG, enabling AT#SMSATRUN will make the device inoperable. With AT#SMSATRUN enabled, the device can t end additional AT commands, because that one instance would be used only for remote SMS AT Run functions and would be unavailable locally. In this case, the device won t accept remote commands because you can t set up phone numbers in the white list. Phone numbers can t be added to the white list until AT#SMSATRUN is enabled. Configuring SMS AT Run Use these steps to configure devices to accept remote AT commands sent via SMS from specific phone numbers. 1. Issue AT#SMSATRUN=1 the device to enable SMS AT Run functionality. 2. Issue AT#SMSATWL=0,x,0,"##########" to the device to add a phone number to the white list; x represents index values of 1 through 8 and ########## represents the phone number. The device must be located where it has access to a cellular network. The device must be registered on the cellular network. The device s SIM account must have active SMS functionality, allowing it to send/receive SMS messages. The device must be in a functional state to process the remote SMS AT and reply to it. Example Issue Device s: AT#SMSATRUN=1 AT#SMSATWL=0,1,0," " Phone number sends an AT via SMS message to the device: AT+GMR 31 AT s for GPRS G3 Modems

32 REMOTELY ISSUING AT COMMANDS The device sends an AT response via SMS to phone number : Some commands don t return SMS responses. For example, AT#REBOOT resets the radio and doesn t send a response. AT#SMSATRUN and AT#SMSATWL automatically save to non volatile memory and are not erased via AT&F or AT&F1 or power cycle. AT s for GPRS G3 Modems 32

33 3GPP TS AT COMMANDS V.250 AT s Generic Modem Control to Factory Defined Configuration &F Execute command sets the configuration parameters to default values specified by the manufacturer. This includes hardware configuration switches and other manufacturer defined criteria. AT&F[<value>] type <value> Hardware version, a string of no more than 31 characters. 0 Only the factory profile base section parameters are set to default values. 1 Full factory profile restored, that is, the factory profile base section and the extended section are restored. If parameter <value> is omitted, the command has the same behavior as AT&F0. Reference: V.25ter. Soft Reset Z Execute this command to the base section of the specified user profile and the extended section of the default factory profile. ATZ[<n>] type Execute <n> Hardware version, a string of no more than 31 characters. 0 1 User profile number. Any call in progress is terminated. If parameter <n> is omitted, the command has the same behavior as ATZ0. Reference: V.25ter. Select Active Service Class +FCLASS command sets the wireless module in specified connection mode (data, fax, voice). All calls done after you set FCLASS are data or voice. command returns the current value of <n>. command returns all supported values of <n>. 33 AT s for GPRS G3 Modems

34 3GPP TS AT COMMANDS AT+FCLASS=<n> AT+FCLASS? AT+FCLASS=? type This device supports the following values: <n> 0 Data. Default: 0. 1 Fax class 1. Not supported. 8 Voice. Reference: 3GPP TS Default Reset Basic Profile Designation &Y Execute command to define the basic profiles that load on startup. AT&Y[<n>] type Execute <n> 0 1 Profile. The wireless module can store 2 complete configurations See &W. Default: 0. Different from command Z<n>, which loads just once the desired profile, the one chosen through command &Y is loaded on every startup. If parameter is omitted, the command has the same behavior as AT&Y0. Default Reset Full Profile Designation &P Execute command defines which full profile is loaded on startup. AT&P[<n>] type Execute <n> 0 1 Profile number. The wireless module can store 2 full configurations. See &W. AT s for GPRS G3 Modems 34

35 3GPP TS AT COMMANDS Different from command Z<n>, which loads just once the desired profile, the one chosen through command &P is loaded on every startup. If parameter is omitted, the command has the same behavior as AT&P0. Store Current Configuration &W Execute command stores the complete configuration of the device in profile <n>. AT&W[<n>] type Execute <n> 0 1 Profile. If parameter is omitted, the command behaves the same as AT&W0. Store Telephone Number &Z Execute command stores the telephone number <nr> in the record <n>. The records cannot be overwritten. You must clear them before rewriting. AT&Z<n>=<nr> type <n> Phonebook record, 0 9. <nr> String type, telephone number. The wireless module has built in, non volatile memory where you can store 10 telephone numbers, each with a maximum 24 digits. To delete the record <n>, issue the command AT&Z<n>=<CR>. Use the command &N to view the records in the module memory To dial the telephone number stored in the record use the command ATDS=<n>. Example Store the number to index 0: AT&Z0= AT s for GPRS G3 Modems

36 3GPP TS AT COMMANDS Display Stored Numbers &N Execute command returns the telephone number stored at the <n> position in the internal memory AT&N[<n>] type Execute <n> Phonebook record number. If parameter <n> is omitted then all the internal records are shown. Manufacturer Identification +GMI Execute command returns the manufacturer identification. AT+GMI type Execute Reference: V.25ter. Model Identification +GMM Execute command returns the manufacturer s model identification. AT+GMM type Execute Reference: V.25ter. Revision Identification +GMR Execute command returns the manufacturer s software revision identification. AT+GMR type Execute Reference: V.25ter. AT s for GPRS G3 Modems 36

37 3GPP TS AT COMMANDS Capabilities List +GCAP Execute command returns the equipment supported command set list. AT+GCAP type Execute Reference: V.25ter. Response indicates: +CGSM: GSM ETSI command set. +DS: Data Service common modem command set. +MS: Mobile Specific command set. +FCLASS: Fax class. Not supported. Serial Number +GSN Execute command returns the cellular radio serial number. AT+GSN type Execute The number returned is not the IMSI; it is only the board number. Reference: V.25ter. Display Configuration and Profile &V Execute command returns some of the base configuration parameters settings. AT&V type Execute The row of information about CTS (C106) OPTIONS is in the output of &V only for compatibility reasons and represents only a dummy value. 37 AT s for GPRS G3 Modems

38 3GPP TS AT COMMANDS Display Configuration and Profile &V0 Execute command returns configuration parameter settings for the following: DTE SPEED EXTENDED MESSAGES DTR (C108) OPTIONS DTE FORMAT LINE SPEED DCD (C109) OPTIONS GSM DATA MODE CONSTANT DTE SPEED RI (C125) OPTIONS AUTOBAUD FLOW CONTROL OPTIONS C108/1 OPERATION COMMAND ECHO CTS (C106) OPTIONS POWER SAVING ON DTR RESULT MESSAGES DSR (C107) OPTIONS DEFAULT PROFILE VERBOSE MESSAGES AT&V0 type Execute This command is the same as &V. The row of information about CTS (C106) OPTIONS is in the output of &V0 only for compatibility reasons and represents only a dummy value. S Registers Display &V1 Use this command to get the value of the S registers in decimal and hexadecimal value in the format: REG DEC HEX <reg0> <dec> <hex> <reg1> <dec> <hex> AT&V1 type Execute <regn> <dec> <hex> S register number. Current value in decimal notation. Current value in hexadecimal notation. AT s for GPRS G3 Modems 38

39 3GPP TS AT COMMANDS Extended S Registers Display &V3 Execute command returns the value of the S registers in decimal and hexadecimal value in the format: REG DEC HEX <reg0> <dec> <hex> <reg1> <dec> <hex> AT&V3 type Execute This device supports the only following values: <regn> <dec> <hex> S register number. Current value in decimal notation. Current value in hexadecimal notation. Display Last Connection Statistics &V2 Execute command returns the last connection statistics & connection failure reason. AT&V2 type Execute Single Line Connect Message \V Execute command set single line connect message. AT\V<n> type Execute <n> 0 Off. 1 On. 39 AT s for GPRS G3 Modems

40 3GPP TS AT COMMANDS Country of Installation +GCI command selects the installation country code. reports the currently selected country code. command reports the supported country codes. AT+GCI=<code> AT+GCI? AT+GCI=? type <code> 59 Italy Master Reset +CMAR command requests that the mobile terminal reset user data. User data resets to default values. command tests for command existence. AT+CMAR=<code> AT+CMAR=? type <phone lock code> String type representing 8 digit security code. Must be verified before master reset. Note This command formats the non volatile memory. After formatting, the module reboots automatically. So formatting is in not interrupted, issue AT+CFUN=4 before starting to format the non volatile memory. DTE Modem Interface Control Echo E command enables or disables the command echo. ATE[<n>] type AT s for GPRS G3 Modems 40

41 3GPP TS AT COMMANDS <n> 0 Disables command echo. 1 Enables command echo, hence commands sent to the device are echoed back to the DTE before the response is given. Default: 1. If parameter is omitted, the command has the same behavior as ATE0. Reference: V.25ter. Quiet Result Codes Q command enables or disables the result codes. ATQ[<n>] type <n> 0 Enables result codes. Default: 0. 1 Disables result codes. 2 Disables result codes. Only for backward compatibility. After issuing either ATQ1 or ATQ2 every information text transmitted in response to commands is not affected. If parameter is omitted, the command has the same behavior as ATQ0. Example After issuing ATQ1 or ATQ2 AT+CREG? +CREG:0,1 Response Format V command determines the contents of the header and trailer transmitted with result codes and information responses. It also determines if result codes are transmitted in a numeric form or an alphanumeric form. For more information about the result codes, refer to Information Responses and Result Codes. ATV[<n>] type 41 AT s for GPRS G3 Modems