xref: /linux/include/sound/hda_codec.h (revision 5676e013f16ac4b616d433af24647d0ce4b067aa)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * Universal Interface for Intel High Definition Audio Codec
4  *
5  * Copyright (c) 2004 Takashi Iwai <tiwai@suse.de>
6  */
7 
8 #ifndef __SOUND_HDA_CODEC_H
9 #define __SOUND_HDA_CODEC_H
10 
11 #include <linux/refcount.h>
12 #include <linux/device-id/hda.h>
13 #include <sound/info.h>
14 #include <sound/control.h>
15 #include <sound/pcm.h>
16 #include <sound/hwdep.h>
17 #include <sound/hdaudio.h>
18 #include <sound/hda_verbs.h>
19 #include <sound/hda_regmap.h>
20 
21 /*
22  * Structures
23  */
24 
25 struct hda_bus;
26 struct hda_beep;
27 struct hda_codec;
28 struct hda_pcm;
29 struct hda_pcm_stream;
30 struct hda_codec_ops;
31 struct hda_jack_tbl;
32 
33 /*
34  * codec bus
35  *
36  * each controller needs to creata a hda_bus to assign the accessor.
37  * A hda_bus contains several codecs in the list codec_list.
38  */
39 struct hda_bus {
40 	struct hdac_bus core;
41 
42 	struct snd_card *card;
43 
44 	struct pci_dev *pci;
45 	const char *modelname;
46 
47 	struct mutex prepare_mutex;
48 
49 	/* assigned PCMs */
50 	DECLARE_BITMAP(pcm_dev_bits, SNDRV_PCM_DEVICES);
51 
52 	/* misc op flags */
53 	unsigned int allow_bus_reset:1;	/* allow bus reset at fatal error */
54 	/* status for codec/controller */
55 	unsigned int shutdown :1;	/* being unloaded */
56 	unsigned int response_reset:1;	/* controller was reset */
57 	unsigned int in_reset:1;	/* during reset operation */
58 	unsigned int no_response_fallback:1; /* don't fallback at RIRB error */
59 	unsigned int bus_probing :1;	/* during probing process */
60 	unsigned int keep_power:1;	/* keep power up for notification */
61 	unsigned int jackpoll_in_suspend:1; /* keep jack polling during
62 					     * runtime suspend
63 					     */
64 
65 	int primary_dig_out_type;	/* primary digital out PCM type */
66 	unsigned int mixer_assigned;	/* codec addr for mixer name */
67 };
68 
69 /* from hdac_bus to hda_bus */
70 #define to_hda_bus(bus)		container_of(bus, struct hda_bus, core)
71 
72 /*
73  * codec preset
74  */
75 
76 #define HDA_CODEC_ID_SKIP_PROBE		0x00000001
77 #define HDA_CODEC_ID_GENERIC_HDMI	0x00000101
78 #define HDA_CODEC_ID_GENERIC		0x00000201
79 
80 #define HDA_CODEC_ID_REV_MODEL(_vid, _rev, _name, _model)	  \
81 	{ .vendor_id = (_vid), .rev_id = (_rev), .name = (_name), \
82 	  .api_version = HDA_DEV_LEGACY, .driver_data = (_model) }
83 #define HDA_CODEC_ID_MODEL(_vid, _name, _model)	  \
84 	HDA_CODEC_ID_REV_MODEL(_vid, 0, _name, _model)
85 #define HDA_CODEC_ID_REV(_vid, _rev, _name) \
86 	HDA_CODEC_ID_REV_MODEL(_vid, _rev, _name, 0)
87 #define HDA_CODEC_ID(_vid, _name) \
88 	HDA_CODEC_ID_REV(_vid, 0, _name)
89 
90 struct hda_codec_driver {
91 	struct hdac_driver core;
92 	const struct hda_device_id *id;
93 	const struct hda_codec_ops *ops;
94 };
95 
96 #define hda_codec_to_driver(codec) \
97 	container_of((codec)->core.dev.driver, struct hda_codec_driver, core.driver)
98 
99 int __hda_codec_driver_register(struct hda_codec_driver *drv, const char *name,
100 			       struct module *owner);
101 #define hda_codec_driver_register(drv) \
102 	__hda_codec_driver_register(drv, KBUILD_MODNAME, THIS_MODULE)
103 void hda_codec_driver_unregister(struct hda_codec_driver *drv);
104 #define module_hda_codec_driver(drv) \
105 	module_driver(drv, hda_codec_driver_register, \
106 		      hda_codec_driver_unregister)
107 
108 /* ops for hda codec driver */
109 struct hda_codec_ops {
110 	int (*probe)(struct hda_codec *codec, const struct hda_device_id *id);
111 	void (*remove)(struct hda_codec *codec);
112 	int (*build_controls)(struct hda_codec *codec);
113 	int (*build_pcms)(struct hda_codec *codec);
114 	int (*init)(struct hda_codec *codec);
115 	void (*unsol_event)(struct hda_codec *codec, unsigned int res);
116 	void (*set_power_state)(struct hda_codec *codec, hda_nid_t fg,
117 				unsigned int power_state);
118 	int (*suspend)(struct hda_codec *codec);
119 	int (*resume)(struct hda_codec *codec);
120 	int (*check_power_status)(struct hda_codec *codec, hda_nid_t nid);
121 	void (*stream_pm)(struct hda_codec *codec, hda_nid_t nid, bool on);
122 };
123 
124 /* PCM callbacks */
125 struct hda_pcm_ops {
126 	int (*open)(struct hda_pcm_stream *info, struct hda_codec *codec,
127 		    struct snd_pcm_substream *substream);
128 	int (*close)(struct hda_pcm_stream *info, struct hda_codec *codec,
129 		     struct snd_pcm_substream *substream);
130 	int (*prepare)(struct hda_pcm_stream *info, struct hda_codec *codec,
131 		       unsigned int stream_tag, unsigned int format,
132 		       struct snd_pcm_substream *substream);
133 	int (*cleanup)(struct hda_pcm_stream *info, struct hda_codec *codec,
134 		       struct snd_pcm_substream *substream);
135 	unsigned int (*get_delay)(struct hda_pcm_stream *info,
136 				  struct hda_codec *codec,
137 				  struct snd_pcm_substream *substream);
138 };
139 
140 /* PCM information for each substream */
141 struct hda_pcm_stream {
142 	unsigned int substreams;	/* number of substreams, 0 = not exist*/
143 	unsigned int channels_min;	/* min. number of channels */
144 	unsigned int channels_max;	/* max. number of channels */
145 	hda_nid_t nid;	/* default NID to query rates/formats/bps, or set up */
146 	u32 rates;	/* supported rates */
147 	u64 formats;	/* supported formats (SNDRV_PCM_FMTBIT_) */
148 	u32 subformats;	/* for S32_LE format, SNDRV_PCM_SUBFMTBIT_* */
149 	unsigned int maxbps;	/* supported max. bit per sample */
150 	const struct snd_pcm_chmap_elem *chmap; /* chmap to override */
151 	struct hda_pcm_ops ops;
152 };
153 
154 /* PCM types */
155 enum {
156 	HDA_PCM_TYPE_AUDIO,
157 	HDA_PCM_TYPE_SPDIF,
158 	HDA_PCM_TYPE_HDMI,
159 	HDA_PCM_TYPE_MODEM,
160 	HDA_PCM_NTYPES
161 };
162 
163 #define SNDRV_PCM_INVALID_DEVICE	(-1)
164 /* for PCM creation */
165 struct hda_pcm {
166 	char *name;
167 	struct hda_pcm_stream stream[2];
168 	unsigned int pcm_type;	/* HDA_PCM_TYPE_XXX */
169 	int device;		/* device number to assign */
170 	struct snd_pcm *pcm;	/* assigned PCM instance */
171 	bool own_chmap;		/* codec driver provides own channel maps */
172 	/* private: */
173 	struct hda_codec *codec;
174 	struct list_head list;
175 	unsigned int disconnected:1;
176 };
177 
178 /* codec information */
179 struct hda_codec {
180 	struct hdac_device core;
181 	struct hda_bus *bus;
182 	struct snd_card *card;
183 	unsigned int addr;	/* codec addr*/
184 	u32 probe_id; /* overridden id for probing */
185 
186 	/* detected preset */
187 	const struct hda_device_id *preset;
188 	const char *modelname;	/* model name for preset */
189 
190 	/* PCM to create, set by hda_codec_ops.build_pcms callback */
191 	struct list_head pcm_list_head;
192 	struct snd_refcount pcm_ref;
193 
194 	/* codec specific info */
195 	void *spec;
196 
197 	/* beep device */
198 	struct hda_beep *beep;
199 	unsigned int beep_mode;
200 	bool beep_just_power_on;
201 
202 	/* widget capabilities cache */
203 	u32 *wcaps;
204 
205 	struct snd_array mixers;	/* list of assigned mixer elements */
206 	struct snd_array nids;		/* list of mapped mixer elements */
207 
208 	struct list_head conn_list;	/* linked-list of connection-list */
209 
210 	struct mutex spdif_mutex;
211 	struct mutex control_mutex;
212 	struct snd_array spdif_out;
213 	unsigned int spdif_in_enable;	/* SPDIF input enable? */
214 	const hda_nid_t *follower_dig_outs; /* optional digital out follower widgets */
215 	struct snd_array init_pins;	/* initial (BIOS) pin configurations */
216 	struct snd_array driver_pins;	/* pin configs set by codec parser */
217 	struct snd_array cvt_setups;	/* audio convert setups */
218 
219 	struct mutex user_mutex;
220 #ifdef CONFIG_SND_HDA_RECONFIG
221 	struct snd_array init_verbs;	/* additional init verbs */
222 	struct snd_array hints;		/* additional hints */
223 	struct snd_array user_pins;	/* default pin configs to override */
224 #endif
225 
226 #ifdef CONFIG_SND_HDA_HWDEP
227 	struct snd_hwdep *hwdep;	/* assigned hwdep device */
228 #endif
229 
230 	/* misc flags */
231 	unsigned int configured:1; /* codec was configured */
232 	unsigned int in_freeing:1; /* being released */
233 	unsigned int display_power_control:1; /* needs display power */
234 	unsigned int spdif_status_reset :1; /* needs to toggle SPDIF for each
235 					     * status change
236 					     * (e.g. Realtek codecs)
237 					     */
238 	unsigned int pin_amp_workaround:1; /* pin out-amp takes index
239 					    * (e.g. Conexant codecs)
240 					    */
241 	unsigned int single_adc_amp:1; /* adc in-amp takes no index
242 					* (e.g. CX20549 codec)
243 					*/
244 	unsigned int no_sticky_stream:1; /* no sticky-PCM stream assignment */
245 	unsigned int pins_shutup:1;	/* pins are shut up */
246 	unsigned int no_trigger_sense:1; /* don't trigger at pin-sensing */
247 	unsigned int no_jack_detect:1;	/* Machine has no jack-detection */
248 	unsigned int inv_eapd:1; /* broken h/w: inverted EAPD control */
249 	unsigned int inv_jack_detect:1;	/* broken h/w: inverted detection bit */
250 	unsigned int pcm_format_first:1; /* PCM format must be set first */
251 	unsigned int cached_write:1;	/* write only to caches */
252 	unsigned int dp_mst:1; /* support DP1.2 Multi-stream transport */
253 	unsigned int dump_coef:1; /* dump processing coefs in codec proc file */
254 	unsigned int power_save_node:1; /* advanced PM for each widget */
255 	unsigned int auto_runtime_pm:1; /* enable automatic codec runtime pm */
256 	unsigned int force_pin_prefix:1; /* Add location prefix */
257 	unsigned int link_down_at_suspend:1; /* link down at runtime suspend */
258 	unsigned int relaxed_resume:1;	/* don't resume forcibly for jack */
259 	unsigned int forced_resume:1; /* forced resume for jack */
260 	unsigned int acomp_requested_resume:1; /* resume requested by acomp */
261 	unsigned int no_stream_clean_at_suspend:1; /* do not clean streams at suspend */
262 	unsigned int ctl_dev_id:1; /* old control element id build behaviour */
263 	unsigned int eld_jack_detect:1;	/* Machine jack-detection by ELD */
264 
265 	unsigned long power_on_acct;
266 	unsigned long power_off_acct;
267 	unsigned long power_jiffies;
268 
269 	/* filter the requested power state per nid */
270 	unsigned int (*power_filter)(struct hda_codec *codec, hda_nid_t nid,
271 				     unsigned int power_state);
272 
273 	/* codec-specific additional proc output */
274 	void (*proc_widget_hook)(struct snd_info_buffer *buffer,
275 				 struct hda_codec *codec, hda_nid_t nid);
276 
277 	/* jack detection */
278 	struct hda_jack_tbl *jacktbl, *jacktbl_last; /* linked list head/tail */
279 	int jacktbl_used; /* number of jacktbl elements */
280 	unsigned long jackpoll_interval; /* In jiffies. Zero means no poll, rely on unsol events */
281 	struct delayed_work jackpoll_work;
282 
283 	int depop_delay; /* depop delay in ms, -1 for default delay time */
284 
285 	/* fix-up list */
286 	int fixup_id;
287 	const struct hda_fixup *fixup_list;
288 	const char *fixup_name;
289 
290 	/* additional init verbs */
291 	struct snd_array verbs;
292 };
293 
294 #define dev_to_hda_codec(_dev)	container_of(_dev, struct hda_codec, core.dev)
295 #define hda_codec_dev(_dev)	(&(_dev)->core.dev)
296 
297 #define hdac_to_hda_codec(_hdac) container_of(_hdac, struct hda_codec, core)
298 
299 #define list_for_each_codec(c, bus) \
300 	list_for_each_entry(c, &(bus)->core.codec_list, core.list)
301 #define list_for_each_codec_safe(c, n, bus)				\
302 	list_for_each_entry_safe(c, n, &(bus)->core.codec_list, core.list)
303 
304 /* snd_hda_codec_read/write optional flags */
305 #define HDA_RW_NO_RESPONSE_FALLBACK	(1 << 0)
306 
307 /*
308  * constructors
309  */
310 __printf(3, 4) struct hda_codec *
311 snd_hda_codec_device_init(struct hda_bus *bus, unsigned int codec_addr,
312 			  const char *fmt, ...);
313 int snd_hda_codec_new(struct hda_bus *bus, struct snd_card *card,
314 		      unsigned int codec_addr, struct hda_codec **codecp);
315 int snd_hda_codec_device_new(struct hda_bus *bus, struct snd_card *card,
316 		      unsigned int codec_addr, struct hda_codec *codec,
317 		      bool snddev_managed);
318 int snd_hda_codec_configure(struct hda_codec *codec);
319 int snd_hda_codec_update_widgets(struct hda_codec *codec);
320 void snd_hda_codec_register(struct hda_codec *codec);
321 void snd_hda_codec_unregister(struct hda_codec *codec);
322 void snd_hda_codec_cleanup_for_unbind(struct hda_codec *codec);
323 
324 /*
325  * low level functions
326  */
327 static inline unsigned int
328 snd_hda_codec_read(struct hda_codec *codec, hda_nid_t nid,
329 				int flags,
330 				unsigned int verb, unsigned int parm)
331 {
332 	return snd_hdac_codec_read(&codec->core, nid, flags, verb, parm);
333 }
334 
335 static inline int
336 snd_hda_codec_write(struct hda_codec *codec, hda_nid_t nid, int flags,
337 			unsigned int verb, unsigned int parm)
338 {
339 	return snd_hdac_codec_write(&codec->core, nid, flags, verb, parm);
340 }
341 
342 /* sync after write */
343 static inline int
344 snd_hda_codec_write_sync(struct hda_codec *codec, hda_nid_t nid, int flags,
345 			 unsigned int verb, unsigned int parm)
346 {
347 	/* use snd_hda_codec_read() for writing;
348 	 * the returned value is usually discarded
349 	 */
350 	return snd_hdac_codec_read(&codec->core, nid, flags, verb, parm);
351 }
352 
353 #define snd_hda_param_read(codec, nid, param) \
354 	snd_hdac_read_parm(&(codec)->core, nid, param)
355 #define snd_hda_get_sub_nodes(codec, nid, start_nid) \
356 	snd_hdac_get_sub_nodes(&(codec)->core, nid, start_nid)
357 int snd_hda_get_connections(struct hda_codec *codec, hda_nid_t nid,
358 			    hda_nid_t *conn_list, int max_conns);
359 static inline int
360 snd_hda_get_num_conns(struct hda_codec *codec, hda_nid_t nid)
361 {
362 	return snd_hda_get_connections(codec, nid, NULL, 0);
363 }
364 
365 #define snd_hda_get_raw_connections(codec, nid, list, max_conns) \
366 	snd_hdac_get_connections(&(codec)->core, nid, list, max_conns)
367 #define snd_hda_get_num_raw_conns(codec, nid) \
368 	snd_hdac_get_connections(&(codec)->core, nid, NULL, 0)
369 
370 int snd_hda_get_conn_list(struct hda_codec *codec, hda_nid_t nid,
371 			  const hda_nid_t **listp);
372 int snd_hda_override_conn_list(struct hda_codec *codec, hda_nid_t nid, int nums,
373 			  const hda_nid_t *list);
374 int snd_hda_get_conn_index(struct hda_codec *codec, hda_nid_t mux,
375 			   hda_nid_t nid, int recursive);
376 unsigned int snd_hda_get_num_devices(struct hda_codec *codec, hda_nid_t nid);
377 unsigned int snd_hda_get_devices(struct hda_codec *codec, hda_nid_t nid,
378 				u8 *dev_list, unsigned int max_devices);
379 int snd_hda_get_dev_select(struct hda_codec *codec, hda_nid_t nid);
380 int snd_hda_set_dev_select(struct hda_codec *codec, hda_nid_t nid, int dev_id);
381 
382 struct hda_verb {
383 	hda_nid_t nid;
384 	u32 verb;
385 	u32 param;
386 };
387 
388 void snd_hda_sequence_write(struct hda_codec *codec,
389 			    const struct hda_verb *seq);
390 
391 /* cached write */
392 static inline int
393 snd_hda_codec_write_cache(struct hda_codec *codec, hda_nid_t nid,
394 			  int flags, unsigned int verb, unsigned int parm)
395 {
396 	return snd_hdac_regmap_write(&codec->core, nid, verb, parm);
397 }
398 
399 /* the struct for codec->pin_configs */
400 struct hda_pincfg {
401 	hda_nid_t nid;
402 	unsigned char ctrl;	/* original pin control value */
403 	unsigned char target;	/* target pin control value */
404 	unsigned int cfg;	/* default configuration */
405 };
406 
407 unsigned int snd_hda_codec_get_pincfg(struct hda_codec *codec, hda_nid_t nid);
408 int snd_hda_codec_set_pincfg(struct hda_codec *codec, hda_nid_t nid,
409 			     unsigned int cfg);
410 int snd_hda_add_pincfg(struct hda_codec *codec, struct snd_array *list,
411 		       hda_nid_t nid, unsigned int cfg); /* for hwdep */
412 void snd_hda_shutup_pins(struct hda_codec *codec);
413 
414 /* SPDIF controls */
415 struct hda_spdif_out {
416 	hda_nid_t nid;		/* Converter nid values relate to */
417 	unsigned int status;	/* IEC958 status bits */
418 	unsigned short ctls;	/* SPDIF control bits */
419 };
420 struct hda_spdif_out *snd_hda_spdif_out_of_nid(struct hda_codec *codec,
421 					       hda_nid_t nid);
422 void snd_hda_spdif_ctls_unassign(struct hda_codec *codec, int idx);
423 void snd_hda_spdif_ctls_assign(struct hda_codec *codec, int idx, hda_nid_t nid);
424 
425 /*
426  * Mixer
427  */
428 int snd_hda_codec_build_controls(struct hda_codec *codec);
429 
430 /*
431  * PCM
432  */
433 int snd_hda_codec_parse_pcms(struct hda_codec *codec);
434 int snd_hda_codec_build_pcms(struct hda_codec *codec);
435 
436 __printf(2, 3)
437 struct hda_pcm *snd_hda_codec_pcm_new(struct hda_codec *codec,
438 				      const char *fmt, ...);
439 
440 void snd_hda_codec_cleanup_for_unbind(struct hda_codec *codec);
441 
442 static inline void snd_hda_codec_pcm_get(struct hda_pcm *pcm)
443 {
444 	snd_refcount_get(&pcm->codec->pcm_ref);
445 }
446 static inline void snd_hda_codec_pcm_put(struct hda_pcm *pcm)
447 {
448 	snd_refcount_put(&pcm->codec->pcm_ref);
449 }
450 
451 int snd_hda_codec_prepare(struct hda_codec *codec,
452 			  struct hda_pcm_stream *hinfo,
453 			  unsigned int stream,
454 			  unsigned int format,
455 			  struct snd_pcm_substream *substream);
456 void snd_hda_codec_cleanup(struct hda_codec *codec,
457 			   struct hda_pcm_stream *hinfo,
458 			   struct snd_pcm_substream *substream);
459 
460 void snd_hda_codec_setup_stream(struct hda_codec *codec, hda_nid_t nid,
461 				u32 stream_tag,
462 				int channel_id, int format);
463 void __snd_hda_codec_cleanup_stream(struct hda_codec *codec, hda_nid_t nid,
464 				    int do_now);
465 #define snd_hda_codec_cleanup_stream(codec, nid) \
466 	__snd_hda_codec_cleanup_stream(codec, nid, 0)
467 
468 #define snd_hda_query_supported_pcm(codec, nid, ratesp, fmtsp, subfmtp, bpsp) \
469 	snd_hdac_query_supported_pcm(&(codec)->core, nid, ratesp, fmtsp, subfmtp, bpsp)
470 #define snd_hda_is_supported_format(codec, nid, fmt) \
471 	snd_hdac_is_supported_format(&(codec)->core, nid, fmt)
472 
473 extern const struct snd_pcm_chmap_elem snd_pcm_2_1_chmaps[];
474 
475 int snd_hda_attach_pcm_stream(struct hda_bus *_bus, struct hda_codec *codec,
476 			      struct hda_pcm *cpcm);
477 
478 /*
479  * Misc
480  */
481 void snd_hda_get_codec_name(struct hda_codec *codec, char *name, int namelen);
482 void snd_hda_codec_set_power_to_all(struct hda_codec *codec, hda_nid_t fg,
483 				    unsigned int power_state);
484 
485 int snd_hda_lock_devices(struct hda_bus *bus);
486 void snd_hda_unlock_devices(struct hda_bus *bus);
487 void snd_hda_bus_reset(struct hda_bus *bus);
488 void snd_hda_bus_reset_codecs(struct hda_bus *bus);
489 
490 void snd_hda_codec_set_gpio(struct hda_codec *codec, unsigned int mask,
491 			    unsigned int dir, unsigned int data,
492 			    unsigned int delay);
493 
494 int snd_hda_codec_set_name(struct hda_codec *codec, const char *name);
495 
496 /*
497  * power management
498  */
499 extern const struct dev_pm_ops hda_codec_driver_pm;
500 
501 static inline
502 int hda_call_check_power_status(struct hda_codec *codec, hda_nid_t nid)
503 {
504 	struct hda_codec_driver *driver = hda_codec_to_driver(codec);
505 
506 	if (driver->ops && driver->ops->check_power_status)
507 		return driver->ops->check_power_status(codec, nid);
508 	return 0;
509 }
510 
511 /*
512  * power saving
513  */
514 #define snd_hda_power_up(codec)		snd_hdac_power_up(&(codec)->core)
515 #define snd_hda_power_up_pm(codec)	snd_hdac_power_up_pm(&(codec)->core)
516 #define snd_hda_power_down(codec)	snd_hdac_power_down(&(codec)->core)
517 #define snd_hda_power_down_pm(codec)	snd_hdac_power_down_pm(&(codec)->core)
518 void snd_hda_codec_set_power_save(struct hda_codec *codec, int delay);
519 void snd_hda_set_power_save(struct hda_bus *bus, int delay);
520 void snd_hda_update_power_acct(struct hda_codec *codec);
521 
522 static inline bool hda_codec_need_resume(struct hda_codec *codec)
523 {
524 	return !codec->relaxed_resume && codec->jacktbl_used;
525 }
526 
527 /*
528  * PM with auto-cleanup: call like CLASS(snd_hda_power, pm)(codec)
529  * If the error handling is needed, refer pm.err.
530  */
531 struct __hda_power_obj {
532 	struct hda_codec *codec;
533 	int err;
534 };
535 
536 static inline struct __hda_power_obj __snd_hda_power_up(struct hda_codec *codec)
537 {
538 	struct __hda_power_obj T = { .codec = codec };
539 	T.err = snd_hda_power_up(codec);
540 	return T;
541 }
542 
543 static inline struct __hda_power_obj __snd_hda_power_up_pm(struct hda_codec *codec)
544 {
545 	struct __hda_power_obj T = { .codec = codec };
546 	T.err = snd_hda_power_up_pm(codec);
547 	return T;
548 }
549 
550 DEFINE_CLASS(snd_hda_power, struct __hda_power_obj,
551 	     snd_hda_power_down((_T).codec), __snd_hda_power_up(codec),
552 	     struct hda_codec *codec)
553 DEFINE_CLASS(snd_hda_power_pm, struct __hda_power_obj,
554 	     snd_hda_power_down_pm((_T).codec), __snd_hda_power_up_pm(codec),
555 	     struct hda_codec *codec)
556 
557 #ifdef CONFIG_SND_HDA_PATCH_LOADER
558 /*
559  * patch firmware
560  */
561 int snd_hda_load_patch(struct hda_bus *bus, size_t size, const void *buf);
562 #endif
563 
564 #ifdef CONFIG_SND_HDA_DSP_LOADER
565 int snd_hda_codec_load_dsp_prepare(struct hda_codec *codec, unsigned int format,
566 				   unsigned int size,
567 				   struct snd_dma_buffer *bufp);
568 void snd_hda_codec_load_dsp_trigger(struct hda_codec *codec, bool start);
569 void snd_hda_codec_load_dsp_cleanup(struct hda_codec *codec,
570 				    struct snd_dma_buffer *dmab);
571 #else
572 static inline int
573 snd_hda_codec_load_dsp_prepare(struct hda_codec *codec, unsigned int format,
574 				unsigned int size,
575 				struct snd_dma_buffer *bufp)
576 {
577 	return -ENOSYS;
578 }
579 static inline void
580 snd_hda_codec_load_dsp_trigger(struct hda_codec *codec, bool start) {}
581 static inline void
582 snd_hda_codec_load_dsp_cleanup(struct hda_codec *codec,
583 				struct snd_dma_buffer *dmab) {}
584 #endif
585 
586 #endif /* __SOUND_HDA_CODEC_H */
587