wss/pss man pages; from mike.long@analog.com; netbsd pr #1757

3 files changed, 126 insertions, 2 deletions

diff --git a/share/man/man4/man4.i386/Makefile b/share/man/man4/man4.i386/Makefile
index 361b39afd2a..59e0c8f057e 100644
--- a/share/man/man4/man4.i386/Makefile
+++ b/share/man/man4/man4.i386/Makefile
@@ -1,9 +1,9 @@
 #	from: @(#)Makefile	5.1 (Berkeley) 2/12/91
-#	$Id: Makefile,v 1.2 1995/11/13 04:41:15 deraadt Exp $
+#	$Id: Makefile,v 1.3 1995/11/13 04:42:59 deraadt 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 gus.4 lms.4 lpt.4 mcd.4 mem.4 mms.4 ncr.4 npx.4
-MAN+=	pms.4 rtfps.4 sea.4 sb.4 speaker.4 uha.4 wd.4
+MAN+=	pms.4 pss.4 rtfps.4 sea.4 sb.4 speaker.4 uha.4 wd.4 wss.4
 MAN+=	eg.4 el.4 ie.4 le.4 wt.4
 
 MLINKS=	mem.4 kmem.4
diff --git a/share/man/man4/man4.i386/pss.4 b/share/man/man4/man4.i386/pss.4
new file mode 100644
index 00000000000..927261ee220
--- /dev/null
+++ b/share/man/man4/man4.i386/pss.4
@@ -0,0 +1,71 @@
+.\"   $NetBSD$
+.\"
+.\" Copyright (c) 1995 Michael Long.
+.\" 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 8, 1995
+.Dt PSS 4 i386
+.Os NetBSD
+.Sh NAME
+.Nm pss
+.Nd Personal Sound System hardware driver
+.Sh SYNOPSIS
+.Cd "device pss0 at isa?"
+.Cd "device sp0 at pss? port 0x530 irq 10 drq 0"
+.Sh DESCRIPTION
+The
+.Nm
+driver supports soundcards based on ESC614 or ESC614A ASICs and AD1848
+or CS4231 series codecs.  Known examples are:
+.Pp
+.Bl -tag -width -offset indent -compact
+.It Cardinal Digital Sound Pro 16
+.It Orchid SoundWave 32
+.El
+.Pp
+The Orchid GameWave 32 is based on the ESC614 ASIC, but is not
+supported because it does not have a codec.
+.Pp
+The
+.Nm
+driver uses the Windows Sound System emulation mode of the ASIC.
+It is a half-duplex device.
+.Sh SEE ALSO
+.Xr audio 4 ,
+.Xr wss 4
+.Sh BUGS
+This driver doesn't work yet.
+.Pp
+The list of cards using the PSS chipset is incomplete.
+.Pp
+The ESC614 (version 1) is unable to reliably determine whether DMA
+channels are free on some motherboards.  The ASIC determines that all
+channels are taken, even if that is untrue.  When this happens, the driver
+cannot verify configured DMA channels with the ASIC's DMA autodetect
+hardware, so it blindly accepts the user setting.
+.Pp
+Cards based on the ESC615 ASIC are not supported.
+.Pp
+The MIDI port, joystick, and CD-ROM drive (if present) are not supported.
diff --git a/share/man/man4/man4.i386/wss.4 b/share/man/man4/man4.i386/wss.4
new file mode 100644
index 00000000000..2d60c2b99fa
--- /dev/null
+++ b/share/man/man4/man4.i386/wss.4
@@ -0,0 +1,53 @@
+.\"   $NetBSD$
+.\"
+.\" Copyright (c) 1995 Michael Long.
+.\" 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 8, 1995
+.Dt WSS 4 i386
+.Os NetBSD
+.Sh NAME
+.Nm wss
+.Nd Windows Sound System hardware driver
+.Sh SYNOPSIS
+.Cd "device wss0 at isa? port 0x530 irq 10 drq 0"
+.Sh DESCRIPTION
+The
+.Nm
+driver supports Microsoft's Windows Sound System hardware and its clones.
+The Windows Sound System is a half-duplex device.
+.Pp
+The base I/O port is set by a jumper on the board; valid choices are
+0x530, 0x604, 0xE80, or 0xF40.
+Both IRQ and DMA channels are software programmable.
+The IRQ may be set to 7, 9, 10, or 11, and
+the DMA channel may be set to 0, 1, or 3.
+.Sh BUGS
+This driver doesn't work yet.
+.Pp
+The FM synthesizer is not supported.
+.Sh SEE ALSO
+.Xr audio 4 ,
+.Xr pss 4