hilkbd: Kill compiler warning and fix comment dyslexia
[wrt350n-kernel.git] / sound / oss / cs4232.c
blobde40e21bf2798c6d248de7f8dbf6d0fc643cf0ab
1 /*
2 * Copyright (C) by Hannu Savolainen 1993-1997
4 * cs4232.c
6 * The low level driver for Crystal CS4232 based cards. The CS4232 is
7 * a PnP compatible chip which contains a CS4231A codec, SB emulation,
8 * a MPU401 compatible MIDI port, joystick and synthesizer and IDE CD-ROM
9 * interfaces. This is just a temporary driver until full PnP support
10 * gets implemented. Just the WSS codec, FM synth and the MIDI ports are
11 * supported. Other interfaces are left uninitialized.
13 * ifdef ...WAVEFRONT...
15 * Support is provided for initializing the WaveFront synth
16 * interface as well, which is logical device #4. Note that if
17 * you have a Tropez+ card, you probably don't need to setup
18 * the CS4232-supported MIDI interface, since it corresponds to
19 * the internal 26-pin header that's hard to access. Using this
20 * requires an additional IRQ, a resource none too plentiful in
21 * this environment. Just don't set module parameters mpuio and
22 * mpuirq, and the MIDI port will be left uninitialized. You can
23 * still use the ICS2115 hosted MIDI interface which corresponds
24 * to the 9-pin D connector on the back of the card.
26 * endif ...WAVEFRONT...
28 * Supported chips are:
29 * CS4232
30 * CS4236
31 * CS4236B
33 * Note: You will need a PnP config setup to initialise some CS4232 boards
34 * anyway.
36 * Changes
37 * John Rood Added Bose Sound System Support.
38 * Toshio Spoor
39 * Alan Cox Modularisation, Basic cleanups.
40 * Paul Barton-Davis Separated MPU configuration, added
41 * Tropez+ (WaveFront) support
42 * Christoph Hellwig Adapted to module_init/module_exit,
43 * simple cleanups
44 * Arnaldo C. de Melo got rid of attach_uart401
45 * Bartlomiej Zolnierkiewicz
46 * Added some __init/__initdata/__exit
47 * Marcus Meissner Added ISA PnP support.
50 #include <linux/pnp.h>
51 #include <linux/module.h>
52 #include <linux/init.h>
54 #include "sound_config.h"
56 #include "ad1848.h"
57 #include "mpu401.h"
59 #define KEY_PORT 0x279 /* Same as LPT1 status port */
60 #define CSN_NUM 0x99 /* Just a random number */
61 #define INDEX_ADDRESS 0x00 /* (R0) Index Address Register */
62 #define INDEX_DATA 0x01 /* (R1) Indexed Data Register */
63 #define PIN_CONTROL 0x0a /* (I10) Pin Control */
64 #define ENABLE_PINS 0xc0 /* XCTRL0/XCTRL1 enable */
66 static void CS_OUT(unsigned char a)
68 outb(a, KEY_PORT);
71 #define CS_OUT2(a, b) {CS_OUT(a);CS_OUT(b);}
72 #define CS_OUT3(a, b, c) {CS_OUT(a);CS_OUT(b);CS_OUT(c);}
74 static int __initdata bss = 0;
75 static int mpu_base, mpu_irq;
76 static int synth_base, synth_irq;
77 static int mpu_detected;
79 static int probe_cs4232_mpu(struct address_info *hw_config)
82 * Just write down the config values.
85 mpu_base = hw_config->io_base;
86 mpu_irq = hw_config->irq;
88 return 1;
91 static unsigned char crystal_key[] = /* A 32 byte magic key sequence */
93 0x96, 0x35, 0x9a, 0xcd, 0xe6, 0xf3, 0x79, 0xbc,
94 0x5e, 0xaf, 0x57, 0x2b, 0x15, 0x8a, 0xc5, 0xe2,
95 0xf1, 0xf8, 0x7c, 0x3e, 0x9f, 0x4f, 0x27, 0x13,
96 0x09, 0x84, 0x42, 0xa1, 0xd0, 0x68, 0x34, 0x1a
99 static void sleep(unsigned howlong)
101 current->state = TASK_INTERRUPTIBLE;
102 schedule_timeout(howlong);
105 static void enable_xctrl(int baseio)
107 unsigned char regd;
110 * Some IBM Aptiva's have the Bose Sound System. By default
111 * the Bose Amplifier is disabled. The amplifier will be
112 * activated, by setting the XCTRL0 and XCTRL1 bits.
113 * Volume of the monitor bose speakers/woofer, can then
114 * be set by changing the PCM volume.
118 printk("cs4232: enabling Bose Sound System Amplifier.\n");
120 /* Switch to Pin Control Address */
121 regd = inb(baseio + INDEX_ADDRESS) & 0xe0;
122 outb(((unsigned char) (PIN_CONTROL | regd)), baseio + INDEX_ADDRESS );
124 /* Activate the XCTRL0 and XCTRL1 Pins */
125 regd = inb(baseio + INDEX_DATA);
126 outb(((unsigned char) (ENABLE_PINS | regd)), baseio + INDEX_DATA );
129 static int __init probe_cs4232(struct address_info *hw_config, int isapnp_configured)
131 int i, n;
132 int base = hw_config->io_base, irq = hw_config->irq;
133 int dma1 = hw_config->dma, dma2 = hw_config->dma2;
134 struct resource *ports;
136 if (base == -1 || irq == -1 || dma1 == -1) {
137 printk(KERN_ERR "cs4232: dma, irq and io must be set.\n");
138 return 0;
142 * Verify that the I/O port range is free.
145 ports = request_region(base, 4, "ad1848");
146 if (!ports) {
147 printk(KERN_ERR "cs4232.c: I/O port 0x%03x not free\n", base);
148 return 0;
150 if (ad1848_detect(ports, NULL, hw_config->osp)) {
151 goto got_it; /* The card is already active */
153 if (isapnp_configured) {
154 printk(KERN_ERR "cs4232.c: ISA PnP configured, but not detected?\n");
155 goto fail;
159 * This version of the driver doesn't use the PnP method when configuring
160 * the card but a simplified method defined by Crystal. This means that
161 * just one CS4232 compatible device can exist on the system. Also this
162 * method conflicts with possible PnP support in the OS. For this reason
163 * driver is just a temporary kludge.
165 * Also the Cirrus/Crystal method doesn't always work. Try ISA PnP first ;)
169 * Repeat initialization few times since it doesn't always succeed in
170 * first time.
173 for (n = 0; n < 4; n++)
176 * Wake up the card by sending a 32 byte Crystal key to the key port.
179 for (i = 0; i < 32; i++)
180 CS_OUT(crystal_key[i]);
182 sleep(HZ / 10);
185 * Now set the CSN (Card Select Number).
188 CS_OUT2(0x06, CSN_NUM);
191 * Then set some config bytes. First logical device 0
194 CS_OUT2(0x15, 0x00); /* Select logical device 0 (WSS/SB/FM) */
195 CS_OUT3(0x47, (base >> 8) & 0xff, base & 0xff); /* WSS base */
197 if (!request_region(0x388, 4, "FM")) /* Not free */
198 CS_OUT3(0x48, 0x00, 0x00) /* FM base off */
199 else {
200 release_region(0x388, 4);
201 CS_OUT3(0x48, 0x03, 0x88); /* FM base 0x388 */
204 CS_OUT3(0x42, 0x00, 0x00); /* SB base off */
205 CS_OUT2(0x22, irq); /* SB+WSS IRQ */
206 CS_OUT2(0x2a, dma1); /* SB+WSS DMA */
208 if (dma2 != -1)
209 CS_OUT2(0x25, dma2) /* WSS DMA2 */
210 else
211 CS_OUT2(0x25, 4); /* No WSS DMA2 */
213 CS_OUT2(0x33, 0x01); /* Activate logical dev 0 */
215 sleep(HZ / 10);
218 * Initialize logical device 3 (MPU)
221 if (mpu_base != 0 && mpu_irq != 0)
223 CS_OUT2(0x15, 0x03); /* Select logical device 3 (MPU) */
224 CS_OUT3(0x47, (mpu_base >> 8) & 0xff, mpu_base & 0xff); /* MPU base */
225 CS_OUT2(0x22, mpu_irq); /* MPU IRQ */
226 CS_OUT2(0x33, 0x01); /* Activate logical dev 3 */
229 if(synth_base != 0)
231 CS_OUT2 (0x15, 0x04); /* logical device 4 (WaveFront) */
232 CS_OUT3 (0x47, (synth_base >> 8) & 0xff,
233 synth_base & 0xff); /* base */
234 CS_OUT2 (0x22, synth_irq); /* IRQ */
235 CS_OUT2 (0x33, 0x01); /* Activate logical dev 4 */
239 * Finally activate the chip
242 CS_OUT(0x79);
244 sleep(HZ / 5);
247 * Then try to detect the codec part of the chip
250 if (ad1848_detect(ports, NULL, hw_config->osp))
251 goto got_it;
253 sleep(HZ);
255 fail:
256 release_region(base, 4);
257 return 0;
259 got_it:
260 if (dma2 == -1)
261 dma2 = dma1;
263 hw_config->slots[0] = ad1848_init("Crystal audio controller", ports,
264 irq,
265 dma1, /* Playback DMA */
266 dma2, /* Capture DMA */
268 hw_config->osp,
269 THIS_MODULE);
271 if (hw_config->slots[0] != -1 &&
272 audio_devs[hw_config->slots[0]]->mixer_dev!=-1)
274 /* Assume the mixer map is as suggested in the CS4232 databook */
275 AD1848_REROUTE(SOUND_MIXER_LINE1, SOUND_MIXER_LINE);
276 AD1848_REROUTE(SOUND_MIXER_LINE2, SOUND_MIXER_CD);
277 AD1848_REROUTE(SOUND_MIXER_LINE3, SOUND_MIXER_SYNTH); /* FM synth */
279 if (mpu_base != 0 && mpu_irq != 0)
281 static struct address_info hw_config2 = {
283 }; /* Ensure it's initialized */
285 hw_config2.io_base = mpu_base;
286 hw_config2.irq = mpu_irq;
287 hw_config2.dma = -1;
288 hw_config2.dma2 = -1;
289 hw_config2.always_detect = 0;
290 hw_config2.name = NULL;
291 hw_config2.driver_use_1 = 0;
292 hw_config2.driver_use_2 = 0;
293 hw_config2.card_subtype = 0;
295 if (probe_uart401(&hw_config2, THIS_MODULE))
297 mpu_detected = 1;
299 else
301 mpu_base = mpu_irq = 0;
303 hw_config->slots[1] = hw_config2.slots[1];
306 if (bss)
307 enable_xctrl(base);
309 return 1;
312 static void __devexit unload_cs4232(struct address_info *hw_config)
314 int base = hw_config->io_base, irq = hw_config->irq;
315 int dma1 = hw_config->dma, dma2 = hw_config->dma2;
317 if (dma2 == -1)
318 dma2 = dma1;
320 ad1848_unload(base,
321 irq,
322 dma1, /* Playback DMA */
323 dma2, /* Capture DMA */
326 sound_unload_audiodev(hw_config->slots[0]);
327 if (mpu_base != 0 && mpu_irq != 0 && mpu_detected)
329 static struct address_info hw_config2 =
332 }; /* Ensure it's initialized */
334 hw_config2.io_base = mpu_base;
335 hw_config2.irq = mpu_irq;
336 hw_config2.dma = -1;
337 hw_config2.dma2 = -1;
338 hw_config2.always_detect = 0;
339 hw_config2.name = NULL;
340 hw_config2.driver_use_1 = 0;
341 hw_config2.driver_use_2 = 0;
342 hw_config2.card_subtype = 0;
343 hw_config2.slots[1] = hw_config->slots[1];
345 unload_uart401(&hw_config2);
349 static struct address_info cfg;
350 static struct address_info cfg_mpu;
352 static int __initdata io = -1;
353 static int __initdata irq = -1;
354 static int __initdata dma = -1;
355 static int __initdata dma2 = -1;
356 static int __initdata mpuio = -1;
357 static int __initdata mpuirq = -1;
358 static int __initdata synthio = -1;
359 static int __initdata synthirq = -1;
360 static int __initdata isapnp = 1;
362 static unsigned int cs4232_devices;
364 MODULE_DESCRIPTION("CS4232 based soundcard driver");
365 MODULE_AUTHOR("Hannu Savolainen, Paul Barton-Davis");
366 MODULE_LICENSE("GPL");
368 module_param(io, int, 0);
369 MODULE_PARM_DESC(io,"base I/O port for AD1848");
370 module_param(irq, int, 0);
371 MODULE_PARM_DESC(irq,"IRQ for AD1848 chip");
372 module_param(dma, int, 0);
373 MODULE_PARM_DESC(dma,"8 bit DMA for AD1848 chip");
374 module_param(dma2, int, 0);
375 MODULE_PARM_DESC(dma2,"16 bit DMA for AD1848 chip");
376 module_param(mpuio, int, 0);
377 MODULE_PARM_DESC(mpuio,"MPU 401 base address");
378 module_param(mpuirq, int, 0);
379 MODULE_PARM_DESC(mpuirq,"MPU 401 IRQ");
380 module_param(synthio, int, 0);
381 MODULE_PARM_DESC(synthio,"Maui WaveTable base I/O port");
382 module_param(synthirq, int, 0);
383 MODULE_PARM_DESC(synthirq,"Maui WaveTable IRQ");
384 module_param(isapnp, bool, 0);
385 MODULE_PARM_DESC(isapnp,"Enable ISAPnP probing (default 1)");
386 module_param(bss, bool, 0);
387 MODULE_PARM_DESC(bss,"Enable Bose Sound System Support (default 0)");
390 * Install a CS4232 based card. Need to have ad1848 and mpu401
391 * loaded ready.
394 /* All cs4232 based cards have the main ad1848 card either as CSC0000 or
395 * CSC0100. */
396 static const struct pnp_device_id cs4232_pnp_table[] = {
397 { .id = "CSC0100", .driver_data = 0 },
398 { .id = "CSC0000", .driver_data = 0 },
399 /* Guillemot Turtlebeach something appears to be cs4232 compatible
400 * (untested) */
401 { .id = "GIM0100", .driver_data = 0 },
402 { .id = ""}
405 MODULE_DEVICE_TABLE(pnp, cs4232_pnp_table);
407 static int __init cs4232_pnp_probe(struct pnp_dev *dev, const struct pnp_device_id *dev_id)
409 struct address_info *isapnpcfg;
411 isapnpcfg = kmalloc(sizeof(*isapnpcfg),GFP_KERNEL);
412 if (!isapnpcfg)
413 return -ENOMEM;
415 isapnpcfg->irq = pnp_irq(dev, 0);
416 isapnpcfg->dma = pnp_dma(dev, 0);
417 isapnpcfg->dma2 = pnp_dma(dev, 1);
418 isapnpcfg->io_base = pnp_port_start(dev, 0);
419 if (probe_cs4232(isapnpcfg,TRUE) == 0) {
420 printk(KERN_ERR "cs4232: ISA PnP card found, but not detected?\n");
421 kfree(isapnpcfg);
422 return -ENODEV;
424 pnp_set_drvdata(dev,isapnpcfg);
425 cs4232_devices++;
426 return 0;
429 static void __devexit cs4232_pnp_remove(struct pnp_dev *dev)
431 struct address_info *cfg = pnp_get_drvdata(dev);
432 if (cfg) {
433 unload_cs4232(cfg);
434 kfree(cfg);
438 static struct pnp_driver cs4232_driver = {
439 .name = "cs4232",
440 .id_table = cs4232_pnp_table,
441 .probe = cs4232_pnp_probe,
442 .remove = __devexit_p(cs4232_pnp_remove),
445 static int __init init_cs4232(void)
447 #ifdef CONFIG_SOUND_WAVEFRONT_MODULE
448 if(synthio == -1)
449 printk(KERN_INFO "cs4232: set synthio and synthirq to use the wavefront facilities.\n");
450 else {
451 synth_base = synthio;
452 synth_irq = synthirq;
454 #else
455 if(synthio != -1)
456 printk(KERN_WARNING "cs4232: wavefront support not enabled in this driver.\n");
457 #endif
458 cfg.irq = -1;
460 if (isapnp) {
461 pnp_register_driver(&cs4232_driver);
462 if (cs4232_devices)
463 return 0;
466 if(io==-1||irq==-1||dma==-1)
468 printk(KERN_ERR "cs4232: Must set io, irq and dma.\n");
469 return -ENODEV;
472 cfg.io_base = io;
473 cfg.irq = irq;
474 cfg.dma = dma;
475 cfg.dma2 = dma2;
477 cfg_mpu.io_base = -1;
478 cfg_mpu.irq = -1;
480 if (mpuio != -1 && mpuirq != -1) {
481 cfg_mpu.io_base = mpuio;
482 cfg_mpu.irq = mpuirq;
483 probe_cs4232_mpu(&cfg_mpu); /* Bug always returns 0 not OK -- AC */
486 if (probe_cs4232(&cfg,FALSE) == 0)
487 return -ENODEV;
489 return 0;
492 static void __exit cleanup_cs4232(void)
494 pnp_unregister_driver(&cs4232_driver);
495 if (cfg.irq != -1)
496 unload_cs4232(&cfg); /* Unloads global MPU as well, if needed */
499 module_init(init_cs4232);
500 module_exit(cleanup_cs4232);
502 #ifndef MODULE
503 static int __init setup_cs4232(char *str)
505 /* io, irq, dma, dma2 mpuio, mpuirq*/
506 int ints[7];
508 /* If we have isapnp cards, no need for options */
509 pnp_register_driver(&cs4232_driver);
510 if (cs4232_devices)
511 return 1;
513 str = get_options(str, ARRAY_SIZE(ints), ints);
515 io = ints[1];
516 irq = ints[2];
517 dma = ints[3];
518 dma2 = ints[4];
519 mpuio = ints[5];
520 mpuirq = ints[6];
522 return 1;
525 __setup("cs4232=", setup_cs4232);
526 #endif