                Crystal Semiconductor Corporation 
                --------------------------------- 
  
  
READ.ME - OS/2 Crystal Audio Device Driver Installation Version 1.31 
------------------------------------------------------------------------------- 
This file contains information on how to install the Crystal Semiconductor 
Corporation Audio Device drivers for the CS4232. 
  
In addition to Crystal Audio driver installation, this diskette allows for 
the optional installation of IBM's MPU-401 and OPL3 MIDI drivers. 
  
The following topics are covered in this READ.ME file : 
1)  Installing on top of previous installations 
2)  System Requirements 
3)  Files List for Crystal Audio Install Disk 
4)  Crystal Audio for OS/2 Installation Procedure 
5)  Device Driver Command Line Options 
6)  Notes on Command Line Options 
7)  Using Audio in DOS and Win-OS/2 Sessions 
8)  Audio Concurrency Issues - OS/2, DOS, Win-OS/2 
9)  Plug and Play System Issues 
10) Mixer Issues 
11) MIDI Issues 
  
  
1)  Installing on top of previous installations 
------------------------------------------------------------------------------- 
Prior to installing, check if the following lines exists in CONFIG.SYS: 
    BASEDEV=CS31CONF.SYS ... 
    BASEDEV=CS32CONF.SYS ... 
    DEVICE=C:\MMOS2\CSBSAUD.SYS ... 
    DEVICE=C:\MMOS2\VCSBSAUD.SYS BSAUD1$ 
    DEVICE=C:\MMOS2\VCSGAMES.SYS BSAUD1$ 
If any of these entries are present, delete them prior to installing this 
product. 
  
  
  
2)  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 
  
  
  
3)  File List for Crystal Audio Install Disk 
------------------------------------------------------------------------------- 
Crystal Audio Files : 
BSAUDRES.DLL    -   OS/2 business audio support DLL. 
BUSAUDIO.HLP    -   Help file used during installation of Crystal Audio. 
CARDINFO.DLL    -   Crystal device support DLL. 
CONTROL.SCR     -   Installation control file. 
CONTROL.32      -   Installation control file for CS4232. 
CSBSAUD.INI     -   OS/2 audio settings. 
CSBSAUD.SYS     -   OS/2 audio physical device driver for Crystal Audio. 
CS31CONF.SYS    -   OS/2 audio configuration device driver for CS4231. 
CS32CONF.SYS    -   OS/2 audio configuration device driver for CS4232 & CS4236. 
CWAUDIO.BIN     -   OS/2 audio device microcode. 
FILES.32        -   File list for CS4232 installation. 
READ.ME         -   This file. 
VCSBSAUD.SYS    -   OS/2 audio virtual device driver for Crystal Audio. 
  
IBM OPL3 Files : 
OPL3.SYS        -   OS/2 audio physical device driver for IBM OPL3 FM MIDI. 
OPL3.HLP        -   Help file used during installation of IBM OPL3 FM MIDI. 
OPL3RES.DLL     -   IBM OPL3 device support DLL. 
OPLREAD.ME      -   Documentation for IBM OPL3 FM MIDI installation. 
		 
IBM MPU401 Files : 
MPU401.SYS      -   OS/2 audio physical device driver for IBM MPU401 MIDI. 
MPURES.DLL      -   IBM MPU401 device support DLL. 
MPUREAD.ME      -   Documentation for IBM MPU401 MIDI installation. 
  
IBM Misc. Files : 
MIDIPLAY.ICO	-   Desktop ICON for MIDI player. 
CLOCK01.SYS     -   OS/2 ISA clock driver that supports the highres timer. 
CLOCK02.SYS     -   OS/2 MCA clock driver that supports the highres timer. 
TIMER0.SYS      -   OS/2 highres timer driver. 
  
  
  
4)  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 Application Install 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). 
  
The installation program may show a single or multiple Crystal Audio device 
in the Features column.  Select the device that applies to the Crystal Audio 
device installed on your system.  Do NOT select more than one Crystal 
Semiconductor Audio device.  You may also select IBM's OPL3 and/or MPU401  
MIDI drivers for installation.  Please refer to your system documentation 
if you have hardware support for these MIDI devices.   
  
A check mark will appear next to the feature(s) selected. 
  
Click the install button to proceed with the installation.  Read and follow 
the instructions provided by the installation program.  The following files 
will be moved onto your system, based on the devices selected : 
  
  
If CS4232 is installed : 
   \MMOS2\DLL\CARDINFO.DLL 
   \MMOS2\DLL\BSAUDRES.DLL 
   \MMOS2\HELP\BUSAUDIO.HLP 
   \OS2\CS32CONF.SYS 
   \MMOS2\CSBSAUD.SYS 
   \MMOS2\VCSBSAUD.SYS 
   \MMOS2\CSBSAUD.INI 
   \MMOS2\CWAUDIO.BIN 
  
If IBM OPL3 is installed : 
	\MMOS2\OPL3.SYS 
	\MMOS2\HELP\OPL3.HLP 
	\MMOS2\DLL\OPL3RES.DLL 
  
If IBM MPU401 is installed : 
	\MMOS2\MPU401.SYS 
	\MMOS2\DLL\MPURES.DLL 
  
If either OPL3 or MPU401 are installed : 
	\MMOS2\INSTALL\MIDIPLAY.ICO 
	\OS2\BOOT\CLOCK01.SYS 
	\OS2\BOOT\CLOCK02.SYS 
	\OS2\BOOT\TIMER0.SYS 
  
  
