include/sound/soc-dapm.h

1 /* SPDX-License-Identifier: GPL-2.0
3  * linux/sound/soc-dapm.h -- ALSA SoC Dynamic Audio Power Management
15 #include <sound/soc-topology.h>
24 #define SND_SOC_NOPM	-1
30  *  1. Codec domain - VREF, VMID
33  *  2. Platform/Machine domain - physically connected inputs and outputs
36  *  3. Path domain - Internal codec path mixers
39  *  4. Stream domain - DAC's and ADC's.
158 /* path domain with event - event handler must return 0 for success */
399 /* regulator widget flags */
408 struct regulator;
419  * @STANDBY: Low power standby state when no playback/capture operations are
420  *           in progress. NOTE: The transition time between STANDBY and ON
488 /* dapm sys fs - used by the core */
531 	snd_soc_dapm_micbias,		/* microphone bias (power) - DEPRECATED: use snd_soc_dapm_supply */
537 	snd_soc_dapm_vmid,		/* codec bias/vmid - to minimise pops */
538 	snd_soc_dapm_pre,		/* machine specific pre widget - exec first */
539 	snd_soc_dapm_post,		/* machine specific post widget - exec last */
542 	snd_soc_dapm_regulator_supply,	/* external regulator */
551 	snd_soc_dapm_kcontrol,		/* Auto-disabled kcontrol */
589 	 * p->source, rather than p->node[SND_SOC_DAPM_DIR_IN]
622 	struct regulator *regulator;		/* attached regulator */  member
628 	unsigned int mask;			/* non-shifted mask */
629 	unsigned int on_val;			/* on state value */
630 	unsigned int off_val;			/* off state value */
635 	unsigned char force:1;			/* force state */
686 	unsigned int idle_bias_off:1;		/* Use BIAS_OFF instead of STANDBY */
689 	struct device *dev;			/* from parent - for debug */
713 	     (i) < list->num_widgets && (widget = list->widgets[i]);	\
728  * snd_soc_dapm_init_bias_level() - Initialize DAPM bias level
732  * This function only sets the driver internal state of the DAPM level and will
733  * not modify the state of the device. Hence it should not be used during normal
734  * operation, but only to synchronize the internal state to the device state.
736  * the power-on reset state of the device.
738  * To change the DAPM state of the device use snd_soc_dapm_set_bias_level().
743 	dapm->bias_level = level;  in snd_soc_dapm_init_bias_level()
747  * snd_soc_dapm_get_bias_level() - Get current DAPM bias level
755 	return dapm->bias_level;  in snd_soc_dapm_get_bias_level()
769  * snd_soc_dapm_widget_for_each_path - Iterates over all paths in the
777 	list_for_each_entry(p, &w->edges[dir], list_node[dir])
780  * snd_soc_dapm_widget_for_each_path_safe - Iterates over all paths in the
792 	list_for_each_entry_safe(p, next_p, &w->edges[dir], list_node[dir])
795  * snd_soc_dapm_widget_for_each_sink_path - Iterates over all paths leaving a
804  * snd_soc_dapm_widget_for_each_source_path - Iterates over all paths leading to