ESS audio driver ported from NetBSD, some mixer problems with X-based mixers

otherwise OK (mixerctl works quite OK, very strange).
At the moment it is polled only, but it works quite OK that way too.

1 files changed, 306 insertions, 0 deletions

diff --git a/sys/dev/isa/essreg.h b/sys/dev/isa/essreg.h
new file mode 100644
index 00000000000..77ac01b2919
--- /dev/null
+++ b/sys/dev/isa/essreg.h
@@ -0,0 +1,306 @@
+/*	$OpenBSD: essreg.h,v 1.1 1999/06/22 16:20:03 niklas Exp $	*/
+/*	$NetBSD: essreg.h,v 1.11 1999/03/19 12:40:21 mycroft Exp $	*/
+/*
+ * Copyright 1997
+ * Digital Equipment Corporation. All rights reserved.
+ *
+ * This software is furnished under license and may be used and
+ * copied only in accordance with the following terms and conditions.
+ * Subject to these conditions, you may download, copy, install,
+ * use, modify and distribute this software in source and/or binary
+ * form. No title or ownership is transferred hereby.
+ *
+ * 1) Any source code used, modified or distributed must reproduce
+ *    and retain this copyright notice and list of conditions as
+ *    they appear in the source file.
+ *
+ * 2) No right is granted to use any trade name, trademark, or logo of
+ *    Digital Equipment Corporation. Neither the "Digital Equipment
+ *    Corporation" name nor any trademark or logo of Digital Equipment
+ *    Corporation may be used to endorse or promote products derived
+ *    from this software without the prior written permission of
+ *    Digital Equipment Corporation.
+ *
+ * 3) This software is provided "AS-IS" and any express or implied
+ *    warranties, including but not limited to, any implied warranties
+ *    of merchantability, fitness for a particular purpose, or
+ *    non-infringement are disclaimed. In no event shall DIGITAL be
+ *    liable for any damages whatsoever, and in particular, DIGITAL
+ *    shall not be liable for special, indirect, consequential, or
+ *    incidental damages or damages for lost profits, loss of
+ *    revenue or loss of use, whether such damages arise in contract,
+ *    negligence, tort, under statute, in equity, at law or otherwise,
+ *    even if advised of the possibility of such damage.
+ */
+
+/*
+** @(#) $RCSfile: essreg.h,v $ $Revision: 1.1 $ (SHARK) $Date: 1999/06/22 16:20:03 $
+**
+**++
+**
+**  essreg.h
+**
+**  FACILITY:
+**
+**	DIGITAL Network Appliance Reference Design (DNARD)
+**
+**  MODULE DESCRIPTION:
+**
+**      This module contains the constant definitions for the device
+**      registers on the ESS Technologies 1888/1887/888 sound chip.
+**
+**  AUTHORS:
+**
+**	Blair Fidler	Software Engineering Australia
+**			Gold Coast, Australia.
+**
+**  CREATION DATE:  
+**
+**	March 10, 1997.
+**
+**  MODIFICATION HISTORY:
+**
+**--
+*/
+
+/*
+ * DSP commands.  This unit handles MIDI and audio capabilities.
+ * The DSP can be reset, data/commands can be read or written to it,
+ * and it can generate interrupts.  Interrupts are generated for MIDI
+ * input or DMA completion.  They seem to have neglected the fact 
+ * that it would be nice to have a MIDI transmission complete interrupt.
+ * Worse, the DMA engine is half-duplex.  This means you need to do
+ * (timed) programmed I/O to be able to record and play simulataneously.
+ */
+#define ESS_ACMD_DAC8WRITE	0x10	/* direct-mode 8-bit DAC write */
+#define ESS_ACMD_DAC16WRITE	0x11	/* direct-mode 16-bit DAC write */
+#define ESS_ACMD_DMA8OUT	0x14	/* 8-bit linear DMA output */
+#define ESS_ACMD_DMA16OUT	0x15	/* 16-bit linear DMA output */
+#define ESS_ACMD_AUTODMA8OUT	0x1C	/* auto-init 8-bit linear DMA output */
+#define ESS_ACMD_AUTODMA16OUT	0x1D	/* auto-init 16-bit linear DMA output */
+#define ESS_ACMD_ADC8READ	0x20	/* direct-mode 8-bit ADC read */
+#define ESS_ACMD_ADC16READ	0x21	/* direct-mode 16-bit ADC read */
+#define ESS_ACMD_DMA8IN		0x24	/* 8-bit linear DMA input */
+#define ESS_ACMD_DMA16IN	0x25	/* 16-bit linear DMA input */
+#define ESS_ACMD_AUTODMA8IN	0x2C	/* auto-init 8-bit linear DMA input */
+#define ESS_ACMD_AUTODMA16IN	0x2D	/* auto-init 16-bit linear DMA input */
+#define ESS_ACMD_SETTIMECONST1	0x40	/* set time constant (1MHz base) */
+#define	ESS_ACMD_SETTIMECONST15	0x41	/* set time constant (1.5MHz base) */
+#define	ESS_ACMD_SETFILTER	0x42	/* set filter clock independently */
+#define ESS_ACMD_BLOCKSIZE	0x48	/* set blk size for high speed xfer */
+
+#define ESS_ACMD_DMA4OUT	0x74	/* 4-bit ADPCM DMA output */
+#define ESS_ACMD_DMA4OUTREF	0x75	/* 4-bit ADPCM DMA output with ref */
+#define ESS_ACMD_DMA2_6OUT	0x76	/* 2.6-bit ADPCM DMA output */
+#define ESS_ACMD_DMA2_6OUTREF	0x77	/* 2.6-bit ADPCM DMA output with ref */
+#define ESS_ACMD_DMA2OUT	0x7A	/* 2-bit ADPCM DMA output */
+#define ESS_ACMD_DMA2OUTREF	0x7B	/* 2-bit ADPCM DMA output with ref */
+#define ESS_ACMD_SILENCEOUT	0x80	/* output a block of silence */
+#define ESS_ACMD_START_AUTO_OUT	0x90	/* start auto-init 8-bit DMA output */
+#define ESS_ACMD_START_OUT	0x91	/* start 8-bit DMA output */
+#define ESS_ACMD_START_AUTO_IN	0x98	/* start auto-init 8-bit DMA input */
+#define ESS_ACMD_START_IN	0x99	/* start 8-bit DMA input */
+
+#define ESS_XCMD_SAMPLE_RATE	0xA1	/* sample rate for Audio1 channel */
+#define ESS_XCMD_FILTER_CLOCK	0xA2	/* filter clock for Audio1 channel*/
+#define ESS_XCMD_XFER_COUNTLO	0xA4	/* */
+#define ESS_XCMD_XFER_COUNTHI	0xA5	/* */
+#define ESS_XCMD_AUDIO_CTRL	0xA8	/* */
+#define	  ESS_AUDIO_CTRL_MONITOR	0x08	/* 0=disable/1=enable */
+#define	  ESS_AUDIO_CTRL_MONO		0x02	/* 0=disable/1=enable */
+#define	  ESS_AUDIO_CTRL_STEREO		0x01	/* 0=disable/1=enable */
+#define ESS_XCMD_PREAMP_CTRL	0xA9 	/* */
+#define	  ESS_PREAMP_CTRL_ENABLE	0x04
+
+#define ESS_XCMD_IRQ_CTRL	0xB1	/* legacy audio interrupt control */
+#define   ESS_IRQ_CTRL_INTRA	0x00
+#define   ESS_IRQ_CTRL_INTRB	0x04
+#define   ESS_IRQ_CTRL_INTRC	0x08
+#define   ESS_IRQ_CTRL_INTRD	0x0C
+#define   ESS_IRQ_CTRL_MASK	0x10
+#define   ESS_IRQ_CTRL_EXT	0x40
+#define ESS_XCMD_DRQ_CTRL	0xB2	/* audio DRQ control */
+#define   ESS_DRQ_CTRL_DRQA	0x04
+#define   ESS_DRQ_CTRL_DRQB	0x08
+#define   ESS_DRQ_CTRL_DRQC	0x0C
+#define   ESS_DRQ_CTRL_PU	0x10
+#define   ESS_DRQ_CTRL_EXT	0x40
+#define ESS_XCMD_VOLIN_CTRL	0xB4	/* stereo input volume control */
+#define ESS_1788_XCMD_AUDIO_CTRL0	0xB6
+#define   ESS_CTRL0_SIGNED	0x00  
+#define   ESS_CTRL0_UNSIGNED	0x80	
+#define ESS_XCMD_AUDIO1_CTRL1	0xB7	/* */
+#define	  ESS_AUDIO1_CTRL1_FIFO_CONNECT	0x80	/* 1=connected */
+#define	  ESS_AUDIO1_CTRL1_FIFO_MONO    0x40    /* 0=stereo/1=mono */
+#define	  ESS_AUDIO1_CTRL1_FIFO_SIGNED	0x20	/* 0=unsigned/1=signed */
+#define	  ESS_AUDIO1_CTRL1_FIFO_STEREO	0x08	/* 0=mono/1=stereo */
+#define	  ESS_AUDIO1_CTRL1_FIFO_SIZE	0x04	/* 0=8-bit/1=16-bit */
+#define ESS_XCMD_AUDIO1_CTRL2	0xB8	/* */
+#define	  ESS_AUDIO1_CTRL2_FIFO_ENABLE	0x01	/* 0=disable/1=enable */
+#define	  ESS_AUDIO1_CTRL2_DMA_READ	0x02	/* 0=DMA write/1=DMA read */
+#define	  ESS_AUDIO1_CTRL2_AUTO_INIT	0x04
+#define	  ESS_AUDIO1_CTRL2_ADC_ENABLE	0x08	/* 0=DAC mode/1=ADC mode */
+#define	ESS_XCMD_DEMAND_CTRL	0xB9	/* */
+#define	  ESS_DEMAND_CTRL_SINGLE	0x00	/* 1-byte transfers */
+#define	  ESS_DEMAND_CTRL_DEMAND_2	0x01	/* 2-byte transfers */
+#define	  ESS_DEMAND_CTRL_DEMAND_4	0x02	/* 4-byte transfers */
+
+#define ESS_ACMD_ENABLE_EXT	0xC6	/* enable ESS extension commands */
+#define ESS_ACMD_DISABLE_EXT	0xC7	/* enable ESS extension commands */
+
+#define ESS_ACMD_PAUSE_DMA	0xD0	/* pause DMA */
+#define ESS_ACMD_ENABLE_SPKR	0xD1	/* enable Audio1 DAC input to mixer */
+#define ESS_ACMD_DISABLE_SPKR	0xD3	/* disable Audio1 DAC input to mixer */
+#define ESS_ACMD_CONT_DMA	0xD4	/* continue paused DMA */
+#define ESS_ACMD_SPKR_STATUS	0xD8	/* return Audio1 DAC status: */
+#define   ESS_SPKR_OFF	0x00
+#define   ESS_SPKR_ON	0xFF
+#define ESS_ACMD_VERSION	0xE1	/* get version number */
+#define ESS_ACMD_LEGACY_ID	0xE7	/* get legacy ES688/ES1688 ID bytes */
+
+#define ESS_MINRATE 4000
+#define ESS_MAXRATE 44100
+
+/*
+ * Macros to detect valid hardware configuration data.
+ */
+#define ESS_BASE_VALID(base) ((base) == 0x220 || (base) == 0x230 || (base) == 0x240 || (base) == 0x250)
+#define ESS_IRQ1_VALID(irq)  ((irq) == 5 || (irq) == 7 || (irq) == 9 || (irq) == 10)
+
+#define ESS_IRQ2_VALID(irq)  ((irq) == 15)
+
+#define ESS_IRQ12_VALID(irq) ((irq) == 5 || (irq) == 7 || (irq) == 9 || (irq) == 10 || (irq) == 15)
+
+#define ESS_DRQ1_VALID(chan) ((chan) == 0 || (chan) == 1 || (chan) == 3)
+
+#define ESS_DRQ2_VALID(chan) ((chan) == 0 || (chan) == 1 || (chan) == 3 || (chan) == 5)
+
+#define ESS_BASE_VALID(base) ((base) == 0x220 || (base) == 0x230 || (base) == 0x240 || (base) == 0x250)
+
+/*
+ * Macros to manipulate gain values
+ */
+#define ESS_4BIT_GAIN(x)	((x) & 0xf0)
+#define ESS_3BIT_GAIN(x)	(((x) & 0xe0) >> 1)
+#define ESS_STEREO_GAIN(l, r)	((l) | ((r) >> 4))
+#define ESS_MONO_GAIN(x)	((x) >> 4)
+
+#ifdef ESS_AMODE_LOW
+/*
+ * Registers used to configure ESS chip via Read Key Sequence
+ */
+#define ESS_CONFIG_KEY_BASE	0x229
+#define ESS_CONFIG_KEY_PORTS	3
+#else
+/*
+ * Registers used to configure ESS chip via System Control Register (SCR)
+ */
+#define ESS_SCR_ACCESS_BASE	0xF9
+#define ESS_SCR_ACCESS_PORTS	3
+#define ESS_SCR_LOCK		0
+#define ESS_SCR_UNLOCK		2
+
+#define ESS_SCR_BASE		0xE0
+#define ESS_SCR_PORTS		2
+#define ESS_SCR_INDEX		0
+#define ESS_SCR_DATA		1
+
+/*
+ * Bit definitions for SCR
+ */
+#define ESS_SCR_AUDIO_ENABLE	0x04
+#define ESS_SCR_AUDIO_220	0x00
+#define ESS_SCR_AUDIO_230	0x01
+#define ESS_SCR_AUDIO_240	0x02
+#define ESS_SCR_AUDIO_250	0x03
+#endif
+
+/*****************************************************************************/
+/*  DSP Timeout Definitions                                                  */
+/*****************************************************************************/
+#define	ESS_READ_TIMEOUT  	5000 /* number of times to try a read, 5ms*/
+#define	ESS_WRITE_TIMEOUT  	5000 /* number of times to try a write, 5ms */
+
+
+#define ESS_NPORT		16
+#define ESS_DSP_RESET		0x06
+#define		ESS_RESET_EXT	0x03 /* reset and use second DMA */
+#define		ESS_MAGIC	0xAA /* response to successful reset */
+
+#define ESS_DSP_READ		0x0A
+#define ESS_DSP_WRITE		0x0C
+
+#define ESS_CLEAR_INTR		0x0E
+
+#define	ESS_DSP_RW_STATUS	0x0C
+#define	ESS_DSP_WRITE_BUSY	0x80
+#define	ESS_DSP_READ_READY     	0x40
+#define   ESS_DSP_READ_FULL	0x20 /* FIFO full */
+#define   ESS_DSP_READ_EMPTY	0x10 /* FIFO empty */
+#define   ESS_DSP_READ_HALF	0x08 /* FIFO half-empty */
+#define   ESS_DSP_READ_IRQ	0x04 /* IRQ generated */
+#define   ESS_DSP_READ_HALF_IRQ	0x02 /*      " from half-empty flag change */
+#define   ESS_DSP_READ_OFLOW	0x01 /*      " from DMA counter overflow */
+#define   ESS_DSP_READ_ANYIRQ	(ESS_DSP_READ_IRQ | \
+				 ESS_DSP_READ_HALF_IRQ | \
+				 ESS_DSP_READ_OFLOW)
+
+#define	ESS_MIX_REG_SELECT	0x04
+#define	ESS_MIX_REG_DATA	0x05
+#define ESS_MIX_RESET		0x00 	/* mixer reset port and value */
+
+
+/*
+ * ESS Mixer registers
+ */
+#define ESS_MREG_VOLUME_VOICE	0x14
+#define ESS_MREG_VOLUME_MIC	0x1A
+#define ESS_MREG_ADC_SOURCE	0x1C
+#define   ESS_SOURCE_MIC	0x00
+#define   ESS_SOURCE_CD		0x02
+#define   ESS_SOURCE_LINE	0x06
+#define   ESS_SOURCE_MIXER	0x07
+#define ESS_MREG_VOLUME_MASTER	0x32
+#define ESS_MREG_VOLUME_SYNTH	0x36
+#define ESS_MREG_VOLUME_CD	0x38
+#define ESS_MREG_VOLUME_AUXB	0x3A
+#define ESS_MREG_VOLUME_PCSPKR	0x3C
+#define ESS_MREG_VOLUME_LINE	0x3E
+#define ESS_MREG_VOLUME_LEFT	0x60
+#define ESS_MREG_VOLUME_RIGHT	0x62
+#define   ESS_VOLUME_MUTE	0x40
+#define ESS_MREG_VOLUME_CTRL	0x64
+#define ESS_MREG_SAMPLE_RATE	0x70	/* sample rate for Audio2 channel */
+#define ESS_MREG_FILTER_CLOCK	0x72	/* filter clock for Audio2 channel */
+#define ESS_MREG_XFER_COUNTLO	0x74	/* low-byte of DMA transfer size */
+#define ESS_MREG_XFER_COUNTHI	0x76	/* high-byte of DMA transfer size */
+#define ESS_MREG_AUDIO2_CTRL1	0x78	/* control register 1 for Audio2: */
+#define   ESS_AUDIO2_CTRL1_SINGLE	0x00
+#define   ESS_AUDIO2_CTRL1_DEMAND_2	0x40
+#define   ESS_AUDIO2_CTRL1_DEMAND_4	0x80
+#define   ESS_AUDIO2_CTRL1_DEMAND_8	0xC0
+#define	  ESS_AUDIO2_CTRL1_XFER_SIZE	0x20	/* 0=8-bit/1=16-bit */
+#define   ESS_AUDIO2_CTRL1_AUTO_INIT	0x10
+#define	  ESS_AUDIO2_CTRL1_FIFO_ENABLE	0x02	/* 0=disable/1=enable */
+#define	  ESS_AUDIO2_CTRL1_DAC_ENABLE	0x01	/* 0=disable/1=enable */
+#define ESS_MREG_AUDIO2_CTRL2	0x7A	/* control register 2 for Audio2: */
+#define	  ESS_AUDIO2_CTRL2_FIFO_SIZE	0x01	/* 0=8-bit/1=16-bit */
+#define	  ESS_AUDIO2_CTRL2_CHANNELS	0x02	/* 0=mono/1=stereo */
+#define	  ESS_AUDIO2_CTRL2_FIFO_SIGNED	0x04	/* 0=unsigned/1=signed */
+#define	  ESS_AUDIO2_CTRL2_DMA_ENABLE	0x20	/* 0=disable/1=enable */
+#define   ESS_AUDIO2_CTRL2_IRQ2_ENABLE	0x40
+#define   ESS_AUDIO2_CTRL2_IRQ_LATCH	0x80
+#define ESS_MREG_AUDIO2_CTRL3	0x7D
+#define   ESS_AUDIO2_CTRL3_DRQA		0x00
+#define   ESS_AUDIO2_CTRL3_DRQB		0x01
+#define   ESS_AUDIO2_CTRL3_DRQC		0x02
+#define   ESS_AUDIO2_CTRL3_DRQD		0x03
+#define   ESS_AUDIO2_CTRL3_DRQ_PD	0x04
+#define ESS_MREG_INTR_ST	0x7F
+#define   ESS_IS_SELECT_IRQ		0x01
+#define   ESS_IS_ES1888			0x00
+#define   ESS_IS_INTRA			0x02
+#define   ESS_IS_INTRB			0x04
+#define   ESS_IS_INTRC			0x06
+#define   ESS_IS_INTRD			0x08
+#define   ESS_IS_INTRE			0x0A