diff --git a/share/man/man4/gus.4 b/share/man/man4/gus.4 new file mode 100644 index 000000000000..95f880d3a7b9 --- /dev/null +++ b/share/man/man4/gus.4 @@ -0,0 +1,85 @@ +.\" $NetBSD: gus.4,v 1.1 1995/11/13 14:39:16 pk Exp $ +.\" Copyright (c) 1995 John T. Kohl +.\" All rights reserved. +.\" +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR `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 AUTHOR 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 November 4, 1995 +.Dt GUS 4 i386 +.Os +.Sh NAME +.Nm gus +.Nd +Gravis UltraSound/UltraSound MAX device driver +.Sh SYNOPSIS +.Cd "gus0 at isa? port 0xPPP irq X drq Y flags Z" +.Sh DESCRIPTION +The +.Nm gus +driver provides support for the Gravis UltraSound (GUS) and GUS MAX +audio cards. Both cards have on-board memory which is used for +seamless playback of samples. They can play back 8- or 16-bit samples +at up to 44.1kHz. They can record 8-bit samples at up to 44.1kHz. +The UltraSound MAX is a full-duplex sound device, and if +configured with two DRQ channels can be used for simultaneous playback +and recording. The I/O port base is jumper-selected, and may be chosen +from 0x210-0x260 in steps of 0x10. (The normal setting is 0x220.) The +GUS takes 16 ports at its base address and 8 ports at its base address + +0x100. +.Pp +The IRQ is software programmed, so you may select any IRQ from the set +{3,5,7,9,11,12,15}. The DRQ lines are software programmed, and may be +chosen from {1,3,5,6,7}. The flags field in the configuration file line +specifies a second DRQ line for recording. If there is no flags field +in the config file, the playback channel will be used for recording DMA +and only half-duplex mode will be available. +.Pp +The Gravis UltraSound MAX has an additional CODEC onboard which is +addressed with four ports at an offset of 0x10C from the base ports +(0x31C-0x36C). +.Sh BUGS +The full-duplex features of the GUS MAX have not been fully tested, and +full-duplex on the original GUS may not be possible at all. +.Pp +Only two voices on the GF1 synthesizer chip are used by this driver (for +left and right channels). +.Pp +Manipulating the mixer while audio samples are playing can lead to +device driver confusion (and maybe even a system panic). +.Pp +Manipulating the mixer device seems to create pregnant system pauses, +probably due to excessive interrupt masking. +.Pp +The joystick and MIDI port interfaces are not supported. +.Sh SEE ALSO +.Xr audio 4 +.Sh REFERENCES +Gravis UltraSound Low-Level Toolkit, Revision 2.01, 20 May 1993, +published by Advanced Gravis and Forte Technologies. +.Sh HISTORY +The +.Nm gus +device driver appeared in +.Nx 1.1 . diff --git a/share/man/man4/man4.i386/Makefile b/share/man/man4/man4.i386/Makefile index 9b24f716ae04..7d75e68025f0 100644 --- a/share/man/man4/man4.i386/Makefile +++ b/share/man/man4/man4.i386/Makefile @@ -1,11 +1,11 @@ # from: @(#)Makefile 5.1 (Berkeley) 2/12/91 -# $Id: Makefile,v 1.16 1995/11/13 09:44:13 pk Exp $ +# $Id: Makefile,v 1.17 1995/11/13 14:39:14 pk Exp $ MAN= intro.4 aha.4 ahb.4 aic.4 ast.4 autoconf.4 boca.4 bt.4 MAN+= com.4 cy.4 ed.4 ep.4 lms.4 lpt.4 mcd.4 mem.4 mms.4 ncr.4 npx.4 pms.4 MAN+= rtfps.4 sea.4 speaker.4 uha.4 wd.4 MAN+= eg.4 el.4 ie.4 le.4 wt.4 -MAN+= pss.4 wss.4 +MAN+= gus.4 pss.4 sb.4 wss.4 MLINKS= mem.4 kmem.4 MANSUBDIR=/i386 diff --git a/share/man/man4/man4.i386/gus.4 b/share/man/man4/man4.i386/gus.4 new file mode 100644 index 000000000000..95f880d3a7b9 --- /dev/null +++ b/share/man/man4/man4.i386/gus.4 @@ -0,0 +1,85 @@ +.\" $NetBSD: gus.4,v 1.1 1995/11/13 14:39:16 pk Exp $ +.\" Copyright (c) 1995 John T. Kohl +.\" All rights reserved. +.\" +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR `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 AUTHOR 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 November 4, 1995 +.Dt GUS 4 i386 +.Os +.Sh NAME +.Nm gus +.Nd +Gravis UltraSound/UltraSound MAX device driver +.Sh SYNOPSIS +.Cd "gus0 at isa? port 0xPPP irq X drq Y flags Z" +.Sh DESCRIPTION +The +.Nm gus +driver provides support for the Gravis UltraSound (GUS) and GUS MAX +audio cards. Both cards have on-board memory which is used for +seamless playback of samples. They can play back 8- or 16-bit samples +at up to 44.1kHz. They can record 8-bit samples at up to 44.1kHz. +The UltraSound MAX is a full-duplex sound device, and if +configured with two DRQ channels can be used for simultaneous playback +and recording. The I/O port base is jumper-selected, and may be chosen +from 0x210-0x260 in steps of 0x10. (The normal setting is 0x220.) The +GUS takes 16 ports at its base address and 8 ports at its base address + +0x100. +.Pp +The IRQ is software programmed, so you may select any IRQ from the set +{3,5,7,9,11,12,15}. The DRQ lines are software programmed, and may be +chosen from {1,3,5,6,7}. The flags field in the configuration file line +specifies a second DRQ line for recording. If there is no flags field +in the config file, the playback channel will be used for recording DMA +and only half-duplex mode will be available. +.Pp +The Gravis UltraSound MAX has an additional CODEC onboard which is +addressed with four ports at an offset of 0x10C from the base ports +(0x31C-0x36C). +.Sh BUGS +The full-duplex features of the GUS MAX have not been fully tested, and +full-duplex on the original GUS may not be possible at all. +.Pp +Only two voices on the GF1 synthesizer chip are used by this driver (for +left and right channels). +.Pp +Manipulating the mixer while audio samples are playing can lead to +device driver confusion (and maybe even a system panic). +.Pp +Manipulating the mixer device seems to create pregnant system pauses, +probably due to excessive interrupt masking. +.Pp +The joystick and MIDI port interfaces are not supported. +.Sh SEE ALSO +.Xr audio 4 +.Sh REFERENCES +Gravis UltraSound Low-Level Toolkit, Revision 2.01, 20 May 1993, +published by Advanced Gravis and Forte Technologies. +.Sh HISTORY +The +.Nm gus +device driver appeared in +.Nx 1.1 . diff --git a/share/man/man4/man4.i386/sb.4 b/share/man/man4/man4.i386/sb.4 new file mode 100644 index 000000000000..847821a0d4b1 --- /dev/null +++ b/share/man/man4/man4.i386/sb.4 @@ -0,0 +1,68 @@ +.\" $NetBSD: sb.4,v 1.1 1995/11/13 14:39:15 pk Exp $ +.\" Copyright (c) 1995 John T. Kohl +.\" All rights reserved. +.\" +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR `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 AUTHOR 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 November 4, 1995 +.Dt SB 4 i386 +.Os +.Sh NAME +.Nm sb +.Nd +SoundBlaster family (and compatibles) audio device driver +.Sh SYNOPSIS +.Cd "sb0 at isa? port 0xPPP irq X drq Y" +.Sh DESCRIPTION +The +.Nm sb +driver provides support for the SoundBlaster, SoundBlaster Pro, +SoundBlaster 16, and hardware register-level compatible audio cards. +.Pp +The SoundBlaster series are half-duplex cards, capable of 8- and 16-bit +audio sample recording and playback at rates up to 44.1kHz (depending on +the particular model). +.Pp +The base I/O port address is usually jumper-selected to either 0x220 or +0x240 (newer cards may provide software configuration, but this driver +does not directly support them--you must configure the card for its I/O +addresses with other software). The SoundBlaster takes 16 I/O ports. +For the SoundBlaster and SoundBlaster Pro, the IRQ and DRQ channels are +jumper-selected. For the SoundBlaster 16, the IRQ and DRQ channels are +set by this driver to the values specified in the config file. The IRQ +must be selected from the set {5,7,9,10}. +.Pp +.Sh BUGS +The driver has not been extensively tested on original SoundBlaster, +SoundBlaster 16, or newer cards. +.Pp +The FM synthesizer, joystick and MIDI port interfaces are not supported. +.Sh SEE ALSO +.Xr audio 4 +.Sh HISTORY +The +.Nm gus +device driver appeared in +.Nx 1.1 . diff --git a/share/man/man4/sb.4 b/share/man/man4/sb.4 new file mode 100644 index 000000000000..847821a0d4b1 --- /dev/null +++ b/share/man/man4/sb.4 @@ -0,0 +1,68 @@ +.\" $NetBSD: sb.4,v 1.1 1995/11/13 14:39:15 pk Exp $ +.\" Copyright (c) 1995 John T. Kohl +.\" All rights reserved. +.\" +.\" 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. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR `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 AUTHOR 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 November 4, 1995 +.Dt SB 4 i386 +.Os +.Sh NAME +.Nm sb +.Nd +SoundBlaster family (and compatibles) audio device driver +.Sh SYNOPSIS +.Cd "sb0 at isa? port 0xPPP irq X drq Y" +.Sh DESCRIPTION +The +.Nm sb +driver provides support for the SoundBlaster, SoundBlaster Pro, +SoundBlaster 16, and hardware register-level compatible audio cards. +.Pp +The SoundBlaster series are half-duplex cards, capable of 8- and 16-bit +audio sample recording and playback at rates up to 44.1kHz (depending on +the particular model). +.Pp +The base I/O port address is usually jumper-selected to either 0x220 or +0x240 (newer cards may provide software configuration, but this driver +does not directly support them--you must configure the card for its I/O +addresses with other software). The SoundBlaster takes 16 I/O ports. +For the SoundBlaster and SoundBlaster Pro, the IRQ and DRQ channels are +jumper-selected. For the SoundBlaster 16, the IRQ and DRQ channels are +set by this driver to the values specified in the config file. The IRQ +must be selected from the set {5,7,9,10}. +.Pp +.Sh BUGS +The driver has not been extensively tested on original SoundBlaster, +SoundBlaster 16, or newer cards. +.Pp +The FM synthesizer, joystick and MIDI port interfaces are not supported. +.Sh SEE ALSO +.Xr audio 4 +.Sh HISTORY +The +.Nm gus +device driver appeared in +.Nx 1.1 .