xref: /netbsd-src/sys/dev/isa/pas.c (revision 8b0f9554ff8762542c4defc4f70e1eb76fb508fa)
1 /*	$NetBSD: pas.c,v 1.66 2007/10/19 12:00:21 ad 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  * jfw 7/13/97 - The soundblaster code requires the generic bus-space
38  * structures to be set up properly.  Rather than go to the effort of making
39  * code for a dead line fully generic, properly set up the SB structures and
40  * leave the rest x86/ISA/default-configuration specific.  If you have a
41  * REAL computer, go buy a REAL sound card.
42  */
43 /*
44  * Todo:
45  *	- look at other PAS drivers (for PAS native suport)
46  *	- use common sb.c once emulation is setup
47  */
48 /*
49  * jfw 6/21/98 - WARNING:  the PAS native IO ports are scattered all around
50  * IO port space (0x0388, 0x738B, 0xBF88, 0x2789, ...) which will make proper
51  * reservation a real pain, so I'm not going to do it (while fixing the
52  * current reservation code to "work").  As a sanity check, I reserve the
53  * 0x0388 base address, but you probably shouldn't even think of trying this
54  * driver unless you're certain you have the hardware installed and it doesn't
55  * conflict with other hardware...
56  */
57 
58 
59 #include <sys/cdefs.h>
60 __KERNEL_RCSID(0, "$NetBSD: pas.c,v 1.66 2007/10/19 12:00:21 ad Exp $");
61 
62 #include <sys/param.h>
63 #include <sys/systm.h>
64 #include <sys/errno.h>
65 #include <sys/ioctl.h>
66 #include <sys/syslog.h>
67 #include <sys/device.h>
68 #include <sys/proc.h>
69 
70 #include <sys/cpu.h>
71 #include <sys/intr.h>
72 #include <sys/bus.h>
73 #include <machine/pio.h>
74 
75 #include <sys/audioio.h>
76 #include <dev/audio_if.h>
77 #include <dev/midi_if.h>
78 
79 #include <dev/isa/isavar.h>
80 #include <dev/isa/isadmavar.h>
81 
82 #include <dev/isa/sbdspvar.h>
83 #include <dev/isa/sbreg.h>
84 
85 #define DEFINE_TRANSLATIONS
86 #include <dev/isa/pasreg.h>
87 
88 #ifdef AUDIO_DEBUG
89 #define DPRINTF(x)	if (pasdebug) printf x
90 int	pasdebug = 0;
91 #else
92 #define DPRINTF(x)
93 #endif
94 
95 /*
96  * Software state, per SoundBlaster card.
97  * The soundblaster has multiple functionality, which we must demultiplex.
98  * One approach is to have one major device number for the soundblaster card,
99  * and use different minor numbers to indicate which hardware function
100  * we want.  This would make for one large driver.  Instead our approach
101  * is to partition the design into a set of drivers that share an underlying
102  * piece of hardware.  Most things are hard to share, for example, the audio
103  * and midi ports.  For audio, we might want to mix two processes' signals,
104  * and for midi we might want to merge streams (this is hard due to
105  * running status).  Moreover, we should be able to re-use the high-level
106  * modules with other kinds of hardware.  In this module, we only handle the
107  * most basic communications with the sb card.
108  */
109 struct pas_softc {
110 	struct sbdsp_softc sc_sbdsp;	/* base device, &c. */
111 	bus_space_handle_t pas_port_handle;    /* the pas-specific port */
112 
113 	int model;
114 	int rev;
115 };
116 
117 int	pas_getdev(void *, struct audio_device *);
118 void	pasconf(int, int, int, int);
119 
120 
121 /*
122  * Define our interface to the higher level audio driver.
123  */
124 
125 const struct audio_hw_if pas_hw_if = {
126 	sbdsp_open,
127 	sbdsp_close,
128 	0,
129 	sbdsp_query_encoding,
130 	sbdsp_set_params,
131 	sbdsp_round_blocksize,
132 	0,
133 	0,
134 	0,
135 	0,
136 	0,
137 	sbdsp_halt_output,
138 	sbdsp_halt_input,
139 	sbdsp_speaker_ctl,
140 	pas_getdev,
141 	0,
142 	sbdsp_mixer_set_port,
143 	sbdsp_mixer_get_port,
144 	sbdsp_mixer_query_devinfo,
145 	sb_malloc,
146 	sb_free,
147 	sb_round_buffersize,
148 	sb_mappage,
149 	sbdsp_get_props,
150 	sbdsp_trigger_output,
151 	sbdsp_trigger_input,
152 	0,
153 	NULL,
154 };
155 
156 /* The Address Translation code is used to convert I/O register addresses to
157    be relative to the given base -register */
158 
159 static const char *pasnames[] = {
160 	"",
161 	"Plus",
162 	"CDPC",
163 	"16",
164 	"16Basic"
165 };
166 
167 static struct audio_device pas_device = {
168 	"PAS,??",
169 	"",
170 	"pas"
171 };
172 
173 /*XXX assume default I/O base address */
174 #define pasread(p) inb((p))
175 #define paswrite(d, p) outb((p), (d))
176 
177 void
178 pasconf(int model, int sbbase, int sbirq, int sbdrq)
179 {
180 
181 	paswrite(0x00, INTERRUPT_MASK);
182 	/* Local timer control register */
183 	paswrite(0x36, SAMPLE_COUNTER_CONTROL);
184 	/* Sample rate timer (16 bit) */
185 	paswrite(0x36, SAMPLE_RATE_TIMER);
186 	paswrite(0, SAMPLE_RATE_TIMER);
187 	/* Local timer control register */
188 	paswrite(0x74, SAMPLE_COUNTER_CONTROL);
189 	/* Sample count register (16 bit) */
190 	paswrite(0x74, SAMPLE_BUFFER_COUNTER);
191 	paswrite(0, SAMPLE_BUFFER_COUNTER);
192 
193 	paswrite(P_C_PCM_MONO | P_C_PCM_DAC_MODE |
194 	    P_C_MIXER_CROSS_L_TO_L | P_C_MIXER_CROSS_R_TO_R,
195 	    PCM_CONTROL);
196 	paswrite(S_M_PCM_RESET | S_M_FM_RESET |
197 	    S_M_SB_RESET | S_M_MIXER_RESET, SERIAL_MIXER);
198 
199 /*XXX*/
200 	paswrite(I_C_1_BOOT_RESET_ENABLE|1, IO_CONFIGURATION_1);
201 
202 	paswrite(I_C_2_PCM_DMA_DISABLED, IO_CONFIGURATION_2);
203 	paswrite(I_C_3_PCM_IRQ_DISABLED, IO_CONFIGURATION_3);
204 
205 #ifdef BROKEN_BUS_CLOCK
206 	paswrite(S_C_1_PCS_ENABLE | S_C_1_PCS_STEREO | S_C_1_PCS_REALSOUND |
207 	    S_C_1_FM_EMULATE_CLOCK, SYSTEM_CONFIGURATION_1);
208 #else
209 	paswrite(S_C_1_PCS_ENABLE | S_C_1_PCS_STEREO | S_C_1_PCS_REALSOUND,
210 	    SYSTEM_CONFIGURATION_1);
211 #endif
212 
213 	/*XXX*/
214 	paswrite(0, SYSTEM_CONFIGURATION_2);
215 	paswrite(0, SYSTEM_CONFIGURATION_3);
216 
217 	/* Sets mute off and selects filter rate of 17.897 kHz */
218 	paswrite(F_F_MIXER_UNMUTE | 0x01, FILTER_FREQUENCY);
219 
220 	if (model == PAS_16 || model == PAS_16BASIC)
221 		paswrite(8, PRESCALE_DIVIDER);
222 	else
223 		paswrite(0, PRESCALE_DIVIDER);
224 
225 	paswrite(P_M_MV508_ADDRESS | P_M_MV508_PCM, PARALLEL_MIXER);
226 	paswrite(5, PARALLEL_MIXER);
227 
228 	/*
229 	 * Setup SoundBlaster emulation.
230 	 */
231 	paswrite((sbbase >> 4) & 0xf, EMULATION_ADDRESS);
232 	paswrite(E_C_SB_IRQ_translate[sbirq] | E_C_SB_DMA_translate[sbdrq],
233 	    EMULATION_CONFIGURATION);
234 	paswrite(C_E_SB_ENABLE, COMPATIBILITY_ENABLE);
235 
236 	/*
237 	 * Set mid-range levels.
238 	 */
239 	paswrite(P_M_MV508_ADDRESS | P_M_MV508_MODE, PARALLEL_MIXER);
240 	paswrite(P_M_MV508_LOUDNESS | P_M_MV508_ENHANCE_NONE, PARALLEL_MIXER);
241 
242 	paswrite(P_M_MV508_ADDRESS | P_M_MV508_MASTER_A, PARALLEL_MIXER);
243 	paswrite(50, PARALLEL_MIXER);
244 	paswrite(P_M_MV508_ADDRESS | P_M_MV508_MASTER_B, PARALLEL_MIXER);
245 	paswrite(50, PARALLEL_MIXER);
246 
247 	paswrite(P_M_MV508_ADDRESS | P_M_MV508_MIXER | P_M_MV508_SB,
248 	    PARALLEL_MIXER);
249 	paswrite(P_M_MV508_OUTPUTMIX | 30, PARALLEL_MIXER);
250 
251 	paswrite(P_M_MV508_ADDRESS | P_M_MV508_MIXER | P_M_MV508_MIC,
252 	    PARALLEL_MIXER);
253 	paswrite(P_M_MV508_INPUTMIX | 30, PARALLEL_MIXER);
254 }
255 
256 int	pasprobe(struct device *, struct cfdata *, void *);
257 void	pasattach(struct device *, struct device *, void *);
258 static	int pasfind(struct device *, struct pas_softc *,
259     struct isa_attach_args *, int);
260 /* argument to pasfind */
261 #define PASPROBE  1
262 #define PASATTACH 0
263 
264 CFATTACH_DECL(pas, sizeof(struct pas_softc),
265     pasprobe, pasattach, NULL, NULL);
266 
267 /*
268  * Probe / attach routines.
269  */
270 
271 int
272 pasprobe(struct device *parent, struct cfdata *match, void *aux)
273 {
274 	struct isa_attach_args *ia;
275 	struct pas_softc probesc, *sc;
276 
277 	ia = aux;
278 	sc = &probesc;
279 	if (ia->ia_nio < 1)
280 		return 0;
281 	if (ia->ia_nirq < 1)
282 		return 0;
283 	if (ia->ia_ndrq < 1)
284 		return 0;
285 
286 	if (ISA_DIRECT_CONFIG(ia))
287 		return 0;
288 
289 	memset(sc, 0, sizeof *sc);
290 	sc->sc_sbdsp.sc_dev.dv_cfdata = match;
291 	strcpy(sc->sc_sbdsp.sc_dev.dv_xname, "pas");
292 	return pasfind(parent, sc, aux, PASPROBE);
293 }
294 
295 /*
296  * Probe for the soundblaster hardware.
297  */
298 static int
299 pasfind(struct device *parent, struct pas_softc *sc,
300     struct isa_attach_args *ia, int probing)
301 {
302 	int iobase;
303 	u_char id, t;
304 	int rc;
305 
306 	rc = 0;			/* failure */
307 	/* ensure we can set this up as a sound blaster */
308 	if (!SB_BASE_VALID(ia->ia_io[0].ir_addr)) {
309 		printf("pas: configured SB iobase 0x%x invalid\n",
310 		    ia->ia_io[0].ir_addr);
311 		return 0;
312 	}
313 
314 	if (bus_space_map(sc->sc_sbdsp.sc_iot, PAS_DEFAULT_BASE, 1, 0,
315 	    &sc->pas_port_handle)) {
316 		printf("pas: can't map base register %x in probe\n",
317 		    PAS_DEFAULT_BASE);
318 		return 0;
319 	}
320 
321 	/*
322 	 * WARNING: Setting an option like W:1 or so that disables
323 	 * warm boot reset of the card will screw up this detect code
324 	 * something fierce.  Adding code to handle this means possibly
325 	 * interfering with other cards on the bus if you have something
326 	 * on base port 0x388.  SO be forewarned.
327 	 */
328 	/* Talk to first board */
329 	outb(MASTER_DECODE, 0xbc);
330 	/* Set base address */
331 
332 #if 0
333 	/* XXX Need to setup pseudo device */
334 	/* XXX What are good io addrs ? */
335 	if (iobase != PAS_DEFAULT_BASE) {
336 		printf("pas: configured iobase %d invalid\n", iobase);
337 		return 0;
338 	}
339 #else
340 	/* Start out talking to native PAS */
341 	iobase = PAS_DEFAULT_BASE;
342 #endif
343 
344 	outb(MASTER_DECODE, iobase >> 2);
345 	/* One wait-state */
346 	paswrite(1, WAIT_STATE);
347 
348 	id = pasread(INTERRUPT_MASK);
349 	if (id == 0xff || id == 0xfe) {
350 		/* sanity */
351 		DPRINTF(("pas: bogus card id\n"));
352 		goto unmap1;
353 	}
354 	/*
355 	 * We probably have a PAS-series board, now check for a
356 	 * PAS2-series board by trying to change the board revision
357 	 * bits.  PAS2-series hardware won't let you do this because
358 	 * the bits are read-only.
359 	 */
360 	t = id ^ 0xe0;
361 	paswrite(t, INTERRUPT_MASK);
362 	t = inb(INTERRUPT_MASK);
363 	paswrite(id, INTERRUPT_MASK);
364 
365 	if (t != id) {
366 		/* Not a PAS2 */
367 		printf("pas: detected card but PAS2 test failed\n");
368 		goto unmap1;
369 	}
370 	/*XXX*/
371 	t = pasread(OPERATION_MODE_1) & 0xf;
372 	sc->model = O_M_1_to_card[t];
373 	if (sc->model != 0) {
374 		sc->rev = pasread(BOARD_REV_ID);
375 	} else {
376 		DPRINTF(("pas: bogus model id\n"));
377 		goto unmap1;
378 	}
379 
380 	if (sc->model >= 0) {
381 		if (ia->ia_irq[0].ir_irq == ISA_UNKNOWN_IRQ) {
382 			printf("pas: sb emulation requires known irq\n");
383 			goto unmap1;
384 		}
385 		pasconf(sc->model, ia->ia_io[0].ir_addr,
386 		    ia->ia_irq[0].ir_irq, 1);
387 	} else {
388 		DPRINTF(("pas: could not probe pas\n"));
389 		goto unmap1;
390 	}
391 
392 	/* Now a SoundBlaster, so set up proper bus-space hooks
393          * appropriately
394          */
395 
396 	sc->sc_sbdsp.sc_iobase = ia->ia_io[0].ir_addr;
397 	sc->sc_sbdsp.sc_iot = ia->ia_iot;
398 
399 	/* Map i/o space [we map 24 ports which is the max of the sb and pro */
400 	if (bus_space_map(sc->sc_sbdsp.sc_iot, ia->ia_io[0].ir_addr,
401 	    SBP_NPORT, 0, &sc->sc_sbdsp.sc_ioh)) {
402 		printf("pas: can't map i/o space 0x%x/%d in probe\n",
403 		    ia->ia_io[0].ir_addr, SBP_NPORT);
404 		goto unmap1;
405 	}
406 
407 	if (sbdsp_reset(&sc->sc_sbdsp) < 0) {
408 		DPRINTF(("pas: couldn't reset card\n"));
409 		goto unmap;
410 	}
411 
412 	/*
413 	 * Cannot auto-discover DMA channel.
414 	 */
415 	if (!SB_DRQ_VALID(ia->ia_drq[0].ir_drq)) {
416 		printf("pas: configured DMA chan %d invalid\n",
417 		    ia->ia_drq[0].ir_drq);
418 		goto unmap;
419 	}
420 	if (!SB_IRQ_VALID(ia->ia_irq[0].ir_irq)) {
421 		printf("pas: configured irq chan %d invalid\n",
422 		    ia->ia_drq[0].ir_drq);
423 		goto unmap;
424 	}
425 
426 	sc->sc_sbdsp.sc_irq = ia->ia_irq[0].ir_irq;
427 	sc->sc_sbdsp.sc_drq8 = ia->ia_drq[0].ir_drq;
428 	sc->sc_sbdsp.sc_drq16 = -1; /* XXX */
429 
430 	if (sbdsp_probe(&sc->sc_sbdsp) == 0) {
431 		DPRINTF(("pas: sbdsp probe failed\n"));
432 		goto unmap;
433 	}
434 
435 	rc = 1;
436 
437 	if (probing) {
438 		ia->ia_nio = 1;
439 		ia->ia_io[0].ir_size = SBP_NPORT;
440 
441 		ia->ia_nirq = 1;
442 		ia->ia_ndrq = 1;
443 
444 		ia->ia_niomem = 0;
445 	}
446 
447  unmap:
448 	if (rc == 0 || probing)
449 		bus_space_unmap(sc->sc_sbdsp.sc_iot, sc->sc_sbdsp.sc_ioh,
450 		    SBP_NPORT);
451  unmap1:
452 	if (rc == 0 || probing)
453 		bus_space_unmap(sc->sc_sbdsp.sc_iot, PAS_DEFAULT_BASE, 1);
454 	return rc;
455 }
456 
457 /*
458  * Attach hardware to driver, attach hardware driver to audio
459  * pseudo-device driver .
460  */
461 void
462 pasattach(struct device *parent, struct device *self, void *aux)
463 {
464 	struct pas_softc *sc;
465 	struct isa_attach_args *ia;
466 	int iobase;
467 
468 	sc = (struct pas_softc *)self;
469 	ia = (struct isa_attach_args *)aux;
470 	iobase = ia->ia_io[0].ir_addr;
471 	if (!pasfind(parent, sc, ia, PASATTACH)) {
472 		printf("%s: pasfind failed\n", sc->sc_sbdsp.sc_dev.dv_xname);
473 		return;
474 	}
475 
476 	sc->sc_sbdsp.sc_ic = ia->ia_ic;
477 	sc->sc_sbdsp.sc_iobase = iobase;
478 	sc->sc_sbdsp.sc_ih = isa_intr_establish(ia->ia_ic, ia->ia_irq[0].ir_irq,
479 	    IST_EDGE, IPL_AUDIO, sbdsp_intr, &sc->sc_sbdsp);
480 
481 	printf(" ProAudio Spectrum %s [rev %d] ", pasnames[sc->model],
482 	    sc->rev);
483 
484 	sbdsp_attach(&sc->sc_sbdsp);
485 
486 	snprintf(pas_device.name, sizeof(pas_device.name), "pas,%s",
487 	    pasnames[sc->model]);
488 	snprintf(pas_device.version, sizeof(pas_device.version), "%d",
489 	    sc->rev);
490 
491 	audio_attach_mi(&pas_hw_if, &sc->sc_sbdsp, &sc->sc_sbdsp.sc_dev);
492 }
493 
494 int
495 pas_getdev(void *addr, struct audio_device *retp)
496 {
497 
498 	*retp = pas_device;
499 	return 0;
500 }
501