Loading...
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>
27#include <sound/hwdep.h>
28#include <sound/hda_verbs.h>
29
30/*
31 * generic arrays
32 */
33struct 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
41void *snd_array_new(struct snd_array *array);
42void snd_array_free(struct snd_array *array);
43static 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
50static inline void *snd_array_elem(struct snd_array *array, unsigned int idx)
51{
52 return array->list + idx * array->elem_size;
53}
54
55static 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
60/*
61 * Structures
62 */
63
64struct hda_bus;
65struct hda_beep;
66struct hda_codec;
67struct hda_pcm;
68struct hda_pcm_stream;
69struct hda_bus_unsolicited;
70
71/* NID type */
72typedef u16 hda_nid_t;
73
74/* bus operators */
75struct hda_bus_ops {
76 /* send a single command */
77 int (*command)(struct hda_bus *bus, unsigned int cmd);
78 /* get a response from the last command */
79 unsigned int (*get_response)(struct hda_bus *bus, unsigned int addr);
80 /* free the private data */
81 void (*private_free)(struct hda_bus *);
82 /* attach a PCM stream */
83 int (*attach_pcm)(struct hda_bus *bus, struct hda_codec *codec,
84 struct hda_pcm *pcm);
85 /* reset bus for retry verb */
86 void (*bus_reset)(struct hda_bus *bus);
87#ifdef CONFIG_PM
88 /* notify power-up/down from codec to controller */
89 void (*pm_notify)(struct hda_bus *bus, bool power_up);
90#endif
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
102};
103
104/* template to pass to the bus constructor */
105struct hda_bus_template {
106 void *private_data;
107 struct pci_dev *pci;
108 const char *modelname;
109 int *power_save;
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 */
119struct hda_bus {
120 struct snd_card *card;
121
122 /* copied from template */
123 void *private_data;
124 struct pci_dev *pci;
125 const char *modelname;
126 int *power_save;
127 struct hda_bus_ops ops;
128
129 /* codec linked list */
130 struct list_head codec_list;
131 unsigned int num_codecs;
132 /* link caddr -> codec */
133 struct hda_codec *caddr_tbl[HDA_MAX_CODEC_ADDRESS + 1];
134
135 struct mutex cmd_mutex;
136 struct mutex prepare_mutex;
137
138 /* unsolicited event queue */
139 struct hda_bus_unsolicited *unsol;
140 char workq_name[16];
141 struct workqueue_struct *workq; /* common workqueue for codecs */
142
143 /* assigned PCMs */
144 DECLARE_BITMAP(pcm_dev_bits, SNDRV_PCM_DEVICES);
145
146 /* misc op flags */
147 unsigned int needs_damn_long_delay :1;
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 */
151 unsigned int shutdown :1; /* being unloaded */
152 unsigned int rirb_error:1; /* error in codec communication */
153 unsigned int response_reset:1; /* controller was reset */
154 unsigned int in_reset:1; /* during reset operation */
155 unsigned int power_keep_link_on:1; /* don't power off HDA link */
156 unsigned int no_response_fallback:1; /* don't fallback at RIRB error */
157
158 int primary_dig_out_type; /* primary digital out PCM type */
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 */
167struct hda_codec_preset {
168 unsigned int id;
169 unsigned int mask;
170 unsigned int subs;
171 unsigned int subs_mask;
172 unsigned int rev;
173 hda_nid_t afg, mfg;
174 const char *name;
175 int (*patch)(struct hda_codec *codec);
176};
177
178struct 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 */
185int snd_hda_add_codec_preset(struct hda_codec_preset_list *preset);
186int snd_hda_delete_codec_preset(struct hda_codec_preset_list *preset);
187
188/* ops set by the preset patch */
189struct 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);
195 void (*set_power_state)(struct hda_codec *codec, hda_nid_t fg,
196 unsigned int power_state);
197#ifdef CONFIG_PM
198 int (*suspend)(struct hda_codec *codec);
199 int (*resume)(struct hda_codec *codec);
200 int (*check_power_status)(struct hda_codec *codec, hda_nid_t nid);
201#endif
202 void (*reboot_notify)(struct hda_codec *codec);
203};
204
205/* record for amp information cache */
206struct hda_cache_head {
207 u32 key:31; /* hash key */
208 u32 dirty:1;
209 u16 val; /* assigned value */
210 u16 next;
211};
212
213struct hda_amp_info {
214 struct hda_cache_head head;
215 u32 amp_caps; /* amp capabilities */
216 u16 vol[2]; /* current volume & mute */
217};
218
219struct hda_cache_rec {
220 u16 hash[64]; /* hash table for index */
221 struct snd_array buf; /* record entries */
222};
223
224/* PCM callbacks */
225struct hda_pcm_ops {
226 int (*open)(struct hda_pcm_stream *info, struct hda_codec *codec,
227 struct snd_pcm_substream *substream);
228 int (*close)(struct hda_pcm_stream *info, struct hda_codec *codec,
229 struct snd_pcm_substream *substream);
230 int (*prepare)(struct hda_pcm_stream *info, struct hda_codec *codec,
231 unsigned int stream_tag, unsigned int format,
232 struct snd_pcm_substream *substream);
233 int (*cleanup)(struct hda_pcm_stream *info, struct hda_codec *codec,
234 struct snd_pcm_substream *substream);
235 unsigned int (*get_delay)(struct hda_pcm_stream *info,
236 struct hda_codec *codec,
237 struct snd_pcm_substream *substream);
238};
239
240/* PCM information for each substream */
241struct hda_pcm_stream {
242 unsigned int substreams; /* number of substreams, 0 = not exist*/
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 */
249 const struct snd_pcm_chmap_elem *chmap; /* chmap to override */
250 struct hda_pcm_ops ops;
251};
252
253/* PCM types */
254enum {
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
262/* for PCM creation */
263struct hda_pcm {
264 char *name;
265 struct hda_pcm_stream stream[2];
266 unsigned int pcm_type; /* HDA_PCM_TYPE_XXX */
267 int device; /* device number to assign */
268 struct snd_pcm *pcm; /* assigned PCM instance */
269 bool own_chmap; /* codec driver provides own channel maps */
270};
271
272/* codec information */
273struct hda_codec {
274 struct device dev;
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 */
280 hda_nid_t mfg; /* MFG node id */
281
282 /* ids */
283 u8 afg_function_id;
284 u8 mfg_function_id;
285 u8 afg_unsol;
286 u8 mfg_unsol;
287 u32 vendor_id;
288 u32 subsystem_id;
289 u32 revision_id;
290
291 /* detected preset */
292 const struct hda_codec_preset *preset;
293 struct module *owner;
294 int (*parser)(struct hda_codec *codec);
295 const char *vendor_name; /* codec vendor name */
296 const char *chip_name; /* codec chip name */
297 const char *modelname; /* model name for preset */
298
299 /* set by patch */
300 struct hda_codec_ops patch_ops;
301
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
309 /* beep device */
310 struct hda_beep *beep;
311 unsigned int beep_mode;
312
313 /* widget capabilities cache */
314 unsigned int num_nodes;
315 hda_nid_t start_nid;
316 u32 *wcaps;
317
318 struct snd_array mixers; /* list of assigned mixer elements */
319 struct snd_array nids; /* list of mapped mixer elements */
320
321 struct hda_cache_rec amp_cache; /* cache for amp access */
322 struct hda_cache_rec cmd_cache; /* cache for other commands */
323
324 struct list_head conn_list; /* linked-list of connection-list */
325
326 struct mutex spdif_mutex;
327 struct mutex control_mutex;
328 struct mutex hash_mutex;
329 struct snd_array spdif_out;
330 unsigned int spdif_in_enable; /* SPDIF input enable? */
331 const hda_nid_t *slave_dig_outs; /* optional digital out slave widgets */
332 struct snd_array init_pins; /* initial (BIOS) pin configurations */
333 struct snd_array driver_pins; /* pin configs set by codec parser */
334 struct snd_array cvt_setups; /* audio convert setups */
335
336 struct mutex user_mutex;
337#ifdef CONFIG_SND_HDA_RECONFIG
338 struct snd_array init_verbs; /* additional init verbs */
339 struct snd_array hints; /* additional hints */
340 struct snd_array user_pins; /* default pin configs to override */
341#endif
342
343#ifdef CONFIG_SND_HDA_HWDEP
344 struct snd_hwdep *hwdep; /* assigned hwdep device */
345#endif
346
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 */
352 unsigned int pin_amp_workaround:1; /* pin out-amp takes index
353 * (e.g. Conexant codecs)
354 */
355 unsigned int single_adc_amp:1; /* adc in-amp takes no index
356 * (e.g. CX20549 codec)
357 */
358 unsigned int no_sticky_stream:1; /* no sticky-PCM stream assignment */
359 unsigned int pins_shutup:1; /* pins are shut up */
360 unsigned int no_trigger_sense:1; /* don't trigger at pin-sensing */
361 unsigned int no_jack_detect:1; /* Machine has no jack-detection */
362 unsigned int inv_eapd:1; /* broken h/w: inverted EAPD control */
363 unsigned int inv_jack_detect:1; /* broken h/w: inverted detection bit */
364 unsigned int pcm_format_first:1; /* PCM format must be set first */
365 unsigned int epss:1; /* supporting EPSS? */
366 unsigned int cached_write:1; /* write only to caches */
367 unsigned int dp_mst:1; /* support DP1.2 Multi-stream transport */
368 unsigned int dump_coef:1; /* dump processing coefs in codec proc file */
369#ifdef CONFIG_PM
370 unsigned int power_on :1; /* current (global) power-state */
371 unsigned int d3_stop_clk:1; /* support D3 operation without BCLK */
372 unsigned int pm_up_notified:1; /* PM notified to controller */
373 unsigned int in_pm:1; /* suspend/resume being performed */
374 int power_transition; /* power-state in transition */
375 int power_count; /* current (global) power refcount */
376 struct delayed_work power_work; /* delayed task for powerdown */
377 unsigned long power_on_acct;
378 unsigned long power_off_acct;
379 unsigned long power_jiffies;
380 spinlock_t power_lock;
381#endif
382
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
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);
390
391 /* jack detection */
392 struct snd_array jacktbl;
393 unsigned long jackpoll_interval; /* In jiffies. Zero means no poll, rely on unsol events */
394 struct delayed_work jackpoll_work;
395
396#ifdef CONFIG_SND_HDA_INPUT_JACK
397 /* jack detection */
398 struct snd_array jacks;
399#endif
400
401 int depop_delay; /* depop delay in ms, -1 for default delay time */
402
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;
410};
411
412/* direction */
413enum {
414 HDA_INPUT, HDA_OUTPUT
415};
416
417/* snd_hda_codec_read/write optional flags */
418#define HDA_RW_NO_RESPONSE_FALLBACK (1 << 0)
419
420/*
421 * constructors
422 */
423int snd_hda_bus_new(struct snd_card *card, const struct hda_bus_template *temp,
424 struct hda_bus **busp);
425int snd_hda_codec_new(struct hda_bus *bus, unsigned int codec_addr,
426 struct hda_codec **codecp);
427int snd_hda_codec_configure(struct hda_codec *codec);
428int snd_hda_codec_update_widgets(struct hda_codec *codec);
429
430/*
431 * low level functions
432 */
433unsigned int snd_hda_codec_read(struct hda_codec *codec, hda_nid_t nid,
434 int flags,
435 unsigned int verb, unsigned int parm);
436int snd_hda_codec_write(struct hda_codec *codec, hda_nid_t nid, int flags,
437 unsigned int verb, unsigned int parm);
438#define snd_hda_param_read(codec, nid, param) \
439 snd_hda_codec_read(codec, nid, 0, AC_VERB_PARAMETERS, param)
440int snd_hda_get_sub_nodes(struct hda_codec *codec, hda_nid_t nid,
441 hda_nid_t *start_id);
442int snd_hda_get_connections(struct hda_codec *codec, hda_nid_t nid,
443 hda_nid_t *conn_list, int max_conns);
444static inline int
445snd_hda_get_num_conns(struct hda_codec *codec, hda_nid_t nid)
446{
447 return snd_hda_get_connections(codec, nid, NULL, 0);
448}
449int snd_hda_get_num_raw_conns(struct hda_codec *codec, hda_nid_t nid);
450int snd_hda_get_raw_connections(struct hda_codec *codec, hda_nid_t nid,
451 hda_nid_t *conn_list, int max_conns);
452int snd_hda_get_conn_list(struct hda_codec *codec, hda_nid_t nid,
453 const hda_nid_t **listp);
454int snd_hda_override_conn_list(struct hda_codec *codec, hda_nid_t nid, int nums,
455 const hda_nid_t *list);
456int snd_hda_get_conn_index(struct hda_codec *codec, hda_nid_t mux,
457 hda_nid_t nid, int recursive);
458int snd_hda_get_devices(struct hda_codec *codec, hda_nid_t nid,
459 u8 *dev_list, int max_devices);
460int snd_hda_query_supported_pcm(struct hda_codec *codec, hda_nid_t nid,
461 u32 *ratesp, u64 *formatsp, unsigned int *bpsp);
462
463struct hda_verb {
464 hda_nid_t nid;
465 u32 verb;
466 u32 param;
467};
468
469void snd_hda_sequence_write(struct hda_codec *codec,
470 const struct hda_verb *seq);
471
472/* unsolicited event */
473int snd_hda_queue_unsol_event(struct hda_bus *bus, u32 res, u32 res_ex);
474
475/* cached write */
476int snd_hda_codec_write_cache(struct hda_codec *codec, hda_nid_t nid,
477 int flags, unsigned int verb, unsigned int parm);
478void snd_hda_sequence_write_cache(struct hda_codec *codec,
479 const struct hda_verb *seq);
480int snd_hda_codec_update_cache(struct hda_codec *codec, hda_nid_t nid,
481 int flags, unsigned int verb, unsigned int parm);
482void snd_hda_codec_resume_cache(struct hda_codec *codec);
483/* both for cmd & amp caches */
484void snd_hda_codec_flush_cache(struct hda_codec *codec);
485
486/* the struct for codec->pin_configs */
487struct hda_pincfg {
488 hda_nid_t nid;
489 unsigned char ctrl; /* original pin control value */
490 unsigned char target; /* target pin control value */
491 unsigned int cfg; /* default configuration */
492};
493
494unsigned int snd_hda_codec_get_pincfg(struct hda_codec *codec, hda_nid_t nid);
495int snd_hda_codec_set_pincfg(struct hda_codec *codec, hda_nid_t nid,
496 unsigned int cfg);
497int snd_hda_add_pincfg(struct hda_codec *codec, struct snd_array *list,
498 hda_nid_t nid, unsigned int cfg); /* for hwdep */
499void snd_hda_shutup_pins(struct hda_codec *codec);
500
501/* SPDIF controls */
502struct 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};
507struct hda_spdif_out *snd_hda_spdif_out_of_nid(struct hda_codec *codec,
508 hda_nid_t nid);
509void snd_hda_spdif_ctls_unassign(struct hda_codec *codec, int idx);
510void snd_hda_spdif_ctls_assign(struct hda_codec *codec, int idx, hda_nid_t nid);
511
512/*
513 * Mixer
514 */
515int snd_hda_build_controls(struct hda_bus *bus);
516int snd_hda_codec_build_controls(struct hda_codec *codec);
517
518/*
519 * PCM
520 */
521int snd_hda_build_pcms(struct hda_bus *bus);
522int snd_hda_codec_build_pcms(struct hda_codec *codec);
523
524int 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);
529void snd_hda_codec_cleanup(struct hda_codec *codec,
530 struct hda_pcm_stream *hinfo,
531 struct snd_pcm_substream *substream);
532
533void snd_hda_codec_setup_stream(struct hda_codec *codec, hda_nid_t nid,
534 u32 stream_tag,
535 int channel_id, int format);
536void __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)
540unsigned int snd_hda_calc_stream_format(unsigned int rate,
541 unsigned int channels,
542 unsigned int format,
543 unsigned int maxbps,
544 unsigned short spdif_ctls);
545int snd_hda_is_supported_format(struct hda_codec *codec, hda_nid_t nid,
546 unsigned int format);
547
548extern const struct snd_pcm_chmap_elem snd_pcm_2_1_chmaps[];
549
550/*
551 * Misc
552 */
553void snd_hda_get_codec_name(struct hda_codec *codec, char *name, int namelen);
554void snd_hda_bus_reboot_notify(struct hda_bus *bus);
555void snd_hda_codec_set_power_to_all(struct hda_codec *codec, hda_nid_t fg,
556 unsigned int power_state);
557
558int snd_hda_lock_devices(struct hda_bus *bus);
559void snd_hda_unlock_devices(struct hda_bus *bus);
560
561/*
562 * power management
563 */
564#ifdef CONFIG_PM
565int snd_hda_suspend(struct hda_bus *bus);
566int snd_hda_resume(struct hda_bus *bus);
567#endif
568
569static inline
570int hda_call_check_power_status(struct hda_codec *codec, hda_nid_t nid)
571{
572#ifdef CONFIG_PM
573 if (codec->patch_ops.check_power_status)
574 return codec->patch_ops.check_power_status(codec, nid);
575#endif
576 return 0;
577}
578
579/*
580 * get widget information
581 */
582const char *snd_hda_get_jack_connectivity(u32 cfg);
583const char *snd_hda_get_jack_type(u32 cfg);
584const char *snd_hda_get_jack_location(u32 cfg);
585
586/*
587 * power saving
588 */
589#ifdef CONFIG_PM
590void snd_hda_power_save(struct hda_codec *codec, int delta, bool d3wait);
591void snd_hda_update_power_acct(struct hda_codec *codec);
592#else
593static inline void snd_hda_power_save(struct hda_codec *codec, int delta,
594 bool d3wait) {}
595#endif
596
597/**
598 * snd_hda_power_up - Power-up the codec
599 * @codec: HD-audio codec
600 *
601 * Increment the power-up counter and power up the hardware really when
602 * not turned on yet.
603 */
604static inline void snd_hda_power_up(struct hda_codec *codec)
605{
606 snd_hda_power_save(codec, 1, false);
607}
608
609/**
610 * snd_hda_power_up_d3wait - Power-up the codec after waiting for any pending
611 * D3 transition to complete. This differs from snd_hda_power_up() when
612 * power_transition == -1. snd_hda_power_up sees this case as a nop,
613 * snd_hda_power_up_d3wait waits for the D3 transition to complete then powers
614 * back up.
615 * @codec: HD-audio codec
616 *
617 * Cancel any power down operation hapenning on the work queue, then power up.
618 */
619static inline void snd_hda_power_up_d3wait(struct hda_codec *codec)
620{
621 snd_hda_power_save(codec, 1, true);
622}
623
624/**
625 * snd_hda_power_down - Power-down the codec
626 * @codec: HD-audio codec
627 *
628 * Decrement the power-up counter and schedules the power-off work if
629 * the counter rearches to zero.
630 */
631static inline void snd_hda_power_down(struct hda_codec *codec)
632{
633 snd_hda_power_save(codec, -1, false);
634}
635
636/**
637 * snd_hda_power_sync - Synchronize the power-save status
638 * @codec: HD-audio codec
639 *
640 * Synchronize the actual power state with the power account;
641 * called when power_save parameter is changed
642 */
643static inline void snd_hda_power_sync(struct hda_codec *codec)
644{
645 snd_hda_power_save(codec, 0, false);
646}
647
648#ifdef CONFIG_SND_HDA_PATCH_LOADER
649/*
650 * patch firmware
651 */
652int snd_hda_load_patch(struct hda_bus *bus, size_t size, const void *buf);
653#endif
654
655#ifdef CONFIG_SND_HDA_DSP_LOADER
656static inline int
657snd_hda_codec_load_dsp_prepare(struct hda_codec *codec, unsigned int format,
658 unsigned int size,
659 struct snd_dma_buffer *bufp)
660{
661 return codec->bus->ops.load_dsp_prepare(codec->bus, format, size, bufp);
662}
663static inline void
664snd_hda_codec_load_dsp_trigger(struct hda_codec *codec, bool start)
665{
666 return codec->bus->ops.load_dsp_trigger(codec->bus, start);
667}
668static inline void
669snd_hda_codec_load_dsp_cleanup(struct hda_codec *codec,
670 struct snd_dma_buffer *dmab)
671{
672 return codec->bus->ops.load_dsp_cleanup(codec->bus, dmab);
673}
674#else
675static inline int
676snd_hda_codec_load_dsp_prepare(struct hda_codec *codec, unsigned int format,
677 unsigned int size,
678 struct snd_dma_buffer *bufp)
679{
680 return -ENOSYS;
681}
682static inline void
683snd_hda_codec_load_dsp_trigger(struct hda_codec *codec, bool start) {}
684static inline void
685snd_hda_codec_load_dsp_cleanup(struct hda_codec *codec,
686 struct snd_dma_buffer *dmab) {}
687#endif
688
689#define EXPORT_SYMBOL_HDA(sym) EXPORT_SYMBOL_GPL(sym)
690
691#endif /* __SOUND_HDA_CODEC_H */
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>
27#include <sound/hwdep.h>
28
29/*
30 * nodes
31 */
32#define AC_NODE_ROOT 0x00
33
34/*
35 * function group types
36 */
37enum {
38 AC_GRP_AUDIO_FUNCTION = 0x01,
39 AC_GRP_MODEM_FUNCTION = 0x02,
40};
41
42/*
43 * widget types
44 */
45enum {
46 AC_WID_AUD_OUT, /* Audio Out */
47 AC_WID_AUD_IN, /* Audio In */
48 AC_WID_AUD_MIX, /* Audio Mixer */
49 AC_WID_AUD_SEL, /* Audio Selector */
50 AC_WID_PIN, /* Pin Complex */
51 AC_WID_POWER, /* Power */
52 AC_WID_VOL_KNB, /* Volume Knob */
53 AC_WID_BEEP, /* Beep Generator */
54 AC_WID_VENDOR = 0x0f /* Vendor specific */
55};
56
57/*
58 * GET verbs
59 */
60#define AC_VERB_GET_STREAM_FORMAT 0x0a00
61#define AC_VERB_GET_AMP_GAIN_MUTE 0x0b00
62#define AC_VERB_GET_PROC_COEF 0x0c00
63#define AC_VERB_GET_COEF_INDEX 0x0d00
64#define AC_VERB_PARAMETERS 0x0f00
65#define AC_VERB_GET_CONNECT_SEL 0x0f01
66#define AC_VERB_GET_CONNECT_LIST 0x0f02
67#define AC_VERB_GET_PROC_STATE 0x0f03
68#define AC_VERB_GET_SDI_SELECT 0x0f04
69#define AC_VERB_GET_POWER_STATE 0x0f05
70#define AC_VERB_GET_CONV 0x0f06
71#define AC_VERB_GET_PIN_WIDGET_CONTROL 0x0f07
72#define AC_VERB_GET_UNSOLICITED_RESPONSE 0x0f08
73#define AC_VERB_GET_PIN_SENSE 0x0f09
74#define AC_VERB_GET_BEEP_CONTROL 0x0f0a
75#define AC_VERB_GET_EAPD_BTLENABLE 0x0f0c
76#define AC_VERB_GET_DIGI_CONVERT_1 0x0f0d
77#define AC_VERB_GET_DIGI_CONVERT_2 0x0f0e /* unused */
78#define AC_VERB_GET_VOLUME_KNOB_CONTROL 0x0f0f
79/* f10-f1a: GPIO */
80#define AC_VERB_GET_GPIO_DATA 0x0f15
81#define AC_VERB_GET_GPIO_MASK 0x0f16
82#define AC_VERB_GET_GPIO_DIRECTION 0x0f17
83#define AC_VERB_GET_GPIO_WAKE_MASK 0x0f18
84#define AC_VERB_GET_GPIO_UNSOLICITED_RSP_MASK 0x0f19
85#define AC_VERB_GET_GPIO_STICKY_MASK 0x0f1a
86#define AC_VERB_GET_CONFIG_DEFAULT 0x0f1c
87/* f20: AFG/MFG */
88#define AC_VERB_GET_SUBSYSTEM_ID 0x0f20
89#define AC_VERB_GET_CVT_CHAN_COUNT 0x0f2d
90#define AC_VERB_GET_HDMI_DIP_SIZE 0x0f2e
91#define AC_VERB_GET_HDMI_ELDD 0x0f2f
92#define AC_VERB_GET_HDMI_DIP_INDEX 0x0f30
93#define AC_VERB_GET_HDMI_DIP_DATA 0x0f31
94#define AC_VERB_GET_HDMI_DIP_XMIT 0x0f32
95#define AC_VERB_GET_HDMI_CP_CTRL 0x0f33
96#define AC_VERB_GET_HDMI_CHAN_SLOT 0x0f34
97
98/*
99 * SET verbs
100 */
101#define AC_VERB_SET_STREAM_FORMAT 0x200
102#define AC_VERB_SET_AMP_GAIN_MUTE 0x300
103#define AC_VERB_SET_PROC_COEF 0x400
104#define AC_VERB_SET_COEF_INDEX 0x500
105#define AC_VERB_SET_CONNECT_SEL 0x701
106#define AC_VERB_SET_PROC_STATE 0x703
107#define AC_VERB_SET_SDI_SELECT 0x704
108#define AC_VERB_SET_POWER_STATE 0x705
109#define AC_VERB_SET_CHANNEL_STREAMID 0x706
110#define AC_VERB_SET_PIN_WIDGET_CONTROL 0x707
111#define AC_VERB_SET_UNSOLICITED_ENABLE 0x708
112#define AC_VERB_SET_PIN_SENSE 0x709
113#define AC_VERB_SET_BEEP_CONTROL 0x70a
114#define AC_VERB_SET_EAPD_BTLENABLE 0x70c
115#define AC_VERB_SET_DIGI_CONVERT_1 0x70d
116#define AC_VERB_SET_DIGI_CONVERT_2 0x70e
117#define AC_VERB_SET_VOLUME_KNOB_CONTROL 0x70f
118#define AC_VERB_SET_GPIO_DATA 0x715
119#define AC_VERB_SET_GPIO_MASK 0x716
120#define AC_VERB_SET_GPIO_DIRECTION 0x717
121#define AC_VERB_SET_GPIO_WAKE_MASK 0x718
122#define AC_VERB_SET_GPIO_UNSOLICITED_RSP_MASK 0x719
123#define AC_VERB_SET_GPIO_STICKY_MASK 0x71a
124#define AC_VERB_SET_CONFIG_DEFAULT_BYTES_0 0x71c
125#define AC_VERB_SET_CONFIG_DEFAULT_BYTES_1 0x71d
126#define AC_VERB_SET_CONFIG_DEFAULT_BYTES_2 0x71e
127#define AC_VERB_SET_CONFIG_DEFAULT_BYTES_3 0x71f
128#define AC_VERB_SET_EAPD 0x788
129#define AC_VERB_SET_CODEC_RESET 0x7ff
130#define AC_VERB_SET_CVT_CHAN_COUNT 0x72d
131#define AC_VERB_SET_HDMI_DIP_INDEX 0x730
132#define AC_VERB_SET_HDMI_DIP_DATA 0x731
133#define AC_VERB_SET_HDMI_DIP_XMIT 0x732
134#define AC_VERB_SET_HDMI_CP_CTRL 0x733
135#define AC_VERB_SET_HDMI_CHAN_SLOT 0x734
136
137/*
138 * Parameter IDs
139 */
140#define AC_PAR_VENDOR_ID 0x00
141#define AC_PAR_SUBSYSTEM_ID 0x01
142#define AC_PAR_REV_ID 0x02
143#define AC_PAR_NODE_COUNT 0x04
144#define AC_PAR_FUNCTION_TYPE 0x05
145#define AC_PAR_AUDIO_FG_CAP 0x08
146#define AC_PAR_AUDIO_WIDGET_CAP 0x09
147#define AC_PAR_PCM 0x0a
148#define AC_PAR_STREAM 0x0b
149#define AC_PAR_PIN_CAP 0x0c
150#define AC_PAR_AMP_IN_CAP 0x0d
151#define AC_PAR_CONNLIST_LEN 0x0e
152#define AC_PAR_POWER_STATE 0x0f
153#define AC_PAR_PROC_CAP 0x10
154#define AC_PAR_GPIO_CAP 0x11
155#define AC_PAR_AMP_OUT_CAP 0x12
156#define AC_PAR_VOL_KNB_CAP 0x13
157#define AC_PAR_HDMI_LPCM_CAP 0x20
158
159/*
160 * AC_VERB_PARAMETERS results (32bit)
161 */
162
163/* Function Group Type */
164#define AC_FGT_TYPE (0xff<<0)
165#define AC_FGT_TYPE_SHIFT 0
166#define AC_FGT_UNSOL_CAP (1<<8)
167
168/* Audio Function Group Capabilities */
169#define AC_AFG_OUT_DELAY (0xf<<0)
170#define AC_AFG_IN_DELAY (0xf<<8)
171#define AC_AFG_BEEP_GEN (1<<16)
172
173/* Audio Widget Capabilities */
174#define AC_WCAP_STEREO (1<<0) /* stereo I/O */
175#define AC_WCAP_IN_AMP (1<<1) /* AMP-in present */
176#define AC_WCAP_OUT_AMP (1<<2) /* AMP-out present */
177#define AC_WCAP_AMP_OVRD (1<<3) /* AMP-parameter override */
178#define AC_WCAP_FORMAT_OVRD (1<<4) /* format override */
179#define AC_WCAP_STRIPE (1<<5) /* stripe */
180#define AC_WCAP_PROC_WID (1<<6) /* Proc Widget */
181#define AC_WCAP_UNSOL_CAP (1<<7) /* Unsol capable */
182#define AC_WCAP_CONN_LIST (1<<8) /* connection list */
183#define AC_WCAP_DIGITAL (1<<9) /* digital I/O */
184#define AC_WCAP_POWER (1<<10) /* power control */
185#define AC_WCAP_LR_SWAP (1<<11) /* L/R swap */
186#define AC_WCAP_CP_CAPS (1<<12) /* content protection */
187#define AC_WCAP_CHAN_CNT_EXT (7<<13) /* channel count ext */
188#define AC_WCAP_DELAY (0xf<<16)
189#define AC_WCAP_DELAY_SHIFT 16
190#define AC_WCAP_TYPE (0xf<<20)
191#define AC_WCAP_TYPE_SHIFT 20
192
193/* supported PCM rates and bits */
194#define AC_SUPPCM_RATES (0xfff << 0)
195#define AC_SUPPCM_BITS_8 (1<<16)
196#define AC_SUPPCM_BITS_16 (1<<17)
197#define AC_SUPPCM_BITS_20 (1<<18)
198#define AC_SUPPCM_BITS_24 (1<<19)
199#define AC_SUPPCM_BITS_32 (1<<20)
200
201/* supported PCM stream format */
202#define AC_SUPFMT_PCM (1<<0)
203#define AC_SUPFMT_FLOAT32 (1<<1)
204#define AC_SUPFMT_AC3 (1<<2)
205
206/* GP I/O count */
207#define AC_GPIO_IO_COUNT (0xff<<0)
208#define AC_GPIO_O_COUNT (0xff<<8)
209#define AC_GPIO_O_COUNT_SHIFT 8
210#define AC_GPIO_I_COUNT (0xff<<16)
211#define AC_GPIO_I_COUNT_SHIFT 16
212#define AC_GPIO_UNSOLICITED (1<<30)
213#define AC_GPIO_WAKE (1<<31)
214
215/* Converter stream, channel */
216#define AC_CONV_CHANNEL (0xf<<0)
217#define AC_CONV_STREAM (0xf<<4)
218#define AC_CONV_STREAM_SHIFT 4
219
220/* Input converter SDI select */
221#define AC_SDI_SELECT (0xf<<0)
222
223/* stream format id */
224#define AC_FMT_CHAN_SHIFT 0
225#define AC_FMT_CHAN_MASK (0x0f << 0)
226#define AC_FMT_BITS_SHIFT 4
227#define AC_FMT_BITS_MASK (7 << 4)
228#define AC_FMT_BITS_8 (0 << 4)
229#define AC_FMT_BITS_16 (1 << 4)
230#define AC_FMT_BITS_20 (2 << 4)
231#define AC_FMT_BITS_24 (3 << 4)
232#define AC_FMT_BITS_32 (4 << 4)
233#define AC_FMT_DIV_SHIFT 8
234#define AC_FMT_DIV_MASK (7 << 8)
235#define AC_FMT_MULT_SHIFT 11
236#define AC_FMT_MULT_MASK (7 << 11)
237#define AC_FMT_BASE_SHIFT 14
238#define AC_FMT_BASE_48K (0 << 14)
239#define AC_FMT_BASE_44K (1 << 14)
240#define AC_FMT_TYPE_SHIFT 15
241#define AC_FMT_TYPE_PCM (0 << 15)
242#define AC_FMT_TYPE_NON_PCM (1 << 15)
243
244/* Unsolicited response control */
245#define AC_UNSOL_TAG (0x3f<<0)
246#define AC_UNSOL_ENABLED (1<<7)
247#define AC_USRSP_EN AC_UNSOL_ENABLED
248
249/* Unsolicited responses */
250#define AC_UNSOL_RES_TAG (0x3f<<26)
251#define AC_UNSOL_RES_TAG_SHIFT 26
252#define AC_UNSOL_RES_SUBTAG (0x1f<<21)
253#define AC_UNSOL_RES_SUBTAG_SHIFT 21
254#define AC_UNSOL_RES_ELDV (1<<1) /* ELD Data valid (for HDMI) */
255#define AC_UNSOL_RES_PD (1<<0) /* pinsense detect */
256#define AC_UNSOL_RES_CP_STATE (1<<1) /* content protection */
257#define AC_UNSOL_RES_CP_READY (1<<0) /* content protection */
258
259/* Pin widget capabilies */
260#define AC_PINCAP_IMP_SENSE (1<<0) /* impedance sense capable */
261#define AC_PINCAP_TRIG_REQ (1<<1) /* trigger required */
262#define AC_PINCAP_PRES_DETECT (1<<2) /* presence detect capable */
263#define AC_PINCAP_HP_DRV (1<<3) /* headphone drive capable */
264#define AC_PINCAP_OUT (1<<4) /* output capable */
265#define AC_PINCAP_IN (1<<5) /* input capable */
266#define AC_PINCAP_BALANCE (1<<6) /* balanced I/O capable */
267/* Note: This LR_SWAP pincap is defined in the Realtek ALC883 specification,
268 * but is marked reserved in the Intel HDA specification.
269 */
270#define AC_PINCAP_LR_SWAP (1<<7) /* L/R swap */
271/* Note: The same bit as LR_SWAP is newly defined as HDMI capability
272 * in HD-audio specification
273 */
274#define AC_PINCAP_HDMI (1<<7) /* HDMI pin */
275#define AC_PINCAP_DP (1<<24) /* DisplayPort pin, can
276 * coexist with AC_PINCAP_HDMI
277 */
278#define AC_PINCAP_VREF (0x37<<8)
279#define AC_PINCAP_VREF_SHIFT 8
280#define AC_PINCAP_EAPD (1<<16) /* EAPD capable */
281#define AC_PINCAP_HBR (1<<27) /* High Bit Rate */
282/* Vref status (used in pin cap) */
283#define AC_PINCAP_VREF_HIZ (1<<0) /* Hi-Z */
284#define AC_PINCAP_VREF_50 (1<<1) /* 50% */
285#define AC_PINCAP_VREF_GRD (1<<2) /* ground */
286#define AC_PINCAP_VREF_80 (1<<4) /* 80% */
287#define AC_PINCAP_VREF_100 (1<<5) /* 100% */
288
289/* Amplifier capabilities */
290#define AC_AMPCAP_OFFSET (0x7f<<0) /* 0dB offset */
291#define AC_AMPCAP_OFFSET_SHIFT 0
292#define AC_AMPCAP_NUM_STEPS (0x7f<<8) /* number of steps */
293#define AC_AMPCAP_NUM_STEPS_SHIFT 8
294#define AC_AMPCAP_STEP_SIZE (0x7f<<16) /* step size 0-32dB
295 * in 0.25dB
296 */
297#define AC_AMPCAP_STEP_SIZE_SHIFT 16
298#define AC_AMPCAP_MUTE (1<<31) /* mute capable */
299#define AC_AMPCAP_MUTE_SHIFT 31
300
301/* driver-specific amp-caps: using bits 24-30 */
302#define AC_AMPCAP_MIN_MUTE (1 << 30) /* min-volume = mute */
303
304/* Connection list */
305#define AC_CLIST_LENGTH (0x7f<<0)
306#define AC_CLIST_LONG (1<<7)
307
308/* Supported power status */
309#define AC_PWRST_D0SUP (1<<0)
310#define AC_PWRST_D1SUP (1<<1)
311#define AC_PWRST_D2SUP (1<<2)
312#define AC_PWRST_D3SUP (1<<3)
313#define AC_PWRST_D3COLDSUP (1<<4)
314#define AC_PWRST_S3D3COLDSUP (1<<29)
315#define AC_PWRST_CLKSTOP (1<<30)
316#define AC_PWRST_EPSS (1U<<31)
317
318/* Power state values */
319#define AC_PWRST_SETTING (0xf<<0)
320#define AC_PWRST_ACTUAL (0xf<<4)
321#define AC_PWRST_ACTUAL_SHIFT 4
322#define AC_PWRST_D0 0x00
323#define AC_PWRST_D1 0x01
324#define AC_PWRST_D2 0x02
325#define AC_PWRST_D3 0x03
326
327/* Processing capabilies */
328#define AC_PCAP_BENIGN (1<<0)
329#define AC_PCAP_NUM_COEF (0xff<<8)
330#define AC_PCAP_NUM_COEF_SHIFT 8
331
332/* Volume knobs capabilities */
333#define AC_KNBCAP_NUM_STEPS (0x7f<<0)
334#define AC_KNBCAP_DELTA (1<<7)
335
336/* HDMI LPCM capabilities */
337#define AC_LPCMCAP_48K_CP_CHNS (0x0f<<0) /* max channels w/ CP-on */
338#define AC_LPCMCAP_48K_NO_CHNS (0x0f<<4) /* max channels w/o CP-on */
339#define AC_LPCMCAP_48K_20BIT (1<<8) /* 20b bitrate supported */
340#define AC_LPCMCAP_48K_24BIT (1<<9) /* 24b bitrate supported */
341#define AC_LPCMCAP_96K_CP_CHNS (0x0f<<10) /* max channels w/ CP-on */
342#define AC_LPCMCAP_96K_NO_CHNS (0x0f<<14) /* max channels w/o CP-on */
343#define AC_LPCMCAP_96K_20BIT (1<<18) /* 20b bitrate supported */
344#define AC_LPCMCAP_96K_24BIT (1<<19) /* 24b bitrate supported */
345#define AC_LPCMCAP_192K_CP_CHNS (0x0f<<20) /* max channels w/ CP-on */
346#define AC_LPCMCAP_192K_NO_CHNS (0x0f<<24) /* max channels w/o CP-on */
347#define AC_LPCMCAP_192K_20BIT (1<<28) /* 20b bitrate supported */
348#define AC_LPCMCAP_192K_24BIT (1<<29) /* 24b bitrate supported */
349#define AC_LPCMCAP_44K (1<<30) /* 44.1kHz support */
350#define AC_LPCMCAP_44K_MS (1<<31) /* 44.1kHz-multiplies support */
351
352/*
353 * Control Parameters
354 */
355
356/* Amp gain/mute */
357#define AC_AMP_MUTE (1<<7)
358#define AC_AMP_GAIN (0x7f)
359#define AC_AMP_GET_INDEX (0xf<<0)
360
361#define AC_AMP_GET_LEFT (1<<13)
362#define AC_AMP_GET_RIGHT (0<<13)
363#define AC_AMP_GET_OUTPUT (1<<15)
364#define AC_AMP_GET_INPUT (0<<15)
365
366#define AC_AMP_SET_INDEX (0xf<<8)
367#define AC_AMP_SET_INDEX_SHIFT 8
368#define AC_AMP_SET_RIGHT (1<<12)
369#define AC_AMP_SET_LEFT (1<<13)
370#define AC_AMP_SET_INPUT (1<<14)
371#define AC_AMP_SET_OUTPUT (1<<15)
372
373/* DIGITAL1 bits */
374#define AC_DIG1_ENABLE (1<<0)
375#define AC_DIG1_V (1<<1)
376#define AC_DIG1_VCFG (1<<2)
377#define AC_DIG1_EMPHASIS (1<<3)
378#define AC_DIG1_COPYRIGHT (1<<4)
379#define AC_DIG1_NONAUDIO (1<<5)
380#define AC_DIG1_PROFESSIONAL (1<<6)
381#define AC_DIG1_LEVEL (1<<7)
382
383/* DIGITAL2 bits */
384#define AC_DIG2_CC (0x7f<<0)
385
386/* Pin widget control - 8bit */
387#define AC_PINCTL_EPT (0x3<<0)
388#define AC_PINCTL_EPT_NATIVE 0
389#define AC_PINCTL_EPT_HBR 3
390#define AC_PINCTL_VREFEN (0x7<<0)
391#define AC_PINCTL_VREF_HIZ 0 /* Hi-Z */
392#define AC_PINCTL_VREF_50 1 /* 50% */
393#define AC_PINCTL_VREF_GRD 2 /* ground */
394#define AC_PINCTL_VREF_80 4 /* 80% */
395#define AC_PINCTL_VREF_100 5 /* 100% */
396#define AC_PINCTL_IN_EN (1<<5)
397#define AC_PINCTL_OUT_EN (1<<6)
398#define AC_PINCTL_HP_EN (1<<7)
399
400/* Pin sense - 32bit */
401#define AC_PINSENSE_IMPEDANCE_MASK (0x7fffffff)
402#define AC_PINSENSE_PRESENCE (1<<31)
403#define AC_PINSENSE_ELDV (1<<30) /* ELD valid (HDMI) */
404
405/* EAPD/BTL enable - 32bit */
406#define AC_EAPDBTL_BALANCED (1<<0)
407#define AC_EAPDBTL_EAPD (1<<1)
408#define AC_EAPDBTL_LR_SWAP (1<<2)
409
410/* HDMI ELD data */
411#define AC_ELDD_ELD_VALID (1<<31)
412#define AC_ELDD_ELD_DATA 0xff
413
414/* HDMI DIP size */
415#define AC_DIPSIZE_ELD_BUF (1<<3) /* ELD buf size of packet size */
416#define AC_DIPSIZE_PACK_IDX (0x07<<0) /* packet index */
417
418/* HDMI DIP index */
419#define AC_DIPIDX_PACK_IDX (0x07<<5) /* packet idnex */
420#define AC_DIPIDX_BYTE_IDX (0x1f<<0) /* byte index */
421
422/* HDMI DIP xmit (transmit) control */
423#define AC_DIPXMIT_MASK (0x3<<6)
424#define AC_DIPXMIT_DISABLE (0x0<<6) /* disable xmit */
425#define AC_DIPXMIT_ONCE (0x2<<6) /* xmit once then disable */
426#define AC_DIPXMIT_BEST (0x3<<6) /* best effort */
427
428/* HDMI content protection (CP) control */
429#define AC_CPCTRL_CES (1<<9) /* current encryption state */
430#define AC_CPCTRL_READY (1<<8) /* ready bit */
431#define AC_CPCTRL_SUBTAG (0x1f<<3) /* subtag for unsol-resp */
432#define AC_CPCTRL_STATE (3<<0) /* current CP request state */
433
434/* Converter channel <-> HDMI slot mapping */
435#define AC_CVTMAP_HDMI_SLOT (0xf<<0) /* HDMI slot number */
436#define AC_CVTMAP_CHAN (0xf<<4) /* converter channel number */
437
438/* configuration default - 32bit */
439#define AC_DEFCFG_SEQUENCE (0xf<<0)
440#define AC_DEFCFG_DEF_ASSOC (0xf<<4)
441#define AC_DEFCFG_ASSOC_SHIFT 4
442#define AC_DEFCFG_MISC (0xf<<8)
443#define AC_DEFCFG_MISC_SHIFT 8
444#define AC_DEFCFG_MISC_NO_PRESENCE (1<<0)
445#define AC_DEFCFG_COLOR (0xf<<12)
446#define AC_DEFCFG_COLOR_SHIFT 12
447#define AC_DEFCFG_CONN_TYPE (0xf<<16)
448#define AC_DEFCFG_CONN_TYPE_SHIFT 16
449#define AC_DEFCFG_DEVICE (0xf<<20)
450#define AC_DEFCFG_DEVICE_SHIFT 20
451#define AC_DEFCFG_LOCATION (0x3f<<24)
452#define AC_DEFCFG_LOCATION_SHIFT 24
453#define AC_DEFCFG_PORT_CONN (0x3<<30)
454#define AC_DEFCFG_PORT_CONN_SHIFT 30
455
456/* device device types (0x0-0xf) */
457enum {
458 AC_JACK_LINE_OUT,
459 AC_JACK_SPEAKER,
460 AC_JACK_HP_OUT,
461 AC_JACK_CD,
462 AC_JACK_SPDIF_OUT,
463 AC_JACK_DIG_OTHER_OUT,
464 AC_JACK_MODEM_LINE_SIDE,
465 AC_JACK_MODEM_HAND_SIDE,
466 AC_JACK_LINE_IN,
467 AC_JACK_AUX,
468 AC_JACK_MIC_IN,
469 AC_JACK_TELEPHONY,
470 AC_JACK_SPDIF_IN,
471 AC_JACK_DIG_OTHER_IN,
472 AC_JACK_OTHER = 0xf,
473};
474
475/* jack connection types (0x0-0xf) */
476enum {
477 AC_JACK_CONN_UNKNOWN,
478 AC_JACK_CONN_1_8,
479 AC_JACK_CONN_1_4,
480 AC_JACK_CONN_ATAPI,
481 AC_JACK_CONN_RCA,
482 AC_JACK_CONN_OPTICAL,
483 AC_JACK_CONN_OTHER_DIGITAL,
484 AC_JACK_CONN_OTHER_ANALOG,
485 AC_JACK_CONN_DIN,
486 AC_JACK_CONN_XLR,
487 AC_JACK_CONN_RJ11,
488 AC_JACK_CONN_COMB,
489 AC_JACK_CONN_OTHER = 0xf,
490};
491
492/* jack colors (0x0-0xf) */
493enum {
494 AC_JACK_COLOR_UNKNOWN,
495 AC_JACK_COLOR_BLACK,
496 AC_JACK_COLOR_GREY,
497 AC_JACK_COLOR_BLUE,
498 AC_JACK_COLOR_GREEN,
499 AC_JACK_COLOR_RED,
500 AC_JACK_COLOR_ORANGE,
501 AC_JACK_COLOR_YELLOW,
502 AC_JACK_COLOR_PURPLE,
503 AC_JACK_COLOR_PINK,
504 AC_JACK_COLOR_WHITE = 0xe,
505 AC_JACK_COLOR_OTHER,
506};
507
508/* Jack location (0x0-0x3f) */
509/* common case */
510enum {
511 AC_JACK_LOC_NONE,
512 AC_JACK_LOC_REAR,
513 AC_JACK_LOC_FRONT,
514 AC_JACK_LOC_LEFT,
515 AC_JACK_LOC_RIGHT,
516 AC_JACK_LOC_TOP,
517 AC_JACK_LOC_BOTTOM,
518};
519/* bits 4-5 */
520enum {
521 AC_JACK_LOC_EXTERNAL = 0x00,
522 AC_JACK_LOC_INTERNAL = 0x10,
523 AC_JACK_LOC_SEPARATE = 0x20,
524 AC_JACK_LOC_OTHER = 0x30,
525};
526enum {
527 /* external on primary chasis */
528 AC_JACK_LOC_REAR_PANEL = 0x07,
529 AC_JACK_LOC_DRIVE_BAY,
530 /* internal */
531 AC_JACK_LOC_RISER = 0x17,
532 AC_JACK_LOC_HDMI,
533 AC_JACK_LOC_ATAPI,
534 /* others */
535 AC_JACK_LOC_MOBILE_IN = 0x37,
536 AC_JACK_LOC_MOBILE_OUT,
537};
538
539/* Port connectivity (0-3) */
540enum {
541 AC_JACK_PORT_COMPLEX,
542 AC_JACK_PORT_NONE,
543 AC_JACK_PORT_FIXED,
544 AC_JACK_PORT_BOTH,
545};
546
547/* max. connections to a widget */
548#define HDA_MAX_CONNECTIONS 32
549
550/* max. codec address */
551#define HDA_MAX_CODEC_ADDRESS 0x0f
552
553/*
554 * generic arrays
555 */
556struct snd_array {
557 unsigned int used;
558 unsigned int alloced;
559 unsigned int elem_size;
560 unsigned int alloc_align;
561 void *list;
562};
563
564void *snd_array_new(struct snd_array *array);
565void snd_array_free(struct snd_array *array);
566static inline void snd_array_init(struct snd_array *array, unsigned int size,
567 unsigned int align)
568{
569 array->elem_size = size;
570 array->alloc_align = align;
571}
572
573static inline void *snd_array_elem(struct snd_array *array, unsigned int idx)
574{
575 return array->list + idx * array->elem_size;
576}
577
578static inline unsigned int snd_array_index(struct snd_array *array, void *ptr)
579{
580 return (unsigned long)(ptr - array->list) / array->elem_size;
581}
582
583/*
584 * Structures
585 */
586
587struct hda_bus;
588struct hda_beep;
589struct hda_codec;
590struct hda_pcm;
591struct hda_pcm_stream;
592struct hda_bus_unsolicited;
593
594/* NID type */
595typedef u16 hda_nid_t;
596
597/* bus operators */
598struct hda_bus_ops {
599 /* send a single command */
600 int (*command)(struct hda_bus *bus, unsigned int cmd);
601 /* get a response from the last command */
602 unsigned int (*get_response)(struct hda_bus *bus, unsigned int addr);
603 /* free the private data */
604 void (*private_free)(struct hda_bus *);
605 /* attach a PCM stream */
606 int (*attach_pcm)(struct hda_bus *bus, struct hda_codec *codec,
607 struct hda_pcm *pcm);
608 /* reset bus for retry verb */
609 void (*bus_reset)(struct hda_bus *bus);
610#ifdef CONFIG_SND_HDA_POWER_SAVE
611 /* notify power-up/down from codec to controller */
612 void (*pm_notify)(struct hda_bus *bus);
613#endif
614};
615
616/* template to pass to the bus constructor */
617struct hda_bus_template {
618 void *private_data;
619 struct pci_dev *pci;
620 const char *modelname;
621 int *power_save;
622 struct hda_bus_ops ops;
623};
624
625/*
626 * codec bus
627 *
628 * each controller needs to creata a hda_bus to assign the accessor.
629 * A hda_bus contains several codecs in the list codec_list.
630 */
631struct hda_bus {
632 struct snd_card *card;
633
634 /* copied from template */
635 void *private_data;
636 struct pci_dev *pci;
637 const char *modelname;
638 int *power_save;
639 struct hda_bus_ops ops;
640
641 /* codec linked list */
642 struct list_head codec_list;
643 /* link caddr -> codec */
644 struct hda_codec *caddr_tbl[HDA_MAX_CODEC_ADDRESS + 1];
645
646 struct mutex cmd_mutex;
647 struct mutex prepare_mutex;
648
649 /* unsolicited event queue */
650 struct hda_bus_unsolicited *unsol;
651 char workq_name[16];
652 struct workqueue_struct *workq; /* common workqueue for codecs */
653
654 /* assigned PCMs */
655 DECLARE_BITMAP(pcm_dev_bits, SNDRV_PCM_DEVICES);
656
657 /* misc op flags */
658 unsigned int needs_damn_long_delay :1;
659 unsigned int allow_bus_reset:1; /* allow bus reset at fatal error */
660 unsigned int sync_write:1; /* sync after verb write */
661 /* status for codec/controller */
662 unsigned int shutdown :1; /* being unloaded */
663 unsigned int rirb_error:1; /* error in codec communication */
664 unsigned int response_reset:1; /* controller was reset */
665 unsigned int in_reset:1; /* during reset operation */
666 unsigned int power_keep_link_on:1; /* don't power off HDA link */
667};
668
669/*
670 * codec preset
671 *
672 * Known codecs have the patch to build and set up the controls/PCMs
673 * better than the generic parser.
674 */
675struct hda_codec_preset {
676 unsigned int id;
677 unsigned int mask;
678 unsigned int subs;
679 unsigned int subs_mask;
680 unsigned int rev;
681 hda_nid_t afg, mfg;
682 const char *name;
683 int (*patch)(struct hda_codec *codec);
684};
685
686struct hda_codec_preset_list {
687 const struct hda_codec_preset *preset;
688 struct module *owner;
689 struct list_head list;
690};
691
692/* initial hook */
693int snd_hda_add_codec_preset(struct hda_codec_preset_list *preset);
694int snd_hda_delete_codec_preset(struct hda_codec_preset_list *preset);
695
696/* ops set by the preset patch */
697struct hda_codec_ops {
698 int (*build_controls)(struct hda_codec *codec);
699 int (*build_pcms)(struct hda_codec *codec);
700 int (*init)(struct hda_codec *codec);
701 void (*free)(struct hda_codec *codec);
702 void (*unsol_event)(struct hda_codec *codec, unsigned int res);
703 void (*set_power_state)(struct hda_codec *codec, hda_nid_t fg,
704 unsigned int power_state);
705#ifdef CONFIG_PM
706 int (*suspend)(struct hda_codec *codec, pm_message_t state);
707 int (*resume)(struct hda_codec *codec);
708#endif
709#ifdef CONFIG_SND_HDA_POWER_SAVE
710 int (*check_power_status)(struct hda_codec *codec, hda_nid_t nid);
711#endif
712 void (*reboot_notify)(struct hda_codec *codec);
713};
714
715/* record for amp information cache */
716struct hda_cache_head {
717 u32 key; /* hash key */
718 u16 val; /* assigned value */
719 u16 next; /* next link; -1 = terminal */
720};
721
722struct hda_amp_info {
723 struct hda_cache_head head;
724 u32 amp_caps; /* amp capabilities */
725 u16 vol[2]; /* current volume & mute */
726};
727
728struct hda_cache_rec {
729 u16 hash[64]; /* hash table for index */
730 struct snd_array buf; /* record entries */
731};
732
733/* PCM callbacks */
734struct hda_pcm_ops {
735 int (*open)(struct hda_pcm_stream *info, struct hda_codec *codec,
736 struct snd_pcm_substream *substream);
737 int (*close)(struct hda_pcm_stream *info, struct hda_codec *codec,
738 struct snd_pcm_substream *substream);
739 int (*prepare)(struct hda_pcm_stream *info, struct hda_codec *codec,
740 unsigned int stream_tag, unsigned int format,
741 struct snd_pcm_substream *substream);
742 int (*cleanup)(struct hda_pcm_stream *info, struct hda_codec *codec,
743 struct snd_pcm_substream *substream);
744};
745
746/* PCM information for each substream */
747struct hda_pcm_stream {
748 unsigned int substreams; /* number of substreams, 0 = not exist*/
749 unsigned int channels_min; /* min. number of channels */
750 unsigned int channels_max; /* max. number of channels */
751 hda_nid_t nid; /* default NID to query rates/formats/bps, or set up */
752 u32 rates; /* supported rates */
753 u64 formats; /* supported formats (SNDRV_PCM_FMTBIT_) */
754 unsigned int maxbps; /* supported max. bit per sample */
755 struct hda_pcm_ops ops;
756};
757
758/* PCM types */
759enum {
760 HDA_PCM_TYPE_AUDIO,
761 HDA_PCM_TYPE_SPDIF,
762 HDA_PCM_TYPE_HDMI,
763 HDA_PCM_TYPE_MODEM,
764 HDA_PCM_NTYPES
765};
766
767/* for PCM creation */
768struct hda_pcm {
769 char *name;
770 struct hda_pcm_stream stream[2];
771 unsigned int pcm_type; /* HDA_PCM_TYPE_XXX */
772 int device; /* device number to assign */
773 struct snd_pcm *pcm; /* assigned PCM instance */
774};
775
776/* codec information */
777struct hda_codec {
778 struct hda_bus *bus;
779 unsigned int addr; /* codec addr*/
780 struct list_head list; /* list point */
781
782 hda_nid_t afg; /* AFG node id */
783 hda_nid_t mfg; /* MFG node id */
784
785 /* ids */
786 u8 afg_function_id;
787 u8 mfg_function_id;
788 u8 afg_unsol;
789 u8 mfg_unsol;
790 u32 vendor_id;
791 u32 subsystem_id;
792 u32 revision_id;
793
794 /* detected preset */
795 const struct hda_codec_preset *preset;
796 struct module *owner;
797 const char *vendor_name; /* codec vendor name */
798 const char *chip_name; /* codec chip name */
799 const char *modelname; /* model name for preset */
800
801 /* set by patch */
802 struct hda_codec_ops patch_ops;
803
804 /* PCM to create, set by patch_ops.build_pcms callback */
805 unsigned int num_pcms;
806 struct hda_pcm *pcm_info;
807
808 /* codec specific info */
809 void *spec;
810
811 /* beep device */
812 struct hda_beep *beep;
813 unsigned int beep_mode;
814
815 /* widget capabilities cache */
816 unsigned int num_nodes;
817 hda_nid_t start_nid;
818 u32 *wcaps;
819
820 struct snd_array mixers; /* list of assigned mixer elements */
821 struct snd_array nids; /* list of mapped mixer elements */
822
823 struct hda_cache_rec amp_cache; /* cache for amp access */
824 struct hda_cache_rec cmd_cache; /* cache for other commands */
825
826 struct snd_array conn_lists; /* connection-list array */
827
828 struct mutex spdif_mutex;
829 struct mutex control_mutex;
830 struct mutex hash_mutex;
831 struct snd_array spdif_out;
832 unsigned int spdif_in_enable; /* SPDIF input enable? */
833 const hda_nid_t *slave_dig_outs; /* optional digital out slave widgets */
834 struct snd_array init_pins; /* initial (BIOS) pin configurations */
835 struct snd_array driver_pins; /* pin configs set by codec parser */
836 struct snd_array cvt_setups; /* audio convert setups */
837
838#ifdef CONFIG_SND_HDA_HWDEP
839 struct snd_hwdep *hwdep; /* assigned hwdep device */
840 struct snd_array init_verbs; /* additional init verbs */
841 struct snd_array hints; /* additional hints */
842 struct snd_array user_pins; /* default pin configs to override */
843#endif
844
845 /* misc flags */
846 unsigned int spdif_status_reset :1; /* needs to toggle SPDIF for each
847 * status change
848 * (e.g. Realtek codecs)
849 */
850 unsigned int pin_amp_workaround:1; /* pin out-amp takes index
851 * (e.g. Conexant codecs)
852 */
853 unsigned int single_adc_amp:1; /* adc in-amp takes no index
854 * (e.g. CX20549 codec)
855 */
856 unsigned int no_sticky_stream:1; /* no sticky-PCM stream assignment */
857 unsigned int pins_shutup:1; /* pins are shut up */
858 unsigned int no_trigger_sense:1; /* don't trigger at pin-sensing */
859 unsigned int ignore_misc_bit:1; /* ignore MISC_NO_PRESENCE bit */
860 unsigned int no_jack_detect:1; /* Machine has no jack-detection */
861#ifdef CONFIG_SND_HDA_POWER_SAVE
862 unsigned int power_on :1; /* current (global) power-state */
863 int power_transition; /* power-state in transition */
864 int power_count; /* current (global) power refcount */
865 struct delayed_work power_work; /* delayed task for powerdown */
866 unsigned long power_on_acct;
867 unsigned long power_off_acct;
868 unsigned long power_jiffies;
869 spinlock_t power_lock;
870#endif
871
872 /* codec-specific additional proc output */
873 void (*proc_widget_hook)(struct snd_info_buffer *buffer,
874 struct hda_codec *codec, hda_nid_t nid);
875
876 /* jack detection */
877 struct snd_array jacktbl;
878
879#ifdef CONFIG_SND_HDA_INPUT_JACK
880 /* jack detection */
881 struct snd_array jacks;
882#endif
883};
884
885/* direction */
886enum {
887 HDA_INPUT, HDA_OUTPUT
888};
889
890
891/*
892 * constructors
893 */
894int snd_hda_bus_new(struct snd_card *card, const struct hda_bus_template *temp,
895 struct hda_bus **busp);
896int snd_hda_codec_new(struct hda_bus *bus, unsigned int codec_addr,
897 struct hda_codec **codecp);
898int snd_hda_codec_configure(struct hda_codec *codec);
899
900/*
901 * low level functions
902 */
903unsigned int snd_hda_codec_read(struct hda_codec *codec, hda_nid_t nid,
904 int direct,
905 unsigned int verb, unsigned int parm);
906int snd_hda_codec_write(struct hda_codec *codec, hda_nid_t nid, int direct,
907 unsigned int verb, unsigned int parm);
908#define snd_hda_param_read(codec, nid, param) \
909 snd_hda_codec_read(codec, nid, 0, AC_VERB_PARAMETERS, param)
910int snd_hda_get_sub_nodes(struct hda_codec *codec, hda_nid_t nid,
911 hda_nid_t *start_id);
912int snd_hda_get_connections(struct hda_codec *codec, hda_nid_t nid,
913 hda_nid_t *conn_list, int max_conns);
914static inline int
915snd_hda_get_num_conns(struct hda_codec *codec, hda_nid_t nid)
916{
917 return snd_hda_get_connections(codec, nid, NULL, 0);
918}
919int snd_hda_get_raw_connections(struct hda_codec *codec, hda_nid_t nid,
920 hda_nid_t *conn_list, int max_conns);
921int snd_hda_override_conn_list(struct hda_codec *codec, hda_nid_t nid, int nums,
922 const hda_nid_t *list);
923int snd_hda_get_conn_index(struct hda_codec *codec, hda_nid_t mux,
924 hda_nid_t nid, int recursive);
925int snd_hda_query_supported_pcm(struct hda_codec *codec, hda_nid_t nid,
926 u32 *ratesp, u64 *formatsp, unsigned int *bpsp);
927
928struct hda_verb {
929 hda_nid_t nid;
930 u32 verb;
931 u32 param;
932};
933
934void snd_hda_sequence_write(struct hda_codec *codec,
935 const struct hda_verb *seq);
936
937/* unsolicited event */
938int snd_hda_queue_unsol_event(struct hda_bus *bus, u32 res, u32 res_ex);
939
940/* cached write */
941#ifdef CONFIG_PM
942int snd_hda_codec_write_cache(struct hda_codec *codec, hda_nid_t nid,
943 int direct, unsigned int verb, unsigned int parm);
944void snd_hda_sequence_write_cache(struct hda_codec *codec,
945 const struct hda_verb *seq);
946int snd_hda_codec_update_cache(struct hda_codec *codec, hda_nid_t nid,
947 int direct, unsigned int verb, unsigned int parm);
948void snd_hda_codec_resume_cache(struct hda_codec *codec);
949#else
950#define snd_hda_codec_write_cache snd_hda_codec_write
951#define snd_hda_codec_update_cache snd_hda_codec_write
952#define snd_hda_sequence_write_cache snd_hda_sequence_write
953#endif
954
955/* the struct for codec->pin_configs */
956struct hda_pincfg {
957 hda_nid_t nid;
958 unsigned char ctrl; /* current pin control value */
959 unsigned char pad; /* reserved */
960 unsigned int cfg; /* default configuration */
961};
962
963unsigned int snd_hda_codec_get_pincfg(struct hda_codec *codec, hda_nid_t nid);
964int snd_hda_codec_set_pincfg(struct hda_codec *codec, hda_nid_t nid,
965 unsigned int cfg);
966int snd_hda_add_pincfg(struct hda_codec *codec, struct snd_array *list,
967 hda_nid_t nid, unsigned int cfg); /* for hwdep */
968void snd_hda_shutup_pins(struct hda_codec *codec);
969
970/* SPDIF controls */
971struct hda_spdif_out {
972 hda_nid_t nid; /* Converter nid values relate to */
973 unsigned int status; /* IEC958 status bits */
974 unsigned short ctls; /* SPDIF control bits */
975};
976struct hda_spdif_out *snd_hda_spdif_out_of_nid(struct hda_codec *codec,
977 hda_nid_t nid);
978void snd_hda_spdif_ctls_unassign(struct hda_codec *codec, int idx);
979void snd_hda_spdif_ctls_assign(struct hda_codec *codec, int idx, hda_nid_t nid);
980
981/*
982 * Mixer
983 */
984int snd_hda_build_controls(struct hda_bus *bus);
985int snd_hda_codec_build_controls(struct hda_codec *codec);
986
987/*
988 * PCM
989 */
990int snd_hda_build_pcms(struct hda_bus *bus);
991int snd_hda_codec_build_pcms(struct hda_codec *codec);
992
993int snd_hda_codec_prepare(struct hda_codec *codec,
994 struct hda_pcm_stream *hinfo,
995 unsigned int stream,
996 unsigned int format,
997 struct snd_pcm_substream *substream);
998void snd_hda_codec_cleanup(struct hda_codec *codec,
999 struct hda_pcm_stream *hinfo,
1000 struct snd_pcm_substream *substream);
1001
1002void snd_hda_codec_setup_stream(struct hda_codec *codec, hda_nid_t nid,
1003 u32 stream_tag,
1004 int channel_id, int format);
1005void __snd_hda_codec_cleanup_stream(struct hda_codec *codec, hda_nid_t nid,
1006 int do_now);
1007#define snd_hda_codec_cleanup_stream(codec, nid) \
1008 __snd_hda_codec_cleanup_stream(codec, nid, 0)
1009unsigned int snd_hda_calc_stream_format(unsigned int rate,
1010 unsigned int channels,
1011 unsigned int format,
1012 unsigned int maxbps,
1013 unsigned short spdif_ctls);
1014int snd_hda_is_supported_format(struct hda_codec *codec, hda_nid_t nid,
1015 unsigned int format);
1016
1017/*
1018 * Misc
1019 */
1020void snd_hda_get_codec_name(struct hda_codec *codec, char *name, int namelen);
1021void snd_hda_bus_reboot_notify(struct hda_bus *bus);
1022void snd_hda_codec_set_power_to_all(struct hda_codec *codec, hda_nid_t fg,
1023 unsigned int power_state,
1024 bool eapd_workaround);
1025
1026int snd_hda_lock_devices(struct hda_bus *bus);
1027void snd_hda_unlock_devices(struct hda_bus *bus);
1028
1029/*
1030 * power management
1031 */
1032#ifdef CONFIG_PM
1033int snd_hda_suspend(struct hda_bus *bus);
1034int snd_hda_resume(struct hda_bus *bus);
1035#endif
1036
1037static inline
1038int hda_call_check_power_status(struct hda_codec *codec, hda_nid_t nid)
1039{
1040#ifdef CONFIG_SND_HDA_POWER_SAVE
1041 if (codec->patch_ops.check_power_status)
1042 return codec->patch_ops.check_power_status(codec, nid);
1043#endif
1044 return 0;
1045}
1046
1047/*
1048 * get widget information
1049 */
1050const char *snd_hda_get_jack_connectivity(u32 cfg);
1051const char *snd_hda_get_jack_type(u32 cfg);
1052const char *snd_hda_get_jack_location(u32 cfg);
1053
1054/*
1055 * power saving
1056 */
1057#ifdef CONFIG_SND_HDA_POWER_SAVE
1058void snd_hda_power_up(struct hda_codec *codec);
1059void snd_hda_power_up_d3wait(struct hda_codec *codec);
1060void snd_hda_power_down(struct hda_codec *codec);
1061void snd_hda_update_power_acct(struct hda_codec *codec);
1062#else
1063static inline void snd_hda_power_up(struct hda_codec *codec) {}
1064static inline void snd_hda_power_up_d3wait(struct hda_codec *codec) {}
1065static inline void snd_hda_power_down(struct hda_codec *codec) {}
1066#endif
1067
1068#ifdef CONFIG_SND_HDA_PATCH_LOADER
1069/*
1070 * patch firmware
1071 */
1072int snd_hda_load_patch(struct hda_bus *bus, const char *patch);
1073#endif
1074
1075/*
1076 * Codec modularization
1077 */
1078
1079/* Export symbols only for communication with codec drivers;
1080 * When built in kernel, all HD-audio drivers are supposed to be statically
1081 * linked to the kernel. Thus, the symbols don't have to (or shouldn't) be
1082 * exported unless it's built as a module.
1083 */
1084#ifdef MODULE
1085#define EXPORT_SYMBOL_HDA(sym) EXPORT_SYMBOL_GPL(sym)
1086#else
1087#define EXPORT_SYMBOL_HDA(sym)
1088#endif
1089
1090#endif /* __SOUND_HDA_CODEC_H */