1 // SPDX-License-Identifier: GPL-2.0-or-later 2 /* 3 * card-als4000.c - driver for Avance Logic ALS4000 based soundcards. 4 * Copyright (C) 2000 by Bart Hartgers <bart@etpmod.phys.tue.nl>, 5 * Jaroslav Kysela <perex@perex.cz> 6 * Copyright (C) 2002, 2008 by Andreas Mohr <hw7oshyuv3001@sneakemail.com> 7 * 8 * Framework borrowed from Massimo Piccioni's card-als100.c. 9 * 10 * NOTES 11 * 12 * Since Avance does not provide any meaningful documentation, and I 13 * bought an ALS4000 based soundcard, I was forced to base this driver 14 * on reverse engineering. 15 * 16 * Note: this is no longer true (thank you!): 17 * pretty verbose chip docu (ALS4000a.PDF) can be found on the ALSA web site. 18 * Page numbers stated anywhere below with the "SPECS_PAGE:" tag 19 * refer to: ALS4000a.PDF specs Ver 1.0, May 28th, 1998. 20 * 21 * The ALS4000 seems to be the PCI-cousin of the ALS100. It contains an 22 * ALS100-like SB DSP/mixer, an OPL3 synth, a MPU401 and a gameport 23 * interface. These subsystems can be mapped into ISA io-port space, 24 * using the PCI-interface. In addition, the PCI-bit provides DMA and IRQ 25 * services to the subsystems. 26 * 27 * While ALS4000 is very similar to a SoundBlaster, the differences in 28 * DMA and capturing require more changes to the SoundBlaster than 29 * desirable, so I made this separate driver. 30 * 31 * The ALS4000 can do real full duplex playback/capture. 32 * 33 * FMDAC: 34 * - 0x4f -> port 0x14 35 * - port 0x15 |= 1 36 * 37 * Enable/disable 3D sound: 38 * - 0x50 -> port 0x14 39 * - change bit 6 (0x40) of port 0x15 40 * 41 * Set QSound: 42 * - 0xdb -> port 0x14 43 * - set port 0x15: 44 * 0x3e (mode 3), 0x3c (mode 2), 0x3a (mode 1), 0x38 (mode 0) 45 * 46 * Set KSound: 47 * - value -> some port 0x0c0d 48 * 49 * ToDo: 50 * - by default, don't enable legacy game and use PCI game I/O 51 * - power management? (card can do voice wakeup according to datasheet!!) 52 */ 53 54 #include <linux/io.h> 55 #include <linux/init.h> 56 #include <linux/pci.h> 57 #include <linux/gameport.h> 58 #include <linux/module.h> 59 #include <linux/dma-mapping.h> 60 #include <sound/core.h> 61 #include <sound/pcm.h> 62 #include <sound/rawmidi.h> 63 #include <sound/mpu401.h> 64 #include <sound/opl3.h> 65 #include <sound/sb.h> 66 #include <sound/initval.h> 67 68 MODULE_AUTHOR("Bart Hartgers <bart@etpmod.phys.tue.nl>, Andreas Mohr"); 69 MODULE_DESCRIPTION("Avance Logic ALS4000"); 70 MODULE_LICENSE("GPL"); 71 MODULE_SUPPORTED_DEVICE("{{Avance Logic,ALS4000}}"); 72 73 #if IS_REACHABLE(CONFIG_GAMEPORT) 74 #define SUPPORT_JOYSTICK 1 75 #endif 76 77 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-MAX */ 78 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* ID for this card */ 79 static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP; /* Enable this card */ 80 #ifdef SUPPORT_JOYSTICK 81 static int joystick_port[SNDRV_CARDS]; 82 #endif 83 84 module_param_array(index, int, NULL, 0444); 85 MODULE_PARM_DESC(index, "Index value for ALS4000 soundcard."); 86 module_param_array(id, charp, NULL, 0444); 87 MODULE_PARM_DESC(id, "ID string for ALS4000 soundcard."); 88 module_param_array(enable, bool, NULL, 0444); 89 MODULE_PARM_DESC(enable, "Enable ALS4000 soundcard."); 90 #ifdef SUPPORT_JOYSTICK 91 module_param_hw_array(joystick_port, int, ioport, NULL, 0444); 92 MODULE_PARM_DESC(joystick_port, "Joystick port address for ALS4000 soundcard. (0 = disabled)"); 93 #endif 94 95 struct snd_card_als4000 { 96 /* most frequent access first */ 97 unsigned long iobase; 98 struct pci_dev *pci; 99 struct snd_sb *chip; 100 #ifdef SUPPORT_JOYSTICK 101 struct gameport *gameport; 102 #endif 103 }; 104 105 static const struct pci_device_id snd_als4000_ids[] = { 106 { 0x4005, 0x4000, PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0, }, /* ALS4000 */ 107 { 0, } 108 }; 109 110 MODULE_DEVICE_TABLE(pci, snd_als4000_ids); 111 112 enum als4k_iobase_t { 113 /* IOx: B == Byte, W = Word, D = DWord; SPECS_PAGE: 37 */ 114 ALS4K_IOD_00_AC97_ACCESS = 0x00, 115 ALS4K_IOW_04_AC97_READ = 0x04, 116 ALS4K_IOB_06_AC97_STATUS = 0x06, 117 ALS4K_IOB_07_IRQSTATUS = 0x07, 118 ALS4K_IOD_08_GCR_DATA = 0x08, 119 ALS4K_IOB_0C_GCR_INDEX = 0x0c, 120 ALS4K_IOB_0E_IRQTYPE_SB_CR1E_MPU = 0x0e, 121 ALS4K_IOB_10_ADLIB_ADDR0 = 0x10, 122 ALS4K_IOB_11_ADLIB_ADDR1 = 0x11, 123 ALS4K_IOB_12_ADLIB_ADDR2 = 0x12, 124 ALS4K_IOB_13_ADLIB_ADDR3 = 0x13, 125 ALS4K_IOB_14_MIXER_INDEX = 0x14, 126 ALS4K_IOB_15_MIXER_DATA = 0x15, 127 ALS4K_IOB_16_ESP_RESET = 0x16, 128 ALS4K_IOB_16_ACK_FOR_CR1E = 0x16, /* 2nd function */ 129 ALS4K_IOB_18_OPL_ADDR0 = 0x18, 130 ALS4K_IOB_19_OPL_ADDR1 = 0x19, 131 ALS4K_IOB_1A_ESP_RD_DATA = 0x1a, 132 ALS4K_IOB_1C_ESP_CMD_DATA = 0x1c, 133 ALS4K_IOB_1C_ESP_WR_STATUS = 0x1c, /* 2nd function */ 134 ALS4K_IOB_1E_ESP_RD_STATUS8 = 0x1e, 135 ALS4K_IOB_1F_ESP_RD_STATUS16 = 0x1f, 136 ALS4K_IOB_20_ESP_GAMEPORT_200 = 0x20, 137 ALS4K_IOB_21_ESP_GAMEPORT_201 = 0x21, 138 ALS4K_IOB_30_MIDI_DATA = 0x30, 139 ALS4K_IOB_31_MIDI_STATUS = 0x31, 140 ALS4K_IOB_31_MIDI_COMMAND = 0x31, /* 2nd function */ 141 }; 142 143 enum als4k_iobase_0e_t { 144 ALS4K_IOB_0E_MPU_IRQ = 0x10, 145 ALS4K_IOB_0E_CR1E_IRQ = 0x40, 146 ALS4K_IOB_0E_SB_DMA_IRQ = 0x80, 147 }; 148 149 enum als4k_gcr_t { /* all registers 32bit wide; SPECS_PAGE: 38 to 42 */ 150 ALS4K_GCR8C_MISC_CTRL = 0x8c, 151 ALS4K_GCR90_TEST_MODE_REG = 0x90, 152 ALS4K_GCR91_DMA0_ADDR = 0x91, 153 ALS4K_GCR92_DMA0_MODE_COUNT = 0x92, 154 ALS4K_GCR93_DMA1_ADDR = 0x93, 155 ALS4K_GCR94_DMA1_MODE_COUNT = 0x94, 156 ALS4K_GCR95_DMA3_ADDR = 0x95, 157 ALS4K_GCR96_DMA3_MODE_COUNT = 0x96, 158 ALS4K_GCR99_DMA_EMULATION_CTRL = 0x99, 159 ALS4K_GCRA0_FIFO1_CURRENT_ADDR = 0xa0, 160 ALS4K_GCRA1_FIFO1_STATUS_BYTECOUNT = 0xa1, 161 ALS4K_GCRA2_FIFO2_PCIADDR = 0xa2, 162 ALS4K_GCRA3_FIFO2_COUNT = 0xa3, 163 ALS4K_GCRA4_FIFO2_CURRENT_ADDR = 0xa4, 164 ALS4K_GCRA5_FIFO1_STATUS_BYTECOUNT = 0xa5, 165 ALS4K_GCRA6_PM_CTRL = 0xa6, 166 ALS4K_GCRA7_PCI_ACCESS_STORAGE = 0xa7, 167 ALS4K_GCRA8_LEGACY_CFG1 = 0xa8, 168 ALS4K_GCRA9_LEGACY_CFG2 = 0xa9, 169 ALS4K_GCRFF_DUMMY_SCRATCH = 0xff, 170 }; 171 172 enum als4k_gcr8c_t { 173 ALS4K_GCR8C_IRQ_MASK_CTRL_ENABLE = 0x8000, 174 ALS4K_GCR8C_CHIP_REV_MASK = 0xf0000 175 }; 176 177 static inline void snd_als4k_iobase_writeb(unsigned long iobase, 178 enum als4k_iobase_t reg, 179 u8 val) 180 { 181 outb(val, iobase + reg); 182 } 183 184 static inline void snd_als4k_iobase_writel(unsigned long iobase, 185 enum als4k_iobase_t reg, 186 u32 val) 187 { 188 outl(val, iobase + reg); 189 } 190 191 static inline u8 snd_als4k_iobase_readb(unsigned long iobase, 192 enum als4k_iobase_t reg) 193 { 194 return inb(iobase + reg); 195 } 196 197 static inline u32 snd_als4k_iobase_readl(unsigned long iobase, 198 enum als4k_iobase_t reg) 199 { 200 return inl(iobase + reg); 201 } 202 203 static inline void snd_als4k_gcr_write_addr(unsigned long iobase, 204 enum als4k_gcr_t reg, 205 u32 val) 206 { 207 snd_als4k_iobase_writeb(iobase, ALS4K_IOB_0C_GCR_INDEX, reg); 208 snd_als4k_iobase_writel(iobase, ALS4K_IOD_08_GCR_DATA, val); 209 } 210 211 static inline void snd_als4k_gcr_write(struct snd_sb *sb, 212 enum als4k_gcr_t reg, 213 u32 val) 214 { 215 snd_als4k_gcr_write_addr(sb->alt_port, reg, val); 216 } 217 218 static inline u32 snd_als4k_gcr_read_addr(unsigned long iobase, 219 enum als4k_gcr_t reg) 220 { 221 /* SPECS_PAGE: 37/38 */ 222 snd_als4k_iobase_writeb(iobase, ALS4K_IOB_0C_GCR_INDEX, reg); 223 return snd_als4k_iobase_readl(iobase, ALS4K_IOD_08_GCR_DATA); 224 } 225 226 static inline u32 snd_als4k_gcr_read(struct snd_sb *sb, enum als4k_gcr_t reg) 227 { 228 return snd_als4k_gcr_read_addr(sb->alt_port, reg); 229 } 230 231 enum als4k_cr_t { /* all registers 8bit wide; SPECS_PAGE: 20 to 23 */ 232 ALS4K_CR0_SB_CONFIG = 0x00, 233 ALS4K_CR2_MISC_CONTROL = 0x02, 234 ALS4K_CR3_CONFIGURATION = 0x03, 235 ALS4K_CR17_FIFO_STATUS = 0x17, 236 ALS4K_CR18_ESP_MAJOR_VERSION = 0x18, 237 ALS4K_CR19_ESP_MINOR_VERSION = 0x19, 238 ALS4K_CR1A_MPU401_UART_MODE_CONTROL = 0x1a, 239 ALS4K_CR1C_FIFO2_BLOCK_LENGTH_LO = 0x1c, 240 ALS4K_CR1D_FIFO2_BLOCK_LENGTH_HI = 0x1d, 241 ALS4K_CR1E_FIFO2_CONTROL = 0x1e, /* secondary PCM FIFO (recording) */ 242 ALS4K_CR3A_MISC_CONTROL = 0x3a, 243 ALS4K_CR3B_CRC32_BYTE0 = 0x3b, /* for testing, activate via CR3A */ 244 ALS4K_CR3C_CRC32_BYTE1 = 0x3c, 245 ALS4K_CR3D_CRC32_BYTE2 = 0x3d, 246 ALS4K_CR3E_CRC32_BYTE3 = 0x3e, 247 }; 248 249 enum als4k_cr0_t { 250 ALS4K_CR0_DMA_CONTIN_MODE_CTRL = 0x02, /* IRQ/FIFO controlled for 0/1 */ 251 ALS4K_CR0_DMA_90H_MODE_CTRL = 0x04, /* IRQ/FIFO controlled for 0/1 */ 252 ALS4K_CR0_MX80_81_REG_WRITE_ENABLE = 0x80, 253 }; 254 255 static inline void snd_als4_cr_write(struct snd_sb *chip, 256 enum als4k_cr_t reg, 257 u8 data) 258 { 259 /* Control Register is reg | 0xc0 (bit 7, 6 set) on sbmixer_index 260 * NOTE: assumes chip->mixer_lock to be locked externally already! 261 * SPECS_PAGE: 6 */ 262 snd_sbmixer_write(chip, reg | 0xc0, data); 263 } 264 265 static inline u8 snd_als4_cr_read(struct snd_sb *chip, 266 enum als4k_cr_t reg) 267 { 268 /* NOTE: assumes chip->mixer_lock to be locked externally already! */ 269 return snd_sbmixer_read(chip, reg | 0xc0); 270 } 271 272 273 274 static void snd_als4000_set_rate(struct snd_sb *chip, unsigned int rate) 275 { 276 if (!(chip->mode & SB_RATE_LOCK)) { 277 snd_sbdsp_command(chip, SB_DSP_SAMPLE_RATE_OUT); 278 snd_sbdsp_command(chip, rate>>8); 279 snd_sbdsp_command(chip, rate); 280 } 281 } 282 283 static inline void snd_als4000_set_capture_dma(struct snd_sb *chip, 284 dma_addr_t addr, unsigned size) 285 { 286 /* SPECS_PAGE: 40 */ 287 snd_als4k_gcr_write(chip, ALS4K_GCRA2_FIFO2_PCIADDR, addr); 288 snd_als4k_gcr_write(chip, ALS4K_GCRA3_FIFO2_COUNT, (size-1)); 289 } 290 291 static inline void snd_als4000_set_playback_dma(struct snd_sb *chip, 292 dma_addr_t addr, 293 unsigned size) 294 { 295 /* SPECS_PAGE: 38 */ 296 snd_als4k_gcr_write(chip, ALS4K_GCR91_DMA0_ADDR, addr); 297 snd_als4k_gcr_write(chip, ALS4K_GCR92_DMA0_MODE_COUNT, 298 (size-1)|0x180000); 299 } 300 301 #define ALS4000_FORMAT_SIGNED (1<<0) 302 #define ALS4000_FORMAT_16BIT (1<<1) 303 #define ALS4000_FORMAT_STEREO (1<<2) 304 305 static int snd_als4000_get_format(struct snd_pcm_runtime *runtime) 306 { 307 int result; 308 309 result = 0; 310 if (snd_pcm_format_signed(runtime->format)) 311 result |= ALS4000_FORMAT_SIGNED; 312 if (snd_pcm_format_physical_width(runtime->format) == 16) 313 result |= ALS4000_FORMAT_16BIT; 314 if (runtime->channels > 1) 315 result |= ALS4000_FORMAT_STEREO; 316 return result; 317 } 318 319 /* structure for setting up playback */ 320 static const struct { 321 unsigned char dsp_cmd, dma_on, dma_off, format; 322 } playback_cmd_vals[]={ 323 /* ALS4000_FORMAT_U8_MONO */ 324 { SB_DSP4_OUT8_AI, SB_DSP_DMA8_ON, SB_DSP_DMA8_OFF, SB_DSP4_MODE_UNS_MONO }, 325 /* ALS4000_FORMAT_S8_MONO */ 326 { SB_DSP4_OUT8_AI, SB_DSP_DMA8_ON, SB_DSP_DMA8_OFF, SB_DSP4_MODE_SIGN_MONO }, 327 /* ALS4000_FORMAT_U16L_MONO */ 328 { SB_DSP4_OUT16_AI, SB_DSP_DMA16_ON, SB_DSP_DMA16_OFF, SB_DSP4_MODE_UNS_MONO }, 329 /* ALS4000_FORMAT_S16L_MONO */ 330 { SB_DSP4_OUT16_AI, SB_DSP_DMA16_ON, SB_DSP_DMA16_OFF, SB_DSP4_MODE_SIGN_MONO }, 331 /* ALS4000_FORMAT_U8_STEREO */ 332 { SB_DSP4_OUT8_AI, SB_DSP_DMA8_ON, SB_DSP_DMA8_OFF, SB_DSP4_MODE_UNS_STEREO }, 333 /* ALS4000_FORMAT_S8_STEREO */ 334 { SB_DSP4_OUT8_AI, SB_DSP_DMA8_ON, SB_DSP_DMA8_OFF, SB_DSP4_MODE_SIGN_STEREO }, 335 /* ALS4000_FORMAT_U16L_STEREO */ 336 { SB_DSP4_OUT16_AI, SB_DSP_DMA16_ON, SB_DSP_DMA16_OFF, SB_DSP4_MODE_UNS_STEREO }, 337 /* ALS4000_FORMAT_S16L_STEREO */ 338 { SB_DSP4_OUT16_AI, SB_DSP_DMA16_ON, SB_DSP_DMA16_OFF, SB_DSP4_MODE_SIGN_STEREO }, 339 }; 340 #define playback_cmd(chip) (playback_cmd_vals[(chip)->playback_format]) 341 342 /* structure for setting up capture */ 343 enum { CMD_WIDTH8=0x04, CMD_SIGNED=0x10, CMD_MONO=0x80, CMD_STEREO=0xA0 }; 344 static const unsigned char capture_cmd_vals[]= 345 { 346 CMD_WIDTH8|CMD_MONO, /* ALS4000_FORMAT_U8_MONO */ 347 CMD_WIDTH8|CMD_SIGNED|CMD_MONO, /* ALS4000_FORMAT_S8_MONO */ 348 CMD_MONO, /* ALS4000_FORMAT_U16L_MONO */ 349 CMD_SIGNED|CMD_MONO, /* ALS4000_FORMAT_S16L_MONO */ 350 CMD_WIDTH8|CMD_STEREO, /* ALS4000_FORMAT_U8_STEREO */ 351 CMD_WIDTH8|CMD_SIGNED|CMD_STEREO, /* ALS4000_FORMAT_S8_STEREO */ 352 CMD_STEREO, /* ALS4000_FORMAT_U16L_STEREO */ 353 CMD_SIGNED|CMD_STEREO, /* ALS4000_FORMAT_S16L_STEREO */ 354 }; 355 #define capture_cmd(chip) (capture_cmd_vals[(chip)->capture_format]) 356 357 static int snd_als4000_hw_params(struct snd_pcm_substream *substream, 358 struct snd_pcm_hw_params *hw_params) 359 { 360 return snd_pcm_lib_malloc_pages(substream, params_buffer_bytes(hw_params)); 361 } 362 363 static int snd_als4000_hw_free(struct snd_pcm_substream *substream) 364 { 365 snd_pcm_lib_free_pages(substream); 366 return 0; 367 } 368 369 static int snd_als4000_capture_prepare(struct snd_pcm_substream *substream) 370 { 371 struct snd_sb *chip = snd_pcm_substream_chip(substream); 372 struct snd_pcm_runtime *runtime = substream->runtime; 373 unsigned long size; 374 unsigned count; 375 376 chip->capture_format = snd_als4000_get_format(runtime); 377 378 size = snd_pcm_lib_buffer_bytes(substream); 379 count = snd_pcm_lib_period_bytes(substream); 380 381 if (chip->capture_format & ALS4000_FORMAT_16BIT) 382 count >>= 1; 383 count--; 384 385 spin_lock_irq(&chip->reg_lock); 386 snd_als4000_set_rate(chip, runtime->rate); 387 snd_als4000_set_capture_dma(chip, runtime->dma_addr, size); 388 spin_unlock_irq(&chip->reg_lock); 389 spin_lock_irq(&chip->mixer_lock); 390 snd_als4_cr_write(chip, ALS4K_CR1C_FIFO2_BLOCK_LENGTH_LO, count & 0xff); 391 snd_als4_cr_write(chip, ALS4K_CR1D_FIFO2_BLOCK_LENGTH_HI, count >> 8); 392 spin_unlock_irq(&chip->mixer_lock); 393 return 0; 394 } 395 396 static int snd_als4000_playback_prepare(struct snd_pcm_substream *substream) 397 { 398 struct snd_sb *chip = snd_pcm_substream_chip(substream); 399 struct snd_pcm_runtime *runtime = substream->runtime; 400 unsigned long size; 401 unsigned count; 402 403 chip->playback_format = snd_als4000_get_format(runtime); 404 405 size = snd_pcm_lib_buffer_bytes(substream); 406 count = snd_pcm_lib_period_bytes(substream); 407 408 if (chip->playback_format & ALS4000_FORMAT_16BIT) 409 count >>= 1; 410 count--; 411 412 /* FIXME: from second playback on, there's a lot more clicks and pops 413 * involved here than on first playback. Fiddling with 414 * tons of different settings didn't help (DMA, speaker on/off, 415 * reordering, ...). Something seems to get enabled on playback 416 * that I haven't found out how to disable again, which then causes 417 * the switching pops to reach the speakers the next time here. */ 418 spin_lock_irq(&chip->reg_lock); 419 snd_als4000_set_rate(chip, runtime->rate); 420 snd_als4000_set_playback_dma(chip, runtime->dma_addr, size); 421 422 /* SPEAKER_ON not needed, since dma_on seems to also enable speaker */ 423 /* snd_sbdsp_command(chip, SB_DSP_SPEAKER_ON); */ 424 snd_sbdsp_command(chip, playback_cmd(chip).dsp_cmd); 425 snd_sbdsp_command(chip, playback_cmd(chip).format); 426 snd_sbdsp_command(chip, count & 0xff); 427 snd_sbdsp_command(chip, count >> 8); 428 snd_sbdsp_command(chip, playback_cmd(chip).dma_off); 429 spin_unlock_irq(&chip->reg_lock); 430 431 return 0; 432 } 433 434 static int snd_als4000_capture_trigger(struct snd_pcm_substream *substream, int cmd) 435 { 436 struct snd_sb *chip = snd_pcm_substream_chip(substream); 437 int result = 0; 438 439 /* FIXME race condition in here!!! 440 chip->mode non-atomic update gets consistently protected 441 by reg_lock always, _except_ for this place!! 442 Probably need to take reg_lock as outer (or inner??) lock, too. 443 (or serialize both lock operations? probably not, though... - racy?) 444 */ 445 spin_lock(&chip->mixer_lock); 446 switch (cmd) { 447 case SNDRV_PCM_TRIGGER_START: 448 case SNDRV_PCM_TRIGGER_RESUME: 449 chip->mode |= SB_RATE_LOCK_CAPTURE; 450 snd_als4_cr_write(chip, ALS4K_CR1E_FIFO2_CONTROL, 451 capture_cmd(chip)); 452 break; 453 case SNDRV_PCM_TRIGGER_STOP: 454 case SNDRV_PCM_TRIGGER_SUSPEND: 455 chip->mode &= ~SB_RATE_LOCK_CAPTURE; 456 snd_als4_cr_write(chip, ALS4K_CR1E_FIFO2_CONTROL, 457 capture_cmd(chip)); 458 break; 459 default: 460 result = -EINVAL; 461 break; 462 } 463 spin_unlock(&chip->mixer_lock); 464 return result; 465 } 466 467 static int snd_als4000_playback_trigger(struct snd_pcm_substream *substream, int cmd) 468 { 469 struct snd_sb *chip = snd_pcm_substream_chip(substream); 470 int result = 0; 471 472 spin_lock(&chip->reg_lock); 473 switch (cmd) { 474 case SNDRV_PCM_TRIGGER_START: 475 case SNDRV_PCM_TRIGGER_RESUME: 476 chip->mode |= SB_RATE_LOCK_PLAYBACK; 477 snd_sbdsp_command(chip, playback_cmd(chip).dma_on); 478 break; 479 case SNDRV_PCM_TRIGGER_STOP: 480 case SNDRV_PCM_TRIGGER_SUSPEND: 481 snd_sbdsp_command(chip, playback_cmd(chip).dma_off); 482 chip->mode &= ~SB_RATE_LOCK_PLAYBACK; 483 break; 484 default: 485 result = -EINVAL; 486 break; 487 } 488 spin_unlock(&chip->reg_lock); 489 return result; 490 } 491 492 static snd_pcm_uframes_t snd_als4000_capture_pointer(struct snd_pcm_substream *substream) 493 { 494 struct snd_sb *chip = snd_pcm_substream_chip(substream); 495 unsigned int result; 496 497 spin_lock(&chip->reg_lock); 498 result = snd_als4k_gcr_read(chip, ALS4K_GCRA4_FIFO2_CURRENT_ADDR); 499 spin_unlock(&chip->reg_lock); 500 result &= 0xffff; 501 return bytes_to_frames( substream->runtime, result ); 502 } 503 504 static snd_pcm_uframes_t snd_als4000_playback_pointer(struct snd_pcm_substream *substream) 505 { 506 struct snd_sb *chip = snd_pcm_substream_chip(substream); 507 unsigned result; 508 509 spin_lock(&chip->reg_lock); 510 result = snd_als4k_gcr_read(chip, ALS4K_GCRA0_FIFO1_CURRENT_ADDR); 511 spin_unlock(&chip->reg_lock); 512 result &= 0xffff; 513 return bytes_to_frames( substream->runtime, result ); 514 } 515 516 /* FIXME: this IRQ routine doesn't really support IRQ sharing (we always 517 * return IRQ_HANDLED no matter whether we actually had an IRQ flag or not). 518 * ALS4000a.PDF writes that while ACKing IRQ in PCI block will *not* ACK 519 * the IRQ in the SB core, ACKing IRQ in SB block *will* ACK the PCI IRQ 520 * register (alt_port + ALS4K_IOB_0E_IRQTYPE_SB_CR1E_MPU). Probably something 521 * could be optimized here to query/write one register only... 522 * And even if both registers need to be queried, then there's still the 523 * question of whether it's actually correct to ACK PCI IRQ before reading 524 * SB IRQ like we do now, since ALS4000a.PDF mentions that PCI IRQ will *clear* 525 * SB IRQ status. 526 * (hmm, SPECS_PAGE: 38 mentions it the other way around!) 527 * And do we *really* need the lock here for *reading* SB_DSP4_IRQSTATUS?? 528 * */ 529 static irqreturn_t snd_als4000_interrupt(int irq, void *dev_id) 530 { 531 struct snd_sb *chip = dev_id; 532 unsigned pci_irqstatus; 533 unsigned sb_irqstatus; 534 535 /* find out which bit of the ALS4000 PCI block produced the interrupt, 536 SPECS_PAGE: 38, 5 */ 537 pci_irqstatus = snd_als4k_iobase_readb(chip->alt_port, 538 ALS4K_IOB_0E_IRQTYPE_SB_CR1E_MPU); 539 if ((pci_irqstatus & ALS4K_IOB_0E_SB_DMA_IRQ) 540 && (chip->playback_substream)) /* playback */ 541 snd_pcm_period_elapsed(chip->playback_substream); 542 if ((pci_irqstatus & ALS4K_IOB_0E_CR1E_IRQ) 543 && (chip->capture_substream)) /* capturing */ 544 snd_pcm_period_elapsed(chip->capture_substream); 545 if ((pci_irqstatus & ALS4K_IOB_0E_MPU_IRQ) 546 && (chip->rmidi)) /* MPU401 interrupt */ 547 snd_mpu401_uart_interrupt(irq, chip->rmidi->private_data); 548 /* ACK the PCI block IRQ */ 549 snd_als4k_iobase_writeb(chip->alt_port, 550 ALS4K_IOB_0E_IRQTYPE_SB_CR1E_MPU, pci_irqstatus); 551 552 spin_lock(&chip->mixer_lock); 553 /* SPECS_PAGE: 20 */ 554 sb_irqstatus = snd_sbmixer_read(chip, SB_DSP4_IRQSTATUS); 555 spin_unlock(&chip->mixer_lock); 556 557 if (sb_irqstatus & SB_IRQTYPE_8BIT) 558 snd_sb_ack_8bit(chip); 559 if (sb_irqstatus & SB_IRQTYPE_16BIT) 560 snd_sb_ack_16bit(chip); 561 if (sb_irqstatus & SB_IRQTYPE_MPUIN) 562 inb(chip->mpu_port); 563 if (sb_irqstatus & ALS4K_IRQTYPE_CR1E_DMA) 564 snd_als4k_iobase_readb(chip->alt_port, 565 ALS4K_IOB_16_ACK_FOR_CR1E); 566 567 /* dev_dbg(chip->card->dev, "als4000: irq 0x%04x 0x%04x\n", 568 pci_irqstatus, sb_irqstatus); */ 569 570 /* only ack the things we actually handled above */ 571 return IRQ_RETVAL( 572 (pci_irqstatus & (ALS4K_IOB_0E_SB_DMA_IRQ|ALS4K_IOB_0E_CR1E_IRQ| 573 ALS4K_IOB_0E_MPU_IRQ)) 574 || (sb_irqstatus & (SB_IRQTYPE_8BIT|SB_IRQTYPE_16BIT| 575 SB_IRQTYPE_MPUIN|ALS4K_IRQTYPE_CR1E_DMA)) 576 ); 577 } 578 579 /*****************************************************************/ 580 581 static const struct snd_pcm_hardware snd_als4000_playback = 582 { 583 .info = (SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_INTERLEAVED | 584 SNDRV_PCM_INFO_MMAP_VALID), 585 .formats = SNDRV_PCM_FMTBIT_S8 | SNDRV_PCM_FMTBIT_U8 | 586 SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_U16_LE, /* formats */ 587 .rates = SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_8000_48000, 588 .rate_min = 4000, 589 .rate_max = 48000, 590 .channels_min = 1, 591 .channels_max = 2, 592 .buffer_bytes_max = 65536, 593 .period_bytes_min = 64, 594 .period_bytes_max = 65536, 595 .periods_min = 1, 596 .periods_max = 1024, 597 .fifo_size = 0 598 }; 599 600 static const struct snd_pcm_hardware snd_als4000_capture = 601 { 602 .info = (SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_INTERLEAVED | 603 SNDRV_PCM_INFO_MMAP_VALID), 604 .formats = SNDRV_PCM_FMTBIT_S8 | SNDRV_PCM_FMTBIT_U8 | 605 SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_U16_LE, /* formats */ 606 .rates = SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_8000_48000, 607 .rate_min = 4000, 608 .rate_max = 48000, 609 .channels_min = 1, 610 .channels_max = 2, 611 .buffer_bytes_max = 65536, 612 .period_bytes_min = 64, 613 .period_bytes_max = 65536, 614 .periods_min = 1, 615 .periods_max = 1024, 616 .fifo_size = 0 617 }; 618 619 /*****************************************************************/ 620 621 static int snd_als4000_playback_open(struct snd_pcm_substream *substream) 622 { 623 struct snd_sb *chip = snd_pcm_substream_chip(substream); 624 struct snd_pcm_runtime *runtime = substream->runtime; 625 626 chip->playback_substream = substream; 627 runtime->hw = snd_als4000_playback; 628 return 0; 629 } 630 631 static int snd_als4000_playback_close(struct snd_pcm_substream *substream) 632 { 633 struct snd_sb *chip = snd_pcm_substream_chip(substream); 634 635 chip->playback_substream = NULL; 636 snd_pcm_lib_free_pages(substream); 637 return 0; 638 } 639 640 static int snd_als4000_capture_open(struct snd_pcm_substream *substream) 641 { 642 struct snd_sb *chip = snd_pcm_substream_chip(substream); 643 struct snd_pcm_runtime *runtime = substream->runtime; 644 645 chip->capture_substream = substream; 646 runtime->hw = snd_als4000_capture; 647 return 0; 648 } 649 650 static int snd_als4000_capture_close(struct snd_pcm_substream *substream) 651 { 652 struct snd_sb *chip = snd_pcm_substream_chip(substream); 653 654 chip->capture_substream = NULL; 655 snd_pcm_lib_free_pages(substream); 656 return 0; 657 } 658 659 /******************************************************************/ 660 661 static const struct snd_pcm_ops snd_als4000_playback_ops = { 662 .open = snd_als4000_playback_open, 663 .close = snd_als4000_playback_close, 664 .ioctl = snd_pcm_lib_ioctl, 665 .hw_params = snd_als4000_hw_params, 666 .hw_free = snd_als4000_hw_free, 667 .prepare = snd_als4000_playback_prepare, 668 .trigger = snd_als4000_playback_trigger, 669 .pointer = snd_als4000_playback_pointer 670 }; 671 672 static const struct snd_pcm_ops snd_als4000_capture_ops = { 673 .open = snd_als4000_capture_open, 674 .close = snd_als4000_capture_close, 675 .ioctl = snd_pcm_lib_ioctl, 676 .hw_params = snd_als4000_hw_params, 677 .hw_free = snd_als4000_hw_free, 678 .prepare = snd_als4000_capture_prepare, 679 .trigger = snd_als4000_capture_trigger, 680 .pointer = snd_als4000_capture_pointer 681 }; 682 683 static int snd_als4000_pcm(struct snd_sb *chip, int device) 684 { 685 struct snd_pcm *pcm; 686 int err; 687 688 err = snd_pcm_new(chip->card, "ALS4000 DSP", device, 1, 1, &pcm); 689 if (err < 0) 690 return err; 691 pcm->private_data = chip; 692 pcm->info_flags = SNDRV_PCM_INFO_JOINT_DUPLEX; 693 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, &snd_als4000_playback_ops); 694 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &snd_als4000_capture_ops); 695 696 snd_pcm_lib_preallocate_pages_for_all(pcm, SNDRV_DMA_TYPE_DEV, snd_dma_pci_data(chip->pci), 697 64*1024, 64*1024); 698 699 chip->pcm = pcm; 700 701 return 0; 702 } 703 704 /******************************************************************/ 705 706 static void snd_als4000_set_addr(unsigned long iobase, 707 unsigned int sb_io, 708 unsigned int mpu_io, 709 unsigned int opl_io, 710 unsigned int game_io) 711 { 712 u32 cfg1 = 0; 713 u32 cfg2 = 0; 714 715 if (mpu_io > 0) 716 cfg2 |= (mpu_io | 1) << 16; 717 if (sb_io > 0) 718 cfg2 |= (sb_io | 1); 719 if (game_io > 0) 720 cfg1 |= (game_io | 1) << 16; 721 if (opl_io > 0) 722 cfg1 |= (opl_io | 1); 723 snd_als4k_gcr_write_addr(iobase, ALS4K_GCRA8_LEGACY_CFG1, cfg1); 724 snd_als4k_gcr_write_addr(iobase, ALS4K_GCRA9_LEGACY_CFG2, cfg2); 725 } 726 727 static void snd_als4000_configure(struct snd_sb *chip) 728 { 729 u8 tmp; 730 int i; 731 732 /* do some more configuration */ 733 spin_lock_irq(&chip->mixer_lock); 734 tmp = snd_als4_cr_read(chip, ALS4K_CR0_SB_CONFIG); 735 snd_als4_cr_write(chip, ALS4K_CR0_SB_CONFIG, 736 tmp|ALS4K_CR0_MX80_81_REG_WRITE_ENABLE); 737 /* always select DMA channel 0, since we do not actually use DMA 738 * SPECS_PAGE: 19/20 */ 739 snd_sbmixer_write(chip, SB_DSP4_DMASETUP, SB_DMASETUP_DMA0); 740 snd_als4_cr_write(chip, ALS4K_CR0_SB_CONFIG, 741 tmp & ~ALS4K_CR0_MX80_81_REG_WRITE_ENABLE); 742 spin_unlock_irq(&chip->mixer_lock); 743 744 spin_lock_irq(&chip->reg_lock); 745 /* enable interrupts */ 746 snd_als4k_gcr_write(chip, ALS4K_GCR8C_MISC_CTRL, 747 ALS4K_GCR8C_IRQ_MASK_CTRL_ENABLE); 748 749 /* SPECS_PAGE: 39 */ 750 for (i = ALS4K_GCR91_DMA0_ADDR; i <= ALS4K_GCR96_DMA3_MODE_COUNT; ++i) 751 snd_als4k_gcr_write(chip, i, 0); 752 /* enable burst mode to prevent dropouts during high PCI bus usage */ 753 snd_als4k_gcr_write(chip, ALS4K_GCR99_DMA_EMULATION_CTRL, 754 (snd_als4k_gcr_read(chip, ALS4K_GCR99_DMA_EMULATION_CTRL) & ~0x07) | 0x04); 755 spin_unlock_irq(&chip->reg_lock); 756 } 757 758 #ifdef SUPPORT_JOYSTICK 759 static int snd_als4000_create_gameport(struct snd_card_als4000 *acard, int dev) 760 { 761 struct gameport *gp; 762 struct resource *r; 763 int io_port; 764 765 if (joystick_port[dev] == 0) 766 return -ENODEV; 767 768 if (joystick_port[dev] == 1) { /* auto-detect */ 769 for (io_port = 0x200; io_port <= 0x218; io_port += 8) { 770 r = request_region(io_port, 8, "ALS4000 gameport"); 771 if (r) 772 break; 773 } 774 } else { 775 io_port = joystick_port[dev]; 776 r = request_region(io_port, 8, "ALS4000 gameport"); 777 } 778 779 if (!r) { 780 dev_warn(&acard->pci->dev, "cannot reserve joystick ports\n"); 781 return -EBUSY; 782 } 783 784 acard->gameport = gp = gameport_allocate_port(); 785 if (!gp) { 786 dev_err(&acard->pci->dev, "cannot allocate memory for gameport\n"); 787 release_and_free_resource(r); 788 return -ENOMEM; 789 } 790 791 gameport_set_name(gp, "ALS4000 Gameport"); 792 gameport_set_phys(gp, "pci%s/gameport0", pci_name(acard->pci)); 793 gameport_set_dev_parent(gp, &acard->pci->dev); 794 gp->io = io_port; 795 gameport_set_port_data(gp, r); 796 797 /* Enable legacy joystick port */ 798 snd_als4000_set_addr(acard->iobase, 0, 0, 0, 1); 799 800 gameport_register_port(acard->gameport); 801 802 return 0; 803 } 804 805 static void snd_als4000_free_gameport(struct snd_card_als4000 *acard) 806 { 807 if (acard->gameport) { 808 struct resource *r = gameport_get_port_data(acard->gameport); 809 810 gameport_unregister_port(acard->gameport); 811 acard->gameport = NULL; 812 813 /* disable joystick */ 814 snd_als4000_set_addr(acard->iobase, 0, 0, 0, 0); 815 816 release_and_free_resource(r); 817 } 818 } 819 #else 820 static inline int snd_als4000_create_gameport(struct snd_card_als4000 *acard, int dev) { return -ENOSYS; } 821 static inline void snd_als4000_free_gameport(struct snd_card_als4000 *acard) { } 822 #endif 823 824 static void snd_card_als4000_free( struct snd_card *card ) 825 { 826 struct snd_card_als4000 *acard = card->private_data; 827 828 /* make sure that interrupts are disabled */ 829 snd_als4k_gcr_write_addr(acard->iobase, ALS4K_GCR8C_MISC_CTRL, 0); 830 /* free resources */ 831 snd_als4000_free_gameport(acard); 832 pci_release_regions(acard->pci); 833 pci_disable_device(acard->pci); 834 } 835 836 static int snd_card_als4000_probe(struct pci_dev *pci, 837 const struct pci_device_id *pci_id) 838 { 839 static int dev; 840 struct snd_card *card; 841 struct snd_card_als4000 *acard; 842 unsigned long iobase; 843 struct snd_sb *chip; 844 struct snd_opl3 *opl3; 845 unsigned short word; 846 int err; 847 848 if (dev >= SNDRV_CARDS) 849 return -ENODEV; 850 if (!enable[dev]) { 851 dev++; 852 return -ENOENT; 853 } 854 855 /* enable PCI device */ 856 if ((err = pci_enable_device(pci)) < 0) { 857 return err; 858 } 859 /* check, if we can restrict PCI DMA transfers to 24 bits */ 860 if (dma_set_mask(&pci->dev, DMA_BIT_MASK(24)) < 0 || 861 dma_set_coherent_mask(&pci->dev, DMA_BIT_MASK(24)) < 0) { 862 dev_err(&pci->dev, "architecture does not support 24bit PCI busmaster DMA\n"); 863 pci_disable_device(pci); 864 return -ENXIO; 865 } 866 867 if ((err = pci_request_regions(pci, "ALS4000")) < 0) { 868 pci_disable_device(pci); 869 return err; 870 } 871 iobase = pci_resource_start(pci, 0); 872 873 pci_read_config_word(pci, PCI_COMMAND, &word); 874 pci_write_config_word(pci, PCI_COMMAND, word | PCI_COMMAND_IO); 875 pci_set_master(pci); 876 877 err = snd_card_new(&pci->dev, index[dev], id[dev], THIS_MODULE, 878 sizeof(*acard) /* private_data: acard */, 879 &card); 880 if (err < 0) { 881 pci_release_regions(pci); 882 pci_disable_device(pci); 883 return err; 884 } 885 886 acard = card->private_data; 887 acard->pci = pci; 888 acard->iobase = iobase; 889 card->private_free = snd_card_als4000_free; 890 891 /* disable all legacy ISA stuff */ 892 snd_als4000_set_addr(acard->iobase, 0, 0, 0, 0); 893 894 if ((err = snd_sbdsp_create(card, 895 iobase + ALS4K_IOB_10_ADLIB_ADDR0, 896 pci->irq, 897 /* internally registered as IRQF_SHARED in case of ALS4000 SB */ 898 snd_als4000_interrupt, 899 -1, 900 -1, 901 SB_HW_ALS4000, 902 &chip)) < 0) { 903 goto out_err; 904 } 905 acard->chip = chip; 906 907 chip->pci = pci; 908 chip->alt_port = iobase; 909 910 snd_als4000_configure(chip); 911 912 strcpy(card->driver, "ALS4000"); 913 strcpy(card->shortname, "Avance Logic ALS4000"); 914 sprintf(card->longname, "%s at 0x%lx, irq %i", 915 card->shortname, chip->alt_port, chip->irq); 916 917 if ((err = snd_mpu401_uart_new( card, 0, MPU401_HW_ALS4000, 918 iobase + ALS4K_IOB_30_MIDI_DATA, 919 MPU401_INFO_INTEGRATED | 920 MPU401_INFO_IRQ_HOOK, 921 -1, &chip->rmidi)) < 0) { 922 dev_err(&pci->dev, "no MPU-401 device at 0x%lx?\n", 923 iobase + ALS4K_IOB_30_MIDI_DATA); 924 goto out_err; 925 } 926 /* FIXME: ALS4000 has interesting MPU401 configuration features 927 * at ALS4K_CR1A_MPU401_UART_MODE_CONTROL 928 * (pass-thru / UART switching, fast MIDI clock, etc.), 929 * however there doesn't seem to be an ALSA API for this... 930 * SPECS_PAGE: 21 */ 931 932 if ((err = snd_als4000_pcm(chip, 0)) < 0) { 933 goto out_err; 934 } 935 if ((err = snd_sbmixer_new(chip)) < 0) { 936 goto out_err; 937 } 938 939 if (snd_opl3_create(card, 940 iobase + ALS4K_IOB_10_ADLIB_ADDR0, 941 iobase + ALS4K_IOB_12_ADLIB_ADDR2, 942 OPL3_HW_AUTO, 1, &opl3) < 0) { 943 dev_err(&pci->dev, "no OPL device at 0x%lx-0x%lx?\n", 944 iobase + ALS4K_IOB_10_ADLIB_ADDR0, 945 iobase + ALS4K_IOB_12_ADLIB_ADDR2); 946 } else { 947 if ((err = snd_opl3_hwdep_new(opl3, 0, 1, NULL)) < 0) { 948 goto out_err; 949 } 950 } 951 952 snd_als4000_create_gameport(acard, dev); 953 954 if ((err = snd_card_register(card)) < 0) { 955 goto out_err; 956 } 957 pci_set_drvdata(pci, card); 958 dev++; 959 err = 0; 960 goto out; 961 962 out_err: 963 snd_card_free(card); 964 965 out: 966 return err; 967 } 968 969 static void snd_card_als4000_remove(struct pci_dev *pci) 970 { 971 snd_card_free(pci_get_drvdata(pci)); 972 } 973 974 #ifdef CONFIG_PM_SLEEP 975 static int snd_als4000_suspend(struct device *dev) 976 { 977 struct snd_card *card = dev_get_drvdata(dev); 978 struct snd_card_als4000 *acard = card->private_data; 979 struct snd_sb *chip = acard->chip; 980 981 snd_power_change_state(card, SNDRV_CTL_POWER_D3hot); 982 983 snd_sbmixer_suspend(chip); 984 return 0; 985 } 986 987 static int snd_als4000_resume(struct device *dev) 988 { 989 struct snd_card *card = dev_get_drvdata(dev); 990 struct snd_card_als4000 *acard = card->private_data; 991 struct snd_sb *chip = acard->chip; 992 993 snd_als4000_configure(chip); 994 snd_sbdsp_reset(chip); 995 snd_sbmixer_resume(chip); 996 997 #ifdef SUPPORT_JOYSTICK 998 if (acard->gameport) 999 snd_als4000_set_addr(acard->iobase, 0, 0, 0, 1); 1000 #endif 1001 1002 snd_power_change_state(card, SNDRV_CTL_POWER_D0); 1003 return 0; 1004 } 1005 1006 static SIMPLE_DEV_PM_OPS(snd_als4000_pm, snd_als4000_suspend, snd_als4000_resume); 1007 #define SND_ALS4000_PM_OPS &snd_als4000_pm 1008 #else 1009 #define SND_ALS4000_PM_OPS NULL 1010 #endif /* CONFIG_PM_SLEEP */ 1011 1012 static struct pci_driver als4000_driver = { 1013 .name = KBUILD_MODNAME, 1014 .id_table = snd_als4000_ids, 1015 .probe = snd_card_als4000_probe, 1016 .remove = snd_card_als4000_remove, 1017 .driver = { 1018 .pm = SND_ALS4000_PM_OPS, 1019 }, 1020 }; 1021 1022 module_pci_driver(als4000_driver); 1023