1ttyi(4)                          Special files                         ttyi(4)
2
3
4

NAME

6       ttyI - ISDN character devices with modem emulator
7

DESCRIPTION

9       ttyI[0-63] are emulated tty devices of the Linux ISDN subsystem.  These
10       devices can be used in the same way as the traditional  serial  devices
11       ttySx.   The official major device numbers are 43 for ttyI .  The minor
12       device numbers start with 0 and end with 63.
13
14       The ISDN tty devices are equipped with a modem emulation implementing a
15       set of traditional and some special AT commands. This provides easy use
16       together with almost all communication software that  uses  modem  com‐
17       mands:  minicom(1),  seyon(1),  XCept(1), uucico(8), mgetty(8), dip(8),
18       pppd(8) and more. When enabled during kernel configuration, the  emula‐
19       tor  is  capable  of a reduced set of commands to support audio. To use
20       audio features, an ISDN card with a audio-capable low-level  driver  is
21       needed.  Currently  the  only  audio-capable  drivers are the teles and
22       HiSax driver.
23
24       The line disciplines are handled by the kernel so that SLIP, CSLIP  and
25       asynchronous PPP are possible.
26
27       The port speed of the ISDN tty devices is always 64000 bps.
28
29

AT COMMAND SET

31       The  description  of AT commands here does not cover audio related com‐
32       mands. For a description of audio related commands, see  isdn_audio(4).
33       The following AT commands are supported by ISDN tty devices:
34
35       ATA    Answer an incoming call.
36
37       ATDnum Dial  number  num.   Allowed are digits [0-9] and the characters
38              ",", "#", ".", "*", "W", "P", "T", "S", "-". The characters  are
39              ignored  except  of "S" which indicates a SPV if it precedes the
40              number (only German 1TR6 ISDN).
41
42       ATE0   Echo off.
43
44       ATE1   Echo on (default).
45
46       ATH    Hang up.
47
48       ATH0   Hang up.
49
50       ATH1   Off hook (ignored).
51
52       ATI    Return device Information ("ISDN for Linux...").
53
54       ATI0   Return device Information ("ISDN for Linux...").
55
56       ATI1   Return device Information ("ISDN for Linux...").
57
58       ATI2   Return Statistics of last connection.
59
60       ATO    Return from command mode to online mode (data mode).
61
62       ATQ0   Enable result codes (default).
63
64       ATQ1   Disable result codes.
65
66       ATSx=y Set register x to value y.
67
68       ATSx?  Show content of register x.
69
70       ATSx.y=z
71              Set register x, bit y to value z
72
73       ATSx.y?
74              Show bit y of register x.
75
76       ATV0   Print result code as number.
77
78       ATV1   Print result code as text (default).
79
80       ATZ    Reset all registers and load profile values.
81
82       AT&Bx  Set packet size of outgoing packets to value x  (maximum  4000).
83              The actual packet size depends on the hardware driver and may be
84              smaller than x (e.g. with the teles driver). There  will  be  no
85              error  message  if  the value is bigger than the hardware driver
86              can process. However the size of the outgoing  packets  will  be
87              set correctly.
88
89       AT&D2  DTR falling edge: hang up and return to command mode (default).
90
91       AT&D3  DTR  falling edge: hang up, return to command mode and reset all
92              registers.
93
94       AT&Ex  Set MSN (Euro-ISDN, EDSS1) or EAZ (German 1TR6) to value x.  For
95              MSNs,  x is a string of digits representing the local phone num‐
96              ber, while for EAZs x should be only the last digit of the  Num‐
97              ber.
98
99       AT&F   Set all registers and profile to "factory-defaults".
100
101       AT&Lplist
102              Set  list  of  phone  numbers  to listen on.  plist is a list of
103              wildcard patterns separated by semicolon. If this is set, it has
104              precedence over the MSN set by AT&E.
105
106       AT&V   Show current register settings.
107
108       AT&W0  Write  registers  and  EAZ/MSN  to  profile.  (You  need  to run
109              iprofd(8) for making changes permanent.)
110
111       AT&X0  Disable BTX-Mode (default).
112
113       AT&X1  Enable BTX-Mode.
114

ESCAPE SEQUENCE

116       During a data connection, the driver can be set to command mode by typ‐
117       ing  in  delay+++delay.   The escape character (default "+") may be set
118       via register 2. The delay must be at least 1.5 seconds and between each
119       escape character the pause must not exceed 0.5 seconds.  ATO brings the
120       modem emulation back to data mode.
121

REGISTERS

