YAMAHA* AUDIO HARDWARE DEVICE DRIVERS FOR USE WITH OS/2*

--------------------
1.0 REVISION HISTORY
--------------------
July 23, 1996: Version 1.0
January 20, 1997: Version 3.02
March 21, 1997:Version 3.03
April 23, 1997:Version 3.04

----------------
2.0 INTRODUCTION
----------------
This file contains last-minute updates.  Please read this file before
proceeding with the installation.

Supported OS and Hardware:
  OS :       OS2 Warp* Version 3 and Version 4
  Hardware:  OPL3-SA, OPL3-SA2, OPL3-SA3, OPL4-ML(Hardware Wavetable)

-----------------
3.0 Preparations
-----------------
1. This driver uses the multimedia application installer, so you must 
   first add multimedia software support (MMPM/2) to your OS/2 system.
2. Prepare sufficient free space for the driver installation in your 
   hard disk. Including the work area required for installation, 
   approximately 300 Kbytes will be necessary. However this does not 
   include the area used by the OS/2 system (swap area).
   We recommend that you allow plenty of space.
3. If you want to delete the previous version of the driver, you must 
   first re-install multimedia software support (MMPM/2) (i.e., delete 
   the functionality and then add it once again).

-----------------------------
4.0 INSTALLATION INSTRUCTIONS
-----------------------------
Installing the Yamaha Device Driver for OS/2 Warp Version 3:

1)  OS/2 will autodetect the Yamaha device as a Sound Blaster* Pro.
    Do NOT install this device and remove it from the setup.  The
    Yamaha driver will be installed as part of the Multimedia
    Application Install.
2)  When installing OS/2 be sure to install the Multimedia Applications.
3)  Be sure that your BIOS settings are set to NOT use a PnP OS if
    using Warp 3.0.
4)  Open the Multimedia Folder located on the Desktop.
5)  Within the Multimedia Folder open the Multimedia Application
    Install Icon.
6)  Insert the Driver Diskette and change the source drive to read from
    the diskette or point to the path where the driver is located.
    a) Highlight and select (double click) the DRIVER directory.
    b) Highlight and select (double click) the language you wish to use.
7)  Highlight and select the Yamaha OPL3-SA Series Driver and then
    click Install.
8)  OS/2 will then prompt you that the CONFIG.SYS will be changed,
    select YES.
9)  Enter 1 for the number of Yamaha OPL3-SA Series Audio devices
    and click OK.
10) The system will display the hardware configuration settings. Do
    not modify these settings unless you are an experienced user. 
    Click OK.

TYPICAL VALUES FOR THE OPL3-SA ARE:
    Interrupt Level:                       IRQ 7
    WSS DMA Channel:                       0, 1
    WSS Base I/O Port:                     530h
    FM Synthesizer Base I/O Port:          388h
    MPU401 Base I/O Port:                  Disable
    MPU401 Interrupt Level:                IRQ5(SA Only)
    Control Register Base I/O Port:        OPL3-SA
    SoundBlaster Register Base I/O Port:   Enable(I/O:220h)
    Game Port Supporting:                  Enable(I/O:201h)
    Game Port Supporting(Joystick Driver): Enable(I/O:201h)

TYPICAL VALUES FOR THE OPL3-SA WITH THE OPL4-ML ARE:
    Interrupt Level:                       IRQ 7
    WSS DMA Channel:                       0, 1
    WSS Base I/O Port:                     530h
    FM Synthesizer Base I/O Port:          388h
    MPU401 Base I/O Port:                  330h
    MPU401 Interrupt Level:                IRQ5(SA Only)
    Control Register Base I/O Port:        OPL3-SA
    SoundBlaster Register Base I/O Port:   Enable(I/O:220h)
    Game Port Supporting:                  Enable(I/O:201h)
    Game Port Supporting(Joystick Driver): Enable(I/O:201h)

TYPICAL VALUES FOR THE OPL3-SA2 OR OPL3-SA3 ARE:
    Interrupt Level:                        IRQ 7
    WSS DMA Channel:                        0, 1
    WSS base I/O Port:                      530h
    FM Synthesizer Base I/O Port:           388h
    MPU401 Base I/O Port:                   Disable
    MPU401 Interrupt Level:                 SA2/SA3
    Control Register Base I/O Port:         390h(SA2 or SA3)
    SoundBlaster Register Base I/O Port:    Enable(I/O:220h)
    Game Port Supporting:                   Enable(I/O:201h)
    Game Port Supporting(Joystick Driver):  Enable(I/O:201h)

