                Crystal Semiconductor Corporation
                ---------------------------------

  READ.ME - Business Audio Device Driver Installation Version 1.20
            ------------------------------------------------------

This file contains information on how to install the Crystal Semiconductor
Corporation Business Audio Device driver for OS/2.

System Requirements
-------------------
Before you install Crystal Audio for OS/2, check to see if you have the
October 1993 version, or a later level, of the MMPM/2 CSD installed on your
system (CSD stands for Corrective Service Diskette).
Use the SYSLEVEL command to determine which level of MMPM/2 you have
installed.  The "Current CSD Level" field displays one of the following
values:

   UN0000  - The version of MMPM/2 as shipped with OS/2 2.1. An update
             is required.
   UN49407 - The October 1993 CSD version of MMPM/2.
             No update is required.
             This is the same version for the OS/2 2.11 service
             refresh of February 1994.
   XR03000 - The version of MMPM/2 as shipped with OS/2 Warp 3.0.
             No update is required.

If an update is required, the MMPM/2 CSD can be obtained free from Compuserve
or from the IBM OS/2 BBS.

CompuServe: OS/2 Support Forum:
  Library 17: mmpmcs.dsk
IBM BBS: (919) 517-0001
  mmoscsd.dsk


Files List for Install Disk
---------------------------
   CONTROL.SCR
   BUSAUDIO.SCR
   BUSAUDIO.HLP
   CARDINFO.DLL
   BSAUDRES.DLL
   CS31CONF.SYS
   CSBSAUD.SYS
   VCSBSAUD.SYS
   CSBSAUD.INI
   READ.ME

Crystal Audio for OS/2 Installation Procedure
----------------------------------------------
To install device support, insert the Crystal Audio for OS/2 diskette in
drive A:.  Start the multimedia installation program, located in the
Multimedia folder on the OS/2 desktop.  Once you are in the Multimedia
installation program, select Source Drive A: (or whichever drive Crystal
Audio for OS/2 diskette is in).  Select the "Crystal Audio" icon after it
appears.

The installation program will update the OS/2 CONFIG.SYS with the following
entries (shown with default values):
   BASEDEV=CS31CONF.SYS /A:NONE /P:530 /I:11 /D:1,1 /CD:NONE
   DEVICE=C:\MMOS2\CSBSAUD.SYS /N:BSAUD1$
   DEVICE=C:\MMOS2\VCSBSAUD.SYS BSAUD1$


Device Driver Parameters
------------------------

  PARM     DESCRIPTION               VALID VALUES                   DEFAULT
+-------+--------------------------+------------------------------+----------+
|CS31CONF.SYS-------CS4231 Configuration Driver for OS/2                     |
|       NOTE:  Select NONE for the device type if no ASIC exists such as in  |
|              the Thinkpad 750C, Windows Sound System Audio Board, and      |
|              Crystal Vivaldi Audio Board.                                  |
+----------------------------------------------------------------------------+
| /A:   |  ASIC Type               | OPTi928, OPTi929,            |  NONE    |
|       |                          | MAD16, GALLANT, NONE         |          |
| /P:   |  WSS Base Port           | 530, 604, E80, F40 (hex)     |   530    |
| /I:   |  Codec Interrupt         | 7, 9, 10, 11 (decimal)       |    11    |
| /D:   |  Playback,Capture DMA    | 0, 1, 3                      |   1,1    |
| /CD:  |  CD-ROM Type,Port        | Sony, Mitsumi, Panasonic     |  NONE    |
|       |                          | 320, 330, 340, 360, NONE     |          |
| /V    |  Verbose Mode            |                              |   Off    |
+-------+--------------------------+------------------------------+----------+
|CSBSAUD.SYS--------Business Audio Physical Device Driver                    |
+----------------------------------------------------------------------------+
| /X1:  |  Unmute AUX1             | 0..31 (default 8=0dB)        |  Muted   |
| /X2:  |  Unmute AUX2             | 0..31 (default 8=0dB)        |  Muted   |
| /L:   |  Unmute LINE             | 0..31 (default 8=0dB)        |  Muted   |
| /R:   |  Enable Adj Intrpt Rate  | 1..60 (interrupts/sec)       | Disabled |
| /EXT  |  Preserve Mixer Inputs   |                              |   Off    |
| /M:   |  Microphone Monitoring   | 1, On                        |   Off    |
| /V    |  Verbose Mode            |                              |   Off    |
+-------+--------------------------+------------------------------+----------+

Notes
-----
 CSBSAUD.INI vs Command line options:
 There are two ways to supply CSBSAUD.SYS with options that override default
 settings. The first method is by supplying command-line options in the
 CONFIG.SYS file as specified above. The second method is by supplying entries
 in the CSBSAUD.INI file in the \MMOS2 directory. The first method overrides
 the second on an individual entry basis. Therefore, entries in CSBSAUD.INI
 will be used only when that particular option is not specified in CONFIG.SYS.

 CSBSAUD.SYS /R Option:
 The CSBSAUD.SYS /R option will allow the user to adjust the device interrupt 
 rate.  This option should be used with caution.


Files Copied after Install
--------------------------
   \MMOS2\DLL\CARDINFO.DLL
   \MMOS2\DLL\BSAUDRES.DLL
   \MMOS2\HELP\BUSAUDIO.HLP
   \OS2\CS31CONF.SYS
   \MMOS2\CSBSAUD.SYS
   \MMOS2\VCSBSAUD.SYS
   \MMOS2\CSBSAUD.INI

Installing on a IBM ThinkPad
----------------------------
Select "NONE" device type and ignore all other parameters. The CSBSAUD.SYS
driver auto-detects the ThinkPad and configures all parameters automatically.


Using Audio in Win-OS/2 Sessions
----------------------------------------
To enable audio for Windows sessions, you must set DOS and Windows properties
to the following:

   WIN_RUN_MODE=3.1 ENHANCED COMPATIBILITY
   AUDIO_ADAPTER_SHARING    Required or Optional
   INT_DURING_IO            On
   HW_TIMER                 On
   VIDEO_SWITCH_NOTIFICATION=ON
   VIDEO_8514A_XGA_IOTRAP=OFF
   VIDEO_RETRACE_EMULATION  Off
   DPMI_MEMORY_LIMIT=8


Audio Concurrency Issues - OS/2, DOS, Win-OS/2
----------------------------------------------
OS/2 MMPM/2 is designed such that, when an application is running in
the foreground (has focus), then that application takes priority over
others running in the background.  Background applications are put on hold
until they are placed in the foreground (have focus).

When you have a single audio device, it is not possible for two programs
to use the device at the same time.  For example, if one application has
the device configured for audio playback, and a second application also
configures the device for audio playback, the application with the focus
takes priority and the application in the background is placed on hold.
This situation also exists for sampling rate and sample size configuration.

DOS applications do not participate in MMPM/2 resource management.
When DOS and Win-OS/2 sessions use the audio device, all OS/2 programs
are unable to access the audio device.

Audio device drivers for Windows, installed under Win-OS/2, attempt to use
the audio device in all Windows sessions.  For Win-OS/2 sessions which do
not use the audio device, you can set the AUDIO_ADAPTER_SHARING property
to "None".  This prevents the session from accessing the audio device, and
enables the device to be used by other applications.

To display OS/2 online documentation pertinent to Business Audio, use
view.exe.  Suggested viewing items are:

                VIEW /AUDIO
                VIEW /MULTIMEDIA
                VIEW /SOUNDS

