1.\" $OpenBSD: ess.4,v 1.4 2001/10/05 14:45:53 mpech Exp $ 2.\" $NetBSD: ess.4,v 1.6 1999/04/13 20:25:29 augustss Exp $ 3.\" 4.\" Copyright (c) 1999 The NetBSD Foundation, Inc. 5.\" All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. All advertising materials mentioning features or use of this software 16.\" must display the following acknowledgement: 17.\" This product includes software developed by the NetBSD 18.\" Foundation, Inc. and its contributors. 19.\" 4. Neither the name of The NetBSD Foundation nor the names of its 20.\" contributors may be used to endorse or promote products derived 21.\" from this software without specific prior written permission. 22.\" 23.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 24.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 25.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 26.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 27.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 28.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 29.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 30.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 31.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 32.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 33.\" POSSIBILITY OF SUCH DAMAGE. 34.\" 35.Dd August 5, 1999 36.Dt ESS 4 37.Os 38.Sh NAME 39.Nm ess 40.Nd ESS Technology AudioDrive family audio device driver 41.Sh SYNOPSIS 42.\" .Cd "ess0 at isa? port 0x220 irq 5 drq 1 drq2 5" 43.Cd "ess* at isapnp?" 44.\" .Cd "ess* at ofisa?" 45.Cd "audio* at ess?" 46.Sh DESCRIPTION 47The 48.Nm 49driver provides support for the ESS 1788, 1888, 1887, and 888 AudioDrive 50audio devices. 51.Pp 52The AudioDrive 1788 is a half-duplex device, while the 1888, 1887, and 53888 are full-duplex. 54All are capable of 8- and 16-bit audio sample recording and playback 55at rates up to 44.1kHz. 56.Pp 57The AudioDrive takes 16 I/O ports. 58The I/O port range, IRQ, and DRQ channels are set by the driver 59to the vaues specified in the configuration file (or for isapnp or ofisa, 60the values assigned from the firmware). 61The I/O port base must be one of 0x220, 0x230, 0x240, 620x250. 63The IRQ must be one of 5, 7, 9, 10 (or 15 on the 1887 only). 64The first DRQ channel must be selected from 0, 1, 3. 65The second DRQ channel (used for playback by the full-duplex 1888/1887, ignored 66by the 1788) can additionally be set to 5. 67If both DRQ channels are used they must be different. 68.Pp 69The joystick interface (if enabled) is handled by the 70.Xr joy 4 71driver. 72.Sh BUGS 73The AudioDrive devices have a SoundBlaster compatibility mode, and may 74be detected by the SoundBlaster driver (see 75.Xr sb 4 ) 76rather than the AudioDrive driver. 77The workaround is to remove the SoundBlaster driver from the kernel 78configuration. 79.Sh SEE ALSO 80.Xr audio 4 , 81.Xr isa 4 , 82.Xr isapnp 4 , 83.Xr joy 4 84.Sh HISTORY 85The 86.Nm 87device driver appeared in 88.Ox 2.2 . 89