xref: /openbmc/linux/sound/pci/hda/hda_local.h (revision e190bfe5)
1 /*
2  * Universal Interface for Intel High Definition Audio Codec
3  *
4  * Local helper functions
5  *
6  * Copyright (c) 2004 Takashi Iwai <tiwai@suse.de>
7  *
8  *  This program is free software; you can redistribute it and/or modify it
9  *  under the terms of the GNU General Public License as published by the Free
10  *  Software Foundation; either version 2 of the License, or (at your option)
11  *  any later version.
12  *
13  *  This program is distributed in the hope that it will be useful, but WITHOUT
14  *  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15  *  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
16  *  more details.
17  *
18  *  You should have received a copy of the GNU General Public License along with
19  *  this program; if not, write to the Free Software Foundation, Inc., 59
20  *  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
21  */
22 
23 #ifndef __SOUND_HDA_LOCAL_H
24 #define __SOUND_HDA_LOCAL_H
25 
26 /* We abuse kcontrol_new.subdev field to pass the NID corresponding to
27  * the given new control.  If id.subdev has a bit flag HDA_SUBDEV_NID_FLAG,
28  * snd_hda_ctl_add() takes the lower-bit subdev value as a valid NID.
29  *
30  * Note that the subdevice field is cleared again before the real registration
31  * in snd_hda_ctl_add(), so that this value won't appear in the outside.
32  */
33 #define HDA_SUBDEV_NID_FLAG	(1U << 31)
34 #define HDA_SUBDEV_AMP_FLAG	(1U << 30)
35 
36 /*
37  * for mixer controls
38  */
39 #define HDA_COMPOSE_AMP_VAL_OFS(nid,chs,idx,dir,ofs)		\
40 	((nid) | ((chs)<<16) | ((dir)<<18) | ((idx)<<19) | ((ofs)<<23))
41 #define HDA_COMPOSE_AMP_VAL(nid,chs,idx,dir) \
42 	HDA_COMPOSE_AMP_VAL_OFS(nid, chs, idx, dir, 0)
43 /* mono volume with index (index=0,1,...) (channel=1,2) */
44 #define HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
45 	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx,  \
46 	  .subdevice = HDA_SUBDEV_AMP_FLAG, \
47 	  .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | \
48 	  	    SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
49 	  	    SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK, \
50 	  .info = snd_hda_mixer_amp_volume_info, \
51 	  .get = snd_hda_mixer_amp_volume_get, \
52 	  .put = snd_hda_mixer_amp_volume_put, \
53 	  .tlv = { .c = snd_hda_mixer_amp_tlv },		\
54 	  .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
55 /* stereo volume with index */
56 #define HDA_CODEC_VOLUME_IDX(xname, xcidx, nid, xindex, direction) \
57 	HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)
58 /* mono volume */
59 #define HDA_CODEC_VOLUME_MONO(xname, nid, channel, xindex, direction) \
60 	HDA_CODEC_VOLUME_MONO_IDX(xname, 0, nid, channel, xindex, direction)
61 /* stereo volume */
62 #define HDA_CODEC_VOLUME(xname, nid, xindex, direction) \
63 	HDA_CODEC_VOLUME_MONO(xname, nid, 3, xindex, direction)
64 /* mono mute switch with index (index=0,1,...) (channel=1,2) */
65 #define HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
66 	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
67 	  .subdevice = HDA_SUBDEV_AMP_FLAG, \
68 	  .info = snd_hda_mixer_amp_switch_info, \
69 	  .get = snd_hda_mixer_amp_switch_get, \
70 	  .put = snd_hda_mixer_amp_switch_put, \
71 	  .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
72 /* stereo mute switch with index */
73 #define HDA_CODEC_MUTE_IDX(xname, xcidx, nid, xindex, direction) \
74 	HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)
75 /* mono mute switch */
76 #define HDA_CODEC_MUTE_MONO(xname, nid, channel, xindex, direction) \
77 	HDA_CODEC_MUTE_MONO_IDX(xname, 0, nid, channel, xindex, direction)
78 /* stereo mute switch */
79 #define HDA_CODEC_MUTE(xname, nid, xindex, direction) \
80 	HDA_CODEC_MUTE_MONO(xname, nid, 3, xindex, direction)
81 #ifdef CONFIG_SND_HDA_INPUT_BEEP
82 /* special beep mono mute switch with index (index=0,1,...) (channel=1,2) */
83 #define HDA_CODEC_MUTE_BEEP_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
84 	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
85 	  .subdevice = HDA_SUBDEV_AMP_FLAG, \
86 	  .info = snd_hda_mixer_amp_switch_info, \
87 	  .get = snd_hda_mixer_amp_switch_get, \
88 	  .put = snd_hda_mixer_amp_switch_put_beep, \
89 	  .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
90 #else
91 /* no digital beep - just the standard one */
92 #define HDA_CODEC_MUTE_BEEP_MONO_IDX(xname, xcidx, nid, ch, xidx, dir) \
93 	HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, ch, xidx, dir)
94 #endif /* CONFIG_SND_HDA_INPUT_BEEP */
95 /* special beep mono mute switch */
96 #define HDA_CODEC_MUTE_BEEP_MONO(xname, nid, channel, xindex, direction) \
97 	HDA_CODEC_MUTE_BEEP_MONO_IDX(xname, 0, nid, channel, xindex, direction)
98 /* special beep stereo mute switch */
99 #define HDA_CODEC_MUTE_BEEP(xname, nid, xindex, direction) \
100 	HDA_CODEC_MUTE_BEEP_MONO(xname, nid, 3, xindex, direction)
101 
102 extern const char *snd_hda_pcm_type_name[];
103 
104 int snd_hda_mixer_amp_volume_info(struct snd_kcontrol *kcontrol,
105 				  struct snd_ctl_elem_info *uinfo);
106 int snd_hda_mixer_amp_volume_get(struct snd_kcontrol *kcontrol,
107 				 struct snd_ctl_elem_value *ucontrol);
108 int snd_hda_mixer_amp_volume_put(struct snd_kcontrol *kcontrol,
109 				 struct snd_ctl_elem_value *ucontrol);
110 int snd_hda_mixer_amp_tlv(struct snd_kcontrol *kcontrol, int op_flag,
111 			  unsigned int size, unsigned int __user *tlv);
112 int snd_hda_mixer_amp_switch_info(struct snd_kcontrol *kcontrol,
113 				  struct snd_ctl_elem_info *uinfo);
114 int snd_hda_mixer_amp_switch_get(struct snd_kcontrol *kcontrol,
115 				 struct snd_ctl_elem_value *ucontrol);
116 int snd_hda_mixer_amp_switch_put(struct snd_kcontrol *kcontrol,
117 				 struct snd_ctl_elem_value *ucontrol);
118 #ifdef CONFIG_SND_HDA_INPUT_BEEP
119 int snd_hda_mixer_amp_switch_put_beep(struct snd_kcontrol *kcontrol,
120 				      struct snd_ctl_elem_value *ucontrol);
121 #endif
122 /* lowlevel accessor with caching; use carefully */
123 int snd_hda_codec_amp_read(struct hda_codec *codec, hda_nid_t nid, int ch,
124 			   int direction, int index);
125 int snd_hda_codec_amp_update(struct hda_codec *codec, hda_nid_t nid, int ch,
126 			     int direction, int idx, int mask, int val);
127 int snd_hda_codec_amp_stereo(struct hda_codec *codec, hda_nid_t nid,
128 			     int dir, int idx, int mask, int val);
129 #ifdef SND_HDA_NEEDS_RESUME
130 void snd_hda_codec_resume_amp(struct hda_codec *codec);
131 #endif
132 
133 void snd_hda_set_vmaster_tlv(struct hda_codec *codec, hda_nid_t nid, int dir,
134 			     unsigned int *tlv);
135 struct snd_kcontrol *snd_hda_find_mixer_ctl(struct hda_codec *codec,
136 					    const char *name);
137 int snd_hda_add_vmaster(struct hda_codec *codec, char *name,
138 			unsigned int *tlv, const char **slaves);
139 int snd_hda_codec_reset(struct hda_codec *codec);
140 
141 /* amp value bits */
142 #define HDA_AMP_MUTE	0x80
143 #define HDA_AMP_UNMUTE	0x00
144 #define HDA_AMP_VOLMASK	0x7f
145 
146 /* mono switch binding multiple inputs */
147 #define HDA_BIND_MUTE_MONO(xname, nid, channel, indices, direction) \
148 	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = 0,  \
149 	  .info = snd_hda_mixer_amp_switch_info, \
150 	  .get = snd_hda_mixer_bind_switch_get, \
151 	  .put = snd_hda_mixer_bind_switch_put, \
152 	  .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, indices, direction) }
153 
154 /* stereo switch binding multiple inputs */
155 #define HDA_BIND_MUTE(xname,nid,indices,dir) \
156 	HDA_BIND_MUTE_MONO(xname,nid,3,indices,dir)
157 
158 int snd_hda_mixer_bind_switch_get(struct snd_kcontrol *kcontrol,
159 				  struct snd_ctl_elem_value *ucontrol);
160 int snd_hda_mixer_bind_switch_put(struct snd_kcontrol *kcontrol,
161 				  struct snd_ctl_elem_value *ucontrol);
162 
163 /* more generic bound controls */
164 struct hda_ctl_ops {
165 	snd_kcontrol_info_t *info;
166 	snd_kcontrol_get_t *get;
167 	snd_kcontrol_put_t *put;
168 	snd_kcontrol_tlv_rw_t *tlv;
169 };
170 
171 extern struct hda_ctl_ops snd_hda_bind_vol;	/* for bind-volume with TLV */
172 extern struct hda_ctl_ops snd_hda_bind_sw;	/* for bind-switch */
173 
174 struct hda_bind_ctls {
175 	struct hda_ctl_ops *ops;
176 	unsigned long values[];
177 };
178 
179 int snd_hda_mixer_bind_ctls_info(struct snd_kcontrol *kcontrol,
180 				 struct snd_ctl_elem_info *uinfo);
181 int snd_hda_mixer_bind_ctls_get(struct snd_kcontrol *kcontrol,
182 				struct snd_ctl_elem_value *ucontrol);
183 int snd_hda_mixer_bind_ctls_put(struct snd_kcontrol *kcontrol,
184 				struct snd_ctl_elem_value *ucontrol);
185 int snd_hda_mixer_bind_tlv(struct snd_kcontrol *kcontrol, int op_flag,
186 			   unsigned int size, unsigned int __user *tlv);
187 
188 #define HDA_BIND_VOL(xname, bindrec) \
189 	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \
190 	  .name = xname, \
191 	  .access = SNDRV_CTL_ELEM_ACCESS_READWRITE |\
192 			  SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
193 			  SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK,\
194 	  .info = snd_hda_mixer_bind_ctls_info,\
195 	  .get =  snd_hda_mixer_bind_ctls_get,\
196 	  .put = snd_hda_mixer_bind_ctls_put,\
197 	  .tlv = { .c = snd_hda_mixer_bind_tlv },\
198 	  .private_value = (long) (bindrec) }
199 #define HDA_BIND_SW(xname, bindrec) \
200 	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER,\
201 	  .name = xname, \
202 	  .info = snd_hda_mixer_bind_ctls_info,\
203 	  .get =  snd_hda_mixer_bind_ctls_get,\
204 	  .put = snd_hda_mixer_bind_ctls_put,\
205 	  .private_value = (long) (bindrec) }
206 
207 /*
208  * SPDIF I/O
209  */
210 int snd_hda_create_spdif_out_ctls(struct hda_codec *codec, hda_nid_t nid);
211 int snd_hda_create_spdif_in_ctls(struct hda_codec *codec, hda_nid_t nid);
212 
213 /*
214  * input MUX helper
215  */
216 #define HDA_MAX_NUM_INPUTS	16
217 struct hda_input_mux_item {
218 	const char *label;
219 	unsigned int index;
220 };
221 struct hda_input_mux {
222 	unsigned int num_items;
223 	struct hda_input_mux_item items[HDA_MAX_NUM_INPUTS];
224 };
225 
226 int snd_hda_input_mux_info(const struct hda_input_mux *imux,
227 			   struct snd_ctl_elem_info *uinfo);
228 int snd_hda_input_mux_put(struct hda_codec *codec,
229 			  const struct hda_input_mux *imux,
230 			  struct snd_ctl_elem_value *ucontrol, hda_nid_t nid,
231 			  unsigned int *cur_val);
232 
233 /*
234  * Channel mode helper
235  */
236 struct hda_channel_mode {
237 	int channels;
238 	const struct hda_verb *sequence;
239 };
240 
241 int snd_hda_ch_mode_info(struct hda_codec *codec,
242 			 struct snd_ctl_elem_info *uinfo,
243 			 const struct hda_channel_mode *chmode,
244 			 int num_chmodes);
245 int snd_hda_ch_mode_get(struct hda_codec *codec,
246 			struct snd_ctl_elem_value *ucontrol,
247 			const struct hda_channel_mode *chmode,
248 			int num_chmodes,
249 			int max_channels);
250 int snd_hda_ch_mode_put(struct hda_codec *codec,
251 			struct snd_ctl_elem_value *ucontrol,
252 			const struct hda_channel_mode *chmode,
253 			int num_chmodes,
254 			int *max_channelsp);
255 
256 /*
257  * Multi-channel / digital-out PCM helper
258  */
259 
260 enum { HDA_FRONT, HDA_REAR, HDA_CLFE, HDA_SIDE }; /* index for dac_nidx */
261 enum { HDA_DIG_NONE, HDA_DIG_EXCLUSIVE, HDA_DIG_ANALOG_DUP }; /* dig_out_used */
262 
263 struct hda_multi_out {
264 	int num_dacs;		/* # of DACs, must be more than 1 */
265 	hda_nid_t *dac_nids;	/* DAC list */
266 	hda_nid_t hp_nid;	/* optional DAC for HP, 0 when not exists */
267 	hda_nid_t extra_out_nid[3];	/* optional DACs, 0 when not exists */
268 	hda_nid_t dig_out_nid;	/* digital out audio widget */
269 	hda_nid_t *slave_dig_outs;
270 	int max_channels;	/* currently supported analog channels */
271 	int dig_out_used;	/* current usage of digital out (HDA_DIG_XXX) */
272 	int no_share_stream;	/* don't share a stream with multiple pins */
273 	int share_spdif;	/* share SPDIF pin */
274 	/* PCM information for both analog and SPDIF DACs */
275 	unsigned int analog_rates;
276 	unsigned int analog_maxbps;
277 	u64 analog_formats;
278 	unsigned int spdif_rates;
279 	unsigned int spdif_maxbps;
280 	u64 spdif_formats;
281 };
282 
283 int snd_hda_create_spdif_share_sw(struct hda_codec *codec,
284 				  struct hda_multi_out *mout);
285 int snd_hda_multi_out_dig_open(struct hda_codec *codec,
286 			       struct hda_multi_out *mout);
287 int snd_hda_multi_out_dig_close(struct hda_codec *codec,
288 				struct hda_multi_out *mout);
289 int snd_hda_multi_out_dig_prepare(struct hda_codec *codec,
290 				  struct hda_multi_out *mout,
291 				  unsigned int stream_tag,
292 				  unsigned int format,
293 				  struct snd_pcm_substream *substream);
294 int snd_hda_multi_out_dig_cleanup(struct hda_codec *codec,
295 				  struct hda_multi_out *mout);
296 int snd_hda_multi_out_analog_open(struct hda_codec *codec,
297 				  struct hda_multi_out *mout,
298 				  struct snd_pcm_substream *substream,
299 				  struct hda_pcm_stream *hinfo);
300 int snd_hda_multi_out_analog_prepare(struct hda_codec *codec,
301 				     struct hda_multi_out *mout,
302 				     unsigned int stream_tag,
303 				     unsigned int format,
304 				     struct snd_pcm_substream *substream);
305 int snd_hda_multi_out_analog_cleanup(struct hda_codec *codec,
306 				     struct hda_multi_out *mout);
307 
308 /*
309  * generic codec parser
310  */
311 #ifdef CONFIG_SND_HDA_GENERIC
312 int snd_hda_parse_generic_codec(struct hda_codec *codec);
313 #else
314 static inline int snd_hda_parse_generic_codec(struct hda_codec *codec)
315 {
316 	return -ENODEV;
317 }
318 #endif
319 
320 /*
321  * generic proc interface
322  */
323 #ifdef CONFIG_PROC_FS
324 int snd_hda_codec_proc_new(struct hda_codec *codec);
325 #else
326 static inline int snd_hda_codec_proc_new(struct hda_codec *codec) { return 0; }
327 #endif
328 
329 #define SND_PRINT_RATES_ADVISED_BUFSIZE	80
330 void snd_print_pcm_rates(int pcm, char *buf, int buflen);
331 
332 #define SND_PRINT_BITS_ADVISED_BUFSIZE	16
333 void snd_print_pcm_bits(int pcm, char *buf, int buflen);
334 
335 /*
336  * Misc
337  */
338 int snd_hda_check_board_config(struct hda_codec *codec, int num_configs,
339 			       const char **modelnames,
340 			       const struct snd_pci_quirk *pci_list);
341 int snd_hda_check_board_codec_sid_config(struct hda_codec *codec,
342                                int num_configs, const char **models,
343                                const struct snd_pci_quirk *tbl);
344 int snd_hda_add_new_ctls(struct hda_codec *codec,
345 			 struct snd_kcontrol_new *knew);
346 
347 /*
348  * unsolicited event handler
349  */
350 
351 #define HDA_UNSOL_QUEUE_SIZE	64
352 
353 struct hda_bus_unsolicited {
354 	/* ring buffer */
355 	u32 queue[HDA_UNSOL_QUEUE_SIZE * 2];
356 	unsigned int rp, wp;
357 
358 	/* workqueue */
359 	struct work_struct work;
360 	struct hda_bus *bus;
361 };
362 
363 /*
364  * Helper for automatic pin configuration
365  */
366 
367 enum {
368 	AUTO_PIN_MIC,
369 	AUTO_PIN_FRONT_MIC,
370 	AUTO_PIN_LINE,
371 	AUTO_PIN_FRONT_LINE,
372 	AUTO_PIN_CD,
373 	AUTO_PIN_AUX,
374 	AUTO_PIN_LAST
375 };
376 
377 enum {
378 	AUTO_PIN_LINE_OUT,
379 	AUTO_PIN_SPEAKER_OUT,
380 	AUTO_PIN_HP_OUT
381 };
382 
383 extern const char *auto_pin_cfg_labels[AUTO_PIN_LAST];
384 
385 #define AUTO_CFG_MAX_OUTS	5
386 
387 struct auto_pin_cfg {
388 	int line_outs;
389 	/* sorted in the order of Front/Surr/CLFE/Side */
390 	hda_nid_t line_out_pins[AUTO_CFG_MAX_OUTS];
391 	int speaker_outs;
392 	hda_nid_t speaker_pins[AUTO_CFG_MAX_OUTS];
393 	int hp_outs;
394 	int line_out_type;	/* AUTO_PIN_XXX_OUT */
395 	hda_nid_t hp_pins[AUTO_CFG_MAX_OUTS];
396 	hda_nid_t input_pins[AUTO_PIN_LAST];
397 	int dig_outs;
398 	hda_nid_t dig_out_pins[2];
399 	hda_nid_t dig_in_pin;
400 	hda_nid_t mono_out_pin;
401 	int dig_out_type[2]; /* HDA_PCM_TYPE_XXX */
402 	int dig_in_type; /* HDA_PCM_TYPE_XXX */
403 };
404 
405 #define get_defcfg_connect(cfg) \
406 	((cfg & AC_DEFCFG_PORT_CONN) >> AC_DEFCFG_PORT_CONN_SHIFT)
407 #define get_defcfg_association(cfg) \
408 	((cfg & AC_DEFCFG_DEF_ASSOC) >> AC_DEFCFG_ASSOC_SHIFT)
409 #define get_defcfg_location(cfg) \
410 	((cfg & AC_DEFCFG_LOCATION) >> AC_DEFCFG_LOCATION_SHIFT)
411 #define get_defcfg_sequence(cfg) \
412 	(cfg & AC_DEFCFG_SEQUENCE)
413 #define get_defcfg_device(cfg) \
414 	((cfg & AC_DEFCFG_DEVICE) >> AC_DEFCFG_DEVICE_SHIFT)
415 
416 int snd_hda_parse_pin_def_config(struct hda_codec *codec,
417 				 struct auto_pin_cfg *cfg,
418 				 hda_nid_t *ignore_nids);
419 
420 /* amp values */
421 #define AMP_IN_MUTE(idx)	(0x7080 | ((idx)<<8))
422 #define AMP_IN_UNMUTE(idx)	(0x7000 | ((idx)<<8))
423 #define AMP_OUT_MUTE		0xb080
424 #define AMP_OUT_UNMUTE		0xb000
425 #define AMP_OUT_ZERO		0xb000
426 /* pinctl values */
427 #define PIN_IN			(AC_PINCTL_IN_EN)
428 #define PIN_VREFHIZ		(AC_PINCTL_IN_EN | AC_PINCTL_VREF_HIZ)
429 #define PIN_VREF50		(AC_PINCTL_IN_EN | AC_PINCTL_VREF_50)
430 #define PIN_VREFGRD		(AC_PINCTL_IN_EN | AC_PINCTL_VREF_GRD)
431 #define PIN_VREF80		(AC_PINCTL_IN_EN | AC_PINCTL_VREF_80)
432 #define PIN_VREF100		(AC_PINCTL_IN_EN | AC_PINCTL_VREF_100)
433 #define PIN_OUT			(AC_PINCTL_OUT_EN)
434 #define PIN_HP			(AC_PINCTL_OUT_EN | AC_PINCTL_HP_EN)
435 #define PIN_HP_AMP		(AC_PINCTL_HP_EN)
436 
437 /*
438  * get widget capabilities
439  */
440 static inline u32 get_wcaps(struct hda_codec *codec, hda_nid_t nid)
441 {
442 	if (nid < codec->start_nid ||
443 	    nid >= codec->start_nid + codec->num_nodes)
444 		return 0;
445 	return codec->wcaps[nid - codec->start_nid];
446 }
447 
448 /* get the widget type from widget capability bits */
449 #define get_wcaps_type(wcaps) (((wcaps) & AC_WCAP_TYPE) >> AC_WCAP_TYPE_SHIFT)
450 
451 static inline unsigned int get_wcaps_channels(u32 wcaps)
452 {
453 	unsigned int chans;
454 
455 	chans = (wcaps & AC_WCAP_CHAN_CNT_EXT) >> 13;
456 	chans = ((chans << 1) | 1) + 1;
457 
458 	return chans;
459 }
460 
461 u32 query_amp_caps(struct hda_codec *codec, hda_nid_t nid, int direction);
462 int snd_hda_override_amp_caps(struct hda_codec *codec, hda_nid_t nid, int dir,
463 			      unsigned int caps);
464 u32 snd_hda_query_pin_caps(struct hda_codec *codec, hda_nid_t nid);
465 u32 snd_hda_pin_sense(struct hda_codec *codec, hda_nid_t nid);
466 int snd_hda_jack_detect(struct hda_codec *codec, hda_nid_t nid);
467 
468 /* flags for hda_nid_item */
469 #define HDA_NID_ITEM_AMP	(1<<0)
470 
471 struct hda_nid_item {
472 	struct snd_kcontrol *kctl;
473 	unsigned int index;
474 	hda_nid_t nid;
475 	unsigned short flags;
476 };
477 
478 int snd_hda_ctl_add(struct hda_codec *codec, hda_nid_t nid,
479 		    struct snd_kcontrol *kctl);
480 int snd_hda_add_nid(struct hda_codec *codec, struct snd_kcontrol *kctl,
481 		    unsigned int index, hda_nid_t nid);
482 void snd_hda_ctls_clear(struct hda_codec *codec);
483 
484 /*
485  * hwdep interface
486  */
487 #ifdef CONFIG_SND_HDA_HWDEP
488 int snd_hda_create_hwdep(struct hda_codec *codec);
489 #else
490 static inline int snd_hda_create_hwdep(struct hda_codec *codec) { return 0; }
491 #endif
492 
493 #if defined(CONFIG_SND_HDA_POWER_SAVE) && defined(CONFIG_SND_HDA_HWDEP)
494 int snd_hda_hwdep_add_power_sysfs(struct hda_codec *codec);
495 #else
496 static inline int snd_hda_hwdep_add_power_sysfs(struct hda_codec *codec)
497 {
498 	return 0;
499 }
500 #endif
501 
502 #ifdef CONFIG_SND_HDA_RECONFIG
503 int snd_hda_hwdep_add_sysfs(struct hda_codec *codec);
504 #else
505 static inline int snd_hda_hwdep_add_sysfs(struct hda_codec *codec)
506 {
507 	return 0;
508 }
509 #endif
510 
511 #ifdef CONFIG_SND_HDA_RECONFIG
512 const char *snd_hda_get_hint(struct hda_codec *codec, const char *key);
513 int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key);
514 #else
515 static inline
516 const char *snd_hda_get_hint(struct hda_codec *codec, const char *key)
517 {
518 	return NULL;
519 }
520 
521 static inline
522 int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key)
523 {
524 	return -ENOENT;
525 }
526 #endif
527 
528 /*
529  * power-management
530  */
531 
532 #ifdef CONFIG_SND_HDA_POWER_SAVE
533 void snd_hda_schedule_power_save(struct hda_codec *codec);
534 
535 struct hda_amp_list {
536 	hda_nid_t nid;
537 	unsigned char dir;
538 	unsigned char idx;
539 };
540 
541 struct hda_loopback_check {
542 	struct hda_amp_list *amplist;
543 	int power_on;
544 };
545 
546 int snd_hda_check_amp_list_power(struct hda_codec *codec,
547 				 struct hda_loopback_check *check,
548 				 hda_nid_t nid);
549 #endif /* CONFIG_SND_HDA_POWER_SAVE */
550 
551 /*
552  * AMP control callbacks
553  */
554 /* retrieve parameters from private_value */
555 #define get_amp_nid_(pv)	((pv) & 0xffff)
556 #define get_amp_nid(kc)		get_amp_nid_((kc)->private_value)
557 #define get_amp_channels(kc)	(((kc)->private_value >> 16) & 0x3)
558 #define get_amp_direction(kc)	(((kc)->private_value >> 18) & 0x1)
559 #define get_amp_index(kc)	(((kc)->private_value >> 19) & 0xf)
560 #define get_amp_offset(kc)	(((kc)->private_value >> 23) & 0x3f)
561 
562 /*
563  * CEA Short Audio Descriptor data
564  */
565 struct cea_sad {
566 	int	channels;
567 	int	format;		/* (format == 0) indicates invalid SAD */
568 	int	rates;
569 	int	sample_bits;	/* for LPCM */
570 	int	max_bitrate;	/* for AC3...ATRAC */
571 	int	profile;	/* for WMAPRO */
572 };
573 
574 #define ELD_FIXED_BYTES	20
575 #define ELD_MAX_MNL	16
576 #define ELD_MAX_SAD	16
577 
578 /*
579  * ELD: EDID Like Data
580  */
581 struct hdmi_eld {
582 	bool	monitor_present;
583 	bool	eld_valid;
584 	int	eld_size;
585 	int	baseline_len;
586 	int	eld_ver;
587 	int	cea_edid_ver;
588 	char	monitor_name[ELD_MAX_MNL + 1];
589 	int	manufacture_id;
590 	int	product_id;
591 	u64	port_id;
592 	int	support_hdcp;
593 	int	support_ai;
594 	int	conn_type;
595 	int	aud_synch_delay;
596 	int	spk_alloc;
597 	int	sad_count;
598 	struct cea_sad sad[ELD_MAX_SAD];
599 #ifdef CONFIG_PROC_FS
600 	struct snd_info_entry *proc_entry;
601 #endif
602 };
603 
604 int snd_hdmi_get_eld_size(struct hda_codec *codec, hda_nid_t nid);
605 int snd_hdmi_get_eld(struct hdmi_eld *, struct hda_codec *, hda_nid_t);
606 void snd_hdmi_show_eld(struct hdmi_eld *eld);
607 
608 #ifdef CONFIG_PROC_FS
609 int snd_hda_eld_proc_new(struct hda_codec *codec, struct hdmi_eld *eld,
610 			 int index);
611 void snd_hda_eld_proc_free(struct hda_codec *codec, struct hdmi_eld *eld);
612 #else
613 static inline int snd_hda_eld_proc_new(struct hda_codec *codec,
614 				       struct hdmi_eld *eld,
615 				       int index)
616 {
617 	return 0;
618 }
619 static inline void snd_hda_eld_proc_free(struct hda_codec *codec,
620 					 struct hdmi_eld *eld)
621 {
622 }
623 #endif
624 
625 #define SND_PRINT_CHANNEL_ALLOCATION_ADVISED_BUFSIZE 80
626 void snd_print_channel_allocation(int spk_alloc, char *buf, int buflen);
627 
628 #endif /* __SOUND_HDA_LOCAL_H */
629