ࡱ> uvtܥhW e\TU3 $<"^ppVk dFXqvLQp K|ܻP.CS423x OS/2TM Software OEM Reference Manual  Revision 1.60 Covers Crystal Audio Drivers Version 1.60 Print Date and Time:  PRINTDATE \@ "MMMM d, yyyy" \* MERGEFORMAT September 9, 1996 PRELIMINARY  Software License Statement The software described in this manual is protected by U.S. and international copyright laws. You may not copy the software for any purpose other than making archival copies for the sole purpose of backing-up the software for protection against loss. A separate Software License may be obtained from Crystal that allows reproduction and distribution of the software. The software may not be used on two or more machines at the same time. Limit of Liability In no event will Crystal be liable to you for any consequential or incidental damages, including any lost profits or lost savings, even if a Crystal representative has been advised of the possibility of such damages, or for any claim by any party. Some states do not allow the exclusion of limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you. Information in this document is subject to change without notice. 1996 Crystal Semiconductor Corp. All rights reserved. Reproduction in any manner whatsoever without the written permission of Crystal Semiconductor Corporation is strictly forbidden. OS/2 and Warp are registered trade marks of IBM Corporation. Sound Blaster and Sound Blaster Pro are registered trade marks of Creative Labs. AdLib is a registered trade mark of AdLib Corporation All brand and product names mentioned herein are trademarks or registered trademarks of their respective holders. Crystal Semiconductor Corporation disclaims any proprietary interest in trademarks and trade names other than its own. Table Of Contents  TOC \o "1-4" Table Of Contents  GOTOBUTTON _Toc373745382  PAGEREF _Toc373745382 iii Chapter 1: Introduction  GOTOBUTTON _Toc373745383  PAGEREF _Toc373745383 1 Chapter 2: Overview  GOTOBUTTON _Toc373745384  PAGEREF _Toc373745384 2 Overview  GOTOBUTTON _Toc373745385  PAGEREF _Toc373745385 2 Resource Data  GOTOBUTTON _Toc373745386  PAGEREF _Toc373745386 2 Chapter 3: Installation  GOTOBUTTON _Toc373745387  PAGEREF _Toc373745387 2 Installing on top of previous installations  GOTOBUTTON _Toc373745388  PAGEREF _Toc373745388 2 System Requirements  GOTOBUTTON _Toc373745389  PAGEREF _Toc373745389 2 File List for Crystal Audio Install Disk  GOTOBUTTON _Toc373745390  PAGEREF _Toc373745390 3 Crystal Audio for OS/2 Installation Procedure  GOTOBUTTON _Toc373745391  PAGEREF _Toc373745391 4 Device Driver Command Line Options  GOTOBUTTON _Toc373745392  PAGEREF _Toc373745392 5 Notes on Command Line Options  GOTOBUTTON _Toc373745393  PAGEREF _Toc373745393 7 CWAUDIO.INI vs. Command line options  GOTOBUTTON _Toc373745394  PAGEREF _Toc373745394 7 CWVAUDIO.SYS /S Option  GOTOBUTTON _Toc373745395  PAGEREF _Toc373745395 7 CWAUDIO.SYS /R Option  GOTOBUTTON _Toc373745396  PAGEREF _Toc373745396 7 Using Audio in DOS and Win-OS/2 Sessions  GOTOBUTTON _Toc373745397  PAGEREF _Toc373745397 7 Audio Concurrency Issues - OS/2, DOS, Win-OS/2  GOTOBUTTON _Toc373745398  PAGEREF _Toc373745398 7 Plug and Play System Issues  GOTOBUTTON _Toc373745399  PAGEREF _Toc373745399 8 Mixer Issues  GOTOBUTTON _Toc373745400  PAGEREF _Toc373745400 8 MIDI Issues  GOTOBUTTON _Toc373745401  PAGEREF _Toc373745401 9 Web Site - where to get updated drivers  GOTOBUTTON _Toc373745402  PAGEREF _Toc373745402 9 Crystal Web Page:  GOTOBUTTON _Toc373745403  PAGEREF _Toc373745403 9 Problems/Questions  GOTOBUTTON _Toc373745404  PAGEREF _Toc373745404 9  Chapter 1: Introduction This manual describes the software package supplied with the CS423x audio codec and covers how to install and use these programs. The package includes a OS/2 driver and support programs. This manual was designed for technicians, programmers, and engineers who need reference information about the Crystal Semiconductor CS423x OS/2 Software Kit. This document provides generic information concerning the CS423x OS/2 Software Kit. For specific information refer to the release notes for the relevant release. This Software Kit can be used directly on the CRD4236-1 Audio Card and other Crystal Semiconductor reference designs and evaluation boards, including, CRD4232-1, CRD4232-2, CRD4232-3, CRD4236-3 and CRD9233-1. This Software Kit will also work with CS4237B and CS4238B audio codecs but will not take advantage of the sound enhancement features of these parts. For full details on the Crystal reference designs and evaluation boards, please refer to the relevant Crystal Data Sheet. seq chapter \hChapter 2: Overview This chapter describes the contents of the CS4232/6 OS/2 Software Kit and how to install the audio driver and support programs. Overview The software contained in the CS4232/6 OS/2 Software Kit consists of setup/installation files, OS/2 drivers and DOS support programs. Resource Data To operate correctly in a Plug & Play environment, the CS423x must be loaded with appropriate resource data. This can be achieved in several ways, the most secure of which is from an external EEPROM. Resource data and utilities are included on a separate disk. Please refer to the Crystal codec data sheet and the RESOURCE.TXT file on the CS423x Utility disk. Many of the examples and screen shots in this document will vary according to specific resource data entries. Resource data can be used to configure the Crystal codec for Plug & Play operation or to disable BIOS Plug & Play operation. On the CS423x Utilities Disk, two batch files, PNP36.BAT and NOPNP36.BAT can be found. Running these batch files will program the EEPROM with data which enables or disables BIOS Plug & Play operation respectively. Boards are generally shipped from Crystal Semiconductor with Plug & Play disabled, though this is subject to change. Note: If the EEPROM of a CS4232 is programmed, the system MUST be rebooted so that it goes through a power cycle. Chapter 3: Installation Installing on top of previous installations This installation program supports installation over previous installations of Crystal Audio device drivers as well as over-installation of IBM's OPL-3 and MPU-401 device drivers. No de-install is necessary prior to executing the OS/2 Multimedia installation program. System Requirements This installation and device drivers work on the following OS/2 systems: OS/2 Warp Version 4 ( Merlin ) OS/2 Warp Connect ( Warp - Blue box ) OS/2 Warp Fullpack ( Warp - Blue box ) OS/2 Warp Version 3 ( Warp - Red box ) In the above "Blue box" and "Red box" refer literally to the color of the retail OS/2 box. Red box => "Warp for Windows". Uses previously installed Windows 3.1 binaries for WinOS2. Blue box => "Full pack". Windows 3.1 binaries are shipped with OS/2. File List for Crystal Audio Install Disk Crystal Audio Files 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  file for overriding audio device settings. CWAUDIO.SYS  Audio physical device driver. CWINST.DLL Installation support DLLCWCONFIG.SYS  Audio device configuration device driver.CWVAUDIO.SYS  Audio virtual device driver. CONTROL.SCR  Installation control file. FILES.SCR  Installation file list. RESOURCE.SYS IBM PnP Resource Manager (Warp Only)RMVIEW.EXE IBM PnP Resource Manager (Warp Only)RMINFO.DLL IBM PnP Resource Manager (Warp Only)TIMER0.SYS IBM Highres timer driver (Warp Only)CLOCK01.SYS IBM ISA clock driver (Warp Only)CLOCK02.SYS IBM MCA clack driver (Warp Only)AUDIOIF.DLL  Updated DLL for mixer support.AMPMXMCD.DLL  Updated DLL for mixer support. IBM OPL3 Files OPL3.SYS  OS/2 audio physical device driver for 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.  WIN-OS/2 Drivers (Installed on Warp/Merlin full pack systems only) CS32BA11.DRV Windows Wave, Aux, and Mixer DriverCS32BA11.INI Wave Driver SettingsCSFM.DRV FM MIDI Synthesis DriverMIDIMAP.CFG Midimapper for FM MIDI DriverCWADD.INI Sndsys Settings For System.ini 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. 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 Crystal Audio (Pre-selected) IBM OPL-3 FM MIDI (Pre-selected) IBM MPU-401 (Not Pre-Selected) Most users will want to just "hit enter" to kick off the install. If your system has wavetable synthesis hardware, or if you have an external MIDI instrument attached to your computer, you will also wish to select the MPU-401 device driver. 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 Crystal Audio is installed : \MMOS2\DLL\BSAUDRES.DLL \MMOS2\CWAUDIO.SYS \MMOS2\CWAUDIO.INI \MMOS2\CWAUDIO.BIN \MMOS2\CWVAUDIO.SYS \OS2\BOOT\CWCONFIG.SYS If IBM OPL3 is installed : \MMOS2\OPL3.SYS \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 If system is Pre-Merlin (Pre OS/2 Warp version 4) \OS2\BOOT\RESOURCE.SYS IBM PnP resource manager \OS2\RMVIEW.EXE IBM PnP resource manager application \OS2\DLL\RMINFO.DLL IBM PnP resource manager application \OS2\BOOT\CLOCK01.SYS IBM high resolution timer support \OS2\BOOT\CLOCK02.SYS IBM high resolution timer support \OS2\BOOT\TIMER0.SYS IBM high resolution timer support \MMOS2\DLL\AMPMXMCD.DLL IBM DLL for mixer API \MMOS2\DLL\AUDIOIF.DLL IBM DLL for mixer API These lines will be added to the OS/2 CONFIG.SYS file.: BASEDEV=CWCONFIG.SYS /P:534 /I:5 /D:1,1 /SB:220 /M:330 /FM:388 /J:NONE /CD:NONE DEVICE=C:\MMOS2\CWAUDIO.SYS /N:BSAUD1$ /X1:8 /X2:8 /L:8 /LCAPT:X1 DEVICE=C:\MMOS2\CWVAUDIO.SYS BSAUD1$ If OPL-3/FM is installed: BASEDEV=TIMER0.SYS DEVICE=C:\MMOS2\OPL3.SYS /P:388 /N:OPL31$ If MPU-401 is installed: BASEDEV=TIMER0.SYS DEVICE=C:\MMOS2\MPU401.SYS /N:MPU4011$ Device Driver Command Line Options The following tables describe the various command line options and setting available for the Crystal Audio device drivers. On PnP systems, many of these command line parameters are ignored. CWCONFIG.SYS - OS/2 audio configuration device driver. Option/FormatDescriptionValid Values (* = Default Value) /A:ASIC Type (CS4231 only)OPTi928, OPTi929, MAD16, GALLANT, *NONE /P:Codec Port*534, 608, E84, F44 (hex) /I:Codec IRQ*5, 7, 9, 11, 15 (decimal) /D:Playback, Capture DMA0, 1, 3 (*1,1) /CS:Control Port(*not required) /SB:Sound Blaster Port*220, 240, NONE /M:MPU Port MPU IRQ330, *NONE 7, 9, 11, 12, 15, *NONE/FM:FM Port*388, NONE /J:Joystick Port100, 200, *NONE /CD:CD-ROM Type CD-ROM Port (CS4231 only)Sony, Mitsumi, Panasonic, *NONE 320, 330, 340, 360, *NONE/DL: