Crystal Semiconductor Corporation
---------------------------------
READ.ME - OS/2 Merlin Crystal Audio Device Driver Installation Version 1.53
-----------------------------------------------------------------------------
This file contains information on how to install the Crystal Semiconductor
Corporation Audio Device drivers for the following devices: CS4232 and
CS4236.
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
12) Installing Win-OS/2 Drivers
13) Installing the IBM OPL3 Driver (FM Synthesis) in Warp 4.0
14) Installing the IBM MPU-401 Driver in Warp 4.0
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 Warp 4.0 (Merlin), 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.
An 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
-----------------------------------------------------------------------------
OS/2 Driver Kit
------------------------
BSAUDRES.DLL - OS/2 business audio support DLL.
CARDINFO.DLL - Crystal device support DLL.
CWAUDIO.HLP - Help file used during installation.
CWAUDIO.BIN - Audio device microcode.
CWAUDIO.INI - Audio settings.
CWAUDIO.SYS - Audio physical device driver.
CWCONFIG.SYS - Audio device configuration device driver.
CWVAUDIO.SYS - Audio virtual device driver.
CONTROL.SCR - Installation control file.
FILES.SCR - Installation file list.
READ.ME - This file.
WIN-OS/2 Driver Kit
-----------------------------
CS32BA11.DRV - Windows Wave, Aux, and Mixer Driver
CS32BA11.INI - Wave Driver Settings
CSFM.DRV - FM MIDI Driver
VSNDSYS.386 - VXD provides for Windows Dual Boot Support
MIDIMAP.CFG - Midimapper for FM MIDI Driver
CWADD.INI - Sndsys Settings For System.ini
CWWINOS2.CMD - Rexx bases script for Installing Win-OS/2
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).
Open the OS/2 System folder on the OS/2 desktop. Next open the
Install/Remove folder. Start the Multimedia Application Install program
which is located in the Install/Remove folder. Alternatively, you can
execute MINSTALL from an OS/2 command prompt. 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 will show a two Crystal Audio devices in the
Features column: CS4232/36/37... Select the device that
applies to the Crystal Audio device installed on your system. Do NOT select
more than one Crystal Semiconductor Audio device.
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 :
\MMOS2\DLL\CARDINFO.DLL
\MMOS2\DLL\BSAUDRES.DLL
\MMOS2\HELP\CWAUDIO.HLP
\MMOS2\CWAUDIO.SYS
\MMOS2\CWAUDIO.INI
\MMOS2\CWAUDIO.BIN
\MMOS2\CWVAUDIO.SYS
\OS2\CWCONFIG.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 :
BASEDEV=CWCONFIG.SYS /P:534 /I:5 /D:1,1 /SB:220 /M:NONE /FM:NONE /J:NONE
/CD:NONE
DEVICE=C:\MMOS2\CWAUDIO.SYS /N:BSAUD1$ /L:8
DEVICE=C:\MMOS2\CWVAUDIO.SYS BSAUD1$
5) Device Driver Command Line Options
-----------------------------------------------------------------------------
The following tables describe the various command line options and setting
available for the Crystal Audio device drivers.
CWCONFIG.SYS - OS/2 audio configuration device driver.
Option/Format Description Valid Values (* = Default
Value)
-----------------------------------------------------------------------------
/A:<asic type> ASIC Type (CS4231 only) OPTi928, OPTi929, MAD16,
GALLANT, *NONE
/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:<type,port> CD-ROM Type (CS4231 only) Sony, Mitsumi, Panasonic,
*NONE
CD-ROM Port 320, 330, 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)
CWAUDIO.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
e
nabled)
/EXT Preserve Mixer Input (*not enabled)
/LCAPT:<source> Line capture source L (line), X1 (AUX1), MX
(MixOut)
/M:<option> Microphone Monitoring 1, On (*not enabled)
/S:<value> Inactivity power down 1..5 minutes (*not enabled)
/V Enable Verbose Display (*not enabled)
CWVAUDIO.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
-----------------------------------------------------------------------------
CWAUDIO.INI vs Command line options:
There are two ways to supply CWAUDIO.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 CWAUDIO.INI file in the \MMOS2 directory. The first method overrides
the second on an individual entry basis. Therefore, entries in CWAUDIO.INI
will be used only when that particular option is not specified in
CONFIG.SYS.
CWVAUDIO.SYS /S Option:
The CWVAUDIO.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 CWVAUDIO.SYS will skip the automatic setting of this environment
variable.
CWAUDIO.SYS /R Option:
The CWAUDIO.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, CS4236, and CS4237 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 CWAUDIO.SYS driver.
Refer
to
section 5, CWAUDIO.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.
11) MIDI Issues
-----------------------------------------------------------------------------
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.
The CS4236 and CS4237 Crystal Semiconductor Audio device supports an
integrated
FM
synthesizer. Therefore, it is recommended that you install the IBM OPL3
driver
to
make use of this feature.
12)Installing WIN-OS/2 Drivers
-----------------------------------------------------------------------------
A script is provided in this install to update the Crystal WIN-OS/2 drivers.
To install the drivers in WIN-OS/2 execute the following from an OS/2
command
prompt:
CWWINOS2.CMD WINOS2DIR OS2DRIVE
where WINOS2DIR = the WIN-OS/2 Directory (usually
\OS2\MDOS\WINOS2)
OS2DRIVE = the Drive on which OS/2 is installed.
This script will make the following modifications:
1. Copy the following files
WINOS2DIR\SYSTEM\CS32BA11.DRV
WINOS2DIR\CS32BA11.INI
WINOS2DIR\SYSTEM\CSFM.DRV
WINOS2DIR\SYSTEM\VSNDSYS.386
WINOS2DIR\SYSTEM\MIDIMAP.CFG
2. Modify system.ini.
Please refer to section 7 for recommended WIN-OS/2 settings.
13) Installing the IBM OPL3 Driver (FM Synthesis) in Warp 4.0
-----------------------------------------------------------------------------
The IBM OPL3 Driver install kit can be obtained from the Device
Driver Pak CD (\DRIVERS\OPL3.ZIP). To unzip this device driver,
you will need to use the PKUNZIP2.EXE program.
If you are using Warp 4, PKUNZIP2.EXE is located in
the d:\IBMCOM subdirectory, where "d:" is the drive letter where
you installed OS/2 Warp 4. If you can not find PKUNZIP2.EXE at
this location, look for it on the Device Driver PAK CD under the
subdirectory d:\TOOLS, where "d:" is the drive letter of the CDROM
drive.
After the install disk is created, run Multimedia Application Install
(Minstall), which is located in the OS/2 System/System Setup/Install-
Remove Folder. From Minstall, select the Source of your install
disk and proceed through the install.
14) Installing the IBM MPU-401 Driver in Warp 4.0
-----------------------------------------------------------------------------
The IBM MPU-401 Driver install kit can be obtained from the Device
Driver Pak CD (\DRIVERS\MPU401.ZIP). To unzip this device driver,
you will need to use the PKUNZIP2.EXE program.
If you are using Warp 4, PKUNZIP2.EXE is located in
the d:\IBMCOM subdirectory, where "d:" is the drive letter where
you installed OS/2 Warp 4. If you can not find PKUNZIP2.EXE
this location, look for it on the Device Driver PAK CD under the
subdirectory d:\TOOLS, where "d:" is the drive letter of the CDROM
drive.
After the install disk is created, run Multimedia Application Install
(Minstall), which is located in the OS/2 System/System Setup/Install-
Remove Folder. From Minstall, select the Source of your install
disk and proceed through the install.
Use Proportional Font: true