sound/soc/dapm.rst

11 such, can easily co-exist with the other PM systems.
29       can be set at stream time if power is not needed for sidetone, etc.
60 Audio DAPM widgets fall into a number of types:-
117 ASRC
127 (Widgets are defined in include/sound/soc-dapm.h)
129 Widgets can be added to the sound card by any of the component driver types.
130 There are convenience macros defined in soc-dapm.h that can be used to quickly
138 ---------------------
144 Stream widgets have the following format:-
153 e.g. stream widgets for HiFi playback and capture
156   SND_SOC_DAPM_DAC("HiFi DAC", "HiFi Playback", REG, 3, 1),
157   SND_SOC_DAPM_ADC("HiFi ADC", "HiFi Capture", REG, 2, 1),
167 -------------------
170 audio paths within the audio subsystem. They have the following form:-
175 Any widget kcontrols can be set using the controls and num_controls members.
184   SOC_DAPM_SINGLE("HiFi Playback Switch", WM8731_APANA, 4, 1, 0),
196 ----------------------
200 machine audio component (non codec or DSP) that can be independently
210 when the Mic is inserted:-::
222 -------------------
230 ---------------
234 a virtual widget - a widget with no control bits e.g.
239 This can be used to merge to signal paths together in software.
241 After all the widgets have been defined, they can then be added to the DAPM
249 audio paths (called interconnections). Each interconnection must be defined in
261 2. DAC (HiFi playback)
271 	{"Output Mixer", "HiFi Playback Switch", "DAC"},
274 So we have :-
278 * ``Output Mixer`` is connected to the ``DAC`` via the ``HiFi Playback Switch``.
283 Interconnections are created with a call to:-
288 Finally, snd_soc_dapm_new_widgets(codec) must be called after all widgets and
295 -------------------------------
321 Endpoints are added to the DAPM graph so that their usage can be determined in
322 order to save power. e.g. NC codecs pins will be switched OFF, unconnected
323 jacks can also be switched OFF.
330 e.g. A Speaker with an amplifier registers a widget so the amplifier can be
345 Please see soc-dapm.h for all other widgets that support events.
349 -----------