root/sound/isa/opl3sa2.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. __snd_opl3sa2_read
  2. snd_opl3sa2_read
  3. __snd_opl3sa2_write
  4. snd_opl3sa2_write
  5. snd_opl3sa2_detect
  6. snd_opl3sa2_interrupt
  7. snd_opl3sa2_get_single
  8. snd_opl3sa2_put_single
  9. snd_opl3sa2_get_double
  10. snd_opl3sa2_put_double
  11. snd_opl3sa2_master_free
  12. snd_opl3sa2_mixer
  13. snd_opl3sa2_suspend
  14. snd_opl3sa2_resume
  15. snd_opl3sa2_pnp
  16. snd_opl3sa2_free
  17. snd_opl3sa2_card_new
  18. snd_opl3sa2_probe
  19. snd_opl3sa2_pnp_detect
  20. snd_opl3sa2_pnp_remove
  21. snd_opl3sa2_pnp_suspend
  22. snd_opl3sa2_pnp_resume
  23. snd_opl3sa2_pnp_cdetect
  24. snd_opl3sa2_pnp_cremove
  25. snd_opl3sa2_pnp_csuspend
  26. snd_opl3sa2_pnp_cresume
  27. snd_opl3sa2_isa_match
  28. snd_opl3sa2_isa_probe
  29. snd_opl3sa2_isa_remove
  30. snd_opl3sa2_isa_suspend
  31. snd_opl3sa2_isa_resume
  32. alsa_card_opl3sa2_init
  33. alsa_card_opl3sa2_exit

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*
   3  *  Driver for Yamaha OPL3-SA[2,3] soundcards
   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/interrupt.h>
  11 #include <linux/pm.h>
  12 #include <linux/pnp.h>
  13 #include <linux/module.h>
  14 #include <linux/io.h>
  15 #include <sound/core.h>
  16 #include <sound/wss.h>
  17 #include <sound/mpu401.h>
  18 #include <sound/opl3.h>
  19 #include <sound/initval.h>
  20 #include <sound/tlv.h>
  21 
  22 MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>");
  23 MODULE_DESCRIPTION("Yamaha OPL3SA2+");
  24 MODULE_LICENSE("GPL");
  25 MODULE_SUPPORTED_DEVICE("{{Yamaha,YMF719E-S},"
  26                 "{Genius,Sound Maker 3DX},"
  27                 "{Yamaha,OPL3SA3},"
  28                 "{Intel,AL440LX sound},"
  29                 "{NeoMagic,MagicWave 3DX}}");
  30 
  31 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX;      /* Index 0-MAX */
  32 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR;       /* ID for this card */
  33 static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_ISAPNP; /* Enable this card */
  34 #ifdef CONFIG_PNP
  35 static bool isapnp[SNDRV_CARDS] = {[0 ... (SNDRV_CARDS - 1)] = 1};
  36 #endif
  37 static long port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT;     /* 0xf86,0x370,0x100 */
  38 static long sb_port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT;  /* 0x220,0x240,0x260 */
  39 static long wss_port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT;/* 0x530,0xe80,0xf40,0x604 */
  40 static long fm_port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT;  /* 0x388 */
  41 static long midi_port[SNDRV_CARDS] = SNDRV_DEFAULT_PORT;/* 0x330,0x300 */
  42 static int irq[SNDRV_CARDS] = SNDRV_DEFAULT_IRQ;        /* 0,1,3,5,9,11,12,15 */
  43 static int dma1[SNDRV_CARDS] = SNDRV_DEFAULT_DMA;       /* 1,3,5,6,7 */
  44 static int dma2[SNDRV_CARDS] = SNDRV_DEFAULT_DMA;       /* 1,3,5,6,7 */
  45 static int opl3sa3_ymode[SNDRV_CARDS];   /* 0,1,2,3 */ /*SL Added*/
  46 
  47 module_param_array(index, int, NULL, 0444);
  48 MODULE_PARM_DESC(index, "Index value for OPL3-SA soundcard.");
  49 module_param_array(id, charp, NULL, 0444);
  50 MODULE_PARM_DESC(id, "ID string for OPL3-SA soundcard.");
  51 module_param_array(enable, bool, NULL, 0444);
  52 MODULE_PARM_DESC(enable, "Enable OPL3-SA soundcard.");
  53 #ifdef CONFIG_PNP
  54 module_param_array(isapnp, bool, NULL, 0444);
  55 MODULE_PARM_DESC(isapnp, "PnP detection for specified soundcard.");
  56 #endif
  57 module_param_hw_array(port, long, ioport, NULL, 0444);
  58 MODULE_PARM_DESC(port, "Port # for OPL3-SA driver.");
  59 module_param_hw_array(sb_port, long, ioport, NULL, 0444);
  60 MODULE_PARM_DESC(sb_port, "SB port # for OPL3-SA driver.");
  61 module_param_hw_array(wss_port, long, ioport, NULL, 0444);
  62 MODULE_PARM_DESC(wss_port, "WSS port # for OPL3-SA driver.");
  63 module_param_hw_array(fm_port, long, ioport, NULL, 0444);
  64 MODULE_PARM_DESC(fm_port, "FM port # for OPL3-SA driver.");
  65 module_param_hw_array(midi_port, long, ioport, NULL, 0444);
  66 MODULE_PARM_DESC(midi_port, "MIDI port # for OPL3-SA driver.");
  67 module_param_hw_array(irq, int, irq, NULL, 0444);
  68 MODULE_PARM_DESC(irq, "IRQ # for OPL3-SA driver.");
  69 module_param_hw_array(dma1, int, dma, NULL, 0444);
  70 MODULE_PARM_DESC(dma1, "DMA1 # for OPL3-SA driver.");
  71 module_param_hw_array(dma2, int, dma, NULL, 0444);
  72 MODULE_PARM_DESC(dma2, "DMA2 # for OPL3-SA driver.");
  73 module_param_array(opl3sa3_ymode, int, NULL, 0444);
  74 MODULE_PARM_DESC(opl3sa3_ymode, "Speaker size selection for 3D Enhancement mode: Desktop/Large Notebook/Small Notebook/HiFi.");
  75 
  76 #ifdef CONFIG_PNP
  77 static int isa_registered;
  78 static int pnp_registered;
  79 static int pnpc_registered;
  80 #endif
  81 
  82 /* control ports */
  83 #define OPL3SA2_PM_CTRL         0x01
  84 #define OPL3SA2_SYS_CTRL                0x02
  85 #define OPL3SA2_IRQ_CONFIG      0x03
  86 #define OPL3SA2_IRQ_STATUS      0x04
  87 #define OPL3SA2_DMA_CONFIG      0x06
  88 #define OPL3SA2_MASTER_LEFT     0x07
  89 #define OPL3SA2_MASTER_RIGHT    0x08
  90 #define OPL3SA2_MIC             0x09
  91 #define OPL3SA2_MISC            0x0A
  92 
  93 /* opl3sa3 only */
  94 #define OPL3SA3_DGTL_DOWN       0x12
  95 #define OPL3SA3_ANLG_DOWN       0x13
  96 #define OPL3SA3_WIDE            0x14
  97 #define OPL3SA3_BASS            0x15
  98 #define OPL3SA3_TREBLE          0x16
  99 
 100 /* power management bits */
 101 #define OPL3SA2_PM_ADOWN                0x20
 102 #define OPL3SA2_PM_PSV          0x04            
 103 #define OPL3SA2_PM_PDN          0x02
 104 #define OPL3SA2_PM_PDX          0x01
 105 
 106 #define OPL3SA2_PM_D0   0x00
 107 #define OPL3SA2_PM_D3   (OPL3SA2_PM_ADOWN|OPL3SA2_PM_PSV|OPL3SA2_PM_PDN|OPL3SA2_PM_PDX)
 108 
 109 struct snd_opl3sa2 {
 110         int version;            /* 2 or 3 */
 111         unsigned long port;     /* control port */
 112         struct resource *res_port; /* control port resource */
 113         int irq;
 114         int single_dma;
 115         spinlock_t reg_lock;
 116         struct snd_hwdep *synth;
 117         struct snd_rawmidi *rmidi;
 118         struct snd_wss *wss;
 119         unsigned char ctlregs[0x20];
 120         int ymode;              /* SL added */
 121         struct snd_kcontrol *master_switch;
 122         struct snd_kcontrol *master_volume;
 123 };
 124 
 125 #define PFX     "opl3sa2: "
 126 
 127 #ifdef CONFIG_PNP
 128 
 129 static const struct pnp_device_id snd_opl3sa2_pnpbiosids[] = {
 130         { .id = "YMH0021" },
 131         { .id = "NMX2210" },    /* Gateway Solo 2500 */
 132         { .id = "" }            /* end */
 133 };
 134 
 135 MODULE_DEVICE_TABLE(pnp, snd_opl3sa2_pnpbiosids);
 136 
 137 static const struct pnp_card_device_id snd_opl3sa2_pnpids[] = {
 138         /* Yamaha YMF719E-S (Genius Sound Maker 3DX) */
 139         { .id = "YMH0020", .devs = { { "YMH0021" } } },
 140         /* Yamaha OPL3-SA3 (integrated on Intel's Pentium II AL440LX motherboard) */
 141         { .id = "YMH0030", .devs = { { "YMH0021" } } },
 142         /* Yamaha OPL3-SA2 */
 143         { .id = "YMH0800", .devs = { { "YMH0021" } } },
 144         /* Yamaha OPL3-SA2 */
 145         { .id = "YMH0801", .devs = { { "YMH0021" } } },
 146         /* NeoMagic MagicWave 3DX */
 147         { .id = "NMX2200", .devs = { { "YMH2210" } } },
 148         /* NeoMagic MagicWave 3D */
 149         { .id = "NMX2200", .devs = { { "NMX2210" } } },
 150         /* --- */
 151         { .id = "" }    /* end */
 152 };
 153 
 154 MODULE_DEVICE_TABLE(pnp_card, snd_opl3sa2_pnpids);
 155 
 156 #endif /* CONFIG_PNP */
 157 
 158 
 159 /* read control port (w/o spinlock) */
 160 static unsigned char __snd_opl3sa2_read(struct snd_opl3sa2 *chip, unsigned char reg)
 161 {
 162         unsigned char result;
 163 #if 0
 164         outb(0x1d, port);       /* password */
 165         printk(KERN_DEBUG "read [0x%lx] = 0x%x\n", port, inb(port));
 166 #endif
 167         outb(reg, chip->port);  /* register */
 168         result = inb(chip->port + 1);
 169 #if 0
 170         printk(KERN_DEBUG "read [0x%lx] = 0x%x [0x%x]\n",
 171                port, result, inb(port));
 172 #endif
 173         return result;
 174 }
 175 
 176 /* read control port (with spinlock) */
 177 static unsigned char snd_opl3sa2_read(struct snd_opl3sa2 *chip, unsigned char reg)
 178 {
 179         unsigned long flags;
 180         unsigned char result;
 181 
 182         spin_lock_irqsave(&chip->reg_lock, flags);
 183         result = __snd_opl3sa2_read(chip, reg);
 184         spin_unlock_irqrestore(&chip->reg_lock, flags);
 185         return result;
 186 }
 187 
 188 /* write control port (w/o spinlock) */
 189 static void __snd_opl3sa2_write(struct snd_opl3sa2 *chip, unsigned char reg, unsigned char value)
 190 {
 191 #if 0
 192         outb(0x1d, port);       /* password */
 193 #endif
 194         outb(reg, chip->port);  /* register */
 195         outb(value, chip->port + 1);
 196         chip->ctlregs[reg] = value;
 197 }
 198 
 199 /* write control port (with spinlock) */
 200 static void snd_opl3sa2_write(struct snd_opl3sa2 *chip, unsigned char reg, unsigned char value)
 201 {
 202         unsigned long flags;
 203         spin_lock_irqsave(&chip->reg_lock, flags);
 204         __snd_opl3sa2_write(chip, reg, value);
 205         spin_unlock_irqrestore(&chip->reg_lock, flags);
 206 }
 207 
 208 static int snd_opl3sa2_detect(struct snd_card *card)
 209 {
 210         struct snd_opl3sa2 *chip = card->private_data;
 211         unsigned long port;
 212         unsigned char tmp, tmp1;
 213         char str[2];
 214 
 215         port = chip->port;
 216         if ((chip->res_port = request_region(port, 2, "OPL3-SA control")) == NULL) {
 217                 snd_printk(KERN_ERR PFX "can't grab port 0x%lx\n", port);
 218                 return -EBUSY;
 219         }
 220         /*
 221         snd_printk(KERN_DEBUG "REG 0A = 0x%x\n",
 222                    snd_opl3sa2_read(chip, 0x0a));
 223         */
 224         chip->version = 0;
 225         tmp = snd_opl3sa2_read(chip, OPL3SA2_MISC);
 226         if (tmp == 0xff) {
 227                 snd_printd("OPL3-SA [0x%lx] detect = 0x%x\n", port, tmp);
 228                 return -ENODEV;
 229         }
 230         switch (tmp & 0x07) {
 231         case 0x01:
 232                 chip->version = 2; /* YMF711 */
 233                 break;
 234         default:
 235                 chip->version = 3;
 236                 /* 0x02 - standard */
 237                 /* 0x03 - YM715B */
 238                 /* 0x04 - YM719 - OPL-SA4? */
 239                 /* 0x05 - OPL3-SA3 - Libretto 100 */
 240                 /* 0x07 - unknown - Neomagic MagicWave 3D */
 241                 break;
 242         }
 243         str[0] = chip->version + '0';
 244         str[1] = 0;
 245         strcat(card->shortname, str);
 246         snd_opl3sa2_write(chip, OPL3SA2_MISC, tmp ^ 7);
 247         if ((tmp1 = snd_opl3sa2_read(chip, OPL3SA2_MISC)) != tmp) {
 248                 snd_printd("OPL3-SA [0x%lx] detect (1) = 0x%x (0x%x)\n", port, tmp, tmp1);
 249                 return -ENODEV;
 250         }
 251         /* try if the MIC register is accessible */
 252         tmp = snd_opl3sa2_read(chip, OPL3SA2_MIC);
 253         snd_opl3sa2_write(chip, OPL3SA2_MIC, 0x8a);
 254         if (((tmp1 = snd_opl3sa2_read(chip, OPL3SA2_MIC)) & 0x9f) != 0x8a) {
 255                 snd_printd("OPL3-SA [0x%lx] detect (2) = 0x%x (0x%x)\n", port, tmp, tmp1);
 256                 return -ENODEV;
 257         }
 258         snd_opl3sa2_write(chip, OPL3SA2_MIC, 0x9f);
 259         /* initialization */
 260         /* Power Management - full on */
 261         snd_opl3sa2_write(chip, OPL3SA2_PM_CTRL, OPL3SA2_PM_D0);
 262         if (chip->version > 2) {
 263                 /* ymode is bits 4&5 (of 0 to 7) on all but opl3sa2 versions */
 264                 snd_opl3sa2_write(chip, OPL3SA2_SYS_CTRL, (chip->ymode << 4));
 265         } else {
 266                 /* default for opl3sa2 versions */
 267                 snd_opl3sa2_write(chip, OPL3SA2_SYS_CTRL, 0x00);
 268         }
 269         snd_opl3sa2_write(chip, OPL3SA2_IRQ_CONFIG, 0x0d);      /* Interrupt Channel Configuration - IRQ A = OPL3 + MPU + WSS */
 270         if (chip->single_dma) {
 271                 snd_opl3sa2_write(chip, OPL3SA2_DMA_CONFIG, 0x03);      /* DMA Configuration - DMA A = WSS-R + WSS-P */
 272         } else {
 273                 snd_opl3sa2_write(chip, OPL3SA2_DMA_CONFIG, 0x21);      /* DMA Configuration - DMA B = WSS-R, DMA A = WSS-P */
 274         }
 275         snd_opl3sa2_write(chip, OPL3SA2_MISC, 0x80 | (tmp & 7));        /* Miscellaneous - default */
 276         if (chip->version > 2) {
 277                 snd_opl3sa2_write(chip, OPL3SA3_DGTL_DOWN, 0x00);       /* Digital Block Partial Power Down - default */
 278                 snd_opl3sa2_write(chip, OPL3SA3_ANLG_DOWN, 0x00);       /* Analog Block Partial Power Down - default */
 279         }
 280         return 0;
 281 }
 282 
 283 static irqreturn_t snd_opl3sa2_interrupt(int irq, void *dev_id)
 284 {
 285         unsigned short status;
 286         struct snd_card *card = dev_id;
 287         struct snd_opl3sa2 *chip;
 288         int handled = 0;
 289 
 290         if (card == NULL)
 291                 return IRQ_NONE;
 292 
 293         chip = card->private_data;
 294         status = snd_opl3sa2_read(chip, OPL3SA2_IRQ_STATUS);
 295 
 296         if (status & 0x20) {
 297                 handled = 1;
 298                 snd_opl3_interrupt(chip->synth);
 299         }
 300 
 301         if ((status & 0x10) && chip->rmidi != NULL) {
 302                 handled = 1;
 303                 snd_mpu401_uart_interrupt(irq, chip->rmidi->private_data);
 304         }
 305 
 306         if (status & 0x07) {    /* TI,CI,PI */
 307                 handled = 1;
 308                 snd_wss_interrupt(irq, chip->wss);
 309         }
 310 
 311         if (status & 0x40) { /* hardware volume change */
 312                 handled = 1;
 313                 /* reading from Master Lch register at 0x07 clears this bit */
 314                 snd_opl3sa2_read(chip, OPL3SA2_MASTER_RIGHT);
 315                 snd_opl3sa2_read(chip, OPL3SA2_MASTER_LEFT);
 316                 if (chip->master_switch && chip->master_volume) {
 317                         snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_VALUE,
 318                                         &chip->master_switch->id);
 319                         snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_VALUE,
 320                                         &chip->master_volume->id);
 321                 }
 322         }
 323         return IRQ_RETVAL(handled);
 324 }
 325 
 326 #define OPL3SA2_SINGLE(xname, xindex, reg, shift, mask, invert) \
 327 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xindex, \
 328   .info = snd_wss_info_single, \
 329   .get = snd_opl3sa2_get_single, .put = snd_opl3sa2_put_single, \
 330   .private_value = reg | (shift << 8) | (mask << 16) | (invert << 24) }
 331 #define OPL3SA2_SINGLE_TLV(xname, xindex, reg, shift, mask, invert, xtlv) \
 332 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \
 333   .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | SNDRV_CTL_ELEM_ACCESS_TLV_READ, \
 334   .name = xname, .index = xindex, \
 335   .info = snd_wss_info_single, \
 336   .get = snd_opl3sa2_get_single, .put = snd_opl3sa2_put_single, \
 337   .private_value = reg | (shift << 8) | (mask << 16) | (invert << 24), \
 338   .tlv = { .p = (xtlv) } }
 339 
 340 static int snd_opl3sa2_get_single(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
 341 {
 342         struct snd_opl3sa2 *chip = snd_kcontrol_chip(kcontrol);
 343         unsigned long flags;
 344         int reg = kcontrol->private_value & 0xff;
 345         int shift = (kcontrol->private_value >> 8) & 0xff;
 346         int mask = (kcontrol->private_value >> 16) & 0xff;
 347         int invert = (kcontrol->private_value >> 24) & 0xff;
 348 
 349         spin_lock_irqsave(&chip->reg_lock, flags);
 350         ucontrol->value.integer.value[0] = (chip->ctlregs[reg] >> shift) & mask;
 351         spin_unlock_irqrestore(&chip->reg_lock, flags);
 352         if (invert)
 353                 ucontrol->value.integer.value[0] = mask - ucontrol->value.integer.value[0];
 354         return 0;
 355 }
 356 
 357 static int snd_opl3sa2_put_single(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
 358 {
 359         struct snd_opl3sa2 *chip = snd_kcontrol_chip(kcontrol);
 360         unsigned long flags;
 361         int reg = kcontrol->private_value & 0xff;
 362         int shift = (kcontrol->private_value >> 8) & 0xff;
 363         int mask = (kcontrol->private_value >> 16) & 0xff;
 364         int invert = (kcontrol->private_value >> 24) & 0xff;
 365         int change;
 366         unsigned short val, oval;
 367         
 368         val = (ucontrol->value.integer.value[0] & mask);
 369         if (invert)
 370                 val = mask - val;
 371         val <<= shift;
 372         spin_lock_irqsave(&chip->reg_lock, flags);
 373         oval = chip->ctlregs[reg];
 374         val = (oval & ~(mask << shift)) | val;
 375         change = val != oval;
 376         __snd_opl3sa2_write(chip, reg, val);
 377         spin_unlock_irqrestore(&chip->reg_lock, flags);
 378         return change;
 379 }
 380 
 381 #define OPL3SA2_DOUBLE(xname, xindex, left_reg, right_reg, shift_left, shift_right, mask, invert) \
 382 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xindex, \
 383   .info = snd_wss_info_double, \
 384   .get = snd_opl3sa2_get_double, .put = snd_opl3sa2_put_double, \
 385   .private_value = left_reg | (right_reg << 8) | (shift_left << 16) | (shift_right << 19) | (mask << 24) | (invert << 22) }
 386 #define OPL3SA2_DOUBLE_TLV(xname, xindex, left_reg, right_reg, shift_left, shift_right, mask, invert, xtlv) \
 387 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \
 388   .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | SNDRV_CTL_ELEM_ACCESS_TLV_READ, \
 389   .name = xname, .index = xindex, \
 390   .info = snd_wss_info_double, \
 391   .get = snd_opl3sa2_get_double, .put = snd_opl3sa2_put_double, \
 392   .private_value = left_reg | (right_reg << 8) | (shift_left << 16) | (shift_right << 19) | (mask << 24) | (invert << 22), \
 393   .tlv = { .p = (xtlv) } }
 394 
 395 static int snd_opl3sa2_get_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
 396 {
 397         struct snd_opl3sa2 *chip = snd_kcontrol_chip(kcontrol);
 398         unsigned long flags;
 399         int left_reg = kcontrol->private_value & 0xff;
 400         int right_reg = (kcontrol->private_value >> 8) & 0xff;
 401         int shift_left = (kcontrol->private_value >> 16) & 0x07;
 402         int shift_right = (kcontrol->private_value >> 19) & 0x07;
 403         int mask = (kcontrol->private_value >> 24) & 0xff;
 404         int invert = (kcontrol->private_value >> 22) & 1;
 405         
 406         spin_lock_irqsave(&chip->reg_lock, flags);
 407         ucontrol->value.integer.value[0] = (chip->ctlregs[left_reg] >> shift_left) & mask;
 408         ucontrol->value.integer.value[1] = (chip->ctlregs[right_reg] >> shift_right) & mask;
 409         spin_unlock_irqrestore(&chip->reg_lock, flags);
 410         if (invert) {
 411                 ucontrol->value.integer.value[0] = mask - ucontrol->value.integer.value[0];
 412                 ucontrol->value.integer.value[1] = mask - ucontrol->value.integer.value[1];
 413         }
 414         return 0;
 415 }
 416 
 417 static int snd_opl3sa2_put_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
 418 {
 419         struct snd_opl3sa2 *chip = snd_kcontrol_chip(kcontrol);
 420         unsigned long flags;
 421         int left_reg = kcontrol->private_value & 0xff;
 422         int right_reg = (kcontrol->private_value >> 8) & 0xff;
 423         int shift_left = (kcontrol->private_value >> 16) & 0x07;
 424         int shift_right = (kcontrol->private_value >> 19) & 0x07;
 425         int mask = (kcontrol->private_value >> 24) & 0xff;
 426         int invert = (kcontrol->private_value >> 22) & 1;
 427         int change;
 428         unsigned short val1, val2, oval1, oval2;
 429         
 430         val1 = ucontrol->value.integer.value[0] & mask;
 431         val2 = ucontrol->value.integer.value[1] & mask;
 432         if (invert) {
 433                 val1 = mask - val1;
 434                 val2 = mask - val2;
 435         }
 436         val1 <<= shift_left;
 437         val2 <<= shift_right;
 438         spin_lock_irqsave(&chip->reg_lock, flags);
 439         if (left_reg != right_reg) {
 440                 oval1 = chip->ctlregs[left_reg];
 441                 oval2 = chip->ctlregs[right_reg];
 442                 val1 = (oval1 & ~(mask << shift_left)) | val1;
 443                 val2 = (oval2 & ~(mask << shift_right)) | val2;
 444                 change = val1 != oval1 || val2 != oval2;
 445                 __snd_opl3sa2_write(chip, left_reg, val1);
 446                 __snd_opl3sa2_write(chip, right_reg, val2);
 447         } else {
 448                 oval1 = chip->ctlregs[left_reg];
 449                 val1 = (oval1 & ~((mask << shift_left) | (mask << shift_right))) | val1 | val2;
 450                 change = val1 != oval1;
 451                 __snd_opl3sa2_write(chip, left_reg, val1);
 452         }
 453         spin_unlock_irqrestore(&chip->reg_lock, flags);
 454         return change;
 455 }
 456 
 457 static const DECLARE_TLV_DB_SCALE(db_scale_master, -3000, 200, 0);
 458 static const DECLARE_TLV_DB_SCALE(db_scale_5bit_12db_max, -3450, 150, 0);
 459 
 460 static struct snd_kcontrol_new snd_opl3sa2_controls[] = {
 461 OPL3SA2_DOUBLE("Master Playback Switch", 0, 0x07, 0x08, 7, 7, 1, 1),
 462 OPL3SA2_DOUBLE_TLV("Master Playback Volume", 0, 0x07, 0x08, 0, 0, 15, 1,
 463                    db_scale_master),
 464 OPL3SA2_SINGLE("Mic Playback Switch", 0, 0x09, 7, 1, 1),
 465 OPL3SA2_SINGLE_TLV("Mic Playback Volume", 0, 0x09, 0, 31, 1,
 466                    db_scale_5bit_12db_max),
 467 OPL3SA2_SINGLE("ZV Port Switch", 0, 0x02, 0, 1, 0),
 468 };
 469 
 470 static struct snd_kcontrol_new snd_opl3sa2_tone_controls[] = {
 471 OPL3SA2_DOUBLE("3D Control - Wide", 0, 0x14, 0x14, 4, 0, 7, 0),
 472 OPL3SA2_DOUBLE("Tone Control - Bass", 0, 0x15, 0x15, 4, 0, 7, 0),
 473 OPL3SA2_DOUBLE("Tone Control - Treble", 0, 0x16, 0x16, 4, 0, 7, 0)
 474 };
 475 
 476 static void snd_opl3sa2_master_free(struct snd_kcontrol *kcontrol)
 477 {
 478         struct snd_opl3sa2 *chip = snd_kcontrol_chip(kcontrol);
 479         chip->master_switch = NULL;
 480         chip->master_volume = NULL;
 481 }
 482 
 483 static int snd_opl3sa2_mixer(struct snd_card *card)
 484 {
 485         struct snd_opl3sa2 *chip = card->private_data;
 486         struct snd_ctl_elem_id id1, id2;
 487         struct snd_kcontrol *kctl;
 488         unsigned int idx;
 489         int err;
 490 
 491         memset(&id1, 0, sizeof(id1));
 492         memset(&id2, 0, sizeof(id2));
 493         id1.iface = id2.iface = SNDRV_CTL_ELEM_IFACE_MIXER;
 494         /* reassign AUX0 to CD */
 495         strcpy(id1.name, "Aux Playback Switch");
 496         strcpy(id2.name, "CD Playback Switch");
 497         if ((err = snd_ctl_rename_id(card, &id1, &id2)) < 0) {
 498                 snd_printk(KERN_ERR "Cannot rename opl3sa2 control\n");
 499                 return err;
 500         }
 501         strcpy(id1.name, "Aux Playback Volume");
 502         strcpy(id2.name, "CD Playback Volume");
 503         if ((err = snd_ctl_rename_id(card, &id1, &id2)) < 0) {
 504                 snd_printk(KERN_ERR "Cannot rename opl3sa2 control\n");
 505                 return err;
 506         }
 507         /* reassign AUX1 to FM */
 508         strcpy(id1.name, "Aux Playback Switch"); id1.index = 1;
 509         strcpy(id2.name, "FM Playback Switch");
 510         if ((err = snd_ctl_rename_id(card, &id1, &id2)) < 0) {
 511                 snd_printk(KERN_ERR "Cannot rename opl3sa2 control\n");
 512                 return err;
 513         }
 514         strcpy(id1.name, "Aux Playback Volume");
 515         strcpy(id2.name, "FM Playback Volume");
 516         if ((err = snd_ctl_rename_id(card, &id1, &id2)) < 0) {
 517                 snd_printk(KERN_ERR "Cannot rename opl3sa2 control\n");
 518                 return err;
 519         }
 520         /* add OPL3SA2 controls */
 521         for (idx = 0; idx < ARRAY_SIZE(snd_opl3sa2_controls); idx++) {
 522                 if ((err = snd_ctl_add(card, kctl = snd_ctl_new1(&snd_opl3sa2_controls[idx], chip))) < 0)
 523                         return err;
 524                 switch (idx) {
 525                 case 0: chip->master_switch = kctl; kctl->private_free = snd_opl3sa2_master_free; break;
 526                 case 1: chip->master_volume = kctl; kctl->private_free = snd_opl3sa2_master_free; break;
 527                 }
 528         }
 529         if (chip->version > 2) {
 530                 for (idx = 0; idx < ARRAY_SIZE(snd_opl3sa2_tone_controls); idx++)
 531                         if ((err = snd_ctl_add(card, snd_ctl_new1(&snd_opl3sa2_tone_controls[idx], chip))) < 0)
 532                                 return err;
 533         }
 534         return 0;
 535 }
 536 
 537 /* Power Management support functions */
 538 #ifdef CONFIG_PM
 539 static int snd_opl3sa2_suspend(struct snd_card *card, pm_message_t state)
 540 {
 541         if (card) {
 542                 struct snd_opl3sa2 *chip = card->private_data;
 543 
 544                 snd_power_change_state(card, SNDRV_CTL_POWER_D3hot);
 545                 chip->wss->suspend(chip->wss);
 546                 /* power down */
 547                 snd_opl3sa2_write(chip, OPL3SA2_PM_CTRL, OPL3SA2_PM_D3);
 548         }
 549 
 550         return 0;
 551 }
 552 
 553 static int snd_opl3sa2_resume(struct snd_card *card)
 554 {
 555         struct snd_opl3sa2 *chip;
 556         int i;
 557 
 558         if (!card)
 559                 return 0;
 560 
 561         chip = card->private_data;
 562         /* power up */
 563         snd_opl3sa2_write(chip, OPL3SA2_PM_CTRL, OPL3SA2_PM_D0);
 564 
 565         /* restore registers */
 566         for (i = 2; i <= 0x0a; i++) {
 567                 if (i != OPL3SA2_IRQ_STATUS)
 568                         snd_opl3sa2_write(chip, i, chip->ctlregs[i]);
 569         }
 570         if (chip->version > 2) {
 571                 for (i = 0x12; i <= 0x16; i++)
 572                         snd_opl3sa2_write(chip, i, chip->ctlregs[i]);
 573         }
 574         /* restore wss */
 575         chip->wss->resume(chip->wss);
 576 
 577         snd_power_change_state(card, SNDRV_CTL_POWER_D0);
 578         return 0;
 579 }
 580 #endif /* CONFIG_PM */
 581 
 582 #ifdef CONFIG_PNP
 583 static int snd_opl3sa2_pnp(int dev, struct snd_opl3sa2 *chip,
 584                            struct pnp_dev *pdev)
 585 {
 586         if (pnp_activate_dev(pdev) < 0) {
 587                 snd_printk(KERN_ERR "PnP configure failure (out of resources?)\n");
 588                 return -EBUSY;
 589         }
 590         sb_port[dev] = pnp_port_start(pdev, 0);
 591         wss_port[dev] = pnp_port_start(pdev, 1);
 592         fm_port[dev] = pnp_port_start(pdev, 2);
 593         midi_port[dev] = pnp_port_start(pdev, 3);
 594         port[dev] = pnp_port_start(pdev, 4);
 595         dma1[dev] = pnp_dma(pdev, 0);
 596         dma2[dev] = pnp_dma(pdev, 1);
 597         irq[dev] = pnp_irq(pdev, 0);
 598         snd_printdd("%sPnP OPL3-SA: sb port=0x%lx, wss port=0x%lx, fm port=0x%lx, midi port=0x%lx\n",
 599                 pnp_device_is_pnpbios(pdev) ? "BIOS" : "ISA", sb_port[dev], wss_port[dev], fm_port[dev], midi_port[dev]);
 600         snd_printdd("%sPnP OPL3-SA: control port=0x%lx, dma1=%i, dma2=%i, irq=%i\n",
 601                 pnp_device_is_pnpbios(pdev) ? "BIOS" : "ISA", port[dev], dma1[dev], dma2[dev], irq[dev]);
 602         return 0;
 603 }
 604 #endif /* CONFIG_PNP */
 605 
 606 static void snd_opl3sa2_free(struct snd_card *card)
 607 {
 608         struct snd_opl3sa2 *chip = card->private_data;
 609         if (chip->irq >= 0)
 610                 free_irq(chip->irq, card);
 611         release_and_free_resource(chip->res_port);
 612 }
 613 
 614 static int snd_opl3sa2_card_new(struct device *pdev, int dev,
 615                                 struct snd_card **cardp)
 616 {
 617         struct snd_card *card;
 618         struct snd_opl3sa2 *chip;
 619         int err;
 620 
 621         err = snd_card_new(pdev, index[dev], id[dev], THIS_MODULE,
 622                            sizeof(struct snd_opl3sa2), &card);
 623         if (err < 0)
 624                 return err;
 625         strcpy(card->driver, "OPL3SA2");
 626         strcpy(card->shortname, "Yamaha OPL3-SA");
 627         chip = card->private_data;
 628         spin_lock_init(&chip->reg_lock);
 629         chip->irq = -1;
 630         card->private_free = snd_opl3sa2_free;
 631         *cardp = card;
 632         return 0;
 633 }
 634 
 635 static int snd_opl3sa2_probe(struct snd_card *card, int dev)
 636 {
 637         int xirq, xdma1, xdma2;
 638         struct snd_opl3sa2 *chip;
 639         struct snd_wss *wss;
 640         struct snd_opl3 *opl3;
 641         int err;
 642 
 643         /* initialise this card from supplied (or default) parameter*/ 
 644         chip = card->private_data;
 645         chip->ymode = opl3sa3_ymode[dev] & 0x03 ;
 646         chip->port = port[dev];
 647         xirq = irq[dev];
 648         xdma1 = dma1[dev];
 649         xdma2 = dma2[dev];
 650         if (xdma2 < 0)
 651                 chip->single_dma = 1;
 652         err = snd_opl3sa2_detect(card);
 653         if (err < 0)
 654                 return err;
 655         err = request_irq(xirq, snd_opl3sa2_interrupt, 0,
 656                           "OPL3-SA2", card);
 657         if (err) {
 658                 snd_printk(KERN_ERR PFX "can't grab IRQ %d\n", xirq);
 659                 return -ENODEV;
 660         }
 661         chip->irq = xirq;
 662         err = snd_wss_create(card,
 663                              wss_port[dev] + 4, -1,
 664                              xirq, xdma1, xdma2,
 665                              WSS_HW_OPL3SA2, WSS_HWSHARE_IRQ, &wss);
 666         if (err < 0) {
 667                 snd_printd("Oops, WSS not detected at 0x%lx\n", wss_port[dev] + 4);
 668                 return err;
 669         }
 670         chip->wss = wss;
 671         err = snd_wss_pcm(wss, 0);
 672         if (err < 0)
 673                 return err;
 674         err = snd_wss_mixer(wss);
 675         if (err < 0)
 676                 return err;
 677         err = snd_opl3sa2_mixer(card);
 678         if (err < 0)
 679                 return err;
 680         err = snd_wss_timer(wss, 0);
 681         if (err < 0)
 682                 return err;
 683         if (fm_port[dev] >= 0x340 && fm_port[dev] < 0x400) {
 684                 if ((err = snd_opl3_create(card, fm_port[dev],
 685                                            fm_port[dev] + 2,
 686                                            OPL3_HW_OPL3, 0, &opl3)) < 0)
 687                         return err;
 688                 if ((err = snd_opl3_timer_new(opl3, 1, 2)) < 0)
 689                         return err;
 690                 if ((err = snd_opl3_hwdep_new(opl3, 0, 1, &chip->synth)) < 0)
 691                         return err;
 692         }
 693         if (midi_port[dev] >= 0x300 && midi_port[dev] < 0x340) {
 694                 if ((err = snd_mpu401_uart_new(card, 0, MPU401_HW_OPL3SA2,
 695                                                midi_port[dev],
 696                                                MPU401_INFO_IRQ_HOOK, -1,
 697                                                &chip->rmidi)) < 0)
 698                         return err;
 699         }
 700         sprintf(card->longname, "%s at 0x%lx, irq %d, dma %d",
 701                 card->shortname, chip->port, xirq, xdma1);
 702         if (xdma2 >= 0)
 703                 sprintf(card->longname + strlen(card->longname), "&%d", xdma2);
 704 
 705         return snd_card_register(card);
 706 }
 707 
 708 #ifdef CONFIG_PNP
 709 static int snd_opl3sa2_pnp_detect(struct pnp_dev *pdev,
 710                                   const struct pnp_device_id *id)
 711 {
 712         static int dev;
 713         int err;
 714         struct snd_card *card;
 715 
 716         if (pnp_device_is_isapnp(pdev))
 717                 return -ENOENT; /* we have another procedure - card */
 718         for (; dev < SNDRV_CARDS; dev++) {
 719                 if (enable[dev] && isapnp[dev])
 720                         break;
 721         }
 722         if (dev >= SNDRV_CARDS)
 723                 return -ENODEV;
 724 
 725         err = snd_opl3sa2_card_new(&pdev->dev, dev, &card);
 726         if (err < 0)
 727                 return err;
 728         if ((err = snd_opl3sa2_pnp(dev, card->private_data, pdev)) < 0) {
 729                 snd_card_free(card);
 730                 return err;
 731         }
 732         if ((err = snd_opl3sa2_probe(card, dev)) < 0) {
 733                 snd_card_free(card);
 734                 return err;
 735         }
 736         pnp_set_drvdata(pdev, card);
 737         dev++;
 738         return 0;
 739 }
 740 
 741 static void snd_opl3sa2_pnp_remove(struct pnp_dev *pdev)
 742 {
 743         snd_card_free(pnp_get_drvdata(pdev));
 744 }
 745 
 746 #ifdef CONFIG_PM
 747 static int snd_opl3sa2_pnp_suspend(struct pnp_dev *pdev, pm_message_t state)
 748 {
 749         return snd_opl3sa2_suspend(pnp_get_drvdata(pdev), state);
 750 }
 751 static int snd_opl3sa2_pnp_resume(struct pnp_dev *pdev)
 752 {
 753         return snd_opl3sa2_resume(pnp_get_drvdata(pdev));
 754 }
 755 #endif
 756 
 757 static struct pnp_driver opl3sa2_pnp_driver = {
 758         .name = "snd-opl3sa2-pnpbios",
 759         .id_table = snd_opl3sa2_pnpbiosids,
 760         .probe = snd_opl3sa2_pnp_detect,
 761         .remove = snd_opl3sa2_pnp_remove,
 762 #ifdef CONFIG_PM
 763         .suspend = snd_opl3sa2_pnp_suspend,
 764         .resume = snd_opl3sa2_pnp_resume,
 765 #endif
 766 };
 767 
 768 static int snd_opl3sa2_pnp_cdetect(struct pnp_card_link *pcard,
 769                                    const struct pnp_card_device_id *id)
 770 {
 771         static int dev;
 772         struct pnp_dev *pdev;
 773         int err;
 774         struct snd_card *card;
 775 
 776         pdev = pnp_request_card_device(pcard, id->devs[0].id, NULL);
 777         if (pdev == NULL) {
 778                 snd_printk(KERN_ERR PFX "can't get pnp device from id '%s'\n",
 779                            id->devs[0].id);
 780                 return -EBUSY;
 781         }
 782         for (; dev < SNDRV_CARDS; dev++) {
 783                 if (enable[dev] && isapnp[dev])
 784                         break;
 785         }
 786         if (dev >= SNDRV_CARDS)
 787                 return -ENODEV;
 788 
 789         err = snd_opl3sa2_card_new(&pdev->dev, dev, &card);
 790         if (err < 0)
 791                 return err;
 792         if ((err = snd_opl3sa2_pnp(dev, card->private_data, pdev)) < 0) {
 793                 snd_card_free(card);
 794                 return err;
 795         }
 796         if ((err = snd_opl3sa2_probe(card, dev)) < 0) {
 797                 snd_card_free(card);
 798                 return err;
 799         }
 800         pnp_set_card_drvdata(pcard, card);
 801         dev++;
 802         return 0;
 803 }
 804 
 805 static void snd_opl3sa2_pnp_cremove(struct pnp_card_link *pcard)
 806 {
 807         snd_card_free(pnp_get_card_drvdata(pcard));
 808         pnp_set_card_drvdata(pcard, NULL);
 809 }
 810 
 811 #ifdef CONFIG_PM
 812 static int snd_opl3sa2_pnp_csuspend(struct pnp_card_link *pcard, pm_message_t state)
 813 {
 814         return snd_opl3sa2_suspend(pnp_get_card_drvdata(pcard), state);
 815 }
 816 static int snd_opl3sa2_pnp_cresume(struct pnp_card_link *pcard)
 817 {
 818         return snd_opl3sa2_resume(pnp_get_card_drvdata(pcard));
 819 }
 820 #endif
 821 
 822 static struct pnp_card_driver opl3sa2_pnpc_driver = {
 823         .flags = PNP_DRIVER_RES_DISABLE,
 824         .name = "snd-opl3sa2-cpnp",
 825         .id_table = snd_opl3sa2_pnpids,
 826         .probe = snd_opl3sa2_pnp_cdetect,
 827         .remove = snd_opl3sa2_pnp_cremove,
 828 #ifdef CONFIG_PM
 829         .suspend = snd_opl3sa2_pnp_csuspend,
 830         .resume = snd_opl3sa2_pnp_cresume,
 831 #endif
 832 };
 833 #endif /* CONFIG_PNP */
 834 
 835 static int snd_opl3sa2_isa_match(struct device *pdev,
 836                                  unsigned int dev)
 837 {
 838         if (!enable[dev])
 839                 return 0;
 840 #ifdef CONFIG_PNP
 841         if (isapnp[dev])
 842                 return 0;
 843 #endif
 844         if (port[dev] == SNDRV_AUTO_PORT) {
 845                 snd_printk(KERN_ERR PFX "specify port\n");
 846                 return 0;
 847         }
 848         if (wss_port[dev] == SNDRV_AUTO_PORT) {
 849                 snd_printk(KERN_ERR PFX "specify wss_port\n");
 850                 return 0;
 851         }
 852         if (fm_port[dev] == SNDRV_AUTO_PORT) {
 853                 snd_printk(KERN_ERR PFX "specify fm_port\n");
 854                 return 0;
 855         }
 856         if (midi_port[dev] == SNDRV_AUTO_PORT) {
 857                 snd_printk(KERN_ERR PFX "specify midi_port\n");
 858                 return 0;
 859         }
 860         return 1;
 861 }
 862 
 863 static int snd_opl3sa2_isa_probe(struct device *pdev,
 864                                  unsigned int dev)
 865 {
 866         struct snd_card *card;
 867         int err;
 868 
 869         err = snd_opl3sa2_card_new(pdev, dev, &card);
 870         if (err < 0)
 871                 return err;
 872         if ((err = snd_opl3sa2_probe(card, dev)) < 0) {
 873                 snd_card_free(card);
 874                 return err;
 875         }
 876         dev_set_drvdata(pdev, card);
 877         return 0;
 878 }
 879 
 880 static int snd_opl3sa2_isa_remove(struct device *devptr,
 881                                   unsigned int dev)
 882 {
 883         snd_card_free(dev_get_drvdata(devptr));
 884         return 0;
 885 }
 886 
 887 #ifdef CONFIG_PM
 888 static int snd_opl3sa2_isa_suspend(struct device *dev, unsigned int n,
 889                                    pm_message_t state)
 890 {
 891         return snd_opl3sa2_suspend(dev_get_drvdata(dev), state);
 892 }
 893 
 894 static int snd_opl3sa2_isa_resume(struct device *dev, unsigned int n)
 895 {
 896         return snd_opl3sa2_resume(dev_get_drvdata(dev));
 897 }
 898 #endif
 899 
 900 #define DEV_NAME "opl3sa2"
 901 
 902 static struct isa_driver snd_opl3sa2_isa_driver = {
 903         .match          = snd_opl3sa2_isa_match,
 904         .probe          = snd_opl3sa2_isa_probe,
 905         .remove         = snd_opl3sa2_isa_remove,
 906 #ifdef CONFIG_PM
 907         .suspend        = snd_opl3sa2_isa_suspend,
 908         .resume         = snd_opl3sa2_isa_resume,
 909 #endif
 910         .driver         = {
 911                 .name   = DEV_NAME
 912         },
 913 };
 914 
 915 static int __init alsa_card_opl3sa2_init(void)
 916 {
 917         int err;
 918 
 919         err = isa_register_driver(&snd_opl3sa2_isa_driver, SNDRV_CARDS);
 920 #ifdef CONFIG_PNP
 921         if (!err)
 922                 isa_registered = 1;
 923 
 924         err = pnp_register_driver(&opl3sa2_pnp_driver);
 925         if (!err)
 926                 pnp_registered = 1;
 927 
 928         err = pnp_register_card_driver(&opl3sa2_pnpc_driver);
 929         if (!err)
 930                 pnpc_registered = 1;
 931 
 932         if (isa_registered || pnp_registered)
 933                 err = 0;
 934 #endif
 935         return err;
 936 }
 937 
 938 static void __exit alsa_card_opl3sa2_exit(void)
 939 {
 940 #ifdef CONFIG_PNP
 941         if (pnpc_registered)
 942                 pnp_unregister_card_driver(&opl3sa2_pnpc_driver);
 943         if (pnp_registered)
 944                 pnp_unregister_driver(&opl3sa2_pnp_driver);
 945         if (isa_registered)
 946 #endif
 947                 isa_unregister_driver(&snd_opl3sa2_isa_driver);
 948 }
 949 
 950 module_init(alsa_card_opl3sa2_init)
 951 module_exit(alsa_card_opl3sa2_exit)

/* [<][>][^][v][top][bottom][index][help] */