Based on your responses to input panels, several lines will be added to the 
OS/2 CONFIG.SYS file.  If you do not know how to respond to the input panels, 
it is best to NOT change the default settings and click the OK button.  The 
following describes the modifications made to your OS/2 CONFIG.SYS file if no 
settings are modified, based on the device selected : 
  
If either CS4232 is installed : 
    BASEDEV=CS32CONF.SYS /P:534 /I:5 /D:1,1 /SB:220 /M:NONE /FM:NONE /J:NONE /CD:NONE 
    DEVICE=C:\MMOS2\CSBSAUD.SYS /N:BSAUD1$ /L:8 
    DEVICE=C:\MMOS2\VCSBSAUD.SYS BSAUD1$ 
  
If either OPL3 or MPU401 are installed : 
	BASEDEV=TIMER0.SYS 
	DEVICE=C:\MMOS2\OPL3.SYS /P:388 /N:OPL31$ 
	DEVICE=C:\MMOS2\MPU401.SYS /N:MPU4011$ 
  
  
5)  Device Driver Command Line Options 
------------------------------------------------------------------------------- 
The following tables describe the various command line options and setting 
available for the Crystal Audio device drivers.  Please refer to the READ.ME 
files for IBM's OPL3 and MPU401 drivers for descriptions of options. 
  
  
CS32CONF.SYS    -   OS/2 audio configuration device driver for CS4232. 
                    This driver is not used in the CS4231 device installations. 
  
Option/Format       Description                 Valid Values (* = Default Value) 
------------------------------------------------------------------------------- 
/P:<port>           Codec Port                  *534, 608, E84, F44 (hex) 
/I:<irq>            Codec IRQ                   *5, 7, 9, 11, 15 (decimal) 
/D:<pDMA,cDMA>      Playback,Capture DMA        0, 1, 3 (*1,1) 
/CS:<port>          Control Port                (*not required) 
/SB:<port>          Sound Blaster Port          *220, 240, NONE 
/M:<port,irq>       MPU Port                    330, *NONE 
                    MPU IRQ                     7, 9, 11, 12, 15, *NONE 
/FM:<port>          FM Port                     *388, NONE 
/J:<port>           Joystick Port               100, 200, *NONE 
/CD:<port>          CD-ROM Port                 320, 340, 360, *NONE 
/DL:<option>        Download microcode          Force, No (*not required) 
/IFM:<option>       Internal FM (CS4236 only)   *On, Off 
/O                  Override PnP settings       (*not enabled) 
/V                  Enable Verbose Display      (*not enabled) 
  
  
  
  
  
CSBSAUD.SYS     -   OS/2 audio physical device driver.  This driver supports all 
                    Crystal Audio devices. 
  
Option/Format       Description                 Valid Values (* = Default Value) 
------------------------------------------------------------------------------- 
/N:<name>           Name of PDD                 Supplied by install program (*BSAUD1$) 
/X1:<value>         AUX1 unmute/gain            0..31 (8 = 0dB)  (*not enabled - muted) 
/X2:<value>         AUX2 unmute/gain            0..31 (8 = 0dB)  (*not enabled - muted) 
/L:<value>          LINE unmute/gain            0..31 (8 = 0dB)  (*not enabled - muted) 
/R:<rate>           Enable Adj Intrpt Rate      1..60 (interrupts/sec) (*not enabled) 
/EXT                Preserve Mixer Input        (*not enabled) 
/M:<option>         Microphone Monitoring       1, On (*not enabled) 
/S:<value>          Inactivity power down       1..5 minutes (*not enabled) 
/V                  Enable Verbose Display      (*not enabled) 
  
  
  
  
  
VCSBSAUD.SYS     -  OS/2 audio virtual device driver.  This driver supports all 
                    Crystal Audio devices. 
  
Option/Format       Description                 Valid Values (* = Default Value) 
------------------------------------------------------------------------------- 
                    Name of PDD                 Supplied by install program (*BSAUD1$) 
/S                  Skip DOS Envir Var Scan     (*not enabled) 
  
  
  
  
  
6)  Notes on Command Line Options 
------------------------------------------------------------------------------- 
 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 beginning 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. 
  
  
  
  
7)  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 
  
  
  
  
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 
  
  
  
9)  Plug and Play System Issues 
------------------------------------------------------------------------------- 
The CS4232 and CS4236 are Plug and Play (PnP) compatible devices.  If the system 
contains a PnP BIOS, the command line options are ignored unless resource data is 
not available or /O override option is specified. 
  
  
  
10) Mixer Issues 
------------------------------------------------------------------------------- 
As of this release, there is no generic OS/2 mixer application for Business  
Audio.  Therefore, the volume control for devices attached to mixer LINE, AUX1, 
and AUX2 is established on the command line of the CSBSAUD.SYS driver.  Refer to 
section 5, CSBSAUD.SYS, for the format of the unmute and gain setting options. 
  
These values for gain are set on each boot and cannot be altered during system 
operation.  The command line values represent a gain setting where 8 is equal
to 0 dB gain.  Each increment is 1.5 dB.  Values greater than 8 will reduce the
volume and values less than 8 increase the volume.
  
The devices attached to LINE, AUX1, and AUX2 are system dependent and cannot be 
detailed here.  Refer to your system documentation for device configuration. 
  
Note: These settings do not effect standard wave audio volume which is controlled
by the OS/2 volume control ICON.
  
  
10) MIDI Issues 
------------------------------------------------------------------------------- 
This installation diskette allows for the optional installation of the IBM OPL3 
and MPU401 MIDI drivers.  These drivers are provided to the user as a convenience. 
Your system may or may not support MIDI audio.  Please refer to your system 
documentation for information related to your system's ability to support MIDI 
audio. 
  
