xref: /openbmc/linux/sound/pci/ac97/ac97_codec.c (revision b830f94f)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
4  *  Universal interface for Audio Codec '97
5  *
6  *  For more details look to AC '97 component specification revision 2.2
7  *  by Intel Corporation (http://developer.intel.com).
8  */
9 
10 #include <linux/delay.h>
11 #include <linux/init.h>
12 #include <linux/slab.h>
13 #include <linux/pci.h>
14 #include <linux/module.h>
15 #include <linux/mutex.h>
16 #include <sound/core.h>
17 #include <sound/pcm.h>
18 #include <sound/tlv.h>
19 #include <sound/ac97_codec.h>
20 #include <sound/asoundef.h>
21 #include <sound/initval.h>
22 #include "ac97_id.h"
23 
24 #include "ac97_patch.c"
25 
26 MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>");
27 MODULE_DESCRIPTION("Universal interface for Audio Codec '97");
28 MODULE_LICENSE("GPL");
29 
30 static bool enable_loopback;
31 
32 module_param(enable_loopback, bool, 0444);
33 MODULE_PARM_DESC(enable_loopback, "Enable AC97 ADC/DAC Loopback Control");
34 
35 #ifdef CONFIG_SND_AC97_POWER_SAVE
36 static int power_save = CONFIG_SND_AC97_POWER_SAVE_DEFAULT;
37 module_param(power_save, int, 0644);
38 MODULE_PARM_DESC(power_save, "Automatic power-saving timeout "
39 		 "(in second, 0 = disable).");
40 #endif
41 /*
42 
43  */
44 
45 struct ac97_codec_id {
46 	unsigned int id;
47 	unsigned int mask;
48 	const char *name;
49 	int (*patch)(struct snd_ac97 *ac97);
50 	int (*mpatch)(struct snd_ac97 *ac97);
51 	unsigned int flags;
52 };
53 
54 static const struct ac97_codec_id snd_ac97_codec_id_vendors[] = {
55 { 0x41445300, 0xffffff00, "Analog Devices",	NULL,	NULL },
56 { 0x414b4d00, 0xffffff00, "Asahi Kasei",	NULL,	NULL },
57 { 0x414c4300, 0xffffff00, "Realtek",		NULL,	NULL },
58 { 0x414c4700, 0xffffff00, "Realtek",		NULL,	NULL },
59 /*
60  * This is an _inofficial_ Aztech Labs entry
61  * (value might differ from unknown official Aztech ID),
62  * currently used by the AC97 emulation of the almost-AC97 PCI168 card.
63  */
64 { 0x415a5400, 0xffffff00, "Aztech Labs (emulated)",	NULL,	NULL },
65 { 0x434d4900, 0xffffff00, "C-Media Electronics", NULL,	NULL },
66 { 0x43525900, 0xffffff00, "Cirrus Logic",	NULL,	NULL },
67 { 0x43585400, 0xffffff00, "Conexant",           NULL,	NULL },
68 { 0x44543000, 0xffffff00, "Diamond Technology", NULL,	NULL },
69 { 0x454d4300, 0xffffff00, "eMicro",		NULL,	NULL },
70 { 0x45838300, 0xffffff00, "ESS Technology",	NULL,	NULL },
71 { 0x48525300, 0xffffff00, "Intersil",		NULL,	NULL },
72 { 0x49434500, 0xffffff00, "ICEnsemble",		NULL,	NULL },
73 { 0x49544500, 0xffffff00, "ITE Tech.Inc",	NULL,	NULL },
74 { 0x4e534300, 0xffffff00, "National Semiconductor", NULL, NULL },
75 { 0x50534300, 0xffffff00, "Philips",		NULL,	NULL },
76 { 0x53494c00, 0xffffff00, "Silicon Laboratory",	NULL,	NULL },
77 { 0x53544d00, 0xffffff00, "STMicroelectronics",	NULL,	NULL },
78 { 0x54524100, 0xffffff00, "TriTech",		NULL,	NULL },
79 { 0x54584e00, 0xffffff00, "Texas Instruments",	NULL,	NULL },
80 { 0x56494100, 0xffffff00, "VIA Technologies",   NULL,	NULL },
81 { 0x57454300, 0xffffff00, "Winbond",		NULL,	NULL },
82 { 0x574d4c00, 0xffffff00, "Wolfson",		NULL,	NULL },
83 { 0x594d4800, 0xffffff00, "Yamaha",		NULL,	NULL },
84 { 0x83847600, 0xffffff00, "SigmaTel",		NULL,	NULL },
85 { 0,	      0, 	  NULL,			NULL,	NULL }
86 };
87 
88 static const struct ac97_codec_id snd_ac97_codec_ids[] = {
89 { 0x41445303, 0xffffffff, "AD1819",		patch_ad1819,	NULL },
90 { 0x41445340, 0xffffffff, "AD1881",		patch_ad1881,	NULL },
91 { 0x41445348, 0xffffffff, "AD1881A",		patch_ad1881,	NULL },
92 { 0x41445360, 0xffffffff, "AD1885",		patch_ad1885,	NULL },
93 { 0x41445361, 0xffffffff, "AD1886",		patch_ad1886,	NULL },
94 { 0x41445362, 0xffffffff, "AD1887",		patch_ad1881,	NULL },
95 { 0x41445363, 0xffffffff, "AD1886A",		patch_ad1881,	NULL },
96 { 0x41445368, 0xffffffff, "AD1888",		patch_ad1888,	NULL },
97 { 0x41445370, 0xffffffff, "AD1980",		patch_ad1980,	NULL },
98 { 0x41445372, 0xffffffff, "AD1981A",		patch_ad1981a,	NULL },
99 { 0x41445374, 0xffffffff, "AD1981B",		patch_ad1981b,	NULL },
100 { 0x41445375, 0xffffffff, "AD1985",		patch_ad1985,	NULL },
101 { 0x41445378, 0xffffffff, "AD1986",		patch_ad1986,	NULL },
102 { 0x414b4d00, 0xffffffff, "AK4540",		NULL,		NULL },
103 { 0x414b4d01, 0xffffffff, "AK4542",		NULL,		NULL },
104 { 0x414b4d02, 0xffffffff, "AK4543",		NULL,		NULL },
105 { 0x414b4d06, 0xffffffff, "AK4544A",		NULL,		NULL },
106 { 0x414b4d07, 0xffffffff, "AK4545",		NULL,		NULL },
107 { 0x414c4300, 0xffffff00, "ALC100,100P", 	NULL,		NULL },
108 { 0x414c4710, 0xfffffff0, "ALC200,200P",	NULL,		NULL },
109 { 0x414c4721, 0xffffffff, "ALC650D",		NULL,	NULL }, /* already patched */
110 { 0x414c4722, 0xffffffff, "ALC650E",		NULL,	NULL }, /* already patched */
111 { 0x414c4723, 0xffffffff, "ALC650F",		NULL,	NULL }, /* already patched */
112 { 0x414c4720, 0xfffffff0, "ALC650",		patch_alc650,	NULL },
113 { 0x414c4730, 0xffffffff, "ALC101",		NULL,		NULL },
114 { 0x414c4740, 0xfffffff0, "ALC202",		NULL,		NULL },
115 { 0x414c4750, 0xfffffff0, "ALC250",		NULL,		NULL },
116 { 0x414c4760, 0xfffffff0, "ALC655",		patch_alc655,	NULL },
117 { 0x414c4770, 0xfffffff0, "ALC203",		patch_alc203,	NULL },
118 { 0x414c4781, 0xffffffff, "ALC658D",		NULL,	NULL }, /* already patched */
119 { 0x414c4780, 0xfffffff0, "ALC658",		patch_alc655,	NULL },
120 { 0x414c4790, 0xfffffff0, "ALC850",		patch_alc850,	NULL },
121 { 0x415a5401, 0xffffffff, "AZF3328",		patch_aztech_azf3328,	NULL },
122 { 0x434d4941, 0xffffffff, "CMI9738",		patch_cm9738,	NULL },
123 { 0x434d4961, 0xffffffff, "CMI9739",		patch_cm9739,	NULL },
124 { 0x434d4969, 0xffffffff, "CMI9780",		patch_cm9780,	NULL },
125 { 0x434d4978, 0xffffffff, "CMI9761A",		patch_cm9761,	NULL },
126 { 0x434d4982, 0xffffffff, "CMI9761B",		patch_cm9761,	NULL },
127 { 0x434d4983, 0xffffffff, "CMI9761A+",		patch_cm9761,	NULL },
128 { 0x43525900, 0xfffffff8, "CS4297",		NULL,		NULL },
129 { 0x43525910, 0xfffffff8, "CS4297A",		patch_cirrus_spdif,	NULL },
130 { 0x43525920, 0xfffffff8, "CS4298",		patch_cirrus_spdif,		NULL },
131 { 0x43525928, 0xfffffff8, "CS4294",		NULL,		NULL },
132 { 0x43525930, 0xfffffff8, "CS4299",		patch_cirrus_cs4299,	NULL },
133 { 0x43525948, 0xfffffff8, "CS4201",		NULL,		NULL },
134 { 0x43525958, 0xfffffff8, "CS4205",		patch_cirrus_spdif,	NULL },
135 { 0x43525960, 0xfffffff8, "CS4291",		NULL,		NULL },
136 { 0x43525970, 0xfffffff8, "CS4202",		NULL,		NULL },
137 { 0x43585421, 0xffffffff, "HSD11246",		NULL,		NULL },	// SmartMC II
138 { 0x43585428, 0xfffffff8, "Cx20468",		patch_conexant,	NULL }, // SmartAMC fixme: the mask might be different
139 { 0x43585430, 0xffffffff, "Cx20468-31",		patch_conexant, NULL },
140 { 0x43585431, 0xffffffff, "Cx20551",           patch_cx20551,  NULL },
141 { 0x44543031, 0xfffffff0, "DT0398",		NULL,		NULL },
142 { 0x454d4328, 0xffffffff, "EM28028",		NULL,		NULL },  // same as TR28028?
143 { 0x45838308, 0xffffffff, "ESS1988",		NULL,		NULL },
144 { 0x48525300, 0xffffff00, "HMP9701",		NULL,		NULL },
145 { 0x49434501, 0xffffffff, "ICE1230",		NULL,		NULL },
146 { 0x49434511, 0xffffffff, "ICE1232",		NULL,		NULL }, // alias VIA VT1611A?
147 { 0x49434514, 0xffffffff, "ICE1232A",		NULL,		NULL },
148 { 0x49434551, 0xffffffff, "VT1616", 		patch_vt1616,	NULL },
149 { 0x49434552, 0xffffffff, "VT1616i",		patch_vt1616,	NULL }, // VT1616 compatible (chipset integrated)
150 { 0x49544520, 0xffffffff, "IT2226E",		NULL,		NULL },
151 { 0x49544561, 0xffffffff, "IT2646E",		patch_it2646,	NULL },
152 { 0x4e534300, 0xffffffff, "LM4540,43,45,46,48",	NULL,		NULL }, // only guess --jk
153 { 0x4e534331, 0xffffffff, "LM4549",		NULL,		NULL },
154 { 0x4e534350, 0xffffffff, "LM4550",		patch_lm4550,  	NULL }, // volume wrap fix
155 { 0x50534304, 0xffffffff, "UCB1400",		patch_ucb1400,	NULL },
156 { 0x53494c20, 0xffffffe0, "Si3036,8",		mpatch_si3036,	mpatch_si3036, AC97_MODEM_PATCH },
157 { 0x53544d02, 0xffffffff, "ST7597",		NULL,		NULL },
158 { 0x54524102, 0xffffffff, "TR28022",		NULL,		NULL },
159 { 0x54524103, 0xffffffff, "TR28023",		NULL,		NULL },
160 { 0x54524106, 0xffffffff, "TR28026",		NULL,		NULL },
161 { 0x54524108, 0xffffffff, "TR28028",		patch_tritech_tr28028,	NULL }, // added by xin jin [07/09/99]
162 { 0x54524123, 0xffffffff, "TR28602",		NULL,		NULL }, // only guess --jk [TR28023 = eMicro EM28023 (new CT1297)]
163 { 0x54584e03, 0xffffffff, "TLV320AIC27",	NULL,		NULL },
164 { 0x54584e20, 0xffffffff, "TLC320AD9xC",	NULL,		NULL },
165 { 0x56494120, 0xfffffff0, "VIA1613",		patch_vt1613,	NULL },
166 { 0x56494161, 0xffffffff, "VIA1612A",		NULL,		NULL }, // modified ICE1232 with S/PDIF
167 { 0x56494170, 0xffffffff, "VIA1617A",		patch_vt1617a,	NULL }, // modified VT1616 with S/PDIF
168 { 0x56494182, 0xffffffff, "VIA1618",		patch_vt1618,   NULL },
169 { 0x57454301, 0xffffffff, "W83971D",		NULL,		NULL },
170 { 0x574d4c00, 0xffffffff, "WM9701,WM9701A",	NULL,		NULL },
171 { 0x574d4C03, 0xffffffff, "WM9703,WM9707,WM9708,WM9717", patch_wolfson03, NULL},
172 { 0x574d4C04, 0xffffffff, "WM9704M,WM9704Q",	patch_wolfson04, NULL},
173 { 0x574d4C05, 0xffffffff, "WM9705,WM9710",	patch_wolfson05, NULL},
174 { 0x574d4C09, 0xffffffff, "WM9709",		NULL,		NULL},
175 { 0x574d4C12, 0xffffffff, "WM9711,WM9712,WM9715",	patch_wolfson11, NULL},
176 { 0x574d4c13, 0xffffffff, "WM9713,WM9714",	patch_wolfson13, NULL, AC97_DEFAULT_POWER_OFF},
177 { 0x594d4800, 0xffffffff, "YMF743",		patch_yamaha_ymf743,	NULL },
178 { 0x594d4802, 0xffffffff, "YMF752",		NULL,		NULL },
179 { 0x594d4803, 0xffffffff, "YMF753",		patch_yamaha_ymf753,	NULL },
180 { 0x83847600, 0xffffffff, "STAC9700,83,84",	patch_sigmatel_stac9700,	NULL },
181 { 0x83847604, 0xffffffff, "STAC9701,3,4,5",	NULL,		NULL },
182 { 0x83847605, 0xffffffff, "STAC9704",		NULL,		NULL },
183 { 0x83847608, 0xffffffff, "STAC9708,11",	patch_sigmatel_stac9708,	NULL },
184 { 0x83847609, 0xffffffff, "STAC9721,23",	patch_sigmatel_stac9721,	NULL },
185 { 0x83847644, 0xffffffff, "STAC9744",		patch_sigmatel_stac9744,	NULL },
186 { 0x83847650, 0xffffffff, "STAC9750,51",	NULL,		NULL },	// patch?
187 { 0x83847652, 0xffffffff, "STAC9752,53",	NULL,		NULL }, // patch?
188 { 0x83847656, 0xffffffff, "STAC9756,57",	patch_sigmatel_stac9756,	NULL },
189 { 0x83847658, 0xffffffff, "STAC9758,59",	patch_sigmatel_stac9758,	NULL },
190 { 0x83847666, 0xffffffff, "STAC9766,67",	NULL,		NULL }, // patch?
191 { 0, 	      0,	  NULL,			NULL,		NULL }
192 };
193 
194 
195 static void update_power_regs(struct snd_ac97 *ac97);
196 #ifdef CONFIG_SND_AC97_POWER_SAVE
197 #define ac97_is_power_save_mode(ac97) \
198 	((ac97->scaps & AC97_SCAP_POWER_SAVE) && power_save)
199 #else
200 #define ac97_is_power_save_mode(ac97) 0
201 #endif
202 
203 #define ac97_err(ac97, fmt, args...)	\
204 	dev_err((ac97)->bus->card->dev, fmt, ##args)
205 #define ac97_warn(ac97, fmt, args...)	\
206 	dev_warn((ac97)->bus->card->dev, fmt, ##args)
207 #define ac97_dbg(ac97, fmt, args...)	\
208 	dev_dbg((ac97)->bus->card->dev, fmt, ##args)
209 
210 /*
211  *  I/O routines
212  */
213 
214 static int snd_ac97_valid_reg(struct snd_ac97 *ac97, unsigned short reg)
215 {
216 	/* filter some registers for buggy codecs */
217 	switch (ac97->id) {
218 	case AC97_ID_ST_AC97_ID4:
219 		if (reg == 0x08)
220 			return 0;
221 		/* fall through */
222 	case AC97_ID_ST7597:
223 		if (reg == 0x22 || reg == 0x7a)
224 			return 1;
225 		/* fall through */
226 	case AC97_ID_AK4540:
227 	case AC97_ID_AK4542:
228 		if (reg <= 0x1c || reg == 0x20 || reg == 0x26 || reg >= 0x7c)
229 			return 1;
230 		return 0;
231 	case AC97_ID_AD1819:	/* AD1819 */
232 	case AC97_ID_AD1881:	/* AD1881 */
233 	case AC97_ID_AD1881A:	/* AD1881A */
234 		if (reg >= 0x3a && reg <= 0x6e)	/* 0x59 */
235 			return 0;
236 		return 1;
237 	case AC97_ID_AD1885:	/* AD1885 */
238 	case AC97_ID_AD1886:	/* AD1886 */
239 	case AC97_ID_AD1886A:	/* AD1886A - !!verify!! --jk */
240 	case AC97_ID_AD1887:	/* AD1887 - !!verify!! --jk */
241 		if (reg == 0x5a)
242 			return 1;
243 		if (reg >= 0x3c && reg <= 0x6e)	/* 0x59 */
244 			return 0;
245 		return 1;
246 	case AC97_ID_STAC9700:
247 	case AC97_ID_STAC9704:
248 	case AC97_ID_STAC9705:
249 	case AC97_ID_STAC9708:
250 	case AC97_ID_STAC9721:
251 	case AC97_ID_STAC9744:
252 	case AC97_ID_STAC9756:
253 		if (reg <= 0x3a || reg >= 0x5a)
254 			return 1;
255 		return 0;
256 	}
257 	return 1;
258 }
259 
260 /**
261  * snd_ac97_write - write a value on the given register
262  * @ac97: the ac97 instance
263  * @reg: the register to change
264  * @value: the value to set
265  *
266  * Writes a value on the given register.  This will invoke the write
267  * callback directly after the register check.
268  * This function doesn't change the register cache unlike
269  * #snd_ca97_write_cache(), so use this only when you don't want to
270  * reflect the change to the suspend/resume state.
271  */
272 void snd_ac97_write(struct snd_ac97 *ac97, unsigned short reg, unsigned short value)
273 {
274 	if (!snd_ac97_valid_reg(ac97, reg))
275 		return;
276 	if ((ac97->id & 0xffffff00) == AC97_ID_ALC100) {
277 		/* Fix H/W bug of ALC100/100P */
278 		if (reg == AC97_MASTER || reg == AC97_HEADPHONE)
279 			ac97->bus->ops->write(ac97, AC97_RESET, 0);	/* reset audio codec */
280 	}
281 	ac97->bus->ops->write(ac97, reg, value);
282 }
283 
284 EXPORT_SYMBOL(snd_ac97_write);
285 
286 /**
287  * snd_ac97_read - read a value from the given register
288  *
289  * @ac97: the ac97 instance
290  * @reg: the register to read
291  *
292  * Reads a value from the given register.  This will invoke the read
293  * callback directly after the register check.
294  *
295  * Return: The read value.
296  */
297 unsigned short snd_ac97_read(struct snd_ac97 *ac97, unsigned short reg)
298 {
299 	if (!snd_ac97_valid_reg(ac97, reg))
300 		return 0;
301 	return ac97->bus->ops->read(ac97, reg);
302 }
303 
304 /* read a register - return the cached value if already read */
305 static inline unsigned short snd_ac97_read_cache(struct snd_ac97 *ac97, unsigned short reg)
306 {
307 	if (! test_bit(reg, ac97->reg_accessed)) {
308 		ac97->regs[reg] = ac97->bus->ops->read(ac97, reg);
309 		// set_bit(reg, ac97->reg_accessed);
310 	}
311 	return ac97->regs[reg];
312 }
313 
314 EXPORT_SYMBOL(snd_ac97_read);
315 
316 /**
317  * snd_ac97_write_cache - write a value on the given register and update the cache
318  * @ac97: the ac97 instance
319  * @reg: the register to change
320  * @value: the value to set
321  *
322  * Writes a value on the given register and updates the register
323  * cache.  The cached values are used for the cached-read and the
324  * suspend/resume.
325  */
326 void snd_ac97_write_cache(struct snd_ac97 *ac97, unsigned short reg, unsigned short value)
327 {
328 	if (!snd_ac97_valid_reg(ac97, reg))
329 		return;
330 	mutex_lock(&ac97->reg_mutex);
331 	ac97->regs[reg] = value;
332 	ac97->bus->ops->write(ac97, reg, value);
333 	set_bit(reg, ac97->reg_accessed);
334 	mutex_unlock(&ac97->reg_mutex);
335 }
336 
337 EXPORT_SYMBOL(snd_ac97_write_cache);
338 
339 /**
340  * snd_ac97_update - update the value on the given register
341  * @ac97: the ac97 instance
342  * @reg: the register to change
343  * @value: the value to set
344  *
345  * Compares the value with the register cache and updates the value
346  * only when the value is changed.
347  *
348  * Return: 1 if the value is changed, 0 if no change, or a negative
349  * code on failure.
350  */
351 int snd_ac97_update(struct snd_ac97 *ac97, unsigned short reg, unsigned short value)
352 {
353 	int change;
354 
355 	if (!snd_ac97_valid_reg(ac97, reg))
356 		return -EINVAL;
357 	mutex_lock(&ac97->reg_mutex);
358 	change = ac97->regs[reg] != value;
359 	if (change) {
360 		ac97->regs[reg] = value;
361 		ac97->bus->ops->write(ac97, reg, value);
362 	}
363 	set_bit(reg, ac97->reg_accessed);
364 	mutex_unlock(&ac97->reg_mutex);
365 	return change;
366 }
367 
368 EXPORT_SYMBOL(snd_ac97_update);
369 
370 /**
371  * snd_ac97_update_bits - update the bits on the given register
372  * @ac97: the ac97 instance
373  * @reg: the register to change
374  * @mask: the bit-mask to change
375  * @value: the value to set
376  *
377  * Updates the masked-bits on the given register only when the value
378  * is changed.
379  *
380  * Return: 1 if the bits are changed, 0 if no change, or a negative
381  * code on failure.
382  */
383 int snd_ac97_update_bits(struct snd_ac97 *ac97, unsigned short reg, unsigned short mask, unsigned short value)
384 {
385 	int change;
386 
387 	if (!snd_ac97_valid_reg(ac97, reg))
388 		return -EINVAL;
389 	mutex_lock(&ac97->reg_mutex);
390 	change = snd_ac97_update_bits_nolock(ac97, reg, mask, value);
391 	mutex_unlock(&ac97->reg_mutex);
392 	return change;
393 }
394 
395 EXPORT_SYMBOL(snd_ac97_update_bits);
396 
397 /* no lock version - see snd_ac97_update_bits() */
398 int snd_ac97_update_bits_nolock(struct snd_ac97 *ac97, unsigned short reg,
399 				unsigned short mask, unsigned short value)
400 {
401 	int change;
402 	unsigned short old, new;
403 
404 	old = snd_ac97_read_cache(ac97, reg);
405 	new = (old & ~mask) | (value & mask);
406 	change = old != new;
407 	if (change) {
408 		ac97->regs[reg] = new;
409 		ac97->bus->ops->write(ac97, reg, new);
410 	}
411 	set_bit(reg, ac97->reg_accessed);
412 	return change;
413 }
414 
415 static int snd_ac97_ad18xx_update_pcm_bits(struct snd_ac97 *ac97, int codec, unsigned short mask, unsigned short value)
416 {
417 	int change;
418 	unsigned short old, new, cfg;
419 
420 	mutex_lock(&ac97->page_mutex);
421 	old = ac97->spec.ad18xx.pcmreg[codec];
422 	new = (old & ~mask) | (value & mask);
423 	change = old != new;
424 	if (change) {
425 		mutex_lock(&ac97->reg_mutex);
426 		cfg = snd_ac97_read_cache(ac97, AC97_AD_SERIAL_CFG);
427 		ac97->spec.ad18xx.pcmreg[codec] = new;
428 		/* select single codec */
429 		ac97->bus->ops->write(ac97, AC97_AD_SERIAL_CFG,
430 				 (cfg & ~0x7000) |
431 				 ac97->spec.ad18xx.unchained[codec] | ac97->spec.ad18xx.chained[codec]);
432 		/* update PCM bits */
433 		ac97->bus->ops->write(ac97, AC97_PCM, new);
434 		/* select all codecs */
435 		ac97->bus->ops->write(ac97, AC97_AD_SERIAL_CFG,
436 				 cfg | 0x7000);
437 		mutex_unlock(&ac97->reg_mutex);
438 	}
439 	mutex_unlock(&ac97->page_mutex);
440 	return change;
441 }
442 
443 /*
444  * Controls
445  */
446 
447 static int snd_ac97_info_enum_double(struct snd_kcontrol *kcontrol,
448 				     struct snd_ctl_elem_info *uinfo)
449 {
450 	struct ac97_enum *e = (struct ac97_enum *)kcontrol->private_value;
451 
452 	return snd_ctl_enum_info(uinfo, e->shift_l == e->shift_r ? 1 : 2,
453 				 e->mask, e->texts);
454 }
455 
456 static int snd_ac97_get_enum_double(struct snd_kcontrol *kcontrol,
457 				    struct snd_ctl_elem_value *ucontrol)
458 {
459 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
460 	struct ac97_enum *e = (struct ac97_enum *)kcontrol->private_value;
461 	unsigned short val, bitmask;
462 
463 	for (bitmask = 1; bitmask < e->mask; bitmask <<= 1)
464 		;
465 	val = snd_ac97_read_cache(ac97, e->reg);
466 	ucontrol->value.enumerated.item[0] = (val >> e->shift_l) & (bitmask - 1);
467 	if (e->shift_l != e->shift_r)
468 		ucontrol->value.enumerated.item[1] = (val >> e->shift_r) & (bitmask - 1);
469 
470 	return 0;
471 }
472 
473 static int snd_ac97_put_enum_double(struct snd_kcontrol *kcontrol,
474 				    struct snd_ctl_elem_value *ucontrol)
475 {
476 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
477 	struct ac97_enum *e = (struct ac97_enum *)kcontrol->private_value;
478 	unsigned short val;
479 	unsigned short mask, bitmask;
480 
481 	for (bitmask = 1; bitmask < e->mask; bitmask <<= 1)
482 		;
483 	if (ucontrol->value.enumerated.item[0] > e->mask - 1)
484 		return -EINVAL;
485 	val = ucontrol->value.enumerated.item[0] << e->shift_l;
486 	mask = (bitmask - 1) << e->shift_l;
487 	if (e->shift_l != e->shift_r) {
488 		if (ucontrol->value.enumerated.item[1] > e->mask - 1)
489 			return -EINVAL;
490 		val |= ucontrol->value.enumerated.item[1] << e->shift_r;
491 		mask |= (bitmask - 1) << e->shift_r;
492 	}
493 	return snd_ac97_update_bits(ac97, e->reg, mask, val);
494 }
495 
496 /* save/restore ac97 v2.3 paging */
497 static int snd_ac97_page_save(struct snd_ac97 *ac97, int reg, struct snd_kcontrol *kcontrol)
498 {
499 	int page_save = -1;
500 	if ((kcontrol->private_value & (1<<25)) &&
501 	    (ac97->ext_id & AC97_EI_REV_MASK) >= AC97_EI_REV_23 &&
502 	    (reg >= 0x60 && reg < 0x70)) {
503 		unsigned short page = (kcontrol->private_value >> 26) & 0x0f;
504 		mutex_lock(&ac97->page_mutex); /* lock paging */
505 		page_save = snd_ac97_read(ac97, AC97_INT_PAGING) & AC97_PAGE_MASK;
506 		snd_ac97_update_bits(ac97, AC97_INT_PAGING, AC97_PAGE_MASK, page);
507 	}
508 	return page_save;
509 }
510 
511 static void snd_ac97_page_restore(struct snd_ac97 *ac97, int page_save)
512 {
513 	if (page_save >= 0) {
514 		snd_ac97_update_bits(ac97, AC97_INT_PAGING, AC97_PAGE_MASK, page_save);
515 		mutex_unlock(&ac97->page_mutex); /* unlock paging */
516 	}
517 }
518 
519 /* volume and switch controls */
520 static int snd_ac97_info_volsw(struct snd_kcontrol *kcontrol,
521 			       struct snd_ctl_elem_info *uinfo)
522 {
523 	int mask = (kcontrol->private_value >> 16) & 0xff;
524 	int shift = (kcontrol->private_value >> 8) & 0x0f;
525 	int rshift = (kcontrol->private_value >> 12) & 0x0f;
526 
527 	uinfo->type = mask == 1 ? SNDRV_CTL_ELEM_TYPE_BOOLEAN : SNDRV_CTL_ELEM_TYPE_INTEGER;
528 	uinfo->count = shift == rshift ? 1 : 2;
529 	uinfo->value.integer.min = 0;
530 	uinfo->value.integer.max = mask;
531 	return 0;
532 }
533 
534 static int snd_ac97_get_volsw(struct snd_kcontrol *kcontrol,
535 			      struct snd_ctl_elem_value *ucontrol)
536 {
537 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
538 	int reg = kcontrol->private_value & 0xff;
539 	int shift = (kcontrol->private_value >> 8) & 0x0f;
540 	int rshift = (kcontrol->private_value >> 12) & 0x0f;
541 	int mask = (kcontrol->private_value >> 16) & 0xff;
542 	int invert = (kcontrol->private_value >> 24) & 0x01;
543 	int page_save;
544 
545 	page_save = snd_ac97_page_save(ac97, reg, kcontrol);
546 	ucontrol->value.integer.value[0] = (snd_ac97_read_cache(ac97, reg) >> shift) & mask;
547 	if (shift != rshift)
548 		ucontrol->value.integer.value[1] = (snd_ac97_read_cache(ac97, reg) >> rshift) & mask;
549 	if (invert) {
550 		ucontrol->value.integer.value[0] = mask - ucontrol->value.integer.value[0];
551 		if (shift != rshift)
552 			ucontrol->value.integer.value[1] = mask - ucontrol->value.integer.value[1];
553 	}
554 	snd_ac97_page_restore(ac97, page_save);
555 	return 0;
556 }
557 
558 static int snd_ac97_put_volsw(struct snd_kcontrol *kcontrol,
559 			      struct snd_ctl_elem_value *ucontrol)
560 {
561 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
562 	int reg = kcontrol->private_value & 0xff;
563 	int shift = (kcontrol->private_value >> 8) & 0x0f;
564 	int rshift = (kcontrol->private_value >> 12) & 0x0f;
565 	int mask = (kcontrol->private_value >> 16) & 0xff;
566 	int invert = (kcontrol->private_value >> 24) & 0x01;
567 	int err, page_save;
568 	unsigned short val, val2, val_mask;
569 
570 	page_save = snd_ac97_page_save(ac97, reg, kcontrol);
571 	val = (ucontrol->value.integer.value[0] & mask);
572 	if (invert)
573 		val = mask - val;
574 	val_mask = mask << shift;
575 	val = val << shift;
576 	if (shift != rshift) {
577 		val2 = (ucontrol->value.integer.value[1] & mask);
578 		if (invert)
579 			val2 = mask - val2;
580 		val_mask |= mask << rshift;
581 		val |= val2 << rshift;
582 	}
583 	err = snd_ac97_update_bits(ac97, reg, val_mask, val);
584 	snd_ac97_page_restore(ac97, page_save);
585 #ifdef CONFIG_SND_AC97_POWER_SAVE
586 	/* check analog mixer power-down */
587 	if ((val_mask & AC97_PD_EAPD) &&
588 	    (kcontrol->private_value & (1<<30))) {
589 		if (val & AC97_PD_EAPD)
590 			ac97->power_up &= ~(1 << (reg>>1));
591 		else
592 			ac97->power_up |= 1 << (reg>>1);
593 		update_power_regs(ac97);
594 	}
595 #endif
596 	return err;
597 }
598 
599 static const struct snd_kcontrol_new snd_ac97_controls_master_mono[2] = {
600 AC97_SINGLE("Master Mono Playback Switch", AC97_MASTER_MONO, 15, 1, 1),
601 AC97_SINGLE("Master Mono Playback Volume", AC97_MASTER_MONO, 0, 31, 1)
602 };
603 
604 static const struct snd_kcontrol_new snd_ac97_controls_tone[2] = {
605 AC97_SINGLE("Tone Control - Bass", AC97_MASTER_TONE, 8, 15, 1),
606 AC97_SINGLE("Tone Control - Treble", AC97_MASTER_TONE, 0, 15, 1)
607 };
608 
609 static const struct snd_kcontrol_new snd_ac97_controls_pc_beep[2] = {
610 AC97_SINGLE("Beep Playback Switch", AC97_PC_BEEP, 15, 1, 1),
611 AC97_SINGLE("Beep Playback Volume", AC97_PC_BEEP, 1, 15, 1)
612 };
613 
614 static const struct snd_kcontrol_new snd_ac97_controls_mic_boost =
615 	AC97_SINGLE("Mic Boost (+20dB)", AC97_MIC, 6, 1, 0);
616 
617 
618 static const char* std_rec_sel[] = {"Mic", "CD", "Video", "Aux", "Line", "Mix", "Mix Mono", "Phone"};
619 static const char* std_3d_path[] = {"pre 3D", "post 3D"};
620 static const char* std_mix[] = {"Mix", "Mic"};
621 static const char* std_mic[] = {"Mic1", "Mic2"};
622 
623 static const struct ac97_enum std_enum[] = {
624 AC97_ENUM_DOUBLE(AC97_REC_SEL, 8, 0, 8, std_rec_sel),
625 AC97_ENUM_SINGLE(AC97_GENERAL_PURPOSE, 15, 2, std_3d_path),
626 AC97_ENUM_SINGLE(AC97_GENERAL_PURPOSE, 9, 2, std_mix),
627 AC97_ENUM_SINGLE(AC97_GENERAL_PURPOSE, 8, 2, std_mic),
628 };
629 
630 static const struct snd_kcontrol_new snd_ac97_control_capture_src =
631 AC97_ENUM("Capture Source", std_enum[0]);
632 
633 static const struct snd_kcontrol_new snd_ac97_control_capture_vol =
634 AC97_DOUBLE("Capture Volume", AC97_REC_GAIN, 8, 0, 15, 0);
635 
636 static const struct snd_kcontrol_new snd_ac97_controls_mic_capture[2] = {
637 AC97_SINGLE("Mic Capture Switch", AC97_REC_GAIN_MIC, 15, 1, 1),
638 AC97_SINGLE("Mic Capture Volume", AC97_REC_GAIN_MIC, 0, 15, 0)
639 };
640 
641 enum {
642 	AC97_GENERAL_PCM_OUT = 0,
643 	AC97_GENERAL_STEREO_ENHANCEMENT,
644 	AC97_GENERAL_3D,
645 	AC97_GENERAL_LOUDNESS,
646 	AC97_GENERAL_MONO,
647 	AC97_GENERAL_MIC,
648 	AC97_GENERAL_LOOPBACK
649 };
650 
651 static const struct snd_kcontrol_new snd_ac97_controls_general[7] = {
652 AC97_ENUM("PCM Out Path & Mute", std_enum[1]),
653 AC97_SINGLE("Simulated Stereo Enhancement", AC97_GENERAL_PURPOSE, 14, 1, 0),
654 AC97_SINGLE("3D Control - Switch", AC97_GENERAL_PURPOSE, 13, 1, 0),
655 AC97_SINGLE("Loudness (bass boost)", AC97_GENERAL_PURPOSE, 12, 1, 0),
656 AC97_ENUM("Mono Output Select", std_enum[2]),
657 AC97_ENUM("Mic Select", std_enum[3]),
658 AC97_SINGLE("ADC/DAC Loopback", AC97_GENERAL_PURPOSE, 7, 1, 0)
659 };
660 
661 static const struct snd_kcontrol_new snd_ac97_controls_3d[2] = {
662 AC97_SINGLE("3D Control - Center", AC97_3D_CONTROL, 8, 15, 0),
663 AC97_SINGLE("3D Control - Depth", AC97_3D_CONTROL, 0, 15, 0)
664 };
665 
666 static const struct snd_kcontrol_new snd_ac97_controls_center[2] = {
667 AC97_SINGLE("Center Playback Switch", AC97_CENTER_LFE_MASTER, 7, 1, 1),
668 AC97_SINGLE("Center Playback Volume", AC97_CENTER_LFE_MASTER, 0, 31, 1)
669 };
670 
671 static const struct snd_kcontrol_new snd_ac97_controls_lfe[2] = {
672 AC97_SINGLE("LFE Playback Switch", AC97_CENTER_LFE_MASTER, 15, 1, 1),
673 AC97_SINGLE("LFE Playback Volume", AC97_CENTER_LFE_MASTER, 8, 31, 1)
674 };
675 
676 static const struct snd_kcontrol_new snd_ac97_control_eapd =
677 AC97_SINGLE("External Amplifier", AC97_POWERDOWN, 15, 1, 1);
678 
679 static const struct snd_kcontrol_new snd_ac97_controls_modem_switches[2] = {
680 AC97_SINGLE("Off-hook Switch", AC97_GPIO_STATUS, 0, 1, 0),
681 AC97_SINGLE("Caller ID Switch", AC97_GPIO_STATUS, 2, 1, 0)
682 };
683 
684 /* change the existing EAPD control as inverted */
685 static void set_inv_eapd(struct snd_ac97 *ac97, struct snd_kcontrol *kctl)
686 {
687 	kctl->private_value = AC97_SINGLE_VALUE(AC97_POWERDOWN, 15, 1, 0);
688 	snd_ac97_update_bits(ac97, AC97_POWERDOWN, (1<<15), (1<<15)); /* EAPD up */
689 	ac97->scaps |= AC97_SCAP_INV_EAPD;
690 }
691 
692 static int snd_ac97_spdif_mask_info(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo)
693 {
694 	uinfo->type = SNDRV_CTL_ELEM_TYPE_IEC958;
695 	uinfo->count = 1;
696 	return 0;
697 }
698 
699 static int snd_ac97_spdif_cmask_get(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
700 {
701 	ucontrol->value.iec958.status[0] = IEC958_AES0_PROFESSIONAL |
702 					   IEC958_AES0_NONAUDIO |
703 					   IEC958_AES0_CON_EMPHASIS_5015 |
704 					   IEC958_AES0_CON_NOT_COPYRIGHT;
705 	ucontrol->value.iec958.status[1] = IEC958_AES1_CON_CATEGORY |
706 					   IEC958_AES1_CON_ORIGINAL;
707 	ucontrol->value.iec958.status[3] = IEC958_AES3_CON_FS;
708 	return 0;
709 }
710 
711 static int snd_ac97_spdif_pmask_get(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
712 {
713 	/* FIXME: AC'97 spec doesn't say which bits are used for what */
714 	ucontrol->value.iec958.status[0] = IEC958_AES0_PROFESSIONAL |
715 					   IEC958_AES0_NONAUDIO |
716 					   IEC958_AES0_PRO_FS |
717 					   IEC958_AES0_PRO_EMPHASIS_5015;
718 	return 0;
719 }
720 
721 static int snd_ac97_spdif_default_get(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
722 {
723 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
724 
725 	mutex_lock(&ac97->reg_mutex);
726 	ucontrol->value.iec958.status[0] = ac97->spdif_status & 0xff;
727 	ucontrol->value.iec958.status[1] = (ac97->spdif_status >> 8) & 0xff;
728 	ucontrol->value.iec958.status[2] = (ac97->spdif_status >> 16) & 0xff;
729 	ucontrol->value.iec958.status[3] = (ac97->spdif_status >> 24) & 0xff;
730 	mutex_unlock(&ac97->reg_mutex);
731 	return 0;
732 }
733 
734 static int snd_ac97_spdif_default_put(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
735 {
736 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
737 	unsigned int new = 0;
738 	unsigned short val = 0;
739 	int change;
740 
741 	new = val = ucontrol->value.iec958.status[0] & (IEC958_AES0_PROFESSIONAL|IEC958_AES0_NONAUDIO);
742 	if (ucontrol->value.iec958.status[0] & IEC958_AES0_PROFESSIONAL) {
743 		new |= ucontrol->value.iec958.status[0] & (IEC958_AES0_PRO_FS|IEC958_AES0_PRO_EMPHASIS_5015);
744 		switch (new & IEC958_AES0_PRO_FS) {
745 		case IEC958_AES0_PRO_FS_44100: val |= 0<<12; break;
746 		case IEC958_AES0_PRO_FS_48000: val |= 2<<12; break;
747 		case IEC958_AES0_PRO_FS_32000: val |= 3<<12; break;
748 		default:		       val |= 1<<12; break;
749 		}
750 		if ((new & IEC958_AES0_PRO_EMPHASIS) == IEC958_AES0_PRO_EMPHASIS_5015)
751 			val |= 1<<3;
752 	} else {
753 		new |= ucontrol->value.iec958.status[0] & (IEC958_AES0_CON_EMPHASIS_5015|IEC958_AES0_CON_NOT_COPYRIGHT);
754 		new |= ((ucontrol->value.iec958.status[1] & (IEC958_AES1_CON_CATEGORY|IEC958_AES1_CON_ORIGINAL)) << 8);
755 		new |= ((ucontrol->value.iec958.status[3] & IEC958_AES3_CON_FS) << 24);
756 		if ((new & IEC958_AES0_CON_EMPHASIS) == IEC958_AES0_CON_EMPHASIS_5015)
757 			val |= 1<<3;
758 		if (!(new & IEC958_AES0_CON_NOT_COPYRIGHT))
759 			val |= 1<<2;
760 		val |= ((new >> 8) & 0xff) << 4;	// category + original
761 		switch ((new >> 24) & 0xff) {
762 		case IEC958_AES3_CON_FS_44100: val |= 0<<12; break;
763 		case IEC958_AES3_CON_FS_48000: val |= 2<<12; break;
764 		case IEC958_AES3_CON_FS_32000: val |= 3<<12; break;
765 		default:		       val |= 1<<12; break;
766 		}
767 	}
768 
769 	mutex_lock(&ac97->reg_mutex);
770 	change = ac97->spdif_status != new;
771 	ac97->spdif_status = new;
772 
773 	if (ac97->flags & AC97_CS_SPDIF) {
774 		int x = (val >> 12) & 0x03;
775 		switch (x) {
776 		case 0: x = 1; break;  // 44.1
777 		case 2: x = 0; break;  // 48.0
778 		default: x = 0; break; // illegal.
779 		}
780 		change |= snd_ac97_update_bits_nolock(ac97, AC97_CSR_SPDIF, 0x3fff, ((val & 0xcfff) | (x << 12)));
781 	} else if (ac97->flags & AC97_CX_SPDIF) {
782 		int v;
783 		v = new & (IEC958_AES0_CON_EMPHASIS_5015|IEC958_AES0_CON_NOT_COPYRIGHT) ? 0 : AC97_CXR_COPYRGT;
784 		v |= new & IEC958_AES0_NONAUDIO ? AC97_CXR_SPDIF_AC3 : AC97_CXR_SPDIF_PCM;
785 		change |= snd_ac97_update_bits_nolock(ac97, AC97_CXR_AUDIO_MISC,
786 						      AC97_CXR_SPDIF_MASK | AC97_CXR_COPYRGT,
787 						      v);
788 	} else if (ac97->id == AC97_ID_YMF743) {
789 		change |= snd_ac97_update_bits_nolock(ac97,
790 						      AC97_YMF7X3_DIT_CTRL,
791 						      0xff38,
792 						      ((val << 4) & 0xff00) |
793 						      ((val << 2) & 0x0038));
794 	} else {
795 		unsigned short extst = snd_ac97_read_cache(ac97, AC97_EXTENDED_STATUS);
796 		snd_ac97_update_bits_nolock(ac97, AC97_EXTENDED_STATUS, AC97_EA_SPDIF, 0); /* turn off */
797 
798 		change |= snd_ac97_update_bits_nolock(ac97, AC97_SPDIF, 0x3fff, val);
799 		if (extst & AC97_EA_SPDIF) {
800 			snd_ac97_update_bits_nolock(ac97, AC97_EXTENDED_STATUS, AC97_EA_SPDIF, AC97_EA_SPDIF); /* turn on again */
801                 }
802 	}
803 	mutex_unlock(&ac97->reg_mutex);
804 
805 	return change;
806 }
807 
808 static int snd_ac97_put_spsa(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
809 {
810 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
811 	int reg = kcontrol->private_value & 0xff;
812 	int shift = (kcontrol->private_value >> 8) & 0x0f;
813 	int mask = (kcontrol->private_value >> 16) & 0xff;
814 	// int invert = (kcontrol->private_value >> 24) & 0xff;
815 	unsigned short value, old, new;
816 	int change;
817 
818 	value = (ucontrol->value.integer.value[0] & mask);
819 
820 	mutex_lock(&ac97->reg_mutex);
821 	mask <<= shift;
822 	value <<= shift;
823 	old = snd_ac97_read_cache(ac97, reg);
824 	new = (old & ~mask) | value;
825 	change = old != new;
826 
827 	if (change) {
828 		unsigned short extst = snd_ac97_read_cache(ac97, AC97_EXTENDED_STATUS);
829 		snd_ac97_update_bits_nolock(ac97, AC97_EXTENDED_STATUS, AC97_EA_SPDIF, 0); /* turn off */
830 		change = snd_ac97_update_bits_nolock(ac97, reg, mask, value);
831 		if (extst & AC97_EA_SPDIF)
832 			snd_ac97_update_bits_nolock(ac97, AC97_EXTENDED_STATUS, AC97_EA_SPDIF, AC97_EA_SPDIF); /* turn on again */
833 	}
834 	mutex_unlock(&ac97->reg_mutex);
835 	return change;
836 }
837 
838 static const struct snd_kcontrol_new snd_ac97_controls_spdif[5] = {
839 	{
840 		.access = SNDRV_CTL_ELEM_ACCESS_READ,
841 		.iface = SNDRV_CTL_ELEM_IFACE_MIXER,
842 		.name = SNDRV_CTL_NAME_IEC958("",PLAYBACK,CON_MASK),
843 		.info = snd_ac97_spdif_mask_info,
844 		.get = snd_ac97_spdif_cmask_get,
845 	},
846 	{
847 		.access = SNDRV_CTL_ELEM_ACCESS_READ,
848 		.iface = SNDRV_CTL_ELEM_IFACE_MIXER,
849 		.name = SNDRV_CTL_NAME_IEC958("",PLAYBACK,PRO_MASK),
850 		.info = snd_ac97_spdif_mask_info,
851 		.get = snd_ac97_spdif_pmask_get,
852 	},
853 	{
854 		.iface = SNDRV_CTL_ELEM_IFACE_MIXER,
855 		.name = SNDRV_CTL_NAME_IEC958("",PLAYBACK,DEFAULT),
856 		.info = snd_ac97_spdif_mask_info,
857 		.get = snd_ac97_spdif_default_get,
858 		.put = snd_ac97_spdif_default_put,
859 	},
860 
861 	AC97_SINGLE(SNDRV_CTL_NAME_IEC958("",PLAYBACK,SWITCH),AC97_EXTENDED_STATUS, 2, 1, 0),
862 	{
863 		.iface = SNDRV_CTL_ELEM_IFACE_MIXER,
864 		.name = SNDRV_CTL_NAME_IEC958("",PLAYBACK,NONE) "AC97-SPSA",
865 		.info = snd_ac97_info_volsw,
866 		.get = snd_ac97_get_volsw,
867 		.put = snd_ac97_put_spsa,
868 		.private_value = AC97_SINGLE_VALUE(AC97_EXTENDED_STATUS, 4, 3, 0)
869 	},
870 };
871 
872 #define AD18XX_PCM_BITS(xname, codec, lshift, rshift, mask) \
873 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .info = snd_ac97_ad18xx_pcm_info_bits, \
874   .get = snd_ac97_ad18xx_pcm_get_bits, .put = snd_ac97_ad18xx_pcm_put_bits, \
875   .private_value = (codec) | ((lshift) << 8) | ((rshift) << 12) | ((mask) << 16) }
876 
877 static int snd_ac97_ad18xx_pcm_info_bits(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo)
878 {
879 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
880 	int mask = (kcontrol->private_value >> 16) & 0x0f;
881 	int lshift = (kcontrol->private_value >> 8) & 0x0f;
882 	int rshift = (kcontrol->private_value >> 12) & 0x0f;
883 
884 	uinfo->type = mask == 1 ? SNDRV_CTL_ELEM_TYPE_BOOLEAN : SNDRV_CTL_ELEM_TYPE_INTEGER;
885 	if (lshift != rshift && (ac97->flags & AC97_STEREO_MUTES))
886 		uinfo->count = 2;
887 	else
888 		uinfo->count = 1;
889 	uinfo->value.integer.min = 0;
890 	uinfo->value.integer.max = mask;
891 	return 0;
892 }
893 
894 static int snd_ac97_ad18xx_pcm_get_bits(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
895 {
896 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
897 	int codec = kcontrol->private_value & 3;
898 	int lshift = (kcontrol->private_value >> 8) & 0x0f;
899 	int rshift = (kcontrol->private_value >> 12) & 0x0f;
900 	int mask = (kcontrol->private_value >> 16) & 0xff;
901 
902 	ucontrol->value.integer.value[0] = mask - ((ac97->spec.ad18xx.pcmreg[codec] >> lshift) & mask);
903 	if (lshift != rshift && (ac97->flags & AC97_STEREO_MUTES))
904 		ucontrol->value.integer.value[1] = mask - ((ac97->spec.ad18xx.pcmreg[codec] >> rshift) & mask);
905 	return 0;
906 }
907 
908 static int snd_ac97_ad18xx_pcm_put_bits(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
909 {
910 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
911 	int codec = kcontrol->private_value & 3;
912 	int lshift = (kcontrol->private_value >> 8) & 0x0f;
913 	int rshift = (kcontrol->private_value >> 12) & 0x0f;
914 	int mask = (kcontrol->private_value >> 16) & 0xff;
915 	unsigned short val, valmask;
916 
917 	val = (mask - (ucontrol->value.integer.value[0] & mask)) << lshift;
918 	valmask = mask << lshift;
919 	if (lshift != rshift && (ac97->flags & AC97_STEREO_MUTES)) {
920 		val |= (mask - (ucontrol->value.integer.value[1] & mask)) << rshift;
921 		valmask |= mask << rshift;
922 	}
923 	return snd_ac97_ad18xx_update_pcm_bits(ac97, codec, valmask, val);
924 }
925 
926 #define AD18XX_PCM_VOLUME(xname, codec) \
927 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .info = snd_ac97_ad18xx_pcm_info_volume, \
928   .get = snd_ac97_ad18xx_pcm_get_volume, .put = snd_ac97_ad18xx_pcm_put_volume, \
929   .private_value = codec }
930 
931 static int snd_ac97_ad18xx_pcm_info_volume(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo)
932 {
933 	uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
934 	uinfo->count = 2;
935 	uinfo->value.integer.min = 0;
936 	uinfo->value.integer.max = 31;
937 	return 0;
938 }
939 
940 static int snd_ac97_ad18xx_pcm_get_volume(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
941 {
942 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
943 	int codec = kcontrol->private_value & 3;
944 
945 	mutex_lock(&ac97->page_mutex);
946 	ucontrol->value.integer.value[0] = 31 - ((ac97->spec.ad18xx.pcmreg[codec] >> 0) & 31);
947 	ucontrol->value.integer.value[1] = 31 - ((ac97->spec.ad18xx.pcmreg[codec] >> 8) & 31);
948 	mutex_unlock(&ac97->page_mutex);
949 	return 0;
950 }
951 
952 static int snd_ac97_ad18xx_pcm_put_volume(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
953 {
954 	struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
955 	int codec = kcontrol->private_value & 3;
956 	unsigned short val1, val2;
957 
958 	val1 = 31 - (ucontrol->value.integer.value[0] & 31);
959 	val2 = 31 - (ucontrol->value.integer.value[1] & 31);
960 	return snd_ac97_ad18xx_update_pcm_bits(ac97, codec, 0x1f1f, (val1 << 8) | val2);
961 }
962 
963 static const struct snd_kcontrol_new snd_ac97_controls_ad18xx_pcm[2] = {
964 AD18XX_PCM_BITS("PCM Playback Switch", 0, 15, 7, 1),
965 AD18XX_PCM_VOLUME("PCM Playback Volume", 0)
966 };
967 
968 static const struct snd_kcontrol_new snd_ac97_controls_ad18xx_surround[2] = {
969 AD18XX_PCM_BITS("Surround Playback Switch", 1, 15, 7, 1),
970 AD18XX_PCM_VOLUME("Surround Playback Volume", 1)
971 };
972 
973 static const struct snd_kcontrol_new snd_ac97_controls_ad18xx_center[2] = {
974 AD18XX_PCM_BITS("Center Playback Switch", 2, 15, 15, 1),
975 AD18XX_PCM_BITS("Center Playback Volume", 2, 8, 8, 31)
976 };
977 
978 static const struct snd_kcontrol_new snd_ac97_controls_ad18xx_lfe[2] = {
979 AD18XX_PCM_BITS("LFE Playback Switch", 2, 7, 7, 1),
980 AD18XX_PCM_BITS("LFE Playback Volume", 2, 0, 0, 31)
981 };
982 
983 /*
984  *
985  */
986 
987 static void snd_ac97_powerdown(struct snd_ac97 *ac97);
988 
989 static int snd_ac97_bus_free(struct snd_ac97_bus *bus)
990 {
991 	if (bus) {
992 		snd_ac97_bus_proc_done(bus);
993 		kfree(bus->pcms);
994 		if (bus->private_free)
995 			bus->private_free(bus);
996 		kfree(bus);
997 	}
998 	return 0;
999 }
1000 
1001 static int snd_ac97_bus_dev_free(struct snd_device *device)
1002 {
1003 	struct snd_ac97_bus *bus = device->device_data;
1004 	return snd_ac97_bus_free(bus);
1005 }
1006 
1007 static int snd_ac97_free(struct snd_ac97 *ac97)
1008 {
1009 	if (ac97) {
1010 #ifdef CONFIG_SND_AC97_POWER_SAVE
1011 		cancel_delayed_work_sync(&ac97->power_work);
1012 #endif
1013 		snd_ac97_proc_done(ac97);
1014 		if (ac97->bus)
1015 			ac97->bus->codec[ac97->num] = NULL;
1016 		if (ac97->private_free)
1017 			ac97->private_free(ac97);
1018 		kfree(ac97);
1019 	}
1020 	return 0;
1021 }
1022 
1023 static int snd_ac97_dev_free(struct snd_device *device)
1024 {
1025 	struct snd_ac97 *ac97 = device->device_data;
1026 	snd_ac97_powerdown(ac97); /* for avoiding click noises during shut down */
1027 	return snd_ac97_free(ac97);
1028 }
1029 
1030 static int snd_ac97_try_volume_mix(struct snd_ac97 * ac97, int reg)
1031 {
1032 	unsigned short val, mask = AC97_MUTE_MASK_MONO;
1033 
1034 	if (! snd_ac97_valid_reg(ac97, reg))
1035 		return 0;
1036 
1037 	switch (reg) {
1038 	case AC97_MASTER_TONE:
1039 		return ac97->caps & AC97_BC_BASS_TREBLE ? 1 : 0;
1040 	case AC97_HEADPHONE:
1041 		return ac97->caps & AC97_BC_HEADPHONE ? 1 : 0;
1042 	case AC97_REC_GAIN_MIC:
1043 		return ac97->caps & AC97_BC_DEDICATED_MIC ? 1 : 0;
1044 	case AC97_3D_CONTROL:
1045 		if (ac97->caps & AC97_BC_3D_TECH_ID_MASK) {
1046 			val = snd_ac97_read(ac97, reg);
1047 			/* if nonzero - fixed and we can't set it */
1048 			return val == 0;
1049 		}
1050 		return 0;
1051 	case AC97_CENTER_LFE_MASTER:	/* center */
1052 		if ((ac97->ext_id & AC97_EI_CDAC) == 0)
1053 			return 0;
1054 		break;
1055 	case AC97_CENTER_LFE_MASTER+1:	/* lfe */
1056 		if ((ac97->ext_id & AC97_EI_LDAC) == 0)
1057 			return 0;
1058 		reg = AC97_CENTER_LFE_MASTER;
1059 		mask = 0x0080;
1060 		break;
1061 	case AC97_SURROUND_MASTER:
1062 		if ((ac97->ext_id & AC97_EI_SDAC) == 0)
1063 			return 0;
1064 		break;
1065 	}
1066 
1067 	val = snd_ac97_read(ac97, reg);
1068 	if (!(val & mask)) {
1069 		/* nothing seems to be here - mute flag is not set */
1070 		/* try another test */
1071 		snd_ac97_write_cache(ac97, reg, val | mask);
1072 		val = snd_ac97_read(ac97, reg);
1073 		val = snd_ac97_read(ac97, reg);
1074 		if (!(val & mask))
1075 			return 0;	/* nothing here */
1076 	}
1077 	return 1;		/* success, useable */
1078 }
1079 
1080 static void check_volume_resolution(struct snd_ac97 *ac97, int reg, unsigned char *lo_max, unsigned char *hi_max)
1081 {
1082 	unsigned short cbit[3] = { 0x20, 0x10, 0x01 };
1083 	unsigned char max[3] = { 63, 31, 15 };
1084 	int i;
1085 
1086 	/* first look up the static resolution table */
1087 	if (ac97->res_table) {
1088 		const struct snd_ac97_res_table *tbl;
1089 		for (tbl = ac97->res_table; tbl->reg; tbl++) {
1090 			if (tbl->reg == reg) {
1091 				*lo_max = tbl->bits & 0xff;
1092 				*hi_max = (tbl->bits >> 8) & 0xff;
1093 				return;
1094 			}
1095 		}
1096 	}
1097 
1098 	*lo_max = *hi_max = 0;
1099 	for (i = 0 ; i < ARRAY_SIZE(cbit); i++) {
1100 		unsigned short val;
1101 		snd_ac97_write(
1102 			ac97, reg,
1103 			AC97_MUTE_MASK_STEREO | cbit[i] | (cbit[i] << 8)
1104 		);
1105 		/* Do the read twice due to buffers on some ac97 codecs.
1106 		 * e.g. The STAC9704 returns exactly what you wrote to the register
1107 		 * if you read it immediately. This causes the detect routine to fail.
1108 		 */
1109 		val = snd_ac97_read(ac97, reg);
1110 		val = snd_ac97_read(ac97, reg);
1111 		if (! *lo_max && (val & 0x7f) == cbit[i])
1112 			*lo_max = max[i];
1113 		if (! *hi_max && ((val >> 8) & 0x7f) == cbit[i])
1114 			*hi_max = max[i];
1115 		if (*lo_max && *hi_max)
1116 			break;
1117 	}
1118 }
1119 
1120 static int snd_ac97_try_bit(struct snd_ac97 * ac97, int reg, int bit)
1121 {
1122 	unsigned short mask, val, orig, res;
1123 
1124 	mask = 1 << bit;
1125 	orig = snd_ac97_read(ac97, reg);
1126 	val = orig ^ mask;
1127 	snd_ac97_write(ac97, reg, val);
1128 	res = snd_ac97_read(ac97, reg);
1129 	snd_ac97_write_cache(ac97, reg, orig);
1130 	return res == val;
1131 }
1132 
1133 /* check the volume resolution of center/lfe */
1134 static void snd_ac97_change_volume_params2(struct snd_ac97 * ac97, int reg, int shift, unsigned char *max)
1135 {
1136 	unsigned short val, val1;
1137 
1138 	*max = 63;
1139 	val = AC97_MUTE_MASK_STEREO | (0x20 << shift);
1140 	snd_ac97_write(ac97, reg, val);
1141 	val1 = snd_ac97_read(ac97, reg);
1142 	if (val != val1) {
1143 		*max = 31;
1144 	}
1145 	/* reset volume to zero */
1146 	snd_ac97_write_cache(ac97, reg, AC97_MUTE_MASK_STEREO);
1147 }
1148 
1149 static inline int printable(unsigned int x)
1150 {
1151 	x &= 0xff;
1152 	if (x < ' ' || x >= 0x71) {
1153 		if (x <= 0x89)
1154 			return x - 0x71 + 'A';
1155 		return '?';
1156 	}
1157 	return x;
1158 }
1159 
1160 static struct snd_kcontrol *snd_ac97_cnew(const struct snd_kcontrol_new *_template,
1161 					  struct snd_ac97 * ac97)
1162 {
1163 	struct snd_kcontrol_new template;
1164 	memcpy(&template, _template, sizeof(template));
1165 	template.index = ac97->num;
1166 	return snd_ctl_new1(&template, ac97);
1167 }
1168 
1169 /*
1170  * create mute switch(es) for normal stereo controls
1171  */
1172 static int snd_ac97_cmute_new_stereo(struct snd_card *card, char *name, int reg,
1173 				     int check_stereo, int check_amix,
1174 				     struct snd_ac97 *ac97)
1175 {
1176 	struct snd_kcontrol *kctl;
1177 	int err;
1178 	unsigned short val, val1, mute_mask;
1179 
1180 	if (! snd_ac97_valid_reg(ac97, reg))
1181 		return 0;
1182 
1183 	mute_mask = AC97_MUTE_MASK_MONO;
1184 	val = snd_ac97_read(ac97, reg);
1185 	if (check_stereo || (ac97->flags & AC97_STEREO_MUTES)) {
1186 		/* check whether both mute bits work */
1187 		val1 = val | AC97_MUTE_MASK_STEREO;
1188 		snd_ac97_write(ac97, reg, val1);
1189 		if (val1 == snd_ac97_read(ac97, reg))
1190 			mute_mask = AC97_MUTE_MASK_STEREO;
1191 	}
1192 	if (mute_mask == AC97_MUTE_MASK_STEREO) {
1193 		struct snd_kcontrol_new tmp = AC97_DOUBLE(name, reg, 15, 7, 1, 1);
1194 		if (check_amix)
1195 			tmp.private_value |= (1 << 30);
1196 		tmp.index = ac97->num;
1197 		kctl = snd_ctl_new1(&tmp, ac97);
1198 	} else {
1199 		struct snd_kcontrol_new tmp = AC97_SINGLE(name, reg, 15, 1, 1);
1200 		if (check_amix)
1201 			tmp.private_value |= (1 << 30);
1202 		tmp.index = ac97->num;
1203 		kctl = snd_ctl_new1(&tmp, ac97);
1204 	}
1205 	err = snd_ctl_add(card, kctl);
1206 	if (err < 0)
1207 		return err;
1208 	/* mute as default */
1209 	snd_ac97_write_cache(ac97, reg, val | mute_mask);
1210 	return 0;
1211 }
1212 
1213 /*
1214  * set dB information
1215  */
1216 static const DECLARE_TLV_DB_SCALE(db_scale_4bit, -4500, 300, 0);
1217 static const DECLARE_TLV_DB_SCALE(db_scale_5bit, -4650, 150, 0);
1218 static const DECLARE_TLV_DB_SCALE(db_scale_6bit, -9450, 150, 0);
1219 static const DECLARE_TLV_DB_SCALE(db_scale_5bit_12db_max, -3450, 150, 0);
1220 static const DECLARE_TLV_DB_SCALE(db_scale_rec_gain, 0, 150, 0);
1221 
1222 static const unsigned int *find_db_scale(unsigned int maxval)
1223 {
1224 	switch (maxval) {
1225 	case 0x0f: return db_scale_4bit;
1226 	case 0x1f: return db_scale_5bit;
1227 	case 0x3f: return db_scale_6bit;
1228 	}
1229 	return NULL;
1230 }
1231 
1232 static void set_tlv_db_scale(struct snd_kcontrol *kctl, const unsigned int *tlv)
1233 {
1234 	kctl->tlv.p = tlv;
1235 	if (tlv)
1236 		kctl->vd[0].access |= SNDRV_CTL_ELEM_ACCESS_TLV_READ;
1237 }
1238 
1239 /*
1240  * create a volume for normal stereo/mono controls
1241  */
1242 static int snd_ac97_cvol_new(struct snd_card *card, char *name, int reg, unsigned int lo_max,
1243 			     unsigned int hi_max, struct snd_ac97 *ac97)
1244 {
1245 	int err;
1246 	struct snd_kcontrol *kctl;
1247 
1248 	if (! snd_ac97_valid_reg(ac97, reg))
1249 		return 0;
1250 	if (hi_max) {
1251 		/* invert */
1252 		struct snd_kcontrol_new tmp = AC97_DOUBLE(name, reg, 8, 0, lo_max, 1);
1253 		tmp.index = ac97->num;
1254 		kctl = snd_ctl_new1(&tmp, ac97);
1255 	} else {
1256 		/* invert */
1257 		struct snd_kcontrol_new tmp = AC97_SINGLE(name, reg, 0, lo_max, 1);
1258 		tmp.index = ac97->num;
1259 		kctl = snd_ctl_new1(&tmp, ac97);
1260 	}
1261 	if (!kctl)
1262 		return -ENOMEM;
1263 	if (reg >= AC97_PHONE && reg <= AC97_PCM)
1264 		set_tlv_db_scale(kctl, db_scale_5bit_12db_max);
1265 	else
1266 		set_tlv_db_scale(kctl, find_db_scale(lo_max));
1267 	err = snd_ctl_add(card, kctl);
1268 	if (err < 0)
1269 		return err;
1270 	snd_ac97_write_cache(
1271 		ac97, reg,
1272 		(snd_ac97_read(ac97, reg) & AC97_MUTE_MASK_STEREO)
1273 		| lo_max | (hi_max << 8)
1274 	);
1275 	return 0;
1276 }
1277 
1278 /*
1279  * create a mute-switch and a volume for normal stereo/mono controls
1280  */
1281 static int snd_ac97_cmix_new_stereo(struct snd_card *card, const char *pfx,
1282 				    int reg, int check_stereo, int check_amix,
1283 				    struct snd_ac97 *ac97)
1284 {
1285 	int err;
1286 	char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
1287 	unsigned char lo_max, hi_max;
1288 
1289 	if (! snd_ac97_valid_reg(ac97, reg))
1290 		return 0;
1291 
1292 	if (snd_ac97_try_bit(ac97, reg, 15)) {
1293 		sprintf(name, "%s Switch", pfx);
1294 		if ((err = snd_ac97_cmute_new_stereo(card, name, reg,
1295 						     check_stereo, check_amix,
1296 						     ac97)) < 0)
1297 			return err;
1298 	}
1299 	check_volume_resolution(ac97, reg, &lo_max, &hi_max);
1300 	if (lo_max) {
1301 		sprintf(name, "%s Volume", pfx);
1302 		if ((err = snd_ac97_cvol_new(card, name, reg, lo_max, hi_max, ac97)) < 0)
1303 			return err;
1304 	}
1305 	return 0;
1306 }
1307 
1308 #define snd_ac97_cmix_new(card, pfx, reg, acheck, ac97) \
1309 	snd_ac97_cmix_new_stereo(card, pfx, reg, 0, acheck, ac97)
1310 #define snd_ac97_cmute_new(card, name, reg, acheck, ac97) \
1311 	snd_ac97_cmute_new_stereo(card, name, reg, 0, acheck, ac97)
1312 
1313 static unsigned int snd_ac97_determine_spdif_rates(struct snd_ac97 *ac97);
1314 
1315 static int snd_ac97_mixer_build(struct snd_ac97 * ac97)
1316 {
1317 	struct snd_card *card = ac97->bus->card;
1318 	struct snd_kcontrol *kctl;
1319 	int err;
1320 	unsigned int idx;
1321 	unsigned char max;
1322 
1323 	/* build master controls */
1324 	/* AD claims to remove this control from AD1887, although spec v2.2 does not allow this */
1325 	if (snd_ac97_try_volume_mix(ac97, AC97_MASTER)) {
1326 		if (ac97->flags & AC97_HAS_NO_MASTER_VOL)
1327 			err = snd_ac97_cmute_new(card, "Master Playback Switch",
1328 						 AC97_MASTER, 0, ac97);
1329 		else
1330 			err = snd_ac97_cmix_new(card, "Master Playback",
1331 						AC97_MASTER, 0, ac97);
1332 		if (err < 0)
1333 			return err;
1334 	}
1335 
1336 	ac97->regs[AC97_CENTER_LFE_MASTER] = AC97_MUTE_MASK_STEREO;
1337 
1338 	/* build center controls */
1339 	if ((snd_ac97_try_volume_mix(ac97, AC97_CENTER_LFE_MASTER))
1340 		&& !(ac97->flags & AC97_AD_MULTI)) {
1341 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_center[0], ac97))) < 0)
1342 			return err;
1343 		if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_center[1], ac97))) < 0)
1344 			return err;
1345 		snd_ac97_change_volume_params2(ac97, AC97_CENTER_LFE_MASTER, 0, &max);
1346 		kctl->private_value &= ~(0xff << 16);
1347 		kctl->private_value |= (int)max << 16;
1348 		set_tlv_db_scale(kctl, find_db_scale(max));
1349 		snd_ac97_write_cache(ac97, AC97_CENTER_LFE_MASTER, ac97->regs[AC97_CENTER_LFE_MASTER] | max);
1350 	}
1351 
1352 	/* build LFE controls */
1353 	if ((snd_ac97_try_volume_mix(ac97, AC97_CENTER_LFE_MASTER+1))
1354 		&& !(ac97->flags & AC97_AD_MULTI)) {
1355 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_lfe[0], ac97))) < 0)
1356 			return err;
1357 		if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_lfe[1], ac97))) < 0)
1358 			return err;
1359 		snd_ac97_change_volume_params2(ac97, AC97_CENTER_LFE_MASTER, 8, &max);
1360 		kctl->private_value &= ~(0xff << 16);
1361 		kctl->private_value |= (int)max << 16;
1362 		set_tlv_db_scale(kctl, find_db_scale(max));
1363 		snd_ac97_write_cache(ac97, AC97_CENTER_LFE_MASTER, ac97->regs[AC97_CENTER_LFE_MASTER] | max << 8);
1364 	}
1365 
1366 	/* build surround controls */
1367 	if ((snd_ac97_try_volume_mix(ac97, AC97_SURROUND_MASTER))
1368 		&& !(ac97->flags & AC97_AD_MULTI)) {
1369 		/* Surround Master (0x38) is with stereo mutes */
1370 		if ((err = snd_ac97_cmix_new_stereo(card, "Surround Playback",
1371 						    AC97_SURROUND_MASTER, 1, 0,
1372 						    ac97)) < 0)
1373 			return err;
1374 	}
1375 
1376 	/* build headphone controls */
1377 	if (snd_ac97_try_volume_mix(ac97, AC97_HEADPHONE)) {
1378 		if ((err = snd_ac97_cmix_new(card, "Headphone Playback",
1379 					     AC97_HEADPHONE, 0, ac97)) < 0)
1380 			return err;
1381 	}
1382 
1383 	/* build master mono controls */
1384 	if (snd_ac97_try_volume_mix(ac97, AC97_MASTER_MONO)) {
1385 		if ((err = snd_ac97_cmix_new(card, "Master Mono Playback",
1386 					     AC97_MASTER_MONO, 0, ac97)) < 0)
1387 			return err;
1388 	}
1389 
1390 	/* build master tone controls */
1391 	if (!(ac97->flags & AC97_HAS_NO_TONE)) {
1392 		if (snd_ac97_try_volume_mix(ac97, AC97_MASTER_TONE)) {
1393 			for (idx = 0; idx < 2; idx++) {
1394 				if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_tone[idx], ac97))) < 0)
1395 					return err;
1396 				if (ac97->id == AC97_ID_YMF743 ||
1397 				    ac97->id == AC97_ID_YMF753) {
1398 					kctl->private_value &= ~(0xff << 16);
1399 					kctl->private_value |= 7 << 16;
1400 				}
1401 			}
1402 			snd_ac97_write_cache(ac97, AC97_MASTER_TONE, 0x0f0f);
1403 		}
1404 	}
1405 
1406 	/* build Beep controls */
1407 	if (!(ac97->flags & AC97_HAS_NO_PC_BEEP) &&
1408 		((ac97->flags & AC97_HAS_PC_BEEP) ||
1409 	    snd_ac97_try_volume_mix(ac97, AC97_PC_BEEP))) {
1410 		for (idx = 0; idx < 2; idx++)
1411 			if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_pc_beep[idx], ac97))) < 0)
1412 				return err;
1413 		set_tlv_db_scale(kctl, db_scale_4bit);
1414 		snd_ac97_write_cache(
1415 			ac97,
1416 			AC97_PC_BEEP,
1417 			(snd_ac97_read(ac97, AC97_PC_BEEP)
1418 				| AC97_MUTE_MASK_MONO | 0x001e)
1419 		);
1420 	}
1421 
1422 	/* build Phone controls */
1423 	if (!(ac97->flags & AC97_HAS_NO_PHONE)) {
1424 		if (snd_ac97_try_volume_mix(ac97, AC97_PHONE)) {
1425 			if ((err = snd_ac97_cmix_new(card, "Phone Playback",
1426 						     AC97_PHONE, 1, ac97)) < 0)
1427 				return err;
1428 		}
1429 	}
1430 
1431 	/* build MIC controls */
1432 	if (!(ac97->flags & AC97_HAS_NO_MIC)) {
1433 		if (snd_ac97_try_volume_mix(ac97, AC97_MIC)) {
1434 			if ((err = snd_ac97_cmix_new(card, "Mic Playback",
1435 						     AC97_MIC, 1, ac97)) < 0)
1436 				return err;
1437 			if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_mic_boost, ac97))) < 0)
1438 				return err;
1439 		}
1440 	}
1441 
1442 	/* build Line controls */
1443 	if (snd_ac97_try_volume_mix(ac97, AC97_LINE)) {
1444 		if ((err = snd_ac97_cmix_new(card, "Line Playback",
1445 					     AC97_LINE, 1, ac97)) < 0)
1446 			return err;
1447 	}
1448 
1449 	/* build CD controls */
1450 	if (!(ac97->flags & AC97_HAS_NO_CD)) {
1451 		if (snd_ac97_try_volume_mix(ac97, AC97_CD)) {
1452 			if ((err = snd_ac97_cmix_new(card, "CD Playback",
1453 						     AC97_CD, 1, ac97)) < 0)
1454 				return err;
1455 		}
1456 	}
1457 
1458 	/* build Video controls */
1459 	if (!(ac97->flags & AC97_HAS_NO_VIDEO)) {
1460 		if (snd_ac97_try_volume_mix(ac97, AC97_VIDEO)) {
1461 			if ((err = snd_ac97_cmix_new(card, "Video Playback",
1462 						     AC97_VIDEO, 1, ac97)) < 0)
1463 				return err;
1464 		}
1465 	}
1466 
1467 	/* build Aux controls */
1468 	if (!(ac97->flags & AC97_HAS_NO_AUX)) {
1469 		if (snd_ac97_try_volume_mix(ac97, AC97_AUX)) {
1470 			if ((err = snd_ac97_cmix_new(card, "Aux Playback",
1471 						     AC97_AUX, 1, ac97)) < 0)
1472 				return err;
1473 		}
1474 	}
1475 
1476 	/* build PCM controls */
1477 	if (ac97->flags & AC97_AD_MULTI) {
1478 		unsigned short init_val;
1479 		if (ac97->flags & AC97_STEREO_MUTES)
1480 			init_val = 0x9f9f;
1481 		else
1482 			init_val = 0x9f1f;
1483 		for (idx = 0; idx < 2; idx++)
1484 			if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_ad18xx_pcm[idx], ac97))) < 0)
1485 				return err;
1486 		set_tlv_db_scale(kctl, db_scale_5bit);
1487 		ac97->spec.ad18xx.pcmreg[0] = init_val;
1488 		if (ac97->scaps & AC97_SCAP_SURROUND_DAC) {
1489 			for (idx = 0; idx < 2; idx++)
1490 				if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_ad18xx_surround[idx], ac97))) < 0)
1491 					return err;
1492 			set_tlv_db_scale(kctl, db_scale_5bit);
1493 			ac97->spec.ad18xx.pcmreg[1] = init_val;
1494 		}
1495 		if (ac97->scaps & AC97_SCAP_CENTER_LFE_DAC) {
1496 			for (idx = 0; idx < 2; idx++)
1497 				if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_ad18xx_center[idx], ac97))) < 0)
1498 					return err;
1499 			set_tlv_db_scale(kctl, db_scale_5bit);
1500 			for (idx = 0; idx < 2; idx++)
1501 				if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_ad18xx_lfe[idx], ac97))) < 0)
1502 					return err;
1503 			set_tlv_db_scale(kctl, db_scale_5bit);
1504 			ac97->spec.ad18xx.pcmreg[2] = init_val;
1505 		}
1506 		snd_ac97_write_cache(ac97, AC97_PCM, init_val);
1507 	} else {
1508 		if (!(ac97->flags & AC97_HAS_NO_STD_PCM)) {
1509 			if (ac97->flags & AC97_HAS_NO_PCM_VOL)
1510 				err = snd_ac97_cmute_new(card,
1511 							 "PCM Playback Switch",
1512 							 AC97_PCM, 0, ac97);
1513 			else
1514 				err = snd_ac97_cmix_new(card, "PCM Playback",
1515 							AC97_PCM, 0, ac97);
1516 			if (err < 0)
1517 				return err;
1518 		}
1519 	}
1520 
1521 	/* build Capture controls */
1522 	if (!(ac97->flags & AC97_HAS_NO_REC_GAIN)) {
1523 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_control_capture_src, ac97))) < 0)
1524 			return err;
1525 		if (snd_ac97_try_bit(ac97, AC97_REC_GAIN, 15)) {
1526 			err = snd_ac97_cmute_new(card, "Capture Switch",
1527 						 AC97_REC_GAIN, 0, ac97);
1528 			if (err < 0)
1529 				return err;
1530 		}
1531 		if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_control_capture_vol, ac97))) < 0)
1532 			return err;
1533 		set_tlv_db_scale(kctl, db_scale_rec_gain);
1534 		snd_ac97_write_cache(ac97, AC97_REC_SEL, 0x0000);
1535 		snd_ac97_write_cache(ac97, AC97_REC_GAIN, 0x0000);
1536 	}
1537 	/* build MIC Capture controls */
1538 	if (snd_ac97_try_volume_mix(ac97, AC97_REC_GAIN_MIC)) {
1539 		for (idx = 0; idx < 2; idx++)
1540 			if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_mic_capture[idx], ac97))) < 0)
1541 				return err;
1542 		set_tlv_db_scale(kctl, db_scale_rec_gain);
1543 		snd_ac97_write_cache(ac97, AC97_REC_GAIN_MIC, 0x0000);
1544 	}
1545 
1546 	/* build PCM out path & mute control */
1547 	if (snd_ac97_try_bit(ac97, AC97_GENERAL_PURPOSE, 15)) {
1548 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_general[AC97_GENERAL_PCM_OUT], ac97))) < 0)
1549 			return err;
1550 	}
1551 
1552 	/* build Simulated Stereo Enhancement control */
1553 	if (ac97->caps & AC97_BC_SIM_STEREO) {
1554 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_general[AC97_GENERAL_STEREO_ENHANCEMENT], ac97))) < 0)
1555 			return err;
1556 	}
1557 
1558 	/* build 3D Stereo Enhancement control */
1559 	if (snd_ac97_try_bit(ac97, AC97_GENERAL_PURPOSE, 13)) {
1560 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_general[AC97_GENERAL_3D], ac97))) < 0)
1561 			return err;
1562 	}
1563 
1564 	/* build Loudness control */
1565 	if (ac97->caps & AC97_BC_LOUDNESS) {
1566 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_general[AC97_GENERAL_LOUDNESS], ac97))) < 0)
1567 			return err;
1568 	}
1569 
1570 	/* build Mono output select control */
1571 	if (snd_ac97_try_bit(ac97, AC97_GENERAL_PURPOSE, 9)) {
1572 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_general[AC97_GENERAL_MONO], ac97))) < 0)
1573 			return err;
1574 	}
1575 
1576 	/* build Mic select control */
1577 	if (snd_ac97_try_bit(ac97, AC97_GENERAL_PURPOSE, 8)) {
1578 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_general[AC97_GENERAL_MIC], ac97))) < 0)
1579 			return err;
1580 	}
1581 
1582 	/* build ADC/DAC loopback control */
1583 	if (enable_loopback && snd_ac97_try_bit(ac97, AC97_GENERAL_PURPOSE, 7)) {
1584 		if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_general[AC97_GENERAL_LOOPBACK], ac97))) < 0)
1585 			return err;
1586 	}
1587 
1588 	snd_ac97_update_bits(ac97, AC97_GENERAL_PURPOSE, ~AC97_GP_DRSS_MASK, 0x0000);
1589 
1590 	/* build 3D controls */
1591 	if (ac97->build_ops->build_3d) {
1592 		ac97->build_ops->build_3d(ac97);
1593 	} else {
1594 		if (snd_ac97_try_volume_mix(ac97, AC97_3D_CONTROL)) {
1595 			unsigned short val;
1596 			val = 0x0707;
1597 			snd_ac97_write(ac97, AC97_3D_CONTROL, val);
1598 			val = snd_ac97_read(ac97, AC97_3D_CONTROL);
1599 			val = val == 0x0606;
1600 			if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_3d[0], ac97))) < 0)
1601 				return err;
1602 			if (val)
1603 				kctl->private_value = AC97_3D_CONTROL | (9 << 8) | (7 << 16);
1604 			if ((err = snd_ctl_add(card, kctl = snd_ac97_cnew(&snd_ac97_controls_3d[1], ac97))) < 0)
1605 				return err;
1606 			if (val)
1607 				kctl->private_value = AC97_3D_CONTROL | (1 << 8) | (7 << 16);
1608 			snd_ac97_write_cache(ac97, AC97_3D_CONTROL, 0x0000);
1609 		}
1610 	}
1611 
1612 	/* build S/PDIF controls */
1613 
1614 	/* Hack for ASUS P5P800-VM, which does not indicate S/PDIF capability */
1615 	if (ac97->subsystem_vendor == 0x1043 &&
1616 	    ac97->subsystem_device == 0x810f)
1617 		ac97->ext_id |= AC97_EI_SPDIF;
1618 
1619 	if ((ac97->ext_id & AC97_EI_SPDIF) && !(ac97->scaps & AC97_SCAP_NO_SPDIF)) {
1620 		if (ac97->build_ops->build_spdif) {
1621 			if ((err = ac97->build_ops->build_spdif(ac97)) < 0)
1622 				return err;
1623 		} else {
1624 			for (idx = 0; idx < 5; idx++)
1625 				if ((err = snd_ctl_add(card, snd_ac97_cnew(&snd_ac97_controls_spdif[idx], ac97))) < 0)
1626 					return err;
1627 			if (ac97->build_ops->build_post_spdif) {
1628 				if ((err = ac97->build_ops->build_post_spdif(ac97)) < 0)
1629 					return err;
1630 			}
1631 			/* set default PCM S/PDIF params */
1632 			/* consumer,PCM audio,no copyright,no preemphasis,PCM coder,original,48000Hz */
1633 			snd_ac97_write_cache(ac97, AC97_SPDIF, 0x2a20);
1634 			ac97->rates[AC97_RATES_SPDIF] = snd_ac97_determine_spdif_rates(ac97);
1635 		}
1636 		ac97->spdif_status = SNDRV_PCM_DEFAULT_CON_SPDIF;
1637 	}
1638 
1639 	/* build chip specific controls */
1640 	if (ac97->build_ops->build_specific)
1641 		if ((err = ac97->build_ops->build_specific(ac97)) < 0)
1642 			return err;
1643 
1644 	if (snd_ac97_try_bit(ac97, AC97_POWERDOWN, 15)) {
1645 		kctl = snd_ac97_cnew(&snd_ac97_control_eapd, ac97);
1646 		if (! kctl)
1647 			return -ENOMEM;
1648 		if (ac97->scaps & AC97_SCAP_INV_EAPD)
1649 			set_inv_eapd(ac97, kctl);
1650 		if ((err = snd_ctl_add(card, kctl)) < 0)
1651 			return err;
1652 	}
1653 
1654 	return 0;
1655 }
1656 
1657 static int snd_ac97_modem_build(struct snd_card *card, struct snd_ac97 * ac97)
1658 {
1659 	int err, idx;
1660 
1661 	/*
1662 	ac97_dbg(ac97, "AC97_GPIO_CFG = %x\n",
1663 	       snd_ac97_read(ac97,AC97_GPIO_CFG));
1664 	*/
1665 	snd_ac97_write(ac97, AC97_GPIO_CFG, 0xffff & ~(AC97_GPIO_LINE1_OH));
1666 	snd_ac97_write(ac97, AC97_GPIO_POLARITY, 0xffff & ~(AC97_GPIO_LINE1_OH));
1667 	snd_ac97_write(ac97, AC97_GPIO_STICKY, 0xffff);
1668 	snd_ac97_write(ac97, AC97_GPIO_WAKEUP, 0x0);
1669 	snd_ac97_write(ac97, AC97_MISC_AFE, 0x0);
1670 
1671 	/* build modem switches */
1672 	for (idx = 0; idx < ARRAY_SIZE(snd_ac97_controls_modem_switches); idx++)
1673 		if ((err = snd_ctl_add(card, snd_ctl_new1(&snd_ac97_controls_modem_switches[idx], ac97))) < 0)
1674 			return err;
1675 
1676 	/* build chip specific controls */
1677 	if (ac97->build_ops->build_specific)
1678 		if ((err = ac97->build_ops->build_specific(ac97)) < 0)
1679 			return err;
1680 
1681 	return 0;
1682 }
1683 
1684 static int snd_ac97_test_rate(struct snd_ac97 *ac97, int reg, int shadow_reg, int rate)
1685 {
1686 	unsigned short val;
1687 	unsigned int tmp;
1688 
1689 	tmp = ((unsigned int)rate * ac97->bus->clock) / 48000;
1690 	snd_ac97_write_cache(ac97, reg, tmp & 0xffff);
1691 	if (shadow_reg)
1692 		snd_ac97_write_cache(ac97, shadow_reg, tmp & 0xffff);
1693 	val = snd_ac97_read(ac97, reg);
1694 	return val == (tmp & 0xffff);
1695 }
1696 
1697 static void snd_ac97_determine_rates(struct snd_ac97 *ac97, int reg, int shadow_reg, unsigned int *r_result)
1698 {
1699 	unsigned int result = 0;
1700 	unsigned short saved;
1701 
1702 	if (ac97->bus->no_vra) {
1703 		*r_result = SNDRV_PCM_RATE_48000;
1704 		if ((ac97->flags & AC97_DOUBLE_RATE) &&
1705 		    reg == AC97_PCM_FRONT_DAC_RATE)
1706 			*r_result |= SNDRV_PCM_RATE_96000;
1707 		return;
1708 	}
1709 
1710 	saved = snd_ac97_read(ac97, reg);
1711 	if ((ac97->ext_id & AC97_EI_DRA) && reg == AC97_PCM_FRONT_DAC_RATE)
1712 		snd_ac97_update_bits(ac97, AC97_EXTENDED_STATUS,
1713 				     AC97_EA_DRA, 0);
1714 	/* test a non-standard rate */
1715 	if (snd_ac97_test_rate(ac97, reg, shadow_reg, 11000))
1716 		result |= SNDRV_PCM_RATE_CONTINUOUS;
1717 	/* let's try to obtain standard rates */
1718 	if (snd_ac97_test_rate(ac97, reg, shadow_reg, 8000))
1719 		result |= SNDRV_PCM_RATE_8000;
1720 	if (snd_ac97_test_rate(ac97, reg, shadow_reg, 11025))
1721 		result |= SNDRV_PCM_RATE_11025;
1722 	if (snd_ac97_test_rate(ac97, reg, shadow_reg, 16000))
1723 		result |= SNDRV_PCM_RATE_16000;
1724 	if (snd_ac97_test_rate(ac97, reg, shadow_reg, 22050))
1725 		result |= SNDRV_PCM_RATE_22050;
1726 	if (snd_ac97_test_rate(ac97, reg, shadow_reg, 32000))
1727 		result |= SNDRV_PCM_RATE_32000;
1728 	if (snd_ac97_test_rate(ac97, reg, shadow_reg, 44100))
1729 		result |= SNDRV_PCM_RATE_44100;
1730 	if (snd_ac97_test_rate(ac97, reg, shadow_reg, 48000))
1731 		result |= SNDRV_PCM_RATE_48000;
1732 	if ((ac97->flags & AC97_DOUBLE_RATE) &&
1733 	    reg == AC97_PCM_FRONT_DAC_RATE) {
1734 		/* test standard double rates */
1735 		snd_ac97_update_bits(ac97, AC97_EXTENDED_STATUS,
1736 				     AC97_EA_DRA, AC97_EA_DRA);
1737 		if (snd_ac97_test_rate(ac97, reg, shadow_reg, 64000 / 2))
1738 			result |= SNDRV_PCM_RATE_64000;
1739 		if (snd_ac97_test_rate(ac97, reg, shadow_reg, 88200 / 2))
1740 			result |= SNDRV_PCM_RATE_88200;
1741 		if (snd_ac97_test_rate(ac97, reg, shadow_reg, 96000 / 2))
1742 			result |= SNDRV_PCM_RATE_96000;
1743 		/* some codecs don't support variable double rates */
1744 		if (!snd_ac97_test_rate(ac97, reg, shadow_reg, 76100 / 2))
1745 			result &= ~SNDRV_PCM_RATE_CONTINUOUS;
1746 		snd_ac97_update_bits(ac97, AC97_EXTENDED_STATUS,
1747 				     AC97_EA_DRA, 0);
1748 	}
1749 	/* restore the default value */
1750 	snd_ac97_write_cache(ac97, reg, saved);
1751 	if (shadow_reg)
1752 		snd_ac97_write_cache(ac97, shadow_reg, saved);
1753 	*r_result = result;
1754 }
1755 
1756 /* check AC97_SPDIF register to accept which sample rates */
1757 static unsigned int snd_ac97_determine_spdif_rates(struct snd_ac97 *ac97)
1758 {
1759 	unsigned int result = 0;
1760 	int i;
1761 	static unsigned short ctl_bits[] = {
1762 		AC97_SC_SPSR_44K, AC97_SC_SPSR_32K, AC97_SC_SPSR_48K
1763 	};
1764 	static unsigned int rate_bits[] = {
1765 		SNDRV_PCM_RATE_44100, SNDRV_PCM_RATE_32000, SNDRV_PCM_RATE_48000
1766 	};
1767 
1768 	for (i = 0; i < (int)ARRAY_SIZE(ctl_bits); i++) {
1769 		snd_ac97_update_bits(ac97, AC97_SPDIF, AC97_SC_SPSR_MASK, ctl_bits[i]);
1770 		if ((snd_ac97_read(ac97, AC97_SPDIF) & AC97_SC_SPSR_MASK) == ctl_bits[i])
1771 			result |= rate_bits[i];
1772 	}
1773 	return result;
1774 }
1775 
1776 /* look for the codec id table matching with the given id */
1777 static const struct ac97_codec_id *look_for_codec_id(const struct ac97_codec_id *table,
1778 						     unsigned int id)
1779 {
1780 	const struct ac97_codec_id *pid;
1781 
1782 	for (pid = table; pid->id; pid++)
1783 		if (pid->id == (id & pid->mask))
1784 			return pid;
1785 	return NULL;
1786 }
1787 
1788 void snd_ac97_get_name(struct snd_ac97 *ac97, unsigned int id, char *name, int modem)
1789 {
1790 	const struct ac97_codec_id *pid;
1791 
1792 	sprintf(name, "0x%x %c%c%c", id,
1793 		printable(id >> 24),
1794 		printable(id >> 16),
1795 		printable(id >> 8));
1796 	pid = look_for_codec_id(snd_ac97_codec_id_vendors, id);
1797 	if (! pid)
1798 		return;
1799 
1800 	strcpy(name, pid->name);
1801 	if (ac97 && pid->patch) {
1802 		if ((modem && (pid->flags & AC97_MODEM_PATCH)) ||
1803 		    (! modem && ! (pid->flags & AC97_MODEM_PATCH)))
1804 			pid->patch(ac97);
1805 	}
1806 
1807 	pid = look_for_codec_id(snd_ac97_codec_ids, id);
1808 	if (pid) {
1809 		strcat(name, " ");
1810 		strcat(name, pid->name);
1811 		if (pid->mask != 0xffffffff)
1812 			sprintf(name + strlen(name), " rev %d", id & ~pid->mask);
1813 		if (ac97 && pid->patch) {
1814 			if ((modem && (pid->flags & AC97_MODEM_PATCH)) ||
1815 			    (! modem && ! (pid->flags & AC97_MODEM_PATCH)))
1816 				pid->patch(ac97);
1817 		}
1818 	} else
1819 		sprintf(name + strlen(name), " id %x", id & 0xff);
1820 }
1821 
1822 /**
1823  * snd_ac97_get_short_name - retrieve codec name
1824  * @ac97: the codec instance
1825  *
1826  * Return: The short identifying name of the codec.
1827  */
1828 const char *snd_ac97_get_short_name(struct snd_ac97 *ac97)
1829 {
1830 	const struct ac97_codec_id *pid;
1831 
1832 	for (pid = snd_ac97_codec_ids; pid->id; pid++)
1833 		if (pid->id == (ac97->id & pid->mask))
1834 			return pid->name;
1835 	return "unknown codec";
1836 }
1837 
1838 EXPORT_SYMBOL(snd_ac97_get_short_name);
1839 
1840 /* wait for a while until registers are accessible after RESET
1841  * return 0 if ok, negative not ready
1842  */
1843 static int ac97_reset_wait(struct snd_ac97 *ac97, int timeout, int with_modem)
1844 {
1845 	unsigned long end_time;
1846 	unsigned short val;
1847 
1848 	end_time = jiffies + timeout;
1849 	do {
1850 
1851 		/* use preliminary reads to settle the communication */
1852 		snd_ac97_read(ac97, AC97_RESET);
1853 		snd_ac97_read(ac97, AC97_VENDOR_ID1);
1854 		snd_ac97_read(ac97, AC97_VENDOR_ID2);
1855 		/* modem? */
1856 		if (with_modem) {
1857 			val = snd_ac97_read(ac97, AC97_EXTENDED_MID);
1858 			if (val != 0xffff && (val & 1) != 0)
1859 				return 0;
1860 		}
1861 		if (ac97->scaps & AC97_SCAP_DETECT_BY_VENDOR) {
1862 			/* probably only Xbox issue - all registers are read as zero */
1863 			val = snd_ac97_read(ac97, AC97_VENDOR_ID1);
1864 			if (val != 0 && val != 0xffff)
1865 				return 0;
1866 		} else {
1867 			/* because the PCM or MASTER volume registers can be modified,
1868 			 * the REC_GAIN register is used for tests
1869 			 */
1870 			/* test if we can write to the record gain volume register */
1871 			snd_ac97_write_cache(ac97, AC97_REC_GAIN, 0x8a05);
1872 			if ((snd_ac97_read(ac97, AC97_REC_GAIN) & 0x7fff) == 0x0a05)
1873 				return 0;
1874 		}
1875 		schedule_timeout_uninterruptible(1);
1876 	} while (time_after_eq(end_time, jiffies));
1877 	return -ENODEV;
1878 }
1879 
1880 /**
1881  * snd_ac97_bus - create an AC97 bus component
1882  * @card: the card instance
1883  * @num: the bus number
1884  * @ops: the bus callbacks table
1885  * @private_data: private data pointer for the new instance
1886  * @rbus: the pointer to store the new AC97 bus instance.
1887  *
1888  * Creates an AC97 bus component.  An struct snd_ac97_bus instance is newly
1889  * allocated and initialized.
1890  *
1891  * The ops table must include valid callbacks (at least read and
1892  * write).  The other callbacks, wait and reset, are not mandatory.
1893  *
1894  * The clock is set to 48000.  If another clock is needed, set
1895  * ``(*rbus)->clock`` manually.
1896  *
1897  * The AC97 bus instance is registered as a low-level device, so you don't
1898  * have to release it manually.
1899  *
1900  * Return: Zero if successful, or a negative error code on failure.
1901  */
1902 int snd_ac97_bus(struct snd_card *card, int num, struct snd_ac97_bus_ops *ops,
1903 		 void *private_data, struct snd_ac97_bus **rbus)
1904 {
1905 	int err;
1906 	struct snd_ac97_bus *bus;
1907 	static struct snd_device_ops dev_ops = {
1908 		.dev_free =	snd_ac97_bus_dev_free,
1909 	};
1910 
1911 	if (snd_BUG_ON(!card))
1912 		return -EINVAL;
1913 	bus = kzalloc(sizeof(*bus), GFP_KERNEL);
1914 	if (bus == NULL)
1915 		return -ENOMEM;
1916 	bus->card = card;
1917 	bus->num = num;
1918 	bus->ops = ops;
1919 	bus->private_data = private_data;
1920 	bus->clock = 48000;
1921 	spin_lock_init(&bus->bus_lock);
1922 	snd_ac97_bus_proc_init(bus);
1923 	if ((err = snd_device_new(card, SNDRV_DEV_BUS, bus, &dev_ops)) < 0) {
1924 		snd_ac97_bus_free(bus);
1925 		return err;
1926 	}
1927 	if (rbus)
1928 		*rbus = bus;
1929 	return 0;
1930 }
1931 
1932 EXPORT_SYMBOL(snd_ac97_bus);
1933 
1934 /* stop no dev release warning */
1935 static void ac97_device_release(struct device * dev)
1936 {
1937 }
1938 
1939 /* register ac97 codec to bus */
1940 static int snd_ac97_dev_register(struct snd_device *device)
1941 {
1942 	struct snd_ac97 *ac97 = device->device_data;
1943 	int err;
1944 
1945 	ac97->dev.bus = &ac97_bus_type;
1946 	ac97->dev.parent = ac97->bus->card->dev;
1947 	ac97->dev.release = ac97_device_release;
1948 	dev_set_name(&ac97->dev, "%d-%d:%s",
1949 		     ac97->bus->card->number, ac97->num,
1950 		     snd_ac97_get_short_name(ac97));
1951 	if ((err = device_register(&ac97->dev)) < 0) {
1952 		ac97_err(ac97, "Can't register ac97 bus\n");
1953 		ac97->dev.bus = NULL;
1954 		return err;
1955 	}
1956 	return 0;
1957 }
1958 
1959 /* disconnect ac97 codec */
1960 static int snd_ac97_dev_disconnect(struct snd_device *device)
1961 {
1962 	struct snd_ac97 *ac97 = device->device_data;
1963 	if (ac97->dev.bus)
1964 		device_unregister(&ac97->dev);
1965 	return 0;
1966 }
1967 
1968 /* build_ops to do nothing */
1969 static const struct snd_ac97_build_ops null_build_ops;
1970 
1971 #ifdef CONFIG_SND_AC97_POWER_SAVE
1972 static void do_update_power(struct work_struct *work)
1973 {
1974 	update_power_regs(
1975 		container_of(work, struct snd_ac97, power_work.work));
1976 }
1977 #endif
1978 
1979 /**
1980  * snd_ac97_mixer - create an Codec97 component
1981  * @bus: the AC97 bus which codec is attached to
1982  * @template: the template of ac97, including index, callbacks and
1983  *         the private data.
1984  * @rac97: the pointer to store the new ac97 instance.
1985  *
1986  * Creates an Codec97 component.  An struct snd_ac97 instance is newly
1987  * allocated and initialized from the template.  The codec
1988  * is then initialized by the standard procedure.
1989  *
1990  * The template must include the codec number (num) and address (addr),
1991  * and the private data (private_data).
1992  *
1993  * The ac97 instance is registered as a low-level device, so you don't
1994  * have to release it manually.
1995  *
1996  * Return: Zero if successful, or a negative error code on failure.
1997  */
1998 int snd_ac97_mixer(struct snd_ac97_bus *bus, struct snd_ac97_template *template, struct snd_ac97 **rac97)
1999 {
2000 	int err;
2001 	struct snd_ac97 *ac97;
2002 	struct snd_card *card;
2003 	char name[64];
2004 	unsigned long end_time;
2005 	unsigned int reg;
2006 	const struct ac97_codec_id *pid;
2007 	static struct snd_device_ops ops = {
2008 		.dev_free =	snd_ac97_dev_free,
2009 		.dev_register =	snd_ac97_dev_register,
2010 		.dev_disconnect =	snd_ac97_dev_disconnect,
2011 	};
2012 
2013 	if (rac97)
2014 		*rac97 = NULL;
2015 	if (snd_BUG_ON(!bus || !template))
2016 		return -EINVAL;
2017 	if (snd_BUG_ON(template->num >= 4))
2018 		return -EINVAL;
2019 	if (bus->codec[template->num])
2020 		return -EBUSY;
2021 
2022 	card = bus->card;
2023 	ac97 = kzalloc(sizeof(*ac97), GFP_KERNEL);
2024 	if (ac97 == NULL)
2025 		return -ENOMEM;
2026 	ac97->private_data = template->private_data;
2027 	ac97->private_free = template->private_free;
2028 	ac97->bus = bus;
2029 	ac97->pci = template->pci;
2030 	ac97->num = template->num;
2031 	ac97->addr = template->addr;
2032 	ac97->scaps = template->scaps;
2033 	ac97->res_table = template->res_table;
2034 	bus->codec[ac97->num] = ac97;
2035 	mutex_init(&ac97->reg_mutex);
2036 	mutex_init(&ac97->page_mutex);
2037 #ifdef CONFIG_SND_AC97_POWER_SAVE
2038 	INIT_DELAYED_WORK(&ac97->power_work, do_update_power);
2039 #endif
2040 
2041 #ifdef CONFIG_PCI
2042 	if (ac97->pci) {
2043 		pci_read_config_word(ac97->pci, PCI_SUBSYSTEM_VENDOR_ID, &ac97->subsystem_vendor);
2044 		pci_read_config_word(ac97->pci, PCI_SUBSYSTEM_ID, &ac97->subsystem_device);
2045 	}
2046 #endif
2047 	if (bus->ops->reset) {
2048 		bus->ops->reset(ac97);
2049 		goto __access_ok;
2050 	}
2051 
2052 	ac97->id = snd_ac97_read(ac97, AC97_VENDOR_ID1) << 16;
2053 	ac97->id |= snd_ac97_read(ac97, AC97_VENDOR_ID2);
2054 	if (ac97->id && ac97->id != (unsigned int)-1) {
2055 		pid = look_for_codec_id(snd_ac97_codec_ids, ac97->id);
2056 		if (pid && (pid->flags & AC97_DEFAULT_POWER_OFF))
2057 			goto __access_ok;
2058 	}
2059 
2060 	/* reset to defaults */
2061 	if (!(ac97->scaps & AC97_SCAP_SKIP_AUDIO))
2062 		snd_ac97_write(ac97, AC97_RESET, 0);
2063 	if (!(ac97->scaps & AC97_SCAP_SKIP_MODEM))
2064 		snd_ac97_write(ac97, AC97_EXTENDED_MID, 0);
2065 	if (bus->ops->wait)
2066 		bus->ops->wait(ac97);
2067 	else {
2068 		udelay(50);
2069 		if (ac97->scaps & AC97_SCAP_SKIP_AUDIO)
2070 			err = ac97_reset_wait(ac97, msecs_to_jiffies(500), 1);
2071 		else {
2072 			err = ac97_reset_wait(ac97, msecs_to_jiffies(500), 0);
2073 			if (err < 0)
2074 				err = ac97_reset_wait(ac97,
2075 						      msecs_to_jiffies(500), 1);
2076 		}
2077 		if (err < 0) {
2078 			ac97_warn(ac97, "AC'97 %d does not respond - RESET\n",
2079 				 ac97->num);
2080 			/* proceed anyway - it's often non-critical */
2081 		}
2082 	}
2083       __access_ok:
2084 	ac97->id = snd_ac97_read(ac97, AC97_VENDOR_ID1) << 16;
2085 	ac97->id |= snd_ac97_read(ac97, AC97_VENDOR_ID2);
2086 	if (! (ac97->scaps & AC97_SCAP_DETECT_BY_VENDOR) &&
2087 	    (ac97->id == 0x00000000 || ac97->id == 0xffffffff)) {
2088 		ac97_err(ac97,
2089 			 "AC'97 %d access is not valid [0x%x], removing mixer.\n",
2090 			 ac97->num, ac97->id);
2091 		snd_ac97_free(ac97);
2092 		return -EIO;
2093 	}
2094 	pid = look_for_codec_id(snd_ac97_codec_ids, ac97->id);
2095 	if (pid)
2096 		ac97->flags |= pid->flags;
2097 
2098 	/* test for AC'97 */
2099 	if (!(ac97->scaps & AC97_SCAP_SKIP_AUDIO) && !(ac97->scaps & AC97_SCAP_AUDIO)) {
2100 		/* test if we can write to the record gain volume register */
2101 		snd_ac97_write_cache(ac97, AC97_REC_GAIN, 0x8a06);
2102 		if (((err = snd_ac97_read(ac97, AC97_REC_GAIN)) & 0x7fff) == 0x0a06)
2103 			ac97->scaps |= AC97_SCAP_AUDIO;
2104 	}
2105 	if (ac97->scaps & AC97_SCAP_AUDIO) {
2106 		ac97->caps = snd_ac97_read(ac97, AC97_RESET);
2107 		ac97->ext_id = snd_ac97_read(ac97, AC97_EXTENDED_ID);
2108 		if (ac97->ext_id == 0xffff)	/* invalid combination */
2109 			ac97->ext_id = 0;
2110 	}
2111 
2112 	/* test for MC'97 */
2113 	if (!(ac97->scaps & AC97_SCAP_SKIP_MODEM) && !(ac97->scaps & AC97_SCAP_MODEM)) {
2114 		ac97->ext_mid = snd_ac97_read(ac97, AC97_EXTENDED_MID);
2115 		if (ac97->ext_mid == 0xffff)	/* invalid combination */
2116 			ac97->ext_mid = 0;
2117 		if (ac97->ext_mid & 1)
2118 			ac97->scaps |= AC97_SCAP_MODEM;
2119 	}
2120 
2121 	if (!ac97_is_audio(ac97) && !ac97_is_modem(ac97)) {
2122 		if (!(ac97->scaps & (AC97_SCAP_SKIP_AUDIO|AC97_SCAP_SKIP_MODEM)))
2123 			ac97_err(ac97,
2124 				 "AC'97 %d access error (not audio or modem codec)\n",
2125 				 ac97->num);
2126 		snd_ac97_free(ac97);
2127 		return -EACCES;
2128 	}
2129 
2130 	if (bus->ops->reset) // FIXME: always skipping?
2131 		goto __ready_ok;
2132 
2133 	/* FIXME: add powerdown control */
2134 	if (ac97_is_audio(ac97)) {
2135 		/* nothing should be in powerdown mode */
2136 		snd_ac97_write_cache(ac97, AC97_POWERDOWN, 0);
2137 		if (! (ac97->flags & AC97_DEFAULT_POWER_OFF)) {
2138 			snd_ac97_write_cache(ac97, AC97_RESET, 0); /* reset to defaults */
2139 			udelay(100);
2140 			snd_ac97_write_cache(ac97, AC97_POWERDOWN, 0);
2141 		}
2142 		/* nothing should be in powerdown mode */
2143 		snd_ac97_write_cache(ac97, AC97_GENERAL_PURPOSE, 0);
2144 		end_time = jiffies + msecs_to_jiffies(5000);
2145 		do {
2146 			if ((snd_ac97_read(ac97, AC97_POWERDOWN) & 0x0f) == 0x0f)
2147 				goto __ready_ok;
2148 			schedule_timeout_uninterruptible(1);
2149 		} while (time_after_eq(end_time, jiffies));
2150 		ac97_warn(ac97,
2151 			  "AC'97 %d analog subsections not ready\n", ac97->num);
2152 	}
2153 
2154 	/* FIXME: add powerdown control */
2155 	if (ac97_is_modem(ac97)) {
2156 		unsigned char tmp;
2157 
2158 		/* nothing should be in powerdown mode */
2159 		/* note: it's important to set the rate at first */
2160 		tmp = AC97_MEA_GPIO;
2161 		if (ac97->ext_mid & AC97_MEI_LINE1) {
2162 			snd_ac97_write_cache(ac97, AC97_LINE1_RATE, 8000);
2163 			tmp |= AC97_MEA_ADC1 | AC97_MEA_DAC1;
2164 		}
2165 		if (ac97->ext_mid & AC97_MEI_LINE2) {
2166 			snd_ac97_write_cache(ac97, AC97_LINE2_RATE, 8000);
2167 			tmp |= AC97_MEA_ADC2 | AC97_MEA_DAC2;
2168 		}
2169 		if (ac97->ext_mid & AC97_MEI_HANDSET) {
2170 			snd_ac97_write_cache(ac97, AC97_HANDSET_RATE, 8000);
2171 			tmp |= AC97_MEA_HADC | AC97_MEA_HDAC;
2172 		}
2173 		snd_ac97_write_cache(ac97, AC97_EXTENDED_MSTATUS, 0);
2174 		udelay(100);
2175 		/* nothing should be in powerdown mode */
2176 		snd_ac97_write_cache(ac97, AC97_EXTENDED_MSTATUS, 0);
2177 		end_time = jiffies + msecs_to_jiffies(100);
2178 		do {
2179 			if ((snd_ac97_read(ac97, AC97_EXTENDED_MSTATUS) & tmp) == tmp)
2180 				goto __ready_ok;
2181 			schedule_timeout_uninterruptible(1);
2182 		} while (time_after_eq(end_time, jiffies));
2183 		ac97_warn(ac97,
2184 			  "MC'97 %d converters and GPIO not ready (0x%x)\n",
2185 			  ac97->num,
2186 			  snd_ac97_read(ac97, AC97_EXTENDED_MSTATUS));
2187 	}
2188 
2189       __ready_ok:
2190 	if (ac97_is_audio(ac97))
2191 		ac97->addr = (ac97->ext_id & AC97_EI_ADDR_MASK) >> AC97_EI_ADDR_SHIFT;
2192 	else
2193 		ac97->addr = (ac97->ext_mid & AC97_MEI_ADDR_MASK) >> AC97_MEI_ADDR_SHIFT;
2194 	if (ac97->ext_id & 0x01c9) {	/* L/R, MIC, SDAC, LDAC VRA support */
2195 		reg = snd_ac97_read(ac97, AC97_EXTENDED_STATUS);
2196 		reg |= ac97->ext_id & 0x01c0; /* LDAC/SDAC/CDAC */
2197 		if (! bus->no_vra)
2198 			reg |= ac97->ext_id & 0x0009; /* VRA/VRM */
2199 		snd_ac97_write_cache(ac97, AC97_EXTENDED_STATUS, reg);
2200 	}
2201 	if ((ac97->ext_id & AC97_EI_DRA) && bus->dra) {
2202 		/* Intel controllers require double rate data to be put in
2203 		 * slots 7+8, so let's hope the codec supports it. */
2204 		snd_ac97_update_bits(ac97, AC97_GENERAL_PURPOSE, AC97_GP_DRSS_MASK, AC97_GP_DRSS_78);
2205 		if ((snd_ac97_read(ac97, AC97_GENERAL_PURPOSE) & AC97_GP_DRSS_MASK) == AC97_GP_DRSS_78)
2206 			ac97->flags |= AC97_DOUBLE_RATE;
2207 		/* restore to slots 10/11 to avoid the confliction with surrounds */
2208 		snd_ac97_update_bits(ac97, AC97_GENERAL_PURPOSE, AC97_GP_DRSS_MASK, 0);
2209 	}
2210 	if (ac97->ext_id & AC97_EI_VRA) {	/* VRA support */
2211 		snd_ac97_determine_rates(ac97, AC97_PCM_FRONT_DAC_RATE, 0, &ac97->rates[AC97_RATES_FRONT_DAC]);
2212 		snd_ac97_determine_rates(ac97, AC97_PCM_LR_ADC_RATE, 0, &ac97->rates[AC97_RATES_ADC]);
2213 	} else {
2214 		ac97->rates[AC97_RATES_FRONT_DAC] = SNDRV_PCM_RATE_48000;
2215 		if (ac97->flags & AC97_DOUBLE_RATE)
2216 			ac97->rates[AC97_RATES_FRONT_DAC] |= SNDRV_PCM_RATE_96000;
2217 		ac97->rates[AC97_RATES_ADC] = SNDRV_PCM_RATE_48000;
2218 	}
2219 	if (ac97->ext_id & AC97_EI_SPDIF) {
2220 		/* codec specific code (patch) should override these values */
2221 		ac97->rates[AC97_RATES_SPDIF] = SNDRV_PCM_RATE_48000 | SNDRV_PCM_RATE_44100 | SNDRV_PCM_RATE_32000;
2222 	}
2223 	if (ac97->ext_id & AC97_EI_VRM) {	/* MIC VRA support */
2224 		snd_ac97_determine_rates(ac97, AC97_PCM_MIC_ADC_RATE, 0, &ac97->rates[AC97_RATES_MIC_ADC]);
2225 	} else {
2226 		ac97->rates[AC97_RATES_MIC_ADC] = SNDRV_PCM_RATE_48000;
2227 	}
2228 	if (ac97->ext_id & AC97_EI_SDAC) {	/* SDAC support */
2229 		snd_ac97_determine_rates(ac97, AC97_PCM_SURR_DAC_RATE, AC97_PCM_FRONT_DAC_RATE, &ac97->rates[AC97_RATES_SURR_DAC]);
2230 		ac97->scaps |= AC97_SCAP_SURROUND_DAC;
2231 	}
2232 	if (ac97->ext_id & AC97_EI_LDAC) {	/* LDAC support */
2233 		snd_ac97_determine_rates(ac97, AC97_PCM_LFE_DAC_RATE, AC97_PCM_FRONT_DAC_RATE, &ac97->rates[AC97_RATES_LFE_DAC]);
2234 		ac97->scaps |= AC97_SCAP_CENTER_LFE_DAC;
2235 	}
2236 	/* additional initializations */
2237 	if (bus->ops->init)
2238 		bus->ops->init(ac97);
2239 	snd_ac97_get_name(ac97, ac97->id, name, !ac97_is_audio(ac97));
2240 	snd_ac97_get_name(NULL, ac97->id, name, !ac97_is_audio(ac97));  // ac97->id might be changed in the special setup code
2241 	if (! ac97->build_ops)
2242 		ac97->build_ops = &null_build_ops;
2243 
2244 	if (ac97_is_audio(ac97)) {
2245 		char comp[16];
2246 		if (card->mixername[0] == '\0') {
2247 			strcpy(card->mixername, name);
2248 		} else {
2249 			if (strlen(card->mixername) + 1 + strlen(name) + 1 <= sizeof(card->mixername)) {
2250 				strcat(card->mixername, ",");
2251 				strcat(card->mixername, name);
2252 			}
2253 		}
2254 		sprintf(comp, "AC97a:%08x", ac97->id);
2255 		if ((err = snd_component_add(card, comp)) < 0) {
2256 			snd_ac97_free(ac97);
2257 			return err;
2258 		}
2259 		if (snd_ac97_mixer_build(ac97) < 0) {
2260 			snd_ac97_free(ac97);
2261 			return -ENOMEM;
2262 		}
2263 	}
2264 	if (ac97_is_modem(ac97)) {
2265 		char comp[16];
2266 		if (card->mixername[0] == '\0') {
2267 			strcpy(card->mixername, name);
2268 		} else {
2269 			if (strlen(card->mixername) + 1 + strlen(name) + 1 <= sizeof(card->mixername)) {
2270 				strcat(card->mixername, ",");
2271 				strcat(card->mixername, name);
2272 			}
2273 		}
2274 		sprintf(comp, "AC97m:%08x", ac97->id);
2275 		if ((err = snd_component_add(card, comp)) < 0) {
2276 			snd_ac97_free(ac97);
2277 			return err;
2278 		}
2279 		if (snd_ac97_modem_build(card, ac97) < 0) {
2280 			snd_ac97_free(ac97);
2281 			return -ENOMEM;
2282 		}
2283 	}
2284 	if (ac97_is_audio(ac97))
2285 		update_power_regs(ac97);
2286 	snd_ac97_proc_init(ac97);
2287 	if ((err = snd_device_new(card, SNDRV_DEV_CODEC, ac97, &ops)) < 0) {
2288 		snd_ac97_free(ac97);
2289 		return err;
2290 	}
2291 	*rac97 = ac97;
2292 	return 0;
2293 }
2294 
2295 EXPORT_SYMBOL(snd_ac97_mixer);
2296 
2297 /*
2298  * Power down the chip.
2299  *
2300  * MASTER and HEADPHONE registers are muted but the register cache values
2301  * are not changed, so that the values can be restored in snd_ac97_resume().
2302  */
2303 static void snd_ac97_powerdown(struct snd_ac97 *ac97)
2304 {
2305 	unsigned short power;
2306 
2307 	if (ac97_is_audio(ac97)) {
2308 		/* some codecs have stereo mute bits */
2309 		snd_ac97_write(ac97, AC97_MASTER, 0x9f9f);
2310 		snd_ac97_write(ac97, AC97_HEADPHONE, 0x9f9f);
2311 	}
2312 
2313 	/* surround, CLFE, mic powerdown */
2314 	power = ac97->regs[AC97_EXTENDED_STATUS];
2315 	if (ac97->scaps & AC97_SCAP_SURROUND_DAC)
2316 		power |= AC97_EA_PRJ;
2317 	if (ac97->scaps & AC97_SCAP_CENTER_LFE_DAC)
2318 		power |= AC97_EA_PRI | AC97_EA_PRK;
2319 	power |= AC97_EA_PRL;
2320 	snd_ac97_write(ac97, AC97_EXTENDED_STATUS, power);
2321 
2322 	/* powerdown external amplifier */
2323 	if (ac97->scaps & AC97_SCAP_INV_EAPD)
2324 		power = ac97->regs[AC97_POWERDOWN] & ~AC97_PD_EAPD;
2325 	else if (! (ac97->scaps & AC97_SCAP_EAPD_LED))
2326 		power = ac97->regs[AC97_POWERDOWN] | AC97_PD_EAPD;
2327 	power |= AC97_PD_PR6;	/* Headphone amplifier powerdown */
2328 	power |= AC97_PD_PR0 | AC97_PD_PR1;	/* ADC & DAC powerdown */
2329 	snd_ac97_write(ac97, AC97_POWERDOWN, power);
2330 	udelay(100);
2331 	power |= AC97_PD_PR2;	/* Analog Mixer powerdown (Vref on) */
2332 	snd_ac97_write(ac97, AC97_POWERDOWN, power);
2333 	if (ac97_is_power_save_mode(ac97)) {
2334 		power |= AC97_PD_PR3;	/* Analog Mixer powerdown */
2335 		snd_ac97_write(ac97, AC97_POWERDOWN, power);
2336 		udelay(100);
2337 		/* AC-link powerdown, internal Clk disable */
2338 		/* FIXME: this may cause click noises on some boards */
2339 		power |= AC97_PD_PR4 | AC97_PD_PR5;
2340 		snd_ac97_write(ac97, AC97_POWERDOWN, power);
2341 	}
2342 }
2343 
2344 
2345 struct ac97_power_reg {
2346 	unsigned short reg;
2347 	unsigned short power_reg;
2348 	unsigned short mask;
2349 };
2350 
2351 enum { PWIDX_ADC, PWIDX_FRONT, PWIDX_CLFE, PWIDX_SURR, PWIDX_MIC, PWIDX_SIZE };
2352 
2353 static struct ac97_power_reg power_regs[PWIDX_SIZE] = {
2354 	[PWIDX_ADC] = { AC97_PCM_LR_ADC_RATE, AC97_POWERDOWN, AC97_PD_PR0},
2355 	[PWIDX_FRONT] = { AC97_PCM_FRONT_DAC_RATE, AC97_POWERDOWN, AC97_PD_PR1},
2356 	[PWIDX_CLFE] = { AC97_PCM_LFE_DAC_RATE, AC97_EXTENDED_STATUS,
2357 			 AC97_EA_PRI | AC97_EA_PRK},
2358 	[PWIDX_SURR] = { AC97_PCM_SURR_DAC_RATE, AC97_EXTENDED_STATUS,
2359 			 AC97_EA_PRJ},
2360 	[PWIDX_MIC] = { AC97_PCM_MIC_ADC_RATE, AC97_EXTENDED_STATUS,
2361 			AC97_EA_PRL},
2362 };
2363 
2364 #ifdef CONFIG_SND_AC97_POWER_SAVE
2365 /**
2366  * snd_ac97_update_power - update the powerdown register
2367  * @ac97: the codec instance
2368  * @reg: the rate register, e.g. AC97_PCM_FRONT_DAC_RATE
2369  * @powerup: non-zero when power up the part
2370  *
2371  * Update the AC97 powerdown register bits of the given part.
2372  *
2373  * Return: Zero.
2374  */
2375 int snd_ac97_update_power(struct snd_ac97 *ac97, int reg, int powerup)
2376 {
2377 	int i;
2378 
2379 	if (! ac97)
2380 		return 0;
2381 
2382 	if (reg) {
2383 		/* SPDIF requires DAC power, too */
2384 		if (reg == AC97_SPDIF)
2385 			reg = AC97_PCM_FRONT_DAC_RATE;
2386 		for (i = 0; i < PWIDX_SIZE; i++) {
2387 			if (power_regs[i].reg == reg) {
2388 				if (powerup)
2389 					ac97->power_up |= (1 << i);
2390 				else
2391 					ac97->power_up &= ~(1 << i);
2392 				break;
2393 			}
2394 		}
2395 	}
2396 
2397 	if (ac97_is_power_save_mode(ac97) && !powerup)
2398 		/* adjust power-down bits after two seconds delay
2399 		 * (for avoiding loud click noises for many (OSS) apps
2400 		 *  that open/close frequently)
2401 		 */
2402 		schedule_delayed_work(&ac97->power_work,
2403 				      msecs_to_jiffies(power_save * 1000));
2404 	else {
2405 		cancel_delayed_work(&ac97->power_work);
2406 		update_power_regs(ac97);
2407 	}
2408 
2409 	return 0;
2410 }
2411 
2412 EXPORT_SYMBOL(snd_ac97_update_power);
2413 #endif /* CONFIG_SND_AC97_POWER_SAVE */
2414 
2415 static void update_power_regs(struct snd_ac97 *ac97)
2416 {
2417 	unsigned int power_up, bits;
2418 	int i;
2419 
2420 	power_up = (1 << PWIDX_FRONT) | (1 << PWIDX_ADC);
2421 	power_up |= (1 << PWIDX_MIC);
2422 	if (ac97->scaps & AC97_SCAP_SURROUND_DAC)
2423 		power_up |= (1 << PWIDX_SURR);
2424 	if (ac97->scaps & AC97_SCAP_CENTER_LFE_DAC)
2425 		power_up |= (1 << PWIDX_CLFE);
2426 #ifdef CONFIG_SND_AC97_POWER_SAVE
2427 	if (ac97_is_power_save_mode(ac97))
2428 		power_up = ac97->power_up;
2429 #endif
2430 	if (power_up) {
2431 		if (ac97->regs[AC97_POWERDOWN] & AC97_PD_PR2) {
2432 			/* needs power-up analog mix and vref */
2433 			snd_ac97_update_bits(ac97, AC97_POWERDOWN,
2434 					     AC97_PD_PR3, 0);
2435 			msleep(1);
2436 			snd_ac97_update_bits(ac97, AC97_POWERDOWN,
2437 					     AC97_PD_PR2, 0);
2438 		}
2439 	}
2440 	for (i = 0; i < PWIDX_SIZE; i++) {
2441 		if (power_up & (1 << i))
2442 			bits = 0;
2443 		else
2444 			bits = power_regs[i].mask;
2445 		snd_ac97_update_bits(ac97, power_regs[i].power_reg,
2446 				     power_regs[i].mask, bits);
2447 	}
2448 	if (! power_up) {
2449 		if (! (ac97->regs[AC97_POWERDOWN] & AC97_PD_PR2)) {
2450 			/* power down analog mix and vref */
2451 			snd_ac97_update_bits(ac97, AC97_POWERDOWN,
2452 					     AC97_PD_PR2, AC97_PD_PR2);
2453 			snd_ac97_update_bits(ac97, AC97_POWERDOWN,
2454 					     AC97_PD_PR3, AC97_PD_PR3);
2455 		}
2456 	}
2457 }
2458 
2459 
2460 #ifdef CONFIG_PM
2461 /**
2462  * snd_ac97_suspend - General suspend function for AC97 codec
2463  * @ac97: the ac97 instance
2464  *
2465  * Suspends the codec, power down the chip.
2466  */
2467 void snd_ac97_suspend(struct snd_ac97 *ac97)
2468 {
2469 	if (! ac97)
2470 		return;
2471 	if (ac97->build_ops->suspend)
2472 		ac97->build_ops->suspend(ac97);
2473 #ifdef CONFIG_SND_AC97_POWER_SAVE
2474 	cancel_delayed_work_sync(&ac97->power_work);
2475 #endif
2476 	snd_ac97_powerdown(ac97);
2477 }
2478 
2479 EXPORT_SYMBOL(snd_ac97_suspend);
2480 
2481 /*
2482  * restore ac97 status
2483  */
2484 static void snd_ac97_restore_status(struct snd_ac97 *ac97)
2485 {
2486 	int i;
2487 
2488 	for (i = 2; i < 0x7c ; i += 2) {
2489 		if (i == AC97_POWERDOWN || i == AC97_EXTENDED_ID)
2490 			continue;
2491 		/* restore only accessible registers
2492 		 * some chip (e.g. nm256) may hang up when unsupported registers
2493 		 * are accessed..!
2494 		 */
2495 		if (test_bit(i, ac97->reg_accessed)) {
2496 			snd_ac97_write(ac97, i, ac97->regs[i]);
2497 			snd_ac97_read(ac97, i);
2498 		}
2499 	}
2500 }
2501 
2502 /*
2503  * restore IEC958 status
2504  */
2505 static void snd_ac97_restore_iec958(struct snd_ac97 *ac97)
2506 {
2507 	if (ac97->ext_id & AC97_EI_SPDIF) {
2508 		if (ac97->regs[AC97_EXTENDED_STATUS] & AC97_EA_SPDIF) {
2509 			/* reset spdif status */
2510 			snd_ac97_update_bits(ac97, AC97_EXTENDED_STATUS, AC97_EA_SPDIF, 0);
2511 			snd_ac97_write(ac97, AC97_EXTENDED_STATUS, ac97->regs[AC97_EXTENDED_STATUS]);
2512 			if (ac97->flags & AC97_CS_SPDIF)
2513 				snd_ac97_write(ac97, AC97_CSR_SPDIF, ac97->regs[AC97_CSR_SPDIF]);
2514 			else
2515 				snd_ac97_write(ac97, AC97_SPDIF, ac97->regs[AC97_SPDIF]);
2516 			snd_ac97_update_bits(ac97, AC97_EXTENDED_STATUS, AC97_EA_SPDIF, AC97_EA_SPDIF); /* turn on again */
2517 		}
2518 	}
2519 }
2520 
2521 /**
2522  * snd_ac97_resume - General resume function for AC97 codec
2523  * @ac97: the ac97 instance
2524  *
2525  * Do the standard resume procedure, power up and restoring the
2526  * old register values.
2527  */
2528 void snd_ac97_resume(struct snd_ac97 *ac97)
2529 {
2530 	unsigned long end_time;
2531 
2532 	if (! ac97)
2533 		return;
2534 
2535 	if (ac97->bus->ops->reset) {
2536 		ac97->bus->ops->reset(ac97);
2537 		goto  __reset_ready;
2538 	}
2539 
2540 	snd_ac97_write(ac97, AC97_POWERDOWN, 0);
2541 	if (! (ac97->flags & AC97_DEFAULT_POWER_OFF)) {
2542 		if (!(ac97->scaps & AC97_SCAP_SKIP_AUDIO))
2543 			snd_ac97_write(ac97, AC97_RESET, 0);
2544 		else if (!(ac97->scaps & AC97_SCAP_SKIP_MODEM))
2545 			snd_ac97_write(ac97, AC97_EXTENDED_MID, 0);
2546 		udelay(100);
2547 		snd_ac97_write(ac97, AC97_POWERDOWN, 0);
2548 	}
2549 	snd_ac97_write(ac97, AC97_GENERAL_PURPOSE, 0);
2550 
2551 	snd_ac97_write(ac97, AC97_POWERDOWN, ac97->regs[AC97_POWERDOWN]);
2552 	if (ac97_is_audio(ac97)) {
2553 		ac97->bus->ops->write(ac97, AC97_MASTER, 0x8101);
2554 		end_time = jiffies + msecs_to_jiffies(100);
2555 		do {
2556 			if (snd_ac97_read(ac97, AC97_MASTER) == 0x8101)
2557 				break;
2558 			schedule_timeout_uninterruptible(1);
2559 		} while (time_after_eq(end_time, jiffies));
2560 		/* FIXME: extra delay */
2561 		ac97->bus->ops->write(ac97, AC97_MASTER, AC97_MUTE_MASK_MONO);
2562 		if (snd_ac97_read(ac97, AC97_MASTER) != AC97_MUTE_MASK_MONO)
2563 			msleep(250);
2564 	} else {
2565 		end_time = jiffies + msecs_to_jiffies(100);
2566 		do {
2567 			unsigned short val = snd_ac97_read(ac97, AC97_EXTENDED_MID);
2568 			if (val != 0xffff && (val & 1) != 0)
2569 				break;
2570 			schedule_timeout_uninterruptible(1);
2571 		} while (time_after_eq(end_time, jiffies));
2572 	}
2573 __reset_ready:
2574 
2575 	if (ac97->bus->ops->init)
2576 		ac97->bus->ops->init(ac97);
2577 
2578 	if (ac97->build_ops->resume)
2579 		ac97->build_ops->resume(ac97);
2580 	else {
2581 		snd_ac97_restore_status(ac97);
2582 		snd_ac97_restore_iec958(ac97);
2583 	}
2584 }
2585 
2586 EXPORT_SYMBOL(snd_ac97_resume);
2587 #endif
2588 
2589 
2590 /*
2591  * Hardware tuning
2592  */
2593 static void set_ctl_name(char *dst, const char *src, const char *suffix)
2594 {
2595 	if (suffix)
2596 		sprintf(dst, "%s %s", src, suffix);
2597 	else
2598 		strcpy(dst, src);
2599 }
2600 
2601 /* remove the control with the given name and optional suffix */
2602 static int snd_ac97_remove_ctl(struct snd_ac97 *ac97, const char *name,
2603 			       const char *suffix)
2604 {
2605 	struct snd_ctl_elem_id id;
2606 	memset(&id, 0, sizeof(id));
2607 	set_ctl_name(id.name, name, suffix);
2608 	id.iface = SNDRV_CTL_ELEM_IFACE_MIXER;
2609 	return snd_ctl_remove_id(ac97->bus->card, &id);
2610 }
2611 
2612 static struct snd_kcontrol *ctl_find(struct snd_ac97 *ac97, const char *name, const char *suffix)
2613 {
2614 	struct snd_ctl_elem_id sid;
2615 	memset(&sid, 0, sizeof(sid));
2616 	set_ctl_name(sid.name, name, suffix);
2617 	sid.iface = SNDRV_CTL_ELEM_IFACE_MIXER;
2618 	return snd_ctl_find_id(ac97->bus->card, &sid);
2619 }
2620 
2621 /* rename the control with the given name and optional suffix */
2622 static int snd_ac97_rename_ctl(struct snd_ac97 *ac97, const char *src,
2623 			       const char *dst, const char *suffix)
2624 {
2625 	struct snd_kcontrol *kctl = ctl_find(ac97, src, suffix);
2626 	if (kctl) {
2627 		set_ctl_name(kctl->id.name, dst, suffix);
2628 		return 0;
2629 	}
2630 	return -ENOENT;
2631 }
2632 
2633 /* rename both Volume and Switch controls - don't check the return value */
2634 static void snd_ac97_rename_vol_ctl(struct snd_ac97 *ac97, const char *src,
2635 				    const char *dst)
2636 {
2637 	snd_ac97_rename_ctl(ac97, src, dst, "Switch");
2638 	snd_ac97_rename_ctl(ac97, src, dst, "Volume");
2639 }
2640 
2641 /* swap controls */
2642 static int snd_ac97_swap_ctl(struct snd_ac97 *ac97, const char *s1,
2643 			     const char *s2, const char *suffix)
2644 {
2645 	struct snd_kcontrol *kctl1, *kctl2;
2646 	kctl1 = ctl_find(ac97, s1, suffix);
2647 	kctl2 = ctl_find(ac97, s2, suffix);
2648 	if (kctl1 && kctl2) {
2649 		set_ctl_name(kctl1->id.name, s2, suffix);
2650 		set_ctl_name(kctl2->id.name, s1, suffix);
2651 		return 0;
2652 	}
2653 	return -ENOENT;
2654 }
2655 
2656 #if 1
2657 /* bind hp and master controls instead of using only hp control */
2658 static int bind_hp_volsw_put(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
2659 {
2660 	int err = snd_ac97_put_volsw(kcontrol, ucontrol);
2661 	if (err > 0) {
2662 		unsigned long priv_saved = kcontrol->private_value;
2663 		kcontrol->private_value = (kcontrol->private_value & ~0xff) | AC97_HEADPHONE;
2664 		snd_ac97_put_volsw(kcontrol, ucontrol);
2665 		kcontrol->private_value = priv_saved;
2666 	}
2667 	return err;
2668 }
2669 
2670 /* ac97 tune: bind Master and Headphone controls */
2671 static int tune_hp_only(struct snd_ac97 *ac97)
2672 {
2673 	struct snd_kcontrol *msw = ctl_find(ac97, "Master Playback Switch", NULL);
2674 	struct snd_kcontrol *mvol = ctl_find(ac97, "Master Playback Volume", NULL);
2675 	if (! msw || ! mvol)
2676 		return -ENOENT;
2677 	msw->put = bind_hp_volsw_put;
2678 	mvol->put = bind_hp_volsw_put;
2679 	snd_ac97_remove_ctl(ac97, "Headphone Playback", "Switch");
2680 	snd_ac97_remove_ctl(ac97, "Headphone Playback", "Volume");
2681 	return 0;
2682 }
2683 
2684 #else
2685 /* ac97 tune: use Headphone control as master */
2686 static int tune_hp_only(struct snd_ac97 *ac97)
2687 {
2688 	if (ctl_find(ac97, "Headphone Playback Switch", NULL) == NULL)
2689 		return -ENOENT;
2690 	snd_ac97_remove_ctl(ac97, "Master Playback", "Switch");
2691 	snd_ac97_remove_ctl(ac97, "Master Playback", "Volume");
2692 	snd_ac97_rename_vol_ctl(ac97, "Headphone Playback", "Master Playback");
2693 	return 0;
2694 }
2695 #endif
2696 
2697 /* ac97 tune: swap Headphone and Master controls */
2698 static int tune_swap_hp(struct snd_ac97 *ac97)
2699 {
2700 	if (ctl_find(ac97, "Headphone Playback Switch", NULL) == NULL)
2701 		return -ENOENT;
2702 	snd_ac97_rename_vol_ctl(ac97, "Master Playback", "Line-Out Playback");
2703 	snd_ac97_rename_vol_ctl(ac97, "Headphone Playback", "Master Playback");
2704 	return 0;
2705 }
2706 
2707 /* ac97 tune: swap Surround and Master controls */
2708 static int tune_swap_surround(struct snd_ac97 *ac97)
2709 {
2710 	if (snd_ac97_swap_ctl(ac97, "Master Playback", "Surround Playback", "Switch") ||
2711 	    snd_ac97_swap_ctl(ac97, "Master Playback", "Surround Playback", "Volume"))
2712 		return -ENOENT;
2713 	return 0;
2714 }
2715 
2716 /* ac97 tune: set up mic sharing for AD codecs */
2717 static int tune_ad_sharing(struct snd_ac97 *ac97)
2718 {
2719 	unsigned short scfg;
2720 	if ((ac97->id & 0xffffff00) != 0x41445300) {
2721 		ac97_err(ac97, "ac97_quirk AD_SHARING is only for AD codecs\n");
2722 		return -EINVAL;
2723 	}
2724 	/* Turn on OMS bit to route microphone to back panel */
2725 	scfg = snd_ac97_read(ac97, AC97_AD_SERIAL_CFG);
2726 	snd_ac97_write_cache(ac97, AC97_AD_SERIAL_CFG, scfg | 0x0200);
2727 	return 0;
2728 }
2729 
2730 static const struct snd_kcontrol_new snd_ac97_alc_jack_detect =
2731 AC97_SINGLE("Jack Detect", AC97_ALC650_CLOCK, 5, 1, 0);
2732 
2733 /* ac97 tune: set up ALC jack-select */
2734 static int tune_alc_jack(struct snd_ac97 *ac97)
2735 {
2736 	if ((ac97->id & 0xffffff00) != 0x414c4700) {
2737 		ac97_err(ac97,
2738 			 "ac97_quirk ALC_JACK is only for Realtek codecs\n");
2739 		return -EINVAL;
2740 	}
2741 	snd_ac97_update_bits(ac97, 0x7a, 0x20, 0x20); /* select jack detect function */
2742 	snd_ac97_update_bits(ac97, 0x7a, 0x01, 0x01); /* Line-out auto mute */
2743 	if (ac97->id == AC97_ID_ALC658D)
2744 		snd_ac97_update_bits(ac97, 0x74, 0x0800, 0x0800);
2745 	return snd_ctl_add(ac97->bus->card, snd_ac97_cnew(&snd_ac97_alc_jack_detect, ac97));
2746 }
2747 
2748 /* ac97 tune: inversed EAPD bit */
2749 static int tune_inv_eapd(struct snd_ac97 *ac97)
2750 {
2751 	struct snd_kcontrol *kctl = ctl_find(ac97, "External Amplifier", NULL);
2752 	if (! kctl)
2753 		return -ENOENT;
2754 	set_inv_eapd(ac97, kctl);
2755 	return 0;
2756 }
2757 
2758 static int master_mute_sw_put(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
2759 {
2760 	int err = snd_ac97_put_volsw(kcontrol, ucontrol);
2761 	if (err > 0) {
2762 		struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
2763 		int shift = (kcontrol->private_value >> 8) & 0x0f;
2764 		int rshift = (kcontrol->private_value >> 12) & 0x0f;
2765 		unsigned short mask;
2766 		if (shift != rshift)
2767 			mask = AC97_MUTE_MASK_STEREO;
2768 		else
2769 			mask = AC97_MUTE_MASK_MONO;
2770 		snd_ac97_update_bits(ac97, AC97_POWERDOWN, AC97_PD_EAPD,
2771 				     (ac97->regs[AC97_MASTER] & mask) == mask ?
2772 				     AC97_PD_EAPD : 0);
2773 	}
2774 	return err;
2775 }
2776 
2777 /* ac97 tune: EAPD controls mute LED bound with the master mute */
2778 static int tune_mute_led(struct snd_ac97 *ac97)
2779 {
2780 	struct snd_kcontrol *msw = ctl_find(ac97, "Master Playback Switch", NULL);
2781 	if (! msw)
2782 		return -ENOENT;
2783 	msw->put = master_mute_sw_put;
2784 	snd_ac97_remove_ctl(ac97, "External Amplifier", NULL);
2785 	snd_ac97_update_bits(
2786 		ac97, AC97_POWERDOWN,
2787 		AC97_PD_EAPD, AC97_PD_EAPD /* mute LED on */
2788 	);
2789 	ac97->scaps |= AC97_SCAP_EAPD_LED;
2790 	return 0;
2791 }
2792 
2793 static int hp_master_mute_sw_put(struct snd_kcontrol *kcontrol,
2794 				 struct snd_ctl_elem_value *ucontrol)
2795 {
2796 	int err = bind_hp_volsw_put(kcontrol, ucontrol);
2797 	if (err > 0) {
2798 		struct snd_ac97 *ac97 = snd_kcontrol_chip(kcontrol);
2799 		int shift = (kcontrol->private_value >> 8) & 0x0f;
2800 		int rshift = (kcontrol->private_value >> 12) & 0x0f;
2801 		unsigned short mask;
2802 		if (shift != rshift)
2803 			mask = AC97_MUTE_MASK_STEREO;
2804 		else
2805 			mask = AC97_MUTE_MASK_MONO;
2806 		snd_ac97_update_bits(ac97, AC97_POWERDOWN, AC97_PD_EAPD,
2807 				     (ac97->regs[AC97_MASTER] & mask) == mask ?
2808 				     AC97_PD_EAPD : 0);
2809 	}
2810 	return err;
2811 }
2812 
2813 static int tune_hp_mute_led(struct snd_ac97 *ac97)
2814 {
2815 	struct snd_kcontrol *msw = ctl_find(ac97, "Master Playback Switch", NULL);
2816 	struct snd_kcontrol *mvol = ctl_find(ac97, "Master Playback Volume", NULL);
2817 	if (! msw || ! mvol)
2818 		return -ENOENT;
2819 	msw->put = hp_master_mute_sw_put;
2820 	mvol->put = bind_hp_volsw_put;
2821 	snd_ac97_remove_ctl(ac97, "External Amplifier", NULL);
2822 	snd_ac97_remove_ctl(ac97, "Headphone Playback", "Switch");
2823 	snd_ac97_remove_ctl(ac97, "Headphone Playback", "Volume");
2824 	snd_ac97_update_bits(
2825 		ac97, AC97_POWERDOWN,
2826 		AC97_PD_EAPD, AC97_PD_EAPD /* mute LED on */
2827 	);
2828 	return 0;
2829 }
2830 
2831 struct quirk_table {
2832 	const char *name;
2833 	int (*func)(struct snd_ac97 *);
2834 };
2835 
2836 static struct quirk_table applicable_quirks[] = {
2837 	{ "none", NULL },
2838 	{ "hp_only", tune_hp_only },
2839 	{ "swap_hp", tune_swap_hp },
2840 	{ "swap_surround", tune_swap_surround },
2841 	{ "ad_sharing", tune_ad_sharing },
2842 	{ "alc_jack", tune_alc_jack },
2843 	{ "inv_eapd", tune_inv_eapd },
2844 	{ "mute_led", tune_mute_led },
2845 	{ "hp_mute_led", tune_hp_mute_led },
2846 };
2847 
2848 /* apply the quirk with the given type */
2849 static int apply_quirk(struct snd_ac97 *ac97, int type)
2850 {
2851 	if (type <= 0)
2852 		return 0;
2853 	else if (type >= ARRAY_SIZE(applicable_quirks))
2854 		return -EINVAL;
2855 	if (applicable_quirks[type].func)
2856 		return applicable_quirks[type].func(ac97);
2857 	return 0;
2858 }
2859 
2860 /* apply the quirk with the given name */
2861 static int apply_quirk_str(struct snd_ac97 *ac97, const char *typestr)
2862 {
2863 	int i;
2864 	struct quirk_table *q;
2865 
2866 	for (i = 0; i < ARRAY_SIZE(applicable_quirks); i++) {
2867 		q = &applicable_quirks[i];
2868 		if (q->name && ! strcmp(typestr, q->name))
2869 			return apply_quirk(ac97, i);
2870 	}
2871 	/* for compatibility, accept the numbers, too */
2872 	if (*typestr >= '0' && *typestr <= '9')
2873 		return apply_quirk(ac97, (int)simple_strtoul(typestr, NULL, 10));
2874 	return -EINVAL;
2875 }
2876 
2877 /**
2878  * snd_ac97_tune_hardware - tune up the hardware
2879  * @ac97: the ac97 instance
2880  * @quirk: quirk list
2881  * @override: explicit quirk value (overrides the list if non-NULL)
2882  *
2883  * Do some workaround for each pci device, such as renaming of the
2884  * headphone (true line-out) control as "Master".
2885  * The quirk-list must be terminated with a zero-filled entry.
2886  *
2887  * Return: Zero if successful, or a negative error code on failure.
2888  */
2889 
2890 int snd_ac97_tune_hardware(struct snd_ac97 *ac97,
2891 			   const struct ac97_quirk *quirk, const char *override)
2892 {
2893 	int result;
2894 
2895 	/* quirk overriden? */
2896 	if (override && strcmp(override, "-1") && strcmp(override, "default")) {
2897 		result = apply_quirk_str(ac97, override);
2898 		if (result < 0)
2899 			ac97_err(ac97, "applying quirk type %s failed (%d)\n",
2900 				 override, result);
2901 		return result;
2902 	}
2903 
2904 	if (! quirk)
2905 		return -EINVAL;
2906 
2907 	for (; quirk->subvendor; quirk++) {
2908 		if (quirk->subvendor != ac97->subsystem_vendor)
2909 			continue;
2910 		if ((! quirk->mask && quirk->subdevice == ac97->subsystem_device) ||
2911 		    quirk->subdevice == (quirk->mask & ac97->subsystem_device)) {
2912 			if (quirk->codec_id && quirk->codec_id != ac97->id)
2913 				continue;
2914 			ac97_dbg(ac97, "ac97 quirk for %s (%04x:%04x)\n",
2915 				 quirk->name, ac97->subsystem_vendor,
2916 				 ac97->subsystem_device);
2917 			result = apply_quirk(ac97, quirk->type);
2918 			if (result < 0)
2919 				ac97_err(ac97,
2920 					 "applying quirk type %d for %s failed (%d)\n",
2921 					 quirk->type, quirk->name, result);
2922 			return result;
2923 		}
2924 	}
2925 	return 0;
2926 }
2927 
2928 EXPORT_SYMBOL(snd_ac97_tune_hardware);
2929