[src/trunk]: src Add the esl driver.

[augustss <augustss%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a92a9603346e
branches:  trunk
changeset: 515608:a92a9603346e
user:      augustss <augustss%NetBSD.org@localhost>
date:      Sat Sep 29 18:46:16 2001 +0000

description:
Add the esl driver.

diffstat:

 share/man/man4/Makefile     |   6 +-
 share/man/man4/esl.4        |  80 +++++++++++++++++++++++++++++++++++++++++++++
 sys/arch/i386/conf/GENERIC  |   9 +++-
 sys/dev/pcmcia/files.pcmcia |  12 ++++++-
 4 files changed, 101 insertions(+), 6 deletions(-)

diffs (167 lines):

diff -r c746ecc397ae -r a92a9603346e share/man/man4/Makefile
--- a/share/man/man4/Makefile   Sat Sep 29 18:13:48 2001 +0000
+++ b/share/man/man4/Makefile   Sat Sep 29 18:46:16 2001 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.227 2001/09/22 16:29:34 ad Exp $
+#      $NetBSD: Makefile,v 1.228 2001/09/29 18:50:42 augustss Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   acphy.4 adv.4 adw.4 agp.4 ahb.4 ahc.4 amhphy.4 an.4 aria.4 \
@@ -7,8 +7,8 @@
        bridge.4 cac.4 cardbus.4 ccd.4 cd.4 cfb.4 ch.4 clcs.4 clct.4 \
        clnp.4 cltp.4 \
        cmpci.4 cms.4 cnw.4 com.4 ddb.4 de.4 dmphy.4 dpt.4 dpti.4 drum.4 eap.4 \
-       edc.4 elmc.4 en.4 envsys.4 ep.4 esh.4 esis.4 esm.4 eso.4 exphy.4 fd.4 \
-       fpa.4 fms.4 fxp.4 gentbi.4 glxtphy.4 gre.4 gphyter.4 gsip.4 hme.4 \
+       edc.4 elmc.4 en.4 envsys.4 ep.4 esh.4 esis.4 esl.4 esm.4 eso.4 exphy.4 \
+       fd.4 fpa.4 fms.4 fxp.4 gentbi.4 glxtphy.4 gre.4 gphyter.4 gsip.4 hme.4 \
        icmp.4 icsphy.4 idp.4 ifmedia.4 iha.4 inet.4 inphy.4 intersil7170.4 \
        ioasic.4 ioat.4 \
        iop.4 iophy.4 iopsp.4 ip.4 ipip.4 ipkdb.4 iso.4 isp.4 lc.4 ld.4 lkm.4 \
diff -r c746ecc397ae -r a92a9603346e share/man/man4/esl.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/esl.4      Sat Sep 29 18:46:16 2001 +0000
@@ -0,0 +1,80 @@
+.\"    $NetBSD: esl.4,v 1.1 2001/09/29 18:50:42 augustss Exp $
+.\"
+.\" Copyright (c) 2001 Jared D. McNeill <jmcneill%invisible.yi.org@localhost>
+.\" 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. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by Jared D. McNeill.
+.\" 4. Neither the name of the author nor the names of any
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 July 20, 2001
+.Dt ESL 4
+.Os
+.Sh NAME
+.Nm esl
+.Nd ESS Technology AudioDrive (Programmed I/O mode) family audio device driver
+.Sh SYNOPSIS
+.Cd "esl*   at pcmcia? function ?"
+.Cd "audio* at esl?"
+.Cd "opl*   at esl?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the ESS 1688 AudioDrive audio devices on a
+PCMCIA card.
+.Pp
+Since there is no way to do DMA over the pcmcia bus, the
+.Nm
+driver uses a Programmed I/O mode to drive the cards. This is very
+inefficient, but is the only way to drive such a card.
+.Pp
+Cards supported by this driver are capable of 8- and 16-bit audio sample
+playback at rates up to 44.1kHz. 
+.Sh BUGS
+.Pp
+Putting a machine into suspend mode while this driver is active will
+cause the machine to freeze.
+.Pp
+When the card is removed, the 
+.Xr opl 4
+device isn't detached (and as a result, neither is the
+.Xr midi 4
+device). This causes multiple copies of each driver to be present after
+many removes / inserts.
+.Pp
+Recording is not yet supported by this driver.
+.Sh SEE ALSO
+.Xr audio 4 ,
+.Xr pcmcia 4 ,
+.Xr opl 4 ,
+.Xr midi 4
+.Sh AUTHOR
+Jared D. McNeill <jmcneill%invisible.yi.org@localhost>
+.Sh HISTORY
+The
+.Nm
+device driver appeared in
+.Nx 1.6 .
diff -r c746ecc397ae -r a92a9603346e sys/arch/i386/conf/GENERIC
--- a/sys/arch/i386/conf/GENERIC        Sat Sep 29 18:13:48 2001 +0000
+++ b/sys/arch/i386/conf/GENERIC        Sat Sep 29 18:46:16 2001 +0000
@@ -1,11 +1,11 @@
-#      $NetBSD: GENERIC,v 1.427 2001/09/21 23:44:21 ad Exp $
+#      $NetBSD: GENERIC,v 1.428 2001/09/29 18:47:07 augustss Exp $
 #
 #      GENERIC -- everything that's currently supported
 #
 
 include "arch/i386/conf/std.i386"
 
