From 1e27c5d843f108fbb7e6458405b9a16c3f11fc48 Mon Sep 17 00:00:00 2001
From: nathanw <nathanw@NetBSD.org>
Date: Wed, 3 Mar 1999 17:07:13 +0000
Subject: [PATCH] Mention isa attachment and 1788 support. Explain more about
 the allowed ISA parameters. Mention SoundBlaster compatibilty and
 cross-detection.

---
 share/man/man4/ess.4 | 53 ++++++++++++++++++++++++++++----------------
 1 file changed, 34 insertions(+), 19 deletions(-)

diff --git a/share/man/man4/ess.4 b/share/man/man4/ess.4
index 8227c324d3d8..2742ab40a01c 100644
--- a/share/man/man4/ess.4
+++ b/share/man/man4/ess.4
@@ -1,8 +1,8 @@
-.\" $NetBSD: ess.4,v 1.3 1998/08/26 12:30:51 augustss Exp $
-.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
+.\"	$NetBSD: ess.4,v 1.4 1999/03/03 17:07:13 nathanw Exp $
+.\"
+.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
-
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
@@ -31,36 +31,51 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd August 1, 1998
+.Dd February 18, 1999
 .Dt ESS 4
 .Os NetBSD
 .Sh NAME
 .Nm ess
-.Nd ESS Technology sound driver 
+.Nd ESS Technology AudioDrive family audio device driver
 .Sh SYNOPSIS
-.Cd "device ess0 at isa? port 0x220 irq 5 drq 0 drq2 1"
-.Cd "device ess* at ofisa?"
-.Cd "device ess* at isapnp?"
-.Cd "audio*      at ess?"
-.Cd "opl*        at ess?"
+.Cd "ess0   at isa? port 0x220 irq 5 drq 1 drq2 5"
+.Cd "ess*   at isapnp?"
+.Cd "ess*   at ofisa?"
+.Cd "audio* at ess?"
 .Sh DESCRIPTION
 The
 .Nm
-driver supports card based on ESS Technology 1887, 1888, and 888.
+driver provides support for the ESS 1788, 1888, 1887, and 888 AudioDrive 
+audio devices.
 .Pp
-Valid I/O addresses are
-0x220, 0x230, 0x240, or 0x250.
-Both IRQ and DMA channels are software programmable.
-The IRQ may be set to 5, 7, 9 or 10, and on the 1887 also to 15.
-The DMA channels may be set to 0, 1, or 3, and on the 1887 the second
-channel also to 5.
+The AudioDrive 1788 is a half-duplex device, while the 1888, 1887, and
+888 are full-duplex. All are capable of 8- and 16-bit audio sample
+recording and playback at rates up to 44.1kHz.
 .Pp
+The AudioDrive takes 16 I/O ports. The I/O port range, IRQ, and DRQ
+channels are set by the driver to the vaues specified in the
+configuration file (or for isapnp or ofisa, the values assigned from
+the firmware). The I/O port base must be one of 0x220, 0x230, 0x240,
+0x250. The IRQ must be one of 5, 7, 9, 10 (or 15 on the 1887
+only). The first DRQ channel must be selected from 0, 1, 3. The second
+DRQ channel (used for playback by the full-duplex 1888/1887, ignored
+by the 1788) can additionally be set to 5. If both DRQ channels are
+used they must be different.
+.Pp
+The joystick interface (if enabled) is handled by the
+.Xr joy 4
+driver. 
+.Sh BUGS
+The AudioDrive devices have a SoundBlaster compatibility mode, and may
+be detected by the SoundBlaster driver (see 
+.Xr sb 4 )  
+rather than the AudioDrive driver. The workaround is to remove the
+SoundBlaster driver from the kernel configuration.
 .Sh SEE ALSO
 .Xr audio 4 ,
 .Xr isa 4 ,
 .Xr isapnp 4 ,
-.Xr ofisa 4 ,
-.Xr opl 4
+.Xr joy 4
 .Sh HISTORY
 The
 .Nm