1ttyi(4) Special files ttyi(4)
2
6 ttyI - ISDN character devices with modem emulator
7
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 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 The line disciplines are handled by the kernel so that SLIP, CSLIP and
25 asynchronous PPP are possible.
26 The port speed of the ISDN tty devices is always 64000 bps.
28
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 ATA Answer an incoming call.
36 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 ATE0 Echo off.
43 ATE1 Echo on (default).
45 ATH Hang up.
47 ATH0 Hang up.
49 ATH1 Off hook (ignored).
51 ATI Return device Information ("ISDN for Linux...").
53 ATI0 Return device Information ("ISDN for Linux...").
55 ATI1 Return device Information ("ISDN for Linux...").
57 ATI2 Return Statistics of last connection.
59 ATO Return from command mode to online mode (data mode).
61 ATQ0 Enable result codes (default).
63 ATQ1 Disable result codes.
65 ATSx=y Set register x to value y.
67 ATSx? Show content of register x.
69 ATSx.y=z
71 Set register x, bit y to value z
72 ATSx.y?
74 Show bit y of register x.
75 ATV0 Print result code as number.
77 ATV1 Print result code as text (default).
79 ATZ Reset all registers and load profile values.
81 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 AT&D2 DTR falling edge: hang up and return to command mode (default).
90 AT&D3 DTR falling edge: hang up, return to command mode and reset all
92 registers.
93 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 AT&F Set all registers and profile to "factory-defaults".
100 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 AT&V Show current register settings.
107 AT&W0 Write registers and EAZ/MSN to profile. (You need to run
109 iprofd(8) for making changes permanent.)
110 AT&X0 Disable BTX-Mode (default).
112 AT&X1 Enable BTX-Mode.
114
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
123 0 (default 0)
124 Number of rings on which the "modem" will answer. (S0=0 will
125 disable auto answering).
126 1 (default 0)
128 Counts and stores the number of rings from an incoming call.
129 2 (default 43 = '+')
131 ASCII code of the escape character.
132 3 (default 13 = CR)
134 ASCII code of Carriage Return.
135 4 (default 10 = LF)
137 ASCII code of Line Feed.
138 5 (default 8 = BS)
140 ASCII code of Backspace.
141 6 (default 3)
143 Duration, in number of seconds, modem waits before dialling.
144 7 (default 60)
146 Wait time for carrier in seconds.
147 8 (default 2)
149 Pause time for comma (',') in dial command in seconds (ignored).
150 9 (default 6)
152 Carrier detect time in tenths of seconds (ignored).
153 10 (default 7)
155 Wait time until hangup after carrier loss in tenths of seconds
156 (ignored).
157 11 (default 70)
159 Duration and delay in milliseconds for touch tone dialling
160 (ignored).
161 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 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 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 15 (default 0)
215 Layer-3 protocol.
216 0 = transparent
217 1 = transparent with audio features (e.g. DSP)
218 2 = Fax G3
219 16 (default 250)
221 Outgoing packet size / 16.
222 17 reserved.
224 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 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 Incoming service audio (Reg. 20.0 = 1)
242 L2-protocol is set to 4 (TRANSPARENT).
243 Incoming service BTX (Reg. 20.1 = 1)
245 L2-protocol is set to 0 (X75/LAPB with I-frames).
246 Incoming service date (Reg. 20.2 = 1)
248 L2-protocol is set to 0 (X75/LAPB with I-frames).
249 19 (default 0)
251 Service-Octet-2 (ignored when using EDSS1).
252 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 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 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 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 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
284 Fritz Elfert <fritz@isdn4linux.de>
285 modified by Paul Slootman <paul@isdn4linux.de>
286
289 icnctrl(8), telesctrl(8), isdninfo(4), isdn_audio(4), isdnctrl(8).
290ISDN 4 Linux 3.13 2002/01/31 ttyi(4)