patch-1.3.9 linux/drivers/sound/Readme

• Lines: 304
• Date: Mon Jul 10 19:13:24 1995
• Orig file: v1.3.8/linux/drivers/sound/Readme
• Orig date: Thu Feb 9 18:29:53 1995

diff -u --recursive --new-file v1.3.8/linux/drivers/sound/Readme linux/drivers/sound/Readme
@@ -1,28 +1,81 @@
-VoxWare v2.90 release notes
---------------------------
+Please read the SOUND-HOWTO (available from sunsite.unc.edu and other Linux ftp 
+sites). It contains much more information than this file.
 
+*****************************************************************
+* NEW! VoxWare home page is http://personal.eunet.fi/pp/voxware *
+* The file Readme.cards contains card specific instructions     *
+* about configuring various cards.				*
+*****************************************************************
 
-		This version includes some hidden features which
-		are described in the file experimental.txt
-		Some of these features are not enabled by default. Look at
-		experimental.txt for more info.
-
-		I just decided to release this version with some
-		incompletely implemented features disabled since
-		there are some new features required by a popular 
-		application. In addition there is also support
-		for the GUS MAX and the 16 bit sampling option of GUS.
-
-		The MSS/WSS support works now. At least with SG NX Pro 16.
-
-********* IMPORTANT *****************************************
-Linux 1.0 or later is required to by this driver version.
-
-Don't distribute binaries which use /dev/sequencer and are
-compiled with the soundcard.h of this version. They will
-not work with version 2.x of the driver.
-*************************************************************
+VoxWare v3.0 release notes
+--------------------------
 
