1 /*
2 * Universal Interface for Intel High Definition Audio Codec
3 *
4 * Local helper functions
5 *
6 * Copyright (c) 2004 Takashi Iwai <tiwai@suse.de>
7 *
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU General Public License as published by the Free
10 * Software Foundation; either version 2 of the License, or (at your option)
11 * any later version.
12 *
13 * This program is distributed in the hope that it will be useful, but WITHOUT
14 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 * more details.
17 *
18 * You should have received a copy of the GNU General Public License along with
19 * this program; if not, write to the Free Software Foundation, Inc., 59
20 * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21 */
22
23 #ifndef __SOUND_HDA_LOCAL_H
24 #define __SOUND_HDA_LOCAL_H
25
26 /*
27 * for mixer controls
28 */
29 #define HDA_COMPOSE_AMP_VAL(nid,chs,idx,dir) ((nid) | ((chs)<<16) | ((dir)<<18) | ((idx)<<19))
30 /* mono volume with index (index=0,1,...) (channel=1,2) */
31 #define HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
32 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
33 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | \
34 SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
35 SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK, \
36 .info = snd_hda_mixer_amp_volume_info, \
37 .get = snd_hda_mixer_amp_volume_get, \
38 .put = snd_hda_mixer_amp_volume_put, \
39 .tlv = { .c = snd_hda_mixer_amp_tlv }, \
40 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
41 /* stereo volume with index */
42 #define HDA_CODEC_VOLUME_IDX(xname, xcidx, nid, xindex, direction) \
43 HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)
44 /* mono volume */
45 #define HDA_CODEC_VOLUME_MONO(xname, nid, channel, xindex, direction) \
46 HDA_CODEC_VOLUME_MONO_IDX(xname, 0, nid, channel, xindex, direction)
47 /* stereo volume */
48 #define HDA_CODEC_VOLUME(xname, nid, xindex, direction) \
49 HDA_CODEC_VOLUME_MONO(xname, nid, 3, xindex, direction)
50 /* mono mute switch with index (index=0,1,...) (channel=1,2) */
51 #define HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \
52 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \
53 .info = snd_hda_mixer_amp_switch_info, \
54 .get = snd_hda_mixer_amp_switch_get, \
55 .put = snd_hda_mixer_amp_switch_put, \
56 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }
57 /* stereo mute switch with index */
58 #define HDA_CODEC_MUTE_IDX(xname, xcidx, nid, xindex, direction) \
59 HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)
60 /* mono mute switch */
61 #define HDA_CODEC_MUTE_MONO(xname, nid, channel, xindex, direction) \
62 HDA_CODEC_MUTE_MONO_IDX(xname, 0, nid, channel, xindex, direction)
63 /* stereo mute switch */
64 #define HDA_CODEC_MUTE(xname, nid, xindex, direction) \
65 HDA_CODEC_MUTE_MONO(xname, nid, 3, xindex, direction)
66
67 int snd_hda_mixer_amp_volume_info(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo);
68 int snd_hda_mixer_amp_volume_get(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
69 int snd_hda_mixer_amp_volume_put(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
70 int snd_hda_mixer_amp_tlv(struct snd_kcontrol *kcontrol, int op_flag, unsigned int size, unsigned int __user *tlv);
71 int snd_hda_mixer_amp_switch_info(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo);
72 int snd_hda_mixer_amp_switch_get(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
73 int snd_hda_mixer_amp_switch_put(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
74 /* lowlevel accessor with caching; use carefully */
75 int snd_hda_codec_amp_read(struct hda_codec *codec, hda_nid_t nid, int ch,
76 int direction, int index);
77 int snd_hda_codec_amp_update(struct hda_codec *codec, hda_nid_t nid, int ch,
78 int direction, int idx, int mask, int val);
79
80 /* mono switch binding multiple inputs */
81 #define HDA_BIND_MUTE_MONO(xname, nid, channel, indices, direction) \
82 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = 0, \
83 .info = snd_hda_mixer_amp_switch_info, \
84 .get = snd_hda_mixer_bind_switch_get, \
85 .put = snd_hda_mixer_bind_switch_put, \
86 .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, indices, direction) }
87
88 /* stereo switch binding multiple inputs */
89 #define HDA_BIND_MUTE(xname,nid,indices,dir) HDA_BIND_MUTE_MONO(xname,nid,3,indices,dir)
90
91 int snd_hda_mixer_bind_switch_get(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
92 int snd_hda_mixer_bind_switch_put(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
93
94 /* more generic bound controls */
95 struct hda_ctl_ops {
96 snd_kcontrol_info_t *info;
97 snd_kcontrol_get_t *get;
98 snd_kcontrol_put_t *put;
99 snd_kcontrol_tlv_rw_t *tlv;
100 };
101
102 extern struct hda_ctl_ops snd_hda_bind_vol; /* for bind-volume with TLV */
103 extern struct hda_ctl_ops snd_hda_bind_sw; /* for bind-switch */
104
105 struct hda_bind_ctls {
106 struct hda_ctl_ops *ops;
107 long values[];
108 };
109
110 int snd_hda_mixer_bind_ctls_info(struct snd_kcontrol *kcontrol,
111 struct snd_ctl_elem_info *uinfo);
112 int snd_hda_mixer_bind_ctls_get(struct snd_kcontrol *kcontrol,
113 struct snd_ctl_elem_value *ucontrol);
114 int snd_hda_mixer_bind_ctls_put(struct snd_kcontrol *kcontrol,
115 struct snd_ctl_elem_value *ucontrol);
116 int snd_hda_mixer_bind_tlv(struct snd_kcontrol *kcontrol, int op_flag,
117 unsigned int size, unsigned int __user *tlv);
118
119 #define HDA_BIND_VOL(xname, bindrec) \
120 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \
121 .name = xname, \
122 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE |\
123 SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
124 SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK,\
125 .info = snd_hda_mixer_bind_ctls_info,\
126 .get = snd_hda_mixer_bind_ctls_get,\
127 .put = snd_hda_mixer_bind_ctls_put,\
128 .tlv = { .c = snd_hda_mixer_bind_tlv },\
129 .private_value = (long) (bindrec) }
130 #define HDA_BIND_SW(xname, bindrec) \
131 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER,\
132 .name = xname, \
133 .info = snd_hda_mixer_bind_ctls_info,\
134 .get = snd_hda_mixer_bind_ctls_get,\
135 .put = snd_hda_mixer_bind_ctls_put,\
136 .private_value = (long) (bindrec) }
137
138 /*
139 * SPDIF I/O
140 */
141 int snd_hda_create_spdif_out_ctls(struct hda_codec *codec, hda_nid_t nid);
142 int snd_hda_create_spdif_in_ctls(struct hda_codec *codec, hda_nid_t nid);
143
144 /*
145 * input MUX helper
146 */
147 #define HDA_MAX_NUM_INPUTS 16
148 struct hda_input_mux_item {
149 const char *label;
150 unsigned int index;
151 };
152 struct hda_input_mux {
153 unsigned int num_items;
154 struct hda_input_mux_item items[HDA_MAX_NUM_INPUTS];
155 };
156
157 int snd_hda_input_mux_info(const struct hda_input_mux *imux, struct snd_ctl_elem_info *uinfo);
158 int snd_hda_input_mux_put(struct hda_codec *codec, const struct hda_input_mux *imux,
159 struct snd_ctl_elem_value *ucontrol, hda_nid_t nid,
160 unsigned int *cur_val);
161
162 /*
163 * Channel mode helper
164 */
165 struct hda_channel_mode {
166 int channels;
167 const struct hda_verb *sequence;
168 };
169
170 int snd_hda_ch_mode_info(struct hda_codec *codec, struct snd_ctl_elem_info *uinfo,
171 const struct hda_channel_mode *chmode, int num_chmodes);
172 int snd_hda_ch_mode_get(struct hda_codec *codec, struct snd_ctl_elem_value *ucontrol,
173 const struct hda_channel_mode *chmode, int num_chmodes,
174 int max_channels);
175 int snd_hda_ch_mode_put(struct hda_codec *codec, struct snd_ctl_elem_value *ucontrol,
176 const struct hda_channel_mode *chmode, int num_chmodes,
177 int *max_channelsp);
178
179 /*
180 * Multi-channel / digital-out PCM helper
181 */
182
183 enum { HDA_FRONT, HDA_REAR, HDA_CLFE, HDA_SIDE }; /* index for dac_nidx */
184 enum { HDA_DIG_NONE, HDA_DIG_EXCLUSIVE, HDA_DIG_ANALOG_DUP }; /* dig_out_used */
185
186 struct hda_multi_out {
187 int num_dacs; /* # of DACs, must be more than 1 */
188 hda_nid_t *dac_nids; /* DAC list */
189 hda_nid_t hp_nid; /* optional DAC for HP, 0 when not exists */
190 hda_nid_t extra_out_nid[3]; /* optional DACs, 0 when not exists */
191 hda_nid_t dig_out_nid; /* digital out audio widget */
192 int max_channels; /* currently supported analog channels */
193 int dig_out_used; /* current usage of digital out (HDA_DIG_XXX) */
194 };
195
196 int snd_hda_multi_out_dig_open(struct hda_codec *codec, struct hda_multi_out *mout);
197 int snd_hda_multi_out_dig_close(struct hda_codec *codec, struct hda_multi_out *mout);
198 int snd_hda_multi_out_analog_open(struct hda_codec *codec, struct hda_multi_out *mout,
199 struct snd_pcm_substream *substream);
200 int snd_hda_multi_out_analog_prepare(struct hda_codec *codec, struct hda_multi_out *mout,
201 unsigned int stream_tag,
202 unsigned int format,
203 struct snd_pcm_substream *substream);
204 int snd_hda_multi_out_analog_cleanup(struct hda_codec *codec, struct hda_multi_out *mout);
205
206 /*
207 * generic codec parser
208 */
209 int snd_hda_parse_generic_codec(struct hda_codec *codec);
210
211 /*
212 * generic proc interface
213 */
214 #ifdef CONFIG_PROC_FS
215 int snd_hda_codec_proc_new(struct hda_codec *codec);
216 #else
217 static inline int snd_hda_codec_proc_new(struct hda_codec *codec) { return 0; }
218 #endif
219
220 /*
221 * Misc
222 */
223 int snd_hda_check_board_config(struct hda_codec *codec, int num_configs,
224 const char **modelnames,
225 const struct snd_pci_quirk *pci_list);
226 int snd_hda_add_new_ctls(struct hda_codec *codec, struct snd_kcontrol_new *knew);
227
228 /*
229 * power management
230 */
231 #ifdef CONFIG_PM
232 int snd_hda_resume_ctls(struct hda_codec *codec, struct snd_kcontrol_new *knew);
233 int snd_hda_resume_spdif_out(struct hda_codec *codec);
234 int snd_hda_resume_spdif_in(struct hda_codec *codec);
235 #endif
236
237 /*
238 * unsolicited event handler
239 */
240
241 #define HDA_UNSOL_QUEUE_SIZE 64
242
243 struct hda_bus_unsolicited {
244 /* ring buffer */
245 u32 queue[HDA_UNSOL_QUEUE_SIZE * 2];
246 unsigned int rp, wp;
247
248 /* workqueue */
249 struct workqueue_struct *workq;
250 struct work_struct work;
251 struct hda_bus *bus;
252 };
253
254 /*
255 * Helper for automatic ping configuration
256 */
257
258 enum {
259 AUTO_PIN_MIC,
260 AUTO_PIN_FRONT_MIC,
261 AUTO_PIN_LINE,
262 AUTO_PIN_FRONT_LINE,
263 AUTO_PIN_CD,
264 AUTO_PIN_AUX,
265 AUTO_PIN_LAST
266 };
267
268 extern const char *auto_pin_cfg_labels[AUTO_PIN_LAST];
269
270 struct auto_pin_cfg {
271 int line_outs;
272 hda_nid_t line_out_pins[5]; /* sorted in the order of Front/Surr/CLFE/Side */
273 int speaker_outs;
274 hda_nid_t speaker_pins[5];
275 int hp_outs;
276 hda_nid_t hp_pins[5];
277 hda_nid_t input_pins[AUTO_PIN_LAST];
278 hda_nid_t dig_out_pin;
279 hda_nid_t dig_in_pin;
280 };
281
282 #define get_defcfg_connect(cfg) ((cfg & AC_DEFCFG_PORT_CONN) >> AC_DEFCFG_PORT_CONN_SHIFT)
283 #define get_defcfg_association(cfg) ((cfg & AC_DEFCFG_DEF_ASSOC) >> AC_DEFCFG_ASSOC_SHIFT)
284 #define get_defcfg_location(cfg) ((cfg & AC_DEFCFG_LOCATION) >> AC_DEFCFG_LOCATION_SHIFT)
285 #define get_defcfg_sequence(cfg) (cfg & AC_DEFCFG_SEQUENCE)
286 #define get_defcfg_device(cfg) ((cfg & AC_DEFCFG_DEVICE) >> AC_DEFCFG_DEVICE_SHIFT)
287
288 int snd_hda_parse_pin_def_config(struct hda_codec *codec, struct auto_pin_cfg *cfg,
289 hda_nid_t *ignore_nids);
290
291 /* amp values */
292 #define AMP_IN_MUTE(idx) (0x7080 | ((idx)<<8))
293 #define AMP_IN_UNMUTE(idx) (0x7000 | ((idx)<<8))
294 #define AMP_OUT_MUTE 0xb080
295 #define AMP_OUT_UNMUTE 0xb000
296 #define AMP_OUT_ZERO 0xb000
297 /* pinctl values */
298 #define PIN_IN 0x20
299 #define PIN_VREF80 0x24
300 #define PIN_VREF50 0x21
301 #define PIN_OUT 0x40
302 #define PIN_HP 0xc0
303 #define PIN_HP_AMP 0x80
304
305 /*
306 * get widget capabilities
307 */
308 static inline u32 get_wcaps(struct hda_codec *codec, hda_nid_t nid)
309 {
310 if (nid < codec->start_nid ||
311 nid >= codec->start_nid + codec->num_nodes)
312 return snd_hda_param_read(codec, nid, AC_PAR_AUDIO_WIDGET_CAP);
313 return codec->wcaps[nid - codec->start_nid];
314 }
315
316
317 #endif /* __SOUND_HDA_LOCAL_H */
318
This page was automatically generated by the
LXR engine.
Visit the LXR main site for more
information.