1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Driver for Gallant SC-6000 soundcard. This card is also known as
4 * Audio Excel DSP 16 or Zoltrix AV302.
5 * These cards use CompuMedia ASC-9308 chip + AD1848 codec.
6 * SC-6600 and SC-7000 cards are also supported. They are based on
7 * CompuMedia ASC-9408 chip and CS4231 codec.
9 * Copyright (C) 2007 Krzysztof Helt <krzysztof.h1@wp.pl>
11 * I don't have documentation for this card. I used the driver
12 * for OSS/Free included in the kernel source as reference.
15 #include <linux/module.h>
16 #include <linux/delay.h>
17 #include <linux/isa.h>
20 #include <sound/core.h>
21 #include <sound/wss.h>
22 #include <sound/opl3.h>
23 #include <sound/mpu401.h>
24 #include <sound/control.h>
25 #define SNDRV_LEGACY_FIND_FREE_IRQ
26 #define SNDRV_LEGACY_FIND_FREE_DMA
27 #include <sound/initval.h>
29 MODULE_AUTHOR("Krzysztof Helt");
30 MODULE_DESCRIPTION("Gallant SC-6000");
31 MODULE_LICENSE("GPL");
33 static int index
[SNDRV_CARDS
] = SNDRV_DEFAULT_IDX
; /* Index 0-MAX */
34 static char *id
[SNDRV_CARDS
] = SNDRV_DEFAULT_STR
; /* ID for this card */
35 static bool enable
[SNDRV_CARDS
] = SNDRV_DEFAULT_ENABLE
; /* Enable this card */
36 static long port
[SNDRV_CARDS
] = SNDRV_DEFAULT_PORT
; /* 0x220, 0x240 */
37 static int irq
[SNDRV_CARDS
] = SNDRV_DEFAULT_IRQ
; /* 5, 7, 9, 10, 11 */
38 static long mss_port
[SNDRV_CARDS
] = SNDRV_DEFAULT_PORT
; /* 0x530, 0xe80 */
39 static long mpu_port
[SNDRV_CARDS
] = SNDRV_DEFAULT_PORT
;
40 /* 0x300, 0x310, 0x320, 0x330 */
41 static int mpu_irq
[SNDRV_CARDS
] = SNDRV_DEFAULT_IRQ
; /* 5, 7, 9, 10, 0 */
42 static int dma
[SNDRV_CARDS
] = SNDRV_DEFAULT_DMA
; /* 0, 1, 3 */
43 static bool joystick
[SNDRV_CARDS
] = { [0 ... (SNDRV_CARDS
-1)] = false };
45 module_param_array(index
, int, NULL
, 0444);
46 MODULE_PARM_DESC(index
, "Index value for sc-6000 based soundcard.");
47 module_param_array(id
, charp
, NULL
, 0444);
48 MODULE_PARM_DESC(id
, "ID string for sc-6000 based soundcard.");
49 module_param_array(enable
, bool, NULL
, 0444);
50 MODULE_PARM_DESC(enable
, "Enable sc-6000 based soundcard.");
51 module_param_hw_array(port
, long, ioport
, NULL
, 0444);
52 MODULE_PARM_DESC(port
, "Port # for sc-6000 driver.");
53 module_param_hw_array(mss_port
, long, ioport
, NULL
, 0444);
54 MODULE_PARM_DESC(mss_port
, "MSS Port # for sc-6000 driver.");
55 module_param_hw_array(mpu_port
, long, ioport
, NULL
, 0444);
56 MODULE_PARM_DESC(mpu_port
, "MPU-401 port # for sc-6000 driver.");
57 module_param_hw_array(irq
, int, irq
, NULL
, 0444);
58 MODULE_PARM_DESC(irq
, "IRQ # for sc-6000 driver.");
59 module_param_hw_array(mpu_irq
, int, irq
, NULL
, 0444);
60 MODULE_PARM_DESC(mpu_irq
, "MPU-401 IRQ # for sc-6000 driver.");
61 module_param_hw_array(dma
, int, dma
, NULL
, 0444);
62 MODULE_PARM_DESC(dma
, "DMA # for sc-6000 driver.");
63 module_param_array(joystick
, bool, NULL
, 0444);
64 MODULE_PARM_DESC(joystick
, "Enable gameport.");
67 * Commands of SC6000's DSP (SBPRO+special).
68 * Some of them are COMMAND_xx, in the future they may change.
70 #define WRITE_MDIRQ_CFG 0x50 /* Set M&I&DRQ mask (the real config) */
71 #define COMMAND_52 0x52 /* */
72 #define READ_HARD_CFG 0x58 /* Read Hardware Config (I/O base etc) */
73 #define COMMAND_5C 0x5c /* */
74 #define COMMAND_60 0x60 /* */
75 #define COMMAND_66 0x66 /* */
76 #define COMMAND_6C 0x6c /* */
77 #define COMMAND_6E 0x6e /* */
78 #define COMMAND_88 0x88 /* Unknown command */
79 #define DSP_INIT_MSS 0x8c /* Enable Microsoft Sound System mode */
80 #define COMMAND_C5 0xc5 /* */
81 #define GET_DSP_VERSION 0xe1 /* Get DSP Version */
82 #define GET_DSP_COPYRIGHT 0xe3 /* Get DSP Copyright */
85 * Offsets of SC6000 DSP I/O ports. The offset is added to base I/O port
86 * to have the actual I/O port.
87 * Register permissions are:
93 #define DSP_RESET 0x06 /* offset of DSP RESET (wo) */
94 #define DSP_READ 0x0a /* offset of DSP READ (ro) */
95 #define DSP_WRITE 0x0c /* offset of DSP WRITE (w-) */
96 #define DSP_COMMAND 0x0c /* offset of DSP COMMAND (w-) */
97 #define DSP_STATUS 0x0c /* offset of DSP STATUS (r-) */
98 #define DSP_DATAVAIL 0x0e /* offset of DSP DATA AVAILABLE (ro) */
100 #define PFX "sc6000: "
101 #define DRV_NAME "SC-6000"
103 /* hardware dependent functions */
106 * sc6000_irq_to_softcfg - Decode irq number into cfg code.
108 static unsigned char sc6000_irq_to_softcfg(int irq
)
110 unsigned char val
= 0;
135 * sc6000_dma_to_softcfg - Decode dma number into cfg code.
137 static unsigned char sc6000_dma_to_softcfg(int dma
)
139 unsigned char val
= 0;
158 * sc6000_mpu_irq_to_softcfg - Decode MPU-401 irq number into cfg code.
160 static unsigned char sc6000_mpu_irq_to_softcfg(int mpu_irq
)
162 unsigned char val
= 0;
183 static int sc6000_wait_data(char __iomem
*vport
)
186 unsigned char val
= 0;
189 val
= ioread8(vport
+ DSP_DATAVAIL
);
198 static int sc6000_read(char __iomem
*vport
)
200 if (sc6000_wait_data(vport
))
203 return ioread8(vport
+ DSP_READ
);
207 static int sc6000_write(struct device
*devptr
, char __iomem
*vport
, int cmd
)
213 val
= ioread8(vport
+ DSP_STATUS
);
215 * DSP ready to receive data if bit 7 of val == 0
218 iowrite8(cmd
, vport
+ DSP_COMMAND
);
224 dev_err(devptr
, "DSP Command (0x%x) timeout.\n", cmd
);
229 static int sc6000_dsp_get_answer(struct device
*devptr
,
230 char __iomem
*vport
, int command
,
231 char *data
, int data_len
)
235 if (sc6000_write(devptr
, vport
, command
)) {
236 dev_err(devptr
, "CMD 0x%x: failed!\n", command
);
241 int val
= sc6000_read(vport
);
248 } while (len
< data_len
);
251 * If no more data available, return to the caller, no error if len>0.
252 * We have no other way to know when the string is finished.
254 return len
? len
: -EIO
;
257 static int sc6000_dsp_reset(char __iomem
*vport
)
259 iowrite8(1, vport
+ DSP_RESET
);
261 iowrite8(0, vport
+ DSP_RESET
);
263 if (sc6000_read(vport
) == 0xaa)
268 /* detection and initialization */
269 static int sc6000_hw_cfg_write(struct device
*devptr
,
270 char __iomem
*vport
, const int *cfg
)
272 if (sc6000_write(devptr
, vport
, COMMAND_6C
) < 0) {
273 dev_warn(devptr
, "CMD 0x%x: failed!\n", COMMAND_6C
);
276 if (sc6000_write(devptr
, vport
, COMMAND_5C
) < 0) {
277 dev_err(devptr
, "CMD 0x%x: failed!\n", COMMAND_5C
);
280 if (sc6000_write(devptr
, vport
, cfg
[0]) < 0) {
281 dev_err(devptr
, "DATA 0x%x: failed!\n", cfg
[0]);
284 if (sc6000_write(devptr
, vport
, cfg
[1]) < 0) {
285 dev_err(devptr
, "DATA 0x%x: failed!\n", cfg
[1]);
288 if (sc6000_write(devptr
, vport
, COMMAND_C5
) < 0) {
289 dev_err(devptr
, "CMD 0x%x: failed!\n", COMMAND_C5
);
296 static int sc6000_cfg_write(struct device
*devptr
,
297 char __iomem
*vport
, unsigned char softcfg
)
300 if (sc6000_write(devptr
, vport
, WRITE_MDIRQ_CFG
)) {
301 dev_err(devptr
, "CMD 0x%x: failed!\n", WRITE_MDIRQ_CFG
);
304 if (sc6000_write(devptr
, vport
, softcfg
)) {
305 dev_err(devptr
, "%s: failed!\n", __func__
);
311 static int sc6000_setup_board(struct device
*devptr
,
312 char __iomem
*vport
, int config
)
317 if (sc6000_write(devptr
, vport
, COMMAND_88
)) {
318 dev_err(devptr
, "CMD 0x%x: failed!\n",
322 } while ((sc6000_wait_data(vport
) < 0) && loop
--);
324 if (sc6000_read(vport
) < 0) {
325 dev_err(devptr
, "sc6000_read after CMD 0x%x: failed\n",
330 if (sc6000_cfg_write(devptr
, vport
, config
))
336 static int sc6000_init_mss(struct device
*devptr
,
337 char __iomem
*vport
, int config
,
338 char __iomem
*vmss_port
, int mss_config
)
340 if (sc6000_write(devptr
, vport
, DSP_INIT_MSS
)) {
341 dev_err(devptr
, "%s [0x%x]: failed!\n", __func__
,
348 if (sc6000_cfg_write(devptr
, vport
, config
))
351 iowrite8(mss_config
, vmss_port
);
356 static void sc6000_hw_cfg_encode(struct device
*devptr
,
357 char __iomem
*vport
, int *cfg
,
358 long xport
, long xmpu
,
359 long xmss_port
, int joystick
)
365 if (xmpu
!= SNDRV_AUTO_PORT
) {
366 cfg
[0] |= (xmpu
& 0x30) >> 2;
369 if (xmss_port
== 0xe80)
371 cfg
[0] |= 0x40; /* always set */
374 cfg
[1] |= 0x80; /* enable WSS system */
375 cfg
[1] &= ~0x40; /* disable IDE */
376 dev_dbg(devptr
, "hw cfg %x, %x\n", cfg
[0], cfg
[1]);
379 static int sc6000_init_board(struct device
*devptr
,
381 char __iomem
*vmss_port
, int dev
)
385 int mss_config
= sc6000_irq_to_softcfg(irq
[dev
]) |
386 sc6000_dma_to_softcfg(dma
[dev
]);
387 int config
= mss_config
|
388 sc6000_mpu_irq_to_softcfg(mpu_irq
[dev
]);
392 err
= sc6000_dsp_reset(vport
);
394 dev_err(devptr
, "sc6000_dsp_reset: failed!\n");
398 memset(answer
, 0, sizeof(answer
));
399 err
= sc6000_dsp_get_answer(devptr
, vport
, GET_DSP_COPYRIGHT
, answer
, 15);
401 dev_err(devptr
, "sc6000_dsp_copyright: failed!\n");
405 * My SC-6000 card return "SC-6000" in DSPCopyright, so
406 * if we have something different, we have to be warned.
408 if (strncmp("SC-6000", answer
, 7))
409 dev_warn(devptr
, "Warning: non SC-6000 audio card!\n");
411 if (sc6000_dsp_get_answer(devptr
, vport
, GET_DSP_VERSION
, version
, 2) < 2) {
412 dev_err(devptr
, "sc6000_dsp_version: failed!\n");
415 dev_info(devptr
, "Detected model: %s, DSP version %d.%d\n",
416 answer
, version
[0], version
[1]);
418 /* set configuration */
419 sc6000_write(devptr
, vport
, COMMAND_5C
);
420 if (sc6000_read(vport
) < 0)
425 sc6000_hw_cfg_encode(devptr
,
426 vport
, &cfg
[0], port
[dev
], mpu_port
[dev
],
427 mss_port
[dev
], joystick
[dev
]);
428 if (sc6000_hw_cfg_write(devptr
, vport
, cfg
) < 0) {
429 dev_err(devptr
, "sc6000_hw_cfg_write: failed!\n");
433 err
= sc6000_setup_board(devptr
, vport
, config
);
435 dev_err(devptr
, "sc6000_setup_board: failed!\n");
439 sc6000_dsp_reset(vport
);
442 sc6000_write(devptr
, vport
, COMMAND_60
);
443 sc6000_write(devptr
, vport
, 0x02);
444 sc6000_dsp_reset(vport
);
447 err
= sc6000_setup_board(devptr
, vport
, config
);
449 dev_err(devptr
, "sc6000_setup_board: failed!\n");
452 err
= sc6000_init_mss(devptr
, vport
, config
, vmss_port
, mss_config
);
454 dev_err(devptr
, "Cannot initialize Microsoft Sound System mode.\n");
461 static int snd_sc6000_mixer(struct snd_wss
*chip
)
463 struct snd_card
*card
= chip
->card
;
464 struct snd_ctl_elem_id id1
, id2
;
467 memset(&id1
, 0, sizeof(id1
));
468 memset(&id2
, 0, sizeof(id2
));
469 id1
.iface
= SNDRV_CTL_ELEM_IFACE_MIXER
;
470 id2
.iface
= SNDRV_CTL_ELEM_IFACE_MIXER
;
471 /* reassign AUX0 to FM */
472 strcpy(id1
.name
, "Aux Playback Switch");
473 strcpy(id2
.name
, "FM Playback Switch");
474 err
= snd_ctl_rename_id(card
, &id1
, &id2
);
477 strcpy(id1
.name
, "Aux Playback Volume");
478 strcpy(id2
.name
, "FM Playback Volume");
479 err
= snd_ctl_rename_id(card
, &id1
, &id2
);
482 /* reassign AUX1 to CD */
483 strcpy(id1
.name
, "Aux Playback Switch"); id1
.index
= 1;
484 strcpy(id2
.name
, "CD Playback Switch");
485 err
= snd_ctl_rename_id(card
, &id1
, &id2
);
488 strcpy(id1
.name
, "Aux Playback Volume");
489 strcpy(id2
.name
, "CD Playback Volume");
490 err
= snd_ctl_rename_id(card
, &id1
, &id2
);
496 static int snd_sc6000_match(struct device
*devptr
, unsigned int dev
)
500 if (port
[dev
] == SNDRV_AUTO_PORT
) {
501 dev_err(devptr
, "specify IO port\n");
504 if (mss_port
[dev
] == SNDRV_AUTO_PORT
) {
505 dev_err(devptr
, "specify MSS port\n");
508 if (port
[dev
] != 0x220 && port
[dev
] != 0x240) {
509 dev_err(devptr
, "Port must be 0x220 or 0x240\n");
512 if (mss_port
[dev
] != 0x530 && mss_port
[dev
] != 0xe80) {
513 dev_err(devptr
, "MSS port must be 0x530 or 0xe80\n");
516 if (irq
[dev
] != SNDRV_AUTO_IRQ
&& !sc6000_irq_to_softcfg(irq
[dev
])) {
517 dev_err(devptr
, "invalid IRQ %d\n", irq
[dev
]);
520 if (dma
[dev
] != SNDRV_AUTO_DMA
&& !sc6000_dma_to_softcfg(dma
[dev
])) {
521 dev_err(devptr
, "invalid DMA %d\n", dma
[dev
]);
524 if (mpu_port
[dev
] != SNDRV_AUTO_PORT
&&
525 (mpu_port
[dev
] & ~0x30L
) != 0x300) {
526 dev_err(devptr
, "invalid MPU-401 port %lx\n",
530 if (mpu_port
[dev
] != SNDRV_AUTO_PORT
&&
531 mpu_irq
[dev
] != SNDRV_AUTO_IRQ
&& mpu_irq
[dev
] != 0 &&
532 !sc6000_mpu_irq_to_softcfg(mpu_irq
[dev
])) {
533 dev_err(devptr
, "invalid MPU-401 IRQ %d\n", mpu_irq
[dev
]);
539 static void snd_sc6000_free(struct snd_card
*card
)
541 char __iomem
*vport
= (char __force __iomem
*)card
->private_data
;
544 sc6000_setup_board(card
->dev
, vport
, 0);
547 static int __snd_sc6000_probe(struct device
*devptr
, unsigned int dev
)
549 static const int possible_irqs
[] = { 5, 7, 9, 10, 11, -1 };
550 static const int possible_dmas
[] = { 1, 3, 0, -1 };
554 struct snd_card
*card
;
555 struct snd_wss
*chip
;
556 struct snd_opl3
*opl3
;
558 char __iomem
*vmss_port
;
560 err
= snd_devm_card_new(devptr
, index
[dev
], id
[dev
], THIS_MODULE
,
565 if (xirq
== SNDRV_AUTO_IRQ
) {
566 xirq
= snd_legacy_find_free_irq(possible_irqs
);
568 dev_err(devptr
, "unable to find a free IRQ\n");
573 if (xdma
== SNDRV_AUTO_DMA
) {
574 xdma
= snd_legacy_find_free_dma(possible_dmas
);
576 dev_err(devptr
, "unable to find a free DMA\n");
581 if (!devm_request_region(devptr
, port
[dev
], 0x10, DRV_NAME
)) {
582 dev_err(devptr
, "I/O port region is already in use.\n");
585 vport
= devm_ioport_map(devptr
, port
[dev
], 0x10);
587 dev_err(devptr
, "I/O port cannot be iomapped.\n");
590 card
->private_data
= (void __force
*)vport
;
592 /* to make it marked as used */
593 if (!devm_request_region(devptr
, mss_port
[dev
], 4, DRV_NAME
)) {
595 "SC-6000 port I/O port region is already in use.\n");
598 vmss_port
= devm_ioport_map(devptr
, mss_port
[dev
], 4);
600 dev_err(devptr
, "MSS port I/O cannot be iomapped.\n");
604 dev_dbg(devptr
, "Initializing BASE[0x%lx] IRQ[%d] DMA[%d] MIRQ[%d]\n",
605 port
[dev
], xirq
, xdma
,
606 mpu_irq
[dev
] == SNDRV_AUTO_IRQ
? 0 : mpu_irq
[dev
]);
608 err
= sc6000_init_board(devptr
, vport
, vmss_port
, dev
);
611 card
->private_free
= snd_sc6000_free
;
613 err
= snd_wss_create(card
, mss_port
[dev
] + 4, -1, xirq
, xdma
, -1,
614 WSS_HW_DETECT
, 0, &chip
);
618 err
= snd_wss_pcm(chip
, 0);
620 dev_err(devptr
, "error creating new WSS PCM device\n");
623 err
= snd_wss_mixer(chip
);
625 dev_err(devptr
, "error creating new WSS mixer\n");
628 err
= snd_sc6000_mixer(chip
);
630 dev_err(devptr
, "the mixer rewrite failed\n");
633 if (snd_opl3_create(card
,
635 OPL3_HW_AUTO
, 0, &opl3
) < 0) {
636 dev_err(devptr
, "no OPL device at 0x%x-0x%x ?\n",
639 err
= snd_opl3_hwdep_new(opl3
, 0, 1, NULL
);
644 if (mpu_port
[dev
] != SNDRV_AUTO_PORT
) {
645 if (mpu_irq
[dev
] == SNDRV_AUTO_IRQ
)
647 if (snd_mpu401_uart_new(card
, 0,
650 mpu_irq
[dev
], NULL
) < 0)
651 dev_err(devptr
, "no MPU-401 device at 0x%lx ?\n",
655 strcpy(card
->driver
, DRV_NAME
);
656 strcpy(card
->shortname
, "SC-6000");
657 sprintf(card
->longname
, "Gallant SC-6000 at 0x%lx, irq %d, dma %d",
658 mss_port
[dev
], xirq
, xdma
);
660 err
= snd_card_register(card
);
664 dev_set_drvdata(devptr
, card
);
668 static int snd_sc6000_probe(struct device
*devptr
, unsigned int dev
)
670 return snd_card_free_on_error(devptr
, __snd_sc6000_probe(devptr
, dev
));
673 static struct isa_driver snd_sc6000_driver
= {
674 .match
= snd_sc6000_match
,
675 .probe
= snd_sc6000_probe
,
676 /* FIXME: suspend/resume */
683 module_isa_driver(snd_sc6000_driver
, SNDRV_CARDS
);