Mention isa attachment and 1788 support.

Explain more about the allowed ISA parameters.
Mention SoundBlaster compatibilty and cross-detection.
This commit is contained in:
nathanw 1999-03-03 17:07:13 +00:00
parent 206c18b1cb
commit 1e27c5d843
1 changed files with 34 additions and 19 deletions

View File

@ -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