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