* Ad Lib Gold Mixer and Windows Drivers, Version 1.2           (July 1993)
*****************************************************
    
    This document will instruct you on how to install the Ad Lib Gold
    Mixer and drivers for Windows 3.1 (found on the diskette entitled
    "Windows 3.1 Mixer and Drivers").


* Contents of the diskette 
***************************
    
    There are 2 separate  Ad Lib Gold Windows Drivers. Each of the
    driver covers separate aspects of the Ad Lib Gold multimedia
    capabilities.

    The first driver, called the Yamaha GSS Midi Synth, is used by
    Windows to play back MIDI data using the internal synthesizer of
    the Ad Lib Gold Card (which uses an FM synthesizer). Once loaded,
    this driver will install a special configuration applet in the
    Control Panel. 

    The second driver, called the Yamaha GSS Wave/Midi/Aux driver,
    covers all other multimedia capabilities of the Gold Card.  The
    Wave section enables digitized sound playback under Windows for all
    applications that use wave files (such as the Sound Recorder,
    StudioSonic 8 or the System Sounds).  The MIDI section is used to
    play back and record MIDI data through the Ad Lib Gold MIDI Port. 
    Finally, the AUX section of the driver provides the applications
    with a mechanism to dynamically control the various mixer controls
    (volume, bass, treble) of the Gold Card.


* Ad Lib Gold Mixer for Windows
*******************************

    You can use this application to control the Ad Lib Gold card's
    programmable mixer.


* Configuration file for Windows MIDI Mapper
********************************************

    This configuration file can be used to replace your current MIDI
    mapper configuration with setups that make optimal use of the Gold
    Card's capabilities.


* Installing the Software
*************************

* Configuring the Gold Card

    In order for the drivers to function properly, an interrupt and at
    least one DMA channel must have been allocated to the Gold card. 
    To allocate an interrupt and DMA channel, use the Gold Setup
    program, supplied on the Gold program disks, under DOS.

    You should take note of the interrupt line (IRQ) and DMA channel
    that you've selected.  This information will be needed when
    installing the Yamaha GSS Wave/Midi/Aux driver.

* Installing the drivers

    To install the drivers, you will need to activate the "Drivers"
    applet found in the "Control Panel" (you'll find this last one in
    the "Main" program group).

    This is where you will add the new Ad Lib Gold Windows Drivers:

    Click on the "Add..." button.  You will be shown a list of the
    available drivers that can be added to Windows.  From this list,
    click on "Unlisted or Updated Driver".  A new dialog box will
    appear asking  you to specify the location of the new driver.  Once
    you have answered this question you will be given a choice of the
    two drivers to install: the Yamaha GSS Midi Synth and the Yamaha
    GSS Wave/Midi/Aux. You should install both of these drivers in
    sequence, first installing the Yamaha GSS Midi Synth, and then the
    Yamaha GSS Wave/Midi/Aux.

    When you will select the Yamaha GSS Midi Synth driver,  this driver
    will be installed in Windows.  This driver doesn't require any more
    installation than that.  Windows will prompt you  with "Don't
    Restart Now" or "Restart Now."  If you haven't yet installed the
    Yamaha GSS Wave/Midi/Aux driver you should choose to postpone the
    restarting of Windows until  you've installed both drivers. 
    Otherwise select "Restart Now."

* Configuring the Yamaha GSS Wave/Midi/Aux driver according to your
  current Gold Card configuration

    The specified address should be "38C."  Even if the Gold card's
    address is "388" the correct address setting for the driver under
    Windows is "38C" (address should always be Gold card base address +
    4 in hexadecimal).

    The DMA Buffer size (Memory allocated to the driver) should be set
    to the maximum available value. 

    The interrupt line and DMA channel should correspond to those
    you've allocated to the Gold Card using the Gold Setup program.

    Windows will prompt you  with "Don't Restart Now" or "Restart Now." 
    If you haven't yet installed the Yamaha GSS Midi Synth driver you
    may as well choose to postpone the restarting of Windows until
    you've installed both drivers.  Otherwise select "Restart Now."

* Restarting Windows

    In order for the changes to take effect, Windows must be restarted.
    
* Reconfigure the MIDI Mapper

    The MIDI Mapper applet from the control panel contains standard
    configurations that maximize the use of your existing hardware. 

    A complete set of configurations for the Ad Lib Gold Card has been
    supplied in the MIDIMAP.CFG file.  This file can be used to replace
    your existing MIDIMAP.CFG file in the "..\WINDOWS\SYSTEM"
    directory.  If you wish to use this configuration, just copy the
    supplied MIDIMAP.CFG file in this directory.

    When copied, you will have two options to choose from (when in the
    MIDI Mapper) to set your Gold card up for MIDI: GOLD MIDI and GOLD
    SYNTH.  GOLD MIDI uses the Yamaha GSS Midi Out (part of the Yamaha
    GSS Wave/Midi/Aux) driver on all 16 of the MIDI channels whereas
    GOLD SYNTH makes use of the Yamaha GSS Midi Synth driver.  This means
    that you would select GOLD MIDI whenever you have a MIDI device hooked
    up to your Gold card and would like to play your MIDI information
    through it.  Any other time you would select GOLD SYNTH.  By default
    the GOLD SYNTH is selected.

* Installing the Ad Lib Gold Mixer for Windows

    Copy the Mixer program (MIXERGLD.EXE) to the "...\WINDOWS"
    directory.

    Now, in Windows, create a new program item in the Program Manager's
    "Accessories" program group:

    Open the "Accessories" program group.  Now select the "New..."
    option in the "File" menu heading.  "Program Item" should be
    highlighted so that you simply have  to click on "OK."  

    You will be prompted to fill in 4 fields: Description:, Command
    Line:, Working Directory:, and Short Cut Key:.  The suggested
    "Description:" is "Gold Mixer."  For the "Command Line:" you should
    type in "MIXERGLD.EXE" (specifying its path is optional).  The last
    two fields don't require any entry so you can simply click on "OK"
    and a new icon will appear in your "Accessories" program group.

    This completes the installation of the Ad Lib Gold Windows drivers
    and mixer.

------------------------------------------------------------------

* Notes:
********

*   The Gold Card must use at least 1 DMA channel.

*   In order for the drivers to function correctly, at least one DMA
    channel must have been allocated to the Gold Card, and that DMA
    channel must have been specified in the drivers configuration.

    To access the driver configuration, use the "Setup..." button in
    the Control Panel "Drivers" applet.

    To allocate a DMA channel to the Gold Card, use the Setup program,
    supplied in the program disks, under DOS. 

*   The Drivers Configuration must reflect the Hardware Configuration

    If the digitized sound playback does not occur or "loops", it may
    indicate that the driver configuration do not reflect the actual
    hardware configuration, in terms of DMA channel allocation or
    interrupt line (IRQ) selection.  It could also indicate that your
    choice of interrupt conflicts with some other peripheral in the
    system.

    To access the driver configuration, use the "Setup..." button in
    the Control Panel "Drivers" applet.

    To allocate a DMA channel to the Gold Card or alter interrupt line
    selection, use the Setup program, supplied in the program disks,
    under DOS.

*   Running DOS applications under Windows

    If a DOS application uses the the ressources of the Ad Lib card,
    the Windows drivers are allocated exclusively to that DOS
    application for the duration of the DOS application. Therefore, you
    will not be able to share those ressources between simultaneously
    opened Windows and DOS applications.

