xref: /openbsd/sys/dev/pci/esoreg.h (revision 998e9631)
1 /*	$OpenBSD: esoreg.h,v 1.2 2007/11/11 01:32:52 jakemsr Exp $	*/
2 /*	$NetBSD: esoreg.h,v 1.6 2004/05/25 20:59:37 kleink Exp $	*/
3 
4 /*
5  * Copyright (c) 1999 Klaus J. Klein
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. The name of the author may not be used to endorse or promote products
17  *    derived from this software without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
20  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
23  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
24  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
26  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29  * SUCH DAMAGE.
30  */
31 
32 #ifndef _DEV_PCI_ESOREG_H_
33 #define _DEV_PCI_ESOREG_H_
34 
35 /*
36  * PCI Configuration Registers
37  */
38 #define ESO_PCI_BAR_IO		0x10	/* I/O space base address */
39 #define ESO_PCI_BAR_SB		0x14	/* SB I/O space base address */
40 #define ESO_PCI_BAR_VC		0x18	/* VC I/O space base address */
41 #define ESO_PCI_BAR_MPU		0x1c	/* MPU-401 I/O space base address */
42 #define ESO_PCI_BAR_GAME	0x20	/* Game port I/O space base address */
43 #define ESO_PCI_S1C		0x50	/* Solo-1 Configuration */
44 #define  ESO_PCI_S1C_IRQP_MASK	0x0006000 /* ISA IRQ emulation policy */
45 #define  ESO_PCI_S1C_DMAP_MASK	0x0000700 /* DMA policy */
46 #define ESO_PCI_DDMAC		0x60	/* DDMA Control base address */
47 #define  ESO_PCI_DDMAC_DE	0x01	 /* Distributed DMA enable */
48 
49 /* PCI Revision IDs of the Solo-1 PCI AudioDrive family */
50 #define ESO_PCI_REVISION_ES1938	0x00	/* ES1938 */
51 #define ESO_PCI_REVISION_ES1946	0x01	/* ES1946 */
52 
53 /*
54  * Check the validity of a PCI I/O space base address for use in
55  * ESO_PCI_DDMAC; see the relevant comment in the attach function.
56  */
57 #define ESO_VALID_DDMAC_BASE(addr) \
58     (((addr) & 0x03ff) != 0)
59 
60 /*
61  * I/O Port offsets
62  */
63 /* I/O Device ports */
64 #define ESO_IO_A2DMAA		0x00	/* [RW] Audio 2 b/c DMA address */
65 #define ESO_IO_A2DMAC		0x04	/* [RW] Audio 2 b/c DMA count */
66 #define ESO_IO_A2DMAM		0x06	/* [RW] Solo-1 mode register */
67 #define  ESO_IO_A2DMAM_DMAENB	0x02	 /* DMA enable */
68 #define  ESO_IO_A2DMAM_AUTO	0x08	 /* Auto-Initialize DMA enable */
69 #define ESO_IO_IRQCTL		0x07	/* [RW] IRQ control register */
70 #define  ESO_IO_IRQCTL_A1IRQ	0x10	 /* Audio 1 IRQ */
71 #define  ESO_IO_IRQCTL_A2IRQ	0x20	 /* Audio 2 IRQ */
72 #define  ESO_IO_IRQCTL_HVIRQ	0x40	 /* Hardware volume IRQ */
73 #define  ESO_IO_IRQCTL_MPUIRQ	0x80	 /* MPU-401 IRQ */
74 #define  ESO_IO_IRQCTL_MASK	0xf0	 /* all of the above */
75 
76 /* Audio/FM Device ports */
77 #define ESO_SB_STATUS		0x00	/* [R]  FM Status */
78 #define ESO_SB_LBA		0x00	/* [W]  FM Low Bank Address */
79 #define ESO_SB_LBDW		0x01	/* [W]  FM Low Bank Data Write */
80 #define ESO_SB_HBA		0x02	/* [W]  FM High Bank Address */
81 #define ESO_SB_HBDW		0x03	/* [W]  FM High Bank Data Write */
82 #define ESO_SB_MIXERADDR	0x04	/* [RW] Mixer Address Register */
83 #define ESO_SB_MIXERDATA	0x05	/* [RW] Mixer Data Register */
84 #define ESO_SB_RESET		0x06	/* [W]  Reset */
85 #define  ESO_SB_RESET_SW	0x01	 /* SW Reset */
86 #define  ESO_SB_RESET_FIFO	0x02	 /* FIFO Reset */
87 #define ESO_SB_STATUSFLAGS	0x06	/* [R]  Status Flags */
88 #define ESO_SB_PMR		0x07	/* [RW] Power Management Register */
89 #define ESO_SB_RDR		0x0a	/* [R]  Read Data Register */
90 #define  ESO_SB_RDR_RESETMAGIC	0xaa	 /* Indicates SW reset completion */
91 #define ESO_SB_WDR		0x0c	/* [W]  Write Data Register */
92 #define ESO_SB_RSR		0x0c	/* [R]  Read Status Register */
93 #define  ESO_SB_RSR_BUSY	0x80	 /* WDR not available or Solo-1 busy */
94 #define ESO_SB_RBSR		0x0e	/* [R]  Read Buffer Status Register */
95 #define  ESO_SB_RBSR_RDAV	0x80	 /* Data available in RDR */
96 #define ESO_SB_PIOAFR		0x0f	/* [RW] PIO Access to FIFO Register */
97 
98 /* (Audio 1) DMAC Device ports */
99 #define ESO_DMAC_DMAA		0x00	/* [RW] DMA Current/Base Address */
100 #define ESO_DMAC_DMAC		0x04	/* [RW] DMA Current/Base Count */
101 #define ESO_DMAC_COMMAND	0x08	/* [W]  DMA Command */
102 #define  ESO_DMAC_COMMAND_ENB	0x04	 /* Controller enable */
103 #define  ESO_DMAC_COMMAND_DREQPOL 0x40	 /* DREQ signal polarity */
104 #define  ESO_DMAC_COMMAND_DACKPOL 0x80	 /* DACK signal polarity */
105 #define ESO_DMAC_STATUS		0x08	/* [R]  DMA Status */
106 #define ESO_DMAC_MODE		0x0b	/* [W]  DMA Mode */
107 #define ESO_DMAC_CLEAR		0x0d	/* [W]  DMA Master Clear */
108 #define ESO_DMAC_MASK		0x0f	/* [RW] DMA Mask */
109 #define  ESO_DMAC_MASK_MASK	0x01	/*  Mask DREQ */
110 
111 /* Controller commands */
112 #define ESO_CMD_RCR		0xc0	/* Read ext. controller registers */
113 #define ESO_CMD_EXTENB		0xc6	/* Enable Solo-1 Extension commands */
114 #define ESO_CMD_EXTDIS		0xc7	/* Disable Solo-1 Extension commands */
115 
116 /* Mixer registers */
117 #define ESO_MIXREG_RESET	0x00	/* Reset mixer registers */
118 #define  ESO_MIXREG_RESET_RESET	0x00	 /* Any value will do */
119 #define ESO_MIXREG_PVR_MIC	0x1a	/* Playback mixer: Microphone */
120 #define ESO_MIXREG_ERS		0x1c	/* Extended record source */
121 #define  ESO_MIXREG_ERS_MIC	0x00	 /* Microphone */
122 #define  ESO_MIXREG_ERS_CD	0x02	 /* CD */
123 #define  ESO_MIXREG_ERS_MIC2	0x04	 /* Microphone (again?) */
124 #define  ESO_MIXREG_ERS_MIXER	0x05	 /* Record mixer */
125 #define  ESO_MIXREG_ERS_LINE	0x06	 /* Line */
126 #define  ESO_MIXREG_ERS_MUTE	0x10	 /* Mutes input to filters for rec */
127 #define ESO_MIXREG_PCSVR	0x3c	/* PC Speaker Volume Register */
128 #define ESO_MIXREG_PCSVR_RESV	0xf8	 /* Reserved */
129 #define ESO_MIXREG_PVR_SYNTH	0x36	/* Playback mixer: FM/Synth */
130 #define ESO_MIXREG_PVR_CD	0x38	/* Playback mixer: AuxA/CD */
131 #define ESO_MIXREG_PVR_AUXB	0x3a	/* Playback mixer: AuxB */
132 #define ESO_MIXREG_PCSPKR_VOL	0x3c	/* PC speaker volume */
133 #define ESO_MIXREG_PVR_LINE	0x3e	/* Playback mixer: Line */
134 #define ESO_MIXREG_SPAT		0x50	/* Spatializer Enable and Mode */
135 #define  ESO_MIXREG_SPAT_MONO	0x02	/* 0 = Stereo in, 1 = Mono in */
136 #define  ESO_MIXREG_SPAT_RSTREL	0x04	/* 0 = reset, 1 = release from reset */
137 #define  ESO_MIXREG_SPAT_ENB	0x08	/* Spatializer Enable */
138 #define ESO_MIXREG_SPATLVL	0x52	/* Spatializer Level */
139 #define ESO_MIXREG_LMVM		0x60	/* Left Master Volume and Mute */
140 #define  ESO_MIXREG_LMVM_MUTE	0x40	 /* Mute enable */
141 #define ESO_MIXREG_LHVCC	0x61	/* Left Hardware Volume Control Ctr */
142 #define ESO_MIXREG_RMVM		0x62	/* Right Master Volume and Mute */
143 #define  ESO_MIXREG_RMVM_MUTE	0x40	 /* Mute enable */
144 #define ESO_MIXREG_RHVCC	0x63	/* Left Hardware Volume Control Ctr */
145 #define ESO_MIXREG_MVCTL	0x64	/* Master Volume Control */
146 #define  ESO_MIXREG_MVCTL_HVIRQM 0x02	 /* Hardware Volume Control intr mask */
147 #define  ESO_MIXREG_MVCTL_MPUIRQM 0x40	 /* MPU-401 interrupt unmask */
148 #define  ESO_MIXREG_MVCTL_SPLIT 0x80	 /* Split xHVCC/xMVM registers */
149 #define ESO_MIXREG_CHVIR	0x66	/* Clear Hardware Volume IRQ */
150 #define ESO_MIXREG_CHVIR_CHVIR	0x00	 /* Any value will do */
151 #define ESO_MIXREG_RVR_MIC	0x68	/* Record mixer: Microphone */
152 #define ESO_MIXREG_RVR_A2	0x69	/* Record mixer: Audio 2 */
153 #define ESO_MIXREG_RVR_CD	0x6a	/* Record mixer: AuxA/CD */
154 #define ESO_MIXREG_RVR_SYNTH	0x6b	/* Record mixer: FM/Synth */
155 #define ESO_MIXREG_RVR_AUXB	0x6c	/* Record mixer: AuxB */
156 #define ESO_MIXREG_PVR_MONO	0x6d	/* Playback mixer: Mono In */
157 #define ESO_MIXREG_RVR_LINE	0x6e	/* Record mixer: Line */
158 #define ESO_MIXREG_RVR_MONO	0x6f	/* Record mixer: Mono In */
159 #define ESO_MIXREG_A2SRG	0x70	/* Audio 2 Sample Rate Generator */
160 #define ESO_MIXREG_A2MODE	0x71	/* Audio 2 Mode */
161 #define  ESO_MIXREG_A2MODE_ASYNC 0x02	 /* A2 SRG and FLTDIV async wrt A1 */
162 #define  ESO_MIXREG_A2MODE_NEWA1 0x20	 /* New-style SRG for Audio 1 */
163 #define ESO_MIXREG_A2FLTDIV	0x72	/* Audio 2 Filter Rate Divider */
164 #define ESO_MIXREG_A2TCRLO	0x74	/* Audio 2 Transfer Count Reload LO */
165 #define ESO_MIXREG_A2TCRHI	0x76	/* Audio 2 Transfer Count Reload HI */
166 #define ESO_MIXREG_A2C1		0x78	/* Audio 2 Control 1 */
167 #define  ESO_MIXREG_A2C1_FIFOENB 0x01	 /* FIFO enable */
168 #define  ESO_MIXREG_A2C1_DMAENB	0x02	 /* DMA enable */
169 #define  ESO_MIXREG_A2C1_RESV0	0xcc	 /* Reserved, always write 0 XXXb5? */
170 #define  ESO_MIXREG_A2C1_AUTO	0x10	 /* Auto-initialize mode */
171 #define ESO_MIXREG_A2C2		0x7a	/* Audio 2 Control 2 */
172 #define  ESO_MIXREG_A2C2_16BIT	0x01	 /* 1 = 16-bit, 0 = 8-bit */
173 #define  ESO_MIXREG_A2C2_STEREO	0x02	 /* 1 = Stereo, 0 = Mono */
174 #define  ESO_MIXREG_A2C2_SIGNED	0x04	 /* 1 = Signed data, 0 = unsigned */
175 #define  ESO_MIXREG_A2C2_RESV0	0x38	 /* Reserved, always write 0 */
176 #define  ESO_MIXREG_A2C2_IRQM	0x40	 /* IRQ mask */
177 #define  ESO_MIXREG_A2C2_IRQ	0x80	 /* IRQ latch */
178 #define ESO_MIXREG_PVR_A2	0x7c	/* Playback mixer: Audio 2 */
179 #define ESO_MIXREG_MPM		0x7d	/* Microphone Preamp, Mono In/Out */
180 #define  ESO_MIXREG_MPM_MIBYPASS 0x01	 /* MONO_IN mixer bypass */
181 #define  ESO_MIXREG_MPM_MOMASK  0x06	 /* MONO_OUT value mask */
182 #define  ESO_MIXREG_MPM_MOMUTE  0x00	  /* MONO_OUT mute */
183 #define  ESO_MIXREG_MPM_MOCINR  0x02	  /* MONO_OUT source CIN_R */
184 #define  ESO_MIXREG_MPM_MOA2R	0x04	  /* MONO_OUT source Audio 2 Right */
185 #define  ESO_MIXREG_MPM_MOREC	0x06	  /* MONO_OUT source record stage */
186 #define  ESO_MIXREG_MPM_PREAMP	0x08	 /* Preamp enable */
187 #define  ESO_MIXREG_MPM_RESV0	0xf0	 /* Reserved, always write 0 */
188 
189 /* Controller registers */
190 #define ESO_CTLREG_SRG		0xa1	/* Sample Rate Generator */
191 #define ESO_CTLREG_FLTDIV	0xa2	/* Filter Rate Divider */
192 #define ESO_CTLREG_A1TCRLO	0xa4	/* Audio 1 Transfer Count Reload LO */
193 #define ESO_CTLREG_A1TCRHI	0xa5	/* Audio 1 Transfer Count Reload HI */
194 #define ESO_CTLREG_ACTL		0xa8	/* Analog Control */
195 #define  ESO_CTLREG_ACTL_STEREO	0x01	 /* DMA converters stereo */
196 #define  ESO_CTLREG_ACTL_MONO	0x02	 /* DMA converters mono */
197 #define  ESO_CTLREG_ACTL_RESV1	0x10	 /* Reserved, always write 1 */
198 #define  ESO_CTLREG_ACTL_RESV0	0xe4	 /* Reserved, always write 0 */
199 #define  ESO_CTLREG_ACTL_RECMON	0x08	 /* Record Monitor enable */
200 #define ESO_CTLREG_LAIC		0xb1	/* Legacy Audio Interrupt Control */
201 #define  ESO_CTLREG_LAIC_PINENB	0x10	 /* Interrupt pin enable */
202 #define  ESO_CTLREG_LAIC_EXTENB	0x40	 /* Extended mode IRQ enable */
203 #define ESO_CTLREG_DRQCTL	0xb2	/* DRQ Control */
204 #define  ESO_CTLREG_DRQCTL_ENB1	0x10	 /* Supposedly no function, but ... */
205 #define  ESO_CTLREG_DRQCTL_EXTENB 0x40	 /* Extended mode DRQ enable */
206 #define ESO_CTLREG_RECLVL	0xb4	/* Record Level */
207 #define ESO_CTLREG_A1C1		0xb7	/* Audio 1 Control 1 */
208 #define  ESO_CTLREG_A1C1_LOAD	0x01	 /* Generate load signal */
209 #define  ESO_CTLREG_A1C1_RESV0	0x02	 /* Reserved, always write 0 */
210 #define  ESO_CTLREG_A1C1_16BIT	0x04	 /* 1 = 16-bit, 0 = 8-bit */
211 #define  ESO_CTLREG_A1C1_STEREO	0x08	 /* DMA FIFO Stereo */
212 #define  ESO_CTLREG_A1C1_RESV1	0x10	 /* Reserved, always write 1 */
213 #define  ESO_CTLREG_A1C1_SIGNED	0x20	 /* 1 = Signed data, 0 = unsigned */
214 #define  ESO_CTLREG_A1C1_MONO	0x40	 /* DMA FIFO Mono */
215 #define  ESO_CTLREG_A1C1_FIFOENB 0x80	 /* DMA FIFO enable */
216 #define ESO_CTLREG_A1C2		0xb8	/* Audio 1 Control 2 */
217 #define  ESO_CTLREG_A1C2_DMAENB	0x01	 /* DMA enable */
218 #define  ESO_CTLREG_A1C2_READ	0x02	 /* 1 = DMA read/ADC, 0 = write/DAC */
219 #define  ESO_CTLREG_A1C2_AUTO	0x04	 /* Auto-initialize DMA enable */
220 #define  ESO_CTLREG_A1C2_ADC	0x08	 /* 1 = ADC mode, 0 = DAC mode */
221 #define ESO_CTLREG_A1TT		0xb9	/* Audio 1 Transfer Type */
222 #define  ESO_CTLREG_A1TT_SINGLE	0x00	 /* Single-Transfer */
223 #define  ESO_CTLREG_A1TT_DEMAND2 0x01	 /* Demand-Transfer, 2 bytes/DREQ */
224 #define  ESO_CTLREG_A1TT_DEMAND4 0x02	 /* Demand-Transfer, 4 bytes/DREQ */
225 
226 /*
227  * Sample rate related constants.
228  * Note: the use of these clock sources must be explicitly enabled for Audio 1.
229  */
230 #define ESO_MINRATE		6000
231 #define ESO_MAXRATE		48000
232 #define ESO_CLK0		793800L	/* Clock source 0 frequency */
233 #define ESO_CLK1		768000L	/* Clock source 1 frequency */
234 #define ESO_CLK1_SELECT		0x80	/* MSb of divider selects clock src */
235 
236 /*
237  * Upper bounds on several polling loop iterations.
238  */
239 #define ESO_RESET_TIMEOUT	5000
240 #define ESO_RDR_TIMEOUT		5000
241 #define ESO_WDR_TIMEOUT		5000
242 
243 /*
244  * Mixer state data conversions.
245  */
246 /* Truncate MI 8-bit precision gain values to the width of chip registers. */
247 #define ESO_GAIN_TO_3BIT(x)		((x) & 0xe0)
248 #define ESO_GAIN_TO_4BIT(x)		((x) & 0xf0)
249 #define ESO_GAIN_TO_6BIT(x)		((x) & 0xfc)
250 /* Convert two 4-bit gain values to standard mixer stereo register layout. */
251 #define ESO_4BIT_GAIN_TO_STEREO(l,r)	((l) | ((r) >> 4))
252 
253 #endif /* !_DEV_PCI_ESOREG_H_ */
254