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

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

This file contains information on how to install the Crystal Semiconductor
Corporation Audio Device driver for CS4232 and CS4236 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:\MMOS2\VCSGAMES.SYS BSAUD1$
If this entries are present, delete them prior to installing this product.


System Requirements
-------------------
Before you install Crystal Audio for OS/2, check to see if you have the
version of MMPM/2 as shipped with OS/2 2.11, or later, installed on your
system.  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.
             An 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 Crystal Audio Install Disk
-----------------------------------------
   CONTROL.SCR
   BUSAUDIO.SCR
   BUSAUDIO.HLP
   CARDINFO.DLL
   BSAUDRES.DLL
   CS32CONF.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: (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
------------------------

+------------------------------------------------------------------------------+
|CS32CONF.SYS - CS4232/CS4236 Configuration Driver                             |
+------------------------------------------------------------------------------+
| PARM  |  DESCRIPTION             | VALID VALUES               | DEFAULT      |
+-------|--------------------------|----------------------------|--------------+
| /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          |
| /M:   | MPU Port and IRQ         | 330,9, NONE                | NONE         |
| /O:   | OPL3 Port                | 388, NONE                  | NONE         |
| /J:   | Joystick Port            | 200, 100, NONE             | NONE         |
| /CS:  | Control Port             | 538, 108, 110              | 538          |		
| /CD:  | CD-ROM Port              | 320, 340, 360, NONE        | NONE         |
| /DL:  | Download microcode       | Force, No                  | not required |
| /IFM: | Internal FM (CS4236 only)| On, Off                    | On           |
| /O    | Override PnP settings    |                            | Off          |
| /V    | Verbose Mode             |                            | Off          |
+------------------------------------------------------------------------------+

+------------------------------------------------------------------------------+
|CSBSAUD.SYS - Business Audio Physical Device Driver                           |
+------------------------------------------------------------------------------+
| PARM  |  DESCRIPTION             | VALID VALUES               | DEFAULT      |
+-------|--------------------------|----------------------------|--------------+
| /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   |                            | Off          |
| /V    |  Verbose Mode            |                            | Off          |
+------------------------------------------------------------------------------+

+------------------------------------------------------------------------------+
|VCSBSAUD.SYS - Business Audio Virtual Device Driver                           |
+------------------------------------------------------------------------------+
| PARM  |  DESCRIPTION             | VALID VALUES               | DEFAULT      |
+-------|--------------------------|----------------------------|--------------+
|       |  Name of PDD             | Supplied by Install Program| BSAUD1$      |
| /S    |  Skip DOS Envir Var Scan |                            | Off          |
+------------------------------------------------------------------------------+

Notes
-----
 CS32CONF.SYS and PnP systems:
 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 or /O override option is specified.                                           |

 Enabling FM Synthesis:
 If you have an OS/2 FM driver, you can enable FM by using /O:388. 
 To unmute the FM mixer in the CRD4232-1, add the /L option in 
 CSBSAUD.SYS.  

 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.

 VCSBSAUD.SYS /S Option: 
 The VCSBSAUD.SYS driver will automatically set a 'BLASTER' DOS environment
 variable to the proper audio hardware settings.  This is done by adding a
 '@SET BLASTER=' line to the begining of all DOS session's autoexec file.
 This file is specified in DOS session's DOS_AUTOEXEC property.  The /S option
 for VCSBSAUD.SYS will skip the automatic setting of this environment variable.

 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


Setting UP For MIDI 
===================
Basically, to get MIDI in OS/2 the following has to occur:

	1. The MPU401 device has to be configured by either a, b, or c:
		a. Plug and Play BIOS based on eeprom PNP resources
                            or BIOS plug and play resources for CS4232/CS4236.
	                This is provided template.ini is used (full resources) and 
		    the PnP BIOS is a known good PnP BIOS.
		b.  By using the command line options  /O /M:330,9 CS4232/4236 Configuration  		     driver CS32CONF.SYS to override PnP configuration and default to using 		     command line values in cs32conf.sys on a Plug and Play System.	 
		c.  By using the command line option /M:330,9 in the OS/2                                                           		     CS4232/4236 Configuration driver CS32CONF.SYS 
		     on a Non Plug and Play System or a Plug and Play System with null 		     resources.	
	
	2.  The MPU-401 driver has to be obtained from IBM.  Crystal is using Mpu-401 Kit 	     Version 1.0.0.  This installation will create an ICON on the OS/2 desktop with the 	     appropriate midi mapping, and it will install the necessary drivers in confg.sys.
	
	3.  Since we do not have an full blown input panel for controlling the input selector in the 	     	     CS4232, the only way to hear MIDI is to unmute the line mixer by using /L in the 	     command line for CSBSAUD.SYS, the OS/2 Physical Device Driver.

	4.  Have an MPU-401 Wave table attached to the CS4232/CS4236.

Setting Up For FM Synthesis
===========================
To get FM Synthesis to play  (either OPL3 or Internal FM Synthesis on CS4236):

	1. The OPL3 device or Internal FM  has to be configured by either a, b, or c:
		a. Plug and Play BIOS based on eeprom PNP resources
                            or BIOS plug and play resources for CS4232/CS4236.
	                This is provided template.ini is used (full resources) and 
		    the PnP BIOS is a known good PnP BIOS.  
		b.  By using the command line options  /O /O:388 CS4232/4236 Configuration  		    driver CS32CONF.SYS to override PnP configuration and default to using 		    command line values in cs32conf.sys on a Plug and Play System.	 
		c.  By using the command line option /0:388 in the OS/2                                                           		     CS4232/4236 Configuration driver CS32CONF.SYS 
		     on a Non Plug and Play System or a Plug and Play System with null 		    resources.	
	
	2.  The OPL3 driver has to be obtained from IBM.  Crystal is using OPL3 Kit Version 	    	     1.0.0.    This installation will create an ICON on the OS/2 desktop with the appropriate 	     	     midi  mapping, and it will install the necessary drivers for it in config.sys.
	
	3.  Since we do not have a full blown input panel for controlling the input selector in the                  	     CS4232, the only way to hear FM is to unmute the line mixer by using /L in the 	 	     command line for CSBSAUD.SYS, the OS/2 Physical Device Driver.



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

