home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / 3DSOS2.ZIP / README.TXT < prev    next >
Text File  |  1996-11-21  |  14KB  |  332 lines
  1. C o n t e n t s
  2.  
  3. A.  Overview
  4. B.  Release Notes
  5. C.  System Requirements
  6. D.  Included Files
  7. E.  Driver Installation
  8. F.  Trouble Shooting
  9. G.  Problems In This Release
  10.  
  11. ----------------------------------------------------------------------------
  12. A.  O v e r v i e w
  13.  
  14. This README.TXT contains instructions to install and configure the OS/2 Wrap
  15. 3.0 driver for the 3D WebSound.
  16.  
  17. ----------------------------------------------------------------------------
  18. B.  R e l e a s e   N o t e s
  19.  
  20. This release of the OS/2 Wrap 3.0 driver supports the following features on
  21. the 3D WebSound.
  22.  
  23. 1.  MPC Level 3 Mixer
  24. 2.  Digital Mixer
  25. 3.  WSS Codec
  26. 4.  SBPro Codec
  27. 5.  Game Port
  28. 6.  MIDI Port
  29. 7.  I2S1
  30. 8.  3D Sound Control
  31.  
  32. The following features are NOT supported by this release:
  33.  
  34. 1.  Extra Logical Device
  35. 2.  DSP Serial Port
  36. 3.  Power Management
  37. 4.  I2S0
  38.  
  39. This driver is designed to run under OS/2 wrap 3.0 only. If you install a
  40. version below the requirement. We encourage you to upgrade your OS/2 system.
  41. If you install the OS/2 merlin, the driver shall be ready for a few weeks.
  42.  
  43. ----------------------------------------------------------------------------
  44. C.  S y s t e m   R e q u i r e m e n t s
  45.  
  46.   - 80486 PC-AT compatible or faster machine.
  47.   - 8 MB DRAM or greater.
  48.   - 1 free 16-bit ISA-bus expansion slot.
  49.   - 400 KB free hard disk space for minimum software installation.
  50.   - IBM OS/2 Wrap 3.0
  51.  
  52. ----------------------------------------------------------------------------
  53. D.  I n c l u d e d   F i l e s
  54.  
  55. AD1816DD.SYS    - AD1816 Soundport controller driver
  56. AD1816DD.SYM    - AD1816 Driver symbols file
  57. CARDINFO.DLL    - AD1816 Soundport controller card
  58.           information file
  59. AD1816.HLP    - AD1816 Soundport controller help file
  60. AD1816.SCR    - AD1816 Soundport controller driver file
  61.           list
  62. CONTROL.SCR    - Install script for MINSTALL
  63. README.TXT    - This file
  64.  
  65. UPDTCLK.BAT    - Batch file for updating timer basedevs
  66. RSTRCLK.BAT    - Batch file for restoring timer basedevs
  67.  
  68. MPU401.SYS    - MPU-401 driver
  69. MPURES.DLL    - MPU-401 resource DLL
  70.  
  71. AUDPLAY.ICO    - Audio ICON
  72. MIDIPLAY.ICO    - MIDI ICON
  73. JOYSTK.ICO    - Joystick ICON
  74.  
  75. OPLRES.DLL    - OPL3 resource file
  76. OPL3.DLL    - OPL3 driver
  77. OPL3.HLP    - OPL3 Help File
  78.  
  79. CLOCK01.SYS    - Timer driver
  80. CLOCK02.SYS    - Timer driver
  81. TIMER0.SYS    - Timer driver
  82.  
  83. GAMEDD.SYS    - Joystick driver
  84. GAMEVDD.SYS    - Joystick driver
  85. JOYSTK.CH    - Joystick install script
  86.  
  87. ----------------------------------------------------------------------------
  88. E.  D r i v e r   I n s t a l l a t i o n
  89.  
  90. Before You Begin.
  91.  
  92.     Proper operation of the 3D WebSound board requires that:
  93.  
  94.     --You are using OS/2 Warp version 3.
  95.     --The OS/2 Multimedia Extensions are installed.
  96.     --The 3D WebSound driver is installed.
  97.  
  98.     NOTE: You must have the OS/2 Multimedia Extensions installed BEFORE you
  99.     install this driver. You will use the OS/2 Multimedia Extensions to
  100.     install and configure the 3D WebSound driver.
  101.  
  102.     If your installation fails, you may need to update some of your OS/2
  103.     system files. See the "Trouble Shooting" section for more information.
  104.  
  105. Check for the OS/2 Multimedia Extensions.
  106.  
  107.     If the extensions are already installed, you will see the "Multimedia"
  108.     icon on your OS/2 desktop. If the extensions are already installed,
  109.     skip ahead to the procedure "Installing the 3D WebSound Driver".
  110.  
  111.     If the "Multimedia" icon is not visible, OS/2 Multimedia Extensions
  112.     may not yet be installed. Install the extensions using the following
  113.     procedure.
  114.  
  115. Install the Multimedia Extensions.
  116.  
  117. 1.  Open the "OS/2 System" folder on the OS/2 desktop. Double-click the
  118.     "System Setup" icon.
  119.  
  120. 2.  From the "System Setup" window, double-click the "Selective Install"
  121.     icon to display the "System Configuration" window. The box labeled
  122.     "Multimedia Device Support" in the lower left corner of the "System
  123.     Configuration" window should read "None". We will install the sound
  124.     board driver later.
  125.  
  126. 3.  Click the "OK" button. The "OS/2 Setup and Installation" window
  127.     appears.
  128.  
  129. 4.  Click the box next to "Multimedia Software Support". You should now
  130.     see a check mark in that box.
  131.  
  132. 5.  Click the "Install" button. OS/2 will begin installing the extensions.
  133.     Follow all on-screen instructions, including the last one that instructs
  134.     you to restart your system. Once your system has restarted, use the
  135.     following procedure to install the driver for the 3D WebSound board.
  136.  
  137. Installing the 3D WebSound Driver.
  138.  
  139. 1.  Double-click the "Multimedia" folder icon on the OS/2 desktop. run the
  140.     "Multimedia Application Install" program.
  141.  
  142. 2.  Insert the 3D WebSound Driver Diskette into your diskette drive.
  143.  
  144. 3.  Use the drop-down "Drive" list box to select the drive letter, A: or B:,
  145.     that contains the diskette. Then choose "OS2" in the "Path" list box.
  146.  
  147. 4.  Click the "Analog Devices AD1816" line to place a check mark next to
  148.     the selection. By default, the 3D WebSound driver installation does
  149.     not install the MPU-401 support for MIDI devices (since this is not a
  150.     very common installation option). You you want MPU-401 support, click
  151.     the "IBM MPU-401" line to place a check mark next to it.
  152.  
  153. 5.  Click the "Install" button. If you receive a warning that the program
  154.     will change your CONFIG.SYS file, click the "Yes" button to allow the
  155.     program to make the required changes.
  156.  
  157. 6.  The "Analog Devices AD1816" window appears. This window displays the
  158.     configuration information for the 3D WebSound board. Adjust the
  159.     configuration information if they are conflicted.
  160.  
  161. 7.  Click the "OK" button. You will receive several additional notifications:
  162.     installation windows for several driver components, that your CONFIG.SYS
  163.     file was backed up, and that the installation is complete. Click "OK" on
  164.     each of these alerts.
  165.  
  166. 8.  Exit OS/2 and reboot your system. When you reboot your system, you should
  167.     hear the OS/2 start-up sounds, indicating that the 3D WebSound board is
  168.     properly installed and working.
  169.  
  170. Configuring the 3D Sound Features:
  171.  
  172. The 3D WebSound board can produce sound in simulated 3D. This feature is
  173. controlled using the card's configuration window. To access these settings:
  174.  
  175. 1.  Open the "OS/2 System" folder on the OS/2 desktop. Double-click the
  176.     "System Setup" icon.
  177.  
  178. 2.  From its window, run "Selective Install" to display the "System
  179.     Configuration" window.
  180.  
  181. 3.  In the "System Configuration" window, the "Multimedia Device Support"
  182.     drop-down list should show the "Analog Device AD1816 Soundport" as the
  183.     active device. Click the square button next to the device name.
  184.  
  185. 4.  Click the "Device Settings" button to display the card's hardware
  186.     settings. The "Analog Devices AD1816" window appears. This window
  187.     contains controls to turn 3D effects on or off, and change the
  188.     acoustic properties of the 3D simulation algorithm.
  189.  
  190. 5.  After you have changed the settings, click the "OK" button. The changed
  191.     settings take effect immediately, and are written to your CONFIG.SYS
  192.     file to be used when you start OS/2.
  193.  
  194. ----------------------------------------------------------------------------
  195. F.  T r o u b l e   S h o o t i n g
  196.  
  197. A majority of problems observed with the 3D WebSound drivers for OS/2 wrap
  198. version 3 are caused by inconsistent versions of the following system
  199. files: CLOCK01.SYS, CLOCK02.SYS, TIMER0.SYS, and OPL3.SYS. Before continuing,
  200. make sure that your versions of these system files match the 3D WebSound
  201. driver install diskette files:
  202.  
  203.     \OS2\BOOT\CLOCK01.SYS
  204.     \OS2\BOOT\CLOCK02.SYS
  205.     \MMOS2\TIMER0.SYS
  206.     \MMOS2\OPL3.SYS
  207.  
  208. This is done by visually comparing the file time, date, and size for each
  209. one of the files listed above against the same filename on the driver
  210. install diskette.
  211.  
  212. If your files do not match the versions on the diskette, then either copy
  213. the diskette files over the files on your system, or use the UPDTCLK.CMD
  214. or UPDTCLK.BAT command files to update your system files.
  215.  
  216. Note that this command file saves a copy of CLOCK01.SYS and CLOCK02.SYS to
  217. CLOCK01.WRP and CLOCK02.WRP respectively. Do not overwrite or delete these
  218. files as these files can be used to restore your original configuration,
  219. if required. Use the RSTRCLK.BAT command file to restore your original
  220. CLOCK01.SYS and CLOCK02.SYS drivers in the \OS2\BOOT directory.
  221.  
  222. ----------------------------------------------------------------------------
  223. G.  P r o b l e m s   I n   T h i s   R e l e a s e
  224.  
  225. Problems Observed and Possible Solutions:
  226. 1.  Exception in device driver: CLOCK$
  227.     TRAP 00d
  228.  
  229.     This problem is due to mismatched or inconsistent revision levels of
  230.     CLOCK01.SYS, CLOCK02.SYS, and and TIMER0.SYS drivers installed on
  231.     your system. Make sure that the CLOCK01.SYS, CLOCK02.SYS and TIMER0.SYS
  232.     drivers from the AD1816DD.SYS driver install diskette are copied into
  233.     the proper subdirectories of the system. Make sure that the CLOCK01.SYS
  234.     and CLOCK02.SYS has its read-only attributes reset. Use ATTRIB CLOCK0?.SYS
  235.     to view the attributes, and ATTRIB -r to reset the read-only attributes,
  236.     if required. To install the files:
  237.  
  238.     Copy CLOCK01.SYS to \OS2\BOOT
  239.     Copy CLOCK02.SYS to \OS2\BOOT
  240.     Copy TIMER0.SYS to \MMOS2
  241.  
  242.     Or, use the UPDTCLK.BAT command file to update these drivers.
  243.  
  244. 2.  MINSTALL Display "MMPM/2 Copy Failed File in Use" while doing install
  245.  
  246.     This problem is due to some CLOCK01.SYS and CLOCK02.SYS files having the
  247.     read-only attribute set. Use OS/2's ATTRIB.EXE utility to reset the
  248.     read-only attribute for these files. Note that on some versions of Warp,
  249.     an option is presented to retry the operation, and when a retry is
  250.     attempted, the copy appears to have succeeded, and in fact fails.
  251.     This problem may manifest itself as a trap when trying to play a MIDI file
  252.     (see TRAP in CLOCK$ driver when opening MIDI player). If you see this
  253.     problem, be sure to check the files CLOCK01.SYS and CLOCK02.SYS in the
  254.     \OS2\BOOT subdirectories to make sure that these were properly copied
  255.     from the install diskette.
  256.  
  257. 3.  When performing a shutdown while the MIDI player is still open, the
  258.     system hangs.
  259.  
  260.     This problem is due to mismatched CLOCK01.SYS, CLOCK02.SYS, and TIMER0.SYS
  261.     drivers. Use the procedure described above to correct this problem.
  262.  
  263. 4.  When playing a MIDI file, switch to Audio Player, then back to MIDI player.
  264.     No audio is heard, and an error occurs when start, pause, or stop.
  265.  
  266.     This problem is due to an inconsistent version of OPL3 with the version
  267.     OS/2 wrap 3 and the TIMER0.SYS set of drivers. Use the procedure
  268.     described above to correct this problem.
  269.  
  270. List of Known Problems:
  271.  
  272. This driver is a Beta-level release. There are four known problems that we
  273. are working to correct. Where required, we are working with IBM to resolve
  274. these problems as quickly and efficiently as possible. Three of the problems
  275. relate to a conflict between multimedia applications and the use of system
  276. sounds. These problems can be solved by turning off system sounds.
  277.  
  278. Problem 1
  279.     The Digital Audio applet gives an error message after you:
  280.     1. Click Record.
  281.     2. Click Stop.
  282.     3. Click New.
  283.     4. Click Discard.
  284.  
  285.     The error message may say that either the device is busy or that there
  286.     was a device error. This is a problem wih the way Digital Audio interacts
  287.     with the device driver while Warp trys to play system sounds. To avoid
  288.     this problem, turn off system sounds. Alternatively, close Digital Audio
  289.     and restart it to continue, or save the recorded audio to a file.
  290.  
  291. Problem 2
  292.     The MIDI Player Applet displays an error after you take the following
  293.     steps:
  294.     1. Start playing a MIDI file using the MIDI Player applet.
  295.     2. Bring up another multimedia application, such as Master Volume or
  296.        Digital Audio.
  297.     3. Click on the MIDI Player applet.
  298.     4. Close the other application.
  299.     5. Click the MIDI Player applet Start button.
  300.  
  301.     This is a problem wih the way MIDI Player interacts with the device
  302.     driver while Warp trys to play system sounds. To avoid this problem, turn
  303.     off system sounds.
  304.  
  305. Problem 3
  306.     When playing a MIDI file, switching to master volume control, then back
  307.     to MIDI play causes the MIDI audio to appear to be muted.
  308.  
  309.     This is a problem with the way Warp plays systems sounds. Turn off the
  310.     system sounds to avoid this problem.
  311.  
  312. Problem 4
  313.     The 3D WebSound boards are plug-and-play cards. Since OS/2 Wrap 3 does
  314.     not support plug-and-play, the Warp 3 driver for these cards needs to
  315.     set the resources according to what resources the user knows is not
  316.     being used. In a few cases, the system BIOS does not support plug-and-play
  317.     BIOS enumeration in cooperation with a non plug-and-play enabled operating
  318.     system, such as Warp 3. This is complicated by the fact that since the
  319.     3D WebSound devices are not critical to system operation (such as a hard
  320.     disk controller, or graphics controller) the card is not enabled by the
  321.     BIOS. In some cases, the system plug-and-play BIOS does not properly
  322.     setup system resources to coexist with the 3D WebSound device. If the
  323.     system appears to behave strangely, that is, audio files play continuously,
  324.     or the system appears to freeze, or a sound file snippet plays
  325.     continuously, or other devices behave unexpectedly, some ROM setup
  326.     modifications may be necessary. Most plug-and-play enabled systems have a
  327.     ROM-based setup menu which allows different plug-and-play options. It may
  328.     be necessary to try different plug-and-play settings within these ROM-
  329.     based BIOS settings to allow proper operation of 3D WebSound board in
  330.     certain systems.
  331.  
  332.