
 The following device drivers and DSP code modules are located
 in this directory:

     Documentation
       README.      - This file
       AUDIODD.PRT  - Technical description of IBM Audio Device Drivers

     Sample audio record & playback program
       DEMO.BAT     - DOS command file to startup up DEMOD.EXE in DOS mode
       DEMOD.EXE    - DOS version sample record & playback program
       DEMO.CMD     - OS/2 command file to start DEMO2.EXE in OS/2 mode
       DEMO2.EXE    - OS/2 version sample record & playback program
       <SOURCE>     - subdirectory containing the source code for the
                      sample audio record & playback program.

     DOS Device Drivers
       ACPADD.SYS   - ACPA full function device driver
       ACPAK12.SYS  - ACPA waveform only device driver (no MIDI)
       MINIDD.SYS   - minimal device driver (serialization only)

     OS/2 Device Driver
       ACPADD2.SYS  - ACPA full function device driver
       VAUDIO.SYS   - VDD for OS/2 2.0
       MINIDD2.SYS  - minimal device driver (serialization only)


     M-ACPA DSP code
       IBMAUDP.DSP  - ADPCM playback (voice, music, stereo music)
       IBMAUDR.DSP  -       recording

       IBMAUDF.DSP  - ADPCM playback (high quality music)
       IBMAUDG.DSP  -       recording

       IBMAUDS.DSP  - MIDI playback

       IBMMPC.DSP   - MPC mode playback (synth + PCM + source mix)

       IBMPCMP.DSP  - PCM playback
       IBMPCMR.DSP  -     recording (except 8k)
       IBMPCMR8.DSP - PCM 8k record
       IBMPMM48.DSP - M-Motion playback

       IBMXA.DSP    - CD/XA playback

    Sample MIDI files
       SONG1.MID
       SONG2.MID
       SONG3.MID
       SONG4.MID
       SONG5.MID
       SONG6.MID
       SONG7.MID
       SONG8.MID


 In order to try out the sample audio record & playback program, you'll
 need to install the M-Audio Capture & Playback Adapter, and its corresponding
 audio device driver:

       IBM M-Audio Capture & Playback Adapter    ACPADD.SYS  (DOS wave+MIDI)
                                              or ACPAK12.SYS (DOS wave only)
                                              or ACPADD2.SYS (OS/2 wave+MIDI)

 To install the audio device driver for your audio adapter, you'll need to
 add a line to your CONFIG.SYS file:
       DEVICE=ddname 1 [A] [P]
 where 'ddname' is the full path name to your device driver, the '1' tells
 it that it is the first audio device driver, the 'A' specifies that this
 this is the first M-ACPA card installed (A thru D may be specified for the
 1st through 4th card installed), and the 'P' enables passthru of
 line-in to line-out when the M-ACPA is idle.  For example, assume that
 you have an IBM M-ACPA card installed in your machine, and that you
 have just copied all these files into a subdirectory on your C: drive
 named "audio".  The line that you would need to add to your CONFIG.SYS file
 if you are running DOS is:    DEVICE=C:\AUDIO\ACPADD.SYS 1
 or if you are running OS/2:   DEVICE=C:\AUDIO\ACPADD2.SYS 1

 After modifying your CONFIG.SYS file, you'll need to re-IPL your system.
 This is done by holding down the Alt & Ctrl keys, then pressing Del.
 Ensure that all files are in the current directory, then type "DEMO".
 We hope that you enjoy the program.


 DEMO PROGRAM OPTIONS

 To Get a full listing for the options available with the DEMOD
 and DEMO2 (OS/2) programs, type a question mark after the
 command.  For DOS and DOS box type:  DEMOD ?
                          OS/2 type:  DEMO2 ?


 PASSTHRU MODE:

 Passthru is a mode that allows an audio source connected to the Line-In
 connector of the IBM M-Audio Capture & Playback Adapter to be "passed
 through" to the Line-Out connector.  In the case of the PS/2 M57SLC this
 allows an audio source connected to the Line-In jack to be heard on the
 front panel speaker of the M57SLC.  There are 3 ways to accomplish this:

   1. A new passthru parameter P may be specified on the config.sys line
      of the M-Audio audio device driver version 1.02.  This will cause
      passthru to be active whenever no other applications are currently
      using the M-Audio card.

   2. Passthru is always active during MPC mode operation.  This mode
      allows an application to playback 11k or 22k 8 bit PCM along with
      MIDI Synthesis.

   3. Passthru can be implemented by an application using the "Source Mix"
      mode of the Audio Device Driver.  This can be run concurrently with
      any of the PCM playback modes.  In the future, Source Mix will be
      available concurrently with other modes as well.

 Note that in the first case above passthru may not be heard at the same
 time that an audio application is using the M-Audio card.

 The Audio Adapter's LL/LR out connector contains a hardware loop back
 which is used by the adapter to self test.  The output signal from the
 LL/LR out connector is fed back into the LL/LR in connector when
 there is nothing plugged into either.  When using passthru, if both
 the LL/LR in and the LL/LR out connectors are empty, you will hear
 a very tinny, echoing sound when the device driver is loaded.  This is
 due to feedback from the LL/LR out to the LL/LR in and back to the
 Speaker/Headphone connector.  To solve the problem, plug something into
 the LL/LR in or LL/LR out connector.  Any mini 3.5mm jack will do,
 including the Y cable that was shipped with the Audio Adapter.


 AUDIO DEVICE DRIVERS FOR OTHER AUDIO HARDWARE

 There are currently Audio Device Drivers available for
 the SoundBlaster, Roland MPU-401 & MPU-IMC, IBM Music Feature,
 Personal System/1 Joystick & Audio feature, and the DigiSpeech
 DS201.


 FOR MORE INFORMATION

 Contact the IBM Industry Support Center 800-241-1620 for more information.


 KNOWN PROBLEMS AND BUGS

 The following is a list of all known problems:

 1. The /U option on the demo program does not work.


 NOTES

 Applications that access the Adapter directly, instead of using
 the device driver, may cause concurrently running applications
 that use the device driver to hang.  These applications can be
 modified to run concurrently by calling the device driver to
 claim the hardware.  See the AUDIO_INIT IOCTL operation in the
 "Audio Device Drivers for IBM personal Computers" document.
 This document is found in the \AUDIODD directory with the file
 name AUDIODD.PRT.
