1 // SPDX-License-Identifier: GPL-2.0+
3 // soc-dapm.c -- ALSA SoC Dynamic Audio Power Management
5 // Copyright 2005 Wolfson Microelectronics PLC.
6 // Author: Liam Girdwood <lrg@slimlogic.co.uk>
9 // o Changes power status of internal codec blocks depending on the
10 // dynamic configuration of codec internal audio paths and active
12 // o Platform power domain - can support external components i.e. amps and
13 // mic/headphone insertion events.
14 // o Automatic Mic Bias support
15 // o Jack insertion power event initiation - e.g. hp insertion will enable
17 // o Delayed power down of audio subsystem to reduce pops between a quick
20 #include <linux/module.h>
21 #include <linux/init.h>
22 #include <linux/async.h>
23 #include <linux/delay.h>
25 #include <linux/bitops.h>
26 #include <linux/platform_device.h>
27 #include <linux/jiffies.h>
28 #include <linux/debugfs.h>
29 #include <linux/pm_runtime.h>
30 #include <linux/regulator/consumer.h>
31 #include <linux/pinctrl/consumer.h>
32 #include <linux/clk.h>
33 #include <linux/slab.h>
34 #include <sound/core.h>
35 #include <sound/pcm.h>
36 #include <sound/pcm_params.h>
37 #include <sound/soc.h>
38 #include <sound/initval.h>
40 #include <trace/events/asoc.h>
42 #define DAPM_UPDATE_STAT(widget, val) widget->dapm->card->dapm_stats.val++;
44 #define SND_SOC_DAPM_DIR_REVERSE(x) ((x == SND_SOC_DAPM_DIR_IN) ? \
45 SND_SOC_DAPM_DIR_OUT : SND_SOC_DAPM_DIR_IN)
47 #define snd_soc_dapm_for_each_direction(dir) \
48 for ((dir) = SND_SOC_DAPM_DIR_IN; (dir) <= SND_SOC_DAPM_DIR_OUT; \
51 static int snd_soc_dapm_add_path(struct snd_soc_dapm_context *dapm,
52 struct snd_soc_dapm_widget *wsource, struct snd_soc_dapm_widget *wsink,
54 int (*connected)(struct snd_soc_dapm_widget *source,
55 struct snd_soc_dapm_widget *sink));
57 struct snd_soc_dapm_widget *
58 snd_soc_dapm_new_control(struct snd_soc_dapm_context *dapm,
59 const struct snd_soc_dapm_widget *widget);
61 struct snd_soc_dapm_widget *
62 snd_soc_dapm_new_control_unlocked(struct snd_soc_dapm_context *dapm,
63 const struct snd_soc_dapm_widget *widget);
65 /* dapm power sequences - make this per codec in the future */
66 static int dapm_up_seq[] = {
67 [snd_soc_dapm_pre] = 1,
68 [snd_soc_dapm_regulator_supply] = 2,
69 [snd_soc_dapm_pinctrl] = 2,
70 [snd_soc_dapm_clock_supply] = 2,
71 [snd_soc_dapm_supply] = 3,
72 [snd_soc_dapm_micbias] = 4,
73 [snd_soc_dapm_vmid] = 4,
74 [snd_soc_dapm_dai_link] = 3,
75 [snd_soc_dapm_dai_in] = 5,
76 [snd_soc_dapm_dai_out] = 5,
77 [snd_soc_dapm_aif_in] = 5,
78 [snd_soc_dapm_aif_out] = 5,
79 [snd_soc_dapm_mic] = 6,
80 [snd_soc_dapm_siggen] = 6,
81 [snd_soc_dapm_input] = 6,
82 [snd_soc_dapm_output] = 6,
83 [snd_soc_dapm_mux] = 7,
84 [snd_soc_dapm_demux] = 7,
85 [snd_soc_dapm_dac] = 8,
86 [snd_soc_dapm_switch] = 9,
87 [snd_soc_dapm_mixer] = 9,
88 [snd_soc_dapm_mixer_named_ctl] = 9,
89 [snd_soc_dapm_pga] = 10,
90 [snd_soc_dapm_buffer] = 10,
91 [snd_soc_dapm_scheduler] = 10,
92 [snd_soc_dapm_effect] = 10,
93 [snd_soc_dapm_src] = 10,
94 [snd_soc_dapm_asrc] = 10,
95 [snd_soc_dapm_encoder] = 10,
96 [snd_soc_dapm_decoder] = 10,
97 [snd_soc_dapm_adc] = 11,
98 [snd_soc_dapm_out_drv] = 12,
99 [snd_soc_dapm_hp] = 12,
100 [snd_soc_dapm_spk] = 12,
101 [snd_soc_dapm_line] = 12,
102 [snd_soc_dapm_sink] = 12,
103 [snd_soc_dapm_kcontrol] = 13,
104 [snd_soc_dapm_post] = 14,
107 static int dapm_down_seq[] = {
108 [snd_soc_dapm_pre] = 1,
109 [snd_soc_dapm_kcontrol] = 2,
110 [snd_soc_dapm_adc] = 3,
111 [snd_soc_dapm_hp] = 4,
112 [snd_soc_dapm_spk] = 4,
113 [snd_soc_dapm_line] = 4,
114 [snd_soc_dapm_out_drv] = 4,
115 [snd_soc_dapm_sink] = 4,
116 [snd_soc_dapm_pga] = 5,
117 [snd_soc_dapm_buffer] = 5,
118 [snd_soc_dapm_scheduler] = 5,
119 [snd_soc_dapm_effect] = 5,
120 [snd_soc_dapm_src] = 5,
121 [snd_soc_dapm_asrc] = 5,
122 [snd_soc_dapm_encoder] = 5,
123 [snd_soc_dapm_decoder] = 5,
124 [snd_soc_dapm_switch] = 6,
125 [snd_soc_dapm_mixer_named_ctl] = 6,
126 [snd_soc_dapm_mixer] = 6,
127 [snd_soc_dapm_dac] = 7,
128 [snd_soc_dapm_mic] = 8,
129 [snd_soc_dapm_siggen] = 8,
130 [snd_soc_dapm_input] = 8,
131 [snd_soc_dapm_output] = 8,
132 [snd_soc_dapm_micbias] = 9,
133 [snd_soc_dapm_vmid] = 9,
134 [snd_soc_dapm_mux] = 10,
135 [snd_soc_dapm_demux] = 10,
136 [snd_soc_dapm_aif_in] = 11,
137 [snd_soc_dapm_aif_out] = 11,
138 [snd_soc_dapm_dai_in] = 11,
139 [snd_soc_dapm_dai_out] = 11,
140 [snd_soc_dapm_dai_link] = 12,
141 [snd_soc_dapm_supply] = 13,
142 [snd_soc_dapm_clock_supply] = 14,
143 [snd_soc_dapm_pinctrl] = 14,
144 [snd_soc_dapm_regulator_supply] = 14,
145 [snd_soc_dapm_post] = 15,
148 static void dapm_assert_locked(struct snd_soc_dapm_context *dapm)
150 if (dapm->card && dapm->card->instantiated)
151 lockdep_assert_held(&dapm->card->dapm_mutex);
154 static void pop_wait(u32 pop_time)
157 schedule_timeout_uninterruptible(msecs_to_jiffies(pop_time));
161 static void pop_dbg(struct device *dev, u32 pop_time, const char *fmt, ...)
169 buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
174 vsnprintf(buf, PAGE_SIZE, fmt, args);
175 dev_info(dev, "%s", buf);
181 static bool dapm_dirty_widget(struct snd_soc_dapm_widget *w)
183 return !list_empty(&w->dirty);
186 static void dapm_mark_dirty(struct snd_soc_dapm_widget *w, const char *reason)
188 dapm_assert_locked(w->dapm);
190 if (!dapm_dirty_widget(w)) {
191 dev_vdbg(w->dapm->dev, "Marking %s dirty due to %s\n",
193 list_add_tail(&w->dirty, &w->dapm->card->dapm_dirty);
198 * Common implementation for dapm_widget_invalidate_input_paths() and
199 * dapm_widget_invalidate_output_paths(). The function is inlined since the
200 * combined size of the two specialized functions is only marginally larger then
201 * the size of the generic function and at the same time the fast path of the
202 * specialized functions is significantly smaller than the generic function.
204 static __always_inline void dapm_widget_invalidate_paths(
205 struct snd_soc_dapm_widget *w, enum snd_soc_dapm_direction dir)
207 enum snd_soc_dapm_direction rdir = SND_SOC_DAPM_DIR_REVERSE(dir);
208 struct snd_soc_dapm_widget *node;
209 struct snd_soc_dapm_path *p;
212 dapm_assert_locked(w->dapm);
214 if (w->endpoints[dir] == -1)
217 list_add_tail(&w->work_list, &list);
218 w->endpoints[dir] = -1;
220 list_for_each_entry(w, &list, work_list) {
221 snd_soc_dapm_widget_for_each_path(w, dir, p) {
222 if (p->is_supply || p->weak || !p->connect)
224 node = p->node[rdir];
225 if (node->endpoints[dir] != -1) {
226 node->endpoints[dir] = -1;
227 list_add_tail(&node->work_list, &list);
234 * dapm_widget_invalidate_input_paths() - Invalidate the cached number of
236 * @w: The widget for which to invalidate the cached number of input paths
238 * Resets the cached number of inputs for the specified widget and all widgets
239 * that can be reached via outcoming paths from the widget.
241 * This function must be called if the number of output paths for a widget might
242 * have changed. E.g. if the source state of a widget changes or a path is added
243 * or activated with the widget as the sink.
245 static void dapm_widget_invalidate_input_paths(struct snd_soc_dapm_widget *w)
247 dapm_widget_invalidate_paths(w, SND_SOC_DAPM_DIR_IN);
251 * dapm_widget_invalidate_output_paths() - Invalidate the cached number of
253 * @w: The widget for which to invalidate the cached number of output paths
255 * Resets the cached number of outputs for the specified widget and all widgets
256 * that can be reached via incoming paths from the widget.
258 * This function must be called if the number of output paths for a widget might
259 * have changed. E.g. if the sink state of a widget changes or a path is added
260 * or activated with the widget as the source.
262 static void dapm_widget_invalidate_output_paths(struct snd_soc_dapm_widget *w)
264 dapm_widget_invalidate_paths(w, SND_SOC_DAPM_DIR_OUT);
268 * dapm_path_invalidate() - Invalidates the cached number of inputs and outputs
269 * for the widgets connected to a path
270 * @p: The path to invalidate
272 * Resets the cached number of inputs for the sink of the path and the cached
273 * number of outputs for the source of the path.
275 * This function must be called when a path is added, removed or the connected
278 static void dapm_path_invalidate(struct snd_soc_dapm_path *p)
281 * Weak paths or supply paths do not influence the number of input or
282 * output paths of their neighbors.
284 if (p->weak || p->is_supply)
288 * The number of connected endpoints is the sum of the number of
289 * connected endpoints of all neighbors. If a node with 0 connected
290 * endpoints is either connected or disconnected that sum won't change,
291 * so there is no need to re-check the path.
293 if (p->source->endpoints[SND_SOC_DAPM_DIR_IN] != 0)
294 dapm_widget_invalidate_input_paths(p->sink);
295 if (p->sink->endpoints[SND_SOC_DAPM_DIR_OUT] != 0)
296 dapm_widget_invalidate_output_paths(p->source);
299 void dapm_mark_endpoints_dirty(struct snd_soc_card *card)
301 struct snd_soc_dapm_widget *w;
303 mutex_lock(&card->dapm_mutex);
305 for_each_card_widgets(card, w) {
307 dapm_mark_dirty(w, "Rechecking endpoints");
308 if (w->is_ep & SND_SOC_DAPM_EP_SINK)
309 dapm_widget_invalidate_output_paths(w);
310 if (w->is_ep & SND_SOC_DAPM_EP_SOURCE)
311 dapm_widget_invalidate_input_paths(w);
315 mutex_unlock(&card->dapm_mutex);
317 EXPORT_SYMBOL_GPL(dapm_mark_endpoints_dirty);
319 /* create a new dapm widget */
320 static inline struct snd_soc_dapm_widget *dapm_cnew_widget(
321 const struct snd_soc_dapm_widget *_widget)
323 struct snd_soc_dapm_widget *w;
325 w = kmemdup(_widget, sizeof(*_widget), GFP_KERNEL);
330 * w->name is duplicated in caller, but w->sname isn't.
331 * Duplicate it here if defined
333 if (_widget->sname) {
334 w->sname = kstrdup_const(_widget->sname, GFP_KERNEL);
343 struct dapm_kcontrol_data {
345 struct snd_soc_dapm_widget *widget;
346 struct list_head paths;
347 struct snd_soc_dapm_widget_list *wlist;
350 static int dapm_kcontrol_data_alloc(struct snd_soc_dapm_widget *widget,
351 struct snd_kcontrol *kcontrol, const char *ctrl_name)
353 struct dapm_kcontrol_data *data;
354 struct soc_mixer_control *mc;
359 data = kzalloc(sizeof(*data), GFP_KERNEL);
363 INIT_LIST_HEAD(&data->paths);
365 switch (widget->id) {
366 case snd_soc_dapm_switch:
367 case snd_soc_dapm_mixer:
368 case snd_soc_dapm_mixer_named_ctl:
369 mc = (struct soc_mixer_control *)kcontrol->private_value;
371 if (mc->autodisable && snd_soc_volsw_is_stereo(mc))
372 dev_warn(widget->dapm->dev,
373 "ASoC: Unsupported stereo autodisable control '%s'\n",
376 if (mc->autodisable) {
377 struct snd_soc_dapm_widget template;
379 name = kasprintf(GFP_KERNEL, "%s %s", ctrl_name,
386 memset(&template, 0, sizeof(template));
387 template.reg = mc->reg;
388 template.mask = (1 << fls(mc->max)) - 1;
389 template.shift = mc->shift;
391 template.off_val = mc->max;
393 template.off_val = 0;
394 template.on_val = template.off_val;
395 template.id = snd_soc_dapm_kcontrol;
396 template.name = name;
398 data->value = template.on_val;
401 snd_soc_dapm_new_control_unlocked(widget->dapm,
404 if (IS_ERR(data->widget)) {
405 ret = PTR_ERR(data->widget);
410 case snd_soc_dapm_demux:
411 case snd_soc_dapm_mux:
412 e = (struct soc_enum *)kcontrol->private_value;
414 if (e->autodisable) {
415 struct snd_soc_dapm_widget template;
417 name = kasprintf(GFP_KERNEL, "%s %s", ctrl_name,
424 memset(&template, 0, sizeof(template));
425 template.reg = e->reg;
426 template.mask = e->mask;
427 template.shift = e->shift_l;
428 template.off_val = snd_soc_enum_item_to_val(e, 0);
429 template.on_val = template.off_val;
430 template.id = snd_soc_dapm_kcontrol;
431 template.name = name;
433 data->value = template.on_val;
435 data->widget = snd_soc_dapm_new_control_unlocked(
436 widget->dapm, &template);
438 if (IS_ERR(data->widget)) {
439 ret = PTR_ERR(data->widget);
443 snd_soc_dapm_add_path(widget->dapm, data->widget,
451 kcontrol->private_data = data;
460 static void dapm_kcontrol_free(struct snd_kcontrol *kctl)
462 struct dapm_kcontrol_data *data = snd_kcontrol_chip(kctl);
464 list_del(&data->paths);
469 static struct snd_soc_dapm_widget_list *dapm_kcontrol_get_wlist(
470 const struct snd_kcontrol *kcontrol)
472 struct dapm_kcontrol_data *data = snd_kcontrol_chip(kcontrol);
477 static int dapm_kcontrol_add_widget(struct snd_kcontrol *kcontrol,
478 struct snd_soc_dapm_widget *widget)
480 struct dapm_kcontrol_data *data = snd_kcontrol_chip(kcontrol);
481 struct snd_soc_dapm_widget_list *new_wlist;
485 n = data->wlist->num_widgets + 1;
489 new_wlist = krealloc(data->wlist,
490 struct_size(new_wlist, widgets, n),
495 new_wlist->widgets[n - 1] = widget;
496 new_wlist->num_widgets = n;
498 data->wlist = new_wlist;
503 static void dapm_kcontrol_add_path(const struct snd_kcontrol *kcontrol,
504 struct snd_soc_dapm_path *path)
506 struct dapm_kcontrol_data *data = snd_kcontrol_chip(kcontrol);
508 list_add_tail(&path->list_kcontrol, &data->paths);
511 static bool dapm_kcontrol_is_powered(const struct snd_kcontrol *kcontrol)
513 struct dapm_kcontrol_data *data = snd_kcontrol_chip(kcontrol);
518 return data->widget->power;
521 static struct list_head *dapm_kcontrol_get_path_list(
522 const struct snd_kcontrol *kcontrol)
524 struct dapm_kcontrol_data *data = snd_kcontrol_chip(kcontrol);
529 #define dapm_kcontrol_for_each_path(path, kcontrol) \
530 list_for_each_entry(path, dapm_kcontrol_get_path_list(kcontrol), \
533 unsigned int dapm_kcontrol_get_value(const struct snd_kcontrol *kcontrol)
535 struct dapm_kcontrol_data *data = snd_kcontrol_chip(kcontrol);
539 EXPORT_SYMBOL_GPL(dapm_kcontrol_get_value);
541 static bool dapm_kcontrol_set_value(const struct snd_kcontrol *kcontrol,
544 struct dapm_kcontrol_data *data = snd_kcontrol_chip(kcontrol);
546 if (data->value == value)
550 switch (dapm_kcontrol_get_wlist(kcontrol)->widgets[0]->id) {
551 case snd_soc_dapm_switch:
552 case snd_soc_dapm_mixer:
553 case snd_soc_dapm_mixer_named_ctl:
554 data->widget->on_val = value & data->widget->mask;
556 case snd_soc_dapm_demux:
557 case snd_soc_dapm_mux:
558 data->widget->on_val = value >> data->widget->shift;
561 data->widget->on_val = value;
572 * snd_soc_dapm_kcontrol_widget() - Returns the widget associated to a
574 * @kcontrol: The kcontrol
576 struct snd_soc_dapm_widget *snd_soc_dapm_kcontrol_widget(
577 struct snd_kcontrol *kcontrol)
579 return dapm_kcontrol_get_wlist(kcontrol)->widgets[0];
581 EXPORT_SYMBOL_GPL(snd_soc_dapm_kcontrol_widget);
584 * snd_soc_dapm_kcontrol_dapm() - Returns the dapm context associated to a
586 * @kcontrol: The kcontrol
588 * Note: This function must only be used on kcontrols that are known to have
589 * been registered for a CODEC. Otherwise the behaviour is undefined.
591 struct snd_soc_dapm_context *snd_soc_dapm_kcontrol_dapm(
592 struct snd_kcontrol *kcontrol)
594 return dapm_kcontrol_get_wlist(kcontrol)->widgets[0]->dapm;
596 EXPORT_SYMBOL_GPL(snd_soc_dapm_kcontrol_dapm);
598 static void dapm_reset(struct snd_soc_card *card)
600 struct snd_soc_dapm_widget *w;
602 lockdep_assert_held(&card->dapm_mutex);
604 memset(&card->dapm_stats, 0, sizeof(card->dapm_stats));
606 for_each_card_widgets(card, w) {
607 w->new_power = w->power;
608 w->power_checked = false;
612 static const char *soc_dapm_prefix(struct snd_soc_dapm_context *dapm)
614 if (!dapm->component)
616 return dapm->component->name_prefix;
619 static unsigned int soc_dapm_read(struct snd_soc_dapm_context *dapm, int reg)
621 if (!dapm->component)
623 return snd_soc_component_read(dapm->component, reg);
626 static int soc_dapm_update_bits(struct snd_soc_dapm_context *dapm,
627 int reg, unsigned int mask, unsigned int value)
629 if (!dapm->component)
631 return snd_soc_component_update_bits(dapm->component, reg,
635 static int soc_dapm_test_bits(struct snd_soc_dapm_context *dapm,
636 int reg, unsigned int mask, unsigned int value)
638 if (!dapm->component)
640 return snd_soc_component_test_bits(dapm->component, reg, mask, value);
643 static void soc_dapm_async_complete(struct snd_soc_dapm_context *dapm)
646 snd_soc_component_async_complete(dapm->component);
649 static struct snd_soc_dapm_widget *
650 dapm_wcache_lookup(struct snd_soc_dapm_wcache *wcache, const char *name)
652 struct snd_soc_dapm_widget *w = wcache->widget;
655 struct list_head *wlist = &w->dapm->card->widgets;
659 list_for_each_entry_from(w, wlist, list) {
660 if (!strcmp(name, w->name))
671 static inline void dapm_wcache_update(struct snd_soc_dapm_wcache *wcache,
672 struct snd_soc_dapm_widget *w)
678 * snd_soc_dapm_force_bias_level() - Sets the DAPM bias level
679 * @dapm: The DAPM context for which to set the level
680 * @level: The level to set
682 * Forces the DAPM bias level to a specific state. It will call the bias level
683 * callback of DAPM context with the specified level. This will even happen if
684 * the context is already at the same level. Furthermore it will not go through
685 * the normal bias level sequencing, meaning any intermediate states between the
686 * current and the target state will not be entered.
688 * Note that the change in bias level is only temporary and the next time
689 * snd_soc_dapm_sync() is called the state will be set to the level as
690 * determined by the DAPM core. The function is mainly intended to be used to
691 * used during probe or resume from suspend to power up the device so
692 * initialization can be done, before the DAPM core takes over.
694 int snd_soc_dapm_force_bias_level(struct snd_soc_dapm_context *dapm,
695 enum snd_soc_bias_level level)
700 ret = snd_soc_component_set_bias_level(dapm->component, level);
703 dapm->bias_level = level;
707 EXPORT_SYMBOL_GPL(snd_soc_dapm_force_bias_level);
710 * snd_soc_dapm_set_bias_level - set the bias level for the system
711 * @dapm: DAPM context
712 * @level: level to configure
714 * Configure the bias (power) levels for the SoC audio device.
716 * Returns 0 for success else error.
718 static int snd_soc_dapm_set_bias_level(struct snd_soc_dapm_context *dapm,
719 enum snd_soc_bias_level level)
721 struct snd_soc_card *card = dapm->card;
724 trace_snd_soc_bias_level_start(card, level);
726 ret = snd_soc_card_set_bias_level(card, dapm, level);
730 if (!card || dapm != &card->dapm)
731 ret = snd_soc_dapm_force_bias_level(dapm, level);
736 ret = snd_soc_card_set_bias_level_post(card, dapm, level);
738 trace_snd_soc_bias_level_done(card, level);
743 /* connect mux widget to its interconnecting audio paths */
744 static int dapm_connect_mux(struct snd_soc_dapm_context *dapm,
745 struct snd_soc_dapm_path *path, const char *control_name,
746 struct snd_soc_dapm_widget *w)
748 const struct snd_kcontrol_new *kcontrol = &w->kcontrol_news[0];
749 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
753 if (e->reg != SND_SOC_NOPM) {
755 val = soc_dapm_read(dapm, e->reg);
756 val = (val >> e->shift_l) & e->mask;
757 item = snd_soc_enum_val_to_item(e, val);
759 /* since a virtual mux has no backing registers to
760 * decide which path to connect, it will try to match
761 * with the first enumeration. This is to ensure
762 * that the default mux choice (the first) will be
763 * correctly powered up during initialization.
768 i = match_string(e->texts, e->items, control_name);
772 path->name = e->texts[i];
773 path->connect = (i == item);
778 /* set up initial codec paths */
779 static void dapm_set_mixer_path_status(struct snd_soc_dapm_path *p, int i,
782 struct soc_mixer_control *mc = (struct soc_mixer_control *)
783 p->sink->kcontrol_news[i].private_value;
784 unsigned int reg = mc->reg;
785 unsigned int invert = mc->invert;
787 if (reg != SND_SOC_NOPM) {
788 unsigned int shift = mc->shift;
789 unsigned int max = mc->max;
790 unsigned int mask = (1 << fls(max)) - 1;
791 unsigned int val = soc_dapm_read(p->sink->dapm, reg);
794 * The nth_path argument allows this function to know
795 * which path of a kcontrol it is setting the initial
796 * status for. Ideally this would support any number
797 * of paths and channels. But since kcontrols only come
798 * in mono and stereo variants, we are limited to 2
801 * The following code assumes for stereo controls the
802 * first path is the left channel, and all remaining
803 * paths are the right channel.
805 if (snd_soc_volsw_is_stereo(mc) && nth_path > 0) {
807 val = soc_dapm_read(p->sink->dapm, mc->rreg);
808 val = (val >> mc->rshift) & mask;
810 val = (val >> shift) & mask;
816 /* since a virtual mixer has no backing registers to
817 * decide which path to connect, it will try to match
818 * with initial state. This is to ensure
819 * that the default mixer choice will be
820 * correctly powered up during initialization.
826 /* connect mixer widget to its interconnecting audio paths */
827 static int dapm_connect_mixer(struct snd_soc_dapm_context *dapm,
828 struct snd_soc_dapm_path *path, const char *control_name)
832 /* search for mixer kcontrol */
833 for (i = 0; i < path->sink->num_kcontrols; i++) {
834 if (!strcmp(control_name, path->sink->kcontrol_news[i].name)) {
835 path->name = path->sink->kcontrol_news[i].name;
836 dapm_set_mixer_path_status(path, i, nth_path++);
843 static int dapm_is_shared_kcontrol(struct snd_soc_dapm_context *dapm,
844 struct snd_soc_dapm_widget *kcontrolw,
845 const struct snd_kcontrol_new *kcontrol_new,
846 struct snd_kcontrol **kcontrol)
848 struct snd_soc_dapm_widget *w;
853 for_each_card_widgets(dapm->card, w) {
854 if (w == kcontrolw || w->dapm != kcontrolw->dapm)
856 for (i = 0; i < w->num_kcontrols; i++) {
857 if (&w->kcontrol_news[i] == kcontrol_new) {
859 *kcontrol = w->kcontrols[i];
869 * Determine if a kcontrol is shared. If it is, look it up. If it isn't,
870 * create it. Either way, add the widget into the control's widget list
872 static int dapm_create_or_share_kcontrol(struct snd_soc_dapm_widget *w,
875 struct snd_soc_dapm_context *dapm = w->dapm;
876 struct snd_card *card = dapm->card->snd_card;
880 struct snd_kcontrol *kcontrol;
881 bool wname_in_long_name, kcname_in_long_name;
882 char *long_name = NULL;
886 prefix = soc_dapm_prefix(dapm);
888 prefix_len = strlen(prefix) + 1;
892 shared = dapm_is_shared_kcontrol(dapm, w, &w->kcontrol_news[kci],
897 wname_in_long_name = false;
898 kcname_in_long_name = true;
901 case snd_soc_dapm_switch:
902 case snd_soc_dapm_mixer:
903 case snd_soc_dapm_pga:
904 case snd_soc_dapm_effect:
905 case snd_soc_dapm_out_drv:
906 wname_in_long_name = true;
907 kcname_in_long_name = true;
909 case snd_soc_dapm_mixer_named_ctl:
910 wname_in_long_name = false;
911 kcname_in_long_name = true;
913 case snd_soc_dapm_demux:
914 case snd_soc_dapm_mux:
915 wname_in_long_name = true;
916 kcname_in_long_name = false;
923 if (wname_in_long_name && kcname_in_long_name) {
925 * The control will get a prefix from the control
926 * creation process but we're also using the same
927 * prefix for widgets so cut the prefix off the
928 * front of the widget name.
930 long_name = kasprintf(GFP_KERNEL, "%s %s",
931 w->name + prefix_len,
932 w->kcontrol_news[kci].name);
933 if (long_name == NULL)
937 } else if (wname_in_long_name) {
939 name = w->name + prefix_len;
942 name = w->kcontrol_news[kci].name;
945 kcontrol = snd_soc_cnew(&w->kcontrol_news[kci], NULL, name,
952 kcontrol->private_free = dapm_kcontrol_free;
954 ret = dapm_kcontrol_data_alloc(w, kcontrol, name);
956 snd_ctl_free_one(kcontrol);
960 ret = snd_ctl_add(card, kcontrol);
963 "ASoC: failed to add widget %s dapm kcontrol %s: %d\n",
969 ret = dapm_kcontrol_add_widget(kcontrol, w);
971 w->kcontrols[kci] = kcontrol;
979 /* create new dapm mixer control */
980 static int dapm_new_mixer(struct snd_soc_dapm_widget *w)
983 struct snd_soc_dapm_path *path;
984 struct dapm_kcontrol_data *data;
987 for (i = 0; i < w->num_kcontrols; i++) {
989 snd_soc_dapm_widget_for_each_source_path(w, path) {
990 /* mixer/mux paths name must match control name */
991 if (path->name != (char *)w->kcontrol_news[i].name)
994 if (!w->kcontrols[i]) {
995 ret = dapm_create_or_share_kcontrol(w, i);
1000 dapm_kcontrol_add_path(w->kcontrols[i], path);
1002 data = snd_kcontrol_chip(w->kcontrols[i]);
1004 snd_soc_dapm_add_path(data->widget->dapm,
1014 /* create new dapm mux control */
1015 static int dapm_new_mux(struct snd_soc_dapm_widget *w)
1017 struct snd_soc_dapm_context *dapm = w->dapm;
1018 enum snd_soc_dapm_direction dir;
1019 struct snd_soc_dapm_path *path;
1024 case snd_soc_dapm_mux:
1025 dir = SND_SOC_DAPM_DIR_OUT;
1028 case snd_soc_dapm_demux:
1029 dir = SND_SOC_DAPM_DIR_IN;
1036 if (w->num_kcontrols != 1) {
1038 "ASoC: %s %s has incorrect number of controls\n", type,
1043 if (list_empty(&w->edges[dir])) {
1044 dev_err(dapm->dev, "ASoC: %s %s has no paths\n", type, w->name);
1048 ret = dapm_create_or_share_kcontrol(w, 0);
1052 snd_soc_dapm_widget_for_each_path(w, dir, path) {
1054 dapm_kcontrol_add_path(w->kcontrols[0], path);
1060 /* create new dapm volume control */
1061 static int dapm_new_pga(struct snd_soc_dapm_widget *w)
1065 for (i = 0; i < w->num_kcontrols; i++) {
1066 int ret = dapm_create_or_share_kcontrol(w, i);
1074 /* create new dapm dai link control */
1075 static int dapm_new_dai_link(struct snd_soc_dapm_widget *w)
1078 struct snd_soc_pcm_runtime *rtd = w->priv;
1080 /* create control for links with > 1 config */
1081 if (rtd->dai_link->num_params <= 1)
1085 for (i = 0; i < w->num_kcontrols; i++) {
1086 struct snd_soc_dapm_context *dapm = w->dapm;
1087 struct snd_card *card = dapm->card->snd_card;
1088 struct snd_kcontrol *kcontrol = snd_soc_cnew(&w->kcontrol_news[i],
1090 int ret = snd_ctl_add(card, kcontrol);
1094 "ASoC: failed to add widget %s dapm kcontrol %s: %d\n",
1095 w->name, w->kcontrol_news[i].name, ret);
1098 kcontrol->private_data = w;
1099 w->kcontrols[i] = kcontrol;
1105 /* We implement power down on suspend by checking the power state of
1106 * the ALSA card - when we are suspending the ALSA state for the card
1109 static int snd_soc_dapm_suspend_check(struct snd_soc_dapm_widget *widget)
1111 int level = snd_power_get_state(widget->dapm->card->snd_card);
1114 case SNDRV_CTL_POWER_D3hot:
1115 case SNDRV_CTL_POWER_D3cold:
1116 if (widget->ignore_suspend)
1117 dev_dbg(widget->dapm->dev, "ASoC: %s ignoring suspend\n",
1119 return widget->ignore_suspend;
1125 static void dapm_widget_list_free(struct snd_soc_dapm_widget_list **list)
1130 static int dapm_widget_list_create(struct snd_soc_dapm_widget_list **list,
1131 struct list_head *widgets)
1133 struct snd_soc_dapm_widget *w;
1134 struct list_head *it;
1135 unsigned int size = 0;
1138 list_for_each(it, widgets)
1141 *list = kzalloc(struct_size(*list, widgets, size), GFP_KERNEL);
1145 list_for_each_entry(w, widgets, work_list)
1146 (*list)->widgets[i++] = w;
1148 (*list)->num_widgets = i;
1154 * Recursively reset the cached number of inputs or outputs for the specified
1155 * widget and all widgets that can be reached via incoming or outcoming paths
1158 static void invalidate_paths_ep(struct snd_soc_dapm_widget *widget,
1159 enum snd_soc_dapm_direction dir)
1161 enum snd_soc_dapm_direction rdir = SND_SOC_DAPM_DIR_REVERSE(dir);
1162 struct snd_soc_dapm_path *path;
1164 widget->endpoints[dir] = -1;
1166 snd_soc_dapm_widget_for_each_path(widget, rdir, path) {
1167 if (path->weak || path->is_supply)
1173 if (path->connect) {
1175 invalidate_paths_ep(path->node[dir], dir);
1182 * Common implementation for is_connected_output_ep() and
1183 * is_connected_input_ep(). The function is inlined since the combined size of
1184 * the two specialized functions is only marginally larger then the size of the
1185 * generic function and at the same time the fast path of the specialized
1186 * functions is significantly smaller than the generic function.
1188 static __always_inline int is_connected_ep(struct snd_soc_dapm_widget *widget,
1189 struct list_head *list, enum snd_soc_dapm_direction dir,
1190 int (*fn)(struct snd_soc_dapm_widget *, struct list_head *,
1191 bool (*custom_stop_condition)(struct snd_soc_dapm_widget *,
1192 enum snd_soc_dapm_direction)),
1193 bool (*custom_stop_condition)(struct snd_soc_dapm_widget *,
1194 enum snd_soc_dapm_direction))
1196 enum snd_soc_dapm_direction rdir = SND_SOC_DAPM_DIR_REVERSE(dir);
1197 struct snd_soc_dapm_path *path;
1200 if (widget->endpoints[dir] >= 0)
1201 return widget->endpoints[dir];
1203 DAPM_UPDATE_STAT(widget, path_checks);
1205 /* do we need to add this widget to the list ? */
1207 list_add_tail(&widget->work_list, list);
1209 if (custom_stop_condition && custom_stop_condition(widget, dir)) {
1211 custom_stop_condition = NULL;
1214 if ((widget->is_ep & SND_SOC_DAPM_DIR_TO_EP(dir)) && widget->connected) {
1215 widget->endpoints[dir] = snd_soc_dapm_suspend_check(widget);
1216 return widget->endpoints[dir];
1219 snd_soc_dapm_widget_for_each_path(widget, rdir, path) {
1220 DAPM_UPDATE_STAT(widget, neighbour_checks);
1222 if (path->weak || path->is_supply)
1228 trace_snd_soc_dapm_path(widget, dir, path);
1230 if (path->connect) {
1232 con += fn(path->node[dir], list, custom_stop_condition);
1237 widget->endpoints[dir] = con;
1243 * Recursively check for a completed path to an active or physically connected
1244 * output widget. Returns number of complete paths.
1246 * Optionally, can be supplied with a function acting as a stopping condition.
1247 * This function takes the dapm widget currently being examined and the walk
1248 * direction as an arguments, it should return true if widgets from that point
1249 * in the graph onwards should not be added to the widget list.
1251 static int is_connected_output_ep(struct snd_soc_dapm_widget *widget,
1252 struct list_head *list,
1253 bool (*custom_stop_condition)(struct snd_soc_dapm_widget *i,
1254 enum snd_soc_dapm_direction))
1256 return is_connected_ep(widget, list, SND_SOC_DAPM_DIR_OUT,
1257 is_connected_output_ep, custom_stop_condition);
1261 * Recursively check for a completed path to an active or physically connected
1262 * input widget. Returns number of complete paths.
1264 * Optionally, can be supplied with a function acting as a stopping condition.
1265 * This function takes the dapm widget currently being examined and the walk
1266 * direction as an arguments, it should return true if the walk should be
1267 * stopped and false otherwise.
1269 static int is_connected_input_ep(struct snd_soc_dapm_widget *widget,
1270 struct list_head *list,
1271 bool (*custom_stop_condition)(struct snd_soc_dapm_widget *i,
1272 enum snd_soc_dapm_direction))
1274 return is_connected_ep(widget, list, SND_SOC_DAPM_DIR_IN,
1275 is_connected_input_ep, custom_stop_condition);
1279 * snd_soc_dapm_dai_get_connected_widgets - query audio path and it's widgets.
1280 * @dai: the soc DAI.
1281 * @stream: stream direction.
1282 * @list: list of active widgets for this stream.
1283 * @custom_stop_condition: (optional) a function meant to stop the widget graph
1284 * walk based on custom logic.
1286 * Queries DAPM graph as to whether a valid audio stream path exists for
1287 * the initial stream specified by name. This takes into account
1288 * current mixer and mux kcontrol settings. Creates list of valid widgets.
1290 * Optionally, can be supplied with a function acting as a stopping condition.
1291 * This function takes the dapm widget currently being examined and the walk
1292 * direction as an arguments, it should return true if the walk should be
1293 * stopped and false otherwise.
1295 * Returns the number of valid paths or negative error.
1297 int snd_soc_dapm_dai_get_connected_widgets(struct snd_soc_dai *dai, int stream,
1298 struct snd_soc_dapm_widget_list **list,
1299 bool (*custom_stop_condition)(struct snd_soc_dapm_widget *,
1300 enum snd_soc_dapm_direction))
1302 struct snd_soc_card *card = dai->component->card;
1303 struct snd_soc_dapm_widget *w;
1308 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
1310 if (stream == SNDRV_PCM_STREAM_PLAYBACK) {
1311 w = dai->playback_widget;
1312 invalidate_paths_ep(w, SND_SOC_DAPM_DIR_OUT);
1313 paths = is_connected_output_ep(w, &widgets,
1314 custom_stop_condition);
1316 w = dai->capture_widget;
1317 invalidate_paths_ep(w, SND_SOC_DAPM_DIR_IN);
1318 paths = is_connected_input_ep(w, &widgets,
1319 custom_stop_condition);
1322 /* Drop starting point */
1323 list_del(widgets.next);
1325 ret = dapm_widget_list_create(list, &widgets);
1329 trace_snd_soc_dapm_connected(paths, stream);
1330 mutex_unlock(&card->dapm_mutex);
1334 EXPORT_SYMBOL_GPL(snd_soc_dapm_dai_get_connected_widgets);
1336 void snd_soc_dapm_dai_free_widgets(struct snd_soc_dapm_widget_list **list)
1338 dapm_widget_list_free(list);
1340 EXPORT_SYMBOL_GPL(snd_soc_dapm_dai_free_widgets);
1343 * Handler for regulator supply widget.
1345 int dapm_regulator_event(struct snd_soc_dapm_widget *w,
1346 struct snd_kcontrol *kcontrol, int event)
1350 soc_dapm_async_complete(w->dapm);
1352 if (SND_SOC_DAPM_EVENT_ON(event)) {
1353 if (w->on_val & SND_SOC_DAPM_REGULATOR_BYPASS) {
1354 ret = regulator_allow_bypass(w->regulator, false);
1356 dev_warn(w->dapm->dev,
1357 "ASoC: Failed to unbypass %s: %d\n",
1361 return regulator_enable(w->regulator);
1363 if (w->on_val & SND_SOC_DAPM_REGULATOR_BYPASS) {
1364 ret = regulator_allow_bypass(w->regulator, true);
1366 dev_warn(w->dapm->dev,
1367 "ASoC: Failed to bypass %s: %d\n",
1371 return regulator_disable_deferred(w->regulator, w->shift);
1374 EXPORT_SYMBOL_GPL(dapm_regulator_event);
1377 * Handler for pinctrl widget.
1379 int dapm_pinctrl_event(struct snd_soc_dapm_widget *w,
1380 struct snd_kcontrol *kcontrol, int event)
1382 struct snd_soc_dapm_pinctrl_priv *priv = w->priv;
1383 struct pinctrl *p = w->pinctrl;
1384 struct pinctrl_state *s;
1389 if (SND_SOC_DAPM_EVENT_ON(event))
1390 s = pinctrl_lookup_state(p, priv->active_state);
1392 s = pinctrl_lookup_state(p, priv->sleep_state);
1397 return pinctrl_select_state(p, s);
1399 EXPORT_SYMBOL_GPL(dapm_pinctrl_event);
1402 * Handler for clock supply widget.
1404 int dapm_clock_event(struct snd_soc_dapm_widget *w,
1405 struct snd_kcontrol *kcontrol, int event)
1410 soc_dapm_async_complete(w->dapm);
1412 if (SND_SOC_DAPM_EVENT_ON(event)) {
1413 return clk_prepare_enable(w->clk);
1415 clk_disable_unprepare(w->clk);
1421 EXPORT_SYMBOL_GPL(dapm_clock_event);
1423 static int dapm_widget_power_check(struct snd_soc_dapm_widget *w)
1425 if (w->power_checked)
1426 return w->new_power;
1431 w->new_power = w->power_check(w);
1433 w->power_checked = true;
1435 return w->new_power;
1438 /* Generic check to see if a widget should be powered. */
1439 static int dapm_generic_check_power(struct snd_soc_dapm_widget *w)
1443 DAPM_UPDATE_STAT(w, power_checks);
1445 in = is_connected_input_ep(w, NULL, NULL);
1446 out = is_connected_output_ep(w, NULL, NULL);
1447 return out != 0 && in != 0;
1450 /* Check to see if a power supply is needed */
1451 static int dapm_supply_check_power(struct snd_soc_dapm_widget *w)
1453 struct snd_soc_dapm_path *path;
1455 DAPM_UPDATE_STAT(w, power_checks);
1457 /* Check if one of our outputs is connected */
1458 snd_soc_dapm_widget_for_each_sink_path(w, path) {
1459 DAPM_UPDATE_STAT(w, neighbour_checks);
1464 if (path->connected &&
1465 !path->connected(path->source, path->sink))
1468 if (dapm_widget_power_check(path->sink))
1475 static int dapm_always_on_check_power(struct snd_soc_dapm_widget *w)
1477 return w->connected;
1480 static int dapm_seq_compare(struct snd_soc_dapm_widget *a,
1481 struct snd_soc_dapm_widget *b,
1486 BUILD_BUG_ON(ARRAY_SIZE(dapm_up_seq) != SND_SOC_DAPM_TYPE_COUNT);
1487 BUILD_BUG_ON(ARRAY_SIZE(dapm_down_seq) != SND_SOC_DAPM_TYPE_COUNT);
1492 sort = dapm_down_seq;
1494 WARN_ONCE(sort[a->id] == 0, "offset a->id %d not initialized\n", a->id);
1495 WARN_ONCE(sort[b->id] == 0, "offset b->id %d not initialized\n", b->id);
1497 if (sort[a->id] != sort[b->id])
1498 return sort[a->id] - sort[b->id];
1499 if (a->subseq != b->subseq) {
1501 return a->subseq - b->subseq;
1503 return b->subseq - a->subseq;
1505 if (a->reg != b->reg)
1506 return a->reg - b->reg;
1507 if (a->dapm != b->dapm)
1508 return (unsigned long)a->dapm - (unsigned long)b->dapm;
1513 /* Insert a widget in order into a DAPM power sequence. */
1514 static void dapm_seq_insert(struct snd_soc_dapm_widget *new_widget,
1515 struct list_head *list,
1518 struct snd_soc_dapm_widget *w;
1520 list_for_each_entry(w, list, power_list)
1521 if (dapm_seq_compare(new_widget, w, power_up) < 0) {
1522 list_add_tail(&new_widget->power_list, &w->power_list);
1526 list_add_tail(&new_widget->power_list, list);
1529 static void dapm_seq_check_event(struct snd_soc_card *card,
1530 struct snd_soc_dapm_widget *w, int event)
1532 const char *ev_name;
1536 case SND_SOC_DAPM_PRE_PMU:
1537 ev_name = "PRE_PMU";
1540 case SND_SOC_DAPM_POST_PMU:
1541 ev_name = "POST_PMU";
1544 case SND_SOC_DAPM_PRE_PMD:
1545 ev_name = "PRE_PMD";
1548 case SND_SOC_DAPM_POST_PMD:
1549 ev_name = "POST_PMD";
1552 case SND_SOC_DAPM_WILL_PMU:
1553 ev_name = "WILL_PMU";
1556 case SND_SOC_DAPM_WILL_PMD:
1557 ev_name = "WILL_PMD";
1561 WARN(1, "Unknown event %d\n", event);
1565 if (w->new_power != power)
1568 if (w->event && (w->event_flags & event)) {
1571 pop_dbg(w->dapm->dev, card->pop_time, "pop test : %s %s\n",
1573 soc_dapm_async_complete(w->dapm);
1574 trace_snd_soc_dapm_widget_event_start(w, event);
1575 ret = w->event(w, NULL, event);
1576 trace_snd_soc_dapm_widget_event_done(w, event);
1578 dev_err(w->dapm->dev, "ASoC: %s: %s event failed: %d\n",
1579 ev_name, w->name, ret);
1583 /* Apply the coalesced changes from a DAPM sequence */
1584 static void dapm_seq_run_coalesced(struct snd_soc_card *card,
1585 struct list_head *pending)
1587 struct snd_soc_dapm_context *dapm;
1588 struct snd_soc_dapm_widget *w;
1590 unsigned int value = 0;
1591 unsigned int mask = 0;
1593 w = list_first_entry(pending, struct snd_soc_dapm_widget, power_list);
1597 list_for_each_entry(w, pending, power_list) {
1598 WARN_ON(reg != w->reg || dapm != w->dapm);
1599 w->power = w->new_power;
1601 mask |= w->mask << w->shift;
1603 value |= w->on_val << w->shift;
1605 value |= w->off_val << w->shift;
1607 pop_dbg(dapm->dev, card->pop_time,
1608 "pop test : Queue %s: reg=0x%x, 0x%x/0x%x\n",
1609 w->name, reg, value, mask);
1611 /* Check for events */
1612 dapm_seq_check_event(card, w, SND_SOC_DAPM_PRE_PMU);
1613 dapm_seq_check_event(card, w, SND_SOC_DAPM_PRE_PMD);
1617 /* Any widget will do, they should all be updating the
1621 pop_dbg(dapm->dev, card->pop_time,
1622 "pop test : Applying 0x%x/0x%x to %x in %dms\n",
1623 value, mask, reg, card->pop_time);
1624 pop_wait(card->pop_time);
1625 soc_dapm_update_bits(dapm, reg, mask, value);
1628 list_for_each_entry(w, pending, power_list) {
1629 dapm_seq_check_event(card, w, SND_SOC_DAPM_POST_PMU);
1630 dapm_seq_check_event(card, w, SND_SOC_DAPM_POST_PMD);
1634 /* Apply a DAPM power sequence.
1636 * We walk over a pre-sorted list of widgets to apply power to. In
1637 * order to minimise the number of writes to the device required
1638 * multiple widgets will be updated in a single write where possible.
1639 * Currently anything that requires more than a single write is not
1642 static void dapm_seq_run(struct snd_soc_card *card,
1643 struct list_head *list, int event, bool power_up)
1645 struct snd_soc_dapm_widget *w, *n;
1646 struct snd_soc_dapm_context *d;
1649 int cur_subseq = -1;
1650 int cur_reg = SND_SOC_NOPM;
1651 struct snd_soc_dapm_context *cur_dapm = NULL;
1658 sort = dapm_down_seq;
1660 list_for_each_entry_safe(w, n, list, power_list) {
1663 /* Do we need to apply any queued changes? */
1664 if (sort[w->id] != cur_sort || w->reg != cur_reg ||
1665 w->dapm != cur_dapm || w->subseq != cur_subseq) {
1666 if (!list_empty(&pending))
1667 dapm_seq_run_coalesced(card, &pending);
1669 if (cur_dapm && cur_dapm->component) {
1670 for (i = 0; i < ARRAY_SIZE(dapm_up_seq); i++)
1671 if (sort[i] == cur_sort)
1672 snd_soc_component_seq_notifier(
1673 cur_dapm->component,
1677 if (cur_dapm && w->dapm != cur_dapm)
1678 soc_dapm_async_complete(cur_dapm);
1680 INIT_LIST_HEAD(&pending);
1682 cur_subseq = INT_MIN;
1683 cur_reg = SND_SOC_NOPM;
1688 case snd_soc_dapm_pre:
1692 if (event == SND_SOC_DAPM_STREAM_START)
1694 NULL, SND_SOC_DAPM_PRE_PMU);
1695 else if (event == SND_SOC_DAPM_STREAM_STOP)
1697 NULL, SND_SOC_DAPM_PRE_PMD);
1700 case snd_soc_dapm_post:
1704 if (event == SND_SOC_DAPM_STREAM_START)
1706 NULL, SND_SOC_DAPM_POST_PMU);
1707 else if (event == SND_SOC_DAPM_STREAM_STOP)
1709 NULL, SND_SOC_DAPM_POST_PMD);
1713 /* Queue it up for application */
1714 cur_sort = sort[w->id];
1715 cur_subseq = w->subseq;
1718 list_move(&w->power_list, &pending);
1723 dev_err(w->dapm->dev,
1724 "ASoC: Failed to apply widget power: %d\n", ret);
1727 if (!list_empty(&pending))
1728 dapm_seq_run_coalesced(card, &pending);
1730 if (cur_dapm && cur_dapm->component) {
1731 for (i = 0; i < ARRAY_SIZE(dapm_up_seq); i++)
1732 if (sort[i] == cur_sort)
1733 snd_soc_component_seq_notifier(
1734 cur_dapm->component,
1738 for_each_card_dapms(card, d)
1739 soc_dapm_async_complete(d);
1742 static void dapm_widget_update(struct snd_soc_card *card)
1744 struct snd_soc_dapm_update *update = card->update;
1745 struct snd_soc_dapm_widget_list *wlist;
1746 struct snd_soc_dapm_widget *w = NULL;
1750 if (!update || !dapm_kcontrol_is_powered(update->kcontrol))
1753 wlist = dapm_kcontrol_get_wlist(update->kcontrol);
1755 for_each_dapm_widgets(wlist, wi, w) {
1756 if (w->event && (w->event_flags & SND_SOC_DAPM_PRE_REG)) {
1757 ret = w->event(w, update->kcontrol, SND_SOC_DAPM_PRE_REG);
1759 dev_err(w->dapm->dev, "ASoC: %s DAPM pre-event failed: %d\n",
1767 ret = soc_dapm_update_bits(w->dapm, update->reg, update->mask,
1770 dev_err(w->dapm->dev, "ASoC: %s DAPM update failed: %d\n",
1773 if (update->has_second_set) {
1774 ret = soc_dapm_update_bits(w->dapm, update->reg2,
1775 update->mask2, update->val2);
1777 dev_err(w->dapm->dev,
1778 "ASoC: %s DAPM update failed: %d\n",
1782 for_each_dapm_widgets(wlist, wi, w) {
1783 if (w->event && (w->event_flags & SND_SOC_DAPM_POST_REG)) {
1784 ret = w->event(w, update->kcontrol, SND_SOC_DAPM_POST_REG);
1786 dev_err(w->dapm->dev, "ASoC: %s DAPM post-event failed: %d\n",
1792 /* Async callback run prior to DAPM sequences - brings to _PREPARE if
1793 * they're changing state.
1795 static void dapm_pre_sequence_async(void *data, async_cookie_t cookie)
1797 struct snd_soc_dapm_context *d = data;
1800 /* If we're off and we're not supposed to go into STANDBY */
1801 if (d->bias_level == SND_SOC_BIAS_OFF &&
1802 d->target_bias_level != SND_SOC_BIAS_OFF) {
1803 if (d->dev && cookie)
1804 pm_runtime_get_sync(d->dev);
1806 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_STANDBY);
1809 "ASoC: Failed to turn on bias: %d\n", ret);
1812 /* Prepare for a transition to ON or away from ON */
1813 if ((d->target_bias_level == SND_SOC_BIAS_ON &&
1814 d->bias_level != SND_SOC_BIAS_ON) ||
1815 (d->target_bias_level != SND_SOC_BIAS_ON &&
1816 d->bias_level == SND_SOC_BIAS_ON)) {
1817 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_PREPARE);
1820 "ASoC: Failed to prepare bias: %d\n", ret);
1824 /* Async callback run prior to DAPM sequences - brings to their final
1827 static void dapm_post_sequence_async(void *data, async_cookie_t cookie)
1829 struct snd_soc_dapm_context *d = data;
1832 /* If we just powered the last thing off drop to standby bias */
1833 if (d->bias_level == SND_SOC_BIAS_PREPARE &&
1834 (d->target_bias_level == SND_SOC_BIAS_STANDBY ||
1835 d->target_bias_level == SND_SOC_BIAS_OFF)) {
1836 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_STANDBY);
1838 dev_err(d->dev, "ASoC: Failed to apply standby bias: %d\n",
1842 /* If we're in standby and can support bias off then do that */
1843 if (d->bias_level == SND_SOC_BIAS_STANDBY &&
1844 d->target_bias_level == SND_SOC_BIAS_OFF) {
1845 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_OFF);
1847 dev_err(d->dev, "ASoC: Failed to turn off bias: %d\n",
1850 if (d->dev && cookie)
1851 pm_runtime_put(d->dev);
1854 /* If we just powered up then move to active bias */
1855 if (d->bias_level == SND_SOC_BIAS_PREPARE &&
1856 d->target_bias_level == SND_SOC_BIAS_ON) {
1857 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_ON);
1859 dev_err(d->dev, "ASoC: Failed to apply active bias: %d\n",
1864 static void dapm_widget_set_peer_power(struct snd_soc_dapm_widget *peer,
1865 bool power, bool connect)
1867 /* If a connection is being made or broken then that update
1868 * will have marked the peer dirty, otherwise the widgets are
1869 * not connected and this update has no impact. */
1873 /* If the peer is already in the state we're moving to then we
1874 * won't have an impact on it. */
1875 if (power != peer->power)
1876 dapm_mark_dirty(peer, "peer state change");
1879 static void dapm_widget_set_power(struct snd_soc_dapm_widget *w, bool power,
1880 struct list_head *up_list,
1881 struct list_head *down_list)
1883 struct snd_soc_dapm_path *path;
1885 if (w->power == power)
1888 trace_snd_soc_dapm_widget_power(w, power);
1890 /* If we changed our power state perhaps our neigbours changed
1893 snd_soc_dapm_widget_for_each_source_path(w, path)
1894 dapm_widget_set_peer_power(path->source, power, path->connect);
1896 /* Supplies can't affect their outputs, only their inputs */
1897 if (!w->is_supply) {
1898 snd_soc_dapm_widget_for_each_sink_path(w, path)
1899 dapm_widget_set_peer_power(path->sink, power,
1904 dapm_seq_insert(w, up_list, true);
1906 dapm_seq_insert(w, down_list, false);
1909 static void dapm_power_one_widget(struct snd_soc_dapm_widget *w,
1910 struct list_head *up_list,
1911 struct list_head *down_list)
1916 case snd_soc_dapm_pre:
1917 dapm_seq_insert(w, down_list, false);
1919 case snd_soc_dapm_post:
1920 dapm_seq_insert(w, up_list, true);
1924 power = dapm_widget_power_check(w);
1926 dapm_widget_set_power(w, power, up_list, down_list);
1931 static bool dapm_idle_bias_off(struct snd_soc_dapm_context *dapm)
1933 if (dapm->idle_bias_off)
1936 switch (snd_power_get_state(dapm->card->snd_card)) {
1937 case SNDRV_CTL_POWER_D3hot:
1938 case SNDRV_CTL_POWER_D3cold:
1939 return dapm->suspend_bias_off;
1948 * Scan each dapm widget for complete audio path.
1949 * A complete path is a route that has valid endpoints i.e.:-
1951 * o DAC to output pin.
1952 * o Input pin to ADC.
1953 * o Input pin to Output pin (bypass, sidetone)
1954 * o DAC to ADC (loopback).
1956 static int dapm_power_widgets(struct snd_soc_card *card, int event)
1958 struct snd_soc_dapm_widget *w;
1959 struct snd_soc_dapm_context *d;
1961 LIST_HEAD(down_list);
1962 ASYNC_DOMAIN_EXCLUSIVE(async_domain);
1963 enum snd_soc_bias_level bias;
1966 lockdep_assert_held(&card->dapm_mutex);
1968 trace_snd_soc_dapm_start(card);
1970 for_each_card_dapms(card, d) {
1971 if (dapm_idle_bias_off(d))
1972 d->target_bias_level = SND_SOC_BIAS_OFF;
1974 d->target_bias_level = SND_SOC_BIAS_STANDBY;
1979 /* Check which widgets we need to power and store them in
1980 * lists indicating if they should be powered up or down. We
1981 * only check widgets that have been flagged as dirty but note
1982 * that new widgets may be added to the dirty list while we
1985 list_for_each_entry(w, &card->dapm_dirty, dirty) {
1986 dapm_power_one_widget(w, &up_list, &down_list);
1989 for_each_card_widgets(card, w) {
1991 case snd_soc_dapm_pre:
1992 case snd_soc_dapm_post:
1993 /* These widgets always need to be powered */
1996 list_del_init(&w->dirty);
2003 /* Supplies and micbiases only bring the
2004 * context up to STANDBY as unless something
2005 * else is active and passing audio they
2006 * generally don't require full power. Signal
2007 * generators are virtual pins and have no
2008 * power impact themselves.
2011 case snd_soc_dapm_siggen:
2012 case snd_soc_dapm_vmid:
2014 case snd_soc_dapm_supply:
2015 case snd_soc_dapm_regulator_supply:
2016 case snd_soc_dapm_pinctrl:
2017 case snd_soc_dapm_clock_supply:
2018 case snd_soc_dapm_micbias:
2019 if (d->target_bias_level < SND_SOC_BIAS_STANDBY)
2020 d->target_bias_level = SND_SOC_BIAS_STANDBY;
2023 d->target_bias_level = SND_SOC_BIAS_ON;
2030 /* Force all contexts in the card to the same bias state if
2031 * they're not ground referenced.
2033 bias = SND_SOC_BIAS_OFF;
2034 for_each_card_dapms(card, d)
2035 if (d->target_bias_level > bias)
2036 bias = d->target_bias_level;
2037 for_each_card_dapms(card, d)
2038 if (!dapm_idle_bias_off(d))
2039 d->target_bias_level = bias;
2041 trace_snd_soc_dapm_walk_done(card);
2043 /* Run card bias changes at first */
2044 dapm_pre_sequence_async(&card->dapm, 0);
2045 /* Run other bias changes in parallel */
2046 for_each_card_dapms(card, d) {
2047 if (d != &card->dapm && d->bias_level != d->target_bias_level)
2048 async_schedule_domain(dapm_pre_sequence_async, d,
2051 async_synchronize_full_domain(&async_domain);
2053 list_for_each_entry(w, &down_list, power_list) {
2054 dapm_seq_check_event(card, w, SND_SOC_DAPM_WILL_PMD);
2057 list_for_each_entry(w, &up_list, power_list) {
2058 dapm_seq_check_event(card, w, SND_SOC_DAPM_WILL_PMU);
2061 /* Power down widgets first; try to avoid amplifying pops. */
2062 dapm_seq_run(card, &down_list, event, false);
2064 dapm_widget_update(card);
2067 dapm_seq_run(card, &up_list, event, true);
2069 /* Run all the bias changes in parallel */
2070 for_each_card_dapms(card, d) {
2071 if (d != &card->dapm && d->bias_level != d->target_bias_level)
2072 async_schedule_domain(dapm_post_sequence_async, d,
2075 async_synchronize_full_domain(&async_domain);
2076 /* Run card bias changes at last */
2077 dapm_post_sequence_async(&card->dapm, 0);
2079 /* do we need to notify any clients that DAPM event is complete */
2080 for_each_card_dapms(card, d) {
2084 ret = snd_soc_component_stream_event(d->component, event);
2089 pop_dbg(card->dev, card->pop_time,
2090 "DAPM sequencing finished, waiting %dms\n", card->pop_time);
2091 pop_wait(card->pop_time);
2093 trace_snd_soc_dapm_done(card);
2098 #ifdef CONFIG_DEBUG_FS
2099 static ssize_t dapm_widget_power_read_file(struct file *file,
2100 char __user *user_buf,
2101 size_t count, loff_t *ppos)
2103 struct snd_soc_dapm_widget *w = file->private_data;
2104 struct snd_soc_card *card = w->dapm->card;
2105 enum snd_soc_dapm_direction dir, rdir;
2109 struct snd_soc_dapm_path *p = NULL;
2111 buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
2115 mutex_lock(&card->dapm_mutex);
2117 /* Supply widgets are not handled by is_connected_{input,output}_ep() */
2122 in = is_connected_input_ep(w, NULL, NULL);
2123 out = is_connected_output_ep(w, NULL, NULL);
2126 ret = scnprintf(buf, PAGE_SIZE, "%s: %s%s in %d out %d",
2127 w->name, w->power ? "On" : "Off",
2128 w->force ? " (forced)" : "", in, out);
2131 ret += scnprintf(buf + ret, PAGE_SIZE - ret,
2132 " - R%d(0x%x) mask 0x%x",
2133 w->reg, w->reg, w->mask << w->shift);
2135 ret += scnprintf(buf + ret, PAGE_SIZE - ret, "\n");
2138 ret += scnprintf(buf + ret, PAGE_SIZE - ret, " stream %s %s\n",
2140 w->active ? "active" : "inactive");
2142 snd_soc_dapm_for_each_direction(dir) {
2143 rdir = SND_SOC_DAPM_DIR_REVERSE(dir);
2144 snd_soc_dapm_widget_for_each_path(w, dir, p) {
2145 if (p->connected && !p->connected(p->source, p->sink))
2151 ret += scnprintf(buf + ret, PAGE_SIZE - ret,
2152 " %s \"%s\" \"%s\"\n",
2153 (rdir == SND_SOC_DAPM_DIR_IN) ? "in" : "out",
2154 p->name ? p->name : "static",
2155 p->node[rdir]->name);
2159 mutex_unlock(&card->dapm_mutex);
2161 ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
2167 static const struct file_operations dapm_widget_power_fops = {
2168 .open = simple_open,
2169 .read = dapm_widget_power_read_file,
2170 .llseek = default_llseek,
2173 static ssize_t dapm_bias_read_file(struct file *file, char __user *user_buf,
2174 size_t count, loff_t *ppos)
2176 struct snd_soc_dapm_context *dapm = file->private_data;
2179 switch (dapm->bias_level) {
2180 case SND_SOC_BIAS_ON:
2183 case SND_SOC_BIAS_PREPARE:
2184 level = "Prepare\n";
2186 case SND_SOC_BIAS_STANDBY:
2187 level = "Standby\n";
2189 case SND_SOC_BIAS_OFF:
2193 WARN(1, "Unknown bias_level %d\n", dapm->bias_level);
2194 level = "Unknown\n";
2198 return simple_read_from_buffer(user_buf, count, ppos, level,
2202 static const struct file_operations dapm_bias_fops = {
2203 .open = simple_open,
2204 .read = dapm_bias_read_file,
2205 .llseek = default_llseek,
2208 void snd_soc_dapm_debugfs_init(struct snd_soc_dapm_context *dapm,
2209 struct dentry *parent)
2211 if (!parent || IS_ERR(parent))
2214 dapm->debugfs_dapm = debugfs_create_dir("dapm", parent);
2216 debugfs_create_file("bias_level", 0444, dapm->debugfs_dapm, dapm,
2220 static void dapm_debugfs_add_widget(struct snd_soc_dapm_widget *w)
2222 struct snd_soc_dapm_context *dapm = w->dapm;
2224 if (!dapm->debugfs_dapm || !w->name)
2227 debugfs_create_file(w->name, 0444, dapm->debugfs_dapm, w,
2228 &dapm_widget_power_fops);
2231 static void dapm_debugfs_cleanup(struct snd_soc_dapm_context *dapm)
2233 debugfs_remove_recursive(dapm->debugfs_dapm);
2234 dapm->debugfs_dapm = NULL;
2238 void snd_soc_dapm_debugfs_init(struct snd_soc_dapm_context *dapm,
2239 struct dentry *parent)
2243 static inline void dapm_debugfs_add_widget(struct snd_soc_dapm_widget *w)
2247 static inline void dapm_debugfs_cleanup(struct snd_soc_dapm_context *dapm)
2254 * soc_dapm_connect_path() - Connects or disconnects a path
2255 * @path: The path to update
2256 * @connect: The new connect state of the path. True if the path is connected,
2257 * false if it is disconnected.
2258 * @reason: The reason why the path changed (for debugging only)
2260 static void soc_dapm_connect_path(struct snd_soc_dapm_path *path,
2261 bool connect, const char *reason)
2263 if (path->connect == connect)
2266 path->connect = connect;
2267 dapm_mark_dirty(path->source, reason);
2268 dapm_mark_dirty(path->sink, reason);
2269 dapm_path_invalidate(path);
2272 /* test and update the power status of a mux widget */
2273 static int soc_dapm_mux_update_power(struct snd_soc_card *card,
2274 struct snd_kcontrol *kcontrol, int mux, struct soc_enum *e)
2276 struct snd_soc_dapm_path *path;
2280 lockdep_assert_held(&card->dapm_mutex);
2282 /* find dapm widget path assoc with kcontrol */
2283 dapm_kcontrol_for_each_path(path, kcontrol) {
2285 /* we now need to match the string in the enum to the path */
2286 if (e && !(strcmp(path->name, e->texts[mux])))
2291 soc_dapm_connect_path(path, connect, "mux update");
2295 dapm_power_widgets(card, SND_SOC_DAPM_STREAM_NOP);
2300 int snd_soc_dapm_mux_update_power(struct snd_soc_dapm_context *dapm,
2301 struct snd_kcontrol *kcontrol, int mux, struct soc_enum *e,
2302 struct snd_soc_dapm_update *update)
2304 struct snd_soc_card *card = dapm->card;
2307 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2308 card->update = update;
2309 ret = soc_dapm_mux_update_power(card, kcontrol, mux, e);
2310 card->update = NULL;
2311 mutex_unlock(&card->dapm_mutex);
2313 snd_soc_dpcm_runtime_update(card);
2316 EXPORT_SYMBOL_GPL(snd_soc_dapm_mux_update_power);
2318 /* test and update the power status of a mixer or switch widget */
2319 static int soc_dapm_mixer_update_power(struct snd_soc_card *card,
2320 struct snd_kcontrol *kcontrol,
2321 int connect, int rconnect)
2323 struct snd_soc_dapm_path *path;
2326 lockdep_assert_held(&card->dapm_mutex);
2328 /* find dapm widget path assoc with kcontrol */
2329 dapm_kcontrol_for_each_path(path, kcontrol) {
2331 * Ideally this function should support any number of
2332 * paths and channels. But since kcontrols only come
2333 * in mono and stereo variants, we are limited to 2
2336 * The following code assumes for stereo controls the
2337 * first path (when 'found == 0') is the left channel,
2338 * and all remaining paths (when 'found == 1') are the
2341 * A stereo control is signified by a valid 'rconnect'
2342 * value, either 0 for unconnected, or >= 0 for connected.
2343 * This is chosen instead of using snd_soc_volsw_is_stereo,
2344 * so that the behavior of snd_soc_dapm_mixer_update_power
2345 * doesn't change even when the kcontrol passed in is
2348 * It passes 'connect' as the path connect status for
2349 * the left channel, and 'rconnect' for the right
2352 if (found && rconnect >= 0)
2353 soc_dapm_connect_path(path, rconnect, "mixer update");
2355 soc_dapm_connect_path(path, connect, "mixer update");
2360 dapm_power_widgets(card, SND_SOC_DAPM_STREAM_NOP);
2365 int snd_soc_dapm_mixer_update_power(struct snd_soc_dapm_context *dapm,
2366 struct snd_kcontrol *kcontrol, int connect,
2367 struct snd_soc_dapm_update *update)
2369 struct snd_soc_card *card = dapm->card;
2372 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2373 card->update = update;
2374 ret = soc_dapm_mixer_update_power(card, kcontrol, connect, -1);
2375 card->update = NULL;
2376 mutex_unlock(&card->dapm_mutex);
2378 snd_soc_dpcm_runtime_update(card);
2381 EXPORT_SYMBOL_GPL(snd_soc_dapm_mixer_update_power);
2383 static ssize_t dapm_widget_show_component(struct snd_soc_component *cmpnt,
2386 struct snd_soc_dapm_context *dapm = snd_soc_component_get_dapm(cmpnt);
2387 struct snd_soc_dapm_widget *w;
2389 char *state = "not set";
2391 /* card won't be set for the dummy component, as a spot fix
2392 * we're checking for that case specifically here but in future
2393 * we will ensure that the dummy component looks like others.
2398 for_each_card_widgets(cmpnt->card, w) {
2399 if (w->dapm != dapm)
2402 /* only display widgets that burn power */
2404 case snd_soc_dapm_hp:
2405 case snd_soc_dapm_mic:
2406 case snd_soc_dapm_spk:
2407 case snd_soc_dapm_line:
2408 case snd_soc_dapm_micbias:
2409 case snd_soc_dapm_dac:
2410 case snd_soc_dapm_adc:
2411 case snd_soc_dapm_pga:
2412 case snd_soc_dapm_effect:
2413 case snd_soc_dapm_out_drv:
2414 case snd_soc_dapm_mixer:
2415 case snd_soc_dapm_mixer_named_ctl:
2416 case snd_soc_dapm_supply:
2417 case snd_soc_dapm_regulator_supply:
2418 case snd_soc_dapm_pinctrl:
2419 case snd_soc_dapm_clock_supply:
2421 count += sprintf(buf + count, "%s: %s\n",
2422 w->name, w->power ? "On":"Off");
2429 switch (snd_soc_dapm_get_bias_level(dapm)) {
2430 case SND_SOC_BIAS_ON:
2433 case SND_SOC_BIAS_PREPARE:
2436 case SND_SOC_BIAS_STANDBY:
2439 case SND_SOC_BIAS_OFF:
2443 count += sprintf(buf + count, "PM State: %s\n", state);
2448 /* show dapm widget status in sys fs */
2449 static ssize_t dapm_widget_show(struct device *dev,
2450 struct device_attribute *attr, char *buf)
2452 struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);
2453 struct snd_soc_dai *codec_dai;
2456 mutex_lock(&rtd->card->dapm_mutex);
2458 for_each_rtd_codec_dais(rtd, i, codec_dai) {
2459 struct snd_soc_component *cmpnt = codec_dai->component;
2461 count += dapm_widget_show_component(cmpnt, buf + count);
2464 mutex_unlock(&rtd->card->dapm_mutex);
2469 static DEVICE_ATTR_RO(dapm_widget);
2471 struct attribute *soc_dapm_dev_attrs[] = {
2472 &dev_attr_dapm_widget.attr,
2476 static void dapm_free_path(struct snd_soc_dapm_path *path)
2478 list_del(&path->list_node[SND_SOC_DAPM_DIR_IN]);
2479 list_del(&path->list_node[SND_SOC_DAPM_DIR_OUT]);
2480 list_del(&path->list_kcontrol);
2481 list_del(&path->list);
2486 * snd_soc_dapm_free_widget - Free specified widget
2487 * @w: widget to free
2489 * Removes widget from all paths and frees memory occupied by it.
2491 void snd_soc_dapm_free_widget(struct snd_soc_dapm_widget *w)
2493 struct snd_soc_dapm_path *p, *next_p;
2494 enum snd_soc_dapm_direction dir;
2497 list_del(&w->dirty);
2499 * remove source and sink paths associated to this widget.
2500 * While removing the path, remove reference to it from both
2501 * source and sink widgets so that path is removed only once.
2503 snd_soc_dapm_for_each_direction(dir) {
2504 snd_soc_dapm_widget_for_each_path_safe(w, dir, p, next_p)
2508 kfree(w->kcontrols);
2509 kfree_const(w->name);
2510 kfree_const(w->sname);
2513 EXPORT_SYMBOL_GPL(snd_soc_dapm_free_widget);
2515 void snd_soc_dapm_reset_cache(struct snd_soc_dapm_context *dapm)
2517 dapm->path_sink_cache.widget = NULL;
2518 dapm->path_source_cache.widget = NULL;
2521 /* free all dapm widgets and resources */
2522 static void dapm_free_widgets(struct snd_soc_dapm_context *dapm)
2524 struct snd_soc_dapm_widget *w, *next_w;
2526 for_each_card_widgets_safe(dapm->card, w, next_w) {
2527 if (w->dapm != dapm)
2529 snd_soc_dapm_free_widget(w);
2531 snd_soc_dapm_reset_cache(dapm);
2534 static struct snd_soc_dapm_widget *dapm_find_widget(
2535 struct snd_soc_dapm_context *dapm, const char *pin,
2536 bool search_other_contexts)
2538 struct snd_soc_dapm_widget *w;
2539 struct snd_soc_dapm_widget *fallback = NULL;
2540 char prefixed_pin[80];
2541 const char *pin_name;
2542 const char *prefix = soc_dapm_prefix(dapm);
2545 snprintf(prefixed_pin, sizeof(prefixed_pin), "%s %s",
2547 pin_name = prefixed_pin;
2552 for_each_card_widgets(dapm->card, w) {
2553 if (!strcmp(w->name, pin_name)) {
2554 if (w->dapm == dapm)
2561 if (search_other_contexts)
2568 * set the DAPM pin status:
2569 * returns 1 when the value has been updated, 0 when unchanged, or a negative
2570 * error code; called from kcontrol put callback
2572 static int __snd_soc_dapm_set_pin(struct snd_soc_dapm_context *dapm,
2573 const char *pin, int status)
2575 struct snd_soc_dapm_widget *w = dapm_find_widget(dapm, pin, true);
2578 dapm_assert_locked(dapm);
2581 dev_err(dapm->dev, "ASoC: DAPM unknown pin %s\n", pin);
2585 if (w->connected != status) {
2586 dapm_mark_dirty(w, "pin configuration");
2587 dapm_widget_invalidate_input_paths(w);
2588 dapm_widget_invalidate_output_paths(w);
2592 w->connected = status;
2600 * similar as __snd_soc_dapm_set_pin(), but returns 0 when successful;
2601 * called from several API functions below
2603 static int snd_soc_dapm_set_pin(struct snd_soc_dapm_context *dapm,
2604 const char *pin, int status)
2606 int ret = __snd_soc_dapm_set_pin(dapm, pin, status);
2608 return ret < 0 ? ret : 0;
2612 * snd_soc_dapm_sync_unlocked - scan and power dapm paths
2613 * @dapm: DAPM context
2615 * Walks all dapm audio paths and powers widgets according to their
2616 * stream or path usage.
2618 * Requires external locking.
2620 * Returns 0 for success.
2622 int snd_soc_dapm_sync_unlocked(struct snd_soc_dapm_context *dapm)
2625 * Suppress early reports (eg, jacks syncing their state) to avoid
2626 * silly DAPM runs during card startup.
2628 if (!dapm->card || !dapm->card->instantiated)
2631 return dapm_power_widgets(dapm->card, SND_SOC_DAPM_STREAM_NOP);
2633 EXPORT_SYMBOL_GPL(snd_soc_dapm_sync_unlocked);
2636 * snd_soc_dapm_sync - scan and power dapm paths
2637 * @dapm: DAPM context
2639 * Walks all dapm audio paths and powers widgets according to their
2640 * stream or path usage.
2642 * Returns 0 for success.
2644 int snd_soc_dapm_sync(struct snd_soc_dapm_context *dapm)
2648 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2649 ret = snd_soc_dapm_sync_unlocked(dapm);
2650 mutex_unlock(&dapm->card->dapm_mutex);
2653 EXPORT_SYMBOL_GPL(snd_soc_dapm_sync);
2655 static int dapm_update_dai_chan(struct snd_soc_dapm_path *p,
2656 struct snd_soc_dapm_widget *w,
2660 case snd_soc_dapm_aif_out:
2661 case snd_soc_dapm_aif_in:
2667 dev_dbg(w->dapm->dev, "%s DAI route %s -> %s\n",
2668 w->channel < channels ? "Connecting" : "Disconnecting",
2669 p->source->name, p->sink->name);
2671 if (w->channel < channels)
2672 soc_dapm_connect_path(p, true, "dai update");
2674 soc_dapm_connect_path(p, false, "dai update");
2679 static int dapm_update_dai_unlocked(struct snd_pcm_substream *substream,
2680 struct snd_pcm_hw_params *params,
2681 struct snd_soc_dai *dai)
2683 int dir = substream->stream;
2684 int channels = params_channels(params);
2685 struct snd_soc_dapm_path *p;
2686 struct snd_soc_dapm_widget *w;
2689 w = snd_soc_dai_get_widget(dai, dir);
2694 dev_dbg(dai->dev, "Update DAI routes for %s %s\n", dai->name,
2695 dir == SNDRV_PCM_STREAM_PLAYBACK ? "playback" : "capture");
2697 snd_soc_dapm_widget_for_each_sink_path(w, p) {
2698 ret = dapm_update_dai_chan(p, p->sink, channels);
2703 snd_soc_dapm_widget_for_each_source_path(w, p) {
2704 ret = dapm_update_dai_chan(p, p->source, channels);
2712 int snd_soc_dapm_update_dai(struct snd_pcm_substream *substream,
2713 struct snd_pcm_hw_params *params,
2714 struct snd_soc_dai *dai)
2716 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
2719 mutex_lock_nested(&rtd->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2720 ret = dapm_update_dai_unlocked(substream, params, dai);
2721 mutex_unlock(&rtd->card->dapm_mutex);
2725 EXPORT_SYMBOL_GPL(snd_soc_dapm_update_dai);
2728 * dapm_update_widget_flags() - Re-compute widget sink and source flags
2729 * @w: The widget for which to update the flags
2731 * Some widgets have a dynamic category which depends on which neighbors they
2732 * are connected to. This function update the category for these widgets.
2734 * This function must be called whenever a path is added or removed to a widget.
2736 static void dapm_update_widget_flags(struct snd_soc_dapm_widget *w)
2738 enum snd_soc_dapm_direction dir;
2739 struct snd_soc_dapm_path *p;
2743 case snd_soc_dapm_input:
2744 /* On a fully routed card an input is never a source */
2745 if (w->dapm->card->fully_routed)
2747 ep = SND_SOC_DAPM_EP_SOURCE;
2748 snd_soc_dapm_widget_for_each_source_path(w, p) {
2749 if (p->source->id == snd_soc_dapm_micbias ||
2750 p->source->id == snd_soc_dapm_mic ||
2751 p->source->id == snd_soc_dapm_line ||
2752 p->source->id == snd_soc_dapm_output) {
2758 case snd_soc_dapm_output:
2759 /* On a fully routed card a output is never a sink */
2760 if (w->dapm->card->fully_routed)
2762 ep = SND_SOC_DAPM_EP_SINK;
2763 snd_soc_dapm_widget_for_each_sink_path(w, p) {
2764 if (p->sink->id == snd_soc_dapm_spk ||
2765 p->sink->id == snd_soc_dapm_hp ||
2766 p->sink->id == snd_soc_dapm_line ||
2767 p->sink->id == snd_soc_dapm_input) {
2773 case snd_soc_dapm_line:
2775 snd_soc_dapm_for_each_direction(dir) {
2776 if (!list_empty(&w->edges[dir]))
2777 ep |= SND_SOC_DAPM_DIR_TO_EP(dir);
2787 static int snd_soc_dapm_check_dynamic_path(struct snd_soc_dapm_context *dapm,
2788 struct snd_soc_dapm_widget *source, struct snd_soc_dapm_widget *sink,
2789 const char *control)
2791 bool dynamic_source = false;
2792 bool dynamic_sink = false;
2797 switch (source->id) {
2798 case snd_soc_dapm_demux:
2799 dynamic_source = true;
2806 case snd_soc_dapm_mux:
2807 case snd_soc_dapm_switch:
2808 case snd_soc_dapm_mixer:
2809 case snd_soc_dapm_mixer_named_ctl:
2810 dynamic_sink = true;
2816 if (dynamic_source && dynamic_sink) {
2818 "Direct connection between demux and mixer/mux not supported for path %s -> [%s] -> %s\n",
2819 source->name, control, sink->name);
2821 } else if (!dynamic_source && !dynamic_sink) {
2823 "Control not supported for path %s -> [%s] -> %s\n",
2824 source->name, control, sink->name);
2831 static int snd_soc_dapm_add_path(struct snd_soc_dapm_context *dapm,
2832 struct snd_soc_dapm_widget *wsource, struct snd_soc_dapm_widget *wsink,
2833 const char *control,
2834 int (*connected)(struct snd_soc_dapm_widget *source,
2835 struct snd_soc_dapm_widget *sink))
2837 struct snd_soc_dapm_widget *widgets[2];
2838 enum snd_soc_dapm_direction dir;
2839 struct snd_soc_dapm_path *path;
2842 if (wsink->is_supply && !wsource->is_supply) {
2844 "Connecting non-supply widget to supply widget is not supported (%s -> %s)\n",
2845 wsource->name, wsink->name);
2849 if (connected && !wsource->is_supply) {
2851 "connected() callback only supported for supply widgets (%s -> %s)\n",
2852 wsource->name, wsink->name);
2856 if (wsource->is_supply && control) {
2858 "Conditional paths are not supported for supply widgets (%s -> [%s] -> %s)\n",
2859 wsource->name, control, wsink->name);
2863 ret = snd_soc_dapm_check_dynamic_path(dapm, wsource, wsink, control);
2867 path = kzalloc(sizeof(struct snd_soc_dapm_path), GFP_KERNEL);
2871 path->node[SND_SOC_DAPM_DIR_IN] = wsource;
2872 path->node[SND_SOC_DAPM_DIR_OUT] = wsink;
2873 widgets[SND_SOC_DAPM_DIR_IN] = wsource;
2874 widgets[SND_SOC_DAPM_DIR_OUT] = wsink;
2876 path->connected = connected;
2877 INIT_LIST_HEAD(&path->list);
2878 INIT_LIST_HEAD(&path->list_kcontrol);
2880 if (wsource->is_supply || wsink->is_supply)
2881 path->is_supply = 1;
2883 /* connect static paths */
2884 if (control == NULL) {
2887 switch (wsource->id) {
2888 case snd_soc_dapm_demux:
2889 ret = dapm_connect_mux(dapm, path, control, wsource);
2897 switch (wsink->id) {
2898 case snd_soc_dapm_mux:
2899 ret = dapm_connect_mux(dapm, path, control, wsink);
2903 case snd_soc_dapm_switch:
2904 case snd_soc_dapm_mixer:
2905 case snd_soc_dapm_mixer_named_ctl:
2906 ret = dapm_connect_mixer(dapm, path, control);
2915 list_add(&path->list, &dapm->card->paths);
2916 snd_soc_dapm_for_each_direction(dir)
2917 list_add(&path->list_node[dir], &widgets[dir]->edges[dir]);
2919 snd_soc_dapm_for_each_direction(dir) {
2920 dapm_update_widget_flags(widgets[dir]);
2921 dapm_mark_dirty(widgets[dir], "Route added");
2924 if (dapm->card->instantiated && path->connect)
2925 dapm_path_invalidate(path);
2933 static int snd_soc_dapm_add_route(struct snd_soc_dapm_context *dapm,
2934 const struct snd_soc_dapm_route *route)
2936 struct snd_soc_dapm_widget *wsource = NULL, *wsink = NULL, *w;
2937 struct snd_soc_dapm_widget *wtsource = NULL, *wtsink = NULL;
2940 char prefixed_sink[80];
2941 char prefixed_source[80];
2943 unsigned int sink_ref = 0;
2944 unsigned int source_ref = 0;
2947 prefix = soc_dapm_prefix(dapm);
2949 snprintf(prefixed_sink, sizeof(prefixed_sink), "%s %s",
2950 prefix, route->sink);
2951 sink = prefixed_sink;
2952 snprintf(prefixed_source, sizeof(prefixed_source), "%s %s",
2953 prefix, route->source);
2954 source = prefixed_source;
2957 source = route->source;
2960 wsource = dapm_wcache_lookup(&dapm->path_source_cache, source);
2961 wsink = dapm_wcache_lookup(&dapm->path_sink_cache, sink);
2963 if (wsink && wsource)
2967 * find src and dest widgets over all widgets but favor a widget from
2968 * current DAPM context
2970 for_each_card_widgets(dapm->card, w) {
2971 if (!wsink && !(strcmp(w->name, sink))) {
2973 if (w->dapm == dapm) {
2981 "ASoC: sink widget %s overwritten\n",
2985 if (!wsource && !(strcmp(w->name, source))) {
2987 if (w->dapm == dapm) {
2995 "ASoC: source widget %s overwritten\n",
2999 /* use widget from another DAPM context if not found from this */
3005 if (wsource == NULL) {
3006 dev_err(dapm->dev, "ASoC: no source widget found for %s\n",
3010 if (wsink == NULL) {
3011 dev_err(dapm->dev, "ASoC: no sink widget found for %s\n",
3017 dapm_wcache_update(&dapm->path_sink_cache, wsink);
3018 dapm_wcache_update(&dapm->path_source_cache, wsource);
3020 ret = snd_soc_dapm_add_path(dapm, wsource, wsink, route->control,
3027 dev_warn(dapm->dev, "ASoC: no dapm match for %s --> %s --> %s\n",
3028 source, route->control, sink);
3032 static int snd_soc_dapm_del_route(struct snd_soc_dapm_context *dapm,
3033 const struct snd_soc_dapm_route *route)
3035 struct snd_soc_dapm_path *path, *p;
3038 char prefixed_sink[80];
3039 char prefixed_source[80];
3042 if (route->control) {
3044 "ASoC: Removal of routes with controls not supported\n");
3048 prefix = soc_dapm_prefix(dapm);
3050 snprintf(prefixed_sink, sizeof(prefixed_sink), "%s %s",
3051 prefix, route->sink);
3052 sink = prefixed_sink;
3053 snprintf(prefixed_source, sizeof(prefixed_source), "%s %s",
3054 prefix, route->source);
3055 source = prefixed_source;
3058 source = route->source;
3062 list_for_each_entry(p, &dapm->card->paths, list) {
3063 if (strcmp(p->source->name, source) != 0)
3065 if (strcmp(p->sink->name, sink) != 0)
3072 struct snd_soc_dapm_widget *wsource = path->source;
3073 struct snd_soc_dapm_widget *wsink = path->sink;
3075 dapm_mark_dirty(wsource, "Route removed");
3076 dapm_mark_dirty(wsink, "Route removed");
3078 dapm_path_invalidate(path);
3080 dapm_free_path(path);
3082 /* Update any path related flags */
3083 dapm_update_widget_flags(wsource);
3084 dapm_update_widget_flags(wsink);
3086 dev_warn(dapm->dev, "ASoC: Route %s->%s does not exist\n",
3094 * snd_soc_dapm_add_routes - Add routes between DAPM widgets
3095 * @dapm: DAPM context
3096 * @route: audio routes
3097 * @num: number of routes
3099 * Connects 2 dapm widgets together via a named audio path. The sink is
3100 * the widget receiving the audio signal, whilst the source is the sender
3101 * of the audio signal.
3103 * Returns 0 for success else error. On error all resources can be freed
3104 * with a call to snd_soc_card_free().
3106 int snd_soc_dapm_add_routes(struct snd_soc_dapm_context *dapm,
3107 const struct snd_soc_dapm_route *route, int num)
3111 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3112 for (i = 0; i < num; i++) {
3113 int r = snd_soc_dapm_add_route(dapm, route);
3115 dev_err(dapm->dev, "ASoC: Failed to add route %s -> %s -> %s\n",
3117 route->control ? route->control : "direct",
3123 mutex_unlock(&dapm->card->dapm_mutex);
3127 EXPORT_SYMBOL_GPL(snd_soc_dapm_add_routes);
3130 * snd_soc_dapm_del_routes - Remove routes between DAPM widgets
3131 * @dapm: DAPM context
3132 * @route: audio routes
3133 * @num: number of routes
3135 * Removes routes from the DAPM context.
3137 int snd_soc_dapm_del_routes(struct snd_soc_dapm_context *dapm,
3138 const struct snd_soc_dapm_route *route, int num)
3142 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3143 for (i = 0; i < num; i++) {
3144 snd_soc_dapm_del_route(dapm, route);
3147 mutex_unlock(&dapm->card->dapm_mutex);
3151 EXPORT_SYMBOL_GPL(snd_soc_dapm_del_routes);
3153 static int snd_soc_dapm_weak_route(struct snd_soc_dapm_context *dapm,
3154 const struct snd_soc_dapm_route *route)
3156 struct snd_soc_dapm_widget *source = dapm_find_widget(dapm,
3159 struct snd_soc_dapm_widget *sink = dapm_find_widget(dapm,
3162 struct snd_soc_dapm_path *path;
3166 dev_err(dapm->dev, "ASoC: Unable to find source %s for weak route\n",
3172 dev_err(dapm->dev, "ASoC: Unable to find sink %s for weak route\n",
3177 if (route->control || route->connected)
3178 dev_warn(dapm->dev, "ASoC: Ignoring control for weak route %s->%s\n",
3179 route->source, route->sink);
3181 snd_soc_dapm_widget_for_each_sink_path(source, path) {
3182 if (path->sink == sink) {
3189 dev_err(dapm->dev, "ASoC: No path found for weak route %s->%s\n",
3190 route->source, route->sink);
3192 dev_warn(dapm->dev, "ASoC: %d paths found for weak route %s->%s\n",
3193 count, route->source, route->sink);
3199 * snd_soc_dapm_weak_routes - Mark routes between DAPM widgets as weak
3200 * @dapm: DAPM context
3201 * @route: audio routes
3202 * @num: number of routes
3204 * Mark existing routes matching those specified in the passed array
3205 * as being weak, meaning that they are ignored for the purpose of
3206 * power decisions. The main intended use case is for sidetone paths
3207 * which couple audio between other independent paths if they are both
3208 * active in order to make the combination work better at the user
3209 * level but which aren't intended to be "used".
3211 * Note that CODEC drivers should not use this as sidetone type paths
3212 * can frequently also be used as bypass paths.
3214 int snd_soc_dapm_weak_routes(struct snd_soc_dapm_context *dapm,
3215 const struct snd_soc_dapm_route *route, int num)
3220 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_INIT);
3221 for (i = 0; i < num; i++) {
3222 int err = snd_soc_dapm_weak_route(dapm, route);
3227 mutex_unlock(&dapm->card->dapm_mutex);
3231 EXPORT_SYMBOL_GPL(snd_soc_dapm_weak_routes);
3234 * snd_soc_dapm_new_widgets - add new dapm widgets
3235 * @card: card to be checked for new dapm widgets
3237 * Checks the codec for any new dapm widgets and creates them if found.
3239 * Returns 0 for success.
3241 int snd_soc_dapm_new_widgets(struct snd_soc_card *card)
3243 struct snd_soc_dapm_widget *w;
3246 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_INIT);
3248 for_each_card_widgets(card, w)
3253 if (w->num_kcontrols) {
3254 w->kcontrols = kcalloc(w->num_kcontrols,
3255 sizeof(struct snd_kcontrol *),
3257 if (!w->kcontrols) {
3258 mutex_unlock(&card->dapm_mutex);
3264 case snd_soc_dapm_switch:
3265 case snd_soc_dapm_mixer:
3266 case snd_soc_dapm_mixer_named_ctl:
3269 case snd_soc_dapm_mux:
3270 case snd_soc_dapm_demux:
3273 case snd_soc_dapm_pga:
3274 case snd_soc_dapm_effect:
3275 case snd_soc_dapm_out_drv:
3278 case snd_soc_dapm_dai_link:
3279 dapm_new_dai_link(w);
3285 /* Read the initial power state from the device */
3287 val = soc_dapm_read(w->dapm, w->reg);
3288 val = val >> w->shift;
3290 if (val == w->on_val)
3296 dapm_mark_dirty(w, "new widget");
3297 dapm_debugfs_add_widget(w);
3300 dapm_power_widgets(card, SND_SOC_DAPM_STREAM_NOP);
3301 mutex_unlock(&card->dapm_mutex);
3304 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_widgets);
3307 * snd_soc_dapm_get_volsw - dapm mixer get callback
3308 * @kcontrol: mixer control
3309 * @ucontrol: control element information
3311 * Callback to get the value of a dapm mixer control.
3313 * Returns 0 for success.
3315 int snd_soc_dapm_get_volsw(struct snd_kcontrol *kcontrol,
3316 struct snd_ctl_elem_value *ucontrol)
3318 struct snd_soc_dapm_context *dapm = snd_soc_dapm_kcontrol_dapm(kcontrol);
3319 struct snd_soc_card *card = dapm->card;
3320 struct soc_mixer_control *mc =
3321 (struct soc_mixer_control *)kcontrol->private_value;
3323 unsigned int shift = mc->shift;
3325 unsigned int width = fls(max);
3326 unsigned int mask = (1 << fls(max)) - 1;
3327 unsigned int invert = mc->invert;
3328 unsigned int reg_val, val, rval = 0;
3330 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3331 if (dapm_kcontrol_is_powered(kcontrol) && reg != SND_SOC_NOPM) {
3332 reg_val = soc_dapm_read(dapm, reg);
3333 val = (reg_val >> shift) & mask;
3335 if (reg != mc->rreg)
3336 reg_val = soc_dapm_read(dapm, mc->rreg);
3338 if (snd_soc_volsw_is_stereo(mc))
3339 rval = (reg_val >> mc->rshift) & mask;
3341 reg_val = dapm_kcontrol_get_value(kcontrol);
3342 val = reg_val & mask;
3344 if (snd_soc_volsw_is_stereo(mc))
3345 rval = (reg_val >> width) & mask;
3347 mutex_unlock(&card->dapm_mutex);
3350 ucontrol->value.integer.value[0] = max - val;
3352 ucontrol->value.integer.value[0] = val;
3354 if (snd_soc_volsw_is_stereo(mc)) {
3356 ucontrol->value.integer.value[1] = max - rval;
3358 ucontrol->value.integer.value[1] = rval;
3363 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_volsw);
3366 * snd_soc_dapm_put_volsw - dapm mixer set callback
3367 * @kcontrol: mixer control
3368 * @ucontrol: control element information
3370 * Callback to set the value of a dapm mixer control.
3372 * Returns 0 for success.
3374 int snd_soc_dapm_put_volsw(struct snd_kcontrol *kcontrol,
3375 struct snd_ctl_elem_value *ucontrol)
3377 struct snd_soc_dapm_context *dapm = snd_soc_dapm_kcontrol_dapm(kcontrol);
3378 struct snd_soc_card *card = dapm->card;
3379 struct soc_mixer_control *mc =
3380 (struct soc_mixer_control *)kcontrol->private_value;
3382 unsigned int shift = mc->shift;
3384 unsigned int width = fls(max);
3385 unsigned int mask = (1 << width) - 1;
3386 unsigned int invert = mc->invert;
3387 unsigned int val, rval = 0;
3388 int connect, rconnect = -1, change, reg_change = 0;
3389 struct snd_soc_dapm_update update = {};
3392 val = (ucontrol->value.integer.value[0] & mask);
3398 if (snd_soc_volsw_is_stereo(mc)) {
3399 rval = (ucontrol->value.integer.value[1] & mask);
3405 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3407 /* This assumes field width < (bits in unsigned int / 2) */
3408 if (width > sizeof(unsigned int) * 8 / 2)
3410 "ASoC: control %s field width limit exceeded\n",
3412 change = dapm_kcontrol_set_value(kcontrol, val | (rval << width));
3414 if (reg != SND_SOC_NOPM) {
3416 rval = rval << mc->rshift;
3418 reg_change = soc_dapm_test_bits(dapm, reg, mask << shift, val);
3420 if (snd_soc_volsw_is_stereo(mc))
3421 reg_change |= soc_dapm_test_bits(dapm, mc->rreg,
3426 if (change || reg_change) {
3428 if (snd_soc_volsw_is_stereo(mc)) {
3429 update.has_second_set = true;
3430 update.reg2 = mc->rreg;
3431 update.mask2 = mask << mc->rshift;
3434 update.kcontrol = kcontrol;
3436 update.mask = mask << shift;
3438 card->update = &update;
3441 ret = soc_dapm_mixer_update_power(card, kcontrol, connect,
3444 card->update = NULL;
3447 mutex_unlock(&card->dapm_mutex);
3450 snd_soc_dpcm_runtime_update(card);
3454 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_volsw);
3457 * snd_soc_dapm_get_enum_double - dapm enumerated double mixer get callback
3458 * @kcontrol: mixer control
3459 * @ucontrol: control element information
3461 * Callback to get the value of a dapm enumerated double mixer control.
3463 * Returns 0 for success.
3465 int snd_soc_dapm_get_enum_double(struct snd_kcontrol *kcontrol,
3466 struct snd_ctl_elem_value *ucontrol)
3468 struct snd_soc_dapm_context *dapm = snd_soc_dapm_kcontrol_dapm(kcontrol);
3469 struct snd_soc_card *card = dapm->card;
3470 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
3471 unsigned int reg_val, val;
3473 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3474 if (e->reg != SND_SOC_NOPM && dapm_kcontrol_is_powered(kcontrol)) {
3475 reg_val = soc_dapm_read(dapm, e->reg);
3477 reg_val = dapm_kcontrol_get_value(kcontrol);
3479 mutex_unlock(&card->dapm_mutex);
3481 val = (reg_val >> e->shift_l) & e->mask;
3482 ucontrol->value.enumerated.item[0] = snd_soc_enum_val_to_item(e, val);
3483 if (e->shift_l != e->shift_r) {
3484 val = (reg_val >> e->shift_r) & e->mask;
3485 val = snd_soc_enum_val_to_item(e, val);
3486 ucontrol->value.enumerated.item[1] = val;
3491 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_enum_double);
3494 * snd_soc_dapm_put_enum_double - dapm enumerated double mixer set callback
3495 * @kcontrol: mixer control
3496 * @ucontrol: control element information
3498 * Callback to set the value of a dapm enumerated double mixer control.
3500 * Returns 0 for success.
3502 int snd_soc_dapm_put_enum_double(struct snd_kcontrol *kcontrol,
3503 struct snd_ctl_elem_value *ucontrol)
3505 struct snd_soc_dapm_context *dapm = snd_soc_dapm_kcontrol_dapm(kcontrol);
3506 struct snd_soc_card *card = dapm->card;
3507 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
3508 unsigned int *item = ucontrol->value.enumerated.item;
3509 unsigned int val, change, reg_change = 0;
3511 struct snd_soc_dapm_update update = {};
3514 if (item[0] >= e->items)
3517 val = snd_soc_enum_item_to_val(e, item[0]) << e->shift_l;
3518 mask = e->mask << e->shift_l;
3519 if (e->shift_l != e->shift_r) {
3520 if (item[1] > e->items)
3522 val |= snd_soc_enum_item_to_val(e, item[1]) << e->shift_r;
3523 mask |= e->mask << e->shift_r;
3526 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3528 change = dapm_kcontrol_set_value(kcontrol, val);
3530 if (e->reg != SND_SOC_NOPM)
3531 reg_change = soc_dapm_test_bits(dapm, e->reg, mask, val);
3533 if (change || reg_change) {
3535 update.kcontrol = kcontrol;
3536 update.reg = e->reg;
3539 card->update = &update;
3542 ret = soc_dapm_mux_update_power(card, kcontrol, item[0], e);
3544 card->update = NULL;
3547 mutex_unlock(&card->dapm_mutex);
3550 snd_soc_dpcm_runtime_update(card);
3554 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_enum_double);
3557 * snd_soc_dapm_info_pin_switch - Info for a pin switch
3559 * @kcontrol: mixer control
3560 * @uinfo: control element information
3562 * Callback to provide information about a pin switch control.
3564 int snd_soc_dapm_info_pin_switch(struct snd_kcontrol *kcontrol,
3565 struct snd_ctl_elem_info *uinfo)
3567 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
3569 uinfo->value.integer.min = 0;
3570 uinfo->value.integer.max = 1;
3574 EXPORT_SYMBOL_GPL(snd_soc_dapm_info_pin_switch);
3577 * snd_soc_dapm_get_pin_switch - Get information for a pin switch
3579 * @kcontrol: mixer control
3582 int snd_soc_dapm_get_pin_switch(struct snd_kcontrol *kcontrol,
3583 struct snd_ctl_elem_value *ucontrol)
3585 struct snd_soc_card *card = snd_kcontrol_chip(kcontrol);
3586 const char *pin = (const char *)kcontrol->private_value;
3588 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3590 ucontrol->value.integer.value[0] =
3591 snd_soc_dapm_get_pin_status(&card->dapm, pin);
3593 mutex_unlock(&card->dapm_mutex);
3597 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_pin_switch);
3600 * snd_soc_dapm_put_pin_switch - Set information for a pin switch
3602 * @kcontrol: mixer control
3605 int snd_soc_dapm_put_pin_switch(struct snd_kcontrol *kcontrol,
3606 struct snd_ctl_elem_value *ucontrol)
3608 struct snd_soc_card *card = snd_kcontrol_chip(kcontrol);
3609 const char *pin = (const char *)kcontrol->private_value;
3612 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3613 ret = __snd_soc_dapm_set_pin(&card->dapm, pin,
3614 !!ucontrol->value.integer.value[0]);
3615 mutex_unlock(&card->dapm_mutex);
3617 snd_soc_dapm_sync(&card->dapm);
3620 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_pin_switch);
3622 struct snd_soc_dapm_widget *
3623 snd_soc_dapm_new_control_unlocked(struct snd_soc_dapm_context *dapm,
3624 const struct snd_soc_dapm_widget *widget)
3626 enum snd_soc_dapm_direction dir;
3627 struct snd_soc_dapm_widget *w;
3631 if ((w = dapm_cnew_widget(widget)) == NULL)
3632 return ERR_PTR(-ENOMEM);
3635 case snd_soc_dapm_regulator_supply:
3636 w->regulator = devm_regulator_get(dapm->dev, w->name);
3637 if (IS_ERR(w->regulator)) {
3638 ret = PTR_ERR(w->regulator);
3639 goto request_failed;
3642 if (w->on_val & SND_SOC_DAPM_REGULATOR_BYPASS) {
3643 ret = regulator_allow_bypass(w->regulator, true);
3646 "ASoC: Failed to bypass %s: %d\n",
3650 case snd_soc_dapm_pinctrl:
3651 w->pinctrl = devm_pinctrl_get(dapm->dev);
3652 if (IS_ERR(w->pinctrl)) {
3653 ret = PTR_ERR(w->pinctrl);
3654 goto request_failed;
3657 /* set to sleep_state when initializing */
3658 dapm_pinctrl_event(w, NULL, SND_SOC_DAPM_POST_PMD);
3660 case snd_soc_dapm_clock_supply:
3661 w->clk = devm_clk_get(dapm->dev, w->name);
3662 if (IS_ERR(w->clk)) {
3663 ret = PTR_ERR(w->clk);
3664 goto request_failed;
3671 prefix = soc_dapm_prefix(dapm);
3673 w->name = kasprintf(GFP_KERNEL, "%s %s", prefix, widget->name);
3675 w->name = kstrdup_const(widget->name, GFP_KERNEL);
3676 if (w->name == NULL) {
3677 kfree_const(w->sname);
3679 return ERR_PTR(-ENOMEM);
3683 case snd_soc_dapm_mic:
3684 w->is_ep = SND_SOC_DAPM_EP_SOURCE;
3685 w->power_check = dapm_generic_check_power;
3687 case snd_soc_dapm_input:
3688 if (!dapm->card->fully_routed)
3689 w->is_ep = SND_SOC_DAPM_EP_SOURCE;
3690 w->power_check = dapm_generic_check_power;
3692 case snd_soc_dapm_spk:
3693 case snd_soc_dapm_hp:
3694 w->is_ep = SND_SOC_DAPM_EP_SINK;
3695 w->power_check = dapm_generic_check_power;
3697 case snd_soc_dapm_output:
3698 if (!dapm->card->fully_routed)
3699 w->is_ep = SND_SOC_DAPM_EP_SINK;
3700 w->power_check = dapm_generic_check_power;
3702 case snd_soc_dapm_vmid:
3703 case snd_soc_dapm_siggen:
3704 w->is_ep = SND_SOC_DAPM_EP_SOURCE;
3705 w->power_check = dapm_always_on_check_power;
3707 case snd_soc_dapm_sink:
3708 w->is_ep = SND_SOC_DAPM_EP_SINK;
3709 w->power_check = dapm_always_on_check_power;
3712 case snd_soc_dapm_mux:
3713 case snd_soc_dapm_demux:
3714 case snd_soc_dapm_switch:
3715 case snd_soc_dapm_mixer:
3716 case snd_soc_dapm_mixer_named_ctl:
3717 case snd_soc_dapm_adc:
3718 case snd_soc_dapm_aif_out:
3719 case snd_soc_dapm_dac:
3720 case snd_soc_dapm_aif_in:
3721 case snd_soc_dapm_pga:
3722 case snd_soc_dapm_buffer:
3723 case snd_soc_dapm_scheduler:
3724 case snd_soc_dapm_effect:
3725 case snd_soc_dapm_src:
3726 case snd_soc_dapm_asrc:
3727 case snd_soc_dapm_encoder:
3728 case snd_soc_dapm_decoder:
3729 case snd_soc_dapm_out_drv:
3730 case snd_soc_dapm_micbias:
3731 case snd_soc_dapm_line:
3732 case snd_soc_dapm_dai_link:
3733 case snd_soc_dapm_dai_out:
3734 case snd_soc_dapm_dai_in:
3735 w->power_check = dapm_generic_check_power;
3737 case snd_soc_dapm_supply:
3738 case snd_soc_dapm_regulator_supply:
3739 case snd_soc_dapm_pinctrl:
3740 case snd_soc_dapm_clock_supply:
3741 case snd_soc_dapm_kcontrol:
3743 w->power_check = dapm_supply_check_power;
3746 w->power_check = dapm_always_on_check_power;
3751 INIT_LIST_HEAD(&w->list);
3752 INIT_LIST_HEAD(&w->dirty);
3753 /* see for_each_card_widgets */
3754 list_add_tail(&w->list, &dapm->card->widgets);
3756 snd_soc_dapm_for_each_direction(dir) {
3757 INIT_LIST_HEAD(&w->edges[dir]);
3758 w->endpoints[dir] = -1;
3761 /* machine layer sets up unconnected pins and insertions */
3766 if (ret != -EPROBE_DEFER)
3767 dev_err(dapm->dev, "ASoC: Failed to request %s: %d\n",
3770 kfree_const(w->sname);
3772 return ERR_PTR(ret);
3776 * snd_soc_dapm_new_control - create new dapm control
3777 * @dapm: DAPM context
3778 * @widget: widget template
3780 * Creates new DAPM control based upon a template.
3782 * Returns a widget pointer on success or an error pointer on failure
3784 struct snd_soc_dapm_widget *
3785 snd_soc_dapm_new_control(struct snd_soc_dapm_context *dapm,
3786 const struct snd_soc_dapm_widget *widget)
3788 struct snd_soc_dapm_widget *w;
3790 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3791 w = snd_soc_dapm_new_control_unlocked(dapm, widget);
3792 mutex_unlock(&dapm->card->dapm_mutex);
3796 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_control);
3799 * snd_soc_dapm_new_controls - create new dapm controls
3800 * @dapm: DAPM context
3801 * @widget: widget array
3802 * @num: number of widgets
3804 * Creates new DAPM controls based upon the templates.
3806 * Returns 0 for success else error.
3808 int snd_soc_dapm_new_controls(struct snd_soc_dapm_context *dapm,
3809 const struct snd_soc_dapm_widget *widget,
3815 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_INIT);
3816 for (i = 0; i < num; i++) {
3817 struct snd_soc_dapm_widget *w = snd_soc_dapm_new_control_unlocked(dapm, widget);
3824 mutex_unlock(&dapm->card->dapm_mutex);
3827 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_controls);
3830 snd_soc_dai_link_event_pre_pmu(struct snd_soc_dapm_widget *w,
3831 struct snd_pcm_substream *substream)
3833 struct snd_soc_dapm_path *path;
3834 struct snd_soc_dai *source, *sink;
3835 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
3836 struct snd_pcm_hw_params *params = NULL;
3837 const struct snd_soc_pcm_stream *config = NULL;
3838 struct snd_pcm_runtime *runtime = NULL;
3842 params = kzalloc(sizeof(*params), GFP_KERNEL);
3846 runtime = kzalloc(sizeof(*runtime), GFP_KERNEL);
3852 substream->runtime = runtime;
3854 substream->stream = SNDRV_PCM_STREAM_CAPTURE;
3855 snd_soc_dapm_widget_for_each_source_path(w, path) {
3856 source = path->source->priv;
3858 ret = snd_soc_dai_startup(source, substream);
3862 snd_soc_dai_activate(source, substream->stream);
3865 substream->stream = SNDRV_PCM_STREAM_PLAYBACK;
3866 snd_soc_dapm_widget_for_each_sink_path(w, path) {
3867 sink = path->sink->priv;
3869 ret = snd_soc_dai_startup(sink, substream);
3873 snd_soc_dai_activate(sink, substream->stream);
3876 substream->hw_opened = 1;
3879 * Note: getting the config after .startup() gives a chance to
3880 * either party on the link to alter the configuration if
3883 config = rtd->dai_link->params + rtd->params_select;
3884 if (WARN_ON(!config)) {
3885 dev_err(w->dapm->dev, "ASoC: link config missing\n");
3890 /* Be a little careful as we don't want to overflow the mask array */
3891 if (config->formats) {
3892 fmt = ffs(config->formats) - 1;
3894 dev_warn(w->dapm->dev, "ASoC: Invalid format %llx specified\n",
3901 snd_mask_set(hw_param_mask(params, SNDRV_PCM_HW_PARAM_FORMAT), fmt);
3902 hw_param_interval(params, SNDRV_PCM_HW_PARAM_RATE)->min =
3904 hw_param_interval(params, SNDRV_PCM_HW_PARAM_RATE)->max =
3906 hw_param_interval(params, SNDRV_PCM_HW_PARAM_CHANNELS)->min
3907 = config->channels_min;
3908 hw_param_interval(params, SNDRV_PCM_HW_PARAM_CHANNELS)->max
3909 = config->channels_max;
3911 substream->stream = SNDRV_PCM_STREAM_CAPTURE;
3912 snd_soc_dapm_widget_for_each_source_path(w, path) {
3913 source = path->source->priv;
3915 ret = snd_soc_dai_hw_params(source, substream, params);
3919 dapm_update_dai_unlocked(substream, params, source);
3922 substream->stream = SNDRV_PCM_STREAM_PLAYBACK;
3923 snd_soc_dapm_widget_for_each_sink_path(w, path) {
3924 sink = path->sink->priv;
3926 ret = snd_soc_dai_hw_params(sink, substream, params);
3930 dapm_update_dai_unlocked(substream, params, sink);
3933 runtime->format = params_format(params);
3934 runtime->subformat = params_subformat(params);
3935 runtime->channels = params_channels(params);
3936 runtime->rate = params_rate(params);
3943 static int snd_soc_dai_link_event(struct snd_soc_dapm_widget *w,
3944 struct snd_kcontrol *kcontrol, int event)
3946 struct snd_soc_dapm_path *path;
3947 struct snd_soc_dai *source, *sink;
3948 struct snd_pcm_substream *substream = w->priv;
3949 int ret = 0, saved_stream = substream->stream;
3951 if (WARN_ON(list_empty(&w->edges[SND_SOC_DAPM_DIR_OUT]) ||
3952 list_empty(&w->edges[SND_SOC_DAPM_DIR_IN])))
3956 case SND_SOC_DAPM_PRE_PMU:
3957 ret = snd_soc_dai_link_event_pre_pmu(w, substream);
3963 case SND_SOC_DAPM_POST_PMU:
3964 snd_soc_dapm_widget_for_each_sink_path(w, path) {
3965 sink = path->sink->priv;
3967 snd_soc_dai_digital_mute(sink, 0, SNDRV_PCM_STREAM_PLAYBACK);
3972 case SND_SOC_DAPM_PRE_PMD:
3973 snd_soc_dapm_widget_for_each_sink_path(w, path) {
3974 sink = path->sink->priv;
3976 snd_soc_dai_digital_mute(sink, 1, SNDRV_PCM_STREAM_PLAYBACK);
3980 substream->stream = SNDRV_PCM_STREAM_CAPTURE;
3981 snd_soc_dapm_widget_for_each_source_path(w, path) {
3982 source = path->source->priv;
3983 snd_soc_dai_hw_free(source, substream, 0);
3986 substream->stream = SNDRV_PCM_STREAM_PLAYBACK;
3987 snd_soc_dapm_widget_for_each_sink_path(w, path) {
3988 sink = path->sink->priv;
3989 snd_soc_dai_hw_free(sink, substream, 0);
3992 substream->stream = SNDRV_PCM_STREAM_CAPTURE;
3993 snd_soc_dapm_widget_for_each_source_path(w, path) {
3994 source = path->source->priv;
3995 snd_soc_dai_deactivate(source, substream->stream);
3996 snd_soc_dai_shutdown(source, substream, 0);
3999 substream->stream = SNDRV_PCM_STREAM_PLAYBACK;
4000 snd_soc_dapm_widget_for_each_sink_path(w, path) {
4001 sink = path->sink->priv;
4002 snd_soc_dai_deactivate(sink, substream->stream);
4003 snd_soc_dai_shutdown(sink, substream, 0);
4007 case SND_SOC_DAPM_POST_PMD:
4008 kfree(substream->runtime);
4012 WARN(1, "Unknown event %d\n", event);
4017 /* Restore the substream direction */
4018 substream->stream = saved_stream;
4022 static int snd_soc_dapm_dai_link_get(struct snd_kcontrol *kcontrol,
4023 struct snd_ctl_elem_value *ucontrol)
4025 struct snd_soc_dapm_widget *w = snd_kcontrol_chip(kcontrol);
4026 struct snd_soc_pcm_runtime *rtd = w->priv;
4028 ucontrol->value.enumerated.item[0] = rtd->params_select;
4033 static int snd_soc_dapm_dai_link_put(struct snd_kcontrol *kcontrol,
4034 struct snd_ctl_elem_value *ucontrol)
4036 struct snd_soc_dapm_widget *w = snd_kcontrol_chip(kcontrol);
4037 struct snd_soc_pcm_runtime *rtd = w->priv;
4039 /* Can't change the config when widget is already powered */
4043 if (ucontrol->value.enumerated.item[0] == rtd->params_select)
4046 if (ucontrol->value.enumerated.item[0] >= rtd->dai_link->num_params)
4049 rtd->params_select = ucontrol->value.enumerated.item[0];
4055 snd_soc_dapm_free_kcontrol(struct snd_soc_card *card,
4056 unsigned long *private_value,
4058 const char **w_param_text)
4062 devm_kfree(card->dev, (void *)*private_value);
4067 for (count = 0 ; count < num_params; count++)
4068 devm_kfree(card->dev, (void *)w_param_text[count]);
4069 devm_kfree(card->dev, w_param_text);
4072 static struct snd_kcontrol_new *
4073 snd_soc_dapm_alloc_kcontrol(struct snd_soc_card *card,
4075 const struct snd_soc_pcm_stream *params,
4076 int num_params, const char **w_param_text,
4077 unsigned long *private_value)
4079 struct soc_enum w_param_enum[] = {
4080 SOC_ENUM_SINGLE(0, 0, 0, NULL),
4082 struct snd_kcontrol_new kcontrol_dai_link[] = {
4083 SOC_ENUM_EXT(NULL, w_param_enum[0],
4084 snd_soc_dapm_dai_link_get,
4085 snd_soc_dapm_dai_link_put),
4087 struct snd_kcontrol_new *kcontrol_news;
4088 const struct snd_soc_pcm_stream *config = params;
4091 for (count = 0 ; count < num_params; count++) {
4092 if (!config->stream_name) {
4093 dev_warn(card->dapm.dev,
4094 "ASoC: anonymous config %d for dai link %s\n",
4096 w_param_text[count] =
4097 devm_kasprintf(card->dev, GFP_KERNEL,
4098 "Anonymous Configuration %d",
4101 w_param_text[count] = devm_kmemdup(card->dev,
4102 config->stream_name,
4103 strlen(config->stream_name) + 1,
4106 if (!w_param_text[count])
4107 goto outfree_w_param;
4111 w_param_enum[0].items = num_params;
4112 w_param_enum[0].texts = w_param_text;
4115 (unsigned long) devm_kmemdup(card->dev,
4116 (void *)(kcontrol_dai_link[0].private_value),
4117 sizeof(struct soc_enum), GFP_KERNEL);
4118 if (!*private_value) {
4119 dev_err(card->dev, "ASoC: Failed to create control for %s widget\n",
4121 goto outfree_w_param;
4123 kcontrol_dai_link[0].private_value = *private_value;
4124 /* duplicate kcontrol_dai_link on heap so that memory persists */
4125 kcontrol_news = devm_kmemdup(card->dev, &kcontrol_dai_link[0],
4126 sizeof(struct snd_kcontrol_new),
4128 if (!kcontrol_news) {
4129 dev_err(card->dev, "ASoC: Failed to create control for %s widget\n",
4131 goto outfree_w_param;
4133 return kcontrol_news;
4136 snd_soc_dapm_free_kcontrol(card, private_value, num_params, w_param_text);
4140 static struct snd_soc_dapm_widget *
4141 snd_soc_dapm_new_dai(struct snd_soc_card *card,
4142 struct snd_pcm_substream *substream,
4145 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
4146 struct snd_soc_dapm_widget template;
4147 struct snd_soc_dapm_widget *w;
4148 const char **w_param_text;
4149 unsigned long private_value = 0;
4153 link_name = devm_kasprintf(card->dev, GFP_KERNEL, "%s-%s",
4154 rtd->dai_link->name, id);
4156 return ERR_PTR(-ENOMEM);
4158 memset(&template, 0, sizeof(template));
4159 template.reg = SND_SOC_NOPM;
4160 template.id = snd_soc_dapm_dai_link;
4161 template.name = link_name;
4162 template.event = snd_soc_dai_link_event;
4163 template.event_flags = SND_SOC_DAPM_PRE_PMU | SND_SOC_DAPM_POST_PMU |
4164 SND_SOC_DAPM_PRE_PMD | SND_SOC_DAPM_POST_PMD;
4165 template.kcontrol_news = NULL;
4167 /* allocate memory for control, only in case of multiple configs */
4168 if (rtd->dai_link->num_params > 1) {
4169 w_param_text = devm_kcalloc(card->dev,
4170 rtd->dai_link->num_params,
4171 sizeof(char *), GFP_KERNEL);
4172 if (!w_param_text) {
4177 template.num_kcontrols = 1;
4178 template.kcontrol_news =
4179 snd_soc_dapm_alloc_kcontrol(card,
4181 rtd->dai_link->params,
4182 rtd->dai_link->num_params,
4183 w_param_text, &private_value);
4184 if (!template.kcontrol_news) {
4189 w_param_text = NULL;
4191 dev_dbg(card->dev, "ASoC: adding %s widget\n", link_name);
4193 w = snd_soc_dapm_new_control_unlocked(&card->dapm, &template);
4196 dev_err(rtd->dev, "ASoC: Failed to create %s widget: %d\n",
4198 goto outfree_kcontrol_news;
4201 w->priv = substream;
4205 outfree_kcontrol_news:
4206 devm_kfree(card->dev, (void *)template.kcontrol_news);
4207 snd_soc_dapm_free_kcontrol(card, &private_value,
4208 rtd->dai_link->num_params, w_param_text);
4210 devm_kfree(card->dev, link_name);
4211 return ERR_PTR(ret);
4215 * snd_soc_dapm_new_dai_widgets - Create new DAPM widgets
4216 * @dapm: DAPM context
4219 * Returns 0 on success, error code otherwise.
4221 int snd_soc_dapm_new_dai_widgets(struct snd_soc_dapm_context *dapm,
4222 struct snd_soc_dai *dai)
4224 struct snd_soc_dapm_widget template;
4225 struct snd_soc_dapm_widget *w;
4227 WARN_ON(dapm->dev != dai->dev);
4229 memset(&template, 0, sizeof(template));
4230 template.reg = SND_SOC_NOPM;
4232 if (dai->driver->playback.stream_name) {
4233 template.id = snd_soc_dapm_dai_in;
4234 template.name = dai->driver->playback.stream_name;
4235 template.sname = dai->driver->playback.stream_name;
4237 dev_dbg(dai->dev, "ASoC: adding %s widget\n",
4240 w = snd_soc_dapm_new_control_unlocked(dapm, &template);
4245 dai->playback_widget = w;
4248 if (dai->driver->capture.stream_name) {
4249 template.id = snd_soc_dapm_dai_out;
4250 template.name = dai->driver->capture.stream_name;
4251 template.sname = dai->driver->capture.stream_name;
4253 dev_dbg(dai->dev, "ASoC: adding %s widget\n",
4256 w = snd_soc_dapm_new_control_unlocked(dapm, &template);
4261 dai->capture_widget = w;
4266 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_dai_widgets);
4268 int snd_soc_dapm_link_dai_widgets(struct snd_soc_card *card)
4270 struct snd_soc_dapm_widget *dai_w, *w;
4271 struct snd_soc_dapm_widget *src, *sink;
4272 struct snd_soc_dai *dai;
4274 /* For each DAI widget... */
4275 for_each_card_widgets(card, dai_w) {
4276 switch (dai_w->id) {
4277 case snd_soc_dapm_dai_in:
4278 case snd_soc_dapm_dai_out:
4284 /* let users know there is no DAI to link */
4286 dev_dbg(card->dev, "dai widget %s has no DAI\n",
4293 /* ...find all widgets with the same stream and link them */
4294 for_each_card_widgets(card, w) {
4295 if (w->dapm != dai_w->dapm)
4299 case snd_soc_dapm_dai_in:
4300 case snd_soc_dapm_dai_out:
4306 if (!w->sname || !strstr(w->sname, dai_w->sname))
4309 if (dai_w->id == snd_soc_dapm_dai_in) {
4316 dev_dbg(dai->dev, "%s -> %s\n", src->name, sink->name);
4317 snd_soc_dapm_add_path(w->dapm, src, sink, NULL, NULL);
4324 static void dapm_connect_dai_routes(struct snd_soc_dapm_context *dapm,
4325 struct snd_soc_dai *src_dai,
4326 struct snd_soc_dapm_widget *src,
4327 struct snd_soc_dapm_widget *dai,
4328 struct snd_soc_dai *sink_dai,
4329 struct snd_soc_dapm_widget *sink)
4331 dev_dbg(dapm->dev, "connected DAI link %s:%s -> %s:%s\n",
4332 src_dai->component->name, src->name,
4333 sink_dai->component->name, sink->name);
4336 snd_soc_dapm_add_path(dapm, src, dai, NULL, NULL);
4340 snd_soc_dapm_add_path(dapm, src, sink, NULL, NULL);
4343 static void dapm_connect_dai_pair(struct snd_soc_card *card,
4344 struct snd_soc_pcm_runtime *rtd,
4345 struct snd_soc_dai *codec_dai,
4346 struct snd_soc_dai *cpu_dai)
4348 struct snd_soc_dai_link *dai_link = rtd->dai_link;
4349 struct snd_soc_dapm_widget *dai, *codec, *playback_cpu, *capture_cpu;
4350 struct snd_pcm_substream *substream;
4351 struct snd_pcm_str *streams = rtd->pcm->streams;
4353 if (dai_link->params) {
4354 playback_cpu = cpu_dai->capture_widget;
4355 capture_cpu = cpu_dai->playback_widget;
4357 playback_cpu = cpu_dai->playback_widget;
4358 capture_cpu = cpu_dai->capture_widget;
4361 /* connect BE DAI playback if widgets are valid */
4362 codec = codec_dai->playback_widget;
4364 if (playback_cpu && codec) {
4365 if (dai_link->params && !rtd->playback_widget) {
4366 substream = streams[SNDRV_PCM_STREAM_PLAYBACK].substream;
4367 dai = snd_soc_dapm_new_dai(card, substream, "playback");
4370 rtd->playback_widget = dai;
4373 dapm_connect_dai_routes(&card->dapm, cpu_dai, playback_cpu,
4374 rtd->playback_widget,
4379 /* connect BE DAI capture if widgets are valid */
4380 codec = codec_dai->capture_widget;
4382 if (codec && capture_cpu) {
4383 if (dai_link->params && !rtd->capture_widget) {
4384 substream = streams[SNDRV_PCM_STREAM_CAPTURE].substream;
4385 dai = snd_soc_dapm_new_dai(card, substream, "capture");
4388 rtd->capture_widget = dai;
4391 dapm_connect_dai_routes(&card->dapm, codec_dai, codec,
4392 rtd->capture_widget,
4393 cpu_dai, capture_cpu);
4397 static void soc_dapm_dai_stream_event(struct snd_soc_dai *dai, int stream,
4400 struct snd_soc_dapm_widget *w;
4402 w = snd_soc_dai_get_widget(dai, stream);
4407 dapm_mark_dirty(w, "stream event");
4409 if (w->id == snd_soc_dapm_dai_in) {
4410 ep = SND_SOC_DAPM_EP_SOURCE;
4411 dapm_widget_invalidate_input_paths(w);
4413 ep = SND_SOC_DAPM_EP_SINK;
4414 dapm_widget_invalidate_output_paths(w);
4418 case SND_SOC_DAPM_STREAM_START:
4422 case SND_SOC_DAPM_STREAM_STOP:
4426 case SND_SOC_DAPM_STREAM_SUSPEND:
4427 case SND_SOC_DAPM_STREAM_RESUME:
4428 case SND_SOC_DAPM_STREAM_PAUSE_PUSH:
4429 case SND_SOC_DAPM_STREAM_PAUSE_RELEASE:
4435 void snd_soc_dapm_connect_dai_link_widgets(struct snd_soc_card *card)
4437 struct snd_soc_pcm_runtime *rtd;
4438 struct snd_soc_dai *codec_dai;
4441 /* for each BE DAI link... */
4442 for_each_card_rtds(card, rtd) {
4444 * dynamic FE links have no fixed DAI mapping.
4445 * CODEC<->CODEC links have no direct connection.
4447 if (rtd->dai_link->dynamic)
4450 if (rtd->num_cpus == 1) {
4451 for_each_rtd_codec_dais(rtd, i, codec_dai)
4452 dapm_connect_dai_pair(card, rtd, codec_dai,
4453 asoc_rtd_to_cpu(rtd, 0));
4454 } else if (rtd->num_codecs == rtd->num_cpus) {
4455 for_each_rtd_codec_dais(rtd, i, codec_dai)
4456 dapm_connect_dai_pair(card, rtd, codec_dai,
4457 asoc_rtd_to_cpu(rtd, i));
4460 "N cpus to M codecs link is not supported yet\n");
4465 static void soc_dapm_stream_event(struct snd_soc_pcm_runtime *rtd, int stream,
4468 struct snd_soc_dai *dai;
4471 for_each_rtd_dais(rtd, i, dai)
4472 soc_dapm_dai_stream_event(dai, stream, event);
4474 dapm_power_widgets(rtd->card, event);
4478 * snd_soc_dapm_stream_event - send a stream event to the dapm core
4479 * @rtd: PCM runtime data
4480 * @stream: stream name
4481 * @event: stream event
4483 * Sends a stream event to the dapm core. The core then makes any
4484 * necessary widget power changes.
4486 * Returns 0 for success else error.
4488 void snd_soc_dapm_stream_event(struct snd_soc_pcm_runtime *rtd, int stream,
4491 struct snd_soc_card *card = rtd->card;
4493 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
4494 soc_dapm_stream_event(rtd, stream, event);
4495 mutex_unlock(&card->dapm_mutex);
4498 void snd_soc_dapm_stream_stop(struct snd_soc_pcm_runtime *rtd, int stream)
4500 if (stream == SNDRV_PCM_STREAM_PLAYBACK) {
4501 if (snd_soc_runtime_ignore_pmdown_time(rtd)) {
4502 /* powered down playback stream now */
4503 snd_soc_dapm_stream_event(rtd,
4504 SNDRV_PCM_STREAM_PLAYBACK,
4505 SND_SOC_DAPM_STREAM_STOP);
4507 /* start delayed pop wq here for playback streams */
4509 queue_delayed_work(system_power_efficient_wq,
4511 msecs_to_jiffies(rtd->pmdown_time));
4514 /* capture streams can be powered down now */
4515 snd_soc_dapm_stream_event(rtd, SNDRV_PCM_STREAM_CAPTURE,
4516 SND_SOC_DAPM_STREAM_STOP);
4519 EXPORT_SYMBOL_GPL(snd_soc_dapm_stream_stop);
4522 * snd_soc_dapm_enable_pin_unlocked - enable pin.
4523 * @dapm: DAPM context
4526 * Enables input/output pin and its parents or children widgets iff there is
4527 * a valid audio route and active audio stream.
4529 * Requires external locking.
4531 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
4532 * do any widget power switching.
4534 int snd_soc_dapm_enable_pin_unlocked(struct snd_soc_dapm_context *dapm,
4537 return snd_soc_dapm_set_pin(dapm, pin, 1);
4539 EXPORT_SYMBOL_GPL(snd_soc_dapm_enable_pin_unlocked);
4542 * snd_soc_dapm_enable_pin - enable pin.
4543 * @dapm: DAPM context
4546 * Enables input/output pin and its parents or children widgets iff there is
4547 * a valid audio route and active audio stream.
4549 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
4550 * do any widget power switching.
4552 int snd_soc_dapm_enable_pin(struct snd_soc_dapm_context *dapm, const char *pin)
4556 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
4558 ret = snd_soc_dapm_set_pin(dapm, pin, 1);
4560 mutex_unlock(&dapm->card->dapm_mutex);
4564 EXPORT_SYMBOL_GPL(snd_soc_dapm_enable_pin);
4567 * snd_soc_dapm_force_enable_pin_unlocked - force a pin to be enabled
4568 * @dapm: DAPM context
4571 * Enables input/output pin regardless of any other state. This is
4572 * intended for use with microphone bias supplies used in microphone
4575 * Requires external locking.
4577 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
4578 * do any widget power switching.
4580 int snd_soc_dapm_force_enable_pin_unlocked(struct snd_soc_dapm_context *dapm,
4583 struct snd_soc_dapm_widget *w = dapm_find_widget(dapm, pin, true);
4586 dev_err(dapm->dev, "ASoC: unknown pin %s\n", pin);
4590 dev_dbg(w->dapm->dev, "ASoC: force enable pin %s\n", pin);
4591 if (!w->connected) {
4593 * w->force does not affect the number of input or output paths,
4594 * so we only have to recheck if w->connected is changed
4596 dapm_widget_invalidate_input_paths(w);
4597 dapm_widget_invalidate_output_paths(w);
4601 dapm_mark_dirty(w, "force enable");
4605 EXPORT_SYMBOL_GPL(snd_soc_dapm_force_enable_pin_unlocked);
4608 * snd_soc_dapm_force_enable_pin - force a pin to be enabled
4609 * @dapm: DAPM context
4612 * Enables input/output pin regardless of any other state. This is
4613 * intended for use with microphone bias supplies used in microphone
4616 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
4617 * do any widget power switching.
4619 int snd_soc_dapm_force_enable_pin(struct snd_soc_dapm_context *dapm,
4624 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
4626 ret = snd_soc_dapm_force_enable_pin_unlocked(dapm, pin);
4628 mutex_unlock(&dapm->card->dapm_mutex);
4632 EXPORT_SYMBOL_GPL(snd_soc_dapm_force_enable_pin);
4635 * snd_soc_dapm_disable_pin_unlocked - disable pin.
4636 * @dapm: DAPM context
4639 * Disables input/output pin and its parents or children widgets.
4641 * Requires external locking.
4643 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
4644 * do any widget power switching.
4646 int snd_soc_dapm_disable_pin_unlocked(struct snd_soc_dapm_context *dapm,
4649 return snd_soc_dapm_set_pin(dapm, pin, 0);
4651 EXPORT_SYMBOL_GPL(snd_soc_dapm_disable_pin_unlocked);
4654 * snd_soc_dapm_disable_pin - disable pin.
4655 * @dapm: DAPM context
4658 * Disables input/output pin and its parents or children widgets.
4660 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
4661 * do any widget power switching.
4663 int snd_soc_dapm_disable_pin(struct snd_soc_dapm_context *dapm,
4668 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
4670 ret = snd_soc_dapm_set_pin(dapm, pin, 0);
4672 mutex_unlock(&dapm->card->dapm_mutex);
4676 EXPORT_SYMBOL_GPL(snd_soc_dapm_disable_pin);
4679 * snd_soc_dapm_nc_pin_unlocked - permanently disable pin.
4680 * @dapm: DAPM context
4683 * Marks the specified pin as being not connected, disabling it along
4684 * any parent or child widgets. At present this is identical to
4685 * snd_soc_dapm_disable_pin() but in future it will be extended to do
4686 * additional things such as disabling controls which only affect
4687 * paths through the pin.
4689 * Requires external locking.
4691 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
4692 * do any widget power switching.
4694 int snd_soc_dapm_nc_pin_unlocked(struct snd_soc_dapm_context *dapm,
4697 return snd_soc_dapm_set_pin(dapm, pin, 0);
4699 EXPORT_SYMBOL_GPL(snd_soc_dapm_nc_pin_unlocked);
4702 * snd_soc_dapm_nc_pin - permanently disable pin.
4703 * @dapm: DAPM context
4706 * Marks the specified pin as being not connected, disabling it along
4707 * any parent or child widgets. At present this is identical to
4708 * snd_soc_dapm_disable_pin() but in future it will be extended to do
4709 * additional things such as disabling controls which only affect
4710 * paths through the pin.
4712 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
4713 * do any widget power switching.
4715 int snd_soc_dapm_nc_pin(struct snd_soc_dapm_context *dapm, const char *pin)
4719 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
4721 ret = snd_soc_dapm_set_pin(dapm, pin, 0);
4723 mutex_unlock(&dapm->card->dapm_mutex);
4727 EXPORT_SYMBOL_GPL(snd_soc_dapm_nc_pin);
4730 * snd_soc_dapm_get_pin_status - get audio pin status
4731 * @dapm: DAPM context
4732 * @pin: audio signal pin endpoint (or start point)
4734 * Get audio pin status - connected or disconnected.
4736 * Returns 1 for connected otherwise 0.
4738 int snd_soc_dapm_get_pin_status(struct snd_soc_dapm_context *dapm,
4741 struct snd_soc_dapm_widget *w = dapm_find_widget(dapm, pin, true);
4744 return w->connected;
4748 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_pin_status);
4751 * snd_soc_dapm_ignore_suspend - ignore suspend status for DAPM endpoint
4752 * @dapm: DAPM context
4753 * @pin: audio signal pin endpoint (or start point)
4755 * Mark the given endpoint or pin as ignoring suspend. When the
4756 * system is disabled a path between two endpoints flagged as ignoring
4757 * suspend will not be disabled. The path must already be enabled via
4758 * normal means at suspend time, it will not be turned on if it was not
4761 int snd_soc_dapm_ignore_suspend(struct snd_soc_dapm_context *dapm,
4764 struct snd_soc_dapm_widget *w = dapm_find_widget(dapm, pin, false);
4767 dev_err(dapm->dev, "ASoC: unknown pin %s\n", pin);
4771 w->ignore_suspend = 1;
4775 EXPORT_SYMBOL_GPL(snd_soc_dapm_ignore_suspend);
4778 * snd_soc_dapm_free - free dapm resources
4779 * @dapm: DAPM context
4781 * Free all dapm widgets and resources.
4783 void snd_soc_dapm_free(struct snd_soc_dapm_context *dapm)
4785 dapm_debugfs_cleanup(dapm);
4786 dapm_free_widgets(dapm);
4787 list_del(&dapm->list);
4789 EXPORT_SYMBOL_GPL(snd_soc_dapm_free);
4791 void snd_soc_dapm_init(struct snd_soc_dapm_context *dapm,
4792 struct snd_soc_card *card,
4793 struct snd_soc_component *component)
4796 dapm->component = component;
4797 dapm->bias_level = SND_SOC_BIAS_OFF;
4800 dapm->dev = component->dev;
4801 dapm->idle_bias_off = !component->driver->idle_bias_on;
4802 dapm->suspend_bias_off = component->driver->suspend_bias_off;
4804 dapm->dev = card->dev;
4807 INIT_LIST_HEAD(&dapm->list);
4808 /* see for_each_card_dapms */
4809 list_add(&dapm->list, &card->dapm_list);
4811 EXPORT_SYMBOL_GPL(snd_soc_dapm_init);
4813 static void soc_dapm_shutdown_dapm(struct snd_soc_dapm_context *dapm)
4815 struct snd_soc_card *card = dapm->card;
4816 struct snd_soc_dapm_widget *w;
4817 LIST_HEAD(down_list);
4820 mutex_lock(&card->dapm_mutex);
4822 for_each_card_widgets(dapm->card, w) {
4823 if (w->dapm != dapm)
4826 dapm_seq_insert(w, &down_list, false);
4832 /* If there were no widgets to power down we're already in
4836 if (dapm->bias_level == SND_SOC_BIAS_ON)
4837 snd_soc_dapm_set_bias_level(dapm,
4838 SND_SOC_BIAS_PREPARE);
4839 dapm_seq_run(card, &down_list, 0, false);
4840 if (dapm->bias_level == SND_SOC_BIAS_PREPARE)
4841 snd_soc_dapm_set_bias_level(dapm,
4842 SND_SOC_BIAS_STANDBY);
4845 mutex_unlock(&card->dapm_mutex);
4849 * snd_soc_dapm_shutdown - callback for system shutdown
4851 void snd_soc_dapm_shutdown(struct snd_soc_card *card)
4853 struct snd_soc_dapm_context *dapm;
4855 for_each_card_dapms(card, dapm) {
4856 if (dapm != &card->dapm) {
4857 soc_dapm_shutdown_dapm(dapm);
4858 if (dapm->bias_level == SND_SOC_BIAS_STANDBY)
4859 snd_soc_dapm_set_bias_level(dapm,
4864 soc_dapm_shutdown_dapm(&card->dapm);
4865 if (card->dapm.bias_level == SND_SOC_BIAS_STANDBY)
4866 snd_soc_dapm_set_bias_level(&card->dapm,
4870 /* Module information */
4871 MODULE_AUTHOR("Liam Girdwood, lrg@slimlogic.co.uk");
4872 MODULE_DESCRIPTION("Dynamic Audio Power Management core for ALSA SoC");
4873 MODULE_LICENSE("GPL");