Linux Manual Pages

Free Software * Books

Source Code

Free Media

Linux

ttyi

NAME
DESCRIPTION
AT COMMAND SET
ESCAPE SEQUENCE
REGISTERS
NOTE
AUTHOR
SEE ALSO

NAME

ttyI − ISDN character devices with modem emulator

DESCRIPTION

ttyI[0-63] are emulated tty devices of the Linux ISDN subsystem. These devices can be used in the same way as the traditional serial devices ttySx. The official major device numbers are 43 for ttyI . The minor device numbers start with 0 and end with 63.

The ISDN tty devices are equipped with a modem emulation implementing a set of traditional and some special AT commands. This provides easy use together with almost all communication software that uses modem commands: minicom(1), seyon(1), XCept(1), uucico(8), mgetty(8), dip(8), pppd(8) and more. When enabled during kernel configuration, 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.

AT COMMAND SET

The description of AT commands here does not cover audio related commands. For a description of audio related commands, see isdn_audio(4). The following AT commands are supported by ISDN tty devices:

	ATA		Answer an incoming call.
	ATDnum		Dial number num. 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 (only* German 1TR6 ISDN).
	ATE0		Echo off.
	ATE1		Echo on (default).
	ATH		Hang up.
	ATH0		Hang up.
	ATH1		Off hook (ignored).
	ATI		Return device Information ("ISDN for Linux...").
	ATI0		Return device Information ("ISDN for Linux...").
	ATI1		Return device Information ("ISDN for Linux...").
	ATI2		Return Statistics of last connection.
	ATO		Return from command mode to online mode (data mode).
	ATQ0		Enable result codes (default).
	ATQ1		Disable result codes.
	ATSx=y		Set register x to value y.
	ATSx?		Show content of register x.

ATSx.y=z

Set register x, bit y to value z

ATSx.y?

Show bit y of register x.

	ATV0		Print result code as number.
	ATV1		Print result code as text (default).
	ATZ		Reset all registers and load profile values.
	AT&Bx		Set packet size of outgoing packets to value x (maximum 4000). The actual packet size depends on the hardware driver and may be smaller than x (e.g. with the teles driver). There will be no error message if the value is bigger than the hardware driver can process. However the size of the outgoing packets will be set correctly.
	AT&D2		DTR falling edge: hang up and return to command mode (default).
	AT&D3		DTR falling edge: hang up, return to command mode and reset all registers.
	AT&Ex		Set MSN (Euro-ISDN, EDSS1) or EAZ (German 1TR6) to value x. For MSNs, x is a string of digits representing the local phone number, while for EAZs x should be only the last digit of the Number.
	AT&F		Set all registers and profile to "factory-defaults".

AT&Lplist

Set list of phone numbers to listen on. plist is a list of wildcard patterns separated by semicolon. If this is set, it has precedence over the MSN set by AT&E.

	AT&V		Show current register settings.
	AT&W0		Write registers and EAZ/MSN to profile. (You need to run iprofd(8) for making changes permanent.)
	AT&X0		Disable BTX-Mode (default).
	AT&X1		Enable BTX-Mode.

ESCAPE SEQUENCE

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

REGISTERS

0 (default 0)

Number of rings on which the "modem" will answer. (S0=0 will disable auto answering).

1 (default 0)

Counts and stores the number of rings from an incoming call.

2 (default 43 = ’+’)

ASCII code of the escape character.

3 (default 13 = CR)

ASCII code of Carriage Return.

4 (default 10 = LF)

ASCII code of Line Feed.

5 (default 8 = BS)

ASCII code of Backspace.

6 (default 3)

Duration, in number of seconds, modem waits before dialling.

7 (default 60)

Wait time for carrier in seconds.

8 (default 2)

Pause time for comma (’,’) in dial command in seconds (ignored).

9 (default 6)

Carrier detect time in tenths of seconds (ignored).

10 (default 7)

Wait time until hangup after carrier loss in tenths of seconds (ignored).

11 (default 70)

Duration and delay in milliseconds for touch tone dialling (ignored).

12 (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.

13 (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.
5 0 = Disable extended T.70 protocol.
1 = Enable extended T.70 protocol.
6 0 = Disable RUNG message.
1 = RUNG on cancelled incoming call.
7 0 = Disable display messages from net.
1 = Enable disable messages from net.

14 (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.
10 = Analog Modem. (only if hardware supports this)
11 = Fax G3. (only if hardware supports this)

15 (default 0)

Layer-3 protocol.
0 = transparent
1 = transparent with audio features (e.g. DSP)
2 = Fax G3

16 (default 250)

Outgoing packet size / 16.

reserved.

18 (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 significant 1-bit is chosen to select the outgoing service octet. On incoming calls the selected services are accepted, contents of register 14 is ignored and the Layer-2-protocol is automatically set with the following values to match the service of the incoming call:

Incoming service audio (Reg. 20.0 = 1)

L2-protocol is set to 4 (TRANSPARENT).

Incoming service BTX (Reg. 20.1 = 1)

L2-protocol is set to 0 (X75/LAPB with I-frames).

Incoming service date (Reg. 20.2 = 1)

L2-protocol is set to 0 (X75/LAPB with I-frames).

19 (default 0)

Service-Octet-2 (ignored when using EDSS1).

20 (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.

21 (read only)

Bit-mapped register. Set on incoming call (during RING) to the value of octet 3 of calling party number Information Element (Numbering plan). See section 4.5.10 of ITU Q.931.

22 (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 4.5.10 of ITU Q.931.

23 (default 0)

Bit-mapped register.
Bit Description
0 0 = Disable CPN extended RING.
1 = Enable CPN extended RING.
1 0 = Disable CPN extended FCON.
1 = Enable CPN extended FCON.

NOTE

There used also be cui devices (major device number 44), but since the cua devices for regular tty devices are no longer supported in the kernel, these are also no longer supported for ISDN4linux.

AUTHOR

Fritz Elfert <fritz@isdn4linux.de>
modified by Paul Slootman <paul@isdn4linux.de>

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.