2 * wm8350.c -- WM8350 ALSA SoC audio driver
4 * Copyright (C) 2007, 2008 Wolfson Microelectronics PLC.
6 * Author: Liam Girdwood <lrg@slimlogic.co.uk>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
13 #include <linux/module.h>
14 #include <linux/moduleparam.h>
15 #include <linux/init.h>
16 #include <linux/slab.h>
17 #include <linux/delay.h>
19 #include <linux/platform_device.h>
20 #include <linux/mfd/wm8350/audio.h>
21 #include <linux/mfd/wm8350/core.h>
22 #include <linux/regulator/consumer.h>
23 #include <sound/core.h>
24 #include <sound/pcm.h>
25 #include <sound/pcm_params.h>
26 #include <sound/soc.h>
27 #include <sound/initval.h>
28 #include <sound/tlv.h>
29 #include <trace/events/asoc.h>
33 #define WM8350_OUTn_0dB 0x39
35 #define WM8350_RAMP_NONE 0
36 #define WM8350_RAMP_UP 1
37 #define WM8350_RAMP_DOWN 2
39 /* We only include the analogue supplies here; the digital supplies
40 * need to be available well before this driver can be probed.
42 static const char *supply_names
[] = {
47 struct wm8350_output
{
55 struct wm8350_jack_data
{
56 struct snd_soc_jack
*jack
;
57 struct delayed_work work
;
63 struct snd_soc_codec codec
;
64 struct wm8350_output out1
;
65 struct wm8350_output out2
;
66 struct wm8350_jack_data hpl
;
67 struct wm8350_jack_data hpr
;
68 struct wm8350_jack_data mic
;
69 struct regulator_bulk_data supplies
[ARRAY_SIZE(supply_names
)];
74 static unsigned int wm8350_codec_cache_read(struct snd_soc_codec
*codec
,
77 struct wm8350
*wm8350
= codec
->control_data
;
78 return wm8350
->reg_cache
[reg
];
81 static unsigned int wm8350_codec_read(struct snd_soc_codec
*codec
,
84 struct wm8350
*wm8350
= codec
->control_data
;
85 return wm8350_reg_read(wm8350
, reg
);
88 static int wm8350_codec_write(struct snd_soc_codec
*codec
, unsigned int reg
,
91 struct wm8350
*wm8350
= codec
->control_data
;
92 return wm8350_reg_write(wm8350
, reg
, value
);
96 * Ramp OUT1 PGA volume to minimise pops at stream startup and shutdown.
98 static inline int wm8350_out1_ramp_step(struct snd_soc_codec
*codec
)
100 struct wm8350_data
*wm8350_data
= snd_soc_codec_get_drvdata(codec
);
101 struct wm8350_output
*out1
= &wm8350_data
->out1
;
102 struct wm8350
*wm8350
= codec
->control_data
;
103 int left_complete
= 0, right_complete
= 0;
107 reg
= wm8350_reg_read(wm8350
, WM8350_LOUT1_VOLUME
);
108 val
= (reg
& WM8350_OUT1L_VOL_MASK
) >> WM8350_OUT1L_VOL_SHIFT
;
110 if (out1
->ramp
== WM8350_RAMP_UP
) {
112 if (val
< out1
->left_vol
) {
114 reg
&= ~WM8350_OUT1L_VOL_MASK
;
115 wm8350_reg_write(wm8350
, WM8350_LOUT1_VOLUME
,
116 reg
| (val
<< WM8350_OUT1L_VOL_SHIFT
));
119 } else if (out1
->ramp
== WM8350_RAMP_DOWN
) {
123 reg
&= ~WM8350_OUT1L_VOL_MASK
;
124 wm8350_reg_write(wm8350
, WM8350_LOUT1_VOLUME
,
125 reg
| (val
<< WM8350_OUT1L_VOL_SHIFT
));
132 reg
= wm8350_reg_read(wm8350
, WM8350_ROUT1_VOLUME
);
133 val
= (reg
& WM8350_OUT1R_VOL_MASK
) >> WM8350_OUT1R_VOL_SHIFT
;
134 if (out1
->ramp
== WM8350_RAMP_UP
) {
136 if (val
< out1
->right_vol
) {
138 reg
&= ~WM8350_OUT1R_VOL_MASK
;
139 wm8350_reg_write(wm8350
, WM8350_ROUT1_VOLUME
,
140 reg
| (val
<< WM8350_OUT1R_VOL_SHIFT
));
143 } else if (out1
->ramp
== WM8350_RAMP_DOWN
) {
147 reg
&= ~WM8350_OUT1R_VOL_MASK
;
148 wm8350_reg_write(wm8350
, WM8350_ROUT1_VOLUME
,
149 reg
| (val
<< WM8350_OUT1R_VOL_SHIFT
));
154 /* only hit the update bit if either volume has changed this step */
155 if (!left_complete
|| !right_complete
)
156 wm8350_set_bits(wm8350
, WM8350_LOUT1_VOLUME
, WM8350_OUT1_VU
);
158 return left_complete
& right_complete
;
162 * Ramp OUT2 PGA volume to minimise pops at stream startup and shutdown.
164 static inline int wm8350_out2_ramp_step(struct snd_soc_codec
*codec
)
166 struct wm8350_data
*wm8350_data
= snd_soc_codec_get_drvdata(codec
);
167 struct wm8350_output
*out2
= &wm8350_data
->out2
;
168 struct wm8350
*wm8350
= codec
->control_data
;
169 int left_complete
= 0, right_complete
= 0;
173 reg
= wm8350_reg_read(wm8350
, WM8350_LOUT2_VOLUME
);
174 val
= (reg
& WM8350_OUT2L_VOL_MASK
) >> WM8350_OUT1L_VOL_SHIFT
;
175 if (out2
->ramp
== WM8350_RAMP_UP
) {
177 if (val
< out2
->left_vol
) {
179 reg
&= ~WM8350_OUT2L_VOL_MASK
;
180 wm8350_reg_write(wm8350
, WM8350_LOUT2_VOLUME
,
181 reg
| (val
<< WM8350_OUT1L_VOL_SHIFT
));
184 } else if (out2
->ramp
== WM8350_RAMP_DOWN
) {
188 reg
&= ~WM8350_OUT2L_VOL_MASK
;
189 wm8350_reg_write(wm8350
, WM8350_LOUT2_VOLUME
,
190 reg
| (val
<< WM8350_OUT1L_VOL_SHIFT
));
197 reg
= wm8350_reg_read(wm8350
, WM8350_ROUT2_VOLUME
);
198 val
= (reg
& WM8350_OUT2R_VOL_MASK
) >> WM8350_OUT1R_VOL_SHIFT
;
199 if (out2
->ramp
== WM8350_RAMP_UP
) {
201 if (val
< out2
->right_vol
) {
203 reg
&= ~WM8350_OUT2R_VOL_MASK
;
204 wm8350_reg_write(wm8350
, WM8350_ROUT2_VOLUME
,
205 reg
| (val
<< WM8350_OUT1R_VOL_SHIFT
));
208 } else if (out2
->ramp
== WM8350_RAMP_DOWN
) {
212 reg
&= ~WM8350_OUT2R_VOL_MASK
;
213 wm8350_reg_write(wm8350
, WM8350_ROUT2_VOLUME
,
214 reg
| (val
<< WM8350_OUT1R_VOL_SHIFT
));
219 /* only hit the update bit if either volume has changed this step */
220 if (!left_complete
|| !right_complete
)
221 wm8350_set_bits(wm8350
, WM8350_LOUT2_VOLUME
, WM8350_OUT2_VU
);
223 return left_complete
& right_complete
;
227 * This work ramps both output PGAs at stream start/stop time to
228 * minimise pop associated with DAPM power switching.
229 * It's best to enable Zero Cross when ramping occurs to minimise any
232 static void wm8350_pga_work(struct work_struct
*work
)
234 struct snd_soc_dapm_context
*dapm
=
235 container_of(work
, struct snd_soc_dapm_context
, delayed_work
.work
);
236 struct snd_soc_codec
*codec
= dapm
->codec
;
237 struct wm8350_data
*wm8350_data
= snd_soc_codec_get_drvdata(codec
);
238 struct wm8350_output
*out1
= &wm8350_data
->out1
,
239 *out2
= &wm8350_data
->out2
;
240 int i
, out1_complete
, out2_complete
;
242 /* do we need to ramp at all ? */
243 if (out1
->ramp
== WM8350_RAMP_NONE
&& out2
->ramp
== WM8350_RAMP_NONE
)
246 /* PGA volumes have 6 bits of resolution to ramp */
247 for (i
= 0; i
<= 63; i
++) {
248 out1_complete
= 1, out2_complete
= 1;
249 if (out1
->ramp
!= WM8350_RAMP_NONE
)
250 out1_complete
= wm8350_out1_ramp_step(codec
);
251 if (out2
->ramp
!= WM8350_RAMP_NONE
)
252 out2_complete
= wm8350_out2_ramp_step(codec
);
254 /* ramp finished ? */
255 if (out1_complete
&& out2_complete
)
258 /* we need to delay longer on the up ramp */
259 if (out1
->ramp
== WM8350_RAMP_UP
||
260 out2
->ramp
== WM8350_RAMP_UP
) {
261 /* delay is longer over 0dB as increases are larger */
262 if (i
>= WM8350_OUTn_0dB
)
263 schedule_timeout_interruptible(msecs_to_jiffies
266 schedule_timeout_interruptible(msecs_to_jiffies
269 udelay(50); /* doesn't matter if we delay longer */
272 out1
->ramp
= WM8350_RAMP_NONE
;
273 out2
->ramp
= WM8350_RAMP_NONE
;
280 static int pga_event(struct snd_soc_dapm_widget
*w
,
281 struct snd_kcontrol
*kcontrol
, int event
)
283 struct snd_soc_codec
*codec
= w
->codec
;
284 struct wm8350_data
*wm8350_data
= snd_soc_codec_get_drvdata(codec
);
285 struct wm8350_output
*out
;
290 out
= &wm8350_data
->out1
;
294 out
= &wm8350_data
->out2
;
303 case SND_SOC_DAPM_POST_PMU
:
304 out
->ramp
= WM8350_RAMP_UP
;
307 if (!delayed_work_pending(&codec
->dapm
.delayed_work
))
308 schedule_delayed_work(&codec
->dapm
.delayed_work
,
309 msecs_to_jiffies(1));
312 case SND_SOC_DAPM_PRE_PMD
:
313 out
->ramp
= WM8350_RAMP_DOWN
;
316 if (!delayed_work_pending(&codec
->dapm
.delayed_work
))
317 schedule_delayed_work(&codec
->dapm
.delayed_work
,
318 msecs_to_jiffies(1));
325 static int wm8350_put_volsw_2r_vu(struct snd_kcontrol
*kcontrol
,
326 struct snd_ctl_elem_value
*ucontrol
)
328 struct snd_soc_codec
*codec
= snd_kcontrol_chip(kcontrol
);
329 struct wm8350_data
*wm8350_priv
= snd_soc_codec_get_drvdata(codec
);
330 struct wm8350_output
*out
= NULL
;
331 struct soc_mixer_control
*mc
=
332 (struct soc_mixer_control
*)kcontrol
->private_value
;
334 unsigned int reg
= mc
->reg
;
337 /* For OUT1 and OUT2 we shadow the values and only actually write
338 * them out when active in order to ensure the amplifier comes on
339 * as quietly as possible. */
341 case WM8350_LOUT1_VOLUME
:
342 out
= &wm8350_priv
->out1
;
344 case WM8350_LOUT2_VOLUME
:
345 out
= &wm8350_priv
->out2
;
352 out
->left_vol
= ucontrol
->value
.integer
.value
[0];
353 out
->right_vol
= ucontrol
->value
.integer
.value
[1];
358 ret
= snd_soc_put_volsw_2r(kcontrol
, ucontrol
);
362 /* now hit the volume update bits (always bit 8) */
363 val
= wm8350_codec_read(codec
, reg
);
364 wm8350_codec_write(codec
, reg
, val
| WM8350_OUT1_VU
);
368 static int wm8350_get_volsw_2r(struct snd_kcontrol
*kcontrol
,
369 struct snd_ctl_elem_value
*ucontrol
)
371 struct snd_soc_codec
*codec
= snd_kcontrol_chip(kcontrol
);
372 struct wm8350_data
*wm8350_priv
= snd_soc_codec_get_drvdata(codec
);
373 struct wm8350_output
*out1
= &wm8350_priv
->out1
;
374 struct wm8350_output
*out2
= &wm8350_priv
->out2
;
375 struct soc_mixer_control
*mc
=
376 (struct soc_mixer_control
*)kcontrol
->private_value
;
377 unsigned int reg
= mc
->reg
;
379 /* If these are cached registers use the cache */
381 case WM8350_LOUT1_VOLUME
:
382 ucontrol
->value
.integer
.value
[0] = out1
->left_vol
;
383 ucontrol
->value
.integer
.value
[1] = out1
->right_vol
;
386 case WM8350_LOUT2_VOLUME
:
387 ucontrol
->value
.integer
.value
[0] = out2
->left_vol
;
388 ucontrol
->value
.integer
.value
[1] = out2
->right_vol
;
395 return snd_soc_get_volsw_2r(kcontrol
, ucontrol
);
398 /* double control with volume update */
399 #define SOC_WM8350_DOUBLE_R_TLV(xname, reg_left, reg_right, xshift, xmax, \
400 xinvert, tlv_array) \
401 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname), \
402 .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
403 SNDRV_CTL_ELEM_ACCESS_READWRITE | \
404 SNDRV_CTL_ELEM_ACCESS_VOLATILE, \
405 .tlv.p = (tlv_array), \
406 .info = snd_soc_info_volsw_2r, \
407 .get = wm8350_get_volsw_2r, .put = wm8350_put_volsw_2r_vu, \
408 .private_value = (unsigned long)&(struct soc_mixer_control) \
409 {.reg = reg_left, .rreg = reg_right, .shift = xshift, \
410 .rshift = xshift, .max = xmax, .invert = xinvert}, }
412 static const char *wm8350_deemp
[] = { "None", "32kHz", "44.1kHz", "48kHz" };
413 static const char *wm8350_pol
[] = { "Normal", "Inv R", "Inv L", "Inv L & R" };
414 static const char *wm8350_dacmutem
[] = { "Normal", "Soft" };
415 static const char *wm8350_dacmutes
[] = { "Fast", "Slow" };
416 static const char *wm8350_adcfilter
[] = { "None", "High Pass" };
417 static const char *wm8350_adchp
[] = { "44.1kHz", "8kHz", "16kHz", "32kHz" };
418 static const char *wm8350_lr
[] = { "Left", "Right" };
420 static const struct soc_enum wm8350_enum
[] = {
421 SOC_ENUM_SINGLE(WM8350_DAC_CONTROL
, 4, 4, wm8350_deemp
),
422 SOC_ENUM_SINGLE(WM8350_DAC_CONTROL
, 0, 4, wm8350_pol
),
423 SOC_ENUM_SINGLE(WM8350_DAC_MUTE_VOLUME
, 14, 2, wm8350_dacmutem
),
424 SOC_ENUM_SINGLE(WM8350_DAC_MUTE_VOLUME
, 13, 2, wm8350_dacmutes
),
425 SOC_ENUM_SINGLE(WM8350_ADC_CONTROL
, 15, 2, wm8350_adcfilter
),
426 SOC_ENUM_SINGLE(WM8350_ADC_CONTROL
, 8, 4, wm8350_adchp
),
427 SOC_ENUM_SINGLE(WM8350_ADC_CONTROL
, 0, 4, wm8350_pol
),
428 SOC_ENUM_SINGLE(WM8350_INPUT_MIXER_VOLUME
, 15, 2, wm8350_lr
),
431 static DECLARE_TLV_DB_SCALE(pre_amp_tlv
, -1200, 3525, 0);
432 static DECLARE_TLV_DB_SCALE(out_pga_tlv
, -5700, 600, 0);
433 static DECLARE_TLV_DB_SCALE(dac_pcm_tlv
, -7163, 36, 1);
434 static DECLARE_TLV_DB_SCALE(adc_pcm_tlv
, -12700, 50, 1);
435 static DECLARE_TLV_DB_SCALE(out_mix_tlv
, -1500, 300, 1);
437 static const unsigned int capture_sd_tlv
[] = {
438 TLV_DB_RANGE_HEAD(2),
439 0, 12, TLV_DB_SCALE_ITEM(-3600, 300, 1),
440 13, 15, TLV_DB_SCALE_ITEM(0, 0, 0),
443 static const struct snd_kcontrol_new wm8350_snd_controls
[] = {
444 SOC_ENUM("Playback Deemphasis", wm8350_enum
[0]),
445 SOC_ENUM("Playback DAC Inversion", wm8350_enum
[1]),
446 SOC_WM8350_DOUBLE_R_TLV("Playback PCM Volume",
447 WM8350_DAC_DIGITAL_VOLUME_L
,
448 WM8350_DAC_DIGITAL_VOLUME_R
,
449 0, 255, 0, dac_pcm_tlv
),
450 SOC_ENUM("Playback PCM Mute Function", wm8350_enum
[2]),
451 SOC_ENUM("Playback PCM Mute Speed", wm8350_enum
[3]),
452 SOC_ENUM("Capture PCM Filter", wm8350_enum
[4]),
453 SOC_ENUM("Capture PCM HP Filter", wm8350_enum
[5]),
454 SOC_ENUM("Capture ADC Inversion", wm8350_enum
[6]),
455 SOC_WM8350_DOUBLE_R_TLV("Capture PCM Volume",
456 WM8350_ADC_DIGITAL_VOLUME_L
,
457 WM8350_ADC_DIGITAL_VOLUME_R
,
458 0, 255, 0, adc_pcm_tlv
),
459 SOC_DOUBLE_TLV("Capture Sidetone Volume",
461 8, 4, 15, 1, capture_sd_tlv
),
462 SOC_WM8350_DOUBLE_R_TLV("Capture Volume",
463 WM8350_LEFT_INPUT_VOLUME
,
464 WM8350_RIGHT_INPUT_VOLUME
,
465 2, 63, 0, pre_amp_tlv
),
466 SOC_DOUBLE_R("Capture ZC Switch",
467 WM8350_LEFT_INPUT_VOLUME
,
468 WM8350_RIGHT_INPUT_VOLUME
, 13, 1, 0),
469 SOC_SINGLE_TLV("Left Input Left Sidetone Volume",
470 WM8350_OUTPUT_LEFT_MIXER_VOLUME
, 1, 7, 0, out_mix_tlv
),
471 SOC_SINGLE_TLV("Left Input Right Sidetone Volume",
472 WM8350_OUTPUT_LEFT_MIXER_VOLUME
,
473 5, 7, 0, out_mix_tlv
),
474 SOC_SINGLE_TLV("Left Input Bypass Volume",
475 WM8350_OUTPUT_LEFT_MIXER_VOLUME
,
476 9, 7, 0, out_mix_tlv
),
477 SOC_SINGLE_TLV("Right Input Left Sidetone Volume",
478 WM8350_OUTPUT_RIGHT_MIXER_VOLUME
,
479 1, 7, 0, out_mix_tlv
),
480 SOC_SINGLE_TLV("Right Input Right Sidetone Volume",
481 WM8350_OUTPUT_RIGHT_MIXER_VOLUME
,
482 5, 7, 0, out_mix_tlv
),
483 SOC_SINGLE_TLV("Right Input Bypass Volume",
484 WM8350_OUTPUT_RIGHT_MIXER_VOLUME
,
485 13, 7, 0, out_mix_tlv
),
486 SOC_SINGLE("Left Input Mixer +20dB Switch",
487 WM8350_INPUT_MIXER_VOLUME_L
, 0, 1, 0),
488 SOC_SINGLE("Right Input Mixer +20dB Switch",
489 WM8350_INPUT_MIXER_VOLUME_R
, 0, 1, 0),
490 SOC_SINGLE_TLV("Out4 Capture Volume",
491 WM8350_INPUT_MIXER_VOLUME
,
492 1, 7, 0, out_mix_tlv
),
493 SOC_WM8350_DOUBLE_R_TLV("Out1 Playback Volume",
496 2, 63, 0, out_pga_tlv
),
497 SOC_DOUBLE_R("Out1 Playback ZC Switch",
499 WM8350_ROUT1_VOLUME
, 13, 1, 0),
500 SOC_WM8350_DOUBLE_R_TLV("Out2 Playback Volume",
503 2, 63, 0, out_pga_tlv
),
504 SOC_DOUBLE_R("Out2 Playback ZC Switch", WM8350_LOUT2_VOLUME
,
505 WM8350_ROUT2_VOLUME
, 13, 1, 0),
506 SOC_SINGLE("Out2 Right Invert Switch", WM8350_ROUT2_VOLUME
, 10, 1, 0),
507 SOC_SINGLE_TLV("Out2 Beep Volume", WM8350_BEEP_VOLUME
,
508 5, 7, 0, out_mix_tlv
),
510 SOC_DOUBLE_R("Out1 Playback Switch",
514 SOC_DOUBLE_R("Out2 Playback Switch",
524 /* Left Playback Mixer */
525 static const struct snd_kcontrol_new wm8350_left_play_mixer_controls
[] = {
526 SOC_DAPM_SINGLE("Playback Switch",
527 WM8350_LEFT_MIXER_CONTROL
, 11, 1, 0),
528 SOC_DAPM_SINGLE("Left Bypass Switch",
529 WM8350_LEFT_MIXER_CONTROL
, 2, 1, 0),
530 SOC_DAPM_SINGLE("Right Playback Switch",
531 WM8350_LEFT_MIXER_CONTROL
, 12, 1, 0),
532 SOC_DAPM_SINGLE("Left Sidetone Switch",
533 WM8350_LEFT_MIXER_CONTROL
, 0, 1, 0),
534 SOC_DAPM_SINGLE("Right Sidetone Switch",
535 WM8350_LEFT_MIXER_CONTROL
, 1, 1, 0),
538 /* Right Playback Mixer */
539 static const struct snd_kcontrol_new wm8350_right_play_mixer_controls
[] = {
540 SOC_DAPM_SINGLE("Playback Switch",
541 WM8350_RIGHT_MIXER_CONTROL
, 12, 1, 0),
542 SOC_DAPM_SINGLE("Right Bypass Switch",
543 WM8350_RIGHT_MIXER_CONTROL
, 3, 1, 0),
544 SOC_DAPM_SINGLE("Left Playback Switch",
545 WM8350_RIGHT_MIXER_CONTROL
, 11, 1, 0),
546 SOC_DAPM_SINGLE("Left Sidetone Switch",
547 WM8350_RIGHT_MIXER_CONTROL
, 0, 1, 0),
548 SOC_DAPM_SINGLE("Right Sidetone Switch",
549 WM8350_RIGHT_MIXER_CONTROL
, 1, 1, 0),
553 static const struct snd_kcontrol_new wm8350_out4_mixer_controls
[] = {
554 SOC_DAPM_SINGLE("Right Playback Switch",
555 WM8350_OUT4_MIXER_CONTROL
, 12, 1, 0),
556 SOC_DAPM_SINGLE("Left Playback Switch",
557 WM8350_OUT4_MIXER_CONTROL
, 11, 1, 0),
558 SOC_DAPM_SINGLE("Right Capture Switch",
559 WM8350_OUT4_MIXER_CONTROL
, 9, 1, 0),
560 SOC_DAPM_SINGLE("Out3 Playback Switch",
561 WM8350_OUT4_MIXER_CONTROL
, 2, 1, 0),
562 SOC_DAPM_SINGLE("Right Mixer Switch",
563 WM8350_OUT4_MIXER_CONTROL
, 1, 1, 0),
564 SOC_DAPM_SINGLE("Left Mixer Switch",
565 WM8350_OUT4_MIXER_CONTROL
, 0, 1, 0),
569 static const struct snd_kcontrol_new wm8350_out3_mixer_controls
[] = {
570 SOC_DAPM_SINGLE("Left Playback Switch",
571 WM8350_OUT3_MIXER_CONTROL
, 11, 1, 0),
572 SOC_DAPM_SINGLE("Left Capture Switch",
573 WM8350_OUT3_MIXER_CONTROL
, 8, 1, 0),
574 SOC_DAPM_SINGLE("Out4 Playback Switch",
575 WM8350_OUT3_MIXER_CONTROL
, 3, 1, 0),
576 SOC_DAPM_SINGLE("Left Mixer Switch",
577 WM8350_OUT3_MIXER_CONTROL
, 0, 1, 0),
580 /* Left Input Mixer */
581 static const struct snd_kcontrol_new wm8350_left_capt_mixer_controls
[] = {
582 SOC_DAPM_SINGLE_TLV("L2 Capture Volume",
583 WM8350_INPUT_MIXER_VOLUME_L
, 1, 7, 0, out_mix_tlv
),
584 SOC_DAPM_SINGLE_TLV("L3 Capture Volume",
585 WM8350_INPUT_MIXER_VOLUME_L
, 9, 7, 0, out_mix_tlv
),
586 SOC_DAPM_SINGLE("PGA Capture Switch",
587 WM8350_LEFT_INPUT_VOLUME
, 14, 1, 1),
590 /* Right Input Mixer */
591 static const struct snd_kcontrol_new wm8350_right_capt_mixer_controls
[] = {
592 SOC_DAPM_SINGLE_TLV("L2 Capture Volume",
593 WM8350_INPUT_MIXER_VOLUME_R
, 5, 7, 0, out_mix_tlv
),
594 SOC_DAPM_SINGLE_TLV("L3 Capture Volume",
595 WM8350_INPUT_MIXER_VOLUME_R
, 13, 7, 0, out_mix_tlv
),
596 SOC_DAPM_SINGLE("PGA Capture Switch",
597 WM8350_RIGHT_INPUT_VOLUME
, 14, 1, 1),
601 static const struct snd_kcontrol_new wm8350_left_mic_mixer_controls
[] = {
602 SOC_DAPM_SINGLE("INN Capture Switch", WM8350_INPUT_CONTROL
, 1, 1, 0),
603 SOC_DAPM_SINGLE("INP Capture Switch", WM8350_INPUT_CONTROL
, 0, 1, 0),
604 SOC_DAPM_SINGLE("IN2 Capture Switch", WM8350_INPUT_CONTROL
, 2, 1, 0),
607 /* Right Mic Mixer */
608 static const struct snd_kcontrol_new wm8350_right_mic_mixer_controls
[] = {
609 SOC_DAPM_SINGLE("INN Capture Switch", WM8350_INPUT_CONTROL
, 9, 1, 0),
610 SOC_DAPM_SINGLE("INP Capture Switch", WM8350_INPUT_CONTROL
, 8, 1, 0),
611 SOC_DAPM_SINGLE("IN2 Capture Switch", WM8350_INPUT_CONTROL
, 10, 1, 0),
615 static const struct snd_kcontrol_new wm8350_beep_switch_controls
=
616 SOC_DAPM_SINGLE("Switch", WM8350_BEEP_VOLUME
, 15, 1, 1);
618 /* Out4 Capture Mux */
619 static const struct snd_kcontrol_new wm8350_out4_capture_controls
=
620 SOC_DAPM_ENUM("Route", wm8350_enum
[7]);
622 static const struct snd_soc_dapm_widget wm8350_dapm_widgets
[] = {
624 SND_SOC_DAPM_PGA("IN3R PGA", WM8350_POWER_MGMT_2
, 11, 0, NULL
, 0),
625 SND_SOC_DAPM_PGA("IN3L PGA", WM8350_POWER_MGMT_2
, 10, 0, NULL
, 0),
626 SND_SOC_DAPM_PGA_E("Right Out2 PGA", WM8350_POWER_MGMT_3
, 3, 0, NULL
,
628 SND_SOC_DAPM_POST_PMU
| SND_SOC_DAPM_PRE_PMD
),
629 SND_SOC_DAPM_PGA_E("Left Out2 PGA", WM8350_POWER_MGMT_3
, 2, 0, NULL
, 0,
631 SND_SOC_DAPM_POST_PMU
| SND_SOC_DAPM_PRE_PMD
),
632 SND_SOC_DAPM_PGA_E("Right Out1 PGA", WM8350_POWER_MGMT_3
, 1, 0, NULL
,
634 SND_SOC_DAPM_POST_PMU
| SND_SOC_DAPM_PRE_PMD
),
635 SND_SOC_DAPM_PGA_E("Left Out1 PGA", WM8350_POWER_MGMT_3
, 0, 0, NULL
, 0,
637 SND_SOC_DAPM_POST_PMU
| SND_SOC_DAPM_PRE_PMD
),
639 SND_SOC_DAPM_MIXER("Right Capture Mixer", WM8350_POWER_MGMT_2
,
640 7, 0, &wm8350_right_capt_mixer_controls
[0],
641 ARRAY_SIZE(wm8350_right_capt_mixer_controls
)),
643 SND_SOC_DAPM_MIXER("Left Capture Mixer", WM8350_POWER_MGMT_2
,
644 6, 0, &wm8350_left_capt_mixer_controls
[0],
645 ARRAY_SIZE(wm8350_left_capt_mixer_controls
)),
647 SND_SOC_DAPM_MIXER("Out4 Mixer", WM8350_POWER_MGMT_2
, 5, 0,
648 &wm8350_out4_mixer_controls
[0],
649 ARRAY_SIZE(wm8350_out4_mixer_controls
)),
651 SND_SOC_DAPM_MIXER("Out3 Mixer", WM8350_POWER_MGMT_2
, 4, 0,
652 &wm8350_out3_mixer_controls
[0],
653 ARRAY_SIZE(wm8350_out3_mixer_controls
)),
655 SND_SOC_DAPM_MIXER("Right Playback Mixer", WM8350_POWER_MGMT_2
, 1, 0,
656 &wm8350_right_play_mixer_controls
[0],
657 ARRAY_SIZE(wm8350_right_play_mixer_controls
)),
659 SND_SOC_DAPM_MIXER("Left Playback Mixer", WM8350_POWER_MGMT_2
, 0, 0,
660 &wm8350_left_play_mixer_controls
[0],
661 ARRAY_SIZE(wm8350_left_play_mixer_controls
)),
663 SND_SOC_DAPM_MIXER("Left Mic Mixer", WM8350_POWER_MGMT_2
, 8, 0,
664 &wm8350_left_mic_mixer_controls
[0],
665 ARRAY_SIZE(wm8350_left_mic_mixer_controls
)),
667 SND_SOC_DAPM_MIXER("Right Mic Mixer", WM8350_POWER_MGMT_2
, 9, 0,
668 &wm8350_right_mic_mixer_controls
[0],
669 ARRAY_SIZE(wm8350_right_mic_mixer_controls
)),
671 /* virtual mixer for Beep and Out2R */
672 SND_SOC_DAPM_MIXER("Out2 Mixer", SND_SOC_NOPM
, 0, 0, NULL
, 0),
674 SND_SOC_DAPM_SWITCH("Beep", WM8350_POWER_MGMT_3
, 7, 0,
675 &wm8350_beep_switch_controls
),
677 SND_SOC_DAPM_ADC("Right ADC", "Right Capture",
678 WM8350_POWER_MGMT_4
, 3, 0),
679 SND_SOC_DAPM_ADC("Left ADC", "Left Capture",
680 WM8350_POWER_MGMT_4
, 2, 0),
681 SND_SOC_DAPM_DAC("Right DAC", "Right Playback",
682 WM8350_POWER_MGMT_4
, 5, 0),
683 SND_SOC_DAPM_DAC("Left DAC", "Left Playback",
684 WM8350_POWER_MGMT_4
, 4, 0),
686 SND_SOC_DAPM_MICBIAS("Mic Bias", WM8350_POWER_MGMT_1
, 4, 0),
688 SND_SOC_DAPM_MUX("Out4 Capture Channel", SND_SOC_NOPM
, 0, 0,
689 &wm8350_out4_capture_controls
),
691 SND_SOC_DAPM_OUTPUT("OUT1R"),
692 SND_SOC_DAPM_OUTPUT("OUT1L"),
693 SND_SOC_DAPM_OUTPUT("OUT2R"),
694 SND_SOC_DAPM_OUTPUT("OUT2L"),
695 SND_SOC_DAPM_OUTPUT("OUT3"),
696 SND_SOC_DAPM_OUTPUT("OUT4"),
698 SND_SOC_DAPM_INPUT("IN1RN"),
699 SND_SOC_DAPM_INPUT("IN1RP"),
700 SND_SOC_DAPM_INPUT("IN2R"),
701 SND_SOC_DAPM_INPUT("IN1LP"),
702 SND_SOC_DAPM_INPUT("IN1LN"),
703 SND_SOC_DAPM_INPUT("IN2L"),
704 SND_SOC_DAPM_INPUT("IN3R"),
705 SND_SOC_DAPM_INPUT("IN3L"),
708 static const struct snd_soc_dapm_route audio_map
[] = {
710 /* left playback mixer */
711 {"Left Playback Mixer", "Playback Switch", "Left DAC"},
712 {"Left Playback Mixer", "Left Bypass Switch", "IN3L PGA"},
713 {"Left Playback Mixer", "Right Playback Switch", "Right DAC"},
714 {"Left Playback Mixer", "Left Sidetone Switch", "Left Mic Mixer"},
715 {"Left Playback Mixer", "Right Sidetone Switch", "Right Mic Mixer"},
717 /* right playback mixer */
718 {"Right Playback Mixer", "Playback Switch", "Right DAC"},
719 {"Right Playback Mixer", "Right Bypass Switch", "IN3R PGA"},
720 {"Right Playback Mixer", "Left Playback Switch", "Left DAC"},
721 {"Right Playback Mixer", "Left Sidetone Switch", "Left Mic Mixer"},
722 {"Right Playback Mixer", "Right Sidetone Switch", "Right Mic Mixer"},
724 /* out4 playback mixer */
725 {"Out4 Mixer", "Right Playback Switch", "Right DAC"},
726 {"Out4 Mixer", "Left Playback Switch", "Left DAC"},
727 {"Out4 Mixer", "Right Capture Switch", "Right Capture Mixer"},
728 {"Out4 Mixer", "Out3 Playback Switch", "Out3 Mixer"},
729 {"Out4 Mixer", "Right Mixer Switch", "Right Playback Mixer"},
730 {"Out4 Mixer", "Left Mixer Switch", "Left Playback Mixer"},
731 {"OUT4", NULL
, "Out4 Mixer"},
733 /* out3 playback mixer */
734 {"Out3 Mixer", "Left Playback Switch", "Left DAC"},
735 {"Out3 Mixer", "Left Capture Switch", "Left Capture Mixer"},
736 {"Out3 Mixer", "Left Mixer Switch", "Left Playback Mixer"},
737 {"Out3 Mixer", "Out4 Playback Switch", "Out4 Mixer"},
738 {"OUT3", NULL
, "Out3 Mixer"},
741 {"Right Out2 PGA", NULL
, "Right Playback Mixer"},
742 {"Left Out2 PGA", NULL
, "Left Playback Mixer"},
743 {"OUT2L", NULL
, "Left Out2 PGA"},
744 {"OUT2R", NULL
, "Right Out2 PGA"},
747 {"Right Out1 PGA", NULL
, "Right Playback Mixer"},
748 {"Left Out1 PGA", NULL
, "Left Playback Mixer"},
749 {"OUT1L", NULL
, "Left Out1 PGA"},
750 {"OUT1R", NULL
, "Right Out1 PGA"},
753 {"Left ADC", NULL
, "Left Capture Mixer"},
754 {"Right ADC", NULL
, "Right Capture Mixer"},
756 /* Left capture mixer */
757 {"Left Capture Mixer", "L2 Capture Volume", "IN2L"},
758 {"Left Capture Mixer", "L3 Capture Volume", "IN3L PGA"},
759 {"Left Capture Mixer", "PGA Capture Switch", "Left Mic Mixer"},
760 {"Left Capture Mixer", NULL
, "Out4 Capture Channel"},
762 /* Right capture mixer */
763 {"Right Capture Mixer", "L2 Capture Volume", "IN2R"},
764 {"Right Capture Mixer", "L3 Capture Volume", "IN3R PGA"},
765 {"Right Capture Mixer", "PGA Capture Switch", "Right Mic Mixer"},
766 {"Right Capture Mixer", NULL
, "Out4 Capture Channel"},
769 {"IN3L PGA", NULL
, "IN3L"},
770 {"IN3R PGA", NULL
, "IN3R"},
773 {"Left Mic Mixer", "INN Capture Switch", "IN1LN"},
774 {"Left Mic Mixer", "INP Capture Switch", "IN1LP"},
775 {"Left Mic Mixer", "IN2 Capture Switch", "IN2L"},
777 /* Right Mic mixer */
778 {"Right Mic Mixer", "INN Capture Switch", "IN1RN"},
779 {"Right Mic Mixer", "INP Capture Switch", "IN1RP"},
780 {"Right Mic Mixer", "IN2 Capture Switch", "IN2R"},
783 {"Out4 Capture Channel", NULL
, "Out4 Mixer"},
786 {"Beep", NULL
, "IN3R PGA"},
789 static int wm8350_add_widgets(struct snd_soc_codec
*codec
)
791 struct snd_soc_dapm_context
*dapm
= &codec
->dapm
;
794 ret
= snd_soc_dapm_new_controls(dapm
,
796 ARRAY_SIZE(wm8350_dapm_widgets
));
798 dev_err(codec
->dev
, "dapm control register failed\n");
802 /* set up audio paths */
803 ret
= snd_soc_dapm_add_routes(dapm
, audio_map
, ARRAY_SIZE(audio_map
));
805 dev_err(codec
->dev
, "DAPM route register failed\n");
812 static int wm8350_set_dai_sysclk(struct snd_soc_dai
*codec_dai
,
813 int clk_id
, unsigned int freq
, int dir
)
815 struct snd_soc_codec
*codec
= codec_dai
->codec
;
816 struct wm8350
*wm8350
= codec
->control_data
;
820 case WM8350_MCLK_SEL_MCLK
:
821 wm8350_clear_bits(wm8350
, WM8350_CLOCK_CONTROL_1
,
824 case WM8350_MCLK_SEL_PLL_MCLK
:
825 case WM8350_MCLK_SEL_PLL_DAC
:
826 case WM8350_MCLK_SEL_PLL_ADC
:
827 case WM8350_MCLK_SEL_PLL_32K
:
828 wm8350_set_bits(wm8350
, WM8350_CLOCK_CONTROL_1
,
830 fll_4
= wm8350_codec_read(codec
, WM8350_FLL_CONTROL_4
) &
831 ~WM8350_FLL_CLK_SRC_MASK
;
832 wm8350_codec_write(codec
, WM8350_FLL_CONTROL_4
, fll_4
| clk_id
);
837 if (dir
== SND_SOC_CLOCK_OUT
)
838 wm8350_set_bits(wm8350
, WM8350_CLOCK_CONTROL_2
,
841 wm8350_clear_bits(wm8350
, WM8350_CLOCK_CONTROL_2
,
847 static int wm8350_set_clkdiv(struct snd_soc_dai
*codec_dai
, int div_id
, int div
)
849 struct snd_soc_codec
*codec
= codec_dai
->codec
;
853 case WM8350_ADC_CLKDIV
:
854 val
= wm8350_codec_read(codec
, WM8350_ADC_DIVIDER
) &
855 ~WM8350_ADC_CLKDIV_MASK
;
856 wm8350_codec_write(codec
, WM8350_ADC_DIVIDER
, val
| div
);
858 case WM8350_DAC_CLKDIV
:
859 val
= wm8350_codec_read(codec
, WM8350_DAC_CLOCK_CONTROL
) &
860 ~WM8350_DAC_CLKDIV_MASK
;
861 wm8350_codec_write(codec
, WM8350_DAC_CLOCK_CONTROL
, val
| div
);
863 case WM8350_BCLK_CLKDIV
:
864 val
= wm8350_codec_read(codec
, WM8350_CLOCK_CONTROL_1
) &
865 ~WM8350_BCLK_DIV_MASK
;
866 wm8350_codec_write(codec
, WM8350_CLOCK_CONTROL_1
, val
| div
);
868 case WM8350_OPCLK_CLKDIV
:
869 val
= wm8350_codec_read(codec
, WM8350_CLOCK_CONTROL_1
) &
870 ~WM8350_OPCLK_DIV_MASK
;
871 wm8350_codec_write(codec
, WM8350_CLOCK_CONTROL_1
, val
| div
);
873 case WM8350_SYS_CLKDIV
:
874 val
= wm8350_codec_read(codec
, WM8350_CLOCK_CONTROL_1
) &
875 ~WM8350_MCLK_DIV_MASK
;
876 wm8350_codec_write(codec
, WM8350_CLOCK_CONTROL_1
, val
| div
);
878 case WM8350_DACLR_CLKDIV
:
879 val
= wm8350_codec_read(codec
, WM8350_DAC_LR_RATE
) &
880 ~WM8350_DACLRC_RATE_MASK
;
881 wm8350_codec_write(codec
, WM8350_DAC_LR_RATE
, val
| div
);
883 case WM8350_ADCLR_CLKDIV
:
884 val
= wm8350_codec_read(codec
, WM8350_ADC_LR_RATE
) &
885 ~WM8350_ADCLRC_RATE_MASK
;
886 wm8350_codec_write(codec
, WM8350_ADC_LR_RATE
, val
| div
);
895 static int wm8350_set_dai_fmt(struct snd_soc_dai
*codec_dai
, unsigned int fmt
)
897 struct snd_soc_codec
*codec
= codec_dai
->codec
;
898 u16 iface
= wm8350_codec_read(codec
, WM8350_AI_FORMATING
) &
899 ~(WM8350_AIF_BCLK_INV
| WM8350_AIF_LRCLK_INV
| WM8350_AIF_FMT_MASK
);
900 u16 master
= wm8350_codec_read(codec
, WM8350_AI_DAC_CONTROL
) &
902 u16 dac_lrc
= wm8350_codec_read(codec
, WM8350_DAC_LR_RATE
) &
904 u16 adc_lrc
= wm8350_codec_read(codec
, WM8350_ADC_LR_RATE
) &
907 /* set master/slave audio interface */
908 switch (fmt
& SND_SOC_DAIFMT_MASTER_MASK
) {
909 case SND_SOC_DAIFMT_CBM_CFM
:
910 master
|= WM8350_BCLK_MSTR
;
911 dac_lrc
|= WM8350_DACLRC_ENA
;
912 adc_lrc
|= WM8350_ADCLRC_ENA
;
914 case SND_SOC_DAIFMT_CBS_CFS
:
920 /* interface format */
921 switch (fmt
& SND_SOC_DAIFMT_FORMAT_MASK
) {
922 case SND_SOC_DAIFMT_I2S
:
925 case SND_SOC_DAIFMT_RIGHT_J
:
927 case SND_SOC_DAIFMT_LEFT_J
:
930 case SND_SOC_DAIFMT_DSP_A
:
933 case SND_SOC_DAIFMT_DSP_B
:
934 iface
|= 0x3 << 8 | WM8350_AIF_LRCLK_INV
;
940 /* clock inversion */
941 switch (fmt
& SND_SOC_DAIFMT_INV_MASK
) {
942 case SND_SOC_DAIFMT_NB_NF
:
944 case SND_SOC_DAIFMT_IB_IF
:
945 iface
|= WM8350_AIF_LRCLK_INV
| WM8350_AIF_BCLK_INV
;
947 case SND_SOC_DAIFMT_IB_NF
:
948 iface
|= WM8350_AIF_BCLK_INV
;
950 case SND_SOC_DAIFMT_NB_IF
:
951 iface
|= WM8350_AIF_LRCLK_INV
;
957 wm8350_codec_write(codec
, WM8350_AI_FORMATING
, iface
);
958 wm8350_codec_write(codec
, WM8350_AI_DAC_CONTROL
, master
);
959 wm8350_codec_write(codec
, WM8350_DAC_LR_RATE
, dac_lrc
);
960 wm8350_codec_write(codec
, WM8350_ADC_LR_RATE
, adc_lrc
);
964 static int wm8350_pcm_trigger(struct snd_pcm_substream
*substream
,
965 int cmd
, struct snd_soc_dai
*codec_dai
)
967 struct snd_soc_codec
*codec
= codec_dai
->codec
;
968 int master
= wm8350_codec_cache_read(codec
, WM8350_AI_DAC_CONTROL
) &
972 /* Check that the DACs or ADCs are enabled since they are
973 * required for LRC in master mode. The DACs or ADCs need a
974 * valid audio path i.e. pin -> ADC or DAC -> pin before
975 * the LRC will be enabled in master mode. */
976 if (!master
|| cmd
!= SNDRV_PCM_TRIGGER_START
)
979 if (substream
->stream
== SNDRV_PCM_STREAM_CAPTURE
) {
980 enabled
= wm8350_codec_cache_read(codec
, WM8350_POWER_MGMT_4
) &
981 (WM8350_ADCR_ENA
| WM8350_ADCL_ENA
);
983 enabled
= wm8350_codec_cache_read(codec
, WM8350_POWER_MGMT_4
) &
984 (WM8350_DACR_ENA
| WM8350_DACL_ENA
);
989 "%s: invalid audio path - no clocks available\n",
996 static int wm8350_pcm_hw_params(struct snd_pcm_substream
*substream
,
997 struct snd_pcm_hw_params
*params
,
998 struct snd_soc_dai
*codec_dai
)
1000 struct snd_soc_codec
*codec
= codec_dai
->codec
;
1001 struct wm8350
*wm8350
= codec
->control_data
;
1002 u16 iface
= wm8350_codec_read(codec
, WM8350_AI_FORMATING
) &
1003 ~WM8350_AIF_WL_MASK
;
1006 switch (params_format(params
)) {
1007 case SNDRV_PCM_FORMAT_S16_LE
:
1009 case SNDRV_PCM_FORMAT_S20_3LE
:
1012 case SNDRV_PCM_FORMAT_S24_LE
:
1015 case SNDRV_PCM_FORMAT_S32_LE
:
1020 wm8350_codec_write(codec
, WM8350_AI_FORMATING
, iface
);
1022 /* The sloping stopband filter is recommended for use with
1023 * lower sample rates to improve performance.
1025 if (substream
->stream
== SNDRV_PCM_STREAM_PLAYBACK
) {
1026 if (params_rate(params
) < 24000)
1027 wm8350_set_bits(wm8350
, WM8350_DAC_MUTE_VOLUME
,
1028 WM8350_DAC_SB_FILT
);
1030 wm8350_clear_bits(wm8350
, WM8350_DAC_MUTE_VOLUME
,
1031 WM8350_DAC_SB_FILT
);
1037 static int wm8350_mute(struct snd_soc_dai
*dai
, int mute
)
1039 struct snd_soc_codec
*codec
= dai
->codec
;
1040 struct wm8350
*wm8350
= codec
->control_data
;
1043 wm8350_set_bits(wm8350
, WM8350_DAC_MUTE
, WM8350_DAC_MUTE_ENA
);
1045 wm8350_clear_bits(wm8350
, WM8350_DAC_MUTE
, WM8350_DAC_MUTE_ENA
);
1051 int div
; /* FLL_OUTDIV */
1054 int ratio
; /* FLL_FRATIO */
1057 /* The size in bits of the fll divide multiplied by 10
1058 * to allow rounding later */
1059 #define FIXED_FLL_SIZE ((1 << 16) * 10)
1061 static inline int fll_factors(struct _fll_div
*fll_div
, unsigned int input
,
1062 unsigned int output
)
1065 unsigned int t1
, t2
, K
, Nmod
;
1067 if (output
>= 2815250 && output
<= 3125000)
1069 else if (output
>= 5625000 && output
<= 6250000)
1071 else if (output
>= 11250000 && output
<= 12500000)
1073 else if (output
>= 22500000 && output
<= 25000000)
1076 printk(KERN_ERR
"wm8350: fll freq %d out of range\n", output
);
1085 t1
= output
* (1 << (fll_div
->div
+ 1));
1086 t2
= input
* fll_div
->ratio
;
1088 fll_div
->n
= t1
/ t2
;
1092 Kpart
= FIXED_FLL_SIZE
* (long long)Nmod
;
1094 K
= Kpart
& 0xFFFFFFFF;
1096 /* Check if we need to round */
1100 /* Move down to proper range now rounding is done */
1109 static int wm8350_set_fll(struct snd_soc_dai
*codec_dai
,
1110 int pll_id
, int source
, unsigned int freq_in
,
1111 unsigned int freq_out
)
1113 struct snd_soc_codec
*codec
= codec_dai
->codec
;
1114 struct wm8350
*wm8350
= codec
->control_data
;
1115 struct wm8350_data
*priv
= snd_soc_codec_get_drvdata(codec
);
1116 struct _fll_div fll_div
;
1120 if (freq_in
== priv
->fll_freq_in
&& freq_out
== priv
->fll_freq_out
)
1123 /* power down FLL - we need to do this for reconfiguration */
1124 wm8350_clear_bits(wm8350
, WM8350_POWER_MGMT_4
,
1125 WM8350_FLL_ENA
| WM8350_FLL_OSC_ENA
);
1127 if (freq_out
== 0 || freq_in
== 0)
1130 ret
= fll_factors(&fll_div
, freq_in
, freq_out
);
1133 dev_dbg(wm8350
->dev
,
1134 "FLL in %u FLL out %u N 0x%x K 0x%x div %d ratio %d",
1135 freq_in
, freq_out
, fll_div
.n
, fll_div
.k
, fll_div
.div
,
1138 /* set up N.K & dividers */
1139 fll_1
= wm8350_codec_read(codec
, WM8350_FLL_CONTROL_1
) &
1140 ~(WM8350_FLL_OUTDIV_MASK
| WM8350_FLL_RSP_RATE_MASK
| 0xc000);
1141 wm8350_codec_write(codec
, WM8350_FLL_CONTROL_1
,
1142 fll_1
| (fll_div
.div
<< 8) | 0x50);
1143 wm8350_codec_write(codec
, WM8350_FLL_CONTROL_2
,
1144 (fll_div
.ratio
<< 11) | (fll_div
.
1145 n
& WM8350_FLL_N_MASK
));
1146 wm8350_codec_write(codec
, WM8350_FLL_CONTROL_3
, fll_div
.k
);
1147 fll_4
= wm8350_codec_read(codec
, WM8350_FLL_CONTROL_4
) &
1148 ~(WM8350_FLL_FRAC
| WM8350_FLL_SLOW_LOCK_REF
);
1149 wm8350_codec_write(codec
, WM8350_FLL_CONTROL_4
,
1150 fll_4
| (fll_div
.k
? WM8350_FLL_FRAC
: 0) |
1151 (fll_div
.ratio
== 8 ? WM8350_FLL_SLOW_LOCK_REF
: 0));
1154 wm8350_set_bits(wm8350
, WM8350_POWER_MGMT_4
, WM8350_FLL_OSC_ENA
);
1155 wm8350_set_bits(wm8350
, WM8350_POWER_MGMT_4
, WM8350_FLL_ENA
);
1157 priv
->fll_freq_out
= freq_out
;
1158 priv
->fll_freq_in
= freq_in
;
1163 static int wm8350_set_bias_level(struct snd_soc_codec
*codec
,
1164 enum snd_soc_bias_level level
)
1166 struct wm8350
*wm8350
= codec
->control_data
;
1167 struct wm8350_data
*priv
= snd_soc_codec_get_drvdata(codec
);
1168 struct wm8350_audio_platform_data
*platform
=
1169 wm8350
->codec
.platform_data
;
1174 case SND_SOC_BIAS_ON
:
1175 pm1
= wm8350_reg_read(wm8350
, WM8350_POWER_MGMT_1
) &
1176 ~(WM8350_VMID_MASK
| WM8350_CODEC_ISEL_MASK
);
1177 wm8350_reg_write(wm8350
, WM8350_POWER_MGMT_1
,
1178 pm1
| WM8350_VMID_50K
|
1179 platform
->codec_current_on
<< 14);
1182 case SND_SOC_BIAS_PREPARE
:
1183 pm1
= wm8350_reg_read(wm8350
, WM8350_POWER_MGMT_1
);
1184 pm1
&= ~WM8350_VMID_MASK
;
1185 wm8350_reg_write(wm8350
, WM8350_POWER_MGMT_1
,
1186 pm1
| WM8350_VMID_50K
);
1189 case SND_SOC_BIAS_STANDBY
:
1190 if (codec
->dapm
.bias_level
== SND_SOC_BIAS_OFF
) {
1191 ret
= regulator_bulk_enable(ARRAY_SIZE(priv
->supplies
),
1196 /* Enable the system clock */
1197 wm8350_set_bits(wm8350
, WM8350_POWER_MGMT_4
,
1200 /* mute DAC & outputs */
1201 wm8350_set_bits(wm8350
, WM8350_DAC_MUTE
,
1202 WM8350_DAC_MUTE_ENA
);
1204 /* discharge cap memory */
1205 wm8350_reg_write(wm8350
, WM8350_ANTI_POP_CONTROL
,
1206 platform
->dis_out1
|
1207 (platform
->dis_out2
<< 2) |
1208 (platform
->dis_out3
<< 4) |
1209 (platform
->dis_out4
<< 6));
1211 /* wait for discharge */
1212 schedule_timeout_interruptible(msecs_to_jiffies
1214 cap_discharge_msecs
));
1216 /* enable antipop */
1217 wm8350_reg_write(wm8350
, WM8350_ANTI_POP_CONTROL
,
1218 (platform
->vmid_s_curve
<< 8));
1221 wm8350_reg_write(wm8350
, WM8350_POWER_MGMT_1
,
1223 codec_current_charge
<< 14) |
1224 WM8350_VMID_5K
| WM8350_VMIDEN
|
1228 schedule_timeout_interruptible(msecs_to_jiffies
1230 vmid_charge_msecs
));
1232 /* turn on vmid 300k */
1233 pm1
= wm8350_reg_read(wm8350
, WM8350_POWER_MGMT_1
) &
1234 ~(WM8350_VMID_MASK
| WM8350_CODEC_ISEL_MASK
);
1235 pm1
|= WM8350_VMID_300K
|
1236 (platform
->codec_current_standby
<< 14);
1237 wm8350_reg_write(wm8350
, WM8350_POWER_MGMT_1
,
1241 /* enable analogue bias */
1242 pm1
|= WM8350_BIASEN
;
1243 wm8350_reg_write(wm8350
, WM8350_POWER_MGMT_1
, pm1
);
1245 /* disable antipop */
1246 wm8350_reg_write(wm8350
, WM8350_ANTI_POP_CONTROL
, 0);
1249 /* turn on vmid 300k and reduce current */
1250 pm1
= wm8350_reg_read(wm8350
, WM8350_POWER_MGMT_1
) &
1251 ~(WM8350_VMID_MASK
| WM8350_CODEC_ISEL_MASK
);
1252 wm8350_reg_write(wm8350
, WM8350_POWER_MGMT_1
,
1253 pm1
| WM8350_VMID_300K
|
1255 codec_current_standby
<< 14));
1260 case SND_SOC_BIAS_OFF
:
1262 /* mute DAC & enable outputs */
1263 wm8350_set_bits(wm8350
, WM8350_DAC_MUTE
, WM8350_DAC_MUTE_ENA
);
1265 wm8350_set_bits(wm8350
, WM8350_POWER_MGMT_3
,
1266 WM8350_OUT1L_ENA
| WM8350_OUT1R_ENA
|
1267 WM8350_OUT2L_ENA
| WM8350_OUT2R_ENA
);
1269 /* enable anti pop S curve */
1270 wm8350_reg_write(wm8350
, WM8350_ANTI_POP_CONTROL
,
1271 (platform
->vmid_s_curve
<< 8));
1274 pm1
= wm8350_reg_read(wm8350
, WM8350_POWER_MGMT_1
) &
1276 wm8350_reg_write(wm8350
, WM8350_POWER_MGMT_1
, pm1
);
1279 schedule_timeout_interruptible(msecs_to_jiffies
1281 vmid_discharge_msecs
));
1283 wm8350_reg_write(wm8350
, WM8350_ANTI_POP_CONTROL
,
1284 (platform
->vmid_s_curve
<< 8) |
1285 platform
->dis_out1
|
1286 (platform
->dis_out2
<< 2) |
1287 (platform
->dis_out3
<< 4) |
1288 (platform
->dis_out4
<< 6));
1290 /* turn off VBuf and drain */
1291 pm1
= wm8350_reg_read(wm8350
, WM8350_POWER_MGMT_1
) &
1292 ~(WM8350_VBUFEN
| WM8350_VMID_MASK
);
1293 wm8350_reg_write(wm8350
, WM8350_POWER_MGMT_1
,
1294 pm1
| WM8350_OUTPUT_DRAIN_EN
);
1297 schedule_timeout_interruptible(msecs_to_jiffies
1298 (platform
->drain_msecs
));
1300 pm1
&= ~WM8350_BIASEN
;
1301 wm8350_reg_write(wm8350
, WM8350_POWER_MGMT_1
, pm1
);
1303 /* disable anti-pop */
1304 wm8350_reg_write(wm8350
, WM8350_ANTI_POP_CONTROL
, 0);
1306 wm8350_clear_bits(wm8350
, WM8350_LOUT1_VOLUME
,
1308 wm8350_clear_bits(wm8350
, WM8350_ROUT1_VOLUME
,
1310 wm8350_clear_bits(wm8350
, WM8350_LOUT2_VOLUME
,
1312 wm8350_clear_bits(wm8350
, WM8350_ROUT2_VOLUME
,
1315 /* disable clock gen */
1316 wm8350_clear_bits(wm8350
, WM8350_POWER_MGMT_4
,
1319 regulator_bulk_disable(ARRAY_SIZE(priv
->supplies
),
1323 codec
->dapm
.bias_level
= level
;
1327 static int wm8350_suspend(struct snd_soc_codec
*codec
, pm_message_t state
)
1329 wm8350_set_bias_level(codec
, SND_SOC_BIAS_OFF
);
1333 static int wm8350_resume(struct snd_soc_codec
*codec
)
1335 wm8350_set_bias_level(codec
, SND_SOC_BIAS_STANDBY
);
1340 static void wm8350_hp_work(struct wm8350_data
*priv
,
1341 struct wm8350_jack_data
*jack
,
1344 struct wm8350
*wm8350
= priv
->codec
.control_data
;
1348 reg
= wm8350_reg_read(wm8350
, WM8350_JACK_PIN_STATUS
);
1350 report
= jack
->report
;
1354 snd_soc_jack_report(jack
->jack
, report
, jack
->report
);
1358 static void wm8350_hpl_work(struct work_struct
*work
)
1360 struct wm8350_data
*priv
=
1361 container_of(work
, struct wm8350_data
, hpl
.work
.work
);
1363 wm8350_hp_work(priv
, &priv
->hpl
, WM8350_JACK_L_LVL
);
1366 static void wm8350_hpr_work(struct work_struct
*work
)
1368 struct wm8350_data
*priv
=
1369 container_of(work
, struct wm8350_data
, hpr
.work
.work
);
1371 wm8350_hp_work(priv
, &priv
->hpr
, WM8350_JACK_R_LVL
);
1374 static irqreturn_t
wm8350_hp_jack_handler(int irq
, void *data
)
1376 struct wm8350_data
*priv
= data
;
1377 struct wm8350
*wm8350
= priv
->codec
.control_data
;
1378 struct wm8350_jack_data
*jack
= NULL
;
1380 switch (irq
- wm8350
->irq_base
) {
1381 case WM8350_IRQ_CODEC_JCK_DET_L
:
1382 #ifndef CONFIG_SND_SOC_WM8350_MODULE
1383 trace_snd_soc_jack_irq("WM8350 HPL");
1388 case WM8350_IRQ_CODEC_JCK_DET_R
:
1389 #ifndef CONFIG_SND_SOC_WM8350_MODULE
1390 trace_snd_soc_jack_irq("WM8350 HPR");
1399 if (device_may_wakeup(wm8350
->dev
))
1400 pm_wakeup_event(wm8350
->dev
, 250);
1402 schedule_delayed_work(&jack
->work
, 200);
1408 * wm8350_hp_jack_detect - Enable headphone jack detection.
1410 * @codec: WM8350 codec
1411 * @which: left or right jack detect signal
1412 * @jack: jack to report detection events on
1413 * @report: value to report
1415 * Enables the headphone jack detection of the WM8350. If no report
1416 * is specified then detection is disabled.
1418 int wm8350_hp_jack_detect(struct snd_soc_codec
*codec
, enum wm8350_jack which
,
1419 struct snd_soc_jack
*jack
, int report
)
1421 struct wm8350_data
*priv
= snd_soc_codec_get_drvdata(codec
);
1422 struct wm8350
*wm8350
= codec
->control_data
;
1428 priv
->hpl
.jack
= jack
;
1429 priv
->hpl
.report
= report
;
1430 irq
= WM8350_IRQ_CODEC_JCK_DET_L
;
1431 ena
= WM8350_JDL_ENA
;
1435 priv
->hpr
.jack
= jack
;
1436 priv
->hpr
.report
= report
;
1437 irq
= WM8350_IRQ_CODEC_JCK_DET_R
;
1438 ena
= WM8350_JDR_ENA
;
1446 wm8350_set_bits(wm8350
, WM8350_POWER_MGMT_4
, WM8350_TOCLK_ENA
);
1447 wm8350_set_bits(wm8350
, WM8350_JACK_DETECT
, ena
);
1449 wm8350_clear_bits(wm8350
, WM8350_JACK_DETECT
, ena
);
1453 wm8350_hp_jack_handler(irq
+ wm8350
->irq_base
, priv
);
1457 EXPORT_SYMBOL_GPL(wm8350_hp_jack_detect
);
1459 static irqreturn_t
wm8350_mic_handler(int irq
, void *data
)
1461 struct wm8350_data
*priv
= data
;
1462 struct wm8350
*wm8350
= priv
->codec
.control_data
;
1466 #ifndef CONFIG_SND_SOC_WM8350_MODULE
1467 trace_snd_soc_jack_irq("WM8350 mic");
1470 reg
= wm8350_reg_read(wm8350
, WM8350_JACK_PIN_STATUS
);
1471 if (reg
& WM8350_JACK_MICSCD_LVL
)
1472 report
|= priv
->mic
.short_report
;
1473 if (reg
& WM8350_JACK_MICSD_LVL
)
1474 report
|= priv
->mic
.report
;
1476 snd_soc_jack_report(priv
->mic
.jack
, report
,
1477 priv
->mic
.report
| priv
->mic
.short_report
);
1483 * wm8350_mic_jack_detect - Enable microphone jack detection.
1485 * @codec: WM8350 codec
1486 * @jack: jack to report detection events on
1487 * @detect_report: value to report when presence detected
1488 * @short_report: value to report when microphone short detected
1490 * Enables the microphone jack detection of the WM8350. If both reports
1491 * are specified as zero then detection is disabled.
1493 int wm8350_mic_jack_detect(struct snd_soc_codec
*codec
,
1494 struct snd_soc_jack
*jack
,
1495 int detect_report
, int short_report
)
1497 struct wm8350_data
*priv
= snd_soc_codec_get_drvdata(codec
);
1498 struct wm8350
*wm8350
= codec
->control_data
;
1500 priv
->mic
.jack
= jack
;
1501 priv
->mic
.report
= detect_report
;
1502 priv
->mic
.short_report
= short_report
;
1504 if (detect_report
|| short_report
) {
1505 wm8350_set_bits(wm8350
, WM8350_POWER_MGMT_4
, WM8350_TOCLK_ENA
);
1506 wm8350_set_bits(wm8350
, WM8350_POWER_MGMT_1
,
1507 WM8350_MIC_DET_ENA
);
1509 wm8350_clear_bits(wm8350
, WM8350_POWER_MGMT_1
,
1510 WM8350_MIC_DET_ENA
);
1515 EXPORT_SYMBOL_GPL(wm8350_mic_jack_detect
);
1517 #define WM8350_RATES (SNDRV_PCM_RATE_8000_96000)
1519 #define WM8350_FORMATS (SNDRV_PCM_FMTBIT_S16_LE |\
1520 SNDRV_PCM_FMTBIT_S20_3LE |\
1521 SNDRV_PCM_FMTBIT_S24_LE)
1523 static struct snd_soc_dai_ops wm8350_dai_ops
= {
1524 .hw_params
= wm8350_pcm_hw_params
,
1525 .digital_mute
= wm8350_mute
,
1526 .trigger
= wm8350_pcm_trigger
,
1527 .set_fmt
= wm8350_set_dai_fmt
,
1528 .set_sysclk
= wm8350_set_dai_sysclk
,
1529 .set_pll
= wm8350_set_fll
,
1530 .set_clkdiv
= wm8350_set_clkdiv
,
1533 static struct snd_soc_dai_driver wm8350_dai
= {
1534 .name
= "wm8350-hifi",
1536 .stream_name
= "Playback",
1539 .rates
= WM8350_RATES
,
1540 .formats
= WM8350_FORMATS
,
1543 .stream_name
= "Capture",
1546 .rates
= WM8350_RATES
,
1547 .formats
= WM8350_FORMATS
,
1549 .ops
= &wm8350_dai_ops
,
1552 static int wm8350_codec_probe(struct snd_soc_codec
*codec
)
1554 struct wm8350
*wm8350
= dev_get_platdata(codec
->dev
);
1555 struct wm8350_data
*priv
;
1556 struct wm8350_output
*out1
;
1557 struct wm8350_output
*out2
;
1560 if (wm8350
->codec
.platform_data
== NULL
) {
1561 dev_err(codec
->dev
, "No audio platform data supplied\n");
1565 priv
= kzalloc(sizeof(struct wm8350_data
), GFP_KERNEL
);
1568 snd_soc_codec_set_drvdata(codec
, priv
);
1570 for (i
= 0; i
< ARRAY_SIZE(supply_names
); i
++)
1571 priv
->supplies
[i
].supply
= supply_names
[i
];
1573 ret
= regulator_bulk_get(wm8350
->dev
, ARRAY_SIZE(priv
->supplies
),
1578 wm8350
->codec
.codec
= codec
;
1579 codec
->control_data
= wm8350
;
1581 /* Put the codec into reset if it wasn't already */
1582 wm8350_clear_bits(wm8350
, WM8350_POWER_MGMT_5
, WM8350_CODEC_ENA
);
1584 INIT_DELAYED_WORK(&codec
->dapm
.delayed_work
, wm8350_pga_work
);
1585 INIT_DELAYED_WORK(&priv
->hpl
.work
, wm8350_hpl_work
);
1586 INIT_DELAYED_WORK(&priv
->hpr
.work
, wm8350_hpr_work
);
1588 /* Enable the codec */
1589 wm8350_set_bits(wm8350
, WM8350_POWER_MGMT_5
, WM8350_CODEC_ENA
);
1591 /* Enable robust clocking mode in ADC */
1592 wm8350_codec_write(codec
, WM8350_SECURITY
, 0xa7);
1593 wm8350_codec_write(codec
, 0xde, 0x13);
1594 wm8350_codec_write(codec
, WM8350_SECURITY
, 0);
1596 /* read OUT1 & OUT2 volumes */
1599 out1
->left_vol
= (wm8350_reg_read(wm8350
, WM8350_LOUT1_VOLUME
) &
1600 WM8350_OUT1L_VOL_MASK
) >> WM8350_OUT1L_VOL_SHIFT
;
1601 out1
->right_vol
= (wm8350_reg_read(wm8350
, WM8350_ROUT1_VOLUME
) &
1602 WM8350_OUT1R_VOL_MASK
) >> WM8350_OUT1R_VOL_SHIFT
;
1603 out2
->left_vol
= (wm8350_reg_read(wm8350
, WM8350_LOUT2_VOLUME
) &
1604 WM8350_OUT2L_VOL_MASK
) >> WM8350_OUT1L_VOL_SHIFT
;
1605 out2
->right_vol
= (wm8350_reg_read(wm8350
, WM8350_ROUT2_VOLUME
) &
1606 WM8350_OUT2R_VOL_MASK
) >> WM8350_OUT1R_VOL_SHIFT
;
1607 wm8350_reg_write(wm8350
, WM8350_LOUT1_VOLUME
, 0);
1608 wm8350_reg_write(wm8350
, WM8350_ROUT1_VOLUME
, 0);
1609 wm8350_reg_write(wm8350
, WM8350_LOUT2_VOLUME
, 0);
1610 wm8350_reg_write(wm8350
, WM8350_ROUT2_VOLUME
, 0);
1612 /* Latch VU bits & mute */
1613 wm8350_set_bits(wm8350
, WM8350_LOUT1_VOLUME
,
1614 WM8350_OUT1_VU
| WM8350_OUT1L_MUTE
);
1615 wm8350_set_bits(wm8350
, WM8350_LOUT2_VOLUME
,
1616 WM8350_OUT2_VU
| WM8350_OUT2L_MUTE
);
1617 wm8350_set_bits(wm8350
, WM8350_ROUT1_VOLUME
,
1618 WM8350_OUT1_VU
| WM8350_OUT1R_MUTE
);
1619 wm8350_set_bits(wm8350
, WM8350_ROUT2_VOLUME
,
1620 WM8350_OUT2_VU
| WM8350_OUT2R_MUTE
);
1622 /* Make sure AIF tristating is disabled by default */
1623 wm8350_clear_bits(wm8350
, WM8350_AI_FORMATING
, WM8350_AIF_TRI
);
1625 /* Make sure we've got a sane companding setup too */
1626 wm8350_clear_bits(wm8350
, WM8350_ADC_DAC_COMP
,
1627 WM8350_DAC_COMP
| WM8350_LOOPBACK
);
1629 /* Make sure jack detect is disabled to start off with */
1630 wm8350_clear_bits(wm8350
, WM8350_JACK_DETECT
,
1631 WM8350_JDL_ENA
| WM8350_JDR_ENA
);
1633 wm8350_register_irq(wm8350
, WM8350_IRQ_CODEC_JCK_DET_L
,
1634 wm8350_hp_jack_handler
, 0, "Left jack detect",
1636 wm8350_register_irq(wm8350
, WM8350_IRQ_CODEC_JCK_DET_R
,
1637 wm8350_hp_jack_handler
, 0, "Right jack detect",
1639 wm8350_register_irq(wm8350
, WM8350_IRQ_CODEC_MICSCD
,
1640 wm8350_mic_handler
, 0, "Microphone short", priv
);
1641 wm8350_register_irq(wm8350
, WM8350_IRQ_CODEC_MICD
,
1642 wm8350_mic_handler
, 0, "Microphone detect", priv
);
1645 snd_soc_add_controls(codec
, wm8350_snd_controls
,
1646 ARRAY_SIZE(wm8350_snd_controls
));
1647 wm8350_add_widgets(codec
);
1649 wm8350_set_bias_level(codec
, SND_SOC_BIAS_STANDBY
);
1658 static int wm8350_codec_remove(struct snd_soc_codec
*codec
)
1660 struct wm8350_data
*priv
= snd_soc_codec_get_drvdata(codec
);
1661 struct wm8350
*wm8350
= dev_get_platdata(codec
->dev
);
1663 wm8350_clear_bits(wm8350
, WM8350_JACK_DETECT
,
1664 WM8350_JDL_ENA
| WM8350_JDR_ENA
);
1665 wm8350_clear_bits(wm8350
, WM8350_POWER_MGMT_4
, WM8350_TOCLK_ENA
);
1667 wm8350_free_irq(wm8350
, WM8350_IRQ_CODEC_MICD
, priv
);
1668 wm8350_free_irq(wm8350
, WM8350_IRQ_CODEC_MICSCD
, priv
);
1669 wm8350_free_irq(wm8350
, WM8350_IRQ_CODEC_JCK_DET_L
, priv
);
1670 wm8350_free_irq(wm8350
, WM8350_IRQ_CODEC_JCK_DET_R
, priv
);
1672 priv
->hpl
.jack
= NULL
;
1673 priv
->hpr
.jack
= NULL
;
1674 priv
->mic
.jack
= NULL
;
1676 cancel_delayed_work_sync(&priv
->hpl
.work
);
1677 cancel_delayed_work_sync(&priv
->hpr
.work
);
1679 /* if there was any work waiting then we run it now and
1680 * wait for its completion */
1681 flush_delayed_work_sync(&codec
->dapm
.delayed_work
);
1683 wm8350_set_bias_level(codec
, SND_SOC_BIAS_OFF
);
1685 wm8350_clear_bits(wm8350
, WM8350_POWER_MGMT_5
, WM8350_CODEC_ENA
);
1687 regulator_bulk_free(ARRAY_SIZE(priv
->supplies
), priv
->supplies
);
1692 static struct snd_soc_codec_driver soc_codec_dev_wm8350
= {
1693 .probe
= wm8350_codec_probe
,
1694 .remove
= wm8350_codec_remove
,
1695 .suspend
= wm8350_suspend
,
1696 .resume
= wm8350_resume
,
1697 .read
= wm8350_codec_read
,
1698 .write
= wm8350_codec_write
,
1699 .set_bias_level
= wm8350_set_bias_level
,
1702 static int __devinit
wm8350_probe(struct platform_device
*pdev
)
1704 return snd_soc_register_codec(&pdev
->dev
, &soc_codec_dev_wm8350
,
1708 static int __devexit
wm8350_remove(struct platform_device
*pdev
)
1710 snd_soc_unregister_codec(&pdev
->dev
);
1714 static struct platform_driver wm8350_codec_driver
= {
1716 .name
= "wm8350-codec",
1717 .owner
= THIS_MODULE
,
1719 .probe
= wm8350_probe
,
1720 .remove
= __devexit_p(wm8350_remove
),
1723 static __init
int wm8350_init(void)
1725 return platform_driver_register(&wm8350_codec_driver
);
1727 module_init(wm8350_init
);
1729 static __exit
void wm8350_exit(void)
1731 platform_driver_unregister(&wm8350_codec_driver
);
1733 module_exit(wm8350_exit
);
1735 MODULE_DESCRIPTION("ASoC WM8350 driver");
1736 MODULE_AUTHOR("Liam Girdwood");
1737 MODULE_LICENSE("GPL");
1738 MODULE_ALIAS("platform:wm8350-codec");