Annotation of sys/dev/pci/esoreg.h, Revision 1.1.1.1
1.1 nbrk 1: /* $OpenBSD: esoreg.h,v 1.1 1999/08/04 23:38:03 niklas Exp $ */
2: /* $NetBSD: esoreg.h,v 1.1 1999/07/12 15:13:31 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_RMVM 0x62 /* Right Master Volume and Mute */
142: #define ESO_MIXREG_RMVM_MUTE 0x40 /* Mute enable */
143: #define ESO_MIXREG_MVCTL 0x64 /* Master Volume Control */
144: #define ESO_MIXREG_RVR_MIC 0x68 /* Record mixer: Microphone */
145: #define ESO_MIXREG_RVR_A2 0x69 /* Record mixer: Audio 2 */
146: #define ESO_MIXREG_RVR_CD 0x6a /* Record mixer: AuxA/CD */
147: #define ESO_MIXREG_RVR_SYNTH 0x6b /* Record mixer: FM/Synth */
148: #define ESO_MIXREG_RVR_AUXB 0x6c /* Record mixer: AuxB */
149: #define ESO_MIXREG_PVR_MONO 0x6d /* Playback mixer: Mono In */
150: #define ESO_MIXREG_RVR_LINE 0x6e /* Record mixer: Line */
151: #define ESO_MIXREG_RVR_MONO 0x6f /* Record mixer: Mono In */
152: #define ESO_MIXREG_A2SRG 0x70 /* Audio 2 Sample Rate Generator */
153: #define ESO_MIXREG_A2MODE 0x71 /* Audio 2 Mode */
154: #define ESO_MIXREG_A2MODE_ASYNC 0x02 /* A2 SRG and FLTDIV async wrt A1 */
155: #define ESO_MIXREG_A2MODE_NEWA1 0x20 /* New-style SRG for Audio 1 */
156: #define ESO_MIXREG_A2FLTDIV 0x72 /* Audio 2 Filter Rate Divider */
157: #define ESO_MIXREG_A2TCRLO 0x74 /* Audio 2 Transfer Count Reload LO */
158: #define ESO_MIXREG_A2TCRHI 0x76 /* Audio 2 Transfer Count Reload HI */
159: #define ESO_MIXREG_A2C1 0x78 /* Audio 2 Control 1 */
160: #define ESO_MIXREG_A2C1_FIFOENB 0x01 /* FIFO enable */
161: #define ESO_MIXREG_A2C1_DMAENB 0x02 /* DMA enable */
162: #define ESO_MIXREG_A2C1_RESV0 0xcc /* Reserved, always write 0 XXXb5? */
163: #define ESO_MIXREG_A2C1_AUTO 0x10 /* Auto-initialize mode */
164: #define ESO_MIXREG_A2C2 0x7a /* Audio 2 Control 2 */
165: #define ESO_MIXREG_A2C2_16BIT 0x01 /* 1 = 16-bit, 0 = 8-bit */
166: #define ESO_MIXREG_A2C2_STEREO 0x02 /* 1 = Stereo, 0 = Mono */
167: #define ESO_MIXREG_A2C2_SIGNED 0x04 /* 1 = Signed data, 0 = unsigned */
168: #define ESO_MIXREG_A2C2_RESV0 0x38 /* Reserved, always write 0 */
169: #define ESO_MIXREG_A2C2_IRQM 0x40 /* IRQ mask */
170: #define ESO_MIXREG_A2C2_IRQ 0x80 /* IRQ latch */
171: #define ESO_MIXREG_PVR_A2 0x7c /* Playback mixer: Audio 2 */
172: #define ESO_MIXREG_MPM 0x7d /* Microphone Preamp, Mono In/Out */
173: #define ESO_MIXREG_MPM_MOMASK 0x03 /* MONO_OUT value mask */
174: #define ESO_MIXREG_MPM_MOMUTE 0x00 /* MONO_OUT mute */
175: #define ESO_MIXREG_MPM_MOCINR 0x01 /* MONO_OUT source CIN_R */
176: #define ESO_MIXREG_MPM_MOA2R 0x02 /* MONO_OUT source Audio 2 Right */
177: #define ESO_MIXREG_MPM_MOREC 0x03 /* MONO_OUT source record stage */
178: #define ESO_MIXREG_MPM_PREAMP 0x08 /* Preamp enable */
179: #define ESO_MIXREG_MPM_RESV0 0xf0 /* Reserved, always write 0 */
180:
181: /* Controller registers */
182: #define ESO_CTLREG_SRG 0xa1 /* Sample Rate Generator */
183: #define ESO_CTLREG_FLTDIV 0xa2 /* Filter Rate Divider */
184: #define ESO_CTLREG_A1TCRLO 0xa4 /* Audio 1 Transfer Count Reload LO */
185: #define ESO_CTLREG_A1TCRHI 0xa5 /* Audio 1 Transfer Count Reload HI */
186: #define ESO_CTLREG_ACTL 0xa8 /* Analog Control */
187: #define ESO_CTLREG_ACTL_STEREO 0x01 /* DMA converters stereo */
188: #define ESO_CTLREG_ACTL_MONO 0x02 /* DMA converters mono */
189: #define ESO_CTLREG_ACTL_RESV1 0x10 /* Reserved, always write 1 */
190: #define ESO_CTLREG_ACTL_RESV0 0xe4 /* Reserved, always write 0 */
191: #define ESO_CTLREG_ACTL_RECMON 0x08 /* Record Monitor enable */
192: #define ESO_CTLREG_LAIC 0xb1 /* Legacy Audio Interrupt Control */
193: #define ESO_CTLREG_LAIC_PINENB 0x10 /* Interrupt pin enable */
194: #define ESO_CTLREG_LAIC_EXTENB 0x40 /* Extended mode IRQ enable */
195: #define ESO_CTLREG_DRQCTL 0xb2 /* DRQ Control */
196: #define ESO_CTLREG_DRQCTL_ENB1 0x10 /* Supposedly no function, but ... */
197: #define ESO_CTLREG_DRQCTL_EXTENB 0x40 /* Extended mode DRQ enable */
198: #define ESO_CTLREG_RECLVL 0xb4 /* Record Level */
199: #define ESO_CTLREG_A1C1 0xb7 /* Audio 1 Control 1 */
200: #define ESO_CTLREG_A1C1_LOAD 0x01 /* Generate load signal */
201: #define ESO_CTLREG_A1C1_RESV0 0x02 /* Reserved, always write 0 */
202: #define ESO_CTLREG_A1C1_16BIT 0x04 /* 1 = 16-bit, 0 = 8-bit */
203: #define ESO_CTLREG_A1C1_STEREO 0x08 /* DMA FIFO Stereo */
204: #define ESO_CTLREG_A1C1_RESV1 0x10 /* Reserved, always write 1 */
205: #define ESO_CTLREG_A1C1_SIGNED 0x20 /* 1 = Signed data, 0 = unsigned */
206: #define ESO_CTLREG_A1C1_MONO 0x40 /* DMA FIFO Mono */
207: #define ESO_CTLREG_A1C1_FIFOENB 0x80 /* DMA FIFO enable */
208: #define ESO_CTLREG_A1C2 0xb8 /* Audio 1 Control 2 */
209: #define ESO_CTLREG_A1C2_DMAENB 0x01 /* DMA enable */
210: #define ESO_CTLREG_A1C2_READ 0x02 /* 1 = DMA read/ADC, 0 = write/DAC */
211: #define ESO_CTLREG_A1C2_AUTO 0x04 /* Auto-initialize DMA enable */
212: #define ESO_CTLREG_A1C2_ADC 0x08 /* 1 = ADC mode, 0 = DAC mode */
213: #define ESO_CTLREG_A1TT 0xb9 /* Audio 1 Transfer Type */
214: #define ESO_CTLREG_A1TT_SINGLE 0x00 /* Single-Transfer */
215: #define ESO_CTLREG_A1TT_DEMAND2 0x01 /* Demand-Transfer, 2 bytes/DREQ */
216: #define ESO_CTLREG_A1TT_DEMAND4 0x02 /* Demand-Transfer, 4 bytes/DREQ */
217:
218: /*
219: * Sample rate related constants.
220: * Note: the use of these clock sources must be explicitly enabled for Audio 1.
221: */
222: #define ESO_MINRATE 6000
223: #define ESO_MAXRATE 48000
224: #define ESO_CLK0 793800L /* Clock source 0 frequency */
225: #define ESO_CLK1 768000L /* Clock source 1 frequency */
226: #define ESO_CLK1_SELECT 0x80 /* MSb of divider selects clock src */
227:
228: /*
229: * Upper bounds on several polling loop iterations.
230: */
231: #define ESO_RESET_TIMEOUT 5000
232: #define ESO_RDR_TIMEOUT 5000
233: #define ESO_WDR_TIMEOUT 5000
234:
235: /*
236: * Mixer state data conversions.
237: */
238: /* Truncate MI 8-bit precision gain values to the width of chip registers. */
239: #define ESO_GAIN_TO_3BIT(x) ((x) & 0xe0)
240: #define ESO_GAIN_TO_4BIT(x) ((x) & 0xf0)
241: #define ESO_GAIN_TO_6BIT(x) ((x) & 0xfc)
242: /* Convert two 4-bit gain values to standard mixer stereo register layout. */
243: #define ESO_4BIT_GAIN_TO_STEREO(l,r) ((l) | ((r) >> 4))
244:
245: #endif /* !_DEV_PCI_ESOREG_H_ */
CVSweb