--------------------------------------------------------------------------------------------------------------------------- AD1816 Soundport Controller Driver for OS/2 Production Release 1.34 WARP 4.0 --------------------------------------------------------------------------------------------------------------------------- I. FILES ON THIS DISKETTE -------------------------------------------------------------------------------------------------------------------------- AD1816.HLP -Base1 Soundport controller help file AD1816.SCR - Base1 Soundport controller file list AD1816DD.SYS - Base1 Soundport controller driver AUDPLAY.ICO - Audio ICON CARDINFO.DLL - Base1 Soundport controller card info CONTROL.SCR - Install script for MINSTALL GAMEDD.SYS - Joystick driver GAMEVDD.SYS - Joystick driver JOYSTK.CH - Joystick install script JOYSTK.ICO - Joystick ICON MIDIPLAY.ICO - MIDI ICON MPU401.SYS - MPU-401 driver MPURES.DLL - MPU-401 resource DLL OPL3.HLP - OPL3 Help File OPL3.SYS - OPL3 driver OPL3RES.DLL - OPL3 resource file README.TXT - This file STARWARS.MID - Sample MIDI file M1.MID - Sample MIDI file HOTOP01.MID - Sample MIDI file 30 file(s) II. BEFORE YOU BEGIN -------------------------------------------------------------------------------------------------------------------------- Proper operation of the Analog Devices AD1815/AD1816/AD1816A Soundport Controller requires that: --You are using OS/2 Warp version 4.0 (for this version of the driver.) --The OS/2 Multimedia Extensions are installed. --The Analog Devices AD1816 driver is installed. NOTE: You must have the OS/2 Multimedia Extensions installed BEFORE you install this driver. You will use the OS/2 Multimedia Extensions to install and configure the AD1816 Soundport Controller driver. If your installation fails, you may need to update some of your OS/2 system files. See the "Troubleshooting" section for more information. III. CHECKING FOR THE OS/2 MULTIMEDIA EXTENSIONS -------------------------------------------------------------------------------------------------------------------------- Check your system for the following conditions: --If the extensions are already installed you will see the "Multimedia Setup" icon in your OS/2 System Setup folder in the OS/2 System folder on the desktop. If the extensions are already installed, skip ahead to the procedure "INSTALLING THE AD1816 SOUNDPORT CONTROLLER DRIVER." --If the "Multimedia Setup" icon is not present, OS/2 Multimedia Extensions may not yet be installed. Install the extensions using the following procedure. IV. INSTALLING THE MULTIMEDIA EXTENSIONS -------------------------------------------------------------------------------------------------------------------------- To install the Multimedia Extensions: 1.Open the "OS/2 System" folder on the OS/2 desktop. Double- click the "System Setup" icon. 2.From the "System Setup" window, double-click the "Selective Install" icon to display the "System Configuration" window. The box labeled "Multimedia Device Support" in the lower left corner of the "System Configuration" window should read "None". 3.Click the "OK" button. The "OS/2 Setup and Installation" window appears. 4.Click the box next to "Multimedia Software Support". You should now see a check mark in that box. 5.Click the "Install" button. OS/2 will begin installing the extensions. Follow all on-screen instructions, including the last one that instructs you to restart your system. Once your system has restarted, use the following procedure to install the driver for the AD1816 Soundport Controller. V. INSTALLING THE AD1816 SOUNDPORT CONTROLLER DRIVER -------------------------------------------------------------------------------------------------------------------------- To install the AD1816 Soundport Controller Driver: 1.Open the "OS/2 System" folder on the OS/2 desktop. Double- click the "System Setup" folder. Double-click the "Install/Remove" folder. Run the "Multimedia Application Install" program. 2.Insert the AD1816 Soundport Controller OS/2 4.0 Driver Diskette into your diskette drive. 3.Use the drop-down "Drive" list box to select the drive letter, A: or B:, that contains the diskette. 4.By default, the AD1816 driver installation does not install the MPU-401 support for MIDI devices (since this is not a very common installation option). If you want MPU-401 support, click the "IBM MPU-401" line to place a check mark next to it. 5.Click the "Install" button. If you receive a warning that the program will change your CONFIG.SYS file, click the "Yes" button to allow the program to make the required changes. 6.The "AD1816" window appears. This window displays the configuration information for the AD1816 Soundport Controller. Note that the AD1816 Soundport Controller has no jumpers or switches; all of the hardware configuration is from this window. 7.Click the "OK" button. You will receive several additional notifications: installation windows for several driver components, that your CONFIG.SYS file was backed up, and that the installation is complete. Click "OK" on each of these alerts. 8.Exit OS/2 and reboot your system. When you reboot your system you should hear the OS/2 start-up sounds, indicating that your audio card is properly installed and working. VI. CONFIGURING THE 3D SOUND FEATURES -------------------------------------------------------------------------------------------------------------------------- The AD1816 Soundport Controller can produce sound in simulated 3D. This feature is controlled using the card's configuration window for the default settings. If the OS/2 mixer is installed, it can also be controlled from there, or the DOS mixer can also be used. To access these settings: 1.Open the "OS/2 System" folder on the OS/2 desktop. Double- click the "System Setup" icon. 2.From its window, run "Selective Install" to display the "System Configuration" window. 3.In the "System Configuration" window, the "Multimedia Device Support" drop-down list should show the "AD1816 Soundport" as the active device. Click the square button next to the device name. 4.Click the "Device Settings" button to display the card's hardware settings.The "AD1816" window appears. This window contains controls to turn 3D effects on or off, and change the acoustic properties of the 3D simulation algorithm. 5.After you have changed the settings, click the "OK" button. The changed settings take effect immediately, and are written to your CONFIG.SYS file to be used when you start OS/2. VII. TROUBLESHOOTING -------------------------------------------------------------------------------------------------------------------------- Even though this is a PnP card, there still can be unresolved resource conflicts. This can occur if there are no more free IRQs for the card to use or if a non PnP card is using resources and the OS/2 RESERVE.SYS driver has not been updated to tell OS/2 about these legacy cards in the system. RMVIEW or the Hardware Manager in the OS/2 Setup folder can tell you what is currently being used and can help resolve any problems. VIII. PROBLEMS OBSERVED AND POSSIBLE SOLUTIONS -------------------------------------------------------------------------------------------------------------------------- This driver install is for WARP 4.0 and above only. It will not work properly for WARP 3.0 and earlier. There is a version of the install package for those systems available. VIII. KNOWN PROBLEMS IN THIS RELEASE -------------------------------------------------------------------------------------------------------------------------- There are four known problems that will be corrected in sub-sequent releases. Where required, we are working with IBM to resolve these problems as quickly and efficiently as possible. Three of the problems relate to a conflict between multimedia applications and the use of system sounds. These problems can be solved by turning off system sounds. Problem 1 The Digital Audio applet gives an error message after you: 1.Click Record. 2.Click Stop. 3.Click New. 4.Click Discard. The error message may say that either the device is busy or that there was a device error. This is a problem wih the way Digital Audio interacts with the device driver while Warp trys to play system sounds. To avoid this problem, turn off system sounds. Alternatively, close Digital Audio and restart it to continue, or save the recorded audio to a file. Problem 2 The MIDI Player Applet displays an error after you take the following steps: 1.Start playing a MIDI file using the MIDI Player applet. 2.Bring up another multimedia application, such as Master Volume or Digital Audio. 3.Click on the MIDI Player applet. 4.Close the other application. 5.Click the MIDI Player applet Start button. This is a problem wih the way MIDI Player interacts with the device driver while Warp trys to play system sounds. To avoid this problem, turn off system sounds. Problem 3 When playing a MIDI file, switching to master volume control, then back to MIDI play causes the MIDI audio to appear to be muted. This is a problem with the way Warp plays systems sounds. Turn off system sounds to avoid this problem. Problem 4 The AD1815/AD1816 audio cards are plug-and-play cards. OS/2 Warp 4 supports plug-and-play. It will enumerate the ISA PnP cards it finds, but only after first time install. If a card is removed or changed, the default is for WARP 4.0 to not update it's device list. If you ad or remove ISA PnP cards, use the F1 key while the OS/2 'white box' is in the upper left corner of the screen while booting to get the recovery choices menu. Select F5 to re-snoop the PnP cards. This can be made the default if you want, but it slows down booting the machine. If the system appears to behave strangely, that is, audio files play continuously, or the system appears to freeze, or a sound file snippet plays continuously, or other devices behave unexpectedly, some ROM setup modifications may be necessary. Most plug-and-play enabled systems have a ROM-based setup menu which allows different plug-and-play options. It may be necessary to try different plug-and-play settings within these ROM-based BIOS settings to allow proper operation of the AD1815/AD1816(A) device in certain systems. For example, a Gateway-2000 P5-133 system required setting the "Plug-and-Play Configuration" mode to "Use ICU or PnP OS" with an Operating System setting of "Other OS" in order for the AD1815 card to work properly. The AD1816 does not require this option. Other systems may require other settings in order for these cards to work properly. IX. DRIVER REFERENCE -- FOR ADVANCED USERS ONLY -------------------------------------------------------------------------------------------------------------------------- WARNING: The following information allows advanced users to adjust driver parameters. Improper use of the parameters can damage your system. DO NOT attempt to adjust parameters if you are not knowledgeable in OS/2 driver and system configuration issues. A. AD1816DD.SYS - AD1816 Soundport controller device driver This device driver initializes the AD1816 for WAV, MIDI, and Joystick operation, as specified by the device driver command line parameters. Plug-and-play resources specified by the operating system will be used. This driver also supports the WAV file format for playback and record. DEVICE=c:\mmos2\ad1816dd.sys Where is : Option - Description (Default value) ==================================================== /N:$strng$ - Device driver name assigned by MINSTALL /3:y - 3D Phase expansion (0-31) Note: For OS/2 before 4.0, there are command line arguments that describe the resources used by the driver. These arguments are ignored by the driver under 4.0. If you are using this driver with older OS/2 than 4.0, pleae get the 3.0 version of the install program that handles these arguments correctly. B. OPL3, or FM Synthesis device driver This driver provides the support required for FM synthesis through OPL3 emulation. The AD1816DD driver initializes the OPL3, and allows the OPL3 driver to control FM synthesis. DEVICE=c:\mmos2\opl3.sys /P:xxx /N:OPL31$ /P:xxx - Base address of OPL3 /N:$strng$ - Device driver name assigned by MINSTALL C. GAMEDD, or Joystick support This driver provides OS/2 Joystick support. DEVICE=c:\mmos2\gamevdd.sys DEVICE=c:\mmos2\gamedd.sys These device drivers take no parameters. D. MPU-401 Device Interface This driver provides the MPU-401 device support required for external MIDI devices. DEVICE=c:\mmos2\mpu401.sys /Pn:yyy - Base I/O: Sets the base I/O address for port n, usually 300 or 330 (# is in hex) /In:yyy - IRQ level: Sets the IRQ level for port n. yyy is a decimal number from 1 to 15. If the base I/O address for a given port is specified (e.g. /P1:300), but the IRQ is _not_ specified, the driver will attempt to autodetect the IRQ. Note that an IRQ is not used for MMPM/2 playback anyway. /L - Long name support. If specified, /L directs the driver to include the base I/O address and the IRQ in the instance name for RTMIDI Type A registration. For example, without /L the instance name might be "MPU-401 #1". With /L, it would look like "MPU-401 #1 (I/O=0330, IRQ=05)" /N:sss - Driver name, an 8-character length string, ending in a $. Do not specify a port number. Default is "MPU401$". /Q - Tells the driver to ignore errors when initializating the hardware for playback. May be necessary for some cards. /R:yyy - Resolution of MMPM/2 timing. If the highres timer (TIMER0.SYS) is installed, this parameter tells the MPU-401 driver what resolution to use (where yyy is the number of milliseconds) when playing MMPM/2 MIDI streams. Default is one millisecond. Default is 2. /V - Verbose output during boot. If used, this should be the first parameter.