Downloads |
Table Of Contents
Supported Standards, MIBs, and RFCs
Configuring the Telephone Number for the Cisco Modem User Interface Connection
Configuring a Line for the Cisco Modem User Interface
Entering Cisco Modem User Interface Mode from EXEC Mode
Configuring Banners for the Hayes Information Mode Command
Verifying Cisco Modem User Interface Mode
Verifying the Cisco Modem User Interface Telephone-to-IP-Address Map
Monitoring and Maintaining the Cisco Modem User Interface
Automatic Connection Configuration Example
Asynchronous Tunnel Termination Configuration Example
Banner Setup and Display Example
Cisco Modem User Interface
Feature History
This document describes the Cisco Modem User Interface feature in Cisco IOS Release 12.2(4)T. It includes the following sections:
•
Supported Standards, MIBs, and RFCs
•
Feature Overview
The Cisco Modem User Interface feature enables Cisco routers to behave like a modem and be configured using standard Hayes modem commands.
Figure 1 shows a legacy data transfer configuration using X.25, modems, and telephone lines.
Figure 1 Legacy Data Transfer Equipment
With the Cisco Modem User Interface feature, a point of sale (POS) terminal, such as those used by gasoline service stations to charge customers for merchandise and services, can use high-speed Internet connections rather than slow-speed telephone connections to transfer data (see Figure 2).
Figure 2 Data Transfers Using the Cisco Modem User Interface
The user interface to the higher speed connection will not change when the Cisco Modem User Interface feature is used; the user interface will still appear as if the connection on the POS terminal is through a modem and a telephone line.
Although there are a wide variety of proprietary extensions to the Hayes modem commands, the Cisco Modem User Interface feature supports only a subset of the commands. This basic functionality is enhanced with Cisco-specific modem register settings, Telnet connection capability, and dial-related Cisco IOS commands.
Benefits
The Cisco Modem User Interface feature allows Cisco routers to replace modems, and thereby update a slow telephone call-modem negotiation process with a high-speed Internet connection. Together, these features provide the following benefits:
•
•
Restrictions
The following Hayes modem features are not supported by the Cisco Modem User Interface:
•
•
•
•
•
Supported Platforms
•
•
•
Platform Support Through Feature Navigator
Cisco IOS software is packaged in feature sets that support specific platforms. To get updated information regarding platform support for this feature, access Feature Navigator. Feature Navigator dynamically updates the list of supported platforms as new platform support is added for the feature.
Feature Navigator is a web-based tool that enables you to quickly determine which Cisco IOS software images support a specific set of features and which features are supported in a specific Cisco IOS image.
To access Feature Navigator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions at http://www.cisco.com/register.
Feature Navigator is updated when major Cisco IOS software releases and technology releases occur. As of May 2001, Feature Navigator supports M, T, E, S, and ST releases. You can access Feature Navigator at the following URL:
http://www.cisco.com/go/fn
Supported Standards, MIBs, and RFCs
Standards
None
MIBs
None
To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB website on Cisco.com at the following URL:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
RFCs
None
Configuration Tasks
See the following sections for the configuration tasks for the Cisco Modem User Interface feature. Each task in the list is identified as either required or optional:
•
•
•
•
Configuring the Telephone Number for the Cisco Modem User Interface Connection
To configure the telephone number for the Cisco Modem User Interface feature, you must map the telephone number to the IP host where the connection will be made. To do so, use the following command in global configuration mode:
Router(config)# ip host tmodem-telephone-number address
Maps a modem telephone number to an IP host address for use in Cisco Modem User Interface mode.
Configuring a Line for the Cisco Modem User Interface
To configure a line for the Cisco Modem User Interface feature, use the following commands beginning in global configuration mode. (Notice that the modemui EXEC command is entered as part of the autocommand command.)
Step 1
Router(config)# line aux 0
Selects the line to configure for the Cisco Modem User Interface feature and enters line configuration mode.
Step 2
Router(config-line)# stopbits bits
Sets the number of stop bits sent per byte.
Step 3
Router(config-line)# speed rate
Sets the asynchronous line bit rate.
Step 4
Router(config-line)# flowcontrol type
Sets line flow control.
Step 5
Router(config-line)# modem dialin delay
(Optional) Delays assertion of the data terminal ready (DTR) signal until a connection is established.
Step 6
Router(config-line)# autocommand modemui [modem-commands]
(Optional) Automatically executes the modemui EXEC command when a user connects to the line. See Table 1 for the modem commands that are entered with the modemui command.
Example configurations in the section "Configuration Examples" list additional commands that might also be entered for line configuration.
Entering Cisco Modem User Interface Mode from EXEC Mode
To enter the Cisco modem user interface from EXEC mode, use the following command in EXEC mode:
Router# modemui [modem-commands]
Enters Cisco modem user interface mode and establishes an environment where you can enter the Hayes modem commands listed in Table 1.
You can also add EXEC commands to the Cisco IOS autocommand line configuration command. This type of configuration allows the modemui EXEC command to be automatically executed; see the section "Configuring a Line for the Cisco Modem User Interface" for the relevant task.
Configuring Banners for the Hayes Information Mode Command
To configure banners that are displayed in response to the Hayes information mode command, use the following command in global configuration mode:
Router(config)# modemui-version delimiter banner-text delimiter
Sets the the display for the Hayes information mode command (ATIn).
Table 1 lists and describes the Hayes-compatible modem commands, including ATIn.
Table 1 Cisco-Supported Hayes Modem Commands
AT
Attention command. Enters modem command execution mode. You can add any of the command settings listed in this table to the AT command.
DTstring
DPstring
Dials outbound tone (T) or pulse (P) call. The string following the T or P character is used as an argument to the Cisco IOS connect EXEC command.
Before dialing, you must set up an appropriate IP host using the Cisco IOS ip host global configuration command. For example:
ip host t555-1212 4023 10.0.0.51Valid characters for string are the same as the characters that are used in a host name for the Cisco IOS connect command, as follows:
•
•
•
•
No other characters (such as # or *) are accepted in the dial string, and unsupported characters are stripped before dialing occurs.
En
Echo mode. Values for n follow:
•
•
Hn
Hangup mode. A value of 0 or 1 closes the connection.
In
Information mode. The information displayed is set in a banner configured with the Cisco IOS MODEMUI-VERSION global configuration command; see the section "Configuring Banners for the Hayes Information Mode Command." Acceptable values for n are the numbers 0 through 6.
On
Online mode. A value of 0 or 1 resumes the connection.
Qn
Quiet mode. Values for n follow:
•
•
Sn=v
Set selected register (S-register).
Note
Choose one of the following S-registers for n:
•
If the value (v) for S201 is 0 (default), parity for both the command and data portions of a call are controlled by the Cisco IOS parity and databits line configuration commands.
If the value (v) for S201 is 1, mark or space parity for the command session will be taken from the Hayes AT part of the command, while the data portion will be 8-bit transparent.
•
This setting allows mark parity to be unconditionally implemented for the command characters. The default value for S202 is 0 (no parity). The value 128 causes command characters to be sent with mark parity.
•
Allows a delay to be added to the time between when the ATD command is executed and when the call success or failure code is displayed. This delay is sometimes required because a Telnet connection is established more quickly than placing a telephone call. The value for S203 can be a number from 0 to 255. The actual value applied to the connect delay is 10 percent of the number entered for v. For example, a value of 300 sets a connect delay of 30 seconds. The default value is 0.
•
Allows the result code for a successful connection to be specified. The default is code 1 for the unextended mode, but you can configure one of the following numbers to display a selected line speed. For example, connection code 10 selects CONNECT 2400. By allowing the code to be expressed explicitly, you can allow for a "CONNECT 2400" response message to be displayed, regardless of the actual line speed.
The default for v is 0, or choose one of the following connection codes:
–
–
–
–
–
–
–
–
Sn?
S-register query. The value for n is the number of the S-register to query (S201 through S204, see the preceding list).
Vn
Result code format. Values for n follow:
•
•
Xn
Extended result codes. The value for n is any nonzero number, which appends /NONE to the connect message. Also see the preceding description for S-register S204, for changing the reported connection speed.
Z
Z99
Reset to default configuration. Choose one of the following reset options:
•
•
Verifying Cisco Modem User Interface Mode
To verify correct operation of the Cisco Modem User Interface feature, perform the following steps in EXEC mode:
Step 1
Router# modemuiStep 2
ATOKStep 3
ATDT4085551212CONNECTUser Access VerificationUsername:Step 4
Step 5
ATZ99Router#
Verifying the Cisco Modem User Interface Telephone-to-IP-Address Map
To verify correct mapping between the modem telephone number and the IP host, enter the show host command in EXEC mode to display the telephone number associated with the IP host. This command also displays default domain name, the style of name lookup service, a list of name server hosts, and the cached list of host names and addresses.
Router# show hostDefault domain is not setName/address lookup uses domain serviceName servers are 255.255.255.255Codes: u - unknown, e - expired, * - OK, ? - revalidatet - temporary, p - permanentHost Age Type Address(es)*p p4085554567 0 IP 1.2.1.6*p t4085551234 0 IP 1.2.1.5Under the Host field, a "p" indicates a pulse-dialed modem telephone number, and a "t" indicates a tone-dialed modem telephone number. The IP address mapped to the telephone number appears under the "Address(es)" field.
Troubleshooting Tips
To troubleshoot operation of the Cisco Modem User Interface feature, use the debug modem privileged EXEC command to start modem and EXEC debugging mode.
Monitoring and Maintaining the Cisco Modem User Interface
To monitor and maintain the Cisco Modem User Interface feature, use the following commands in EXEC mode, as needed:
Configuration Examples
This section provides the following configuration examples:
•
•
•
Automatic Connection Configuration Example
The following example shows how to configure the Cisco Modem User Interface shown in Figure 3.
Figure 3 Cisco Modem User Interface Configuration
Both the client and host router must have the Cisco Modem User Interface feature loaded for the configurations to work. Configuration settings on the routers provide an environment that spoofs or emulates the Hayes modem interface, yet allows connection to the host using a high-speed Internet connection instead of the slow-speed telephone connections shown in Figure 1. The configuration in this example includes a 2-second delay between when the dial number command is executed and when the call success or failure code is displayed (see the autocommand modemui ats203=20 command in the following "Client Router Configuration" output).
Client Router Configuration
ip host t4155551234 192.168.33.15!line 35login authentication modemmodem dialin delaystopbits 1speed 2400flowcontrol hardwaretransport input noneautocommand modemui ats203=20Host Router Configuration
aaa new-modelaaa authentication login modem none!ip host t4085551234 1.2.1.5!interface async 129ip address 1.2.1.5 255.255.255.0encapsulation pppasync dynamic addressasync dynamic routingasync mode dedicatedpulse-time 3Asynchronous Tunnel Termination Configuration Example
The following example shows a configuration where a destination host router terminates an asynchronous tunnel from the client router. The connection to the final destination is also an asynchronous connection (see Figure 4).
Figure 4 Asynchronous Tunnel Configuration
Note that in this configuration the host router does not use the modemui EXEC command.
Client Router Configuration
!ip host t4155551234 4017 121.12.33.15!line 35login authentication modemmodem dialin delaystopbits 1speed 2400flowcontrol hardwaretransport input noneautocommand ats203=20Host Router Configuration
!line 17login authentication asynctunnelsmodem hosttransport input allstopbits 1speed 2400flowcontrol hardwareno execBanner Setup and Display Example
The following example configures the Cisco Modem User Interface feature banner to display the modem model and code revision in response to the ATI6 modem command:
modemui-version / Telebit T3000 Modem, Version 1.5 /To display the banner, perform the following steps:
Step 1
Router# modemuiStep 2
ATI6Telebit T3000, Version 1.5Step 3
ATDT4085551212CONNECTUser Access VerificationUsername:Step 4
Step 5
ATZ99Router#
Command Reference
This section documents new and modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.2 command reference publications.
New Commands
Modified Commands
ip host
To define a static host name-to-address mapping in the host cache, use the ip host command in global configuration mode. To remove the host name-to-address mapping, use the no form of this command.
ip host {name | tmodem-telephone-number} [tcp-port-number] {address1 [address2...address8]}
no ip host {name | tmodem-telephone-number} address1
Syntax Description
Defaults
Disabled
Command Modes
Global configuration
Command History
10.0
This command was introduced.
12.2(4)T
The capability to map a modem telephone number to an IP host was added for the Cisco modem user interface feature.
Usage Guidelines
The first character can be either a letter or a number. If you use a number, the types of operations you can perform (such as ping) are limited.
Examples
The following example defines two static mappings:
ip host croff 192.168.7.18ip host bisso-gw 10.2.0.2 192.168.7.33The following example shows how to map modem telephone number (415) 555-1234 to IP host address 10.1.5.5 for the Cisco modem user interface mode:
ip host t4155551234 10.1.5.5modem dialin
To configure a line to enable a modem attached to the router to accept incoming calls only, use the modem dialin command in line configuration mode. To disable this feature, use the no form of this command.
modem dialin [delay]
no modem dialin
Syntax Description
delay
(Optional) Causes the operating system to delay assertion of the data terminal ready (DTR) signal until a network connection is established.
Defaults
Incoming calls to the modem are not permitted.
Command Modes
Line configuration
Command History
11.1
This command was introduced.
12.2(4)T
The delay keyword was added to support the Cisco Modem User Interface feature.
Usage Guidelines
This command supports modems that can automatically handle telephone line activity, such as answering the telephone after a certain number of rings.
The delay keyword is useful when using the modemui EXEC command with software that requires a signal assertion to recognize that a connection has been established. It may be necessary to reroute the router DTR signal to an alternate EIA-232 pin such as Carrier Detect (CD) for the delay to work properly.
Examples
The following example configures a line for a high-speed modem:
line 5modem dialinThe following example shows how to set up a delay in a line configured for the Cisco Modem User Interface feature:
line aux 0login authentication modemmodem dialin delayautocommand modemuitransport input allstopbits 1speed 38400flowcontrol hardwareRelated Commands
modem inout
Configures a line for both incoming and outgoing calls.
modemui
Enters the Cisco modem user interface mode.
parity
Defines generation of a parity bit.
modemui
To enter Cisco modem user interface mode and enter Hayes-compatible modem commands, use the modemui command in EXEC mode.
modemui [modem-commands]
Syntax Description
modem-commands
(Optional) Hayes-compatible modem commands. Table 1 lists the modem commands supported on Cisco routers. Multiple commands may be entered.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use the modemui command to enter interactive Cisco modem user interface mode, which allows the Hayes-compatible modem command subset listed in Table 1 to be entered.
The modemui EXEC command can also be entered with the autocommand line configuration command to configure the Cisco modem user interface feature as part of line configuration.
Note
Examples
The following example shows how to configure a line for the Cisco Modem User Interface feature and set the modem in no-echo, short-response mode:
line aux 0login authentication modemmodem dialin delayautocommand modemui ATE0V0transport input allstopbits 1speed 38400flowcontrol hardwareThe following example shows how to enter Cisco modem user interface mode from the Cisco IOS EXEC mode and enter Hayes-compatible AT commands to dial and test the modem:
Router# modemuiATOKATDT4155551234CONNECTUser Access VerificationUsername:Related Commands
modemui-version
To display a banner as a response to the Hayes modem information command, use the modemui-version command in global configuration mode. To remove or change the banner display, use the no form of this command.
modemui-version delimiter banner-text delimiter
no modemui-version delimiter banner-text delimiter
Syntax Description
delimiter
Character that you choose, such as # or /, to signal the beginning and end of the banner message.
banner-text
Banner message text.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Usage Guidelines
Use the modemui-version command to configure banners for the Hayes information mode command (ATIn).
Examples
The following example configures the modem user interface banner to display the modem model and code revision in response to the ATI6 Cisco modem user interface command:
modemui-version / Telebit T3000, Version 1.5 /Related Commands
show hosts
To display the default domain name, the style of name lookup service, a list of name server hosts, and the cached list of host names and addresses, use the show hosts command in EXEC mode.
show hosts
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
10.0
This command was introduced.
12.2(4)T
This command was updated to support the Cisco modem user interface feature.
Examples
The following is sample output from the show hosts command:
Router# show hostsDefault domain is CISCO.COMName/address lookup uses domain serviceName servers are 255.255.255.255Host Flag Age Type Address(es)SLAG.CISCO.COM (temp, OK) 1 IP 172.20.4.10CHAR.CISCO.COM (temp, OK) 8 IP 192.168.7.50CHAOS.CISCO.COM (temp, OK) 8 IP 172.20.1.115DIRT.CISCO.COM (temp, EX) 8 IP 172.20.1.111DUSTBIN.CISCO.COM (temp, EX) 0 IP 172.20.1.27DREGS.CISCO.COM (temp, EX) 24 IP 172.20.1.30Table 2 describes the significant fields shown in the display.
The following is sample output from a router when a modem telephone number is mapped to an IP host address for the Cisco modem user interface feature using the ip host global configuration command:
Router# show hostsDefault domain is not setName/address lookup uses domain serviceName servers are 255.255.255.255Codes: u - unknown, e - expired, * - OK, ? - revalidatet - temporary, p - permanentHost Age Type Address(es)*p p4085554567 0 IP 1.2.1.6*p t4085551234 0 IP 1.2.1.5Under the Host field, a "p" preceding the number indicates a pulse-dialed modem telephone number, and a "t" indicates a tone-dialed modem telephone number. The IP address mapped to the telephone number appears under the Address(es) field. See Table 2 for descriptions of the other fields seen in this display.
Related Commands
clear host
Deletes entries from the host name-to-address cache.
ip host
Defines a static host-name-to-address mapping in the host cache.
Glossary
AT commands—The basic AT, or attention, command starts interaction with a Hayes or Hayes-compatible modem. Additional Hayes modem commands and arguments can be added to the basic AT command to set modem characteristics. For example, the ATE0 command turns off command echoing.
Hayes-compatible modem—Any modem that recognizes Hayes modem commands. Hayes Microcomputer Products has developed a language called the AT command set for controlling modems that has become a de facto modem industry standard.
point of sale—See POS.
point of service—See POS.
POS—point of service or point of sale. A terminal such as those used by gasoline service stations to charge customers for merchandise and services. A POS can be a PC with an internal modem and software or an integrated device containing both a terminal and modem.
S-registers—Low-level modem service registers. Users can modify modem behavior by setting numeric values into various modem control registers.
