isdn4linux-web/workshop/ttyI.shtml

294 lines
12 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>ttyI, cui - ISDN character devices with modem emulator</TITLE>
<!--#include virtual="/ssi/js.shtml" -->
<!--#include virtual="/ssi/buttondefs.shtml" -->
</HEAD>
<BODY BGCOLOR="#FFFFFF">
<TABLE WIDTH="100%">
<TR>
<TD ALIGN=LEFT WIDTH="90"><!--#include virtual="/ssi/b_home.shtml" --></TD>
<TD ALIGN=RIGHT WIDTH="90"><!--#include virtual="/ssi/b_index.shtml" --></TD>
</TR>
</TABLE>
<PRE>
ttyI, cui - ISDN character devices with modem emulator
</PRE>
<H2>DESCRIPTION</H2><PRE>
<EM>ttyI</EM><STRONG>[</STRONG><EM>0-63</EM><STRONG>]</STRONG> and <EM>cui</EM><STRONG>[</STRONG><EM>0-63</EM><STRONG>]</STRONG> are emulated tty devices of the
Linux ISDN subsystem. These devices can be used in the
same way as the traditional serial devices <EM>ttySx</EM> and <EM>cuax</EM>.
The official major device numbers are <STRONG>43</STRONG> for <EM>ttyI</EM> and <STRONG>44</STRONG>
for <EM>cui</EM>. The minor device numbers start with <STRONG>0</STRONG> and end
with <STRONG>63</STRONG>.
The ISDN tty devices are equipped with a modem emulation
implementing a set of traditional and some special AT com­
mands. This provides easy use together with almost all
communication software that uses modem commands: <STRONG>mini­</STRONG>
<STRONG>com</STRONG>(1), <STRONG>seyon</STRONG>(1), <STRONG>XCept</STRONG>(1), <STRONG>uucico</STRONG>(8), <STRONG>mgetty</STRONG>(8), <STRONG>dip</STRONG>(8),
<STRONG>pppd</STRONG>(8) and more. When enabled during kernel configura­
tion, the emulator is capable of a reduced set of commands
to support audio. To use audio features, an ISDN card with
a audio-capable low-level driver is needed. Currently the
only audio-capable drivers are the teles and HiSax driver.
The line disciplines are handled by the kernel so that
SLIP, CSLIP and asynchronous PPP are possible.
The port speed of the ISDN tty devices is always 64000
bps.
</PRE>
<H2>AT COMMAND SET</H2><PRE>
The description of <STRONG>AT</STRONG> <STRONG>commands</STRONG> here does <STRONG>not</STRONG> cover audio
related commands. For a description of audio related com­
mands, see <STRONG>isdn_audio</STRONG>(4). The following <STRONG>AT</STRONG> <STRONG>commands</STRONG> are
supported by ISDN tty devices:
<STRONG>ATA</STRONG> Answer an incoming call.
<STRONG>ATD</STRONG><EM>num</EM> Dial number <EM>num</EM>. Allowed are digits [0-9] and the
characters ",", "#", ".", "*", "W", "P", "T", "S",
"-". The characters are ignored except of "S" which
indicates a SPV if it precedes the number (<STRONG>only</STRONG>
German 1TR6 ISDN).
<STRONG>ATE0</STRONG> Echo off.
<STRONG>ATE1</STRONG> Echo on (default).
<STRONG>ATH</STRONG> Hang up.
<STRONG>ATH0</STRONG> Hang up.
<STRONG>ATH1</STRONG> Off hook (ignored).
<STRONG>ATI1</STRONG> Return device Information ("ISDN for Linux...").
<STRONG>ATI2</STRONG> Return Statistics of last connection.
<STRONG>ATO</STRONG> Return from command mode to online mode (data
mode).
<STRONG>ATQ0</STRONG> Enable result codes (default).
<STRONG>ATQ1</STRONG> Disable result codes.
<STRONG>ATS</STRONG><EM>x</EM><STRONG>=</STRONG><EM>y</EM> Set register <EM>x</EM> to value <EM>y</EM>.
<STRONG>ATS</STRONG><EM>x</EM><STRONG>?</STRONG> Show content of register <EM>x</EM>.
<STRONG>ATS</STRONG><EM>x</EM><STRONG>.</STRONG><EM>y</EM><STRONG>=</STRONG><EM>z</EM>
Set register <EM>x</EM>, bit <EM>y</EM> to value <EM>z</EM>
<STRONG>ATS</STRONG><EM>x</EM><STRONG>.</STRONG><EM>y</EM><STRONG>?</STRONG>
Show bit <EM>y</EM> of register <EM>x</EM>.
<STRONG>ATV0</STRONG> Print result code as number.
<STRONG>ATV1</STRONG> Print result code as text (default).
<STRONG>ATZ</STRONG> Reset all registers and load profile values.
<STRONG>AT&amp;B</STRONG><EM>x</EM> Set packet size of outgoing packets to value <EM>x</EM>
(maximum 4000). The actual packet size depends on
the hardware driver and may be smaller than <EM>x</EM> (e.g.
with the teles driver). There will be <STRONG>no</STRONG> error mes­
sage if the value is bigger than the hardware
driver can process. However the size of the outgo­
ing packets will be set correctly.
<STRONG>AT&amp;D2</STRONG> DTR falling edge: hang up and return to command
mode (default).
<STRONG>AT&amp;D3</STRONG> DTR falling edge: hang up, return to command mode
and reset all registers.
<STRONG>AT&amp;E</STRONG><EM>x</EM> Set MSN (Euro-ISDN, EDSS1) or EAZ (German 1TR6) to
value <EM>x</EM>. For MSNs, <EM>x</EM> is a string of digits repre­
senting the local phone number, while for EAZs <EM>x</EM>
should be only the last digit of the Number.
<STRONG>AT&amp;F</STRONG> Set all registers and profile to "factory-
defaults".
<STRONG>AT&amp;V</STRONG> Show current register settings.
<STRONG>AT&amp;X0</STRONG> Disable BTX-Mode (default).
<STRONG>AT&amp;X1</STRONG> Enable BTX-Mode.
</PRE>
<H2>ESCAPE SEQUENCE</H2><PRE>
During a data connection, the driver can be set to command
mode by typing in <EM>delay</EM><STRONG>+++</STRONG><EM>delay</EM>. The escape character
(default "+") may be set via register 2. The <EM>delay</EM> must be
at least 1.5 seconds and between each escape character the
pause must not exceed 0.5 seconds. <EM>ATO</EM> brings the modem
emulation back to data mode.
</PRE>
<H2>REGISTERS</H2><PRE>
<STRONG>0</STRONG> (default 0)
Number of rings on which the "modem" will answer.
(S0=0 will disable auto answering).
<STRONG>1</STRONG> (default 0)
Counts and stores the number of rings from an
incoming call.
<STRONG>2</STRONG> (default 43 = '+')
ASCII code of the escape character.
<STRONG>3</STRONG> (default 13 = CR)
ASCII code of Carriage Return.
<STRONG>4</STRONG> (default 10 = LF)
ASCII code of Line Feed.
<STRONG>5</STRONG> (default 8 = BS)
ASCII code of Backspace.
<STRONG>6</STRONG> (default 3)
Duration, in number of seconds, modem waits before
dialling.
<STRONG>7</STRONG> (default 60)
Wait time for carrier in seconds (ignored).
<STRONG>8</STRONG> (default 2)
Pause time for comma (',') in dial command in sec­
onds (ignored).
<STRONG>9</STRONG> (default 6)
Carrier detect time in tenths of seconds (ignored).
<STRONG>10</STRONG> (default 7)
Wait time until hangup after carrier loss in tenths
of seconds (ignored).
Duration and delay in milliseconds for touch tone
dialling (ignored).
<STRONG>12</STRONG> (default 69)
Bit-mapped register.
Bit Description
0 0 = Suppress response messages.
1 = Show response messages.
1 0 = Response messages as text.
1 = Numeric response messages.
2 0 = Echo off.
1 = Echo on.
3 0 = DCD always on.
1 = DCD follows carrier.
4 0 = CTS follows RTS.
1 = Ignore RTS, CTS always on.
5 0 = Low-edge on DTR: Hangup and return
to command mode.
1 = Same as 0 but also resets all
registers.
6 0 = DSR always on.
1 = DSR on only if channel is available.
7 0 = Cisco-PPP-flag-hack off.
1 = Cisco-PPP-flag-hack on.
<STRONG>13</STRONG> (default 4)
Bit-mapped register.
Bit Description
0 0 = Use delayed sending of data.
1 = Immediately send data.
1 0 = T.70 protocol off.
1 = T.70 protocol on.
2 0 = Don't hangup on DTR low.
1 = Hangup on DTR low.
3 0 = Standard response messages.
1 = Extended response messages.
4 0 = CALLER NUMBER before every RING.
1 = CALLER NUMBER after first RING.
<STRONG>14</STRONG> (default 0)
Layer-2 protocol.
0 = X75/LAPB with I-frames.
1 = X75/LAPB with UI-frames.
2 = X75/LAPB with BUI-frames.
3 = HDLC.
4 = TRANSPARENT.
<STRONG>15</STRONG> (default 0)
Layer-3 protocol.
0 = transparent
<STRONG>16</STRONG> (default 250)
<STRONG>18</STRONG> (default 4)
Service-Octet-1 to accept or to be used on dial
out.
Bit-mapped register.
Bit Description
0 Service 1 (audio) when set.
1 Service 5 (BTX) when set.
2 Service 7 (data) when set.
Note: It is possible to set more than one bit. In
this case, on outgoing calls, the most sig­
nificant 1-bit is chosen to select the out­
going service octet. On incoming calls the
selected services are accepted, contents of
register 14 is ignored and the Layer-2-pro­
tocol is automatically set with the follow­
ing values to match the service of the
incoming call:
Incoming service <EM>audio</EM> (Reg. 20.0 = 1)
L2-protocol is set to 4 (TRANSPAR­
ENT).
Incoming service <EM>BTX</EM> (Reg. 20.1 = 1)
L2-protocol is set to 0 (X75/LAPB
with I-frames).
Incoming service <EM>date</EM> (Reg. 20.2 = 1)
L2-protocol is set to 0 (X75/LAPB
with I-frames).
<STRONG>19</STRONG> (default 0)
Service-Octet-2 (ignored when using EDSS1).
<STRONG>20</STRONG> (read only)
Service-Octet-1 of last incoming call. This bit-
mapped register is set on incoming call (during
RING). Mapping is the same like register 18.
<STRONG>21</STRONG> (read only)
Bit-mapped register. Set on incoming call (during
RING) to the value of octet 3 of calling party num­
ber Information Element (Numbering plan). See sec­
tion <STRONG>4.5.10</STRONG> of <STRONG>ITU</STRONG> <STRONG>Q.931</STRONG>.
<STRONG>22</STRONG> (read only)
Bit-mapped register. Set on incoming call (during
RING) to the value of octet 3a of calling party
number Information Element (Screening info). See
section <STRONG>4.5.10</STRONG> of <STRONG>ITU</STRONG> <STRONG>Q.931</STRONG>.
Fritz Elfert &lt;fritz@wuemaus.franken.de&gt;
</PRE>
<H2>SEE ALSO</H2><PRE>
<STRONG>icnctrl</STRONG>(8), <STRONG>telesctrl</STRONG>(8), <A HREF="isdninfo.shtml">isdninfo</A>(4), <A HREF="isdn_audio.shtml">isdn_audio</A>(4), <STRONG>isd­</STRONG>
<STRONG>nctrl</STRONG>(8).
</PRE>
</BODY>
</HTML>