xref: /openbmc/linux/sound/pci/azt3328.c (revision b868a02e)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*  azt3328.c - driver for Aztech AZF3328 based soundcards (e.g. PCI168).
3  *  Copyright (C) 2002, 2005 - 2011 by Andreas Mohr <andi AT lisas.de>
4  *
5  *  Framework borrowed from Bart Hartgers's als4000.c.
6  *  Driver developed on PCI168 AP(W) version (PCI rev. 10, subsystem ID 1801),
7  *  found in a Fujitsu-Siemens PC ("Cordant", aluminum case).
8  *  Other versions are:
9  *  PCI168 A(W), sub ID 1800
10  *  PCI168 A/AP, sub ID 8000
11  *  Please give me feedback in case you try my driver with one of these!!
12  *
13  *  Keywords: Windows XP Vista 168nt4-125.zip 168win95-125.zip PCI 168 download
14  *  (XP/Vista do not support this card at all but every Linux distribution
15  *   has very good support out of the box;
16  *   just to make sure that the right people hit this and get to know that,
17  *   despite the high level of Internet ignorance - as usual :-P -
18  *   about very good support for this card - on Linux!)
19  *
20  * NOTES
21  *  Since Aztech does not provide any chipset documentation,
22  *  even on repeated request to various addresses,
23  *  and the answer that was finally given was negative
24  *  (and I was stupid enough to manage to get hold of a PCI168 soundcard
25  *  in the first place >:-P}),
26  *  I was forced to base this driver on reverse engineering
27  *  (3 weeks' worth of evenings filled with driver work).
28  *  (and no, I did NOT go the easy way: to pick up a SB PCI128 for 9 Euros)
29  *
30  *  It is quite likely that the AZF3328 chip is the PCI cousin of the
31  *  AZF3318 ("azt1020 pnp", "MM Pro 16") ISA chip, given very similar specs.
32  *
33  *  The AZF3328 chip (note: AZF3328, *not* AZT3328, that's just the driver name
34  *  for compatibility reasons) from Azfin (joint-venture of Aztech and Fincitec,
35  *  Fincitec acquired by National Semiconductor in 2002, together with the
36  *  Fincitec-related company ARSmikro) has the following features:
37  *
38  *  - compatibility & compliance:
39  *    - Microsoft PC 97 ("PC 97 Hardware Design Guide",
40  *                       http://www.microsoft.com/whdc/archive/pcguides.mspx)
41  *    - Microsoft PC 98 Baseline Audio
42  *    - MPU401 UART
43  *    - Sound Blaster Emulation (DOS Box)
44  *  - builtin AC97 conformant codec (SNR over 80dB)
45  *    Note that "conformant" != "compliant"!! this chip's mixer register layout
46  *    *differs* from the standard AC97 layout:
47  *    they chose to not implement the headphone register (which is not a
48  *    problem since it's merely optional), yet when doing this, they committed
49  *    the grave sin of letting other registers follow immediately instead of
50  *    keeping a headphone dummy register, thereby shifting the mixer register
51  *    addresses illegally. So far unfortunately it looks like the very flexible
52  *    ALSA AC97 support is still not enough to easily compensate for such a
53  *    grave layout violation despite all tweaks and quirks mechanisms it offers.
54  *    Well, not quite: now ac97 layer is much improved (bus-specific ops!),
55  *    thus I was able to implement support - it's actually working quite well.
56  *    An interesting item might be Aztech AMR 2800-W, since it's an AC97
57  *    modem card which might reveal the Aztech-specific codec ID which
58  *    we might want to pretend, too. Dito PCI168's brother, PCI368,
59  *    where the advertising datasheet says it's AC97-based and has a
60  *    Digital Enhanced Game Port.
61  *  - builtin genuine OPL3 - verified to work fine, 20080506
62  *  - full duplex 16bit playback/record at independent sampling rate
63  *  - MPU401 (+ legacy address support, claimed by one official spec sheet)
64  *    FIXME: how to enable legacy addr??
65  *  - game port (legacy address support)
66  *  - builtin DirectInput support, helps reduce CPU overhead (interrupt-driven
67  *    features supported). - See common term "Digital Enhanced Game Port"...
68  *    (probably DirectInput 3.0 spec - confirm)
69  *  - builtin 3D enhancement (said to be YAMAHA Ymersion)
70  *  - built-in General DirectX timer having a 20 bits counter
71  *    with 1us resolution (see below!)
72  *  - I2S serial output port for external DAC
73  *    [FIXME: 3.3V or 5V level? maximum rate is 66.2kHz right?]
74  *  - supports 33MHz PCI spec 2.1, PCI power management 1.0, compliant with ACPI
75  *  - supports hardware volume control
76  *  - single chip low cost solution (128 pin QFP)
77  *  - supports programmable Sub-vendor and Sub-system ID [24C02 SEEPROM chip]
78  *    required for Microsoft's logo compliance (FIXME: where?)
79  *    At least the Trident 4D Wave DX has one bit somewhere
80  *    to enable writes to PCI subsystem VID registers, that should be it.
81  *    This might easily be in extended PCI reg space, since PCI168 also has
82  *    some custom data starting at 0x80. What kind of config settings
83  *    are located in our extended PCI space anyway??
84  *  - PCI168 AP(W) card: power amplifier with 4 Watts/channel at 4 Ohms
85  *    [TDA1517P chip]
86  *
87  *  Note that this driver now is actually *better* than the Windows driver,
88  *  since it additionally supports the card's 1MHz DirectX timer - just try
89  *  the following snd-seq module parameters etc.:
90  *  - options snd-seq seq_default_timer_class=2 seq_default_timer_sclass=0
91  *    seq_default_timer_card=0 seq_client_load=1 seq_default_timer_device=0
92  *    seq_default_timer_subdevice=0 seq_default_timer_resolution=1000000
93  *  - "timidity -iAv -B2,8 -Os -EFreverb=0"
94  *  - "pmidi -p 128:0 jazz.mid"
95  *
96  *  OPL3 hardware playback testing, try something like:
97  *  cat /proc/asound/hwdep
98  *  and
99  *  aconnect -o
100  *  Then use
101  *  sbiload -Dhw:x,y --opl3 /usr/share/sounds/opl3/std.o3 ......./drums.o3
102  *  where x,y is the xx-yy number as given in hwdep.
103  *  Then try
104  *  pmidi -p a:b jazz.mid
105  *  where a:b is the client number plus 0 usually, as given by aconnect above.
106  *  Oh, and make sure to unmute the FM mixer control (doh!)
107  *  NOTE: power use during OPL3 playback is _VERY_ high (70W --> 90W!)
108  *  despite no CPU activity, possibly due to hindering ACPI idling somehow.
109  *  Shouldn't be a problem of the AZF3328 chip itself, I'd hope.
110  *  Higher PCM / FM mixer levels seem to conflict (causes crackling),
111  *  at least sometimes.   Maybe even use with hardware sequencer timer above :)
112  *  adplay/adplug-utils might soon offer hardware-based OPL3 playback, too.
113  *
114  *  Certain PCI versions of this card are susceptible to DMA traffic underruns
115  *  in some systems (resulting in sound crackling/clicking/popping),
116  *  probably because they don't have a DMA FIFO buffer or so.
117  *  Overview (PCI ID/PCI subID/PCI rev.):
118  *  - no DMA crackling on SiS735: 0x50DC/0x1801/16
119  *  - unknown performance: 0x50DC/0x1801/10
120  *    (well, it's not bad on an Athlon 1800 with now very optimized IRQ handler)
121  *
122  *  Crackling happens with VIA chipsets or, in my case, an SiS735, which is
123  *  supposed to be very fast and supposed to get rid of crackling much
124  *  better than a VIA, yet ironically I still get crackling, like many other
125  *  people with the same chipset.
126  *  Possible remedies:
127  *  - use speaker (amplifier) output instead of headphone output
128  *    (in case crackling is due to overloaded output clipping)
129  *  - plug card into a different PCI slot, preferably one that isn't shared
130  *    too much (this helps a lot, but not completely!)
131  *  - get rid of PCI VGA card, use AGP instead
132  *  - upgrade or downgrade BIOS
133  *  - fiddle with PCI latency settings (setpci -v -s BUSID latency_timer=XX)
134  *    Not too helpful.
135  *  - Disable ACPI/power management/"Auto Detect RAM/PCI Clk" in BIOS
136  *
137  * BUGS
138  *  - full-duplex might *still* be problematic, however a recent test was fine
139  *  - (non-bug) "Bass/Treble or 3D settings don't work" - they do get evaluated
140  *    if you set PCM output switch to "pre 3D" instead of "post 3D".
141  *    If this can't be set, then get a mixer application that Isn't Stupid (tm)
142  *    (e.g. kmix, gamix) - unfortunately several are!!
143  *  - locking is not entirely clean, especially the audio stream activity
144  *    ints --> may be racy
145  *  - an _unconnected_ secondary joystick at the gameport will be reported
146  *    to be "active" (floating values, not precisely -1) due to the way we need
147  *    to read the Digital Enhanced Game Port. Not sure whether it is fixable.
148  *
149  * TODO
150  *  - use PCI_VDEVICE
151  *  - verify driver status on x86_64
152  *  - test multi-card driver operation
153  *  - (ab)use 1MHz DirectX timer as kernel clocksource
154  *  - test MPU401 MIDI playback etc.
155  *  - add more power micro-management (disable various units of the card
156  *    as long as they're unused, to improve audio quality and save power).
157  *    However this requires more I/O ports which I haven't figured out yet
158  *    and which thus might not even exist...
159  *    The standard suspend/resume functionality could probably make use of
160  *    some improvement, too...
161  *  - figure out what all unknown port bits are responsible for
162  *  - figure out some cleverly evil scheme to possibly make ALSA AC97 code
163  *    fully accept our quite incompatible ""AC97"" mixer and thus save some
164  *    code (but I'm not too optimistic that doing this is possible at all)
165  *  - use MMIO (memory-mapped I/O)? Slightly faster access, e.g. for gameport.
166  */
167 
168 #include <linux/io.h>
169 #include <linux/init.h>
170 #include <linux/bug.h> /* WARN_ONCE */
171 #include <linux/pci.h>
172 #include <linux/delay.h>
173 #include <linux/slab.h>
174 #include <linux/gameport.h>
175 #include <linux/module.h>
176 #include <linux/dma-mapping.h>
177 #include <sound/core.h>
178 #include <sound/control.h>
179 #include <sound/pcm.h>
180 #include <sound/rawmidi.h>
181 #include <sound/mpu401.h>
182 #include <sound/opl3.h>
183 #include <sound/initval.h>
184 /*
185  * Config switch, to use ALSA's AC97 layer instead of old custom mixer crap.
186  * If the AC97 compatibility parts we needed to implement locally turn out
187  * to work nicely, then remove the old implementation eventually.
188  */
189 #define AZF_USE_AC97_LAYER 1
190 
191 #ifdef AZF_USE_AC97_LAYER
192 #include <sound/ac97_codec.h>
193 #endif
194 #include "azt3328.h"
195 
196 MODULE_AUTHOR("Andreas Mohr <andi AT lisas.de>");
197 MODULE_DESCRIPTION("Aztech AZF3328 (PCI168)");
198 MODULE_LICENSE("GPL");
199 
200 #if IS_REACHABLE(CONFIG_GAMEPORT)
201 #define SUPPORT_GAMEPORT 1
202 #endif
203 
204 /* === Debug settings ===
205   Further diagnostic functionality than the settings below
206   does not need to be provided, since one can easily write a POSIX shell script
207   to dump the card's I/O ports (those listed in lspci -v -v):
208   dump()
209   {
210     local descr=$1; local addr=$2; local count=$3
211 
212     echo "${descr}: ${count} @ ${addr}:"
213     dd if=/dev/port skip=`printf %d ${addr}` count=${count} bs=1 \
214       2>/dev/null| hexdump -C
215   }
216   and then use something like
217   "dump joy200 0x200 8", "dump mpu388 0x388 4", "dump joy 0xb400 8",
218   "dump codec00 0xa800 32", "dump mixer 0xb800 64", "dump synth 0xbc00 8",
219   possibly within a "while true; do ... sleep 1; done" loop.
220   Tweaking ports could be done using
221   VALSTRING="`printf "%02x" $value`"
222   printf "\x""$VALSTRING"|dd of=/dev/port seek=`printf %d ${addr}` bs=1 \
223     2>/dev/null
224 */
225 
226 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX;	/* Index 0-MAX */
227 module_param_array(index, int, NULL, 0444);
228 MODULE_PARM_DESC(index, "Index value for AZF3328 soundcard.");
229 
230 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR;	/* ID for this card */
231 module_param_array(id, charp, NULL, 0444);
232 MODULE_PARM_DESC(id, "ID string for AZF3328 soundcard.");
233 
234 static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP;	/* Enable this card */
235 module_param_array(enable, bool, NULL, 0444);
236 MODULE_PARM_DESC(enable, "Enable AZF3328 soundcard.");
237 
238 static int seqtimer_scaling = 128;
239 module_param(seqtimer_scaling, int, 0444);
240 MODULE_PARM_DESC(seqtimer_scaling, "Set 1024000Hz sequencer timer scale factor (lockup danger!). Default 128.");
241 
242 enum snd_azf3328_codec_type {
243   /* warning: fixed indices (also used for bitmask checks!) */
244   AZF_CODEC_PLAYBACK = 0,
245   AZF_CODEC_CAPTURE = 1,
246   AZF_CODEC_I2S_OUT = 2,
247 };
248 
249 struct snd_azf3328_codec_data {
250 	unsigned long io_base; /* keep first! (avoid offset calc) */
251 	unsigned int dma_base; /* helper to avoid an indirection in hotpath */
252 	spinlock_t *lock; /* TODO: convert to our own per-codec lock member */
253 	struct snd_pcm_substream *substream;
254 	bool running;
255 	enum snd_azf3328_codec_type type;
256 	const char *name;
257 };
258 
259 struct snd_azf3328 {
260 	/* often-used fields towards beginning, then grouped */
261 
262 	unsigned long ctrl_io; /* usually 0xb000, size 128 */
263 	unsigned long game_io;  /* usually 0xb400, size 8 */
264 	unsigned long mpu_io;   /* usually 0xb800, size 4 */
265 	unsigned long opl3_io; /* usually 0xbc00, size 8 */
266 	unsigned long mixer_io; /* usually 0xc000, size 64 */
267 
268 	spinlock_t reg_lock;
269 
270 	struct snd_timer *timer;
271 
272 	struct snd_pcm *pcm[3];
273 
274 	/* playback, recording and I2S out codecs */
275 	struct snd_azf3328_codec_data codecs[3];
276 
277 #ifdef AZF_USE_AC97_LAYER
278 	struct snd_ac97 *ac97;
279 #endif
280 
281 	struct snd_card *card;
282 	struct snd_rawmidi *rmidi;
283 
284 #ifdef SUPPORT_GAMEPORT
285 	struct gameport *gameport;
286 	u16 axes[4];
287 #endif
288 
289 	struct pci_dev *pci;
290 	int irq;
291 
292 	/* register 0x6a is write-only, thus need to remember setting.
293 	 * If we need to add more registers here, then we might try to fold this
294 	 * into some transparent combined shadow register handling with
295 	 * CONFIG_PM register storage below, but that's slightly difficult. */
296 	u16 shadow_reg_ctrl_6AH;
297 
298 #ifdef CONFIG_PM_SLEEP
299 	/* register value containers for power management
300 	 * Note: not always full I/O range preserved (similar to Win driver!) */
301 	u32 saved_regs_ctrl[AZF_ALIGN(AZF_IO_SIZE_CTRL_PM) / 4];
302 	u32 saved_regs_game[AZF_ALIGN(AZF_IO_SIZE_GAME_PM) / 4];
303 	u32 saved_regs_mpu[AZF_ALIGN(AZF_IO_SIZE_MPU_PM) / 4];
304 	u32 saved_regs_opl3[AZF_ALIGN(AZF_IO_SIZE_OPL3_PM) / 4];
305 	u32 saved_regs_mixer[AZF_ALIGN(AZF_IO_SIZE_MIXER_PM) / 4];
306 #endif
307 };
308 
309 static const struct pci_device_id snd_azf3328_ids[] = {
310 	{ 0x122D, 0x50DC, PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0 },   /* PCI168/3328 */
311 	{ 0x122D, 0x80DA, PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0 },   /* 3328 */
312 	{ 0, }
313 };
314 
315 MODULE_DEVICE_TABLE(pci, snd_azf3328_ids);
316 
317 
318 static int
319 snd_azf3328_io_reg_setb(unsigned reg, u8 mask, bool do_set)
320 {
321 	/* Well, strictly spoken, the inb/outb sequence isn't atomic
322 	   and would need locking. However we currently don't care
323 	   since it potentially complicates matters. */
324 	u8 prev = inb(reg), new;
325 
326 	new = (do_set) ? (prev|mask) : (prev & ~mask);
327 	/* we need to always write the new value no matter whether it differs
328 	 * or not, since some register bits don't indicate their setting */
329 	outb(new, reg);
330 	if (new != prev)
331 		return 1;
332 
333 	return 0;
334 }
335 
336 static inline void
337 snd_azf3328_codec_outb(const struct snd_azf3328_codec_data *codec,
338 		       unsigned reg,
339 		       u8 value
340 )
341 {
342 	outb(value, codec->io_base + reg);
343 }
344 
345 static inline u8
346 snd_azf3328_codec_inb(const struct snd_azf3328_codec_data *codec, unsigned reg)
347 {
348 	return inb(codec->io_base + reg);
349 }
350 
351 static inline void
352 snd_azf3328_codec_outw(const struct snd_azf3328_codec_data *codec,
353 		       unsigned reg,
354 		       u16 value
355 )
356 {
357 	outw(value, codec->io_base + reg);
358 }
359 
360 static inline u16
361 snd_azf3328_codec_inw(const struct snd_azf3328_codec_data *codec, unsigned reg)
362 {
363 	return inw(codec->io_base + reg);
364 }
365 
366 static inline void
367 snd_azf3328_codec_outl(const struct snd_azf3328_codec_data *codec,
368 		       unsigned reg,
369 		       u32 value
370 )
371 {
372 	outl(value, codec->io_base + reg);
373 }
374 
375 static inline void
376 snd_azf3328_codec_outl_multi(const struct snd_azf3328_codec_data *codec,
377 			     unsigned reg, const void *buffer, int count
378 )
379 {
380 	unsigned long addr = codec->io_base + reg;
381 	if (count) {
382 		const u32 *buf = buffer;
383 		do {
384 			outl(*buf++, addr);
385 			addr += 4;
386 		} while (--count);
387 	}
388 }
389 
390 static inline u32
391 snd_azf3328_codec_inl(const struct snd_azf3328_codec_data *codec, unsigned reg)
392 {
393 	return inl(codec->io_base + reg);
394 }
395 
396 static inline void
397 snd_azf3328_ctrl_outb(const struct snd_azf3328 *chip, unsigned reg, u8 value)
398 {
399 	outb(value, chip->ctrl_io + reg);
400 }
401 
402 static inline u8
403 snd_azf3328_ctrl_inb(const struct snd_azf3328 *chip, unsigned reg)
404 {
405 	return inb(chip->ctrl_io + reg);
406 }
407 
408 static inline u16
409 snd_azf3328_ctrl_inw(const struct snd_azf3328 *chip, unsigned reg)
410 {
411 	return inw(chip->ctrl_io + reg);
412 }
413 
414 static inline void
415 snd_azf3328_ctrl_outw(const struct snd_azf3328 *chip, unsigned reg, u16 value)
416 {
417 	outw(value, chip->ctrl_io + reg);
418 }
419 
420 static inline void
421 snd_azf3328_ctrl_outl(const struct snd_azf3328 *chip, unsigned reg, u32 value)
422 {
423 	outl(value, chip->ctrl_io + reg);
424 }
425 
426 static inline void
427 snd_azf3328_game_outb(const struct snd_azf3328 *chip, unsigned reg, u8 value)
428 {
429 	outb(value, chip->game_io + reg);
430 }
431 
432 static inline void
433 snd_azf3328_game_outw(const struct snd_azf3328 *chip, unsigned reg, u16 value)
434 {
435 	outw(value, chip->game_io + reg);
436 }
437 
438 static inline u8
439 snd_azf3328_game_inb(const struct snd_azf3328 *chip, unsigned reg)
440 {
441 	return inb(chip->game_io + reg);
442 }
443 
444 static inline u16
445 snd_azf3328_game_inw(const struct snd_azf3328 *chip, unsigned reg)
446 {
447 	return inw(chip->game_io + reg);
448 }
449 
450 static inline void
451 snd_azf3328_mixer_outw(const struct snd_azf3328 *chip, unsigned reg, u16 value)
452 {
453 	outw(value, chip->mixer_io + reg);
454 }
455 
456 static inline u16
457 snd_azf3328_mixer_inw(const struct snd_azf3328 *chip, unsigned reg)
458 {
459 	return inw(chip->mixer_io + reg);
460 }
461 
462 #define AZF_MUTE_BIT 0x80
463 
464 static bool
465 snd_azf3328_mixer_mute_control(const struct snd_azf3328 *chip,
466 			   unsigned reg, bool do_mute
467 )
468 {
469 	unsigned long portbase = chip->mixer_io + reg + 1;
470 	bool updated;
471 
472 	/* the mute bit is on the *second* (i.e. right) register of a
473 	 * left/right channel setting */
474 	updated = snd_azf3328_io_reg_setb(portbase, AZF_MUTE_BIT, do_mute);
475 
476 	/* indicate whether it was muted before */
477 	return (do_mute) ? !updated : updated;
478 }
479 
480 static inline bool
481 snd_azf3328_mixer_mute_control_master(const struct snd_azf3328 *chip,
482 			   bool do_mute
483 )
484 {
485 	return snd_azf3328_mixer_mute_control(
486 		chip,
487 		IDX_MIXER_PLAY_MASTER,
488 		do_mute
489 	);
490 }
491 
492 static inline bool
493 snd_azf3328_mixer_mute_control_pcm(const struct snd_azf3328 *chip,
494 			   bool do_mute
495 )
496 {
497 	return snd_azf3328_mixer_mute_control(
498 		chip,
499 		IDX_MIXER_WAVEOUT,
500 		do_mute
501 	);
502 }
503 
504 static inline void
505 snd_azf3328_mixer_reset(const struct snd_azf3328 *chip)
506 {
507 	/* reset (close) mixer:
508 	 * first mute master volume, then reset
509 	 */
510 	snd_azf3328_mixer_mute_control_master(chip, 1);
511 	snd_azf3328_mixer_outw(chip, IDX_MIXER_RESET, 0x0000);
512 }
513 
514 #ifdef AZF_USE_AC97_LAYER
515 
516 static inline void
517 snd_azf3328_mixer_ac97_map_unsupported(const struct snd_azf3328 *chip,
518 				       unsigned short reg, const char *mode)
519 {
520 	/* need to add some more or less clever emulation? */
521 	dev_warn(chip->card->dev,
522 		"missing %s emulation for AC97 register 0x%02x!\n",
523 		mode, reg);
524 }
525 
526 /*
527  * Need to have _special_ AC97 mixer hardware register index mapper,
528  * to compensate for the issue of a rather AC97-incompatible hardware layout.
529  */
530 #define AZF_REG_MASK 0x3f
531 #define AZF_AC97_REG_UNSUPPORTED 0x8000
532 #define AZF_AC97_REG_REAL_IO_READ 0x4000
533 #define AZF_AC97_REG_REAL_IO_WRITE 0x2000
534 #define AZF_AC97_REG_REAL_IO_RW \
535 	(AZF_AC97_REG_REAL_IO_READ | AZF_AC97_REG_REAL_IO_WRITE)
536 #define AZF_AC97_REG_EMU_IO_READ 0x0400
537 #define AZF_AC97_REG_EMU_IO_WRITE 0x0200
538 #define AZF_AC97_REG_EMU_IO_RW \
539 	(AZF_AC97_REG_EMU_IO_READ | AZF_AC97_REG_EMU_IO_WRITE)
540 static unsigned short
541 snd_azf3328_mixer_ac97_map_reg_idx(unsigned short reg)
542 {
543 	static const struct {
544 		unsigned short azf_reg;
545 	} azf_reg_mapper[] = {
546 		/* Especially when taking into consideration
547 		 * mono/stereo-based sequence of azf vs. AC97 control series,
548 		 * it's quite obvious that azf simply got rid
549 		 * of the AC97_HEADPHONE control at its intended offset,
550 		 * thus shifted _all_ controls by one,
551 		 * and _then_ simply added it as an FMSYNTH control at the end,
552 		 * to make up for the offset.
553 		 * This means we'll have to translate indices here as
554 		 * needed and then do some tiny AC97 patch action
555 		 * (snd_ac97_rename_vol_ctl() etc.) - that's it.
556 		 */
557 		{ /* AC97_RESET */ IDX_MIXER_RESET
558 			| AZF_AC97_REG_REAL_IO_WRITE
559 			| AZF_AC97_REG_EMU_IO_READ },
560 		{ /* AC97_MASTER */ IDX_MIXER_PLAY_MASTER },
561 		 /* note large shift: AC97_HEADPHONE to IDX_MIXER_FMSYNTH! */
562 		{ /* AC97_HEADPHONE */ IDX_MIXER_FMSYNTH },
563 		{ /* AC97_MASTER_MONO */ IDX_MIXER_MODEMOUT },
564 		{ /* AC97_MASTER_TONE */ IDX_MIXER_BASSTREBLE },
565 		{ /* AC97_PC_BEEP */ IDX_MIXER_PCBEEP },
566 		{ /* AC97_PHONE */ IDX_MIXER_MODEMIN },
567 		{ /* AC97_MIC */ IDX_MIXER_MIC },
568 		{ /* AC97_LINE */ IDX_MIXER_LINEIN },
569 		{ /* AC97_CD */ IDX_MIXER_CDAUDIO },
570 		{ /* AC97_VIDEO */ IDX_MIXER_VIDEO },
571 		{ /* AC97_AUX */ IDX_MIXER_AUX },
572 		{ /* AC97_PCM */ IDX_MIXER_WAVEOUT },
573 		{ /* AC97_REC_SEL */ IDX_MIXER_REC_SELECT },
574 		{ /* AC97_REC_GAIN */ IDX_MIXER_REC_VOLUME },
575 		{ /* AC97_REC_GAIN_MIC */ AZF_AC97_REG_EMU_IO_RW },
576 		{ /* AC97_GENERAL_PURPOSE */ IDX_MIXER_ADVCTL2 },
577 		{ /* AC97_3D_CONTROL */ IDX_MIXER_ADVCTL1 },
578 	};
579 
580 	unsigned short reg_azf = AZF_AC97_REG_UNSUPPORTED;
581 
582 	/* azf3328 supports the low-numbered and low-spec:ed range
583 	   of AC97 regs only */
584 	if (reg <= AC97_3D_CONTROL) {
585 		unsigned short reg_idx = reg / 2;
586 		reg_azf = azf_reg_mapper[reg_idx].azf_reg;
587 		/* a translation-only entry means it's real read/write: */
588 		if (!(reg_azf & ~AZF_REG_MASK))
589 			reg_azf |= AZF_AC97_REG_REAL_IO_RW;
590 	} else {
591 		switch (reg) {
592 		case AC97_POWERDOWN:
593 			reg_azf = AZF_AC97_REG_EMU_IO_RW;
594 			break;
595 		case AC97_EXTENDED_ID:
596 			reg_azf = AZF_AC97_REG_EMU_IO_READ;
597 			break;
598 		case AC97_EXTENDED_STATUS:
599 			/* I don't know what the h*ll AC97 layer
600 			 * would consult this _extended_ register for
601 			 * given a base-AC97-advertised card,
602 			 * but let's just emulate it anyway :-P
603 			 */
604 			reg_azf = AZF_AC97_REG_EMU_IO_RW;
605 			break;
606 		case AC97_VENDOR_ID1:
607 		case AC97_VENDOR_ID2:
608 			reg_azf = AZF_AC97_REG_EMU_IO_READ;
609 			break;
610 		}
611 	}
612 	return reg_azf;
613 }
614 
615 static const unsigned short
616 azf_emulated_ac97_caps =
617 	AC97_BC_DEDICATED_MIC |
618 	AC97_BC_BASS_TREBLE |
619 	/* Headphone is an FM Synth control here */
620 	AC97_BC_HEADPHONE |
621 	/* no AC97_BC_LOUDNESS! */
622 	/* mask 0x7c00 is
623 	   vendor-specific 3D enhancement
624 	   vendor indicator.
625 	   Since there actually _is_ an
626 	   entry for Aztech Labs
627 	   (13), make damn sure
628 	   to indicate it. */
629 	(13 << 10);
630 
631 static const unsigned short
632 azf_emulated_ac97_powerdown =
633 	/* pretend everything to be active */
634 		AC97_PD_ADC_STATUS |
635 		AC97_PD_DAC_STATUS |
636 		AC97_PD_MIXER_STATUS |
637 		AC97_PD_VREF_STATUS;
638 
639 /*
640  * Emulated, _inofficial_ vendor ID
641  * (there might be some devices such as the MR 2800-W
642  * which could reveal the real Aztech AC97 ID).
643  * We choose to use "AZT" prefix, and then use 1 to indicate PCI168
644  * (better don't use 0x68 since there's a PCI368 as well).
645  */
646 static const unsigned int
647 azf_emulated_ac97_vendor_id = 0x415a5401;
648 
649 static unsigned short
650 snd_azf3328_mixer_ac97_read(struct snd_ac97 *ac97, unsigned short reg_ac97)
651 {
652 	const struct snd_azf3328 *chip = ac97->private_data;
653 	unsigned short reg_azf = snd_azf3328_mixer_ac97_map_reg_idx(reg_ac97);
654 	unsigned short reg_val = 0;
655 	bool unsupported = false;
656 
657 	dev_dbg(chip->card->dev, "snd_azf3328_mixer_ac97_read reg_ac97 %u\n",
658 		reg_ac97);
659 	if (reg_azf & AZF_AC97_REG_UNSUPPORTED)
660 		unsupported = true;
661 	else {
662 		if (reg_azf & AZF_AC97_REG_REAL_IO_READ)
663 			reg_val = snd_azf3328_mixer_inw(chip,
664 						reg_azf & AZF_REG_MASK);
665 		else {
666 			/*
667 			 * Proceed with dummy I/O read,
668 			 * to ensure compatible timing where this may matter.
669 			 * (ALSA AC97 layer usually doesn't call I/O functions
670 			 * due to intelligent I/O caching anyway)
671 			 * Choose a mixer register that's thoroughly unrelated
672 			 * to common audio (try to minimize distortion).
673 			 */
674 			snd_azf3328_mixer_inw(chip, IDX_MIXER_SOMETHING30H);
675 		}
676 
677 		if (reg_azf & AZF_AC97_REG_EMU_IO_READ) {
678 			switch (reg_ac97) {
679 			case AC97_RESET:
680 				reg_val |= azf_emulated_ac97_caps;
681 				break;
682 			case AC97_POWERDOWN:
683 				reg_val |= azf_emulated_ac97_powerdown;
684 				break;
685 			case AC97_EXTENDED_ID:
686 			case AC97_EXTENDED_STATUS:
687 				/* AFAICS we simply can't support anything: */
688 				reg_val |= 0;
689 				break;
690 			case AC97_VENDOR_ID1:
691 				reg_val = azf_emulated_ac97_vendor_id >> 16;
692 				break;
693 			case AC97_VENDOR_ID2:
694 				reg_val = azf_emulated_ac97_vendor_id & 0xffff;
695 				break;
696 			default:
697 				unsupported = true;
698 				break;
699 			}
700 		}
701 	}
702 	if (unsupported)
703 		snd_azf3328_mixer_ac97_map_unsupported(chip, reg_ac97, "read");
704 
705 	return reg_val;
706 }
707 
708 static void
709 snd_azf3328_mixer_ac97_write(struct snd_ac97 *ac97,
710 		     unsigned short reg_ac97, unsigned short val)
711 {
712 	const struct snd_azf3328 *chip = ac97->private_data;
713 	unsigned short reg_azf = snd_azf3328_mixer_ac97_map_reg_idx(reg_ac97);
714 	bool unsupported = false;
715 
716 	dev_dbg(chip->card->dev,
717 		"snd_azf3328_mixer_ac97_write reg_ac97 %u val %u\n",
718 		reg_ac97, val);
719 	if (reg_azf & AZF_AC97_REG_UNSUPPORTED)
720 		unsupported = true;
721 	else {
722 		if (reg_azf & AZF_AC97_REG_REAL_IO_WRITE)
723 			snd_azf3328_mixer_outw(
724 				chip,
725 				reg_azf & AZF_REG_MASK,
726 				val
727 			);
728 		else
729 		if (reg_azf & AZF_AC97_REG_EMU_IO_WRITE) {
730 			switch (reg_ac97) {
731 			case AC97_REC_GAIN_MIC:
732 			case AC97_POWERDOWN:
733 			case AC97_EXTENDED_STATUS:
734 				/*
735 				 * Silently swallow these writes.
736 				 * Since for most registers our card doesn't
737 				 * actually support a comparable feature,
738 				 * this is exactly what we should do here.
739 				 * The AC97 layer's I/O caching probably
740 				 * automatically takes care of all the rest...
741 				 * (remembers written values etc.)
742 				 */
743 				break;
744 			default:
745 				unsupported = true;
746 				break;
747 			}
748 		}
749 	}
750 	if (unsupported)
751 		snd_azf3328_mixer_ac97_map_unsupported(chip, reg_ac97, "write");
752 }
753 
754 static int
755 snd_azf3328_mixer_new(struct snd_azf3328 *chip)
756 {
757 	struct snd_ac97_bus *bus;
758 	struct snd_ac97_template ac97;
759 	static const struct snd_ac97_bus_ops ops = {
760 		.write = snd_azf3328_mixer_ac97_write,
761 		.read = snd_azf3328_mixer_ac97_read,
762 	};
763 	int rc;
764 
765 	memset(&ac97, 0, sizeof(ac97));
766 	ac97.scaps = AC97_SCAP_SKIP_MODEM
767 			| AC97_SCAP_AUDIO /* we support audio! */
768 			| AC97_SCAP_NO_SPDIF;
769 	ac97.private_data = chip;
770 	ac97.pci = chip->pci;
771 
772 	/*
773 	 * ALSA's AC97 layer has terrible init crackling issues,
774 	 * unfortunately, and since it makes use of AC97_RESET,
775 	 * there's no use trying to mute Master Playback proactively.
776 	 */
777 
778 	rc = snd_ac97_bus(chip->card, 0, &ops, NULL, &bus);
779 	if (!rc)
780 		rc = snd_ac97_mixer(bus, &ac97, &chip->ac97);
781 		/*
782 		 * Make sure to complain loudly in case of AC97 init failure,
783 		 * since failure may happen quite often,
784 		 * due to this card being a very quirky AC97 "lookalike".
785 		 */
786 	if (rc)
787 		dev_err(chip->card->dev, "AC97 init failed, err %d!\n", rc);
788 
789 	/* If we return an error here, then snd_card_free() should
790 	 * free up any ac97 codecs that got created, as well as the bus.
791 	 */
792 	return rc;
793 }
794 #else /* AZF_USE_AC97_LAYER */
795 static void
796 snd_azf3328_mixer_write_volume_gradually(const struct snd_azf3328 *chip,
797 					 unsigned reg,
798 					 unsigned char dst_vol_left,
799 					 unsigned char dst_vol_right,
800 					 int chan_sel, int delay
801 )
802 {
803 	unsigned long portbase = chip->mixer_io + reg;
804 	unsigned char curr_vol_left = 0, curr_vol_right = 0;
805 	int left_change = 0, right_change = 0;
806 
807 	if (chan_sel & SET_CHAN_LEFT) {
808 		curr_vol_left  = inb(portbase + 1);
809 
810 		/* take care of muting flag contained in left channel */
811 		if (curr_vol_left & AZF_MUTE_BIT)
812 			dst_vol_left |= AZF_MUTE_BIT;
813 		else
814 			dst_vol_left &= ~AZF_MUTE_BIT;
815 
816 		left_change = (curr_vol_left > dst_vol_left) ? -1 : 1;
817 	}
818 
819 	if (chan_sel & SET_CHAN_RIGHT) {
820 		curr_vol_right = inb(portbase + 0);
821 
822 		right_change = (curr_vol_right > dst_vol_right) ? -1 : 1;
823 	}
824 
825 	do {
826 		if (left_change) {
827 			if (curr_vol_left != dst_vol_left) {
828 				curr_vol_left += left_change;
829 				outb(curr_vol_left, portbase + 1);
830 			} else
831 			    left_change = 0;
832 		}
833 		if (right_change) {
834 			if (curr_vol_right != dst_vol_right) {
835 				curr_vol_right += right_change;
836 
837 			/* during volume change, the right channel is crackling
838 			 * somewhat more than the left channel, unfortunately.
839 			 * This seems to be a hardware issue. */
840 				outb(curr_vol_right, portbase + 0);
841 			} else
842 			    right_change = 0;
843 		}
844 		if (delay)
845 			mdelay(delay);
846 	} while ((left_change) || (right_change));
847 }
848 
849 /*
850  * general mixer element
851  */
852 struct azf3328_mixer_reg {
853 	unsigned reg;
854 	unsigned int lchan_shift, rchan_shift;
855 	unsigned int mask;
856 	unsigned int invert: 1;
857 	unsigned int stereo: 1;
858 	unsigned int enum_c: 4;
859 };
860 
861 #define COMPOSE_MIXER_REG(reg,lchan_shift,rchan_shift,mask,invert,stereo,enum_c) \
862  ((reg) | (lchan_shift << 8) | (rchan_shift << 12) | \
863   (mask << 16) | \
864   (invert << 24) | \
865   (stereo << 25) | \
866   (enum_c << 26))
867 
868 static void snd_azf3328_mixer_reg_decode(struct azf3328_mixer_reg *r, unsigned long val)
869 {
870 	r->reg = val & 0xff;
871 	r->lchan_shift = (val >> 8) & 0x0f;
872 	r->rchan_shift = (val >> 12) & 0x0f;
873 	r->mask = (val >> 16) & 0xff;
874 	r->invert = (val >> 24) & 1;
875 	r->stereo = (val >> 25) & 1;
876 	r->enum_c = (val >> 26) & 0x0f;
877 }
878 
879 /*
880  * mixer switches/volumes
881  */
882 
883 #define AZF3328_MIXER_SWITCH(xname, reg, shift, invert) \
884 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
885   .info = snd_azf3328_info_mixer, \
886   .get = snd_azf3328_get_mixer, .put = snd_azf3328_put_mixer, \
887   .private_value = COMPOSE_MIXER_REG(reg, shift, 0, 0x1, invert, 0, 0), \
888 }
889 
890 #define AZF3328_MIXER_VOL_STEREO(xname, reg, mask, invert) \
891 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
892   .info = snd_azf3328_info_mixer, \
893   .get = snd_azf3328_get_mixer, .put = snd_azf3328_put_mixer, \
894   .private_value = COMPOSE_MIXER_REG(reg, 8, 0, mask, invert, 1, 0), \
895 }
896 
897 #define AZF3328_MIXER_VOL_MONO(xname, reg, mask, is_right_chan) \
898 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
899   .info = snd_azf3328_info_mixer, \
900   .get = snd_azf3328_get_mixer, .put = snd_azf3328_put_mixer, \
901   .private_value = COMPOSE_MIXER_REG(reg, is_right_chan ? 0 : 8, 0, mask, 1, 0, 0), \
902 }
903 
904 #define AZF3328_MIXER_VOL_SPECIAL(xname, reg, mask, shift, invert) \
905 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
906   .info = snd_azf3328_info_mixer, \
907   .get = snd_azf3328_get_mixer, .put = snd_azf3328_put_mixer, \
908   .private_value = COMPOSE_MIXER_REG(reg, shift, 0, mask, invert, 0, 0), \
909 }
910 
911 #define AZF3328_MIXER_ENUM(xname, reg, enum_c, shift) \
912 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
913   .info = snd_azf3328_info_mixer_enum, \
914   .get = snd_azf3328_get_mixer_enum, .put = snd_azf3328_put_mixer_enum, \
915   .private_value = COMPOSE_MIXER_REG(reg, shift, 0, 0, 0, 0, enum_c), \
916 }
917 
918 static int
919 snd_azf3328_info_mixer(struct snd_kcontrol *kcontrol,
920 		       struct snd_ctl_elem_info *uinfo)
921 {
922 	struct azf3328_mixer_reg reg;
923 
924 	snd_azf3328_mixer_reg_decode(&reg, kcontrol->private_value);
925 	uinfo->type = reg.mask == 1 ?
926 		SNDRV_CTL_ELEM_TYPE_BOOLEAN : SNDRV_CTL_ELEM_TYPE_INTEGER;
927 	uinfo->count = reg.stereo + 1;
928 	uinfo->value.integer.min = 0;
929 	uinfo->value.integer.max = reg.mask;
930 	return 0;
931 }
932 
933 static int
934 snd_azf3328_get_mixer(struct snd_kcontrol *kcontrol,
935 		      struct snd_ctl_elem_value *ucontrol)
936 {
937 	struct snd_azf3328 *chip = snd_kcontrol_chip(kcontrol);
938 	struct azf3328_mixer_reg reg;
939 	u16 oreg, val;
940 
941 	snd_azf3328_mixer_reg_decode(&reg, kcontrol->private_value);
942 
943 	oreg = snd_azf3328_mixer_inw(chip, reg.reg);
944 	val = (oreg >> reg.lchan_shift) & reg.mask;
945 	if (reg.invert)
946 		val = reg.mask - val;
947 	ucontrol->value.integer.value[0] = val;
948 	if (reg.stereo) {
949 		val = (oreg >> reg.rchan_shift) & reg.mask;
950 		if (reg.invert)
951 			val = reg.mask - val;
952 		ucontrol->value.integer.value[1] = val;
953 	}
954 	dev_dbg(chip->card->dev,
955 		"get: %02x is %04x -> vol %02lx|%02lx (shift %02d|%02d, mask %02x, inv. %d, stereo %d)\n",
956 		reg.reg, oreg,
957 		ucontrol->value.integer.value[0], ucontrol->value.integer.value[1],
958 		reg.lchan_shift, reg.rchan_shift, reg.mask, reg.invert, reg.stereo);
959 	return 0;
960 }
961 
962 static int
963 snd_azf3328_put_mixer(struct snd_kcontrol *kcontrol,
964 		      struct snd_ctl_elem_value *ucontrol)
965 {
966 	struct snd_azf3328 *chip = snd_kcontrol_chip(kcontrol);
967 	struct azf3328_mixer_reg reg;
968 	u16 oreg, nreg, val;
969 
970 	snd_azf3328_mixer_reg_decode(&reg, kcontrol->private_value);
971 	oreg = snd_azf3328_mixer_inw(chip, reg.reg);
972 	val = ucontrol->value.integer.value[0] & reg.mask;
973 	if (reg.invert)
974 		val = reg.mask - val;
975 	nreg = oreg & ~(reg.mask << reg.lchan_shift);
976 	nreg |= (val << reg.lchan_shift);
977 	if (reg.stereo) {
978 		val = ucontrol->value.integer.value[1] & reg.mask;
979 		if (reg.invert)
980 			val = reg.mask - val;
981 		nreg &= ~(reg.mask << reg.rchan_shift);
982 		nreg |= (val << reg.rchan_shift);
983 	}
984 	if (reg.mask >= 0x07) /* it's a volume control, so better take care */
985 		snd_azf3328_mixer_write_volume_gradually(
986 			chip, reg.reg, nreg >> 8, nreg & 0xff,
987 			/* just set both channels, doesn't matter */
988 			SET_CHAN_LEFT|SET_CHAN_RIGHT,
989 			0);
990 	else
991         	snd_azf3328_mixer_outw(chip, reg.reg, nreg);
992 
993 	dev_dbg(chip->card->dev,
994 		"put: %02x to %02lx|%02lx, oreg %04x; shift %02d|%02d -> nreg %04x; after: %04x\n",
995 		reg.reg, ucontrol->value.integer.value[0], ucontrol->value.integer.value[1],
996 		oreg, reg.lchan_shift, reg.rchan_shift,
997 		nreg, snd_azf3328_mixer_inw(chip, reg.reg));
998 	return (nreg != oreg);
999 }
1000 
1001 static int
1002 snd_azf3328_info_mixer_enum(struct snd_kcontrol *kcontrol,
1003 			    struct snd_ctl_elem_info *uinfo)
1004 {
1005 	static const char * const texts1[] = {
1006 		"Mic1", "Mic2"
1007 	};
1008 	static const char * const texts2[] = {
1009 		"Mix", "Mic"
1010 	};
1011 	static const char * const texts3[] = {
1012 		"Mic", "CD", "Video", "Aux",
1013 		"Line", "Mix", "Mix Mono", "Phone"
1014         };
1015 	static const char * const texts4[] = {
1016 		"pre 3D", "post 3D"
1017         };
1018 	struct azf3328_mixer_reg reg;
1019 	const char * const *p = NULL;
1020 
1021 	snd_azf3328_mixer_reg_decode(&reg, kcontrol->private_value);
1022 	if (reg.reg == IDX_MIXER_ADVCTL2) {
1023 		switch(reg.lchan_shift) {
1024 		case 8: /* modem out sel */
1025 			p = texts1;
1026 			break;
1027 		case 9: /* mono sel source */
1028 			p = texts2;
1029 			break;
1030 		case 15: /* PCM Out Path */
1031 			p = texts4;
1032 			break;
1033 		}
1034 	} else if (reg.reg == IDX_MIXER_REC_SELECT)
1035 		p = texts3;
1036 
1037 	return snd_ctl_enum_info(uinfo,
1038 				 (reg.reg == IDX_MIXER_REC_SELECT) ? 2 : 1,
1039 				 reg.enum_c, p);
1040 }
1041 
1042 static int
1043 snd_azf3328_get_mixer_enum(struct snd_kcontrol *kcontrol,
1044 			   struct snd_ctl_elem_value *ucontrol)
1045 {
1046         struct snd_azf3328 *chip = snd_kcontrol_chip(kcontrol);
1047 	struct azf3328_mixer_reg reg;
1048         unsigned short val;
1049 
1050 	snd_azf3328_mixer_reg_decode(&reg, kcontrol->private_value);
1051 	val = snd_azf3328_mixer_inw(chip, reg.reg);
1052 	if (reg.reg == IDX_MIXER_REC_SELECT) {
1053         	ucontrol->value.enumerated.item[0] = (val >> 8) & (reg.enum_c - 1);
1054         	ucontrol->value.enumerated.item[1] = (val >> 0) & (reg.enum_c - 1);
1055 	} else
1056         	ucontrol->value.enumerated.item[0] = (val >> reg.lchan_shift) & (reg.enum_c - 1);
1057 
1058 	dev_dbg(chip->card->dev,
1059 		"get_enum: %02x is %04x -> %d|%d (shift %02d, enum_c %d)\n",
1060 		reg.reg, val, ucontrol->value.enumerated.item[0], ucontrol->value.enumerated.item[1],
1061 		reg.lchan_shift, reg.enum_c);
1062         return 0;
1063 }
1064 
1065 static int
1066 snd_azf3328_put_mixer_enum(struct snd_kcontrol *kcontrol,
1067 			   struct snd_ctl_elem_value *ucontrol)
1068 {
1069         struct snd_azf3328 *chip = snd_kcontrol_chip(kcontrol);
1070 	struct azf3328_mixer_reg reg;
1071 	u16 oreg, nreg, val;
1072 
1073 	snd_azf3328_mixer_reg_decode(&reg, kcontrol->private_value);
1074 	oreg = snd_azf3328_mixer_inw(chip, reg.reg);
1075 	val = oreg;
1076 	if (reg.reg == IDX_MIXER_REC_SELECT) {
1077         	if (ucontrol->value.enumerated.item[0] > reg.enum_c - 1U ||
1078             	ucontrol->value.enumerated.item[1] > reg.enum_c - 1U)
1079                 	return -EINVAL;
1080         	val = (ucontrol->value.enumerated.item[0] << 8) |
1081         	      (ucontrol->value.enumerated.item[1] << 0);
1082 	} else {
1083         	if (ucontrol->value.enumerated.item[0] > reg.enum_c - 1U)
1084                 	return -EINVAL;
1085 		val &= ~((reg.enum_c - 1) << reg.lchan_shift);
1086         	val |= (ucontrol->value.enumerated.item[0] << reg.lchan_shift);
1087 	}
1088 	snd_azf3328_mixer_outw(chip, reg.reg, val);
1089 	nreg = val;
1090 
1091 	dev_dbg(chip->card->dev,
1092 		"put_enum: %02x to %04x, oreg %04x\n", reg.reg, val, oreg);
1093 	return (nreg != oreg);
1094 }
1095 
1096 static const struct snd_kcontrol_new snd_azf3328_mixer_controls[] = {
1097 	AZF3328_MIXER_SWITCH("Master Playback Switch", IDX_MIXER_PLAY_MASTER, 15, 1),
1098 	AZF3328_MIXER_VOL_STEREO("Master Playback Volume", IDX_MIXER_PLAY_MASTER, 0x1f, 1),
1099 	AZF3328_MIXER_SWITCH("PCM Playback Switch", IDX_MIXER_WAVEOUT, 15, 1),
1100 	AZF3328_MIXER_VOL_STEREO("PCM Playback Volume",
1101 					IDX_MIXER_WAVEOUT, 0x1f, 1),
1102 	AZF3328_MIXER_SWITCH("PCM 3D Bypass Playback Switch",
1103 					IDX_MIXER_ADVCTL2, 7, 1),
1104 	AZF3328_MIXER_SWITCH("FM Playback Switch", IDX_MIXER_FMSYNTH, 15, 1),
1105 	AZF3328_MIXER_VOL_STEREO("FM Playback Volume", IDX_MIXER_FMSYNTH, 0x1f, 1),
1106 	AZF3328_MIXER_SWITCH("CD Playback Switch", IDX_MIXER_CDAUDIO, 15, 1),
1107 	AZF3328_MIXER_VOL_STEREO("CD Playback Volume", IDX_MIXER_CDAUDIO, 0x1f, 1),
1108 	AZF3328_MIXER_SWITCH("Capture Switch", IDX_MIXER_REC_VOLUME, 15, 1),
1109 	AZF3328_MIXER_VOL_STEREO("Capture Volume", IDX_MIXER_REC_VOLUME, 0x0f, 0),
1110 	AZF3328_MIXER_ENUM("Capture Source", IDX_MIXER_REC_SELECT, 8, 0),
1111 	AZF3328_MIXER_SWITCH("Mic Playback Switch", IDX_MIXER_MIC, 15, 1),
1112 	AZF3328_MIXER_VOL_MONO("Mic Playback Volume", IDX_MIXER_MIC, 0x1f, 1),
1113 	AZF3328_MIXER_SWITCH("Mic Boost (+20dB)", IDX_MIXER_MIC, 6, 0),
1114 	AZF3328_MIXER_SWITCH("Line Playback Switch", IDX_MIXER_LINEIN, 15, 1),
1115 	AZF3328_MIXER_VOL_STEREO("Line Playback Volume", IDX_MIXER_LINEIN, 0x1f, 1),
1116 	AZF3328_MIXER_SWITCH("Beep Playback Switch", IDX_MIXER_PCBEEP, 15, 1),
1117 	AZF3328_MIXER_VOL_SPECIAL("Beep Playback Volume", IDX_MIXER_PCBEEP, 0x0f, 1, 1),
1118 	AZF3328_MIXER_SWITCH("Video Playback Switch", IDX_MIXER_VIDEO, 15, 1),
1119 	AZF3328_MIXER_VOL_STEREO("Video Playback Volume", IDX_MIXER_VIDEO, 0x1f, 1),
1120 	AZF3328_MIXER_SWITCH("Aux Playback Switch", IDX_MIXER_AUX, 15, 1),
1121 	AZF3328_MIXER_VOL_STEREO("Aux Playback Volume", IDX_MIXER_AUX, 0x1f, 1),
1122 	AZF3328_MIXER_SWITCH("Modem Playback Switch", IDX_MIXER_MODEMOUT, 15, 1),
1123 	AZF3328_MIXER_VOL_MONO("Modem Playback Volume", IDX_MIXER_MODEMOUT, 0x1f, 1),
1124 	AZF3328_MIXER_SWITCH("Modem Capture Switch", IDX_MIXER_MODEMIN, 15, 1),
1125 	AZF3328_MIXER_VOL_MONO("Modem Capture Volume", IDX_MIXER_MODEMIN, 0x1f, 1),
1126 	AZF3328_MIXER_ENUM("Mic Select", IDX_MIXER_ADVCTL2, 2, 8),
1127 	AZF3328_MIXER_ENUM("Mono Output Select", IDX_MIXER_ADVCTL2, 2, 9),
1128 	AZF3328_MIXER_ENUM("PCM Output Route", IDX_MIXER_ADVCTL2, 2, 15), /* PCM Out Path, place in front since it controls *both* 3D and Bass/Treble! */
1129 	AZF3328_MIXER_VOL_SPECIAL("Tone Control - Treble", IDX_MIXER_BASSTREBLE, 0x07, 1, 0),
1130 	AZF3328_MIXER_VOL_SPECIAL("Tone Control - Bass", IDX_MIXER_BASSTREBLE, 0x07, 9, 0),
1131 	AZF3328_MIXER_SWITCH("3D Control - Switch", IDX_MIXER_ADVCTL2, 13, 0),
1132 	AZF3328_MIXER_VOL_SPECIAL("3D Control - Width", IDX_MIXER_ADVCTL1, 0x07, 1, 0), /* "3D Width" */
1133 	AZF3328_MIXER_VOL_SPECIAL("3D Control - Depth", IDX_MIXER_ADVCTL1, 0x03, 8, 0), /* "Hifi 3D" */
1134 #if MIXER_TESTING
1135 	AZF3328_MIXER_SWITCH("0", IDX_MIXER_ADVCTL2, 0, 0),
1136 	AZF3328_MIXER_SWITCH("1", IDX_MIXER_ADVCTL2, 1, 0),
1137 	AZF3328_MIXER_SWITCH("2", IDX_MIXER_ADVCTL2, 2, 0),
1138 	AZF3328_MIXER_SWITCH("3", IDX_MIXER_ADVCTL2, 3, 0),
1139 	AZF3328_MIXER_SWITCH("4", IDX_MIXER_ADVCTL2, 4, 0),
1140 	AZF3328_MIXER_SWITCH("5", IDX_MIXER_ADVCTL2, 5, 0),
1141 	AZF3328_MIXER_SWITCH("6", IDX_MIXER_ADVCTL2, 6, 0),
1142 	AZF3328_MIXER_SWITCH("7", IDX_MIXER_ADVCTL2, 7, 0),
1143 	AZF3328_MIXER_SWITCH("8", IDX_MIXER_ADVCTL2, 8, 0),
1144 	AZF3328_MIXER_SWITCH("9", IDX_MIXER_ADVCTL2, 9, 0),
1145 	AZF3328_MIXER_SWITCH("10", IDX_MIXER_ADVCTL2, 10, 0),
1146 	AZF3328_MIXER_SWITCH("11", IDX_MIXER_ADVCTL2, 11, 0),
1147 	AZF3328_MIXER_SWITCH("12", IDX_MIXER_ADVCTL2, 12, 0),
1148 	AZF3328_MIXER_SWITCH("13", IDX_MIXER_ADVCTL2, 13, 0),
1149 	AZF3328_MIXER_SWITCH("14", IDX_MIXER_ADVCTL2, 14, 0),
1150 	AZF3328_MIXER_SWITCH("15", IDX_MIXER_ADVCTL2, 15, 0),
1151 #endif
1152 };
1153 
1154 static const u16 snd_azf3328_init_values[][2] = {
1155         { IDX_MIXER_PLAY_MASTER,	MIXER_MUTE_MASK|0x1f1f },
1156         { IDX_MIXER_MODEMOUT,		MIXER_MUTE_MASK|0x1f1f },
1157 	{ IDX_MIXER_BASSTREBLE,		0x0000 },
1158 	{ IDX_MIXER_PCBEEP,		MIXER_MUTE_MASK|0x1f1f },
1159 	{ IDX_MIXER_MODEMIN,		MIXER_MUTE_MASK|0x1f1f },
1160 	{ IDX_MIXER_MIC,		MIXER_MUTE_MASK|0x001f },
1161 	{ IDX_MIXER_LINEIN,		MIXER_MUTE_MASK|0x1f1f },
1162 	{ IDX_MIXER_CDAUDIO,		MIXER_MUTE_MASK|0x1f1f },
1163 	{ IDX_MIXER_VIDEO,		MIXER_MUTE_MASK|0x1f1f },
1164 	{ IDX_MIXER_AUX,		MIXER_MUTE_MASK|0x1f1f },
1165         { IDX_MIXER_WAVEOUT,		MIXER_MUTE_MASK|0x1f1f },
1166         { IDX_MIXER_FMSYNTH,		MIXER_MUTE_MASK|0x1f1f },
1167         { IDX_MIXER_REC_VOLUME,		MIXER_MUTE_MASK|0x0707 },
1168 };
1169 
1170 static int
1171 snd_azf3328_mixer_new(struct snd_azf3328 *chip)
1172 {
1173 	struct snd_card *card;
1174 	const struct snd_kcontrol_new *sw;
1175 	unsigned int idx;
1176 	int err;
1177 
1178 	if (snd_BUG_ON(!chip || !chip->card))
1179 		return -EINVAL;
1180 
1181 	card = chip->card;
1182 
1183 	/* mixer reset */
1184 	snd_azf3328_mixer_outw(chip, IDX_MIXER_RESET, 0x0000);
1185 
1186 	/* mute and zero volume channels */
1187 	for (idx = 0; idx < ARRAY_SIZE(snd_azf3328_init_values); ++idx) {
1188 		snd_azf3328_mixer_outw(chip,
1189 			snd_azf3328_init_values[idx][0],
1190 			snd_azf3328_init_values[idx][1]);
1191 	}
1192 
1193 	/* add mixer controls */
1194 	sw = snd_azf3328_mixer_controls;
1195 	for (idx = 0; idx < ARRAY_SIZE(snd_azf3328_mixer_controls);
1196 			++idx, ++sw) {
1197 		err = snd_ctl_add(chip->card, snd_ctl_new1(sw, chip));
1198 		if (err < 0)
1199 			return err;
1200 	}
1201 	snd_component_add(card, "AZF3328 mixer");
1202 	strcpy(card->mixername, "AZF3328 mixer");
1203 
1204 	return 0;
1205 }
1206 #endif /* AZF_USE_AC97_LAYER */
1207 
1208 static void
1209 snd_azf3328_codec_setfmt(struct snd_azf3328_codec_data *codec,
1210 			       enum azf_freq_t bitrate,
1211 			       unsigned int format_width,
1212 			       unsigned int channels
1213 )
1214 {
1215 	unsigned long flags;
1216 	u16 val = 0xff00;
1217 	u8 freq = 0;
1218 
1219 	switch (bitrate) {
1220 	case AZF_FREQ_4000:  freq = SOUNDFORMAT_FREQ_SUSPECTED_4000; break;
1221 	case AZF_FREQ_4800:  freq = SOUNDFORMAT_FREQ_SUSPECTED_4800; break;
1222 	case AZF_FREQ_5512:
1223 		/* the AZF3328 names it "5510" for some strange reason */
1224 			     freq = SOUNDFORMAT_FREQ_5510; break;
1225 	case AZF_FREQ_6620:  freq = SOUNDFORMAT_FREQ_6620; break;
1226 	case AZF_FREQ_8000:  freq = SOUNDFORMAT_FREQ_8000; break;
1227 	case AZF_FREQ_9600:  freq = SOUNDFORMAT_FREQ_9600; break;
1228 	case AZF_FREQ_11025: freq = SOUNDFORMAT_FREQ_11025; break;
1229 	case AZF_FREQ_13240: freq = SOUNDFORMAT_FREQ_SUSPECTED_13240; break;
1230 	case AZF_FREQ_16000: freq = SOUNDFORMAT_FREQ_16000; break;
1231 	case AZF_FREQ_22050: freq = SOUNDFORMAT_FREQ_22050; break;
1232 	case AZF_FREQ_32000: freq = SOUNDFORMAT_FREQ_32000; break;
1233 	default:
1234 		snd_printk(KERN_WARNING "unknown bitrate %d, assuming 44.1kHz!\n", bitrate);
1235 		fallthrough;
1236 	case AZF_FREQ_44100: freq = SOUNDFORMAT_FREQ_44100; break;
1237 	case AZF_FREQ_48000: freq = SOUNDFORMAT_FREQ_48000; break;
1238 	case AZF_FREQ_66200: freq = SOUNDFORMAT_FREQ_SUSPECTED_66200; break;
1239 	}
1240 	/* val = 0xff07; 3m27.993s (65301Hz; -> 64000Hz???) hmm, 66120, 65967, 66123 */
1241 	/* val = 0xff09; 17m15.098s (13123,478Hz; -> 12000Hz???) hmm, 13237.2Hz? */
1242 	/* val = 0xff0a; 47m30.599s (4764,891Hz; -> 4800Hz???) yup, 4803Hz */
1243 	/* val = 0xff0c; 57m0.510s (4010,263Hz; -> 4000Hz???) yup, 4003Hz */
1244 	/* val = 0xff05; 5m11.556s (... -> 44100Hz) */
1245 	/* val = 0xff03; 10m21.529s (21872,463Hz; -> 22050Hz???) */
1246 	/* val = 0xff0f; 20m41.883s (10937,993Hz; -> 11025Hz???) */
1247 	/* val = 0xff0d; 41m23.135s (5523,600Hz; -> 5512Hz???) */
1248 	/* val = 0xff0e; 28m30.777s (8017Hz; -> 8000Hz???) */
1249 
1250 	val |= freq;
1251 
1252 	if (channels == 2)
1253 		val |= SOUNDFORMAT_FLAG_2CHANNELS;
1254 
1255 	if (format_width == 16)
1256 		val |= SOUNDFORMAT_FLAG_16BIT;
1257 
1258 	spin_lock_irqsave(codec->lock, flags);
1259 
1260 	/* set bitrate/format */
1261 	snd_azf3328_codec_outw(codec, IDX_IO_CODEC_SOUNDFORMAT, val);
1262 
1263 	/* changing the bitrate/format settings switches off the
1264 	 * audio output with an annoying click in case of 8/16bit format change
1265 	 * (maybe shutting down DAC/ADC?), thus immediately
1266 	 * do some tweaking to reenable it and get rid of the clicking
1267 	 * (FIXME: yes, it works, but what exactly am I doing here?? :)
1268 	 * FIXME: does this have some side effects for full-duplex
1269 	 * or other dramatic side effects? */
1270 	/* do it for non-capture codecs only */
1271 	if (codec->type != AZF_CODEC_CAPTURE)
1272 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS,
1273 			snd_azf3328_codec_inw(codec, IDX_IO_CODEC_DMA_FLAGS) |
1274 			DMA_RUN_SOMETHING1 |
1275 			DMA_RUN_SOMETHING2 |
1276 			SOMETHING_ALMOST_ALWAYS_SET |
1277 			DMA_EPILOGUE_SOMETHING |
1278 			DMA_SOMETHING_ELSE
1279 		);
1280 
1281 	spin_unlock_irqrestore(codec->lock, flags);
1282 }
1283 
1284 static inline void
1285 snd_azf3328_codec_setfmt_lowpower(struct snd_azf3328_codec_data *codec
1286 )
1287 {
1288 	/* choose lowest frequency for low power consumption.
1289 	 * While this will cause louder noise due to rather coarse frequency,
1290 	 * it should never matter since output should always
1291 	 * get disabled properly when idle anyway. */
1292 	snd_azf3328_codec_setfmt(codec, AZF_FREQ_4000, 8, 1);
1293 }
1294 
1295 static void
1296 snd_azf3328_ctrl_reg_6AH_update(struct snd_azf3328 *chip,
1297 					unsigned bitmask,
1298 					bool enable
1299 )
1300 {
1301 	bool do_mask = !enable;
1302 	if (do_mask)
1303 		chip->shadow_reg_ctrl_6AH |= bitmask;
1304 	else
1305 		chip->shadow_reg_ctrl_6AH &= ~bitmask;
1306 	dev_dbg(chip->card->dev,
1307 		"6AH_update mask 0x%04x do_mask %d: val 0x%04x\n",
1308 		bitmask, do_mask, chip->shadow_reg_ctrl_6AH);
1309 	snd_azf3328_ctrl_outw(chip, IDX_IO_6AH, chip->shadow_reg_ctrl_6AH);
1310 }
1311 
1312 static inline void
1313 snd_azf3328_ctrl_enable_codecs(struct snd_azf3328 *chip, bool enable)
1314 {
1315 	dev_dbg(chip->card->dev, "codec_enable %d\n", enable);
1316 	/* no idea what exactly is being done here, but I strongly assume it's
1317 	 * PM related */
1318 	snd_azf3328_ctrl_reg_6AH_update(
1319 		chip, IO_6A_PAUSE_PLAYBACK_BIT8, enable
1320 	);
1321 }
1322 
1323 static void
1324 snd_azf3328_ctrl_codec_activity(struct snd_azf3328 *chip,
1325 				enum snd_azf3328_codec_type codec_type,
1326 				bool enable
1327 )
1328 {
1329 	struct snd_azf3328_codec_data *codec = &chip->codecs[codec_type];
1330 	bool need_change = (codec->running != enable);
1331 
1332 	dev_dbg(chip->card->dev,
1333 		"codec_activity: %s codec, enable %d, need_change %d\n",
1334 				codec->name, enable, need_change
1335 	);
1336 	if (need_change) {
1337 		static const struct {
1338 			enum snd_azf3328_codec_type other1;
1339 			enum snd_azf3328_codec_type other2;
1340 		} peer_codecs[3] =
1341 			{ { AZF_CODEC_CAPTURE, AZF_CODEC_I2S_OUT },
1342 			  { AZF_CODEC_PLAYBACK, AZF_CODEC_I2S_OUT },
1343 			  { AZF_CODEC_PLAYBACK, AZF_CODEC_CAPTURE } };
1344 		bool call_function;
1345 
1346 		if (enable)
1347 			/* if enable codec, call enable_codecs func
1348 			   to enable codec supply... */
1349 			call_function = 1;
1350 		else {
1351 			/* ...otherwise call enable_codecs func
1352 			   (which globally shuts down operation of codecs)
1353 			   only in case the other codecs are currently
1354 			   not active either! */
1355 			call_function =
1356 				((!chip->codecs[peer_codecs[codec_type].other1]
1357 					.running)
1358 			     &&  (!chip->codecs[peer_codecs[codec_type].other2]
1359 					.running));
1360 		}
1361 		if (call_function)
1362 			snd_azf3328_ctrl_enable_codecs(chip, enable);
1363 
1364 		/* ...and adjust clock, too
1365 		 * (reduce noise and power consumption) */
1366 		if (!enable)
1367 			snd_azf3328_codec_setfmt_lowpower(codec);
1368 		codec->running = enable;
1369 	}
1370 }
1371 
1372 static void
1373 snd_azf3328_codec_setdmaa(struct snd_azf3328 *chip,
1374 			  struct snd_azf3328_codec_data *codec,
1375 			  unsigned long addr,
1376 			  unsigned int period_bytes,
1377 			  unsigned int buffer_bytes
1378 )
1379 {
1380 	WARN_ONCE(period_bytes & 1, "odd period length!?\n");
1381 	WARN_ONCE(buffer_bytes != 2 * period_bytes,
1382 		 "missed our input expectations! %u vs. %u\n",
1383 		 buffer_bytes, period_bytes);
1384 	if (!codec->running) {
1385 		/* AZF3328 uses a two buffer pointer DMA transfer approach */
1386 
1387 		unsigned long flags;
1388 
1389 		/* width 32bit (prevent overflow): */
1390 		u32 area_length;
1391 		struct codec_setup_io {
1392 			u32 dma_start_1;
1393 			u32 dma_start_2;
1394 			u32 dma_lengths;
1395 		} __attribute__((packed)) setup_io;
1396 
1397 		area_length = buffer_bytes/2;
1398 
1399 		setup_io.dma_start_1 = addr;
1400 		setup_io.dma_start_2 = addr+area_length;
1401 
1402 		dev_dbg(chip->card->dev,
1403 			"setdma: buffers %08x[%u] / %08x[%u], %u, %u\n",
1404 				setup_io.dma_start_1, area_length,
1405 				setup_io.dma_start_2, area_length,
1406 				period_bytes, buffer_bytes);
1407 
1408 		/* Hmm, are we really supposed to decrement this by 1??
1409 		   Most definitely certainly not: configuring full length does
1410 		   work properly (i.e. likely better), and BTW we
1411 		   violated possibly differing frame sizes with this...
1412 
1413 		area_length--; |* max. index *|
1414 		*/
1415 
1416 		/* build combined I/O buffer length word */
1417 		setup_io.dma_lengths = (area_length << 16) | (area_length);
1418 
1419 		spin_lock_irqsave(codec->lock, flags);
1420 		snd_azf3328_codec_outl_multi(
1421 			codec, IDX_IO_CODEC_DMA_START_1, &setup_io, 3
1422 		);
1423 		spin_unlock_irqrestore(codec->lock, flags);
1424 	}
1425 }
1426 
1427 static int
1428 snd_azf3328_pcm_prepare(struct snd_pcm_substream *substream)
1429 {
1430 	struct snd_pcm_runtime *runtime = substream->runtime;
1431 	struct snd_azf3328_codec_data *codec = runtime->private_data;
1432 #if 0
1433         unsigned int size = snd_pcm_lib_buffer_bytes(substream);
1434 	unsigned int count = snd_pcm_lib_period_bytes(substream);
1435 #endif
1436 
1437 	codec->dma_base = runtime->dma_addr;
1438 
1439 #if 0
1440 	snd_azf3328_codec_setfmt(codec,
1441 		runtime->rate,
1442 		snd_pcm_format_width(runtime->format),
1443 		runtime->channels);
1444 	snd_azf3328_codec_setdmaa(chip, codec,
1445 					runtime->dma_addr, count, size);
1446 #endif
1447 	return 0;
1448 }
1449 
1450 static int
1451 snd_azf3328_pcm_trigger(struct snd_pcm_substream *substream, int cmd)
1452 {
1453 	struct snd_azf3328 *chip = snd_pcm_substream_chip(substream);
1454 	struct snd_pcm_runtime *runtime = substream->runtime;
1455 	struct snd_azf3328_codec_data *codec = runtime->private_data;
1456 	int result = 0;
1457 	u16 flags1;
1458 	bool previously_muted = false;
1459 	bool is_main_mixer_playback_codec = (AZF_CODEC_PLAYBACK == codec->type);
1460 
1461 	switch (cmd) {
1462 	case SNDRV_PCM_TRIGGER_START:
1463 		dev_dbg(chip->card->dev, "START PCM %s\n", codec->name);
1464 
1465 		if (is_main_mixer_playback_codec) {
1466 			/* mute WaveOut (avoid clicking during setup) */
1467 			previously_muted =
1468 				snd_azf3328_mixer_mute_control_pcm(
1469 						chip, 1
1470 				);
1471 		}
1472 
1473 		snd_azf3328_codec_setfmt(codec,
1474 			runtime->rate,
1475 			snd_pcm_format_width(runtime->format),
1476 			runtime->channels);
1477 
1478 		spin_lock(codec->lock);
1479 		/* first, remember current value: */
1480 		flags1 = snd_azf3328_codec_inw(codec, IDX_IO_CODEC_DMA_FLAGS);
1481 
1482 		/* stop transfer */
1483 		flags1 &= ~DMA_RESUME;
1484 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS, flags1);
1485 
1486 		/* FIXME: clear interrupts or what??? */
1487 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_IRQTYPE, 0xffff);
1488 		spin_unlock(codec->lock);
1489 
1490 		snd_azf3328_codec_setdmaa(chip, codec, runtime->dma_addr,
1491 			snd_pcm_lib_period_bytes(substream),
1492 			snd_pcm_lib_buffer_bytes(substream)
1493 		);
1494 
1495 		spin_lock(codec->lock);
1496 #ifdef WIN9X
1497 		/* FIXME: enable playback/recording??? */
1498 		flags1 |= DMA_RUN_SOMETHING1 | DMA_RUN_SOMETHING2;
1499 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS, flags1);
1500 
1501 		/* start transfer again */
1502 		/* FIXME: what is this value (0x0010)??? */
1503 		flags1 |= DMA_RESUME | DMA_EPILOGUE_SOMETHING;
1504 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS, flags1);
1505 #else /* NT4 */
1506 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS,
1507 			0x0000);
1508 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS,
1509 			DMA_RUN_SOMETHING1);
1510 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS,
1511 			DMA_RUN_SOMETHING1 |
1512 			DMA_RUN_SOMETHING2);
1513 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS,
1514 			DMA_RESUME |
1515 			SOMETHING_ALMOST_ALWAYS_SET |
1516 			DMA_EPILOGUE_SOMETHING |
1517 			DMA_SOMETHING_ELSE);
1518 #endif
1519 		spin_unlock(codec->lock);
1520 		snd_azf3328_ctrl_codec_activity(chip, codec->type, 1);
1521 
1522 		if (is_main_mixer_playback_codec) {
1523 			/* now unmute WaveOut */
1524 			if (!previously_muted)
1525 				snd_azf3328_mixer_mute_control_pcm(
1526 						chip, 0
1527 				);
1528 		}
1529 
1530 		dev_dbg(chip->card->dev, "PCM STARTED %s\n", codec->name);
1531 		break;
1532 	case SNDRV_PCM_TRIGGER_RESUME:
1533 		dev_dbg(chip->card->dev, "PCM RESUME %s\n", codec->name);
1534 		/* resume codec if we were active */
1535 		spin_lock(codec->lock);
1536 		if (codec->running)
1537 			snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS,
1538 				snd_azf3328_codec_inw(
1539 					codec, IDX_IO_CODEC_DMA_FLAGS
1540 				) | DMA_RESUME
1541 			);
1542 		spin_unlock(codec->lock);
1543 		break;
1544 	case SNDRV_PCM_TRIGGER_STOP:
1545 		dev_dbg(chip->card->dev, "PCM STOP %s\n", codec->name);
1546 
1547 		if (is_main_mixer_playback_codec) {
1548 			/* mute WaveOut (avoid clicking during setup) */
1549 			previously_muted =
1550 				snd_azf3328_mixer_mute_control_pcm(
1551 						chip, 1
1552 				);
1553 		}
1554 
1555 		spin_lock(codec->lock);
1556 		/* first, remember current value: */
1557 		flags1 = snd_azf3328_codec_inw(codec, IDX_IO_CODEC_DMA_FLAGS);
1558 
1559 		/* stop transfer */
1560 		flags1 &= ~DMA_RESUME;
1561 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS, flags1);
1562 
1563 		/* hmm, is this really required? we're resetting the same bit
1564 		 * immediately thereafter... */
1565 		flags1 |= DMA_RUN_SOMETHING1;
1566 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS, flags1);
1567 
1568 		flags1 &= ~DMA_RUN_SOMETHING1;
1569 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS, flags1);
1570 		spin_unlock(codec->lock);
1571 		snd_azf3328_ctrl_codec_activity(chip, codec->type, 0);
1572 
1573 		if (is_main_mixer_playback_codec) {
1574 			/* now unmute WaveOut */
1575 			if (!previously_muted)
1576 				snd_azf3328_mixer_mute_control_pcm(
1577 						chip, 0
1578 				);
1579 		}
1580 
1581 		dev_dbg(chip->card->dev, "PCM STOPPED %s\n", codec->name);
1582 		break;
1583 	case SNDRV_PCM_TRIGGER_SUSPEND:
1584 		dev_dbg(chip->card->dev, "PCM SUSPEND %s\n", codec->name);
1585 		/* make sure codec is stopped */
1586 		snd_azf3328_codec_outw(codec, IDX_IO_CODEC_DMA_FLAGS,
1587 			snd_azf3328_codec_inw(
1588 				codec, IDX_IO_CODEC_DMA_FLAGS
1589 			) & ~DMA_RESUME
1590 		);
1591 		break;
1592         case SNDRV_PCM_TRIGGER_PAUSE_PUSH:
1593 		WARN(1, "FIXME: SNDRV_PCM_TRIGGER_PAUSE_PUSH NIY!\n");
1594                 break;
1595         case SNDRV_PCM_TRIGGER_PAUSE_RELEASE:
1596 		WARN(1, "FIXME: SNDRV_PCM_TRIGGER_PAUSE_RELEASE NIY!\n");
1597                 break;
1598         default:
1599 		WARN(1, "FIXME: unknown trigger mode!\n");
1600                 return -EINVAL;
1601 	}
1602 
1603 	return result;
1604 }
1605 
1606 static snd_pcm_uframes_t
1607 snd_azf3328_pcm_pointer(struct snd_pcm_substream *substream
1608 )
1609 {
1610 	const struct snd_azf3328_codec_data *codec =
1611 		substream->runtime->private_data;
1612 	unsigned long result;
1613 	snd_pcm_uframes_t frmres;
1614 
1615 	result = snd_azf3328_codec_inl(codec, IDX_IO_CODEC_DMA_CURRPOS);
1616 
1617 	/* calculate offset */
1618 #ifdef QUERY_HARDWARE
1619 	result -= snd_azf3328_codec_inl(codec, IDX_IO_CODEC_DMA_START_1);
1620 #else
1621 	result -= codec->dma_base;
1622 #endif
1623 	frmres = bytes_to_frames( substream->runtime, result);
1624 	dev_dbg(substream->pcm->card->dev, "%08li %s @ 0x%8lx, frames %8ld\n",
1625 		jiffies, codec->name, result, frmres);
1626 	return frmres;
1627 }
1628 
1629 /******************************************************************/
1630 
1631 #ifdef SUPPORT_GAMEPORT
1632 static inline void
1633 snd_azf3328_gameport_irq_enable(struct snd_azf3328 *chip,
1634 				bool enable
1635 )
1636 {
1637 	snd_azf3328_io_reg_setb(
1638 		chip->game_io+IDX_GAME_HWCONFIG,
1639 		GAME_HWCFG_IRQ_ENABLE,
1640 		enable
1641 	);
1642 }
1643 
1644 static inline void
1645 snd_azf3328_gameport_legacy_address_enable(struct snd_azf3328 *chip,
1646 					   bool enable
1647 )
1648 {
1649 	snd_azf3328_io_reg_setb(
1650 		chip->game_io+IDX_GAME_HWCONFIG,
1651 		GAME_HWCFG_LEGACY_ADDRESS_ENABLE,
1652 		enable
1653 	);
1654 }
1655 
1656 static void
1657 snd_azf3328_gameport_set_counter_frequency(struct snd_azf3328 *chip,
1658 					   unsigned int freq_cfg
1659 )
1660 {
1661 	snd_azf3328_io_reg_setb(
1662 		chip->game_io+IDX_GAME_HWCONFIG,
1663 		0x02,
1664 		(freq_cfg & 1) != 0
1665 	);
1666 	snd_azf3328_io_reg_setb(
1667 		chip->game_io+IDX_GAME_HWCONFIG,
1668 		0x04,
1669 		(freq_cfg & 2) != 0
1670 	);
1671 }
1672 
1673 static inline void
1674 snd_azf3328_gameport_axis_circuit_enable(struct snd_azf3328 *chip, bool enable)
1675 {
1676 	snd_azf3328_ctrl_reg_6AH_update(
1677 		chip, IO_6A_SOMETHING2_GAMEPORT, enable
1678 	);
1679 }
1680 
1681 static inline void
1682 snd_azf3328_gameport_interrupt(struct snd_azf3328 *chip)
1683 {
1684 	/*
1685 	 * skeleton handler only
1686 	 * (we do not want axis reading in interrupt handler - too much load!)
1687 	 */
1688 	dev_dbg(chip->card->dev, "gameport irq\n");
1689 
1690 	 /* this should ACK the gameport IRQ properly, hopefully. */
1691 	snd_azf3328_game_inw(chip, IDX_GAME_AXIS_VALUE);
1692 }
1693 
1694 static int
1695 snd_azf3328_gameport_open(struct gameport *gameport, int mode)
1696 {
1697 	struct snd_azf3328 *chip = gameport_get_port_data(gameport);
1698 	int res;
1699 
1700 	dev_dbg(chip->card->dev, "gameport_open, mode %d\n", mode);
1701 	switch (mode) {
1702 	case GAMEPORT_MODE_COOKED:
1703 	case GAMEPORT_MODE_RAW:
1704 		res = 0;
1705 		break;
1706 	default:
1707 		res = -1;
1708 		break;
1709 	}
1710 
1711 	snd_azf3328_gameport_set_counter_frequency(chip,
1712 				GAME_HWCFG_ADC_COUNTER_FREQ_STD);
1713 	snd_azf3328_gameport_axis_circuit_enable(chip, (res == 0));
1714 
1715 	return res;
1716 }
1717 
1718 static void
1719 snd_azf3328_gameport_close(struct gameport *gameport)
1720 {
1721 	struct snd_azf3328 *chip = gameport_get_port_data(gameport);
1722 
1723 	dev_dbg(chip->card->dev, "gameport_close\n");
1724 	snd_azf3328_gameport_set_counter_frequency(chip,
1725 				GAME_HWCFG_ADC_COUNTER_FREQ_1_200);
1726 	snd_azf3328_gameport_axis_circuit_enable(chip, 0);
1727 }
1728 
1729 static int
1730 snd_azf3328_gameport_cooked_read(struct gameport *gameport,
1731 				 int *axes,
1732 				 int *buttons
1733 )
1734 {
1735 	struct snd_azf3328 *chip = gameport_get_port_data(gameport);
1736 	int i;
1737 	u8 val;
1738 	unsigned long flags;
1739 
1740 	if (snd_BUG_ON(!chip))
1741 		return 0;
1742 
1743 	spin_lock_irqsave(&chip->reg_lock, flags);
1744 	val = snd_azf3328_game_inb(chip, IDX_GAME_LEGACY_COMPATIBLE);
1745 	*buttons = (~(val) >> 4) & 0xf;
1746 
1747 	/* ok, this one is a bit dirty: cooked_read is being polled by a timer,
1748 	 * thus we're atomic and cannot actively wait in here
1749 	 * (which would be useful for us since it probably would be better
1750 	 * to trigger a measurement in here, then wait a short amount of
1751 	 * time until it's finished, then read values of _this_ measurement).
1752 	 *
1753 	 * Thus we simply resort to reading values if they're available already
1754 	 * and trigger the next measurement.
1755 	 */
1756 
1757 	val = snd_azf3328_game_inb(chip, IDX_GAME_AXES_CONFIG);
1758 	if (val & GAME_AXES_SAMPLING_READY) {
1759 		for (i = 0; i < ARRAY_SIZE(chip->axes); ++i) {
1760 			/* configure the axis to read */
1761 			val = (i << 4) | 0x0f;
1762 			snd_azf3328_game_outb(chip, IDX_GAME_AXES_CONFIG, val);
1763 
1764 			chip->axes[i] = snd_azf3328_game_inw(
1765 						chip, IDX_GAME_AXIS_VALUE
1766 					);
1767 		}
1768 	}
1769 
1770 	/* trigger next sampling of axes, to be evaluated the next time we
1771 	 * enter this function */
1772 
1773 	/* for some very, very strange reason we cannot enable
1774 	 * Measurement Ready monitoring for all axes here,
1775 	 * at least not when only one joystick connected */
1776 	val = 0x03; /* we're able to monitor axes 1 and 2 only */
1777 	snd_azf3328_game_outb(chip, IDX_GAME_AXES_CONFIG, val);
1778 
1779 	snd_azf3328_game_outw(chip, IDX_GAME_AXIS_VALUE, 0xffff);
1780 	spin_unlock_irqrestore(&chip->reg_lock, flags);
1781 
1782 	for (i = 0; i < ARRAY_SIZE(chip->axes); i++) {
1783 		axes[i] = chip->axes[i];
1784 		if (axes[i] == 0xffff)
1785 			axes[i] = -1;
1786 	}
1787 
1788 	dev_dbg(chip->card->dev, "cooked_read: axes %d %d %d %d buttons %d\n",
1789 		axes[0], axes[1], axes[2], axes[3], *buttons);
1790 
1791 	return 0;
1792 }
1793 
1794 static int
1795 snd_azf3328_gameport(struct snd_azf3328 *chip, int dev)
1796 {
1797 	struct gameport *gp;
1798 
1799 	chip->gameport = gp = gameport_allocate_port();
1800 	if (!gp) {
1801 		dev_err(chip->card->dev, "cannot alloc memory for gameport\n");
1802 		return -ENOMEM;
1803 	}
1804 
1805 	gameport_set_name(gp, "AZF3328 Gameport");
1806 	gameport_set_phys(gp, "pci%s/gameport0", pci_name(chip->pci));
1807 	gameport_set_dev_parent(gp, &chip->pci->dev);
1808 	gp->io = chip->game_io;
1809 	gameport_set_port_data(gp, chip);
1810 
1811 	gp->open = snd_azf3328_gameport_open;
1812 	gp->close = snd_azf3328_gameport_close;
1813 	gp->fuzz = 16; /* seems ok */
1814 	gp->cooked_read = snd_azf3328_gameport_cooked_read;
1815 
1816 	/* DISABLE legacy address: we don't need it! */
1817 	snd_azf3328_gameport_legacy_address_enable(chip, 0);
1818 
1819 	snd_azf3328_gameport_set_counter_frequency(chip,
1820 				GAME_HWCFG_ADC_COUNTER_FREQ_1_200);
1821 	snd_azf3328_gameport_axis_circuit_enable(chip, 0);
1822 
1823 	gameport_register_port(chip->gameport);
1824 
1825 	return 0;
1826 }
1827 
1828 static void
1829 snd_azf3328_gameport_free(struct snd_azf3328 *chip)
1830 {
1831 	if (chip->gameport) {
1832 		gameport_unregister_port(chip->gameport);
1833 		chip->gameport = NULL;
1834 	}
1835 	snd_azf3328_gameport_irq_enable(chip, 0);
1836 }
1837 #else
1838 static inline int
1839 snd_azf3328_gameport(struct snd_azf3328 *chip, int dev) { return -ENOSYS; }
1840 static inline void
1841 snd_azf3328_gameport_free(struct snd_azf3328 *chip) { }
1842 static inline void
1843 snd_azf3328_gameport_interrupt(struct snd_azf3328 *chip)
1844 {
1845 	dev_warn(chip->card->dev, "huh, game port IRQ occurred!?\n");
1846 }
1847 #endif /* SUPPORT_GAMEPORT */
1848 
1849 /******************************************************************/
1850 
1851 static inline void
1852 snd_azf3328_irq_log_unknown_type(struct snd_azf3328 *chip, u8 which)
1853 {
1854 	dev_dbg(chip->card->dev,
1855 		"unknown IRQ type (%x) occurred, please report!\n",
1856 		which);
1857 }
1858 
1859 static inline void
1860 snd_azf3328_pcm_interrupt(struct snd_azf3328 *chip,
1861 			  const struct snd_azf3328_codec_data *first_codec,
1862 			  u8 status
1863 )
1864 {
1865 	u8 which;
1866 	enum snd_azf3328_codec_type codec_type;
1867 	const struct snd_azf3328_codec_data *codec = first_codec;
1868 
1869 	for (codec_type = AZF_CODEC_PLAYBACK;
1870 		 codec_type <= AZF_CODEC_I2S_OUT;
1871 			 ++codec_type, ++codec) {
1872 
1873 		/* skip codec if there's no interrupt for it */
1874 		if (!(status & (1 << codec_type)))
1875 			continue;
1876 
1877 		spin_lock(codec->lock);
1878 		which = snd_azf3328_codec_inb(codec, IDX_IO_CODEC_IRQTYPE);
1879 		/* ack all IRQ types immediately */
1880 		snd_azf3328_codec_outb(codec, IDX_IO_CODEC_IRQTYPE, which);
1881 		spin_unlock(codec->lock);
1882 
1883 		if (codec->substream) {
1884 			snd_pcm_period_elapsed(codec->substream);
1885 			dev_dbg(chip->card->dev, "%s period done (#%x), @ %x\n",
1886 				codec->name,
1887 				which,
1888 				snd_azf3328_codec_inl(
1889 					codec, IDX_IO_CODEC_DMA_CURRPOS));
1890 		} else
1891 			dev_warn(chip->card->dev, "irq handler problem!\n");
1892 		if (which & IRQ_SOMETHING)
1893 			snd_azf3328_irq_log_unknown_type(chip, which);
1894 	}
1895 }
1896 
1897 static irqreturn_t
1898 snd_azf3328_interrupt(int irq, void *dev_id)
1899 {
1900 	struct snd_azf3328 *chip = dev_id;
1901 	u8 status;
1902 	static unsigned long irq_count;
1903 
1904 	status = snd_azf3328_ctrl_inb(chip, IDX_IO_IRQSTATUS);
1905 
1906         /* fast path out, to ease interrupt sharing */
1907 	if (!(status &
1908 		(IRQ_PLAYBACK|IRQ_RECORDING|IRQ_I2S_OUT
1909 		|IRQ_GAMEPORT|IRQ_MPU401|IRQ_TIMER)
1910 	))
1911 		return IRQ_NONE; /* must be interrupt for another device */
1912 
1913 	dev_dbg(chip->card->dev,
1914 		"irq_count %ld! IDX_IO_IRQSTATUS %04x\n",
1915 			irq_count++ /* debug-only */,
1916 			status);
1917 
1918 	if (status & IRQ_TIMER) {
1919 		/* dev_dbg(chip->card->dev, "timer %ld\n",
1920 			snd_azf3328_codec_inl(chip, IDX_IO_TIMER_VALUE)
1921 				& TIMER_VALUE_MASK
1922 		); */
1923 		if (chip->timer)
1924 			snd_timer_interrupt(chip->timer, chip->timer->sticks);
1925 		/* ACK timer */
1926                 spin_lock(&chip->reg_lock);
1927 		snd_azf3328_ctrl_outb(chip, IDX_IO_TIMER_VALUE + 3, 0x07);
1928 		spin_unlock(&chip->reg_lock);
1929 		dev_dbg(chip->card->dev, "timer IRQ\n");
1930 	}
1931 
1932 	if (status & (IRQ_PLAYBACK|IRQ_RECORDING|IRQ_I2S_OUT))
1933 		snd_azf3328_pcm_interrupt(chip, chip->codecs, status);
1934 
1935 	if (status & IRQ_GAMEPORT)
1936 		snd_azf3328_gameport_interrupt(chip);
1937 
1938 	/* MPU401 has less critical IRQ requirements
1939 	 * than timer and playback/recording, right? */
1940 	if (status & IRQ_MPU401) {
1941 		snd_mpu401_uart_interrupt(irq, chip->rmidi->private_data);
1942 
1943 		/* hmm, do we have to ack the IRQ here somehow?
1944 		 * If so, then I don't know how yet... */
1945 		dev_dbg(chip->card->dev, "MPU401 IRQ\n");
1946 	}
1947 	return IRQ_HANDLED;
1948 }
1949 
1950 /*****************************************************************/
1951 
1952 /* as long as we think we have identical snd_pcm_hardware parameters
1953    for playback, capture and i2s out, we can use the same physical struct
1954    since the struct is simply being copied into a member.
1955 */
1956 static const struct snd_pcm_hardware snd_azf3328_hardware =
1957 {
1958 	/* FIXME!! Correct? */
1959 	.info =			SNDRV_PCM_INFO_MMAP |
1960 				SNDRV_PCM_INFO_INTERLEAVED |
1961 				SNDRV_PCM_INFO_MMAP_VALID,
1962 	.formats =		SNDRV_PCM_FMTBIT_S8 |
1963 				SNDRV_PCM_FMTBIT_U8 |
1964 				SNDRV_PCM_FMTBIT_S16_LE |
1965 				SNDRV_PCM_FMTBIT_U16_LE,
1966 	.rates =		SNDRV_PCM_RATE_5512 |
1967 				SNDRV_PCM_RATE_8000_48000 |
1968 				SNDRV_PCM_RATE_KNOT,
1969 	.rate_min =		AZF_FREQ_4000,
1970 	.rate_max =		AZF_FREQ_66200,
1971 	.channels_min =		1,
1972 	.channels_max =		2,
1973 	.buffer_bytes_max =	(64*1024),
1974 	.period_bytes_min =	1024,
1975 	.period_bytes_max =	(32*1024),
1976 	/* We simply have two DMA areas (instead of a list of descriptors
1977 	   such as other cards); I believe that this is a fixed hardware
1978 	   attribute and there isn't much driver magic to be done to expand it.
1979 	   Thus indicate that we have at least and at most 2 periods. */
1980 	.periods_min =		2,
1981 	.periods_max =		2,
1982 	/* FIXME: maybe that card actually has a FIFO?
1983 	 * Hmm, it seems newer revisions do have one, but we still don't know
1984 	 * its size... */
1985 	.fifo_size =		0,
1986 };
1987 
1988 
1989 static const unsigned int snd_azf3328_fixed_rates[] = {
1990 	AZF_FREQ_4000,
1991 	AZF_FREQ_4800,
1992 	AZF_FREQ_5512,
1993 	AZF_FREQ_6620,
1994 	AZF_FREQ_8000,
1995 	AZF_FREQ_9600,
1996 	AZF_FREQ_11025,
1997 	AZF_FREQ_13240,
1998 	AZF_FREQ_16000,
1999 	AZF_FREQ_22050,
2000 	AZF_FREQ_32000,
2001 	AZF_FREQ_44100,
2002 	AZF_FREQ_48000,
2003 	AZF_FREQ_66200
2004 };
2005 
2006 static const struct snd_pcm_hw_constraint_list snd_azf3328_hw_constraints_rates = {
2007 	.count = ARRAY_SIZE(snd_azf3328_fixed_rates),
2008 	.list = snd_azf3328_fixed_rates,
2009 	.mask = 0,
2010 };
2011 
2012 /*****************************************************************/
2013 
2014 static int
2015 snd_azf3328_pcm_open(struct snd_pcm_substream *substream,
2016 		     enum snd_azf3328_codec_type codec_type
2017 )
2018 {
2019 	struct snd_azf3328 *chip = snd_pcm_substream_chip(substream);
2020 	struct snd_pcm_runtime *runtime = substream->runtime;
2021 	struct snd_azf3328_codec_data *codec = &chip->codecs[codec_type];
2022 
2023 	codec->substream = substream;
2024 
2025 	/* same parameters for all our codecs - at least we think so... */
2026 	runtime->hw = snd_azf3328_hardware;
2027 
2028 	snd_pcm_hw_constraint_list(runtime, 0, SNDRV_PCM_HW_PARAM_RATE,
2029 				   &snd_azf3328_hw_constraints_rates);
2030 	runtime->private_data = codec;
2031 	return 0;
2032 }
2033 
2034 static int
2035 snd_azf3328_pcm_playback_open(struct snd_pcm_substream *substream)
2036 {
2037 	return snd_azf3328_pcm_open(substream, AZF_CODEC_PLAYBACK);
2038 }
2039 
2040 static int
2041 snd_azf3328_pcm_capture_open(struct snd_pcm_substream *substream)
2042 {
2043 	return snd_azf3328_pcm_open(substream, AZF_CODEC_CAPTURE);
2044 }
2045 
2046 static int
2047 snd_azf3328_pcm_i2s_out_open(struct snd_pcm_substream *substream)
2048 {
2049 	return snd_azf3328_pcm_open(substream, AZF_CODEC_I2S_OUT);
2050 }
2051 
2052 static int
2053 snd_azf3328_pcm_close(struct snd_pcm_substream *substream
2054 )
2055 {
2056 	struct snd_azf3328_codec_data *codec =
2057 		substream->runtime->private_data;
2058 
2059 	codec->substream = NULL;
2060 	return 0;
2061 }
2062 
2063 /******************************************************************/
2064 
2065 static const struct snd_pcm_ops snd_azf3328_playback_ops = {
2066 	.open =		snd_azf3328_pcm_playback_open,
2067 	.close =	snd_azf3328_pcm_close,
2068 	.prepare =	snd_azf3328_pcm_prepare,
2069 	.trigger =	snd_azf3328_pcm_trigger,
2070 	.pointer =	snd_azf3328_pcm_pointer
2071 };
2072 
2073 static const struct snd_pcm_ops snd_azf3328_capture_ops = {
2074 	.open =		snd_azf3328_pcm_capture_open,
2075 	.close =	snd_azf3328_pcm_close,
2076 	.prepare =	snd_azf3328_pcm_prepare,
2077 	.trigger =	snd_azf3328_pcm_trigger,
2078 	.pointer =	snd_azf3328_pcm_pointer
2079 };
2080 
2081 static const struct snd_pcm_ops snd_azf3328_i2s_out_ops = {
2082 	.open =		snd_azf3328_pcm_i2s_out_open,
2083 	.close =	snd_azf3328_pcm_close,
2084 	.prepare =	snd_azf3328_pcm_prepare,
2085 	.trigger =	snd_azf3328_pcm_trigger,
2086 	.pointer =	snd_azf3328_pcm_pointer
2087 };
2088 
2089 static int
2090 snd_azf3328_pcm(struct snd_azf3328 *chip)
2091 {
2092 	/* pcm devices */
2093 	enum { AZF_PCMDEV_STD, AZF_PCMDEV_I2S_OUT, NUM_AZF_PCMDEVS };
2094 
2095 	struct snd_pcm *pcm;
2096 	int err;
2097 
2098 	err = snd_pcm_new(chip->card, "AZF3328 DSP", AZF_PCMDEV_STD,
2099 								1, 1, &pcm);
2100 	if (err < 0)
2101 		return err;
2102 	snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK,
2103 						&snd_azf3328_playback_ops);
2104 	snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE,
2105 						&snd_azf3328_capture_ops);
2106 
2107 	pcm->private_data = chip;
2108 	pcm->info_flags = 0;
2109 	strcpy(pcm->name, chip->card->shortname);
2110 	/* same pcm object for playback/capture (see snd_pcm_new() above) */
2111 	chip->pcm[AZF_CODEC_PLAYBACK] = pcm;
2112 	chip->pcm[AZF_CODEC_CAPTURE] = pcm;
2113 
2114 	snd_pcm_set_managed_buffer_all(pcm, SNDRV_DMA_TYPE_DEV, &chip->pci->dev,
2115 				       64*1024, 64*1024);
2116 
2117 	err = snd_pcm_new(chip->card, "AZF3328 I2S OUT", AZF_PCMDEV_I2S_OUT,
2118 								1, 0, &pcm);
2119 	if (err < 0)
2120 		return err;
2121 	snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK,
2122 						&snd_azf3328_i2s_out_ops);
2123 
2124 	pcm->private_data = chip;
2125 	pcm->info_flags = 0;
2126 	strcpy(pcm->name, chip->card->shortname);
2127 	chip->pcm[AZF_CODEC_I2S_OUT] = pcm;
2128 
2129 	snd_pcm_set_managed_buffer_all(pcm, SNDRV_DMA_TYPE_DEV, &chip->pci->dev,
2130 				       64*1024, 64*1024);
2131 
2132 	return 0;
2133 }
2134 
2135 /******************************************************************/
2136 
2137 /*** NOTE: the physical timer resolution actually is 1024000 ticks per second
2138  *** (probably derived from main crystal via a divider of 24),
2139  *** but announcing those attributes to user-space would make programs
2140  *** configure the timer to a 1 tick value, resulting in an absolutely fatal
2141  *** timer IRQ storm.
2142  *** Thus I chose to announce a down-scaled virtual timer to the outside and
2143  *** calculate real timer countdown values internally.
2144  *** (the scale factor can be set via module parameter "seqtimer_scaling").
2145  ***/
2146 
2147 static int
2148 snd_azf3328_timer_start(struct snd_timer *timer)
2149 {
2150 	struct snd_azf3328 *chip;
2151 	unsigned long flags;
2152 	unsigned int delay;
2153 
2154 	chip = snd_timer_chip(timer);
2155 	delay = ((timer->sticks * seqtimer_scaling) - 1) & TIMER_VALUE_MASK;
2156 	if (delay < 49) {
2157 		/* uhoh, that's not good, since user-space won't know about
2158 		 * this timing tweak
2159 		 * (we need to do it to avoid a lockup, though) */
2160 
2161 		dev_dbg(chip->card->dev, "delay was too low (%d)!\n", delay);
2162 		delay = 49; /* minimum time is 49 ticks */
2163 	}
2164 	dev_dbg(chip->card->dev, "setting timer countdown value %d\n", delay);
2165 	delay |= TIMER_COUNTDOWN_ENABLE | TIMER_IRQ_ENABLE;
2166 	spin_lock_irqsave(&chip->reg_lock, flags);
2167 	snd_azf3328_ctrl_outl(chip, IDX_IO_TIMER_VALUE, delay);
2168 	spin_unlock_irqrestore(&chip->reg_lock, flags);
2169 	return 0;
2170 }
2171 
2172 static int
2173 snd_azf3328_timer_stop(struct snd_timer *timer)
2174 {
2175 	struct snd_azf3328 *chip;
2176 	unsigned long flags;
2177 
2178 	chip = snd_timer_chip(timer);
2179 	spin_lock_irqsave(&chip->reg_lock, flags);
2180 	/* disable timer countdown and interrupt */
2181 	/* Hmm, should we write TIMER_IRQ_ACK here?
2182 	   YES indeed, otherwise a rogue timer operation - which prompts
2183 	   ALSA(?) to call repeated stop() in vain, but NOT start() -
2184 	   will never end (value 0x03 is kept shown in control byte).
2185 	   Simply manually poking 0x04 _once_ immediately successfully stops
2186 	   the hardware/ALSA interrupt activity. */
2187 	snd_azf3328_ctrl_outb(chip, IDX_IO_TIMER_VALUE + 3, 0x04);
2188 	spin_unlock_irqrestore(&chip->reg_lock, flags);
2189 	return 0;
2190 }
2191 
2192 
2193 static int
2194 snd_azf3328_timer_precise_resolution(struct snd_timer *timer,
2195 					       unsigned long *num, unsigned long *den)
2196 {
2197 	*num = 1;
2198 	*den = 1024000 / seqtimer_scaling;
2199 	return 0;
2200 }
2201 
2202 static struct snd_timer_hardware snd_azf3328_timer_hw = {
2203 	.flags = SNDRV_TIMER_HW_AUTO,
2204 	.resolution = 977, /* 1000000/1024000 = 0.9765625us */
2205 	.ticks = 1024000, /* max tick count, defined by the value register; actually it's not 1024000, but 1048576, but we don't care */
2206 	.start = snd_azf3328_timer_start,
2207 	.stop = snd_azf3328_timer_stop,
2208 	.precise_resolution = snd_azf3328_timer_precise_resolution,
2209 };
2210 
2211 static int
2212 snd_azf3328_timer(struct snd_azf3328 *chip, int device)
2213 {
2214 	struct snd_timer *timer = NULL;
2215 	struct snd_timer_id tid;
2216 	int err;
2217 
2218 	tid.dev_class = SNDRV_TIMER_CLASS_CARD;
2219 	tid.dev_sclass = SNDRV_TIMER_SCLASS_NONE;
2220 	tid.card = chip->card->number;
2221 	tid.device = device;
2222 	tid.subdevice = 0;
2223 
2224 	snd_azf3328_timer_hw.resolution *= seqtimer_scaling;
2225 	snd_azf3328_timer_hw.ticks /= seqtimer_scaling;
2226 
2227 	err = snd_timer_new(chip->card, "AZF3328", &tid, &timer);
2228 	if (err < 0)
2229 		goto out;
2230 
2231 	strcpy(timer->name, "AZF3328 timer");
2232 	timer->private_data = chip;
2233 	timer->hw = snd_azf3328_timer_hw;
2234 
2235 	chip->timer = timer;
2236 
2237 	snd_azf3328_timer_stop(timer);
2238 
2239 	err = 0;
2240 
2241 out:
2242 	return err;
2243 }
2244 
2245 /******************************************************************/
2246 
2247 static void
2248 snd_azf3328_free(struct snd_card *card)
2249 {
2250 	struct snd_azf3328 *chip = card->private_data;
2251 
2252 	snd_azf3328_mixer_reset(chip);
2253 
2254 	snd_azf3328_timer_stop(chip->timer);
2255 	snd_azf3328_gameport_free(chip);
2256 }
2257 
2258 #if 0
2259 /* check whether a bit can be modified */
2260 static void
2261 snd_azf3328_test_bit(unsigned unsigned reg, int bit)
2262 {
2263 	unsigned char val, valoff, valon;
2264 
2265 	val = inb(reg);
2266 
2267 	outb(val & ~(1 << bit), reg);
2268 	valoff = inb(reg);
2269 
2270 	outb(val|(1 << bit), reg);
2271 	valon = inb(reg);
2272 
2273 	outb(val, reg);
2274 
2275 	printk(KERN_DEBUG "reg %04x bit %d: %02x %02x %02x\n",
2276 				reg, bit, val, valoff, valon
2277 	);
2278 }
2279 #endif
2280 
2281 static inline void
2282 snd_azf3328_debug_show_ports(const struct snd_azf3328 *chip)
2283 {
2284 	u16 tmp;
2285 
2286 	dev_dbg(chip->card->dev,
2287 		"ctrl_io 0x%lx, game_io 0x%lx, mpu_io 0x%lx, "
2288 		"opl3_io 0x%lx, mixer_io 0x%lx, irq %d\n",
2289 		chip->ctrl_io, chip->game_io, chip->mpu_io,
2290 		chip->opl3_io, chip->mixer_io, chip->irq);
2291 
2292 	dev_dbg(chip->card->dev,
2293 		"game %02x %02x %02x %02x %02x %02x\n",
2294 		snd_azf3328_game_inb(chip, 0),
2295 		snd_azf3328_game_inb(chip, 1),
2296 		snd_azf3328_game_inb(chip, 2),
2297 		snd_azf3328_game_inb(chip, 3),
2298 		snd_azf3328_game_inb(chip, 4),
2299 		snd_azf3328_game_inb(chip, 5));
2300 
2301 	for (tmp = 0; tmp < 0x07; tmp += 1)
2302 		dev_dbg(chip->card->dev,
2303 			"mpu_io 0x%04x\n", inb(chip->mpu_io + tmp));
2304 
2305 	for (tmp = 0; tmp <= 0x07; tmp += 1)
2306 		dev_dbg(chip->card->dev,
2307 			"0x%02x: game200 0x%04x, game208 0x%04x\n",
2308 			tmp, inb(0x200 + tmp), inb(0x208 + tmp));
2309 
2310 	for (tmp = 0; tmp <= 0x01; tmp += 1)
2311 		dev_dbg(chip->card->dev,
2312 			"0x%02x: mpu300 0x%04x, mpu310 0x%04x, mpu320 0x%04x, "
2313 			"mpu330 0x%04x opl388 0x%04x opl38c 0x%04x\n",
2314 				tmp,
2315 				inb(0x300 + tmp),
2316 				inb(0x310 + tmp),
2317 				inb(0x320 + tmp),
2318 				inb(0x330 + tmp),
2319 				inb(0x388 + tmp),
2320 				inb(0x38c + tmp));
2321 
2322 	for (tmp = 0; tmp < AZF_IO_SIZE_CTRL; tmp += 2)
2323 		dev_dbg(chip->card->dev,
2324 			"ctrl 0x%02x: 0x%04x\n",
2325 			tmp, snd_azf3328_ctrl_inw(chip, tmp));
2326 
2327 	for (tmp = 0; tmp < AZF_IO_SIZE_MIXER; tmp += 2)
2328 		dev_dbg(chip->card->dev,
2329 			"mixer 0x%02x: 0x%04x\n",
2330 			tmp, snd_azf3328_mixer_inw(chip, tmp));
2331 }
2332 
2333 static int
2334 snd_azf3328_create(struct snd_card *card,
2335 		   struct pci_dev *pci,
2336 		   unsigned long device_type)
2337 {
2338 	struct snd_azf3328 *chip = card->private_data;
2339 	int err;
2340 	u8 dma_init;
2341 	enum snd_azf3328_codec_type codec_type;
2342 	struct snd_azf3328_codec_data *codec_setup;
2343 
2344 	err = pcim_enable_device(pci);
2345 	if (err < 0)
2346 		return err;
2347 
2348 	spin_lock_init(&chip->reg_lock);
2349 	chip->card = card;
2350 	chip->pci = pci;
2351 	chip->irq = -1;
2352 
2353 	/* check if we can restrict PCI DMA transfers to 24 bits */
2354 	if (dma_set_mask_and_coherent(&pci->dev, DMA_BIT_MASK(24))) {
2355 		dev_err(card->dev,
2356 			"architecture does not support 24bit PCI busmaster DMA\n"
2357 		);
2358 		return -ENXIO;
2359 	}
2360 
2361 	err = pci_request_regions(pci, "Aztech AZF3328");
2362 	if (err < 0)
2363 		return err;
2364 
2365 	chip->ctrl_io  = pci_resource_start(pci, 0);
2366 	chip->game_io  = pci_resource_start(pci, 1);
2367 	chip->mpu_io   = pci_resource_start(pci, 2);
2368 	chip->opl3_io  = pci_resource_start(pci, 3);
2369 	chip->mixer_io = pci_resource_start(pci, 4);
2370 
2371 	codec_setup = &chip->codecs[AZF_CODEC_PLAYBACK];
2372 	codec_setup->io_base = chip->ctrl_io + AZF_IO_OFFS_CODEC_PLAYBACK;
2373 	codec_setup->lock = &chip->reg_lock;
2374 	codec_setup->type = AZF_CODEC_PLAYBACK;
2375 	codec_setup->name = "PLAYBACK";
2376 
2377 	codec_setup = &chip->codecs[AZF_CODEC_CAPTURE];
2378 	codec_setup->io_base = chip->ctrl_io + AZF_IO_OFFS_CODEC_CAPTURE;
2379 	codec_setup->lock = &chip->reg_lock;
2380 	codec_setup->type = AZF_CODEC_CAPTURE;
2381 	codec_setup->name = "CAPTURE";
2382 
2383 	codec_setup = &chip->codecs[AZF_CODEC_I2S_OUT];
2384 	codec_setup->io_base = chip->ctrl_io + AZF_IO_OFFS_CODEC_I2S_OUT;
2385 	codec_setup->lock = &chip->reg_lock;
2386 	codec_setup->type = AZF_CODEC_I2S_OUT;
2387 	codec_setup->name = "I2S_OUT";
2388 
2389 	if (devm_request_irq(&pci->dev, pci->irq, snd_azf3328_interrupt,
2390 			     IRQF_SHARED, KBUILD_MODNAME, chip)) {
2391 		dev_err(card->dev, "unable to grab IRQ %d\n", pci->irq);
2392 		return -EBUSY;
2393 	}
2394 	chip->irq = pci->irq;
2395 	card->sync_irq = chip->irq;
2396 	card->private_free = snd_azf3328_free;
2397 	pci_set_master(pci);
2398 
2399 	snd_azf3328_debug_show_ports(chip);
2400 
2401 	/* create mixer interface & switches */
2402 	err = snd_azf3328_mixer_new(chip);
2403 	if (err < 0)
2404 		return err;
2405 
2406 	/* standard codec init stuff */
2407 		/* default DMA init value */
2408 	dma_init = DMA_RUN_SOMETHING2|DMA_EPILOGUE_SOMETHING|DMA_SOMETHING_ELSE;
2409 
2410 	for (codec_type = AZF_CODEC_PLAYBACK;
2411 		codec_type <= AZF_CODEC_I2S_OUT; ++codec_type) {
2412 		struct snd_azf3328_codec_data *codec =
2413 			 &chip->codecs[codec_type];
2414 
2415 		/* shutdown codecs to reduce power / noise */
2416 			/* have ...ctrl_codec_activity() act properly */
2417 		codec->running = true;
2418 		snd_azf3328_ctrl_codec_activity(chip, codec_type, 0);
2419 
2420 		spin_lock_irq(codec->lock);
2421 		snd_azf3328_codec_outb(codec, IDX_IO_CODEC_DMA_FLAGS,
2422 						 dma_init);
2423 		spin_unlock_irq(codec->lock);
2424 	}
2425 
2426 	return 0;
2427 }
2428 
2429 static int
2430 __snd_azf3328_probe(struct pci_dev *pci, const struct pci_device_id *pci_id)
2431 {
2432 	static int dev;
2433 	struct snd_card *card;
2434 	struct snd_azf3328 *chip;
2435 	struct snd_opl3 *opl3;
2436 	int err;
2437 
2438 	if (dev >= SNDRV_CARDS)
2439 		return -ENODEV;
2440 	if (!enable[dev]) {
2441 		dev++;
2442 		return -ENOENT;
2443 	}
2444 
2445 	err = snd_devm_card_new(&pci->dev, index[dev], id[dev], THIS_MODULE,
2446 				sizeof(*chip), &card);
2447 	if (err < 0)
2448 		return err;
2449 	chip = card->private_data;
2450 
2451 	strcpy(card->driver, "AZF3328");
2452 	strcpy(card->shortname, "Aztech AZF3328 (PCI168)");
2453 
2454 	err = snd_azf3328_create(card, pci, pci_id->driver_data);
2455 	if (err < 0)
2456 		return err;
2457 
2458 	/* chose to use MPU401_HW_AZT2320 ID instead of MPU401_HW_MPU401,
2459 	   since our hardware ought to be similar, thus use same ID. */
2460 	err = snd_mpu401_uart_new(
2461 		card, 0,
2462 		MPU401_HW_AZT2320, chip->mpu_io,
2463 		MPU401_INFO_INTEGRATED | MPU401_INFO_IRQ_HOOK,
2464 		-1, &chip->rmidi
2465 	);
2466 	if (err < 0) {
2467 		dev_err(card->dev, "no MPU-401 device at 0x%lx?\n",
2468 				chip->mpu_io
2469 		);
2470 		return err;
2471 	}
2472 
2473 	err = snd_azf3328_timer(chip, 0);
2474 	if (err < 0)
2475 		return err;
2476 
2477 	err = snd_azf3328_pcm(chip);
2478 	if (err < 0)
2479 		return err;
2480 
2481 	if (snd_opl3_create(card, chip->opl3_io, chip->opl3_io+2,
2482 			    OPL3_HW_AUTO, 1, &opl3) < 0) {
2483 		dev_err(card->dev, "no OPL3 device at 0x%lx-0x%lx?\n",
2484 			   chip->opl3_io, chip->opl3_io+2
2485 		);
2486 	} else {
2487 		/* need to use IDs 1, 2 since ID 0 is snd_azf3328_timer above */
2488 		err = snd_opl3_timer_new(opl3, 1, 2);
2489 		if (err < 0)
2490 			return err;
2491 		err = snd_opl3_hwdep_new(opl3, 0, 1, NULL);
2492 		if (err < 0)
2493 			return err;
2494 		opl3->private_data = chip;
2495 	}
2496 
2497 	sprintf(card->longname, "%s at 0x%lx, irq %i",
2498 		card->shortname, chip->ctrl_io, chip->irq);
2499 
2500 	err = snd_card_register(card);
2501 	if (err < 0)
2502 		return err;
2503 
2504 #ifdef MODULE
2505 	dev_info(card->dev,
2506 		 "Sound driver for Aztech AZF3328-based soundcards such as PCI168.\n");
2507 	dev_info(card->dev,
2508 		 "Hardware was completely undocumented, unfortunately.\n");
2509 	dev_info(card->dev,
2510 		 "Feel free to contact andi AT lisas.de for bug reports etc.!\n");
2511 	dev_info(card->dev,
2512 		 "User-scalable sequencer timer set to %dHz (1024000Hz / %d).\n",
2513 		 1024000 / seqtimer_scaling, seqtimer_scaling);
2514 #endif
2515 
2516 	snd_azf3328_gameport(chip, dev);
2517 
2518 	pci_set_drvdata(pci, card);
2519 	dev++;
2520 	return 0;
2521 }
2522 
2523 static int
2524 snd_azf3328_probe(struct pci_dev *pci, const struct pci_device_id *pci_id)
2525 {
2526 	return snd_card_free_on_error(&pci->dev, __snd_azf3328_probe(pci, pci_id));
2527 }
2528 
2529 #ifdef CONFIG_PM_SLEEP
2530 static inline void
2531 snd_azf3328_suspend_regs(const struct snd_azf3328 *chip,
2532 			 unsigned long io_addr, unsigned count, u32 *saved_regs)
2533 {
2534 	unsigned reg;
2535 
2536 	for (reg = 0; reg < count; ++reg) {
2537 		*saved_regs = inl(io_addr);
2538 		dev_dbg(chip->card->dev, "suspend: io 0x%04lx: 0x%08x\n",
2539 			io_addr, *saved_regs);
2540 		++saved_regs;
2541 		io_addr += sizeof(*saved_regs);
2542 	}
2543 }
2544 
2545 static inline void
2546 snd_azf3328_resume_regs(const struct snd_azf3328 *chip,
2547 			const u32 *saved_regs,
2548 			unsigned long io_addr,
2549 			unsigned count
2550 )
2551 {
2552 	unsigned reg;
2553 
2554 	for (reg = 0; reg < count; ++reg) {
2555 		outl(*saved_regs, io_addr);
2556 		dev_dbg(chip->card->dev,
2557 			"resume: io 0x%04lx: 0x%08x --> 0x%08x\n",
2558 			io_addr, *saved_regs, inl(io_addr));
2559 		++saved_regs;
2560 		io_addr += sizeof(*saved_regs);
2561 	}
2562 }
2563 
2564 static inline void
2565 snd_azf3328_suspend_ac97(struct snd_azf3328 *chip)
2566 {
2567 #ifdef AZF_USE_AC97_LAYER
2568 	snd_ac97_suspend(chip->ac97);
2569 #else
2570 	snd_azf3328_suspend_regs(chip, chip->mixer_io,
2571 		ARRAY_SIZE(chip->saved_regs_mixer), chip->saved_regs_mixer);
2572 
2573 	/* make sure to disable master volume etc. to prevent looping sound */
2574 	snd_azf3328_mixer_mute_control_master(chip, 1);
2575 	snd_azf3328_mixer_mute_control_pcm(chip, 1);
2576 #endif /* AZF_USE_AC97_LAYER */
2577 }
2578 
2579 static inline void
2580 snd_azf3328_resume_ac97(const struct snd_azf3328 *chip)
2581 {
2582 #ifdef AZF_USE_AC97_LAYER
2583 	snd_ac97_resume(chip->ac97);
2584 #else
2585 	snd_azf3328_resume_regs(chip, chip->saved_regs_mixer, chip->mixer_io,
2586 					ARRAY_SIZE(chip->saved_regs_mixer));
2587 
2588 	/* unfortunately with 32bit transfers, IDX_MIXER_PLAY_MASTER (0x02)
2589 	   and IDX_MIXER_RESET (offset 0x00) get touched at the same time,
2590 	   resulting in a mixer reset condition persisting until _after_
2591 	   master vol was restored. Thus master vol needs an extra restore. */
2592 	outw(((u16 *)chip->saved_regs_mixer)[1], chip->mixer_io + 2);
2593 #endif /* AZF_USE_AC97_LAYER */
2594 }
2595 
2596 static int
2597 snd_azf3328_suspend(struct device *dev)
2598 {
2599 	struct snd_card *card = dev_get_drvdata(dev);
2600 	struct snd_azf3328 *chip = card->private_data;
2601 	u16 *saved_regs_ctrl_u16;
2602 
2603 	snd_power_change_state(card, SNDRV_CTL_POWER_D3hot);
2604 
2605 	snd_azf3328_suspend_ac97(chip);
2606 
2607 	snd_azf3328_suspend_regs(chip, chip->ctrl_io,
2608 		ARRAY_SIZE(chip->saved_regs_ctrl), chip->saved_regs_ctrl);
2609 
2610 	/* manually store the one currently relevant write-only reg, too */
2611 	saved_regs_ctrl_u16 = (u16 *)chip->saved_regs_ctrl;
2612 	saved_regs_ctrl_u16[IDX_IO_6AH / 2] = chip->shadow_reg_ctrl_6AH;
2613 
2614 	snd_azf3328_suspend_regs(chip, chip->game_io,
2615 		ARRAY_SIZE(chip->saved_regs_game), chip->saved_regs_game);
2616 	snd_azf3328_suspend_regs(chip, chip->mpu_io,
2617 		ARRAY_SIZE(chip->saved_regs_mpu), chip->saved_regs_mpu);
2618 	snd_azf3328_suspend_regs(chip, chip->opl3_io,
2619 		ARRAY_SIZE(chip->saved_regs_opl3), chip->saved_regs_opl3);
2620 	return 0;
2621 }
2622 
2623 static int
2624 snd_azf3328_resume(struct device *dev)
2625 {
2626 	struct snd_card *card = dev_get_drvdata(dev);
2627 	const struct snd_azf3328 *chip = card->private_data;
2628 
2629 	snd_azf3328_resume_regs(chip, chip->saved_regs_game, chip->game_io,
2630 					ARRAY_SIZE(chip->saved_regs_game));
2631 	snd_azf3328_resume_regs(chip, chip->saved_regs_mpu, chip->mpu_io,
2632 					ARRAY_SIZE(chip->saved_regs_mpu));
2633 	snd_azf3328_resume_regs(chip, chip->saved_regs_opl3, chip->opl3_io,
2634 					ARRAY_SIZE(chip->saved_regs_opl3));
2635 
2636 	snd_azf3328_resume_ac97(chip);
2637 
2638 	snd_azf3328_resume_regs(chip, chip->saved_regs_ctrl, chip->ctrl_io,
2639 					ARRAY_SIZE(chip->saved_regs_ctrl));
2640 
2641 	snd_power_change_state(card, SNDRV_CTL_POWER_D0);
2642 	return 0;
2643 }
2644 
2645 static SIMPLE_DEV_PM_OPS(snd_azf3328_pm, snd_azf3328_suspend, snd_azf3328_resume);
2646 #define SND_AZF3328_PM_OPS	&snd_azf3328_pm
2647 #else
2648 #define SND_AZF3328_PM_OPS	NULL
2649 #endif /* CONFIG_PM_SLEEP */
2650 
2651 static struct pci_driver azf3328_driver = {
2652 	.name = KBUILD_MODNAME,
2653 	.id_table = snd_azf3328_ids,
2654 	.probe = snd_azf3328_probe,
2655 	.driver = {
2656 		.pm = SND_AZF3328_PM_OPS,
2657 	},
2658 };
2659 
2660 module_pci_driver(azf3328_driver);
2661