Hayes command set

From Wikipedia, the free encyclopedia - View original article

 
Jump to: navigation, search

In computer telecommunication, the Hayes command set is a specific command language originally developed for the Hayes Smartmodem 300 baud modem in 1981. The command set consists of a series of short text strings which combine together to produce complete commands for operations such as dialing, hanging up, and changing the parameters of the connection. The vast majority of dialup modems use the Hayes command set in numerous variations.

The command set covered only those operations supported by the earliest 300 bit/s modems. When new commands were required to control additional functionality in higher speed modems, a variety of one-off standards emerged from each of the major vendors. These continued to share the basic command structure and syntax, but added any number of new commands using some sort of prefix character - & for Hayes and USR, \ for Microcom, for instance. Many of these re-standardized on the Hayes extensions after the introduction of the SupraFAXModem 14400 and the subsequent market consolidation that followed.

History[edit]

Background[edit]

Prior to the introduction of the Bulletin Board System (BBS), modems typically operated on direct-dial telephone lines that always began and ended with a known modem at each end. The modems operated in either "originate" or "answer" modes, manually switching between two sets of frequencies for data transfer. Generally the user placing the call would switch their modem to "originate" and then dial the number by hand. When the remote modem answered, already set to "answer" mode, the telephone handset was switched off and communications continued until the caller manually disconnected.

When automation was required, it was commonly only needed on the answer side - for instance, a bank might need to take calls from a number of branch offices for end-of-day processing. To fill this role, some modems included the ability to pick up the phone automatically when it was in answer mode, clearing the line when the other user manually disconnected. The need for automated outbound dialling was considerably less common, and handled through a separate peripheral device, a "dialler". This was normally plugged into a separate input/output port on the computer (typically an RS-232 port) and programmed separately from the modem itself.

This method of operation worked satisfactorily in the 1960s and early 1970s, when modems were generally used to connect dumb devices like computer terminals (dialling out) with smart mainframe computers (answering). However, the microcomputer revolution of the 1970s led to the introduction of low-cost modems and the idea of a semi-dedicated point-to-point link was no longer appropriate. There were potentially thousands of users who might want to dial any of the other thousands of users, and the only solution at the time was to make the user dial manually.

The computer industry needed a way to tell the modem what number to dial through software. The earlier separate dialers had this capability, but only at the cost of a separate port, which a microcomputer might not have available. Another solution would have been to use a separate set of "command pins" dedicated to sending and receiving commands, another could have used a signal pin indicating that the modem should interpret incoming data as a command. Both of these had hardware support in the RS-232 standard. However, many implementations of the RS-232 port on microcomputers were extremely basic, and some eliminated many of these pins as a cost saving measure.

Hayes' solution[edit]

Hayes Communications introduced a solution in its 1981 Smartmodem by re-using the existing data pins with no modification. Instead, the modem itself could switch itself between one of two modes:

  1. data mode in which the modem sends the data to the remote modem. (A modem in data mode treats everything it receives from the computer as data and sends it across the phone line).
  2. command mode in which data is interpreted as commands to the local modem (commands that the local modem should execute).

To switch from data mode to command mode, sessions sent an escape sequence string of three plus signs ("+++") followed by a pause of about a second. The pause at the end of the escape sequence was required to reduce the problem caused by in-band signaling: if any other data was received within one second of the three plus signs, it was not the escape sequence and would be sent as data. To switch back they sent the online command, O. In actual use many of the commands automatically switched to the online mode after completion, and it is rare for a user to use the online command explicitly.

In order to avoid licensing Hayes's patent, some manufacturers implemented the escape sequence without the time guard interval (TIES). This had a major denial of service security implication in that it would lead to the modem hanging up the connection should the computer ever try to transmit the byte sequence "+++ATH0" in data mode. For any computer connected to the Internet through such a modem, this could be easily exploited by sending it a ping of death request containing the sequence "+++ATH0" in the payload. The computer operating system would automatically try to reply the sender with the same payload, immediately disconnecting itself from the Internet, as the modem would interpret the ICMP packet's data payload as a Hayes command.[1] The same error would also trigger if, for example, the user of the computer ever tried to send an e-mail containing the aforementioned string.

Commands[edit]

The Hayes command set includes commands for various phone-line manipulations, dialing and hanging-up for instance. It also includes various controls to set up the modem, including a set of register commands which allowed the user to directly set the various memory locations in the original Hayes modem. The command set was copied largely verbatim, including the meaning of the registers, by almost all early 300 baud modem manufacturers, of which there were quite a few.

