xref: /openbmc/linux/sound/pci/ad1889.c (revision 93d6487f)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /* Analog Devices 1889 audio driver
3  *
4  * This is a driver for the AD1889 PCI audio chipset found
5  * on the HP PA-RISC [BCJ]-xxx0 workstations.
6  *
7  * Copyright (C) 2004-2005, Kyle McMartin <kyle@parisc-linux.org>
8  * Copyright (C) 2005, Thibaut Varene <varenet@parisc-linux.org>
9  *   Based on the OSS AD1889 driver by Randolph Chung <tausq@debian.org>
10  *
11  * TODO:
12  *	Do we need to take care of CCS register?
13  *	Maybe we could use finer grained locking (separate locks for pb/cap)?
14  * Wishlist:
15  *	Control Interface (mixer) support
16  *	Better AC97 support (VSR...)?
17  *	PM support
18  *	MIDI support
19  *	Game Port support
20  *	SG DMA support (this will need *a lot* of work)
21  */
22 
23 #include <linux/init.h>
24 #include <linux/pci.h>
25 #include <linux/dma-mapping.h>
26 #include <linux/slab.h>
27 #include <linux/interrupt.h>
28 #include <linux/compiler.h>
29 #include <linux/delay.h>
30 #include <linux/module.h>
31 #include <linux/io.h>
32 
33 #include <sound/core.h>
34 #include <sound/pcm.h>
35 #include <sound/initval.h>
36 #include <sound/ac97_codec.h>
37 
38 #include "ad1889.h"
39 #include "ac97/ac97_id.h"
40 
41 #define	AD1889_DRVVER	"Version: 1.7"
42 
43 MODULE_AUTHOR("Kyle McMartin <kyle@parisc-linux.org>, Thibaut Varene <t-bone@parisc-linux.org>");
44 MODULE_DESCRIPTION("Analog Devices AD1889 ALSA sound driver");
45 MODULE_LICENSE("GPL");
46 MODULE_SUPPORTED_DEVICE("{{Analog Devices,AD1889}}");
47 
48 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX;
49 module_param_array(index, int, NULL, 0444);
50 MODULE_PARM_DESC(index, "Index value for the AD1889 soundcard.");
51 
52 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR;
53 module_param_array(id, charp, NULL, 0444);
54 MODULE_PARM_DESC(id, "ID string for the AD1889 soundcard.");
55 
56 static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP;
57 module_param_array(enable, bool, NULL, 0444);
58 MODULE_PARM_DESC(enable, "Enable AD1889 soundcard.");
59 
60 static char *ac97_quirk[SNDRV_CARDS];
61 module_param_array(ac97_quirk, charp, NULL, 0444);
62 MODULE_PARM_DESC(ac97_quirk, "AC'97 workaround for strange hardware.");
63 
64 #define DEVNAME "ad1889"
65 #define PFX	DEVNAME ": "
66 
67 /* keep track of some hw registers */
68 struct ad1889_register_state {
69 	u16 reg;	/* reg setup */
70 	u32 addr;	/* dma base address */
71 	unsigned long size;	/* DMA buffer size */
72 };
73 
74 struct snd_ad1889 {
75 	struct snd_card *card;
76 	struct pci_dev *pci;
77 
78 	int irq;
79 	unsigned long bar;
80 	void __iomem *iobase;
81 
82 	struct snd_ac97 *ac97;
83 	struct snd_ac97_bus *ac97_bus;
84 	struct snd_pcm *pcm;
85 	struct snd_info_entry *proc;
86 
87 	struct snd_pcm_substream *psubs;
88 	struct snd_pcm_substream *csubs;
89 
90 	/* playback register state */
91 	struct ad1889_register_state wave;
92 	struct ad1889_register_state ramc;
93 
94 	spinlock_t lock;
95 };
96 
97 static inline u16
98 ad1889_readw(struct snd_ad1889 *chip, unsigned reg)
99 {
100 	return readw(chip->iobase + reg);
101 }
102 
103 static inline void
104 ad1889_writew(struct snd_ad1889 *chip, unsigned reg, u16 val)
105 {
106 	writew(val, chip->iobase + reg);
107 }
108 
109 static inline u32
110 ad1889_readl(struct snd_ad1889 *chip, unsigned reg)
111 {
112 	return readl(chip->iobase + reg);
113 }
114 
115 static inline void
116 ad1889_writel(struct snd_ad1889 *chip, unsigned reg, u32 val)
117 {
118 	writel(val, chip->iobase + reg);
119 }
120 
121 static inline void
122 ad1889_unmute(struct snd_ad1889 *chip)
123 {
124 	u16 st;
125 	st = ad1889_readw(chip, AD_DS_WADA) &
126 		~(AD_DS_WADA_RWAM | AD_DS_WADA_LWAM);
127 	ad1889_writew(chip, AD_DS_WADA, st);
128 	ad1889_readw(chip, AD_DS_WADA);
129 }
130 
131 static inline void
132 ad1889_mute(struct snd_ad1889 *chip)
133 {
134 	u16 st;
135 	st = ad1889_readw(chip, AD_DS_WADA) | AD_DS_WADA_RWAM | AD_DS_WADA_LWAM;
136 	ad1889_writew(chip, AD_DS_WADA, st);
137 	ad1889_readw(chip, AD_DS_WADA);
138 }
139 
140 static inline void
141 ad1889_load_adc_buffer_address(struct snd_ad1889 *chip, u32 address)
142 {
143 	ad1889_writel(chip, AD_DMA_ADCBA, address);
144 	ad1889_writel(chip, AD_DMA_ADCCA, address);
145 }
146 
147 static inline void
148 ad1889_load_adc_buffer_count(struct snd_ad1889 *chip, u32 count)
149 {
150 	ad1889_writel(chip, AD_DMA_ADCBC, count);
151 	ad1889_writel(chip, AD_DMA_ADCCC, count);
152 }
153 
154 static inline void
155 ad1889_load_adc_interrupt_count(struct snd_ad1889 *chip, u32 count)
156 {
157 	ad1889_writel(chip, AD_DMA_ADCIB, count);
158 	ad1889_writel(chip, AD_DMA_ADCIC, count);
159 }
160 
161 static inline void
162 ad1889_load_wave_buffer_address(struct snd_ad1889 *chip, u32 address)
163 {
164 	ad1889_writel(chip, AD_DMA_WAVBA, address);
165 	ad1889_writel(chip, AD_DMA_WAVCA, address);
166 }
167 
168 static inline void
169 ad1889_load_wave_buffer_count(struct snd_ad1889 *chip, u32 count)
170 {
171 	ad1889_writel(chip, AD_DMA_WAVBC, count);
172 	ad1889_writel(chip, AD_DMA_WAVCC, count);
173 }
174 
175 static inline void
176 ad1889_load_wave_interrupt_count(struct snd_ad1889 *chip, u32 count)
177 {
178 	ad1889_writel(chip, AD_DMA_WAVIB, count);
179 	ad1889_writel(chip, AD_DMA_WAVIC, count);
180 }
181 
182 static void
183 ad1889_channel_reset(struct snd_ad1889 *chip, unsigned int channel)
184 {
185 	u16 reg;
186 
187 	if (channel & AD_CHAN_WAV) {
188 		/* Disable wave channel */
189 		reg = ad1889_readw(chip, AD_DS_WSMC) & ~AD_DS_WSMC_WAEN;
190 		ad1889_writew(chip, AD_DS_WSMC, reg);
191 		chip->wave.reg = reg;
192 
193 		/* disable IRQs */
194 		reg = ad1889_readw(chip, AD_DMA_WAV);
195 		reg &= AD_DMA_IM_DIS;
196 		reg &= ~AD_DMA_LOOP;
197 		ad1889_writew(chip, AD_DMA_WAV, reg);
198 
199 		/* clear IRQ and address counters and pointers */
200 		ad1889_load_wave_buffer_address(chip, 0x0);
201 		ad1889_load_wave_buffer_count(chip, 0x0);
202 		ad1889_load_wave_interrupt_count(chip, 0x0);
203 
204 		/* flush */
205 		ad1889_readw(chip, AD_DMA_WAV);
206 	}
207 
208 	if (channel & AD_CHAN_ADC) {
209 		/* Disable ADC channel */
210 		reg = ad1889_readw(chip, AD_DS_RAMC) & ~AD_DS_RAMC_ADEN;
211 		ad1889_writew(chip, AD_DS_RAMC, reg);
212 		chip->ramc.reg = reg;
213 
214 		reg = ad1889_readw(chip, AD_DMA_ADC);
215 		reg &= AD_DMA_IM_DIS;
216 		reg &= ~AD_DMA_LOOP;
217 		ad1889_writew(chip, AD_DMA_ADC, reg);
218 
219 		ad1889_load_adc_buffer_address(chip, 0x0);
220 		ad1889_load_adc_buffer_count(chip, 0x0);
221 		ad1889_load_adc_interrupt_count(chip, 0x0);
222 
223 		/* flush */
224 		ad1889_readw(chip, AD_DMA_ADC);
225 	}
226 }
227 
228 static u16
229 snd_ad1889_ac97_read(struct snd_ac97 *ac97, unsigned short reg)
230 {
231 	struct snd_ad1889 *chip = ac97->private_data;
232 	return ad1889_readw(chip, AD_AC97_BASE + reg);
233 }
234 
235 static void
236 snd_ad1889_ac97_write(struct snd_ac97 *ac97, unsigned short reg, unsigned short val)
237 {
238 	struct snd_ad1889 *chip = ac97->private_data;
239 	ad1889_writew(chip, AD_AC97_BASE + reg, val);
240 }
241 
242 static int
243 snd_ad1889_ac97_ready(struct snd_ad1889 *chip)
244 {
245 	int retry = 400; /* average needs 352 msec */
246 
247 	while (!(ad1889_readw(chip, AD_AC97_ACIC) & AD_AC97_ACIC_ACRDY)
248 			&& --retry)
249 		usleep_range(1000, 2000);
250 	if (!retry) {
251 		dev_err(chip->card->dev, "[%s] Link is not ready.\n",
252 			__func__);
253 		return -EIO;
254 	}
255 	dev_dbg(chip->card->dev, "[%s] ready after %d ms\n", __func__, 400 - retry);
256 
257 	return 0;
258 }
259 
260 static const struct snd_pcm_hardware snd_ad1889_playback_hw = {
261 	.info = SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_INTERLEAVED |
262 		SNDRV_PCM_INFO_MMAP_VALID | SNDRV_PCM_INFO_BLOCK_TRANSFER,
263 	.formats = SNDRV_PCM_FMTBIT_S16_LE,
264 	.rates = SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_8000_48000,
265 	.rate_min = 8000,	/* docs say 7000, but we're lazy */
266 	.rate_max = 48000,
267 	.channels_min = 1,
268 	.channels_max = 2,
269 	.buffer_bytes_max = BUFFER_BYTES_MAX,
270 	.period_bytes_min = PERIOD_BYTES_MIN,
271 	.period_bytes_max = PERIOD_BYTES_MAX,
272 	.periods_min = PERIODS_MIN,
273 	.periods_max = PERIODS_MAX,
274 	/*.fifo_size = 0,*/
275 };
276 
277 static const struct snd_pcm_hardware snd_ad1889_capture_hw = {
278 	.info = SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_INTERLEAVED |
279 		SNDRV_PCM_INFO_MMAP_VALID | SNDRV_PCM_INFO_BLOCK_TRANSFER,
280 	.formats = SNDRV_PCM_FMTBIT_S16_LE,
281 	.rates = SNDRV_PCM_RATE_48000,
282 	.rate_min = 48000,	/* docs say we could to VSR, but we're lazy */
283 	.rate_max = 48000,
284 	.channels_min = 1,
285 	.channels_max = 2,
286 	.buffer_bytes_max = BUFFER_BYTES_MAX,
287 	.period_bytes_min = PERIOD_BYTES_MIN,
288 	.period_bytes_max = PERIOD_BYTES_MAX,
289 	.periods_min = PERIODS_MIN,
290 	.periods_max = PERIODS_MAX,
291 	/*.fifo_size = 0,*/
292 };
293 
294 static int
295 snd_ad1889_playback_open(struct snd_pcm_substream *ss)
296 {
297 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
298 	struct snd_pcm_runtime *rt = ss->runtime;
299 
300 	chip->psubs = ss;
301 	rt->hw = snd_ad1889_playback_hw;
302 
303 	return 0;
304 }
305 
306 static int
307 snd_ad1889_capture_open(struct snd_pcm_substream *ss)
308 {
309 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
310 	struct snd_pcm_runtime *rt = ss->runtime;
311 
312 	chip->csubs = ss;
313 	rt->hw = snd_ad1889_capture_hw;
314 
315 	return 0;
316 }
317 
318 static int
319 snd_ad1889_playback_close(struct snd_pcm_substream *ss)
320 {
321 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
322 	chip->psubs = NULL;
323 	return 0;
324 }
325 
326 static int
327 snd_ad1889_capture_close(struct snd_pcm_substream *ss)
328 {
329 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
330 	chip->csubs = NULL;
331 	return 0;
332 }
333 
334 static int
335 snd_ad1889_playback_prepare(struct snd_pcm_substream *ss)
336 {
337 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
338 	struct snd_pcm_runtime *rt = ss->runtime;
339 	unsigned int size = snd_pcm_lib_buffer_bytes(ss);
340 	unsigned int count = snd_pcm_lib_period_bytes(ss);
341 	u16 reg;
342 
343 	ad1889_channel_reset(chip, AD_CHAN_WAV);
344 
345 	reg = ad1889_readw(chip, AD_DS_WSMC);
346 
347 	/* Mask out 16-bit / Stereo */
348 	reg &= ~(AD_DS_WSMC_WA16 | AD_DS_WSMC_WAST);
349 
350 	if (snd_pcm_format_width(rt->format) == 16)
351 		reg |= AD_DS_WSMC_WA16;
352 
353 	if (rt->channels > 1)
354 		reg |= AD_DS_WSMC_WAST;
355 
356 	/* let's make sure we don't clobber ourselves */
357 	spin_lock_irq(&chip->lock);
358 
359 	chip->wave.size = size;
360 	chip->wave.reg = reg;
361 	chip->wave.addr = rt->dma_addr;
362 
363 	ad1889_writew(chip, AD_DS_WSMC, chip->wave.reg);
364 
365 	/* Set sample rates on the codec */
366 	ad1889_writew(chip, AD_DS_WAS, rt->rate);
367 
368 	/* Set up DMA */
369 	ad1889_load_wave_buffer_address(chip, chip->wave.addr);
370 	ad1889_load_wave_buffer_count(chip, size);
371 	ad1889_load_wave_interrupt_count(chip, count);
372 
373 	/* writes flush */
374 	ad1889_readw(chip, AD_DS_WSMC);
375 
376 	spin_unlock_irq(&chip->lock);
377 
378 	dev_dbg(chip->card->dev,
379 		"prepare playback: addr = 0x%x, count = %u, size = %u, reg = 0x%x, rate = %u\n",
380 		chip->wave.addr, count, size, reg, rt->rate);
381 	return 0;
382 }
383 
384 static int
385 snd_ad1889_capture_prepare(struct snd_pcm_substream *ss)
386 {
387 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
388 	struct snd_pcm_runtime *rt = ss->runtime;
389 	unsigned int size = snd_pcm_lib_buffer_bytes(ss);
390 	unsigned int count = snd_pcm_lib_period_bytes(ss);
391 	u16 reg;
392 
393 	ad1889_channel_reset(chip, AD_CHAN_ADC);
394 
395 	reg = ad1889_readw(chip, AD_DS_RAMC);
396 
397 	/* Mask out 16-bit / Stereo */
398 	reg &= ~(AD_DS_RAMC_AD16 | AD_DS_RAMC_ADST);
399 
400 	if (snd_pcm_format_width(rt->format) == 16)
401 		reg |= AD_DS_RAMC_AD16;
402 
403 	if (rt->channels > 1)
404 		reg |= AD_DS_RAMC_ADST;
405 
406 	/* let's make sure we don't clobber ourselves */
407 	spin_lock_irq(&chip->lock);
408 
409 	chip->ramc.size = size;
410 	chip->ramc.reg = reg;
411 	chip->ramc.addr = rt->dma_addr;
412 
413 	ad1889_writew(chip, AD_DS_RAMC, chip->ramc.reg);
414 
415 	/* Set up DMA */
416 	ad1889_load_adc_buffer_address(chip, chip->ramc.addr);
417 	ad1889_load_adc_buffer_count(chip, size);
418 	ad1889_load_adc_interrupt_count(chip, count);
419 
420 	/* writes flush */
421 	ad1889_readw(chip, AD_DS_RAMC);
422 
423 	spin_unlock_irq(&chip->lock);
424 
425 	dev_dbg(chip->card->dev,
426 		"prepare capture: addr = 0x%x, count = %u, size = %u, reg = 0x%x, rate = %u\n",
427 		chip->ramc.addr, count, size, reg, rt->rate);
428 	return 0;
429 }
430 
431 /* this is called in atomic context with IRQ disabled.
432    Must be as fast as possible and not sleep.
433    DMA should be *triggered* by this call.
434    The WSMC "WAEN" bit triggers DMA Wave On/Off */
435 static int
436 snd_ad1889_playback_trigger(struct snd_pcm_substream *ss, int cmd)
437 {
438 	u16 wsmc;
439 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
440 
441 	wsmc = ad1889_readw(chip, AD_DS_WSMC);
442 
443 	switch (cmd) {
444 	case SNDRV_PCM_TRIGGER_START:
445 		/* enable DMA loop & interrupts */
446 		ad1889_writew(chip, AD_DMA_WAV, AD_DMA_LOOP | AD_DMA_IM_CNT);
447 		wsmc |= AD_DS_WSMC_WAEN;
448 		/* 1 to clear CHSS bit */
449 		ad1889_writel(chip, AD_DMA_CHSS, AD_DMA_CHSS_WAVS);
450 		ad1889_unmute(chip);
451 		break;
452 	case SNDRV_PCM_TRIGGER_STOP:
453 		ad1889_mute(chip);
454 		wsmc &= ~AD_DS_WSMC_WAEN;
455 		break;
456 	default:
457 		snd_BUG();
458 		return -EINVAL;
459 	}
460 
461 	chip->wave.reg = wsmc;
462 	ad1889_writew(chip, AD_DS_WSMC, wsmc);
463 	ad1889_readw(chip, AD_DS_WSMC);	/* flush */
464 
465 	/* reset the chip when STOP - will disable IRQs */
466 	if (cmd == SNDRV_PCM_TRIGGER_STOP)
467 		ad1889_channel_reset(chip, AD_CHAN_WAV);
468 
469 	return 0;
470 }
471 
472 /* this is called in atomic context with IRQ disabled.
473    Must be as fast as possible and not sleep.
474    DMA should be *triggered* by this call.
475    The RAMC "ADEN" bit triggers DMA ADC On/Off */
476 static int
477 snd_ad1889_capture_trigger(struct snd_pcm_substream *ss, int cmd)
478 {
479 	u16 ramc;
480 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
481 
482 	ramc = ad1889_readw(chip, AD_DS_RAMC);
483 
484 	switch (cmd) {
485 	case SNDRV_PCM_TRIGGER_START:
486 		/* enable DMA loop & interrupts */
487 		ad1889_writew(chip, AD_DMA_ADC, AD_DMA_LOOP | AD_DMA_IM_CNT);
488 		ramc |= AD_DS_RAMC_ADEN;
489 		/* 1 to clear CHSS bit */
490 		ad1889_writel(chip, AD_DMA_CHSS, AD_DMA_CHSS_ADCS);
491 		break;
492 	case SNDRV_PCM_TRIGGER_STOP:
493 		ramc &= ~AD_DS_RAMC_ADEN;
494 		break;
495 	default:
496 		return -EINVAL;
497 	}
498 
499 	chip->ramc.reg = ramc;
500 	ad1889_writew(chip, AD_DS_RAMC, ramc);
501 	ad1889_readw(chip, AD_DS_RAMC);	/* flush */
502 
503 	/* reset the chip when STOP - will disable IRQs */
504 	if (cmd == SNDRV_PCM_TRIGGER_STOP)
505 		ad1889_channel_reset(chip, AD_CHAN_ADC);
506 
507 	return 0;
508 }
509 
510 /* Called in atomic context with IRQ disabled */
511 static snd_pcm_uframes_t
512 snd_ad1889_playback_pointer(struct snd_pcm_substream *ss)
513 {
514 	size_t ptr = 0;
515 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
516 
517 	if (unlikely(!(chip->wave.reg & AD_DS_WSMC_WAEN)))
518 		return 0;
519 
520 	ptr = ad1889_readl(chip, AD_DMA_WAVCA);
521 	ptr -= chip->wave.addr;
522 
523 	if (snd_BUG_ON(ptr >= chip->wave.size))
524 		return 0;
525 
526 	return bytes_to_frames(ss->runtime, ptr);
527 }
528 
529 /* Called in atomic context with IRQ disabled */
530 static snd_pcm_uframes_t
531 snd_ad1889_capture_pointer(struct snd_pcm_substream *ss)
532 {
533 	size_t ptr = 0;
534 	struct snd_ad1889 *chip = snd_pcm_substream_chip(ss);
535 
536 	if (unlikely(!(chip->ramc.reg & AD_DS_RAMC_ADEN)))
537 		return 0;
538 
539 	ptr = ad1889_readl(chip, AD_DMA_ADCCA);
540 	ptr -= chip->ramc.addr;
541 
542 	if (snd_BUG_ON(ptr >= chip->ramc.size))
543 		return 0;
544 
545 	return bytes_to_frames(ss->runtime, ptr);
546 }
547 
548 static const struct snd_pcm_ops snd_ad1889_playback_ops = {
549 	.open = snd_ad1889_playback_open,
550 	.close = snd_ad1889_playback_close,
551 	.ioctl = snd_pcm_lib_ioctl,
552 	.prepare = snd_ad1889_playback_prepare,
553 	.trigger = snd_ad1889_playback_trigger,
554 	.pointer = snd_ad1889_playback_pointer,
555 };
556 
557 static const struct snd_pcm_ops snd_ad1889_capture_ops = {
558 	.open = snd_ad1889_capture_open,
559 	.close = snd_ad1889_capture_close,
560 	.ioctl = snd_pcm_lib_ioctl,
561 	.prepare = snd_ad1889_capture_prepare,
562 	.trigger = snd_ad1889_capture_trigger,
563 	.pointer = snd_ad1889_capture_pointer,
564 };
565 
566 static irqreturn_t
567 snd_ad1889_interrupt(int irq, void *dev_id)
568 {
569 	unsigned long st;
570 	struct snd_ad1889 *chip = dev_id;
571 
572 	st = ad1889_readl(chip, AD_DMA_DISR);
573 
574 	/* clear ISR */
575 	ad1889_writel(chip, AD_DMA_DISR, st);
576 
577 	st &= AD_INTR_MASK;
578 
579 	if (unlikely(!st))
580 		return IRQ_NONE;
581 
582 	if (st & (AD_DMA_DISR_PMAI|AD_DMA_DISR_PTAI))
583 		dev_dbg(chip->card->dev,
584 			"Unexpected master or target abort interrupt!\n");
585 
586 	if ((st & AD_DMA_DISR_WAVI) && chip->psubs)
587 		snd_pcm_period_elapsed(chip->psubs);
588 	if ((st & AD_DMA_DISR_ADCI) && chip->csubs)
589 		snd_pcm_period_elapsed(chip->csubs);
590 
591 	return IRQ_HANDLED;
592 }
593 
594 static int
595 snd_ad1889_pcm_init(struct snd_ad1889 *chip, int device)
596 {
597 	int err;
598 	struct snd_pcm *pcm;
599 
600 	err = snd_pcm_new(chip->card, chip->card->driver, device, 1, 1, &pcm);
601 	if (err < 0)
602 		return err;
603 
604 	snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK,
605 			&snd_ad1889_playback_ops);
606 	snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE,
607 			&snd_ad1889_capture_ops);
608 
609 	pcm->private_data = chip;
610 	pcm->info_flags = 0;
611 	strcpy(pcm->name, chip->card->shortname);
612 
613 	chip->pcm = pcm;
614 	chip->psubs = NULL;
615 	chip->csubs = NULL;
616 
617 	snd_pcm_set_managed_buffer_all(pcm, SNDRV_DMA_TYPE_DEV, &chip->pci->dev,
618 				       BUFFER_BYTES_MAX / 2, BUFFER_BYTES_MAX);
619 
620 	return 0;
621 }
622 
623 static void
624 snd_ad1889_proc_read(struct snd_info_entry *entry, struct snd_info_buffer *buffer)
625 {
626 	struct snd_ad1889 *chip = entry->private_data;
627 	u16 reg;
628 	int tmp;
629 
630 	reg = ad1889_readw(chip, AD_DS_WSMC);
631 	snd_iprintf(buffer, "Wave output: %s\n",
632 			(reg & AD_DS_WSMC_WAEN) ? "enabled" : "disabled");
633 	snd_iprintf(buffer, "Wave Channels: %s\n",
634 			(reg & AD_DS_WSMC_WAST) ? "stereo" : "mono");
635 	snd_iprintf(buffer, "Wave Quality: %d-bit linear\n",
636 			(reg & AD_DS_WSMC_WA16) ? 16 : 8);
637 
638 	/* WARQ is at offset 12 */
639 	tmp = (reg & AD_DS_WSMC_WARQ) ?
640 		((((reg & AD_DS_WSMC_WARQ) >> 12) & 0x01) ? 12 : 18) : 4;
641 	tmp /= (reg & AD_DS_WSMC_WAST) ? 2 : 1;
642 
643 	snd_iprintf(buffer, "Wave FIFO: %d %s words\n\n", tmp,
644 			(reg & AD_DS_WSMC_WAST) ? "stereo" : "mono");
645 
646 
647 	snd_iprintf(buffer, "Synthesis output: %s\n",
648 			reg & AD_DS_WSMC_SYEN ? "enabled" : "disabled");
649 
650 	/* SYRQ is at offset 4 */
651 	tmp = (reg & AD_DS_WSMC_SYRQ) ?
652 		((((reg & AD_DS_WSMC_SYRQ) >> 4) & 0x01) ? 12 : 18) : 4;
653 	tmp /= (reg & AD_DS_WSMC_WAST) ? 2 : 1;
654 
655 	snd_iprintf(buffer, "Synthesis FIFO: %d %s words\n\n", tmp,
656 			(reg & AD_DS_WSMC_WAST) ? "stereo" : "mono");
657 
658 	reg = ad1889_readw(chip, AD_DS_RAMC);
659 	snd_iprintf(buffer, "ADC input: %s\n",
660 			(reg & AD_DS_RAMC_ADEN) ? "enabled" : "disabled");
661 	snd_iprintf(buffer, "ADC Channels: %s\n",
662 			(reg & AD_DS_RAMC_ADST) ? "stereo" : "mono");
663 	snd_iprintf(buffer, "ADC Quality: %d-bit linear\n",
664 			(reg & AD_DS_RAMC_AD16) ? 16 : 8);
665 
666 	/* ACRQ is at offset 4 */
667 	tmp = (reg & AD_DS_RAMC_ACRQ) ?
668 		((((reg & AD_DS_RAMC_ACRQ) >> 4) & 0x01) ? 12 : 18) : 4;
669 	tmp /= (reg & AD_DS_RAMC_ADST) ? 2 : 1;
670 
671 	snd_iprintf(buffer, "ADC FIFO: %d %s words\n\n", tmp,
672 			(reg & AD_DS_RAMC_ADST) ? "stereo" : "mono");
673 
674 	snd_iprintf(buffer, "Resampler input: %s\n",
675 			reg & AD_DS_RAMC_REEN ? "enabled" : "disabled");
676 
677 	/* RERQ is at offset 12 */
678 	tmp = (reg & AD_DS_RAMC_RERQ) ?
679 		((((reg & AD_DS_RAMC_RERQ) >> 12) & 0x01) ? 12 : 18) : 4;
680 	tmp /= (reg & AD_DS_RAMC_ADST) ? 2 : 1;
681 
682 	snd_iprintf(buffer, "Resampler FIFO: %d %s words\n\n", tmp,
683 			(reg & AD_DS_WSMC_WAST) ? "stereo" : "mono");
684 
685 
686 	/* doc says LSB represents -1.5dB, but the max value (-94.5dB)
687 	suggests that LSB is -3dB, which is more coherent with the logarithmic
688 	nature of the dB scale */
689 	reg = ad1889_readw(chip, AD_DS_WADA);
690 	snd_iprintf(buffer, "Left: %s, -%d dB\n",
691 			(reg & AD_DS_WADA_LWAM) ? "mute" : "unmute",
692 			((reg & AD_DS_WADA_LWAA) >> 8) * 3);
693 	reg = ad1889_readw(chip, AD_DS_WADA);
694 	snd_iprintf(buffer, "Right: %s, -%d dB\n",
695 			(reg & AD_DS_WADA_RWAM) ? "mute" : "unmute",
696 			(reg & AD_DS_WADA_RWAA) * 3);
697 
698 	reg = ad1889_readw(chip, AD_DS_WAS);
699 	snd_iprintf(buffer, "Wave samplerate: %u Hz\n", reg);
700 	reg = ad1889_readw(chip, AD_DS_RES);
701 	snd_iprintf(buffer, "Resampler samplerate: %u Hz\n", reg);
702 }
703 
704 static void
705 snd_ad1889_proc_init(struct snd_ad1889 *chip)
706 {
707 	snd_card_ro_proc_new(chip->card, chip->card->driver,
708 			     chip, snd_ad1889_proc_read);
709 }
710 
711 static const struct ac97_quirk ac97_quirks[] = {
712 	{
713 		.subvendor = 0x11d4,	/* AD */
714 		.subdevice = 0x1889,	/* AD1889 */
715 		.codec_id = AC97_ID_AD1819,
716 		.name = "AD1889",
717 		.type = AC97_TUNE_HP_ONLY
718 	},
719 	{ } /* terminator */
720 };
721 
722 static void
723 snd_ad1889_ac97_xinit(struct snd_ad1889 *chip)
724 {
725 	u16 reg;
726 
727 	reg = ad1889_readw(chip, AD_AC97_ACIC);
728 	reg |= AD_AC97_ACIC_ACRD;		/* Reset Disable */
729 	ad1889_writew(chip, AD_AC97_ACIC, reg);
730 	ad1889_readw(chip, AD_AC97_ACIC);	/* flush posted write */
731 	udelay(10);
732 	/* Interface Enable */
733 	reg |= AD_AC97_ACIC_ACIE;
734 	ad1889_writew(chip, AD_AC97_ACIC, reg);
735 
736 	snd_ad1889_ac97_ready(chip);
737 
738 	/* Audio Stream Output | Variable Sample Rate Mode */
739 	reg = ad1889_readw(chip, AD_AC97_ACIC);
740 	reg |= AD_AC97_ACIC_ASOE | AD_AC97_ACIC_VSRM;
741 	ad1889_writew(chip, AD_AC97_ACIC, reg);
742 	ad1889_readw(chip, AD_AC97_ACIC); /* flush posted write */
743 
744 }
745 
746 static void
747 snd_ad1889_ac97_bus_free(struct snd_ac97_bus *bus)
748 {
749 	struct snd_ad1889 *chip = bus->private_data;
750 	chip->ac97_bus = NULL;
751 }
752 
753 static void
754 snd_ad1889_ac97_free(struct snd_ac97 *ac97)
755 {
756 	struct snd_ad1889 *chip = ac97->private_data;
757 	chip->ac97 = NULL;
758 }
759 
760 static int
761 snd_ad1889_ac97_init(struct snd_ad1889 *chip, const char *quirk_override)
762 {
763 	int err;
764 	struct snd_ac97_template ac97;
765 	static struct snd_ac97_bus_ops ops = {
766 		.write = snd_ad1889_ac97_write,
767 		.read = snd_ad1889_ac97_read,
768 	};
769 
770 	/* doing that here, it works. */
771 	snd_ad1889_ac97_xinit(chip);
772 
773 	err = snd_ac97_bus(chip->card, 0, &ops, chip, &chip->ac97_bus);
774 	if (err < 0)
775 		return err;
776 
777 	chip->ac97_bus->private_free = snd_ad1889_ac97_bus_free;
778 
779 	memset(&ac97, 0, sizeof(ac97));
780 	ac97.private_data = chip;
781 	ac97.private_free = snd_ad1889_ac97_free;
782 	ac97.pci = chip->pci;
783 
784 	err = snd_ac97_mixer(chip->ac97_bus, &ac97, &chip->ac97);
785 	if (err < 0)
786 		return err;
787 
788 	snd_ac97_tune_hardware(chip->ac97, ac97_quirks, quirk_override);
789 
790 	return 0;
791 }
792 
793 static int
794 snd_ad1889_free(struct snd_ad1889 *chip)
795 {
796 	if (chip->irq < 0)
797 		goto skip_hw;
798 
799 	spin_lock_irq(&chip->lock);
800 
801 	ad1889_mute(chip);
802 
803 	/* Turn off interrupt on count and zero DMA registers */
804 	ad1889_channel_reset(chip, AD_CHAN_WAV | AD_CHAN_ADC);
805 
806 	/* clear DISR. If we don't, we'd better jump off the Eiffel Tower */
807 	ad1889_writel(chip, AD_DMA_DISR, AD_DMA_DISR_PTAI | AD_DMA_DISR_PMAI);
808 	ad1889_readl(chip, AD_DMA_DISR);	/* flush, dammit! */
809 
810 	spin_unlock_irq(&chip->lock);
811 
812 	if (chip->irq >= 0)
813 		free_irq(chip->irq, chip);
814 
815 skip_hw:
816 	iounmap(chip->iobase);
817 	pci_release_regions(chip->pci);
818 	pci_disable_device(chip->pci);
819 	kfree(chip);
820 	return 0;
821 }
822 
823 static int
824 snd_ad1889_dev_free(struct snd_device *device)
825 {
826 	struct snd_ad1889 *chip = device->device_data;
827 	return snd_ad1889_free(chip);
828 }
829 
830 static int
831 snd_ad1889_init(struct snd_ad1889 *chip)
832 {
833 	ad1889_writew(chip, AD_DS_CCS, AD_DS_CCS_CLKEN); /* turn on clock */
834 	ad1889_readw(chip, AD_DS_CCS);	/* flush posted write */
835 
836 	usleep_range(10000, 11000);
837 
838 	/* enable Master and Target abort interrupts */
839 	ad1889_writel(chip, AD_DMA_DISR, AD_DMA_DISR_PMAE | AD_DMA_DISR_PTAE);
840 
841 	return 0;
842 }
843 
844 static int
845 snd_ad1889_create(struct snd_card *card,
846 		  struct pci_dev *pci,
847 		  struct snd_ad1889 **rchip)
848 {
849 	int err;
850 
851 	struct snd_ad1889 *chip;
852 	static struct snd_device_ops ops = {
853 		.dev_free = snd_ad1889_dev_free,
854 	};
855 
856 	*rchip = NULL;
857 
858 	if ((err = pci_enable_device(pci)) < 0)
859 		return err;
860 
861 	/* check PCI availability (32bit DMA) */
862 	if (dma_set_mask(&pci->dev, DMA_BIT_MASK(32)) < 0 ||
863 	    dma_set_coherent_mask(&pci->dev, DMA_BIT_MASK(32)) < 0) {
864 		dev_err(card->dev, "error setting 32-bit DMA mask.\n");
865 		pci_disable_device(pci);
866 		return -ENXIO;
867 	}
868 
869 	/* allocate chip specific data with zero-filled memory */
870 	if ((chip = kzalloc(sizeof(*chip), GFP_KERNEL)) == NULL) {
871 		pci_disable_device(pci);
872 		return -ENOMEM;
873 	}
874 
875 	chip->card = card;
876 	card->private_data = chip;
877 	chip->pci = pci;
878 	chip->irq = -1;
879 
880 	/* (1) PCI resource allocation */
881 	if ((err = pci_request_regions(pci, card->driver)) < 0)
882 		goto free_and_ret;
883 
884 	chip->bar = pci_resource_start(pci, 0);
885 	chip->iobase = pci_ioremap_bar(pci, 0);
886 	if (chip->iobase == NULL) {
887 		dev_err(card->dev, "unable to reserve region.\n");
888 		err = -EBUSY;
889 		goto free_and_ret;
890 	}
891 
892 	pci_set_master(pci);
893 
894 	spin_lock_init(&chip->lock);	/* only now can we call ad1889_free */
895 
896 	if (request_irq(pci->irq, snd_ad1889_interrupt,
897 			IRQF_SHARED, KBUILD_MODNAME, chip)) {
898 		dev_err(card->dev, "cannot obtain IRQ %d\n", pci->irq);
899 		snd_ad1889_free(chip);
900 		return -EBUSY;
901 	}
902 
903 	chip->irq = pci->irq;
904 	synchronize_irq(chip->irq);
905 
906 	/* (2) initialization of the chip hardware */
907 	if ((err = snd_ad1889_init(chip)) < 0) {
908 		snd_ad1889_free(chip);
909 		return err;
910 	}
911 
912 	if ((err = snd_device_new(card, SNDRV_DEV_LOWLEVEL, chip, &ops)) < 0) {
913 		snd_ad1889_free(chip);
914 		return err;
915 	}
916 
917 	*rchip = chip;
918 
919 	return 0;
920 
921 free_and_ret:
922 	kfree(chip);
923 	pci_disable_device(pci);
924 
925 	return err;
926 }
927 
928 static int
929 snd_ad1889_probe(struct pci_dev *pci,
930 		 const struct pci_device_id *pci_id)
931 {
932 	int err;
933 	static int devno;
934 	struct snd_card *card;
935 	struct snd_ad1889 *chip;
936 
937 	/* (1) */
938 	if (devno >= SNDRV_CARDS)
939 		return -ENODEV;
940 	if (!enable[devno]) {
941 		devno++;
942 		return -ENOENT;
943 	}
944 
945 	/* (2) */
946 	err = snd_card_new(&pci->dev, index[devno], id[devno], THIS_MODULE,
947 			   0, &card);
948 	/* XXX REVISIT: we can probably allocate chip in this call */
949 	if (err < 0)
950 		return err;
951 
952 	strcpy(card->driver, "AD1889");
953 	strcpy(card->shortname, "Analog Devices AD1889");
954 
955 	/* (3) */
956 	err = snd_ad1889_create(card, pci, &chip);
957 	if (err < 0)
958 		goto free_and_ret;
959 
960 	/* (4) */
961 	sprintf(card->longname, "%s at 0x%lx irq %i",
962 		card->shortname, chip->bar, chip->irq);
963 
964 	/* (5) */
965 	/* register AC97 mixer */
966 	err = snd_ad1889_ac97_init(chip, ac97_quirk[devno]);
967 	if (err < 0)
968 		goto free_and_ret;
969 
970 	err = snd_ad1889_pcm_init(chip, 0);
971 	if (err < 0)
972 		goto free_and_ret;
973 
974 	/* register proc interface */
975 	snd_ad1889_proc_init(chip);
976 
977 	/* (6) */
978 	err = snd_card_register(card);
979 	if (err < 0)
980 		goto free_and_ret;
981 
982 	/* (7) */
983 	pci_set_drvdata(pci, card);
984 
985 	devno++;
986 	return 0;
987 
988 free_and_ret:
989 	snd_card_free(card);
990 	return err;
991 }
992 
993 static void
994 snd_ad1889_remove(struct pci_dev *pci)
995 {
996 	snd_card_free(pci_get_drvdata(pci));
997 }
998 
999 static const struct pci_device_id snd_ad1889_ids[] = {
1000 	{ PCI_DEVICE(PCI_VENDOR_ID_ANALOG_DEVICES, PCI_DEVICE_ID_AD1889JS) },
1001 	{ 0, },
1002 };
1003 MODULE_DEVICE_TABLE(pci, snd_ad1889_ids);
1004 
1005 static struct pci_driver ad1889_pci_driver = {
1006 	.name = KBUILD_MODNAME,
1007 	.id_table = snd_ad1889_ids,
1008 	.probe = snd_ad1889_probe,
1009 	.remove = snd_ad1889_remove,
1010 };
1011 
1012 module_pci_driver(ad1889_pci_driver);
1013