>Number:         1757
>Category:       port-i386
>Synopsis:       wss(4) and pss(4) do not exist
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    gnats-admin (GNATS administrator)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Nov 12 17:20:00 1995
>Last-Modified:
>Originator:     Mike Long <mike.long@analog.com>
>Organization:
	Procrastinators Anonymous
>Release:        951010
>Environment:
	
System: NetBSD azathoth 1.1_ALPHA NetBSD 1.1_ALPHA (AZATHOTH) #14: Fri Nov 10 01:10:55 EST 1995 root@azathoth:/usr/src/sys/arch/i386/compile/AZATHOTH i386


>Description:
	There are no man pages for the wss and pss audio drivers.
>How-To-Repeat:
	man wss
	man pss
>Fix:
	Apply the patch:

*** /dev/null	Sun Nov 12 14:49:14 1995
--- /usr/src/share/man/man4/man4.i386/wss.4	Wed Nov  8 03:34:35 1995
***************
*** 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


*** /dev/null	Sun Nov 12 14:49:14 1995
--- /usr/src/share/man/man4/man4.i386/pss.4	Wed Nov  8 03:35:34 1995
***************
*** 0 ****
--- 1,72 ----
+ .\"   $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.

>Audit-Trail:
>Unformatted: