								31-8-'1997

I've decided to rewrite the installation 'manual' to prevent 
unnecessary problems for people that don't have much experience
with their GUS cards. (and after many asked for it)

Here it goes: (suggestions are always welcome)
	- Uninstall Manley drivers if installed
		- MINSTALL with that package and select zero Ultrasounds
		  (start minstall.exe in directory of previous driver 
		   package)
		- Confirm no "ULTRA" strings in CONFIG.SYS

	- If you haven't installed MMPM/2, do it right now.
          (install at least Base Multimedia Support)

	- MINSTALL this package 
		- Run minstall.exe in the directory where you unpacked
		  ultra120.zip
		- The new installation program should be sufficient
		  to install the driver. At the bottom of this document
		  you'll find a list of all the parameters supported
		  by the driver
		- After selecting the Gravis UltraSound a new dialog
		  box is created where you can enter all the settings
		  required: (press the help button for online help)
		  ****************** Important **********************
		  The installation program does *not* check if the
		  port/irq/dma settings you chose conflict with other
		  hardware devices in your system. So make sure you
		  choose those ports/irqs/dmas that are free for use.
		  
		    - Base/Codec Address
			- Select 220 for the baseport address unless
			  you changed it with the dos setup program!
			- For GUS PnP/Max/InterWave you will only need 
			  to change the Codec address to something else
			  than 32C if you changed the baseport address:
				- baseport 2X0
				    (X = 1, 2, 3, 4, 5 or 6)
			        - codec 3XC
				    (X is identical to the one in the 
				     baseport address!)
			  GUS Daughterboard:
				- Select 503, 604 or E80 (check the
				  jumper on the daughterboard)
		    - GF1/MIDI Irq
			- GUS Daughterboard requires both irqs
			  to be different! (check jumpers on the
			  daughterboard for the correct MIDI Irq)
			- You can select two different irqs for
			  all other models, but it's actually
			  a waste of resources, since the OS/2
			  driver only uses the GF1 irq.
		    - Playback/Record DMA
			- GUS Daughterboard requires both dmas to
			  be different (check jumpers on the
			  daughterboard for the correct Record DMA
			  channel)
			- Selecting two different dma channels
			  allows full duplex on your GUS. 
			  (simultaneous playback and record)
		    - SoundCard
			- Choose the model you own from the list
			  NOTE: You need to select the GUS PnP
			        if you own one, or else the driver
                                will not attempt to detect it and
	                        thinks it's another GUS model
                                (most likely GUS + Daughterboard)!
                                This is to prevent problems on
                                motherboards without a PnP BIOS.
                                (yes, they still exist)
		    - Plug 'n Play support
			- Only used for the GUS PnP or InterWave
			  based cards
		- The second page in the notebook is used for
		  non-critical settings which are explained in
		  the online help
	- Press the OK button when you're done
	- InterWave board owners (those that selected 'Other
	  InterWave' in the Soundcard selection) will see
             a dialog box that asks for the PnP Vendor ID.
 	       	- XXXXXXX (3 letters + 4 digits)
 	             (PnP ISA Vendor ID for Interwave based soundcards
   	       	      not sold by Gravis
	              example (uses the GUS PnP Vendor ID):
	                 GRV0001
                      The Vendor ID can be found in the iw.ini file)
	- Choose whether you want the install program to create a
          folder which contains icons for ultramem, ultimix and ultimod)
	- After this, the installation program has finished.

	- CONFIG.SYS should have lines similar to this:
		DEVICE=D:\MMOS2\ULTRADD.SYS /P:240,32C /I:12,5 /D:7 /J /V
		DEVICE=D:\MMOS2\ULTRAVDD.SYS
		RUN=D:\MMOS2\ULTRADMN.EXE C:\ULTRASND
		RUN=D:\MMOS2\ULTRALDR.EXE

	- shutdown and reboot
	- Wave playback and recording should work right now
	  (if you hear looping sounds or see OS/2 crash when
	   playing wave sounds, there's a high chance there's
	   a port/irq/dma conflict with other hardware)

	- How to get MIDI working properly:
	  - First of all you'll need onboard RAM for MIDI playback
	    The OS/2 GUS driver does *not* support onboard ROM on
	    the GUS PnP or other InterWave cards.
	  - GUS PnP/Pro owners:
	    (assuming your UltraSound software is installed in 
             C:\ULTRAPNP)
		- install RAM support from your Gravis CD
		  (this copies patch (.pat) files to your
		   harddisk which are required for MIDI playback
		   in OS/2)
		  This is done by running install.bat from the root
		  directory of the CD and choosing RAM support from
	 	  the menu.
		- make sure the path in the
			RUN=D:\MMOS2\ULTRADMN.EXE C:\ULTRAPNP
		  statement points to the directory where you
                  installed RAM support (the patch files are
                  stored in C:\ULTRAPNP\MIDI (in this case))
                - copy ultrasnd.ini from \UTILS\ULTRASND on
                  your Gravis CD to the C:\ULTRAPNP directory
                - start an editor to change the contents of
                  your ultrasnd.ini file.
	          Changes required:
		      - All the 
			   PatchDir=D:\GUS\MIDI\
	                statements should be modified
                        to reflect your GUS installation
                        (C:\ULTRAPNP\MIDI in this case)
	  - other GUS Models:
	    (assuming your UltraSound software is installed in 
                C:\ULTRASND)
		- the dos install program should have installed
	 	  the MIDI patches and ultrasnd.ini on your
	             harddisk
		- make sure the path in the
			RUN=D:\MMOS2\ULTRADMN.EXE C:\ULTRASND
		  statement points to the directory where your
                  ultrasound software was installed.
	  - InterWave owners
		- visit Gravis' website (www.gravis.com) and download
		  either Propatch lite or one of the old GUS install
                  disk packages.
	  - To improve MIDI playback (since the standard GUS patchset
            is of rather poor quality) you can download the ProPatch
            Lite package.
            It's a big improvement over the original patches.


Summary of all the parameters supported by the OS/2 GUS driver:
	- new ULTRADD switches:
		- /P:<GUS base>,<codec base>
		- /I:<GF1 IRQ>,<MIDI IRQ>
		- /D:<play DMA>,<rec DMA>
		- /C:<number of voices to use> (default = 28)
		  (Ignored on a GUS PnP)
		- /J (enable joystick)
		- /L (always enable line-in)
		- /V (verbose messages at startup)
		- /X Displays initial Code & Data offsets
		  (for debugging crashes)
	   The next switches are only for the GUS PnP (Pro)
	   and other InterWave based soundcards:
  	        - /G (enable GUS PnP (and Interwave) detection)
      	        - /R (force PnP reset if your system doesn't have
	              a PnP BIOS and you are NOT running OS/2 Warp 4.0)
	              NOTE: /R seems to be necessary for the Reveal 
			    WaveXtreme
 	       	- /E:XXXXXXX (3 letters + 4 digits)
 	             (PnP ISA Vendor ID for Interwave based soundcards
   	       	      not sold by Gravis
	              example (uses the GUS PnP Vendor ID):
	                 /E:GRV0001
                      The Vendor ID can be found in the iw.ini file)

