sound/soc/dapm.rst

9 Linux devices to use the minimum amount of power within the audio
11 such, can easily co-exist with the other PM systems.
20 audio subsystem, this includes internal codec power blocks and machine
53 internal codec components). All audio components that effect power are called
60 Audio DAPM widgets fall into a number of types:-
87 	Power or clock supply widget used by other widgets.
90 Clock
91 	External clock that supplies clock to audio components.
111 	DSP internal scheduler that schedules component/pipeline processing
127 (Widgets are defined in include/sound/soc-dapm.h)
130 There are convenience macros defined in soc-dapm.h that can be used to quickly
138 ---------------------
144 Stream widgets have the following format:-
167 -------------------
170 audio paths within the audio subsystem. They have the following form:-
191 you can use SND_SOC_DAPM_MIXER_NAMED_CTL instead. the parameters are the same
196 ----------------------
210 when the Mic is inserted:-::
222 -------------------
230 ---------------
234 a virtual widget - a widget with no control bits e.g.
274 So we have :-
283 Interconnections are created with a call to:-
290 scan the codec and machine so that the internal DAPM state matches the
295 -------------------------------
299 e.g. connects the speaker out codec pins to the internal speaker.
306 This allows the DAPM to power on and off pins that are connected (and in use)
316 * Internal Speaker
317 * Internal Mic
331 powered only when the spk is in use.
334   /* turn speaker amplifier on/off depending on use */
345 Please see soc-dapm.h for all other widgets that support events.
349 -----------