Merge branch 'for-2.6.31' into for-2.6.32
[deliverable/linux.git] / sound / soc / soc-dapm.c
1 /*
2 * soc-dapm.c -- ALSA SoC Dynamic Audio Power Management
3 *
4 * Copyright 2005 Wolfson Microelectronics PLC.
5 * Author: Liam Girdwood <lrg@slimlogic.co.uk>
6 *
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.
11 *
12 * Features:
13 * o Changes power status of internal codec blocks depending on the
14 * dynamic configuration of codec internal audio paths and active
15 * DACs/ADCs.
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
20 * sinks, dacs, etc
21 * o Delayed powerdown of audio susbsystem to reduce pops between a quick
22 * device reopen.
23 *
24 * Todo:
25 * o DAPM power change sequencing - allow for configurable per
26 * codec sequences.
27 * o Support for analogue bias optimisation.
28 * o Support for reduced codec oversampling rates.
29 * o Support for reduced codec bias currents.
30 */
31
32 #include <linux/module.h>
33 #include <linux/moduleparam.h>
34 #include <linux/init.h>
35 #include <linux/delay.h>
36 #include <linux/pm.h>
37 #include <linux/bitops.h>
38 #include <linux/platform_device.h>
39 #include <linux/jiffies.h>
40 #include <sound/core.h>
41 #include <sound/pcm.h>
42 #include <sound/pcm_params.h>
43 #include <sound/soc-dapm.h>
44 #include <sound/initval.h>
45
46 /* debug */
47 #ifdef DEBUG
48 #define dump_dapm(codec, action) dbg_dump_dapm(codec, action)
49 #else
50 #define dump_dapm(codec, action)
51 #endif
52
53 /* dapm power sequences - make this per codec in the future */
54 static int dapm_up_seq[] = {
55 [snd_soc_dapm_pre] = 0,
56 [snd_soc_dapm_supply] = 1,
57 [snd_soc_dapm_micbias] = 2,
58 [snd_soc_dapm_mic] = 3,
59 [snd_soc_dapm_mux] = 4,
60 [snd_soc_dapm_value_mux] = 4,
61 [snd_soc_dapm_dac] = 5,
62 [snd_soc_dapm_mixer] = 6,
63 [snd_soc_dapm_mixer_named_ctl] = 6,
64 [snd_soc_dapm_pga] = 7,
65 [snd_soc_dapm_adc] = 8,
66 [snd_soc_dapm_hp] = 9,
67 [snd_soc_dapm_spk] = 10,
68 [snd_soc_dapm_post] = 11,
69 };
70
71 static int dapm_down_seq[] = {
72 [snd_soc_dapm_pre] = 0,
73 [snd_soc_dapm_adc] = 1,
74 [snd_soc_dapm_hp] = 2,
75 [snd_soc_dapm_spk] = 3,
76 [snd_soc_dapm_pga] = 4,
77 [snd_soc_dapm_mixer_named_ctl] = 5,
78 [snd_soc_dapm_mixer] = 5,
79 [snd_soc_dapm_dac] = 6,
80 [snd_soc_dapm_mic] = 7,
81 [snd_soc_dapm_micbias] = 8,
82 [snd_soc_dapm_mux] = 9,
83 [snd_soc_dapm_value_mux] = 9,
84 [snd_soc_dapm_supply] = 10,
85 [snd_soc_dapm_post] = 11,
86 };
87
88 static void pop_wait(u32 pop_time)
89 {
90 if (pop_time)
91 schedule_timeout_uninterruptible(msecs_to_jiffies(pop_time));
92 }
93
94 static void pop_dbg(u32 pop_time, const char *fmt, ...)
95 {
96 va_list args;
97
98 va_start(args, fmt);
99
100 if (pop_time) {
101 vprintk(fmt, args);
102 pop_wait(pop_time);
103 }
104
105 va_end(args);
106 }
107
108 /* create a new dapm widget */
109 static inline struct snd_soc_dapm_widget *dapm_cnew_widget(
110 const struct snd_soc_dapm_widget *_widget)
111 {
112 return kmemdup(_widget, sizeof(*_widget), GFP_KERNEL);
113 }
114
115 /**
116 * snd_soc_dapm_set_bias_level - set the bias level for the system
117 * @socdev: audio device
118 * @level: level to configure
119 *
120 * Configure the bias (power) levels for the SoC audio device.
121 *
122 * Returns 0 for success else error.
123 */
124 static int snd_soc_dapm_set_bias_level(struct snd_soc_device *socdev,
125 enum snd_soc_bias_level level)
126 {
127 struct snd_soc_card *card = socdev->card;
128 struct snd_soc_codec *codec = socdev->card->codec;
129 int ret = 0;
130
131 switch (level) {
132 case SND_SOC_BIAS_ON:
133 dev_dbg(socdev->dev, "Setting full bias\n");
134 break;
135 case SND_SOC_BIAS_PREPARE:
136 dev_dbg(socdev->dev, "Setting bias prepare\n");
137 break;
138 case SND_SOC_BIAS_STANDBY:
139 dev_dbg(socdev->dev, "Setting standby bias\n");
140 break;
141 case SND_SOC_BIAS_OFF:
142 dev_dbg(socdev->dev, "Setting bias off\n");
143 break;
144 default:
145 dev_err(socdev->dev, "Setting invalid bias %d\n", level);
146 return -EINVAL;
147 }
148
149 if (card->set_bias_level)
150 ret = card->set_bias_level(card, level);
151 if (ret == 0 && codec->set_bias_level)
152 ret = codec->set_bias_level(codec, level);
153
154 return ret;
155 }
156
157 /* set up initial codec paths */
158 static void dapm_set_path_status(struct snd_soc_dapm_widget *w,
159 struct snd_soc_dapm_path *p, int i)
160 {
161 switch (w->id) {
162 case snd_soc_dapm_switch:
163 case snd_soc_dapm_mixer:
164 case snd_soc_dapm_mixer_named_ctl: {
165 int val;
166 struct soc_mixer_control *mc = (struct soc_mixer_control *)
167 w->kcontrols[i].private_value;
168 unsigned int reg = mc->reg;
169 unsigned int shift = mc->shift;
170 int max = mc->max;
171 unsigned int mask = (1 << fls(max)) - 1;
172 unsigned int invert = mc->invert;
173
174 val = snd_soc_read(w->codec, reg);
175 val = (val >> shift) & mask;
176
177 if ((invert && !val) || (!invert && val))
178 p->connect = 1;
179 else
180 p->connect = 0;
181 }
182 break;
183 case snd_soc_dapm_mux: {
184 struct soc_enum *e = (struct soc_enum *)w->kcontrols[i].private_value;
185 int val, item, bitmask;
186
187 for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
188 ;
189 val = snd_soc_read(w->codec, e->reg);
190 item = (val >> e->shift_l) & (bitmask - 1);
191
192 p->connect = 0;
193 for (i = 0; i < e->max; i++) {
194 if (!(strcmp(p->name, e->texts[i])) && item == i)
195 p->connect = 1;
196 }
197 }
198 break;
199 case snd_soc_dapm_value_mux: {
200 struct soc_enum *e = (struct soc_enum *)
201 w->kcontrols[i].private_value;
202 int val, item;
203
204 val = snd_soc_read(w->codec, e->reg);
205 val = (val >> e->shift_l) & e->mask;
206 for (item = 0; item < e->max; item++) {
207 if (val == e->values[item])
208 break;
209 }
210
211 p->connect = 0;
212 for (i = 0; i < e->max; i++) {
213 if (!(strcmp(p->name, e->texts[i])) && item == i)
214 p->connect = 1;
215 }
216 }
217 break;
218 /* does not effect routing - always connected */
219 case snd_soc_dapm_pga:
220 case snd_soc_dapm_output:
221 case snd_soc_dapm_adc:
222 case snd_soc_dapm_input:
223 case snd_soc_dapm_dac:
224 case snd_soc_dapm_micbias:
225 case snd_soc_dapm_vmid:
226 case snd_soc_dapm_supply:
227 p->connect = 1;
228 break;
229 /* does effect routing - dynamically connected */
230 case snd_soc_dapm_hp:
231 case snd_soc_dapm_mic:
232 case snd_soc_dapm_spk:
233 case snd_soc_dapm_line:
234 case snd_soc_dapm_pre:
235 case snd_soc_dapm_post:
236 p->connect = 0;
237 break;
238 }
239 }
240
241 /* connect mux widget to its interconnecting audio paths */
242 static int dapm_connect_mux(struct snd_soc_codec *codec,
243 struct snd_soc_dapm_widget *src, struct snd_soc_dapm_widget *dest,
244 struct snd_soc_dapm_path *path, const char *control_name,
245 const struct snd_kcontrol_new *kcontrol)
246 {
247 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
248 int i;
249
250 for (i = 0; i < e->max; i++) {
251 if (!(strcmp(control_name, e->texts[i]))) {
252 list_add(&path->list, &codec->dapm_paths);
253 list_add(&path->list_sink, &dest->sources);
254 list_add(&path->list_source, &src->sinks);
255 path->name = (char*)e->texts[i];
256 dapm_set_path_status(dest, path, 0);
257 return 0;
258 }
259 }
260
261 return -ENODEV;
262 }
263
264 /* connect mixer widget to its interconnecting audio paths */
265 static int dapm_connect_mixer(struct snd_soc_codec *codec,
266 struct snd_soc_dapm_widget *src, struct snd_soc_dapm_widget *dest,
267 struct snd_soc_dapm_path *path, const char *control_name)
268 {
269 int i;
270
271 /* search for mixer kcontrol */
272 for (i = 0; i < dest->num_kcontrols; i++) {
273 if (!strcmp(control_name, dest->kcontrols[i].name)) {
274 list_add(&path->list, &codec->dapm_paths);
275 list_add(&path->list_sink, &dest->sources);
276 list_add(&path->list_source, &src->sinks);
277 path->name = dest->kcontrols[i].name;
278 dapm_set_path_status(dest, path, i);
279 return 0;
280 }
281 }
282 return -ENODEV;
283 }
284
285 /* update dapm codec register bits */
286 static int dapm_update_bits(struct snd_soc_dapm_widget *widget)
287 {
288 int change, power;
289 unsigned int old, new;
290 struct snd_soc_codec *codec = widget->codec;
291
292 /* check for valid widgets */
293 if (widget->reg < 0 || widget->id == snd_soc_dapm_input ||
294 widget->id == snd_soc_dapm_output ||
295 widget->id == snd_soc_dapm_hp ||
296 widget->id == snd_soc_dapm_mic ||
297 widget->id == snd_soc_dapm_line ||
298 widget->id == snd_soc_dapm_spk)
299 return 0;
300
301 power = widget->power;
302 if (widget->invert)
303 power = (power ? 0:1);
304
305 old = snd_soc_read(codec, widget->reg);
306 new = (old & ~(0x1 << widget->shift)) | (power << widget->shift);
307
308 change = old != new;
309 if (change) {
310 pop_dbg(codec->pop_time, "pop test %s : %s in %d ms\n",
311 widget->name, widget->power ? "on" : "off",
312 codec->pop_time);
313 snd_soc_write(codec, widget->reg, new);
314 pop_wait(codec->pop_time);
315 }
316 pr_debug("reg %x old %x new %x change %d\n", widget->reg,
317 old, new, change);
318 return change;
319 }
320
321 /* ramps the volume up or down to minimise pops before or after a
322 * DAPM power event */
323 static int dapm_set_pga(struct snd_soc_dapm_widget *widget, int power)
324 {
325 const struct snd_kcontrol_new *k = widget->kcontrols;
326
327 if (widget->muted && !power)
328 return 0;
329 if (!widget->muted && power)
330 return 0;
331
332 if (widget->num_kcontrols && k) {
333 struct soc_mixer_control *mc =
334 (struct soc_mixer_control *)k->private_value;
335 unsigned int reg = mc->reg;
336 unsigned int shift = mc->shift;
337 int max = mc->max;
338 unsigned int mask = (1 << fls(max)) - 1;
339 unsigned int invert = mc->invert;
340
341 if (power) {
342 int i;
343 /* power up has happended, increase volume to last level */
344 if (invert) {
345 for (i = max; i > widget->saved_value; i--)
346 snd_soc_update_bits(widget->codec, reg, mask, i);
347 } else {
348 for (i = 0; i < widget->saved_value; i++)
349 snd_soc_update_bits(widget->codec, reg, mask, i);
350 }
351 widget->muted = 0;
352 } else {
353 /* power down is about to occur, decrease volume to mute */
354 int val = snd_soc_read(widget->codec, reg);
355 int i = widget->saved_value = (val >> shift) & mask;
356 if (invert) {
357 for (; i < mask; i++)
358 snd_soc_update_bits(widget->codec, reg, mask, i);
359 } else {
360 for (; i > 0; i--)
361 snd_soc_update_bits(widget->codec, reg, mask, i);
362 }
363 widget->muted = 1;
364 }
365 }
366 return 0;
367 }
368
369 /* create new dapm mixer control */
370 static int dapm_new_mixer(struct snd_soc_codec *codec,
371 struct snd_soc_dapm_widget *w)
372 {
373 int i, ret = 0;
374 size_t name_len;
375 struct snd_soc_dapm_path *path;
376
377 /* add kcontrol */
378 for (i = 0; i < w->num_kcontrols; i++) {
379
380 /* match name */
381 list_for_each_entry(path, &w->sources, list_sink) {
382
383 /* mixer/mux paths name must match control name */
384 if (path->name != (char*)w->kcontrols[i].name)
385 continue;
386
387 /* add dapm control with long name.
388 * for dapm_mixer this is the concatenation of the
389 * mixer and kcontrol name.
390 * for dapm_mixer_named_ctl this is simply the
391 * kcontrol name.
392 */
393 name_len = strlen(w->kcontrols[i].name) + 1;
394 if (w->id != snd_soc_dapm_mixer_named_ctl)
395 name_len += 1 + strlen(w->name);
396
397 path->long_name = kmalloc(name_len, GFP_KERNEL);
398
399 if (path->long_name == NULL)
400 return -ENOMEM;
401
402 switch (w->id) {
403 default:
404 snprintf(path->long_name, name_len, "%s %s",
405 w->name, w->kcontrols[i].name);
406 break;
407 case snd_soc_dapm_mixer_named_ctl:
408 snprintf(path->long_name, name_len, "%s",
409 w->kcontrols[i].name);
410 break;
411 }
412
413 path->long_name[name_len - 1] = '\0';
414
415 path->kcontrol = snd_soc_cnew(&w->kcontrols[i], w,
416 path->long_name);
417 ret = snd_ctl_add(codec->card, path->kcontrol);
418 if (ret < 0) {
419 printk(KERN_ERR "asoc: failed to add dapm kcontrol %s: %d\n",
420 path->long_name,
421 ret);
422 kfree(path->long_name);
423 path->long_name = NULL;
424 return ret;
425 }
426 }
427 }
428 return ret;
429 }
430
431 /* create new dapm mux control */
432 static int dapm_new_mux(struct snd_soc_codec *codec,
433 struct snd_soc_dapm_widget *w)
434 {
435 struct snd_soc_dapm_path *path = NULL;
436 struct snd_kcontrol *kcontrol;
437 int ret = 0;
438
439 if (!w->num_kcontrols) {
440 printk(KERN_ERR "asoc: mux %s has no controls\n", w->name);
441 return -EINVAL;
442 }
443
444 kcontrol = snd_soc_cnew(&w->kcontrols[0], w, w->name);
445 ret = snd_ctl_add(codec->card, kcontrol);
446 if (ret < 0)
447 goto err;
448
449 list_for_each_entry(path, &w->sources, list_sink)
450 path->kcontrol = kcontrol;
451
452 return ret;
453
454 err:
455 printk(KERN_ERR "asoc: failed to add kcontrol %s\n", w->name);
456 return ret;
457 }
458
459 /* create new dapm volume control */
460 static int dapm_new_pga(struct snd_soc_codec *codec,
461 struct snd_soc_dapm_widget *w)
462 {
463 struct snd_kcontrol *kcontrol;
464 int ret = 0;
465
466 if (!w->num_kcontrols)
467 return -EINVAL;
468
469 kcontrol = snd_soc_cnew(&w->kcontrols[0], w, w->name);
470 ret = snd_ctl_add(codec->card, kcontrol);
471 if (ret < 0) {
472 printk(KERN_ERR "asoc: failed to add kcontrol %s\n", w->name);
473 return ret;
474 }
475
476 return ret;
477 }
478
479 /* reset 'walked' bit for each dapm path */
480 static inline void dapm_clear_walk(struct snd_soc_codec *codec)
481 {
482 struct snd_soc_dapm_path *p;
483
484 list_for_each_entry(p, &codec->dapm_paths, list)
485 p->walked = 0;
486 }
487
488 /*
489 * Recursively check for a completed path to an active or physically connected
490 * output widget. Returns number of complete paths.
491 */
492 static int is_connected_output_ep(struct snd_soc_dapm_widget *widget)
493 {
494 struct snd_soc_dapm_path *path;
495 int con = 0;
496
497 if (widget->id == snd_soc_dapm_supply)
498 return 0;
499
500 if (widget->id == snd_soc_dapm_adc && widget->active)
501 return 1;
502
503 if (widget->connected) {
504 /* connected pin ? */
505 if (widget->id == snd_soc_dapm_output && !widget->ext)
506 return 1;
507
508 /* connected jack or spk ? */
509 if (widget->id == snd_soc_dapm_hp || widget->id == snd_soc_dapm_spk ||
510 widget->id == snd_soc_dapm_line)
511 return 1;
512 }
513
514 list_for_each_entry(path, &widget->sinks, list_source) {
515 if (path->walked)
516 continue;
517
518 if (path->sink && path->connect) {
519 path->walked = 1;
520 con += is_connected_output_ep(path->sink);
521 }
522 }
523
524 return con;
525 }
526
527 /*
528 * Recursively check for a completed path to an active or physically connected
529 * input widget. Returns number of complete paths.
530 */
531 static int is_connected_input_ep(struct snd_soc_dapm_widget *widget)
532 {
533 struct snd_soc_dapm_path *path;
534 int con = 0;
535
536 if (widget->id == snd_soc_dapm_supply)
537 return 0;
538
539 /* active stream ? */
540 if (widget->id == snd_soc_dapm_dac && widget->active)
541 return 1;
542
543 if (widget->connected) {
544 /* connected pin ? */
545 if (widget->id == snd_soc_dapm_input && !widget->ext)
546 return 1;
547
548 /* connected VMID/Bias for lower pops */
549 if (widget->id == snd_soc_dapm_vmid)
550 return 1;
551
552 /* connected jack ? */
553 if (widget->id == snd_soc_dapm_mic || widget->id == snd_soc_dapm_line)
554 return 1;
555 }
556
557 list_for_each_entry(path, &widget->sources, list_sink) {
558 if (path->walked)
559 continue;
560
561 if (path->source && path->connect) {
562 path->walked = 1;
563 con += is_connected_input_ep(path->source);
564 }
565 }
566
567 return con;
568 }
569
570 /*
571 * Handler for generic register modifier widget.
572 */
573 int dapm_reg_event(struct snd_soc_dapm_widget *w,
574 struct snd_kcontrol *kcontrol, int event)
575 {
576 unsigned int val;
577
578 if (SND_SOC_DAPM_EVENT_ON(event))
579 val = w->on_val;
580 else
581 val = w->off_val;
582
583 snd_soc_update_bits(w->codec, -(w->reg + 1),
584 w->mask << w->shift, val << w->shift);
585
586 return 0;
587 }
588 EXPORT_SYMBOL_GPL(dapm_reg_event);
589
590 /* Standard power change method, used to apply power changes to most
591 * widgets.
592 */
593 static int dapm_generic_apply_power(struct snd_soc_dapm_widget *w)
594 {
595 int ret;
596
597 /* call any power change event handlers */
598 if (w->event)
599 pr_debug("power %s event for %s flags %x\n",
600 w->power ? "on" : "off",
601 w->name, w->event_flags);
602
603 /* power up pre event */
604 if (w->power && w->event &&
605 (w->event_flags & SND_SOC_DAPM_PRE_PMU)) {
606 ret = w->event(w, NULL, SND_SOC_DAPM_PRE_PMU);
607 if (ret < 0)
608 return ret;
609 }
610
611 /* power down pre event */
612 if (!w->power && w->event &&
613 (w->event_flags & SND_SOC_DAPM_PRE_PMD)) {
614 ret = w->event(w, NULL, SND_SOC_DAPM_PRE_PMD);
615 if (ret < 0)
616 return ret;
617 }
618
619 /* Lower PGA volume to reduce pops */
620 if (w->id == snd_soc_dapm_pga && !w->power)
621 dapm_set_pga(w, w->power);
622
623 dapm_update_bits(w);
624
625 /* Raise PGA volume to reduce pops */
626 if (w->id == snd_soc_dapm_pga && w->power)
627 dapm_set_pga(w, w->power);
628
629 /* power up post event */
630 if (w->power && w->event &&
631 (w->event_flags & SND_SOC_DAPM_POST_PMU)) {
632 ret = w->event(w,
633 NULL, SND_SOC_DAPM_POST_PMU);
634 if (ret < 0)
635 return ret;
636 }
637
638 /* power down post event */
639 if (!w->power && w->event &&
640 (w->event_flags & SND_SOC_DAPM_POST_PMD)) {
641 ret = w->event(w, NULL, SND_SOC_DAPM_POST_PMD);
642 if (ret < 0)
643 return ret;
644 }
645
646 return 0;
647 }
648
649 /* Generic check to see if a widget should be powered.
650 */
651 static int dapm_generic_check_power(struct snd_soc_dapm_widget *w)
652 {
653 int in, out;
654
655 in = is_connected_input_ep(w);
656 dapm_clear_walk(w->codec);
657 out = is_connected_output_ep(w);
658 dapm_clear_walk(w->codec);
659 return out != 0 && in != 0;
660 }
661
662 /* Check to see if an ADC has power */
663 static int dapm_adc_check_power(struct snd_soc_dapm_widget *w)
664 {
665 int in;
666
667 if (w->active) {
668 in = is_connected_input_ep(w);
669 dapm_clear_walk(w->codec);
670 return in != 0;
671 } else {
672 return dapm_generic_check_power(w);
673 }
674 }
675
676 /* Check to see if a DAC has power */
677 static int dapm_dac_check_power(struct snd_soc_dapm_widget *w)
678 {
679 int out;
680
681 if (w->active) {
682 out = is_connected_output_ep(w);
683 dapm_clear_walk(w->codec);
684 return out != 0;
685 } else {
686 return dapm_generic_check_power(w);
687 }
688 }
689
690 /* Check to see if a power supply is needed */
691 static int dapm_supply_check_power(struct snd_soc_dapm_widget *w)
692 {
693 struct snd_soc_dapm_path *path;
694 int power = 0;
695
696 /* Check if one of our outputs is connected */
697 list_for_each_entry(path, &w->sinks, list_source) {
698 if (path->sink && path->sink->power_check &&
699 path->sink->power_check(path->sink)) {
700 power = 1;
701 break;
702 }
703 }
704
705 dapm_clear_walk(w->codec);
706
707 return power;
708 }
709
710 static int dapm_seq_compare(struct snd_soc_dapm_widget *a,
711 struct snd_soc_dapm_widget *b,
712 int sort[])
713 {
714 if (sort[a->id] != sort[b->id])
715 return sort[a->id] - sort[b->id];
716 if (a->reg != b->reg)
717 return a->reg - b->reg;
718
719 return 0;
720 }
721
722 /* Insert a widget in order into a DAPM power sequence. */
723 static void dapm_seq_insert(struct snd_soc_dapm_widget *new_widget,
724 struct list_head *list,
725 int sort[])
726 {
727 struct snd_soc_dapm_widget *w;
728
729 list_for_each_entry(w, list, power_list)
730 if (dapm_seq_compare(new_widget, w, sort) < 0) {
731 list_add_tail(&new_widget->power_list, &w->power_list);
732 return;
733 }
734
735 list_add_tail(&new_widget->power_list, list);
736 }
737
738 /* Apply the coalesced changes from a DAPM sequence */
739 static void dapm_seq_run_coalesced(struct snd_soc_codec *codec,
740 struct list_head *pending)
741 {
742 struct snd_soc_dapm_widget *w;
743 int reg, power, ret;
744 unsigned int value = 0;
745 unsigned int mask = 0;
746 unsigned int cur_mask;
747
748 reg = list_first_entry(pending, struct snd_soc_dapm_widget,
749 power_list)->reg;
750
751 list_for_each_entry(w, pending, power_list) {
752 cur_mask = 1 << w->shift;
753 BUG_ON(reg != w->reg);
754
755 if (w->invert)
756 power = !w->power;
757 else
758 power = w->power;
759
760 mask |= cur_mask;
761 if (power)
762 value |= cur_mask;
763
764 pop_dbg(codec->pop_time,
765 "pop test : Queue %s: reg=0x%x, 0x%x/0x%x\n",
766 w->name, reg, value, mask);
767
768 /* power up pre event */
769 if (w->power && w->event &&
770 (w->event_flags & SND_SOC_DAPM_PRE_PMU)) {
771 pop_dbg(codec->pop_time, "pop test : %s PRE_PMU\n",
772 w->name);
773 ret = w->event(w, NULL, SND_SOC_DAPM_PRE_PMU);
774 if (ret < 0)
775 pr_err("%s: pre event failed: %d\n",
776 w->name, ret);
777 }
778
779 /* power down pre event */
780 if (!w->power && w->event &&
781 (w->event_flags & SND_SOC_DAPM_PRE_PMD)) {
782 pop_dbg(codec->pop_time, "pop test : %s PRE_PMD\n",
783 w->name);
784 ret = w->event(w, NULL, SND_SOC_DAPM_PRE_PMD);
785 if (ret < 0)
786 pr_err("%s: pre event failed: %d\n",
787 w->name, ret);
788 }
789
790 /* Lower PGA volume to reduce pops */
791 if (w->id == snd_soc_dapm_pga && !w->power)
792 dapm_set_pga(w, w->power);
793 }
794
795 if (reg >= 0) {
796 pop_dbg(codec->pop_time,
797 "pop test : Applying 0x%x/0x%x to %x in %dms\n",
798 value, mask, reg, codec->pop_time);
799 pop_wait(codec->pop_time);
800 snd_soc_update_bits(codec, reg, mask, value);
801 }
802
803 list_for_each_entry(w, pending, power_list) {
804 /* Raise PGA volume to reduce pops */
805 if (w->id == snd_soc_dapm_pga && w->power)
806 dapm_set_pga(w, w->power);
807
808 /* power up post event */
809 if (w->power && w->event &&
810 (w->event_flags & SND_SOC_DAPM_POST_PMU)) {
811 pop_dbg(codec->pop_time, "pop test : %s POST_PMU\n",
812 w->name);
813 ret = w->event(w,
814 NULL, SND_SOC_DAPM_POST_PMU);
815 if (ret < 0)
816 pr_err("%s: post event failed: %d\n",
817 w->name, ret);
818 }
819
820 /* power down post event */
821 if (!w->power && w->event &&
822 (w->event_flags & SND_SOC_DAPM_POST_PMD)) {
823 pop_dbg(codec->pop_time, "pop test : %s POST_PMD\n",
824 w->name);
825 ret = w->event(w, NULL, SND_SOC_DAPM_POST_PMD);
826 if (ret < 0)
827 pr_err("%s: post event failed: %d\n",
828 w->name, ret);
829 }
830 }
831 }
832
833 /* Apply a DAPM power sequence.
834 *
835 * We walk over a pre-sorted list of widgets to apply power to. In
836 * order to minimise the number of writes to the device required
837 * multiple widgets will be updated in a single write where possible.
838 * Currently anything that requires more than a single write is not
839 * handled.
840 */
841 static void dapm_seq_run(struct snd_soc_codec *codec, struct list_head *list,
842 int event, int sort[])
843 {
844 struct snd_soc_dapm_widget *w, *n;
845 LIST_HEAD(pending);
846 int cur_sort = -1;
847 int cur_reg = SND_SOC_NOPM;
848 int ret;
849
850 list_for_each_entry_safe(w, n, list, power_list) {
851 ret = 0;
852
853 /* Do we need to apply any queued changes? */
854 if (sort[w->id] != cur_sort || w->reg != cur_reg) {
855 if (!list_empty(&pending))
856 dapm_seq_run_coalesced(codec, &pending);
857
858 INIT_LIST_HEAD(&pending);
859 cur_sort = -1;
860 cur_reg = SND_SOC_NOPM;
861 }
862
863 switch (w->id) {
864 case snd_soc_dapm_pre:
865 if (!w->event)
866 list_for_each_entry_safe_continue(w, n, list,
867 power_list);
868
869 if (event == SND_SOC_DAPM_STREAM_START)
870 ret = w->event(w,
871 NULL, SND_SOC_DAPM_PRE_PMU);
872 else if (event == SND_SOC_DAPM_STREAM_STOP)
873 ret = w->event(w,
874 NULL, SND_SOC_DAPM_PRE_PMD);
875 break;
876
877 case snd_soc_dapm_post:
878 if (!w->event)
879 list_for_each_entry_safe_continue(w, n, list,
880 power_list);
881
882 if (event == SND_SOC_DAPM_STREAM_START)
883 ret = w->event(w,
884 NULL, SND_SOC_DAPM_POST_PMU);
885 else if (event == SND_SOC_DAPM_STREAM_STOP)
886 ret = w->event(w,
887 NULL, SND_SOC_DAPM_POST_PMD);
888 break;
889
890 case snd_soc_dapm_input:
891 case snd_soc_dapm_output:
892 case snd_soc_dapm_hp:
893 case snd_soc_dapm_mic:
894 case snd_soc_dapm_line:
895 case snd_soc_dapm_spk:
896 /* No register support currently */
897 ret = dapm_generic_apply_power(w);
898 break;
899
900 default:
901 /* Queue it up for application */
902 cur_sort = sort[w->id];
903 cur_reg = w->reg;
904 list_move(&w->power_list, &pending);
905 break;
906 }
907
908 if (ret < 0)
909 pr_err("Failed to apply widget power: %d\n",
910 ret);
911 }
912
913 if (!list_empty(&pending))
914 dapm_seq_run_coalesced(codec, &pending);
915 }
916
917 /*
918 * Scan each dapm widget for complete audio path.
919 * A complete path is a route that has valid endpoints i.e.:-
920 *
921 * o DAC to output pin.
922 * o Input Pin to ADC.
923 * o Input pin to Output pin (bypass, sidetone)
924 * o DAC to ADC (loopback).
925 */
926 static int dapm_power_widgets(struct snd_soc_codec *codec, int event)
927 {
928 struct snd_soc_device *socdev = codec->socdev;
929 struct snd_soc_dapm_widget *w;
930 LIST_HEAD(up_list);
931 LIST_HEAD(down_list);
932 int ret = 0;
933 int power;
934 int sys_power = 0;
935
936 /* Check which widgets we need to power and store them in
937 * lists indicating if they should be powered up or down.
938 */
939 list_for_each_entry(w, &codec->dapm_widgets, list) {
940 switch (w->id) {
941 case snd_soc_dapm_pre:
942 dapm_seq_insert(w, &down_list, dapm_down_seq);
943 break;
944 case snd_soc_dapm_post:
945 dapm_seq_insert(w, &up_list, dapm_up_seq);
946 break;
947
948 default:
949 if (!w->power_check)
950 continue;
951
952 power = w->power_check(w);
953 if (power)
954 sys_power = 1;
955
956 if (w->power == power)
957 continue;
958
959 if (power)
960 dapm_seq_insert(w, &up_list, dapm_up_seq);
961 else
962 dapm_seq_insert(w, &down_list, dapm_down_seq);
963
964 w->power = power;
965 break;
966 }
967 }
968
969 /* If we're changing to all on or all off then prepare */
970 if ((sys_power && codec->bias_level == SND_SOC_BIAS_STANDBY) ||
971 (!sys_power && codec->bias_level == SND_SOC_BIAS_ON)) {
972 ret = snd_soc_dapm_set_bias_level(socdev,
973 SND_SOC_BIAS_PREPARE);
974 if (ret != 0)
975 pr_err("Failed to prepare bias: %d\n", ret);
976 }
977
978 /* Power down widgets first; try to avoid amplifying pops. */
979 dapm_seq_run(codec, &down_list, event, dapm_down_seq);
980
981 /* Now power up. */
982 dapm_seq_run(codec, &up_list, event, dapm_up_seq);
983
984 /* If we just powered the last thing off drop to standby bias */
985 if (codec->bias_level == SND_SOC_BIAS_PREPARE && !sys_power) {
986 ret = snd_soc_dapm_set_bias_level(socdev,
987 SND_SOC_BIAS_STANDBY);
988 if (ret != 0)
989 pr_err("Failed to apply standby bias: %d\n", ret);
990 }
991
992 /* If we just powered up then move to active bias */
993 if (codec->bias_level == SND_SOC_BIAS_PREPARE && sys_power) {
994 ret = snd_soc_dapm_set_bias_level(socdev,
995 SND_SOC_BIAS_ON);
996 if (ret != 0)
997 pr_err("Failed to apply active bias: %d\n", ret);
998 }
999
1000 pop_dbg(codec->pop_time, "DAPM sequencing finished, waiting %dms\n",
1001 codec->pop_time);
1002
1003 return 0;
1004 }
1005
1006 #ifdef DEBUG
1007 static void dbg_dump_dapm(struct snd_soc_codec* codec, const char *action)
1008 {
1009 struct snd_soc_dapm_widget *w;
1010 struct snd_soc_dapm_path *p = NULL;
1011 int in, out;
1012
1013 printk("DAPM %s %s\n", codec->name, action);
1014
1015 list_for_each_entry(w, &codec->dapm_widgets, list) {
1016
1017 /* only display widgets that effect routing */
1018 switch (w->id) {
1019 case snd_soc_dapm_pre:
1020 case snd_soc_dapm_post:
1021 case snd_soc_dapm_vmid:
1022 continue;
1023 case snd_soc_dapm_mux:
1024 case snd_soc_dapm_value_mux:
1025 case snd_soc_dapm_output:
1026 case snd_soc_dapm_input:
1027 case snd_soc_dapm_switch:
1028 case snd_soc_dapm_hp:
1029 case snd_soc_dapm_mic:
1030 case snd_soc_dapm_spk:
1031 case snd_soc_dapm_line:
1032 case snd_soc_dapm_micbias:
1033 case snd_soc_dapm_dac:
1034 case snd_soc_dapm_adc:
1035 case snd_soc_dapm_pga:
1036 case snd_soc_dapm_mixer:
1037 case snd_soc_dapm_mixer_named_ctl:
1038 case snd_soc_dapm_supply:
1039 if (w->name) {
1040 in = is_connected_input_ep(w);
1041 dapm_clear_walk(w->codec);
1042 out = is_connected_output_ep(w);
1043 dapm_clear_walk(w->codec);
1044 printk("%s: %s in %d out %d\n", w->name,
1045 w->power ? "On":"Off",in, out);
1046
1047 list_for_each_entry(p, &w->sources, list_sink) {
1048 if (p->connect)
1049 printk(" in %s %s\n", p->name ? p->name : "static",
1050 p->source->name);
1051 }
1052 list_for_each_entry(p, &w->sinks, list_source) {
1053 if (p->connect)
1054 printk(" out %s %s\n", p->name ? p->name : "static",
1055 p->sink->name);
1056 }
1057 }
1058 break;
1059 }
1060 }
1061 }
1062 #endif
1063
1064 /* test and update the power status of a mux widget */
1065 static int dapm_mux_update_power(struct snd_soc_dapm_widget *widget,
1066 struct snd_kcontrol *kcontrol, int mask,
1067 int mux, int val, struct soc_enum *e)
1068 {
1069 struct snd_soc_dapm_path *path;
1070 int found = 0;
1071
1072 if (widget->id != snd_soc_dapm_mux &&
1073 widget->id != snd_soc_dapm_value_mux)
1074 return -ENODEV;
1075
1076 if (!snd_soc_test_bits(widget->codec, e->reg, mask, val))
1077 return 0;
1078
1079 /* find dapm widget path assoc with kcontrol */
1080 list_for_each_entry(path, &widget->codec->dapm_paths, list) {
1081 if (path->kcontrol != kcontrol)
1082 continue;
1083
1084 if (!path->name || !e->texts[mux])
1085 continue;
1086
1087 found = 1;
1088 /* we now need to match the string in the enum to the path */
1089 if (!(strcmp(path->name, e->texts[mux])))
1090 path->connect = 1; /* new connection */
1091 else
1092 path->connect = 0; /* old connection must be powered down */
1093 }
1094
1095 if (found) {
1096 dapm_power_widgets(widget->codec, SND_SOC_DAPM_STREAM_NOP);
1097 dump_dapm(widget->codec, "mux power update");
1098 }
1099
1100 return 0;
1101 }
1102
1103 /* test and update the power status of a mixer or switch widget */
1104 static int dapm_mixer_update_power(struct snd_soc_dapm_widget *widget,
1105 struct snd_kcontrol *kcontrol, int reg,
1106 int val_mask, int val, int invert)
1107 {
1108 struct snd_soc_dapm_path *path;
1109 int found = 0;
1110
1111 if (widget->id != snd_soc_dapm_mixer &&
1112 widget->id != snd_soc_dapm_mixer_named_ctl &&
1113 widget->id != snd_soc_dapm_switch)
1114 return -ENODEV;
1115
1116 if (!snd_soc_test_bits(widget->codec, reg, val_mask, val))
1117 return 0;
1118
1119 /* find dapm widget path assoc with kcontrol */
1120 list_for_each_entry(path, &widget->codec->dapm_paths, list) {
1121 if (path->kcontrol != kcontrol)
1122 continue;
1123
1124 /* found, now check type */
1125 found = 1;
1126 if (val)
1127 /* new connection */
1128 path->connect = invert ? 0:1;
1129 else
1130 /* old connection must be powered down */
1131 path->connect = invert ? 1:0;
1132 break;
1133 }
1134
1135 if (found) {
1136 dapm_power_widgets(widget->codec, SND_SOC_DAPM_STREAM_NOP);
1137 dump_dapm(widget->codec, "mixer power update");
1138 }
1139
1140 return 0;
1141 }
1142
1143 /* show dapm widget status in sys fs */
1144 static ssize_t dapm_widget_show(struct device *dev,
1145 struct device_attribute *attr, char *buf)
1146 {
1147 struct snd_soc_device *devdata = dev_get_drvdata(dev);
1148 struct snd_soc_codec *codec = devdata->card->codec;
1149 struct snd_soc_dapm_widget *w;
1150 int count = 0;
1151 char *state = "not set";
1152
1153 list_for_each_entry(w, &codec->dapm_widgets, list) {
1154
1155 /* only display widgets that burnm power */
1156 switch (w->id) {
1157 case snd_soc_dapm_hp:
1158 case snd_soc_dapm_mic:
1159 case snd_soc_dapm_spk:
1160 case snd_soc_dapm_line:
1161 case snd_soc_dapm_micbias:
1162 case snd_soc_dapm_dac:
1163 case snd_soc_dapm_adc:
1164 case snd_soc_dapm_pga:
1165 case snd_soc_dapm_mixer:
1166 case snd_soc_dapm_mixer_named_ctl:
1167 case snd_soc_dapm_supply:
1168 if (w->name)
1169 count += sprintf(buf + count, "%s: %s\n",
1170 w->name, w->power ? "On":"Off");
1171 break;
1172 default:
1173 break;
1174 }
1175 }
1176
1177 switch (codec->bias_level) {
1178 case SND_SOC_BIAS_ON:
1179 state = "On";
1180 break;
1181 case SND_SOC_BIAS_PREPARE:
1182 state = "Prepare";
1183 break;
1184 case SND_SOC_BIAS_STANDBY:
1185 state = "Standby";
1186 break;
1187 case SND_SOC_BIAS_OFF:
1188 state = "Off";
1189 break;
1190 }
1191 count += sprintf(buf + count, "PM State: %s\n", state);
1192
1193 return count;
1194 }
1195
1196 static DEVICE_ATTR(dapm_widget, 0444, dapm_widget_show, NULL);
1197
1198 int snd_soc_dapm_sys_add(struct device *dev)
1199 {
1200 return device_create_file(dev, &dev_attr_dapm_widget);
1201 }
1202
1203 static void snd_soc_dapm_sys_remove(struct device *dev)
1204 {
1205 device_remove_file(dev, &dev_attr_dapm_widget);
1206 }
1207
1208 /* free all dapm widgets and resources */
1209 static void dapm_free_widgets(struct snd_soc_codec *codec)
1210 {
1211 struct snd_soc_dapm_widget *w, *next_w;
1212 struct snd_soc_dapm_path *p, *next_p;
1213
1214 list_for_each_entry_safe(w, next_w, &codec->dapm_widgets, list) {
1215 list_del(&w->list);
1216 kfree(w);
1217 }
1218
1219 list_for_each_entry_safe(p, next_p, &codec->dapm_paths, list) {
1220 list_del(&p->list);
1221 kfree(p->long_name);
1222 kfree(p);
1223 }
1224 }
1225
1226 static int snd_soc_dapm_set_pin(struct snd_soc_codec *codec,
1227 const char *pin, int status)
1228 {
1229 struct snd_soc_dapm_widget *w;
1230
1231 list_for_each_entry(w, &codec->dapm_widgets, list) {
1232 if (!strcmp(w->name, pin)) {
1233 pr_debug("dapm: %s: pin %s\n", codec->name, pin);
1234 w->connected = status;
1235 return 0;
1236 }
1237 }
1238
1239 pr_err("dapm: %s: configuring unknown pin %s\n", codec->name, pin);
1240 return -EINVAL;
1241 }
1242
1243 /**
1244 * snd_soc_dapm_sync - scan and power dapm paths
1245 * @codec: audio codec
1246 *
1247 * Walks all dapm audio paths and powers widgets according to their
1248 * stream or path usage.
1249 *
1250 * Returns 0 for success.
1251 */
1252 int snd_soc_dapm_sync(struct snd_soc_codec *codec)
1253 {
1254 int ret = dapm_power_widgets(codec, SND_SOC_DAPM_STREAM_NOP);
1255 dump_dapm(codec, "sync");
1256 return ret;
1257 }
1258 EXPORT_SYMBOL_GPL(snd_soc_dapm_sync);
1259
1260 static int snd_soc_dapm_add_route(struct snd_soc_codec *codec,
1261 const char *sink, const char *control, const char *source)
1262 {
1263 struct snd_soc_dapm_path *path;
1264 struct snd_soc_dapm_widget *wsource = NULL, *wsink = NULL, *w;
1265 int ret = 0;
1266
1267 /* find src and dest widgets */
1268 list_for_each_entry(w, &codec->dapm_widgets, list) {
1269
1270 if (!wsink && !(strcmp(w->name, sink))) {
1271 wsink = w;
1272 continue;
1273 }
1274 if (!wsource && !(strcmp(w->name, source))) {
1275 wsource = w;
1276 }
1277 }
1278
1279 if (wsource == NULL || wsink == NULL)
1280 return -ENODEV;
1281
1282 path = kzalloc(sizeof(struct snd_soc_dapm_path), GFP_KERNEL);
1283 if (!path)
1284 return -ENOMEM;
1285
1286 path->source = wsource;
1287 path->sink = wsink;
1288 INIT_LIST_HEAD(&path->list);
1289 INIT_LIST_HEAD(&path->list_source);
1290 INIT_LIST_HEAD(&path->list_sink);
1291
1292 /* check for external widgets */
1293 if (wsink->id == snd_soc_dapm_input) {
1294 if (wsource->id == snd_soc_dapm_micbias ||
1295 wsource->id == snd_soc_dapm_mic ||
1296 wsource->id == snd_soc_dapm_line ||
1297 wsource->id == snd_soc_dapm_output)
1298 wsink->ext = 1;
1299 }
1300 if (wsource->id == snd_soc_dapm_output) {
1301 if (wsink->id == snd_soc_dapm_spk ||
1302 wsink->id == snd_soc_dapm_hp ||
1303 wsink->id == snd_soc_dapm_line ||
1304 wsink->id == snd_soc_dapm_input)
1305 wsource->ext = 1;
1306 }
1307
1308 /* connect static paths */
1309 if (control == NULL) {
1310 list_add(&path->list, &codec->dapm_paths);
1311 list_add(&path->list_sink, &wsink->sources);
1312 list_add(&path->list_source, &wsource->sinks);
1313 path->connect = 1;
1314 return 0;
1315 }
1316
1317 /* connect dynamic paths */
1318 switch(wsink->id) {
1319 case snd_soc_dapm_adc:
1320 case snd_soc_dapm_dac:
1321 case snd_soc_dapm_pga:
1322 case snd_soc_dapm_input:
1323 case snd_soc_dapm_output:
1324 case snd_soc_dapm_micbias:
1325 case snd_soc_dapm_vmid:
1326 case snd_soc_dapm_pre:
1327 case snd_soc_dapm_post:
1328 case snd_soc_dapm_supply:
1329 list_add(&path->list, &codec->dapm_paths);
1330 list_add(&path->list_sink, &wsink->sources);
1331 list_add(&path->list_source, &wsource->sinks);
1332 path->connect = 1;
1333 return 0;
1334 case snd_soc_dapm_mux:
1335 case snd_soc_dapm_value_mux:
1336 ret = dapm_connect_mux(codec, wsource, wsink, path, control,
1337 &wsink->kcontrols[0]);
1338 if (ret != 0)
1339 goto err;
1340 break;
1341 case snd_soc_dapm_switch:
1342 case snd_soc_dapm_mixer:
1343 case snd_soc_dapm_mixer_named_ctl:
1344 ret = dapm_connect_mixer(codec, wsource, wsink, path, control);
1345 if (ret != 0)
1346 goto err;
1347 break;
1348 case snd_soc_dapm_hp:
1349 case snd_soc_dapm_mic:
1350 case snd_soc_dapm_line:
1351 case snd_soc_dapm_spk:
1352 list_add(&path->list, &codec->dapm_paths);
1353 list_add(&path->list_sink, &wsink->sources);
1354 list_add(&path->list_source, &wsource->sinks);
1355 path->connect = 0;
1356 return 0;
1357 }
1358 return 0;
1359
1360 err:
1361 printk(KERN_WARNING "asoc: no dapm match for %s --> %s --> %s\n", source,
1362 control, sink);
1363 kfree(path);
1364 return ret;
1365 }
1366
1367 /**
1368 * snd_soc_dapm_add_routes - Add routes between DAPM widgets
1369 * @codec: codec
1370 * @route: audio routes
1371 * @num: number of routes
1372 *
1373 * Connects 2 dapm widgets together via a named audio path. The sink is
1374 * the widget receiving the audio signal, whilst the source is the sender
1375 * of the audio signal.
1376 *
1377 * Returns 0 for success else error. On error all resources can be freed
1378 * with a call to snd_soc_card_free().
1379 */
1380 int snd_soc_dapm_add_routes(struct snd_soc_codec *codec,
1381 const struct snd_soc_dapm_route *route, int num)
1382 {
1383 int i, ret;
1384
1385 for (i = 0; i < num; i++) {
1386 ret = snd_soc_dapm_add_route(codec, route->sink,
1387 route->control, route->source);
1388 if (ret < 0) {
1389 printk(KERN_ERR "Failed to add route %s->%s\n",
1390 route->source,
1391 route->sink);
1392 return ret;
1393 }
1394 route++;
1395 }
1396
1397 return 0;
1398 }
1399 EXPORT_SYMBOL_GPL(snd_soc_dapm_add_routes);
1400
1401 /**
1402 * snd_soc_dapm_new_widgets - add new dapm widgets
1403 * @codec: audio codec
1404 *
1405 * Checks the codec for any new dapm widgets and creates them if found.
1406 *
1407 * Returns 0 for success.
1408 */
1409 int snd_soc_dapm_new_widgets(struct snd_soc_codec *codec)
1410 {
1411 struct snd_soc_dapm_widget *w;
1412
1413 list_for_each_entry(w, &codec->dapm_widgets, list)
1414 {
1415 if (w->new)
1416 continue;
1417
1418 switch(w->id) {
1419 case snd_soc_dapm_switch:
1420 case snd_soc_dapm_mixer:
1421 case snd_soc_dapm_mixer_named_ctl:
1422 w->power_check = dapm_generic_check_power;
1423 dapm_new_mixer(codec, w);
1424 break;
1425 case snd_soc_dapm_mux:
1426 case snd_soc_dapm_value_mux:
1427 w->power_check = dapm_generic_check_power;
1428 dapm_new_mux(codec, w);
1429 break;
1430 case snd_soc_dapm_adc:
1431 w->power_check = dapm_adc_check_power;
1432 break;
1433 case snd_soc_dapm_dac:
1434 w->power_check = dapm_dac_check_power;
1435 break;
1436 case snd_soc_dapm_pga:
1437 w->power_check = dapm_generic_check_power;
1438 dapm_new_pga(codec, w);
1439 break;
1440 case snd_soc_dapm_input:
1441 case snd_soc_dapm_output:
1442 case snd_soc_dapm_micbias:
1443 case snd_soc_dapm_spk:
1444 case snd_soc_dapm_hp:
1445 case snd_soc_dapm_mic:
1446 case snd_soc_dapm_line:
1447 w->power_check = dapm_generic_check_power;
1448 break;
1449 case snd_soc_dapm_supply:
1450 w->power_check = dapm_supply_check_power;
1451 case snd_soc_dapm_vmid:
1452 case snd_soc_dapm_pre:
1453 case snd_soc_dapm_post:
1454 break;
1455 }
1456 w->new = 1;
1457 }
1458
1459 dapm_power_widgets(codec, SND_SOC_DAPM_STREAM_NOP);
1460 return 0;
1461 }
1462 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_widgets);
1463
1464 /**
1465 * snd_soc_dapm_get_volsw - dapm mixer get callback
1466 * @kcontrol: mixer control
1467 * @ucontrol: control element information
1468 *
1469 * Callback to get the value of a dapm mixer control.
1470 *
1471 * Returns 0 for success.
1472 */
1473 int snd_soc_dapm_get_volsw(struct snd_kcontrol *kcontrol,
1474 struct snd_ctl_elem_value *ucontrol)
1475 {
1476 struct snd_soc_dapm_widget *widget = snd_kcontrol_chip(kcontrol);
1477 struct soc_mixer_control *mc =
1478 (struct soc_mixer_control *)kcontrol->private_value;
1479 unsigned int reg = mc->reg;
1480 unsigned int shift = mc->shift;
1481 unsigned int rshift = mc->rshift;
1482 int max = mc->max;
1483 unsigned int invert = mc->invert;
1484 unsigned int mask = (1 << fls(max)) - 1;
1485
1486 /* return the saved value if we are powered down */
1487 if (widget->id == snd_soc_dapm_pga && !widget->power) {
1488 ucontrol->value.integer.value[0] = widget->saved_value;
1489 return 0;
1490 }
1491
1492 ucontrol->value.integer.value[0] =
1493 (snd_soc_read(widget->codec, reg) >> shift) & mask;
1494 if (shift != rshift)
1495 ucontrol->value.integer.value[1] =
1496 (snd_soc_read(widget->codec, reg) >> rshift) & mask;
1497 if (invert) {
1498 ucontrol->value.integer.value[0] =
1499 max - ucontrol->value.integer.value[0];
1500 if (shift != rshift)
1501 ucontrol->value.integer.value[1] =
1502 max - ucontrol->value.integer.value[1];
1503 }
1504
1505 return 0;
1506 }
1507 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_volsw);
1508
1509 /**
1510 * snd_soc_dapm_put_volsw - dapm mixer set callback
1511 * @kcontrol: mixer control
1512 * @ucontrol: control element information
1513 *
1514 * Callback to set the value of a dapm mixer control.
1515 *
1516 * Returns 0 for success.
1517 */
1518 int snd_soc_dapm_put_volsw(struct snd_kcontrol *kcontrol,
1519 struct snd_ctl_elem_value *ucontrol)
1520 {
1521 struct snd_soc_dapm_widget *widget = snd_kcontrol_chip(kcontrol);
1522 struct soc_mixer_control *mc =
1523 (struct soc_mixer_control *)kcontrol->private_value;
1524 unsigned int reg = mc->reg;
1525 unsigned int shift = mc->shift;
1526 unsigned int rshift = mc->rshift;
1527 int max = mc->max;
1528 unsigned int mask = (1 << fls(max)) - 1;
1529 unsigned int invert = mc->invert;
1530 unsigned int val, val2, val_mask;
1531 int ret;
1532
1533 val = (ucontrol->value.integer.value[0] & mask);
1534
1535 if (invert)
1536 val = max - val;
1537 val_mask = mask << shift;
1538 val = val << shift;
1539 if (shift != rshift) {
1540 val2 = (ucontrol->value.integer.value[1] & mask);
1541 if (invert)
1542 val2 = max - val2;
1543 val_mask |= mask << rshift;
1544 val |= val2 << rshift;
1545 }
1546
1547 mutex_lock(&widget->codec->mutex);
1548 widget->value = val;
1549
1550 /* save volume value if the widget is powered down */
1551 if (widget->id == snd_soc_dapm_pga && !widget->power) {
1552 widget->saved_value = val;
1553 mutex_unlock(&widget->codec->mutex);
1554 return 1;
1555 }
1556
1557 dapm_mixer_update_power(widget, kcontrol, reg, val_mask, val, invert);
1558 if (widget->event) {
1559 if (widget->event_flags & SND_SOC_DAPM_PRE_REG) {
1560 ret = widget->event(widget, kcontrol,
1561 SND_SOC_DAPM_PRE_REG);
1562 if (ret < 0) {
1563 ret = 1;
1564 goto out;
1565 }
1566 }
1567 ret = snd_soc_update_bits(widget->codec, reg, val_mask, val);
1568 if (widget->event_flags & SND_SOC_DAPM_POST_REG)
1569 ret = widget->event(widget, kcontrol,
1570 SND_SOC_DAPM_POST_REG);
1571 } else
1572 ret = snd_soc_update_bits(widget->codec, reg, val_mask, val);
1573
1574 out:
1575 mutex_unlock(&widget->codec->mutex);
1576 return ret;
1577 }
1578 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_volsw);
1579
1580 /**
1581 * snd_soc_dapm_get_enum_double - dapm enumerated double mixer get callback
1582 * @kcontrol: mixer control
1583 * @ucontrol: control element information
1584 *
1585 * Callback to get the value of a dapm enumerated double mixer control.
1586 *
1587 * Returns 0 for success.
1588 */
1589 int snd_soc_dapm_get_enum_double(struct snd_kcontrol *kcontrol,
1590 struct snd_ctl_elem_value *ucontrol)
1591 {
1592 struct snd_soc_dapm_widget *widget = snd_kcontrol_chip(kcontrol);
1593 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1594 unsigned int val, bitmask;
1595
1596 for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
1597 ;
1598 val = snd_soc_read(widget->codec, e->reg);
1599 ucontrol->value.enumerated.item[0] = (val >> e->shift_l) & (bitmask - 1);
1600 if (e->shift_l != e->shift_r)
1601 ucontrol->value.enumerated.item[1] =
1602 (val >> e->shift_r) & (bitmask - 1);
1603
1604 return 0;
1605 }
1606 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_enum_double);
1607
1608 /**
1609 * snd_soc_dapm_put_enum_double - dapm enumerated double mixer set callback
1610 * @kcontrol: mixer control
1611 * @ucontrol: control element information
1612 *
1613 * Callback to set the value of a dapm enumerated double mixer control.
1614 *
1615 * Returns 0 for success.
1616 */
1617 int snd_soc_dapm_put_enum_double(struct snd_kcontrol *kcontrol,
1618 struct snd_ctl_elem_value *ucontrol)
1619 {
1620 struct snd_soc_dapm_widget *widget = snd_kcontrol_chip(kcontrol);
1621 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1622 unsigned int val, mux;
1623 unsigned int mask, bitmask;
1624 int ret = 0;
1625
1626 for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
1627 ;
1628 if (ucontrol->value.enumerated.item[0] > e->max - 1)
1629 return -EINVAL;
1630 mux = ucontrol->value.enumerated.item[0];
1631 val = mux << e->shift_l;
1632 mask = (bitmask - 1) << e->shift_l;
1633 if (e->shift_l != e->shift_r) {
1634 if (ucontrol->value.enumerated.item[1] > e->max - 1)
1635 return -EINVAL;
1636 val |= ucontrol->value.enumerated.item[1] << e->shift_r;
1637 mask |= (bitmask - 1) << e->shift_r;
1638 }
1639
1640 mutex_lock(&widget->codec->mutex);
1641 widget->value = val;
1642 dapm_mux_update_power(widget, kcontrol, mask, mux, val, e);
1643 if (widget->event) {
1644 if (widget->event_flags & SND_SOC_DAPM_PRE_REG) {
1645 ret = widget->event(widget,
1646 kcontrol, SND_SOC_DAPM_PRE_REG);
1647 if (ret < 0)
1648 goto out;
1649 }
1650 ret = snd_soc_update_bits(widget->codec, e->reg, mask, val);
1651 if (widget->event_flags & SND_SOC_DAPM_POST_REG)
1652 ret = widget->event(widget,
1653 kcontrol, SND_SOC_DAPM_POST_REG);
1654 } else
1655 ret = snd_soc_update_bits(widget->codec, e->reg, mask, val);
1656
1657 out:
1658 mutex_unlock(&widget->codec->mutex);
1659 return ret;
1660 }
1661 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_enum_double);
1662
1663 /**
1664 * snd_soc_dapm_get_value_enum_double - dapm semi enumerated double mixer get
1665 * callback
1666 * @kcontrol: mixer control
1667 * @ucontrol: control element information
1668 *
1669 * Callback to get the value of a dapm semi enumerated double mixer control.
1670 *
1671 * Semi enumerated mixer: the enumerated items are referred as values. Can be
1672 * used for handling bitfield coded enumeration for example.
1673 *
1674 * Returns 0 for success.
1675 */
1676 int snd_soc_dapm_get_value_enum_double(struct snd_kcontrol *kcontrol,
1677 struct snd_ctl_elem_value *ucontrol)
1678 {
1679 struct snd_soc_dapm_widget *widget = snd_kcontrol_chip(kcontrol);
1680 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1681 unsigned int reg_val, val, mux;
1682
1683 reg_val = snd_soc_read(widget->codec, e->reg);
1684 val = (reg_val >> e->shift_l) & e->mask;
1685 for (mux = 0; mux < e->max; mux++) {
1686 if (val == e->values[mux])
1687 break;
1688 }
1689 ucontrol->value.enumerated.item[0] = mux;
1690 if (e->shift_l != e->shift_r) {
1691 val = (reg_val >> e->shift_r) & e->mask;
1692 for (mux = 0; mux < e->max; mux++) {
1693 if (val == e->values[mux])
1694 break;
1695 }
1696 ucontrol->value.enumerated.item[1] = mux;
1697 }
1698
1699 return 0;
1700 }
1701 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_value_enum_double);
1702
1703 /**
1704 * snd_soc_dapm_put_value_enum_double - dapm semi enumerated double mixer set
1705 * callback
1706 * @kcontrol: mixer control
1707 * @ucontrol: control element information
1708 *
1709 * Callback to set the value of a dapm semi enumerated double mixer control.
1710 *
1711 * Semi enumerated mixer: the enumerated items are referred as values. Can be
1712 * used for handling bitfield coded enumeration for example.
1713 *
1714 * Returns 0 for success.
1715 */
1716 int snd_soc_dapm_put_value_enum_double(struct snd_kcontrol *kcontrol,
1717 struct snd_ctl_elem_value *ucontrol)
1718 {
1719 struct snd_soc_dapm_widget *widget = snd_kcontrol_chip(kcontrol);
1720 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1721 unsigned int val, mux;
1722 unsigned int mask;
1723 int ret = 0;
1724
1725 if (ucontrol->value.enumerated.item[0] > e->max - 1)
1726 return -EINVAL;
1727 mux = ucontrol->value.enumerated.item[0];
1728 val = e->values[ucontrol->value.enumerated.item[0]] << e->shift_l;
1729 mask = e->mask << e->shift_l;
1730 if (e->shift_l != e->shift_r) {
1731 if (ucontrol->value.enumerated.item[1] > e->max - 1)
1732 return -EINVAL;
1733 val |= e->values[ucontrol->value.enumerated.item[1]] << e->shift_r;
1734 mask |= e->mask << e->shift_r;
1735 }
1736
1737 mutex_lock(&widget->codec->mutex);
1738 widget->value = val;
1739 dapm_mux_update_power(widget, kcontrol, mask, mux, val, e);
1740 if (widget->event) {
1741 if (widget->event_flags & SND_SOC_DAPM_PRE_REG) {
1742 ret = widget->event(widget,
1743 kcontrol, SND_SOC_DAPM_PRE_REG);
1744 if (ret < 0)
1745 goto out;
1746 }
1747 ret = snd_soc_update_bits(widget->codec, e->reg, mask, val);
1748 if (widget->event_flags & SND_SOC_DAPM_POST_REG)
1749 ret = widget->event(widget,
1750 kcontrol, SND_SOC_DAPM_POST_REG);
1751 } else
1752 ret = snd_soc_update_bits(widget->codec, e->reg, mask, val);
1753
1754 out:
1755 mutex_unlock(&widget->codec->mutex);
1756 return ret;
1757 }
1758 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_value_enum_double);
1759
1760 /**
1761 * snd_soc_dapm_info_pin_switch - Info for a pin switch
1762 *
1763 * @kcontrol: mixer control
1764 * @uinfo: control element information
1765 *
1766 * Callback to provide information about a pin switch control.
1767 */
1768 int snd_soc_dapm_info_pin_switch(struct snd_kcontrol *kcontrol,
1769 struct snd_ctl_elem_info *uinfo)
1770 {
1771 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
1772 uinfo->count = 1;
1773 uinfo->value.integer.min = 0;
1774 uinfo->value.integer.max = 1;
1775
1776 return 0;
1777 }
1778 EXPORT_SYMBOL_GPL(snd_soc_dapm_info_pin_switch);
1779
1780 /**
1781 * snd_soc_dapm_get_pin_switch - Get information for a pin switch
1782 *
1783 * @kcontrol: mixer control
1784 * @ucontrol: Value
1785 */
1786 int snd_soc_dapm_get_pin_switch(struct snd_kcontrol *kcontrol,
1787 struct snd_ctl_elem_value *ucontrol)
1788 {
1789 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1790 const char *pin = (const char *)kcontrol->private_value;
1791
1792 mutex_lock(&codec->mutex);
1793
1794 ucontrol->value.integer.value[0] =
1795 snd_soc_dapm_get_pin_status(codec, pin);
1796
1797 mutex_unlock(&codec->mutex);
1798
1799 return 0;
1800 }
1801 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_pin_switch);
1802
1803 /**
1804 * snd_soc_dapm_put_pin_switch - Set information for a pin switch
1805 *
1806 * @kcontrol: mixer control
1807 * @ucontrol: Value
1808 */
1809 int snd_soc_dapm_put_pin_switch(struct snd_kcontrol *kcontrol,
1810 struct snd_ctl_elem_value *ucontrol)
1811 {
1812 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1813 const char *pin = (const char *)kcontrol->private_value;
1814
1815 mutex_lock(&codec->mutex);
1816
1817 if (ucontrol->value.integer.value[0])
1818 snd_soc_dapm_enable_pin(codec, pin);
1819 else
1820 snd_soc_dapm_disable_pin(codec, pin);
1821
1822 snd_soc_dapm_sync(codec);
1823
1824 mutex_unlock(&codec->mutex);
1825
1826 return 0;
1827 }
1828 EXPORT_SYMBOL_GPL(snd_soc_dapm_put_pin_switch);
1829
1830 /**
1831 * snd_soc_dapm_new_control - create new dapm control
1832 * @codec: audio codec
1833 * @widget: widget template
1834 *
1835 * Creates a new dapm control based upon the template.
1836 *
1837 * Returns 0 for success else error.
1838 */
1839 int snd_soc_dapm_new_control(struct snd_soc_codec *codec,
1840 const struct snd_soc_dapm_widget *widget)
1841 {
1842 struct snd_soc_dapm_widget *w;
1843
1844 if ((w = dapm_cnew_widget(widget)) == NULL)
1845 return -ENOMEM;
1846
1847 w->codec = codec;
1848 INIT_LIST_HEAD(&w->sources);
1849 INIT_LIST_HEAD(&w->sinks);
1850 INIT_LIST_HEAD(&w->list);
1851 list_add(&w->list, &codec->dapm_widgets);
1852
1853 /* machine layer set ups unconnected pins and insertions */
1854 w->connected = 1;
1855 return 0;
1856 }
1857 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_control);
1858
1859 /**
1860 * snd_soc_dapm_new_controls - create new dapm controls
1861 * @codec: audio codec
1862 * @widget: widget array
1863 * @num: number of widgets
1864 *
1865 * Creates new DAPM controls based upon the templates.
1866 *
1867 * Returns 0 for success else error.
1868 */
1869 int snd_soc_dapm_new_controls(struct snd_soc_codec *codec,
1870 const struct snd_soc_dapm_widget *widget,
1871 int num)
1872 {
1873 int i, ret;
1874
1875 for (i = 0; i < num; i++) {
1876 ret = snd_soc_dapm_new_control(codec, widget);
1877 if (ret < 0) {
1878 printk(KERN_ERR
1879 "ASoC: Failed to create DAPM control %s: %d\n",
1880 widget->name, ret);
1881 return ret;
1882 }
1883 widget++;
1884 }
1885 return 0;
1886 }
1887 EXPORT_SYMBOL_GPL(snd_soc_dapm_new_controls);
1888
1889
1890 /**
1891 * snd_soc_dapm_stream_event - send a stream event to the dapm core
1892 * @codec: audio codec
1893 * @stream: stream name
1894 * @event: stream event
1895 *
1896 * Sends a stream event to the dapm core. The core then makes any
1897 * necessary widget power changes.
1898 *
1899 * Returns 0 for success else error.
1900 */
1901 int snd_soc_dapm_stream_event(struct snd_soc_codec *codec,
1902 char *stream, int event)
1903 {
1904 struct snd_soc_dapm_widget *w;
1905
1906 if (stream == NULL)
1907 return 0;
1908
1909 mutex_lock(&codec->mutex);
1910 list_for_each_entry(w, &codec->dapm_widgets, list)
1911 {
1912 if (!w->sname)
1913 continue;
1914 pr_debug("widget %s\n %s stream %s event %d\n",
1915 w->name, w->sname, stream, event);
1916 if (strstr(w->sname, stream)) {
1917 switch(event) {
1918 case SND_SOC_DAPM_STREAM_START:
1919 w->active = 1;
1920 break;
1921 case SND_SOC_DAPM_STREAM_STOP:
1922 w->active = 0;
1923 break;
1924 case SND_SOC_DAPM_STREAM_SUSPEND:
1925 if (w->active)
1926 w->suspend = 1;
1927 w->active = 0;
1928 break;
1929 case SND_SOC_DAPM_STREAM_RESUME:
1930 if (w->suspend) {
1931 w->active = 1;
1932 w->suspend = 0;
1933 }
1934 break;
1935 case SND_SOC_DAPM_STREAM_PAUSE_PUSH:
1936 break;
1937 case SND_SOC_DAPM_STREAM_PAUSE_RELEASE:
1938 break;
1939 }
1940 }
1941 }
1942 mutex_unlock(&codec->mutex);
1943
1944 dapm_power_widgets(codec, event);
1945 dump_dapm(codec, __func__);
1946 return 0;
1947 }
1948 EXPORT_SYMBOL_GPL(snd_soc_dapm_stream_event);
1949
1950 /**
1951 * snd_soc_dapm_enable_pin - enable pin.
1952 * @codec: SoC codec
1953 * @pin: pin name
1954 *
1955 * Enables input/output pin and its parents or children widgets iff there is
1956 * a valid audio route and active audio stream.
1957 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
1958 * do any widget power switching.
1959 */
1960 int snd_soc_dapm_enable_pin(struct snd_soc_codec *codec, const char *pin)
1961 {
1962 return snd_soc_dapm_set_pin(codec, pin, 1);
1963 }
1964 EXPORT_SYMBOL_GPL(snd_soc_dapm_enable_pin);
1965
1966 /**
1967 * snd_soc_dapm_disable_pin - disable pin.
1968 * @codec: SoC codec
1969 * @pin: pin name
1970 *
1971 * Disables input/output pin and its parents or children widgets.
1972 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
1973 * do any widget power switching.
1974 */
1975 int snd_soc_dapm_disable_pin(struct snd_soc_codec *codec, const char *pin)
1976 {
1977 return snd_soc_dapm_set_pin(codec, pin, 0);
1978 }
1979 EXPORT_SYMBOL_GPL(snd_soc_dapm_disable_pin);
1980
1981 /**
1982 * snd_soc_dapm_nc_pin - permanently disable pin.
1983 * @codec: SoC codec
1984 * @pin: pin name
1985 *
1986 * Marks the specified pin as being not connected, disabling it along
1987 * any parent or child widgets. At present this is identical to
1988 * snd_soc_dapm_disable_pin() but in future it will be extended to do
1989 * additional things such as disabling controls which only affect
1990 * paths through the pin.
1991 *
1992 * NOTE: snd_soc_dapm_sync() needs to be called after this for DAPM to
1993 * do any widget power switching.
1994 */
1995 int snd_soc_dapm_nc_pin(struct snd_soc_codec *codec, const char *pin)
1996 {
1997 return snd_soc_dapm_set_pin(codec, pin, 0);
1998 }
1999 EXPORT_SYMBOL_GPL(snd_soc_dapm_nc_pin);
2000
2001 /**
2002 * snd_soc_dapm_get_pin_status - get audio pin status
2003 * @codec: audio codec
2004 * @pin: audio signal pin endpoint (or start point)
2005 *
2006 * Get audio pin status - connected or disconnected.
2007 *
2008 * Returns 1 for connected otherwise 0.
2009 */
2010 int snd_soc_dapm_get_pin_status(struct snd_soc_codec *codec, const char *pin)
2011 {
2012 struct snd_soc_dapm_widget *w;
2013
2014 list_for_each_entry(w, &codec->dapm_widgets, list) {
2015 if (!strcmp(w->name, pin))
2016 return w->connected;
2017 }
2018
2019 return 0;
2020 }
2021 EXPORT_SYMBOL_GPL(snd_soc_dapm_get_pin_status);
2022
2023 /**
2024 * snd_soc_dapm_free - free dapm resources
2025 * @socdev: SoC device
2026 *
2027 * Free all dapm widgets and resources.
2028 */
2029 void snd_soc_dapm_free(struct snd_soc_device *socdev)
2030 {
2031 struct snd_soc_codec *codec = socdev->card->codec;
2032
2033 snd_soc_dapm_sys_remove(socdev->dev);
2034 dapm_free_widgets(codec);
2035 }
2036 EXPORT_SYMBOL_GPL(snd_soc_dapm_free);
2037
2038 /*
2039 * snd_soc_dapm_shutdown - callback for system shutdown
2040 */
2041 void snd_soc_dapm_shutdown(struct snd_soc_device *socdev)
2042 {
2043 struct snd_soc_codec *codec = socdev->card->codec;
2044 struct snd_soc_dapm_widget *w;
2045 LIST_HEAD(down_list);
2046 int powerdown = 0;
2047
2048 list_for_each_entry(w, &codec->dapm_widgets, list) {
2049 if (w->power) {
2050 dapm_seq_insert(w, &down_list, dapm_down_seq);
2051 w->power = 0;
2052 powerdown = 1;
2053 }
2054 }
2055
2056 /* If there were no widgets to power down we're already in
2057 * standby.
2058 */
2059 if (powerdown) {
2060 snd_soc_dapm_set_bias_level(socdev, SND_SOC_BIAS_PREPARE);
2061 dapm_seq_run(codec, &down_list, 0, dapm_down_seq);
2062 snd_soc_dapm_set_bias_level(socdev, SND_SOC_BIAS_STANDBY);
2063 }
2064
2065 snd_soc_dapm_set_bias_level(socdev, SND_SOC_BIAS_OFF);
2066 }
2067
2068 /* Module information */
2069 MODULE_AUTHOR("Liam Girdwood, lrg@slimlogic.co.uk");
2070 MODULE_DESCRIPTION("Dynamic Audio Power Management core for ALSA SoC");
2071 MODULE_LICENSE("GPL");
This page took 0.072256 seconds and 6 git commands to generate.