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