123       0 (default 0)
124              Number of rings on which the "modem"  will  answer.  (S0=0  will
125              disable auto answering).
126
127       1 (default 0)
128              Counts and stores the number of rings from an incoming call.
129
130       2 (default 43 = '+')
131              ASCII code of the escape character.
132
133       3 (default 13 = CR)
134              ASCII code of Carriage Return.
135
136       4 (default 10 = LF)
137              ASCII code of Line Feed.
138
139       5 (default 8 = BS)
140              ASCII code of Backspace.
141
142       6 (default 3)
143              Duration, in number of seconds, modem waits before dialling.
144
145       7 (default 60)
146              Wait time for carrier in seconds.
147
148       8 (default 2)
149              Pause time for comma (',') in dial command in seconds (ignored).
150
151       9 (default 6)
152              Carrier detect time in tenths of seconds (ignored).
153
154       10 (default 7)
155              Wait  time  until hangup after carrier loss in tenths of seconds
156              (ignored).
157
158       11 (default 70)
159              Duration and delay  in  milliseconds  for  touch  tone  dialling
160              (ignored).
161
162       12 (default 69)
163              Bit-mapped register.
164              Bit  Description
165              0    0 = Suppress response messages.
166                   1 = Show response messages.
167              1    0 = Response messages as text.
168                   1 = Numeric response messages.
169              2    0 = Echo off.
170                   1 = Echo on.
171              3    0 = DCD always on.
172                   1 = DCD follows carrier.
173              4    0 = CTS follows RTS.
174                   1 = Ignore RTS, CTS always on.
175              5    0 = Low-edge on DTR: Hangup and return
176                        to command mode.
177                   1 = Same as 0 but also resets all
178                        registers.
179              6    0 = DSR always on.
180                   1 = DSR on only if channel is available.
181              7    0 = Cisco-PPP-flag-hack off.
182                   1 = Cisco-PPP-flag-hack on.
183
184       13 (default 4)
185              Bit-mapped register.
186              Bit  Description
187              0    0 = Use delayed sending of data.
188                   1 = Immediately send data.
189              1    0 = T.70 protocol off.
190                   1 = T.70 protocol on.
191              2    0 = Don't hangup on DTR low.
192                   1 = Hangup on DTR low.
193              3    0 = Standard response messages.
194                   1 = Extended response messages.
195              4    0 = CALLER NUMBER before every RING.
196                   1 = CALLER NUMBER after first RING.
197              5    0 = Disable extended T.70 protocol.
198                   1 = Enable extended T.70 protocol.
199              6    0 = Disable RUNG message.
200                   1 = RUNG on cancelled incoming call.
201              7    0 = Disable display messages from net.
202                   1 = Enable disable messages from net.
203
204       14 (default 0)
205              Layer-2 protocol.
206               0 = X75/LAPB with I-frames.
207               1 = X75/LAPB with UI-frames.
208               2 = X75/LAPB with BUI-frames.
209               3 = HDLC.
210               4 = TRANSPARENT.
211              10 = Analog Modem. (only if hardware supports this)
212              11 = Fax G3. (only if hardware supports this)
213
214       15 (default 0)
215              Layer-3 protocol.
216              0 = transparent
217              1 = transparent with audio features (e.g. DSP)
218              2 = Fax G3
219
220       16 (default 250)
221              Outgoing packet size / 16.
222
223       17     reserved.
224
225       18 (default 4)
226              Service-Octet-1 to accept or to be used on dial out.
227              Bit-mapped register.
228              Bit  Description
229              0    Service 1 (audio) when set.
230              1    Service 5 (BTX) when set.
231              2    Service 7 (data) when set.
232
233              Note:  It is possible to set more than one bit. In this case, on
234                     outgoing calls, the most significant 1-bit is  chosen  to
235                     select  the outgoing service octet. On incoming calls the
236                     selected services are accepted, contents of  register  14
237                     is  ignored and the Layer-2-protocol is automatically set
238                     with the following values to match  the  service  of  the
239                     incoming call:
240
241                     Incoming service audio (Reg. 20.0 = 1)
242                            L2-protocol is set to 4 (TRANSPARENT).
243
244                     Incoming service BTX (Reg. 20.1 = 1)
245                            L2-protocol is set to 0 (X75/LAPB with I-frames).
246
247                     Incoming service date (Reg. 20.2 = 1)
248                            L2-protocol is set to 0 (X75/LAPB with I-frames).
249
250       19 (default 0)
251              Service-Octet-2 (ignored when using EDSS1).
252
253       20 (read only)
254              Service-Octet-1  of last incoming call. This bit-mapped register
255              is set on incoming call (during RING). Mapping is the same  like
256              register 18.
257
258       21 (read only)
259              Bit-mapped  register.  Set on incoming call (during RING) to the
260              value of octet 3 of calling  party  number  Information  Element
261              (Numbering plan).  See section 4.5.10 of ITU Q.931.
262
263       22 (read only)
264              Bit-mapped  register.  Set on incoming call (during RING) to the
265              value of octet 3a of calling party  number  Information  Element
266              (Screening info).  See section 4.5.10 of ITU Q.931.
267
268       23 (default 0)
269              Bit-mapped register.
270              Bit  Description
271              0    0 = Disable CPN extended RING.
272                   1 = Enable CPN extended RING.
273              1    0 = Disable CPN extended FCON.
274                   1 = Enable CPN extended FCON.
275
276
277       NOTE   There  used  also  be  cui devices (major device number 44), but
278              since the cua devices for regular tty devices are no longer sup‐
279              ported  in  the  kernel,  these are also no longer supported for
280              ISDN4linux.
281
282

AUTHOR

284       Fritz Elfert <fritz@isdn4linux.de>
285       modified by Paul Slootman <paul@isdn4linux.de>
286
287

SEE ALSO

289       icnctrl(8), telesctrl(8), isdninfo(4), isdn_audio(4), isdnctrl(8).
290
291
292
293ISDN 4 Linux 3.27                 2002/01/31                           ttyi(4)
Impressum