LEON-G100/G200. Quad Band GSM/GPRS Data and Voice Modules. AT Commands Manual. locate, communicate, accelerate. Abstract

Transcription

1 locate, communicate, accelerate LEON-G100/G200 Quad Band GSM/GPRS Data and Voice Modules AT Commands Manual Abstract Description of standard and proprietary AT Commands used with u-blox LEON-G100 and LEON-G200 Quad Band GSM/GPRS Data and Voice Modules..

2 Document Information Title Subtitle Document type Document number Document status LEON-G100/G200 Quad Band GSM/GPRS Data and Voice Modules AT Commands Manual GSM.G1-SW B Preliminary This document contains preliminary data, revised and supplementary data may be published later. This document applies to the following products: Name Type number Firmware version PCN reference LEON-G100 LEON-G100-00S n.a. LEON-G200 LEON-G200-00S n.a. This document and the use of any information contained therein, is subject to the acceptance of the u-blox terms and conditions. They can be downloaded from u-blox makes no warranties based on the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. u-blox reserves all rights to this document and the information contained herein. Reproduction, use or disclosure to third parties without express permission is strictly prohibited. Copyright 2009, u-blox AG. u-blox is a registered trademark of u-blox Holding AG in the EU and other countries. GSM.G1-SW B Preface Page 2 of 262