-#ident                 "GENERIC-$Revision: 1.427 $"
+#ident                 "GENERIC-$Revision: 1.428 $"
 
 maxusers       32              # estimated number of users
 
@@ -819,10 +819,14 @@
 sb0    at isa? port 0x220 irq 5 drq 1 drq2 5   # SoundBlaster
 wss0   at isa? port 0x530 irq 10 drq 0 drq2 1  # Windows Sound System
 
+# PCMCIA audio devices
+#esl*  at pcmcia? function ?                   # ESS 1688 AudioDrive
+
 #cms0  at isa? port 0x220                      # Creative Music System
 
 # OPL[23] FM synthesizers
 #opl0  at isa? port 0x388      # use only if not attached to sound card
+opl*   at esl?
 opl*   at eso?
 opl*   at ess?
 opl*   at fms?
@@ -840,6 +844,7 @@
 audio* at clct?
 audio* at cmpci?
 audio* at eap?
+audio* at esl?
 audio* at esm?
 audio* at eso?
 audio* at ess?
diff -r c746ecc397ae -r a92a9603346e sys/dev/pcmcia/files.pcmcia
--- a/sys/dev/pcmcia/files.pcmcia       Sat Sep 29 18:13:48 2001 +0000
+++ b/sys/dev/pcmcia/files.pcmcia       Sat Sep 29 18:46:16 2001 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: files.pcmcia,v 1.39 2001/08/04 11:38:58 enami Exp $
+#      $NetBSD: files.pcmcia,v 1.40 2001/09/29 18:46:16 augustss Exp $
 #
 # Config.new file and device description for machine-independent PCMCIA code.
 # Included by ports that need it.
@@ -117,3 +117,13 @@
 file   dev/pcmcia/isic_pcmcia_elsa_isdnmc.c    isic_pcmcia
 file   dev/pcmcia/isic_pcmcia_elsa_mcall.c     isic_pcmcia
 file   dev/pcmcia/isic_pcmcia_sbspeedstar2.c   isic_pcmcia
+
+# Audio devices
+# Eiger Labs with ESS 1688
+device esl { }: audio, midibus, auconv, mulaw
+attach esl at pcmcia with esl_pcmcia
+file   dev/pcmcia/esl_pcmcia.c                 esl_pcmcia
+file   dev/pcmcia/esl.c                        esl
+
+attach opl at esl with opl_esl
+file   dev/pcmcia/opl_esl.c                    opl_esl