projects / linux-2.6-block.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Merge branch 'fix/hda' into topic/hda
[linux-2.6-block.git] / sound / pci / hda / hda_local.h
CommitLineData
1da177e4
LT		 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
9c96fa59
TI		 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)
9e3fd871 34#define HDA_SUBDEV_AMP_FLAG (1U << 30)
9c96fa59 35
1da177e4
LT		 36/*
37 * for mixer controls
38 */
29fdbec2
TI		 39#define HDA_COMPOSE_AMP_VAL_OFS(nid,chs,idx,dir,ofs) \
40 ((nid) | ((chs)<<16) | ((dir)<<18) | ((idx)<<19) | ((ofs)<<23))
de8c85f7 41#define HDA_AMP_VAL_MIN_MUTE (1<<29)
d01ce99f 42#define HDA_COMPOSE_AMP_VAL(nid,chs,idx,dir) \
29fdbec2 43 HDA_COMPOSE_AMP_VAL_OFS(nid, chs, idx, dir, 0)
985be54b 44/* mono volume with index (index=0,1,...) (channel=1,2) */
de8c85f7 45#define HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, channel, xindex, dir, flags) \
1da177e4 46 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
5e26dfd0 47 .subdevice = HDA_SUBDEV_AMP_FLAG, \
302e9c5a
JK		 48 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | \
49 SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
50 SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK, \
1da177e4
LT		 51 .info = snd_hda_mixer_amp_volume_info, \
52 .get = snd_hda_mixer_amp_volume_get, \
53 .put = snd_hda_mixer_amp_volume_put, \
7cf0a953 54 .tlv = { .c = snd_hda_mixer_amp_tlv }, \
de8c85f7 55 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, dir) | flags }
985be54b 56/* stereo volume with index */
1da177e4 57#define HDA_CODEC_VOLUME_IDX(xname, xcidx, nid, xindex, direction) \
de8c85f7 58 HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, 3, xindex, direction, 0)
985be54b 59/* mono volume */
1da177e4 60#define HDA_CODEC_VOLUME_MONO(xname, nid, channel, xindex, direction) \
de8c85f7 61 HDA_CODEC_VOLUME_MONO_IDX(xname, 0, nid, channel, xindex, direction, 0)
985be54b 62/* stereo volume */
1da177e4
LT		 63#define HDA_CODEC_VOLUME(xname, nid, xindex, direction) \
64 HDA_CODEC_VOLUME_MONO(xname, nid, 3, xindex, direction)
de8c85f7
CL		 65/* stereo volume with min=mute */
66#define HDA_CODEC_VOLUME_MIN_MUTE(xname, nid, xindex, direction) \
67 HDA_CODEC_VOLUME_MONO_IDX(xname, 0, nid, 3, xindex, direction, \
68 HDA_AMP_VAL_MIN_MUTE)
985be54b 69/* mono mute switch with index (index=0,1,...) (channel=1,2) */
1da177e4
LT		 70#define HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
71 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
5e26dfd0 72 .subdevice = HDA_SUBDEV_AMP_FLAG, \
1da177e4
LT		 73 .info = snd_hda_mixer_amp_switch_info, \
74 .get = snd_hda_mixer_amp_switch_get, \
75 .put = snd_hda_mixer_amp_switch_put, \
76 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
985be54b 77/* stereo mute switch with index */
1da177e4
LT		 78#define HDA_CODEC_MUTE_IDX(xname, xcidx, nid, xindex, direction) \
79 HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)
985be54b 80/* mono mute switch */
1da177e4
LT		 81#define HDA_CODEC_MUTE_MONO(xname, nid, channel, xindex, direction) \
82 HDA_CODEC_MUTE_MONO_IDX(xname, 0, nid, channel, xindex, direction)
985be54b 83/* stereo mute switch */
1da177e4
LT		 84#define HDA_CODEC_MUTE(xname, nid, xindex, direction) \
85 HDA_CODEC_MUTE_MONO(xname, nid, 3, xindex, direction)
67d634c0 86#ifdef CONFIG_SND_HDA_INPUT_BEEP
123c07ae
JK		 87/* special beep mono mute switch with index (index=0,1,...) (channel=1,2) */
88#define HDA_CODEC_MUTE_BEEP_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
89 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
5e26dfd0 90 .subdevice = HDA_SUBDEV_AMP_FLAG, \
123c07ae
JK		 91 .info = snd_hda_mixer_amp_switch_info, \
92 .get = snd_hda_mixer_amp_switch_get, \
93 .put = snd_hda_mixer_amp_switch_put_beep, \
94 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
67d634c0
TI		 95#else
96/* no digital beep - just the standard one */
97#define HDA_CODEC_MUTE_BEEP_MONO_IDX(xname, xcidx, nid, ch, xidx, dir) \
98 HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, ch, xidx, dir)
99#endif /* CONFIG_SND_HDA_INPUT_BEEP */
123c07ae
JK		 100/* special beep mono mute switch */
101#define HDA_CODEC_MUTE_BEEP_MONO(xname, nid, channel, xindex, direction) \
102 HDA_CODEC_MUTE_BEEP_MONO_IDX(xname, 0, nid, channel, xindex, direction)
103/* special beep stereo mute switch */
104#define HDA_CODEC_MUTE_BEEP(xname, nid, xindex, direction) \
105 HDA_CODEC_MUTE_BEEP_MONO(xname, nid, 3, xindex, direction)
1da177e4 106
85dd662f
JK		 107extern const char *snd_hda_pcm_type_name[];
108
d01ce99f
TI		 109int snd_hda_mixer_amp_volume_info(struct snd_kcontrol *kcontrol,
110 struct snd_ctl_elem_info *uinfo);
111int snd_hda_mixer_amp_volume_get(struct snd_kcontrol *kcontrol,
112 struct snd_ctl_elem_value *ucontrol);
113int snd_hda_mixer_amp_volume_put(struct snd_kcontrol *kcontrol,
114 struct snd_ctl_elem_value *ucontrol);
115int snd_hda_mixer_amp_tlv(struct snd_kcontrol *kcontrol, int op_flag,
116 unsigned int size, unsigned int __user *tlv);
117int snd_hda_mixer_amp_switch_info(struct snd_kcontrol *kcontrol,
118 struct snd_ctl_elem_info *uinfo);
119int snd_hda_mixer_amp_switch_get(struct snd_kcontrol *kcontrol,
120 struct snd_ctl_elem_value *ucontrol);
121int snd_hda_mixer_amp_switch_put(struct snd_kcontrol *kcontrol,
122 struct snd_ctl_elem_value *ucontrol);
67d634c0 123#ifdef CONFIG_SND_HDA_INPUT_BEEP
123c07ae
JK		 124int snd_hda_mixer_amp_switch_put_beep(struct snd_kcontrol *kcontrol,
125 struct snd_ctl_elem_value *ucontrol);
67d634c0 126#endif
834be88d
TI		 127/* lowlevel accessor with caching; use carefully */
128int snd_hda_codec_amp_read(struct hda_codec *codec, hda_nid_t nid, int ch,
129 int direction, int index);
130int snd_hda_codec_amp_update(struct hda_codec *codec, hda_nid_t nid, int ch,
131 int direction, int idx, int mask, int val);
47fd830a
TI		 132int snd_hda_codec_amp_stereo(struct hda_codec *codec, hda_nid_t nid,
133 int dir, int idx, int mask, int val);
2a43952a 134#ifdef CONFIG_PM
b3ac5636 135void snd_hda_codec_resume_amp(struct hda_codec *codec);
82beb8fd 136#endif
1da177e4 137
2134ea4f
TI		 138void snd_hda_set_vmaster_tlv(struct hda_codec *codec, hda_nid_t nid, int dir,
139 unsigned int *tlv);
140struct snd_kcontrol *snd_hda_find_mixer_ctl(struct hda_codec *codec,
141 const char *name);
18478e8b 142int __snd_hda_add_vmaster(struct hda_codec *codec, char *name,
29e5853d
TI		 143 unsigned int *tlv, const char * const *slaves,
144 const char *suffix, bool init_slave_vol,
145 struct snd_kcontrol **ctl_ret);
18478e8b 146#define snd_hda_add_vmaster(codec, name, tlv, slaves, suffix) \
29e5853d 147 __snd_hda_add_vmaster(codec, name, tlv, slaves, suffix, true, NULL)
a65d629c 148int snd_hda_codec_reset(struct hda_codec *codec);
2134ea4f 149
d2f344b5
TI		 150enum {
151 HDA_VMUTE_OFF,
152 HDA_VMUTE_ON,
153 HDA_VMUTE_FOLLOW_MASTER,
154};
155
156struct hda_vmaster_mute_hook {
157 /* below two fields must be filled by the caller of
158 * snd_hda_add_vmaster_hook() beforehand
159 */
160 struct snd_kcontrol *sw_kctl;
161 void (*hook)(void *, int);
162 /* below are initialized automatically */
163 unsigned int mute_mode; /* HDA_VMUTE_XXX */
164 struct hda_codec *codec;
165};
166
167int snd_hda_add_vmaster_hook(struct hda_codec *codec,
f29735cb
TI		 168 struct hda_vmaster_mute_hook *hook,
169 bool expose_enum_ctl);
d2f344b5
TI		 170void snd_hda_sync_vmaster_hook(struct hda_vmaster_mute_hook *hook);
171
47fd830a
TI		 172/* amp value bits */
173#define HDA_AMP_MUTE 0x80
174#define HDA_AMP_UNMUTE 0x00
175#define HDA_AMP_VOLMASK 0x7f
176
985be54b
TI		 177/* mono switch binding multiple inputs */
178#define HDA_BIND_MUTE_MONO(xname, nid, channel, indices, direction) \
179 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = 0, \
180 .info = snd_hda_mixer_amp_switch_info, \
181 .get = snd_hda_mixer_bind_switch_get, \
182 .put = snd_hda_mixer_bind_switch_put, \
183 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, indices, direction) }
184
185/* stereo switch binding multiple inputs */
d01ce99f
TI		 186#define HDA_BIND_MUTE(xname,nid,indices,dir) \
187 HDA_BIND_MUTE_MONO(xname,nid,3,indices,dir)
985be54b 188
d01ce99f
TI		 189int snd_hda_mixer_bind_switch_get(struct snd_kcontrol *kcontrol,
190 struct snd_ctl_elem_value *ucontrol);
191int snd_hda_mixer_bind_switch_put(struct snd_kcontrol *kcontrol,
192 struct snd_ctl_elem_value *ucontrol);
985be54b 193
532d5381
TI		 194/* more generic bound controls */
195struct hda_ctl_ops {
196 snd_kcontrol_info_t *info;
197 snd_kcontrol_get_t *get;
198 snd_kcontrol_put_t *put;
199 snd_kcontrol_tlv_rw_t *tlv;
200};
201
202extern struct hda_ctl_ops snd_hda_bind_vol; /* for bind-volume with TLV */
203extern struct hda_ctl_ops snd_hda_bind_sw; /* for bind-switch */
204
205struct hda_bind_ctls {
206 struct hda_ctl_ops *ops;
5d9b6c07 207 unsigned long values[];
532d5381
TI		 208};
209
210int snd_hda_mixer_bind_ctls_info(struct snd_kcontrol *kcontrol,
211 struct snd_ctl_elem_info *uinfo);
212int snd_hda_mixer_bind_ctls_get(struct snd_kcontrol *kcontrol,
213 struct snd_ctl_elem_value *ucontrol);
214int snd_hda_mixer_bind_ctls_put(struct snd_kcontrol *kcontrol,
215 struct snd_ctl_elem_value *ucontrol);
216int snd_hda_mixer_bind_tlv(struct snd_kcontrol *kcontrol, int op_flag,
217 unsigned int size, unsigned int __user *tlv);
218
219#define HDA_BIND_VOL(xname, bindrec) \
220 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \
221 .name = xname, \
222 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE |\
223 SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
224 SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK,\
225 .info = snd_hda_mixer_bind_ctls_info,\
226 .get = snd_hda_mixer_bind_ctls_get,\
227 .put = snd_hda_mixer_bind_ctls_put,\
228 .tlv = { .c = snd_hda_mixer_bind_tlv },\
229 .private_value = (long) (bindrec) }
230#define HDA_BIND_SW(xname, bindrec) \
231 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER,\
232 .name = xname, \
233 .info = snd_hda_mixer_bind_ctls_info,\
234 .get = snd_hda_mixer_bind_ctls_get,\
235 .put = snd_hda_mixer_bind_ctls_put,\
236 .private_value = (long) (bindrec) }
237
238/*
239 * SPDIF I/O
240 */
74b654c9
SW		 241int snd_hda_create_spdif_out_ctls(struct hda_codec *codec,
242 hda_nid_t associated_nid,
243 hda_nid_t cvt_nid);
1da177e4
LT		 244int snd_hda_create_spdif_in_ctls(struct hda_codec *codec, hda_nid_t nid);
245
246/*
247 * input MUX helper
248 */
54d17403 249#define HDA_MAX_NUM_INPUTS 16
1da177e4 250struct hda_input_mux_item {
b5786e85 251 char label[32];
1da177e4
LT		 252 unsigned int index;
253};
254struct hda_input_mux {
255 unsigned int num_items;
256 struct hda_input_mux_item items[HDA_MAX_NUM_INPUTS];
257};
258
d01ce99f
TI		 259int snd_hda_input_mux_info(const struct hda_input_mux *imux,
260 struct snd_ctl_elem_info *uinfo);
261int snd_hda_input_mux_put(struct hda_codec *codec,
262 const struct hda_input_mux *imux,
c8b6bf9b 263 struct snd_ctl_elem_value *ucontrol, hda_nid_t nid,
1da177e4
LT		 264 unsigned int *cur_val);
265
c8b6bf9b 266/*
d2a6d7dc
TI		 267 * Channel mode helper
268 */
269struct hda_channel_mode {
270 int channels;
271 const struct hda_verb *sequence;
272};
273
d01ce99f
TI		 274int snd_hda_ch_mode_info(struct hda_codec *codec,
275 struct snd_ctl_elem_info *uinfo,
276 const struct hda_channel_mode *chmode,
277 int num_chmodes);
278int snd_hda_ch_mode_get(struct hda_codec *codec,
279 struct snd_ctl_elem_value *ucontrol,
280 const struct hda_channel_mode *chmode,
281 int num_chmodes,
d2a6d7dc 282 int max_channels);
d01ce99f
TI		 283int snd_hda_ch_mode_put(struct hda_codec *codec,
284 struct snd_ctl_elem_value *ucontrol,
285 const struct hda_channel_mode *chmode,
286 int num_chmodes,
d2a6d7dc
TI		 287 int *max_channelsp);
288
1da177e4
LT		 289/*
290 * Multi-channel / digital-out PCM helper
291 */
292
293enum { HDA_FRONT, HDA_REAR, HDA_CLFE, HDA_SIDE }; /* index for dac_nidx */
294enum { HDA_DIG_NONE, HDA_DIG_EXCLUSIVE, HDA_DIG_ANALOG_DUP }; /* dig_out_used */
295
a06dbfc2
TI		 296#define HDA_MAX_OUTS 5
297
1da177e4
LT		 298struct hda_multi_out {
299 int num_dacs; /* # of DACs, must be more than 1 */
dda14410 300 const hda_nid_t *dac_nids; /* DAC list */
1da177e4 301 hda_nid_t hp_nid; /* optional DAC for HP, 0 when not exists */
a06dbfc2
TI		 302 hda_nid_t hp_out_nid[HDA_MAX_OUTS]; /* DACs for multiple HPs */
303 hda_nid_t extra_out_nid[HDA_MAX_OUTS]; /* other (e.g. speaker) DACs */
1da177e4 304 hda_nid_t dig_out_nid; /* digital out audio widget */
dda14410 305 const hda_nid_t *slave_dig_outs;
1da177e4
LT		 306 int max_channels; /* currently supported analog channels */
307 int dig_out_used; /* current usage of digital out (HDA_DIG_XXX) */
d29240ce 308 int no_share_stream; /* don't share a stream with multiple pins */
9a08160b
TI		 309 int share_spdif; /* share SPDIF pin */
310 /* PCM information for both analog and SPDIF DACs */
311 unsigned int analog_rates;
312 unsigned int analog_maxbps;
313 u64 analog_formats;
314 unsigned int spdif_rates;
315 unsigned int spdif_maxbps;
316 u64 spdif_formats;
1da177e4
LT		 317};
318
9a08160b
TI		 319int snd_hda_create_spdif_share_sw(struct hda_codec *codec,
320 struct hda_multi_out *mout);
d01ce99f
TI		 321int snd_hda_multi_out_dig_open(struct hda_codec *codec,
322 struct hda_multi_out *mout);
323int snd_hda_multi_out_dig_close(struct hda_codec *codec,
324 struct hda_multi_out *mout);
6b97eb45
TI		 325int snd_hda_multi_out_dig_prepare(struct hda_codec *codec,
326 struct hda_multi_out *mout,
327 unsigned int stream_tag,
328 unsigned int format,
329 struct snd_pcm_substream *substream);
9411e21c
TI		 330int snd_hda_multi_out_dig_cleanup(struct hda_codec *codec,
331 struct hda_multi_out *mout);
d01ce99f
TI		 332int snd_hda_multi_out_analog_open(struct hda_codec *codec,
333 struct hda_multi_out *mout,
9a08160b
TI		 334 struct snd_pcm_substream *substream,
335 struct hda_pcm_stream *hinfo);
d01ce99f
TI		 336int snd_hda_multi_out_analog_prepare(struct hda_codec *codec,
337 struct hda_multi_out *mout,
1da177e4
LT		 338 unsigned int stream_tag,
339 unsigned int format,
c8b6bf9b 340 struct snd_pcm_substream *substream);
d01ce99f
TI		 341int snd_hda_multi_out_analog_cleanup(struct hda_codec *codec,
342 struct hda_multi_out *mout);
1da177e4
LT		 343
344/*
345 * generic codec parser
346 */
35a1e0cc 347#ifdef CONFIG_SND_HDA_GENERIC
1da177e4 348int snd_hda_parse_generic_codec(struct hda_codec *codec);
35a1e0cc
TI		 349#else
350static inline int snd_hda_parse_generic_codec(struct hda_codec *codec)
351{
352 return -ENODEV;
353}
354#endif
1da177e4
LT		 355
356/*
357 * generic proc interface
358 */
359#ifdef CONFIG_PROC_FS
360int snd_hda_codec_proc_new(struct hda_codec *codec);
361#else
362static inline int snd_hda_codec_proc_new(struct hda_codec *codec) { return 0; }
363#endif
364
d39b4352
WF		 365#define SND_PRINT_BITS_ADVISED_BUFSIZE 16
366void snd_print_pcm_bits(int pcm, char *buf, int buflen);
367
1da177e4
LT		 368/*
369 * Misc
370 */
f5fcc13c 371int snd_hda_check_board_config(struct hda_codec *codec, int num_configs,
ea734963 372 const char * const *modelnames,
f5fcc13c 373 const struct snd_pci_quirk *pci_list);
2eda3445 374int snd_hda_check_board_codec_sid_config(struct hda_codec *codec,
ea734963 375 int num_configs, const char * const *models,
2eda3445 376 const struct snd_pci_quirk *tbl);
d01ce99f 377int snd_hda_add_new_ctls(struct hda_codec *codec,
031024ee 378 const struct snd_kcontrol_new *knew);
1da177e4 379
1da177e4
LT		 380/*
381 * unsolicited event handler
382 */
383
384#define HDA_UNSOL_QUEUE_SIZE 64
385
386struct hda_bus_unsolicited {
387 /* ring buffer */
388 u32 queue[HDA_UNSOL_QUEUE_SIZE * 2];
389 unsigned int rp, wp;
390
391 /* workqueue */
1da177e4 392 struct work_struct work;
c4028958 393 struct hda_bus *bus;
1da177e4
LT		 394};
395
e9edcee0 396/*
b7a5633a 397 * Helper for automatic pin configuration
e9edcee0
TI		 398 */
399
400enum {
401 AUTO_PIN_MIC,
86e2959a 402 AUTO_PIN_LINE_IN,
e9edcee0
TI		 403 AUTO_PIN_CD,
404 AUTO_PIN_AUX,
405 AUTO_PIN_LAST
406};
407
d258e24a
TI		 408enum {
409 AUTO_PIN_LINE_OUT,
410 AUTO_PIN_SPEAKER_OUT,
411 AUTO_PIN_HP_OUT
412};
413
a06dbfc2 414#define AUTO_CFG_MAX_OUTS HDA_MAX_OUTS
75e0eb24
TI		 415#define AUTO_CFG_MAX_INS 8
416
417struct auto_pin_cfg_item {
418 hda_nid_t pin;
419 int type;
420};
421
422struct auto_pin_cfg;
10a20af7
TI		 423const char *hda_get_autocfg_input_label(struct hda_codec *codec,
424 const struct auto_pin_cfg *cfg,
425 int input);
201e06ff
TI		 426int snd_hda_get_pin_label(struct hda_codec *codec, hda_nid_t nid,
427 const struct auto_pin_cfg *cfg,
428 char *label, int maxlen, int *indexp);
10a20af7
TI		 429int snd_hda_add_imux_item(struct hda_input_mux *imux, const char *label,
430 int index, int *type_index_ret);
41923e44 431
99ae28be
TI		 432enum {
433 INPUT_PIN_ATTR_UNUSED, /* pin not connected */
434 INPUT_PIN_ATTR_INT, /* internal mic/line-in */
435 INPUT_PIN_ATTR_DOCK, /* docking mic/line-in */
436 INPUT_PIN_ATTR_NORMAL, /* mic/line-in jack */
437 INPUT_PIN_ATTR_FRONT, /* mic/line-in jack in front */
438 INPUT_PIN_ATTR_REAR, /* mic/line-in jack in rear */
439};
440
441int snd_hda_get_input_pin_attr(unsigned int def_conf);
442
e9edcee0
TI		 443struct auto_pin_cfg {
444 int line_outs;
41923e44
TI		 445 /* sorted in the order of Front/Surr/CLFE/Side */
446 hda_nid_t line_out_pins[AUTO_CFG_MAX_OUTS];
82bc955f 447 int speaker_outs;
41923e44 448 hda_nid_t speaker_pins[AUTO_CFG_MAX_OUTS];
eb06ed8f 449 int hp_outs;
d258e24a 450 int line_out_type; /* AUTO_PIN_XXX_OUT */
41923e44 451 hda_nid_t hp_pins[AUTO_CFG_MAX_OUTS];
75e0eb24
TI		 452 int num_inputs;
453 struct auto_pin_cfg_item inputs[AUTO_CFG_MAX_INS];
0852d7a6
TI		 454 int dig_outs;
455 hda_nid_t dig_out_pins[2];
e9edcee0 456 hda_nid_t dig_in_pin;
90da78bf 457 hda_nid_t mono_out_pin;
0852d7a6 458 int dig_out_type[2]; /* HDA_PCM_TYPE_XXX */
2297bd6e 459 int dig_in_type; /* HDA_PCM_TYPE_XXX */
e9edcee0
TI		 460};
461
d01ce99f
TI		 462#define get_defcfg_connect(cfg) \
463 ((cfg & AC_DEFCFG_PORT_CONN) >> AC_DEFCFG_PORT_CONN_SHIFT)
464#define get_defcfg_association(cfg) \
465 ((cfg & AC_DEFCFG_DEF_ASSOC) >> AC_DEFCFG_ASSOC_SHIFT)
466#define get_defcfg_location(cfg) \
467 ((cfg & AC_DEFCFG_LOCATION) >> AC_DEFCFG_LOCATION_SHIFT)
468#define get_defcfg_sequence(cfg) \
469 (cfg & AC_DEFCFG_SEQUENCE)
470#define get_defcfg_device(cfg) \
471 ((cfg & AC_DEFCFG_DEVICE) >> AC_DEFCFG_DEVICE_SHIFT)
08a1f5eb
TI		 472#define get_defcfg_misc(cfg) \
473 ((cfg & AC_DEFCFG_MISC) >> AC_DEFCFG_MISC_SHIFT)
d01ce99f 474
d025febc
TI		 475/* bit-flags for snd_hda_parse_pin_def_config() behavior */
476#define HDA_PINCFG_NO_HP_FIXUP (1 << 0) /* no HP-split */
477#define HDA_PINCFG_NO_LO_FIXUP (1 << 1) /* don't take other outs as LO */
478
479int snd_hda_parse_pin_defcfg(struct hda_codec *codec,
480 struct auto_pin_cfg *cfg,
481 const hda_nid_t *ignore_nids,
482 unsigned int cond_flags);
483
484/* older function */
485#define snd_hda_parse_pin_def_config(codec, cfg, ignore) \
486 snd_hda_parse_pin_defcfg(codec, cfg, ignore, 0)
e9edcee0 487
8d88bc3d
TI		 488/* amp values */
489#define AMP_IN_MUTE(idx) (0x7080 | ((idx)<<8))
490#define AMP_IN_UNMUTE(idx) (0x7000 | ((idx)<<8))
d301fc32
TI		 491#define AMP_OUT_MUTE 0xb080
492#define AMP_OUT_UNMUTE 0xb000
493#define AMP_OUT_ZERO 0xb000
8d88bc3d 494/* pinctl values */
35e8901e 495#define PIN_IN (AC_PINCTL_IN_EN)
d301fc32 496#define PIN_VREFHIZ (AC_PINCTL_IN_EN | AC_PINCTL_VREF_HIZ)
35e8901e 497#define PIN_VREF50 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_50)
d301fc32 498#define PIN_VREFGRD (AC_PINCTL_IN_EN | AC_PINCTL_VREF_GRD)
35e8901e 499#define PIN_VREF80 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_80)
d301fc32
TI		 500#define PIN_VREF100 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_100)
501#define PIN_OUT (AC_PINCTL_OUT_EN)
35e8901e
RJ		 502#define PIN_HP (AC_PINCTL_OUT_EN | AC_PINCTL_HP_EN)
503#define PIN_HP_AMP (AC_PINCTL_HP_EN)
8d88bc3d 504
54d17403
TI		 505/*
506 * get widget capabilities
507 */
508static inline u32 get_wcaps(struct hda_codec *codec, hda_nid_t nid)
509{
510 if (nid < codec->start_nid ||
511 nid >= codec->start_nid + codec->num_nodes)
dca008f3 512 return 0;
54d17403
TI		 513 return codec->wcaps[nid - codec->start_nid];
514}
515
a22d543a 516/* get the widget type from widget capability bits */
3a90274d
TI		 517static inline int get_wcaps_type(unsigned int wcaps)
518{
519 if (!wcaps)
520 return -1; /* invalid type */
521 return (wcaps & AC_WCAP_TYPE) >> AC_WCAP_TYPE_SHIFT;
522}
a22d543a 523
fd72d008
WF		 524static inline unsigned int get_wcaps_channels(u32 wcaps)
525{
526 unsigned int chans;
527
528 chans = (wcaps & AC_WCAP_CHAN_CNT_EXT) >> 13;
529 chans = ((chans << 1) | 1) + 1;
530
531 return chans;
532}
533
09a99959 534u32 query_amp_caps(struct hda_codec *codec, hda_nid_t nid, int direction);
897cc188
TI		 535int snd_hda_override_amp_caps(struct hda_codec *codec, hda_nid_t nid, int dir,
536 unsigned int caps);
1327a32b 537u32 snd_hda_query_pin_caps(struct hda_codec *codec, hda_nid_t nid);
f57c2565
TI		 538int snd_hda_override_pin_caps(struct hda_codec *codec, hda_nid_t nid,
539 unsigned int caps);
03697e2a 540
9e3fd871
JK		 541/* flags for hda_nid_item */
542#define HDA_NID_ITEM_AMP (1<<0)
543
3911a4c1
JK		 544struct hda_nid_item {
545 struct snd_kcontrol *kctl;
5b0cb1d8 546 unsigned int index;
3911a4c1 547 hda_nid_t nid;
9e3fd871 548 unsigned short flags;
3911a4c1
JK		 549};
550
551int snd_hda_ctl_add(struct hda_codec *codec, hda_nid_t nid,
552 struct snd_kcontrol *kctl);
5b0cb1d8
JK		 553int snd_hda_add_nid(struct hda_codec *codec, struct snd_kcontrol *kctl,
554 unsigned int index, hda_nid_t nid);
d13bd412
TI		 555void snd_hda_ctls_clear(struct hda_codec *codec);
556
2807314d
TI		 557/*
558 * hwdep interface
559 */
d7ffba19 560#ifdef CONFIG_SND_HDA_HWDEP
2807314d 561int snd_hda_create_hwdep(struct hda_codec *codec);
d7ffba19
TI		 562#else
563static inline int snd_hda_create_hwdep(struct hda_codec *codec) { return 0; }
564#endif
2807314d 565
7288561a 566#if defined(CONFIG_SND_HDA_POWER_SAVE) && defined(CONFIG_SND_HDA_HWDEP)
a2f6309e
TI		 567int snd_hda_hwdep_add_power_sysfs(struct hda_codec *codec);
568#else
569static inline int snd_hda_hwdep_add_power_sysfs(struct hda_codec *codec)
570{
571 return 0;
572}
573#endif
574
e7ee058c
TI		 575#ifdef CONFIG_SND_HDA_RECONFIG
576int snd_hda_hwdep_add_sysfs(struct hda_codec *codec);
577#else
578static inline int snd_hda_hwdep_add_sysfs(struct hda_codec *codec)
579{
580 return 0;
581}
582#endif
583
43b62713
TI		 584#ifdef CONFIG_SND_HDA_RECONFIG
585const char *snd_hda_get_hint(struct hda_codec *codec, const char *key);
586int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key);
587#else
588static inline
589const char *snd_hda_get_hint(struct hda_codec *codec, const char *key)
590{
591 return NULL;
592}
593
594static inline
595int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key)
596{
597 return -ENOENT;
598}
599#endif
600
cb53c626
TI		 601/*
602 * power-management
603 */
604
cb53c626
TI		 605void snd_hda_schedule_power_save(struct hda_codec *codec);
606
607struct hda_amp_list {
608 hda_nid_t nid;
609 unsigned char dir;
610 unsigned char idx;
611};
612
613struct hda_loopback_check {
031024ee 614 const struct hda_amp_list *amplist;
cb53c626
TI		 615 int power_on;
616};
617
618int snd_hda_check_amp_list_power(struct hda_codec *codec,
619 struct hda_loopback_check *check,
620 hda_nid_t nid);
cb53c626 621
89385035
MR		 622/*
623 * AMP control callbacks
624 */
625/* retrieve parameters from private_value */
3911a4c1
JK		 626#define get_amp_nid_(pv) ((pv) & 0xffff)
627#define get_amp_nid(kc) get_amp_nid_((kc)->private_value)
89385035 628#define get_amp_channels(kc) (((kc)->private_value >> 16) & 0x3)
527e4d73
TI		 629#define get_amp_direction_(pv) (((pv) >> 18) & 0x1)
630#define get_amp_direction(kc) get_amp_direction_((kc)->private_value)
89385035 631#define get_amp_index(kc) (((kc)->private_value >> 19) & 0xf)
29fdbec2 632#define get_amp_offset(kc) (((kc)->private_value >> 23) & 0x3f)
de8c85f7 633#define get_amp_min_mute(kc) (((kc)->private_value >> 29) & 0x1)
89385035 634
7f4a9f43
WF		 635/*
636 * CEA Short Audio Descriptor data
637 */
638struct cea_sad {
639 int channels;
640 int format; /* (format == 0) indicates invalid SAD */
641 int rates;
642 int sample_bits; /* for LPCM */
643 int max_bitrate; /* for AC3...ATRAC */
644 int profile; /* for WMAPRO */
645};
646
647#define ELD_FIXED_BYTES 20
14bc52b8 648#define ELD_MAX_SIZE 256
7f4a9f43
WF		 649#define ELD_MAX_MNL 16
650#define ELD_MAX_SAD 16
651
652/*
653 * ELD: EDID Like Data
654 */
5b87ebb7 655struct hdmi_eld {
23ccc2bd
WF		 656 bool monitor_present;
657 bool eld_valid;
7f4a9f43
WF		 658 int eld_size;
659 int baseline_len;
23ccc2bd 660 int eld_ver;
7f4a9f43
WF		 661 int cea_edid_ver;
662 char monitor_name[ELD_MAX_MNL + 1];
663 int manufacture_id;
664 int product_id;
665 u64 port_id;
666 int support_hdcp;
667 int support_ai;
668 int conn_type;
669 int aud_synch_delay;
670 int spk_alloc;
671 int sad_count;
672 struct cea_sad sad[ELD_MAX_SAD];
b95d68b8
WF		 673 /*
674 * all fields above eld_buffer will be cleared before updating ELD
675 */
14bc52b8 676 char eld_buffer[ELD_MAX_SIZE];
f208dba9
TI		 677#ifdef CONFIG_PROC_FS
678 struct snd_info_entry *proc_entry;
679#endif
7f4a9f43
WF		 680};
681
682int snd_hdmi_get_eld_size(struct hda_codec *codec, hda_nid_t nid);
5b87ebb7
WF		 683int snd_hdmi_get_eld(struct hdmi_eld *, struct hda_codec *, hda_nid_t);
684void snd_hdmi_show_eld(struct hdmi_eld *eld);
2def8172
SW		 685void snd_hdmi_eld_update_pcm_info(struct hdmi_eld *eld,
686 struct hda_pcm_stream *hinfo);
7f4a9f43 687
5f1e71b1 688#ifdef CONFIG_PROC_FS
54a25f87
WF		 689int snd_hda_eld_proc_new(struct hda_codec *codec, struct hdmi_eld *eld,
690 int index);
f208dba9 691void snd_hda_eld_proc_free(struct hda_codec *codec, struct hdmi_eld *eld);
5f1e71b1 692#else
0623536c 693static inline int snd_hda_eld_proc_new(struct hda_codec *codec,
54a25f87
WF		 694 struct hdmi_eld *eld,
695 int index)
5f1e71b1
WF		 696{
697 return 0;
698}
f208dba9
TI		 699static inline void snd_hda_eld_proc_free(struct hda_codec *codec,
700 struct hdmi_eld *eld)
701{
702}
5f1e71b1
WF		 703#endif
704
903b21d8
WF		 705#define SND_PRINT_CHANNEL_ALLOCATION_ADVISED_BUFSIZE 80
706void snd_print_channel_allocation(int spk_alloc, char *buf, int buflen);
707
1da177e4 708#endif /* __SOUND_HDA_LOCAL_H */
Linux 6.x block layer and io_uring tree(s)