3 Preface u-blox Technical Documentation As part of our commitment to customer support, u-blox maintains an extensive volume of technical documentation for our products. In addition to our product-specific technical data sheets, the following manuals are available to assist u-blox customers in product design and development. AT Commands Manual: This document provides the description of the supported AT commands by the LEON GSM/GPRS Voice and Data Modules to verify all implemented functionalities. System Integration Manual: This Manual provides hardware design instructions and information on how to set up production and final product tests. How to use this Manual The LEON-G100/G200 AT Commands Manual provides the necessary information to successfully design in and configure these u-blox wireless modules. For navigating this document please note the following: This manual has a modular structure. It is not necessary to read it from the beginning to the end. The following symbols are used to highlight important information within the manual: Questions An index finger points out key information pertaining to module integration and performance. A warning symbol indicates actions that could negatively impact or damage the module. If you have any questions about u-blox Wireless Hardware Integration, please: Read this manual carefully. Contact our information service on our homepage Read the questions and answers on our FAQ database Technical Support Worldwide Web Our website ( is a rich pool of information. Product information, technical documents and helpful FAQ can be accessed 24h a day. By If you have technical problems or cannot find the required information in the provided documents, contact the nearest of the Technical Support offices by . Use our service pool addresses rather than any personal address of our staff. This makes sure that your request is processed as soon as possible. You will find the contact details at the end of the document. Helpful Information when Contacting Technical Support When contacting Technical Support please have the following information ready: Module type (e.g. LEON-G100-00S-01) and firmware version (e.g ) Module configuration Clear description of your question or the problem A short description of the application Your complete contact details GSM.G1-SW B Preliminary Preface Page 3 of 262

4 Contents Preface... 3 Contents AT command mode at startup Power saving and CTS handshake DSR and RI activity AT command features Module connection settings Definitions Profiles Default values General operation Start up and initialization AT Commands mode IPC Inter Processor Communication Multiplexing mode +CMUX General commands Manufacturer identification +CGMI Request model identification +CGMM Request Firmware version +CGMR Request for IMEI +CGSN Set TE character set +CSCS Request international mobile subscriber identification +CIMI Card identification +CCID Request complete capabilities list +GCAP Repeat last command A/ Mobile equipment control and status commands Phone activity status +CPAS Switch off MT +CPWROFF Set phone functionality +CFUN GSM.G1-SW B Preliminary Contents Page 4 of 262

5 6.4 Battery charge +CBC Indicator control +CIND Mobile termination event reporting +CMER Clock +CCLK Alarm +CALA Delete alarm +CALD Restricted SIM access +CRSM Alert sound mode +CALM Ringer sound level +CRSL Loudspeaker volume level +CLVL Mute control +CMUT Call meter maximum event +CCWE Set greeting text +CSGT Automatic Time Zone Update +CTZU Time Zone Reporting +CTZR Report mobile termination error +CMEE List all available AT commands +CLAC Call control commands Select type of address +CSTA Dial command D Direct calling from phonebooks D> Select tone dialling T Select pulse dialling P Call answer A Hook control H Monitor speaker loudness L Monitor speaker mode M Call mode +CMOD Hang up call +CHUP Extended error report +CEER Single numbering scheme +CSNS Tone duration +VTD DTMF and tone generation +VTS Redial last telephone number DL Automatic answer S Network service commands GSM.G1-SW B Preliminary Contents Page 5 of 262

6 8.1 Subscriber number +CNUM Signal quality +CSQ Operator selection +COPS Network registration +CREG Preferred operator list +CPOL Read operator names +COPN User to user signalling service 1 +CUUS Security commands Enter PIN +CPIN Facility lock +CLCK Change password +CPWD Phonebook commands Select phonebook memory storage +CPBS Read phonebook entries +CPBR Find phonebook entries +CPBF Write phonebook entry +CPBW Short messages commands Select message service +CSMS Preferred message storage +CPMS Preferred message format +CMGF Save settings +CSAS Restore Settings +CRES Show text mode parameters +CSDH New message indication +CNMI Read message +CMGR New Message Acknowledgement to MT +CNMA List message +CMGL Send message +CMGS Write message to memory +CMGW Send message from storage +CMSS Set text mode parameters +CSMP Delete SMS +CMGD Service center address +CSCA Select cell broadcast message types +CSCB GSM.G1-SW B Preliminary Contents Page 6 of 262

7 12 Supplementary services commands Call forwarding +CCFC Call waiting +CCWA Calling line identification restriction +CLIR Calling line identification presentation +CLIP Connected line identification presentation +COLP Connected line identification restriction +COLR Advise of charge +CAOC Accumulated call meter +CACM Accumulated call meter maximum +CAMM Price per unit and currency table +CPUC Call related supplementary services +CHLD Call deflection +CTFR List current calls +CLCC Supplementary service notifications +CSSN Unstructured supplementary service data +CUSD Closed user group +CCUG Calling name presentation +CNAP Data commands Select bearer service type +CBST Service class selection and identification +FCLASS Service reporting control +CR Cellular result codes +CRC Radio link protocol +CRLP FAX class 2 commands Introduction Adaptive answer +FAA Address & polling capabilities +FAP Buffer size +FBS Data bit order +FBO HDLC frame reporting +FBU DS capabilities parameters +FCC Copy quality checking +FCQ Capability to receive data +FCR Current session results +FCS GSM.G1-SW B Preliminary Contents Page 7 of 262

8 14.11 DTE phase C response timeout +FCT Receive data +FDR Transmit Data +FDT Phase C received EOL alignment +FEA Format conversion +FFC Report file transfer diagnostic frame +FFD Call termination status +FHS Procedure interrupt enable +FIE Initialize facsimile parameters +FIP Current session parameters +FIS Inactivity timeout +FIT Session termination +FKS, +FK Local ID string +FLI Set flow control +FLO Indicate document to poll +FLP Request manufacturer Identification +FMI Request model identification +FMM Request revision identification +FMR Minimum phase C speed +FMS Negotiation reporting +FNR Non-standard frame FIF octet string +FNS NSF message data indication +FND Selective polling address +FPA Local polling ID string +FLI Packet protocol control +FPP Page status +FPS Password parameter +FPW Receive quality thresholds +FRQ Error correction mode retry count +FRY SubAddress parameter +FSA Request to poll +FSP Fax intermediate result codes V24 control and V25ter commands Reset to default configuration Z Set to factory defined configuration &F Circuit 109 behavior &C GSM.G1-SW B Preliminary Contents Page 8 of 262

9 15.4 Circuit 108/2 behaviour &D DSR override &S Flow control &K Store current configuration &W Display current configuration &V Designate a default reset profile &Y Request identification information I Request manufacturer Identification +GMI Request model identification +GMM Request revision identification +GMR Request product serial number identification +GSN DTE-DCE character framing +ICF DTE-DCE local flow control +IFC Set flow control \Q Fixed DTE rate +IPR System can Return to on-line data state O Escape character S Command line termination character S Response formatting character S Command line editing character S Pause before blind dialling S Connection completion timeout S Command dial modifier time S Automatic disconnect delay S Escape prompt delay (EPD) S Command echo E Result code suppression Q DCE response format V Result code selection and call progress monitoring control X SIM toolkit Introduction SIM-APPL-TK proactive commands +STKPRO SIM-APPL-TK terminal response +STKTR SIM-APPL-TK envelope +STKENV SIM-APPL-TK terminal profile +STKPROF SIM-APPL-TK call control commands +STKCC GSM.G1-SW B Preliminary Contents Page 9 of 262

10 16.7 SIM-APPL-TK proactive session status +STKCNF GPRS commands Parameters definition Define PDP context +CGDCONT Quality of service profile (requested) +CGQREQ Quality of service profile (minimum acceptable) +CGQMIN GPRS attach or detach +CGATT PDP context activate or deactivate +CGACT Enter data state +CGDATA Enter IP state/gprs IP dial D Show PDP address +CGPADDR GPRS mobile station class +CGCLASS GPRS event reporting +CGEREP GPRS network registration status +CGREG Select service for MO SMS messages +CGSMS Manaul deactivation of a PDP context H Multiple PDP contexts Specific AT-commands Firmware Update +UFWUPD Antenna Detection +UANTR ADC read command +UADC Power saving control (Power SaVing) +UPSV GPIO select configuration command +UGPIOC GPIO read command +UGPIOR GPIO set command +UGPIOW Tone generator (Tone GeNerator) +UTGN Ringing tone selection command +URNG SMS Alert sound mode (Message Sound Muting) +UMSM I2S Digital Interface Mode +UI2S Audio Path mode setting (Set Path Mode) +USPM Play audio resource (Play Audio Resource) +UPAR Stop audio resource (Stop Audio Resource) +USAR Play AMR audio file +UPLAYFILE Stop AMR audio file +USTOPFILE Network Congestion Detection +UCD Select GSM Band +UBANDSEL GSM.G1-SW B Preliminary Contents Page 10 of 262

11 18.19 Set reporting call status +UCALLSTAT GPRS Operator selection +UCGOPS GPRS cell environment description +CGED Read counters of sent or received GPRS data +UGCNTRD Set/reset counter of sent or received GPRS data +UGCNTSET Read remaining SIM PIN attempts +UPINCNT Help displaying all commands &H File System AT Commands Download file +UDWNFILE Delete file +UDELFILE Read file +URDFILE List files +ULSTFILE Audio parameters tuning commands Introduction Microphone Gain (Microphone Gain Control) +UMGC Speaker Gain (Speaker Gain Control) +USGC Sidetone (SideToNe) +USTN Uplink Digital Filters (Uplink Biquad Filters) +UUBF Downlink Digital Filters (Downlink Biquad Filters) +UDBF Hand Free Parameters (Hand Free Parameters) +UHFP Data Connection Setup AT Commands Packet Switched Data +UPSD Packet Switched Data Action +UPSDA Packet Switched Network-assigned Data +UPSND Circuit Switched Data +UCSD Circuit Switched Data Action +UCSDA Circuit Switched Network-assigned Data +UCSND DNS AT Commands Resolve Name / IP Number through DNS +UDNSRN TCP/IP UDP/IP AT Commands Introduction Create Socket +USOCR Set Socket Option +USOSO Get Socket Option +USOGO GSM.G1-SW B Preliminary Contents Page 11 of 262

12 23.5 Close Socket +USOCL Get Socket Error +USOER Connect Socket +USOCO Write Socket Data +USOWR Read Socket Data +USORD Set Listening Socket +USOLI Firewall control +UFRW FTP AT Commands File Transfer Protocol Control +UFTP File Transfer Protocol Command +UFTPC FTP Unsolicited Data Indication +UUFTPCD FTP Unsolicited Result Indication +UUFTPCR File Transfer Protocol Error +UFTPER HTTP AT commands HTTP Control +UHTTP HTTP Command +UHTTPC HTTP Command Result Unsolicited Indication +UUHTTPCR HTTP rotocol Error +UHTTPER SMTP AT Commands SMTP Control +USMTP SMTP Mail Control +USMTPM SMTP Command +USMTPC SMTP Command Result Unsolicited Indication +UUSMTPCR SMTP Error +USMTPER GPS AT Commands GPS Power Management +UGPS GPS Profile configuration +UGPRF AssistNow Online configuration +UGAOP AssistNow Offline configuration +UGAOF GPS Aiding request command +UGAOS Send of UBX string +UGUBX GPS Indications timer +UGTMR Get GPS Time and date +UGZDA Get GPS fix data +UGGGA GSM.G1-SW B Preliminary Contents Page 12 of 262

13 27.10 Get geographic position +UGGLL Get number of GNSS satellites in view +UGGSV Get recommended minimum GNSS data +UGRMC Get course over ground and ground speed +UGVTG Get course over ground and ground speed +UGGSA Appendix A Appendix A.1 Networking Error A.2 Mobile Termination error result code +CME ERROR A.3 Message service failure result codes +CMS ERROR B AT Commands List B.1 Parameters stored in profiles B.2 Parameters stored in non volatile memory C Glossary Related documents Revision history Contact GSM.G1-SW B Preliminary Contents Page 13 of 262

14 1 AT command mode at startup By default, LEON-G100/G200 modules start with serial port 0 in AT command mode (configuration possible using software with different functions at the serial port, this is out of the scope of this document). Users can execute AT commands in accordance to this document and ETSI / 3GPP [2], [21] specifications. LEON-G100/G200 modules are a Data Circuit-terminating Equipment (DCE) modem, in conformity to the specifications in [21], [20], [26]. In this document the following serial line convention is used: Tx (103) Rx (104) RTS (105) CTS (106) DTR (108/2) DSR (107) DCE / Modem DTE / Computer DCD (109) RI (126) Serial lines at startup are: Circuit 107, DSR: ON Circuit 106, CTS: ON Circuit 109, DCD: OFF Circuit 126, RI: OFF Circuit 108/2 DTR is relevant when the module is in data traffic only Circuit 105 RTS is continuously monitored i.e. the flow control is usually hardware like default (AT&K3). The CTS line and module power saving are synchronized to prevent the Data Terminal Equipment (DTE) from delivering data when the module cannot receive it. If power saving is enabled without hardware flow control, the data provided by the DTE can be lost. The modem UART connector lines operate within a voltage range of 0 V (space) to 1.8 V (mark). The EIA- TIA RS-232 standard defines the ON state as +12 V and the OFF state as -12 V, which is too large a voltage range for telecom devices. Because of this the electrical values for the modem connector UART lines are inverted and scaled with respect to the RS-232 electrical values. Note that the figures in this document use the EIA-TIA RS-232 notation, while the real electrical values are inverted (ON=0 V, OFF=1.8 V). GSM.G1-SW B Preliminary AT command mode at startup Page 14 of 262

15 1.1 Power saving and CTS handshake The CTS line is used during power saving mode to prevent a remote DTE from sending data to the DCE when the DCE cannot receive. During power saving mode, module activity and the system reference clock are reduced. Under these conditions the UART cannot receive data and the CTS line is switched to the OFF state. When the module is connected to a network, it periodically wakes up in order to synchronize with network activity. Power saving mode time is in relationship to network parameters and can be up to 450 GSM time frames (~2 s). Note that this time is not constant, it is only a maximum time reference and is valid when the module is connected to the network. When the module wakes-up, the CTS line is switched ON and remains in this state for at least 3 GSM time frames (~14 ms). If the module is active on the network or data is delivered at the UART port, then the module remains in operation mode, otherwise it returns to power saving mode. The time amount until the module enters power saving mode is variable and it depends on parameters such as: Type of network activity SW activity Elapsed time since last data received at the serial port: after 5000 GSM frames (~23 s) without serial activity (data transmitted or received) the serial drivers allow the module to enter power saving mode if there are no other activities Figure 1 shows an example of CTS line activity inside and outside power saving mode in different scenarios. Most power saving mode scenarios have an unpredictable time line because they are influenced by external events and network activity. data input here CTS ON CTS OFF time [# GSM frames] max 450 GSM frames at least 5000 GSM frames at least 3 GSM frames (without any activity) Figure 1: CTS line activity GSM.G1-SW B Preliminary AT command mode at startup Page 15 of 262

16 1.2 DSR and RI activity Incoming SMS The RI line is also used to notify an SMS arrival. The RI switches from OFF to ON for 1 second as shown in Figure 2. 1s RI ON RI OFF Figure 2: RI line activity during SMS arrival SMS arrives time [s] DSR at power on After power on the DSR line follows the rule shown in Figure 3: ON DSR line OFF 0 T switch time [s] power on T switch depends on the boot process duration (time from reset to UART initialization). Figure 3: DSR line activity at power on GSM.G1-SW B Preliminary AT command mode at startup Page 16 of 262

17 2 AT command features 2.1 Module connection settings For module and hyper terminal connection and settings see EVK-G25H Evalution Kit Getting Started [43]. 2.2 Definitions In this document the naming convention is to refer to the module as the DCE (Data Communications Equipment) or MT (Mobile Terminal) while the terminal that sends the command to the module is the TE (Terminal Equipment) or DTE (Data Terminal Equipment). The terms DCE and DTE are used in the context of the serial interface. A brief overview is shown below: AT commands configure and enable the wireless module functionalities in accordance to 3GPP normative and u-blox specifications. The AT commands are provided via a hyper terminal through a command line and are described in the following chapters. A general description of each command is provided including functionalities, correct syntax to be provided by the TE/DTE, possible responses, and an example. The command description defines each parameter of the command with its scope and parameter type, the supported values and the default value (when available). AT commands are typically provided to wireless modules using a command line with the following generic syntax: AT <command_name><string><cr><lf> Where: "AT" is a prefix to be set at the beginning of each command line <command_name> is the command name string; it can have a + character as prefix <string> is a string consisting of the value parameters following the syntax provided in this manual; <CR> is the carriage return character, with value specified by command S3. <LF> is the linefeed character, with value specified by command S4. The maximum number of command line characters for a single command is 512. This value depends on the hyper terminal used; in some cases the number of characters is less. When writing or sending an SMS, CtrlZ or ESC terminates the command; <CR> is used between the 2 parts of the SMS (address and text). If the command line could be performed successfully, the string is sent. In the following descriptions <CR><LF> are intentionally omitted. The command line is not case sensitive. If a parameter is omitted, no value will be inserted between the two commas indicating the interested parameter in the command line sent by the DTE. The following rules are used when describing the command syntax: <...>: Name in angle brackets is a parameter. The brackets themselves do not appear in the command line; GSM.G1-SW B Preliminary AT command features Page 17 of 262

18 [...]: the square brackets represent the optional parameters of a command or an optional part of the TA information response. Brackets themselves do not appear in the command line. When parameter is not given, the value will be set to the default. The response format can be set with ATV command (for more details refer to the command description, section 15.31). The default setting (ATV1) is as follows: Information responses: <CR><LF><text><CR><LF> Result codes: <CR><LF><verbose code><cr><lf> If the command is not accepted by the MT a message error will be displayed. The format of the message error can be set with AT+CMEE command (see the command description form more details). The default setting adopted in this manual is AT+CMEE=2 and the message error is displayed with this format: +CME ERROR: <err> where <err> represent the result code using verbose <err> values. If the command is not supported or unknown, +CME ERROR: unknown is sent. If the command syntax is wrong, +CME ERROR: operation not supported is sent. If the parameters are wrong, +CME ERROR: <error> or +CMS ERROR: <error> is sent. If no SIM-card is present or the PIN was not correctly entered, +CME ERROR: <error> is sent for the most commands. <error> hints at the kind of the error. The list of all allowed errors is available in Appendix A.2 and A.3. For some commands only the message ERROR is displayed and is documented in the command description. 2.3 Profiles The default settings of some commands are stored in the memory of the wireless module (for a complete list of the command please refer to chapter B). While a subset of these commands is stored in the non volatile memory, other default settings of the commands are organized in two personal profiles. The first profile is the default profile and the data contained in him is used during the module power on (for the complete list of the commands and their values please refer to B.1. For more details related to the loading, storing and updating of the profiles please refer to AT&W (chapter 15.7), AT&V (chapter 15.8) command description. 2.4 Default values If the command parameters are optional, they can be also left out in the command line. In such cases normal default values are assumed as follows: In case of integer type parameters, the default value is 0, except the cases specified for each concerned command; In case of text parameters, the default value is an empty string, except the cases specified for each concerned command. GSM.G1-SW B Preliminary AT command features Page 18 of 262

19 3 General operation 3.1 Start up and initialization A complete start up can take place only with a SIM-card with disabled PIN-check. For a SIM-card with enabled PIN check the most commands are answered with +CME ERROR: SIM-PIN requested. After entering PIN via +CPIN command, which allows a start up completion, a lot of SIM-files will be read; it is possible that some commands are affected for a few seconds. The serial interface driver does not allow a new command, until the old one is terminated by or +CME ERROR: <error>. If at start up the MT detects inconsistencies related to the NVRAM the following message is displayed:! NVR DOES NOT FIT TO SW-VERSION. NVR-update is needed!. 3.2 AT Commands mode Action Command An action command is used to force the DCE to transmit an information or execute a specific action for the command. A typical usage of this command mode is to provide the manufacturer settings proper of the DCE like manufacturer name, firmware version, etc Set Command A Set Command is performed to set the preferred settings for the specific command. The set command is the only way to set the preferred settings in the DCE. For a subset of the commands is possible to store in the profile the current settings and retrieve them in a another connection Read Command A Read Command provides the current values of the command parameters. It is used to know the last configuration of the parameters of the command Test Command A Test Command provides the complete list of the values supported by each parameter of the command. For a specific set of commands the information can be provided directly by the DCE when a specific event happens. This type of command is an unsolicited (or intermediate) result and can be enabled through a set command Unsolicted Result Code (URC) The unsolicted result code can have the same name of the command that enables it (e.g. +CREG) or can be enabled by another command (e.g. unsolicited command: +CMTI, command that enables it: +CNMI) GSM.G1-SW B Preliminary General operation Page 19 of 262

20 4 IPC Inter Processor Communication 4.1 Multiplexing mode +CMUX Description Enables the multiplexing protocol control channel as defined in 3GPP The command sets parameters for the Control Channel. If parameters are no specified, the default values are used. The response code is returned using the old interface speed. The parameters become active only after sending. Usage of +CMUX command while multiplexing is not not allowed. The Mux configuration is reported as follows: Channel 0: Mux control Channel 1: GPS reserved Channel 2-5: available for free usage Read commands are possible only on virtual channels (2-5) Set AT+CMUX=<mode>[,<subset>[,<port_s peed>[,<n1>[,<t1>[,<n2>[,<t2>[,<t3> [,<k>]]]]]]] Read AT+CMUX? +CMUX: <mode>,[<subset>],<port_speed>,<n1 >,<T1>,<N2>,<T2>,<T3>[,<k>] +CMUX: 0,0,0,0,0,0,0,0,0 Test AT+CMUX=? +CMUX: (list of supported <mode>s),(list of supported <subset>s),(list of supported <port_speed>s), (list of supported <N1>s), (list of supported <T1>s),(list of supported <N2>s),(list of supported <T2>s),(list of supported <T3>s), (list of supported <k>s) +CMUX: (0),(0),(0),(1-1509),(1-255),(0-5),(2-255),(0),(0) GSM.G1-SW B Preliminary IPC Inter Processor Communication Page 20 of 262

21 4.1.2 Defined Values M / O mandatory or optional parameters. Unless otherwise specified, all parameters are mandatory. <mode> Integer M Multiplexer Transparency Mechanism <subset> Integer M Char set 0: Basic option (default); 1-7: currently not supported, in case of read command 0 is returned. 0: UIH frames used only (Default value); 1: UI frames used only; value currently not supported; 2: I frames used only; value currently not supported. <port_speed> Integer M Transmission rate; this parameter is not supported and the value 0 is always displayed in case of read command. <N1> Integer Maximum frame size : Currently only the range is supported; <T1> Integer Acknowledgement timer in units of ten milliseconds 1-255; currently only the value 253 is supported <N2> Integer O Maximum number of re-transmissions 0-5: 3 is default; currently only the range 0-5 is supported <T2> <T3> <k> Response timer for the multiplexer control channel in units of ten milliseconds 2-255; currently only the value 254 is supported Wake up response timer in seconds only the value 0 is currently supported Window size, for Advanced operation with Error Recovery options only the value 0 is currently supported T2 must be longer than T1. GSM.G1-SW B Preliminary IPC Inter Processor Communication Page 21 of 262

22 5 General commands 5.1 Manufacturer identification +CGMI Description Text string, determined by the manufacturer, identifying the manufacturer. Action AT+CGMI <manufacturer> Test AT+CGMI=? Defined Values <manufacturer> String manufacturer name 5.2 Request model identification +CGMM Description Text string, determined by the manufacturer, identifying the manufacturer. Action AT+CGMM <model> Test AT+CGMM=? Defined Values <model> String Name of model GSM.G1-SW B Preliminary General commands Page 22 of 262

23 5.3 Request Firmware version +CGMR Description Returns the firmware version of the module. Action AT+CGMR <version> Test AT+CGMR=? Defined Values <version> String Firmware version 5.4 Request for IMEI +CGSN Description Returns the product serial number, IMEI (International Mobile Equipment Identity) of the MT. Action AT+CGSN <IMEI> Test AT+CGSN=? Defined Values <version> String IMEI GSM.G1-SW B Preliminary General commands Page 23 of 262

24 5.5 Set TE character set +CSCS Description Selects the TE character set. Set AT+CSCS=<chset> AT+CSCS= IRA Read AT+CSCS? +CSCS=<chset> Test AT+CSCS=? +CSCS: (list of supported <chset>'s) +CSCS="IRA" +CSCS: ("IRA","GSM","PCCP437","8859-1","UCS2","HEX") Defined Values <chset> String M IRA : International Reference Alphabet (ITU-T T.50) GSM : GSM default alphabet (3GPP TS ) PCCP437 : PC character set Code Page : ISO 8859 Latin 1 character set UCS2 : 16-bit universal multiple-octet coded character set (USO/IEC10646); UCS2 character strings are converted to hexadecimal numbers from 0000 to FFFF. Only the strings found in quotation marks are UCS2 coded, the rest of commands or responses, remains in IRA alphabet "HEX": character strings consist only of hexadecimal numbers from 00 to FF; e.g. "032FE6" equals three 8-bit characters with decimal values 3, 47 and 230; no conversions to the original MT character set shall be done 5.6 Request international mobile subscriber identification +CIMI Description Request the IMSI (International Mobile Subscriber Identity). Action AT+CIMI <IMSI> Test AT+CIMI=? GSM.G1-SW B Preliminary General commands Page 24 of 262

25 5.6.2 Defined Values <IMSI> String 5.7 Card identification +CCID Description Returns the ICCID (Integrated Circuit Card ID) of the SIM-card. ICCID is a serial number identifying the SIM. Action AT+CCID +CCID: <ICCID> Read AT+CCID? +CCID: <ICCID> +CCID: CCID: Test AT+CCID=? Defined Values <ICCID> String ICCID of the SIM card 5.8 Request complete capabilities list +GCAP Description This command requests the list of capabilities, containing the corresponding command names. The Complete Capabilities List command indicates the major capability areas of the MT. Each area is presented by the selection command name of the specific capability area or some other predefined response. The first response text (+FCLASS) informs that some fax or voice capabilities are present while the second supported area presented with +CGSM shows that all GSM commands of the present document are supported. Action AT+GCAP +GCAP: <command_name1>, <command_name2> +GCAP: +FCLASS, +CGSM Defined Values <command_name> String command name GSM.G1-SW B Preliminary General commands Page 25 of 262

26 5.9 Repeat last command A/ Description Repeats the previously executed command again. Only the A/ command can not be repeated. Action A/ If autobauding is active, the command A/ cannot be used. GSM.G1-SW B Preliminary General commands Page 26 of 262

27 6 Mobile equipment control and status commands 6.1 Phone activity status +CPAS Description Returns the activity status <pas> of the MT. Action AT+CPAS +CPAS: <pas> Test AT+CPAS=? +CPAS: (list of supported <pas>s) +CPAS: (0-5) Defined Values <pas> Integer M 0: ready (MT allows commands from DTE) 1: unavailable (MT does not allow commands from DTE) 2: unknown (MT is not guaranteed to respond to instructions) 3: ringing (MT is ready for commands from DTE, but the ringer is active) 4: call in progress (MT is ready for commands from DTE, but a call is in progress) 5: asleep (ME is unable to process commands from DTE because it is in a low functionality state) 6.2 Switch off MT +CPWROFF Description Switches off the MT. During shut-down current settings are saved in module s non-volatile memory. Using this command can result in following command line being ignored. Action AT+CPWROFF Test AT+CPWROFF=? GSM.G1-SW B Preliminary Mobile equipment control and status commands Page 27 of 262

28 6.3 Set phone functionality +CFUN Description Selects level of functionality <fun> in the MT. If the syntaxes +CFUN=0, +CFUN=15 or +CFUN=16 (resets) are used, the rest of the command line, placed after that, will be ignored. If the syntaxes +CFUN=0 or +CFUN=15 or +CFUN=16 (resets) are used, the rest of the command line, placed after that, will be ignored. Set AT+CFUN=<fun> AT+CFUN=1 Read AT+CFUN? +CFUN: <power_mode>,<stk_mode> Test AT+CFUN=? +CFUN: (list of supported <fun> s) +CFUN: 1,0 +CFUN: (0,1,6,7,8,15,16) Defined Values <fun> Integer M Selected functionality 0: minimum functionality meaning switch off of the MT 1: full functionality meaning start up MT (from offline mode) 6: enables the SIM-toolkit interface and fetching of proactive commands by SIM-APPL from the SIM-card 7: disables the SIM-toolkit interface and enables fetching of proactive commands by SIM-APPL from the SIM-card 8: disable fetching of proactive commands by SIM-APPL from the SIMcard 15: silent reset (reset MT without resetting the SIM) 16: Reset (reset MT with resetting the SIM) <power_mode> Integer M 1: MT is switched on 2: invalid mode <STK_mode> Integer M 0: inactive state 6: enables the SIM-toolkit interface and fetching of proactive commands by SIM-APPL from the SIM-card 7: disables the SIM-toolkit interface and enables fetching of proactive commands by SIM-APPL from the SIM-card 8: disable fetching of proactive commands by SIM-APPL from the SIMcard GSM.G1-SW B Preliminary Mobile equipment control and status commands Page 28 of 262

29 6.4 Battery charge +CBC Description Returns battery status <bcs> and battery charge level <bcl> of the MT. The charge level <bcl> will be also used to build and display the indicator battchg i.e. battery charge level in the response code +CIND (refer to chapter 6.5) and in the URC +CIEV (refer to chapter 6.6). The following mapping of battchg to <bcl> exists: battchg <bcl> 0 < 17 % 1 < 33 % 2 < 50 % 3 < 67 % 4 < 83 % 5 >= 83 % Action AT+CBC +CBC: <bcs>,<bcl> Test AT+CBC=? +CBC: (list of supported <bcs> s), (list of supported <bcl> s) +CBC: 0,69 +CBC: (0-3),(0-100) Defined Values <bcs> Integer M Battery status <bcl> Integer M Battery charge level 0: MT is powered by the battery 1: MT has a battery connected, but is not powered by it 2: MT does not have a battery connected 3: Recognized power fault, calls inhibited 0: battery is exhausted, or MT does not have a battery connected; : battery has percent remaining. GSM.G1-SW B Preliminary Mobile equipment control and status commands Page 29 of 262

30 6.5 Indicator control +CIND Description Provides the status of the data module about the battery, the network status, SMS, GPRS, etc. The test command returns pairs, where string value <descr> is a maximum 16 character description of the indicator and compound value is the allowed value for the indicator. Because all possible supported parameters of the set syntax can not be overwritten, the setting will be ignored and the MT sends the corresponding final result code to DTE. Set AT+CIND=[<ind>[,<ind>[,...]]] Read AT+ CIND? +CIND: <ind>[,<ind>[,...]] Test AT+ CIND=? +CIND: (list of <descr>s) +CIND: 2,0,0,0,0,0,0,0,0,0,0 +CIND: ("battchg",(0-5)),("signal",(0-5)),("service",(0,1)),("sounder",(0,1)),(" message",(0,1)),("call",(0,1)),("roam",(0,1)),("smsful",(0,1)),("gprs",(0-2)),("callsetup",(0-3)),("callheld",(0-1)) Defined Values <ind> Integer M Integer type value, which shall be in range of corresponding <descr> <descr> String These values are reserved by the norm and their <ind> ranges; it may have the values: battchg : battery charge level (0-5); see also +CBC (refer to chapter 6.4) for details signal : signal quality (0-5); see also +CSQ (chapter 8.2) for details service : service availability (0,1) o 0 means no service o 1 means service available sounder : sounder activity (0,1) o 0 means no sound o 1 means sound available message : message received (0,1) o 0 means no messages o 1 means message(s) received call : call in progress (0,1) o 0 means no call active o 1 means a call is active roam : roaming indicator (0,1); see +CREG (chapter 8.4) for details smsfull : SMS full status (0-1); at receiving of SMS the used memory storage becomes full (1), or memory allocations are available (0) gprs : GPRS registration status (0-2): o 0 means not registered and GPRS network not available; o 1 means GPRS available but not registered; o 2 means GPRS registered callsetup : call setup status indicator destinated for devices usage (not covered by [2]) (0-3); possible values are: GSM.G1-SW B Preliminary Mobile equipment control and status commands Page 30 of 262

31 o 0: not currently in call setup o 1: incoming call process ongoing o 2: outgoing call setup is ongoing o 3: remote party being alerted in an ongoing call callheld : call held indicator destinated for devices (not covered by [2]) (0-2); possible values are: o 0: no calls held o 1: call on hold 6.6 Mobile termination event reporting +CMER Description Enables or disables sending of URCs from MT to DTE in the case of key pressings, display changes and indicator state changes. <mode> parameter controls the processing of URCs specified within this command. Set AT+CMER=[<mode>[,<keyp>[,<disp>[,< ind>[,<bfr>]]]]] AT+CMER=1,0,0,2,1 Read AT+CMER? +CMER: <mode>,<keyp>,<disp>,<ind>,<bfr> Test AT+CMER=? +CMER: (list of supported <mode> s), (list of supported <keyp> s), (list of supported <disp> s), (list of supported <ind> s), ( list of supported <bfr> s) +CMER: 1,0,0,0,1 +CMER: (0-3),(0),(0),(0-2),(0,1) URC +CIEV: <ind>,<value> Defined Values <mode> Integer M 0: buffer URCs in the MT 1: discard URCs when the V.24 interface is reserved for data; otherwise display them on DTE directly 2: buffer URCs in MT when the V.24 interface is reserved and flush them after reservation; otherwise display them on DTE directly 3: forward URCs directly to the DTE <keyp> Integer M 0: no keypad event reporting <disp> Integer M 0: no display event reporting <ind> Integer M 0: no indicator event reporting 1: indicator event reporting using result code +CIEV: <ind>,<value> where <ind> indicates the indicator order number (as specified for +CIND) and <value> is the new value indicator. Only the indicator events which are not caused by +CIND shall be indicated by the MT to the DTE. 2: indicator event reporting using result code +CIEV: <ind>,<value>. All indicator events shall be directed from MT to DTE. <bfr> Integer M 0: MT buffer of URCs defined within this command is cleared when <mode> is entered 1: MT buffer of URCs defined within this command is flushed to the DTE when <mode> is entered ( response shall be given before flushing the codes). GSM.G1-SW B Preliminary Mobile equipment control and status commands Page 31 of 262

32 6.7 Clock +CCLK Description Sets the real-time clock of the MT. Set AT+CCLK=<time> AT+CCLK= 02/07/01,14:54:00+01 Read AT+CCLK? +CCLK:<time> +CCLK: 02/07/01,14:55:00+01 Test AT+CCLK=? Defined Values <time> String Format is yy/mm/dd,hh:mm:ss±tz. Characters indicate year, month, day, hour, minutes, seconds, time zone. "TZ:" The Time Zone information is represented by two digits; the display of TZ for query contains always this information but it is updated only if the automatic time zone update is enabled via AT+CTZU command (before the registration on the network) and the network supports the time zone information. 6.8 Alarm +CALA Description Sets an alarm time in the MT. There can be an array of different types of alarms. If the setting fails, a +CME ERROR: <error> is returned. To set up a recurrent alarm for more days in the week, the <recurr> parameter is used. When an alarm is timed out, the alarm actions are executed: Sound alarm (if not silent); URC +CALV: <n> is displayed on DTE. Set AT+CALA=<time>[,<n>[,<type>[,<text> [,<recurr>[,<silent>]]]]] AT+CALA= 02/07/01,14:56:00+04,1, 1, Alarm Read AT+CALA? [+CALA: <time>,<n1>,<type>,[<text>],[<recurr>],<silent> [+CALA: <time>,<n2>,<type>,[<text>],[<recurr>],<silent> [...]]] +CALA: 02/07/01,14:56:00+04,1,0, Alarm,0 GSM.G1-SW B Preliminary Mobile equipment control and status commands Page 32 of 262

33 Test AT+CALA=? +CALA: (list of supported <n>s),(list of supported <type>s),<tlength>,<rlength>,(list of supported <silent> s) URC +CALA: (1-3),,255,13,(0-1) +CALV: <n> Defined Values <time> String Format is yy/mm/dd,hh:mm:ss±tz. Characters indicate year, month, day, hour, minutes, seconds, time zone. <n>, <n1>, <n2> Integer M indicates the index of the alarm, the allowed ranges are 1-3; if not indicated by user, default value 1 is assumed <type> Type of the alarm; this parameter is ignored. <text> String Indicates the text to be displayed when alarm time is reached; this parameter is ignored <tlength> Integer Indicates the maximum length of <text>; this parameter is ignored <recurr> String Maximum string length is 13, indicates day of week for the alarm in one of the following formats: <1..7>[,<1..7>[ ]]: Sets a recurrent alarm for one or more days in the week. The digits 1 to 7 corresponds to the days in the week, Monday (1),, Sunday (7). Example: The string "1,2,3,4,5" may be used to set an alarm for some weekdays. 0 : Sets a recurrent alarm for all days in the week and all following weeks <rlength> Integer M Indicates the maximum length of <recurr> <silent> Integer M Indicates if the alarm is silent or not 1: the alarm will be silent and the only result from the alarm is the URC +CALV. 0: the alarm will not be silent Switching off module after setting the alarm Alternatively the module can be switched off after setting the alarm, the module switches on as soon as the alarm has expired. The following procedure can be followed: Set the RTC clock by AT command: AT+CCLK= 06/12/29,11:00:00+00 (you can check the time set by AT+CCLK?); Set the RTC alarm by AT command: AT+CALA= 06/12/29,11:01:00+00,1,0,,,0 (you can check the alarm set by AT+CALA?); Switch off the MT with AT+CPWROFF; Output: The MT switches on as soon as the minute is expired and answers +CALV:1. Try to send AT on the hyper terminal, the MT replies properly. If the MT cannot generate an alarm tone, only the text is displayed at alarm time GSM.G1-SW B Preliminary Mobile equipment control and status commands Page 33 of 262

34 6.9 Delete alarm +CALD Description Deletes an alarm in the MT. Set AT+CALD=<n> AT+CALD=0 Test AT+CALD=? +CALD: (list of <n>s) +CALD: (1-3) Defined Values <n> Integer M Indicates the index of the alarm; refer to +CALA description for the allowed range of indexes Restricted SIM access +CRSM Description Allows easy access to the SIM database. Set command transmits to the MT the SIM <command> and its required parameters. MT handles internally all SIM-MT interface locking and file selection routines. As response to the command, MT sends the actual SIM information parameters and response data. MT error result code +CME ERROR may be returned when the command cannot be passed to the SIM, but the failure in the execution of the command in the SIM is reported in <sw1> and <sw2> parameters. Set AT+CRSM=<command>[,<fileid>[,<P1>,<P2>,<P3>[,<data> [,<pathid>]]]] +CRSM: <sw1>,<sw2>[,<response>] AT+CRSM=176,28471,0,0,3 Test AT+CRSM=? GSM.G1-SW B Preliminary Mobile equipment control and status commands Page 34 of 262

35 Defined Values <command> Integer M 176: read binary 178: read record 192: get response 214: update binary 220: update record 242: status <fileid> Integer M Identifies elementary datafile on SIM. Mandatory for every command except STATUS (e.g : meaning IMSI file (6F07)) <P1>, <P2>, <P3> Integer M Defines the request. These parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in [18]. <data> String M Information which shall be written to the SIM (hexadecimal character format; refer to +CSCS (refer to chapter 5.5) string containing hexadecimal characters) <sw1>, <sw2> Integer M Contains SIM information about the execution of the actual command and can be (more details in [18]): 0x90 0x00: normal ending of the command 0x9F 0xXX: length XX of the response data 0x92 0x0X: command successful but after using an internal retry routine X times 0x92 0x40: memory problem 0x94 0x00: no EF selected 0x94 0x02: out of range (invalid address) 0x94 0x04: file ID not found; pattern not found 0x94 0x08: file is inconsistent with the command 0x98 0x02: no CHV initialized 0x98 0x04: access condition not fullfiled / unsucc. CHV verify / authent.failed 0x98 0x08: in contradiction with CHV status 0x98 0x10: in contradiction with invalidation status 0x98 0x40: unsucc. CHV-verif. or UNBLOCK CHV-verif. / CHV blocked /UNBL.blocked 0x98 0x50: increase can not be performed. Max. value reached 0x67 0xXX: incorrect parameter P3 0x6B 0xXX: incorrect parameter P1 or P2 0x6D 0xXX: unknown instruction code given in the command 0x6E 0xXX: wrong instruction class given in the command 0x6F 0xXX: technical problem with no diagnostic given <response> String The response of successful completion of the command previously issued (hexadecimal character format; refer to +CSCS - chapter 5.5). STATUS and GET RESPONSE return data, which gives information about the current elementary datafield. This information includes the type of file and its size (refer [18]). After READ BINARY or READ RECORD command the requested data will be returned. <response> is not returned after a successful UPDATE BINARY or UPDATE RECORD command. GSM.G1-SW B Preliminary Mobile equipment control and status commands Page 35 of 262