isdn_audio



isdn_audio

NAME
DESCRIPTION
AUDIO RELATED AT COMMAND SET
GENERAL BEHAVIOUR
AUDIO DATA FORMAT
AUTHOR
SEE ALSO

NAME

isdn_audio − audio extension of ttyI ISDN character devices

DESCRIPTION

This document describes the audio related extensions of the modem emulation, provided by /dev/ttyIx.

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 port speed of the ISDN tty devices is always 64000 bps.

AUDIO RELATED AT COMMAND SET

This description does not include the standard AT command set. For a description of the standard AT command set, provided by the Linux ISDN subsystem, see ttyI(4). All commands starting with AT+ except AT+FCLASS are enabled only, if audio mode is active. The following audio related AT commands are supported by ISDN tty devices:
AT+FCLASS=0

Disable audio mode (default). This command sets register 18 to 4.

AT+FCLASS=8

Enable audio mode. This command sets register 18 to 5.

AT+FCLASS=?

Show possible modes.

AT+FCLASS?

Show current mode.

AT+VNH=x

No function, provided for compatibility only.

AT+VNH=?

Always showing "1".

AT+VNH?

Always showing "1".

AT+VIP

Reset all audio parameters.

AT+VLS=x

Select line x, where x is one of the following:
0 = No device.
2 = Phone line.

AT+VLS=?

Always showing "0,2".

AT+VLS?

Show current line.

AT+VRX

Start audio recording. See below for more information.

AT+VSD=x,y

Set silence-detection parameters.
Possible parameters:
x
= 0 ... 31 sensitivity threshold level.
(default 0 , deactivated)
y
= 0 ... 255 range of interval in units of 0.1 second. (default 70)

AT+VSD=?

Show possible parameters.

AT+VSD?

Show current parameters.

AT+VSM=x

Select audio data format to x, where x is:
2 = ADPCM-2
3 = ADPCM-3
4 = ADPCM-4
5 = aLAW
6 = uLAW

AT+VSM=?

Show possible audio data formats.

AT+VSM?

Show current audio data format.

AT+VTX

Start audio playback. See below for more information.

GENERAL BEHAVIOUR

On incoming calls, if the application responds to a RING by sending ATA, depending on the calling service, the emulator responds with either CONNECT (data call) or VCON (voice call).

When starting audio playback or recording, the emulator responds with CONNECT. After that, the data transfer protocol described below is used. It is possible to initiate full duplex data transfer by issuing AT+VRX+VTX in a single command. In this case, no CONNECT message is sent to the application and the protocol described below is started immediately.

When stopping audio playback or recording, the message returned by the emulator depends on how the data transfer is stopped. If the data transfer is stopped by a remote hangup, NO CARRIER is sent to the application, while stopping data transfer with one of the DLE sequences, VCON is sent. In any case, the message is preceeded by the appropriate DLE sequence for end of audio data and/or abort respectively.

On outgoing voice calls, the emulator responds with VCON upon connection setup.

AUDIO DATA FORMAT

When recording or playing back audio data, a kind of modified bisync protocol is used. When recording audio data, the modem emulator is considered to be the sender, while the application is the receiver. When playing back, this relationship is reversed: The modem emulator acts as receiver, while the application is the sender. With the bisync protocol the character DLE (0x10) has a special meaning and is used like an escape character. It is always followed by a second character which has the following meanings defined:
ETX
(0x03)

End of audio data. This code has to be sent by the sender, indicating end of audio data.

DC4 (0x14)

Abort sending. This code has to be sent by the receiver, when it wishes to abort receiving data. The sender has to reply by stop sending data and finally indicating end of audio data.

DLE (0x10)

a single byte with value 0x10 in the data stream.

0

Touch-tone "0" received. Valid only in direction from emulator to application.

1

Touch-tone "1" received. Valid only in direction from emulator to application.

2

Touch-tone "2" received. Valid only in direction from emulator to application.

3

Touch-tone "3" received. Valid only in direction from emulator to application.

4

Touch-tone "4" received. Valid only in direction from emulator to application.

5

Touch-tone "5" received. Valid only in direction from emulator to application.

6

Touch-tone "6" received. Valid only in direction from emulator to application.

7

Touch-tone "7" received. Valid only in direction from emulator to application.

8

Touch-tone "8" received. Valid only in direction from emulator to application.

9

Touch-tone "9" received. Valid only in direction from emulator to application.

#

Touch-tone "#" received. Valid only in direction from emulator to application.

*

Touch-tone "*" received. Valid only in direction from emulator to application.

A

Touch-tone "A" received. Valid only in direction from emulator to application.

B

Touch-tone "B" received. Valid only in direction from emulator to application.

C

Touch-tone "C" received. Valid only in direction from emulator to application.

D

Touch-tone "D" received. Valid only in direction from emulator to application.

AUTHOR

Fritz Elfert <fritz@isdn4linux.de>

SEE ALSO

ttyI(4).






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.