The expansion to 1200 and 2400 baud required the addition of a small set of new commands, some of them prefixed with an ampersand ("&") to denote those dedicated to new functionality. Hayes itself was forced to quickly introduce a 2400 baud model shortly after their 1200, and the command sets were identical as a time-saving method.[2] Essentially by accident, this allowed users of existing 1200 baud modems to use the new Hayes 2400 models without changing their software. This re-inforced the use of the Hayes versions of these commands. Years later, the TIA/EIA raised the 2400-baud command set into a formal standard with the title Data Transmission Systems and Equipment - Serial Asynchronous Automatic Dialing and Control, TIA/EIA-602.

However Hayes Communications moved only slowly to higher speeds or the use of compression, and three other companies led the way here – Microcom, U.S. Robotics and Telebit. Each of these three used its own additional command-sets instead of waiting for Hayes to lead the way. By the early-1990s there were four major command sets in use, and a number of versions based on one of these. Things became simpler again during the widespread introduction of 14.4 and 28.8 kbit/s modems in the early 1990s. Slowly a set of commands based heavily on the original Hayes extended set using "&" commands became popular, and then universal. Only one other command set has remained popular, the US Robotics set from their popular line of modems.

Description[edit]

The following text lists part of the Hayes command set (also called the AT commands: "AT" meaning attention).

The Hayes command set can subdivide into four groups:

  1. basic command set - A capital character followed by a digit. For example, M1.
  2. extended command set - An “&” (ampersand) and a capital character followed by a digit. This extends the basic command set. For example, &M1. Note that M1 is different from &M1.
  3. proprietary command set - Usually starting either with a backslash (“\”) or with a percent sign (“%”); these commands vary widely among modem-manufacturers.
  4. register commands - Sr=n where r is the number of the register to be changed, and n is the new value that is assigned.

A register represents a specific physical location in memory. Modems have small amounts of memory on board. The fourth set of commands serves for entering values into a particular register (memory location). The register will store a particular variable (alpha-numeric information) which the modem and the communications software can utilize. For example, S7=60 instructs the computer to "Set register #7 to the value 60".

Although the command-set syntax defines most commands by a letter-number combination (L0, L1 etc.), the use of a zero is optional. In this example, "L0" equates to a plain "L". Keep this in mind when reading the table below.

When in data-mode an escape sequence can return the modem to command mode. The normal escape sequence is three plus signs ("+++"), and to disambiguate it from possible real data, a guard timer is used: it must be preceded by a pause, not have any pauses between the plus signs, and be followed by a pause; by default a "pause" is one second and "no pause" is anything less.

Syntactical definitions[edit]

The following syntactical definitions apply:[3]

Modem initialization[edit]

A string can contain many Hayes commands placed together, so as to optimally prepare the modem to dial out or answer, e.g. AT&F&D2&C1S0=0X4. This is called the initialization string.[4] The V.250 specification requires all DCEs to accept a body (after "AT") of at least 40 characters of concatenated commands.[5]

Example session[edit]

The following represents two computers, computer A and computer B, both with modems attached, and the user controlling the modems with terminal-emulator software. Terminal-emulator software typically allows the user to send Hayes commands directly to the modem, and to see the responses. In this example, the user of computer A makes the modem dial the phone number of modem B at phone number 555-1234 (long distance). Note that after every command and response, there is a carriage return sent to complete the command.

Modem AModem BComment
ATDT15551234User at modem A issues a dial command: AT-Get the modem's ATtention D-Dial T-Touch-Tone 15551234-Call this number
RINGModem A begins dialing. Modem B's phone-line rings, and the modem reports the fact.
ATAComputer at modem B issues answer command.
CONNECTCONNECTThe modems connect, and both modems report "connect". (In practice, most modems report more information after the word CONNECT — specifying the speed of the connection.) Also, at this time, both modems will raise the DCD, or Data Carrier Detect signal, on the serial port.
abcdefabcdefWhen the modems are connected, any characters typed at either side will appear on the other side. The person at computer A starts typing. The characters pass through the modem and appear on computer B's screen. (User A may not see his own typed characters — depending on the terminal software's local echo setting).
+++The person at computer B issues the modem escape command. (Alternately, and more commonly, the computer B could drop the DTR, or Data Terminal Ready signal, to achieve a hangup, without needing to use +++ or ATH.)
OKThe modem acknowledges it.
ATHThe person at computer B issues a hang up command.
NO CARRIEROKBoth modems report that the connection has ended. Modem B responds "OK" as the expected result of the command; modem A says NO CARRIER to report that the remote side interrupted the connection. The modems on both sides drop their DCD signals as well.

Compatibility[edit]

While the original Hayes command set represented a huge leap forward in modem-based communications, with time many problems set in, almost none of them due to Hayes per se:

For example, setting up hardware or software handshaking often required many different commands for different modems. This undermined the handy universality of the basic "AT" command-set.

