GDW-11 Westermo Teleindustri AB Teleindustri • Westermo 2007 ©
Total Page:16
File Type:pdf, Size:1020Kb
AT Commands Interface Guide 6615-2220 GDW-11 Westermo Teleindustri AB Teleindustri • Westermo 2007 © GDW-11 GSM/GPRS Modem GDW-11 485 GSM/GPRS Modem with RS-485 www.westermo.com Introduction This document describes the AT-commands that can be used to configure and control the GDW-1x modem. AT Commands Network message Network Responses The GDW-1x different operating modes are controlled by AT-commands. Modem operation modes: 1 Operating Online Mode Mode 2 3 5 4 Online Command Mode Example of commands/events that can trigger a change of the modems operation modes 1 – ATD command 2 – Hangup from the remote end 3 – Escape sequence +++ 4 – ATO command 5 – ATH command For more information about Westermo, please visit out website www.westermo.com 2 Introduction 6615-2220 Abbreviations and definitions Abbreviations ASCII American Standard Code for Information Interchange AT ATtention; this two-character abbreviation is always used to start a command line to be sent from TE to Modem BCD Binary Coded Decimal ETSI European Telecommunications Standards Institute IMEI International Mobile station Equipment Identity IRA International Reference Alphabet (ITU-T T.50 [13]) ISO International Standards Organisation ITU-T International Telecommunication Union – Telecommunications Standardization Sector ME Mobile Equipment, e.g. a GSM phone (equal to MS; Mobile Station) MOC / MTC A call from a GSM mobile station to the PSTN is called a “Mobile Originated Call” (MOC) or “outgoing call”, and a call from a fixed network to a GSM mobile station is called a “Mobile Terminated Call” (MTC) or “incoming call”. MoU Memorandum of Understanding (GSM operator joint) MS The words “Mobile Station” (MS) or “Mobile Equipment” (ME) are used for mobile terminals supporting GSM services. RLP Radio Link Protocol SIM Subscriber Identity Module TA T erminal Adaptor, e.g. a GSM data card (equal to DCE; Data Circuit terminating Equipment) TE T erminal Equipment, e.g. a computer (equal to DTE; Data Terminal Equipment) Terminal Equipment is the Man-Machine Interface of a GSM device (modem or handset). A TE can be a handset MMI or the AT command line interface. TIA Telecommunications Industry Association Definitions <CR> Carriage return character, which value is specified with command S3. <LF> Linefeed character, which value is specified with command S4. <...> Name enclosed in angle brackets is a syntactical element. Brackets themselves do not appear in the command line. [...] Optional subparameter of a command or an optional part of ME information response is enclosed in square brackets. Brackets themselves do not appear in the command line. When subparameter is not given in parameter type commands, new value equals to its previous value. In action type commands, action should be done on the basis of the recommended default setting of the subparameter underline Underlined defined subparameter value is the recommended default setting of this subparameter. In parameter type commands, this value should be used in factory settings that are configured by V.25ter command &F0. In action type commands, this value should be used when subparameter is not given. 6615-2220 Abbreviations and definitions 3 AT command syntax Command line All commands always start with AT (ATtention) and are terminated with <CR>. There are 3 exceptions to this rule: … The A/ command is not terminated with <CR>. … Some commands where input text is the final parameter to the command is terminated with character (ASCII 26 or <ctrl+z>). One example of such command is AT+CMGS. … The command to switch from “on-line mode” to “online command mode” is +++ and this command is not terminated with <CR> There are 3 different types of commands that differ slightly in command format and the command response: … Standardized basic commands … Register commands. … Extended commands. The basic commands are commands not preceded by a ‘+’ character. Most of the basic commands originate in the V.25ter [TBD] standard. Action Command Example Set/Execute CMD[x] AT&D2, AT&W, ATD The register commands is a set of S-registers that contain parameter values needed by the modem in different modes. Syntax: ATSx=<value> Test command: ATSx? Possible values: ATSx=? The S-registers are saved by the AT&W command and Refer to section “S-registers” for more information. Every extended command has a test command (trailing =?) to test the existence of the command and to give information about the type of its subparameters. Parameter type commands also have a read command (trailing ?) to check the current values of subparameters. Action type commands do not store the values of any of their possible subparameters, and therefore do not have a read command. read command for checking current subparameter values subparameter extended commands are command line command line prefix delimited with semicolon termination character ATCMD1 CMD2=12; +CMD1; +CMD2=,,15; +CMD2?; +CMD2=?<CR> subparameters basic command may be omitted Figure 1: Basic structure of (no + prefix) extended command (prefixed with +) test command for checking a command line possible subparameter values 4 AT command syntax 6615-2220 If verbose responses are enabled with command V1 and all commands in a command line has been performed successfully, result code <CR><LF>OK<CR><LF> is sent from the TA to the TE. If numeric responses are enabled with command V0, result code 0<CR> is sent instead. If verbose responses are enabled with command V1 and subparameter values of a com- mand 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 to the TE and no subsequent commands in the command line are processed. If numeric responses are enabled with command V0, result code 4<CR> is sent instead. ERROR (or 4) response may be replaced by +CME ERROR: <err> see appendix when com- mand was not processed due to an error related to ME operation. Responses and result codes Responses start and end with <CR><LF> (except for the ATV0 DCE response format) and the ATQ1 (result code suppression) commands. … If command syntax is incorrect, the “ERROR” string is returned. … If command syntax is correct but transmitted with wrong parameters, the +CME ERROR: <Err> or +CMS ERROR: <SmsErr> strings is returned with adequate error codes if CMEE was previously set to 1. By default, CMEE is set to 0, and the error message is only “ERROR”. … If the command line has been executed successfully, an “OK” string is returned. The TA response for the example command line of figure 1 could be as shown in figure 2. Here, verbose response format is enabled with command V1. If numeric format V0 would have been used, <CR><LF> headers of information responses would have been left out and final result code changed to 0<CR>. also string type subparameters possible information response to +CMD2=? information response to +CMD2? <CR><LF>+CMD2: 3,0,15,"GSM"<CR><LF> <CR><LF>+CMD2: (0-3),(0,1),(0-12,15),("GSM","IRA")<CR><LF> <CR><LF>OK<CR><LF> Figure 2: Response to a shows acceptable ranges of each subparameter command line final result code So called intermediate result codes inform about progress of TA operation (e.g. connec- tion establishment CONNECT), and so called unsolicited result codes indicate occur- rence of an event not directly associated with issuance of a command from TE (e.g. ring indication RING). In some cases, such as “AT+CPIN?” or (unsolicited) incoming events, the product does not return the “OK” string as a response. In the following examples <CR> and <CR><LF> are intentionally omitted. 6615-2220 AT command syntax 5 General commands +CGMI – Manufacturer identification Description: This command gives the manufacturer identification. Syntax: AT+CGMI Parameters: No parameters Command example Possible responses Note AT+CGMI WESTERMO MODEM Modem manufacturer OK +CGMM – Request model identification Description: This command is used to get the supported frequency bands. With multi-band products the response may be a combination of different bands. Syntax: AT+CGMM Parameters: No parameters Command example Possible responses Note AT+CGMM MULTIBAND 900E 1800 Support of 900 and 1800 MHz OK AT+CGMM MULTIBAND G850 1900 Support of 850 and 1900 MHz OK 6 General commands 6615-2220 +CGMR – Request revision identification Description: This command is used to get the software version. Syntax: AT+CGMR Parameters: No parameters Command example Possible responses Note AT+CGMR 641_09gg.Q2406B 1328940 ... Software release 6.41 +CGSN – Product Serial Number Description: This command allows the user application to get the IMEI (International Mobile Equipment Identity) of the product. Syntax: AT+CGSN Parameters: No parameters Command example Possible responses Note AT+CGSN 135790248939000 IMEI read from modem OK 6615-2220 General commands 7 +CSCS – Select TE character set Description: This command informs the ME which character set is used by the TE. The ME can con- vert each character of entered or displayed strings. This is used to send, read or write short messages. See also +WPCS for the phonebooks’ character sets. Syntax: AT+CSCS=<Character Set> Parameters: <Character Set> “GSM” GSM default alphabet. “PCCP437” PC character set code page 437. “CUSTOM” User defined character set (see also. +WCCS command). “HEX” Hexadecimal mode. No character set used ; the user can read or write hexadecimal values. Command example Possible responses Note AT+CSCS=”GSM” OK Command valid AT+CSCS=”PCCP437” OK Command valid AT+CSCS=? +CSCS:("GSM”,“PCCP437”, Possible values “CUSTOM”,“HEX”) OK 8 General commands 6615-2220 +WPCS – Phonebook Character Set Description: This specific command informs the ME which character set is used by the TE for the phonebooks. The ME can convert each character of entered or displayed strings. This is used to read or write phonebook entries (parameters <text>, <address> and <mail>) and <description> parameter of agenda entries.