Commit | Line | Data |
---|---|---|
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 | 91 | .info = snd_hda_mixer_amp_switch_info, \ |
0401e854 | 92 | .get = snd_hda_mixer_amp_switch_get_beep, \ |
123c07ae JK |
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 |
107 | extern const char *snd_hda_pcm_type_name[]; |
108 | ||
d01ce99f TI |
109 | int snd_hda_mixer_amp_volume_info(struct snd_kcontrol *kcontrol, |
110 | struct snd_ctl_elem_info *uinfo); | |
111 | int snd_hda_mixer_amp_volume_get(struct snd_kcontrol *kcontrol, | |
112 | struct snd_ctl_elem_value *ucontrol); | |
113 | int snd_hda_mixer_amp_volume_put(struct snd_kcontrol *kcontrol, | |
114 | struct snd_ctl_elem_value *ucontrol); | |
115 | int snd_hda_mixer_amp_tlv(struct snd_kcontrol *kcontrol, int op_flag, | |
116 | unsigned int size, unsigned int __user *tlv); | |
117 | int snd_hda_mixer_amp_switch_info(struct snd_kcontrol *kcontrol, | |
118 | struct snd_ctl_elem_info *uinfo); | |
119 | int snd_hda_mixer_amp_switch_get(struct snd_kcontrol *kcontrol, | |
120 | struct snd_ctl_elem_value *ucontrol); | |
121 | int 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 |
0401e854 TI |
124 | int snd_hda_mixer_amp_switch_get_beep(struct snd_kcontrol *kcontrol, |
125 | struct snd_ctl_elem_value *ucontrol); | |
123c07ae JK |
126 | int snd_hda_mixer_amp_switch_put_beep(struct snd_kcontrol *kcontrol, |
127 | struct snd_ctl_elem_value *ucontrol); | |
67d634c0 | 128 | #endif |
834be88d | 129 | /* lowlevel accessor with caching; use carefully */ |
eeecd9d1 TI |
130 | #define snd_hda_codec_amp_read(codec, nid, ch, dir, idx) \ |
131 | snd_hdac_regmap_get_amp(&(codec)->core, nid, ch, dir, idx) | |
a686ec4c TI |
132 | int snd_hda_codec_amp_update(struct hda_codec *codec, hda_nid_t nid, |
133 | int ch, int dir, int idx, int mask, int val); | |
47fd830a TI |
134 | int snd_hda_codec_amp_stereo(struct hda_codec *codec, hda_nid_t nid, |
135 | int dir, int idx, int mask, int val); | |
280e57d5 TI |
136 | int snd_hda_codec_amp_init(struct hda_codec *codec, hda_nid_t nid, int ch, |
137 | int direction, int idx, int mask, int val); | |
138 | int snd_hda_codec_amp_init_stereo(struct hda_codec *codec, hda_nid_t nid, | |
139 | int dir, int idx, int mask, int val); | |
2134ea4f TI |
140 | void snd_hda_set_vmaster_tlv(struct hda_codec *codec, hda_nid_t nid, int dir, |
141 | unsigned int *tlv); | |
142 | struct snd_kcontrol *snd_hda_find_mixer_ctl(struct hda_codec *codec, | |
143 | const char *name); | |
18478e8b | 144 | int __snd_hda_add_vmaster(struct hda_codec *codec, char *name, |
29e5853d TI |
145 | unsigned int *tlv, const char * const *slaves, |
146 | const char *suffix, bool init_slave_vol, | |
147 | struct snd_kcontrol **ctl_ret); | |
18478e8b | 148 | #define snd_hda_add_vmaster(codec, name, tlv, slaves, suffix) \ |
29e5853d | 149 | __snd_hda_add_vmaster(codec, name, tlv, slaves, suffix, true, NULL) |
a65d629c | 150 | int snd_hda_codec_reset(struct hda_codec *codec); |
c4c2533f | 151 | void snd_hda_codec_register(struct hda_codec *codec); |
9a6246ff | 152 | void snd_hda_codec_cleanup_for_unbind(struct hda_codec *codec); |
2134ea4f | 153 | |
d2f344b5 TI |
154 | enum { |
155 | HDA_VMUTE_OFF, | |
156 | HDA_VMUTE_ON, | |
157 | HDA_VMUTE_FOLLOW_MASTER, | |
158 | }; | |
159 | ||
160 | struct hda_vmaster_mute_hook { | |
161 | /* below two fields must be filled by the caller of | |
162 | * snd_hda_add_vmaster_hook() beforehand | |
163 | */ | |
164 | struct snd_kcontrol *sw_kctl; | |
165 | void (*hook)(void *, int); | |
166 | /* below are initialized automatically */ | |
167 | unsigned int mute_mode; /* HDA_VMUTE_XXX */ | |
168 | struct hda_codec *codec; | |
169 | }; | |
170 | ||
171 | int snd_hda_add_vmaster_hook(struct hda_codec *codec, | |
f29735cb TI |
172 | struct hda_vmaster_mute_hook *hook, |
173 | bool expose_enum_ctl); | |
d2f344b5 TI |
174 | void snd_hda_sync_vmaster_hook(struct hda_vmaster_mute_hook *hook); |
175 | ||
47fd830a TI |
176 | /* amp value bits */ |
177 | #define HDA_AMP_MUTE 0x80 | |
178 | #define HDA_AMP_UNMUTE 0x00 | |
179 | #define HDA_AMP_VOLMASK 0x7f | |
180 | ||
985be54b TI |
181 | /* mono switch binding multiple inputs */ |
182 | #define HDA_BIND_MUTE_MONO(xname, nid, channel, indices, direction) \ | |
183 | { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = 0, \ | |
184 | .info = snd_hda_mixer_amp_switch_info, \ | |
185 | .get = snd_hda_mixer_bind_switch_get, \ | |
186 | .put = snd_hda_mixer_bind_switch_put, \ | |
187 | .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, indices, direction) } | |
188 | ||
189 | /* stereo switch binding multiple inputs */ | |
d01ce99f TI |
190 | #define HDA_BIND_MUTE(xname,nid,indices,dir) \ |
191 | HDA_BIND_MUTE_MONO(xname,nid,3,indices,dir) | |
985be54b | 192 | |
d01ce99f TI |
193 | int snd_hda_mixer_bind_switch_get(struct snd_kcontrol *kcontrol, |
194 | struct snd_ctl_elem_value *ucontrol); | |
195 | int snd_hda_mixer_bind_switch_put(struct snd_kcontrol *kcontrol, | |
196 | struct snd_ctl_elem_value *ucontrol); | |
985be54b | 197 | |
532d5381 TI |
198 | /* more generic bound controls */ |
199 | struct hda_ctl_ops { | |
200 | snd_kcontrol_info_t *info; | |
201 | snd_kcontrol_get_t *get; | |
202 | snd_kcontrol_put_t *put; | |
203 | snd_kcontrol_tlv_rw_t *tlv; | |
204 | }; | |
205 | ||
206 | extern struct hda_ctl_ops snd_hda_bind_vol; /* for bind-volume with TLV */ | |
207 | extern struct hda_ctl_ops snd_hda_bind_sw; /* for bind-switch */ | |
208 | ||
209 | struct hda_bind_ctls { | |
210 | struct hda_ctl_ops *ops; | |
5d9b6c07 | 211 | unsigned long values[]; |
532d5381 TI |
212 | }; |
213 | ||
214 | int snd_hda_mixer_bind_ctls_info(struct snd_kcontrol *kcontrol, | |
215 | struct snd_ctl_elem_info *uinfo); | |
216 | int snd_hda_mixer_bind_ctls_get(struct snd_kcontrol *kcontrol, | |
217 | struct snd_ctl_elem_value *ucontrol); | |
218 | int snd_hda_mixer_bind_ctls_put(struct snd_kcontrol *kcontrol, | |
219 | struct snd_ctl_elem_value *ucontrol); | |
220 | int snd_hda_mixer_bind_tlv(struct snd_kcontrol *kcontrol, int op_flag, | |
221 | unsigned int size, unsigned int __user *tlv); | |
222 | ||
223 | #define HDA_BIND_VOL(xname, bindrec) \ | |
224 | { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \ | |
225 | .name = xname, \ | |
226 | .access = SNDRV_CTL_ELEM_ACCESS_READWRITE |\ | |
227 | SNDRV_CTL_ELEM_ACCESS_TLV_READ |\ | |
228 | SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK,\ | |
229 | .info = snd_hda_mixer_bind_ctls_info,\ | |
230 | .get = snd_hda_mixer_bind_ctls_get,\ | |
231 | .put = snd_hda_mixer_bind_ctls_put,\ | |
232 | .tlv = { .c = snd_hda_mixer_bind_tlv },\ | |
233 | .private_value = (long) (bindrec) } | |
234 | #define HDA_BIND_SW(xname, bindrec) \ | |
235 | { .iface = SNDRV_CTL_ELEM_IFACE_MIXER,\ | |
236 | .name = xname, \ | |
237 | .info = snd_hda_mixer_bind_ctls_info,\ | |
238 | .get = snd_hda_mixer_bind_ctls_get,\ | |
239 | .put = snd_hda_mixer_bind_ctls_put,\ | |
240 | .private_value = (long) (bindrec) } | |
241 | ||
242 | /* | |
243 | * SPDIF I/O | |
244 | */ | |
dcda5806 TI |
245 | int snd_hda_create_dig_out_ctls(struct hda_codec *codec, |
246 | hda_nid_t associated_nid, | |
247 | hda_nid_t cvt_nid, int type); | |
248 | #define snd_hda_create_spdif_out_ctls(codec, anid, cnid) \ | |
249 | snd_hda_create_dig_out_ctls(codec, anid, cnid, HDA_PCM_TYPE_SPDIF) | |
1da177e4 LT |
250 | int snd_hda_create_spdif_in_ctls(struct hda_codec *codec, hda_nid_t nid); |
251 | ||
252 | /* | |
253 | * input MUX helper | |
254 | */ | |
54d17403 | 255 | #define HDA_MAX_NUM_INPUTS 16 |
1da177e4 | 256 | struct hda_input_mux_item { |
b5786e85 | 257 | char label[32]; |
1da177e4 LT |
258 | unsigned int index; |
259 | }; | |
260 | struct hda_input_mux { | |
261 | unsigned int num_items; | |
262 | struct hda_input_mux_item items[HDA_MAX_NUM_INPUTS]; | |
263 | }; | |
264 | ||
d01ce99f TI |
265 | int snd_hda_input_mux_info(const struct hda_input_mux *imux, |
266 | struct snd_ctl_elem_info *uinfo); | |
267 | int snd_hda_input_mux_put(struct hda_codec *codec, | |
268 | const struct hda_input_mux *imux, | |
c8b6bf9b | 269 | struct snd_ctl_elem_value *ucontrol, hda_nid_t nid, |
1da177e4 | 270 | unsigned int *cur_val); |
6194b99d TI |
271 | int snd_hda_add_imux_item(struct hda_codec *codec, |
272 | struct hda_input_mux *imux, const char *label, | |
128bc4ba | 273 | int index, int *type_index_ret); |
1da177e4 LT |
274 | |
275 | /* | |
276 | * Multi-channel / digital-out PCM helper | |
277 | */ | |
278 | ||
279 | enum { HDA_FRONT, HDA_REAR, HDA_CLFE, HDA_SIDE }; /* index for dac_nidx */ | |
280 | enum { HDA_DIG_NONE, HDA_DIG_EXCLUSIVE, HDA_DIG_ANALOG_DUP }; /* dig_out_used */ | |
281 | ||
a06dbfc2 TI |
282 | #define HDA_MAX_OUTS 5 |
283 | ||
1da177e4 LT |
284 | struct hda_multi_out { |
285 | int num_dacs; /* # of DACs, must be more than 1 */ | |
dda14410 | 286 | const hda_nid_t *dac_nids; /* DAC list */ |
1da177e4 | 287 | hda_nid_t hp_nid; /* optional DAC for HP, 0 when not exists */ |
a06dbfc2 TI |
288 | hda_nid_t hp_out_nid[HDA_MAX_OUTS]; /* DACs for multiple HPs */ |
289 | hda_nid_t extra_out_nid[HDA_MAX_OUTS]; /* other (e.g. speaker) DACs */ | |
1da177e4 | 290 | hda_nid_t dig_out_nid; /* digital out audio widget */ |
dda14410 | 291 | const hda_nid_t *slave_dig_outs; |
1da177e4 LT |
292 | int max_channels; /* currently supported analog channels */ |
293 | int dig_out_used; /* current usage of digital out (HDA_DIG_XXX) */ | |
d29240ce | 294 | int no_share_stream; /* don't share a stream with multiple pins */ |
9a08160b TI |
295 | int share_spdif; /* share SPDIF pin */ |
296 | /* PCM information for both analog and SPDIF DACs */ | |
297 | unsigned int analog_rates; | |
298 | unsigned int analog_maxbps; | |
299 | u64 analog_formats; | |
300 | unsigned int spdif_rates; | |
301 | unsigned int spdif_maxbps; | |
302 | u64 spdif_formats; | |
1da177e4 LT |
303 | }; |
304 | ||
9a08160b TI |
305 | int snd_hda_create_spdif_share_sw(struct hda_codec *codec, |
306 | struct hda_multi_out *mout); | |
d01ce99f TI |
307 | int snd_hda_multi_out_dig_open(struct hda_codec *codec, |
308 | struct hda_multi_out *mout); | |
309 | int snd_hda_multi_out_dig_close(struct hda_codec *codec, | |
310 | struct hda_multi_out *mout); | |
6b97eb45 TI |
311 | int snd_hda_multi_out_dig_prepare(struct hda_codec *codec, |
312 | struct hda_multi_out *mout, | |
313 | unsigned int stream_tag, | |
314 | unsigned int format, | |
315 | struct snd_pcm_substream *substream); | |
9411e21c TI |
316 | int snd_hda_multi_out_dig_cleanup(struct hda_codec *codec, |
317 | struct hda_multi_out *mout); | |
d01ce99f TI |
318 | int snd_hda_multi_out_analog_open(struct hda_codec *codec, |
319 | struct hda_multi_out *mout, | |
9a08160b TI |
320 | struct snd_pcm_substream *substream, |
321 | struct hda_pcm_stream *hinfo); | |
d01ce99f TI |
322 | int snd_hda_multi_out_analog_prepare(struct hda_codec *codec, |
323 | struct hda_multi_out *mout, | |
1da177e4 LT |
324 | unsigned int stream_tag, |
325 | unsigned int format, | |
c8b6bf9b | 326 | struct snd_pcm_substream *substream); |
d01ce99f TI |
327 | int snd_hda_multi_out_analog_cleanup(struct hda_codec *codec, |
328 | struct hda_multi_out *mout); | |
1da177e4 | 329 | |
1da177e4 LT |
330 | /* |
331 | * generic proc interface | |
332 | */ | |
cd6a6503 | 333 | #ifdef CONFIG_SND_PROC_FS |
1da177e4 LT |
334 | int snd_hda_codec_proc_new(struct hda_codec *codec); |
335 | #else | |
336 | static inline int snd_hda_codec_proc_new(struct hda_codec *codec) { return 0; } | |
337 | #endif | |
338 | ||
d39b4352 WF |
339 | #define SND_PRINT_BITS_ADVISED_BUFSIZE 16 |
340 | void snd_print_pcm_bits(int pcm, char *buf, int buflen); | |
341 | ||
1da177e4 LT |
342 | /* |
343 | * Misc | |
344 | */ | |
d01ce99f | 345 | int snd_hda_add_new_ctls(struct hda_codec *codec, |
031024ee | 346 | const struct snd_kcontrol_new *knew); |
1da177e4 | 347 | |
c9ce6b26 TI |
348 | /* |
349 | * Fix-up pin default configurations and add default verbs | |
350 | */ | |
351 | ||
352 | struct hda_pintbl { | |
353 | hda_nid_t nid; | |
354 | u32 val; | |
355 | }; | |
356 | ||
357 | struct hda_model_fixup { | |
358 | const int id; | |
359 | const char *name; | |
360 | }; | |
361 | ||
362 | struct hda_fixup { | |
363 | int type; | |
1f578250 TI |
364 | bool chained:1; /* call the chained fixup(s) after this */ |
365 | bool chained_before:1; /* call the chained fixup(s) before this */ | |
c9ce6b26 TI |
366 | int chain_id; |
367 | union { | |
368 | const struct hda_pintbl *pins; | |
369 | const struct hda_verb *verbs; | |
370 | void (*func)(struct hda_codec *codec, | |
371 | const struct hda_fixup *fix, | |
372 | int action); | |
373 | } v; | |
374 | }; | |
375 | ||
20531415 DH |
376 | struct snd_hda_pin_quirk { |
377 | unsigned int codec; /* Codec vendor/device ID */ | |
378 | unsigned short subvendor; /* PCI subvendor ID */ | |
379 | const struct hda_pintbl *pins; /* list of matching pins */ | |
380 | #ifdef CONFIG_SND_DEBUG_VERBOSE | |
381 | const char *name; | |
382 | #endif | |
383 | int value; /* quirk value */ | |
384 | }; | |
385 | ||
a2d2fa02 DH |
386 | #ifdef CONFIG_SND_DEBUG_VERBOSE |
387 | ||
388 | #define SND_HDA_PIN_QUIRK(_codec, _subvendor, _name, _value, _pins...) \ | |
389 | { .codec = _codec,\ | |
390 | .subvendor = _subvendor,\ | |
391 | .name = _name,\ | |
392 | .value = _value,\ | |
fb54a645 | 393 | .pins = (const struct hda_pintbl[]) { _pins, {0, 0}} \ |
a2d2fa02 DH |
394 | } |
395 | #else | |
396 | ||
397 | #define SND_HDA_PIN_QUIRK(_codec, _subvendor, _name, _value, _pins...) \ | |
398 | { .codec = _codec,\ | |
399 | .subvendor = _subvendor,\ | |
400 | .value = _value,\ | |
fb54a645 | 401 | .pins = (const struct hda_pintbl[]) { _pins, {0, 0}} \ |
a2d2fa02 DH |
402 | } |
403 | ||
404 | #endif | |
405 | ||
f5662e1c DH |
406 | #define HDA_FIXUP_ID_NOT_SET -1 |
407 | #define HDA_FIXUP_ID_NO_FIXUP -2 | |
a2d2fa02 | 408 | |
c9ce6b26 TI |
409 | /* fixup types */ |
410 | enum { | |
411 | HDA_FIXUP_INVALID, | |
412 | HDA_FIXUP_PINS, | |
413 | HDA_FIXUP_VERBS, | |
414 | HDA_FIXUP_FUNC, | |
fd108215 | 415 | HDA_FIXUP_PINCTLS, |
c9ce6b26 TI |
416 | }; |
417 | ||
418 | /* fixup action definitions */ | |
419 | enum { | |
420 | HDA_FIXUP_ACT_PRE_PROBE, | |
421 | HDA_FIXUP_ACT_PROBE, | |
422 | HDA_FIXUP_ACT_INIT, | |
423 | HDA_FIXUP_ACT_BUILD, | |
360fec28 | 424 | HDA_FIXUP_ACT_FREE, |
c9ce6b26 TI |
425 | }; |
426 | ||
427 | int snd_hda_add_verbs(struct hda_codec *codec, const struct hda_verb *list); | |
428 | void snd_hda_apply_verbs(struct hda_codec *codec); | |
429 | void snd_hda_apply_pincfgs(struct hda_codec *codec, | |
430 | const struct hda_pintbl *cfg); | |
431 | void snd_hda_apply_fixup(struct hda_codec *codec, int action); | |
432 | void snd_hda_pick_fixup(struct hda_codec *codec, | |
433 | const struct hda_model_fixup *models, | |
434 | const struct snd_pci_quirk *quirk, | |
435 | const struct hda_fixup *fixlist); | |
20531415 DH |
436 | void snd_hda_pick_pin_fixup(struct hda_codec *codec, |
437 | const struct snd_hda_pin_quirk *pin_quirk, | |
438 | const struct hda_fixup *fixlist); | |
439 | ||
128bc4ba | 440 | /* helper macros to retrieve pin default-config values */ |
d01ce99f TI |
441 | #define get_defcfg_connect(cfg) \ |
442 | ((cfg & AC_DEFCFG_PORT_CONN) >> AC_DEFCFG_PORT_CONN_SHIFT) | |
443 | #define get_defcfg_association(cfg) \ | |
444 | ((cfg & AC_DEFCFG_DEF_ASSOC) >> AC_DEFCFG_ASSOC_SHIFT) | |
445 | #define get_defcfg_location(cfg) \ | |
446 | ((cfg & AC_DEFCFG_LOCATION) >> AC_DEFCFG_LOCATION_SHIFT) | |
447 | #define get_defcfg_sequence(cfg) \ | |
448 | (cfg & AC_DEFCFG_SEQUENCE) | |
449 | #define get_defcfg_device(cfg) \ | |
450 | ((cfg & AC_DEFCFG_DEVICE) >> AC_DEFCFG_DEVICE_SHIFT) | |
08a1f5eb TI |
451 | #define get_defcfg_misc(cfg) \ |
452 | ((cfg & AC_DEFCFG_MISC) >> AC_DEFCFG_MISC_SHIFT) | |
d01ce99f | 453 | |
8d88bc3d TI |
454 | /* amp values */ |
455 | #define AMP_IN_MUTE(idx) (0x7080 | ((idx)<<8)) | |
456 | #define AMP_IN_UNMUTE(idx) (0x7000 | ((idx)<<8)) | |
d301fc32 TI |
457 | #define AMP_OUT_MUTE 0xb080 |
458 | #define AMP_OUT_UNMUTE 0xb000 | |
459 | #define AMP_OUT_ZERO 0xb000 | |
8d88bc3d | 460 | /* pinctl values */ |
35e8901e | 461 | #define PIN_IN (AC_PINCTL_IN_EN) |
d301fc32 | 462 | #define PIN_VREFHIZ (AC_PINCTL_IN_EN | AC_PINCTL_VREF_HIZ) |
35e8901e | 463 | #define PIN_VREF50 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_50) |
d301fc32 | 464 | #define PIN_VREFGRD (AC_PINCTL_IN_EN | AC_PINCTL_VREF_GRD) |
35e8901e | 465 | #define PIN_VREF80 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_80) |
d301fc32 TI |
466 | #define PIN_VREF100 (AC_PINCTL_IN_EN | AC_PINCTL_VREF_100) |
467 | #define PIN_OUT (AC_PINCTL_OUT_EN) | |
35e8901e RJ |
468 | #define PIN_HP (AC_PINCTL_OUT_EN | AC_PINCTL_HP_EN) |
469 | #define PIN_HP_AMP (AC_PINCTL_HP_EN) | |
8d88bc3d | 470 | |
4740860b | 471 | unsigned int snd_hda_get_default_vref(struct hda_codec *codec, hda_nid_t pin); |
62f3a2f7 TI |
472 | unsigned int snd_hda_correct_pin_ctl(struct hda_codec *codec, |
473 | hda_nid_t pin, unsigned int val); | |
cdd03ced TI |
474 | int _snd_hda_set_pin_ctl(struct hda_codec *codec, hda_nid_t pin, |
475 | unsigned int val, bool cached); | |
476 | ||
477 | /** | |
478 | * _snd_hda_set_pin_ctl - Set a pin-control value safely | |
479 | * @codec: the codec instance | |
480 | * @pin: the pin NID to set the control | |
481 | * @val: the pin-control value (AC_PINCTL_* bits) | |
482 | * | |
483 | * This function sets the pin-control value to the given pin, but | |
484 | * filters out the invalid pin-control bits when the pin has no such | |
485 | * capabilities. For example, when PIN_HP is passed but the pin has no | |
486 | * HP-drive capability, the HP bit is omitted. | |
487 | * | |
488 | * The function doesn't check the input VREF capability bits, though. | |
4740860b | 489 | * Use snd_hda_get_default_vref() to guess the right value. |
cdd03ced TI |
490 | * Also, this function is only for analog pins, not for HDMI pins. |
491 | */ | |
492 | static inline int | |
493 | snd_hda_set_pin_ctl(struct hda_codec *codec, hda_nid_t pin, unsigned int val) | |
494 | { | |
495 | return _snd_hda_set_pin_ctl(codec, pin, val, false); | |
496 | } | |
497 | ||
498 | /** | |
499 | * snd_hda_set_pin_ctl_cache - Set a pin-control value safely | |
500 | * @codec: the codec instance | |
501 | * @pin: the pin NID to set the control | |
502 | * @val: the pin-control value (AC_PINCTL_* bits) | |
503 | * | |
504 | * Just like snd_hda_set_pin_ctl() but write to cache as well. | |
505 | */ | |
506 | static inline int | |
507 | snd_hda_set_pin_ctl_cache(struct hda_codec *codec, hda_nid_t pin, | |
508 | unsigned int val) | |
509 | { | |
510 | return _snd_hda_set_pin_ctl(codec, pin, val, true); | |
511 | } | |
512 | ||
d7fdc00a TI |
513 | int snd_hda_codec_get_pin_target(struct hda_codec *codec, hda_nid_t nid); |
514 | int snd_hda_codec_set_pin_target(struct hda_codec *codec, hda_nid_t nid, | |
515 | unsigned int val); | |
516 | ||
7639a06c TI |
517 | #define for_each_hda_codec_node(nid, codec) \ |
518 | for ((nid) = (codec)->core.start_nid; (nid) < (codec)->core.end_nid; (nid)++) | |
519 | ||
54d17403 TI |
520 | /* |
521 | * get widget capabilities | |
522 | */ | |
523 | static inline u32 get_wcaps(struct hda_codec *codec, hda_nid_t nid) | |
524 | { | |
7639a06c TI |
525 | if (nid < codec->core.start_nid || |
526 | nid >= codec->core.start_nid + codec->core.num_nodes) | |
dca008f3 | 527 | return 0; |
7639a06c | 528 | return codec->wcaps[nid - codec->core.start_nid]; |
54d17403 TI |
529 | } |
530 | ||
a22d543a | 531 | /* get the widget type from widget capability bits */ |
3a90274d TI |
532 | static inline int get_wcaps_type(unsigned int wcaps) |
533 | { | |
534 | if (!wcaps) | |
535 | return -1; /* invalid type */ | |
536 | return (wcaps & AC_WCAP_TYPE) >> AC_WCAP_TYPE_SHIFT; | |
537 | } | |
a22d543a | 538 | |
fd72d008 WF |
539 | static inline unsigned int get_wcaps_channels(u32 wcaps) |
540 | { | |
541 | unsigned int chans; | |
542 | ||
543 | chans = (wcaps & AC_WCAP_CHAN_CNT_EXT) >> 13; | |
544 | chans = ((chans << 1) | 1) + 1; | |
545 | ||
546 | return chans; | |
547 | } | |
548 | ||
d045c5dc TI |
549 | static inline void snd_hda_override_wcaps(struct hda_codec *codec, |
550 | hda_nid_t nid, u32 val) | |
551 | { | |
7639a06c TI |
552 | if (nid >= codec->core.start_nid && |
553 | nid < codec->core.start_nid + codec->core.num_nodes) | |
554 | codec->wcaps[nid - codec->core.start_nid] = val; | |
d045c5dc TI |
555 | } |
556 | ||
09a99959 | 557 | u32 query_amp_caps(struct hda_codec *codec, hda_nid_t nid, int direction); |
897cc188 TI |
558 | int snd_hda_override_amp_caps(struct hda_codec *codec, hda_nid_t nid, int dir, |
559 | unsigned int caps); | |
faa75f8a TI |
560 | /** |
561 | * snd_hda_query_pin_caps - Query PIN capabilities | |
562 | * @codec: the HD-auio codec | |
563 | * @nid: the NID to query | |
564 | * | |
565 | * Query PIN capabilities for the given widget. | |
566 | * Returns the obtained capability bits. | |
567 | * | |
568 | * When cap bits have been already read, this doesn't read again but | |
569 | * returns the cached value. | |
570 | */ | |
571 | static inline u32 | |
572 | snd_hda_query_pin_caps(struct hda_codec *codec, hda_nid_t nid) | |
573 | { | |
574 | return snd_hda_param_read(codec, nid, AC_PAR_PIN_CAP); | |
575 | ||
576 | } | |
577 | ||
578 | /** | |
579 | * snd_hda_override_pin_caps - Override the pin capabilities | |
580 | * @codec: the CODEC | |
581 | * @nid: the NID to override | |
582 | * @caps: the capability bits to set | |
583 | * | |
584 | * Override the cached PIN capabilitiy bits value by the given one. | |
585 | * | |
586 | * Returns zero if successful or a negative error code. | |
587 | */ | |
588 | static inline int | |
589 | snd_hda_override_pin_caps(struct hda_codec *codec, hda_nid_t nid, | |
590 | unsigned int caps) | |
591 | { | |
592 | return snd_hdac_override_parm(&codec->core, nid, AC_PAR_PIN_CAP, caps); | |
593 | } | |
594 | ||
861a04ed DH |
595 | bool snd_hda_check_amp_caps(struct hda_codec *codec, hda_nid_t nid, |
596 | int dir, unsigned int bits); | |
597 | ||
598 | #define nid_has_mute(codec, nid, dir) \ | |
599 | snd_hda_check_amp_caps(codec, nid, dir, (AC_AMPCAP_MUTE | AC_AMPCAP_MIN_MUTE)) | |
600 | #define nid_has_volume(codec, nid, dir) \ | |
601 | snd_hda_check_amp_caps(codec, nid, dir, AC_AMPCAP_NUM_STEPS) | |
602 | ||
03697e2a | 603 | |
9e3fd871 JK |
604 | /* flags for hda_nid_item */ |
605 | #define HDA_NID_ITEM_AMP (1<<0) | |
606 | ||
3911a4c1 JK |
607 | struct hda_nid_item { |
608 | struct snd_kcontrol *kctl; | |
5b0cb1d8 | 609 | unsigned int index; |
3911a4c1 | 610 | hda_nid_t nid; |
9e3fd871 | 611 | unsigned short flags; |
3911a4c1 JK |
612 | }; |
613 | ||
614 | int snd_hda_ctl_add(struct hda_codec *codec, hda_nid_t nid, | |
615 | struct snd_kcontrol *kctl); | |
5b0cb1d8 JK |
616 | int snd_hda_add_nid(struct hda_codec *codec, struct snd_kcontrol *kctl, |
617 | unsigned int index, hda_nid_t nid); | |
d13bd412 TI |
618 | void snd_hda_ctls_clear(struct hda_codec *codec); |
619 | ||
2807314d TI |
620 | /* |
621 | * hwdep interface | |
622 | */ | |
d7ffba19 | 623 | #ifdef CONFIG_SND_HDA_HWDEP |
2807314d | 624 | int snd_hda_create_hwdep(struct hda_codec *codec); |
d7ffba19 TI |
625 | #else |
626 | static inline int snd_hda_create_hwdep(struct hda_codec *codec) { return 0; } | |
627 | #endif | |
2807314d | 628 | |
648a8d27 TI |
629 | void snd_hda_sysfs_init(struct hda_codec *codec); |
630 | void snd_hda_sysfs_clear(struct hda_codec *codec); | |
631 | ||
632 | extern const struct attribute_group *snd_hda_dev_attr_groups[]; | |
633 | ||
43b62713 TI |
634 | #ifdef CONFIG_SND_HDA_RECONFIG |
635 | const char *snd_hda_get_hint(struct hda_codec *codec, const char *key); | |
636 | int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key); | |
bc759721 | 637 | int snd_hda_get_int_hint(struct hda_codec *codec, const char *key, int *valp); |
43b62713 TI |
638 | #else |
639 | static inline | |
640 | const char *snd_hda_get_hint(struct hda_codec *codec, const char *key) | |
641 | { | |
642 | return NULL; | |
643 | } | |
644 | ||
645 | static inline | |
646 | int snd_hda_get_bool_hint(struct hda_codec *codec, const char *key) | |
647 | { | |
648 | return -ENOENT; | |
649 | } | |
bc759721 TI |
650 | |
651 | static inline | |
652 | int snd_hda_get_int_hint(struct hda_codec *codec, const char *key, int *valp) | |
653 | { | |
654 | return -ENOENT; | |
655 | } | |
43b62713 TI |
656 | #endif |
657 | ||
cb53c626 TI |
658 | /* |
659 | * power-management | |
660 | */ | |
661 | ||
cb53c626 TI |
662 | void snd_hda_schedule_power_save(struct hda_codec *codec); |
663 | ||
664 | struct hda_amp_list { | |
665 | hda_nid_t nid; | |
666 | unsigned char dir; | |
667 | unsigned char idx; | |
668 | }; | |
669 | ||
670 | struct hda_loopback_check { | |
031024ee | 671 | const struct hda_amp_list *amplist; |
cb53c626 TI |
672 | int power_on; |
673 | }; | |
674 | ||
675 | int snd_hda_check_amp_list_power(struct hda_codec *codec, | |
676 | struct hda_loopback_check *check, | |
677 | hda_nid_t nid); | |
cb53c626 | 678 | |
9040d102 TI |
679 | /* check whether the actual power state matches with the target state */ |
680 | static inline bool | |
681 | snd_hda_check_power_state(struct hda_codec *codec, hda_nid_t nid, | |
682 | unsigned int target_state) | |
683 | { | |
70b4891c | 684 | return snd_hdac_check_power_state(&codec->core, nid, target_state); |
9040d102 TI |
685 | } |
686 | ||
ba615b86 TI |
687 | unsigned int snd_hda_codec_eapd_power_filter(struct hda_codec *codec, |
688 | hda_nid_t nid, | |
689 | unsigned int power_state); | |
690 | ||
89385035 MR |
691 | /* |
692 | * AMP control callbacks | |
693 | */ | |
694 | /* retrieve parameters from private_value */ | |
3911a4c1 JK |
695 | #define get_amp_nid_(pv) ((pv) & 0xffff) |
696 | #define get_amp_nid(kc) get_amp_nid_((kc)->private_value) | |
89385035 | 697 | #define get_amp_channels(kc) (((kc)->private_value >> 16) & 0x3) |
527e4d73 TI |
698 | #define get_amp_direction_(pv) (((pv) >> 18) & 0x1) |
699 | #define get_amp_direction(kc) get_amp_direction_((kc)->private_value) | |
130e5f06 TI |
700 | #define get_amp_index_(pv) (((pv) >> 19) & 0xf) |
701 | #define get_amp_index(kc) get_amp_index_((kc)->private_value) | |
29fdbec2 | 702 | #define get_amp_offset(kc) (((kc)->private_value >> 23) & 0x3f) |
de8c85f7 | 703 | #define get_amp_min_mute(kc) (((kc)->private_value >> 29) & 0x1) |
89385035 | 704 | |
dda415d4 TI |
705 | /* |
706 | * enum control helper | |
707 | */ | |
708 | int snd_hda_enum_helper_info(struct snd_kcontrol *kcontrol, | |
709 | struct snd_ctl_elem_info *uinfo, | |
710 | int num_entries, const char * const *texts); | |
711 | #define snd_hda_enum_bool_helper_info(kcontrol, uinfo) \ | |
712 | snd_hda_enum_helper_info(kcontrol, uinfo, 0, NULL) | |
713 | ||
7f4a9f43 WF |
714 | /* |
715 | * CEA Short Audio Descriptor data | |
716 | */ | |
717 | struct cea_sad { | |
718 | int channels; | |
719 | int format; /* (format == 0) indicates invalid SAD */ | |
720 | int rates; | |
721 | int sample_bits; /* for LPCM */ | |
722 | int max_bitrate; /* for AC3...ATRAC */ | |
723 | int profile; /* for WMAPRO */ | |
724 | }; | |
725 | ||
726 | #define ELD_FIXED_BYTES 20 | |
14bc52b8 | 727 | #define ELD_MAX_SIZE 256 |
7f4a9f43 WF |
728 | #define ELD_MAX_MNL 16 |
729 | #define ELD_MAX_SAD 16 | |
730 | ||
731 | /* | |
732 | * ELD: EDID Like Data | |
733 | */ | |
1613d6b4 DH |
734 | struct parsed_hdmi_eld { |
735 | /* | |
736 | * all fields will be cleared before updating ELD | |
737 | */ | |
7f4a9f43 | 738 | int baseline_len; |
23ccc2bd | 739 | int eld_ver; |
7f4a9f43 WF |
740 | int cea_edid_ver; |
741 | char monitor_name[ELD_MAX_MNL + 1]; | |
742 | int manufacture_id; | |
743 | int product_id; | |
744 | u64 port_id; | |
745 | int support_hdcp; | |
746 | int support_ai; | |
747 | int conn_type; | |
748 | int aud_synch_delay; | |
749 | int spk_alloc; | |
750 | int sad_count; | |
751 | struct cea_sad sad[ELD_MAX_SAD]; | |
1613d6b4 DH |
752 | }; |
753 | ||
754 | struct hdmi_eld { | |
755 | bool monitor_present; | |
756 | bool eld_valid; | |
757 | int eld_size; | |
14bc52b8 | 758 | char eld_buffer[ELD_MAX_SIZE]; |
1613d6b4 | 759 | struct parsed_hdmi_eld info; |
7f4a9f43 WF |
760 | }; |
761 | ||
762 | int snd_hdmi_get_eld_size(struct hda_codec *codec, hda_nid_t nid); | |
1613d6b4 DH |
763 | int snd_hdmi_get_eld(struct hda_codec *codec, hda_nid_t nid, |
764 | unsigned char *buf, int *eld_size); | |
79514d47 | 765 | int snd_hdmi_parse_eld(struct hda_codec *codec, struct parsed_hdmi_eld *e, |
1613d6b4 | 766 | const unsigned char *buf, int size); |
79514d47 | 767 | void snd_hdmi_show_eld(struct hda_codec *codec, struct parsed_hdmi_eld *e); |
1613d6b4 | 768 | void snd_hdmi_eld_update_pcm_info(struct parsed_hdmi_eld *e, |
2def8172 | 769 | struct hda_pcm_stream *hinfo); |
7f4a9f43 | 770 | |
89250f84 AH |
771 | int snd_hdmi_get_eld_ati(struct hda_codec *codec, hda_nid_t nid, |
772 | unsigned char *buf, int *eld_size, | |
773 | bool rev3_or_later); | |
774 | ||
cd6a6503 | 775 | #ifdef CONFIG_SND_PROC_FS |
a4e9a38b TI |
776 | void snd_hdmi_print_eld_info(struct hdmi_eld *eld, |
777 | struct snd_info_buffer *buffer); | |
778 | void snd_hdmi_write_eld_info(struct hdmi_eld *eld, | |
779 | struct snd_info_buffer *buffer); | |
5f1e71b1 WF |
780 | #endif |
781 | ||
903b21d8 WF |
782 | #define SND_PRINT_CHANNEL_ALLOCATION_ADVISED_BUFSIZE 80 |
783 | void snd_print_channel_allocation(int spk_alloc, char *buf, int buflen); | |
784 | ||
4e76a883 TI |
785 | /* |
786 | */ | |
d8a766a1 TI |
787 | #define codec_err(codec, fmt, args...) \ |
788 | dev_err(hda_codec_dev(codec), fmt, ##args) | |
789 | #define codec_warn(codec, fmt, args...) \ | |
790 | dev_warn(hda_codec_dev(codec), fmt, ##args) | |
791 | #define codec_info(codec, fmt, args...) \ | |
792 | dev_info(hda_codec_dev(codec), fmt, ##args) | |
793 | #define codec_dbg(codec, fmt, args...) \ | |
794 | dev_dbg(hda_codec_dev(codec), fmt, ##args) | |
4e76a883 | 795 | |
1da177e4 | 796 | #endif /* __SOUND_HDA_LOCAL_H */ |