sbdspvar.h revision 1.61 1 /* $NetBSD: sbdspvar.h,v 1.61 2011/11/23 23:07:33 jmcneill Exp $ */
2
3 /*
4 * Copyright (c) 1991-1993 Regents of the University of California.
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. All advertising materials mentioning features or use of this software
16 * must display the following acknowledgement:
17 * This product includes software developed by the Computer Systems
18 * Engineering Group at Lawrence Berkeley Laboratory.
19 * 4. Neither the name of the University nor of the Laboratory may be used
20 * to endorse or promote products derived from this software without
21 * specific prior written permission.
22 *
23 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * SUCH DAMAGE.
34 *
35 */
36
37 #include "mpu.h"
38 #if NMPU > 0
39 #include <dev/ic/mpuvar.h>
40 #endif
41
42 #define SB_MASTER_VOL 0
43 #define SB_MIDI_VOL 1
44 #define SB_CD_VOL 2
45 #define SB_VOICE_VOL 3
46 #define SB_OUTPUT_CLASS 4
47
48 #define SB_MIC_VOL 5
49 #define SB_LINE_IN_VOL 6
50 #define SB_RECORD_SOURCE 7
51 #define SB_TREBLE 8
52 #define SB_BASS 9
53 #define SB_RECORD_CLASS 10
54 #define SB_INPUT_CLASS 11
55
56 #define SB_PCSPEAKER 12
57 #define SB_INPUT_GAIN 13
58 #define SB_OUTPUT_GAIN 14
59 #define SB_AGC 15
60 #define SB_EQUALIZATION_CLASS 16
61
62 #define SB_CD_IN_MUTE 17
63 #define SB_MIC_IN_MUTE 18
64 #define SB_LINE_IN_MUTE 19
65 #define SB_MIDI_IN_MUTE 20
66
67 #define SB_CD_SWAP 21
68 #define SB_MIC_SWAP 22
69 #define SB_LINE_SWAP 23
70 #define SB_MIDI_SWAP 24
71
72 #define SB_CD_OUT_MUTE 25
73 #define SB_MIC_OUT_MUTE 26
74 #define SB_LINE_OUT_MUTE 27
75
76 #define SB_NDEVS 28
77
78 #define SB_IS_IN_MUTE(x) ((x) < SB_CD_SWAP)
79
80 /*
81 * Software state, per SoundBlaster card.
82 * The soundblaster has multiple functionality, which we must demultiplex.
83 * One approach is to have one major device number for the soundblaster card,
84 * and use different minor numbers to indicate which hardware function
85 * we want. This would make for one large driver. Instead our approach
86 * is to partition the design into a set of drivers that share an underlying
87 * piece of hardware. Most things are hard to share, for example, the audio
88 * and midi ports. For audio, we might want to mix two processes' signals,
89 * and for midi we might want to merge streams (this is hard due to
90 * running status). Moreover, we should be able to re-use the high-level
91 * modules with other kinds of hardware. In this module, we only handle the
92 * most basic communications with the sb card.
93 */
94 struct sbdsp_softc {
95 device_t sc_dev; /* base device */
96 isa_chipset_tag_t sc_ic;
97 bus_space_tag_t sc_iot; /* tag */
98 bus_space_handle_t sc_ioh; /* handle */
99 void *sc_ih; /* interrupt vectoring */
100 kmutex_t sc_lock;
101 kmutex_t sc_intr_lock;
102
103 /* XXX These are only for setting chip configuration registers. */
104 int sc_iobase; /* I/O port base address */
105 int sc_irq; /* interrupt */
106
107 int sc_drq8; /* DMA (8-bit) */
108 bus_size_t sc_drq8_maxsize;
109 int sc_drq16; /* DMA (16-bit) */
110 bus_size_t sc_drq16_maxsize;
111
112 u_int sc_quirks; /* minor variations */
113 #define SB_QUIRK_NO_INIT_DRQ 0x01
114
115 int sc_open; /* reference count of open calls */
116 #define SB_CLOSED 0
117 #define SB_OPEN_AUDIO 1
118 #define SB_OPEN_MIDI 2
119 u_char sc_fullduplex; /* can do full duplex */
120
121 u_char gain[SB_NDEVS][2]; /* kept in input levels */
122 #define SB_LEFT 0
123 #define SB_RIGHT 1
124 #define SB_LR 0
125
126 u_int in_mask; /* input ports */
127 u_int in_port; /* XXX needed for MI interface */
128 u_int in_filter; /* one of SB_TREBLE_EQ, SB_BASS_EQ, 0 */
129
130 u_int spkr_state; /* non-null is on */
131
132 struct sbdsp_state {
133 u_int rate; /* Sample rate */
134 u_char tc; /* Time constant */
135 struct sbmode *modep;
136 u_char bmode;
137 int dmachan; /* DMA channel */
138 int blksize; /* Block size, preadjusted */
139 u_char run;
140 #define SB_NOTRUNNING 0 /* Not running, not initialized */
141 #define SB_RUNNING 3 /* non-looping mode */
142 #define SB_LOOPING 2 /* DMA&PCM running (looping mode) */
143 } sc_i, sc_o; /* Input and output state */
144
145 u_long sc_interrupts; /* number of interrupts taken */
146
147 int (*sc_intr8)(void*); /* DMA completion intr handler */
148 int (*sc_intr16)(void*); /* DMA completion intr handler */
149 void (*sc_intrp)(void*); /* PCM output intr handler */
150 void *sc_argp; /* arg for sc_intrp() */
151 void (*sc_intrr)(void*); /* PCM input intr handler */
152 void *sc_argr; /* arg for sc_intrr() */
153 void (*sc_intrm)(void*, int);/* midi input intr handler */
154 void *sc_argm; /* arg for sc_intrm() */
155
156 u_int sc_mixer_model;
157 #define SBM_NONE 0
158 #define SBM_CT1335 1
159 #define SBM_CT1345 2
160 #define SBM_CT1XX5 3
161 #define SBM_CT1745 4
162 #define ISSBM1745(x) ((x)->sc_mixer_model >= SBM_CT1XX5)
163
164 u_int sc_model; /* DSP model */
165 #define SB_UNK -1
166 #define SB_1 0 /* original SB */
167 #define SB_20 1 /* SB 2 */
168 #define SB_2x 2 /* SB 2, new version */
169 #define SB_PRO 3 /* SB Pro */
170 #define SB_JAZZ 4 /* Jazz 16 */
171 #define SB_16 5 /* SB 16 */
172 #define SB_32 6 /* SB AWE 32 */
173 #define SB_64 7 /* SB AWE 64 */
174
175 #define SB_NAMES { "SB_1", "SB_2.0", "SB_2.x", "SB_Pro", "Jazz_16", "SB_16", \
176 "SB_AWE_32", "SB_AWE_64" }
177
178 u_int sc_version; /* DSP version */
179 #define SBVER_MAJOR(v) (((v)>>8) & 0xff)
180 #define SBVER_MINOR(v) ((v)&0xff)
181
182 #if NMPU > 0
183 int sc_hasmpu;
184 #define SBMPU_EXTERNAL 1
185 #define SBMPU_INTERNAL 0
186 #define SBMPU_NONE -1
187 device_t sc_mpudev;
188 bus_space_tag_t sc_mpu_iot; /* tag */
189 bus_space_handle_t sc_mpu_ioh; /* handle */
190 #endif
191 };
192
193 #define ISSBPRO(sc) ((sc)->sc_model == SB_PRO || (sc)->sc_model == SB_JAZZ)
194 #define ISSBPROCLASS(sc) ((sc)->sc_model >= SB_PRO)
195 #define ISSB16CLASS(sc) ((sc)->sc_model >= SB_16)
196
197 #ifdef _KERNEL
198 struct malloc_type;
199
200 int sbdsp_open(void *, int);
201 void sbdsp_close(void *);
202
203 int sbdsp_probe(struct sbdsp_softc *, cfdata_t);
204 void sbdsp_attach(struct sbdsp_softc *);
205
206 int sbdsp_set_in_gain(void *, u_int, u_char);
207 int sbdsp_set_in_gain_real(void *, u_int, u_char);
208 int sbdsp_get_in_gain(void *);
209 int sbdsp_set_out_gain(void *, u_int, u_char);
210 int sbdsp_set_out_gain_real(void *, u_int, u_char);
211 int sbdsp_get_out_gain(void *);
212 int sbdsp_set_monitor_gain(void *, u_int);
213 int sbdsp_get_monitor_gain(void *);
214 int sbdsp_query_encoding(void *, struct audio_encoding *);
215 int sbdsp_set_params(void *, int, int, audio_params_t *, audio_params_t *,
216 stream_filter_list_t *, stream_filter_list_t *);
217 int sbdsp_round_blocksize(void *, int, int, const audio_params_t *);
218 int sbdsp_get_avail_in_ports(void *);
219 int sbdsp_get_avail_out_ports(void *);
220 int sbdsp_speaker_ctl(void *, int);
221
222 int sbdsp_commit(void *);
223 int sbdsp_trigger_output(void *, void *, void *, int, void (*)(void *),
224 void *, const audio_params_t *);
225 int sbdsp_trigger_input(void *, void *, void *, int, void (*)(void *),
226 void *, const audio_params_t *);
227 int sbdsp_halt_output(void *);
228 int sbdsp_halt_input(void *);
229
230 void sbdsp_compress(int, u_char *, int);
231 void sbdsp_expand(int, u_char *, int);
232
233 int sbdsp_reset(struct sbdsp_softc *);
234 void sbdsp_spkron(struct sbdsp_softc *);
235 void sbdsp_spkroff(struct sbdsp_softc *);
236
237 int sbdsp_wdsp(struct sbdsp_softc *, int);
238 int sbdsp_rdsp(struct sbdsp_softc *);
239
240 int sbdsp_intr(void *);
241
242 int sbdsp_set_sr(struct sbdsp_softc *, u_long *, int);
243
244 void sbdsp_mix_write(struct sbdsp_softc *, int, int);
245 int sbdsp_mix_read(struct sbdsp_softc *, int);
246
247 int sbdsp_mixer_set_port(void *, mixer_ctrl_t *);
248 int sbdsp_mixer_get_port(void *, mixer_ctrl_t *);
249 int sbdsp_mixer_query_devinfo(void *, mixer_devinfo_t *);
250
251 void *sb_malloc(void *, int, size_t);
252 void sb_free(void *, void *, size_t);
253 size_t sb_round_buffersize(void *, int, size_t);
254 paddr_t sb_mappage(void *, void *, off_t, int);
255
256 int sbdsp_get_props(void *);
257 void sbdsp_get_locks(void *, kmutex_t **, kmutex_t **);
258
259 int sbdsp_midi_open(void *, int, void (*iintr)(void *, int),
260 void (*ointr)(void *), void *);
261 void sbdsp_midi_close(void *);
262 int sbdsp_midi_output(void *, int);
263 void sbdsp_midi_getinfo(void *, struct midi_info *);
264 #endif
265