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/meadphone insertion events.
18 * o Automatic Mic Bias support
19 * o Jack insertion power event initiation - e.g. hp insertion will enable
21 * o Delayed powerdown of audio susbsystem to reduce pops between a quick
25 * o DAPM power change sequencing - allow for configurable per
27 * o Support for analogue bias optimisation.
28 * o Support for reduced codec oversampling rates.
29 * o Support for reduced codec bias currents.
32 #include <linux/module.h>
33 #include <linux/moduleparam.h>
34 #include <linux/init.h>
35 #include <linux/async.h>
36 #include <linux/delay.h>
38 #include <linux/bitops.h>
39 #include <linux/platform_device.h>
40 #include <linux/jiffies.h>
41 #include <linux/debugfs.h>
42 #include <linux/pm_runtime.h>
43 #include <linux/regulator/consumer.h>
44 #include <linux/slab.h>
45 #include <sound/core.h>
46 #include <sound/pcm.h>
47 #include <sound/pcm_params.h>
48 #include <sound/soc.h>
49 #include <sound/initval.h>
51 #include <trace/events/asoc.h>
53 #define DAPM_UPDATE_STAT(widget, val) widget->dapm->card->dapm_stats.val++;
55 /* dapm power sequences - make this per codec in the future */
56 static int dapm_up_seq
[] = {
57 [snd_soc_dapm_pre
] = 0,
58 [snd_soc_dapm_supply
] = 1,
59 [snd_soc_dapm_regulator_supply
] = 1,
60 [snd_soc_dapm_micbias
] = 2,
61 [snd_soc_dapm_aif_in
] = 3,
62 [snd_soc_dapm_aif_out
] = 3,
63 [snd_soc_dapm_mic
] = 4,
64 [snd_soc_dapm_mux
] = 5,
65 [snd_soc_dapm_virt_mux
] = 5,
66 [snd_soc_dapm_value_mux
] = 5,
67 [snd_soc_dapm_dac
] = 6,
68 [snd_soc_dapm_mixer
] = 7,
69 [snd_soc_dapm_mixer_named_ctl
] = 7,
70 [snd_soc_dapm_pga
] = 8,
71 [snd_soc_dapm_adc
] = 9,
72 [snd_soc_dapm_out_drv
] = 10,
73 [snd_soc_dapm_hp
] = 10,
74 [snd_soc_dapm_spk
] = 10,
75 [snd_soc_dapm_post
] = 11,
78 static int dapm_down_seq
[] = {
79 [snd_soc_dapm_pre
] = 0,
80 [snd_soc_dapm_adc
] = 1,
81 [snd_soc_dapm_hp
] = 2,
82 [snd_soc_dapm_spk
] = 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_regulator_supply
] = 11,
96 [snd_soc_dapm_supply
] = 11,
97 [snd_soc_dapm_post
] = 12,
100 static void pop_wait(u32 pop_time
)
103 schedule_timeout_uninterruptible(msecs_to_jiffies(pop_time
));
106 static void pop_dbg(struct device
*dev
, u32 pop_time
, const char *fmt
, ...)
114 buf
= kmalloc(PAGE_SIZE
, GFP_KERNEL
);
119 vsnprintf(buf
, PAGE_SIZE
, fmt
, args
);
120 dev_info(dev
, "%s", buf
);
126 static bool dapm_dirty_widget(struct snd_soc_dapm_widget
*w
)
128 return !list_empty(&w
->dirty
);
131 void dapm_mark_dirty(struct snd_soc_dapm_widget
*w
, const char *reason
)
133 if (!dapm_dirty_widget(w
)) {
134 dev_vdbg(w
->dapm
->dev
, "Marking %s dirty due to %s\n",
136 list_add_tail(&w
->dirty
, &w
->dapm
->card
->dapm_dirty
);
139 EXPORT_SYMBOL_GPL(dapm_mark_dirty
);
141 /* create a new dapm widget */
142 static inline struct snd_soc_dapm_widget
*dapm_cnew_widget(
143 const struct snd_soc_dapm_widget
*_widget
)
145 return kmemdup(_widget
, sizeof(*_widget
), GFP_KERNEL
);
148 /* get snd_card from DAPM context */
149 static inline struct snd_card
*dapm_get_snd_card(
150 struct snd_soc_dapm_context
*dapm
)
153 return dapm
->codec
->card
->snd_card
;
154 else if (dapm
->platform
)
155 return dapm
->platform
->card
->snd_card
;
163 /* get soc_card from DAPM context */
164 static inline struct snd_soc_card
*dapm_get_soc_card(
165 struct snd_soc_dapm_context
*dapm
)
168 return dapm
->codec
->card
;
169 else if (dapm
->platform
)
170 return dapm
->platform
->card
;
178 static int soc_widget_read(struct snd_soc_dapm_widget
*w
, int reg
)
181 return snd_soc_read(w
->codec
, reg
);
182 else if (w
->platform
)
183 return snd_soc_platform_read(w
->platform
, reg
);
185 dev_err(w
->dapm
->dev
, "no valid widget read method\n");
189 static int soc_widget_write(struct snd_soc_dapm_widget
*w
, int reg
, int val
)
192 return snd_soc_write(w
->codec
, reg
, val
);
193 else if (w
->platform
)
194 return snd_soc_platform_write(w
->platform
, reg
, val
);
196 dev_err(w
->dapm
->dev
, "no valid widget write method\n");
200 static int soc_widget_update_bits(struct snd_soc_dapm_widget
*w
,
201 unsigned short reg
, unsigned int mask
, unsigned int value
)
204 unsigned int old
, new;
207 if (w
->codec
&& w
->codec
->using_regmap
) {
208 ret
= regmap_update_bits_check(w
->codec
->control_data
,
209 reg
, mask
, value
, &change
);
213 ret
= soc_widget_read(w
, reg
);
218 new = (old
& ~mask
) | (value
& mask
);
221 ret
= soc_widget_write(w
, reg
, new);
231 * snd_soc_dapm_set_bias_level - set the bias level for the system
232 * @dapm: DAPM context
233 * @level: level to configure
235 * Configure the bias (power) levels for the SoC audio device.
237 * Returns 0 for success else error.
239 static int snd_soc_dapm_set_bias_level(struct snd_soc_dapm_context
*dapm
,
240 enum snd_soc_bias_level level
)
242 struct snd_soc_card
*card
= dapm
->card
;
245 trace_snd_soc_bias_level_start(card
, level
);
247 if (card
&& card
->set_bias_level
)
248 ret
= card
->set_bias_level(card
, dapm
, level
);
253 if (dapm
->codec
->driver
->set_bias_level
)
254 ret
= dapm
->codec
->driver
->set_bias_level(dapm
->codec
,
257 dapm
->bias_level
= level
;
262 if (card
&& card
->set_bias_level_post
)
263 ret
= card
->set_bias_level_post(card
, dapm
, level
);
265 trace_snd_soc_bias_level_done(card
, level
);
270 /* set up initial codec paths */
271 static void dapm_set_path_status(struct snd_soc_dapm_widget
*w
,
272 struct snd_soc_dapm_path
*p
, int i
)
275 case snd_soc_dapm_switch
:
276 case snd_soc_dapm_mixer
:
277 case snd_soc_dapm_mixer_named_ctl
: {
279 struct soc_mixer_control
*mc
= (struct soc_mixer_control
*)
280 w
->kcontrol_news
[i
].private_value
;
281 unsigned int reg
= mc
->reg
;
282 unsigned int shift
= mc
->shift
;
284 unsigned int mask
= (1 << fls(max
)) - 1;
285 unsigned int invert
= mc
->invert
;
287 val
= soc_widget_read(w
, reg
);
288 val
= (val
>> shift
) & mask
;
290 if ((invert
&& !val
) || (!invert
&& val
))
296 case snd_soc_dapm_mux
: {
297 struct soc_enum
*e
= (struct soc_enum
*)
298 w
->kcontrol_news
[i
].private_value
;
299 int val
, item
, bitmask
;
301 for (bitmask
= 1; bitmask
< e
->max
; bitmask
<<= 1)
303 val
= soc_widget_read(w
, e
->reg
);
304 item
= (val
>> e
->shift_l
) & (bitmask
- 1);
307 for (i
= 0; i
< e
->max
; i
++) {
308 if (!(strcmp(p
->name
, e
->texts
[i
])) && item
== i
)
313 case snd_soc_dapm_virt_mux
: {
314 struct soc_enum
*e
= (struct soc_enum
*)
315 w
->kcontrol_news
[i
].private_value
;
318 /* since a virtual mux has no backing registers to
319 * decide which path to connect, it will try to match
320 * with the first enumeration. This is to ensure
321 * that the default mux choice (the first) will be
322 * correctly powered up during initialization.
324 if (!strcmp(p
->name
, e
->texts
[0]))
328 case snd_soc_dapm_value_mux
: {
329 struct soc_enum
*e
= (struct soc_enum
*)
330 w
->kcontrol_news
[i
].private_value
;
333 val
= soc_widget_read(w
, e
->reg
);
334 val
= (val
>> e
->shift_l
) & e
->mask
;
335 for (item
= 0; item
< e
->max
; item
++) {
336 if (val
== e
->values
[item
])
341 for (i
= 0; i
< e
->max
; i
++) {
342 if (!(strcmp(p
->name
, e
->texts
[i
])) && item
== i
)
347 /* does not affect routing - always connected */
348 case snd_soc_dapm_pga
:
349 case snd_soc_dapm_out_drv
:
350 case snd_soc_dapm_output
:
351 case snd_soc_dapm_adc
:
352 case snd_soc_dapm_input
:
353 case snd_soc_dapm_siggen
:
354 case snd_soc_dapm_dac
:
355 case snd_soc_dapm_micbias
:
356 case snd_soc_dapm_vmid
:
357 case snd_soc_dapm_supply
:
358 case snd_soc_dapm_regulator_supply
:
359 case snd_soc_dapm_aif_in
:
360 case snd_soc_dapm_aif_out
:
361 case snd_soc_dapm_hp
:
362 case snd_soc_dapm_mic
:
363 case snd_soc_dapm_spk
:
364 case snd_soc_dapm_line
:
367 /* does affect routing - dynamically connected */
368 case snd_soc_dapm_pre
:
369 case snd_soc_dapm_post
:
375 /* connect mux widget to its interconnecting audio paths */
376 static int dapm_connect_mux(struct snd_soc_dapm_context
*dapm
,
377 struct snd_soc_dapm_widget
*src
, struct snd_soc_dapm_widget
*dest
,
378 struct snd_soc_dapm_path
*path
, const char *control_name
,
379 const struct snd_kcontrol_new
*kcontrol
)
381 struct soc_enum
*e
= (struct soc_enum
*)kcontrol
->private_value
;
384 for (i
= 0; i
< e
->max
; i
++) {
385 if (!(strcmp(control_name
, e
->texts
[i
]))) {
386 list_add(&path
->list
, &dapm
->card
->paths
);
387 list_add(&path
->list_sink
, &dest
->sources
);
388 list_add(&path
->list_source
, &src
->sinks
);
389 path
->name
= (char*)e
->texts
[i
];
390 dapm_set_path_status(dest
, path
, 0);
398 /* connect mixer widget to its interconnecting audio paths */
399 static int dapm_connect_mixer(struct snd_soc_dapm_context
*dapm
,
400 struct snd_soc_dapm_widget
*src
, struct snd_soc_dapm_widget
*dest
,
401 struct snd_soc_dapm_path
*path
, const char *control_name
)
405 /* search for mixer kcontrol */
406 for (i
= 0; i
< dest
->num_kcontrols
; i
++) {
407 if (!strcmp(control_name
, dest
->kcontrol_news
[i
].name
)) {
408 list_add(&path
->list
, &dapm
->card
->paths
);
409 list_add(&path
->list_sink
, &dest
->sources
);
410 list_add(&path
->list_source
, &src
->sinks
);
411 path
->name
= dest
->kcontrol_news
[i
].name
;
412 dapm_set_path_status(dest
, path
, i
);
419 static int dapm_is_shared_kcontrol(struct snd_soc_dapm_context
*dapm
,
420 struct snd_soc_dapm_widget
*kcontrolw
,
421 const struct snd_kcontrol_new
*kcontrol_new
,
422 struct snd_kcontrol
**kcontrol
)
424 struct snd_soc_dapm_widget
*w
;
429 list_for_each_entry(w
, &dapm
->card
->widgets
, list
) {
430 if (w
== kcontrolw
|| w
->dapm
!= kcontrolw
->dapm
)
432 for (i
= 0; i
< w
->num_kcontrols
; i
++) {
433 if (&w
->kcontrol_news
[i
] == kcontrol_new
) {
435 *kcontrol
= w
->kcontrols
[i
];
444 /* create new dapm mixer control */
445 static int dapm_new_mixer(struct snd_soc_dapm_widget
*w
)
447 struct snd_soc_dapm_context
*dapm
= w
->dapm
;
449 size_t name_len
, prefix_len
;
450 struct snd_soc_dapm_path
*path
;
451 struct snd_card
*card
= dapm
->card
->snd_card
;
453 struct snd_soc_dapm_widget_list
*wlist
;
457 prefix
= dapm
->codec
->name_prefix
;
462 prefix_len
= strlen(prefix
) + 1;
467 for (i
= 0; i
< w
->num_kcontrols
; i
++) {
470 list_for_each_entry(path
, &w
->sources
, list_sink
) {
472 /* mixer/mux paths name must match control name */
473 if (path
->name
!= (char *)w
->kcontrol_news
[i
].name
)
476 if (w
->kcontrols
[i
]) {
477 path
->kcontrol
= w
->kcontrols
[i
];
481 wlistsize
= sizeof(struct snd_soc_dapm_widget_list
) +
482 sizeof(struct snd_soc_dapm_widget
*),
483 wlist
= kzalloc(wlistsize
, GFP_KERNEL
);
486 "asoc: can't allocate widget list for %s\n",
490 wlist
->num_widgets
= 1;
491 wlist
->widgets
[0] = w
;
493 /* add dapm control with long name.
494 * for dapm_mixer this is the concatenation of the
495 * mixer and kcontrol name.
496 * for dapm_mixer_named_ctl this is simply the
499 name_len
= strlen(w
->kcontrol_news
[i
].name
) + 1;
500 if (w
->id
!= snd_soc_dapm_mixer_named_ctl
)
501 name_len
+= 1 + strlen(w
->name
);
503 path
->long_name
= kmalloc(name_len
, GFP_KERNEL
);
505 if (path
->long_name
== NULL
) {
512 /* The control will get a prefix from
513 * the control creation process but
514 * we're also using the same prefix
515 * for widgets so cut the prefix off
516 * the front of the widget name.
518 snprintf(path
->long_name
, name_len
, "%s %s",
519 w
->name
+ prefix_len
,
520 w
->kcontrol_news
[i
].name
);
522 case snd_soc_dapm_mixer_named_ctl
:
523 snprintf(path
->long_name
, name_len
, "%s",
524 w
->kcontrol_news
[i
].name
);
528 path
->long_name
[name_len
- 1] = '\0';
530 path
->kcontrol
= snd_soc_cnew(&w
->kcontrol_news
[i
],
531 wlist
, path
->long_name
,
533 ret
= snd_ctl_add(card
, path
->kcontrol
);
536 "asoc: failed to add dapm kcontrol %s: %d\n",
537 path
->long_name
, ret
);
539 kfree(path
->long_name
);
540 path
->long_name
= NULL
;
543 w
->kcontrols
[i
] = path
->kcontrol
;
549 /* create new dapm mux control */
550 static int dapm_new_mux(struct snd_soc_dapm_widget
*w
)
552 struct snd_soc_dapm_context
*dapm
= w
->dapm
;
553 struct snd_soc_dapm_path
*path
= NULL
;
554 struct snd_kcontrol
*kcontrol
;
555 struct snd_card
*card
= dapm
->card
->snd_card
;
559 struct snd_soc_dapm_widget_list
*wlist
;
560 int shared
, wlistentries
;
564 if (w
->num_kcontrols
!= 1) {
566 "asoc: mux %s has incorrect number of controls\n",
571 shared
= dapm_is_shared_kcontrol(dapm
, w
, &w
->kcontrol_news
[0],
574 wlist
= kcontrol
->private_data
;
575 wlistentries
= wlist
->num_widgets
+ 1;
580 wlistsize
= sizeof(struct snd_soc_dapm_widget_list
) +
581 wlistentries
* sizeof(struct snd_soc_dapm_widget
*),
582 wlist
= krealloc(wlist
, wlistsize
, GFP_KERNEL
);
585 "asoc: can't allocate widget list for %s\n", w
->name
);
588 wlist
->num_widgets
= wlistentries
;
589 wlist
->widgets
[wlistentries
- 1] = w
;
593 prefix
= dapm
->codec
->name_prefix
;
598 name
= w
->kcontrol_news
[0].name
;
603 prefix_len
= strlen(prefix
) + 1;
609 * The control will get a prefix from the control creation
610 * process but we're also using the same prefix for widgets so
611 * cut the prefix off the front of the widget name.
613 kcontrol
= snd_soc_cnew(&w
->kcontrol_news
[0], wlist
,
614 name
+ prefix_len
, prefix
);
615 ret
= snd_ctl_add(card
, kcontrol
);
617 dev_err(dapm
->dev
, "failed to add kcontrol %s: %d\n",
624 kcontrol
->private_data
= wlist
;
626 w
->kcontrols
[0] = kcontrol
;
628 list_for_each_entry(path
, &w
->sources
, list_sink
)
629 path
->kcontrol
= kcontrol
;
634 /* create new dapm volume control */
635 static int dapm_new_pga(struct snd_soc_dapm_widget
*w
)
637 if (w
->num_kcontrols
)
638 dev_err(w
->dapm
->dev
,
639 "asoc: PGA controls not supported: '%s'\n", w
->name
);
644 /* reset 'walked' bit for each dapm path */
645 static inline void dapm_clear_walk(struct snd_soc_dapm_context
*dapm
)
647 struct snd_soc_dapm_path
*p
;
649 list_for_each_entry(p
, &dapm
->card
->paths
, list
)
653 /* We implement power down on suspend by checking the power state of
654 * the ALSA card - when we are suspending the ALSA state for the card
657 static int snd_soc_dapm_suspend_check(struct snd_soc_dapm_widget
*widget
)
659 int level
= snd_power_get_state(widget
->dapm
->card
->snd_card
);
662 case SNDRV_CTL_POWER_D3hot
:
663 case SNDRV_CTL_POWER_D3cold
:
664 if (widget
->ignore_suspend
)
665 dev_dbg(widget
->dapm
->dev
, "%s ignoring suspend\n",
667 return widget
->ignore_suspend
;
674 * Recursively check for a completed path to an active or physically connected
675 * output widget. Returns number of complete paths.
677 static int is_connected_output_ep(struct snd_soc_dapm_widget
*widget
)
679 struct snd_soc_dapm_path
*path
;
682 if (widget
->outputs
>= 0)
683 return widget
->outputs
;
685 DAPM_UPDATE_STAT(widget
, path_checks
);
687 switch (widget
->id
) {
688 case snd_soc_dapm_supply
:
689 case snd_soc_dapm_regulator_supply
:
695 switch (widget
->id
) {
696 case snd_soc_dapm_adc
:
697 case snd_soc_dapm_aif_out
:
698 if (widget
->active
) {
699 widget
->outputs
= snd_soc_dapm_suspend_check(widget
);
700 return widget
->outputs
;
706 if (widget
->connected
) {
707 /* connected pin ? */
708 if (widget
->id
== snd_soc_dapm_output
&& !widget
->ext
) {
709 widget
->outputs
= snd_soc_dapm_suspend_check(widget
);
710 return widget
->outputs
;
713 /* connected jack or spk ? */
714 if (widget
->id
== snd_soc_dapm_hp
||
715 widget
->id
== snd_soc_dapm_spk
||
716 (widget
->id
== snd_soc_dapm_line
&&
717 !list_empty(&widget
->sources
))) {
718 widget
->outputs
= snd_soc_dapm_suspend_check(widget
);
719 return widget
->outputs
;
723 list_for_each_entry(path
, &widget
->sinks
, list_source
) {
724 DAPM_UPDATE_STAT(widget
, neighbour_checks
);
732 if (path
->sink
&& path
->connect
) {
734 con
+= is_connected_output_ep(path
->sink
);
738 widget
->outputs
= con
;
744 * Recursively check for a completed path to an active or physically connected
745 * input widget. Returns number of complete paths.
747 static int is_connected_input_ep(struct snd_soc_dapm_widget
*widget
)
749 struct snd_soc_dapm_path
*path
;
752 if (widget
->inputs
>= 0)
753 return widget
->inputs
;
755 DAPM_UPDATE_STAT(widget
, path_checks
);
757 switch (widget
->id
) {
758 case snd_soc_dapm_supply
:
759 case snd_soc_dapm_regulator_supply
:
765 /* active stream ? */
766 switch (widget
->id
) {
767 case snd_soc_dapm_dac
:
768 case snd_soc_dapm_aif_in
:
769 if (widget
->active
) {
770 widget
->inputs
= snd_soc_dapm_suspend_check(widget
);
771 return widget
->inputs
;
777 if (widget
->connected
) {
778 /* connected pin ? */
779 if (widget
->id
== snd_soc_dapm_input
&& !widget
->ext
) {
780 widget
->inputs
= snd_soc_dapm_suspend_check(widget
);
781 return widget
->inputs
;
784 /* connected VMID/Bias for lower pops */
785 if (widget
->id
== snd_soc_dapm_vmid
) {
786 widget
->inputs
= snd_soc_dapm_suspend_check(widget
);
787 return widget
->inputs
;
790 /* connected jack ? */
791 if (widget
->id
== snd_soc_dapm_mic
||
792 (widget
->id
== snd_soc_dapm_line
&&
793 !list_empty(&widget
->sinks
))) {
794 widget
->inputs
= snd_soc_dapm_suspend_check(widget
);
795 return widget
->inputs
;
798 /* signal generator */
799 if (widget
->id
== snd_soc_dapm_siggen
) {
800 widget
->inputs
= snd_soc_dapm_suspend_check(widget
);
801 return widget
->inputs
;
805 list_for_each_entry(path
, &widget
->sources
, list_sink
) {
806 DAPM_UPDATE_STAT(widget
, neighbour_checks
);
814 if (path
->source
&& path
->connect
) {
816 con
+= is_connected_input_ep(path
->source
);
820 widget
->inputs
= con
;
826 * Handler for generic register modifier widget.
828 int dapm_reg_event(struct snd_soc_dapm_widget
*w
,
829 struct snd_kcontrol
*kcontrol
, int event
)
833 if (SND_SOC_DAPM_EVENT_ON(event
))
838 soc_widget_update_bits(w
, -(w
->reg
+ 1),
839 w
->mask
<< w
->shift
, val
<< w
->shift
);
843 EXPORT_SYMBOL_GPL(dapm_reg_event
);
846 * Handler for regulator supply widget.
848 int dapm_regulator_event(struct snd_soc_dapm_widget
*w
,
849 struct snd_kcontrol
*kcontrol
, int event
)
851 if (SND_SOC_DAPM_EVENT_ON(event
))
852 return regulator_enable(w
->priv
);
854 return regulator_disable_deferred(w
->priv
, w
->shift
);
856 EXPORT_SYMBOL_GPL(dapm_regulator_event
);
858 static int dapm_widget_power_check(struct snd_soc_dapm_widget
*w
)
860 if (w
->power_checked
)
866 w
->new_power
= w
->power_check(w
);
868 w
->power_checked
= true;
873 /* Generic check to see if a widget should be powered.
875 static int dapm_generic_check_power(struct snd_soc_dapm_widget
*w
)
879 DAPM_UPDATE_STAT(w
, power_checks
);
881 in
= is_connected_input_ep(w
);
882 dapm_clear_walk(w
->dapm
);
883 out
= is_connected_output_ep(w
);
884 dapm_clear_walk(w
->dapm
);
885 return out
!= 0 && in
!= 0;
888 /* Check to see if an ADC has power */
889 static int dapm_adc_check_power(struct snd_soc_dapm_widget
*w
)
893 DAPM_UPDATE_STAT(w
, power_checks
);
896 in
= is_connected_input_ep(w
);
897 dapm_clear_walk(w
->dapm
);
900 return dapm_generic_check_power(w
);
904 /* Check to see if a DAC has power */
905 static int dapm_dac_check_power(struct snd_soc_dapm_widget
*w
)
909 DAPM_UPDATE_STAT(w
, power_checks
);
912 out
= is_connected_output_ep(w
);
913 dapm_clear_walk(w
->dapm
);
916 return dapm_generic_check_power(w
);
920 /* Check to see if a power supply is needed */
921 static int dapm_supply_check_power(struct snd_soc_dapm_widget
*w
)
923 struct snd_soc_dapm_path
*path
;
925 DAPM_UPDATE_STAT(w
, power_checks
);
927 /* Check if one of our outputs is connected */
928 list_for_each_entry(path
, &w
->sinks
, list_source
) {
929 DAPM_UPDATE_STAT(w
, neighbour_checks
);
934 if (path
->connected
&&
935 !path
->connected(path
->source
, path
->sink
))
941 if (dapm_widget_power_check(path
->sink
))
945 dapm_clear_walk(w
->dapm
);
950 static int dapm_always_on_check_power(struct snd_soc_dapm_widget
*w
)
955 static int dapm_seq_compare(struct snd_soc_dapm_widget
*a
,
956 struct snd_soc_dapm_widget
*b
,
964 sort
= dapm_down_seq
;
966 if (sort
[a
->id
] != sort
[b
->id
])
967 return sort
[a
->id
] - sort
[b
->id
];
968 if (a
->subseq
!= b
->subseq
) {
970 return a
->subseq
- b
->subseq
;
972 return b
->subseq
- a
->subseq
;
974 if (a
->reg
!= b
->reg
)
975 return a
->reg
- b
->reg
;
976 if (a
->dapm
!= b
->dapm
)
977 return (unsigned long)a
->dapm
- (unsigned long)b
->dapm
;
982 /* Insert a widget in order into a DAPM power sequence. */
983 static void dapm_seq_insert(struct snd_soc_dapm_widget
*new_widget
,
984 struct list_head
*list
,
987 struct snd_soc_dapm_widget
*w
;
989 list_for_each_entry(w
, list
, power_list
)
990 if (dapm_seq_compare(new_widget
, w
, power_up
) < 0) {
991 list_add_tail(&new_widget
->power_list
, &w
->power_list
);
995 list_add_tail(&new_widget
->power_list
, list
);
998 static void dapm_seq_check_event(struct snd_soc_dapm_context
*dapm
,
999 struct snd_soc_dapm_widget
*w
, int event
)
1001 struct snd_soc_card
*card
= dapm
->card
;
1002 const char *ev_name
;
1006 case SND_SOC_DAPM_PRE_PMU
:
1007 ev_name
= "PRE_PMU";
1010 case SND_SOC_DAPM_POST_PMU
:
1011 ev_name
= "POST_PMU";
1014 case SND_SOC_DAPM_PRE_PMD
:
1015 ev_name
= "PRE_PMD";
1018 case SND_SOC_DAPM_POST_PMD
:
1019 ev_name
= "POST_PMD";
1027 if (w
->power
!= power
)
1030 if (w
->event
&& (w
->event_flags
& event
)) {
1031 pop_dbg(dapm
->dev
, card
->pop_time
, "pop test : %s %s\n",
1033 trace_snd_soc_dapm_widget_event_start(w
, event
);
1034 ret
= w
->event(w
, NULL
, event
);
1035 trace_snd_soc_dapm_widget_event_done(w
, event
);
1037 pr_err("%s: %s event failed: %d\n",
1038 ev_name
, w
->name
, ret
);
1042 /* Apply the coalesced changes from a DAPM sequence */
1043 static void dapm_seq_run_coalesced(struct snd_soc_dapm_context
*dapm
,
1044 struct list_head
*pending
)
1046 struct snd_soc_card
*card
= dapm
->card
;
1047 struct snd_soc_dapm_widget
*w
;
1049 unsigned int value
= 0;
1050 unsigned int mask
= 0;
1051 unsigned int cur_mask
;
1053 reg
= list_first_entry(pending
, struct snd_soc_dapm_widget
,
1056 list_for_each_entry(w
, pending
, power_list
) {
1057 cur_mask
= 1 << w
->shift
;
1058 BUG_ON(reg
!= w
->reg
);
1069 pop_dbg(dapm
->dev
, card
->pop_time
,
1070 "pop test : Queue %s: reg=0x%x, 0x%x/0x%x\n",
1071 w
->name
, reg
, value
, mask
);
1073 /* Check for events */
1074 dapm_seq_check_event(dapm
, w
, SND_SOC_DAPM_PRE_PMU
);
1075 dapm_seq_check_event(dapm
, w
, SND_SOC_DAPM_PRE_PMD
);
1079 /* Any widget will do, they should all be updating the
1082 w
= list_first_entry(pending
, struct snd_soc_dapm_widget
,
1085 pop_dbg(dapm
->dev
, card
->pop_time
,
1086 "pop test : Applying 0x%x/0x%x to %x in %dms\n",
1087 value
, mask
, reg
, card
->pop_time
);
1088 pop_wait(card
->pop_time
);
1089 soc_widget_update_bits(w
, reg
, mask
, value
);
1092 list_for_each_entry(w
, pending
, power_list
) {
1093 dapm_seq_check_event(dapm
, w
, SND_SOC_DAPM_POST_PMU
);
1094 dapm_seq_check_event(dapm
, w
, SND_SOC_DAPM_POST_PMD
);
1098 /* Apply a DAPM power sequence.
1100 * We walk over a pre-sorted list of widgets to apply power to. In
1101 * order to minimise the number of writes to the device required
1102 * multiple widgets will be updated in a single write where possible.
1103 * Currently anything that requires more than a single write is not
1106 static void dapm_seq_run(struct snd_soc_dapm_context
*dapm
,
1107 struct list_head
*list
, int event
, bool power_up
)
1109 struct snd_soc_dapm_widget
*w
, *n
;
1112 int cur_subseq
= -1;
1113 int cur_reg
= SND_SOC_NOPM
;
1114 struct snd_soc_dapm_context
*cur_dapm
= NULL
;
1121 sort
= dapm_down_seq
;
1123 list_for_each_entry_safe(w
, n
, list
, power_list
) {
1126 /* Do we need to apply any queued changes? */
1127 if (sort
[w
->id
] != cur_sort
|| w
->reg
!= cur_reg
||
1128 w
->dapm
!= cur_dapm
|| w
->subseq
!= cur_subseq
) {
1129 if (!list_empty(&pending
))
1130 dapm_seq_run_coalesced(cur_dapm
, &pending
);
1132 if (cur_dapm
&& cur_dapm
->seq_notifier
) {
1133 for (i
= 0; i
< ARRAY_SIZE(dapm_up_seq
); i
++)
1134 if (sort
[i
] == cur_sort
)
1135 cur_dapm
->seq_notifier(cur_dapm
,
1140 INIT_LIST_HEAD(&pending
);
1142 cur_subseq
= INT_MIN
;
1143 cur_reg
= SND_SOC_NOPM
;
1148 case snd_soc_dapm_pre
:
1150 list_for_each_entry_safe_continue(w
, n
, list
,
1153 if (event
== SND_SOC_DAPM_STREAM_START
)
1155 NULL
, SND_SOC_DAPM_PRE_PMU
);
1156 else if (event
== SND_SOC_DAPM_STREAM_STOP
)
1158 NULL
, SND_SOC_DAPM_PRE_PMD
);
1161 case snd_soc_dapm_post
:
1163 list_for_each_entry_safe_continue(w
, n
, list
,
1166 if (event
== SND_SOC_DAPM_STREAM_START
)
1168 NULL
, SND_SOC_DAPM_POST_PMU
);
1169 else if (event
== SND_SOC_DAPM_STREAM_STOP
)
1171 NULL
, SND_SOC_DAPM_POST_PMD
);
1175 /* Queue it up for application */
1176 cur_sort
= sort
[w
->id
];
1177 cur_subseq
= w
->subseq
;
1180 list_move(&w
->power_list
, &pending
);
1185 dev_err(w
->dapm
->dev
,
1186 "Failed to apply widget power: %d\n", ret
);
1189 if (!list_empty(&pending
))
1190 dapm_seq_run_coalesced(cur_dapm
, &pending
);
1192 if (cur_dapm
&& cur_dapm
->seq_notifier
) {
1193 for (i
= 0; i
< ARRAY_SIZE(dapm_up_seq
); i
++)
1194 if (sort
[i
] == cur_sort
)
1195 cur_dapm
->seq_notifier(cur_dapm
,
1200 static void dapm_widget_update(struct snd_soc_dapm_context
*dapm
)
1202 struct snd_soc_dapm_update
*update
= dapm
->update
;
1203 struct snd_soc_dapm_widget
*w
;
1212 (w
->event_flags
& SND_SOC_DAPM_PRE_REG
)) {
1213 ret
= w
->event(w
, update
->kcontrol
, SND_SOC_DAPM_PRE_REG
);
1215 pr_err("%s DAPM pre-event failed: %d\n",
1219 ret
= snd_soc_update_bits(w
->codec
, update
->reg
, update
->mask
,
1222 pr_err("%s DAPM update failed: %d\n", w
->name
, ret
);
1225 (w
->event_flags
& SND_SOC_DAPM_POST_REG
)) {
1226 ret
= w
->event(w
, update
->kcontrol
, SND_SOC_DAPM_POST_REG
);
1228 pr_err("%s DAPM post-event failed: %d\n",
1233 /* Async callback run prior to DAPM sequences - brings to _PREPARE if
1234 * they're changing state.
1236 static void dapm_pre_sequence_async(void *data
, async_cookie_t cookie
)
1238 struct snd_soc_dapm_context
*d
= data
;
1241 /* If we're off and we're not supposed to be go into STANDBY */
1242 if (d
->bias_level
== SND_SOC_BIAS_OFF
&&
1243 d
->target_bias_level
!= SND_SOC_BIAS_OFF
) {
1245 pm_runtime_get_sync(d
->dev
);
1247 ret
= snd_soc_dapm_set_bias_level(d
, SND_SOC_BIAS_STANDBY
);
1250 "Failed to turn on bias: %d\n", ret
);
1253 /* Prepare for a STADDBY->ON or ON->STANDBY transition */
1254 if (d
->bias_level
!= d
->target_bias_level
) {
1255 ret
= snd_soc_dapm_set_bias_level(d
, SND_SOC_BIAS_PREPARE
);
1258 "Failed to prepare bias: %d\n", ret
);
1262 /* Async callback run prior to DAPM sequences - brings to their final
1265 static void dapm_post_sequence_async(void *data
, async_cookie_t cookie
)
1267 struct snd_soc_dapm_context
*d
= data
;
1270 /* If we just powered the last thing off drop to standby bias */
1271 if (d
->bias_level
== SND_SOC_BIAS_PREPARE
&&
1272 (d
->target_bias_level
== SND_SOC_BIAS_STANDBY
||
1273 d
->target_bias_level
== SND_SOC_BIAS_OFF
)) {
1274 ret
= snd_soc_dapm_set_bias_level(d
, SND_SOC_BIAS_STANDBY
);
1276 dev_err(d
->dev
, "Failed to apply standby bias: %d\n",
1280 /* If we're in standby and can support bias off then do that */
1281 if (d
->bias_level
== SND_SOC_BIAS_STANDBY
&&
1282 d
->target_bias_level
== SND_SOC_BIAS_OFF
) {
1283 ret
= snd_soc_dapm_set_bias_level(d
, SND_SOC_BIAS_OFF
);
1285 dev_err(d
->dev
, "Failed to turn off bias: %d\n", ret
);
1288 pm_runtime_put(d
->dev
);
1291 /* If we just powered up then move to active bias */
1292 if (d
->bias_level
== SND_SOC_BIAS_PREPARE
&&
1293 d
->target_bias_level
== SND_SOC_BIAS_ON
) {
1294 ret
= snd_soc_dapm_set_bias_level(d
, SND_SOC_BIAS_ON
);
1296 dev_err(d
->dev
, "Failed to apply active bias: %d\n",
1301 static void dapm_widget_set_peer_power(struct snd_soc_dapm_widget
*peer
,
1302 bool power
, bool connect
)
1304 /* If a connection is being made or broken then that update
1305 * will have marked the peer dirty, otherwise the widgets are
1306 * not connected and this update has no impact. */
1310 /* If the peer is already in the state we're moving to then we
1311 * won't have an impact on it. */
1312 if (power
!= peer
->power
)
1313 dapm_mark_dirty(peer
, "peer state change");
1316 static void dapm_widget_set_power(struct snd_soc_dapm_widget
*w
, bool power
,
1317 struct list_head
*up_list
,
1318 struct list_head
*down_list
)
1320 struct snd_soc_dapm_path
*path
;
1322 if (w
->power
== power
)
1325 trace_snd_soc_dapm_widget_power(w
, power
);
1327 /* If we changed our power state perhaps our neigbours changed
1330 list_for_each_entry(path
, &w
->sources
, list_sink
) {
1332 dapm_widget_set_peer_power(path
->source
, power
,
1337 case snd_soc_dapm_supply
:
1338 case snd_soc_dapm_regulator_supply
:
1339 /* Supplies can't affect their outputs, only their inputs */
1342 list_for_each_entry(path
, &w
->sinks
, list_source
) {
1344 dapm_widget_set_peer_power(path
->sink
, power
,
1352 dapm_seq_insert(w
, up_list
, true);
1354 dapm_seq_insert(w
, down_list
, false);
1359 static void dapm_power_one_widget(struct snd_soc_dapm_widget
*w
,
1360 struct list_head
*up_list
,
1361 struct list_head
*down_list
)
1366 case snd_soc_dapm_pre
:
1367 dapm_seq_insert(w
, down_list
, false);
1369 case snd_soc_dapm_post
:
1370 dapm_seq_insert(w
, up_list
, true);
1374 power
= dapm_widget_power_check(w
);
1376 dapm_widget_set_power(w
, power
, up_list
, down_list
);
1382 * Scan each dapm widget for complete audio path.
1383 * A complete path is a route that has valid endpoints i.e.:-
1385 * o DAC to output pin.
1386 * o Input Pin to ADC.
1387 * o Input pin to Output pin (bypass, sidetone)
1388 * o DAC to ADC (loopback).
1390 static int dapm_power_widgets(struct snd_soc_dapm_context
*dapm
, int event
)
1392 struct snd_soc_card
*card
= dapm
->card
;
1393 struct snd_soc_dapm_widget
*w
;
1394 struct snd_soc_dapm_context
*d
;
1396 LIST_HEAD(down_list
);
1397 LIST_HEAD(async_domain
);
1398 enum snd_soc_bias_level bias
;
1400 trace_snd_soc_dapm_start(card
);
1402 list_for_each_entry(d
, &card
->dapm_list
, list
) {
1403 if (d
->n_widgets
|| d
->codec
== NULL
) {
1404 if (d
->idle_bias_off
)
1405 d
->target_bias_level
= SND_SOC_BIAS_OFF
;
1407 d
->target_bias_level
= SND_SOC_BIAS_STANDBY
;
1411 memset(&card
->dapm_stats
, 0, sizeof(card
->dapm_stats
));
1413 list_for_each_entry(w
, &card
->widgets
, list
) {
1414 w
->power_checked
= false;
1419 /* Check which widgets we need to power and store them in
1420 * lists indicating if they should be powered up or down. We
1421 * only check widgets that have been flagged as dirty but note
1422 * that new widgets may be added to the dirty list while we
1425 list_for_each_entry(w
, &card
->dapm_dirty
, dirty
) {
1426 dapm_power_one_widget(w
, &up_list
, &down_list
);
1429 list_for_each_entry(w
, &card
->widgets
, list
) {
1430 list_del_init(&w
->dirty
);
1435 /* Supplies and micbiases only bring the
1436 * context up to STANDBY as unless something
1437 * else is active and passing audio they
1438 * generally don't require full power. Signal
1439 * generators are virtual pins and have no
1440 * power impact themselves.
1443 case snd_soc_dapm_siggen
:
1445 case snd_soc_dapm_supply
:
1446 case snd_soc_dapm_regulator_supply
:
1447 case snd_soc_dapm_micbias
:
1448 if (d
->target_bias_level
< SND_SOC_BIAS_STANDBY
)
1449 d
->target_bias_level
= SND_SOC_BIAS_STANDBY
;
1452 d
->target_bias_level
= SND_SOC_BIAS_ON
;
1459 /* If there are no DAPM widgets then try to figure out power from the
1462 if (!dapm
->n_widgets
) {
1464 case SND_SOC_DAPM_STREAM_START
:
1465 case SND_SOC_DAPM_STREAM_RESUME
:
1466 dapm
->target_bias_level
= SND_SOC_BIAS_ON
;
1468 case SND_SOC_DAPM_STREAM_STOP
:
1469 if (dapm
->codec
&& dapm
->codec
->active
)
1470 dapm
->target_bias_level
= SND_SOC_BIAS_ON
;
1472 dapm
->target_bias_level
= SND_SOC_BIAS_STANDBY
;
1474 case SND_SOC_DAPM_STREAM_SUSPEND
:
1475 dapm
->target_bias_level
= SND_SOC_BIAS_STANDBY
;
1477 case SND_SOC_DAPM_STREAM_NOP
:
1478 dapm
->target_bias_level
= dapm
->bias_level
;
1485 /* Force all contexts in the card to the same bias state if
1486 * they're not ground referenced.
1488 bias
= SND_SOC_BIAS_OFF
;
1489 list_for_each_entry(d
, &card
->dapm_list
, list
)
1490 if (d
->target_bias_level
> bias
)
1491 bias
= d
->target_bias_level
;
1492 list_for_each_entry(d
, &card
->dapm_list
, list
)
1493 if (!d
->idle_bias_off
)
1494 d
->target_bias_level
= bias
;
1496 trace_snd_soc_dapm_walk_done(card
);
1498 /* Run all the bias changes in parallel */
1499 list_for_each_entry(d
, &dapm
->card
->dapm_list
, list
)
1500 async_schedule_domain(dapm_pre_sequence_async
, d
,
1502 async_synchronize_full_domain(&async_domain
);
1504 /* Power down widgets first; try to avoid amplifying pops. */
1505 dapm_seq_run(dapm
, &down_list
, event
, false);
1507 dapm_widget_update(dapm
);
1510 dapm_seq_run(dapm
, &up_list
, event
, true);
1512 /* Run all the bias changes in parallel */
1513 list_for_each_entry(d
, &dapm
->card
->dapm_list
, list
)
1514 async_schedule_domain(dapm_post_sequence_async
, d
,
1516 async_synchronize_full_domain(&async_domain
);
1518 pop_dbg(dapm
->dev
, card
->pop_time
,
1519 "DAPM sequencing finished, waiting %dms\n", card
->pop_time
);
1520 pop_wait(card
->pop_time
);
1522 trace_snd_soc_dapm_done(card
);
1527 #ifdef CONFIG_DEBUG_FS
1528 static int dapm_widget_power_open_file(struct inode
*inode
, struct file
*file
)
1530 file
->private_data
= inode
->i_private
;
1534 static ssize_t
dapm_widget_power_read_file(struct file
*file
,
1535 char __user
*user_buf
,
1536 size_t count
, loff_t
*ppos
)
1538 struct snd_soc_dapm_widget
*w
= file
->private_data
;
1542 struct snd_soc_dapm_path
*p
= NULL
;
1544 buf
= kmalloc(PAGE_SIZE
, GFP_KERNEL
);
1548 in
= is_connected_input_ep(w
);
1549 dapm_clear_walk(w
->dapm
);
1550 out
= is_connected_output_ep(w
);
1551 dapm_clear_walk(w
->dapm
);
1553 ret
= snprintf(buf
, PAGE_SIZE
, "%s: %s in %d out %d",
1554 w
->name
, w
->power
? "On" : "Off", in
, out
);
1557 ret
+= snprintf(buf
+ ret
, PAGE_SIZE
- ret
,
1558 " - R%d(0x%x) bit %d",
1559 w
->reg
, w
->reg
, w
->shift
);
1561 ret
+= snprintf(buf
+ ret
, PAGE_SIZE
- ret
, "\n");
1564 ret
+= snprintf(buf
+ ret
, PAGE_SIZE
- ret
, " stream %s %s\n",
1566 w
->active
? "active" : "inactive");
1568 list_for_each_entry(p
, &w
->sources
, list_sink
) {
1569 if (p
->connected
&& !p
->connected(w
, p
->sink
))
1573 ret
+= snprintf(buf
+ ret
, PAGE_SIZE
- ret
,
1574 " in \"%s\" \"%s\"\n",
1575 p
->name
? p
->name
: "static",
1578 list_for_each_entry(p
, &w
->sinks
, list_source
) {
1579 if (p
->connected
&& !p
->connected(w
, p
->sink
))
1583 ret
+= snprintf(buf
+ ret
, PAGE_SIZE
- ret
,
1584 " out \"%s\" \"%s\"\n",
1585 p
->name
? p
->name
: "static",
1589 ret
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, ret
);
1595 static const struct file_operations dapm_widget_power_fops
= {
1596 .open
= dapm_widget_power_open_file
,
1597 .read
= dapm_widget_power_read_file
,
1598 .llseek
= default_llseek
,
1601 static int dapm_bias_open_file(struct inode
*inode
, struct file
*file
)
1603 file
->private_data
= inode
->i_private
;
1607 static ssize_t
dapm_bias_read_file(struct file
*file
, char __user
*user_buf
,
1608 size_t count
, loff_t
*ppos
)
1610 struct snd_soc_dapm_context
*dapm
= file
->private_data
;
1613 switch (dapm
->bias_level
) {
1614 case SND_SOC_BIAS_ON
:
1617 case SND_SOC_BIAS_PREPARE
:
1618 level
= "Prepare\n";
1620 case SND_SOC_BIAS_STANDBY
:
1621 level
= "Standby\n";
1623 case SND_SOC_BIAS_OFF
:
1628 level
= "Unknown\n";
1632 return simple_read_from_buffer(user_buf
, count
, ppos
, level
,
1636 static const struct file_operations dapm_bias_fops
= {
1637 .open
= dapm_bias_open_file
,
1638 .read
= dapm_bias_read_file
,
1639 .llseek
= default_llseek
,
1642 void snd_soc_dapm_debugfs_init(struct snd_soc_dapm_context
*dapm
,
1643 struct dentry
*parent
)
1647 dapm
->debugfs_dapm
= debugfs_create_dir("dapm", parent
);
1649 if (!dapm
->debugfs_dapm
) {
1651 "Failed to create DAPM debugfs directory\n");
1655 d
= debugfs_create_file("bias_level", 0444,
1656 dapm
->debugfs_dapm
, dapm
,
1660 "ASoC: Failed to create bias level debugfs file\n");
1663 static void dapm_debugfs_add_widget(struct snd_soc_dapm_widget
*w
)
1665 struct snd_soc_dapm_context
*dapm
= w
->dapm
;
1668 if (!dapm
->debugfs_dapm
|| !w
->name
)
1671 d
= debugfs_create_file(w
->name
, 0444,
1672 dapm
->debugfs_dapm
, w
,
1673 &dapm_widget_power_fops
);
1675 dev_warn(w
->dapm
->dev
,
1676 "ASoC: Failed to create %s debugfs file\n",
1680 static void dapm_debugfs_cleanup(struct snd_soc_dapm_context
*dapm
)
1682 debugfs_remove_recursive(dapm
->debugfs_dapm
);
1686 void snd_soc_dapm_debugfs_init(struct snd_soc_dapm_context
*dapm
,
1687 struct dentry
*parent
)
1691 static inline void dapm_debugfs_add_widget(struct snd_soc_dapm_widget
*w
)
1695 static inline void dapm_debugfs_cleanup(struct snd_soc_dapm_context
*dapm
)
1701 /* test and update the power status of a mux widget */
1702 int snd_soc_dapm_mux_update_power(struct snd_soc_dapm_widget
*widget
,
1703 struct snd_kcontrol
*kcontrol
, int mux
, struct soc_enum
*e
)
1705 struct snd_soc_dapm_path
*path
;
1708 if (widget
->id
!= snd_soc_dapm_mux
&&
1709 widget
->id
!= snd_soc_dapm_virt_mux
&&
1710 widget
->id
!= snd_soc_dapm_value_mux
)
1713 /* find dapm widget path assoc with kcontrol */
1714 list_for_each_entry(path
, &widget
->dapm
->card
->paths
, list
) {
1715 if (path
->kcontrol
!= kcontrol
)
1718 if (!path
->name
|| !e
->texts
[mux
])
1722 /* we now need to match the string in the enum to the path */
1723 if (!(strcmp(path
->name
, e
->texts
[mux
]))) {
1724 path
->connect
= 1; /* new connection */
1725 dapm_mark_dirty(path
->source
, "mux connection");
1728 dapm_mark_dirty(path
->source
,
1729 "mux disconnection");
1730 path
->connect
= 0; /* old connection must be powered down */
1735 dapm_mark_dirty(widget
, "mux change");
1736 dapm_power_widgets(widget
->dapm
, SND_SOC_DAPM_STREAM_NOP
);
1741 EXPORT_SYMBOL_GPL(snd_soc_dapm_mux_update_power
);
1743 /* test and update the power status of a mixer or switch widget */
1744 int snd_soc_dapm_mixer_update_power(struct snd_soc_dapm_widget
*widget
,
1745 struct snd_kcontrol
*kcontrol
, int connect
)
1747 struct snd_soc_dapm_path
*path
;
1750 if (widget
->id
!= snd_soc_dapm_mixer
&&
1751 widget
->id
!= snd_soc_dapm_mixer_named_ctl
&&
1752 widget
->id
!= snd_soc_dapm_switch
)
1755 /* find dapm widget path assoc with kcontrol */
1756 list_for_each_entry(path
, &widget
->dapm
->card
->paths
, list
) {
1757 if (path
->kcontrol
!= kcontrol
)
1760 /* found, now check type */
1762 path
->connect
= connect
;
1763 dapm_mark_dirty(path
->source
, "mixer connection");
1767 dapm_mark_dirty(widget
, "mixer update");
1768 dapm_power_widgets(widget
->dapm
, SND_SOC_DAPM_STREAM_NOP
);
1773 EXPORT_SYMBOL_GPL(snd_soc_dapm_mixer_update_power
);
1775 /* show dapm widget status in sys fs */
1776 static ssize_t
dapm_widget_show(struct device
*dev
,
1777 struct device_attribute
*attr
, char *buf
)
1779 struct snd_soc_pcm_runtime
*rtd
= dev_get_drvdata(dev
);
1780 struct snd_soc_codec
*codec
=rtd
->codec
;
1781 struct snd_soc_dapm_widget
*w
;
1783 char *state
= "not set";
1785 list_for_each_entry(w
, &codec
->card
->widgets
, list
) {
1786 if (w
->dapm
!= &codec
->dapm
)
1789 /* only display widgets that burnm power */
1791 case snd_soc_dapm_hp
:
1792 case snd_soc_dapm_mic
:
1793 case snd_soc_dapm_spk
:
1794 case snd_soc_dapm_line
:
1795 case snd_soc_dapm_micbias
:
1796 case snd_soc_dapm_dac
:
1797 case snd_soc_dapm_adc
:
1798 case snd_soc_dapm_pga
:
1799 case snd_soc_dapm_out_drv
:
1800 case snd_soc_dapm_mixer
:
1801 case snd_soc_dapm_mixer_named_ctl
:
1802 case snd_soc_dapm_supply
:
1803 case snd_soc_dapm_regulator_supply
:
1805 count
+= sprintf(buf
+ count
, "%s: %s\n",
1806 w
->name
, w
->power
? "On":"Off");
1813 switch (codec
->dapm
.bias_level
) {
1814 case SND_SOC_BIAS_ON
:
1817 case SND_SOC_BIAS_PREPARE
:
1820 case SND_SOC_BIAS_STANDBY
:
1823 case SND_SOC_BIAS_OFF
:
1827 count
+= sprintf(buf
+ count
, "PM State: %s\n", state
);
1832 static DEVICE_ATTR(dapm_widget
, 0444, dapm_widget_show
, NULL
);
1834 int snd_soc_dapm_sys_add(struct device
*dev
)
1836 return device_create_file(dev
, &dev_attr_dapm_widget
);
1839 static void snd_soc_dapm_sys_remove(struct device
*dev
)
1841 device_remove_file(dev
, &dev_attr_dapm_widget
);
1844 /* free all dapm widgets and resources */
1845 static void dapm_free_widgets(struct snd_soc_dapm_context
*dapm
)
1847 struct snd_soc_dapm_widget
*w
, *next_w
;
1848 struct snd_soc_dapm_path
*p
, *next_p
;
1850 list_for_each_entry_safe(w
, next_w
, &dapm
->card
->widgets
, list
) {
1851 if (w
->dapm
!= dapm
)
1855 * remove source and sink paths associated to this widget.
1856 * While removing the path, remove reference to it from both
1857 * source and sink widgets so that path is removed only once.
1859 list_for_each_entry_safe(p
, next_p
, &w
->sources
, list_sink
) {
1860 list_del(&p
->list_sink
);
1861 list_del(&p
->list_source
);
1863 kfree(p
->long_name
);
1866 list_for_each_entry_safe(p
, next_p
, &w
->sinks
, list_source
) {
1867 list_del(&p
->list_sink
);
1868 list_del(&p
->list_source
);
1870 kfree(p
->long_name
);
1873 kfree(w
->kcontrols
);
1879 static struct snd_soc_dapm_widget
*dapm_find_widget(
1880 struct snd_soc_dapm_context
*dapm
, const char *pin
,
1881 bool search_other_contexts
)
1883 struct snd_soc_dapm_widget
*w
;
1884 struct snd_soc_dapm_widget
*fallback
= NULL
;
1886 list_for_each_entry(w
, &dapm
->card
->widgets
, list
) {
1887 if (!strcmp(w
->name
, pin
)) {
1888 if (w
->dapm
== dapm
)
1895 if (search_other_contexts
)
1901 static int snd_soc_dapm_set_pin(struct snd_soc_dapm_context
*dapm
,
1902 const char *pin
, int status
)
1904 struct snd_soc_dapm_widget
*w
= dapm_find_widget(dapm
, pin
, true);
1907 dev_err(dapm
->dev
, "dapm: unknown pin %s\n", pin
);
1911 w
->connected
= status
;
1914 dapm_mark_dirty(w
, "pin configuration");
1920 * snd_soc_dapm_sync - scan and power dapm paths
1921 * @dapm: DAPM context
1923 * Walks all dapm audio paths and powers widgets according to their
1924 * stream or path usage.
1926 * Returns 0 for success.
1928 int snd_soc_dapm_sync(struct snd_soc_dapm_context
*dapm
)
1931 * Suppress early reports (eg, jacks syncing their state) to avoid
1932 * silly DAPM runs during card startup.
1934 if (!dapm
->card
|| !dapm
->card
->instantiated
)
1937 return dapm_power_widgets(dapm
, SND_SOC_DAPM_STREAM_NOP
);
1939 EXPORT_SYMBOL_GPL(snd_soc_dapm_sync
);
1941 static int snd_soc_dapm_add_route(struct snd_soc_dapm_context
*dapm
,
1942 const struct snd_soc_dapm_route
*route
)
1944 struct snd_soc_dapm_path
*path
;
1945 struct snd_soc_dapm_widget
*wsource
= NULL
, *wsink
= NULL
, *w
;
1946 struct snd_soc_dapm_widget
*wtsource
= NULL
, *wtsink
= NULL
;
1948 const char *control
= route
->control
;
1950 char prefixed_sink
[80];
1951 char prefixed_source
[80];
1954 if (dapm
->codec
&& dapm
->codec
->name_prefix
) {
1955 snprintf(prefixed_sink
, sizeof(prefixed_sink
), "%s %s",
1956 dapm
->codec
->name_prefix
, route
->sink
);
1957 sink
= prefixed_sink
;
1958 snprintf(prefixed_source
, sizeof(prefixed_source
), "%s %s",
1959 dapm
->codec
->name_prefix
, route
->source
);
1960 source
= prefixed_source
;
1963 source
= route
->source
;
1967 * find src and dest widgets over all widgets but favor a widget from
1968 * current DAPM context
1970 list_for_each_entry(w
, &dapm
->card
->widgets
, list
) {
1971 if (!wsink
&& !(strcmp(w
->name
, sink
))) {
1973 if (w
->dapm
== dapm
)
1977 if (!wsource
&& !(strcmp(w
->name
, source
))) {
1979 if (w
->dapm
== dapm
)
1983 /* use widget from another DAPM context if not found from this */
1989 if (wsource
== NULL
|| wsink
== NULL
)
1992 path
= kzalloc(sizeof(struct snd_soc_dapm_path
), GFP_KERNEL
);
1996 path
->source
= wsource
;
1998 path
->connected
= route
->connected
;
1999 INIT_LIST_HEAD(&path
->list
);
2000 INIT_LIST_HEAD(&path
->list_source
);
2001 INIT_LIST_HEAD(&path
->list_sink
);
2003 /* check for external widgets */
2004 if (wsink
->id
== snd_soc_dapm_input
) {
2005 if (wsource
->id
== snd_soc_dapm_micbias
||
2006 wsource
->id
== snd_soc_dapm_mic
||
2007 wsource
->id
== snd_soc_dapm_line
||
2008 wsource
->id
== snd_soc_dapm_output
)
2011 if (wsource
->id
== snd_soc_dapm_output
) {
2012 if (wsink
->id
== snd_soc_dapm_spk
||
2013 wsink
->id
== snd_soc_dapm_hp
||
2014 wsink
->id
== snd_soc_dapm_line
||
2015 wsink
->id
== snd_soc_dapm_input
)
2019 /* connect static paths */
2020 if (control
== NULL
) {
2021 list_add(&path
->list
, &dapm
->card
->paths
);
2022 list_add(&path
->list_sink
, &wsink
->sources
);
2023 list_add(&path
->list_source
, &wsource
->sinks
);
2028 /* connect dynamic paths */
2029 switch (wsink
->id
) {
2030 case snd_soc_dapm_adc
:
2031 case snd_soc_dapm_dac
:
2032 case snd_soc_dapm_pga
:
2033 case snd_soc_dapm_out_drv
:
2034 case snd_soc_dapm_input
:
2035 case snd_soc_dapm_output
:
2036 case snd_soc_dapm_siggen
:
2037 case snd_soc_dapm_micbias
:
2038 case snd_soc_dapm_vmid
:
2039 case snd_soc_dapm_pre
:
2040 case snd_soc_dapm_post
:
2041 case snd_soc_dapm_supply
:
2042 case snd_soc_dapm_regulator_supply
:
2043 case snd_soc_dapm_aif_in
:
2044 case snd_soc_dapm_aif_out
:
2045 list_add(&path
->list
, &dapm
->card
->paths
);
2046 list_add(&path
->list_sink
, &wsink
->sources
);
2047 list_add(&path
->list_source
, &wsource
->sinks
);
2050 case snd_soc_dapm_mux
:
2051 case snd_soc_dapm_virt_mux
:
2052 case snd_soc_dapm_value_mux
:
2053 ret
= dapm_connect_mux(dapm
, wsource
, wsink
, path
, control
,
2054 &wsink
->kcontrol_news
[0]);
2058 case snd_soc_dapm_switch
:
2059 case snd_soc_dapm_mixer
:
2060 case snd_soc_dapm_mixer_named_ctl
:
2061 ret
= dapm_connect_mixer(dapm
, wsource
, wsink
, path
, control
);
2065 case snd_soc_dapm_hp
:
2066 case snd_soc_dapm_mic
:
2067 case snd_soc_dapm_line
:
2068 case snd_soc_dapm_spk
:
2069 list_add(&path
->list
, &dapm
->card
->paths
);
2070 list_add(&path
->list_sink
, &wsink
->sources
);
2071 list_add(&path
->list_source
, &wsource
->sinks
);
2078 dev_warn(dapm
->dev
, "asoc: no dapm match for %s --> %s --> %s\n",
2079 source
, control
, sink
);
2085 * snd_soc_dapm_add_routes - Add routes between DAPM widgets
2086 * @dapm: DAPM context
2087 * @route: audio routes
2088 * @num: number of routes
2090 * Connects 2 dapm widgets together via a named audio path. The sink is
2091 * the widget receiving the audio signal, whilst the source is the sender
2092 * of the audio signal.
2094 * Returns 0 for success else error. On error all resources can be freed
2095 * with a call to snd_soc_card_free().
2097 int snd_soc_dapm_add_routes(struct snd_soc_dapm_context
*dapm
,
2098 const struct snd_soc_dapm_route
*route
, int num
)
2102 for (i
= 0; i
< num
; i
++) {
2103 ret
= snd_soc_dapm_add_route(dapm
, route
);
2105 dev_err(dapm
->dev
, "Failed to add route %s->%s\n",
2106 route
->source
, route
->sink
);
2114 EXPORT_SYMBOL_GPL(snd_soc_dapm_add_routes
);
2116 static int snd_soc_dapm_weak_route(struct snd_soc_dapm_context
*dapm
,
2117 const struct snd_soc_dapm_route
*route
)
2119 struct snd_soc_dapm_widget
*source
= dapm_find_widget(dapm
,
2122 struct snd_soc_dapm_widget
*sink
= dapm_find_widget(dapm
,
2125 struct snd_soc_dapm_path
*path
;
2129 dev_err(dapm
->dev
, "Unable to find source %s for weak route\n",
2135 dev_err(dapm
->dev
, "Unable to find sink %s for weak route\n",
2140 if (route
->control
|| route
->connected
)
2141 dev_warn(dapm
->dev
, "Ignoring control for weak route %s->%s\n",
2142 route
->source
, route
->sink
);
2144 list_for_each_entry(path
, &source
->sinks
, list_source
) {
2145 if (path
->sink
== sink
) {
2152 dev_err(dapm
->dev
, "No path found for weak route %s->%s\n",
2153 route
->source
, route
->sink
);
2155 dev_warn(dapm
->dev
, "%d paths found for weak route %s->%s\n",
2156 count
, route
->source
, route
->sink
);
2162 * snd_soc_dapm_weak_routes - Mark routes between DAPM widgets as weak
2163 * @dapm: DAPM context
2164 * @route: audio routes
2165 * @num: number of routes
2167 * Mark existing routes matching those specified in the passed array
2168 * as being weak, meaning that they are ignored for the purpose of
2169 * power decisions. The main intended use case is for sidetone paths
2170 * which couple audio between other independent paths if they are both
2171 * active in order to make the combination work better at the user
2172 * level but which aren't intended to be "used".
2174 * Note that CODEC drivers should not use this as sidetone type paths
2175 * can frequently also be used as bypass paths.
2177 int snd_soc_dapm_weak_routes(struct snd_soc_dapm_context
*dapm
,
2178 const struct snd_soc_dapm_route
*route
, int num
)
2183 for (i
= 0; i
< num
; i
++) {
2184 err
= snd_soc_dapm_weak_route(dapm
, route
);
2192 EXPORT_SYMBOL_GPL(snd_soc_dapm_weak_routes
);
2195 * snd_soc_dapm_new_widgets - add new dapm widgets
2196 * @dapm: DAPM context
2198 * Checks the codec for any new dapm widgets and creates them if found.
2200 * Returns 0 for success.
2202 int snd_soc_dapm_new_widgets(struct snd_soc_dapm_context
*dapm
)
2204 struct snd_soc_dapm_widget
*w
;
2207 list_for_each_entry(w
, &dapm
->card
->widgets
, list
)
2212 if (w
->num_kcontrols
) {
2213 w
->kcontrols
= kzalloc(w
->num_kcontrols
*
2214 sizeof(struct snd_kcontrol
*),
2221 case snd_soc_dapm_switch
:
2222 case snd_soc_dapm_mixer
:
2223 case snd_soc_dapm_mixer_named_ctl
:
2226 case snd_soc_dapm_mux
:
2227 case snd_soc_dapm_virt_mux
:
2228 case snd_soc_dapm_value_mux
:
2231 case snd_soc_dapm_pga
:
2232 case snd_soc_dapm_out_drv
:
2239 /* Read the initial power state from the device */
2241 val
= soc_widget_read(w
, w
->reg
);
2242 val
&= 1 << w
->shift
;
2252 dapm_mark_dirty(w
, "new widget");
2253 dapm_debugfs_add_widget(w
);
2256 dapm_power_widgets(dapm
, SND_SOC_DAPM_STREAM_NOP
);
2259 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_widgets
);
2262 * snd_soc_dapm_get_volsw - dapm mixer get callback
2263 * @kcontrol: mixer control
2264 * @ucontrol: control element information
2266 * Callback to get the value of a dapm mixer control.
2268 * Returns 0 for success.
2270 int snd_soc_dapm_get_volsw(struct snd_kcontrol
*kcontrol
,
2271 struct snd_ctl_elem_value
*ucontrol
)
2273 struct snd_soc_dapm_widget_list
*wlist
= snd_kcontrol_chip(kcontrol
);
2274 struct snd_soc_dapm_widget
*widget
= wlist
->widgets
[0];
2275 struct soc_mixer_control
*mc
=
2276 (struct soc_mixer_control
*)kcontrol
->private_value
;
2277 unsigned int reg
= mc
->reg
;
2278 unsigned int shift
= mc
->shift
;
2279 unsigned int rshift
= mc
->rshift
;
2281 unsigned int invert
= mc
->invert
;
2282 unsigned int mask
= (1 << fls(max
)) - 1;
2284 ucontrol
->value
.integer
.value
[0] =
2285 (snd_soc_read(widget
->codec
, reg
) >> shift
) & mask
;
2286 if (shift
!= rshift
)
2287 ucontrol
->value
.integer
.value
[1] =
2288 (snd_soc_read(widget
->codec
, reg
) >> rshift
) & mask
;
2290 ucontrol
->value
.integer
.value
[0] =
2291 max
- ucontrol
->value
.integer
.value
[0];
2292 if (shift
!= rshift
)
2293 ucontrol
->value
.integer
.value
[1] =
2294 max
- ucontrol
->value
.integer
.value
[1];
2299 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_volsw
);
2302 * snd_soc_dapm_put_volsw - dapm mixer set callback
2303 * @kcontrol: mixer control
2304 * @ucontrol: control element information
2306 * Callback to set the value of a dapm mixer control.
2308 * Returns 0 for success.
2310 int snd_soc_dapm_put_volsw(struct snd_kcontrol
*kcontrol
,
2311 struct snd_ctl_elem_value
*ucontrol
)
2313 struct snd_soc_dapm_widget_list
*wlist
= snd_kcontrol_chip(kcontrol
);
2314 struct snd_soc_dapm_widget
*widget
= wlist
->widgets
[0];
2315 struct snd_soc_codec
*codec
= widget
->codec
;
2316 struct soc_mixer_control
*mc
=
2317 (struct soc_mixer_control
*)kcontrol
->private_value
;
2318 unsigned int reg
= mc
->reg
;
2319 unsigned int shift
= mc
->shift
;
2321 unsigned int mask
= (1 << fls(max
)) - 1;
2322 unsigned int invert
= mc
->invert
;
2324 int connect
, change
;
2325 struct snd_soc_dapm_update update
;
2328 val
= (ucontrol
->value
.integer
.value
[0] & mask
);
2332 mask
= mask
<< shift
;
2336 /* new connection */
2337 connect
= invert
? 0 : 1;
2339 /* old connection must be powered down */
2340 connect
= invert
? 1 : 0;
2342 mutex_lock(&codec
->mutex
);
2344 change
= snd_soc_test_bits(widget
->codec
, reg
, mask
, val
);
2346 for (wi
= 0; wi
< wlist
->num_widgets
; wi
++) {
2347 widget
= wlist
->widgets
[wi
];
2349 widget
->value
= val
;
2351 update
.kcontrol
= kcontrol
;
2352 update
.widget
= widget
;
2356 widget
->dapm
->update
= &update
;
2358 snd_soc_dapm_mixer_update_power(widget
, kcontrol
, connect
);
2360 widget
->dapm
->update
= NULL
;
2364 mutex_unlock(&codec
->mutex
);
2367 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_volsw
);
2370 * snd_soc_dapm_get_enum_double - dapm enumerated double mixer get callback
2371 * @kcontrol: mixer control
2372 * @ucontrol: control element information
2374 * Callback to get the value of a dapm enumerated double mixer control.
2376 * Returns 0 for success.
2378 int snd_soc_dapm_get_enum_double(struct snd_kcontrol
*kcontrol
,
2379 struct snd_ctl_elem_value
*ucontrol
)
2381 struct snd_soc_dapm_widget_list
*wlist
= snd_kcontrol_chip(kcontrol
);
2382 struct snd_soc_dapm_widget
*widget
= wlist
->widgets
[0];
2383 struct soc_enum
*e
= (struct soc_enum
*)kcontrol
->private_value
;
2384 unsigned int val
, bitmask
;
2386 for (bitmask
= 1; bitmask
< e
->max
; bitmask
<<= 1)
2388 val
= snd_soc_read(widget
->codec
, e
->reg
);
2389 ucontrol
->value
.enumerated
.item
[0] = (val
>> e
->shift_l
) & (bitmask
- 1);
2390 if (e
->shift_l
!= e
->shift_r
)
2391 ucontrol
->value
.enumerated
.item
[1] =
2392 (val
>> e
->shift_r
) & (bitmask
- 1);
2396 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_enum_double
);
2399 * snd_soc_dapm_put_enum_double - dapm enumerated double mixer set callback
2400 * @kcontrol: mixer control
2401 * @ucontrol: control element information
2403 * Callback to set the value of a dapm enumerated double mixer control.
2405 * Returns 0 for success.
2407 int snd_soc_dapm_put_enum_double(struct snd_kcontrol
*kcontrol
,
2408 struct snd_ctl_elem_value
*ucontrol
)
2410 struct snd_soc_dapm_widget_list
*wlist
= snd_kcontrol_chip(kcontrol
);
2411 struct snd_soc_dapm_widget
*widget
= wlist
->widgets
[0];
2412 struct snd_soc_codec
*codec
= widget
->codec
;
2413 struct soc_enum
*e
= (struct soc_enum
*)kcontrol
->private_value
;
2414 unsigned int val
, mux
, change
;
2415 unsigned int mask
, bitmask
;
2416 struct snd_soc_dapm_update update
;
2419 for (bitmask
= 1; bitmask
< e
->max
; bitmask
<<= 1)
2421 if (ucontrol
->value
.enumerated
.item
[0] > e
->max
- 1)
2423 mux
= ucontrol
->value
.enumerated
.item
[0];
2424 val
= mux
<< e
->shift_l
;
2425 mask
= (bitmask
- 1) << e
->shift_l
;
2426 if (e
->shift_l
!= e
->shift_r
) {
2427 if (ucontrol
->value
.enumerated
.item
[1] > e
->max
- 1)
2429 val
|= ucontrol
->value
.enumerated
.item
[1] << e
->shift_r
;
2430 mask
|= (bitmask
- 1) << e
->shift_r
;
2433 mutex_lock(&codec
->mutex
);
2435 change
= snd_soc_test_bits(widget
->codec
, e
->reg
, mask
, val
);
2437 for (wi
= 0; wi
< wlist
->num_widgets
; wi
++) {
2438 widget
= wlist
->widgets
[wi
];
2440 widget
->value
= val
;
2442 update
.kcontrol
= kcontrol
;
2443 update
.widget
= widget
;
2444 update
.reg
= e
->reg
;
2447 widget
->dapm
->update
= &update
;
2449 snd_soc_dapm_mux_update_power(widget
, kcontrol
, mux
, e
);
2451 widget
->dapm
->update
= NULL
;
2455 mutex_unlock(&codec
->mutex
);
2458 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_enum_double
);
2461 * snd_soc_dapm_get_enum_virt - Get virtual DAPM mux
2462 * @kcontrol: mixer control
2463 * @ucontrol: control element information
2465 * Returns 0 for success.
2467 int snd_soc_dapm_get_enum_virt(struct snd_kcontrol
*kcontrol
,
2468 struct snd_ctl_elem_value
*ucontrol
)
2470 struct snd_soc_dapm_widget_list
*wlist
= snd_kcontrol_chip(kcontrol
);
2471 struct snd_soc_dapm_widget
*widget
= wlist
->widgets
[0];
2473 ucontrol
->value
.enumerated
.item
[0] = widget
->value
;
2477 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_enum_virt
);
2480 * snd_soc_dapm_put_enum_virt - Set virtual DAPM mux
2481 * @kcontrol: mixer control
2482 * @ucontrol: control element information
2484 * Returns 0 for success.
2486 int snd_soc_dapm_put_enum_virt(struct snd_kcontrol
*kcontrol
,
2487 struct snd_ctl_elem_value
*ucontrol
)
2489 struct snd_soc_dapm_widget_list
*wlist
= snd_kcontrol_chip(kcontrol
);
2490 struct snd_soc_dapm_widget
*widget
= wlist
->widgets
[0];
2491 struct snd_soc_codec
*codec
= widget
->codec
;
2492 struct soc_enum
*e
=
2493 (struct soc_enum
*)kcontrol
->private_value
;
2498 if (ucontrol
->value
.enumerated
.item
[0] >= e
->max
)
2501 mutex_lock(&codec
->mutex
);
2503 change
= widget
->value
!= ucontrol
->value
.enumerated
.item
[0];
2505 for (wi
= 0; wi
< wlist
->num_widgets
; wi
++) {
2506 widget
= wlist
->widgets
[wi
];
2508 widget
->value
= ucontrol
->value
.enumerated
.item
[0];
2510 snd_soc_dapm_mux_update_power(widget
, kcontrol
, widget
->value
, e
);
2514 mutex_unlock(&codec
->mutex
);
2517 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_enum_virt
);
2520 * snd_soc_dapm_get_value_enum_double - dapm semi enumerated double mixer get
2522 * @kcontrol: mixer control
2523 * @ucontrol: control element information
2525 * Callback to get the value of a dapm semi enumerated double mixer control.
2527 * Semi enumerated mixer: the enumerated items are referred as values. Can be
2528 * used for handling bitfield coded enumeration for example.
2530 * Returns 0 for success.
2532 int snd_soc_dapm_get_value_enum_double(struct snd_kcontrol
*kcontrol
,
2533 struct snd_ctl_elem_value
*ucontrol
)
2535 struct snd_soc_dapm_widget_list
*wlist
= snd_kcontrol_chip(kcontrol
);
2536 struct snd_soc_dapm_widget
*widget
= wlist
->widgets
[0];
2537 struct soc_enum
*e
= (struct soc_enum
*)kcontrol
->private_value
;
2538 unsigned int reg_val
, val
, mux
;
2540 reg_val
= snd_soc_read(widget
->codec
, e
->reg
);
2541 val
= (reg_val
>> e
->shift_l
) & e
->mask
;
2542 for (mux
= 0; mux
< e
->max
; mux
++) {
2543 if (val
== e
->values
[mux
])
2546 ucontrol
->value
.enumerated
.item
[0] = mux
;
2547 if (e
->shift_l
!= e
->shift_r
) {
2548 val
= (reg_val
>> e
->shift_r
) & e
->mask
;
2549 for (mux
= 0; mux
< e
->max
; mux
++) {
2550 if (val
== e
->values
[mux
])
2553 ucontrol
->value
.enumerated
.item
[1] = mux
;
2558 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_value_enum_double
);
2561 * snd_soc_dapm_put_value_enum_double - dapm semi enumerated double mixer set
2563 * @kcontrol: mixer control
2564 * @ucontrol: control element information
2566 * Callback to set the value of a dapm semi enumerated double mixer control.
2568 * Semi enumerated mixer: the enumerated items are referred as values. Can be
2569 * used for handling bitfield coded enumeration for example.
2571 * Returns 0 for success.
2573 int snd_soc_dapm_put_value_enum_double(struct snd_kcontrol
*kcontrol
,
2574 struct snd_ctl_elem_value
*ucontrol
)
2576 struct snd_soc_dapm_widget_list
*wlist
= snd_kcontrol_chip(kcontrol
);
2577 struct snd_soc_dapm_widget
*widget
= wlist
->widgets
[0];
2578 struct snd_soc_codec
*codec
= widget
->codec
;
2579 struct soc_enum
*e
= (struct soc_enum
*)kcontrol
->private_value
;
2580 unsigned int val
, mux
, change
;
2582 struct snd_soc_dapm_update update
;
2585 if (ucontrol
->value
.enumerated
.item
[0] > e
->max
- 1)
2587 mux
= ucontrol
->value
.enumerated
.item
[0];
2588 val
= e
->values
[ucontrol
->value
.enumerated
.item
[0]] << e
->shift_l
;
2589 mask
= e
->mask
<< e
->shift_l
;
2590 if (e
->shift_l
!= e
->shift_r
) {
2591 if (ucontrol
->value
.enumerated
.item
[1] > e
->max
- 1)
2593 val
|= e
->values
[ucontrol
->value
.enumerated
.item
[1]] << e
->shift_r
;
2594 mask
|= e
->mask
<< e
->shift_r
;
2597 mutex_lock(&codec
->mutex
);
2599 change
= snd_soc_test_bits(widget
->codec
, e
->reg
, mask
, val
);
2601 for (wi
= 0; wi
< wlist
->num_widgets
; wi
++) {
2602 widget
= wlist
->widgets
[wi
];
2604 widget
->value
= val
;
2606 update
.kcontrol
= kcontrol
;
2607 update
.widget
= widget
;
2608 update
.reg
= e
->reg
;
2611 widget
->dapm
->update
= &update
;
2613 snd_soc_dapm_mux_update_power(widget
, kcontrol
, mux
, e
);
2615 widget
->dapm
->update
= NULL
;
2619 mutex_unlock(&codec
->mutex
);
2622 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_value_enum_double
);
2625 * snd_soc_dapm_info_pin_switch - Info for a pin switch
2627 * @kcontrol: mixer control
2628 * @uinfo: control element information
2630 * Callback to provide information about a pin switch control.
2632 int snd_soc_dapm_info_pin_switch(struct snd_kcontrol
*kcontrol
,
2633 struct snd_ctl_elem_info
*uinfo
)
2635 uinfo
->type
= SNDRV_CTL_ELEM_TYPE_BOOLEAN
;
2637 uinfo
->value
.integer
.min
= 0;
2638 uinfo
->value
.integer
.max
= 1;
2642 EXPORT_SYMBOL_GPL(snd_soc_dapm_info_pin_switch
);
2645 * snd_soc_dapm_get_pin_switch - Get information for a pin switch
2647 * @kcontrol: mixer control
2650 int snd_soc_dapm_get_pin_switch(struct snd_kcontrol
*kcontrol
,
2651 struct snd_ctl_elem_value
*ucontrol
)
2653 struct snd_soc_codec
*codec
= snd_kcontrol_chip(kcontrol
);
2654 const char *pin
= (const char *)kcontrol
->private_value
;
2656 mutex_lock(&codec
->mutex
);
2658 ucontrol
->value
.integer
.value
[0] =
2659 snd_soc_dapm_get_pin_status(&codec
->dapm
, pin
);
2661 mutex_unlock(&codec
->mutex
);
2665 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_pin_switch
);
2668 * snd_soc_dapm_put_pin_switch - Set information for a pin switch
2670 * @kcontrol: mixer control
2673 int snd_soc_dapm_put_pin_switch(struct snd_kcontrol
*kcontrol
,
2674 struct snd_ctl_elem_value
*ucontrol
)
2676 struct snd_soc_codec
*codec
= snd_kcontrol_chip(kcontrol
);
2677 const char *pin
= (const char *)kcontrol
->private_value
;
2679 mutex_lock(&codec
->mutex
);
2681 if (ucontrol
->value
.integer
.value
[0])
2682 snd_soc_dapm_enable_pin(&codec
->dapm
, pin
);
2684 snd_soc_dapm_disable_pin(&codec
->dapm
, pin
);
2686 snd_soc_dapm_sync(&codec
->dapm
);
2688 mutex_unlock(&codec
->mutex
);
2692 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_pin_switch
);
2695 * snd_soc_dapm_new_control - create new dapm control
2696 * @dapm: DAPM context
2697 * @widget: widget template
2699 * Creates a new dapm control based upon the template.
2701 * Returns 0 for success else error.
2703 int snd_soc_dapm_new_control(struct snd_soc_dapm_context
*dapm
,
2704 const struct snd_soc_dapm_widget
*widget
)
2706 struct snd_soc_dapm_widget
*w
;
2710 if ((w
= dapm_cnew_widget(widget
)) == NULL
)
2714 case snd_soc_dapm_regulator_supply
:
2715 w
->priv
= devm_regulator_get(dapm
->dev
, w
->name
);
2716 if (IS_ERR(w
->priv
)) {
2717 ret
= PTR_ERR(w
->priv
);
2718 dev_err(dapm
->dev
, "Failed to request %s: %d\n",
2727 name_len
= strlen(widget
->name
) + 1;
2728 if (dapm
->codec
&& dapm
->codec
->name_prefix
)
2729 name_len
+= 1 + strlen(dapm
->codec
->name_prefix
);
2730 w
->name
= kmalloc(name_len
, GFP_KERNEL
);
2731 if (w
->name
== NULL
) {
2735 if (dapm
->codec
&& dapm
->codec
->name_prefix
)
2736 snprintf(w
->name
, name_len
, "%s %s",
2737 dapm
->codec
->name_prefix
, widget
->name
);
2739 snprintf(w
->name
, name_len
, "%s", widget
->name
);
2742 case snd_soc_dapm_switch
:
2743 case snd_soc_dapm_mixer
:
2744 case snd_soc_dapm_mixer_named_ctl
:
2745 w
->power_check
= dapm_generic_check_power
;
2747 case snd_soc_dapm_mux
:
2748 case snd_soc_dapm_virt_mux
:
2749 case snd_soc_dapm_value_mux
:
2750 w
->power_check
= dapm_generic_check_power
;
2752 case snd_soc_dapm_adc
:
2753 case snd_soc_dapm_aif_out
:
2754 w
->power_check
= dapm_adc_check_power
;
2756 case snd_soc_dapm_dac
:
2757 case snd_soc_dapm_aif_in
:
2758 w
->power_check
= dapm_dac_check_power
;
2760 case snd_soc_dapm_pga
:
2761 case snd_soc_dapm_out_drv
:
2762 case snd_soc_dapm_input
:
2763 case snd_soc_dapm_output
:
2764 case snd_soc_dapm_micbias
:
2765 case snd_soc_dapm_spk
:
2766 case snd_soc_dapm_hp
:
2767 case snd_soc_dapm_mic
:
2768 case snd_soc_dapm_line
:
2769 w
->power_check
= dapm_generic_check_power
;
2771 case snd_soc_dapm_supply
:
2772 case snd_soc_dapm_regulator_supply
:
2773 w
->power_check
= dapm_supply_check_power
;
2776 w
->power_check
= dapm_always_on_check_power
;
2782 w
->codec
= dapm
->codec
;
2783 w
->platform
= dapm
->platform
;
2784 INIT_LIST_HEAD(&w
->sources
);
2785 INIT_LIST_HEAD(&w
->sinks
);
2786 INIT_LIST_HEAD(&w
->list
);
2787 INIT_LIST_HEAD(&w
->dirty
);
2788 list_add(&w
->list
, &dapm
->card
->widgets
);
2790 /* machine layer set ups unconnected pins and insertions */
2794 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_control
);
2797 * snd_soc_dapm_new_controls - create new dapm controls
2798 * @dapm: DAPM context
2799 * @widget: widget array
2800 * @num: number of widgets
2802 * Creates new DAPM controls based upon the templates.
2804 * Returns 0 for success else error.
2806 int snd_soc_dapm_new_controls(struct snd_soc_dapm_context
*dapm
,
2807 const struct snd_soc_dapm_widget
*widget
,
2812 for (i
= 0; i
< num
; i
++) {
2813 ret
= snd_soc_dapm_new_control(dapm
, widget
);
2816 "ASoC: Failed to create DAPM control %s: %d\n",
2824 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_controls
);
2826 static void soc_dapm_stream_event(struct snd_soc_dapm_context
*dapm
,
2827 const char *stream
, int event
)
2829 struct snd_soc_dapm_widget
*w
;
2831 list_for_each_entry(w
, &dapm
->card
->widgets
, list
)
2833 if (!w
->sname
|| w
->dapm
!= dapm
)
2835 dev_vdbg(w
->dapm
->dev
, "widget %s\n %s stream %s event %d\n",
2836 w
->name
, w
->sname
, stream
, event
);
2837 if (strstr(w
->sname
, stream
)) {
2838 dapm_mark_dirty(w
, "stream event");
2840 case SND_SOC_DAPM_STREAM_START
:
2843 case SND_SOC_DAPM_STREAM_STOP
:
2846 case SND_SOC_DAPM_STREAM_SUSPEND
:
2847 case SND_SOC_DAPM_STREAM_RESUME
:
2848 case SND_SOC_DAPM_STREAM_PAUSE_PUSH
:
2849 case SND_SOC_DAPM_STREAM_PAUSE_RELEASE
:
2855 dapm_power_widgets(dapm
, event
);
2857 /* do we need to notify any clients that DAPM stream is complete */
2858 if (dapm
->stream_event
)
2859 dapm
->stream_event(dapm
, event
);
2863 * snd_soc_dapm_stream_event - send a stream event to the dapm core
2864 * @rtd: PCM runtime data
2865 * @stream: stream name
2866 * @event: stream event
2868 * Sends a stream event to the dapm core. The core then makes any
2869 * necessary widget power changes.
2871 * Returns 0 for success else error.
2873 int snd_soc_dapm_stream_event(struct snd_soc_pcm_runtime
*rtd
,
2874 const char *stream
, int event
)
2876 struct snd_soc_codec
*codec
= rtd
->codec
;
2881 mutex_lock(&codec
->mutex
);
2882 soc_dapm_stream_event(&codec
->dapm
, stream
, event
);
2883 mutex_unlock(&codec
->mutex
);
2888 * snd_soc_dapm_enable_pin - enable pin.
2889 * @dapm: DAPM context
2892 * Enables input/output pin and its parents or children widgets iff there is
2893 * a valid audio route and active audio stream.
2894 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
2895 * do any widget power switching.
2897 int snd_soc_dapm_enable_pin(struct snd_soc_dapm_context
*dapm
, const char *pin
)
2899 return snd_soc_dapm_set_pin(dapm
, pin
, 1);
2901 EXPORT_SYMBOL_GPL(snd_soc_dapm_enable_pin
);
2904 * snd_soc_dapm_force_enable_pin - force a pin to be enabled
2905 * @dapm: DAPM context
2908 * Enables input/output pin regardless of any other state. This is
2909 * intended for use with microphone bias supplies used in microphone
2912 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
2913 * do any widget power switching.
2915 int snd_soc_dapm_force_enable_pin(struct snd_soc_dapm_context
*dapm
,
2918 struct snd_soc_dapm_widget
*w
= dapm_find_widget(dapm
, pin
, true);
2921 dev_err(dapm
->dev
, "dapm: unknown pin %s\n", pin
);
2925 dev_dbg(w
->dapm
->dev
, "dapm: force enable pin %s\n", pin
);
2928 dapm_mark_dirty(w
, "force enable");
2932 EXPORT_SYMBOL_GPL(snd_soc_dapm_force_enable_pin
);
2935 * snd_soc_dapm_disable_pin - disable pin.
2936 * @dapm: DAPM context
2939 * Disables input/output pin and its parents or children widgets.
2940 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
2941 * do any widget power switching.
2943 int snd_soc_dapm_disable_pin(struct snd_soc_dapm_context
*dapm
,
2946 return snd_soc_dapm_set_pin(dapm
, pin
, 0);
2948 EXPORT_SYMBOL_GPL(snd_soc_dapm_disable_pin
);
2951 * snd_soc_dapm_nc_pin - permanently disable pin.
2952 * @dapm: DAPM context
2955 * Marks the specified pin as being not connected, disabling it along
2956 * any parent or child widgets. At present this is identical to
2957 * snd_soc_dapm_disable_pin() but in future it will be extended to do
2958 * additional things such as disabling controls which only affect
2959 * paths through the pin.
2961 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
2962 * do any widget power switching.
2964 int snd_soc_dapm_nc_pin(struct snd_soc_dapm_context
*dapm
, const char *pin
)
2966 return snd_soc_dapm_set_pin(dapm
, pin
, 0);
2968 EXPORT_SYMBOL_GPL(snd_soc_dapm_nc_pin
);
2971 * snd_soc_dapm_get_pin_status - get audio pin status
2972 * @dapm: DAPM context
2973 * @pin: audio signal pin endpoint (or start point)
2975 * Get audio pin status - connected or disconnected.
2977 * Returns 1 for connected otherwise 0.
2979 int snd_soc_dapm_get_pin_status(struct snd_soc_dapm_context
*dapm
,
2982 struct snd_soc_dapm_widget
*w
= dapm_find_widget(dapm
, pin
, true);
2985 return w
->connected
;
2989 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_pin_status
);
2992 * snd_soc_dapm_ignore_suspend - ignore suspend status for DAPM endpoint
2993 * @dapm: DAPM context
2994 * @pin: audio signal pin endpoint (or start point)
2996 * Mark the given endpoint or pin as ignoring suspend. When the
2997 * system is disabled a path between two endpoints flagged as ignoring
2998 * suspend will not be disabled. The path must already be enabled via
2999 * normal means at suspend time, it will not be turned on if it was not
3002 int snd_soc_dapm_ignore_suspend(struct snd_soc_dapm_context
*dapm
,
3005 struct snd_soc_dapm_widget
*w
= dapm_find_widget(dapm
, pin
, false);
3008 dev_err(dapm
->dev
, "dapm: unknown pin %s\n", pin
);
3012 w
->ignore_suspend
= 1;
3016 EXPORT_SYMBOL_GPL(snd_soc_dapm_ignore_suspend
);
3018 static bool snd_soc_dapm_widget_in_card_paths(struct snd_soc_card
*card
,
3019 struct snd_soc_dapm_widget
*w
)
3021 struct snd_soc_dapm_path
*p
;
3023 list_for_each_entry(p
, &card
->paths
, list
) {
3024 if ((p
->source
== w
) || (p
->sink
== w
)) {
3026 "... Path %s(id:%d dapm:%p) - %s(id:%d dapm:%p)\n",
3027 p
->source
->name
, p
->source
->id
, p
->source
->dapm
,
3028 p
->sink
->name
, p
->sink
->id
, p
->sink
->dapm
);
3030 /* Connected to something other than the codec */
3031 if (p
->source
->dapm
!= p
->sink
->dapm
)
3034 * Loopback connection from codec external pin to
3035 * codec external pin
3037 if (p
->sink
->id
== snd_soc_dapm_input
) {
3038 switch (p
->source
->id
) {
3039 case snd_soc_dapm_output
:
3040 case snd_soc_dapm_micbias
:
3053 * snd_soc_dapm_auto_nc_codec_pins - call snd_soc_dapm_nc_pin for unused pins
3054 * @codec: The codec whose pins should be processed
3056 * Automatically call snd_soc_dapm_nc_pin() for any external pins in the codec
3057 * which are unused. Pins are used if they are connected externally to the
3058 * codec, whether that be to some other device, or a loop-back connection to
3061 void snd_soc_dapm_auto_nc_codec_pins(struct snd_soc_codec
*codec
)
3063 struct snd_soc_card
*card
= codec
->card
;
3064 struct snd_soc_dapm_context
*dapm
= &codec
->dapm
;
3065 struct snd_soc_dapm_widget
*w
;
3067 dev_dbg(codec
->dev
, "Auto NC: DAPMs: card:%p codec:%p\n",
3068 &card
->dapm
, &codec
->dapm
);
3070 list_for_each_entry(w
, &card
->widgets
, list
) {
3071 if (w
->dapm
!= dapm
)
3074 case snd_soc_dapm_input
:
3075 case snd_soc_dapm_output
:
3076 case snd_soc_dapm_micbias
:
3077 dev_dbg(codec
->dev
, "Auto NC: Checking widget %s\n",
3079 if (!snd_soc_dapm_widget_in_card_paths(card
, w
)) {
3081 "... Not in map; disabling\n");
3082 snd_soc_dapm_nc_pin(dapm
, w
->name
);
3092 * snd_soc_dapm_free - free dapm resources
3093 * @dapm: DAPM context
3095 * Free all dapm widgets and resources.
3097 void snd_soc_dapm_free(struct snd_soc_dapm_context
*dapm
)
3099 snd_soc_dapm_sys_remove(dapm
->dev
);
3100 dapm_debugfs_cleanup(dapm
);
3101 dapm_free_widgets(dapm
);
3102 list_del(&dapm
->list
);
3104 EXPORT_SYMBOL_GPL(snd_soc_dapm_free
);
3106 static void soc_dapm_shutdown_codec(struct snd_soc_dapm_context
*dapm
)
3108 struct snd_soc_dapm_widget
*w
;
3109 LIST_HEAD(down_list
);
3112 list_for_each_entry(w
, &dapm
->card
->widgets
, list
) {
3113 if (w
->dapm
!= dapm
)
3116 dapm_seq_insert(w
, &down_list
, false);
3122 /* If there were no widgets to power down we're already in
3126 snd_soc_dapm_set_bias_level(dapm
, SND_SOC_BIAS_PREPARE
);
3127 dapm_seq_run(dapm
, &down_list
, 0, false);
3128 snd_soc_dapm_set_bias_level(dapm
, SND_SOC_BIAS_STANDBY
);
3133 * snd_soc_dapm_shutdown - callback for system shutdown
3135 void snd_soc_dapm_shutdown(struct snd_soc_card
*card
)
3137 struct snd_soc_codec
*codec
;
3139 list_for_each_entry(codec
, &card
->codec_dev_list
, list
) {
3140 soc_dapm_shutdown_codec(&codec
->dapm
);
3141 snd_soc_dapm_set_bias_level(&codec
->dapm
, SND_SOC_BIAS_OFF
);
3145 /* Module information */
3146 MODULE_AUTHOR("Liam Girdwood, lrg@slimlogic.co.uk");
3147 MODULE_DESCRIPTION("Dynamic Audio Power Management core for ALSA SoC");
3148 MODULE_LICENSE("GPL");