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

            READ.ME - Crystal Audio Device Driver Installation Version 1.21
            ---------------------------------------------------------------


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


Installing on top of previous installations
-------------------------------------------
Prior to installing, check if the following lines exists in CONFIG.SYS:
BASEDEV=CS32CONF.ADD ...
DEVICE=C:\OS2\CS32CONF.SYS ...
DEVICE=C:\MMOS2\CSBSAUD.SYS ...
DEVICE=C:\MMOS2\VCSGAMES.SYS ...
If any of the above exist, delete them.


System Requirements
-------------------
Before you install Crystal Audio for OS/2, check to see if you have the
October 1994 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 should display the following value:

   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 Crystal Audio Install Disk
-----------------------------------------
   CONTROL.SCR
   BUSAUDIO.SCR
   CARDINFO.DLL
   BSAUDRES.DLL
   BUSAUDIO.HLP
   CS32CONF.SYS
   CSBSAUD.SYS
   VCSBSAUD.SYS
   READ.ME

Crystal Audio for OS/2 Installation Procedure
----------------------------------------------
To install device support, insert the Crystal Audio for OS/2 diskette in
drive A: (or whichever drive Crystal Audio for OS/2 diskette is in).
Start the multimedia installation program which is 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.

If no settings are modified, the installation program will update the
OS/2 CONFIG.SYS as follows:

   BASEDEV=CS32CONF.SYS /P:534 /I:5 /D:1,1 /SB:220 /M:NONE /O:NONE /J:NONE
                        /CD:NONE 
   DEVICE=C:\MMOS2\CSBSAUD.SYS /N:BSAUD1$
   DEVICE=C:\MMOS2\VCSBSAUD.SYS BSAUD1$

Device Driver Parameters
------------------------
+-------+---------------------------+------------------------------+----------+
|  PARM |    DESCRIPTION            |    VALID VALUES              | DEFAULT  |
+-------+---------------------------+------------------------------+----------+
|CS32CONF.SYS-------CS4232 Configuration Driver for OS/2                      |
|       NOTE:  If Crystal Audio for OS/2 is being executed on a platform      |
|              containing a Plug and Play BIOS, the command line options are  |
|              ignored unless resource data is not available.                 |
|                                                                             |
+-----------------------------------------------------------------------------+
| /P:   |  Codec Port               | 534, 608, E84, F44 (hex)     |   534    |
| /I:   |  Codec IRQ                | 5, 7, 9, 11, 15 (decimal)    |    5     |
| /D:   |  Playback,Capture DMA     | 0, 1, 3                      |   1,1    |
| /SB:  |  Sound Blaster Port       | 220, 240, NONE               |   220    |
| /J:   |  Joystick Port            | 100, 200, NONE               |   NONE   |
| /O:   |  OPL3 Port                | 330                          | Disabled |
| /M:   |  MPU Port and IRQ         | 330,9                        | Disabled |
| /CD:  |  CD-ROM Port              | 320, 330, 340, 360, NONE     |   NONE   |
| /V    |  Verbose Mode             |                              |   Off    |
| /O    |  Override PNP BIOS        |                              |          | 
+-------+---------------------------+------------------------------+----------+
|CSBSAUD.SYS--------Business Audio Physical Device Driver                     |
+-----------------------------------------------------------------------------+
| /N:   |  Name of PDD             | Supplied by Install Program  | BSAUD1$   |
| /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     |
+-------+--------------------------+------------------------------+-----------+
|VCSBSAUD.SYS-------Business Audio Virtual Device Driver                      |
+-----------------------------------------------------------------------------+
|       |  Name of PDD              | Supplied by Install Program  | BSAUD1$  |
+-------+---------------------------+------------------------------+----------+

 
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 Installation
-------------------------------
   \MMOS2\DLL\CARDINFO.DLL
   \MMOS2\DLL\BSAUDRES.DLL
   \MMOS2\HELP\BUSAUDIO.HLP
   \OS2\CS32CONF.SYS
   \MMOS2\CSBSAUD.SYS
   \MMOS2\VCSBSAUD.SYS
   \MMOS2\CSBSAUD.INI

Using Audio in DOS and Win-OS/2 Sessions
----------------------------------------

To enable Audio for DOS and Win-OS/2 sessions, you must set DOS 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.

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 system audio, use
view.exe.  Suggested viewing items are:

                VIEW /AUDIO
                VIEW /MULTIMEDIA
                VIEW /SOUNDS