TYPICAL VALUES FOR THE OPL3-SA2 OR OPL3-SA3 WITH THE OPL4-ML ARE:
    Interrupt Level:                         IRQ 7
    WSS DMA Channel:                         0, 1
    WSS base I/O Port:                       530h
    FM Synthesizer Base I/O Port:            388h
    MPU401 Base I/O Port:                    330h
    MPU401 Interrupt Level:                  SA2/SA3
    Control Register Base I/O Port:          390h(SA2 or SA3)
    SoundBlaster Register Base I/O Port:     Enable(I/O:220h)
    Game Port Supporting:                    Enable(I/O:201h)
    Game Port Supporting(Joystick Driver):   Enable(I/O:201h)

    NOTE: to enable support for OPL4-ML (Hardware wavetable) or
    external MIDI devices, set MPU401 Support to enabled.  If
    no Hardware Wavetable devices or External MIDI devices are present
    set the MPU401 Base I/O: to disabled default settings.

11) OS/2 will then prompt that the changes have taken place.
12) Reboot if necessary.


Installing the Yamaha Device Driver for OS/2 Warp Version 4:

1)  When installing OS/2 be sure to install the Multimedia Applications.
2)  OS/2 will autodetect the Yamaha device as a Sound Blaster Pro.
    Do NOT install this device and remove it from the setup.  The
    Yamaha driver will be installed as part of the Multimedia
    Application Install.
3)  Once OS/2 is loaded.  Double click on the OS/2 System icon on the
    Desktop.
4)  Double click the System Setup Icon.
5)  Double click the Install/Remove Icon.
6)  Double click the Multimedia Application Install Icon.
7)  Insert the Driver Diskette and change the source drive to read from
    the diskette or point to the path where the driver is located.
    a) Highlight and select (double click) the DRIVER directory.
    b) Highlight and select (double click) the language you wish to use.
8)  Highlight and select the Yamaha OPL3-SA Series Driver and then
    click Install.
9)  OS/2 will then prompt you that the CONFIG.SYS will be changed,
    select YES.
10) Enter the number of Yamaha OPL3-SA Audio devices to be 1 and click
    OK.
11) The system will display the hardware configuration settings. Do
    not modify these settings unless you are an experienced user. 
    Click OK. 

TYPICAL VALUSES FOR THE OPL3-SA ARE:
    Interrupt Level:                         IRQ 7
    WSS DMA Channel:                         0, 1
    WSS Base I/O Port:                       530h
    FM Synthesizer Base I/O Port:            388h
    MPU401 Base I/O Port:                    Disable
    MPU401 Interrupt Level:                  IRQ5(SA Only)
    Control Register Base I/O Port:          OPL3-SA
    SoundBlaster Register Base I/O Port:     Enable(I/O:220h)
    Game Port Supporting:                    Enable(I/O:201h)
    Game Port Supporting(Joystick Driver):   Enable(I/O:201h)

TYICAL VALUES FOR THE OPL3-SA WITH THE OPL4-ML INSTALLED ARE:
    Interrupt Level:                        IRQ 7
    WSS DMA Channel:                        0, 1
    WSS Base I/O Port:                      530h
    FM Synthesizer Base I/O Port:           388h
    MPU401 Base I/O Port:                   330h
    MPU401 Interrupt Level:                 IRQ5(SA Only)
    Control Register Base I/O Port:         OPL3-SA
    SoundBlaster Register Base I/O Port:    Enable(I/O:220h)
    Game Port Supporting:                   Enable(I/O:201h)
    Game Port Supporting(Joystick Driver):  Enable(I/O:201h)

TYPICAL VALUES FOR THE OPL3-SA2 OR OPL3-SA3 ARE:
    Interrupt Level:                         IRQ 7
    WSS DMA Channel:                         0, 1
    WSS base I/O Port:                       530h
    FM Synthesizer Base I/O Port:            388h
    MPU401 Base I/O Port:                    Disable
    MPU401 Interrupt Level:                  SA2/SA3
    Control Register Base I/O Port:          390h(SA2 or SA3)
    SoundBlaster Register Base I/O Port:     Enable(I/O:220h)
    Game Port Supporting:                    Enable(I/O:201h)
    Game Port Supporting(Joystick Driver):   Enable(I/O:201h)

