1.\" $OpenBSD: gus.4,v 1.15 2008/06/26 05:42:07 ray 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.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 20.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 21.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 22.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE 23.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 29.\" POSSIBILITY OF SUCH DAMAGE. 30.\" 31.Dd $Mdocdate: June 26 2008 $ 32.Dt GUS 4 i386 33.Os 34.Sh NAME 35.Nm gus 36.Nd Gravis UltraSound/UltraSound MAX audio device 37.Sh SYNOPSIS 38.Cd "gus0 at isa? port 0x220 irq 7 drq 1 drq2 6" 39.Cd "gus* at isapnp?" 40.Cd "audio* at gus?" 41.Sh DESCRIPTION 42The 43.Nm 44driver provides support for the Gravis UltraSound (GUS) and GUS MAX 45audio cards. 46Both cards have on-board memory which is used for seamless playback of samples. 47They can play back 8- or 16-bit samples at up to 44.1kHz. 48They can record 8-bit samples at up to 44.1kHz. 49The UltraSound MAX is a full-duplex sound device, and if configured with two 50DRQ channels can be used for simultaneous playback and recording. 51The I/O port base is jumper-selected, and may be chosen from 0x210-0x260 in 52steps of 0x10. 53(The normal setting is 0x220.) 54The GUS takes 16 ports at its base address and 8 ports at its base address + 550x100. 56.Pp 57The IRQ is software programmed, so you may select any IRQ from the set 58{3,5,7,9,11,12,15}. 59The DRQ lines are software programmed, and may be chosen from {1,3,5,6,7}. 60The 61.Dq drq2 62field in the configuration file line specifies a second DRQ line for recording. 63If there is no drq2 field in the config file, the playback channel will be 64used for recording DMA and only half-duplex mode will be available. 65.Pp 66The Gravis UltraSound MAX has an additional CODEC onboard which is 67addressed with four ports at an offset of 0x10C from the base ports 68(0x31C-0x36C). 69.Sh SEE ALSO 70.Xr audio 4 , 71.Xr intro 4 , 72.Xr isa 4 , 73.Xr isapnp 4 74.Sh REFERENCES 75Gravis UltraSound Low-Level Toolkit, Revision 2.01, 20 May 1993, 76published by Advanced Gravis and Forte Technologies. 77.Pp 78If you wish to use 79.Xr wdc 4 80on the ISAPNP version of the card, and it comes up as DISABLED, 81Gravis has a PNPCFG.EXE program which re-enables it. 82.Sh HISTORY 83The 84.Nm 85device driver appeared in 86.Nx 1.1 . 87.Sh BUGS 88The full-duplex features of the GUS MAX have not been fully tested, and 89full-duplex on the original GUS may not be possible at all. 90.Pp 91Only two voices on the GF1 synthesizer chip are used by this driver (for 92left and right channels). 93.Pp 94Manipulating the mixer while audio samples are playing can lead to 95device driver confusion (and maybe even a system panic). 96.Pp 97Manipulating the mixer device seems to create pregnant system pauses, 98probably due to excessive interrupt masking. 99.Pp 100The joystick and MIDI port interfaces are not supported. 101