2 * soc-dapm.c -- ALSA SoC Dynamic Audio Power Management
4 * Copyright 2005 Wolfson Microelectronics PLC.
5 * Author: Liam Girdwood <lrg@slimlogic.co.uk>
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License as published by the
9 * Free Software Foundation; either version 2 of the License, or (at your
10 * option) any later version.
13 * o Changes power status of internal codec blocks depending on the
14 * dynamic configuration of codec internal audio paths and active
16 * o Platform power domain - can support external components i.e. amps and
17 * mic/headphone insertion events.
18 * o Automatic Mic Bias support
19 * o Jack insertion power event initiation - e.g. hp insertion will enable
21 * o Delayed power down of audio subsystem to reduce pops between a quick
26 #include <linux/module.h>
27 #include <linux/moduleparam.h>
28 #include <linux/init.h>
29 #include <linux/async.h>
30 #include <linux/delay.h>
32 #include <linux/bitops.h>
33 #include <linux/platform_device.h>
34 #include <linux/jiffies.h>
35 #include <linux/debugfs.h>
36 #include <linux/pm_runtime.h>
37 #include <linux/regulator/consumer.h>
38 #include <linux/clk.h>
39 #include <linux/slab.h>
40 #include <sound/core.h>
41 #include <sound/pcm.h>
42 #include <sound/pcm_params.h>
43 #include <sound/soc.h>
44 #include <sound/initval.h>
46 #include <trace/events/asoc.h>
48 #define DAPM_UPDATE_STAT(widget, val) widget->dapm->card->dapm_stats.val++;
50 /* dapm power sequences - make this per codec in the future */
51 static int dapm_up_seq[] = {
52 [snd_soc_dapm_pre] = 0,
53 [snd_soc_dapm_supply] = 1,
54 [snd_soc_dapm_regulator_supply] = 1,
55 [snd_soc_dapm_clock_supply] = 1,
56 [snd_soc_dapm_micbias] = 2,
57 [snd_soc_dapm_dai_link] = 2,
58 [snd_soc_dapm_dai] = 3,
59 [snd_soc_dapm_aif_in] = 3,
60 [snd_soc_dapm_aif_out] = 3,
61 [snd_soc_dapm_mic] = 4,
62 [snd_soc_dapm_mux] = 5,
63 [snd_soc_dapm_virt_mux] = 5,
64 [snd_soc_dapm_value_mux] = 5,
65 [snd_soc_dapm_dac] = 6,
66 [snd_soc_dapm_mixer] = 7,
67 [snd_soc_dapm_mixer_named_ctl] = 7,
68 [snd_soc_dapm_pga] = 8,
69 [snd_soc_dapm_adc] = 9,
70 [snd_soc_dapm_out_drv] = 10,
71 [snd_soc_dapm_hp] = 10,
72 [snd_soc_dapm_spk] = 10,
73 [snd_soc_dapm_line] = 10,
74 [snd_soc_dapm_post] = 11,
77 static int dapm_down_seq[] = {
78 [snd_soc_dapm_pre] = 0,
79 [snd_soc_dapm_adc] = 1,
80 [snd_soc_dapm_hp] = 2,
81 [snd_soc_dapm_spk] = 2,
82 [snd_soc_dapm_line] = 2,
83 [snd_soc_dapm_out_drv] = 2,
84 [snd_soc_dapm_pga] = 4,
85 [snd_soc_dapm_mixer_named_ctl] = 5,
86 [snd_soc_dapm_mixer] = 5,
87 [snd_soc_dapm_dac] = 6,
88 [snd_soc_dapm_mic] = 7,
89 [snd_soc_dapm_micbias] = 8,
90 [snd_soc_dapm_mux] = 9,
91 [snd_soc_dapm_virt_mux] = 9,
92 [snd_soc_dapm_value_mux] = 9,
93 [snd_soc_dapm_aif_in] = 10,
94 [snd_soc_dapm_aif_out] = 10,
95 [snd_soc_dapm_dai] = 10,
96 [snd_soc_dapm_dai_link] = 11,
97 [snd_soc_dapm_clock_supply] = 12,
98 [snd_soc_dapm_regulator_supply] = 12,
99 [snd_soc_dapm_supply] = 12,
100 [snd_soc_dapm_post] = 13,
103 static void pop_wait(u32 pop_time)
106 schedule_timeout_uninterruptible(msecs_to_jiffies(pop_time));
109 static void pop_dbg(struct device *dev, u32 pop_time, const char *fmt, ...)
117 buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
122 vsnprintf(buf, PAGE_SIZE, fmt, args);
123 dev_info(dev, "%s", buf);
129 static bool dapm_dirty_widget(struct snd_soc_dapm_widget *w)
131 return !list_empty(&w->dirty);
134 void dapm_mark_dirty(struct snd_soc_dapm_widget *w, const char *reason)
136 if (!dapm_dirty_widget(w)) {
137 dev_vdbg(w->dapm->dev, "Marking %s dirty due to %s\n",
139 list_add_tail(&w->dirty, &w->dapm->card->dapm_dirty);
142 EXPORT_SYMBOL_GPL(dapm_mark_dirty);
144 /* create a new dapm widget */
145 static inline struct snd_soc_dapm_widget *dapm_cnew_widget(
146 const struct snd_soc_dapm_widget *_widget)
148 return kmemdup(_widget, sizeof(*_widget), GFP_KERNEL);
151 /* get snd_card from DAPM context */
152 static inline struct snd_card *dapm_get_snd_card(
153 struct snd_soc_dapm_context *dapm)
156 return dapm->codec->card->snd_card;
157 else if (dapm->platform)
158 return dapm->platform->card->snd_card;
166 /* get soc_card from DAPM context */
167 static inline struct snd_soc_card *dapm_get_soc_card(
168 struct snd_soc_dapm_context *dapm)
171 return dapm->codec->card;
172 else if (dapm->platform)
173 return dapm->platform->card;
181 static void dapm_reset(struct snd_soc_card *card)
183 struct snd_soc_dapm_widget *w;
185 memset(&card->dapm_stats, 0, sizeof(card->dapm_stats));
187 list_for_each_entry(w, &card->widgets, list) {
188 w->power_checked = false;
194 static int soc_widget_read(struct snd_soc_dapm_widget *w, int reg)
197 return snd_soc_read(w->codec, reg);
198 else if (w->platform)
199 return snd_soc_platform_read(w->platform, reg);
201 dev_err(w->dapm->dev, "no valid widget read method\n");
205 static int soc_widget_write(struct snd_soc_dapm_widget *w, int reg, int val)
208 return snd_soc_write(w->codec, reg, val);
209 else if (w->platform)
210 return snd_soc_platform_write(w->platform, reg, val);
212 dev_err(w->dapm->dev, "no valid widget write method\n");
216 static inline void soc_widget_lock(struct snd_soc_dapm_widget *w)
218 if (w->codec && !w->codec->using_regmap)
219 mutex_lock(&w->codec->mutex);
220 else if (w->platform)
221 mutex_lock(&w->platform->mutex);
224 static inline void soc_widget_unlock(struct snd_soc_dapm_widget *w)
226 if (w->codec && !w->codec->using_regmap)
227 mutex_unlock(&w->codec->mutex);
228 else if (w->platform)
229 mutex_unlock(&w->platform->mutex);
232 static int soc_widget_update_bits_locked(struct snd_soc_dapm_widget *w,
233 unsigned short reg, unsigned int mask, unsigned int value)
236 unsigned int old, new;
239 if (w->codec && w->codec->using_regmap) {
240 ret = regmap_update_bits_check(w->codec->control_data,
241 reg, mask, value, &change);
246 ret = soc_widget_read(w, reg);
248 soc_widget_unlock(w);
253 new = (old & ~mask) | (value & mask);
256 ret = soc_widget_write(w, reg, new);
258 soc_widget_unlock(w);
262 soc_widget_unlock(w);
269 * snd_soc_dapm_set_bias_level - set the bias level for the system
270 * @dapm: DAPM context
271 * @level: level to configure
273 * Configure the bias (power) levels for the SoC audio device.
275 * Returns 0 for success else error.
277 static int snd_soc_dapm_set_bias_level(struct snd_soc_dapm_context *dapm,
278 enum snd_soc_bias_level level)
280 struct snd_soc_card *card = dapm->card;
283 trace_snd_soc_bias_level_start(card, level);
285 if (card && card->set_bias_level)
286 ret = card->set_bias_level(card, dapm, level);
291 if (dapm->codec->driver->set_bias_level)
292 ret = dapm->codec->driver->set_bias_level(dapm->codec,
295 dapm->bias_level = level;
300 if (card && card->set_bias_level_post)
301 ret = card->set_bias_level_post(card, dapm, level);
303 trace_snd_soc_bias_level_done(card, level);
308 /* set up initial codec paths */
309 static void dapm_set_path_status(struct snd_soc_dapm_widget *w,
310 struct snd_soc_dapm_path *p, int i)
313 case snd_soc_dapm_switch:
314 case snd_soc_dapm_mixer:
315 case snd_soc_dapm_mixer_named_ctl: {
317 struct soc_mixer_control *mc = (struct soc_mixer_control *)
318 w->kcontrol_news[i].private_value;
319 unsigned int reg = mc->reg;
320 unsigned int shift = mc->shift;
322 unsigned int mask = (1 << fls(max)) - 1;
323 unsigned int invert = mc->invert;
325 val = soc_widget_read(w, reg);
326 val = (val >> shift) & mask;
328 if ((invert && !val) || (!invert && val))
334 case snd_soc_dapm_mux: {
335 struct soc_enum *e = (struct soc_enum *)
336 w->kcontrol_news[i].private_value;
337 int val, item, bitmask;
339 for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
341 val = soc_widget_read(w, e->reg);
342 item = (val >> e->shift_l) & (bitmask - 1);
345 for (i = 0; i < e->max; i++) {
346 if (!(strcmp(p->name, e->texts[i])) && item == i)
351 case snd_soc_dapm_virt_mux: {
352 struct soc_enum *e = (struct soc_enum *)
353 w->kcontrol_news[i].private_value;
356 /* since a virtual mux has no backing registers to
357 * decide which path to connect, it will try to match
358 * with the first enumeration. This is to ensure
359 * that the default mux choice (the first) will be
360 * correctly powered up during initialization.
362 if (!strcmp(p->name, e->texts[0]))
366 case snd_soc_dapm_value_mux: {
367 struct soc_enum *e = (struct soc_enum *)
368 w->kcontrol_news[i].private_value;
371 val = soc_widget_read(w, e->reg);
372 val = (val >> e->shift_l) & e->mask;
373 for (item = 0; item < e->max; item++) {
374 if (val == e->values[item])
379 for (i = 0; i < e->max; i++) {
380 if (!(strcmp(p->name, e->texts[i])) && item == i)
385 /* does not affect routing - always connected */
386 case snd_soc_dapm_pga:
387 case snd_soc_dapm_out_drv:
388 case snd_soc_dapm_output:
389 case snd_soc_dapm_adc:
390 case snd_soc_dapm_input:
391 case snd_soc_dapm_siggen:
392 case snd_soc_dapm_dac:
393 case snd_soc_dapm_micbias:
394 case snd_soc_dapm_vmid:
395 case snd_soc_dapm_supply:
396 case snd_soc_dapm_regulator_supply:
397 case snd_soc_dapm_clock_supply:
398 case snd_soc_dapm_aif_in:
399 case snd_soc_dapm_aif_out:
400 case snd_soc_dapm_dai:
401 case snd_soc_dapm_hp:
402 case snd_soc_dapm_mic:
403 case snd_soc_dapm_spk:
404 case snd_soc_dapm_line:
405 case snd_soc_dapm_dai_link:
408 /* does affect routing - dynamically connected */
409 case snd_soc_dapm_pre:
410 case snd_soc_dapm_post:
416 /* connect mux widget to its interconnecting audio paths */
417 static int dapm_connect_mux(struct snd_soc_dapm_context *dapm,
418 struct snd_soc_dapm_widget *src, struct snd_soc_dapm_widget *dest,
419 struct snd_soc_dapm_path *path, const char *control_name,
420 const struct snd_kcontrol_new *kcontrol)
422 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
425 for (i = 0; i < e->max; i++) {
426 if (!(strcmp(control_name, e->texts[i]))) {
427 list_add(&path->list, &dapm->card->paths);
428 list_add(&path->list_sink, &dest->sources);
429 list_add(&path->list_source, &src->sinks);
430 path->name = (char*)e->texts[i];
431 dapm_set_path_status(dest, path, 0);
439 /* connect mixer widget to its interconnecting audio paths */
440 static int dapm_connect_mixer(struct snd_soc_dapm_context *dapm,
441 struct snd_soc_dapm_widget *src, struct snd_soc_dapm_widget *dest,
442 struct snd_soc_dapm_path *path, const char *control_name)
446 /* search for mixer kcontrol */
447 for (i = 0; i < dest->num_kcontrols; i++) {
448 if (!strcmp(control_name, dest->kcontrol_news[i].name)) {
449 list_add(&path->list, &dapm->card->paths);
450 list_add(&path->list_sink, &dest->sources);
451 list_add(&path->list_source, &src->sinks);
452 path->name = dest->kcontrol_news[i].name;
453 dapm_set_path_status(dest, path, i);
460 static int dapm_is_shared_kcontrol(struct snd_soc_dapm_context *dapm,
461 struct snd_soc_dapm_widget *kcontrolw,
462 const struct snd_kcontrol_new *kcontrol_new,
463 struct snd_kcontrol **kcontrol)
465 struct snd_soc_dapm_widget *w;
470 list_for_each_entry(w, &dapm->card->widgets, list) {
471 if (w == kcontrolw || w->dapm != kcontrolw->dapm)
473 for (i = 0; i < w->num_kcontrols; i++) {
474 if (&w->kcontrol_news[i] == kcontrol_new) {
476 *kcontrol = w->kcontrols[i];
485 /* create new dapm mixer control */
486 static int dapm_new_mixer(struct snd_soc_dapm_widget *w)
488 struct snd_soc_dapm_context *dapm = w->dapm;
490 size_t name_len, prefix_len;
491 struct snd_soc_dapm_path *path;
492 struct snd_card *card = dapm->card->snd_card;
494 struct snd_soc_dapm_widget_list *wlist;
498 prefix = dapm->codec->name_prefix;
503 prefix_len = strlen(prefix) + 1;
508 for (i = 0; i < w->num_kcontrols; i++) {
511 list_for_each_entry(path, &w->sources, list_sink) {
513 /* mixer/mux paths name must match control name */
514 if (path->name != (char *)w->kcontrol_news[i].name)
517 if (w->kcontrols[i]) {
518 path->kcontrol = w->kcontrols[i];
522 wlistsize = sizeof(struct snd_soc_dapm_widget_list) +
523 sizeof(struct snd_soc_dapm_widget *),
524 wlist = kzalloc(wlistsize, GFP_KERNEL);
527 "asoc: can't allocate widget list for %s\n",
531 wlist->num_widgets = 1;
532 wlist->widgets[0] = w;
534 /* add dapm control with long name.
535 * for dapm_mixer this is the concatenation of the
536 * mixer and kcontrol name.
537 * for dapm_mixer_named_ctl this is simply the
540 name_len = strlen(w->kcontrol_news[i].name) + 1;
541 if (w->id != snd_soc_dapm_mixer_named_ctl)
542 name_len += 1 + strlen(w->name);
544 path->long_name = kmalloc(name_len, GFP_KERNEL);
546 if (path->long_name == NULL) {
553 /* The control will get a prefix from
554 * the control creation process but
555 * we're also using the same prefix
556 * for widgets so cut the prefix off
557 * the front of the widget name.
559 snprintf((char *)path->long_name, name_len,
560 "%s %s", w->name + prefix_len,
561 w->kcontrol_news[i].name);
563 case snd_soc_dapm_mixer_named_ctl:
564 snprintf((char *)path->long_name, name_len,
565 "%s", w->kcontrol_news[i].name);
569 ((char *)path->long_name)[name_len - 1] = '\0';
571 path->kcontrol = snd_soc_cnew(&w->kcontrol_news[i],
572 wlist, path->long_name,
574 ret = snd_ctl_add(card, path->kcontrol);
577 "asoc: failed to add dapm kcontrol %s: %d\n",
578 path->long_name, ret);
580 kfree(path->long_name);
581 path->long_name = NULL;
584 w->kcontrols[i] = path->kcontrol;
590 /* create new dapm mux control */
591 static int dapm_new_mux(struct snd_soc_dapm_widget *w)
593 struct snd_soc_dapm_context *dapm = w->dapm;
594 struct snd_soc_dapm_path *path = NULL;
595 struct snd_kcontrol *kcontrol;
596 struct snd_card *card = dapm->card->snd_card;
600 struct snd_soc_dapm_widget_list *wlist;
601 int shared, wlistentries;
605 if (w->num_kcontrols != 1) {
607 "asoc: mux %s has incorrect number of controls\n",
612 shared = dapm_is_shared_kcontrol(dapm, w, &w->kcontrol_news[0],
615 wlist = kcontrol->private_data;
616 wlistentries = wlist->num_widgets + 1;
621 wlistsize = sizeof(struct snd_soc_dapm_widget_list) +
622 wlistentries * sizeof(struct snd_soc_dapm_widget *),
623 wlist = krealloc(wlist, wlistsize, GFP_KERNEL);
626 "asoc: can't allocate widget list for %s\n", w->name);
629 wlist->num_widgets = wlistentries;
630 wlist->widgets[wlistentries - 1] = w;
634 prefix = dapm->codec->name_prefix;
639 name = w->kcontrol_news[0].name;
644 prefix_len = strlen(prefix) + 1;
650 * The control will get a prefix from the control creation
651 * process but we're also using the same prefix for widgets so
652 * cut the prefix off the front of the widget name.
654 kcontrol = snd_soc_cnew(&w->kcontrol_news[0], wlist,
655 name + prefix_len, prefix);
656 ret = snd_ctl_add(card, kcontrol);
658 dev_err(dapm->dev, "failed to add kcontrol %s: %d\n",
665 kcontrol->private_data = wlist;
667 w->kcontrols[0] = kcontrol;
669 list_for_each_entry(path, &w->sources, list_sink)
670 path->kcontrol = kcontrol;
675 /* create new dapm volume control */
676 static int dapm_new_pga(struct snd_soc_dapm_widget *w)
678 if (w->num_kcontrols)
679 dev_err(w->dapm->dev,
680 "asoc: PGA controls not supported: '%s'\n", w->name);
685 /* reset 'walked' bit for each dapm path */
686 static inline void dapm_clear_walk(struct snd_soc_dapm_context *dapm)
688 struct snd_soc_dapm_path *p;
690 list_for_each_entry(p, &dapm->card->paths, list)
694 /* We implement power down on suspend by checking the power state of
695 * the ALSA card - when we are suspending the ALSA state for the card
698 static int snd_soc_dapm_suspend_check(struct snd_soc_dapm_widget *widget)
700 int level = snd_power_get_state(widget->dapm->card->snd_card);
703 case SNDRV_CTL_POWER_D3hot:
704 case SNDRV_CTL_POWER_D3cold:
705 if (widget->ignore_suspend)
706 dev_dbg(widget->dapm->dev, "%s ignoring suspend\n",
708 return widget->ignore_suspend;
714 /* add widget to list if it's not already in the list */
715 static int dapm_list_add_widget(struct snd_soc_dapm_widget_list **list,
716 struct snd_soc_dapm_widget *w)
718 struct snd_soc_dapm_widget_list *wlist;
719 int wlistsize, wlistentries, i;
726 /* is this widget already in the list */
727 for (i = 0; i < wlist->num_widgets; i++) {
728 if (wlist->widgets[i] == w)
732 /* allocate some new space */
733 wlistentries = wlist->num_widgets + 1;
734 wlistsize = sizeof(struct snd_soc_dapm_widget_list) +
735 wlistentries * sizeof(struct snd_soc_dapm_widget *);
736 *list = krealloc(wlist, wlistsize, GFP_KERNEL);
738 dev_err(w->dapm->dev, "can't allocate widget list for %s\n",
744 /* insert the widget */
745 dev_dbg(w->dapm->dev, "added %s in widget list pos %d\n",
746 w->name, wlist->num_widgets);
748 wlist->widgets[wlist->num_widgets] = w;
749 wlist->num_widgets++;
754 * Recursively check for a completed path to an active or physically connected
755 * output widget. Returns number of complete paths.
757 static int is_connected_output_ep(struct snd_soc_dapm_widget *widget,
758 struct snd_soc_dapm_widget_list **list)
760 struct snd_soc_dapm_path *path;
763 if (widget->outputs >= 0)
764 return widget->outputs;
766 DAPM_UPDATE_STAT(widget, path_checks);
768 switch (widget->id) {
769 case snd_soc_dapm_supply:
770 case snd_soc_dapm_regulator_supply:
771 case snd_soc_dapm_clock_supply:
777 switch (widget->id) {
778 case snd_soc_dapm_adc:
779 case snd_soc_dapm_aif_out:
780 case snd_soc_dapm_dai:
781 if (widget->active) {
782 widget->outputs = snd_soc_dapm_suspend_check(widget);
783 return widget->outputs;
789 if (widget->connected) {
790 /* connected pin ? */
791 if (widget->id == snd_soc_dapm_output && !widget->ext) {
792 widget->outputs = snd_soc_dapm_suspend_check(widget);
793 return widget->outputs;
796 /* connected jack or spk ? */
797 if (widget->id == snd_soc_dapm_hp ||
798 widget->id == snd_soc_dapm_spk ||
799 (widget->id == snd_soc_dapm_line &&
800 !list_empty(&widget->sources))) {
801 widget->outputs = snd_soc_dapm_suspend_check(widget);
802 return widget->outputs;
806 list_for_each_entry(path, &widget->sinks, list_source) {
807 DAPM_UPDATE_STAT(widget, neighbour_checks);
815 trace_snd_soc_dapm_output_path(widget, path);
817 if (path->sink && path->connect) {
820 /* do we need to add this widget to the list ? */
823 err = dapm_list_add_widget(list, path->sink);
825 dev_err(widget->dapm->dev, "could not add widget %s\n",
831 con += is_connected_output_ep(path->sink, list);
835 widget->outputs = con;
841 * Recursively check for a completed path to an active or physically connected
842 * input widget. Returns number of complete paths.
844 static int is_connected_input_ep(struct snd_soc_dapm_widget *widget,
845 struct snd_soc_dapm_widget_list **list)
847 struct snd_soc_dapm_path *path;
850 if (widget->inputs >= 0)
851 return widget->inputs;
853 DAPM_UPDATE_STAT(widget, path_checks);
855 switch (widget->id) {
856 case snd_soc_dapm_supply:
857 case snd_soc_dapm_regulator_supply:
858 case snd_soc_dapm_clock_supply:
864 /* active stream ? */
865 switch (widget->id) {
866 case snd_soc_dapm_dac:
867 case snd_soc_dapm_aif_in:
868 case snd_soc_dapm_dai:
869 if (widget->active) {
870 widget->inputs = snd_soc_dapm_suspend_check(widget);
871 return widget->inputs;
877 if (widget->connected) {
878 /* connected pin ? */
879 if (widget->id == snd_soc_dapm_input && !widget->ext) {
880 widget->inputs = snd_soc_dapm_suspend_check(widget);
881 return widget->inputs;
884 /* connected VMID/Bias for lower pops */
885 if (widget->id == snd_soc_dapm_vmid) {
886 widget->inputs = snd_soc_dapm_suspend_check(widget);
887 return widget->inputs;
890 /* connected jack ? */
891 if (widget->id == snd_soc_dapm_mic ||
892 (widget->id == snd_soc_dapm_line &&
893 !list_empty(&widget->sinks))) {
894 widget->inputs = snd_soc_dapm_suspend_check(widget);
895 return widget->inputs;
898 /* signal generator */
899 if (widget->id == snd_soc_dapm_siggen) {
900 widget->inputs = snd_soc_dapm_suspend_check(widget);
901 return widget->inputs;
905 list_for_each_entry(path, &widget->sources, list_sink) {
906 DAPM_UPDATE_STAT(widget, neighbour_checks);
914 trace_snd_soc_dapm_input_path(widget, path);
916 if (path->source && path->connect) {
919 /* do we need to add this widget to the list ? */
922 err = dapm_list_add_widget(list, path->source);
924 dev_err(widget->dapm->dev, "could not add widget %s\n",
930 con += is_connected_input_ep(path->source, list);
934 widget->inputs = con;
940 * snd_soc_dapm_get_connected_widgets - query audio path and it's widgets.
942 * @stream: stream direction.
943 * @list: list of active widgets for this stream.
945 * Queries DAPM graph as to whether an valid audio stream path exists for
946 * the initial stream specified by name. This takes into account
947 * current mixer and mux kcontrol settings. Creates list of valid widgets.
949 * Returns the number of valid paths or negative error.
951 int snd_soc_dapm_dai_get_connected_widgets(struct snd_soc_dai *dai, int stream,
952 struct snd_soc_dapm_widget_list **list)
954 struct snd_soc_card *card = dai->card;
957 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
960 if (stream == SNDRV_PCM_STREAM_PLAYBACK)
961 paths = is_connected_output_ep(dai->playback_widget, list);
963 paths = is_connected_input_ep(dai->capture_widget, list);
965 trace_snd_soc_dapm_connected(paths, stream);
966 dapm_clear_walk(&card->dapm);
967 mutex_unlock(&card->dapm_mutex);
973 * Handler for generic register modifier widget.
975 int dapm_reg_event(struct snd_soc_dapm_widget *w,
976 struct snd_kcontrol *kcontrol, int event)
980 if (SND_SOC_DAPM_EVENT_ON(event))
985 soc_widget_update_bits_locked(w, -(w->reg + 1),
986 w->mask << w->shift, val << w->shift);
990 EXPORT_SYMBOL_GPL(dapm_reg_event);
993 * Handler for regulator supply widget.
995 int dapm_regulator_event(struct snd_soc_dapm_widget *w,
996 struct snd_kcontrol *kcontrol, int event)
998 if (SND_SOC_DAPM_EVENT_ON(event))
999 return regulator_enable(w->regulator);
1001 return regulator_disable_deferred(w->regulator, w->shift);
1003 EXPORT_SYMBOL_GPL(dapm_regulator_event);
1006 * Handler for clock supply widget.
1008 int dapm_clock_event(struct snd_soc_dapm_widget *w,
1009 struct snd_kcontrol *kcontrol, int event)
1014 #ifdef CONFIG_HAVE_CLK
1015 if (SND_SOC_DAPM_EVENT_ON(event)) {
1016 return clk_enable(w->clk);
1018 clk_disable(w->clk);
1024 EXPORT_SYMBOL_GPL(dapm_clock_event);
1026 static int dapm_widget_power_check(struct snd_soc_dapm_widget *w)
1028 if (w->power_checked)
1029 return w->new_power;
1034 w->new_power = w->power_check(w);
1036 w->power_checked = true;
1038 return w->new_power;
1041 /* Generic check to see if a widget should be powered.
1043 static int dapm_generic_check_power(struct snd_soc_dapm_widget *w)
1047 DAPM_UPDATE_STAT(w, power_checks);
1049 in = is_connected_input_ep(w, NULL);
1050 dapm_clear_walk(w->dapm);
1051 out = is_connected_output_ep(w, NULL);
1052 dapm_clear_walk(w->dapm);
1053 return out != 0 && in != 0;
1056 static int dapm_dai_check_power(struct snd_soc_dapm_widget *w)
1058 DAPM_UPDATE_STAT(w, power_checks);
1063 return dapm_generic_check_power(w);
1066 /* Check to see if an ADC has power */
1067 static int dapm_adc_check_power(struct snd_soc_dapm_widget *w)
1071 DAPM_UPDATE_STAT(w, power_checks);
1074 in = is_connected_input_ep(w, NULL);
1075 dapm_clear_walk(w->dapm);
1078 return dapm_generic_check_power(w);
1082 /* Check to see if a DAC has power */
1083 static int dapm_dac_check_power(struct snd_soc_dapm_widget *w)
1087 DAPM_UPDATE_STAT(w, power_checks);
1090 out = is_connected_output_ep(w, NULL);
1091 dapm_clear_walk(w->dapm);
1094 return dapm_generic_check_power(w);
1098 /* Check to see if a power supply is needed */
1099 static int dapm_supply_check_power(struct snd_soc_dapm_widget *w)
1101 struct snd_soc_dapm_path *path;
1103 DAPM_UPDATE_STAT(w, power_checks);
1105 /* Check if one of our outputs is connected */
1106 list_for_each_entry(path, &w->sinks, list_source) {
1107 DAPM_UPDATE_STAT(w, neighbour_checks);
1112 if (path->connected &&
1113 !path->connected(path->source, path->sink))
1119 if (dapm_widget_power_check(path->sink))
1123 dapm_clear_walk(w->dapm);
1128 static int dapm_always_on_check_power(struct snd_soc_dapm_widget *w)
1133 static int dapm_seq_compare(struct snd_soc_dapm_widget *a,
1134 struct snd_soc_dapm_widget *b,
1142 sort = dapm_down_seq;
1144 if (sort[a->id] != sort[b->id])
1145 return sort[a->id] - sort[b->id];
1146 if (a->subseq != b->subseq) {
1148 return a->subseq - b->subseq;
1150 return b->subseq - a->subseq;
1152 if (a->reg != b->reg)
1153 return a->reg - b->reg;
1154 if (a->dapm != b->dapm)
1155 return (unsigned long)a->dapm - (unsigned long)b->dapm;
1160 /* Insert a widget in order into a DAPM power sequence. */
1161 static void dapm_seq_insert(struct snd_soc_dapm_widget *new_widget,
1162 struct list_head *list,
1165 struct snd_soc_dapm_widget *w;
1167 list_for_each_entry(w, list, power_list)
1168 if (dapm_seq_compare(new_widget, w, power_up) < 0) {
1169 list_add_tail(&new_widget->power_list, &w->power_list);
1173 list_add_tail(&new_widget->power_list, list);
1176 static void dapm_seq_check_event(struct snd_soc_dapm_context *dapm,
1177 struct snd_soc_dapm_widget *w, int event)
1179 struct snd_soc_card *card = dapm->card;
1180 const char *ev_name;
1184 case SND_SOC_DAPM_PRE_PMU:
1185 ev_name = "PRE_PMU";
1188 case SND_SOC_DAPM_POST_PMU:
1189 ev_name = "POST_PMU";
1192 case SND_SOC_DAPM_PRE_PMD:
1193 ev_name = "PRE_PMD";
1196 case SND_SOC_DAPM_POST_PMD:
1197 ev_name = "POST_PMD";
1205 if (w->power != power)
1208 if (w->event && (w->event_flags & event)) {
1209 pop_dbg(dapm->dev, card->pop_time, "pop test : %s %s\n",
1211 trace_snd_soc_dapm_widget_event_start(w, event);
1212 ret = w->event(w, NULL, event);
1213 trace_snd_soc_dapm_widget_event_done(w, event);
1215 pr_err("%s: %s event failed: %d\n",
1216 ev_name, w->name, ret);
1220 /* Apply the coalesced changes from a DAPM sequence */
1221 static void dapm_seq_run_coalesced(struct snd_soc_dapm_context *dapm,
1222 struct list_head *pending)
1224 struct snd_soc_card *card = dapm->card;
1225 struct snd_soc_dapm_widget *w;
1227 unsigned int value = 0;
1228 unsigned int mask = 0;
1229 unsigned int cur_mask;
1231 reg = list_first_entry(pending, struct snd_soc_dapm_widget,
1234 list_for_each_entry(w, pending, power_list) {
1235 cur_mask = 1 << w->shift;
1236 BUG_ON(reg != w->reg);
1247 pop_dbg(dapm->dev, card->pop_time,
1248 "pop test : Queue %s: reg=0x%x, 0x%x/0x%x\n",
1249 w->name, reg, value, mask);
1251 /* Check for events */
1252 dapm_seq_check_event(dapm, w, SND_SOC_DAPM_PRE_PMU);
1253 dapm_seq_check_event(dapm, w, SND_SOC_DAPM_PRE_PMD);
1257 /* Any widget will do, they should all be updating the
1260 w = list_first_entry(pending, struct snd_soc_dapm_widget,
1263 pop_dbg(dapm->dev, card->pop_time,
1264 "pop test : Applying 0x%x/0x%x to %x in %dms\n",
1265 value, mask, reg, card->pop_time);
1266 pop_wait(card->pop_time);
1267 soc_widget_update_bits_locked(w, reg, mask, value);
1270 list_for_each_entry(w, pending, power_list) {
1271 dapm_seq_check_event(dapm, w, SND_SOC_DAPM_POST_PMU);
1272 dapm_seq_check_event(dapm, w, SND_SOC_DAPM_POST_PMD);
1276 /* Apply a DAPM power sequence.
1278 * We walk over a pre-sorted list of widgets to apply power to. In
1279 * order to minimise the number of writes to the device required
1280 * multiple widgets will be updated in a single write where possible.
1281 * Currently anything that requires more than a single write is not
1284 static void dapm_seq_run(struct snd_soc_dapm_context *dapm,
1285 struct list_head *list, int event, bool power_up)
1287 struct snd_soc_dapm_widget *w, *n;
1290 int cur_subseq = -1;
1291 int cur_reg = SND_SOC_NOPM;
1292 struct snd_soc_dapm_context *cur_dapm = NULL;
1299 sort = dapm_down_seq;
1301 list_for_each_entry_safe(w, n, list, power_list) {
1304 /* Do we need to apply any queued changes? */
1305 if (sort[w->id] != cur_sort || w->reg != cur_reg ||
1306 w->dapm != cur_dapm || w->subseq != cur_subseq) {
1307 if (!list_empty(&pending))
1308 dapm_seq_run_coalesced(cur_dapm, &pending);
1310 if (cur_dapm && cur_dapm->seq_notifier) {
1311 for (i = 0; i < ARRAY_SIZE(dapm_up_seq); i++)
1312 if (sort[i] == cur_sort)
1313 cur_dapm->seq_notifier(cur_dapm,
1318 INIT_LIST_HEAD(&pending);
1320 cur_subseq = INT_MIN;
1321 cur_reg = SND_SOC_NOPM;
1326 case snd_soc_dapm_pre:
1328 list_for_each_entry_safe_continue(w, n, list,
1331 if (event == SND_SOC_DAPM_STREAM_START)
1333 NULL, SND_SOC_DAPM_PRE_PMU);
1334 else if (event == SND_SOC_DAPM_STREAM_STOP)
1336 NULL, SND_SOC_DAPM_PRE_PMD);
1339 case snd_soc_dapm_post:
1341 list_for_each_entry_safe_continue(w, n, list,
1344 if (event == SND_SOC_DAPM_STREAM_START)
1346 NULL, SND_SOC_DAPM_POST_PMU);
1347 else if (event == SND_SOC_DAPM_STREAM_STOP)
1349 NULL, SND_SOC_DAPM_POST_PMD);
1353 /* Queue it up for application */
1354 cur_sort = sort[w->id];
1355 cur_subseq = w->subseq;
1358 list_move(&w->power_list, &pending);
1363 dev_err(w->dapm->dev,
1364 "Failed to apply widget power: %d\n", ret);
1367 if (!list_empty(&pending))
1368 dapm_seq_run_coalesced(cur_dapm, &pending);
1370 if (cur_dapm && cur_dapm->seq_notifier) {
1371 for (i = 0; i < ARRAY_SIZE(dapm_up_seq); i++)
1372 if (sort[i] == cur_sort)
1373 cur_dapm->seq_notifier(cur_dapm,
1378 static void dapm_widget_update(struct snd_soc_dapm_context *dapm)
1380 struct snd_soc_dapm_update *update = dapm->update;
1381 struct snd_soc_dapm_widget *w;
1390 (w->event_flags & SND_SOC_DAPM_PRE_REG)) {
1391 ret = w->event(w, update->kcontrol, SND_SOC_DAPM_PRE_REG);
1393 pr_err("%s DAPM pre-event failed: %d\n",
1397 ret = soc_widget_update_bits_locked(w, update->reg, update->mask,
1400 pr_err("%s DAPM update failed: %d\n", w->name, ret);
1403 (w->event_flags & SND_SOC_DAPM_POST_REG)) {
1404 ret = w->event(w, update->kcontrol, SND_SOC_DAPM_POST_REG);
1406 pr_err("%s DAPM post-event failed: %d\n",
1411 /* Async callback run prior to DAPM sequences - brings to _PREPARE if
1412 * they're changing state.
1414 static void dapm_pre_sequence_async(void *data, async_cookie_t cookie)
1416 struct snd_soc_dapm_context *d = data;
1419 /* If we're off and we're not supposed to be go into STANDBY */
1420 if (d->bias_level == SND_SOC_BIAS_OFF &&
1421 d->target_bias_level != SND_SOC_BIAS_OFF) {
1423 pm_runtime_get_sync(d->dev);
1425 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_STANDBY);
1428 "Failed to turn on bias: %d\n", ret);
1431 /* Prepare for a STADDBY->ON or ON->STANDBY transition */
1432 if (d->bias_level != d->target_bias_level) {
1433 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_PREPARE);
1436 "Failed to prepare bias: %d\n", ret);
1440 /* Async callback run prior to DAPM sequences - brings to their final
1443 static void dapm_post_sequence_async(void *data, async_cookie_t cookie)
1445 struct snd_soc_dapm_context *d = data;
1448 /* If we just powered the last thing off drop to standby bias */
1449 if (d->bias_level == SND_SOC_BIAS_PREPARE &&
1450 (d->target_bias_level == SND_SOC_BIAS_STANDBY ||
1451 d->target_bias_level == SND_SOC_BIAS_OFF)) {
1452 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_STANDBY);
1454 dev_err(d->dev, "Failed to apply standby bias: %d\n",
1458 /* If we're in standby and can support bias off then do that */
1459 if (d->bias_level == SND_SOC_BIAS_STANDBY &&
1460 d->target_bias_level == SND_SOC_BIAS_OFF) {
1461 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_OFF);
1463 dev_err(d->dev, "Failed to turn off bias: %d\n", ret);
1466 pm_runtime_put(d->dev);
1469 /* If we just powered up then move to active bias */
1470 if (d->bias_level == SND_SOC_BIAS_PREPARE &&
1471 d->target_bias_level == SND_SOC_BIAS_ON) {
1472 ret = snd_soc_dapm_set_bias_level(d, SND_SOC_BIAS_ON);
1474 dev_err(d->dev, "Failed to apply active bias: %d\n",
1479 static void dapm_widget_set_peer_power(struct snd_soc_dapm_widget *peer,
1480 bool power, bool connect)
1482 /* If a connection is being made or broken then that update
1483 * will have marked the peer dirty, otherwise the widgets are
1484 * not connected and this update has no impact. */
1488 /* If the peer is already in the state we're moving to then we
1489 * won't have an impact on it. */
1490 if (power != peer->power)
1491 dapm_mark_dirty(peer, "peer state change");
1494 static void dapm_widget_set_power(struct snd_soc_dapm_widget *w, bool power,
1495 struct list_head *up_list,
1496 struct list_head *down_list)
1498 struct snd_soc_dapm_path *path;
1500 if (w->power == power)
1503 trace_snd_soc_dapm_widget_power(w, power);
1505 /* If we changed our power state perhaps our neigbours changed
1508 list_for_each_entry(path, &w->sources, list_sink) {
1510 dapm_widget_set_peer_power(path->source, power,
1515 case snd_soc_dapm_supply:
1516 case snd_soc_dapm_regulator_supply:
1517 case snd_soc_dapm_clock_supply:
1518 /* Supplies can't affect their outputs, only their inputs */
1521 list_for_each_entry(path, &w->sinks, list_source) {
1523 dapm_widget_set_peer_power(path->sink, power,
1531 dapm_seq_insert(w, up_list, true);
1533 dapm_seq_insert(w, down_list, false);
1538 static void dapm_power_one_widget(struct snd_soc_dapm_widget *w,
1539 struct list_head *up_list,
1540 struct list_head *down_list)
1545 case snd_soc_dapm_pre:
1546 dapm_seq_insert(w, down_list, false);
1548 case snd_soc_dapm_post:
1549 dapm_seq_insert(w, up_list, true);
1553 power = dapm_widget_power_check(w);
1555 dapm_widget_set_power(w, power, up_list, down_list);
1561 * Scan each dapm widget for complete audio path.
1562 * A complete path is a route that has valid endpoints i.e.:-
1564 * o DAC to output pin.
1565 * o Input Pin to ADC.
1566 * o Input pin to Output pin (bypass, sidetone)
1567 * o DAC to ADC (loopback).
1569 static int dapm_power_widgets(struct snd_soc_dapm_context *dapm, int event)
1571 struct snd_soc_card *card = dapm->card;
1572 struct snd_soc_dapm_widget *w;
1573 struct snd_soc_dapm_context *d;
1575 LIST_HEAD(down_list);
1576 LIST_HEAD(async_domain);
1577 enum snd_soc_bias_level bias;
1579 trace_snd_soc_dapm_start(card);
1581 list_for_each_entry(d, &card->dapm_list, list) {
1582 if (d->idle_bias_off)
1583 d->target_bias_level = SND_SOC_BIAS_OFF;
1585 d->target_bias_level = SND_SOC_BIAS_STANDBY;
1590 /* Check which widgets we need to power and store them in
1591 * lists indicating if they should be powered up or down. We
1592 * only check widgets that have been flagged as dirty but note
1593 * that new widgets may be added to the dirty list while we
1596 list_for_each_entry(w, &card->dapm_dirty, dirty) {
1597 dapm_power_one_widget(w, &up_list, &down_list);
1600 list_for_each_entry(w, &card->widgets, list) {
1601 list_del_init(&w->dirty);
1606 /* Supplies and micbiases only bring the
1607 * context up to STANDBY as unless something
1608 * else is active and passing audio they
1609 * generally don't require full power. Signal
1610 * generators are virtual pins and have no
1611 * power impact themselves.
1614 case snd_soc_dapm_siggen:
1616 case snd_soc_dapm_supply:
1617 case snd_soc_dapm_regulator_supply:
1618 case snd_soc_dapm_clock_supply:
1619 case snd_soc_dapm_micbias:
1620 if (d->target_bias_level < SND_SOC_BIAS_STANDBY)
1621 d->target_bias_level = SND_SOC_BIAS_STANDBY;
1624 d->target_bias_level = SND_SOC_BIAS_ON;
1631 /* Force all contexts in the card to the same bias state if
1632 * they're not ground referenced.
1634 bias = SND_SOC_BIAS_OFF;
1635 list_for_each_entry(d, &card->dapm_list, list)
1636 if (d->target_bias_level > bias)
1637 bias = d->target_bias_level;
1638 list_for_each_entry(d, &card->dapm_list, list)
1639 if (!d->idle_bias_off)
1640 d->target_bias_level = bias;
1642 trace_snd_soc_dapm_walk_done(card);
1644 /* Run all the bias changes in parallel */
1645 list_for_each_entry(d, &dapm->card->dapm_list, list)
1646 async_schedule_domain(dapm_pre_sequence_async, d,
1648 async_synchronize_full_domain(&async_domain);
1650 /* Power down widgets first; try to avoid amplifying pops. */
1651 dapm_seq_run(dapm, &down_list, event, false);
1653 dapm_widget_update(dapm);
1656 dapm_seq_run(dapm, &up_list, event, true);
1658 /* Run all the bias changes in parallel */
1659 list_for_each_entry(d, &dapm->card->dapm_list, list)
1660 async_schedule_domain(dapm_post_sequence_async, d,
1662 async_synchronize_full_domain(&async_domain);
1664 /* do we need to notify any clients that DAPM event is complete */
1665 list_for_each_entry(d, &card->dapm_list, list) {
1666 if (d->stream_event)
1667 d->stream_event(d, event);
1670 pop_dbg(dapm->dev, card->pop_time,
1671 "DAPM sequencing finished, waiting %dms\n", card->pop_time);
1672 pop_wait(card->pop_time);
1674 trace_snd_soc_dapm_done(card);
1679 #ifdef CONFIG_DEBUG_FS
1680 static ssize_t dapm_widget_power_read_file(struct file *file,
1681 char __user *user_buf,
1682 size_t count, loff_t *ppos)
1684 struct snd_soc_dapm_widget *w = file->private_data;
1688 struct snd_soc_dapm_path *p = NULL;
1690 buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
1694 in = is_connected_input_ep(w, NULL);
1695 dapm_clear_walk(w->dapm);
1696 out = is_connected_output_ep(w, NULL);
1697 dapm_clear_walk(w->dapm);
1699 ret = snprintf(buf, PAGE_SIZE, "%s: %s%s in %d out %d",
1700 w->name, w->power ? "On" : "Off",
1701 w->force ? " (forced)" : "", in, out);
1704 ret += snprintf(buf + ret, PAGE_SIZE - ret,
1705 " - R%d(0x%x) bit %d",
1706 w->reg, w->reg, w->shift);
1708 ret += snprintf(buf + ret, PAGE_SIZE - ret, "\n");
1711 ret += snprintf(buf + ret, PAGE_SIZE - ret, " stream %s %s\n",
1713 w->active ? "active" : "inactive");
1715 list_for_each_entry(p, &w->sources, list_sink) {
1716 if (p->connected && !p->connected(w, p->sink))
1720 ret += snprintf(buf + ret, PAGE_SIZE - ret,
1721 " in \"%s\" \"%s\"\n",
1722 p->name ? p->name : "static",
1725 list_for_each_entry(p, &w->sinks, list_source) {
1726 if (p->connected && !p->connected(w, p->sink))
1730 ret += snprintf(buf + ret, PAGE_SIZE - ret,
1731 " out \"%s\" \"%s\"\n",
1732 p->name ? p->name : "static",
1736 ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
1742 static const struct file_operations dapm_widget_power_fops = {
1743 .open = simple_open,
1744 .read = dapm_widget_power_read_file,
1745 .llseek = default_llseek,
1748 static ssize_t dapm_bias_read_file(struct file *file, char __user *user_buf,
1749 size_t count, loff_t *ppos)
1751 struct snd_soc_dapm_context *dapm = file->private_data;
1754 switch (dapm->bias_level) {
1755 case SND_SOC_BIAS_ON:
1758 case SND_SOC_BIAS_PREPARE:
1759 level = "Prepare\n";
1761 case SND_SOC_BIAS_STANDBY:
1762 level = "Standby\n";
1764 case SND_SOC_BIAS_OFF:
1769 level = "Unknown\n";
1773 return simple_read_from_buffer(user_buf, count, ppos, level,
1777 static const struct file_operations dapm_bias_fops = {
1778 .open = simple_open,
1779 .read = dapm_bias_read_file,
1780 .llseek = default_llseek,
1783 void snd_soc_dapm_debugfs_init(struct snd_soc_dapm_context *dapm,
1784 struct dentry *parent)
1788 dapm->debugfs_dapm = debugfs_create_dir("dapm", parent);
1790 if (!dapm->debugfs_dapm) {
1792 "Failed to create DAPM debugfs directory\n");
1796 d = debugfs_create_file("bias_level", 0444,
1797 dapm->debugfs_dapm, dapm,
1801 "ASoC: Failed to create bias level debugfs file\n");
1804 static void dapm_debugfs_add_widget(struct snd_soc_dapm_widget *w)
1806 struct snd_soc_dapm_context *dapm = w->dapm;
1809 if (!dapm->debugfs_dapm || !w->name)
1812 d = debugfs_create_file(w->name, 0444,
1813 dapm->debugfs_dapm, w,
1814 &dapm_widget_power_fops);
1816 dev_warn(w->dapm->dev,
1817 "ASoC: Failed to create %s debugfs file\n",
1821 static void dapm_debugfs_cleanup(struct snd_soc_dapm_context *dapm)
1823 debugfs_remove_recursive(dapm->debugfs_dapm);
1827 void snd_soc_dapm_debugfs_init(struct snd_soc_dapm_context *dapm,
1828 struct dentry *parent)
1832 static inline void dapm_debugfs_add_widget(struct snd_soc_dapm_widget *w)
1836 static inline void dapm_debugfs_cleanup(struct snd_soc_dapm_context *dapm)
1842 /* test and update the power status of a mux widget */
1843 static int soc_dapm_mux_update_power(struct snd_soc_dapm_widget *widget,
1844 struct snd_kcontrol *kcontrol, int mux, struct soc_enum *e)
1846 struct snd_soc_dapm_path *path;
1849 if (widget->id != snd_soc_dapm_mux &&
1850 widget->id != snd_soc_dapm_virt_mux &&
1851 widget->id != snd_soc_dapm_value_mux)
1854 /* find dapm widget path assoc with kcontrol */
1855 list_for_each_entry(path, &widget->dapm->card->paths, list) {
1856 if (path->kcontrol != kcontrol)
1859 if (!path->name || !e->texts[mux])
1863 /* we now need to match the string in the enum to the path */
1864 if (!(strcmp(path->name, e->texts[mux]))) {
1865 path->connect = 1; /* new connection */
1866 dapm_mark_dirty(path->source, "mux connection");
1869 dapm_mark_dirty(path->source,
1870 "mux disconnection");
1871 path->connect = 0; /* old connection must be powered down */
1876 dapm_mark_dirty(widget, "mux change");
1877 dapm_power_widgets(widget->dapm, SND_SOC_DAPM_STREAM_NOP);
1883 int snd_soc_dapm_mux_update_power(struct snd_soc_dapm_widget *widget,
1884 struct snd_kcontrol *kcontrol, int mux, struct soc_enum *e)
1886 struct snd_soc_card *card = widget->dapm->card;
1889 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
1890 ret = soc_dapm_mux_update_power(widget, kcontrol, mux, e);
1891 mutex_unlock(&card->dapm_mutex);
1893 soc_dpcm_runtime_update(widget);
1896 EXPORT_SYMBOL_GPL(snd_soc_dapm_mux_update_power);
1898 /* test and update the power status of a mixer or switch widget */
1899 static int soc_dapm_mixer_update_power(struct snd_soc_dapm_widget *widget,
1900 struct snd_kcontrol *kcontrol, int connect)
1902 struct snd_soc_dapm_path *path;
1905 if (widget->id != snd_soc_dapm_mixer &&
1906 widget->id != snd_soc_dapm_mixer_named_ctl &&
1907 widget->id != snd_soc_dapm_switch)
1910 /* find dapm widget path assoc with kcontrol */
1911 list_for_each_entry(path, &widget->dapm->card->paths, list) {
1912 if (path->kcontrol != kcontrol)
1915 /* found, now check type */
1917 path->connect = connect;
1918 dapm_mark_dirty(path->source, "mixer connection");
1922 dapm_mark_dirty(widget, "mixer update");
1923 dapm_power_widgets(widget->dapm, SND_SOC_DAPM_STREAM_NOP);
1929 int snd_soc_dapm_mixer_update_power(struct snd_soc_dapm_widget *widget,
1930 struct snd_kcontrol *kcontrol, int connect)
1932 struct snd_soc_card *card = widget->dapm->card;
1935 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
1936 ret = soc_dapm_mixer_update_power(widget, kcontrol, connect);
1937 mutex_unlock(&card->dapm_mutex);
1939 soc_dpcm_runtime_update(widget);
1942 EXPORT_SYMBOL_GPL(snd_soc_dapm_mixer_update_power);
1944 /* show dapm widget status in sys fs */
1945 static ssize_t dapm_widget_show(struct device *dev,
1946 struct device_attribute *attr, char *buf)
1948 struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);
1949 struct snd_soc_codec *codec =rtd->codec;
1950 struct snd_soc_dapm_widget *w;
1952 char *state = "not set";
1954 list_for_each_entry(w, &codec->card->widgets, list) {
1955 if (w->dapm != &codec->dapm)
1958 /* only display widgets that burnm power */
1960 case snd_soc_dapm_hp:
1961 case snd_soc_dapm_mic:
1962 case snd_soc_dapm_spk:
1963 case snd_soc_dapm_line:
1964 case snd_soc_dapm_micbias:
1965 case snd_soc_dapm_dac:
1966 case snd_soc_dapm_adc:
1967 case snd_soc_dapm_pga:
1968 case snd_soc_dapm_out_drv:
1969 case snd_soc_dapm_mixer:
1970 case snd_soc_dapm_mixer_named_ctl:
1971 case snd_soc_dapm_supply:
1972 case snd_soc_dapm_regulator_supply:
1973 case snd_soc_dapm_clock_supply:
1975 count += sprintf(buf + count, "%s: %s\n",
1976 w->name, w->power ? "On":"Off");
1983 switch (codec->dapm.bias_level) {
1984 case SND_SOC_BIAS_ON:
1987 case SND_SOC_BIAS_PREPARE:
1990 case SND_SOC_BIAS_STANDBY:
1993 case SND_SOC_BIAS_OFF:
1997 count += sprintf(buf + count, "PM State: %s\n", state);
2002 static DEVICE_ATTR(dapm_widget, 0444, dapm_widget_show, NULL);
2004 int snd_soc_dapm_sys_add(struct device *dev)
2006 return device_create_file(dev, &dev_attr_dapm_widget);
2009 static void snd_soc_dapm_sys_remove(struct device *dev)
2011 device_remove_file(dev, &dev_attr_dapm_widget);
2014 /* free all dapm widgets and resources */
2015 static void dapm_free_widgets(struct snd_soc_dapm_context *dapm)
2017 struct snd_soc_dapm_widget *w, *next_w;
2018 struct snd_soc_dapm_path *p, *next_p;
2020 list_for_each_entry_safe(w, next_w, &dapm->card->widgets, list) {
2021 if (w->dapm != dapm)
2025 * remove source and sink paths associated to this widget.
2026 * While removing the path, remove reference to it from both
2027 * source and sink widgets so that path is removed only once.
2029 list_for_each_entry_safe(p, next_p, &w->sources, list_sink) {
2030 list_del(&p->list_sink);
2031 list_del(&p->list_source);
2033 kfree(p->long_name);
2036 list_for_each_entry_safe(p, next_p, &w->sinks, list_source) {
2037 list_del(&p->list_sink);
2038 list_del(&p->list_source);
2040 kfree(p->long_name);
2043 kfree(w->kcontrols);
2049 static struct snd_soc_dapm_widget *dapm_find_widget(
2050 struct snd_soc_dapm_context *dapm, const char *pin,
2051 bool search_other_contexts)
2053 struct snd_soc_dapm_widget *w;
2054 struct snd_soc_dapm_widget *fallback = NULL;
2056 list_for_each_entry(w, &dapm->card->widgets, list) {
2057 if (!strcmp(w->name, pin)) {
2058 if (w->dapm == dapm)
2065 if (search_other_contexts)
2071 static int snd_soc_dapm_set_pin(struct snd_soc_dapm_context *dapm,
2072 const char *pin, int status)
2074 struct snd_soc_dapm_widget *w = dapm_find_widget(dapm, pin, true);
2077 dev_err(dapm->dev, "dapm: unknown pin %s\n", pin);
2081 if (w->connected != status)
2082 dapm_mark_dirty(w, "pin configuration");
2084 w->connected = status;
2092 * snd_soc_dapm_sync - scan and power dapm paths
2093 * @dapm: DAPM context
2095 * Walks all dapm audio paths and powers widgets according to their
2096 * stream or path usage.
2098 * Returns 0 for success.
2100 int snd_soc_dapm_sync(struct snd_soc_dapm_context *dapm)
2105 * Suppress early reports (eg, jacks syncing their state) to avoid
2106 * silly DAPM runs during card startup.
2108 if (!dapm->card || !dapm->card->instantiated)
2111 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2112 ret = dapm_power_widgets(dapm, SND_SOC_DAPM_STREAM_NOP);
2113 mutex_unlock(&dapm->card->dapm_mutex);
2116 EXPORT_SYMBOL_GPL(snd_soc_dapm_sync);
2118 static int snd_soc_dapm_add_route(struct snd_soc_dapm_context *dapm,
2119 const struct snd_soc_dapm_route *route)
2121 struct snd_soc_dapm_path *path;
2122 struct snd_soc_dapm_widget *wsource = NULL, *wsink = NULL, *w;
2123 struct snd_soc_dapm_widget *wtsource = NULL, *wtsink = NULL;
2125 const char *control = route->control;
2127 char prefixed_sink[80];
2128 char prefixed_source[80];
2131 if (dapm->codec && dapm->codec->name_prefix) {
2132 snprintf(prefixed_sink, sizeof(prefixed_sink), "%s %s",
2133 dapm->codec->name_prefix, route->sink);
2134 sink = prefixed_sink;
2135 snprintf(prefixed_source, sizeof(prefixed_source), "%s %s",
2136 dapm->codec->name_prefix, route->source);
2137 source = prefixed_source;
2140 source = route->source;
2144 * find src and dest widgets over all widgets but favor a widget from
2145 * current DAPM context
2147 list_for_each_entry(w, &dapm->card->widgets, list) {
2148 if (!wsink && !(strcmp(w->name, sink))) {
2150 if (w->dapm == dapm)
2154 if (!wsource && !(strcmp(w->name, source))) {
2156 if (w->dapm == dapm)
2160 /* use widget from another DAPM context if not found from this */
2166 if (wsource == NULL || wsink == NULL)
2169 path = kzalloc(sizeof(struct snd_soc_dapm_path), GFP_KERNEL);
2173 path->source = wsource;
2175 path->connected = route->connected;
2176 INIT_LIST_HEAD(&path->list);
2177 INIT_LIST_HEAD(&path->list_source);
2178 INIT_LIST_HEAD(&path->list_sink);
2180 /* check for external widgets */
2181 if (wsink->id == snd_soc_dapm_input) {
2182 if (wsource->id == snd_soc_dapm_micbias ||
2183 wsource->id == snd_soc_dapm_mic ||
2184 wsource->id == snd_soc_dapm_line ||
2185 wsource->id == snd_soc_dapm_output)
2188 if (wsource->id == snd_soc_dapm_output) {
2189 if (wsink->id == snd_soc_dapm_spk ||
2190 wsink->id == snd_soc_dapm_hp ||
2191 wsink->id == snd_soc_dapm_line ||
2192 wsink->id == snd_soc_dapm_input)
2196 /* connect static paths */
2197 if (control == NULL) {
2198 list_add(&path->list, &dapm->card->paths);
2199 list_add(&path->list_sink, &wsink->sources);
2200 list_add(&path->list_source, &wsource->sinks);
2205 /* connect dynamic paths */
2206 switch (wsink->id) {
2207 case snd_soc_dapm_adc:
2208 case snd_soc_dapm_dac:
2209 case snd_soc_dapm_pga:
2210 case snd_soc_dapm_out_drv:
2211 case snd_soc_dapm_input:
2212 case snd_soc_dapm_output:
2213 case snd_soc_dapm_siggen:
2214 case snd_soc_dapm_micbias:
2215 case snd_soc_dapm_vmid:
2216 case snd_soc_dapm_pre:
2217 case snd_soc_dapm_post:
2218 case snd_soc_dapm_supply:
2219 case snd_soc_dapm_regulator_supply:
2220 case snd_soc_dapm_clock_supply:
2221 case snd_soc_dapm_aif_in:
2222 case snd_soc_dapm_aif_out:
2223 case snd_soc_dapm_dai:
2224 case snd_soc_dapm_dai_link:
2225 list_add(&path->list, &dapm->card->paths);
2226 list_add(&path->list_sink, &wsink->sources);
2227 list_add(&path->list_source, &wsource->sinks);
2230 case snd_soc_dapm_mux:
2231 case snd_soc_dapm_virt_mux:
2232 case snd_soc_dapm_value_mux:
2233 ret = dapm_connect_mux(dapm, wsource, wsink, path, control,
2234 &wsink->kcontrol_news[0]);
2238 case snd_soc_dapm_switch:
2239 case snd_soc_dapm_mixer:
2240 case snd_soc_dapm_mixer_named_ctl:
2241 ret = dapm_connect_mixer(dapm, wsource, wsink, path, control);
2245 case snd_soc_dapm_hp:
2246 case snd_soc_dapm_mic:
2247 case snd_soc_dapm_line:
2248 case snd_soc_dapm_spk:
2249 list_add(&path->list, &dapm->card->paths);
2250 list_add(&path->list_sink, &wsink->sources);
2251 list_add(&path->list_source, &wsource->sinks);
2256 dapm_mark_dirty(wsource, "Route added");
2257 dapm_mark_dirty(wsink, "Route added");
2262 dev_warn(dapm->dev, "asoc: no dapm match for %s --> %s --> %s\n",
2263 source, control, sink);
2268 static int snd_soc_dapm_del_route(struct snd_soc_dapm_context *dapm,
2269 const struct snd_soc_dapm_route *route)
2271 struct snd_soc_dapm_path *path, *p;
2274 char prefixed_sink[80];
2275 char prefixed_source[80];
2277 if (route->control) {
2279 "Removal of routes with controls not supported\n");
2283 if (dapm->codec && dapm->codec->name_prefix) {
2284 snprintf(prefixed_sink, sizeof(prefixed_sink), "%s %s",
2285 dapm->codec->name_prefix, route->sink);
2286 sink = prefixed_sink;
2287 snprintf(prefixed_source, sizeof(prefixed_source), "%s %s",
2288 dapm->codec->name_prefix, route->source);
2289 source = prefixed_source;
2292 source = route->source;
2296 list_for_each_entry(p, &dapm->card->paths, list) {
2297 if (strcmp(p->source->name, source) != 0)
2299 if (strcmp(p->sink->name, sink) != 0)
2306 dapm_mark_dirty(path->source, "Route removed");
2307 dapm_mark_dirty(path->sink, "Route removed");
2309 list_del(&path->list);
2310 list_del(&path->list_sink);
2311 list_del(&path->list_source);
2314 dev_warn(dapm->dev, "Route %s->%s does not exist\n",
2322 * snd_soc_dapm_add_routes - Add routes between DAPM widgets
2323 * @dapm: DAPM context
2324 * @route: audio routes
2325 * @num: number of routes
2327 * Connects 2 dapm widgets together via a named audio path. The sink is
2328 * the widget receiving the audio signal, whilst the source is the sender
2329 * of the audio signal.
2331 * Returns 0 for success else error. On error all resources can be freed
2332 * with a call to snd_soc_card_free().
2334 int snd_soc_dapm_add_routes(struct snd_soc_dapm_context *dapm,
2335 const struct snd_soc_dapm_route *route, int num)
2339 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_INIT);
2340 for (i = 0; i < num; i++) {
2341 r = snd_soc_dapm_add_route(dapm, route);
2343 dev_err(dapm->dev, "Failed to add route %s->%s\n",
2344 route->source, route->sink);
2349 mutex_unlock(&dapm->card->dapm_mutex);
2353 EXPORT_SYMBOL_GPL(snd_soc_dapm_add_routes);
2356 * snd_soc_dapm_del_routes - Remove routes between DAPM widgets
2357 * @dapm: DAPM context
2358 * @route: audio routes
2359 * @num: number of routes
2361 * Removes routes from the DAPM context.
2363 int snd_soc_dapm_del_routes(struct snd_soc_dapm_context *dapm,
2364 const struct snd_soc_dapm_route *route, int num)
2368 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_INIT);
2369 for (i = 0; i < num; i++) {
2370 snd_soc_dapm_del_route(dapm, route);
2373 mutex_unlock(&dapm->card->dapm_mutex);
2377 EXPORT_SYMBOL_GPL(snd_soc_dapm_del_routes);
2379 static int snd_soc_dapm_weak_route(struct snd_soc_dapm_context *dapm,
2380 const struct snd_soc_dapm_route *route)
2382 struct snd_soc_dapm_widget *source = dapm_find_widget(dapm,
2385 struct snd_soc_dapm_widget *sink = dapm_find_widget(dapm,
2388 struct snd_soc_dapm_path *path;
2392 dev_err(dapm->dev, "Unable to find source %s for weak route\n",
2398 dev_err(dapm->dev, "Unable to find sink %s for weak route\n",
2403 if (route->control || route->connected)
2404 dev_warn(dapm->dev, "Ignoring control for weak route %s->%s\n",
2405 route->source, route->sink);
2407 list_for_each_entry(path, &source->sinks, list_source) {
2408 if (path->sink == sink) {
2415 dev_err(dapm->dev, "No path found for weak route %s->%s\n",
2416 route->source, route->sink);
2418 dev_warn(dapm->dev, "%d paths found for weak route %s->%s\n",
2419 count, route->source, route->sink);
2425 * snd_soc_dapm_weak_routes - Mark routes between DAPM widgets as weak
2426 * @dapm: DAPM context
2427 * @route: audio routes
2428 * @num: number of routes
2430 * Mark existing routes matching those specified in the passed array
2431 * as being weak, meaning that they are ignored for the purpose of
2432 * power decisions. The main intended use case is for sidetone paths
2433 * which couple audio between other independent paths if they are both
2434 * active in order to make the combination work better at the user
2435 * level but which aren't intended to be "used".
2437 * Note that CODEC drivers should not use this as sidetone type paths
2438 * can frequently also be used as bypass paths.
2440 int snd_soc_dapm_weak_routes(struct snd_soc_dapm_context *dapm,
2441 const struct snd_soc_dapm_route *route, int num)
2446 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_INIT);
2447 for (i = 0; i < num; i++) {
2448 err = snd_soc_dapm_weak_route(dapm, route);
2453 mutex_unlock(&dapm->card->dapm_mutex);
2457 EXPORT_SYMBOL_GPL(snd_soc_dapm_weak_routes);
2460 * snd_soc_dapm_new_widgets - add new dapm widgets
2461 * @dapm: DAPM context
2463 * Checks the codec for any new dapm widgets and creates them if found.
2465 * Returns 0 for success.
2467 int snd_soc_dapm_new_widgets(struct snd_soc_dapm_context *dapm)
2469 struct snd_soc_dapm_widget *w;
2472 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_INIT);
2474 list_for_each_entry(w, &dapm->card->widgets, list)
2479 if (w->num_kcontrols) {
2480 w->kcontrols = kzalloc(w->num_kcontrols *
2481 sizeof(struct snd_kcontrol *),
2483 if (!w->kcontrols) {
2484 mutex_unlock(&dapm->card->dapm_mutex);
2490 case snd_soc_dapm_switch:
2491 case snd_soc_dapm_mixer:
2492 case snd_soc_dapm_mixer_named_ctl:
2495 case snd_soc_dapm_mux:
2496 case snd_soc_dapm_virt_mux:
2497 case snd_soc_dapm_value_mux:
2500 case snd_soc_dapm_pga:
2501 case snd_soc_dapm_out_drv:
2508 /* Read the initial power state from the device */
2510 val = soc_widget_read(w, w->reg);
2511 val &= 1 << w->shift;
2521 dapm_mark_dirty(w, "new widget");
2522 dapm_debugfs_add_widget(w);
2525 dapm_power_widgets(dapm, SND_SOC_DAPM_STREAM_NOP);
2526 mutex_unlock(&dapm->card->dapm_mutex);
2529 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_widgets);
2532 * snd_soc_dapm_get_volsw - dapm mixer get callback
2533 * @kcontrol: mixer control
2534 * @ucontrol: control element information
2536 * Callback to get the value of a dapm mixer control.
2538 * Returns 0 for success.
2540 int snd_soc_dapm_get_volsw(struct snd_kcontrol *kcontrol,
2541 struct snd_ctl_elem_value *ucontrol)
2543 struct snd_soc_dapm_widget_list *wlist = snd_kcontrol_chip(kcontrol);
2544 struct snd_soc_dapm_widget *widget = wlist->widgets[0];
2545 struct soc_mixer_control *mc =
2546 (struct soc_mixer_control *)kcontrol->private_value;
2547 unsigned int reg = mc->reg;
2548 unsigned int shift = mc->shift;
2550 unsigned int mask = (1 << fls(max)) - 1;
2551 unsigned int invert = mc->invert;
2553 if (snd_soc_volsw_is_stereo(mc))
2554 dev_warn(widget->dapm->dev,
2555 "Control '%s' is stereo, which is not supported\n",
2558 ucontrol->value.integer.value[0] =
2559 (snd_soc_read(widget->codec, reg) >> shift) & mask;
2561 ucontrol->value.integer.value[0] =
2562 max - ucontrol->value.integer.value[0];
2566 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_volsw);
2569 * snd_soc_dapm_put_volsw - dapm mixer set callback
2570 * @kcontrol: mixer control
2571 * @ucontrol: control element information
2573 * Callback to set the value of a dapm mixer control.
2575 * Returns 0 for success.
2577 int snd_soc_dapm_put_volsw(struct snd_kcontrol *kcontrol,
2578 struct snd_ctl_elem_value *ucontrol)
2580 struct snd_soc_dapm_widget_list *wlist = snd_kcontrol_chip(kcontrol);
2581 struct snd_soc_dapm_widget *widget = wlist->widgets[0];
2582 struct snd_soc_codec *codec = widget->codec;
2583 struct snd_soc_card *card = codec->card;
2584 struct soc_mixer_control *mc =
2585 (struct soc_mixer_control *)kcontrol->private_value;
2586 unsigned int reg = mc->reg;
2587 unsigned int shift = mc->shift;
2589 unsigned int mask = (1 << fls(max)) - 1;
2590 unsigned int invert = mc->invert;
2592 int connect, change;
2593 struct snd_soc_dapm_update update;
2596 if (snd_soc_volsw_is_stereo(mc))
2597 dev_warn(widget->dapm->dev,
2598 "Control '%s' is stereo, which is not supported\n",
2601 val = (ucontrol->value.integer.value[0] & mask);
2606 mask = mask << shift;
2609 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2611 change = snd_soc_test_bits(widget->codec, reg, mask, val);
2613 for (wi = 0; wi < wlist->num_widgets; wi++) {
2614 widget = wlist->widgets[wi];
2616 widget->value = val;
2618 update.kcontrol = kcontrol;
2619 update.widget = widget;
2623 widget->dapm->update = &update;
2625 soc_dapm_mixer_update_power(widget, kcontrol, connect);
2627 widget->dapm->update = NULL;
2631 mutex_unlock(&card->dapm_mutex);
2634 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_volsw);
2637 * snd_soc_dapm_get_enum_double - dapm enumerated double mixer get callback
2638 * @kcontrol: mixer control
2639 * @ucontrol: control element information
2641 * Callback to get the value of a dapm enumerated double mixer control.
2643 * Returns 0 for success.
2645 int snd_soc_dapm_get_enum_double(struct snd_kcontrol *kcontrol,
2646 struct snd_ctl_elem_value *ucontrol)
2648 struct snd_soc_dapm_widget_list *wlist = snd_kcontrol_chip(kcontrol);
2649 struct snd_soc_dapm_widget *widget = wlist->widgets[0];
2650 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2651 unsigned int val, bitmask;
2653 for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
2655 val = snd_soc_read(widget->codec, e->reg);
2656 ucontrol->value.enumerated.item[0] = (val >> e->shift_l) & (bitmask - 1);
2657 if (e->shift_l != e->shift_r)
2658 ucontrol->value.enumerated.item[1] =
2659 (val >> e->shift_r) & (bitmask - 1);
2663 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_enum_double);
2666 * snd_soc_dapm_put_enum_double - dapm enumerated double mixer set callback
2667 * @kcontrol: mixer control
2668 * @ucontrol: control element information
2670 * Callback to set the value of a dapm enumerated double mixer control.
2672 * Returns 0 for success.
2674 int snd_soc_dapm_put_enum_double(struct snd_kcontrol *kcontrol,
2675 struct snd_ctl_elem_value *ucontrol)
2677 struct snd_soc_dapm_widget_list *wlist = snd_kcontrol_chip(kcontrol);
2678 struct snd_soc_dapm_widget *widget = wlist->widgets[0];
2679 struct snd_soc_codec *codec = widget->codec;
2680 struct snd_soc_card *card = codec->card;
2681 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2682 unsigned int val, mux, change;
2683 unsigned int mask, bitmask;
2684 struct snd_soc_dapm_update update;
2687 for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
2689 if (ucontrol->value.enumerated.item[0] > e->max - 1)
2691 mux = ucontrol->value.enumerated.item[0];
2692 val = mux << e->shift_l;
2693 mask = (bitmask - 1) << e->shift_l;
2694 if (e->shift_l != e->shift_r) {
2695 if (ucontrol->value.enumerated.item[1] > e->max - 1)
2697 val |= ucontrol->value.enumerated.item[1] << e->shift_r;
2698 mask |= (bitmask - 1) << e->shift_r;
2701 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2703 change = snd_soc_test_bits(widget->codec, e->reg, mask, val);
2705 for (wi = 0; wi < wlist->num_widgets; wi++) {
2706 widget = wlist->widgets[wi];
2708 widget->value = val;
2710 update.kcontrol = kcontrol;
2711 update.widget = widget;
2712 update.reg = e->reg;
2715 widget->dapm->update = &update;
2717 soc_dapm_mux_update_power(widget, kcontrol, mux, e);
2719 widget->dapm->update = NULL;
2723 mutex_unlock(&card->dapm_mutex);
2726 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_enum_double);
2729 * snd_soc_dapm_get_enum_virt - Get virtual DAPM mux
2730 * @kcontrol: mixer control
2731 * @ucontrol: control element information
2733 * Returns 0 for success.
2735 int snd_soc_dapm_get_enum_virt(struct snd_kcontrol *kcontrol,
2736 struct snd_ctl_elem_value *ucontrol)
2738 struct snd_soc_dapm_widget_list *wlist = snd_kcontrol_chip(kcontrol);
2739 struct snd_soc_dapm_widget *widget = wlist->widgets[0];
2741 ucontrol->value.enumerated.item[0] = widget->value;
2745 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_enum_virt);
2748 * snd_soc_dapm_put_enum_virt - Set virtual DAPM mux
2749 * @kcontrol: mixer control
2750 * @ucontrol: control element information
2752 * Returns 0 for success.
2754 int snd_soc_dapm_put_enum_virt(struct snd_kcontrol *kcontrol,
2755 struct snd_ctl_elem_value *ucontrol)
2757 struct snd_soc_dapm_widget_list *wlist = snd_kcontrol_chip(kcontrol);
2758 struct snd_soc_dapm_widget *widget = wlist->widgets[0];
2759 struct snd_soc_codec *codec = widget->codec;
2760 struct snd_soc_card *card = codec->card;
2761 struct soc_enum *e =
2762 (struct soc_enum *)kcontrol->private_value;
2767 if (ucontrol->value.enumerated.item[0] >= e->max)
2770 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2772 change = widget->value != ucontrol->value.enumerated.item[0];
2774 for (wi = 0; wi < wlist->num_widgets; wi++) {
2775 widget = wlist->widgets[wi];
2777 widget->value = ucontrol->value.enumerated.item[0];
2779 soc_dapm_mux_update_power(widget, kcontrol, widget->value, e);
2783 mutex_unlock(&card->dapm_mutex);
2786 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_enum_virt);
2789 * snd_soc_dapm_get_value_enum_double - dapm semi enumerated double mixer get
2791 * @kcontrol: mixer control
2792 * @ucontrol: control element information
2794 * Callback to get the value of a dapm semi enumerated double mixer control.
2796 * Semi enumerated mixer: the enumerated items are referred as values. Can be
2797 * used for handling bitfield coded enumeration for example.
2799 * Returns 0 for success.
2801 int snd_soc_dapm_get_value_enum_double(struct snd_kcontrol *kcontrol,
2802 struct snd_ctl_elem_value *ucontrol)
2804 struct snd_soc_dapm_widget_list *wlist = snd_kcontrol_chip(kcontrol);
2805 struct snd_soc_dapm_widget *widget = wlist->widgets[0];
2806 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2807 unsigned int reg_val, val, mux;
2809 reg_val = snd_soc_read(widget->codec, e->reg);
2810 val = (reg_val >> e->shift_l) & e->mask;
2811 for (mux = 0; mux < e->max; mux++) {
2812 if (val == e->values[mux])
2815 ucontrol->value.enumerated.item[0] = mux;
2816 if (e->shift_l != e->shift_r) {
2817 val = (reg_val >> e->shift_r) & e->mask;
2818 for (mux = 0; mux < e->max; mux++) {
2819 if (val == e->values[mux])
2822 ucontrol->value.enumerated.item[1] = mux;
2827 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_value_enum_double);
2830 * snd_soc_dapm_put_value_enum_double - dapm semi enumerated double mixer set
2832 * @kcontrol: mixer control
2833 * @ucontrol: control element information
2835 * Callback to set the value of a dapm semi enumerated double mixer control.
2837 * Semi enumerated mixer: the enumerated items are referred as values. Can be
2838 * used for handling bitfield coded enumeration for example.
2840 * Returns 0 for success.
2842 int snd_soc_dapm_put_value_enum_double(struct snd_kcontrol *kcontrol,
2843 struct snd_ctl_elem_value *ucontrol)
2845 struct snd_soc_dapm_widget_list *wlist = snd_kcontrol_chip(kcontrol);
2846 struct snd_soc_dapm_widget *widget = wlist->widgets[0];
2847 struct snd_soc_codec *codec = widget->codec;
2848 struct snd_soc_card *card = codec->card;
2849 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2850 unsigned int val, mux, change;
2852 struct snd_soc_dapm_update update;
2855 if (ucontrol->value.enumerated.item[0] > e->max - 1)
2857 mux = ucontrol->value.enumerated.item[0];
2858 val = e->values[ucontrol->value.enumerated.item[0]] << e->shift_l;
2859 mask = e->mask << e->shift_l;
2860 if (e->shift_l != e->shift_r) {
2861 if (ucontrol->value.enumerated.item[1] > e->max - 1)
2863 val |= e->values[ucontrol->value.enumerated.item[1]] << e->shift_r;
2864 mask |= e->mask << e->shift_r;
2867 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2869 change = snd_soc_test_bits(widget->codec, e->reg, mask, val);
2871 for (wi = 0; wi < wlist->num_widgets; wi++) {
2872 widget = wlist->widgets[wi];
2874 widget->value = val;
2876 update.kcontrol = kcontrol;
2877 update.widget = widget;
2878 update.reg = e->reg;
2881 widget->dapm->update = &update;
2883 soc_dapm_mux_update_power(widget, kcontrol, mux, e);
2885 widget->dapm->update = NULL;
2889 mutex_unlock(&card->dapm_mutex);
2892 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_value_enum_double);
2895 * snd_soc_dapm_info_pin_switch - Info for a pin switch
2897 * @kcontrol: mixer control
2898 * @uinfo: control element information
2900 * Callback to provide information about a pin switch control.
2902 int snd_soc_dapm_info_pin_switch(struct snd_kcontrol *kcontrol,
2903 struct snd_ctl_elem_info *uinfo)
2905 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
2907 uinfo->value.integer.min = 0;
2908 uinfo->value.integer.max = 1;
2912 EXPORT_SYMBOL_GPL(snd_soc_dapm_info_pin_switch);
2915 * snd_soc_dapm_get_pin_switch - Get information for a pin switch
2917 * @kcontrol: mixer control
2920 int snd_soc_dapm_get_pin_switch(struct snd_kcontrol *kcontrol,
2921 struct snd_ctl_elem_value *ucontrol)
2923 struct snd_soc_card *card = snd_kcontrol_chip(kcontrol);
2924 const char *pin = (const char *)kcontrol->private_value;
2926 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2928 ucontrol->value.integer.value[0] =
2929 snd_soc_dapm_get_pin_status(&card->dapm, pin);
2931 mutex_unlock(&card->dapm_mutex);
2935 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_pin_switch);
2938 * snd_soc_dapm_put_pin_switch - Set information for a pin switch
2940 * @kcontrol: mixer control
2943 int snd_soc_dapm_put_pin_switch(struct snd_kcontrol *kcontrol,
2944 struct snd_ctl_elem_value *ucontrol)
2946 struct snd_soc_card *card = snd_kcontrol_chip(kcontrol);
2947 const char *pin = (const char *)kcontrol->private_value;
2949 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
2951 if (ucontrol->value.integer.value[0])
2952 snd_soc_dapm_enable_pin(&card->dapm, pin);
2954 snd_soc_dapm_disable_pin(&card->dapm, pin);
2956 mutex_unlock(&card->dapm_mutex);
2958 snd_soc_dapm_sync(&card->dapm);
2961 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_pin_switch);
2963 static struct snd_soc_dapm_widget *
2964 snd_soc_dapm_new_control(struct snd_soc_dapm_context *dapm,
2965 const struct snd_soc_dapm_widget *widget)
2967 struct snd_soc_dapm_widget *w;
2971 if ((w = dapm_cnew_widget(widget)) == NULL)
2975 case snd_soc_dapm_regulator_supply:
2976 w->regulator = devm_regulator_get(dapm->dev, w->name);
2977 if (IS_ERR(w->regulator)) {
2978 ret = PTR_ERR(w->regulator);
2979 dev_err(dapm->dev, "Failed to request %s: %d\n",
2984 case snd_soc_dapm_clock_supply:
2985 #ifdef CONFIG_CLKDEV_LOOKUP
2986 w->clk = devm_clk_get(dapm->dev, w->name);
2987 if (IS_ERR(w->clk)) {
2988 ret = PTR_ERR(w->clk);
2989 dev_err(dapm->dev, "Failed to request %s: %d\n",
3001 name_len = strlen(widget->name) + 1;
3002 if (dapm->codec && dapm->codec->name_prefix)
3003 name_len += 1 + strlen(dapm->codec->name_prefix);
3004 w->name = kmalloc(name_len, GFP_KERNEL);
3005 if (w->name == NULL) {
3009 if (dapm->codec && dapm->codec->name_prefix)
3010 snprintf((char *)w->name, name_len, "%s %s",
3011 dapm->codec->name_prefix, widget->name);
3013 snprintf((char *)w->name, name_len, "%s", widget->name);
3016 case snd_soc_dapm_switch:
3017 case snd_soc_dapm_mixer:
3018 case snd_soc_dapm_mixer_named_ctl:
3019 w->power_check = dapm_generic_check_power;
3021 case snd_soc_dapm_mux:
3022 case snd_soc_dapm_virt_mux:
3023 case snd_soc_dapm_value_mux:
3024 w->power_check = dapm_generic_check_power;
3026 case snd_soc_dapm_adc:
3027 case snd_soc_dapm_aif_out:
3028 w->power_check = dapm_adc_check_power;
3030 case snd_soc_dapm_dac:
3031 case snd_soc_dapm_aif_in:
3032 w->power_check = dapm_dac_check_power;
3034 case snd_soc_dapm_pga:
3035 case snd_soc_dapm_out_drv:
3036 case snd_soc_dapm_input:
3037 case snd_soc_dapm_output:
3038 case snd_soc_dapm_micbias:
3039 case snd_soc_dapm_spk:
3040 case snd_soc_dapm_hp:
3041 case snd_soc_dapm_mic:
3042 case snd_soc_dapm_line:
3043 case snd_soc_dapm_dai_link:
3044 w->power_check = dapm_generic_check_power;
3046 case snd_soc_dapm_supply:
3047 case snd_soc_dapm_regulator_supply:
3048 case snd_soc_dapm_clock_supply:
3049 w->power_check = dapm_supply_check_power;
3051 case snd_soc_dapm_dai:
3052 w->power_check = dapm_dai_check_power;
3055 w->power_check = dapm_always_on_check_power;
3061 w->codec = dapm->codec;
3062 w->platform = dapm->platform;
3063 INIT_LIST_HEAD(&w->sources);
3064 INIT_LIST_HEAD(&w->sinks);
3065 INIT_LIST_HEAD(&w->list);
3066 INIT_LIST_HEAD(&w->dirty);
3067 list_add(&w->list, &dapm->card->widgets);
3069 /* machine layer set ups unconnected pins and insertions */
3075 * snd_soc_dapm_new_controls - create new dapm controls
3076 * @dapm: DAPM context
3077 * @widget: widget array
3078 * @num: number of widgets
3080 * Creates new DAPM controls based upon the templates.
3082 * Returns 0 for success else error.
3084 int snd_soc_dapm_new_controls(struct snd_soc_dapm_context *dapm,
3085 const struct snd_soc_dapm_widget *widget,
3088 struct snd_soc_dapm_widget *w;
3092 mutex_lock_nested(&dapm->card->dapm_mutex, SND_SOC_DAPM_CLASS_INIT);
3093 for (i = 0; i < num; i++) {
3094 w = snd_soc_dapm_new_control(dapm, widget);
3097 "ASoC: Failed to create DAPM control %s\n",
3104 mutex_unlock(&dapm->card->dapm_mutex);
3107 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_controls);
3109 static int snd_soc_dai_link_event(struct snd_soc_dapm_widget *w,
3110 struct snd_kcontrol *kcontrol, int event)
3112 struct snd_soc_dapm_path *source_p, *sink_p;
3113 struct snd_soc_dai *source, *sink;
3114 const struct snd_soc_pcm_stream *config = w->params;
3115 struct snd_pcm_substream substream;
3116 struct snd_pcm_hw_params *params = NULL;
3121 BUG_ON(list_empty(&w->sources) || list_empty(&w->sinks));
3123 /* We only support a single source and sink, pick the first */
3124 source_p = list_first_entry(&w->sources, struct snd_soc_dapm_path,
3126 sink_p = list_first_entry(&w->sinks, struct snd_soc_dapm_path,
3129 BUG_ON(!source_p || !sink_p);
3130 BUG_ON(!sink_p->source || !source_p->sink);
3131 BUG_ON(!source_p->source || !sink_p->sink);
3133 source = source_p->source->priv;
3134 sink = sink_p->sink->priv;
3136 /* Be a little careful as we don't want to overflow the mask array */
3137 if (config->formats) {
3138 fmt = ffs(config->formats) - 1;
3140 dev_warn(w->dapm->dev, "Invalid format %llx specified\n",
3145 /* Currently very limited parameter selection */
3146 params = kzalloc(sizeof(*params), GFP_KERNEL);
3151 snd_mask_set(hw_param_mask(params, SNDRV_PCM_HW_PARAM_FORMAT), fmt);
3153 hw_param_interval(params, SNDRV_PCM_HW_PARAM_RATE)->min =
3155 hw_param_interval(params, SNDRV_PCM_HW_PARAM_RATE)->max =
3158 hw_param_interval(params, SNDRV_PCM_HW_PARAM_CHANNELS)->min
3159 = config->channels_min;
3160 hw_param_interval(params, SNDRV_PCM_HW_PARAM_CHANNELS)->max
3161 = config->channels_max;
3163 memset(&substream, 0, sizeof(substream));
3166 case SND_SOC_DAPM_PRE_PMU:
3167 if (source->driver->ops && source->driver->ops->hw_params) {
3168 substream.stream = SNDRV_PCM_STREAM_CAPTURE;
3169 ret = source->driver->ops->hw_params(&substream,
3172 dev_err(source->dev,
3173 "hw_params() failed: %d\n", ret);
3178 if (sink->driver->ops && sink->driver->ops->hw_params) {
3179 substream.stream = SNDRV_PCM_STREAM_PLAYBACK;
3180 ret = sink->driver->ops->hw_params(&substream, params,
3184 "hw_params() failed: %d\n", ret);
3190 case SND_SOC_DAPM_POST_PMU:
3191 ret = snd_soc_dai_digital_mute(sink, 0);
3192 if (ret != 0 && ret != -ENOTSUPP)
3193 dev_warn(sink->dev, "Failed to unmute: %d\n", ret);
3197 case SND_SOC_DAPM_PRE_PMD:
3198 ret = snd_soc_dai_digital_mute(sink, 1);
3199 if (ret != 0 && ret != -ENOTSUPP)
3200 dev_warn(sink->dev, "Failed to mute: %d\n", ret);
3214 int snd_soc_dapm_new_pcm(struct snd_soc_card *card,
3215 const struct snd_soc_pcm_stream *params,
3216 struct snd_soc_dapm_widget *source,
3217 struct snd_soc_dapm_widget *sink)
3219 struct snd_soc_dapm_route routes[2];
3220 struct snd_soc_dapm_widget template;
3221 struct snd_soc_dapm_widget *w;
3225 len = strlen(source->name) + strlen(sink->name) + 2;
3226 link_name = devm_kzalloc(card->dev, len, GFP_KERNEL);
3229 snprintf(link_name, len, "%s-%s", source->name, sink->name);
3231 memset(&template, 0, sizeof(template));
3232 template.reg = SND_SOC_NOPM;
3233 template.id = snd_soc_dapm_dai_link;
3234 template.name = link_name;
3235 template.event = snd_soc_dai_link_event;
3236 template.event_flags = SND_SOC_DAPM_PRE_PMU | SND_SOC_DAPM_POST_PMU |
3237 SND_SOC_DAPM_PRE_PMD;
3239 dev_dbg(card->dev, "adding %s widget\n", link_name);
3241 w = snd_soc_dapm_new_control(&card->dapm, &template);
3243 dev_err(card->dev, "Failed to create %s widget\n",
3250 memset(&routes, 0, sizeof(routes));
3252 routes[0].source = source->name;
3253 routes[0].sink = link_name;
3254 routes[1].source = link_name;
3255 routes[1].sink = sink->name;
3257 return snd_soc_dapm_add_routes(&card->dapm, routes,
3258 ARRAY_SIZE(routes));
3261 int snd_soc_dapm_new_dai_widgets(struct snd_soc_dapm_context *dapm,
3262 struct snd_soc_dai *dai)
3264 struct snd_soc_dapm_widget template;
3265 struct snd_soc_dapm_widget *w;
3267 WARN_ON(dapm->dev != dai->dev);
3269 memset(&template, 0, sizeof(template));
3270 template.reg = SND_SOC_NOPM;
3272 if (dai->driver->playback.stream_name) {
3273 template.id = snd_soc_dapm_dai;
3274 template.name = dai->driver->playback.stream_name;
3275 template.sname = dai->driver->playback.stream_name;
3277 dev_dbg(dai->dev, "adding %s widget\n",
3280 w = snd_soc_dapm_new_control(dapm, &template);
3282 dev_err(dapm->dev, "Failed to create %s widget\n",
3283 dai->driver->playback.stream_name);
3287 dai->playback_widget = w;
3290 if (dai->driver->capture.stream_name) {
3291 template.id = snd_soc_dapm_dai;
3292 template.name = dai->driver->capture.stream_name;
3293 template.sname = dai->driver->capture.stream_name;
3295 dev_dbg(dai->dev, "adding %s widget\n",
3298 w = snd_soc_dapm_new_control(dapm, &template);
3300 dev_err(dapm->dev, "Failed to create %s widget\n",
3301 dai->driver->capture.stream_name);
3305 dai->capture_widget = w;
3311 int snd_soc_dapm_link_dai_widgets(struct snd_soc_card *card)
3313 struct snd_soc_dapm_widget *dai_w, *w;
3314 struct snd_soc_dai *dai;
3315 struct snd_soc_dapm_route r;
3317 memset(&r, 0, sizeof(r));
3319 /* For each DAI widget... */
3320 list_for_each_entry(dai_w, &card->widgets, list) {
3321 if (dai_w->id != snd_soc_dapm_dai)
3326 /* ...find all widgets with the same stream and link them */
3327 list_for_each_entry(w, &card->widgets, list) {
3328 if (w->dapm != dai_w->dapm)
3331 if (w->id == snd_soc_dapm_dai)
3337 if (dai->driver->playback.stream_name &&
3339 dai->driver->playback.stream_name)) {
3340 r.source = dai->playback_widget->name;
3342 dev_dbg(dai->dev, "%s -> %s\n",
3345 snd_soc_dapm_add_route(w->dapm, &r);
3348 if (dai->driver->capture.stream_name &&
3350 dai->driver->capture.stream_name)) {
3352 r.sink = dai->capture_widget->name;
3353 dev_dbg(dai->dev, "%s -> %s\n",
3356 snd_soc_dapm_add_route(w->dapm, &r);
3364 static void soc_dapm_stream_event(struct snd_soc_pcm_runtime *rtd, int stream,
3368 struct snd_soc_dapm_widget *w_cpu, *w_codec;
3369 struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
3370 struct snd_soc_dai *codec_dai = rtd->codec_dai;
3372 if (stream == SNDRV_PCM_STREAM_PLAYBACK) {
3373 w_cpu = cpu_dai->playback_widget;
3374 w_codec = codec_dai->playback_widget;
3376 w_cpu = cpu_dai->capture_widget;
3377 w_codec = codec_dai->capture_widget;
3382 dapm_mark_dirty(w_cpu, "stream event");
3385 case SND_SOC_DAPM_STREAM_START:
3388 case SND_SOC_DAPM_STREAM_STOP:
3391 case SND_SOC_DAPM_STREAM_SUSPEND:
3392 case SND_SOC_DAPM_STREAM_RESUME:
3393 case SND_SOC_DAPM_STREAM_PAUSE_PUSH:
3394 case SND_SOC_DAPM_STREAM_PAUSE_RELEASE:
3401 dapm_mark_dirty(w_codec, "stream event");
3404 case SND_SOC_DAPM_STREAM_START:
3405 w_codec->active = 1;
3407 case SND_SOC_DAPM_STREAM_STOP:
3408 w_codec->active = 0;
3410 case SND_SOC_DAPM_STREAM_SUSPEND:
3411 case SND_SOC_DAPM_STREAM_RESUME:
3412 case SND_SOC_DAPM_STREAM_PAUSE_PUSH:
3413 case SND_SOC_DAPM_STREAM_PAUSE_RELEASE:
3418 dapm_power_widgets(&rtd->card->dapm, event);
3422 * snd_soc_dapm_stream_event - send a stream event to the dapm core
3423 * @rtd: PCM runtime data
3424 * @stream: stream name
3425 * @event: stream event
3427 * Sends a stream event to the dapm core. The core then makes any
3428 * necessary widget power changes.
3430 * Returns 0 for success else error.
3432 void snd_soc_dapm_stream_event(struct snd_soc_pcm_runtime *rtd, int stream,
3435 struct snd_soc_card *card = rtd->card;
3437 mutex_lock_nested(&card->dapm_mutex, SND_SOC_DAPM_CLASS_RUNTIME);
3438 soc_dapm_stream_event(rtd, stream, event);
3439 mutex_unlock(&card->dapm_mutex);
3443 * snd_soc_dapm_enable_pin - enable pin.
3444 * @dapm: DAPM context
3447 * Enables input/output pin and its parents or children widgets iff there is
3448 * a valid audio route and active audio stream.
3449 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
3450 * do any widget power switching.
3452 int snd_soc_dapm_enable_pin(struct snd_soc_dapm_context *dapm, const char *pin)
3454 return snd_soc_dapm_set_pin(dapm, pin, 1);
3456 EXPORT_SYMBOL_GPL(snd_soc_dapm_enable_pin);
3459 * snd_soc_dapm_force_enable_pin - force a pin to be enabled
3460 * @dapm: DAPM context
3463 * Enables input/output pin regardless of any other state. This is
3464 * intended for use with microphone bias supplies used in microphone
3467 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
3468 * do any widget power switching.
3470 int snd_soc_dapm_force_enable_pin(struct snd_soc_dapm_context *dapm,
3473 struct snd_soc_dapm_widget *w = dapm_find_widget(dapm, pin, true);
3476 dev_err(dapm->dev, "dapm: unknown pin %s\n", pin);
3480 dev_dbg(w->dapm->dev, "dapm: force enable pin %s\n", pin);
3483 dapm_mark_dirty(w, "force enable");
3487 EXPORT_SYMBOL_GPL(snd_soc_dapm_force_enable_pin);
3490 * snd_soc_dapm_disable_pin - disable pin.
3491 * @dapm: DAPM context
3494 * Disables input/output pin and its parents or children widgets.
3495 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
3496 * do any widget power switching.
3498 int snd_soc_dapm_disable_pin(struct snd_soc_dapm_context *dapm,
3501 return snd_soc_dapm_set_pin(dapm, pin, 0);
3503 EXPORT_SYMBOL_GPL(snd_soc_dapm_disable_pin);
3506 * snd_soc_dapm_nc_pin - permanently disable pin.
3507 * @dapm: DAPM context
3510 * Marks the specified pin as being not connected, disabling it along
3511 * any parent or child widgets. At present this is identical to
3512 * snd_soc_dapm_disable_pin() but in future it will be extended to do
3513 * additional things such as disabling controls which only affect
3514 * paths through the pin.
3516 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
3517 * do any widget power switching.
3519 int snd_soc_dapm_nc_pin(struct snd_soc_dapm_context *dapm, const char *pin)
3521 return snd_soc_dapm_set_pin(dapm, pin, 0);
3523 EXPORT_SYMBOL_GPL(snd_soc_dapm_nc_pin);
3526 * snd_soc_dapm_get_pin_status - get audio pin status
3527 * @dapm: DAPM context
3528 * @pin: audio signal pin endpoint (or start point)
3530 * Get audio pin status - connected or disconnected.
3532 * Returns 1 for connected otherwise 0.
3534 int snd_soc_dapm_get_pin_status(struct snd_soc_dapm_context *dapm,
3537 struct snd_soc_dapm_widget *w = dapm_find_widget(dapm, pin, true);
3540 return w->connected;
3544 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_pin_status);
3547 * snd_soc_dapm_ignore_suspend - ignore suspend status for DAPM endpoint
3548 * @dapm: DAPM context
3549 * @pin: audio signal pin endpoint (or start point)
3551 * Mark the given endpoint or pin as ignoring suspend. When the
3552 * system is disabled a path between two endpoints flagged as ignoring
3553 * suspend will not be disabled. The path must already be enabled via
3554 * normal means at suspend time, it will not be turned on if it was not
3557 int snd_soc_dapm_ignore_suspend(struct snd_soc_dapm_context *dapm,
3560 struct snd_soc_dapm_widget *w = dapm_find_widget(dapm, pin, false);
3563 dev_err(dapm->dev, "dapm: unknown pin %s\n", pin);
3567 w->ignore_suspend = 1;
3571 EXPORT_SYMBOL_GPL(snd_soc_dapm_ignore_suspend);
3573 static bool snd_soc_dapm_widget_in_card_paths(struct snd_soc_card *card,
3574 struct snd_soc_dapm_widget *w)
3576 struct snd_soc_dapm_path *p;
3578 list_for_each_entry(p, &card->paths, list) {
3579 if ((p->source == w) || (p->sink == w)) {
3581 "... Path %s(id:%d dapm:%p) - %s(id:%d dapm:%p)\n",
3582 p->source->name, p->source->id, p->source->dapm,
3583 p->sink->name, p->sink->id, p->sink->dapm);
3585 /* Connected to something other than the codec */
3586 if (p->source->dapm != p->sink->dapm)
3589 * Loopback connection from codec external pin to
3590 * codec external pin
3592 if (p->sink->id == snd_soc_dapm_input) {
3593 switch (p->source->id) {
3594 case snd_soc_dapm_output:
3595 case snd_soc_dapm_micbias:
3608 * snd_soc_dapm_auto_nc_codec_pins - call snd_soc_dapm_nc_pin for unused pins
3609 * @codec: The codec whose pins should be processed
3611 * Automatically call snd_soc_dapm_nc_pin() for any external pins in the codec
3612 * which are unused. Pins are used if they are connected externally to the
3613 * codec, whether that be to some other device, or a loop-back connection to
3616 void snd_soc_dapm_auto_nc_codec_pins(struct snd_soc_codec *codec)
3618 struct snd_soc_card *card = codec->card;
3619 struct snd_soc_dapm_context *dapm = &codec->dapm;
3620 struct snd_soc_dapm_widget *w;
3622 dev_dbg(codec->dev, "Auto NC: DAPMs: card:%p codec:%p\n",
3623 &card->dapm, &codec->dapm);
3625 list_for_each_entry(w, &card->widgets, list) {
3626 if (w->dapm != dapm)
3629 case snd_soc_dapm_input:
3630 case snd_soc_dapm_output:
3631 case snd_soc_dapm_micbias:
3632 dev_dbg(codec->dev, "Auto NC: Checking widget %s\n",
3634 if (!snd_soc_dapm_widget_in_card_paths(card, w)) {
3636 "... Not in map; disabling\n");
3637 snd_soc_dapm_nc_pin(dapm, w->name);
3647 * snd_soc_dapm_free - free dapm resources
3648 * @dapm: DAPM context
3650 * Free all dapm widgets and resources.
3652 void snd_soc_dapm_free(struct snd_soc_dapm_context *dapm)
3654 snd_soc_dapm_sys_remove(dapm->dev);
3655 dapm_debugfs_cleanup(dapm);
3656 dapm_free_widgets(dapm);
3657 list_del(&dapm->list);
3659 EXPORT_SYMBOL_GPL(snd_soc_dapm_free);
3661 static void soc_dapm_shutdown_codec(struct snd_soc_dapm_context *dapm)
3663 struct snd_soc_dapm_widget *w;
3664 LIST_HEAD(down_list);
3667 list_for_each_entry(w, &dapm->card->widgets, list) {
3668 if (w->dapm != dapm)
3671 dapm_seq_insert(w, &down_list, false);
3677 /* If there were no widgets to power down we're already in
3681 if (dapm->bias_level == SND_SOC_BIAS_ON)
3682 snd_soc_dapm_set_bias_level(dapm,
3683 SND_SOC_BIAS_PREPARE);
3684 dapm_seq_run(dapm, &down_list, 0, false);
3685 if (dapm->bias_level == SND_SOC_BIAS_PREPARE)
3686 snd_soc_dapm_set_bias_level(dapm,
3687 SND_SOC_BIAS_STANDBY);
3692 * snd_soc_dapm_shutdown - callback for system shutdown
3694 void snd_soc_dapm_shutdown(struct snd_soc_card *card)
3696 struct snd_soc_codec *codec;
3698 list_for_each_entry(codec, &card->codec_dev_list, list) {
3699 soc_dapm_shutdown_codec(&codec->dapm);
3700 if (codec->dapm.bias_level == SND_SOC_BIAS_STANDBY)
3701 snd_soc_dapm_set_bias_level(&codec->dapm,
3706 /* Module information */
3707 MODULE_AUTHOR("Liam Girdwood, lrg@slimlogic.co.uk");
3708 MODULE_DESCRIPTION("Dynamic Audio Power Management core for ALSA SoC");
3709 MODULE_LICENSE("GPL");