Man page for guspnp driver.

share/man/man4/audio.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: audio.4,v 1.12 1997/08/26 19:03:55 augustss Exp $
+.\"	$NetBSD: audio.4,v 1.13 1997/10/06 16:00:55 augustss Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -215,7 +215,7 @@ the device admits full duplex operation.
 the device can be used with
 .Xr mmap 2 .
 .It Dv AUDIO_PROP_INDEPENDENT
-the device can set the playing and recording encoding paramaters
+the device can set the playing and recording encoding parameters
 independently.
 .El
 .It Dv AUDIO_GETIOFFS (audio_offset_t)
@@ -554,6 +554,7 @@ because they use a name from one of the AudioC* string values.
 .br
 For ports using the ISA bus:
 .Xr gus 4 ,
+.Xr guspnp 4 ,
 .Xr pas 4 ,
 .Xr pss 4 ,
 .Xr sb 4 ,

share/man/man4/guspnp.4

@@ -0,0 +1,106 @@
+.\"	$NetBSD: guspnp.4,v 1.1 1997/10/06 16:01:02 augustss Exp $
+.\"
+.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Author: Kari Mettinen
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
+.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+
+.Dd Oct 5, 1997
+.Dt guspnp 4 "Am78C201 device driver" "Version 1.0"
+.Sh NAME
+guspnp \- Am78C201 device driver
+.Sh SYNOPSIS
+.Cd "guspnp* at isapnp?"
+.Cd "audio*  at guspnp?"
+.Pp
+There should be no limit caused by the driver on the number of drivers
+or cards active in the system.
+.Sh DESCRIPTION
+The
+.Nm guspnp
+driver provides support for audiosubsystems using the Interwave (Am78C20x)
+family of ICs, usually the Gravis Ultrasound Plug and Play. Unlike the
+.Nm gus
+driver guspnp driver does not require any local memory for the IC, but uses
+the codec for both playback and recording. The
+.Nm guspnp
+driver can simultaneously playback and record 8- and 16-bit samples at 
+frequencies from 5.51kHz to 48kHz. 
+.Pp
+The
+.Nm guspnp
+driver relies on 
+.Nm isapnp
+to allocate suitable resources for it. This version of the driver only
+uses the first logical device of 5 the interwave IC has. The 4 Unused
+logical devices are ATAPI CD-ROM device, PnP Joystick device, Legacy
+soundcard emulation device (Soundblaster) and MIDI serial device. Support
+for atleast ATAPI CD-ROM and Joystick is being worked on.
+This version of the driver will use 1 IRQ and 2 DRQs.
+.Sh BUGS
+Sometimes you can cause a hiss on either left or right channel, or both.
+You can usually make it disappear by playing random data, however this
+might not be a very nice thing to your audio equipment, but it is the only
+way I have found out to be effective.
+.Pp
+Only the Codec is used in this version of the driver, therefore only 2
+channels are supported (left and right). Also sound quality is propably
+worse at lower kHz compared to playing through the synthesizer which does
+interpolation.
+.Pp
+If the implementation has a 'bad' oscillator, using frequencies 44.8kHz
+and 38.4kHz will result in incorrect playback frequency. The author has
+a GUS PnP Pro which displays this behaviour.
+.Pp
+Other members of the Interwave family have not been tested and don't
+have the glue needed to make them work. Should someone need to implement it,
+not many changes in the existing code are needed. Output voltage control in
+register CFIG2 [7] should be set differently for some other members of the
+family.
+.Pp
+Other architectures than i386 haven't been tested. The bus_space abstraction
+has been used from the beginning, so it should work.
+.Sh SEE ALSO
+.Xr audio 4 ,
+.Xr isapnp 4 ,
+.Xr gus 4
+.Sh AUTHOR
+Kari Mettinen (Kari.Mettinen@helsinki.fi), University of Helsinki.
+.Sh REFERENCES
+Interwave(tm) IC Am78C201/202 Programmer's Guide Rev. 2. 1996. Advanced
+Micro Devices.
+.Sh HISTORY
+The
+.Nm guspnp
+driver appeared in 
+.Nx 1.3 .
+