]>
Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * Universal Interface for Intel High Definition Audio Codec | |
3 | * | |
4 | * Copyright (c) 2004 Takashi Iwai <tiwai@suse.de> | |
5 | * | |
6 | * This program is free software; you can redistribute it and/or modify it | |
7 | * under the terms of the GNU General Public License as published by the Free | |
8 | * Software Foundation; either version 2 of the License, or (at your option) | |
9 | * any later version. | |
10 | * | |
11 | * This program is distributed in the hope that it will be useful, but WITHOUT | |
12 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
13 | * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
14 | * more details. | |
15 | * | |
16 | * You should have received a copy of the GNU General Public License along with | |
17 | * this program; if not, write to the Free Software Foundation, Inc., 59 | |
18 | * Temple Place - Suite 330, Boston, MA 02111-1307, USA. | |
19 | */ | |
20 | ||
21 | #ifndef __SOUND_HDA_CODEC_H | |
22 | #define __SOUND_HDA_CODEC_H | |
23 | ||
24 | #include <sound/info.h> | |
25 | #include <sound/control.h> | |
26 | #include <sound/pcm.h> | |
2807314d | 27 | #include <sound/hwdep.h> |
ed326363 | 28 | #include <sound/hda_verbs.h> |
1da177e4 | 29 | |
b2e18597 TI |
30 | /* |
31 | * generic arrays | |
32 | */ | |
33 | struct snd_array { | |
34 | unsigned int used; | |
35 | unsigned int alloced; | |
36 | unsigned int elem_size; | |
37 | unsigned int alloc_align; | |
38 | void *list; | |
39 | }; | |
40 | ||
41 | void *snd_array_new(struct snd_array *array); | |
42 | void snd_array_free(struct snd_array *array); | |
43 | static inline void snd_array_init(struct snd_array *array, unsigned int size, | |
44 | unsigned int align) | |
45 | { | |
46 | array->elem_size = size; | |
47 | array->alloc_align = align; | |
48 | } | |
49 | ||
f43aa025 TI |
50 | static inline void *snd_array_elem(struct snd_array *array, unsigned int idx) |
51 | { | |
52 | return array->list + idx * array->elem_size; | |
53 | } | |
54 | ||
55 | static inline unsigned int snd_array_index(struct snd_array *array, void *ptr) | |
56 | { | |
57 | return (unsigned long)(ptr - array->list) / array->elem_size; | |
58 | } | |
59 | ||
1da177e4 LT |
60 | /* |
61 | * Structures | |
62 | */ | |
63 | ||
64 | struct hda_bus; | |
1cd2224c | 65 | struct hda_beep; |
1da177e4 LT |
66 | struct hda_codec; |
67 | struct hda_pcm; | |
68 | struct hda_pcm_stream; | |
69 | struct hda_bus_unsolicited; | |
70 | ||
71 | /* NID type */ | |
72 | typedef u16 hda_nid_t; | |
73 | ||
74 | /* bus operators */ | |
75 | struct hda_bus_ops { | |
76 | /* send a single command */ | |
33fa35ed | 77 | int (*command)(struct hda_bus *bus, unsigned int cmd); |
1da177e4 | 78 | /* get a response from the last command */ |
deadff16 | 79 | unsigned int (*get_response)(struct hda_bus *bus, unsigned int addr); |
1da177e4 LT |
80 | /* free the private data */ |
81 | void (*private_free)(struct hda_bus *); | |
176d5335 | 82 | /* attach a PCM stream */ |
33fa35ed TI |
83 | int (*attach_pcm)(struct hda_bus *bus, struct hda_codec *codec, |
84 | struct hda_pcm *pcm); | |
8dd78330 TI |
85 | /* reset bus for retry verb */ |
86 | void (*bus_reset)(struct hda_bus *bus); | |
83012a7c | 87 | #ifdef CONFIG_PM |
561de31a | 88 | /* notify power-up/down from codec to controller */ |
68467f51 | 89 | void (*pm_notify)(struct hda_bus *bus, bool power_up); |
cb53c626 | 90 | #endif |
1d1a4564 TI |
91 | #ifdef CONFIG_SND_HDA_DSP_LOADER |
92 | /* prepare DSP transfer */ | |
93 | int (*load_dsp_prepare)(struct hda_bus *bus, unsigned int format, | |
94 | unsigned int byte_size, | |
95 | struct snd_dma_buffer *bufp); | |
96 | /* start/stop DSP transfer */ | |
97 | void (*load_dsp_trigger)(struct hda_bus *bus, bool start); | |
98 | /* clean up DSP transfer */ | |
99 | void (*load_dsp_cleanup)(struct hda_bus *bus, | |
100 | struct snd_dma_buffer *dmab); | |
101 | #endif | |
1da177e4 LT |
102 | }; |
103 | ||
104 | /* template to pass to the bus constructor */ | |
105 | struct hda_bus_template { | |
106 | void *private_data; | |
107 | struct pci_dev *pci; | |
108 | const char *modelname; | |
fee2fba3 | 109 | int *power_save; |
1da177e4 LT |
110 | struct hda_bus_ops ops; |
111 | }; | |
112 | ||
113 | /* | |
114 | * codec bus | |
115 | * | |
116 | * each controller needs to creata a hda_bus to assign the accessor. | |
117 | * A hda_bus contains several codecs in the list codec_list. | |
118 | */ | |
119 | struct hda_bus { | |
c8b6bf9b | 120 | struct snd_card *card; |
1da177e4 LT |
121 | |
122 | /* copied from template */ | |
123 | void *private_data; | |
124 | struct pci_dev *pci; | |
125 | const char *modelname; | |
fee2fba3 | 126 | int *power_save; |
1da177e4 LT |
127 | struct hda_bus_ops ops; |
128 | ||
129 | /* codec linked list */ | |
130 | struct list_head codec_list; | |
0e24dbb7 | 131 | unsigned int num_codecs; |
d01ce99f TI |
132 | /* link caddr -> codec */ |
133 | struct hda_codec *caddr_tbl[HDA_MAX_CODEC_ADDRESS + 1]; | |
1da177e4 | 134 | |
62932df8 | 135 | struct mutex cmd_mutex; |
3f50ac6a | 136 | struct mutex prepare_mutex; |
1da177e4 LT |
137 | |
138 | /* unsolicited event queue */ | |
139 | struct hda_bus_unsolicited *unsol; | |
e8c0ee5d | 140 | char workq_name[16]; |
6acaed38 | 141 | struct workqueue_struct *workq; /* common workqueue for codecs */ |
1da177e4 | 142 | |
529bd6c4 TI |
143 | /* assigned PCMs */ |
144 | DECLARE_BITMAP(pcm_dev_bits, SNDRV_PCM_DEVICES); | |
145 | ||
52987656 TI |
146 | /* misc op flags */ |
147 | unsigned int needs_damn_long_delay :1; | |
b20f3b83 TI |
148 | unsigned int allow_bus_reset:1; /* allow bus reset at fatal error */ |
149 | unsigned int sync_write:1; /* sync after verb write */ | |
150 | /* status for codec/controller */ | |
b94d3539 | 151 | unsigned int shutdown :1; /* being unloaded */ |
b613291f | 152 | unsigned int rirb_error:1; /* error in codec communication */ |
8dd78330 TI |
153 | unsigned int response_reset:1; /* controller was reset */ |
154 | unsigned int in_reset:1; /* during reset operation */ | |
0287d970 | 155 | unsigned int power_keep_link_on:1; /* don't power off HDA link */ |
63e51fd7 | 156 | unsigned int no_response_fallback:1; /* don't fallback at RIRB error */ |
ea9b43ad TI |
157 | |
158 | int primary_dig_out_type; /* primary digital out PCM type */ | |
1da177e4 LT |
159 | }; |
160 | ||
161 | /* | |
162 | * codec preset | |
163 | * | |
164 | * Known codecs have the patch to build and set up the controls/PCMs | |
165 | * better than the generic parser. | |
166 | */ | |
167 | struct hda_codec_preset { | |
168 | unsigned int id; | |
169 | unsigned int mask; | |
170 | unsigned int subs; | |
171 | unsigned int subs_mask; | |
172 | unsigned int rev; | |
ca7cfae9 | 173 | hda_nid_t afg, mfg; |
1da177e4 LT |
174 | const char *name; |
175 | int (*patch)(struct hda_codec *codec); | |
176 | }; | |
177 | ||
1289e9e8 TI |
178 | struct hda_codec_preset_list { |
179 | const struct hda_codec_preset *preset; | |
180 | struct module *owner; | |
181 | struct list_head list; | |
182 | }; | |
183 | ||
184 | /* initial hook */ | |
185 | int snd_hda_add_codec_preset(struct hda_codec_preset_list *preset); | |
186 | int snd_hda_delete_codec_preset(struct hda_codec_preset_list *preset); | |
187 | ||
1da177e4 LT |
188 | /* ops set by the preset patch */ |
189 | struct hda_codec_ops { | |
190 | int (*build_controls)(struct hda_codec *codec); | |
191 | int (*build_pcms)(struct hda_codec *codec); | |
192 | int (*init)(struct hda_codec *codec); | |
193 | void (*free)(struct hda_codec *codec); | |
194 | void (*unsol_event)(struct hda_codec *codec, unsigned int res); | |
4d7fbdbc TI |
195 | void (*set_power_state)(struct hda_codec *codec, hda_nid_t fg, |
196 | unsigned int power_state); | |
2a43952a | 197 | #ifdef CONFIG_PM |
68cb2b55 | 198 | int (*suspend)(struct hda_codec *codec); |
1da177e4 | 199 | int (*resume)(struct hda_codec *codec); |
cb53c626 TI |
200 | int (*check_power_status)(struct hda_codec *codec, hda_nid_t nid); |
201 | #endif | |
fb8d1a34 | 202 | void (*reboot_notify)(struct hda_codec *codec); |
1da177e4 LT |
203 | }; |
204 | ||
205 | /* record for amp information cache */ | |
01751f54 | 206 | struct hda_cache_head { |
c370dd6e TI |
207 | u32 key:31; /* hash key */ |
208 | u32 dirty:1; | |
01751f54 | 209 | u16 val; /* assigned value */ |
c370dd6e | 210 | u16 next; |
01751f54 TI |
211 | }; |
212 | ||
213 | struct hda_amp_info { | |
214 | struct hda_cache_head head; | |
1da177e4 | 215 | u32 amp_caps; /* amp capabilities */ |
7f0e2f8b | 216 | u16 vol[2]; /* current volume & mute */ |
01751f54 TI |
217 | }; |
218 | ||
219 | struct hda_cache_rec { | |
220 | u16 hash[64]; /* hash table for index */ | |
603c4019 | 221 | struct snd_array buf; /* record entries */ |
1da177e4 LT |
222 | }; |
223 | ||
224 | /* PCM callbacks */ | |
225 | struct hda_pcm_ops { | |
226 | int (*open)(struct hda_pcm_stream *info, struct hda_codec *codec, | |
c8b6bf9b | 227 | struct snd_pcm_substream *substream); |
1da177e4 | 228 | int (*close)(struct hda_pcm_stream *info, struct hda_codec *codec, |
c8b6bf9b | 229 | struct snd_pcm_substream *substream); |
1da177e4 LT |
230 | int (*prepare)(struct hda_pcm_stream *info, struct hda_codec *codec, |
231 | unsigned int stream_tag, unsigned int format, | |
c8b6bf9b | 232 | struct snd_pcm_substream *substream); |
1da177e4 | 233 | int (*cleanup)(struct hda_pcm_stream *info, struct hda_codec *codec, |
c8b6bf9b | 234 | struct snd_pcm_substream *substream); |
21229613 TI |
235 | unsigned int (*get_delay)(struct hda_pcm_stream *info, |
236 | struct hda_codec *codec, | |
237 | struct snd_pcm_substream *substream); | |
1da177e4 LT |
238 | }; |
239 | ||
240 | /* PCM information for each substream */ | |
241 | struct hda_pcm_stream { | |
d01ce99f | 242 | unsigned int substreams; /* number of substreams, 0 = not exist*/ |
1da177e4 LT |
243 | unsigned int channels_min; /* min. number of channels */ |
244 | unsigned int channels_max; /* max. number of channels */ | |
245 | hda_nid_t nid; /* default NID to query rates/formats/bps, or set up */ | |
246 | u32 rates; /* supported rates */ | |
247 | u64 formats; /* supported formats (SNDRV_PCM_FMTBIT_) */ | |
248 | unsigned int maxbps; /* supported max. bit per sample */ | |
ee81abb6 | 249 | const struct snd_pcm_chmap_elem *chmap; /* chmap to override */ |
1da177e4 LT |
250 | struct hda_pcm_ops ops; |
251 | }; | |
252 | ||
7ba72ba1 TI |
253 | /* PCM types */ |
254 | enum { | |
255 | HDA_PCM_TYPE_AUDIO, | |
256 | HDA_PCM_TYPE_SPDIF, | |
257 | HDA_PCM_TYPE_HDMI, | |
258 | HDA_PCM_TYPE_MODEM, | |
259 | HDA_PCM_NTYPES | |
260 | }; | |
261 | ||
1da177e4 LT |
262 | /* for PCM creation */ |
263 | struct hda_pcm { | |
264 | char *name; | |
265 | struct hda_pcm_stream stream[2]; | |
7ba72ba1 | 266 | unsigned int pcm_type; /* HDA_PCM_TYPE_XXX */ |
176d5335 TI |
267 | int device; /* device number to assign */ |
268 | struct snd_pcm *pcm; /* assigned PCM instance */ | |
9c9a5175 | 269 | bool own_chmap; /* codec driver provides own channel maps */ |
1da177e4 LT |
270 | }; |
271 | ||
272 | /* codec information */ | |
273 | struct hda_codec { | |
13aeaf68 | 274 | struct device dev; |
1da177e4 LT |
275 | struct hda_bus *bus; |
276 | unsigned int addr; /* codec addr*/ | |
277 | struct list_head list; /* list point */ | |
278 | ||
279 | hda_nid_t afg; /* AFG node id */ | |
673b683a | 280 | hda_nid_t mfg; /* MFG node id */ |
1da177e4 LT |
281 | |
282 | /* ids */ | |
79c944ad JK |
283 | u8 afg_function_id; |
284 | u8 mfg_function_id; | |
285 | u8 afg_unsol; | |
286 | u8 mfg_unsol; | |
1da177e4 LT |
287 | u32 vendor_id; |
288 | u32 subsystem_id; | |
289 | u32 revision_id; | |
290 | ||
291 | /* detected preset */ | |
292 | const struct hda_codec_preset *preset; | |
1289e9e8 | 293 | struct module *owner; |
b21bdd0d | 294 | int (*parser)(struct hda_codec *codec); |
812a2cca TI |
295 | const char *vendor_name; /* codec vendor name */ |
296 | const char *chip_name; /* codec chip name */ | |
f44ac837 | 297 | const char *modelname; /* model name for preset */ |
1da177e4 LT |
298 | |
299 | /* set by patch */ | |
300 | struct hda_codec_ops patch_ops; | |
301 | ||
1da177e4 LT |
302 | /* PCM to create, set by patch_ops.build_pcms callback */ |
303 | unsigned int num_pcms; | |
304 | struct hda_pcm *pcm_info; | |
305 | ||
306 | /* codec specific info */ | |
307 | void *spec; | |
308 | ||
1cd2224c MR |
309 | /* beep device */ |
310 | struct hda_beep *beep; | |
2dca0bba | 311 | unsigned int beep_mode; |
1cd2224c | 312 | |
54d17403 TI |
313 | /* widget capabilities cache */ |
314 | unsigned int num_nodes; | |
315 | hda_nid_t start_nid; | |
316 | u32 *wcaps; | |
317 | ||
d13bd412 | 318 | struct snd_array mixers; /* list of assigned mixer elements */ |
5b0cb1d8 | 319 | struct snd_array nids; /* list of mapped mixer elements */ |
d13bd412 | 320 | |
01751f54 | 321 | struct hda_cache_rec amp_cache; /* cache for amp access */ |
b3ac5636 | 322 | struct hda_cache_rec cmd_cache; /* cache for other commands */ |
1da177e4 | 323 | |
ee8e765b | 324 | struct list_head conn_list; /* linked-list of connection-list */ |
a12d3e1e | 325 | |
62932df8 | 326 | struct mutex spdif_mutex; |
5a9e02e9 | 327 | struct mutex control_mutex; |
c3b6bcc2 | 328 | struct mutex hash_mutex; |
7c935976 | 329 | struct snd_array spdif_out; |
1da177e4 | 330 | unsigned int spdif_in_enable; /* SPDIF input enable? */ |
dda14410 | 331 | const hda_nid_t *slave_dig_outs; /* optional digital out slave widgets */ |
3be14149 | 332 | struct snd_array init_pins; /* initial (BIOS) pin configurations */ |
346ff70f | 333 | struct snd_array driver_pins; /* pin configs set by codec parser */ |
eb541337 | 334 | struct snd_array cvt_setups; /* audio convert setups */ |
2807314d | 335 | |
09b70e85 | 336 | struct mutex user_mutex; |
b989d044 | 337 | #ifdef CONFIG_SND_HDA_RECONFIG |
11aeff08 | 338 | struct snd_array init_verbs; /* additional init verbs */ |
1e1be432 | 339 | struct snd_array hints; /* additional hints */ |
346ff70f | 340 | struct snd_array user_pins; /* default pin configs to override */ |
11aeff08 | 341 | #endif |
cb53c626 | 342 | |
648a8d27 TI |
343 | #ifdef CONFIG_SND_HDA_HWDEP |
344 | struct snd_hwdep *hwdep; /* assigned hwdep device */ | |
345 | #endif | |
346 | ||
963f803f TI |
347 | /* misc flags */ |
348 | unsigned int spdif_status_reset :1; /* needs to toggle SPDIF for each | |
349 | * status change | |
350 | * (e.g. Realtek codecs) | |
351 | */ | |
9421f954 TI |
352 | unsigned int pin_amp_workaround:1; /* pin out-amp takes index |
353 | * (e.g. Conexant codecs) | |
354 | */ | |
4f32456e MK |
355 | unsigned int single_adc_amp:1; /* adc in-amp takes no index |
356 | * (e.g. CX20549 codec) | |
357 | */ | |
0e7adbe2 | 358 | unsigned int no_sticky_stream:1; /* no sticky-PCM stream assignment */ |
ac0547dc | 359 | unsigned int pins_shutup:1; /* pins are shut up */ |
729d55ba | 360 | unsigned int no_trigger_sense:1; /* don't trigger at pin-sensing */ |
71b1e9e4 | 361 | unsigned int no_jack_detect:1; /* Machine has no jack-detection */ |
ecac3ed1 | 362 | unsigned int inv_eapd:1; /* broken h/w: inverted EAPD control */ |
9cc159c6 | 363 | unsigned int inv_jack_detect:1; /* broken h/w: inverted detection bit */ |
ed360813 | 364 | unsigned int pcm_format_first:1; /* PCM format must be set first */ |
983f6b93 | 365 | unsigned int epss:1; /* supporting EPSS? */ |
c370dd6e | 366 | unsigned int cached_write:1; /* write only to caches */ |
f1aa0684 | 367 | unsigned int dp_mst:1; /* support DP1.2 Multi-stream transport */ |
cd262518 | 368 | unsigned int dump_coef:1; /* dump processing coefs in codec proc file */ |
83012a7c | 369 | #ifdef CONFIG_PM |
a221e287 | 370 | unsigned int power_on :1; /* current (global) power-state */ |
4b927345 | 371 | unsigned int d3_stop_clk:1; /* support D3 operation without BCLK */ |
a40e0a88 | 372 | unsigned int pm_up_notified:1; /* PM notified to controller */ |
989c3187 | 373 | unsigned int in_pm:1; /* suspend/resume being performed */ |
a2d96e77 | 374 | int power_transition; /* power-state in transition */ |
cb53c626 TI |
375 | int power_count; /* current (global) power refcount */ |
376 | struct delayed_work power_work; /* delayed task for powerdown */ | |
a2f6309e TI |
377 | unsigned long power_on_acct; |
378 | unsigned long power_off_acct; | |
379 | unsigned long power_jiffies; | |
5536c6d6 | 380 | spinlock_t power_lock; |
cb53c626 | 381 | #endif |
daead538 | 382 | |
9419ab6b TI |
383 | /* filter the requested power state per nid */ |
384 | unsigned int (*power_filter)(struct hda_codec *codec, hda_nid_t nid, | |
385 | unsigned int power_state); | |
386 | ||
daead538 TI |
387 | /* codec-specific additional proc output */ |
388 | void (*proc_widget_hook)(struct snd_info_buffer *buffer, | |
389 | struct hda_codec *codec, hda_nid_t nid); | |
cd372fb3 | 390 | |
1835a0f9 TI |
391 | /* jack detection */ |
392 | struct snd_array jacktbl; | |
26a6cb6c DH |
393 | unsigned long jackpoll_interval; /* In jiffies. Zero means no poll, rely on unsol events */ |
394 | struct delayed_work jackpoll_work; | |
1835a0f9 | 395 | |
cd372fb3 TI |
396 | #ifdef CONFIG_SND_HDA_INPUT_JACK |
397 | /* jack detection */ | |
398 | struct snd_array jacks; | |
399 | #endif | |
c9ce6b26 | 400 | |
7f132927 ML |
401 | int depop_delay; /* depop delay in ms, -1 for default delay time */ |
402 | ||
c9ce6b26 TI |
403 | /* fix-up list */ |
404 | int fixup_id; | |
405 | const struct hda_fixup *fixup_list; | |
406 | const char *fixup_name; | |
407 | ||
408 | /* additional init verbs */ | |
409 | struct snd_array verbs; | |
1da177e4 LT |
410 | }; |
411 | ||
412 | /* direction */ | |
413 | enum { | |
414 | HDA_INPUT, HDA_OUTPUT | |
415 | }; | |
416 | ||
63e51fd7 TI |
417 | /* snd_hda_codec_read/write optional flags */ |
418 | #define HDA_RW_NO_RESPONSE_FALLBACK (1 << 0) | |
1da177e4 LT |
419 | |
420 | /* | |
421 | * constructors | |
422 | */ | |
c8b6bf9b | 423 | int snd_hda_bus_new(struct snd_card *card, const struct hda_bus_template *temp, |
1da177e4 LT |
424 | struct hda_bus **busp); |
425 | int snd_hda_codec_new(struct hda_bus *bus, unsigned int codec_addr, | |
a1e21c90 TI |
426 | struct hda_codec **codecp); |
427 | int snd_hda_codec_configure(struct hda_codec *codec); | |
a15d05db | 428 | int snd_hda_codec_update_widgets(struct hda_codec *codec); |
1da177e4 LT |
429 | |
430 | /* | |
431 | * low level functions | |
432 | */ | |
d01ce99f | 433 | unsigned int snd_hda_codec_read(struct hda_codec *codec, hda_nid_t nid, |
e7ecc27e | 434 | int flags, |
1da177e4 | 435 | unsigned int verb, unsigned int parm); |
e7ecc27e | 436 | int snd_hda_codec_write(struct hda_codec *codec, hda_nid_t nid, int flags, |
1da177e4 | 437 | unsigned int verb, unsigned int parm); |
d01ce99f TI |
438 | #define snd_hda_param_read(codec, nid, param) \ |
439 | snd_hda_codec_read(codec, nid, 0, AC_VERB_PARAMETERS, param) | |
440 | int snd_hda_get_sub_nodes(struct hda_codec *codec, hda_nid_t nid, | |
441 | hda_nid_t *start_id); | |
442 | int snd_hda_get_connections(struct hda_codec *codec, hda_nid_t nid, | |
443 | hda_nid_t *conn_list, int max_conns); | |
09cf03b8 TI |
444 | static inline int |
445 | snd_hda_get_num_conns(struct hda_codec *codec, hda_nid_t nid) | |
446 | { | |
447 | return snd_hda_get_connections(codec, nid, NULL, 0); | |
448 | } | |
4eea3091 | 449 | int snd_hda_get_num_raw_conns(struct hda_codec *codec, hda_nid_t nid); |
9e7717c9 TI |
450 | int snd_hda_get_raw_connections(struct hda_codec *codec, hda_nid_t nid, |
451 | hda_nid_t *conn_list, int max_conns); | |
ee8e765b TI |
452 | int snd_hda_get_conn_list(struct hda_codec *codec, hda_nid_t nid, |
453 | const hda_nid_t **listp); | |
b2f934a0 TI |
454 | int snd_hda_override_conn_list(struct hda_codec *codec, hda_nid_t nid, int nums, |
455 | const hda_nid_t *list); | |
8d087c76 TI |
456 | int snd_hda_get_conn_index(struct hda_codec *codec, hda_nid_t mux, |
457 | hda_nid_t nid, int recursive); | |
f1aa0684 ML |
458 | int snd_hda_get_devices(struct hda_codec *codec, hda_nid_t nid, |
459 | u8 *dev_list, int max_devices); | |
384a48d7 SW |
460 | int snd_hda_query_supported_pcm(struct hda_codec *codec, hda_nid_t nid, |
461 | u32 *ratesp, u64 *formatsp, unsigned int *bpsp); | |
1da177e4 LT |
462 | |
463 | struct hda_verb { | |
464 | hda_nid_t nid; | |
465 | u32 verb; | |
466 | u32 param; | |
467 | }; | |
468 | ||
d01ce99f TI |
469 | void snd_hda_sequence_write(struct hda_codec *codec, |
470 | const struct hda_verb *seq); | |
1da177e4 LT |
471 | |
472 | /* unsolicited event */ | |
473 | int snd_hda_queue_unsol_event(struct hda_bus *bus, u32 res, u32 res_ex); | |
474 | ||
b3ac5636 TI |
475 | /* cached write */ |
476 | int snd_hda_codec_write_cache(struct hda_codec *codec, hda_nid_t nid, | |
e7ecc27e | 477 | int flags, unsigned int verb, unsigned int parm); |
b3ac5636 TI |
478 | void snd_hda_sequence_write_cache(struct hda_codec *codec, |
479 | const struct hda_verb *seq); | |
a68d5a54 | 480 | int snd_hda_codec_update_cache(struct hda_codec *codec, hda_nid_t nid, |
e7ecc27e | 481 | int flags, unsigned int verb, unsigned int parm); |
b3ac5636 | 482 | void snd_hda_codec_resume_cache(struct hda_codec *codec); |
dc870f38 TI |
483 | /* both for cmd & amp caches */ |
484 | void snd_hda_codec_flush_cache(struct hda_codec *codec); | |
0c3d47b0 | 485 | |
3be14149 TI |
486 | /* the struct for codec->pin_configs */ |
487 | struct hda_pincfg { | |
488 | hda_nid_t nid; | |
d7fdc00a TI |
489 | unsigned char ctrl; /* original pin control value */ |
490 | unsigned char target; /* target pin control value */ | |
ac0547dc | 491 | unsigned int cfg; /* default configuration */ |
3be14149 TI |
492 | }; |
493 | ||
494 | unsigned int snd_hda_codec_get_pincfg(struct hda_codec *codec, hda_nid_t nid); | |
495 | int snd_hda_codec_set_pincfg(struct hda_codec *codec, hda_nid_t nid, | |
496 | unsigned int cfg); | |
497 | int snd_hda_add_pincfg(struct hda_codec *codec, struct snd_array *list, | |
498 | hda_nid_t nid, unsigned int cfg); /* for hwdep */ | |
92ee6162 | 499 | void snd_hda_shutup_pins(struct hda_codec *codec); |
3be14149 | 500 | |
7c935976 SW |
501 | /* SPDIF controls */ |
502 | struct hda_spdif_out { | |
503 | hda_nid_t nid; /* Converter nid values relate to */ | |
504 | unsigned int status; /* IEC958 status bits */ | |
505 | unsigned short ctls; /* SPDIF control bits */ | |
506 | }; | |
507 | struct hda_spdif_out *snd_hda_spdif_out_of_nid(struct hda_codec *codec, | |
508 | hda_nid_t nid); | |
74b654c9 SW |
509 | void snd_hda_spdif_ctls_unassign(struct hda_codec *codec, int idx); |
510 | void snd_hda_spdif_ctls_assign(struct hda_codec *codec, int idx, hda_nid_t nid); | |
7c935976 | 511 | |
1da177e4 LT |
512 | /* |
513 | * Mixer | |
514 | */ | |
515 | int snd_hda_build_controls(struct hda_bus *bus); | |
6c1f45ea | 516 | int snd_hda_codec_build_controls(struct hda_codec *codec); |
1da177e4 LT |
517 | |
518 | /* | |
519 | * PCM | |
520 | */ | |
521 | int snd_hda_build_pcms(struct hda_bus *bus); | |
529bd6c4 | 522 | int snd_hda_codec_build_pcms(struct hda_codec *codec); |
eb541337 TI |
523 | |
524 | int snd_hda_codec_prepare(struct hda_codec *codec, | |
525 | struct hda_pcm_stream *hinfo, | |
526 | unsigned int stream, | |
527 | unsigned int format, | |
528 | struct snd_pcm_substream *substream); | |
529 | void snd_hda_codec_cleanup(struct hda_codec *codec, | |
530 | struct hda_pcm_stream *hinfo, | |
531 | struct snd_pcm_substream *substream); | |
532 | ||
d01ce99f TI |
533 | void snd_hda_codec_setup_stream(struct hda_codec *codec, hda_nid_t nid, |
534 | u32 stream_tag, | |
1da177e4 | 535 | int channel_id, int format); |
f0cea797 TI |
536 | void __snd_hda_codec_cleanup_stream(struct hda_codec *codec, hda_nid_t nid, |
537 | int do_now); | |
538 | #define snd_hda_codec_cleanup_stream(codec, nid) \ | |
539 | __snd_hda_codec_cleanup_stream(codec, nid, 0) | |
6194b99d TI |
540 | unsigned int snd_hda_calc_stream_format(struct hda_codec *codec, |
541 | unsigned int rate, | |
d01ce99f TI |
542 | unsigned int channels, |
543 | unsigned int format, | |
32c168c8 AH |
544 | unsigned int maxbps, |
545 | unsigned short spdif_ctls); | |
1da177e4 LT |
546 | int snd_hda_is_supported_format(struct hda_codec *codec, hda_nid_t nid, |
547 | unsigned int format); | |
548 | ||
ee81abb6 TI |
549 | extern const struct snd_pcm_chmap_elem snd_pcm_2_1_chmaps[]; |
550 | ||
1da177e4 LT |
551 | /* |
552 | * Misc | |
553 | */ | |
554 | void snd_hda_get_codec_name(struct hda_codec *codec, char *name, int namelen); | |
fb8d1a34 | 555 | void snd_hda_bus_reboot_notify(struct hda_bus *bus); |
4d7fbdbc | 556 | void snd_hda_codec_set_power_to_all(struct hda_codec *codec, hda_nid_t fg, |
9419ab6b | 557 | unsigned int power_state); |
1da177e4 | 558 | |
d3d020bd TI |
559 | int snd_hda_lock_devices(struct hda_bus *bus); |
560 | void snd_hda_unlock_devices(struct hda_bus *bus); | |
561 | ||
1da177e4 LT |
562 | /* |
563 | * power management | |
564 | */ | |
565 | #ifdef CONFIG_PM | |
8dd78330 | 566 | int snd_hda_suspend(struct hda_bus *bus); |
1da177e4 LT |
567 | int snd_hda_resume(struct hda_bus *bus); |
568 | #endif | |
569 | ||
9e5341b9 TI |
570 | static inline |
571 | int hda_call_check_power_status(struct hda_codec *codec, hda_nid_t nid) | |
572 | { | |
83012a7c | 573 | #ifdef CONFIG_PM |
9e5341b9 TI |
574 | if (codec->patch_ops.check_power_status) |
575 | return codec->patch_ops.check_power_status(codec, nid); | |
ff2b7e2a | 576 | #endif |
9e5341b9 TI |
577 | return 0; |
578 | } | |
9e5341b9 | 579 | |
50a9f790 MR |
580 | /* |
581 | * get widget information | |
582 | */ | |
583 | const char *snd_hda_get_jack_connectivity(u32 cfg); | |
584 | const char *snd_hda_get_jack_type(u32 cfg); | |
585 | const char *snd_hda_get_jack_location(u32 cfg); | |
586 | ||
cb53c626 TI |
587 | /* |
588 | * power saving | |
589 | */ | |
83012a7c | 590 | #ifdef CONFIG_PM |
c376e2c7 | 591 | void snd_hda_power_save(struct hda_codec *codec, int delta, bool d3wait); |
a2f6309e | 592 | void snd_hda_update_power_acct(struct hda_codec *codec); |
cb53c626 | 593 | #else |
c376e2c7 TI |
594 | static inline void snd_hda_power_save(struct hda_codec *codec, int delta, |
595 | bool d3wait) {} | |
cb53c626 TI |
596 | #endif |
597 | ||
c376e2c7 TI |
598 | /** |
599 | * snd_hda_power_up - Power-up the codec | |
600 | * @codec: HD-audio codec | |
601 | * | |
602 | * Increment the power-up counter and power up the hardware really when | |
603 | * not turned on yet. | |
604 | */ | |
605 | static inline void snd_hda_power_up(struct hda_codec *codec) | |
606 | { | |
607 | snd_hda_power_save(codec, 1, false); | |
608 | } | |
609 | ||
610 | /** | |
611 | * snd_hda_power_up_d3wait - Power-up the codec after waiting for any pending | |
612 | * D3 transition to complete. This differs from snd_hda_power_up() when | |
613 | * power_transition == -1. snd_hda_power_up sees this case as a nop, | |
614 | * snd_hda_power_up_d3wait waits for the D3 transition to complete then powers | |
615 | * back up. | |
616 | * @codec: HD-audio codec | |
617 | * | |
618 | * Cancel any power down operation hapenning on the work queue, then power up. | |
619 | */ | |
620 | static inline void snd_hda_power_up_d3wait(struct hda_codec *codec) | |
621 | { | |
622 | snd_hda_power_save(codec, 1, true); | |
623 | } | |
624 | ||
625 | /** | |
626 | * snd_hda_power_down - Power-down the codec | |
627 | * @codec: HD-audio codec | |
628 | * | |
629 | * Decrement the power-up counter and schedules the power-off work if | |
630 | * the counter rearches to zero. | |
631 | */ | |
632 | static inline void snd_hda_power_down(struct hda_codec *codec) | |
633 | { | |
634 | snd_hda_power_save(codec, -1, false); | |
635 | } | |
636 | ||
637 | /** | |
638 | * snd_hda_power_sync - Synchronize the power-save status | |
639 | * @codec: HD-audio codec | |
640 | * | |
641 | * Synchronize the actual power state with the power account; | |
642 | * called when power_save parameter is changed | |
643 | */ | |
644 | static inline void snd_hda_power_sync(struct hda_codec *codec) | |
645 | { | |
646 | snd_hda_power_save(codec, 0, false); | |
647 | } | |
648 | ||
4ea6fbc8 TI |
649 | #ifdef CONFIG_SND_HDA_PATCH_LOADER |
650 | /* | |
651 | * patch firmware | |
652 | */ | |
4918cdab | 653 | int snd_hda_load_patch(struct hda_bus *bus, size_t size, const void *buf); |
4ea6fbc8 TI |
654 | #endif |
655 | ||
1d1a4564 TI |
656 | #ifdef CONFIG_SND_HDA_DSP_LOADER |
657 | static inline int | |
658 | snd_hda_codec_load_dsp_prepare(struct hda_codec *codec, unsigned int format, | |
659 | unsigned int size, | |
660 | struct snd_dma_buffer *bufp) | |
661 | { | |
662 | return codec->bus->ops.load_dsp_prepare(codec->bus, format, size, bufp); | |
663 | } | |
664 | static inline void | |
665 | snd_hda_codec_load_dsp_trigger(struct hda_codec *codec, bool start) | |
666 | { | |
667 | return codec->bus->ops.load_dsp_trigger(codec->bus, start); | |
668 | } | |
669 | static inline void | |
670 | snd_hda_codec_load_dsp_cleanup(struct hda_codec *codec, | |
671 | struct snd_dma_buffer *dmab) | |
672 | { | |
673 | return codec->bus->ops.load_dsp_cleanup(codec->bus, dmab); | |
674 | } | |
675 | #else | |
676 | static inline int | |
677 | snd_hda_codec_load_dsp_prepare(struct hda_codec *codec, unsigned int format, | |
678 | unsigned int size, | |
679 | struct snd_dma_buffer *bufp) | |
680 | { | |
a3af4807 | 681 | return -ENOSYS; |
1d1a4564 TI |
682 | } |
683 | static inline void | |
684 | snd_hda_codec_load_dsp_trigger(struct hda_codec *codec, bool start) {} | |
685 | static inline void | |
686 | snd_hda_codec_load_dsp_cleanup(struct hda_codec *codec, | |
687 | struct snd_dma_buffer *dmab) {} | |
688 | #endif | |
689 | ||
1da177e4 | 690 | #endif /* __SOUND_HDA_CODEC_H */ |