1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * Driver for C-Media CMI8328-based soundcards, such as AudioExcel AV500
4 * Copyright (c) 2012 Ondrej Zary
5 *
6 * AudioExcel AV500 card consists of:
7 * - CMI8328 - main chip (SB Pro emulation, gameport, OPL3, MPU401, CD-ROM)
8 * - CS4231A - WSS codec
9 * - Dream SAM9233+GMS950400+RAM+ROM: Wavetable MIDI, connected to MPU401
10 */
11
12#include <linux/init.h>
13#include <linux/isa.h>
14#include <linux/module.h>
15#include <linux/gameport.h>
16#include <asm/dma.h>
17#include <sound/core.h>
18#include <sound/wss.h>
19#include <sound/opl3.h>
20#include <sound/mpu401.h>
21#define SNDRV_LEGACY_FIND_FREE_IOPORT
22#define SNDRV_LEGACY_FIND_FREE_IRQ
23#define SNDRV_LEGACY_FIND_FREE_DMA
24#include <sound/initval.h>
25
26MODULE_AUTHOR("Ondrej Zary <linux@rainbow-software.org>");
27MODULE_DESCRIPTION("C-Media CMI8328");
28MODULE_LICENSE("GPL");
29
30#if IS_ENABLED(CONFIG_GAMEPORT)
31#define SUPPORT_JOYSTICK 1
32#endif
33
34/* I/O port is configured by jumpers on the card to one of these */
35static const int cmi8328_ports[] = { 0x530, 0xe80, 0xf40, 0x604 };
36#define CMI8328_MAX ARRAY_SIZE(cmi8328_ports)
37
38static int index[CMI8328_MAX] = {[0 ... (CMI8328_MAX-1)] = -1};
39static char *id[CMI8328_MAX] = {[0 ... (CMI8328_MAX-1)] = NULL};
40static long port[CMI8328_MAX] = {[0 ... (CMI8328_MAX-1)] = SNDRV_AUTO_PORT};
41static int irq[CMI8328_MAX] = {[0 ... (CMI8328_MAX-1)] = SNDRV_AUTO_IRQ};
42static int dma1[CMI8328_MAX] = {[0 ... (CMI8328_MAX-1)] = SNDRV_AUTO_DMA};
43static int dma2[CMI8328_MAX] = {[0 ... (CMI8328_MAX-1)] = SNDRV_AUTO_DMA};
44static long mpuport[CMI8328_MAX] = {[0 ... (CMI8328_MAX-1)] = SNDRV_AUTO_PORT};
45static int mpuirq[CMI8328_MAX] = {[0 ... (CMI8328_MAX-1)] = SNDRV_AUTO_IRQ};
46#ifdef SUPPORT_JOYSTICK
47static bool gameport[CMI8328_MAX] = {[0 ... (CMI8328_MAX-1)] = true};
48#endif
49
50module_param_array(index, int, NULL, 0444);
51MODULE_PARM_DESC(index, "Index value for CMI8328 soundcard.");
52module_param_array(id, charp, NULL, 0444);
53MODULE_PARM_DESC(id, "ID string for CMI8328 soundcard.");
54
55module_param_hw_array(port, long, ioport, NULL, 0444);
56MODULE_PARM_DESC(port, "Port # for CMI8328 driver.");
57module_param_hw_array(irq, int, irq, NULL, 0444);
58MODULE_PARM_DESC(irq, "IRQ # for CMI8328 driver.");
59module_param_hw_array(dma1, int, dma, NULL, 0444);
60MODULE_PARM_DESC(dma1, "DMA1 for CMI8328 driver.");
61module_param_hw_array(dma2, int, dma, NULL, 0444);
62MODULE_PARM_DESC(dma2, "DMA2 for CMI8328 driver.");
63
64module_param_hw_array(mpuport, long, ioport, NULL, 0444);
65MODULE_PARM_DESC(mpuport, "MPU-401 port # for CMI8328 driver.");
66module_param_hw_array(mpuirq, int, irq, NULL, 0444);
67MODULE_PARM_DESC(mpuirq, "IRQ # for CMI8328 MPU-401 port.");
68#ifdef SUPPORT_JOYSTICK
69module_param_array(gameport, bool, NULL, 0444);
70MODULE_PARM_DESC(gameport, "Enable gameport.");
71#endif
72
73struct snd_cmi8328 {
74 u16 port;
75 u8 cfg[3];
76 u8 wss_cfg;
77 struct snd_card *card;
78 struct snd_wss *wss;
79#ifdef SUPPORT_JOYSTICK
80 struct gameport *gameport;
81#endif
82};
83
84/* CMI8328 configuration registers */
85#define CFG1 0x61
86#define CFG1_SB_DISABLE (1 << 0)
87#define CFG1_GAMEPORT (1 << 1)
88/*
89 * bit 0: SB: 0=enabled, 1=disabled
90 * bit 1: gameport: 0=disabled, 1=enabled
91 * bits 2-4: SB IRQ: 001=3, 010=5, 011=7, 100=9, 101=10, 110=11
92 * bits 5-6: SB DMA: 00=disabled (when SB disabled), 01=DMA0, 10=DMA1, 11=DMA3
93 * bit 7: SB port: 0=0x220, 1=0x240
94 */
95#define CFG2 0x62
96#define CFG2_MPU_ENABLE (1 << 2)
97/*
98 * bits 0-1: CD-ROM mode: 00=disabled, 01=Panasonic, 10=Sony/Mitsumi/Wearnes,
99 11=IDE
100 * bit 2: MPU401: 0=disabled, 1=enabled
101 * bits 3-4: MPU401 IRQ: 00=3, 01=5, 10=7, 11=9,
102 * bits 5-7: MPU401 port: 000=0x300, 001=0x310, 010=0x320, 011=0x330, 100=0x332,
103 101=0x334, 110=0x336
104 */
105#define CFG3 0x63
106/*
107 * bits 0-2: CD-ROM IRQ: 000=disabled, 001=3, 010=5, 011=7, 100=9, 101=10,
108 110=11
109 * bits 3-4: CD-ROM DMA: 00=disabled, 01=DMA0, 10=DMA1, 11=DMA3
110 * bits 5-7: CD-ROM port: 000=0x300, 001=0x310, 010=0x320, 011=0x330, 100=0x340,
111 101=0x350, 110=0x360, 111=0x370
112 */
113
114static u8 snd_cmi8328_cfg_read(u16 port, u8 reg)
115{
116 outb(value: 0x43, port: port + 3);
117 outb(value: 0x21, port: port + 3);
118 outb(value: reg, port: port + 3);
119 return inb(port);
120}
121
122static void snd_cmi8328_cfg_write(u16 port, u8 reg, u8 val)
123{
124 outb(value: 0x43, port: port + 3);
125 outb(value: 0x21, port: port + 3);
126 outb(value: reg, port: port + 3);
127 outb(value: val, port: port + 3); /* yes, value goes to the same port as index */
128}
129
130#ifdef CONFIG_PM
131static void snd_cmi8328_cfg_save(u16 port, u8 cfg[])
132{
133 cfg[0] = snd_cmi8328_cfg_read(port, CFG1);
134 cfg[1] = snd_cmi8328_cfg_read(port, CFG2);
135 cfg[2] = snd_cmi8328_cfg_read(port, CFG3);
136}
137
138static void snd_cmi8328_cfg_restore(u16 port, u8 cfg[])
139{
140 snd_cmi8328_cfg_write(port, CFG1, val: cfg[0]);
141 snd_cmi8328_cfg_write(port, CFG2, val: cfg[1]);
142 snd_cmi8328_cfg_write(port, CFG3, val: cfg[2]);
143}
144#endif /* CONFIG_PM */
145
146static int snd_cmi8328_mixer(struct snd_wss *chip)
147{
148 struct snd_card *card;
149 struct snd_ctl_elem_id id1, id2;
150 int err;
151
152 card = chip->card;
153
154 memset(&id1, 0, sizeof(id1));
155 memset(&id2, 0, sizeof(id2));
156 id1.iface = id2.iface = SNDRV_CTL_ELEM_IFACE_MIXER;
157 /* rename AUX0 switch to CD */
158 strcpy(p: id1.name, q: "Aux Playback Switch");
159 strcpy(p: id2.name, q: "CD Playback Switch");
160 err = snd_ctl_rename_id(card, src_id: &id1, dst_id: &id2);
161 if (err < 0) {
162 snd_printk(KERN_ERR "error renaming control\n");
163 return err;
164 }
165 /* rename AUX0 volume to CD */
166 strcpy(p: id1.name, q: "Aux Playback Volume");
167 strcpy(p: id2.name, q: "CD Playback Volume");
168 err = snd_ctl_rename_id(card, src_id: &id1, dst_id: &id2);
169 if (err < 0) {
170 snd_printk(KERN_ERR "error renaming control\n");
171 return err;
172 }
173 /* rename AUX1 switch to Synth */
174 strcpy(p: id1.name, q: "Aux Playback Switch");
175 id1.index = 1;
176 strcpy(p: id2.name, q: "Synth Playback Switch");
177 err = snd_ctl_rename_id(card, src_id: &id1, dst_id: &id2);
178 if (err < 0) {
179 snd_printk(KERN_ERR "error renaming control\n");
180 return err;
181 }
182 /* rename AUX1 volume to Synth */
183 strcpy(p: id1.name, q: "Aux Playback Volume");
184 id1.index = 1;
185 strcpy(p: id2.name, q: "Synth Playback Volume");
186 err = snd_ctl_rename_id(card, src_id: &id1, dst_id: &id2);
187 if (err < 0) {
188 snd_printk(KERN_ERR "error renaming control\n");
189 return err;
190 }
191
192 return 0;
193}
194
195/* find index of an item in "-1"-ended array */
196static int array_find(const int array[], int item)
197{
198 int i;
199
200 for (i = 0; array[i] != -1; i++)
201 if (array[i] == item)
202 return i;
203
204 return -1;
205}
206/* the same for long */
207static int array_find_l(const long array[], long item)
208{
209 int i;
210
211 for (i = 0; array[i] != -1; i++)
212 if (array[i] == item)
213 return i;
214
215 return -1;
216}
217
218static int snd_cmi8328_probe(struct device *pdev, unsigned int ndev)
219{
220 struct snd_card *card;
221 struct snd_opl3 *opl3;
222 struct snd_cmi8328 *cmi;
223#ifdef SUPPORT_JOYSTICK
224 struct resource *res;
225#endif
226 int err, pos;
227 static const long mpu_ports[] = { 0x330, 0x300, 0x310, 0x320, 0x332, 0x334,
228 0x336, -1 };
229 static const u8 mpu_port_bits[] = { 3, 0, 1, 2, 4, 5, 6 };
230 static const int mpu_irqs[] = { 9, 7, 5, 3, -1 };
231 static const u8 mpu_irq_bits[] = { 3, 2, 1, 0 };
232 static const int irqs[] = { 9, 10, 11, 7, -1 };
233 static const u8 irq_bits[] = { 2, 3, 4, 1 };
234 static const int dma1s[] = { 3, 1, 0, -1 };
235 static const u8 dma_bits[] = { 3, 2, 1 };
236 static const int dma2s[][2] = { {1, -1}, {0, -1}, {-1, -1}, {0, -1} };
237 u16 port = cmi8328_ports[ndev];
238 u8 val;
239
240 /* 0xff is invalid configuration (but settable - hope it isn't set) */
241 if (snd_cmi8328_cfg_read(port, CFG1) == 0xff)
242 return -ENODEV;
243 /* the SB disable bit must NEVER EVER be cleared or the WSS dies */
244 snd_cmi8328_cfg_write(port, CFG1, CFG1_SB_DISABLE);
245 if (snd_cmi8328_cfg_read(port, CFG1) != CFG1_SB_DISABLE)
246 return -ENODEV;
247 /* disable everything first */
248 snd_cmi8328_cfg_write(port, CFG2, val: 0); /* disable CDROM and MPU401 */
249 snd_cmi8328_cfg_write(port, CFG3, val: 0); /* disable CDROM IRQ and DMA */
250
251 if (irq[ndev] == SNDRV_AUTO_IRQ) {
252 irq[ndev] = snd_legacy_find_free_irq(irq_table: irqs);
253 if (irq[ndev] < 0) {
254 snd_printk(KERN_ERR "unable to find a free IRQ\n");
255 return -EBUSY;
256 }
257 }
258 if (dma1[ndev] == SNDRV_AUTO_DMA) {
259 dma1[ndev] = snd_legacy_find_free_dma(dma_table: dma1s);
260 if (dma1[ndev] < 0) {
261 snd_printk(KERN_ERR "unable to find a free DMA1\n");
262 return -EBUSY;
263 }
264 }
265 if (dma2[ndev] == SNDRV_AUTO_DMA) {
266 dma2[ndev] = snd_legacy_find_free_dma(dma_table: dma2s[dma1[ndev] % 4]);
267 if (dma2[ndev] < 0) {
268 snd_printk(KERN_WARNING "unable to find a free DMA2, full-duplex will not work\n");
269 dma2[ndev] = -1;
270 }
271 }
272 /* configure WSS IRQ... */
273 pos = array_find(array: irqs, item: irq[ndev]);
274 if (pos < 0) {
275 snd_printk(KERN_ERR "invalid IRQ %d\n", irq[ndev]);
276 return -EINVAL;
277 }
278 val = irq_bits[pos] << 3;
279 /* ...and DMA... */
280 pos = array_find(array: dma1s, item: dma1[ndev]);
281 if (pos < 0) {
282 snd_printk(KERN_ERR "invalid DMA1 %d\n", dma1[ndev]);
283 return -EINVAL;
284 }
285 val |= dma_bits[pos];
286 /* ...and DMA2 */
287 if (dma2[ndev] >= 0 && dma1[ndev] != dma2[ndev]) {
288 pos = array_find(array: dma2s[dma1[ndev]], item: dma2[ndev]);
289 if (pos < 0) {
290 snd_printk(KERN_ERR "invalid DMA2 %d\n", dma2[ndev]);
291 return -EINVAL;
292 }
293 val |= 0x04; /* enable separate capture DMA */
294 }
295 outb(value: val, port);
296
297 err = snd_devm_card_new(parent: pdev, idx: index[ndev], xid: id[ndev], THIS_MODULE,
298 extra_size: sizeof(struct snd_cmi8328), card_ret: &card);
299 if (err < 0)
300 return err;
301 cmi = card->private_data;
302 cmi->card = card;
303 cmi->port = port;
304 cmi->wss_cfg = val;
305
306 err = snd_wss_create(card, port: port + 4, cport: -1, irq: irq[ndev], dma1: dma1[ndev],
307 dma2: dma2[ndev], WSS_HW_DETECT, hwshare: 0, rchip: &cmi->wss);
308 if (err < 0)
309 return err;
310
311 err = snd_wss_pcm(chip: cmi->wss, device: 0);
312 if (err < 0)
313 return err;
314
315 err = snd_wss_mixer(chip: cmi->wss);
316 if (err < 0)
317 return err;
318 err = snd_cmi8328_mixer(chip: cmi->wss);
319 if (err < 0)
320 return err;
321
322 if (snd_wss_timer(chip: cmi->wss, device: 0) < 0)
323 snd_printk(KERN_WARNING "error initializing WSS timer\n");
324
325 if (mpuport[ndev] == SNDRV_AUTO_PORT) {
326 mpuport[ndev] = snd_legacy_find_free_ioport(port_table: mpu_ports, size: 2);
327 if (mpuport[ndev] < 0)
328 snd_printk(KERN_ERR "unable to find a free MPU401 port\n");
329 }
330 if (mpuirq[ndev] == SNDRV_AUTO_IRQ) {
331 mpuirq[ndev] = snd_legacy_find_free_irq(irq_table: mpu_irqs);
332 if (mpuirq[ndev] < 0)
333 snd_printk(KERN_ERR "unable to find a free MPU401 IRQ\n");
334 }
335 /* enable and configure MPU401 */
336 if (mpuport[ndev] > 0 && mpuirq[ndev] > 0) {
337 val = CFG2_MPU_ENABLE;
338 pos = array_find_l(array: mpu_ports, item: mpuport[ndev]);
339 if (pos < 0)
340 snd_printk(KERN_WARNING "invalid MPU401 port 0x%lx\n",
341 mpuport[ndev]);
342 else {
343 val |= mpu_port_bits[pos] << 5;
344 pos = array_find(array: mpu_irqs, item: mpuirq[ndev]);
345 if (pos < 0)
346 snd_printk(KERN_WARNING "invalid MPU401 IRQ %d\n",
347 mpuirq[ndev]);
348 else {
349 val |= mpu_irq_bits[pos] << 3;
350 snd_cmi8328_cfg_write(port, CFG2, val);
351 if (snd_mpu401_uart_new(card, device: 0,
352 MPU401_HW_MPU401, port: mpuport[ndev],
353 info_flags: 0, irq: mpuirq[ndev], NULL) < 0)
354 snd_printk(KERN_ERR "error initializing MPU401\n");
355 }
356 }
357 }
358 /* OPL3 is hardwired to 0x388 and cannot be disabled */
359 if (snd_opl3_create(card, l_port: 0x388, r_port: 0x38a, OPL3_HW_AUTO, integrated: 0, opl3: &opl3) < 0)
360 snd_printk(KERN_ERR "error initializing OPL3\n");
361 else
362 if (snd_opl3_hwdep_new(opl3, device: 0, seq_device: 1, NULL) < 0)
363 snd_printk(KERN_WARNING "error initializing OPL3 hwdep\n");
364
365 strcpy(p: card->driver, q: "CMI8328");
366 strcpy(p: card->shortname, q: "C-Media CMI8328");
367 sprintf(buf: card->longname, fmt: "%s at 0x%lx, irq %d, dma %d,%d",
368 card->shortname, cmi->wss->port, irq[ndev], dma1[ndev],
369 (dma2[ndev] >= 0) ? dma2[ndev] : dma1[ndev]);
370
371 dev_set_drvdata(dev: pdev, data: card);
372 err = snd_card_register(card);
373 if (err < 0)
374 return err;
375#ifdef SUPPORT_JOYSTICK
376 if (!gameport[ndev])
377 return 0;
378 /* gameport is hardwired to 0x200 */
379 res = devm_request_region(pdev, 0x200, 8, "CMI8328 gameport");
380 if (!res)
381 snd_printk(KERN_WARNING "unable to allocate gameport I/O port\n");
382 else {
383 struct gameport *gp = cmi->gameport = gameport_allocate_port();
384 if (cmi->gameport) {
385 gameport_set_name(gameport: gp, name: "CMI8328 Gameport");
386 gameport_set_phys(gameport: gp, fmt: "%s/gameport0", dev_name(dev: pdev));
387 gameport_set_dev_parent(gp, pdev);
388 gp->io = 0x200;
389 /* Enable gameport */
390 snd_cmi8328_cfg_write(port, CFG1,
391 CFG1_SB_DISABLE | CFG1_GAMEPORT);
392 gameport_register_port(gp);
393 }
394 }
395#endif
396 return 0;
397}
398
399static void snd_cmi8328_remove(struct device *pdev, unsigned int dev)
400{
401 struct snd_card *card = dev_get_drvdata(dev: pdev);
402 struct snd_cmi8328 *cmi = card->private_data;
403
404#ifdef SUPPORT_JOYSTICK
405 if (cmi->gameport)
406 gameport_unregister_port(gameport: cmi->gameport);
407#endif
408 /* disable everything */
409 snd_cmi8328_cfg_write(port: cmi->port, CFG1, CFG1_SB_DISABLE);
410 snd_cmi8328_cfg_write(port: cmi->port, CFG2, val: 0);
411 snd_cmi8328_cfg_write(port: cmi->port, CFG3, val: 0);
412}
413
414#ifdef CONFIG_PM
415static int snd_cmi8328_suspend(struct device *pdev, unsigned int n,
416 pm_message_t state)
417{
418 struct snd_card *card = dev_get_drvdata(dev: pdev);
419 struct snd_cmi8328 *cmi;
420
421 if (!card) /* ignore absent devices */
422 return 0;
423 cmi = card->private_data;
424 snd_cmi8328_cfg_save(port: cmi->port, cfg: cmi->cfg);
425 snd_power_change_state(card, SNDRV_CTL_POWER_D3hot);
426 cmi->wss->suspend(cmi->wss);
427
428 return 0;
429}
430
431static int snd_cmi8328_resume(struct device *pdev, unsigned int n)
432{
433 struct snd_card *card = dev_get_drvdata(dev: pdev);
434 struct snd_cmi8328 *cmi;
435
436 if (!card) /* ignore absent devices */
437 return 0;
438 cmi = card->private_data;
439 snd_cmi8328_cfg_restore(port: cmi->port, cfg: cmi->cfg);
440 outb(value: cmi->wss_cfg, port: cmi->port);
441 cmi->wss->resume(cmi->wss);
442 snd_power_change_state(card, SNDRV_CTL_POWER_D0);
443
444 return 0;
445}
446#endif
447
448static struct isa_driver snd_cmi8328_driver = {
449 .probe = snd_cmi8328_probe,
450 .remove = snd_cmi8328_remove,
451#ifdef CONFIG_PM
452 .suspend = snd_cmi8328_suspend,
453 .resume = snd_cmi8328_resume,
454#endif
455 .driver = {
456 .name = "cmi8328"
457 },
458};
459
460module_isa_driver(snd_cmi8328_driver, CMI8328_MAX);
461

source code of linux/sound/isa/cmi8328.c