2 * Copyright (C) by Hannu Savolainen 1993-1997
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:
33 * Note: You will need a PnP config setup to initialise some CS4232 boards
37 * John Rood Added Bose Sound System Support.
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,
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/config.h>
51 #include <linux/pnp.h>
52 #include <linux/module.h>
53 #include <linux/init.h>
55 #include "sound_config.h"
60 #define KEY_PORT 0x279 /* Same as LPT1 status port */
61 #define CSN_NUM 0x99 /* Just a random number */
62 #define INDEX_ADDRESS 0x00 /* (R0) Index Address Register */
63 #define INDEX_DATA 0x01 /* (R1) Indexed Data Register */
64 #define PIN_CONTROL 0x0a /* (I10) Pin Control */
65 #define ENABLE_PINS 0xc0 /* XCTRL0/XCTRL1 enable */
67 static void CS_OUT(unsigned char a
)
72 #define CS_OUT2(a, b) {CS_OUT(a);CS_OUT(b);}
73 #define CS_OUT3(a, b, c) {CS_OUT(a);CS_OUT(b);CS_OUT(c);}
75 static int __initdata bss
= 0;
76 static int mpu_base
, mpu_irq
;
77 static int synth_base
, synth_irq
;
78 static int mpu_detected
;
80 static int probe_cs4232_mpu(struct address_info
*hw_config
)
83 * Just write down the config values.
86 mpu_base
= hw_config
->io_base
;
87 mpu_irq
= hw_config
->irq
;
92 static unsigned char crystal_key
[] = /* A 32 byte magic key sequence */
94 0x96, 0x35, 0x9a, 0xcd, 0xe6, 0xf3, 0x79, 0xbc,
95 0x5e, 0xaf, 0x57, 0x2b, 0x15, 0x8a, 0xc5, 0xe2,
96 0xf1, 0xf8, 0x7c, 0x3e, 0x9f, 0x4f, 0x27, 0x13,
97 0x09, 0x84, 0x42, 0xa1, 0xd0, 0x68, 0x34, 0x1a
100 static void sleep(unsigned howlong
)
102 current
->state
= TASK_INTERRUPTIBLE
;
103 schedule_timeout(howlong
);
106 static void enable_xctrl(int baseio
)
111 * Some IBM Aptiva's have the Bose Sound System. By default
112 * the Bose Amplifier is disabled. The amplifier will be
113 * activated, by setting the XCTRL0 and XCTRL1 bits.
114 * Volume of the monitor bose speakers/woofer, can then
115 * be set by changing the PCM volume.
119 printk("cs4232: enabling Bose Sound System Amplifier.\n");
121 /* Switch to Pin Control Address */
122 regd
= inb(baseio
+ INDEX_ADDRESS
) & 0xe0;
123 outb(((unsigned char) (PIN_CONTROL
| regd
)), baseio
+ INDEX_ADDRESS
);
125 /* Activate the XCTRL0 and XCTRL1 Pins */
126 regd
= inb(baseio
+ INDEX_DATA
);
127 outb(((unsigned char) (ENABLE_PINS
| regd
)), baseio
+ INDEX_DATA
);
130 static int __init
probe_cs4232(struct address_info
*hw_config
, int isapnp_configured
)
133 int base
= hw_config
->io_base
, irq
= hw_config
->irq
;
134 int dma1
= hw_config
->dma
, dma2
= hw_config
->dma2
;
135 struct resource
*ports
;
137 if (base
== -1 || irq
== -1 || dma1
== -1) {
138 printk(KERN_ERR
"cs4232: dma, irq and io must be set.\n");
143 * Verify that the I/O port range is free.
146 ports
= request_region(base
, 4, "ad1848");
148 printk(KERN_ERR
"cs4232.c: I/O port 0x%03x not free\n", base
);
151 if (ad1848_detect(ports
, NULL
, hw_config
->osp
)) {
152 goto got_it
; /* The card is already active */
154 if (isapnp_configured
) {
155 printk(KERN_ERR
"cs4232.c: ISA PnP configured, but not detected?\n");
160 * This version of the driver doesn't use the PnP method when configuring
161 * the card but a simplified method defined by Crystal. This means that
162 * just one CS4232 compatible device can exist on the system. Also this
163 * method conflicts with possible PnP support in the OS. For this reason
164 * driver is just a temporary kludge.
166 * Also the Cirrus/Crystal method doesn't always work. Try ISA PnP first ;)
170 * Repeat initialization few times since it doesn't always succeed in
174 for (n
= 0; n
< 4; n
++)
177 * Wake up the card by sending a 32 byte Crystal key to the key port.
180 for (i
= 0; i
< 32; i
++)
181 CS_OUT(crystal_key
[i
]);
186 * Now set the CSN (Card Select Number).
189 CS_OUT2(0x06, CSN_NUM
);
192 * Then set some config bytes. First logical device 0
195 CS_OUT2(0x15, 0x00); /* Select logical device 0 (WSS/SB/FM) */
196 CS_OUT3(0x47, (base
>> 8) & 0xff, base
& 0xff); /* WSS base */
198 if (check_region(0x388, 4)) /* Not free */
199 CS_OUT3(0x48, 0x00, 0x00) /* FM base off */
201 CS_OUT3(0x48, 0x03, 0x88); /* FM base 0x388 */
203 CS_OUT3(0x42, 0x00, 0x00); /* SB base off */
204 CS_OUT2(0x22, irq
); /* SB+WSS IRQ */
205 CS_OUT2(0x2a, dma1
); /* SB+WSS DMA */
208 CS_OUT2(0x25, dma2
) /* WSS DMA2 */
210 CS_OUT2(0x25, 4); /* No WSS DMA2 */
212 CS_OUT2(0x33, 0x01); /* Activate logical dev 0 */
217 * Initialize logical device 3 (MPU)
220 if (mpu_base
!= 0 && mpu_irq
!= 0)
222 CS_OUT2(0x15, 0x03); /* Select logical device 3 (MPU) */
223 CS_OUT3(0x47, (mpu_base
>> 8) & 0xff, mpu_base
& 0xff); /* MPU base */
224 CS_OUT2(0x22, mpu_irq
); /* MPU IRQ */
225 CS_OUT2(0x33, 0x01); /* Activate logical dev 3 */
230 CS_OUT2 (0x15, 0x04); /* logical device 4 (WaveFront) */
231 CS_OUT3 (0x47, (synth_base
>> 8) & 0xff,
232 synth_base
& 0xff); /* base */
233 CS_OUT2 (0x22, synth_irq
); /* IRQ */
234 CS_OUT2 (0x33, 0x01); /* Activate logical dev 4 */
238 * Finally activate the chip
246 * Then try to detect the codec part of the chip
249 if (ad1848_detect(ports
, NULL
, hw_config
->osp
))
255 release_region(base
, 4);
262 hw_config
->slots
[0] = ad1848_init("Crystal audio controller", ports
,
264 dma1
, /* Playback DMA */
265 dma2
, /* Capture DMA */
270 if (hw_config
->slots
[0] != -1 &&
271 audio_devs
[hw_config
->slots
[0]]->mixer_dev
!=-1)
273 /* Assume the mixer map is as suggested in the CS4232 databook */
274 AD1848_REROUTE(SOUND_MIXER_LINE1
, SOUND_MIXER_LINE
);
275 AD1848_REROUTE(SOUND_MIXER_LINE2
, SOUND_MIXER_CD
);
276 AD1848_REROUTE(SOUND_MIXER_LINE3
, SOUND_MIXER_SYNTH
); /* FM synth */
278 if (mpu_base
!= 0 && mpu_irq
!= 0)
280 static struct address_info hw_config2
= {
282 }; /* Ensure it's initialized */
284 hw_config2
.io_base
= mpu_base
;
285 hw_config2
.irq
= mpu_irq
;
287 hw_config2
.dma2
= -1;
288 hw_config2
.always_detect
= 0;
289 hw_config2
.name
= NULL
;
290 hw_config2
.driver_use_1
= 0;
291 hw_config2
.driver_use_2
= 0;
292 hw_config2
.card_subtype
= 0;
294 if (probe_uart401(&hw_config2
, THIS_MODULE
))
300 mpu_base
= mpu_irq
= 0;
302 hw_config
->slots
[1] = hw_config2
.slots
[1];
311 static void __devexit
unload_cs4232(struct address_info
*hw_config
)
313 int base
= hw_config
->io_base
, irq
= hw_config
->irq
;
314 int dma1
= hw_config
->dma
, dma2
= hw_config
->dma2
;
321 dma1
, /* Playback DMA */
322 dma2
, /* Capture DMA */
325 sound_unload_audiodev(hw_config
->slots
[0]);
326 if (mpu_base
!= 0 && mpu_irq
!= 0 && mpu_detected
)
328 static struct address_info hw_config2
=
331 }; /* Ensure it's initialized */
333 hw_config2
.io_base
= mpu_base
;
334 hw_config2
.irq
= mpu_irq
;
336 hw_config2
.dma2
= -1;
337 hw_config2
.always_detect
= 0;
338 hw_config2
.name
= NULL
;
339 hw_config2
.driver_use_1
= 0;
340 hw_config2
.driver_use_2
= 0;
341 hw_config2
.card_subtype
= 0;
342 hw_config2
.slots
[1] = hw_config
->slots
[1];
344 unload_uart401(&hw_config2
);
348 static struct address_info cfg
;
349 static struct address_info cfg_mpu
;
351 static int __initdata io
= -1;
352 static int __initdata irq
= -1;
353 static int __initdata dma
= -1;
354 static int __initdata dma2
= -1;
355 static int __initdata mpuio
= -1;
356 static int __initdata mpuirq
= -1;
357 static int __initdata synthio
= -1;
358 static int __initdata synthirq
= -1;
359 static int __initdata isapnp
= 1;
361 MODULE_DESCRIPTION("CS4232 based soundcard driver");
362 MODULE_AUTHOR("Hannu Savolainen, Paul Barton-Davis");
363 MODULE_LICENSE("GPL");
365 module_param(io
, int, 0);
366 MODULE_PARM_DESC(io
,"base I/O port for AD1848");
367 module_param(irq
, int, 0);
368 MODULE_PARM_DESC(irq
,"IRQ for AD1848 chip");
369 module_param(dma
, int, 0);
370 MODULE_PARM_DESC(dma
,"8 bit DMA for AD1848 chip");
371 module_param(dma2
, int, 0);
372 MODULE_PARM_DESC(dma2
,"16 bit DMA for AD1848 chip");
373 module_param(mpuio
, int, 0);
374 MODULE_PARM_DESC(mpuio
,"MPU 401 base address");
375 module_param(mpuirq
, int, 0);
376 MODULE_PARM_DESC(mpuirq
,"MPU 401 IRQ");
377 module_param(synthio
, int, 0);
378 MODULE_PARM_DESC(synthio
,"Maui WaveTable base I/O port");
379 module_param(synthirq
, int, 0);
380 MODULE_PARM_DESC(synthirq
,"Maui WaveTable IRQ");
381 module_param(isapnp
, bool, 0);
382 MODULE_PARM_DESC(isapnp
,"Enable ISAPnP probing (default 1)");
383 module_param(bss
, bool, 0);
384 MODULE_PARM_DESC(bss
,"Enable Bose Sound System Support (default 0)");
387 * Install a CS4232 based card. Need to have ad1848 and mpu401
391 /* All cs4232 based cards have the main ad1848 card either as CSC0000 or
393 static const struct pnp_device_id cs4232_pnp_table
[] = {
394 { .id
= "CSC0100", .driver_data
= 0 },
395 { .id
= "CSC0000", .driver_data
= 0 },
396 /* Guillemot Turtlebeach something appears to be cs4232 compatible
398 { .id
= "GIM0100", .driver_data
= 0 },
402 MODULE_DEVICE_TABLE(pnp
, cs4232_pnp_table
);
404 static int cs4232_pnp_probe(struct pnp_dev
*dev
, const struct pnp_device_id
*dev_id
)
406 struct address_info
*isapnpcfg
;
408 isapnpcfg
=(struct address_info
*)kmalloc(sizeof(*isapnpcfg
),GFP_KERNEL
);
412 isapnpcfg
->irq
= pnp_irq(dev
, 0);
413 isapnpcfg
->dma
= pnp_dma(dev
, 0);
414 isapnpcfg
->dma2
= pnp_dma(dev
, 1);
415 isapnpcfg
->io_base
= pnp_port_start(dev
, 0);
416 if (probe_cs4232(isapnpcfg
,TRUE
) == 0) {
417 printk(KERN_ERR
"cs4232: ISA PnP card found, but not detected?\n");
421 pnp_set_drvdata(dev
,isapnpcfg
);
425 static void __devexit
cs4232_pnp_remove(struct pnp_dev
*dev
)
427 struct address_info
*cfg
= pnp_get_drvdata(dev
);
434 static struct pnp_driver cs4232_driver
= {
436 .id_table
= cs4232_pnp_table
,
437 .probe
= cs4232_pnp_probe
,
438 .remove
= __devexit_p(cs4232_pnp_remove
),
441 static int __init
init_cs4232(void)
443 #ifdef CONFIG_SOUND_WAVEFRONT_MODULE
445 printk(KERN_INFO
"cs4232: set synthio and synthirq to use the wavefront facilities.\n");
447 synth_base
= synthio
;
448 synth_irq
= synthirq
;
452 printk(KERN_WARNING
"cs4232: wavefront support not enabled in this driver.\n");
457 (pnp_register_driver(&cs4232_driver
) > 0)
461 if(io
==-1||irq
==-1||dma
==-1)
463 printk(KERN_ERR
"cs4232: Must set io, irq and dma.\n");
472 cfg_mpu
.io_base
= -1;
475 if (mpuio
!= -1 && mpuirq
!= -1) {
476 cfg_mpu
.io_base
= mpuio
;
477 cfg_mpu
.irq
= mpuirq
;
478 probe_cs4232_mpu(&cfg_mpu
); /* Bug always returns 0 not OK -- AC */
481 if (probe_cs4232(&cfg
,FALSE
) == 0)
487 static void __exit
cleanup_cs4232(void)
489 pnp_unregister_driver(&cs4232_driver
);
491 unload_cs4232(&cfg
); /* Unloads global MPU as well, if needed */
494 module_init(init_cs4232
);
495 module_exit(cleanup_cs4232
);
498 static int __init
setup_cs4232(char *str
)
500 /* io, irq, dma, dma2 mpuio, mpuirq*/
503 /* If we have isapnp cards, no need for options */
504 if (pnp_register_driver(&cs4232_driver
) > 0)
507 str
= get_options(str
, ARRAY_SIZE(ints
), ints
);
519 __setup("cs4232=", setup_cs4232
);