1.\" $OpenBSD: gus.4,v 1.11 2001/08/03 14:30:26 mpech Exp $ 2.\" $NetBSD: gus.4,v 1.7 1997/10/08 21:59:55 jtc Exp $ 3.\" 4.\" Copyright (c) 1996 The NetBSD Foundation, Inc. 5.\" All rights reserved. 6.\" 7.\" This code is derived from software contributed to The NetBSD Foundation 8.\" by John T. Kohl. 9.\" 10.\" Redistribution and use in source and binary forms, with or without 11.\" modification, are permitted provided that the following conditions 12.\" are met: 13.\" 1. Redistributions of source code must retain the above copyright 14.\" notice, this list of conditions and the following disclaimer. 15.\" 2. Redistributions in binary form must reproduce the above copyright 16.\" notice, this list of conditions and the following disclaimer in the 17.\" documentation and/or other materials provided with the distribution. 18.\" 3. All advertising materials mentioning features or use of this software 19.\" must display the following acknowledgement: 20.\" This product includes software developed by the NetBSD 21.\" Foundation, Inc. and its contributors. 22.\" 4. Neither the name of The NetBSD Foundation nor the names of its 23.\" contributors may be used to endorse or promote products derived 24.\" from this software without specific prior written permission. 25.\" 26.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 27.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 28.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 29.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE 30.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 31.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 32.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 33.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 34.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 35.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 36.\" POSSIBILITY OF SUCH DAMAGE. 37.\" 38.Dd November 4, 1995 39.Dt GUS 4 i386 40.Os 41.Sh NAME 42.Nm gus 43.Nd Gravis UltraSound/UltraSound MAX device driver 44.Sh SYNOPSIS 45.Cd "gus0 at isa? port 0xPPP irq X drq Y drq2 Z" 46.Cd "gus* at isapnp?" 47.Cd "audio* at gus?" 48.Sh DESCRIPTION 49The 50.Nm 51driver provides support for the Gravis UltraSound (GUS) and GUS MAX 52audio cards. 53Both cards have on-board memory which is used for seamless playback of samples. 54They can play back 8- or 16-bit samples at up to 44.1kHz. 55They can record 8-bit samples at up to 44.1kHz. 56The UltraSound MAX is a full-duplex sound device, and if configured with two 57DRQ channels can be used for simultaneous playback and recording. 58The I/O port base is jumper-selected, and may be chosen from 0x210-0x260 in 59steps of 0x10. 60(The normal setting is 0x220.) 61The GUS takes 16 ports at its base address and 8 ports at its base address + 620x100. 63.Pp 64The IRQ is software programmed, so you may select any IRQ from the set 65{3,5,7,9,11,12,15}. 66The DRQ lines are software programmed, and may be chosen from {1,3,5,6,7}. 67The 68.Dq drq2 69field in the configuration file line specifies a second DRQ line for recording. 70If there is no drq2 field in the config file, the playback channel will be 71used for recording DMA and only half-duplex mode will be available. 72.Pp 73The Gravis UltraSound MAX has an additional CODEC onboard which is 74addressed with four ports at an offset of 0x10C from the base ports 75(0x31C-0x36C). 76.Sh SEE ALSO 77.Xr audio 4 78.Sh REFERENCES 79Gravis UltraSound Low-Level Toolkit, Revision 2.01, 20 May 1993, 80published by Advanced Gravis and Forte Technologies. 81.Pp 82If you wish to use 83.Xr wdc 4 84on the ISAPNP version of the card, and it comes up as DISABLED, 85Gravis has a PNPCFG.EXE program which re-enables it. 86.Sh HISTORY 87The 88.Nm 89device driver appeared in 90.Nx 1.1 . 91.Sh BUGS 92The full-duplex features of the GUS MAX have not been fully tested, and 93full-duplex on the original GUS may not be possible at all. 94.Pp 95Only two voices on the GF1 synthesizer chip are used by this driver (for 96left and right channels). 97.Pp 98Manipulating the mixer while audio samples are playing can lead to 99device driver confusion (and maybe even a system panic). 100.Pp 101Manipulating the mixer device seems to create pregnant system pauses, 102probably due to excessive interrupt masking. 103.Pp 104The joystick and MIDI port interfaces are not supported. 105