blob: 72e7b2f210ee3a174d92a764ee711bc2517c3658 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
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
Takashi Iwai9c96fa52009-11-16 11:25:33 +010026/* 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)
Jaroslav Kysela9e3fd872009-12-08 17:45:25 +010034#define HDA_SUBDEV_AMP_FLAG (1U << 30)
Takashi Iwai9c96fa52009-11-16 11:25:33 +010035
Linus Torvalds1da177e2005-04-16 15:20:36 -070036/*
37 * for mixer controls
38 */
Takashi Iwai29fdbec2009-01-20 13:07:55 +010039#define HDA_COMPOSE_AMP_VAL_OFS(nid,chs,idx,dir,ofs) \
40 ((nid) | ((chs)<<16) | ((dir)<<18) | ((idx)<<19) | ((ofs)<<23))
Takashi Iwaid01ce992007-07-27 16:52:19 +020041#define HDA_COMPOSE_AMP_VAL(nid,chs,idx,dir) \
Takashi Iwai29fdbec2009-01-20 13:07:55 +010042 HDA_COMPOSE_AMP_VAL_OFS(nid, chs, idx, dir, 0)
Takashi Iwai985be542005-11-02 18:26:49 +010043/* mono volume with index (index=0,1,...) (channel=1,2) */
Linus Torvalds1da177e2005-04-16 15:20:36 -070044#define HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
45 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
Jaroslav Kysela5e26dfd2009-12-10 13:57:01 +010046 .subdevice = HDA_SUBDEV_AMP_FLAG, \
Jaroslav Kysela302e9c52006-07-05 17:39:49 +020047 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | \
48 SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
49 SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK, \
Linus Torvalds1da177e2005-04-16 15:20:36 -070050 .info = snd_hda_mixer_amp_volume_info, \
51 .get = snd_hda_mixer_amp_volume_get, \
52 .put = snd_hda_mixer_amp_volume_put, \
Takashi Iwai7cf0a952006-08-17 16:23:07 +020053 .tlv = { .c = snd_hda_mixer_amp_tlv }, \
Linus Torvalds1da177e2005-04-16 15:20:36 -070054 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
Takashi Iwai985be542005-11-02 18:26:49 +010055/* stereo volume with index */
Linus Torvalds1da177e2005-04-16 15:20:36 -070056#define HDA_CODEC_VOLUME_IDX(xname, xcidx, nid, xindex, direction) \
57 HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010058/* mono volume */
Linus Torvalds1da177e2005-04-16 15:20:36 -070059#define HDA_CODEC_VOLUME_MONO(xname, nid, channel, xindex, direction) \
60 HDA_CODEC_VOLUME_MONO_IDX(xname, 0, nid, channel, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010061/* stereo volume */
Linus Torvalds1da177e2005-04-16 15:20:36 -070062#define HDA_CODEC_VOLUME(xname, nid, xindex, direction) \
63 HDA_CODEC_VOLUME_MONO(xname, nid, 3, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010064/* mono mute switch with index (index=0,1,...) (channel=1,2) */
Linus Torvalds1da177e2005-04-16 15:20:36 -070065#define HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
66 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
Jaroslav Kysela5e26dfd2009-12-10 13:57:01 +010067 .subdevice = HDA_SUBDEV_AMP_FLAG, \
Linus Torvalds1da177e2005-04-16 15:20:36 -070068 .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) }
Takashi Iwai985be542005-11-02 18:26:49 +010072/* stereo mute switch with index */
Linus Torvalds1da177e2005-04-16 15:20:36 -070073#define HDA_CODEC_MUTE_IDX(xname, xcidx, nid, xindex, direction) \
74 HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010075/* mono mute switch */
Linus Torvalds1da177e2005-04-16 15:20:36 -070076#define HDA_CODEC_MUTE_MONO(xname, nid, channel, xindex, direction) \
77 HDA_CODEC_MUTE_MONO_IDX(xname, 0, nid, channel, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010078/* stereo mute switch */
Linus Torvalds1da177e2005-04-16 15:20:36 -070079#define HDA_CODEC_MUTE(xname, nid, xindex, direction) \
80 HDA_CODEC_MUTE_MONO(xname, nid, 3, xindex, direction)
Takashi Iwai67d634c2009-11-16 15:35:59 +010081#ifdef CONFIG_SND_HDA_INPUT_BEEP
Jaroslav Kysela123c07a2009-10-21 14:48:23 +020082/* 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, \
Jaroslav Kysela5e26dfd2009-12-10 13:57:01 +010085 .subdevice = HDA_SUBDEV_AMP_FLAG, \
Jaroslav Kysela123c07a2009-10-21 14:48:23 +020086 .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) }
Takashi Iwai67d634c2009-11-16 15:35:59 +010090#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 */
Jaroslav Kysela123c07a2009-10-21 14:48:23 +020095/* 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)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700101
Jaroslav Kysela85dd6622009-11-11 13:49:07 +0100102extern const char *snd_hda_pcm_type_name[];
103
Takashi Iwaid01ce992007-07-27 16:52:19 +0200104int snd_hda_mixer_amp_volume_info(struct snd_kcontrol *kcontrol,
105 struct snd_ctl_elem_info *uinfo);
106int snd_hda_mixer_amp_volume_get(struct snd_kcontrol *kcontrol,
107 struct snd_ctl_elem_value *ucontrol);
108int snd_hda_mixer_amp_volume_put(struct snd_kcontrol *kcontrol,
109 struct snd_ctl_elem_value *ucontrol);
110int snd_hda_mixer_amp_tlv(struct snd_kcontrol *kcontrol, int op_flag,
111 unsigned int size, unsigned int __user *tlv);
112int snd_hda_mixer_amp_switch_info(struct snd_kcontrol *kcontrol,
113 struct snd_ctl_elem_info *uinfo);
114int snd_hda_mixer_amp_switch_get(struct snd_kcontrol *kcontrol,
115 struct snd_ctl_elem_value *ucontrol);
116int snd_hda_mixer_amp_switch_put(struct snd_kcontrol *kcontrol,
117 struct snd_ctl_elem_value *ucontrol);
Takashi Iwai67d634c2009-11-16 15:35:59 +0100118#ifdef CONFIG_SND_HDA_INPUT_BEEP
Jaroslav Kysela123c07a2009-10-21 14:48:23 +0200119int snd_hda_mixer_amp_switch_put_beep(struct snd_kcontrol *kcontrol,
120 struct snd_ctl_elem_value *ucontrol);
Takashi Iwai67d634c2009-11-16 15:35:59 +0100121#endif
Takashi Iwai834be882006-03-01 14:16:17 +0100122/* lowlevel accessor with caching; use carefully */
123int snd_hda_codec_amp_read(struct hda_codec *codec, hda_nid_t nid, int ch,
124 int direction, int index);
125int snd_hda_codec_amp_update(struct hda_codec *codec, hda_nid_t nid, int ch,
126 int direction, int idx, int mask, int val);
Takashi Iwai47fd8302007-08-10 17:11:07 +0200127int snd_hda_codec_amp_stereo(struct hda_codec *codec, hda_nid_t nid,
128 int dir, int idx, int mask, int val);
Takashi Iwaicb53c622007-08-10 17:21:45 +0200129#ifdef SND_HDA_NEEDS_RESUME
Takashi Iwaib3ac5632007-08-10 17:03:40 +0200130void snd_hda_codec_resume_amp(struct hda_codec *codec);
Takashi Iwai82beb8f2007-08-10 17:09:26 +0200131#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700132
Takashi Iwai2134ea42008-01-10 16:53:55 +0100133void snd_hda_set_vmaster_tlv(struct hda_codec *codec, hda_nid_t nid, int dir,
134 unsigned int *tlv);
135struct snd_kcontrol *snd_hda_find_mixer_ctl(struct hda_codec *codec,
136 const char *name);
137int snd_hda_add_vmaster(struct hda_codec *codec, char *name,
138 unsigned int *tlv, const char **slaves);
Takashi Iwaia65d6292009-02-23 16:57:04 +0100139int snd_hda_codec_reset(struct hda_codec *codec);
Takashi Iwai2134ea42008-01-10 16:53:55 +0100140
Takashi Iwai47fd8302007-08-10 17:11:07 +0200141/* amp value bits */
142#define HDA_AMP_MUTE 0x80
143#define HDA_AMP_UNMUTE 0x00
144#define HDA_AMP_VOLMASK 0x7f
145
Takashi Iwai985be542005-11-02 18:26:49 +0100146/* 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 */
Takashi Iwaid01ce992007-07-27 16:52:19 +0200155#define HDA_BIND_MUTE(xname,nid,indices,dir) \
156 HDA_BIND_MUTE_MONO(xname,nid,3,indices,dir)
Takashi Iwai985be542005-11-02 18:26:49 +0100157
Takashi Iwaid01ce992007-07-27 16:52:19 +0200158int snd_hda_mixer_bind_switch_get(struct snd_kcontrol *kcontrol,
159 struct snd_ctl_elem_value *ucontrol);
160int snd_hda_mixer_bind_switch_put(struct snd_kcontrol *kcontrol,
161 struct snd_ctl_elem_value *ucontrol);
Takashi Iwai985be542005-11-02 18:26:49 +0100162
Takashi Iwai532d5382007-07-27 19:02:40 +0200163/* more generic bound controls */
164struct 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
171extern struct hda_ctl_ops snd_hda_bind_vol; /* for bind-volume with TLV */
172extern struct hda_ctl_ops snd_hda_bind_sw; /* for bind-switch */
173
174struct hda_bind_ctls {
175 struct hda_ctl_ops *ops;
Hannes Eder5d9b6c02009-02-25 22:28:45 +0100176 unsigned long values[];
Takashi Iwai532d5382007-07-27 19:02:40 +0200177};
178
179int snd_hda_mixer_bind_ctls_info(struct snd_kcontrol *kcontrol,
180 struct snd_ctl_elem_info *uinfo);
181int snd_hda_mixer_bind_ctls_get(struct snd_kcontrol *kcontrol,
182 struct snd_ctl_elem_value *ucontrol);
183int snd_hda_mixer_bind_ctls_put(struct snd_kcontrol *kcontrol,
184 struct snd_ctl_elem_value *ucontrol);
185int 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 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700210int snd_hda_create_spdif_out_ctls(struct hda_codec *codec, hda_nid_t nid);
211int snd_hda_create_spdif_in_ctls(struct hda_codec *codec, hda_nid_t nid);
212
213/*
214 * input MUX helper
215 */
Takashi Iwai54d17402005-11-21 16:33:22 +0100216#define HDA_MAX_NUM_INPUTS 16
Linus Torvalds1da177e2005-04-16 15:20:36 -0700217struct hda_input_mux_item {
Takashi Iwaib5786e82010-09-09 14:21:17 +0200218 char label[32];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700219 unsigned int index;
220};
221struct hda_input_mux {
222 unsigned int num_items;
223 struct hda_input_mux_item items[HDA_MAX_NUM_INPUTS];
224};
225
Takashi Iwaid01ce992007-07-27 16:52:19 +0200226int snd_hda_input_mux_info(const struct hda_input_mux *imux,
227 struct snd_ctl_elem_info *uinfo);
228int snd_hda_input_mux_put(struct hda_codec *codec,
229 const struct hda_input_mux *imux,
Takashi Iwaic8b6bf9b2005-11-17 14:57:47 +0100230 struct snd_ctl_elem_value *ucontrol, hda_nid_t nid,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700231 unsigned int *cur_val);
232
Takashi Iwaic8b6bf9b2005-11-17 14:57:47 +0100233/*
Takashi Iwaid2a6d7d2005-11-17 11:06:29 +0100234 * Channel mode helper
235 */
236struct hda_channel_mode {
237 int channels;
238 const struct hda_verb *sequence;
239};
240
Takashi Iwaid01ce992007-07-27 16:52:19 +0200241int 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);
245int 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,
Takashi Iwaid2a6d7d2005-11-17 11:06:29 +0100249 int max_channels);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200250int 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,
Takashi Iwaid2a6d7d2005-11-17 11:06:29 +0100254 int *max_channelsp);
255
Linus Torvalds1da177e2005-04-16 15:20:36 -0700256/*
257 * Multi-channel / digital-out PCM helper
258 */
259
260enum { HDA_FRONT, HDA_REAR, HDA_CLFE, HDA_SIDE }; /* index for dac_nidx */
261enum { HDA_DIG_NONE, HDA_DIG_EXCLUSIVE, HDA_DIG_ANALOG_DUP }; /* dig_out_used */
262
263struct 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 */
Takashi Iwai82bc9552006-03-21 11:24:42 +0100267 hda_nid_t extra_out_nid[3]; /* optional DACs, 0 when not exists */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700268 hda_nid_t dig_out_nid; /* digital out audio widget */
Wu Fengguangb25c9da2009-02-06 15:02:27 +0800269 hda_nid_t *slave_dig_outs;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700270 int max_channels; /* currently supported analog channels */
271 int dig_out_used; /* current usage of digital out (HDA_DIG_XXX) */
Takashi Iwaid29240c2007-10-26 12:35:56 +0200272 int no_share_stream; /* don't share a stream with multiple pins */
Takashi Iwai9a081602008-02-12 18:37:26 +0100273 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;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700281};
282
Takashi Iwai9a081602008-02-12 18:37:26 +0100283int snd_hda_create_spdif_share_sw(struct hda_codec *codec,
284 struct hda_multi_out *mout);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200285int snd_hda_multi_out_dig_open(struct hda_codec *codec,
286 struct hda_multi_out *mout);
287int snd_hda_multi_out_dig_close(struct hda_codec *codec,
288 struct hda_multi_out *mout);
Takashi Iwai6b97eb42007-04-05 14:51:48 +0200289int 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);
Takashi Iwai9411e212009-02-13 11:32:28 +0100294int snd_hda_multi_out_dig_cleanup(struct hda_codec *codec,
295 struct hda_multi_out *mout);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200296int snd_hda_multi_out_analog_open(struct hda_codec *codec,
297 struct hda_multi_out *mout,
Takashi Iwai9a081602008-02-12 18:37:26 +0100298 struct snd_pcm_substream *substream,
299 struct hda_pcm_stream *hinfo);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200300int snd_hda_multi_out_analog_prepare(struct hda_codec *codec,
301 struct hda_multi_out *mout,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700302 unsigned int stream_tag,
303 unsigned int format,
Takashi Iwaic8b6bf9b2005-11-17 14:57:47 +0100304 struct snd_pcm_substream *substream);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200305int snd_hda_multi_out_analog_cleanup(struct hda_codec *codec,
306 struct hda_multi_out *mout);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700307
308/*
309 * generic codec parser
310 */
Takashi Iwai35a1e0c2007-10-19 08:13:40 +0200311#ifdef CONFIG_SND_HDA_GENERIC
Linus Torvalds1da177e2005-04-16 15:20:36 -0700312int snd_hda_parse_generic_codec(struct hda_codec *codec);
Takashi Iwai35a1e0c2007-10-19 08:13:40 +0200313#else
314static inline int snd_hda_parse_generic_codec(struct hda_codec *codec)
315{
316 return -ENODEV;
317}
318#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700319
320/*
321 * generic proc interface
322 */
323#ifdef CONFIG_PROC_FS
324int snd_hda_codec_proc_new(struct hda_codec *codec);
325#else
326static inline int snd_hda_codec_proc_new(struct hda_codec *codec) { return 0; }
327#endif
328
Wu Fengguang33deeca2008-11-18 11:47:51 +0800329#define SND_PRINT_RATES_ADVISED_BUFSIZE 80
330void snd_print_pcm_rates(int pcm, char *buf, int buflen);
331
Wu Fengguangd39b4352008-11-19 15:14:02 +0800332#define SND_PRINT_BITS_ADVISED_BUFSIZE 16
333void snd_print_pcm_bits(int pcm, char *buf, int buflen);
334
Linus Torvalds1da177e2005-04-16 15:20:36 -0700335/*
336 * Misc
337 */
Takashi Iwaif5fcc132006-11-24 17:07:44 +0100338int snd_hda_check_board_config(struct hda_codec *codec, int num_configs,
339 const char **modelnames,
340 const struct snd_pci_quirk *pci_list);
Mauro Carvalho Chehab2eda3442008-08-11 10:18:39 +0200341int 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);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200344int snd_hda_add_new_ctls(struct hda_codec *codec,
345 struct snd_kcontrol_new *knew);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700346
347/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700348 * unsolicited event handler
349 */
350
351#define HDA_UNSOL_QUEUE_SIZE 64
352
353struct hda_bus_unsolicited {
354 /* ring buffer */
355 u32 queue[HDA_UNSOL_QUEUE_SIZE * 2];
356 unsigned int rp, wp;
357
358 /* workqueue */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700359 struct work_struct work;
David Howellsc4028952006-11-22 14:57:56 +0000360 struct hda_bus *bus;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700361};
362
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200363/*
Justin P. Mattockb7a56332010-03-18 19:26:13 -0700364 * Helper for automatic pin configuration
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200365 */
366
367enum {
368 AUTO_PIN_MIC,
Takashi Iwai86e29592010-09-09 14:50:17 +0200369 AUTO_PIN_LINE_IN,
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200370 AUTO_PIN_CD,
371 AUTO_PIN_AUX,
372 AUTO_PIN_LAST
373};
374
Takashi Iwaid258e242007-04-23 17:16:21 +0200375enum {
376 AUTO_PIN_LINE_OUT,
377 AUTO_PIN_SPEAKER_OUT,
378 AUTO_PIN_HP_OUT
379};
380
Takashi Iwai4a471b72005-12-07 13:56:29 +0100381extern const char *auto_pin_cfg_labels[AUTO_PIN_LAST];
382
Takashi Iwai41923e42007-10-22 17:20:10 +0200383#define AUTO_CFG_MAX_OUTS 5
Takashi Iwai75e0eb22010-08-30 12:56:55 +0200384#define AUTO_CFG_MAX_INS 8
385
386struct auto_pin_cfg_item {
387 hda_nid_t pin;
388 int type;
389};
390
391struct auto_pin_cfg;
Takashi Iwaib5786e82010-09-09 14:21:17 +0200392void snd_hda_get_input_pin_label(const struct auto_pin_cfg *cfg,
393 int input, char *label);
Takashi Iwai41923e42007-10-22 17:20:10 +0200394
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200395struct auto_pin_cfg {
396 int line_outs;
Takashi Iwai41923e42007-10-22 17:20:10 +0200397 /* sorted in the order of Front/Surr/CLFE/Side */
398 hda_nid_t line_out_pins[AUTO_CFG_MAX_OUTS];
Takashi Iwai82bc9552006-03-21 11:24:42 +0100399 int speaker_outs;
Takashi Iwai41923e42007-10-22 17:20:10 +0200400 hda_nid_t speaker_pins[AUTO_CFG_MAX_OUTS];
Takashi Iwaieb06ed82006-09-20 17:10:27 +0200401 int hp_outs;
Takashi Iwaid258e242007-04-23 17:16:21 +0200402 int line_out_type; /* AUTO_PIN_XXX_OUT */
Takashi Iwai41923e42007-10-22 17:20:10 +0200403 hda_nid_t hp_pins[AUTO_CFG_MAX_OUTS];
Takashi Iwai75e0eb22010-08-30 12:56:55 +0200404 int num_inputs;
405 struct auto_pin_cfg_item inputs[AUTO_CFG_MAX_INS];
Takashi Iwai0852d7a2009-02-11 11:35:15 +0100406 int dig_outs;
407 hda_nid_t dig_out_pins[2];
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200408 hda_nid_t dig_in_pin;
Matthew Ranostay90da78b2008-01-24 11:48:01 +0100409 hda_nid_t mono_out_pin;
Takashi Iwai0852d7a2009-02-11 11:35:15 +0100410 int dig_out_type[2]; /* HDA_PCM_TYPE_XXX */
Takashi Iwai2297bd62009-01-20 18:24:13 +0100411 int dig_in_type; /* HDA_PCM_TYPE_XXX */
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200412};
413
Takashi Iwaid01ce992007-07-27 16:52:19 +0200414#define get_defcfg_connect(cfg) \
415 ((cfg & AC_DEFCFG_PORT_CONN) >> AC_DEFCFG_PORT_CONN_SHIFT)
416#define get_defcfg_association(cfg) \
417 ((cfg & AC_DEFCFG_DEF_ASSOC) >> AC_DEFCFG_ASSOC_SHIFT)
418#define get_defcfg_location(cfg) \
419 ((cfg & AC_DEFCFG_LOCATION) >> AC_DEFCFG_LOCATION_SHIFT)
420#define get_defcfg_sequence(cfg) \
421 (cfg & AC_DEFCFG_SEQUENCE)
422#define get_defcfg_device(cfg) \
423 ((cfg & AC_DEFCFG_DEVICE) >> AC_DEFCFG_DEVICE_SHIFT)
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200424
Takashi Iwaid01ce992007-07-27 16:52:19 +0200425int snd_hda_parse_pin_def_config(struct hda_codec *codec,
426 struct auto_pin_cfg *cfg,
Kailang Yangdf694da2005-12-05 19:42:22 +0100427 hda_nid_t *ignore_nids);
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200428
Takashi Iwai8d88bc32005-11-17 11:09:23 +0100429/* amp values */
430#define AMP_IN_MUTE(idx) (0x7080 | ((idx)<<8))
431#define AMP_IN_UNMUTE(idx) (0x7000 | ((idx)<<8))
Takashi Iwaid301fc32008-10-29 08:15:30 +0100432#define AMP_OUT_MUTE 0xb080
433#define AMP_OUT_UNMUTE 0xb000
434#define AMP_OUT_ZERO 0xb000
Takashi Iwai8d88bc32005-11-17 11:09:23 +0100435/* pinctl values */
Robin H. Johnson35e89012008-09-13 16:54:59 -0700436#define PIN_IN (AC_PINCTL_IN_EN)
Takashi Iwaid301fc32008-10-29 08:15:30 +0100437#define PIN_VREFHIZ (AC_PINCTL_IN_EN | AC_PINCTL_VREF_HIZ)
Robin H. Johnson35e89012008-09-13 16:54:59 -0700438#define PIN_VREF50 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_50)
Takashi Iwaid301fc32008-10-29 08:15:30 +0100439#define PIN_VREFGRD (AC_PINCTL_IN_EN | AC_PINCTL_VREF_GRD)
Robin H. Johnson35e89012008-09-13 16:54:59 -0700440#define PIN_VREF80 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_80)
Takashi Iwaid301fc32008-10-29 08:15:30 +0100441#define PIN_VREF100 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_100)
442#define PIN_OUT (AC_PINCTL_OUT_EN)
Robin H. Johnson35e89012008-09-13 16:54:59 -0700443#define PIN_HP (AC_PINCTL_OUT_EN | AC_PINCTL_HP_EN)
444#define PIN_HP_AMP (AC_PINCTL_HP_EN)
Takashi Iwai8d88bc32005-11-17 11:09:23 +0100445
Takashi Iwai54d17402005-11-21 16:33:22 +0100446/*
447 * get widget capabilities
448 */
449static inline u32 get_wcaps(struct hda_codec *codec, hda_nid_t nid)
450{
451 if (nid < codec->start_nid ||
452 nid >= codec->start_nid + codec->num_nodes)
Takashi Iwaidca008f2008-01-22 15:37:13 +0100453 return 0;
Takashi Iwai54d17402005-11-21 16:33:22 +0100454 return codec->wcaps[nid - codec->start_nid];
455}
456
Takashi Iwaia22d5432009-07-27 12:54:26 +0200457/* get the widget type from widget capability bits */
458#define get_wcaps_type(wcaps) (((wcaps) & AC_WCAP_TYPE) >> AC_WCAP_TYPE_SHIFT)
459
Wu Fengguangfd72d002009-08-24 09:50:46 +0800460static inline unsigned int get_wcaps_channels(u32 wcaps)
461{
462 unsigned int chans;
463
464 chans = (wcaps & AC_WCAP_CHAN_CNT_EXT) >> 13;
465 chans = ((chans << 1) | 1) + 1;
466
467 return chans;
468}
469
Matthew Ranostay09a99952008-01-24 11:49:21 +0100470u32 query_amp_caps(struct hda_codec *codec, hda_nid_t nid, int direction);
Takashi Iwai897cc182007-05-29 19:01:37 +0200471int snd_hda_override_amp_caps(struct hda_codec *codec, hda_nid_t nid, int dir,
472 unsigned int caps);
Takashi Iwai1327a322009-03-23 13:07:47 +0100473u32 snd_hda_query_pin_caps(struct hda_codec *codec, hda_nid_t nid);
Wu Fengguang864f92b2009-11-18 12:38:02 +0800474u32 snd_hda_pin_sense(struct hda_codec *codec, hda_nid_t nid);
475int snd_hda_jack_detect(struct hda_codec *codec, hda_nid_t nid);
Takashi Iwai54d17402005-11-21 16:33:22 +0100476
Jaroslav Kysela9e3fd872009-12-08 17:45:25 +0100477/* flags for hda_nid_item */
478#define HDA_NID_ITEM_AMP (1<<0)
479
Jaroslav Kysela3911a4c2009-11-11 13:43:01 +0100480struct hda_nid_item {
481 struct snd_kcontrol *kctl;
Jaroslav Kysela5b0cb1d2009-12-08 16:13:32 +0100482 unsigned int index;
Jaroslav Kysela3911a4c2009-11-11 13:43:01 +0100483 hda_nid_t nid;
Jaroslav Kysela9e3fd872009-12-08 17:45:25 +0100484 unsigned short flags;
Jaroslav Kysela3911a4c2009-11-11 13:43:01 +0100485};
486
487int snd_hda_ctl_add(struct hda_codec *codec, hda_nid_t nid,
488 struct snd_kcontrol *kctl);
Jaroslav Kysela5b0cb1d2009-12-08 16:13:32 +0100489int snd_hda_add_nid(struct hda_codec *codec, struct snd_kcontrol *kctl,
490 unsigned int index, hda_nid_t nid);
Takashi Iwaid13bd412008-07-30 15:01:45 +0200491void snd_hda_ctls_clear(struct hda_codec *codec);
492
Takashi Iwai28073142007-07-27 18:58:06 +0200493/*
494 * hwdep interface
495 */
Takashi Iwaid7ffba12008-07-30 15:01:46 +0200496#ifdef CONFIG_SND_HDA_HWDEP
Takashi Iwai28073142007-07-27 18:58:06 +0200497int snd_hda_create_hwdep(struct hda_codec *codec);
Takashi Iwaid7ffba12008-07-30 15:01:46 +0200498#else
499static inline int snd_hda_create_hwdep(struct hda_codec *codec) { return 0; }
500#endif
Takashi Iwai28073142007-07-27 18:58:06 +0200501
Takashi Iwai72885612009-11-12 10:01:18 +0100502#if defined(CONFIG_SND_HDA_POWER_SAVE) && defined(CONFIG_SND_HDA_HWDEP)
Takashi Iwaia2f63092009-11-11 09:34:25 +0100503int snd_hda_hwdep_add_power_sysfs(struct hda_codec *codec);
504#else
505static inline int snd_hda_hwdep_add_power_sysfs(struct hda_codec *codec)
506{
507 return 0;
508}
509#endif
510
Takashi Iwaie7ee0582008-11-21 09:26:20 +0100511#ifdef CONFIG_SND_HDA_RECONFIG
512int snd_hda_hwdep_add_sysfs(struct hda_codec *codec);
513#else
514static inline int snd_hda_hwdep_add_sysfs(struct hda_codec *codec)
515{
516 return 0;
517}
518#endif
519
Takashi Iwai43b62712009-03-02 14:25:17 +0100520#ifdef CONFIG_SND_HDA_RECONFIG
521const char *snd_hda_get_hint(struct hda_codec *codec, const char *key);
522int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key);
523#else
524static inline
525const char *snd_hda_get_hint(struct hda_codec *codec, const char *key)
526{
527 return NULL;
528}
529
530static inline
531int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key)
532{
533 return -ENOENT;
534}
535#endif
536
Takashi Iwaicb53c622007-08-10 17:21:45 +0200537/*
538 * power-management
539 */
540
541#ifdef CONFIG_SND_HDA_POWER_SAVE
542void snd_hda_schedule_power_save(struct hda_codec *codec);
543
544struct hda_amp_list {
545 hda_nid_t nid;
546 unsigned char dir;
547 unsigned char idx;
548};
549
550struct hda_loopback_check {
551 struct hda_amp_list *amplist;
552 int power_on;
553};
554
555int snd_hda_check_amp_list_power(struct hda_codec *codec,
556 struct hda_loopback_check *check,
557 hda_nid_t nid);
558#endif /* CONFIG_SND_HDA_POWER_SAVE */
559
Matthew Ranostay89385032008-09-11 09:49:39 -0400560/*
561 * AMP control callbacks
562 */
563/* retrieve parameters from private_value */
Jaroslav Kysela3911a4c2009-11-11 13:43:01 +0100564#define get_amp_nid_(pv) ((pv) & 0xffff)
565#define get_amp_nid(kc) get_amp_nid_((kc)->private_value)
Matthew Ranostay89385032008-09-11 09:49:39 -0400566#define get_amp_channels(kc) (((kc)->private_value >> 16) & 0x3)
567#define get_amp_direction(kc) (((kc)->private_value >> 18) & 0x1)
568#define get_amp_index(kc) (((kc)->private_value >> 19) & 0xf)
Takashi Iwai29fdbec2009-01-20 13:07:55 +0100569#define get_amp_offset(kc) (((kc)->private_value >> 23) & 0x3f)
Matthew Ranostay89385032008-09-11 09:49:39 -0400570
Wu Fengguang7f4a9f42008-11-18 11:47:52 +0800571/*
572 * CEA Short Audio Descriptor data
573 */
574struct cea_sad {
575 int channels;
576 int format; /* (format == 0) indicates invalid SAD */
577 int rates;
578 int sample_bits; /* for LPCM */
579 int max_bitrate; /* for AC3...ATRAC */
580 int profile; /* for WMAPRO */
581};
582
583#define ELD_FIXED_BYTES 20
584#define ELD_MAX_MNL 16
585#define ELD_MAX_SAD 16
586
587/*
588 * ELD: EDID Like Data
589 */
Wu Fengguang5b87ebb2008-11-19 15:14:00 +0800590struct hdmi_eld {
Wu Fengguang23ccc2b2009-11-18 12:38:01 +0800591 bool monitor_present;
592 bool eld_valid;
Wu Fengguang7f4a9f42008-11-18 11:47:52 +0800593 int eld_size;
594 int baseline_len;
Wu Fengguang23ccc2b2009-11-18 12:38:01 +0800595 int eld_ver;
Wu Fengguang7f4a9f42008-11-18 11:47:52 +0800596 int cea_edid_ver;
597 char monitor_name[ELD_MAX_MNL + 1];
598 int manufacture_id;
599 int product_id;
600 u64 port_id;
601 int support_hdcp;
602 int support_ai;
603 int conn_type;
604 int aud_synch_delay;
605 int spk_alloc;
606 int sad_count;
607 struct cea_sad sad[ELD_MAX_SAD];
Takashi Iwaif208dba2008-11-21 09:11:50 +0100608#ifdef CONFIG_PROC_FS
609 struct snd_info_entry *proc_entry;
610#endif
Wu Fengguang7f4a9f42008-11-18 11:47:52 +0800611};
612
613int snd_hdmi_get_eld_size(struct hda_codec *codec, hda_nid_t nid);
Wu Fengguang5b87ebb2008-11-19 15:14:00 +0800614int snd_hdmi_get_eld(struct hdmi_eld *, struct hda_codec *, hda_nid_t);
615void snd_hdmi_show_eld(struct hdmi_eld *eld);
Takashi Iwaibbbe3392010-08-13 08:45:23 +0200616void hdmi_eld_update_pcm_info(struct hdmi_eld *eld, struct hda_pcm_stream *pcm,
617 struct hda_pcm_stream *codec_pars);
Wu Fengguang7f4a9f42008-11-18 11:47:52 +0800618
Wu Fengguang5f1e71b2008-11-18 11:47:53 +0800619#ifdef CONFIG_PROC_FS
Wu Fengguang54a25f82009-10-30 11:44:26 +0100620int snd_hda_eld_proc_new(struct hda_codec *codec, struct hdmi_eld *eld,
621 int index);
Takashi Iwaif208dba2008-11-21 09:11:50 +0100622void snd_hda_eld_proc_free(struct hda_codec *codec, struct hdmi_eld *eld);
Wu Fengguang5f1e71b2008-11-18 11:47:53 +0800623#else
Takashi Iwai06235362008-11-21 08:54:54 +0100624static inline int snd_hda_eld_proc_new(struct hda_codec *codec,
Wu Fengguang54a25f82009-10-30 11:44:26 +0100625 struct hdmi_eld *eld,
626 int index)
Wu Fengguang5f1e71b2008-11-18 11:47:53 +0800627{
628 return 0;
629}
Takashi Iwaif208dba2008-11-21 09:11:50 +0100630static inline void snd_hda_eld_proc_free(struct hda_codec *codec,
631 struct hdmi_eld *eld)
632{
633}
Wu Fengguang5f1e71b2008-11-18 11:47:53 +0800634#endif
635
Wu Fengguang903b21d2008-11-19 08:56:16 +0800636#define SND_PRINT_CHANNEL_ALLOCATION_ADVISED_BUFSIZE 80
637void snd_print_channel_allocation(int spk_alloc, char *buf, int buflen);
638
Linus Torvalds1da177e2005-04-16 15:20:36 -0700639#endif /* __SOUND_HDA_LOCAL_H */