blob: 7c049839ea2600cae4d2eb233a52c33707c5f0d0 [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)
34
Linus Torvalds1da177e2005-04-16 15:20:36 -070035/*
36 * for mixer controls
37 */
Takashi Iwai29fdbec2009-01-20 13:07:55 +010038#define HDA_COMPOSE_AMP_VAL_OFS(nid,chs,idx,dir,ofs) \
39 ((nid) | ((chs)<<16) | ((dir)<<18) | ((idx)<<19) | ((ofs)<<23))
Takashi Iwaid01ce992007-07-27 16:52:19 +020040#define HDA_COMPOSE_AMP_VAL(nid,chs,idx,dir) \
Takashi Iwai29fdbec2009-01-20 13:07:55 +010041 HDA_COMPOSE_AMP_VAL_OFS(nid, chs, idx, dir, 0)
Takashi Iwai985be542005-11-02 18:26:49 +010042/* mono volume with index (index=0,1,...) (channel=1,2) */
Linus Torvalds1da177e2005-04-16 15:20:36 -070043#define HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
44 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
Takashi Iwai9c96fa52009-11-16 11:25:33 +010045 .subdevice = HDA_SUBDEV_NID_FLAG | (nid), \
Jaroslav Kysela302e9c52006-07-05 17:39:49 +020046 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | \
47 SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
48 SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK, \
Linus Torvalds1da177e2005-04-16 15:20:36 -070049 .info = snd_hda_mixer_amp_volume_info, \
50 .get = snd_hda_mixer_amp_volume_get, \
51 .put = snd_hda_mixer_amp_volume_put, \
Takashi Iwai7cf0a952006-08-17 16:23:07 +020052 .tlv = { .c = snd_hda_mixer_amp_tlv }, \
Linus Torvalds1da177e2005-04-16 15:20:36 -070053 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
Takashi Iwai985be542005-11-02 18:26:49 +010054/* stereo volume with index */
Linus Torvalds1da177e2005-04-16 15:20:36 -070055#define HDA_CODEC_VOLUME_IDX(xname, xcidx, nid, xindex, direction) \
56 HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010057/* mono volume */
Linus Torvalds1da177e2005-04-16 15:20:36 -070058#define HDA_CODEC_VOLUME_MONO(xname, nid, channel, xindex, direction) \
59 HDA_CODEC_VOLUME_MONO_IDX(xname, 0, nid, channel, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010060/* stereo volume */
Linus Torvalds1da177e2005-04-16 15:20:36 -070061#define HDA_CODEC_VOLUME(xname, nid, xindex, direction) \
62 HDA_CODEC_VOLUME_MONO(xname, nid, 3, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010063/* mono mute switch with index (index=0,1,...) (channel=1,2) */
Linus Torvalds1da177e2005-04-16 15:20:36 -070064#define HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
65 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
Takashi Iwai9c96fa52009-11-16 11:25:33 +010066 .subdevice = HDA_SUBDEV_NID_FLAG | (nid), \
Linus Torvalds1da177e2005-04-16 15:20:36 -070067 .info = snd_hda_mixer_amp_switch_info, \
68 .get = snd_hda_mixer_amp_switch_get, \
69 .put = snd_hda_mixer_amp_switch_put, \
70 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
Takashi Iwai985be542005-11-02 18:26:49 +010071/* stereo mute switch with index */
Linus Torvalds1da177e2005-04-16 15:20:36 -070072#define HDA_CODEC_MUTE_IDX(xname, xcidx, nid, xindex, direction) \
73 HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010074/* mono mute switch */
Linus Torvalds1da177e2005-04-16 15:20:36 -070075#define HDA_CODEC_MUTE_MONO(xname, nid, channel, xindex, direction) \
76 HDA_CODEC_MUTE_MONO_IDX(xname, 0, nid, channel, xindex, direction)
Takashi Iwai985be542005-11-02 18:26:49 +010077/* stereo mute switch */
Linus Torvalds1da177e2005-04-16 15:20:36 -070078#define HDA_CODEC_MUTE(xname, nid, xindex, direction) \
79 HDA_CODEC_MUTE_MONO(xname, nid, 3, xindex, direction)
Jaroslav Kysela123c07a2009-10-21 14:48:23 +020080/* special beep mono mute switch with index (index=0,1,...) (channel=1,2) */
81#define HDA_CODEC_MUTE_BEEP_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
82 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
Takashi Iwai9c96fa52009-11-16 11:25:33 +010083 .subdevice = HDA_SUBDEV_NID_FLAG | (nid), \
Jaroslav Kysela123c07a2009-10-21 14:48:23 +020084 .info = snd_hda_mixer_amp_switch_info, \
85 .get = snd_hda_mixer_amp_switch_get, \
86 .put = snd_hda_mixer_amp_switch_put_beep, \
87 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
88/* special beep mono mute switch */
89#define HDA_CODEC_MUTE_BEEP_MONO(xname, nid, channel, xindex, direction) \
90 HDA_CODEC_MUTE_BEEP_MONO_IDX(xname, 0, nid, channel, xindex, direction)
91/* special beep stereo mute switch */
92#define HDA_CODEC_MUTE_BEEP(xname, nid, xindex, direction) \
93 HDA_CODEC_MUTE_BEEP_MONO(xname, nid, 3, xindex, direction)
Linus Torvalds1da177e2005-04-16 15:20:36 -070094
Jaroslav Kysela85dd6622009-11-11 13:49:07 +010095extern const char *snd_hda_pcm_type_name[];
96
Takashi Iwaid01ce992007-07-27 16:52:19 +020097int snd_hda_mixer_amp_volume_info(struct snd_kcontrol *kcontrol,
98 struct snd_ctl_elem_info *uinfo);
99int snd_hda_mixer_amp_volume_get(struct snd_kcontrol *kcontrol,
100 struct snd_ctl_elem_value *ucontrol);
101int snd_hda_mixer_amp_volume_put(struct snd_kcontrol *kcontrol,
102 struct snd_ctl_elem_value *ucontrol);
103int snd_hda_mixer_amp_tlv(struct snd_kcontrol *kcontrol, int op_flag,
104 unsigned int size, unsigned int __user *tlv);
105int snd_hda_mixer_amp_switch_info(struct snd_kcontrol *kcontrol,
106 struct snd_ctl_elem_info *uinfo);
107int snd_hda_mixer_amp_switch_get(struct snd_kcontrol *kcontrol,
108 struct snd_ctl_elem_value *ucontrol);
109int snd_hda_mixer_amp_switch_put(struct snd_kcontrol *kcontrol,
110 struct snd_ctl_elem_value *ucontrol);
Jaroslav Kysela123c07a2009-10-21 14:48:23 +0200111int snd_hda_mixer_amp_switch_put_beep(struct snd_kcontrol *kcontrol,
112 struct snd_ctl_elem_value *ucontrol);
Takashi Iwai834be882006-03-01 14:16:17 +0100113/* lowlevel accessor with caching; use carefully */
114int snd_hda_codec_amp_read(struct hda_codec *codec, hda_nid_t nid, int ch,
115 int direction, int index);
116int snd_hda_codec_amp_update(struct hda_codec *codec, hda_nid_t nid, int ch,
117 int direction, int idx, int mask, int val);
Takashi Iwai47fd8302007-08-10 17:11:07 +0200118int snd_hda_codec_amp_stereo(struct hda_codec *codec, hda_nid_t nid,
119 int dir, int idx, int mask, int val);
Takashi Iwaicb53c622007-08-10 17:21:45 +0200120#ifdef SND_HDA_NEEDS_RESUME
Takashi Iwaib3ac5632007-08-10 17:03:40 +0200121void snd_hda_codec_resume_amp(struct hda_codec *codec);
Takashi Iwai82beb8f2007-08-10 17:09:26 +0200122#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700123
Takashi Iwai2134ea42008-01-10 16:53:55 +0100124void snd_hda_set_vmaster_tlv(struct hda_codec *codec, hda_nid_t nid, int dir,
125 unsigned int *tlv);
126struct snd_kcontrol *snd_hda_find_mixer_ctl(struct hda_codec *codec,
127 const char *name);
128int snd_hda_add_vmaster(struct hda_codec *codec, char *name,
129 unsigned int *tlv, const char **slaves);
Takashi Iwaia65d6292009-02-23 16:57:04 +0100130int snd_hda_codec_reset(struct hda_codec *codec);
Takashi Iwai2134ea42008-01-10 16:53:55 +0100131
Takashi Iwai47fd8302007-08-10 17:11:07 +0200132/* amp value bits */
133#define HDA_AMP_MUTE 0x80
134#define HDA_AMP_UNMUTE 0x00
135#define HDA_AMP_VOLMASK 0x7f
136
Takashi Iwai985be542005-11-02 18:26:49 +0100137/* mono switch binding multiple inputs */
138#define HDA_BIND_MUTE_MONO(xname, nid, channel, indices, direction) \
139 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = 0, \
140 .info = snd_hda_mixer_amp_switch_info, \
141 .get = snd_hda_mixer_bind_switch_get, \
142 .put = snd_hda_mixer_bind_switch_put, \
143 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, indices, direction) }
144
145/* stereo switch binding multiple inputs */
Takashi Iwaid01ce992007-07-27 16:52:19 +0200146#define HDA_BIND_MUTE(xname,nid,indices,dir) \
147 HDA_BIND_MUTE_MONO(xname,nid,3,indices,dir)
Takashi Iwai985be542005-11-02 18:26:49 +0100148
Takashi Iwaid01ce992007-07-27 16:52:19 +0200149int snd_hda_mixer_bind_switch_get(struct snd_kcontrol *kcontrol,
150 struct snd_ctl_elem_value *ucontrol);
151int snd_hda_mixer_bind_switch_put(struct snd_kcontrol *kcontrol,
152 struct snd_ctl_elem_value *ucontrol);
Takashi Iwai985be542005-11-02 18:26:49 +0100153
Takashi Iwai532d5382007-07-27 19:02:40 +0200154/* more generic bound controls */
155struct hda_ctl_ops {
156 snd_kcontrol_info_t *info;
157 snd_kcontrol_get_t *get;
158 snd_kcontrol_put_t *put;
159 snd_kcontrol_tlv_rw_t *tlv;
160};
161
162extern struct hda_ctl_ops snd_hda_bind_vol; /* for bind-volume with TLV */
163extern struct hda_ctl_ops snd_hda_bind_sw; /* for bind-switch */
164
165struct hda_bind_ctls {
166 struct hda_ctl_ops *ops;
Hannes Eder5d9b6c02009-02-25 22:28:45 +0100167 unsigned long values[];
Takashi Iwai532d5382007-07-27 19:02:40 +0200168};
169
170int snd_hda_mixer_bind_ctls_info(struct snd_kcontrol *kcontrol,
171 struct snd_ctl_elem_info *uinfo);
172int snd_hda_mixer_bind_ctls_get(struct snd_kcontrol *kcontrol,
173 struct snd_ctl_elem_value *ucontrol);
174int snd_hda_mixer_bind_ctls_put(struct snd_kcontrol *kcontrol,
175 struct snd_ctl_elem_value *ucontrol);
176int snd_hda_mixer_bind_tlv(struct snd_kcontrol *kcontrol, int op_flag,
177 unsigned int size, unsigned int __user *tlv);
178
179#define HDA_BIND_VOL(xname, bindrec) \
180 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \
181 .name = xname, \
182 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE |\
183 SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
184 SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK,\
185 .info = snd_hda_mixer_bind_ctls_info,\
186 .get = snd_hda_mixer_bind_ctls_get,\
187 .put = snd_hda_mixer_bind_ctls_put,\
188 .tlv = { .c = snd_hda_mixer_bind_tlv },\
189 .private_value = (long) (bindrec) }
190#define HDA_BIND_SW(xname, bindrec) \
191 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER,\
192 .name = xname, \
193 .info = snd_hda_mixer_bind_ctls_info,\
194 .get = snd_hda_mixer_bind_ctls_get,\
195 .put = snd_hda_mixer_bind_ctls_put,\
196 .private_value = (long) (bindrec) }
197
198/*
199 * SPDIF I/O
200 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700201int snd_hda_create_spdif_out_ctls(struct hda_codec *codec, hda_nid_t nid);
202int snd_hda_create_spdif_in_ctls(struct hda_codec *codec, hda_nid_t nid);
203
204/*
205 * input MUX helper
206 */
Takashi Iwai54d17402005-11-21 16:33:22 +0100207#define HDA_MAX_NUM_INPUTS 16
Linus Torvalds1da177e2005-04-16 15:20:36 -0700208struct hda_input_mux_item {
209 const char *label;
210 unsigned int index;
211};
212struct hda_input_mux {
213 unsigned int num_items;
214 struct hda_input_mux_item items[HDA_MAX_NUM_INPUTS];
215};
216
Takashi Iwaid01ce992007-07-27 16:52:19 +0200217int snd_hda_input_mux_info(const struct hda_input_mux *imux,
218 struct snd_ctl_elem_info *uinfo);
219int snd_hda_input_mux_put(struct hda_codec *codec,
220 const struct hda_input_mux *imux,
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100221 struct snd_ctl_elem_value *ucontrol, hda_nid_t nid,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700222 unsigned int *cur_val);
223
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100224/*
Takashi Iwaid2a6d7d2005-11-17 11:06:29 +0100225 * Channel mode helper
226 */
227struct hda_channel_mode {
228 int channels;
229 const struct hda_verb *sequence;
230};
231
Takashi Iwaid01ce992007-07-27 16:52:19 +0200232int snd_hda_ch_mode_info(struct hda_codec *codec,
233 struct snd_ctl_elem_info *uinfo,
234 const struct hda_channel_mode *chmode,
235 int num_chmodes);
236int snd_hda_ch_mode_get(struct hda_codec *codec,
237 struct snd_ctl_elem_value *ucontrol,
238 const struct hda_channel_mode *chmode,
239 int num_chmodes,
Takashi Iwaid2a6d7d2005-11-17 11:06:29 +0100240 int max_channels);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200241int snd_hda_ch_mode_put(struct hda_codec *codec,
242 struct snd_ctl_elem_value *ucontrol,
243 const struct hda_channel_mode *chmode,
244 int num_chmodes,
Takashi Iwaid2a6d7d2005-11-17 11:06:29 +0100245 int *max_channelsp);
246
Linus Torvalds1da177e2005-04-16 15:20:36 -0700247/*
248 * Multi-channel / digital-out PCM helper
249 */
250
251enum { HDA_FRONT, HDA_REAR, HDA_CLFE, HDA_SIDE }; /* index for dac_nidx */
252enum { HDA_DIG_NONE, HDA_DIG_EXCLUSIVE, HDA_DIG_ANALOG_DUP }; /* dig_out_used */
253
254struct hda_multi_out {
255 int num_dacs; /* # of DACs, must be more than 1 */
256 hda_nid_t *dac_nids; /* DAC list */
257 hda_nid_t hp_nid; /* optional DAC for HP, 0 when not exists */
Takashi Iwai82bc9552006-03-21 11:24:42 +0100258 hda_nid_t extra_out_nid[3]; /* optional DACs, 0 when not exists */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700259 hda_nid_t dig_out_nid; /* digital out audio widget */
Wu Fengguangb25c9da2009-02-06 15:02:27 +0800260 hda_nid_t *slave_dig_outs;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700261 int max_channels; /* currently supported analog channels */
262 int dig_out_used; /* current usage of digital out (HDA_DIG_XXX) */
Takashi Iwaid29240c2007-10-26 12:35:56 +0200263 int no_share_stream; /* don't share a stream with multiple pins */
Takashi Iwai9a081602008-02-12 18:37:26 +0100264 int share_spdif; /* share SPDIF pin */
265 /* PCM information for both analog and SPDIF DACs */
266 unsigned int analog_rates;
267 unsigned int analog_maxbps;
268 u64 analog_formats;
269 unsigned int spdif_rates;
270 unsigned int spdif_maxbps;
271 u64 spdif_formats;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700272};
273
Takashi Iwai9a081602008-02-12 18:37:26 +0100274int snd_hda_create_spdif_share_sw(struct hda_codec *codec,
275 struct hda_multi_out *mout);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200276int snd_hda_multi_out_dig_open(struct hda_codec *codec,
277 struct hda_multi_out *mout);
278int snd_hda_multi_out_dig_close(struct hda_codec *codec,
279 struct hda_multi_out *mout);
Takashi Iwai6b97eb42007-04-05 14:51:48 +0200280int snd_hda_multi_out_dig_prepare(struct hda_codec *codec,
281 struct hda_multi_out *mout,
282 unsigned int stream_tag,
283 unsigned int format,
284 struct snd_pcm_substream *substream);
Takashi Iwai9411e212009-02-13 11:32:28 +0100285int snd_hda_multi_out_dig_cleanup(struct hda_codec *codec,
286 struct hda_multi_out *mout);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200287int snd_hda_multi_out_analog_open(struct hda_codec *codec,
288 struct hda_multi_out *mout,
Takashi Iwai9a081602008-02-12 18:37:26 +0100289 struct snd_pcm_substream *substream,
290 struct hda_pcm_stream *hinfo);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200291int snd_hda_multi_out_analog_prepare(struct hda_codec *codec,
292 struct hda_multi_out *mout,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700293 unsigned int stream_tag,
294 unsigned int format,
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100295 struct snd_pcm_substream *substream);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200296int snd_hda_multi_out_analog_cleanup(struct hda_codec *codec,
297 struct hda_multi_out *mout);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700298
299/*
300 * generic codec parser
301 */
Takashi Iwai35a1e0c2007-10-19 08:13:40 +0200302#ifdef CONFIG_SND_HDA_GENERIC
Linus Torvalds1da177e2005-04-16 15:20:36 -0700303int snd_hda_parse_generic_codec(struct hda_codec *codec);
Takashi Iwai35a1e0c2007-10-19 08:13:40 +0200304#else
305static inline int snd_hda_parse_generic_codec(struct hda_codec *codec)
306{
307 return -ENODEV;
308}
309#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700310
311/*
312 * generic proc interface
313 */
314#ifdef CONFIG_PROC_FS
315int snd_hda_codec_proc_new(struct hda_codec *codec);
316#else
317static inline int snd_hda_codec_proc_new(struct hda_codec *codec) { return 0; }
318#endif
319
Wu Fengguang33deeca2008-11-18 11:47:51 +0800320#define SND_PRINT_RATES_ADVISED_BUFSIZE 80
321void snd_print_pcm_rates(int pcm, char *buf, int buflen);
322
Wu Fengguangd39b4352008-11-19 15:14:02 +0800323#define SND_PRINT_BITS_ADVISED_BUFSIZE 16
324void snd_print_pcm_bits(int pcm, char *buf, int buflen);
325
Linus Torvalds1da177e2005-04-16 15:20:36 -0700326/*
327 * Misc
328 */
Takashi Iwaif5fcc132006-11-24 17:07:44 +0100329int snd_hda_check_board_config(struct hda_codec *codec, int num_configs,
330 const char **modelnames,
331 const struct snd_pci_quirk *pci_list);
Mauro Carvalho Chehab2eda3442008-08-11 10:18:39 +0200332int snd_hda_check_board_codec_sid_config(struct hda_codec *codec,
333 int num_configs, const char **models,
334 const struct snd_pci_quirk *tbl);
Takashi Iwaid01ce992007-07-27 16:52:19 +0200335int snd_hda_add_new_ctls(struct hda_codec *codec,
336 struct snd_kcontrol_new *knew);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700337
338/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700339 * unsolicited event handler
340 */
341
342#define HDA_UNSOL_QUEUE_SIZE 64
343
344struct hda_bus_unsolicited {
345 /* ring buffer */
346 u32 queue[HDA_UNSOL_QUEUE_SIZE * 2];
347 unsigned int rp, wp;
348
349 /* workqueue */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700350 struct work_struct work;
David Howellsc4028952006-11-22 14:57:56 +0000351 struct hda_bus *bus;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700352};
353
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200354/*
355 * Helper for automatic ping configuration
356 */
357
358enum {
359 AUTO_PIN_MIC,
360 AUTO_PIN_FRONT_MIC,
361 AUTO_PIN_LINE,
362 AUTO_PIN_FRONT_LINE,
363 AUTO_PIN_CD,
364 AUTO_PIN_AUX,
365 AUTO_PIN_LAST
366};
367
Takashi Iwaid258e242007-04-23 17:16:21 +0200368enum {
369 AUTO_PIN_LINE_OUT,
370 AUTO_PIN_SPEAKER_OUT,
371 AUTO_PIN_HP_OUT
372};
373
Takashi Iwai4a471b72005-12-07 13:56:29 +0100374extern const char *auto_pin_cfg_labels[AUTO_PIN_LAST];
375
Takashi Iwai41923e42007-10-22 17:20:10 +0200376#define AUTO_CFG_MAX_OUTS 5
377
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200378struct auto_pin_cfg {
379 int line_outs;
Takashi Iwai41923e42007-10-22 17:20:10 +0200380 /* sorted in the order of Front/Surr/CLFE/Side */
381 hda_nid_t line_out_pins[AUTO_CFG_MAX_OUTS];
Takashi Iwai82bc9552006-03-21 11:24:42 +0100382 int speaker_outs;
Takashi Iwai41923e42007-10-22 17:20:10 +0200383 hda_nid_t speaker_pins[AUTO_CFG_MAX_OUTS];
Takashi Iwaieb06ed82006-09-20 17:10:27 +0200384 int hp_outs;
Takashi Iwaid258e242007-04-23 17:16:21 +0200385 int line_out_type; /* AUTO_PIN_XXX_OUT */
Takashi Iwai41923e42007-10-22 17:20:10 +0200386 hda_nid_t hp_pins[AUTO_CFG_MAX_OUTS];
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200387 hda_nid_t input_pins[AUTO_PIN_LAST];
Takashi Iwai0852d7a2009-02-11 11:35:15 +0100388 int dig_outs;
389 hda_nid_t dig_out_pins[2];
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200390 hda_nid_t dig_in_pin;
Matthew Ranostay90da78b2008-01-24 11:48:01 +0100391 hda_nid_t mono_out_pin;
Takashi Iwai0852d7a2009-02-11 11:35:15 +0100392 int dig_out_type[2]; /* HDA_PCM_TYPE_XXX */
Takashi Iwai2297bd62009-01-20 18:24:13 +0100393 int dig_in_type; /* HDA_PCM_TYPE_XXX */
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200394};
395
Takashi Iwaid01ce992007-07-27 16:52:19 +0200396#define get_defcfg_connect(cfg) \
397 ((cfg & AC_DEFCFG_PORT_CONN) >> AC_DEFCFG_PORT_CONN_SHIFT)
398#define get_defcfg_association(cfg) \
399 ((cfg & AC_DEFCFG_DEF_ASSOC) >> AC_DEFCFG_ASSOC_SHIFT)
400#define get_defcfg_location(cfg) \
401 ((cfg & AC_DEFCFG_LOCATION) >> AC_DEFCFG_LOCATION_SHIFT)
402#define get_defcfg_sequence(cfg) \
403 (cfg & AC_DEFCFG_SEQUENCE)
404#define get_defcfg_device(cfg) \
405 ((cfg & AC_DEFCFG_DEVICE) >> AC_DEFCFG_DEVICE_SHIFT)
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200406
Takashi Iwaid01ce992007-07-27 16:52:19 +0200407int snd_hda_parse_pin_def_config(struct hda_codec *codec,
408 struct auto_pin_cfg *cfg,
Kailang Yangdf694da2005-12-05 19:42:22 +0100409 hda_nid_t *ignore_nids);
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200410
Takashi Iwai8d88bc32005-11-17 11:09:23 +0100411/* amp values */
412#define AMP_IN_MUTE(idx) (0x7080 | ((idx)<<8))
413#define AMP_IN_UNMUTE(idx) (0x7000 | ((idx)<<8))
Takashi Iwaid301fc32008-10-29 08:15:30 +0100414#define AMP_OUT_MUTE 0xb080
415#define AMP_OUT_UNMUTE 0xb000
416#define AMP_OUT_ZERO 0xb000
Takashi Iwai8d88bc32005-11-17 11:09:23 +0100417/* pinctl values */
Robin H. Johnson35e89012008-09-13 16:54:59 -0700418#define PIN_IN (AC_PINCTL_IN_EN)
Takashi Iwaid301fc32008-10-29 08:15:30 +0100419#define PIN_VREFHIZ (AC_PINCTL_IN_EN | AC_PINCTL_VREF_HIZ)
Robin H. Johnson35e89012008-09-13 16:54:59 -0700420#define PIN_VREF50 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_50)
Takashi Iwaid301fc32008-10-29 08:15:30 +0100421#define PIN_VREFGRD (AC_PINCTL_IN_EN | AC_PINCTL_VREF_GRD)
Robin H. Johnson35e89012008-09-13 16:54:59 -0700422#define PIN_VREF80 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_80)
Takashi Iwaid301fc32008-10-29 08:15:30 +0100423#define PIN_VREF100 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_100)
424#define PIN_OUT (AC_PINCTL_OUT_EN)
Robin H. Johnson35e89012008-09-13 16:54:59 -0700425#define PIN_HP (AC_PINCTL_OUT_EN | AC_PINCTL_HP_EN)
426#define PIN_HP_AMP (AC_PINCTL_HP_EN)
Takashi Iwai8d88bc32005-11-17 11:09:23 +0100427
Takashi Iwai54d17402005-11-21 16:33:22 +0100428/*
429 * get widget capabilities
430 */
431static inline u32 get_wcaps(struct hda_codec *codec, hda_nid_t nid)
432{
433 if (nid < codec->start_nid ||
434 nid >= codec->start_nid + codec->num_nodes)
Takashi Iwaidca008f2008-01-22 15:37:13 +0100435 return 0;
Takashi Iwai54d17402005-11-21 16:33:22 +0100436 return codec->wcaps[nid - codec->start_nid];
437}
438
Takashi Iwaia22d5432009-07-27 12:54:26 +0200439/* get the widget type from widget capability bits */
440#define get_wcaps_type(wcaps) (((wcaps) & AC_WCAP_TYPE) >> AC_WCAP_TYPE_SHIFT)
441
Wu Fengguangfd72d002009-08-24 09:50:46 +0800442static inline unsigned int get_wcaps_channels(u32 wcaps)
443{
444 unsigned int chans;
445
446 chans = (wcaps & AC_WCAP_CHAN_CNT_EXT) >> 13;
447 chans = ((chans << 1) | 1) + 1;
448
449 return chans;
450}
451
Matthew Ranostay09a99952008-01-24 11:49:21 +0100452u32 query_amp_caps(struct hda_codec *codec, hda_nid_t nid, int direction);
Takashi Iwai897cc182007-05-29 19:01:37 +0200453int snd_hda_override_amp_caps(struct hda_codec *codec, hda_nid_t nid, int dir,
454 unsigned int caps);
Takashi Iwai1327a322009-03-23 13:07:47 +0100455u32 snd_hda_query_pin_caps(struct hda_codec *codec, hda_nid_t nid);
Takashi Iwai54d17402005-11-21 16:33:22 +0100456
Jaroslav Kysela3911a4c2009-11-11 13:43:01 +0100457struct hda_nid_item {
458 struct snd_kcontrol *kctl;
459 hda_nid_t nid;
460};
461
462int snd_hda_ctl_add(struct hda_codec *codec, hda_nid_t nid,
463 struct snd_kcontrol *kctl);
Takashi Iwaid13bd412008-07-30 15:01:45 +0200464void snd_hda_ctls_clear(struct hda_codec *codec);
465
Takashi Iwai28073142007-07-27 18:58:06 +0200466/*
467 * hwdep interface
468 */
Takashi Iwaid7ffba12008-07-30 15:01:46 +0200469#ifdef CONFIG_SND_HDA_HWDEP
Takashi Iwai28073142007-07-27 18:58:06 +0200470int snd_hda_create_hwdep(struct hda_codec *codec);
Takashi Iwaid7ffba12008-07-30 15:01:46 +0200471#else
472static inline int snd_hda_create_hwdep(struct hda_codec *codec) { return 0; }
473#endif
Takashi Iwai28073142007-07-27 18:58:06 +0200474
Takashi Iwai72885612009-11-12 10:01:18 +0100475#if defined(CONFIG_SND_HDA_POWER_SAVE) && defined(CONFIG_SND_HDA_HWDEP)
Takashi Iwaia2f63092009-11-11 09:34:25 +0100476int snd_hda_hwdep_add_power_sysfs(struct hda_codec *codec);
477#else
478static inline int snd_hda_hwdep_add_power_sysfs(struct hda_codec *codec)
479{
480 return 0;
481}
482#endif
483
Takashi Iwaie7ee0582008-11-21 09:26:20 +0100484#ifdef CONFIG_SND_HDA_RECONFIG
485int snd_hda_hwdep_add_sysfs(struct hda_codec *codec);
486#else
487static inline int snd_hda_hwdep_add_sysfs(struct hda_codec *codec)
488{
489 return 0;
490}
491#endif
492
Takashi Iwai43b62712009-03-02 14:25:17 +0100493#ifdef CONFIG_SND_HDA_RECONFIG
494const char *snd_hda_get_hint(struct hda_codec *codec, const char *key);
495int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key);
496#else
497static inline
498const char *snd_hda_get_hint(struct hda_codec *codec, const char *key)
499{
500 return NULL;
501}
502
503static inline
504int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key)
505{
506 return -ENOENT;
507}
508#endif
509
Takashi Iwaicb53c622007-08-10 17:21:45 +0200510/*
511 * power-management
512 */
513
514#ifdef CONFIG_SND_HDA_POWER_SAVE
515void snd_hda_schedule_power_save(struct hda_codec *codec);
516
517struct hda_amp_list {
518 hda_nid_t nid;
519 unsigned char dir;
520 unsigned char idx;
521};
522
523struct hda_loopback_check {
524 struct hda_amp_list *amplist;
525 int power_on;
526};
527
528int snd_hda_check_amp_list_power(struct hda_codec *codec,
529 struct hda_loopback_check *check,
530 hda_nid_t nid);
531#endif /* CONFIG_SND_HDA_POWER_SAVE */
532
Matthew Ranostay89385032008-09-11 09:49:39 -0400533/*
534 * AMP control callbacks
535 */
536/* retrieve parameters from private_value */
Jaroslav Kysela3911a4c2009-11-11 13:43:01 +0100537#define get_amp_nid_(pv) ((pv) & 0xffff)
538#define get_amp_nid(kc) get_amp_nid_((kc)->private_value)
Matthew Ranostay89385032008-09-11 09:49:39 -0400539#define get_amp_channels(kc) (((kc)->private_value >> 16) & 0x3)
540#define get_amp_direction(kc) (((kc)->private_value >> 18) & 0x1)
541#define get_amp_index(kc) (((kc)->private_value >> 19) & 0xf)
Takashi Iwai29fdbec2009-01-20 13:07:55 +0100542#define get_amp_offset(kc) (((kc)->private_value >> 23) & 0x3f)
Matthew Ranostay89385032008-09-11 09:49:39 -0400543
Wu Fengguang7f4a9f42008-11-18 11:47:52 +0800544/*
545 * CEA Short Audio Descriptor data
546 */
547struct cea_sad {
548 int channels;
549 int format; /* (format == 0) indicates invalid SAD */
550 int rates;
551 int sample_bits; /* for LPCM */
552 int max_bitrate; /* for AC3...ATRAC */
553 int profile; /* for WMAPRO */
554};
555
556#define ELD_FIXED_BYTES 20
557#define ELD_MAX_MNL 16
558#define ELD_MAX_SAD 16
559
560/*
561 * ELD: EDID Like Data
562 */
Wu Fengguang5b87ebb2008-11-19 15:14:00 +0800563struct hdmi_eld {
Wu Fengguang7f4a9f42008-11-18 11:47:52 +0800564 int eld_size;
565 int baseline_len;
566 int eld_ver; /* (eld_ver == 0) indicates invalid ELD */
567 int cea_edid_ver;
568 char monitor_name[ELD_MAX_MNL + 1];
569 int manufacture_id;
570 int product_id;
571 u64 port_id;
572 int support_hdcp;
573 int support_ai;
574 int conn_type;
575 int aud_synch_delay;
576 int spk_alloc;
577 int sad_count;
578 struct cea_sad sad[ELD_MAX_SAD];
Takashi Iwaif208dba2008-11-21 09:11:50 +0100579#ifdef CONFIG_PROC_FS
580 struct snd_info_entry *proc_entry;
581#endif
Wu Fengguang7f4a9f42008-11-18 11:47:52 +0800582};
583
584int snd_hdmi_get_eld_size(struct hda_codec *codec, hda_nid_t nid);
Wu Fengguang5b87ebb2008-11-19 15:14:00 +0800585int snd_hdmi_get_eld(struct hdmi_eld *, struct hda_codec *, hda_nid_t);
586void snd_hdmi_show_eld(struct hdmi_eld *eld);
Wu Fengguang7f4a9f42008-11-18 11:47:52 +0800587
Wu Fengguang5f1e71b2008-11-18 11:47:53 +0800588#ifdef CONFIG_PROC_FS
Wu Fengguang54a25f82009-10-30 11:44:26 +0100589int snd_hda_eld_proc_new(struct hda_codec *codec, struct hdmi_eld *eld,
590 int index);
Takashi Iwaif208dba2008-11-21 09:11:50 +0100591void snd_hda_eld_proc_free(struct hda_codec *codec, struct hdmi_eld *eld);
Wu Fengguang5f1e71b2008-11-18 11:47:53 +0800592#else
Takashi Iwai06235362008-11-21 08:54:54 +0100593static inline int snd_hda_eld_proc_new(struct hda_codec *codec,
Wu Fengguang54a25f82009-10-30 11:44:26 +0100594 struct hdmi_eld *eld,
595 int index)
Wu Fengguang5f1e71b2008-11-18 11:47:53 +0800596{
597 return 0;
598}
Takashi Iwaif208dba2008-11-21 09:11:50 +0100599static inline void snd_hda_eld_proc_free(struct hda_codec *codec,
600 struct hdmi_eld *eld)
601{
602}
Wu Fengguang5f1e71b2008-11-18 11:47:53 +0800603#endif
604
Wu Fengguang903b21d2008-11-19 08:56:16 +0800605#define SND_PRINT_CHANNEL_ALLOCATION_ADVISED_BUFSIZE 80
606void snd_print_channel_allocation(int spk_alloc, char *buf, int buflen);
607
Linus Torvalds1da177e2005-04-16 15:20:36 -0700608#endif /* __SOUND_HDA_LOCAL_H */