4 * (C) 1997 Luigi Rizzo (luigi@iet.unipi.it)
6 * This file contains information and macro definitions for
7 * AD1848-compatible devices, used in the MSS/WSS compatible boards.
12 * Copyright (c) 1999 Doug Rabson
13 * All rights reserved.
15 * Redistribution and use in source and binary forms, with or without
16 * modification, are permitted provided that the following conditions
18 * 1. Redistributions of source code must retain the above copyright
19 * notice, this list of conditions and the following disclaimer.
20 * 2. Redistributions in binary form must reproduce the above copyright
21 * notice, this list of conditions and the following disclaimer in the
22 * documentation and/or other materials provided with the distribution.
24 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
25 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36 * $FreeBSD: src/sys/dev/sound/isa/mss.h,v 1.12 2005/01/06 01:43:17 imp Exp $
37 * $DragonFly: src/sys/dev/sound/isa/mss.h,v 1.4 2007/01/04 21:47:02 corecode Exp $
43 The codec part of the board is seen as a set of 4 registers mapped
44 at the base address for the board (default 0x534). Note that some
45 (early) boards implemented 4 additional registers 4 location before
46 (usually 0x530) to store configuration information. This is a source
47 of confusion in that one never knows what address to specify. The
48 (current) convention is to use the old address (0x530) in the kernel
49 configuration file and consider MSS registers start four location
57 u_int polarity:1; /* 1 means reversed */
61 typedef struct mixer_def mixer_ent;
62 typedef struct mixer_def mixer_tab[32][2];
64 #define MIX_ENT(name, reg_l, pol_l, pos_l, len_l, reg_r, pol_r, pos_r, len_r) \
65 {{reg_l, pol_l, pos_l, len_l}, {reg_r, pol_r, pos_r, len_r}}
67 #define PMIX_ENT(name, reg_l, pos_l, len_l, reg_r, pos_r, len_r) \
68 {{reg_l, 0, pos_l, len_l}, {reg_r, 0, pos_r, len_r}}
70 #define MIX_NONE(name) MIX_ENT(name, 0,0,0,0, 0,0,0,0)
73 * The four visible registers of the MSS :
77 #define MSS_INDEX (0 + 4)
78 #define MSS_IDXBUSY 0x80 /* readonly, set when busy */
79 #define MSS_MCE 0x40 /* the MCE bit. */
81 * the MCE bit must be set whenever the current mode of the
82 * codec is changed; this in particular is true for the
83 * Data Format (I8, I28) and Interface Config(I9) registers.
84 * Only exception are CEN and PEN which can be changed on the fly.
85 * The DAC output is muted when MCE is set.
87 #define MSS_TRD 0x20 /* Transfer request disable */
89 * When TRD is set, DMA transfers cease when the INT bit in
90 * the MSS status reg is set. Must be cleared for automode
93 #define MSS_IDXMASK 0x1f /* mask for indirect address */
95 #define MSS_IDATA (1 + 4)
97 * data to be transferred to the indirect register addressed
98 * by index addr. During init and sw. powerdown, cannot be
99 * written to, and is always read as 0x80 (consistent with the
103 #define MSS_STATUS (2 + 4)
105 #define IS_CUL 0x80 /* capture upper/lower */
106 #define IS_CLR 0x40 /* capture left/right */
107 #define IS_CRDY 0x20 /* capture ready for programmed i/o */
108 #define IS_SER 0x10 /* sample error (overrun/underrun) */
109 #define IS_PUL 0x08 /* playback upper/lower */
110 #define IS_PLR 0x04 /* playback left/right */
111 #define IS_PRDY 0x02 /* playback ready for programmed i/o */
112 #define IS_INT 0x01 /* int status (1 = active) */
114 * IS_INT is clreared by any write to the status register.
117 #define io_Polled_IO(d) ((d)->io_base+3+4)
119 * this register is used in case of polled i/o
124 * The MSS has a set of 16 (or 32 depending on the model) indirect
125 * registers accessible through the data port by specifying the
126 * appropriate address in the address register.
128 * The 16 low registers are uniformly handled in AD1848/CS4248 compatible
129 * mode (often called MODE1). For the upper 16 registers there are
130 * some differences among different products, mainly Crystal uses them
131 * differently from OPTi.
142 * register I9 -- interface configuration.
145 #define I9_PEN 0x01 /* playback enable */
146 #define I9_CEN 0x02 /* capture enable */
149 * values used in bd_flags
151 #define BD_F_MCE_BIT 0x0001
152 #define BD_F_IRQ_OK 0x0002
153 #define BD_F_TMR_RUN 0x0004
154 #define BD_F_MSS_OFFSET 0x0008 /* offset mss writes by -4 */
155 #define BD_F_DUPLEX 0x0010
156 #define BD_F_924PNP 0x0020 /* OPTi924 is in PNP mode */
159 * sound/ad1848_mixer.h
161 * Definitions for the mixer of AD1848 and compatible codecs.
163 * Copyright by Hannu Savolainen 1994
165 * Redistribution and use in source and binary forms, with or without
166 * modification, are permitted provided that the following conditions are
167 * met: 1. Redistributions of source code must retain the above copyright
168 * notice, this list of conditions and the following disclaimer. 2.
169 * Redistributions in binary form must reproduce the above copyright notice,
170 * this list of conditions and the following disclaimer in the documentation
171 * and/or other materials provided with the distribution.
173 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY
174 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
175 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
176 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
177 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
178 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
179 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
180 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
181 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
182 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
186 * The AD1848 codec has generic input lines called Line, Aux1 and Aux2.
187 * Soundcard manufacturers have connected actual inputs (CD, synth, line,
188 * etc) to these inputs in different order. Therefore it's difficult
189 * to assign mixer channels to to these inputs correctly. The following
190 * contains two alternative mappings. The first one is for GUS MAX and
191 * the second is just a generic one (line1, line2 and line3).
192 * (Actually this is not a mapping but rather some kind of interleaving
196 #define MSS_REC_DEVICES \
197 (SOUND_MASK_LINE | SOUND_MASK_MIC | SOUND_MASK_CD|SOUND_MASK_IMIX)
201 * Table of mixer registers. There is a default table for the
202 * AD1848/CS423x clones, one for the OPTI931 and one for the
203 * OPTi930. As more MSS clones come out, there ought to be
206 * Fields in the table are : polarity, register, offset, bits
208 * The channel numbering used by individual soundcards is not fixed.
209 * Some cards have assigned different meanings for the AUX1, AUX2
210 * and LINE inputs. Some have different features...
212 * Following there is a macro ...MIXER_DEVICES which is a bitmap
213 * of all non-zero fields in the table.
214 * MODE1_MIXER_DEVICES is the basic mixer of the 1848 in mode 1
219 mixer_ent mix_devices[32][2] = {
220 MIX_NONE(SOUND_MIXER_VOLUME),
221 MIX_NONE(SOUND_MIXER_BASS),
222 MIX_NONE(SOUND_MIXER_TREBLE),
223 #ifdef PC98 /* PC98's synth is assigned to AUX#2 */
224 MIX_ENT(SOUND_MIXER_SYNTH, 4, 1, 0, 5, 5, 1, 0, 5),
225 #else /* AT386's synth is assigned to AUX#1 */
226 MIX_ENT(SOUND_MIXER_SYNTH, 2, 1, 0, 5, 3, 1, 0, 5),
228 MIX_ENT(SOUND_MIXER_PCM, 6, 1, 0, 6, 7, 1, 0, 6),
229 MIX_ENT(SOUND_MIXER_SPEAKER, 26, 1, 0, 4, 0, 0, 0, 0),
230 MIX_ENT(SOUND_MIXER_LINE, 18, 1, 0, 5, 19, 1, 0, 5),
231 MIX_ENT(SOUND_MIXER_MIC, 0, 0, 5, 1, 1, 0, 5, 1),
232 #ifdef PC98 /* PC98's cd-audio is assigned to AUX#1 */
233 MIX_ENT(SOUND_MIXER_CD, 2, 1, 0, 5, 3, 1, 0, 5),
234 #else /* AT386's cd-audio is assigned to AUX#2 */
235 MIX_ENT(SOUND_MIXER_CD, 4, 1, 0, 5, 5, 1, 0, 5),
237 MIX_ENT(SOUND_MIXER_IMIX, 13, 1, 2, 6, 0, 0, 0, 0),
238 MIX_NONE(SOUND_MIXER_ALTPCM),
239 MIX_NONE(SOUND_MIXER_RECLEV),
240 MIX_ENT(SOUND_MIXER_IGAIN, 0, 0, 0, 4, 1, 0, 0, 4),
241 MIX_NONE(SOUND_MIXER_OGAIN),
242 MIX_NONE(SOUND_MIXER_LINE1),
243 MIX_NONE(SOUND_MIXER_LINE2),
244 MIX_NONE(SOUND_MIXER_LINE3),
247 #define MODE2_MIXER_DEVICES \
248 (SOUND_MASK_SYNTH | SOUND_MASK_PCM | SOUND_MASK_SPEAKER | \
249 SOUND_MASK_LINE | SOUND_MASK_MIC | SOUND_MASK_CD | \
250 SOUND_MASK_IMIX | SOUND_MASK_IGAIN )
252 #define MODE1_MIXER_DEVICES \
253 (SOUND_MASK_SYNTH | SOUND_MASK_PCM | SOUND_MASK_MIC | \
254 SOUND_MASK_CD | SOUND_MASK_IMIX | SOUND_MASK_IGAIN )
257 mixer_ent opti930_devices[32][2] = {
258 MIX_ENT(SOUND_MIXER_VOLUME, 22, 1, 0, 4, 23, 1, 0, 4),
259 MIX_NONE(SOUND_MIXER_BASS),
260 MIX_NONE(SOUND_MIXER_TREBLE),
261 MIX_ENT(SOUND_MIXER_SYNTH, 4, 1, 0, 4, 5, 1, 0, 4),
262 MIX_ENT(SOUND_MIXER_PCM, 6, 1, 1, 5, 7, 1, 1, 5),
263 MIX_ENT(SOUND_MIXER_LINE, 18, 1, 1, 4, 19, 1, 1, 4),
264 MIX_NONE(SOUND_MIXER_SPEAKER),
265 MIX_ENT(SOUND_MIXER_MIC, 21, 1, 0, 4, 22, 1, 0, 4),
266 MIX_ENT(SOUND_MIXER_CD, 2, 1, 1, 4, 3, 1, 1, 4),
267 MIX_NONE(SOUND_MIXER_IMIX),
268 MIX_NONE(SOUND_MIXER_ALTPCM),
269 MIX_NONE(SOUND_MIXER_RECLEV),
270 MIX_NONE(SOUND_MIXER_IGAIN),
271 MIX_NONE(SOUND_MIXER_OGAIN),
272 MIX_NONE(SOUND_MIXER_LINE1),
273 MIX_NONE(SOUND_MIXER_LINE2),
274 MIX_NONE(SOUND_MIXER_LINE3),
277 #define OPTI930_MIXER_DEVICES \
278 (SOUND_MASK_VOLUME | SOUND_MASK_SYNTH | SOUND_MASK_PCM | \
279 SOUND_MASK_LINE | SOUND_MASK_MIC | SOUND_MASK_CD )
282 * entries for the opti931...
285 mixer_ent opti931_devices[32][2] = { /* for the opti931 */
286 MIX_ENT(SOUND_MIXER_VOLUME, 22, 1, 1, 5, 23, 1, 1, 5),
287 MIX_NONE(SOUND_MIXER_BASS),
288 MIX_NONE(SOUND_MIXER_TREBLE),
289 MIX_ENT(SOUND_MIXER_SYNTH, 4, 1, 1, 4, 5, 1, 1, 4),
290 MIX_ENT(SOUND_MIXER_PCM, 6, 1, 0, 5, 7, 1, 0, 5),
291 MIX_NONE(SOUND_MIXER_SPEAKER),
292 MIX_ENT(SOUND_MIXER_LINE, 18, 1, 1, 4, 19, 1, 1, 4),
293 MIX_ENT(SOUND_MIXER_MIC, 0, 0, 5, 1, 1, 0, 5, 1),
294 MIX_ENT(SOUND_MIXER_CD, 2, 1, 1, 4, 3, 1, 1, 4),
295 MIX_NONE(SOUND_MIXER_IMIX),
296 MIX_NONE(SOUND_MIXER_ALTPCM),
297 MIX_NONE(SOUND_MIXER_RECLEV),
298 MIX_ENT(SOUND_MIXER_IGAIN, 0, 0, 0, 4, 1, 0, 0, 4),
299 MIX_NONE(SOUND_MIXER_OGAIN),
300 MIX_ENT(SOUND_MIXER_LINE1, 16, 1, 1, 4, 17, 1, 1, 4),
301 MIX_NONE(SOUND_MIXER_LINE2),
302 MIX_NONE(SOUND_MIXER_LINE3),
305 #define OPTI931_MIXER_DEVICES \
306 (SOUND_MASK_VOLUME | SOUND_MASK_SYNTH | SOUND_MASK_PCM | \
307 SOUND_MASK_LINE | SOUND_MASK_MIC | SOUND_MASK_CD | \
308 SOUND_MASK_IGAIN | SOUND_MASK_LINE1 )
311 * Register definitions for the Yamaha OPL3-SA[23x].
313 #define OPL3SAx_POWER 0x01 /* Power Management (R/W) */
314 #define OPL3SAx_POWER_PDX 0x01 /* Set to 1 to halt oscillator */
315 #define OPL3SAx_POWER_PDN 0x02 /* Set to 1 to power down */
316 #define OPL3SAx_POWER_PSV 0x04 /* Set to 1 to power save */
317 #define OPL3SAx_POWER_ADOWN 0x20 /* Analog power (?) */
319 #define OPL3SAx_SYSTEM 0x02 /* System control (R/W) */
320 #define OPL3SAx_SYSTEM_VZE 0x01 /* I2S audio routing */
321 #define OPL3SAx_SYSTEM_IDSEL 0x03 /* SB compat version select */
322 #define OPL3SAx_SYSTEM_SBHE 0x80 /* 0 for AT bus, 1 for XT bus */
324 #define OPL3SAx_IRQCONF 0x03 /* Interrupt configuration (R/W */
325 #define OPL3SAx_IRQCONF_WSSA 0x01 /* WSS interrupts through IRQA */
326 #define OPL3SAx_IRQCONF_SBA 0x02 /* WSS interrupts through IRQA */
327 #define OPL3SAx_IRQCONF_MPUA 0x04 /* WSS interrupts through IRQA */
328 #define OPL3SAx_IRQCONF_OPL3A 0x08 /* WSS interrupts through IRQA */
329 #define OPL3SAx_IRQCONF_WSSB 0x10 /* WSS interrupts through IRQB */
330 #define OPL3SAx_IRQCONF_SBB 0x20 /* WSS interrupts through IRQB */
331 #define OPL3SAx_IRQCONF_MPUB 0x40 /* WSS interrupts through IRQB */
332 #define OPL3SAx_IRQCONF_OPL3B 0x80 /* WSS interrupts through IRQB */
334 #define OPL3SAx_IRQSTATUSA 0x04 /* Interrupt (IRQ-A) Status (RO) */
335 #define OPL3SAx_IRQSTATUSB 0x05 /* Interrupt (IRQ-B) Status (RO) */
336 #define OPL3SAx_IRQSTATUS_PI 0x01 /* Playback Flag of CODEC */
337 #define OPL3SAx_IRQSTATUS_CI 0x02 /* Recording Flag of CODEC */
338 #define OPL3SAx_IRQSTATUS_TI 0x04 /* Timer Flag of CODEC */
339 #define OPL3SAx_IRQSTATUS_SB 0x08 /* SB compat Playback Interrupt Flag */
340 #define OPL3SAx_IRQSTATUS_MPU 0x10 /* MPU401 Interrupt Flag */
341 #define OPL3SAx_IRQSTATUS_OPL3 0x20 /* Internal FM Timer Flag */
342 #define OPL3SAx_IRQSTATUS_MV 0x40 /* HW Volume Interrupt Flag */
343 #define OPL3SAx_IRQSTATUS_PI 0x01 /* Playback Flag of CODEC */
344 #define OPL3SAx_IRQSTATUS_CI 0x02 /* Recording Flag of CODEC */
345 #define OPL3SAx_IRQSTATUS_TI 0x04 /* Timer Flag of CODEC */
346 #define OPL3SAx_IRQSTATUS_SB 0x08 /* SB compat Playback Interrupt Flag */
347 #define OPL3SAx_IRQSTATUS_MPU 0x10 /* MPU401 Interrupt Flag */
348 #define OPL3SAx_IRQSTATUS_OPL3 0x20 /* Internal FM Timer Flag */
349 #define OPL3SAx_IRQSTATUS_MV 0x40 /* HW Volume Interrupt Flag */
351 #define OPL3SAx_DMACONF 0x06 /* DMA configuration (R/W) */
352 #define OPL3SAx_DMACONF_WSSPA 0x01 /* WSS Playback on DMA-A */
353 #define OPL3SAx_DMACONF_WSSRA 0x02 /* WSS Recording on DMA-A */
354 #define OPL3SAx_DMACONF_SBA 0x02 /* SB Playback on DMA-A */
355 #define OPL3SAx_DMACONF_WSSPB 0x10 /* WSS Playback on DMA-A */
356 #define OPL3SAx_DMACONF_WSSRB 0x20 /* WSS Recording on DMA-A */
357 #define OPL3SAx_DMACONF_SBB 0x20 /* SB Playback on DMA-A */
359 #define OPL3SAx_VOLUMEL 0x07 /* Master Volume Left (R/W) */
360 #define OPL3SAx_VOLUMEL_MVL 0x0f /* Attenuation level */
361 #define OPL3SAx_VOLUMEL_MVLM 0x80 /* Mute */
363 #define OPL3SAx_VOLUMER 0x08 /* Master Volume Right (R/W) */
364 #define OPL3SAx_VOLUMER_MVR 0x0f /* Attenuation level */
365 #define OPL3SAx_VOLUMER_MVRM 0x80 /* Mute */
367 #define OPL3SAx_MIC 0x09 /* MIC Volume (R/W) */
368 #define OPL3SAx_VOLUMER_MCV 0x1f /* Attenuation level */
369 #define OPL3SAx_VOLUMER_MICM 0x80 /* Mute */
371 #define OPL3SAx_MISC 0x0a /* Miscellaneous */
372 #define OPL3SAx_MISC_VER 0x07 /* Version */
373 #define OPL3SAx_MISC_MODE 0x08 /* SB or WSS mode */
374 #define OPL3SAx_MISC_MCSW 0x10 /* */
375 #define OPL3SAx_MISC_VEN 0x80 /* Enable hardware volume control */
377 #define OPL3SAx_WSSDMA 0x0b /* WSS DMA Counter (RW) (4 regs) */
379 #define OPL3SAx_WSSIRQSCAN 0x0f /* WSS Interrupt Scan out/in (R/W) */
380 #define OPL3SAx_WSSIRQSCAN_SPI 0x01
381 #define OPL3SAx_WSSIRQSCAN_SCI 0x02
382 #define OPL3SAx_WSSIRQSCAN_STI 0x04
384 #define OPL3SAx_SBSTATE 0x10 /* SB compat Internal State (R/W) */
385 #define OPL3SAx_SBSTATE_SBPDR 0x01 /* SB Power Down Request */
386 #define OPL3SAx_SBSTATE_SE 0x02 /* Scan Enable */
387 #define OPL3SAx_SBSTATE_SM 0x04 /* Scan Mode */
388 #define OPL3SAx_SBSTATE_SS 0x08 /* Scan Select */
389 #define OPL3SAx_SBSTATE_SBPDA 0x80 /* SB Power Down Acknowledge */
391 #define OPL3SAx_SBDATA 0x11 /* SB compat State Scan Data (R/W) */
393 #define OPL3SAx_DIGITALPOWER 0x12 /* Digital Partial Power Down (R/W) */
394 #define OPL3SAx_DIGITALPOWER_PnP 0x01
395 #define OPL3SAx_DIGITALPOWER_SB 0x02
396 #define OPL3SAx_DIGITALPOWER_WSSP 0x04
397 #define OPL3SAx_DIGITALPOWER_WSSR 0x08
398 #define OPL3SAx_DIGITALPOWER_FM 0x10
399 #define OPL3SAx_DIGITALPOWER_MCLK0 0x20
400 #define OPL3SAx_DIGITALPOWER_MPU 0x40
401 #define OPL3SAx_DIGITALPOWER_JOY 0x80
403 #define OPL3SAx_ANALOGPOWER 0x13 /* Analog Partial Power Down (R/W) */
404 #define OPL3SAx_ANALOGPOWER_WIDE 0x01
405 #define OPL3SAx_ANALOGPOWER_SBDAC 0x02
406 #define OPL3SAx_ANALOGPOWER_DA 0x04
407 #define OPL3SAx_ANALOGPOWER_AD 0x08
408 #define OPL3SAx_ANALOGPOWER_FMDAC 0x10
410 #define OPL3SAx_WIDE 0x14 /* Enhanced control(WIDE) (R/W) */
411 #define OPL3SAx_WIDE_WIDEL 0x07 /* Wide level on Left Channel */
412 #define OPL3SAx_WIDE_WIDER 0x70 /* Wide level on Right Channel */
414 #define OPL3SAx_BASS 0x15 /* Enhanced control(BASS) (R/W) */
415 #define OPL3SAx_BASS_BASSL 0x07 /* Bass level on Left Channel */
416 #define OPL3SAx_BASS_BASSR 0x70 /* Bass level on Right Channel */
418 #define OPL3SAx_TREBLE 0x16 /* Enhanced control(TREBLE) (R/W) */
419 #define OPL3SAx_TREBLE_TREBLEL 0x07 /* Treble level on Left Channel */
420 #define OPL3SAx_TREBLE_TREBLER 0x70 /* Treble level on Right Channel */
422 #define OPL3SAx_HWVOL 0x17 /* HW Volume IRQ Configuration (R/W) */
423 #define OPL3SAx_HWVOL_IRQA 0x10 /* HW Volume IRQ on IRQ-A */
424 #define OPL3SAx_HWVOL_IRQB 0x20 /* HW Volume IRQ on IRQ-B */