path: root/Documentation/sound/oss/README.OSS

Introduction
------------

This file is a collection of all the old Readme files distributed with
OSS/Lite by Hannu Savolainen. Since the new Linux sound driver is founded
on it I think these information may still be interesting for users that
have to configure their sound system.

Be warned: Alan Cox is the current maintainer of the Linux sound driver so if
you have problems with it, please contact him or the current device-specific
driver maintainer (e.g. for aedsp16 specific problems contact me). If you have
patches, contributions or suggestions send them to Alan: I'm sure they are
welcome.

In this document you will find a lot of references about OSS/Lite or ossfree:
they are gone forever. Keeping this in mind and with a grain of salt this
document can be still interesting and very helpful.

[ File edited 17.01.1999 - Riccardo Facchetti ]
[ Edited miroSOUND section 19.04.2001 - Robert Siemer ]

OSS/Free version 3.8 release notes
----------------------------------

Please read the SOUND-HOWTO (available from sunsite.unc.edu and other Linux FTP 
sites). It gives instructions about using sound with Linux. It's bit out of
date but still very useful. Information about bug fixes and such things
is available from the web page (see above).

Please check http://www.opensound.com/pguide for more info about programming
with OSS API.

   ====================================================
-  THIS VERSION ____REQUIRES____ Linux 2.1.57 OR LATER.
   ====================================================

Packages "snd-util-3.8.tar.gz" and "snd-data-0.1.tar.Z"
contain useful utilities to be used with this driver.
See http://www.opensound.com/ossfree/ for
download instructions.

If you are looking for the installation instructions, please
look forward into this document.

Supported sound cards
---------------------

See below.

Contributors
------------

This driver contains code by several contributors. In addition several other
persons have given useful suggestions. The following is a list of major
contributors. (I could have forgotten some names.)

	Craig Metz	1/2 of the PAS16 Mixer and PCM support
	Rob Hooft	Volume computation algorithm for the FM synth.
	Mika Liljeberg	uLaw encoding and decoding routines
	Jeff Tranter	Linux SOUND HOWTO document
	Greg Lee	Volume computation algorithm for the GUS and
			lots of valuable suggestions.
	Andy Warner	ISC port
	Jim Lowe,
	Amancio Hasty Jr	FreeBSD/NetBSD port
	Anders Baekgaard 	Bug hunting and valuable suggestions.
	Joerg Schubert	SB16 DSP support (initial version).
	Andrew Robinson Improvements to the GUS driver
	Megens SA	MIDI recording for SB and SB Pro (initial version).
	Mikael Nordqvist  Linear volume support for GUS and
			  nonblocking /dev/sequencer.
	Ian Hartas		SVR4.2 port
	Markus Aroharju	and
	Risto Kankkunen		Major contributions to the mixer support
				of GUS v3.7.
	Hunyue Yau	Mixer support for SG NX Pro.
	Marc Hoffman	PSS support (initial version).
	Rainer Vranken	Initialization for Jazz16 (initial version).
	Peter Trattler	Initial version of loadable module support for Linux.
	JRA Gibson	16 bit mode for Jazz16 (initial version)
	Davor Jadrijevic MAD16 support (initial version)
	Gregor Hoffleit	Mozart support (initial version)
	Riccardo Facchetti Audio Excel DSP 16 (aedsp16) support
	James Hightower Spotting a tiny but important bug in CS423x support.
	Denis Sablic	OPTi 82C924 specific enhancements (non PnP mode)
	Tim MacKenzie	Full duplex support for OPTi 82C930.
	
	Please look at lowlevel/README for more contributors.

There are probably many other names missing. If you have sent me some
patches and your name is not in the above list, please inform me.

Sending your contributions or patches
-------------------------------------

First of all it's highly recommended to contact me before sending anything
or before even starting to do any work. Tell me what you suggest to be
changed or what you have planned to do. Also ensure you are using the
very latest (development) version of OSS/Free since the change may already be
implemented there. In general it's a major waste of time to try to improve a
several months old version. Information about the latest version can be found
from http://www.opensound.com/ossfree. In general there is no point in
sending me patches relative to production kernels.

Sponsors etc.
-------------

The following companies have greatly helped development of this driver 
in form of a free copy of their product:

Novell, Inc.		UnixWare personal edition + SDK
The Santa Cruz Operation, Inc. 	A SCO OpenServer + SDK
Ensoniq Corp,		a SoundScape card and extensive amount of assistance
MediaTrix Peripherals Inc, a AudioTrix Pro card + SDK
Acer, Inc.		a pair of AcerMagic S23 cards.

In addition the following companies have provided me sufficient amount
of technical information at least some of their products (free or $$$):

Advanced Gravis Computer Technology Ltd.
Media Vision Inc.
Analog Devices Inc.
Logitech Inc.
Aztech Labs Inc.
Crystal Semiconductor Corporation,
Integrated Circuit Systems Inc.
OAK Technology
OPTi
Turtle Beach
miro
Ad Lib Inc. ($$)
Music Quest Inc. ($$)
Creative Labs ($$$)

If you have some problems
=========================

Read the sound HOWTO (sunsite.unc.edu:/pub/Linux/docs/...?).
Also look at the home page (http://www.opensound.com/ossfree). It may
contain info about some recent bug fixes.

It's likely that you have some problems when trying to use the sound driver
first time. Sound cards don't have standard configuration so there are no
good default configuration to use. Please try to use same I/O, DMA and IRQ
values for the sound card than with DOS.

If you get an error message when trying to use the driver, please look
at /var/adm/messages for more verbose error message.


The following errors are likely with /dev/dsp and /dev/audio.

	- "No such device or address".
	This error indicates that there are no suitable hardware for the
	device file or the sound driver has been compiled without support for
	this particular device. For example /dev/audio and /dev/dsp will not
	work if "digitized voice support" was no