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