  README.OS2
  (Version 1.31)

  Thank you for purchasing the IBM ThinkPad.

  This readme file contains information related to an OS/2 (TM) installation
  of the IBM ThinkPad Audio Subsystem software.


  INSTALLATION:

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

  Installation of the OS/2 audio support is handled by the
  OS/2 Multimedia Presentation Manager MINSTALL program.

        1)      Install OS/2 2.1 on your system

        2)      Install Multimedia Presentation Manager
                (which comes with OS/2 2.1) on your
                system. Select only the motion video
                application for installation. Do
                not install any of the audio cards
                shown.

        3)      Insert the ThinkPad Audio Features
                diskette into the diskette drive.

        4)      From an OS/2 command prompt type: MINSTALL

        5)      When the MINSTALL window appears, select
                drive A in the upper left-hand corner.

        6)      After selecting drive A, an icon for the
                ThinkPad audio features will appear.

        7)      Select this icon and click on install.



  Code is installed to enable you to run audio applications from an
  OS/2 or DOS session.



  MINSTALL will create the directory \IBMAUDIO under the \MMOS2
  directory.

  MINSTALL installs the following device drivers:

       TPAUDDD2.SYS  - Full function device driver
       VAUDIO.SYS    - Virtual Device Driver for OS/2 2.0 and above VDM
                       session support



  Optional parameters for the TPAUDDD2.SYS device driver are:

    DEVICE=inst_path\AUDIODD\TPAUDDD2.SYS audio# N:aaaaaaaa

    where:
            audio#   - specifies the number n (1-9) in the device driver name,
                       AUDIOn$
            N:aaaaaaaa - alternate name (1-8 chars) for the audio device
                         driver for MMPM/2


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


  DIAGNOSTICS:

  The following hardware diagnostic device driver may be optionally
  installed:

       AUDTEST2.SYS - DOS Diagnostic Device Driver

  The purpose of AUDTEST2.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 AUDTEST2.SYS
  completing its test.

  MINSTALL adds this test device driver to your CONFIG.SYS automatically.
  It can be removed if it is not wanted.

  AUDTEST2.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 make 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 limiations 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




  DEMO PROGRAMS:

  In addition to the MMPM applets the following programs are installed
  in the \MMOS2\IBMAUDIO directory. These programs run in an OS/2 DOS
  Box session.

       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.

  Note: Earlier versions of PLAYFILE.EXE did not run correctly in the
        OS/2 DOS Box.  Replace any earlier versions with this one.


  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.

  WIN-OS/2 SUPPORT

  Windows Multimedia applications are not supported under the Windows OS/2
  Desktop.

  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 or with the MMPM
  MIDI Player.

  GAME SUPPORT

  Audio support for playing games in the OS/2 2.1 DOS box is offered
  in this release on an "as is" basis. Only some games will run. The
  support is provided by the driver SVAUDIO.SYS which is installed
  automatically by MINSTALL. The user need only install and execute
  the game from an OS/2 DOS command prompt. Users should be forewarned,
  however, that making games run from the OS/2 DOS command prompt
  can be quite tricky and is likely to require extensive experimentation
  with the DOS session settings for each and every game.

  If the game can be made to run at all from an OS/2 DOS command prompt,
  it will be most likely to deliver satisfactory sound if the following
  priority is used in selecting game sound modes:

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



  KNOWN PROBLEM WITH OS/2 APM MOUSE DRIVER

  There is a known problem with the MOUSE.SYS driver which ships
  with OS/2 2.1. For the users convenience, an updated version
  of this driver is shipped on the ThinkPad Audio Options diskette.
  If you experience difficulty with audio playback after re-opening
  the cover of the ThinkPad or resuming after a suspend, please
  copy the file MOUSE.SYS from the ThinkPad Audio Options diskette
  to your d:\OS2 directory, where d: is the drive where OS/2 is
  installed.

  ADVANCED POWER MANAGEMENT AND THE OS/2 2.1 MOUSE DRIVER

  This software supports APM suspend/resume (Use of the Fn-F4 key or
  closing the lid) during audio playback.  However, there is a known
  problem with the MOUSE.SYS driver which ships with OS/2 2.1.  For the
  users convenience, an updated version of this driver is shipped on the
  ThinkPad Audio Options diskette.  If you experience difficulty with
  audio playback after re-opening the cover of the ThinkPad or resuming
  after a suspend, please copy the file MOUSE.SYS from the ThinkPad
  Audio Options diskette to your d:\OS2 directory, where d: is the
  drive where OS/2 is installed.  Also, there are some known OS/2
  problems with APM suspend/resume during PCM record.  The system may
  hang if you attempt to close the lid and open it again during an audio
  record operation.  Finally, closing the lid and opening it during the
  middle of a video playback operation will cause loss of
  synchronization between the video and audio tracks.  This
  synchronization loss is unavoidable with the current system design.

  KNOWN PROBLEM WITH OS/2 SHUTDOWN

  There is a known problem with OS/2 shutdown. Users may find that they
  need to close the MIDI Player and/or Digital Audio Player before
  executing an OS/2 shutdown.

  KNOWN PROBLEM PLAYING PCM AND MIDI CONCURRENTLY

  To play PCM and MIDI files concurrently, a line must be added to the
  MMPM2.INI file.  This file is found in the MMOS2 directory.
  In the [ibmampmixtp01] section, add the following line:

     VALIDCOMBINATIONS=1,2,2,1


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

  OS/2 is a trademark of the International Business Machines Corporation.
  Sound Blaster is a trademark of the Creative Labs Corporation.
  Windows is a trademark of the Microsoft Corporation.
  Roland is a trademark of the Roland Corporation.
  AdLib is a trademark of AdLib Inc.
