1 // SPDX-License-Identifier: GPL-2.0-or-later 2 /* 3 * Routines for Gravis UltraSound soundcards 4 * Copyright (c) by Jaroslav Kysela <perex@perex.cz> 5 */ 6 7 #include <linux/init.h> 8 #include <linux/interrupt.h> 9 #include <linux/delay.h> 10 #include <linux/slab.h> 11 #include <linux/ioport.h> 12 #include <linux/module.h> 13 #include <sound/core.h> 14 #include <sound/gus.h> 15 #include <sound/control.h> 16 17 #include <asm/dma.h> 18 19 MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>"); 20 MODULE_DESCRIPTION("Routines for Gravis UltraSound soundcards"); 21 MODULE_LICENSE("GPL"); 22 23 static int snd_gus_init_dma_irq(struct snd_gus_card * gus, int latches); 24 25 int snd_gus_use_inc(struct snd_gus_card * gus) 26 { 27 if (!try_module_get(gus->card->module)) 28 return 0; 29 return 1; 30 } 31 32 void snd_gus_use_dec(struct snd_gus_card * gus) 33 { 34 module_put(gus->card->module); 35 } 36 37 static int snd_gus_joystick_info(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo) 38 { 39 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER; 40 uinfo->count = 1; 41 uinfo->value.integer.min = 0; 42 uinfo->value.integer.max = 31; 43 return 0; 44 } 45 46 static int snd_gus_joystick_get(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol) 47 { 48 struct snd_gus_card *gus = snd_kcontrol_chip(kcontrol); 49 50 ucontrol->value.integer.value[0] = gus->joystick_dac & 31; 51 return 0; 52 } 53 54 static int snd_gus_joystick_put(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol) 55 { 56 struct snd_gus_card *gus = snd_kcontrol_chip(kcontrol); 57 unsigned long flags; 58 int change; 59 unsigned char nval; 60 61 nval = ucontrol->value.integer.value[0] & 31; 62 spin_lock_irqsave(&gus->reg_lock, flags); 63 change = gus->joystick_dac != nval; 64 gus->joystick_dac = nval; 65 snd_gf1_write8(gus, SNDRV_GF1_GB_JOYSTICK_DAC_LEVEL, gus->joystick_dac); 66 spin_unlock_irqrestore(&gus->reg_lock, flags); 67 return change; 68 } 69 70 static const struct snd_kcontrol_new snd_gus_joystick_control = { 71 .iface = SNDRV_CTL_ELEM_IFACE_CARD, 72 .name = "Joystick Speed", 73 .info = snd_gus_joystick_info, 74 .get = snd_gus_joystick_get, 75 .put = snd_gus_joystick_put 76 }; 77 78 static void snd_gus_init_control(struct snd_gus_card *gus) 79 { 80 int ret; 81 82 if (!gus->ace_flag) { 83 ret = 84 snd_ctl_add(gus->card, 85 snd_ctl_new1(&snd_gus_joystick_control, 86 gus)); 87 if (ret) 88 snd_printk(KERN_ERR "gus: snd_ctl_add failed: %d\n", 89 ret); 90 } 91 } 92 93 /* 94 * 95 */ 96 97 static int snd_gus_free(struct snd_gus_card *gus) 98 { 99 if (gus->gf1.res_port2 == NULL) 100 goto __hw_end; 101 snd_gf1_stop(gus); 102 snd_gus_init_dma_irq(gus, 0); 103 __hw_end: 104 release_and_free_resource(gus->gf1.res_port1); 105 release_and_free_resource(gus->gf1.res_port2); 106 if (gus->gf1.irq >= 0) 107 free_irq(gus->gf1.irq, (void *) gus); 108 if (gus->gf1.dma1 >= 0) { 109 disable_dma(gus->gf1.dma1); 110 free_dma(gus->gf1.dma1); 111 } 112 if (!gus->equal_dma && gus->gf1.dma2 >= 0) { 113 disable_dma(gus->gf1.dma2); 114 free_dma(gus->gf1.dma2); 115 } 116 kfree(gus); 117 return 0; 118 } 119 120 static int snd_gus_dev_free(struct snd_device *device) 121 { 122 struct snd_gus_card *gus = device->device_data; 123 return snd_gus_free(gus); 124 } 125 126 int snd_gus_create(struct snd_card *card, 127 unsigned long port, 128 int irq, int dma1, int dma2, 129 int timer_dev, 130 int voices, 131 int pcm_channels, 132 int effect, 133 struct snd_gus_card **rgus) 134 { 135 struct snd_gus_card *gus; 136 int err; 137 static const struct snd_device_ops ops = { 138 .dev_free = snd_gus_dev_free, 139 }; 140 141 *rgus = NULL; 142 gus = kzalloc(sizeof(*gus), GFP_KERNEL); 143 if (gus == NULL) 144 return -ENOMEM; 145 spin_lock_init(&gus->reg_lock); 146 spin_lock_init(&gus->voice_alloc); 147 spin_lock_init(&gus->active_voice_lock); 148 spin_lock_init(&gus->event_lock); 149 spin_lock_init(&gus->dma_lock); 150 spin_lock_init(&gus->pcm_volume_level_lock); 151 spin_lock_init(&gus->uart_cmd_lock); 152 mutex_init(&gus->dma_mutex); 153 gus->gf1.irq = -1; 154 gus->gf1.dma1 = -1; 155 gus->gf1.dma2 = -1; 156 gus->card = card; 157 gus->gf1.port = port; 158 /* fill register variables for speedup */ 159 gus->gf1.reg_page = GUSP(gus, GF1PAGE); 160 gus->gf1.reg_regsel = GUSP(gus, GF1REGSEL); 161 gus->gf1.reg_data8 = GUSP(gus, GF1DATAHIGH); 162 gus->gf1.reg_data16 = GUSP(gus, GF1DATALOW); 163 gus->gf1.reg_irqstat = GUSP(gus, IRQSTAT); 164 gus->gf1.reg_dram = GUSP(gus, DRAM); 165 gus->gf1.reg_timerctrl = GUSP(gus, TIMERCNTRL); 166 gus->gf1.reg_timerdata = GUSP(gus, TIMERDATA); 167 /* allocate resources */ 168 gus->gf1.res_port1 = request_region(port, 16, "GUS GF1 (Adlib/SB)"); 169 if (!gus->gf1.res_port1) { 170 snd_printk(KERN_ERR "gus: can't grab SB port 0x%lx\n", port); 171 snd_gus_free(gus); 172 return -EBUSY; 173 } 174 gus->gf1.res_port2 = request_region(port + 0x100, 12, "GUS GF1 (Synth)"); 175 if (!gus->gf1.res_port2) { 176 snd_printk(KERN_ERR "gus: can't grab synth port 0x%lx\n", port + 0x100); 177 snd_gus_free(gus); 178 return -EBUSY; 179 } 180 if (irq >= 0 && request_irq(irq, snd_gus_interrupt, 0, "GUS GF1", (void *) gus)) { 181 snd_printk(KERN_ERR "gus: can't grab irq %d\n", irq); 182 snd_gus_free(gus); 183 return -EBUSY; 184 } 185 gus->gf1.irq = irq; 186 card->sync_irq = irq; 187 if (request_dma(dma1, "GUS - 1")) { 188 snd_printk(KERN_ERR "gus: can't grab DMA1 %d\n", dma1); 189 snd_gus_free(gus); 190 return -EBUSY; 191 } 192 gus->gf1.dma1 = dma1; 193 if (dma2 >= 0 && dma1 != dma2) { 194 if (request_dma(dma2, "GUS - 2")) { 195 snd_printk(KERN_ERR "gus: can't grab DMA2 %d\n", dma2); 196 snd_gus_free(gus); 197 return -EBUSY; 198 } 199 gus->gf1.dma2 = dma2; 200 } else { 201 gus->gf1.dma2 = gus->gf1.dma1; 202 gus->equal_dma = 1; 203 } 204 gus->timer_dev = timer_dev; 205 if (voices < 14) 206 voices = 14; 207 if (voices > 32) 208 voices = 32; 209 if (pcm_channels < 0) 210 pcm_channels = 0; 211 if (pcm_channels > 8) 212 pcm_channels = 8; 213 pcm_channels++; 214 pcm_channels &= ~1; 215 gus->gf1.effect = effect ? 1 : 0; 216 gus->gf1.active_voices = voices; 217 gus->gf1.pcm_channels = pcm_channels; 218 gus->gf1.volume_ramp = 25; 219 gus->gf1.smooth_pan = 1; 220 err = snd_device_new(card, SNDRV_DEV_LOWLEVEL, gus, &ops); 221 if (err < 0) { 222 snd_gus_free(gus); 223 return err; 224 } 225 *rgus = gus; 226 return 0; 227 } 228 229 /* 230 * Memory detection routine for plain GF1 soundcards 231 */ 232 233 static int snd_gus_detect_memory(struct snd_gus_card * gus) 234 { 235 int l, idx, local; 236 unsigned char d; 237 238 snd_gf1_poke(gus, 0L, 0xaa); 239 snd_gf1_poke(gus, 1L, 0x55); 240 if (snd_gf1_peek(gus, 0L) != 0xaa || snd_gf1_peek(gus, 1L) != 0x55) { 241 snd_printk(KERN_ERR "plain GF1 card at 0x%lx without onboard DRAM?\n", gus->gf1.port); 242 return -ENOMEM; 243 } 244 for (idx = 1, d = 0xab; idx < 4; idx++, d++) { 245 local = idx << 18; 246 snd_gf1_poke(gus, local, d); 247 snd_gf1_poke(gus, local + 1, d + 1); 248 if (snd_gf1_peek(gus, local) != d || 249 snd_gf1_peek(gus, local + 1) != d + 1 || 250 snd_gf1_peek(gus, 0L) != 0xaa) 251 break; 252 } 253 #if 1 254 gus->gf1.memory = idx << 18; 255 #else 256 gus->gf1.memory = 256 * 1024; 257 #endif 258 for (l = 0, local = gus->gf1.memory; l < 4; l++, local -= 256 * 1024) { 259 gus->gf1.mem_alloc.banks_8[l].address = 260 gus->gf1.mem_alloc.banks_8[l].size = 0; 261 gus->gf1.mem_alloc.banks_16[l].address = l << 18; 262 gus->gf1.mem_alloc.banks_16[l].size = local > 0 ? 256 * 1024 : 0; 263 } 264 gus->gf1.mem_alloc.banks_8[0].size = gus->gf1.memory; 265 return 0; /* some memory were detected */ 266 } 267 268 static int snd_gus_init_dma_irq(struct snd_gus_card * gus, int latches) 269 { 270 struct snd_card *card; 271 unsigned long flags; 272 int irq, dma1, dma2; 273 static const unsigned char irqs[16] = 274 {0, 0, 1, 3, 0, 2, 0, 4, 0, 1, 0, 5, 6, 0, 0, 7}; 275 static const unsigned char dmas[8] = 276 {6, 1, 0, 2, 0, 3, 4, 5}; 277 278 if (snd_BUG_ON(!gus)) 279 return -EINVAL; 280 card = gus->card; 281 if (snd_BUG_ON(!card)) 282 return -EINVAL; 283 284 gus->mix_cntrl_reg &= 0xf8; 285 gus->mix_cntrl_reg |= 0x01; /* disable MIC, LINE IN, enable LINE OUT */ 286 if (gus->codec_flag || gus->ess_flag) { 287 gus->mix_cntrl_reg &= ~1; /* enable LINE IN */ 288 gus->mix_cntrl_reg |= 4; /* enable MIC */ 289 } 290 dma1 = gus->gf1.dma1; 291 dma1 = abs(dma1); 292 dma1 = dmas[dma1 & 7]; 293 dma2 = gus->gf1.dma2; 294 dma2 = abs(dma2); 295 dma2 = dmas[dma2 & 7]; 296 dma1 |= gus->equal_dma ? 0x40 : (dma2 << 3); 297 298 if ((dma1 & 7) == 0 || (dma2 & 7) == 0) { 299 snd_printk(KERN_ERR "Error! DMA isn't defined.\n"); 300 return -EINVAL; 301 } 302 irq = gus->gf1.irq; 303 irq = abs(irq); 304 irq = irqs[irq & 0x0f]; 305 if (irq == 0) { 306 snd_printk(KERN_ERR "Error! IRQ isn't defined.\n"); 307 return -EINVAL; 308 } 309 irq |= 0x40; 310 #if 0 311 card->mixer.mix_ctrl_reg |= 0x10; 312 #endif 313 314 spin_lock_irqsave(&gus->reg_lock, flags); 315 outb(5, GUSP(gus, REGCNTRLS)); 316 outb(gus->mix_cntrl_reg, GUSP(gus, MIXCNTRLREG)); 317 outb(0x00, GUSP(gus, IRQDMACNTRLREG)); 318 outb(0, GUSP(gus, REGCNTRLS)); 319 spin_unlock_irqrestore(&gus->reg_lock, flags); 320 321 udelay(100); 322 323 spin_lock_irqsave(&gus->reg_lock, flags); 324 outb(0x00 | gus->mix_cntrl_reg, GUSP(gus, MIXCNTRLREG)); 325 outb(dma1, GUSP(gus, IRQDMACNTRLREG)); 326 if (latches) { 327 outb(0x40 | gus->mix_cntrl_reg, GUSP(gus, MIXCNTRLREG)); 328 outb(irq, GUSP(gus, IRQDMACNTRLREG)); 329 } 330 spin_unlock_irqrestore(&gus->reg_lock, flags); 331 332 udelay(100); 333 334 spin_lock_irqsave(&gus->reg_lock, flags); 335 outb(0x00 | gus->mix_cntrl_reg, GUSP(gus, MIXCNTRLREG)); 336 outb(dma1, GUSP(gus, IRQDMACNTRLREG)); 337 if (latches) { 338 outb(0x40 | gus->mix_cntrl_reg, GUSP(gus, MIXCNTRLREG)); 339 outb(irq, GUSP(gus, IRQDMACNTRLREG)); 340 } 341 spin_unlock_irqrestore(&gus->reg_lock, flags); 342 343 snd_gf1_delay(gus); 344 345 if (latches) 346 gus->mix_cntrl_reg |= 0x08; /* enable latches */ 347 else 348 gus->mix_cntrl_reg &= ~0x08; /* disable latches */ 349 spin_lock_irqsave(&gus->reg_lock, flags); 350 outb(gus->mix_cntrl_reg, GUSP(gus, MIXCNTRLREG)); 351 outb(0, GUSP(gus, GF1PAGE)); 352 spin_unlock_irqrestore(&gus->reg_lock, flags); 353 354 return 0; 355 } 356 357 static int snd_gus_check_version(struct snd_gus_card * gus) 358 { 359 unsigned long flags; 360 unsigned char val, rev; 361 struct snd_card *card; 362 363 card = gus->card; 364 spin_lock_irqsave(&gus->reg_lock, flags); 365 outb(0x20, GUSP(gus, REGCNTRLS)); 366 val = inb(GUSP(gus, REGCNTRLS)); 367 rev = inb(GUSP(gus, BOARDVERSION)); 368 spin_unlock_irqrestore(&gus->reg_lock, flags); 369 snd_printdd("GF1 [0x%lx] init - val = 0x%x, rev = 0x%x\n", gus->gf1.port, val, rev); 370 strcpy(card->driver, "GUS"); 371 strcpy(card->longname, "Gravis UltraSound Classic (2.4)"); 372 if ((val != 255 && (val & 0x06)) || (rev >= 5 && rev != 255)) { 373 if (rev >= 5 && rev <= 9) { 374 gus->ics_flag = 1; 375 if (rev == 5) 376 gus->ics_flipped = 1; 377 card->longname[27] = '3'; 378 card->longname[29] = rev == 5 ? '5' : '7'; 379 } 380 if (rev >= 10 && rev != 255) { 381 if (rev >= 10 && rev <= 11) { 382 strcpy(card->driver, "GUS MAX"); 383 strcpy(card->longname, "Gravis UltraSound MAX"); 384 gus->max_flag = 1; 385 } else if (rev == 0x30) { 386 strcpy(card->driver, "GUS ACE"); 387 strcpy(card->longname, "Gravis UltraSound Ace"); 388 gus->ace_flag = 1; 389 } else if (rev == 0x50) { 390 strcpy(card->driver, "GUS Extreme"); 391 strcpy(card->longname, "Gravis UltraSound Extreme"); 392 gus->ess_flag = 1; 393 } else { 394 snd_printk(KERN_ERR "unknown GF1 revision number at 0x%lx - 0x%x (0x%x)\n", gus->gf1.port, rev, val); 395 snd_printk(KERN_ERR " please - report to <perex@perex.cz>\n"); 396 } 397 } 398 } 399 strscpy(card->shortname, card->longname, sizeof(card->shortname)); 400 gus->uart_enable = 1; /* standard GUSes doesn't have midi uart trouble */ 401 snd_gus_init_control(gus); 402 return 0; 403 } 404 405 int snd_gus_initialize(struct snd_gus_card *gus) 406 { 407 int err; 408 409 if (!gus->interwave) { 410 err = snd_gus_check_version(gus); 411 if (err < 0) { 412 snd_printk(KERN_ERR "version check failed\n"); 413 return err; 414 } 415 err = snd_gus_detect_memory(gus); 416 if (err < 0) 417 return err; 418 } 419 err = snd_gus_init_dma_irq(gus, 1); 420 if (err < 0) 421 return err; 422 snd_gf1_start(gus); 423 gus->initialized = 1; 424 return 0; 425 } 426 427 /* gus_io.c */ 428 EXPORT_SYMBOL(snd_gf1_delay); 429 EXPORT_SYMBOL(snd_gf1_write8); 430 EXPORT_SYMBOL(snd_gf1_look8); 431 EXPORT_SYMBOL(snd_gf1_write16); 432 EXPORT_SYMBOL(snd_gf1_look16); 433 EXPORT_SYMBOL(snd_gf1_i_write8); 434 EXPORT_SYMBOL(snd_gf1_i_look8); 435 EXPORT_SYMBOL(snd_gf1_i_look16); 436 EXPORT_SYMBOL(snd_gf1_dram_addr); 437 EXPORT_SYMBOL(snd_gf1_write_addr); 438 EXPORT_SYMBOL(snd_gf1_poke); 439 EXPORT_SYMBOL(snd_gf1_peek); 440 /* gus_reset.c */ 441 EXPORT_SYMBOL(snd_gf1_alloc_voice); 442 EXPORT_SYMBOL(snd_gf1_free_voice); 443 EXPORT_SYMBOL(snd_gf1_ctrl_stop); 444 EXPORT_SYMBOL(snd_gf1_stop_voice); 445 /* gus_mixer.c */ 446 EXPORT_SYMBOL(snd_gf1_new_mixer); 447 /* gus_pcm.c */ 448 EXPORT_SYMBOL(snd_gf1_pcm_new); 449 /* gus.c */ 450 EXPORT_SYMBOL(snd_gus_use_inc); 451 EXPORT_SYMBOL(snd_gus_use_dec); 452 EXPORT_SYMBOL(snd_gus_create); 453 EXPORT_SYMBOL(snd_gus_initialize); 454 /* gus_irq.c */ 455 EXPORT_SYMBOL(snd_gus_interrupt); 456 /* gus_uart.c */ 457 EXPORT_SYMBOL(snd_gf1_rawmidi_new); 458 /* gus_dram.c */ 459 EXPORT_SYMBOL(snd_gus_dram_write); 460 EXPORT_SYMBOL(snd_gus_dram_read); 461 /* gus_volume.c */ 462 EXPORT_SYMBOL(snd_gf1_lvol_to_gvol_raw); 463 EXPORT_SYMBOL(snd_gf1_translate_freq); 464 /* gus_mem.c */ 465 EXPORT_SYMBOL(snd_gf1_mem_alloc); 466 EXPORT_SYMBOL(snd_gf1_mem_xfree); 467 EXPORT_SYMBOL(snd_gf1_mem_free); 468 EXPORT_SYMBOL(snd_gf1_mem_lock); 469