TYPICAL VALUES FOR THE OPL3-SA2 OR OPL3-SA3 WITH THE OPL4-ML ARE:
    Interrupt Level:                         IRQ 7
    WSS DMA Channel:                         0, 1
    WSS base I/O Port:                       530h
    FM Synthesizer Base I/O Port:            388h
    MPU401 Base I/O Port:                    330h
    MPU401 Interrupt Level:                  SA2/SA3
    Control Register Base I/O Port:          390h(SA2 or SA3)
    SoundBlaster Register Base I/O Port:     Enable(I/O:220h)
    Game Port Supporting:                    Enable(I/O:201h)
    Game Port Supporting(Joystick Driver):   Enable(I/O:201h)

    NOTE: to enable support for OPL4-ML (Hardware wavetable) or
    External MIDI devices MPU401 Support must be set to enabled.  If
    no Hardware Wavetable devices or External MIDI devices are present
    please select the MPU401 Base I/O: disabled default settings.

12) OS/2 will then prompt that the changes have taken place.
13) Reboot if necessary.

-------------------------------
5.0 UNINSTALLATION INSTRUCTIONS
-------------------------------

     To un-install the Yamaha Device Driver, the following
     lines must be removed from the respective files.

     CONFIG.SYS

   	Device=C:\MMOS2\OPL3SA.SYS /I:11 /D:01 /W:530 /F:388 /M:0 /A:0 /C:390 /S:220 /N:OPL3S1$ /J:1,201
  	Device=C:\MMOS2\OPL3VDD.SYS OPL3S1$
        Device=C:\MMOS\GAMEDD.SYS /J:I,201
        Device=C:\MMOS\GAMEVDD.SYS

     MMPM2.INI file

       	[Drivers]
       	Waveaudio = YMSWAVEOPL3SA01
       	Sequencer = YMSSEQOPL3SA01
       	Ampmix = YMSAMPMIXOPL3SA01

	[YMSWAVEOPL3SA01]
	[YMSWAVEOPL3SA01-PLAY]
	[YMSWAVEOPL3SA01-RECORD]
	[YMSSEQOPL3SA01]
	[YMSSEQOPL3SA01-PLAY]
	[YMSAMPMIXOPL3SA01]
	

-----------
6.0 OPTIONS
-----------
When installation successfully completes, the following lines are added
to CONFIG.SYS:
DEVICE=[MMOS2 dir]\OPL3SA.SYS (*)
DEVICE=[MMOS2 dir]\GAMEDD.SYS (*)
DEVICE=[MMOS2 DIR]\OPL3VDD.SYS (*)
DEVICE=[MMOS2 DIR]\GAMEVDD.SYS

where (*) is:
   /I:xx:5,7,9,10,11            'Interrupt for Windows Sound System
   /D:xx,yy:0,1,3               'DMA channel for Windows Sound System
   /W:xxx:530,604,E80,F40       'Base I/O address for Windows Sound System
   /F:xxx:388,398,3A8,3B8       'Base I/O for OPL3
   /M:xxx:330,320,310,300       'Base I/O address for MPU401
   /C:xxx:F86,390,620,910,A10   'Base I/O address for control registers
   /N:xxx                       'Name of the device driver
   /A:xx:5,7,9,10 (/A:1,2,3,4 (Ymersion MODE for OPL3-SA3B))
				'Interrupt for MPU401 (0 for SA2/SA3)
				'Also in the case of the OPL3-SA3B, you can set the YMERSION mode 
				 by selecting one of the following values for this option.
				 1: Desktop,2: Notebook(1),3: Notebook(2),4: HiFi
				 For values other than the above, Normal mode will be selected.
   /S:xxx:0 disable,220,240,260 'Base I/O address for Sound Blaster

   /J:x,yyy  x:0(Disable), 1(Enable)  'control for Joystick
             yyy: 201,20A,20E

---------------------
7.0 SUPPORTED FEATURES
----------------------
1) Supported devices
   Wave_Out, Wave_In
2) Supported sampling rates
   11.025kHz,22.05kHz,44.1kHz
3) Formats
   Monaural and Stereo, 8bit unsigned PCM and 16bit signed PCM
4) MIDI_Out
   OPL3 & MPU401 for external wavetable synthesizer
5) Mixer
   This driver supports the playback volume for Master, Wave,
   Synthesizer(for internal FM or external synthesizer), CD audio,
   Mic._In, Line_In. And the recording volume for CD audio,
   Line_In, Mic_In and loopback are supported.
6) Game port driver is supported.

------------------------------
8.0 LIMITATIONS
------------------------------

1) Resources.  Regarding the resource that this driver uses (ex. I/O
   address, IRQ and DMA channel), there are constraints resulting from
   the hardware configuration.
2) MIDI playback device assignment.  If MPU401 is enabled, FM synth
   playback will not work.

-------------------------
9.0 COPYRIGHT/TRADEMARKS
-------------------------
*Other brands and trademarks are the property of their respective owners.
