home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP Eylül 1998.iso / Slackwar / docs / linux-2.0.34 / isdn / README.audio < prev    next >
Encoding:
Text File  |  1997-08-04  |  5.0 KB  |  126 lines
  1. $Id: README.audio,v 1.5 1997/02/23 23:53:46 fritz Exp $
  2.  
  3. ISDN subsystem for Linux.
  4.   Description of audio mode.
  5.  
  6. When enabled during kernel configuration, the tty emulator of the ISDN
  7. subsystem is capable of a reduced set of commands to support audio.
  8. This document describes the commands supported and the format of
  9. audio data.
  10.  
  11. Commands for enabling/disabling audio mode:
  12.  
  13.         AT+FCLASS=8      Enable audio mode.
  14.                          This affects the following registers:
  15.                            S18: Bits 0 and 2 are set.
  16.                            S16: Set to 48 and any further change to
  17.                                 larger values is blocked.
  18.         AT+FCLASS=0      Disable audio mode.
  19.                          Register 18 is set to 4.
  20.         AT+FCLASS=?      Show possible modes.
  21.         AT+FCLASS?       Report current mode (0 or 8).
  22.  
  23. Commands supported in audio mode:
  24.  
  25. All audio mode commands have the one of the following form:
  26.  
  27.         AT+Vxx?          Show current setting.
  28.         AT+Vxx=?         Show possible settings.
  29.         AT+Vxx=v         Set simple parameter.
  30.         AT+Vxx=v,v ...   Set complex parameter.
  31.  
  32. where xx is a two-character code and v are alphanumerical parameters.
  33. The following commands are supported:
  34.  
  35.         AT+VNH=x         Auto hangup setting. NO EFFECT, supported
  36.                          for compatibility only.
  37.         AT+VNH?          Always reporting "1"
  38.         AT+VNH=?         Always reporting "1"
  39.  
  40.         AT+VIP           Reset all audio parameters.
  41.  
  42.         AT+VLS=x         Line select. x is one of the following:
  43.                            0 = No device.
  44.                            2 = Phone line.
  45.         AT+VLS=?         Always reporting "0,2"
  46.         AT+VLS?          Show current line.
  47.  
  48.         AT+VRX           Start recording. Emulator responds with
  49.                          CONNECT and starts sending audio data to
  50.                          the application. See below for data format
  51.  
  52.         AT+VSD=x,y       Set silence-detection parameters.
  53.                          NO EFFECT, supported for compatibility
  54.                          only. Possible parameters:
  55.                            x = 0 ... 31
  56.                            y = 0 ... 255
  57.         AT+VSD=?         Report possible parameters.
  58.         AT+VSD?          Show current parameters.
  59.  
  60.         AT+VSM=x         Select audio data format.
  61.                          Possible parameters:
  62.                            2 = ADPCM-2
  63.                            3 = ADPCM-3
  64.                            4 = ADPCM-4
  65.                            5 = aLAW
  66.                            6 = uLAW
  67.         AT+VSM=?         Show possible audio formats.
  68.  
  69.         AT+VTX           Start audio playback. Emulator responds
  70.                          with CONNECT and starts sending audio data
  71.                          received from the application via phone line.
  72. General behavior and description of data formats/protocol.
  73.     when a connection is made:
  74.  
  75.       On incoming calls, if the application responds to a RING
  76.       with ATA, depending on the calling service, the emulator
  77.       responds with either CONNECT (data call) or VCON (voice call).
  78.       
  79.       On outgoing voice calls, the emulator responds with VCON
  80.       upon connection setup.
  81.  
  82.   Audio recording.
  83.  
  84.     When receiving audio data, a kind of bisync protocol is used.
  85.     Upon AT+VRX command, the emulator responds with CONNECT, and
  86.     starts sending audio data to the application. There are several
  87.     escape sequences defined, all using DLE (0x10) as Escape char:
  88.  
  89.     <DLE><ETX>              End of audio data. (i.e. caused by a
  90.                             hangup of the remote side) Emulator stops
  91.                             recording, responding with VCON.
  92.     <DLE><DC4>                Abort recording, (send by appl.) Emulator
  93.                             stops recording, sends DLE,ETX.
  94.     <DLE><DLE>              Escape sequence for DLE in data stream.
  95.     <DLE>0                  Touchtone "0" received.
  96.          ...
  97.     <DLE>9                  Touchtone "9" received.
  98.     <DLE>#                  Touchtone "#" received.
  99.     <DLE>*                  Touchtone "*" received.
  100.     <DLE>A                  Touchtone "A" received.
  101.     <DLE>B                  Touchtone "B" received.
  102.     <DLE>C                  Touchtone "C" received.
  103.     <DLE>D                  Touchtone "D" received.
  104.  
  105.     Currently unsupported DLE sequences:
  106.  
  107.     <DLE>c                  FAX calling tone received.
  108.     <DLE>b                  busy tone received.
  109.     <DLE>q                  quiet. Silence detected after non-silence.
  110.     <DLE>s                  silence. Silence detected from the
  111.                             start of recording.
  112.  
  113.   Audio playback.
  114.  
  115.     When sending audio data, upon AT+VTX command, emulator responds with
  116.     CONNECT, and starts transferring data from application to the phone line.
  117.     The same DLE sequences apply to this mode.
  118.  
  119.   Full-Duplex-Audio:
  120.  
  121.     When _both_ commands for recording and playback are given in _one_
  122.     AT-command-line (i.e.: "AT+VTX+VRX"), full-duplex-mode is selected.
  123.     In this mode, the only way to stop recording is sending <DLE><DC4>
  124.     and the only way to stop playback is to send <DLE><ETX>.
  125.  
  126.