  README.DOS
  (Version 1.31)

  Thank you for purchasing the IBM ThinkPad.

  This readme file contains information related to a DOS installation
  of the IBM ThinkPad Audio Support Software.


  INSTALLATION:

  You may install the software in any directory you specify.  The
  default directory is C:\IBMAUDIO.

  The disk space required for the basic device driver installation is
  approximately 570K bytes.

  If there is insufficient disk space to install the options you have
  selected, SETUP will notify you that this has occurred.  It will then
  give you the opportunity to either change the installation drive
  or delete one or more of the options you have selected.  If there is
  still insufficient disk space, SETUP will exit.

  To install the IBM ThinkPad Audio Support Software, insert the diskette
  labeled "Audio Features Diskette" in drive A: and type A:\SETUP from
  the DOS command line.


  SETUP will create the following subdirectories under your
  install directory:

    \AUDIODD -  Device driver code for the IBM ThinkPad Audio Subsystem.
                Provides a hardware independent interface for low level
                control of waveform audio.

    \DEMO    -  Contains demo programs and sample WAV and MIDI files.

    \DIAG    -  Contains a device driver which can optionally be installed
                to test the audio subsystem when the system is powered on.

    \VDD     -  Contains support for game software.  Also contains the
                file BOOTDISK.BAT used to create a boot disk for running
                games.


  DEVICE DRIVERS:

  The following device drivers modules are installed:

     In the \AUDIODD subdirectory:

       TPAUDDD.SYS - DOS device driver


  The SETUP program adds the following line to your config.sys file:

       DEVICE=install_path\AUDIODD\TPAUDDD.SYS


  Remember, you must press Ctrl+Alt+Del to restart the machine for the
  changes to take effect.



  DEMO PROGRAM:

  The sample audio record & playback programs are located in the \DEMO
  subdirectory and consist of the following:

       TPDEMO.EXE   - DOS version sample record & playback program
       PLAYFILE.EXE - Simple DOS playback RIFF audio file program

  To run PLAYFILE.EXE enter:

       PLAYFILE <filename> <options>

  where <options> are:  /Q  - quiet. Suppress normal display output.
                        /NE - no errors.  Suppress error messages.


  The following WAV file is installed in this directory:

       DEMO16.WAV

  The following MIDI files are also installed in this directory:

       SONG1.MID
       SONG2.MID
       SONG3.MID
       SONG4.MID
       SONG5.MID
       SONG6.MID
       SONG7.MID
       SONG8.MID


  DIAGNOSTICS:

  The following hardware diagnostic device driver may be optionally
  installed:

       AUDTEST.SYS - DOS Diagnostic Device Driver

  The purpose of AUDTEST.SYS is to perform a quick check of your Audio
  Subsystem each time the system is turned on. You will notice a brief
  tune each time you turn your machine on.  This tune is AUDTEST.SYS
  completing its test.

  AUDTEST.SYS has several command line switches which are set automatically
  by the SETUP program. Generally, you should not need to modify these
  settings.  For reference, however, the command line settings are:

        /V - volume for the brief tune. The value is a percentage 0 to 100
             of the maximum volume.

        /Q - "quiet" - suppress the brief tune

        /T - set your own tune. You can customize the tune played at
             startup by appending a string of notes to the command
             line with the /T= switch. For example

                /T=OUB5R8B4C4D5R8D4C4B4A4ODG5R8G4OUA4B4A3ODG5R8G2

             will play the main theme of Beethoven's 9th Symphony.
             The rules for this string are as follows:

             1)  Each command is two characters

             2)  Up to 40 commands can be entered

             3)  Each command can be a note, a rest or an octave
                 shift.

             4)  If the first character of the command is
                 an A, B, C, D, E, F, or G the command is
                 a natural note (neither flat nor sharp)

             5)  If the first character of the command is
                 an a, b, c, d, e, f, or g the command is
                 a sharp note.

             6)  If the first character of the command is
                 an R or r the note is a rest.

             7)  The second character of the note or rest
                 determines its length:

                        0 - full note
                        1 - 3/4  note
                        2 - 1/2  note
                        3 - 3/8  note
                        4 - 1/4  note
                        5 - 3/16 note
                        8 - 1/8  note

              8)  The default octave is one above the middle.
                  That is, by default C0 is a full note C
                  one octave above middle C.

              9)  The command OU shifts up one octave.

              10) The command OD shifts down one octave. Note
                  that limitations of the built-in speaker
                  on the ThinkPad mean that notes which are
                  shifted down more than one octave may
                  not be audible.

  Here are a few sample tunes for those inclined to try customizing
  the sound of their startup:

  OS/2 MMPM Fanfare
  /T=OUC8D8E8G4E8G2

  Hungarian Rhapsody
  /T=G3OUC8d3C8B3C8D8C2

  Minuet
  /T=OUE3F8G3f8G3f8G3f8G3R8OUA3ODE4F2

  Spring
  /T=OUB4C8c8D8G4D4C4B4A3C5E2



  WARNING ABOUT PROCESSOR SPEED SETTING:

  The IBM ThinkPad provides configurable CPU speed settings of high, medium,
  and low. The selection of any setting other than high may cause some
  audio applications and features to fail.


  OS/2 2.1 DOS BOX

  It is not necessary to load the DOS driver to have audio support
  in the OS/2 2.1 DOS box. This support is provided by the normal
  OS/2 audio device driver and the VAUDIO.SYS virtual device
  driver.

  MIDI SYNTHESIZER

  The DOS audio device driver provides a software MIDI synthesizer.
  This synthesizer supports 8 melodic voices and one percussive voice.
  The synthesizer can play general MIDI files. General MIDI files
  can be played with the TPDEMO.EXE demo program.

  GAME SUPPORT

  This release provides limited support for games designed to
  work with the Adlib (tm) Roland (tm) and Sound Blaster (tm)
  products. Most games are supported at some level. This support
  is definitely intended for casual game users, not advanced
  expert game players.

  The game and synthesizer functions are simulated in system
  software. Advanced game users will notice that some games play
  more slowly than the same games played on a desktop computer
  equipped with a hardware sound device.

  Advanced users will also notice that some of the sounds are
  slightly different from the sounds made by the original game.
  These variations are due to the difference in synthesizer
  technology used.

  Most games provide a number of options for sound support. Some
  games will fail to run in some modes, but run acceptably in
  others. The priority for selecting a mode (if available) is:

        1) General MIDI mode
        2) Roland Mode
        3) Adlib Mode
        4) Sound Blaster Mode
        5) PC Speaker Mode

  Game support is provided by loading the DOS audio device driver
  TPAUDDD.SYS and the game support module SVAUDIO.EXE.

  Note: in some cases it will be necessary to re-boot your machine
  after running games before running other software. In particular,
  the machine should always be re-booted after running game
  software before starting Windows.

  For games which require expanded memory, CONFIG.SYS and AUTOEXEC.BAT
  will have to be carefully tuned. The following combination of commands
  is recommended:

        In CONFIG.SYS

           DEVICE=C:\DOS\HIMEM.SYS
           DOS=HIGH,UMB
           DEVICE=C:\DOS\EMM386.EXE RAM FRAME=C000 I=D000-E6FF
           DEVICEHIGH=C:\IBMAUDIO\AUDIODD\TPAUDDD.SYS

        In AUTOEXEC.BAT

           Load any needed drivers like MOUSE.COM high.
           In particular, load MOUSE.COM (if needed) before
           any other drivers.

        SVAUDIO.EXE can either be included in AUTOEXEC.BAT
        or started from the command prompt with the command:

           LH C:\IBMAUDIO\VDD\SVAUDIO.EXE

  Laboratory testing has also shown that some games may encounter
  fewer problems if SMARTDRV.EXE is started before the game
  is started. Others will not be helped by the presence of
  SMARTDRV.EXE. If your game plays music for a while and then
  gets stuck on a sound effect, please try starting SMARTDRV.EXE
  (available in your DOS or Windows directory) and running the
  game again.

  The BOOTDISK.BAT file can be used to create a bootable diskette
  containing CONFIG.SYS and AUTOEXEC.BAT files that conform to the
  recommended guidelines.

  As mentioned above, any processor speed setting other than HIGH
  will severely degrade the performance of games. While a little
  slowness is to be expected, if your game is running so slowly
  that action and music are almost stopped, please run PS2.EXE
  from the Utility diskette to check that your processor speed
  is set to HIGH.

  SPECIFIC GAME CONFIGURATION

  The following are some configuration suggestions to
  run some specific DOS games.

        4D Boxing       Runs best if Roland mode is
                        selected


        Alone in the    May have problems if run repeatedly
        Dark            without rebooting the machine.
                        Please reboot the machine each
                        time the game is run. Also,
                        the FILES statement needs to
                        be set to a number greater than
                        FILES=10, 20 is recommended.

        Battle Chess    This game needs expanded memory.
        4000            Please use the RAM switch with
                        EMM386.EXE as shown above.

        Carriers at     Use Sound Blaster mode
        War

        Castle of       Use Sound Blaster mode
        Dr. Brain

        Chuck Yeager's  Use Adlib or Sound Blaster mode
        Air Combat

        Civilization    Use either Sound Blaster or
                        Roland mode

        Conquered       Runs best with music set for
        Kingdoms        Roland

        Dagger of       Recommended setting is Sound
        Aman-Ra         Blaster for speech and Roland
                        for music

        Dragon's Eye    PCM sound effects are not supported
                        for this game. Music plays
                        acceptably.

        EarPlay         Use Sound Blaster mode

        EcoSaurus       Use Sound Blaster mode

        HardBall III    Use MT32 setting for music
                        and Sound Blaster for sound
                        effects.

        Headline Harry  PCM sound effects are not supported
        and the Great   for this game. Music plays
        Paper Chase     acceptably.


        Indiana Jones - Use Roland setting
        Fate of
        Atlantis

        Jack Nicklaus   Use Sound Blaster or Roland
        Golf and Course setting
        Design

        Legend of       Use Roland setting
        Kyrandia

        Lemmings        Use Sound Blaster setting

        Links - The     Select Sound Blaster mode, not
        Challenge of    Adlib mode.
        Golf

        Martian Dreams  Recommended setting is Roland
                        for music and Sound Blaster
                        for sound effects.

        Matrix Cubed    Use Roland MT32 setting

        Nova 9          Use Sound Blaster mode

        Pacific War     Use Sound Blaster mode

        Play it by EAR  Use Sound Blaster mode

        Quest for       PCM sound effects are not supported
        Glory 3         for this game. Music plays
                        acceptably.

        Secrets of the  This game runs better if
        Rain Forest     SMARTDRV.EXE is loaded.

        Secret Weapons  One small peculiarity of this
        of the          game is that it sets NumLock on
        Luftwaffe       which prevents the user from
                        entering the required codes
                        from the codewheel. To turn
                        off NumLock use Shift-NumLock.

        Spear of        Use Sound Blaster mode
        Destiny

        Street Fighter  Use Sound Blaster mode
        II

        Super Fighter   Use Sound Blaster mode

        Super Tetris    PCM sound effects are not supported
                        for this game. Music plays
                        acceptably.

        Tristan         Use Sound Blaster mode

        Trump Castle II PCM sound effects are not supported
                        for this game. Music plays
                        acceptably.

        Wayne Gretzky   This game needs expanded memory.
        Hockey 3        Please use the RAM switch with
                        EMM386.EXE as shown above.

        Where in the    Use Sound Blaster mode
        U.S.A. is
        Carmen San
        Diego

        Wolfenstein 3D  Use Sound Blaster mode



  REQUIREMENTS:

  You must be running DOS 5.02 or higher.

  The audio device driver requires HIMEM.SYS.

  This DOS driver is NOT supported in a Windows DOS box.


  -----------------

  Windows is a trademark of the Microsoft Corporation.
  Sound Blaster is a trademark of Creative Labs Inc.
  Roland is a trademark of the Roland Corporation.
  AdLib is a trademark of AdLib Inc.
