Return to modemcap CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

coherent

modemcap              Technical Information              modemcap




Modem description language


modemcap is a language  for describing modems to your system.  It
resembles the  termcap language in  its syntax, although  the two
are by no means  identical.  With modemcap, you can describe your
modem to any program  that automatically dials out on your modem;
this should  spare you the tedium  of continually describing your
modem to one program after another.

The copy of  /etc/modemcap included with your release of COHERENT
already contains descriptions of many popular modems; the chances
are good that yours has already been described for you.

Each modemcap  command is  one of  three types: flag,  string, or
number.  A  flag command  signals that  your modem is  performs a
particular action or  has a particular feature.  A string command
gives the  command that your  modem recognizes to  perform a par-
ticular  action.  For  example,  many modems  recognize that  the
string at means that you  want to gain its attention.  Finally, a
number command sets a value  or parameter for your modem, such as
the highest baud rate it recognizes.

The following table describes each modemcap command:

_N_a_m_e _T_y_p_e      _M_e_a_n_i_n_g

aadd   number    Delay after aass
aass   flag      Numbers are in ASCII, not binary
aatt   string    Attention string, forces model into command mode
               from online mode
bbdd   number    Highest online baud rate
bbll   number    Alternate lower baud rate
ccee   string    Command end string (required if CS is present)
ccll   string    String from modem on remote connection at BL baud rate
ccoo   string    String from modem on remote connection at BD baud rate
ccss   string    Command start string
ddee   string    End dial command string (required if DS is present)
ddii   flag      Modem has a dialer
ddss   string    Start dial command string
iidd   number    Delay after IS
iiss   string    Initialization string, resets modem to offline,
               ready to dial
hhcc   flag      Modem hangs up when DTR drops
hhuu   string    Hangup command
tttt   flag      Modem dials touchtone by default (or DS is set
               that way)

All commands, such as ddss (dial  command) and hu (hang up) will be
prefixed by  cs and ended with  ce.  If there is  a common prefix
and suffix, use  this feature.  Otherwise, each command will have
to have the entire string built in.




COHERENT Lexicon                                           Page 1




modemcap              Technical Information              modemcap



***** Example Entry *****

The  following gives  the entry  in  /etc/modemcap for  the Hayes
Smartmodem 1200:


hy|hayes|Hayes Smartmodem 1200:\
     :as:at=+++:ad#3:bd#1200:bl#300:cs=AT:ce=\r:co=CONNECT:\
     :cl=CONNECT:di:ds=DT :de=:is=ATQ0 V1 E1\r:id#2:\
     :hc:hu=H0 V0 E0 Q1:tt:


Each field is separated by a colon.  A backslash `\' character at
the end  of each  line but the  last lets the  description extend
over more than one line.

The  three  fields  gives three  versions  of  the modem's  name,
separated by vertical bars `|'.  The first version of the name is
a  two-character mnemonic;  this must be  unique.  The  other two
versions give fuller versions of the name; these are optional.

The following explains each field in detail:

aass             Numbers are in binary mode.

aatt=+++         To gain the attention of the modem, type +++.

aadd#33           Delay three milliseconds after a number.

bbdd#11220000        Maximum baud rate is 1200.

bbll#330000         Minimum baud rate is 300.

ccss=AATT          To initiate a command string, type AATT.

ccee=\rr           A command  string is  ended by  a carriage-return
               character.

ccoo=CCOONNNNEECCTT     Modem  returns the string CCOONNNNEECCTT  when it makes a
               connection at 1200 baud.

ccll=CCOONNNNEECCTT     Modem  returns the string CCOONNNNEECCTT  when it makes a
               connection at 300 baud.

ddii             The modem can dial a telephone number.

ddss=DDTT          Begin dialing, touch-tone mode.

ddee=             No  special  string is  needed  to  end the  dial
               string.

iiss=AATTQQ00        To initialize the modem, type AATTQQ00 VV11 EE11<rreettuurrnn>.

iidd#22
               Delay two  seconds after entering  the initializa-


COHERENT Lexicon                                           Page 2




modemcap              Technical Information              modemcap



               tion string.

hhcc             The modem hangs  up when DTR drops (i.e., it hangs
               up when the program requests a hangup).

hhuu=HH00          To hang up, type HH00 VV00 EE00 QQ11.

tttt             The modem dials touch-tone by default.

***** Currently Recognized Modems *****

The  file /etc/modemcap  includes descriptions  of  the following
modems:


          Trailblazer, 9600 baud
          Trailblazer, 2400 baud
          Hayes Smartmodem 1200
          Avatex 2400 (clone of Hayes Smartmodem 2400)
          Prometheus Promodem 1200
          Signalman Mark XII
          Radio Shack Direct-Connect 300 Modem


***** See Also *****

technical information, termcap






























COHERENT Lexicon                                           Page 3

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.