

                       The Linux Ultra Sound Project
                     -===============================-


What's it?
==========

	This  project  is  based  on  Jaroslav Kysela's  new low-level driver
for the Gravis UltraSound card.  Driver offers some unique features  (support
for 8 cards, native  GF1/CODEC/InterWave support,  very useful mixer control,
full duplex  PCM,  MIDI UART support,  MIDI emulation with GF1/InterWave chip
and many  other things).
	More details about driver is in file src/driver/README.


Applications:
=============

	* GUSMIX	ncurses mixer
	* XGUSMIX	X-Window mixer (Tcl/Tk)
	* MUSSERVER	patched music server for DOOM
	* ULTRAMOD	module player based on MikMod routines
	* ULTRAMIDI	native midi player
	* ULTRAPLAY/REC	program for playing/recording .WAV, .VOC files


Binary distribution:
====================

	It was removed due to non-stable source code of 2.0.X kernels..


Quick install:
==============

	Type 'configure' and 'make'.
	... and after compilation and installation ...
	
	1) run 'gusdevs' - this command creates devices for new driver
	2) check /usr/local/etc/gus.conf configuration file
	3) run 'insgus' - this command insert gus driver module to the kernel
	4) check /usr/local/etc/gus-midi.conf configuration file
	5) check /usr/local/etc/gus-midi-gf1.conf and
                 /usr/local/etc/gus-midi-gf1.defs configuration file
		- if path for GF1 patches is incorrect - insert correct path

	Problems? Read FAQ text file...
	Wrong path? Read PATH text file...
	Problems with some application? Read apps-setup/APPS text file...
	Please, look to SPONSORS text file, too...


Quick uninstall:
================

	Type 'make uninstall'...



Original AMD FFFF files:
========================

	The driver support FFFF files for both type of GUS cards (with
old GF1 chip and the new InterWave chip), but original AMD's files named
gmfull1m.XXX and gsfull4m.XXX are licensed by creator (EYE & I Productions)
only for InterWave cards, not for old GUS Classic, GUS MAX, GUS ACE
cards :-((( Please, don't distribute these files over InterNet or other
media which doesn't come from Advanced Gravis Technologies!!! Owners of
first GUS PnP boards can contact Gravis for new software CD with
gsfull4m.XXX file in installation package.


Hard bug in the driver?:
========================

	Look to ~/src/driver/TRACE.BUG for more details.


Linux Ultra Sound Group:
========================

	Jaroslav Kysela <perex@jcu.cz>
	---------------------------------

		* new driver for the UltraSound cards
		* libgus - API for new driver
		* gusmix - mixer which uses ncurses library
		* ultraplay/ultrarec hack - .WAV,.VOC playback/record
		* musserver hack
		* ultramidi - native midi player (ncurses)

	Andy Lo A Foe <arloafoe@cs.vu.nl>
	---------------------------------

		* xgusmix - X-Window mixer (use Tcl/Tk library)
		* ultramod - mod player based on MikMod routines


New projects (in progress):
===========================

	--- none ---

	Have you ideas and time for new project?
	---> Send e-mail to Jaroslav Kysela <perex@jcu.cz> <---


Do you need to contact the Linux Ultra Sound Group?
===================================================

	Mailing list:	<ultra@pf.jcu.cz>

	You can subscribe to the ULTRA mailing list by sending
        'subscribe ultra Your Name' command in the body of e-mail
        message to <listserver@pf.jcu.cz>.

	WWW page:	http://www.pf.jcu.cz/~perex/ultra


FTP sites?
==========

	Official site    	 : sunsite.unc.edu:/pub/Linux/apps/sound
	Alternate & archive site : romeo.pf.jcu.cz:/pub/perex/ultra/final
	Binary distribution site : romeo.pf.jcu.cz:/pub/perex/ultra/binary
	Development site         : romeo.pf.jcu.cz:/pub/perex/ultra/devel


Thanks to:
==========

        Tony Romero <Tony.Romero@amd.com>
                - for InterWave (tm) IC Am78C201/202 Programmer's Guide
        Andreas Schiffler <andreas@karlsberg.usask.ca>
                - spline routines (for shrinking and stretching samples)
                - noise channel idea
        Tim Janik <Tim.Janik@Hamburg.Netsuft.DE>
                - patch for gusmix mixer
        People subscribed to <ultra@pf.jcu.cz> mailing list...


Final note:
===========

	That's all folks... Happy GUSing...

						Jaroslav Kysela