+This version is the final v3.0. All features I have planned to
+include in v3.0 are there but some of them are completely untested
+(see experimental.txt).
+
+NOTE!	This Linux only distribution doesn't contain files required
+	for other operating systems than Linux. They are distributed
+	in file VoxWare-3.0.tar.gz which is available from
+	sunsite.unc.edu:pub/Linux/kernel/sound (or pub/Linux/Incoming).
+
+	Also some utilities for SoundScape, PSS and AudioTriX cards
+	have been removed. They are available in VoxWare-3.0.tar.gz and
+	in snd-util-3.0.tar.gz (when I have time to release it).
+
+*** GUS MAX enhancements *****************************************************
+Recording with GUS MAX works now. The configuration program asks
+two DMA channels for GUS MAX. You have to use two different 16 bit
+DMA numbers (5, 6 or 7) if you want to record (8 bit DMA channels
+may or may not work). It's still possible to use just one DMA channel
+with GUS MAX but recording doesn't work in this case (a hardware limitation).
+Even the driver has capability to use two DMA channels, simultaneous recording
+and playback is not possible with GUS MAX (will not be before v4.0 
+of the driver). However it's now possible to play using /dev/dsp and /dev/dsp1
+at the same time (or /dev/dsp and /dev/sequencer as well).
+Recording using /dev/dsp1 will not work if GUS MAX is configured to use two
+DMA channels.
+******************************************************************************
+
+There are some additional device files (since v2.90-2 andv3.0-proto-94mmdd 
+versions).
+You will need to create additional device files using the script at the
+end of ./linux/Readme. Also recompile all mixer programs since there are
+some new channels that are not enabled in mixers compiled with older
+soundcard.h.
+
+There are some programming information (little bit old) in the
+Hacker's Guide 
+(ftp://nic.funet.fi/pub/OS/Linux/ALPHA/sound/snd-sdk-doc-0.1.ps.gz).
+Believe me: The file is really there. The directory is just hidden and
+you have to cd into it before the file is visible.
+
+I have got many patches from various persons during last year. Some of
+them are still on my mailbox and they should be included in versions
+after v3.0 (I will not add aditional features before v3.0 is ready).
+
+   ====================================================
+-  THIS VERSION ____REQUIRES____ Linux 1.2.0 OR LATER.
+   ====================================================
+
+-  THIS VERSION MAY NOT WORK WITH Linux VERSIONS RELEASED
+   AFTER end of July 1995. If this version doesn't compile with
+   your kernel version, please use the sound driver version
+   included in your kernel.
+-  Ensoniq SoundScape support is included in this version but it's
+   somehow incomplete. MIDI recording may not work and you have to
+   use /dev/dsp1 and /dev/audio1 (/dev/dsp and /dev/audio don't work).
+   I recommend you recreate the device files used by the driver by
+   running the script at the end of linux/Readme. Then just
+   rm /dev/dsp;ln -s /dev/dsp1 /dev/dsp (and the same with /dev/audio).
+   You will also need the latest version of the soundscape.co[01] file.
+   The old sndscape.cod will ___NOT___ work (it propably just hangs your
+   system completely). The latest code file is available from ftp.ensoniq.com
+   as part of the DOS/Windows driver distribution. See sndscape/ssinit.c
+   for more info.
+-  This is Linux only version. It should work in other operating systems
+   (SCO, UW, FreeBSD and NetBSD) too but may require some fixes before
+   it compiles.
 
 You will need the snd-util-2.5.tar.gz and snd-data-0.1.tar.Z
 packages to use this driver. They should be in the same
@@ -32,55 +85,187 @@
 If you are looking for the installation instructions, please
 look at linux/Readme.
 
+Supported soundcards
+--------------------
+
+Gravis Ultrasound (GUS)
+GUS MAX
+GUS with the 16 bit sampling daughtercard
+PAS16
+Windows Sound System compatible soundcards
+ECHO-PSS (cards based on the PSS architecture by Analog Devices.
+	Including Orchid SW32, Cardinal DSP16 among others).
+		(NOTE! WSS mode may not work (DMA channel setup problem)).
+MediaTriX AudioTriX Pro (OPL4 and the optional effect daughtercard
+	require special initialization. There is a program (setfx) in
+	the audiotrix directory which does it).
+Ensoniq SoundScape (works but needs some improvements)
+MV Jazz16 based soundcards (ProSonic, 3D etc).
+SoundMan Wave (recording may not work, mixer support is limited)
+Mozart (OAK OTI-601 interface chip) based soundcards.
+MAD16 (an interface chip by OPTi) based soundcards (TB Tropez ???).
+(NOTE! The MAD16 looks similar to the Mozart chip. It could be a good
+idea to configure MAD16 cards as Mozart ones. The MAD16 driver doesn't set
+up MPU401 which the Mozart one does.
+
+In addition all Sound Blaster models and clones (up to AWE32) work if
+you want to use them.
+
+The Emu synthesizer chip of AWE32 is not and will not be supported. The same is
+true with the ASP chip also. Creative Technology will not release detailed
+information about them so it's not possible to support them.
+
+If you want to get support for AWE32 or ASP, please contact Creative Labs.
+Ask _politely_ if they are going to support Linux. Maybe they change
+their policy if there is enough demand.
+
+===========================================================================
+If your card is compatible with SB, MPU401 or Windows Sound System, it
+may work with the driver even if it's not listed in the above list. In this
+case it may require initialization using DOS. Just start DOS and cold
+boot to Linux (etc.) by hitting ctrl-alt-del. 
+===========================================================================
+
 Compatibility with the earlier versions
 ---------------------------------------
 
-This version is backward compatible with the version 2.X. All programs
-compiled with sys/soundcard.h of v2.X should work without problems.
-PROGRAMS COMPILED WITH THE sys/soundcard.h OF THIS VERSION WILL NOT
-WORK WITH v2.X DRIVER. BE CAREFUL WHEN DISTRIBUTING BINARIES COMPILED 
-FOR THIS VERSION.
+There have been some changes in soundcard.h after v2.5 of the driver
+(v2.90 is compatible with this one). Binaries compiled with this version
+of soundcard.h will not work with v2.0 and earlier.
 
 Contributors
 ------------
 
 This driver contains code by several contributors. In addition several other
-persons have given useful suggestions. The following is a list of major
+persons have given usefull 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
+	Andy Fingerhut	New ulaw conversion tables (ulaw.h)
+	Jeff Tranter	Linux SOUND HOWTO document
 	Greg Lee	Volume computation algorithm for the GUS and
 			lot's of valuable suggestions.
 	Andy Warner	ISC port
-	Jim Lowe	FreeBSD port
+	Jim Lowe,
+	Amancio Hasty Jr	FreeBSD/NetBSD port
 	Anders Baekgaard 	Bughunting and valuable suggestions.
 	Joerg Schubert	SB16 DSP support.
 	Andrew Robinson Improvements to the GUS driver
 	Megens SA	MIDI recording for SB and SB Pro.
-	Mikael Nordqvist  Linear volume support for GUS.
-	Mikael Nordqvist  	Linear volume support for GUS.
+	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.
+	Rainer Vranken	Initialization for Jazz16 (ProSonic, MV3D, SM Wave).
+	Peter Trattler	Loadable module support for Linux.
+	JRA Gibson	16 bit mode for Jazz16
+	Davor Jadrijevic MAD16 support
+	Gregor Hoffleit	Mozart support
+	Riccardo Facchetti Audio Excel DSP 16 (aedsp16) support
+
+There are propably many other names missing. If you have sent me some
+patches and your name is not in the above list, please inform me.
+
+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
+Ensoniq Corp,		a SoundScape card and extensive amount of assistance
+MediaTriX Peripherals Inc, a AudioTriX Pro card + SDK
+
+In addition the following companies have provided me sufficial 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
+Ad Lib Inc. ($$)
+Music Quest Inc. ($$)
+Creative Labs ($$$)
+
+If you have some problems
+=========================
+
+Read the sound HOWTO (sunsite.unc.edu:/pub/Linux/docs/...?).
+
+It's likely that you have some problems when trying to use the sound driver
+first time. Soundcards 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 soundcard 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.
+
+
+In general the easiest way to diagnoze problems is to do "cat /dev/sndstat".
+
+If you get an error message, there are some problems with the driver setup:
+
+	- "No such file or directory" tells that the device files for
+	the sound driver are missing. Use the script at the end of
+	linux/drivers/sound/Readme.linux to create them.
+
+	- "No such device" telss that the sound driver is not in the kernel.
+	You have to reconfigure and recompile the kernel to have the sound
+	driver. Compiling the driver doesn't help alone. You have to boot
+	with the newly compiled one before the driver becomes active.
+	The Linux-HOWTO should help in this step.
+
+The following errors are likely with /dev/dsp and /dev/audio.
+
+	- "No such device or address". This error message should not happen
+	with /dev/sndstat but it's possible with the other sound devices.
+	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 not enabled during "make config".
+	
+	- "Device or resource busy". Propably the IRQ (or DMA) channel 
+	required by the soundcard is in use by some other device/driver.
+
+	- "I/O error". Almost certainly (99%) it's an IRQ or DMA conflict.
+	Look at the kernel messages in /var/adm/notice for more info.
+
+	- "Invalid argument". The application is calling ioctl()
+	with impossible parameters. Check that the application is
+	for sound driver version 2.X or later.
+
+In general the printout of of /dev/sndstat should tell what is the problem.
+It's possible that there are bugs in the sound driver but 99% of the problems
+reported to me are caused by somehow incorrect setup during "make config".
+
+Hannu
 
 Regards,
 
 Hannu Savolainen
 hannu@voxware.pp.fi
+(or Hannu.Savolainen@cctap.carel.fi in case the above bounces)
 
 Snail mail:	Hannu Savolainen
 		Hiekkalaiturintie 3 A 8
 		00980 Helsinki
 		Finland
-FAX:		+358 0 341 6272 (answers if I have my machine (mgetty) on).
 
-NOTE!	I probably don't answer to Snail mail or FAX messages. Sending answer
+NOTE!	I propably don't answer to Snail mail or FAX messages. Sending answer
 	to each of them is simply too expensive and time consuming. However I
-	try to reply every email message I get (within a week). If you don't
+	try to reply every email message I get (within a week). If you don't 
 	get response, please check how your address is written in the message
 	header. I can't answer if I don't have a valid reply address.
+
+VoxWare home page is http://personal.eunet.fi/pp/voxware