As a result of all this, eventually many communications programs had to give up any sense of being able to talk to all "Hayes-compatible" modems, and instead the programs had to try to determine the modem type from its responses, or provide the user with some option whereby they could enter whatever special commands it took to coerce their particular modem into acting properly.

The basic Hayes command set[edit]

The following commands are understood by virtually all modems supporting an AT command set, whether old or new.

CommandDescriptionComments
A0 or AAnswer incoming call 
A/Repeat last commandDon't preface with AT, don't follow with carriage return. Enter usually aborts.
DDial

Dial the following number and then handshake

P - Pulse Dial
T - Touch Tone Dial
W - Wait for the second dial tone
R - Reverse to answer-mode after dialing
@ - Wait for up to 30 seconds for one or more ringbacks
, - Pause for the time specified in register S8 (usually 2 seconds)
; - Remain in command mode after dialing.
! - Flash switch-hook (Hang up for a half second, as in transferring a call.)
L - Dial last number

E0 or ENo EchoWill not echo commands to the computer
E1EchoWill echo commands to the computer (so one can see what one types)
H0Hook StatusOn hook. Hangs up the phone, ending any call in progress.
H1Hook statusOff hook. Picks up the phone line (typically you'll hear a dialtone)
I0 to I9Inquiry, Information, or InterrogationThis command returns information about the model, such as its firmware or brand name. Each number (0 to 9, and sometimes 10 and above) returns one line of modem-specific information, or the word ERROR if the line isn't defined. Today, Windows uses this for Plug-and-play detection of specific modem types.
L0 or Ln (n=1 to 3)Speaker Loudness. Supported only by some modems, usually external ones. Modems lacking speakers, or with physical volume controls, or ones whose sound output is piped through the sound card will not support this command.Off or low volume
M0 or MSpeaker off, completely silent during dialingM3 is also common, but different on many brands
M1Speaker on until remote carrier detected (i.e. until the other modem is heard)
M2Speaker always on (data sounds are heard after CONNECT)
OReturn OnlineReturns the modem back to the normal connected state after being interrupted by the "+++" escape code.
Q0 or QQuiet ModeOff - Displays result codes, user sees command responses (e.g. OK)
Q1Quiet ModeOn - Result codes are suppressed, user does not see responses.
SnSelect current register

Note that Sn, ? and =r are actually three separate commands, and can be given in separate AT commands.

Select register n as the current register
Sn?Select register n as the current register, and query its value. Using ? on its own will query whichever register was most recently selected.
Sn=rSelect register n as the current register, and store r in it. Using =r on its own will store into whichever register was most recently selected.
V0 or VVerboseNumeric result codes
V1English result codes (e.g. CONNECT, BUSY, NO CARRIER etc.)
X0 or XSmartmodemHayes Smartmodem 300 compatible result codes
X1Usually adds connection speed to basic result codes (e.g. CONNECT 1200)
X2Usually adds dial tone detection (preventing blind dial, and sometimes preventing ATO)
X3Usually adds busy signal detection.
X4Usually adds both busy signal and dial tone detection
Z0 or ZResetReset modem to stored configuration. Use Z0, Z1etc. for multiple profiles. This is the same as &F for factory default on modems without NVRAM (non volatile memory)

Note: a command string is terminated with a CR (\r) character

Modem S register definitions[edit]

RegisterDescriptionRangeDefault value
S0Number of rings before Auto-Answer0–0 never0
S1Ring Counter0–255 rings0
S2Escape character0–255, ASCII decimal43 ("+")
S3Carriage Return Character0–127, ASCII decimal13 (Carriage Return)
S4Line Feed Character0–127, ASCII decimal10 (Line Feed)
S5Backspace Character0–32, ASCII decimal8 (Backspace)
S6Wait Time before Blind Dialing2–255 seconds2
S7Wait for Carrier after Dial1–255 seconds50
S8Pause Time for Comma (Dial Delay)0–255 seconds2
S9Carrier Detect Response Time1–255 tenths of a seconds6 (0.6 second)
S10Delay between Loss of Carrier and Hang-Up1–255 tenths of a second14 (1.4 seconds)
S11DTMF Tone Duration50–255 milliseconds95 milliseconds
S12Escape Code Guard Time0–255 fiftieths of a second50 (1 second)
S18Test Timer0–255 seconds0 seconds
S25Delay to DTR0–255 (seconds if synchronous mode, hundredths of a second in all other modes)5
S26RTS to CTS Delay Interval0–255 hundredths of a second1 hundredth of a second
S30Inactivity Disconnect Timer0–255 tens of seconds0 (disable)
S37Desired Telco Line Speed0–10

Command options:

  • 0 Attempt auto mode connection
  • 1 Attempt to connect at 300 bit/s
  • 2 Attempt to connect at 300 bit/s
  • 3 Attempt to connect at 300 bit/s
  • 5 Attempt to connect at 1200 bit/s
  • 6 Attempt to connect at 2400 bit/s
  • 7 Attempt to connect in V.23 75/1200 mode.
  • 8 Attempt to connect at 9600 bit/s
  • 9 Attempt to connect at 12000 bit/s
  • 10 Attempt to connect at 14400 bit/s
0
S38Delay before Force Disconnect0–255 seconds20 seconds

V.250[edit]

The ITU-T established a standard in its V-Series Recommendations, V.25 ter, in 1995 in an attempt to establish a standard for the command set again. It was renamed V.250 in 1998 with an annex that was not concerning the Hayes command set renamed as V.251. A V.250 compliant modem implements the A, D, E, H, I, L, M, N, O, P, Q, T, V, X, Z, &C, &D, and &F commands in the way specified by the standard. It must also implement S registers and must use registers S0, S3, S4, S5, S6, S7, S8, and S10 for the purposes given in the standard. Lastly it also must implement any command beginning with the plus sign, "+" followed by any letter A to Z, only in accordance with ITU recommendations. Modem manufacturers are free to implement other commands and S-registers as they see fit, and may add options to standard commands.

V.250 – Defined leading character sequences
Leading
characters
Includes commands related to
+ACall control (network Addressing) issues, common, PSTN, ISDN, ITU-T Rec. X.25, switched digital
+CDigital Cellular extensions
+DData Compression, ITU-T Rec. V.42 bis
+EError Control, ITU-T Rec. V.42
+FFacsimile, ITU-T Rec. T.30, etc.
+GGeneric issues such as identity and capabilities
+IDTE-DCE Interface issues, ITU-T Rec. V.24, etc.
+MModulation, ITU-T Rec. V.32 bis, etc.
+PPCM DCE commands, ITU-T Rec. V.92
+SSwitched or Simultaneous Data Types
+TTest issues
+VVoice extensions
+WWireless extensions

GSM[edit]

The ETSI GSM 07.07 (3GPP TS 27.007) specifies AT style commands for controlling a GSM phone or modem. The ETSI GSM 07.05 (3GPP TS 27.005) specifies AT style commands for managing the SMS feature of GSM.

Examples of GSM commands:[6][7]

CommandDescription
AT+CPIN=1234Enter PIN code
AT+CPWD="SC","old","new"Change PIN code from 'old' to 'new'
AT+CLCK="SC",0,"1234"Remove PIN code
AT&VStatus
ATIStatus (Manufacturer, Model, Revision, IMEI, capabilities)
AT+COPS=?List available networks 0-Unknown/2-Current/3-Forbidden, Longname, Shortname, Numerical-ID, "AcT"
AT+CSQGet signal strength. Answer: +CSQ: <rssi (more=better)>, <ber, less=better>
ATD*99#Dial access point
AT+CGDCONT=1,"IP","access.point.name"Defines PDP context[6]

GSM/3G modems typically support the ETSI GSM 07.07/3GPP TS 27.007 AT command set extensions, although how many commands are implemented varies.

Most USB modem vendors, such as Huawei, Sierra Wireless, Option, have also defined proprietary extensions for radio mode selection (GSM/3G preference) or similar. Some recent high speed modems provide a virtual Ethernet interface instead of using a PPP connection for the data connection because of performance reasons (PPP connection is only used between the computer and the modem, not over network). The set-up requires vendor-specific AT command extensions. Sometimes the specifications for these extensions are openly available, other times the vendor requires an NDA for access to these.[8]

Voice command set[edit]

Modems with voice or answering-machine capabilities support a superset of these commands to enable digital audio playback and recording.

See also[edit]

Notes and references[edit]

  1. ^ Max, Schau (27 September 1998). "1+2=3, +++ATH0=Old school DoS". Bugtraq mailing list. Retrieved 8 December 2012. 
  2. ^ Frank Durda IV, "The AT Command Set Reference - History", 1993
  3. ^ AT Commands Reference Guide (dead)
  4. ^ Initialization Strings: Why, What & Where
  5. ^ "5.2.1 Command line general format" (PDF), V.250 : Serial asynchronous automatic dialling and control (05/99, 07/03), ITU-T/Telecommunication Standardization Bureau 
  6. ^ a b "Developers guidelines June 2010 AT commands for Sony Ericsson phones".  090505 developer.sonyericsson.com
  7. ^ "UC864-E Software User Guide".  090505 m2m-platforms.com
  8. ^ "Dan Williams’ blog - That’s when I reach for my revolver…". 

External links[edit]