home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / q01t01a.txt < prev    next >
Text File  |  1998-09-08  |  18KB  |  419 lines
  1.                 Crystal Semiconductor Corporation 
  2.                 --------------------------------- 
  3.   
  4.   
  5. READ.ME - OS/2 Warp 3.0 Crystal Audio Device Driver Installation Version 1.53 
  6. ------------------------------------------------------------------------------- 
  7. This file contains information on how to install the Crystal Semiconductor 
  8. Corporation Audio Device drivers for the following devices: CS4232 and
  9. and CS4236. 
  10.   
  11. In addition to Crystal Audio driver installation, this diskette allows for 
  12. the optional installation of IBM's MPU-401 and OPL3 MIDI drivers.  Please
  13. view mpuread.me and oplread.me for instructions on installing the IBM MPU-401
  14. and OPL3 drivers included in this kit.
  15.  
  16.  
  17. NOTE:  This is NOT an OS/2 Merlin Install Kit.  Do not install this release
  18. in Merlin.  The same Crystal audio drivers which are installed in Merlin are
  19. installed in Warp 3.0, but the actual installation is different.   The
  20. Merlin driver kit can be obtained from http:\\www.crystal.com\.
  21.  
  22.   
  23. The following topics are covered in this READ.ME file : 
  24. 1)  Installing on top of previous installations 
  25. 2)  System Requirements 
  26. 3)  Files List for Crystal Audio Install Disk 
  27. 4)  Crystal Audio for OS/2 Installation Procedure 
  28. 5)  Device Driver Command Line Options 
  29. 6)  Notes on Command Line Options 
  30. 7)  Using Audio in DOS and Win-OS/2 Sessions 
  31. 8)  Audio Concurrency Issues - OS/2, DOS, Win-OS/2 
  32. 9)  Plug and Play System Issues 
  33. 10) Mixer Issues 
  34. 11) MIDI Issues
  35. 12) Installing Crystal Drivers In Win-OS/2
  36. 13) Problems/Questions
  37.   
  38.   
  39. 1)  Installing on top of previous installations 
  40. ------------------------------------------------------------------------------- 
  41. Prior to installing, check if the following lines exists in CONFIG.SYS: 
  42.     BASEDEV=CS31CONF.SYS ... 
  43.     BASEDEV=CS32CONF.SYS ... 
  44.     DEVICE=C:\MMOS2\CSBSAUD.SYS ... 
  45.     DEVICE=C:\MMOS2\VCSBSAUD.SYS BSAUD1$ 
  46.     DEVICE=C:\MMOS2\VCSGAMES.SYS BSAUD1$ 
  47. If any of these entries are present, delete them prior to installing this 
  48. product. 
  49.   
  50.   
  51.   
  52. 2)  System Requirements 
  53. ------------------------------------------------------------------------------- 
  54. Before you install Crystal Audio for OS/2, check to see if you have the 
  55. version of MMPM/2 as shipped with OS/2 3.0, or later, installed on your 
  56. system.  Use the SYSLEVEL command to determine which level of MMPM/2 you have 
  57. installed.  The "Current CSD Level" field displays one of the following 
  58. values: 
  59.   
  60.     UN0000  - The version of MMPM/2 as shipped with OS/2 2.1. An update 
  61.                is required. 
  62.     UN49407 - The October 1993 CSD version of MMPM/2. 
  63.                An update is required. 
  64.                This is the same version for the OS/2 2.11 service 
  65.                refresh of February 1994. 
  66.     XR03000 - The version of MMPM/2 as shipped with OS/2 Warp 3.0. 
  67.                No update is required. 
  68.   
  69. If an update is required, the MMPM/2 CSD can be obtained free from 
  70. Compuserve or from the IBM OS/2 BBS. 
  71.   
  72. CompuServe: OS/2 Support Forum: 
  73.     Library 17: mmpmcs.dsk 
  74.   
  75. IBM BBS: (919) 517-0001 
  76.     mmoscsd.dsk 
  77.   
  78.   
  79.   
  80. 3)  File List for Crystal Audio Install Disk 
  81. ------------------------------------------------------------------------------- 
  82. Crystal Audio Files :
  83. -----------------------------
  84. BSAUDRES.DLL    -   OS/2 business audio support DLL. 
  85. CARDINFO.DLL    -   Crystal device support DLL. 
  86. CWAUDIO.HLP     -   Help file used during installation. 
  87. CWAUDIO.BIN     -   Audio device microcode. 
  88. CWAUDIO.INI     -   Audio settings. 
  89. CWAUDIO.SYS     -   Audio physical device driver. 
  90. CWCONFIG.SYS    -   Audio device configuration device driver.
  91. CWVAUDIO.SYS    -   Audio virtual device driver. 
  92. CONTROL.SCR     -   Installation control file. 
  93. FILES.SCR       -   Installation file list. 
  94. READ.ME         -   This file. 
  95. AUDIOIF.DLL     -   Updated DLL for mixer support.
  96. AMPMXMCD.DLL    -   Updated DLL for mixer support.
  97. RESOURCE.SYS    -   Updated Resource Manager.
  98.  
  99. IBM OPL3 Files :
  100. -----------------------------
  101. OPL3.SYS        -   OS/2 audio physical device driver for IBM OPL3 FM MIDI. 
  102. OPL3.HLP        -   Help file used during installation of IBM OPL3 FM MIDI. 
  103. OPL3RES.DLL     -   IBM OPL3 device support DLL. 
  104. OPLREAD.ME      -   Documentation for IBM OPL3 FM MIDI installation. 
  105.          
  106. IBM MPU401 Files :
  107. -----------------------------
  108. MPU401.SYS      -   OS/2 audio physical device driver for IBM MPU401 MIDI. 
  109. MPURES.DLL      -   IBM MPU401 device support DLL. 
  110. MPUREAD.ME      -   Documentation for IBM MPU401 MIDI installation. 
  111.   
  112. IBM Misc. Files :
  113. -----------------------------
  114. MIDIPLAY.ICO    -   Desktop ICON for MIDI player. 
  115. CLOCK01.SYS     -   OS/2 ISA clock driver that supports the highres timer. 
  116. CLOCK02.SYS     -   OS/2 MCA clock driver that supports the highres timer. 
  117. TIMER0.SYS      -   OS/2 highres timer driver.
  118.  
  119. WIN-OS/2 Driver Kit
  120. -----------------------------
  121. CS32BA11.DRV    -   Windows Wave, Aux, and Mixer Driver
  122. CS32BA11.INI    -   Wave Driver Settings
  123. CSFM.DRV        -   FM MIDI Driver
  124. VSNDSYS.386     -   VXD provides for Windows Dual Boot Support
  125. MIDIMAP.CFG     -   Midimapper for FM MIDI Driver
  126. CWADD.INI        -   Sndsys Settings For System.ini
  127. CWWINOS2.CMD    -   Rexx bases script for Installing Win-OS/2
  128.   
  129. 4)  Crystal Audio for OS/2 Installation Procedure 
  130. ------------------------------------------------------------------------------- 
  131. To install device support, insert the Crystal Audio for OS/2 diskette in 
  132. drive A: (or whichever drive Crystal Audio for OS/2 diskette is in). 
  133. Start the Multimedia Application Install program which is located in the 
  134. Multimedia folder on the OS/2 desktop.  Once you are in the multimedia 
  135. installation program, select Source Drive A: (or whichever drive Crystal 
  136. Audio for OS/2 diskette is in). 
  137.   
  138. The installation program will show a two Crystal Audio devices in the 
  139. Features column: CS4231 and CS4232/CS4236.  Select the device that 
  140. applies to the Crystal Audio device installed on your system.  Do NOT select
  141. more than one Crystal Semiconductor Audio device.
  142.   
  143. A check mark will appear next to the feature(s) selected. 
  144.   
  145. Click the install button to proceed with the installation.  Read and follow 
  146. the instructions provided by the installation program.  The following files 
  147. will be moved onto your system, based on the devices selected : 
  148.   
  149. If Crystal Audio is installed : 
  150.    \MMOS2\DLL\CARDINFO.DLL 
  151.    \MMOS2\DLL\BSAUDRES.DLL 
  152.    \MMOS2\HELP\CWAUDIO.HLP 
  153.    \MMOS2\CWAUDIO.SYS 
  154.    \MMOS2\CWAUDIO.INI 
  155.    \MMOS2\CWAUDIO.BIN 
  156.    \MMOS2\CWVAUDIO.SYS 
  157.    \OS2\CWCONFIG.SYS
  158.    \OS2\BOOT\RESOURCE.SYS
  159.    \MMOS2\DLL\AUDIOIF.DLL 
  160.    \MMOS2\DLL\AMPMXMCD.DLL 
  161.  
  162. If IBM OPL3 is installed : 
  163.     \MMOS2\OPL3.SYS 
  164.     \MMOS2\HELP\OPL3.HLP 
  165.     \MMOS2\DLL\OPL3RES.DLL 
  166.   
  167. If IBM MPU401 is installed : 
  168.     \MMOS2\MPU401.SYS 
  169.     \MMOS2\DLL\MPURES.DLL 
  170.   
  171. If either OPL3 or MPU401 are installed : 
  172.     \MMOS2\INSTALL\MIDIPLAY.ICO 
  173.     \OS2\BOOT\CLOCK01.SYS 
  174.     \OS2\BOOT\CLOCK02.SYS 
  175.     \OS2\BOOT\TIMER0.SYS 
  176.   
  177. Based on your responses to input panels, several lines will be added to the 
  178. OS/2 CONFIG.SYS file.  If you do not know how to respond to the input panels, 
  179. it is best to NOT change the default settings and click the OK button.  The 
  180. following describes the modifications made to your OS/2 CONFIG.SYS file if no 
  181. settings are modified, based on the device selected : 
  182.   
  183.     BASEDEV=CWCONFIG.SYS /P:534 /I:5 /D:1,1 /SB:220 /M:NONE /FM:NONE /J:NONE /CD:NONE 
  184.     DEVICE=C:\MMOS2\CWAUDIO.SYS /N:BSAUD1$ /L:8 /X1:8 /X2:8
  185.     DEVICE=C:\MMOS2\CWVAUDIO.SYS BSAUD1$ 
  186.   
  187. If either OPL3 or MPU401 are installed : 
  188.     BASEDEV=TIMER0.SYS 
  189.     DEVICE=C:\MMOS2\OPL3.SYS /P:388 /N:OPL31$ 
  190.     DEVICE=C:\MMOS2\MPU401.SYS /N:MPU4011$ 
  191.  
  192.   
  193. 5)  Device Driver Command Line Options 
  194. ------------------------------------------------------------------------------- 
  195. The following tables describe the various command line options and setting 
  196. available for the Crystal Audio device drivers.
  197.   
  198.   
  199.   
  200. CWCONFIG.SYS    -   OS/2 audio configuration device driver.
  201.   
  202. Option/Format       Description                 Valid Values (* = Default Value) 
  203. ------------------------------------------------------------------------------- 
  204. /A:<asic type>      ASIC Type (CS4231 only)     OPTi928, OPTi929, MAD16, GALLANT, *NONE 
  205. /P:<port>           Codec Port                  *534, 608, E84, F44 (hex) 
  206. /I:<irq>            Codec IRQ                   *5, 7, 9, 11, 15 (decimal) 
  207. /D:<pDMA,cDMA>      Playback,Capture DMA        0, 1, 3 (*1,1) 
  208. /CS:<port>          Control Port                (*not required) 
  209. /SB:<port>          Sound Blaster Port          *220, 240, NONE 
  210. /M:<port,irq>       MPU Port                    330, *NONE 
  211.                     MPU IRQ                     7, 9, 11, 12, 15, *NONE 
  212. /FM:<port>          FM Port                     *388, NONE 
  213. /J:<port>           Joystick Port               100, 200, *NONE 
  214. /CD:<type,port>     CD-ROM Type (CS4231 only)   Sony, Mitsumi, Panasonic, *NONE
  215.                     CD-ROM Port                 320, 330, 340, 360, *NONE 
  216. /DL:<option>        Download microcode          Force, No (*not required) 
  217. /IFM:<option>       Internal FM (CS4236 only)   *On, Off 
  218. /O                  Override PnP settings       (*not enabled) 
  219. /V                  Enable Verbose Display      (*not enabled) 
  220.   
  221.   
  222.   
  223.   
  224.   
  225. CWAUDIO.SYS     -   OS/2 audio physical device driver.  This driver supports all 
  226.                     Crystal Audio devices. 
  227.   
  228. Option/Format       Description                 Valid Values (* = Default Value) 
  229. ------------------------------------------------------------------------------- 
  230. /N:<name>           Name of PDD                 Supplied by install program (*BSAUD1$) 
  231. /X1:<value>         AUX1 unmute/gain            0..31 (8 = 0dB)  (*not enabled - muted) 
  232. /X2:<value>         AUX2 unmute/gain            0..31 (8 = 0dB)  (*not enabled - muted) 
  233. /L:<value>          LINE unmute/gain            0..31 (8 = 0dB)  (*not enabled - muted) 
  234. /R:<rate>           Enable Adj Intrpt Rate      1..60 (interrupts/sec) (*not enabled) 
  235. /EXT                Preserve Mixer Input        (*not enabled) 
  236. /LCAPT:<source>     Line capture source         L (line), X1 (AUX1), MX (MixOut)
  237. /M:<option>         Microphone Monitoring       1, On (*not enabled) 
  238. /S:<value>          Inactivity power down       1..5 minutes (*not enabled) 
  239. /V                  Enable Verbose Display      (*not enabled) 
  240.   
  241.   
  242.   
  243.   
  244.   
  245. CWVAUDIO.SYS     -  OS/2 audio virtual device driver.  This driver supports all 
  246.                     Crystal Audio devices. 
  247.   
  248. Option/Format       Description                 Valid Values (* = Default Value) 
  249. ------------------------------------------------------------------------------- 
  250.                     Name of PDD                 Supplied by install program (*BSAUD1$) 
  251. /S                  Skip DOS Envir Var Scan     (*not enabled) 
  252.   
  253.   
  254.   
  255.   
  256.   
  257. 6)  Notes on Command Line Options 
  258. ------------------------------------------------------------------------------- 
  259.  CWAUDIO.INI vs Command line options: 
  260.  There are two ways to supply CWAUDIO.SYS with options that override default 
  261.  settings. The first method is by supplying command-line options in the 
  262.  CONFIG.SYS file as specified above. The second method is by supplying entries 
  263.  in the CWAUDIO.INI file in the \MMOS2 directory. The first method overrides 
  264.  the second on an individual entry basis. Therefore, entries in CWAUDIO.INI 
  265.  will be used only when that particular option is not specified in CONFIG.SYS. 
  266.   
  267.  CWVAUDIO.SYS /S Option:  
  268.  The CWVAUDIO.SYS driver will automatically set a 'BLASTER' DOS environment 
  269.  variable to the proper audio hardware settings.  This is done by adding a 
  270.  '@SET BLASTER=' line to the beginning of all DOS session's autoexec file. 
  271.  This file is specified in DOS session's DOS_AUTOEXEC property.  The /S option 
  272.  for CWVAUDIO.SYS will skip the automatic setting of this environment variable. 
  273.   
  274.  CWAUDIO.SYS /R Option: 
  275.  The CWAUDIO.SYS /R option will allow the user to adjust the device interrupt  
  276.  rate.  This option should be used with caution. 
  277.   
  278.   
  279.   
  280.   
  281. 7)  Using Audio in DOS and Win-OS/2 Sessions 
  282. ------------------------------------------------------------------------------- 
  283. To enable Audio for DOS and Win-OS/2 sessions, you must set DOS properties 
  284. to the following: 
  285.   
  286.     WIN_RUN_MODE                 3.1 ENHANCED COMPATIBILITY 
  287.     AUDIO_ADAPTER_SHARING        Required or Optional 
  288.     INT_DURING_IO                On 
  289.     HW_TIMER                     On 
  290.     VIDEO_SWITCH_NOTIFICATION    On 
  291.     VIDEO_8514A_XGA_IOTRAP       Off 
  292.     VIDEO_RETRACE_EMULATION      Off 
  293.     DPMI_MEMORY_LIMIT            8 
  294.   
  295.   
  296.   
  297.   
  298. 8)  Audio Concurrency Issues - OS/2, DOS, Win-OS/2 
  299. ------------------------------------------------------------------------------- 
  300. OS/2 MMPM/2 is designed such that, when an application is running in 
  301. the foreground (has focus), then that application takes priority over 
  302. others running in the background.  Background applications are put on hold 
  303. until they are placed in the foreground (have focus). 
  304.   
  305. When you have a single audio device, it is not possible for two programs 
  306. to use the device at the same time.  For example, if one application has 
  307. the device configured for audio playback, and a second application also 
  308. configures the device for audio playback, the application with the focus 
  309. takes priority and the application in the background is placed on hold. 
  310. This situation also exists for sampling rate and sample size configuration. 
  311.   
  312. Audio device drivers for Windows, installed under Win-OS/2, attempt to use 
  313. the audio device in all Windows sessions.  For Win-OS/2 sessions which do 
  314. not use the audio device, you can set the AUDIO_ADAPTER_SHARING property 
  315. to "None".  This prevents the session from accessing the audio device, and 
  316. enables the device to be used by other applications. 
  317.   
  318. To display OS/2 online documentation pertinent to system audio, use 
  319. view.exe.  Suggested viewing items are: 
  320.   
  321.     VIEW /AUDIO 
  322.     VIEW /MULTIMEDIA 
  323.     VIEW /SOUNDS 
  324.   
  325.   
  326.   
  327. 9)  Plug and Play System Issues 
  328. ------------------------------------------------------------------------------- 
  329. The CS4232 and CS4236 are Plug and Play (PnP) compatible devices.  If the system 
  330. contains a PnP BIOS, the command line options are ignored unless resource data is 
  331. not available or /O override option is specified. 
  332.   
  333.   
  334.   
  335. 10) Mixer Issues 
  336. ------------------------------------------------------------------------------- 
  337. As of this release, there is no generic OS/2 mixer application for Business  
  338. Audio.  Therefore, the volume control for devices attached to mixer LINE, AUX1, 
  339. and AUX2 is established on the command line of the CWAUDIO.SYS driver.  Refer to 
  340. section 5, CWAUDIO.SYS, for the format of the unmute and gain setting options. 
  341.   
  342. These values for gain are set on each boot and cannot be altered during system 
  343. operation.  The command line values represent a gain setting where 8 is equal
  344. to 0 dB gain.  Each increment is 1.5 dB.  Values greater than 8 will reduce the
  345. volume and values less than 8 increase the volume.
  346.   
  347. The devices attached to LINE, AUX1, and AUX2 are system dependent and cannot be 
  348. detailed here.  Refer to your system documentation for device configuration. 
  349.   
  350. Note: These settings do not effect standard wave audio volume which is controlled
  351. by the OS/2 volume control ICON.
  352.   
  353.   
  354. 11) MIDI Issues 
  355. ------------------------------------------------------------------------------- 
  356. This installation diskette allows for the optional installation of the IBM OPL3 
  357. and MPU401 MIDI drivers.  These drivers are provided to the user as a convenience. 
  358. Your system may or may not support MIDI audio.  Please refer to your system 
  359. documentation for information related to your system's ability to support MIDI 
  360. audio. 
  361.   
  362. The CS4236 Crystal Semiconductor Audio device supports an integrated FM synthesizer. 
  363. Therefore, it is recommended that you install the IBM OPL3 driver to make use of 
  364. this feature.  To do so, check both the Crystal Audio and the IBM OPL3 FM Synthesis
  365. features during Multimedia Installation.  For further information, please
  366. refer to MPUREAD.ME and OPLREAD.ME.
  367.  
  368. 12) Installing Crystal Drivers In Win-OS/2
  369. -------------------------------------------------------------------------------
  370. There are two ways to setup up Crystal drivers in Win-OS/2.  The first
  371. way is to execute the script provided in this kit, and the second way is to
  372. download Win 3.1 drivers from the Crystal Semiconductor Web Site.
  373.  
  374. CWWINOS2.CMD
  375. -----------------------------
  376. A script is provided in this install to update the Crystal WIN-OS/2 drivers.
  377. To install the drivers in WIN-OS/2 execute the following from an OS/2 command
  378. prompt:
  379.  
  380.     CWWINOS2.CMD WINOS2DIR OS2DRIVE
  381.     
  382.     where       WINOS2DIR = the WIN-OS/2 Directory (usually \OS2\MDOS\WINOS2)
  383.                 OS2DRIVE  = the Drive on which OS/2 is installed.
  384.  
  385. This script will make the following modifications:
  386.  
  387. 1.  Copy the following files
  388. WINOS2DIR\SYSTEM\CS32BA11.DRV  
  389. WINOS2DIR\CS32BA11.INI    
  390. WINOS2DIR\SYSTEM\CSFM.DRV        
  391. WINOS2DIR\SYSTEM\VSNDSYS.386     
  392. WINOS2DIR\SYSTEM\MIDIMAP.CFG     
  393.  
  394. 2.  Modify system.ini.
  395.  
  396. Please refer to section 7 for recommended WIN-OS/2 settings. 
  397.  
  398. Web Site
  399. -----------------------------
  400. The Windows 3.1 drivers can be obtained from the
  401. Crystal Web Page:  
  402. http://www.crystal.com/support/crysoft.htm
  403.  
  404. Win 3.1X drivers:
  405. w31r151b1.zip and w31r151b2.zip 
  406.  
  407. From Disk 1, run Setup.exe from within Win-OS/2.  After going thru Disk 1 and Disk2, modify the Win-OS/2 
  408. settings with those described in Section 7 above. Also, it is recommended that after running Setup, the
  409. following entry be removed from CONFIG.SYS:  DEVICE=C:\CRYSTAL\CS4232C.EXE  (Needed For Win 3.1, but not Win-OS/2).
  410.  
  411. 13)  Problems/Questions
  412. -------------------------------------------------------------------------------
  413. Please e-mail problems/questions to the following address:
  414. montalvo@crystal.cirrus.com
  415.  
  416.  
  417.  
  418.  
  419.