Hayes command set

Most dialup modems follow the Hayes Command Set to a large extent. The modem initialization string consists of a series of commands. It prepares the modem for communications, setting such features as dialing mode, waits, detection of the busy signal and many other settings. Newer modem communications programs reset the initializations string for you according to which menu options selected or which features are enabled.

Table of contents 1 History 2 Description 1 The Basic Hayes Command Set 2 External Link

History

Prior to the introduction of the Bulletin board system, modems were typically used on dedicated point-to-point telephone lines that were always connected to a modem at the far end. In the situations where this was not the case, the user would dial the phone manually before connecting, or pick it up if it rang. In a few cases the computers themselves were required to call a selection of numbers, and for this task a separate "dialer" was used, plugged into a different input/output port on the computer (typically an RS-232).

When Dennis Hayes was creating his first "smart modem" in 1977, he faced a problem that no previous modem manufacturer had: how to tell the modem what phone number to dial, using only one port. One solution would be to use a separate set of "command pins" that would be dedicated to sending and receiving commands. Another would be to use a signal pin that indicated that data on the main data lines should be interpreted as a command.

Instead, in order to save money, Hayes chose to re-use the existing data pins with no modification. The modem could be placed in one of two modes, data mode in which the modem sent the data to the remote modem, and command mode in which the data was interpreted as commands to the local modem. To switch from data to command mode an escape sequence string of three plus signs was sent, and to switch back you 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.

This use of in-band signalling[?] leads to a potential serious problem: what if the data being sent in data mode contains three plus signs? This could happen randomly quite easily, and it would happen any time someone attempted to send data describing the system – this document for instance. In order to avoid this problem a delay was added to the end of the escape sequence, 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-is.

The command set includes commands for various phone-line manipulations, dialing and hanging up for instance. It also includes various controls to setup 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 a & to denote those dedicated to new functionality. However Hayes was slow to move to higher speeds or the use of compression, and three other companies led the way here – Microcomm[?], U.S. Robotics and Telebit[?]. All three used their own additional command sets instead of waiting for Hayes to lead the way.

Soon there was an explosion of new models, including new ones from Hayes, following one sort of standard or another. Things became simpler again during the widespread introduction of 14.4 and 28.8 kbaud modems in the early 1990s. Slowly a set of command based heavily on the original Hayes extended set using & commands became popular, and then universal. The only other command set still popular is the US Robotics set, due to their widespread popularity.

The command set was unprotected, but the concept of a "guard time" after the escape sequence was patented. In the late 1980s Hayes started enforcing the patent, charging $1 per modem that used it.

Description

The following is a partial list of the Hayes command set. (also called the AT commands, AT is short for attention).

The Hayes Command Set can be divided into four groups:

• Basic Command Set - A capital character followed by a digit. For example, M1.
• Extended Command Set - An “&” (ampersand) and a capital character followed by a digit. This is an extension of the basic command set. For example, &M1. Note that M1 is different from &M1.
• Proprietary Command Set - Usually started by either a backslash (“\”), or a percent sign (“%”), these commands vary widely among modem manufacturers.
• 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 is a specific physical location in memory. Modems have small amounts of memory onboard. This fourth set of commands is used to enter values in a particular register (memory location). The register will be storing a particular variable (alpha-numeric information) which is utilized by the modem and communication software. For example, S7=60 instructs your computer to “Set register #7 to the value 60”.

Although most commands are defined by a letter-number combination (L0, L1 etc.), the user of a zero is optional. In this example, L0 is the same as a plain L. Keep this in mind when reading the table below.

Here are some of the most important characters that may appear in the modem initialization string. These characers normally should not be changed.

• AT - Tells the modem that modem commands follow. This must begin each line of commands.
• Z - Resets the modem to it's default state.
• , (a comma) - Makes the software pause for a second. More than one can be used in a row. For example, ,,,, tells the software to pause four seconds. (The duration of the pause is governed by the setting of register S8.
• ^M - Sends the terminating Carriage Return character to the modem. This is a control code[?] that most communication software translates as a Carriage Return[?].

When in data mode the escape sequence "+++" is used to return the modem to command mode.

The Basic Hayes Command Set

Command	Description	Comments
A0 or A	Answer incoming call
A/	Repeat last command	Don't preface with AT. Enter usually aborts.
B0 or B	Call negotiation	V32 Mode/CCITT Answer Seq.
B1	Call negotiation	Bell 212A Answer Seq.
B2	Call negotiation	Verbose/Quiet On Answer
D	Dial	Dial the following number and then handshake in orginate mode. P - Pulse Dial T - Touch Tone Dial W - Wait for the second dial tone , - 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 E	No Echo	Will not echo commands to the computer
E1	Echo	Will echo commands to the computer (so one can see what one types)
H0	Hook Status	On hook - Hang up
H1	Hook status	Off hook - phone picked up
I0 or I	Inquiry, Information, or Interrogation	This command is very model specific. I0 usually returns a number or code, while higher numbers often provide much more useful information.
L0 or L	Speaker Loudness. Modems with volume control knobs will not have these options.	Off or low volume
L1		Low Volume
L2		Medium Volume
L3		Loud or High Volume
M0 or M	Speaker off	M3 is also common, but different on many brands
M1		Speaker on until remote carrier detected (i.e. until the other modem is heard)
M2		Speaker is always on (data sounds are heard after CONNECT)
N0 or N	Handshake Speed	Handshake only at speed in S37
N1		Handshake at highest speed larger than S37
O0 or O	Return Online	See also X1 as dial tone detection may be active.
O1		Return Online after an equalizer retrain sequence
Q0 or Q1	Quiet Mode	Off - Displays result codes, user sees command responses (e.g. OK)
Q1	Quiet Mode	On - Result codes are suppressed, user does not see responses.
Sn?		Query the contents of S-register n
Sn=r	Store	Store the value of r in S-register n
V0 or V	Verbose	Numeric result codes
V1		English result codes (e.g. CONNECT, BUSY, NO CARRIER etc.)
X0 or X	Smartmodem	Hayes Smartmodem 300 compatible result codes
X1		Usually adds connection speed to basic result codes (e.g. CONNECT 1200)
X2		Usually adds dial tone detection (preventing blind dial, and sometimes preventing AT0)
X3		Usually adds busy signal detection
X4		Usually adds both busy signal and dial tone detection
Z0 or Z	Reset	Reset modem to stored configuration. Use Z0, Z1etc. for multiple profiles. This is the same as &F for factory default on modems without NVRAM (non voltaile memory)

External Link

• http://docs.kde.org/en/3.1/kdenetwork/kppp/appendix-hayes-commands