1// SPDX-License-Identifier: GPL-2.0-or-later 2/* 3 * Driver for SoundBlaster 1.0/2.0/Pro soundcards and compatible 4 * Copyright (c) by Jaroslav Kysela <perex@perex.cz> 5 */ 6 7#include <linux/init.h> 8#include <linux/err.h> 9#include <linux/isa.h> 10#include <linux/ioport.h> 11#include <linux/module.h> 12#include <sound/core.h> 13#include <sound/sb.h> 14#include <sound/opl3.h> 15#include <sound/initval.h> 16 17MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>"); 18MODULE_DESCRIPTION("Sound Blaster 1.0/2.0/Pro"); 19MODULE_LICENSE("GPL"); 20MODULE_SUPPORTED_DEVICE("{{Creative Labs,SB 1.0/SB 2.0/SB Pro}}"); 21 22static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-MAX */ 23static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* ID for this card */ 24static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE; /* Enable this card */ 25static long port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT; /* 0x220,0x240,0x260 */ 26static int irq[SNDRV_CARDS] = SNDRV_DEFAULT_IRQ; /* 5,7,9,10 */ 27static int dma8[SNDRV_CARDS] = SNDRV_DEFAULT_DMA; /* 1,3 */ 28 29module_param_array(index, int, NULL, 0444); 30MODULE_PARM_DESC(index, "Index value for Sound Blaster soundcard."); 31module_param_array(id, charp, NULL, 0444); 32MODULE_PARM_DESC(id, "ID string for Sound Blaster soundcard."); 33module_param_array(enable, bool, NULL, 0444); 34MODULE_PARM_DESC(enable, "Enable Sound Blaster soundcard."); 35module_param_hw_array(port, long, ioport, NULL, 0444); 36MODULE_PARM_DESC(port, "Port # for SB8 driver."); 37module_param_hw_array(irq, int, irq, NULL, 0444); 38MODULE_PARM_DESC(irq, "IRQ # for SB8 driver."); 39module_param_hw_array(dma8, int, dma, NULL, 0444); 40MODULE_PARM_DESC(dma8, "8-bit DMA # for SB8 driver."); 41 42struct snd_sb8 { 43 struct resource *fm_res; /* used to block FM i/o region for legacy cards */ 44 struct snd_sb *chip; 45}; 46 47static irqreturn_t snd_sb8_interrupt(int irq, void *dev_id) 48{ 49 struct snd_sb *chip = dev_id; 50 51 if (chip->open & SB_OPEN_PCM) { 52 return snd_sb8dsp_interrupt(chip); 53 } else { 54 return snd_sb8dsp_midi_interrupt(chip); 55 } 56} 57 58static void snd_sb8_free(struct snd_card *card) 59{ 60 struct snd_sb8 *acard = card->private_data; 61 62 if (acard == NULL) 63 return; 64 release_and_free_resource(acard->fm_res); 65} 66 67static int snd_sb8_match(struct device *pdev, unsigned int dev) 68{ 69 if (!enable[dev]) 70 return 0; 71 if (irq[dev] == SNDRV_AUTO_IRQ) { 72 dev_err(pdev, "please specify irq\n"); 73 return 0; 74 } 75 if (dma8[dev] == SNDRV_AUTO_DMA) { 76 dev_err(pdev, "please specify dma8\n"); 77 return 0; 78 } 79 return 1; 80} 81 82static int snd_sb8_probe(struct device *pdev, unsigned int dev) 83{ 84 struct snd_sb *chip; 85 struct snd_card *card; 86 struct snd_sb8 *acard; 87 struct snd_opl3 *opl3; 88 int err; 89 90 err = snd_card_new(pdev, index[dev], id[dev], THIS_MODULE, 91 sizeof(struct snd_sb8), &card); 92 if (err < 0) 93 return err; 94 acard = card->private_data; 95 card->private_free = snd_sb8_free; 96 97 /* block the 0x388 port to avoid PnP conflicts */ 98 acard->fm_res = request_region(0x388, 4, "SoundBlaster FM"); 99 100 if (port[dev] != SNDRV_AUTO_PORT) { 101 if ((err = snd_sbdsp_create(card, port[dev], irq[dev], 102 snd_sb8_interrupt, 103 dma8[dev], 104 -1, 105 SB_HW_AUTO, 106 &chip)) < 0) 107 goto _err; 108 } else { 109 /* auto-probe legacy ports */ 110 static const unsigned long possible_ports[] = { 111 0x220, 0x240, 0x260, 112 }; 113 int i; 114 for (i = 0; i < ARRAY_SIZE(possible_ports); i++) { 115 err = snd_sbdsp_create(card, possible_ports[i], 116 irq[dev], 117 snd_sb8_interrupt, 118 dma8[dev], 119 -1, 120 SB_HW_AUTO, 121 &chip); 122 if (err >= 0) { 123 port[dev] = possible_ports[i]; 124 break; 125 } 126 } 127 if (i >= ARRAY_SIZE(possible_ports)) { 128 err = -EINVAL; 129 goto _err; 130 } 131 } 132 acard->chip = chip; 133 134 if (chip->hardware >= SB_HW_16) { 135 if (chip->hardware == SB_HW_ALS100) 136 snd_printk(KERN_WARNING "ALS100 chip detected at 0x%lx, try snd-als100 module\n", 137 port[dev]); 138 else 139 snd_printk(KERN_WARNING "SB 16 chip detected at 0x%lx, try snd-sb16 module\n", 140 port[dev]); 141 err = -ENODEV; 142 goto _err; 143 } 144 145 if ((err = snd_sb8dsp_pcm(chip, 0)) < 0) 146 goto _err; 147 148 if ((err = snd_sbmixer_new(chip)) < 0) 149 goto _err; 150 151 if (chip->hardware == SB_HW_10 || chip->hardware == SB_HW_20) { 152 if ((err = snd_opl3_create(card, chip->port + 8, 0, 153 OPL3_HW_AUTO, 1, 154 &opl3)) < 0) { 155 snd_printk(KERN_WARNING "sb8: no OPL device at 0x%lx\n", chip->port + 8); 156 } 157 } else { 158 if ((err = snd_opl3_create(card, chip->port, chip->port + 2, 159 OPL3_HW_AUTO, 1, 160 &opl3)) < 0) { 161 snd_printk(KERN_WARNING "sb8: no OPL device at 0x%lx-0x%lx\n", 162 chip->port, chip->port + 2); 163 } 164 } 165 if (err >= 0) { 166 if ((err = snd_opl3_hwdep_new(opl3, 0, 1, NULL)) < 0) 167 goto _err; 168 } 169 170 if ((err = snd_sb8dsp_midi(chip, 0)) < 0) 171 goto _err; 172 173 strcpy(card->driver, chip->hardware == SB_HW_PRO ? "SB Pro" : "SB8"); 174 strcpy(card->shortname, chip->name); 175 sprintf(card->longname, "%s at 0x%lx, irq %d, dma %d", 176 chip->name, 177 chip->port, 178 irq[dev], dma8[dev]); 179 180 if ((err = snd_card_register(card)) < 0) 181 goto _err; 182 183 dev_set_drvdata(pdev, card); 184 return 0; 185 186 _err: 187 snd_card_free(card); 188 return err; 189} 190 191static int snd_sb8_remove(struct device *pdev, unsigned int dev) 192{ 193 snd_card_free(dev_get_drvdata(pdev)); 194 return 0; 195} 196 197#ifdef CONFIG_PM 198static int snd_sb8_suspend(struct device *dev, unsigned int n, 199 pm_message_t state) 200{ 201 struct snd_card *card = dev_get_drvdata(dev); 202 struct snd_sb8 *acard = card->private_data; 203 struct snd_sb *chip = acard->chip; 204 205 snd_power_change_state(card, SNDRV_CTL_POWER_D3hot); 206 snd_sbmixer_suspend(chip); 207 return 0; 208} 209 210static int snd_sb8_resume(struct device *dev, unsigned int n) 211{ 212 struct snd_card *card = dev_get_drvdata(dev); 213 struct snd_sb8 *acard = card->private_data; 214 struct snd_sb *chip = acard->chip; 215 216 snd_sbdsp_reset(chip); 217 snd_sbmixer_resume(chip); 218 snd_power_change_state(card, SNDRV_CTL_POWER_D0); 219 return 0; 220} 221#endif 222 223#define DEV_NAME "sb8" 224 225static struct isa_driver snd_sb8_driver = { 226 .match = snd_sb8_match, 227 .probe = snd_sb8_probe, 228 .remove = snd_sb8_remove, 229#ifdef CONFIG_PM 230 .suspend = snd_sb8_suspend, 231 .resume = snd_sb8_resume, 232#endif 233 .driver = { 234 .name = DEV_NAME 235 }, 236}; 237 238module_isa_driver(snd_sb8_driver, SNDRV_CARDS); 239