2 * soc-core.c -- ALSA SoC Audio Layer
4 * Copyright 2005 Wolfson Microelectronics PLC.
5 * Copyright 2005 Openedhand Ltd.
7 * Author: Liam Girdwood <lrg@slimlogic.co.uk>
8 * with code, comments and ideas from :-
9 * Richard Purdie <richard@openedhand.com>
11 * This program is free software; you can redistribute it and/or modify it
12 * under the terms of the GNU General Public License as published by the
13 * Free Software Foundation; either version 2 of the License, or (at your
14 * option) any later version.
17 * o Add hw rules to enforce rates, etc.
18 * o More testing with other codecs/machines.
19 * o Add more codecs and platforms to ensure good API coverage.
20 * o Support TDM on PCM and I2S
23 #include <linux/module.h>
24 #include <linux/moduleparam.h>
25 #include <linux/init.h>
26 #include <linux/delay.h>
28 #include <linux/bitops.h>
29 #include <linux/debugfs.h>
30 #include <linux/platform_device.h>
31 #include <sound/core.h>
32 #include <sound/pcm.h>
33 #include <sound/pcm_params.h>
34 #include <sound/soc.h>
35 #include <sound/soc-dapm.h>
36 #include <sound/initval.h>
38 static DEFINE_MUTEX(pcm_mutex);
39 static DEFINE_MUTEX(io_mutex);
40 static DECLARE_WAIT_QUEUE_HEAD(soc_pm_waitq);
42 #ifdef CONFIG_DEBUG_FS
43 static struct dentry *debugfs_root;
46 static DEFINE_MUTEX(client_mutex);
47 static LIST_HEAD(card_list);
48 static LIST_HEAD(dai_list);
49 static LIST_HEAD(platform_list);
50 static LIST_HEAD(codec_list);
52 static int snd_soc_register_card(struct snd_soc_card *card);
53 static int snd_soc_unregister_card(struct snd_soc_card *card);
56 * This is a timeout to do a DAPM powerdown after a stream is closed().
57 * It can be used to eliminate pops between different playback streams, e.g.
58 * between two audio tracks.
60 static int pmdown_time = 5000;
61 module_param(pmdown_time, int, 0);
62 MODULE_PARM_DESC(pmdown_time, "DAPM stream powerdown time (msecs)");
65 * This function forces any delayed work to be queued and run.
67 static int run_delayed_work(struct delayed_work *dwork)
71 /* cancel any work waiting to be queued. */
72 ret = cancel_delayed_work(dwork);
74 /* if there was any work waiting then we run it now and
75 * wait for it's completion */
77 schedule_delayed_work(dwork, 0);
78 flush_scheduled_work();
83 #ifdef CONFIG_SND_SOC_AC97_BUS
84 /* unregister ac97 codec */
85 static int soc_ac97_dev_unregister(struct snd_soc_codec *codec)
87 if (codec->ac97->dev.bus)
88 device_unregister(&codec->ac97->dev);
92 /* stop no dev release warning */
93 static void soc_ac97_device_release(struct device *dev){}
95 /* register ac97 codec to bus */
96 static int soc_ac97_dev_register(struct snd_soc_codec *codec)
100 codec->ac97->dev.bus = &ac97_bus_type;
101 codec->ac97->dev.parent = codec->card->dev;
102 codec->ac97->dev.release = soc_ac97_device_release;
104 dev_set_name(&codec->ac97->dev, "%d-%d:%s",
105 codec->card->number, 0, codec->name);
106 err = device_register(&codec->ac97->dev);
108 snd_printk(KERN_ERR "Can't register ac97 bus\n");
109 codec->ac97->dev.bus = NULL;
116 static int soc_pcm_apply_symmetry(struct snd_pcm_substream *substream)
118 struct snd_soc_pcm_runtime *rtd = substream->private_data;
119 struct snd_soc_device *socdev = rtd->socdev;
120 struct snd_soc_card *card = socdev->card;
121 struct snd_soc_dai_link *machine = rtd->dai;
122 struct snd_soc_dai *cpu_dai = machine->cpu_dai;
123 struct snd_soc_dai *codec_dai = machine->codec_dai;
126 if (codec_dai->symmetric_rates || cpu_dai->symmetric_rates ||
127 machine->symmetric_rates) {
128 dev_dbg(card->dev, "Symmetry forces %dHz rate\n",
131 ret = snd_pcm_hw_constraint_minmax(substream->runtime,
132 SNDRV_PCM_HW_PARAM_RATE,
137 "Unable to apply rate symmetry constraint: %d\n", ret);
146 * Called by ALSA when a PCM substream is opened, the runtime->hw record is
147 * then initialized and any private data can be allocated. This also calls
148 * startup for the cpu DAI, platform, machine and codec DAI.
150 static int soc_pcm_open(struct snd_pcm_substream *substream)
152 struct snd_soc_pcm_runtime *rtd = substream->private_data;
153 struct snd_soc_device *socdev = rtd->socdev;
154 struct snd_soc_card *card = socdev->card;
155 struct snd_pcm_runtime *runtime = substream->runtime;
156 struct snd_soc_dai_link *machine = rtd->dai;
157 struct snd_soc_platform *platform = card->platform;
158 struct snd_soc_dai *cpu_dai = machine->cpu_dai;
159 struct snd_soc_dai *codec_dai = machine->codec_dai;
162 mutex_lock(&pcm_mutex);
164 /* startup the audio subsystem */
165 if (cpu_dai->ops->startup) {
166 ret = cpu_dai->ops->startup(substream, cpu_dai);
168 printk(KERN_ERR "asoc: can't open interface %s\n",
174 if (platform->pcm_ops->open) {
175 ret = platform->pcm_ops->open(substream);
177 printk(KERN_ERR "asoc: can't open platform %s\n", platform->name);
182 if (codec_dai->ops->startup) {
183 ret = codec_dai->ops->startup(substream, codec_dai);
185 printk(KERN_ERR "asoc: can't open codec %s\n",
191 if (machine->ops && machine->ops->startup) {
192 ret = machine->ops->startup(substream);
194 printk(KERN_ERR "asoc: %s startup failed\n", machine->name);
199 /* Check that the codec and cpu DAI's are compatible */
200 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) {
201 runtime->hw.rate_min =
202 max(codec_dai->playback.rate_min,
203 cpu_dai->playback.rate_min);
204 runtime->hw.rate_max =
205 min(codec_dai->playback.rate_max,
206 cpu_dai->playback.rate_max);
207 runtime->hw.channels_min =
208 max(codec_dai->playback.channels_min,
209 cpu_dai->playback.channels_min);
210 runtime->hw.channels_max =
211 min(codec_dai->playback.channels_max,
212 cpu_dai->playback.channels_max);
213 runtime->hw.formats =
214 codec_dai->playback.formats & cpu_dai->playback.formats;
216 codec_dai->playback.rates & cpu_dai->playback.rates;
218 runtime->hw.rate_min =
219 max(codec_dai->capture.rate_min,
220 cpu_dai->capture.rate_min);
221 runtime->hw.rate_max =
222 min(codec_dai->capture.rate_max,
223 cpu_dai->capture.rate_max);
224 runtime->hw.channels_min =
225 max(codec_dai->capture.channels_min,
226 cpu_dai->capture.channels_min);
227 runtime->hw.channels_max =
228 min(codec_dai->capture.channels_max,
229 cpu_dai->capture.channels_max);
230 runtime->hw.formats =
231 codec_dai->capture.formats & cpu_dai->capture.formats;
233 codec_dai->capture.rates & cpu_dai->capture.rates;
236 snd_pcm_limit_hw_rates(runtime);
237 if (!runtime->hw.rates) {
238 printk(KERN_ERR "asoc: %s <-> %s No matching rates\n",
239 codec_dai->name, cpu_dai->name);
242 if (!runtime->hw.formats) {
243 printk(KERN_ERR "asoc: %s <-> %s No matching formats\n",
244 codec_dai->name, cpu_dai->name);
247 if (!runtime->hw.channels_min || !runtime->hw.channels_max) {
248 printk(KERN_ERR "asoc: %s <-> %s No matching channels\n",
249 codec_dai->name, cpu_dai->name);
253 /* Symmetry only applies if we've already got an active stream. */
254 if (cpu_dai->active || codec_dai->active) {
255 ret = soc_pcm_apply_symmetry(substream);
260 pr_debug("asoc: %s <-> %s info:\n", codec_dai->name, cpu_dai->name);
261 pr_debug("asoc: rate mask 0x%x\n", runtime->hw.rates);
262 pr_debug("asoc: min ch %d max ch %d\n", runtime->hw.channels_min,
263 runtime->hw.channels_max);
264 pr_debug("asoc: min rate %d max rate %d\n", runtime->hw.rate_min,
265 runtime->hw.rate_max);
267 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
268 cpu_dai->playback.active = codec_dai->playback.active = 1;
270 cpu_dai->capture.active = codec_dai->capture.active = 1;
271 cpu_dai->active = codec_dai->active = 1;
272 cpu_dai->runtime = runtime;
273 card->codec->active++;
274 mutex_unlock(&pcm_mutex);
278 if (machine->ops && machine->ops->shutdown)
279 machine->ops->shutdown(substream);
282 if (platform->pcm_ops->close)
283 platform->pcm_ops->close(substream);
286 if (cpu_dai->ops->shutdown)
287 cpu_dai->ops->shutdown(substream, cpu_dai);
289 mutex_unlock(&pcm_mutex);
294 * Power down the audio subsystem pmdown_time msecs after close is called.
295 * This is to ensure there are no pops or clicks in between any music tracks
296 * due to DAPM power cycling.
298 static void close_delayed_work(struct work_struct *work)
300 struct snd_soc_card *card = container_of(work, struct snd_soc_card,
302 struct snd_soc_codec *codec = card->codec;
303 struct snd_soc_dai *codec_dai;
306 mutex_lock(&pcm_mutex);
307 for (i = 0; i < codec->num_dai; i++) {
308 codec_dai = &codec->dai[i];
310 pr_debug("pop wq checking: %s status: %s waiting: %s\n",
311 codec_dai->playback.stream_name,
312 codec_dai->playback.active ? "active" : "inactive",
313 codec_dai->pop_wait ? "yes" : "no");
315 /* are we waiting on this codec DAI stream */
316 if (codec_dai->pop_wait == 1) {
317 codec_dai->pop_wait = 0;
318 snd_soc_dapm_stream_event(codec,
319 codec_dai->playback.stream_name,
320 SND_SOC_DAPM_STREAM_STOP);
323 mutex_unlock(&pcm_mutex);
327 * Called by ALSA when a PCM substream is closed. Private data can be
328 * freed here. The cpu DAI, codec DAI, machine and platform are also
331 static int soc_codec_close(struct snd_pcm_substream *substream)
333 struct snd_soc_pcm_runtime *rtd = substream->private_data;
334 struct snd_soc_device *socdev = rtd->socdev;
335 struct snd_soc_card *card = socdev->card;
336 struct snd_soc_dai_link *machine = rtd->dai;
337 struct snd_soc_platform *platform = card->platform;
338 struct snd_soc_dai *cpu_dai = machine->cpu_dai;
339 struct snd_soc_dai *codec_dai = machine->codec_dai;
340 struct snd_soc_codec *codec = card->codec;
342 mutex_lock(&pcm_mutex);
344 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
345 cpu_dai->playback.active = codec_dai->playback.active = 0;
347 cpu_dai->capture.active = codec_dai->capture.active = 0;
349 if (codec_dai->playback.active == 0 &&
350 codec_dai->capture.active == 0) {
351 cpu_dai->active = codec_dai->active = 0;
355 /* Muting the DAC suppresses artifacts caused during digital
356 * shutdown, for example from stopping clocks.
358 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
359 snd_soc_dai_digital_mute(codec_dai, 1);
361 if (cpu_dai->ops->shutdown)
362 cpu_dai->ops->shutdown(substream, cpu_dai);
364 if (codec_dai->ops->shutdown)
365 codec_dai->ops->shutdown(substream, codec_dai);
367 if (machine->ops && machine->ops->shutdown)
368 machine->ops->shutdown(substream);
370 if (platform->pcm_ops->close)
371 platform->pcm_ops->close(substream);
372 cpu_dai->runtime = NULL;
374 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) {
375 /* start delayed pop wq here for playback streams */
376 codec_dai->pop_wait = 1;
377 schedule_delayed_work(&card->delayed_work,
378 msecs_to_jiffies(pmdown_time));
380 /* capture streams can be powered down now */
381 snd_soc_dapm_stream_event(codec,
382 codec_dai->capture.stream_name,
383 SND_SOC_DAPM_STREAM_STOP);
386 mutex_unlock(&pcm_mutex);
391 * Called by ALSA when the PCM substream is prepared, can set format, sample
392 * rate, etc. This function is non atomic and can be called multiple times,
393 * it can refer to the runtime info.
395 static int soc_pcm_prepare(struct snd_pcm_substream *substream)
397 struct snd_soc_pcm_runtime *rtd = substream->private_data;
398 struct snd_soc_device *socdev = rtd->socdev;
399 struct snd_soc_card *card = socdev->card;
400 struct snd_soc_dai_link *machine = rtd->dai;
401 struct snd_soc_platform *platform = card->platform;
402 struct snd_soc_dai *cpu_dai = machine->cpu_dai;
403 struct snd_soc_dai *codec_dai = machine->codec_dai;
404 struct snd_soc_codec *codec = card->codec;
407 mutex_lock(&pcm_mutex);
409 if (machine->ops && machine->ops->prepare) {
410 ret = machine->ops->prepare(substream);
412 printk(KERN_ERR "asoc: machine prepare error\n");
417 if (platform->pcm_ops->prepare) {
418 ret = platform->pcm_ops->prepare(substream);
420 printk(KERN_ERR "asoc: platform prepare error\n");
425 if (codec_dai->ops->prepare) {
426 ret = codec_dai->ops->prepare(substream, codec_dai);
428 printk(KERN_ERR "asoc: codec DAI prepare error\n");
433 if (cpu_dai->ops->prepare) {
434 ret = cpu_dai->ops->prepare(substream, cpu_dai);
436 printk(KERN_ERR "asoc: cpu DAI prepare error\n");
441 /* cancel any delayed stream shutdown that is pending */
442 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK &&
443 codec_dai->pop_wait) {
444 codec_dai->pop_wait = 0;
445 cancel_delayed_work(&card->delayed_work);
448 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
449 snd_soc_dapm_stream_event(codec,
450 codec_dai->playback.stream_name,
451 SND_SOC_DAPM_STREAM_START);
453 snd_soc_dapm_stream_event(codec,
454 codec_dai->capture.stream_name,
455 SND_SOC_DAPM_STREAM_START);
457 snd_soc_dai_digital_mute(codec_dai, 0);
460 mutex_unlock(&pcm_mutex);
465 * Called by ALSA when the hardware params are set by application. This
466 * function can also be called multiple times and can allocate buffers
467 * (using snd_pcm_lib_* ). It's non-atomic.
469 static int soc_pcm_hw_params(struct snd_pcm_substream *substream,
470 struct snd_pcm_hw_params *params)
472 struct snd_soc_pcm_runtime *rtd = substream->private_data;
473 struct snd_soc_device *socdev = rtd->socdev;
474 struct snd_soc_dai_link *machine = rtd->dai;
475 struct snd_soc_card *card = socdev->card;
476 struct snd_soc_platform *platform = card->platform;
477 struct snd_soc_dai *cpu_dai = machine->cpu_dai;
478 struct snd_soc_dai *codec_dai = machine->codec_dai;
481 mutex_lock(&pcm_mutex);
483 if (machine->ops && machine->ops->hw_params) {
484 ret = machine->ops->hw_params(substream, params);
486 printk(KERN_ERR "asoc: machine hw_params failed\n");
491 if (codec_dai->ops->hw_params) {
492 ret = codec_dai->ops->hw_params(substream, params, codec_dai);
494 printk(KERN_ERR "asoc: can't set codec %s hw params\n",
500 if (cpu_dai->ops->hw_params) {
501 ret = cpu_dai->ops->hw_params(substream, params, cpu_dai);
503 printk(KERN_ERR "asoc: interface %s hw params failed\n",
509 if (platform->pcm_ops->hw_params) {
510 ret = platform->pcm_ops->hw_params(substream, params);
512 printk(KERN_ERR "asoc: platform %s hw params failed\n",
518 machine->rate = params_rate(params);
521 mutex_unlock(&pcm_mutex);
525 if (cpu_dai->ops->hw_free)
526 cpu_dai->ops->hw_free(substream, cpu_dai);
529 if (codec_dai->ops->hw_free)
530 codec_dai->ops->hw_free(substream, codec_dai);
533 if (machine->ops && machine->ops->hw_free)
534 machine->ops->hw_free(substream);
536 mutex_unlock(&pcm_mutex);
541 * Free's resources allocated by hw_params, can be called multiple times
543 static int soc_pcm_hw_free(struct snd_pcm_substream *substream)
545 struct snd_soc_pcm_runtime *rtd = substream->private_data;
546 struct snd_soc_device *socdev = rtd->socdev;
547 struct snd_soc_dai_link *machine = rtd->dai;
548 struct snd_soc_card *card = socdev->card;
549 struct snd_soc_platform *platform = card->platform;
550 struct snd_soc_dai *cpu_dai = machine->cpu_dai;
551 struct snd_soc_dai *codec_dai = machine->codec_dai;
552 struct snd_soc_codec *codec = card->codec;
554 mutex_lock(&pcm_mutex);
556 /* apply codec digital mute */
558 snd_soc_dai_digital_mute(codec_dai, 1);
560 /* free any machine hw params */
561 if (machine->ops && machine->ops->hw_free)
562 machine->ops->hw_free(substream);
564 /* free any DMA resources */
565 if (platform->pcm_ops->hw_free)
566 platform->pcm_ops->hw_free(substream);
568 /* now free hw params for the DAI's */
569 if (codec_dai->ops->hw_free)
570 codec_dai->ops->hw_free(substream, codec_dai);
572 if (cpu_dai->ops->hw_free)
573 cpu_dai->ops->hw_free(substream, cpu_dai);
575 mutex_unlock(&pcm_mutex);
579 static int soc_pcm_trigger(struct snd_pcm_substream *substream, int cmd)
581 struct snd_soc_pcm_runtime *rtd = substream->private_data;
582 struct snd_soc_device *socdev = rtd->socdev;
583 struct snd_soc_card *card= socdev->card;
584 struct snd_soc_dai_link *machine = rtd->dai;
585 struct snd_soc_platform *platform = card->platform;
586 struct snd_soc_dai *cpu_dai = machine->cpu_dai;
587 struct snd_soc_dai *codec_dai = machine->codec_dai;
590 if (codec_dai->ops->trigger) {
591 ret = codec_dai->ops->trigger(substream, cmd, codec_dai);
596 if (platform->pcm_ops->trigger) {
597 ret = platform->pcm_ops->trigger(substream, cmd);
602 if (cpu_dai->ops->trigger) {
603 ret = cpu_dai->ops->trigger(substream, cmd, cpu_dai);
610 /* ASoC PCM operations */
611 static struct snd_pcm_ops soc_pcm_ops = {
612 .open = soc_pcm_open,
613 .close = soc_codec_close,
614 .hw_params = soc_pcm_hw_params,
615 .hw_free = soc_pcm_hw_free,
616 .prepare = soc_pcm_prepare,
617 .trigger = soc_pcm_trigger,
621 /* powers down audio subsystem for suspend */
622 static int soc_suspend(struct device *dev)
624 struct platform_device *pdev = to_platform_device(dev);
625 struct snd_soc_device *socdev = platform_get_drvdata(pdev);
626 struct snd_soc_card *card = socdev->card;
627 struct snd_soc_platform *platform = card->platform;
628 struct snd_soc_codec_device *codec_dev = socdev->codec_dev;
629 struct snd_soc_codec *codec = card->codec;
632 /* If the initialization of this soc device failed, there is no codec
633 * associated with it. Just bail out in this case.
638 /* Due to the resume being scheduled into a workqueue we could
639 * suspend before that's finished - wait for it to complete.
641 snd_power_lock(codec->card);
642 snd_power_wait(codec->card, SNDRV_CTL_POWER_D0);
643 snd_power_unlock(codec->card);
645 /* we're going to block userspace touching us until resume completes */
646 snd_power_change_state(codec->card, SNDRV_CTL_POWER_D3hot);
648 /* mute any active DAC's */
649 for (i = 0; i < card->num_links; i++) {
650 struct snd_soc_dai *dai = card->dai_link[i].codec_dai;
651 if (dai->ops->digital_mute && dai->playback.active)
652 dai->ops->digital_mute(dai, 1);
655 /* suspend all pcms */
656 for (i = 0; i < card->num_links; i++)
657 snd_pcm_suspend_all(card->dai_link[i].pcm);
659 if (card->suspend_pre)
660 card->suspend_pre(pdev, PMSG_SUSPEND);
662 for (i = 0; i < card->num_links; i++) {
663 struct snd_soc_dai *cpu_dai = card->dai_link[i].cpu_dai;
664 if (cpu_dai->suspend && !cpu_dai->ac97_control)
665 cpu_dai->suspend(cpu_dai);
666 if (platform->suspend)
667 platform->suspend(cpu_dai);
670 /* close any waiting streams and save state */
671 run_delayed_work(&card->delayed_work);
672 codec->suspend_bias_level = codec->bias_level;
674 for (i = 0; i < codec->num_dai; i++) {
675 char *stream = codec->dai[i].playback.stream_name;
677 snd_soc_dapm_stream_event(codec, stream,
678 SND_SOC_DAPM_STREAM_SUSPEND);
679 stream = codec->dai[i].capture.stream_name;
681 snd_soc_dapm_stream_event(codec, stream,
682 SND_SOC_DAPM_STREAM_SUSPEND);
685 if (codec_dev->suspend)
686 codec_dev->suspend(pdev, PMSG_SUSPEND);
688 for (i = 0; i < card->num_links; i++) {
689 struct snd_soc_dai *cpu_dai = card->dai_link[i].cpu_dai;
690 if (cpu_dai->suspend && cpu_dai->ac97_control)
691 cpu_dai->suspend(cpu_dai);
694 if (card->suspend_post)
695 card->suspend_post(pdev, PMSG_SUSPEND);
700 /* deferred resume work, so resume can complete before we finished
701 * setting our codec back up, which can be very slow on I2C
703 static void soc_resume_deferred(struct work_struct *work)
705 struct snd_soc_card *card = container_of(work,
707 deferred_resume_work);
708 struct snd_soc_device *socdev = card->socdev;
709 struct snd_soc_platform *platform = card->platform;
710 struct snd_soc_codec_device *codec_dev = socdev->codec_dev;
711 struct snd_soc_codec *codec = card->codec;
712 struct platform_device *pdev = to_platform_device(socdev->dev);
715 /* our power state is still SNDRV_CTL_POWER_D3hot from suspend time,
716 * so userspace apps are blocked from touching us
719 dev_dbg(socdev->dev, "starting resume work\n");
721 if (card->resume_pre)
722 card->resume_pre(pdev);
724 for (i = 0; i < card->num_links; i++) {
725 struct snd_soc_dai *cpu_dai = card->dai_link[i].cpu_dai;
726 if (cpu_dai->resume && cpu_dai->ac97_control)
727 cpu_dai->resume(cpu_dai);
730 if (codec_dev->resume)
731 codec_dev->resume(pdev);
733 for (i = 0; i < codec->num_dai; i++) {
734 char *stream = codec->dai[i].playback.stream_name;
736 snd_soc_dapm_stream_event(codec, stream,
737 SND_SOC_DAPM_STREAM_RESUME);
738 stream = codec->dai[i].capture.stream_name;
740 snd_soc_dapm_stream_event(codec, stream,
741 SND_SOC_DAPM_STREAM_RESUME);
744 /* unmute any active DACs */
745 for (i = 0; i < card->num_links; i++) {
746 struct snd_soc_dai *dai = card->dai_link[i].codec_dai;
747 if (dai->ops->digital_mute && dai->playback.active)
748 dai->ops->digital_mute(dai, 0);
751 for (i = 0; i < card->num_links; i++) {
752 struct snd_soc_dai *cpu_dai = card->dai_link[i].cpu_dai;
753 if (cpu_dai->resume && !cpu_dai->ac97_control)
754 cpu_dai->resume(cpu_dai);
755 if (platform->resume)
756 platform->resume(cpu_dai);
759 if (card->resume_post)
760 card->resume_post(pdev);
762 dev_dbg(socdev->dev, "resume work completed\n");
764 /* userspace can access us now we are back as we were before */
765 snd_power_change_state(codec->card, SNDRV_CTL_POWER_D0);
768 /* powers up audio subsystem after a suspend */
769 static int soc_resume(struct device *dev)
771 struct platform_device *pdev = to_platform_device(dev);
772 struct snd_soc_device *socdev = platform_get_drvdata(pdev);
773 struct snd_soc_card *card = socdev->card;
774 struct snd_soc_dai *cpu_dai = card->dai_link[0].cpu_dai;
776 /* AC97 devices might have other drivers hanging off them so
777 * need to resume immediately. Other drivers don't have that
778 * problem and may take a substantial amount of time to resume
779 * due to I/O costs and anti-pop so handle them out of line.
781 if (cpu_dai->ac97_control) {
782 dev_dbg(socdev->dev, "Resuming AC97 immediately\n");
783 soc_resume_deferred(&card->deferred_resume_work);
785 dev_dbg(socdev->dev, "Scheduling resume work\n");
786 if (!schedule_work(&card->deferred_resume_work))
787 dev_err(socdev->dev, "resume work item may be lost\n");
794 * snd_soc_suspend_device: Notify core of device suspend
796 * @dev: Device being suspended.
798 * In order to ensure that the entire audio subsystem is suspended in a
799 * coordinated fashion ASoC devices should suspend themselves when
800 * called by ASoC. When the standard kernel suspend process asks the
801 * device to suspend it should call this function to initiate a suspend
802 * of the entire ASoC card.
804 * \note Currently this function is stubbed out.
806 int snd_soc_suspend_device(struct device *dev)
810 EXPORT_SYMBOL_GPL(snd_soc_suspend_device);
813 * snd_soc_resume_device: Notify core of device resume
815 * @dev: Device being resumed.
817 * In order to ensure that the entire audio subsystem is resumed in a
818 * coordinated fashion ASoC devices should resume themselves when called
819 * by ASoC. When the standard kernel resume process asks the device
820 * to resume it should call this function. Once all the components of
821 * the card have notified that they are ready to be resumed the card
824 * \note Currently this function is stubbed out.
826 int snd_soc_resume_device(struct device *dev)
830 EXPORT_SYMBOL_GPL(snd_soc_resume_device);
832 #define soc_suspend NULL
833 #define soc_resume NULL
836 static void snd_soc_instantiate_card(struct snd_soc_card *card)
838 struct platform_device *pdev = container_of(card->dev,
839 struct platform_device,
841 struct snd_soc_codec_device *codec_dev = card->socdev->codec_dev;
842 struct snd_soc_platform *platform;
843 struct snd_soc_dai *dai;
844 int i, found, ret, ac97;
846 if (card->instantiated)
850 list_for_each_entry(platform, &platform_list, list)
851 if (card->platform == platform) {
856 dev_dbg(card->dev, "Platform %s not registered\n",
857 card->platform->name);
862 for (i = 0; i < card->num_links; i++) {
864 list_for_each_entry(dai, &dai_list, list)
865 if (card->dai_link[i].cpu_dai == dai) {
870 dev_dbg(card->dev, "DAI %s not registered\n",
871 card->dai_link[i].cpu_dai->name);
875 if (card->dai_link[i].cpu_dai->ac97_control)
879 /* If we have AC97 in the system then don't wait for the
880 * codec. This will need revisiting if we have to handle
881 * systems with mixed AC97 and non-AC97 parts. Only check for
882 * DAIs currently; we can't do this per link since some AC97
883 * codecs have non-AC97 DAIs.
886 for (i = 0; i < card->num_links; i++) {
888 list_for_each_entry(dai, &dai_list, list)
889 if (card->dai_link[i].codec_dai == dai) {
894 dev_dbg(card->dev, "DAI %s not registered\n",
895 card->dai_link[i].codec_dai->name);
900 /* Note that we do not current check for codec components */
902 dev_dbg(card->dev, "All components present, instantiating\n");
904 /* Found everything, bring it up */
906 ret = card->probe(pdev);
911 for (i = 0; i < card->num_links; i++) {
912 struct snd_soc_dai *cpu_dai = card->dai_link[i].cpu_dai;
913 if (cpu_dai->probe) {
914 ret = cpu_dai->probe(pdev, cpu_dai);
920 if (codec_dev->probe) {
921 ret = codec_dev->probe(pdev);
926 if (platform->probe) {
927 ret = platform->probe(pdev);
932 /* DAPM stream work */
933 INIT_DELAYED_WORK(&card->delayed_work, close_delayed_work);
935 /* deferred resume work */
936 INIT_WORK(&card->deferred_resume_work, soc_resume_deferred);
939 card->instantiated = 1;
944 if (codec_dev->remove)
945 codec_dev->remove(pdev);
948 for (i--; i >= 0; i--) {
949 struct snd_soc_dai *cpu_dai = card->dai_link[i].cpu_dai;
951 cpu_dai->remove(pdev, cpu_dai);
959 * Attempt to initialise any uninitalised cards. Must be called with
962 static void snd_soc_instantiate_cards(void)
964 struct snd_soc_card *card;
965 list_for_each_entry(card, &card_list, list)
966 snd_soc_instantiate_card(card);
969 /* probes a new socdev */
970 static int soc_probe(struct platform_device *pdev)
973 struct snd_soc_device *socdev = platform_get_drvdata(pdev);
974 struct snd_soc_card *card = socdev->card;
976 /* Bodge while we push things out of socdev */
977 card->socdev = socdev;
979 /* Bodge while we unpick instantiation */
980 card->dev = &pdev->dev;
981 ret = snd_soc_register_card(card);
983 dev_err(&pdev->dev, "Failed to register card\n");
990 /* removes a socdev */
991 static int soc_remove(struct platform_device *pdev)
994 struct snd_soc_device *socdev = platform_get_drvdata(pdev);
995 struct snd_soc_card *card = socdev->card;
996 struct snd_soc_platform *platform = card->platform;
997 struct snd_soc_codec_device *codec_dev = socdev->codec_dev;
999 if (!card->instantiated)
1002 run_delayed_work(&card->delayed_work);
1004 if (platform->remove)
1005 platform->remove(pdev);
1007 if (codec_dev->remove)
1008 codec_dev->remove(pdev);
1010 for (i = 0; i < card->num_links; i++) {
1011 struct snd_soc_dai *cpu_dai = card->dai_link[i].cpu_dai;
1012 if (cpu_dai->remove)
1013 cpu_dai->remove(pdev, cpu_dai);
1019 snd_soc_unregister_card(card);
1024 static int soc_poweroff(struct device *dev)
1026 struct platform_device *pdev = to_platform_device(dev);
1027 struct snd_soc_device *socdev = platform_get_drvdata(pdev);
1028 struct snd_soc_card *card = socdev->card;
1030 if (!card->instantiated)
1033 /* Flush out pmdown_time work - we actually do want to run it
1034 * now, we're shutting down so no imminent restart. */
1035 run_delayed_work(&card->delayed_work);
1037 snd_soc_dapm_shutdown(socdev);
1042 static struct dev_pm_ops soc_pm_ops = {
1043 .suspend = soc_suspend,
1044 .resume = soc_resume,
1045 .poweroff = soc_poweroff,
1048 /* ASoC platform driver */
1049 static struct platform_driver soc_driver = {
1051 .name = "soc-audio",
1052 .owner = THIS_MODULE,
1056 .remove = soc_remove,
1059 /* create a new pcm */
1060 static int soc_new_pcm(struct snd_soc_device *socdev,
1061 struct snd_soc_dai_link *dai_link, int num)
1063 struct snd_soc_card *card = socdev->card;
1064 struct snd_soc_codec *codec = card->codec;
1065 struct snd_soc_platform *platform = card->platform;
1066 struct snd_soc_dai *codec_dai = dai_link->codec_dai;
1067 struct snd_soc_dai *cpu_dai = dai_link->cpu_dai;
1068 struct snd_soc_pcm_runtime *rtd;
1069 struct snd_pcm *pcm;
1071 int ret = 0, playback = 0, capture = 0;
1073 rtd = kzalloc(sizeof(struct snd_soc_pcm_runtime), GFP_KERNEL);
1077 rtd->dai = dai_link;
1078 rtd->socdev = socdev;
1079 codec_dai->codec = card->codec;
1081 /* check client and interface hw capabilities */
1082 sprintf(new_name, "%s %s-%d", dai_link->stream_name, codec_dai->name,
1085 if (codec_dai->playback.channels_min)
1087 if (codec_dai->capture.channels_min)
1090 ret = snd_pcm_new(codec->card, new_name, codec->pcm_devs++, playback,
1093 printk(KERN_ERR "asoc: can't create pcm for codec %s\n",
1099 dai_link->pcm = pcm;
1100 pcm->private_data = rtd;
1101 soc_pcm_ops.mmap = platform->pcm_ops->mmap;
1102 soc_pcm_ops.pointer = platform->pcm_ops->pointer;
1103 soc_pcm_ops.ioctl = platform->pcm_ops->ioctl;
1104 soc_pcm_ops.copy = platform->pcm_ops->copy;
1105 soc_pcm_ops.silence = platform->pcm_ops->silence;
1106 soc_pcm_ops.ack = platform->pcm_ops->ack;
1107 soc_pcm_ops.page = platform->pcm_ops->page;
1110 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, &soc_pcm_ops);
1113 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &soc_pcm_ops);
1115 ret = platform->pcm_new(codec->card, codec_dai, pcm);
1117 printk(KERN_ERR "asoc: platform pcm constructor failed\n");
1122 pcm->private_free = platform->pcm_free;
1123 printk(KERN_INFO "asoc: %s <-> %s mapping ok\n", codec_dai->name,
1129 * snd_soc_codec_volatile_register: Report if a register is volatile.
1131 * @codec: CODEC to query.
1132 * @reg: Register to query.
1134 * Boolean function indiciating if a CODEC register is volatile.
1136 int snd_soc_codec_volatile_register(struct snd_soc_codec *codec, int reg)
1138 if (codec->volatile_register)
1139 return codec->volatile_register(reg);
1143 EXPORT_SYMBOL_GPL(snd_soc_codec_volatile_register);
1145 /* codec register dump */
1146 static ssize_t soc_codec_reg_show(struct snd_soc_codec *codec, char *buf)
1148 int i, step = 1, count = 0;
1150 if (!codec->reg_cache_size)
1153 if (codec->reg_cache_step)
1154 step = codec->reg_cache_step;
1156 count += sprintf(buf, "%s registers\n", codec->name);
1157 for (i = 0; i < codec->reg_cache_size; i += step) {
1158 count += sprintf(buf + count, "%2x: ", i);
1159 if (count >= PAGE_SIZE - 1)
1162 if (codec->display_register)
1163 count += codec->display_register(codec, buf + count,
1164 PAGE_SIZE - count, i);
1166 count += snprintf(buf + count, PAGE_SIZE - count,
1167 "%4x", codec->read(codec, i));
1169 if (count >= PAGE_SIZE - 1)
1172 count += snprintf(buf + count, PAGE_SIZE - count, "\n");
1173 if (count >= PAGE_SIZE - 1)
1177 /* Truncate count; min() would cause a warning */
1178 if (count >= PAGE_SIZE)
1179 count = PAGE_SIZE - 1;
1183 static ssize_t codec_reg_show(struct device *dev,
1184 struct device_attribute *attr, char *buf)
1186 struct snd_soc_device *devdata = dev_get_drvdata(dev);
1187 return soc_codec_reg_show(devdata->card->codec, buf);
1190 static DEVICE_ATTR(codec_reg, 0444, codec_reg_show, NULL);
1192 #ifdef CONFIG_DEBUG_FS
1193 static int codec_reg_open_file(struct inode *inode, struct file *file)
1195 file->private_data = inode->i_private;
1199 static ssize_t codec_reg_read_file(struct file *file, char __user *user_buf,
1200 size_t count, loff_t *ppos)
1203 struct snd_soc_codec *codec = file->private_data;
1204 char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
1207 ret = soc_codec_reg_show(codec, buf);
1209 ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
1214 static ssize_t codec_reg_write_file(struct file *file,
1215 const char __user *user_buf, size_t count, loff_t *ppos)
1220 unsigned long reg, value;
1222 struct snd_soc_codec *codec = file->private_data;
1224 buf_size = min(count, (sizeof(buf)-1));
1225 if (copy_from_user(buf, user_buf, buf_size))
1229 if (codec->reg_cache_step)
1230 step = codec->reg_cache_step;
1232 while (*start == ' ')
1234 reg = simple_strtoul(start, &start, 16);
1235 if ((reg >= codec->reg_cache_size) || (reg % step))
1237 while (*start == ' ')
1239 if (strict_strtoul(start, 16, &value))
1241 codec->write(codec, reg, value);
1245 static const struct file_operations codec_reg_fops = {
1246 .open = codec_reg_open_file,
1247 .read = codec_reg_read_file,
1248 .write = codec_reg_write_file,
1251 static void soc_init_codec_debugfs(struct snd_soc_codec *codec)
1253 codec->debugfs_reg = debugfs_create_file("codec_reg", 0644,
1254 debugfs_root, codec,
1256 if (!codec->debugfs_reg)
1258 "ASoC: Failed to create codec register debugfs file\n");
1260 codec->debugfs_pop_time = debugfs_create_u32("dapm_pop_time", 0744,
1263 if (!codec->debugfs_pop_time)
1265 "Failed to create pop time debugfs file\n");
1268 static void soc_cleanup_codec_debugfs(struct snd_soc_codec *codec)
1270 debugfs_remove(codec->debugfs_pop_time);
1271 debugfs_remove(codec->debugfs_reg);
1276 static inline void soc_init_codec_debugfs(struct snd_soc_codec *codec)
1280 static inline void soc_cleanup_codec_debugfs(struct snd_soc_codec *codec)
1286 * snd_soc_new_ac97_codec - initailise AC97 device
1287 * @codec: audio codec
1288 * @ops: AC97 bus operations
1289 * @num: AC97 codec number
1291 * Initialises AC97 codec resources for use by ad-hoc devices only.
1293 int snd_soc_new_ac97_codec(struct snd_soc_codec *codec,
1294 struct snd_ac97_bus_ops *ops, int num)
1296 mutex_lock(&codec->mutex);
1298 codec->ac97 = kzalloc(sizeof(struct snd_ac97), GFP_KERNEL);
1299 if (codec->ac97 == NULL) {
1300 mutex_unlock(&codec->mutex);
1304 codec->ac97->bus = kzalloc(sizeof(struct snd_ac97_bus), GFP_KERNEL);
1305 if (codec->ac97->bus == NULL) {
1308 mutex_unlock(&codec->mutex);
1312 codec->ac97->bus->ops = ops;
1313 codec->ac97->num = num;
1314 mutex_unlock(&codec->mutex);
1317 EXPORT_SYMBOL_GPL(snd_soc_new_ac97_codec);
1320 * snd_soc_free_ac97_codec - free AC97 codec device
1321 * @codec: audio codec
1323 * Frees AC97 codec device resources.
1325 void snd_soc_free_ac97_codec(struct snd_soc_codec *codec)
1327 mutex_lock(&codec->mutex);
1328 kfree(codec->ac97->bus);
1331 mutex_unlock(&codec->mutex);
1333 EXPORT_SYMBOL_GPL(snd_soc_free_ac97_codec);
1336 * snd_soc_update_bits - update codec register bits
1337 * @codec: audio codec
1338 * @reg: codec register
1339 * @mask: register mask
1342 * Writes new register value.
1344 * Returns 1 for change else 0.
1346 int snd_soc_update_bits(struct snd_soc_codec *codec, unsigned short reg,
1347 unsigned int mask, unsigned int value)
1350 unsigned int old, new;
1352 mutex_lock(&io_mutex);
1353 old = snd_soc_read(codec, reg);
1354 new = (old & ~mask) | value;
1355 change = old != new;
1357 snd_soc_write(codec, reg, new);
1359 mutex_unlock(&io_mutex);
1362 EXPORT_SYMBOL_GPL(snd_soc_update_bits);
1365 * snd_soc_test_bits - test register for change
1366 * @codec: audio codec
1367 * @reg: codec register
1368 * @mask: register mask
1371 * Tests a register with a new value and checks if the new value is
1372 * different from the old value.
1374 * Returns 1 for change else 0.
1376 int snd_soc_test_bits(struct snd_soc_codec *codec, unsigned short reg,
1377 unsigned int mask, unsigned int value)
1380 unsigned int old, new;
1382 mutex_lock(&io_mutex);
1383 old = snd_soc_read(codec, reg);
1384 new = (old & ~mask) | value;
1385 change = old != new;
1386 mutex_unlock(&io_mutex);
1390 EXPORT_SYMBOL_GPL(snd_soc_test_bits);
1393 * snd_soc_new_pcms - create new sound card and pcms
1394 * @socdev: the SoC audio device
1395 * @idx: ALSA card index
1396 * @xid: card identification
1398 * Create a new sound card based upon the codec and interface pcms.
1400 * Returns 0 for success, else error.
1402 int snd_soc_new_pcms(struct snd_soc_device *socdev, int idx, const char *xid)
1404 struct snd_soc_card *card = socdev->card;
1405 struct snd_soc_codec *codec = card->codec;
1408 mutex_lock(&codec->mutex);
1410 /* register a sound card */
1411 ret = snd_card_create(idx, xid, codec->owner, 0, &codec->card);
1413 printk(KERN_ERR "asoc: can't create sound card for codec %s\n",
1415 mutex_unlock(&codec->mutex);
1419 codec->socdev = socdev;
1420 codec->card->dev = socdev->dev;
1421 codec->card->private_data = codec;
1422 strncpy(codec->card->driver, codec->name, sizeof(codec->card->driver));
1424 /* create the pcms */
1425 for (i = 0; i < card->num_links; i++) {
1426 ret = soc_new_pcm(socdev, &card->dai_link[i], i);
1428 printk(KERN_ERR "asoc: can't create pcm %s\n",
1429 card->dai_link[i].stream_name);
1430 mutex_unlock(&codec->mutex);
1435 mutex_unlock(&codec->mutex);
1438 EXPORT_SYMBOL_GPL(snd_soc_new_pcms);
1441 * snd_soc_init_card - register sound card
1442 * @socdev: the SoC audio device
1444 * Register a SoC sound card. Also registers an AC97 device if the
1445 * codec is AC97 for ad hoc devices.
1447 * Returns 0 for success, else error.
1449 int snd_soc_init_card(struct snd_soc_device *socdev)
1451 struct snd_soc_card *card = socdev->card;
1452 struct snd_soc_codec *codec = card->codec;
1453 int ret = 0, i, ac97 = 0, err = 0;
1455 for (i = 0; i < card->num_links; i++) {
1456 if (card->dai_link[i].init) {
1457 err = card->dai_link[i].init(codec);
1459 printk(KERN_ERR "asoc: failed to init %s\n",
1460 card->dai_link[i].stream_name);
1464 if (card->dai_link[i].codec_dai->ac97_control)
1467 snprintf(codec->card->shortname, sizeof(codec->card->shortname),
1469 snprintf(codec->card->longname, sizeof(codec->card->longname),
1470 "%s (%s)", card->name, codec->name);
1472 /* Make sure all DAPM widgets are instantiated */
1473 snd_soc_dapm_new_widgets(codec);
1475 ret = snd_card_register(codec->card);
1477 printk(KERN_ERR "asoc: failed to register soundcard for %s\n",
1482 mutex_lock(&codec->mutex);
1483 #ifdef CONFIG_SND_SOC_AC97_BUS
1484 /* Only instantiate AC97 if not already done by the adaptor
1485 * for the generic AC97 subsystem.
1487 if (ac97 && strcmp(codec->name, "AC97") != 0) {
1488 ret = soc_ac97_dev_register(codec);
1490 printk(KERN_ERR "asoc: AC97 device register failed\n");
1491 snd_card_free(codec->card);
1492 mutex_unlock(&codec->mutex);
1498 err = snd_soc_dapm_sys_add(socdev->dev);
1500 printk(KERN_WARNING "asoc: failed to add dapm sysfs entries\n");
1502 err = device_create_file(socdev->dev, &dev_attr_codec_reg);
1504 printk(KERN_WARNING "asoc: failed to add codec sysfs files\n");
1506 soc_init_codec_debugfs(codec);
1507 mutex_unlock(&codec->mutex);
1512 EXPORT_SYMBOL_GPL(snd_soc_init_card);
1515 * snd_soc_free_pcms - free sound card and pcms
1516 * @socdev: the SoC audio device
1518 * Frees sound card and pcms associated with the socdev.
1519 * Also unregister the codec if it is an AC97 device.
1521 void snd_soc_free_pcms(struct snd_soc_device *socdev)
1523 struct snd_soc_codec *codec = socdev->card->codec;
1524 #ifdef CONFIG_SND_SOC_AC97_BUS
1525 struct snd_soc_dai *codec_dai;
1529 mutex_lock(&codec->mutex);
1530 soc_cleanup_codec_debugfs(codec);
1531 #ifdef CONFIG_SND_SOC_AC97_BUS
1532 for (i = 0; i < codec->num_dai; i++) {
1533 codec_dai = &codec->dai[i];
1534 if (codec_dai->ac97_control && codec->ac97 &&
1535 strcmp(codec->name, "AC97") != 0) {
1536 soc_ac97_dev_unregister(codec);
1544 snd_card_free(codec->card);
1545 device_remove_file(socdev->dev, &dev_attr_codec_reg);
1546 mutex_unlock(&codec->mutex);
1548 EXPORT_SYMBOL_GPL(snd_soc_free_pcms);
1551 * snd_soc_set_runtime_hwparams - set the runtime hardware parameters
1552 * @substream: the pcm substream
1553 * @hw: the hardware parameters
1555 * Sets the substream runtime hardware parameters.
1557 int snd_soc_set_runtime_hwparams(struct snd_pcm_substream *substream,
1558 const struct snd_pcm_hardware *hw)
1560 struct snd_pcm_runtime *runtime = substream->runtime;
1561 runtime->hw.info = hw->info;
1562 runtime->hw.formats = hw->formats;
1563 runtime->hw.period_bytes_min = hw->period_bytes_min;
1564 runtime->hw.period_bytes_max = hw->period_bytes_max;
1565 runtime->hw.periods_min = hw->periods_min;
1566 runtime->hw.periods_max = hw->periods_max;
1567 runtime->hw.buffer_bytes_max = hw->buffer_bytes_max;
1568 runtime->hw.fifo_size = hw->fifo_size;
1571 EXPORT_SYMBOL_GPL(snd_soc_set_runtime_hwparams);
1574 * snd_soc_cnew - create new control
1575 * @_template: control template
1576 * @data: control private data
1577 * @long_name: control long name
1579 * Create a new mixer control from a template control.
1581 * Returns 0 for success, else error.
1583 struct snd_kcontrol *snd_soc_cnew(const struct snd_kcontrol_new *_template,
1584 void *data, char *long_name)
1586 struct snd_kcontrol_new template;
1588 memcpy(&template, _template, sizeof(template));
1590 template.name = long_name;
1593 return snd_ctl_new1(&template, data);
1595 EXPORT_SYMBOL_GPL(snd_soc_cnew);
1598 * snd_soc_add_controls - add an array of controls to a codec.
1599 * Convienience function to add a list of controls. Many codecs were
1600 * duplicating this code.
1602 * @codec: codec to add controls to
1603 * @controls: array of controls to add
1604 * @num_controls: number of elements in the array
1606 * Return 0 for success, else error.
1608 int snd_soc_add_controls(struct snd_soc_codec *codec,
1609 const struct snd_kcontrol_new *controls, int num_controls)
1611 struct snd_card *card = codec->card;
1614 for (i = 0; i < num_controls; i++) {
1615 const struct snd_kcontrol_new *control = &controls[i];
1616 err = snd_ctl_add(card, snd_soc_cnew(control, codec, NULL));
1618 dev_err(codec->dev, "%s: Failed to add %s\n",
1619 codec->name, control->name);
1626 EXPORT_SYMBOL_GPL(snd_soc_add_controls);
1629 * snd_soc_info_enum_double - enumerated double mixer info callback
1630 * @kcontrol: mixer control
1631 * @uinfo: control element information
1633 * Callback to provide information about a double enumerated
1636 * Returns 0 for success.
1638 int snd_soc_info_enum_double(struct snd_kcontrol *kcontrol,
1639 struct snd_ctl_elem_info *uinfo)
1641 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1643 uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
1644 uinfo->count = e->shift_l == e->shift_r ? 1 : 2;
1645 uinfo->value.enumerated.items = e->max;
1647 if (uinfo->value.enumerated.item > e->max - 1)
1648 uinfo->value.enumerated.item = e->max - 1;
1649 strcpy(uinfo->value.enumerated.name,
1650 e->texts[uinfo->value.enumerated.item]);
1653 EXPORT_SYMBOL_GPL(snd_soc_info_enum_double);
1656 * snd_soc_get_enum_double - enumerated double mixer get callback
1657 * @kcontrol: mixer control
1658 * @ucontrol: control element information
1660 * Callback to get the value of a double enumerated mixer.
1662 * Returns 0 for success.
1664 int snd_soc_get_enum_double(struct snd_kcontrol *kcontrol,
1665 struct snd_ctl_elem_value *ucontrol)
1667 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1668 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1669 unsigned int val, bitmask;
1671 for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
1673 val = snd_soc_read(codec, e->reg);
1674 ucontrol->value.enumerated.item[0]
1675 = (val >> e->shift_l) & (bitmask - 1);
1676 if (e->shift_l != e->shift_r)
1677 ucontrol->value.enumerated.item[1] =
1678 (val >> e->shift_r) & (bitmask - 1);
1682 EXPORT_SYMBOL_GPL(snd_soc_get_enum_double);
1685 * snd_soc_put_enum_double - enumerated double mixer put callback
1686 * @kcontrol: mixer control
1687 * @ucontrol: control element information
1689 * Callback to set the value of a double enumerated mixer.
1691 * Returns 0 for success.
1693 int snd_soc_put_enum_double(struct snd_kcontrol *kcontrol,
1694 struct snd_ctl_elem_value *ucontrol)
1696 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1697 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1699 unsigned int mask, bitmask;
1701 for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
1703 if (ucontrol->value.enumerated.item[0] > e->max - 1)
1705 val = ucontrol->value.enumerated.item[0] << e->shift_l;
1706 mask = (bitmask - 1) << e->shift_l;
1707 if (e->shift_l != e->shift_r) {
1708 if (ucontrol->value.enumerated.item[1] > e->max - 1)
1710 val |= ucontrol->value.enumerated.item[1] << e->shift_r;
1711 mask |= (bitmask - 1) << e->shift_r;
1714 return snd_soc_update_bits(codec, e->reg, mask, val);
1716 EXPORT_SYMBOL_GPL(snd_soc_put_enum_double);
1719 * snd_soc_get_value_enum_double - semi enumerated double mixer get callback
1720 * @kcontrol: mixer control
1721 * @ucontrol: control element information
1723 * Callback to get the value of a double semi enumerated mixer.
1725 * Semi enumerated mixer: the enumerated items are referred as values. Can be
1726 * used for handling bitfield coded enumeration for example.
1728 * Returns 0 for success.
1730 int snd_soc_get_value_enum_double(struct snd_kcontrol *kcontrol,
1731 struct snd_ctl_elem_value *ucontrol)
1733 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1734 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1735 unsigned int reg_val, val, mux;
1737 reg_val = snd_soc_read(codec, e->reg);
1738 val = (reg_val >> e->shift_l) & e->mask;
1739 for (mux = 0; mux < e->max; mux++) {
1740 if (val == e->values[mux])
1743 ucontrol->value.enumerated.item[0] = mux;
1744 if (e->shift_l != e->shift_r) {
1745 val = (reg_val >> e->shift_r) & e->mask;
1746 for (mux = 0; mux < e->max; mux++) {
1747 if (val == e->values[mux])
1750 ucontrol->value.enumerated.item[1] = mux;
1755 EXPORT_SYMBOL_GPL(snd_soc_get_value_enum_double);
1758 * snd_soc_put_value_enum_double - semi enumerated double mixer put callback
1759 * @kcontrol: mixer control
1760 * @ucontrol: control element information
1762 * Callback to set the value of a double semi enumerated mixer.
1764 * Semi enumerated mixer: the enumerated items are referred as values. Can be
1765 * used for handling bitfield coded enumeration for example.
1767 * Returns 0 for success.
1769 int snd_soc_put_value_enum_double(struct snd_kcontrol *kcontrol,
1770 struct snd_ctl_elem_value *ucontrol)
1772 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1773 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1777 if (ucontrol->value.enumerated.item[0] > e->max - 1)
1779 val = e->values[ucontrol->value.enumerated.item[0]] << e->shift_l;
1780 mask = e->mask << e->shift_l;
1781 if (e->shift_l != e->shift_r) {
1782 if (ucontrol->value.enumerated.item[1] > e->max - 1)
1784 val |= e->values[ucontrol->value.enumerated.item[1]] << e->shift_r;
1785 mask |= e->mask << e->shift_r;
1788 return snd_soc_update_bits(codec, e->reg, mask, val);
1790 EXPORT_SYMBOL_GPL(snd_soc_put_value_enum_double);
1793 * snd_soc_info_enum_ext - external enumerated single mixer info callback
1794 * @kcontrol: mixer control
1795 * @uinfo: control element information
1797 * Callback to provide information about an external enumerated
1800 * Returns 0 for success.
1802 int snd_soc_info_enum_ext(struct snd_kcontrol *kcontrol,
1803 struct snd_ctl_elem_info *uinfo)
1805 struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1807 uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
1809 uinfo->value.enumerated.items = e->max;
1811 if (uinfo->value.enumerated.item > e->max - 1)
1812 uinfo->value.enumerated.item = e->max - 1;
1813 strcpy(uinfo->value.enumerated.name,
1814 e->texts[uinfo->value.enumerated.item]);
1817 EXPORT_SYMBOL_GPL(snd_soc_info_enum_ext);
1820 * snd_soc_info_volsw_ext - external single mixer info callback
1821 * @kcontrol: mixer control
1822 * @uinfo: control element information
1824 * Callback to provide information about a single external mixer control.
1826 * Returns 0 for success.
1828 int snd_soc_info_volsw_ext(struct snd_kcontrol *kcontrol,
1829 struct snd_ctl_elem_info *uinfo)
1831 int max = kcontrol->private_value;
1833 if (max == 1 && !strstr(kcontrol->id.name, " Volume"))
1834 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
1836 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
1839 uinfo->value.integer.min = 0;
1840 uinfo->value.integer.max = max;
1843 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_ext);
1846 * snd_soc_info_volsw - single mixer info callback
1847 * @kcontrol: mixer control
1848 * @uinfo: control element information
1850 * Callback to provide information about a single mixer control.
1852 * Returns 0 for success.
1854 int snd_soc_info_volsw(struct snd_kcontrol *kcontrol,
1855 struct snd_ctl_elem_info *uinfo)
1857 struct soc_mixer_control *mc =
1858 (struct soc_mixer_control *)kcontrol->private_value;
1860 unsigned int shift = mc->shift;
1861 unsigned int rshift = mc->rshift;
1863 if (max == 1 && !strstr(kcontrol->id.name, " Volume"))
1864 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
1866 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
1868 uinfo->count = shift == rshift ? 1 : 2;
1869 uinfo->value.integer.min = 0;
1870 uinfo->value.integer.max = max;
1873 EXPORT_SYMBOL_GPL(snd_soc_info_volsw);
1876 * snd_soc_get_volsw - single mixer get callback
1877 * @kcontrol: mixer control
1878 * @ucontrol: control element information
1880 * Callback to get the value of a single mixer control.
1882 * Returns 0 for success.
1884 int snd_soc_get_volsw(struct snd_kcontrol *kcontrol,
1885 struct snd_ctl_elem_value *ucontrol)
1887 struct soc_mixer_control *mc =
1888 (struct soc_mixer_control *)kcontrol->private_value;
1889 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1890 unsigned int reg = mc->reg;
1891 unsigned int shift = mc->shift;
1892 unsigned int rshift = mc->rshift;
1894 unsigned int mask = (1 << fls(max)) - 1;
1895 unsigned int invert = mc->invert;
1897 ucontrol->value.integer.value[0] =
1898 (snd_soc_read(codec, reg) >> shift) & mask;
1899 if (shift != rshift)
1900 ucontrol->value.integer.value[1] =
1901 (snd_soc_read(codec, reg) >> rshift) & mask;
1903 ucontrol->value.integer.value[0] =
1904 max - ucontrol->value.integer.value[0];
1905 if (shift != rshift)
1906 ucontrol->value.integer.value[1] =
1907 max - ucontrol->value.integer.value[1];
1912 EXPORT_SYMBOL_GPL(snd_soc_get_volsw);
1915 * snd_soc_put_volsw - single mixer put callback
1916 * @kcontrol: mixer control
1917 * @ucontrol: control element information
1919 * Callback to set the value of a single mixer control.
1921 * Returns 0 for success.
1923 int snd_soc_put_volsw(struct snd_kcontrol *kcontrol,
1924 struct snd_ctl_elem_value *ucontrol)
1926 struct soc_mixer_control *mc =
1927 (struct soc_mixer_control *)kcontrol->private_value;
1928 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1929 unsigned int reg = mc->reg;
1930 unsigned int shift = mc->shift;
1931 unsigned int rshift = mc->rshift;
1933 unsigned int mask = (1 << fls(max)) - 1;
1934 unsigned int invert = mc->invert;
1935 unsigned int val, val2, val_mask;
1937 val = (ucontrol->value.integer.value[0] & mask);
1940 val_mask = mask << shift;
1942 if (shift != rshift) {
1943 val2 = (ucontrol->value.integer.value[1] & mask);
1946 val_mask |= mask << rshift;
1947 val |= val2 << rshift;
1949 return snd_soc_update_bits(codec, reg, val_mask, val);
1951 EXPORT_SYMBOL_GPL(snd_soc_put_volsw);
1954 * snd_soc_info_volsw_2r - double mixer info callback
1955 * @kcontrol: mixer control
1956 * @uinfo: control element information
1958 * Callback to provide information about a double mixer control that
1959 * spans 2 codec registers.
1961 * Returns 0 for success.
1963 int snd_soc_info_volsw_2r(struct snd_kcontrol *kcontrol,
1964 struct snd_ctl_elem_info *uinfo)
1966 struct soc_mixer_control *mc =
1967 (struct soc_mixer_control *)kcontrol->private_value;
1970 if (max == 1 && !strstr(kcontrol->id.name, " Volume"))
1971 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
1973 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
1976 uinfo->value.integer.min = 0;
1977 uinfo->value.integer.max = max;
1980 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_2r);
1983 * snd_soc_get_volsw_2r - double mixer get callback
1984 * @kcontrol: mixer control
1985 * @ucontrol: control element information
1987 * Callback to get the value of a double mixer control that spans 2 registers.
1989 * Returns 0 for success.
1991 int snd_soc_get_volsw_2r(struct snd_kcontrol *kcontrol,
1992 struct snd_ctl_elem_value *ucontrol)
1994 struct soc_mixer_control *mc =
1995 (struct soc_mixer_control *)kcontrol->private_value;
1996 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1997 unsigned int reg = mc->reg;
1998 unsigned int reg2 = mc->rreg;
1999 unsigned int shift = mc->shift;
2001 unsigned int mask = (1 << fls(max)) - 1;
2002 unsigned int invert = mc->invert;
2004 ucontrol->value.integer.value[0] =
2005 (snd_soc_read(codec, reg) >> shift) & mask;
2006 ucontrol->value.integer.value[1] =
2007 (snd_soc_read(codec, reg2) >> shift) & mask;
2009 ucontrol->value.integer.value[0] =
2010 max - ucontrol->value.integer.value[0];
2011 ucontrol->value.integer.value[1] =
2012 max - ucontrol->value.integer.value[1];
2017 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_2r);
2020 * snd_soc_put_volsw_2r - double mixer set callback
2021 * @kcontrol: mixer control
2022 * @ucontrol: control element information
2024 * Callback to set the value of a double mixer control that spans 2 registers.
2026 * Returns 0 for success.
2028 int snd_soc_put_volsw_2r(struct snd_kcontrol *kcontrol,
2029 struct snd_ctl_elem_value *ucontrol)
2031 struct soc_mixer_control *mc =
2032 (struct soc_mixer_control *)kcontrol->private_value;
2033 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2034 unsigned int reg = mc->reg;
2035 unsigned int reg2 = mc->rreg;
2036 unsigned int shift = mc->shift;
2038 unsigned int mask = (1 << fls(max)) - 1;
2039 unsigned int invert = mc->invert;
2041 unsigned int val, val2, val_mask;
2043 val_mask = mask << shift;
2044 val = (ucontrol->value.integer.value[0] & mask);
2045 val2 = (ucontrol->value.integer.value[1] & mask);
2053 val2 = val2 << shift;
2055 err = snd_soc_update_bits(codec, reg, val_mask, val);
2059 err = snd_soc_update_bits(codec, reg2, val_mask, val2);
2062 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_2r);
2065 * snd_soc_info_volsw_s8 - signed mixer info callback
2066 * @kcontrol: mixer control
2067 * @uinfo: control element information
2069 * Callback to provide information about a signed mixer control.
2071 * Returns 0 for success.
2073 int snd_soc_info_volsw_s8(struct snd_kcontrol *kcontrol,
2074 struct snd_ctl_elem_info *uinfo)
2076 struct soc_mixer_control *mc =
2077 (struct soc_mixer_control *)kcontrol->private_value;
2081 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
2083 uinfo->value.integer.min = 0;
2084 uinfo->value.integer.max = max-min;
2087 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_s8);
2090 * snd_soc_get_volsw_s8 - signed mixer get callback
2091 * @kcontrol: mixer control
2092 * @ucontrol: control element information
2094 * Callback to get the value of a signed mixer control.
2096 * Returns 0 for success.
2098 int snd_soc_get_volsw_s8(struct snd_kcontrol *kcontrol,
2099 struct snd_ctl_elem_value *ucontrol)
2101 struct soc_mixer_control *mc =
2102 (struct soc_mixer_control *)kcontrol->private_value;
2103 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2104 unsigned int reg = mc->reg;
2106 int val = snd_soc_read(codec, reg);
2108 ucontrol->value.integer.value[0] =
2109 ((signed char)(val & 0xff))-min;
2110 ucontrol->value.integer.value[1] =
2111 ((signed char)((val >> 8) & 0xff))-min;
2114 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_s8);
2117 * snd_soc_put_volsw_sgn - signed mixer put callback
2118 * @kcontrol: mixer control
2119 * @ucontrol: control element information
2121 * Callback to set the value of a signed mixer control.
2123 * Returns 0 for success.
2125 int snd_soc_put_volsw_s8(struct snd_kcontrol *kcontrol,
2126 struct snd_ctl_elem_value *ucontrol)
2128 struct soc_mixer_control *mc =
2129 (struct soc_mixer_control *)kcontrol->private_value;
2130 struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2131 unsigned int reg = mc->reg;
2135 val = (ucontrol->value.integer.value[0]+min) & 0xff;
2136 val |= ((ucontrol->value.integer.value[1]+min) & 0xff) << 8;
2138 return snd_soc_update_bits(codec, reg, 0xffff, val);
2140 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_s8);
2143 * snd_soc_dai_set_sysclk - configure DAI system or master clock.
2145 * @clk_id: DAI specific clock ID
2146 * @freq: new clock frequency in Hz
2147 * @dir: new clock direction - input/output.
2149 * Configures the DAI master (MCLK) or system (SYSCLK) clocking.
2151 int snd_soc_dai_set_sysclk(struct snd_soc_dai *dai, int clk_id,
2152 unsigned int freq, int dir)
2154 if (dai->ops && dai->ops->set_sysclk)
2155 return dai->ops->set_sysclk(dai, clk_id, freq, dir);
2159 EXPORT_SYMBOL_GPL(snd_soc_dai_set_sysclk);
2162 * snd_soc_dai_set_clkdiv - configure DAI clock dividers.
2164 * @div_id: DAI specific clock divider ID
2165 * @div: new clock divisor.
2167 * Configures the clock dividers. This is used to derive the best DAI bit and
2168 * frame clocks from the system or master clock. It's best to set the DAI bit
2169 * and frame clocks as low as possible to save system power.
2171 int snd_soc_dai_set_clkdiv(struct snd_soc_dai *dai,
2172 int div_id, int div)
2174 if (dai->ops && dai->ops->set_clkdiv)
2175 return dai->ops->set_clkdiv(dai, div_id, div);
2179 EXPORT_SYMBOL_GPL(snd_soc_dai_set_clkdiv);
2182 * snd_soc_dai_set_pll - configure DAI PLL.
2184 * @pll_id: DAI specific PLL ID
2185 * @freq_in: PLL input clock frequency in Hz
2186 * @freq_out: requested PLL output clock frequency in Hz
2188 * Configures and enables PLL to generate output clock based on input clock.
2190 int snd_soc_dai_set_pll(struct snd_soc_dai *dai,
2191 int pll_id, unsigned int freq_in, unsigned int freq_out)
2193 if (dai->ops && dai->ops->set_pll)
2194 return dai->ops->set_pll(dai, pll_id, freq_in, freq_out);
2198 EXPORT_SYMBOL_GPL(snd_soc_dai_set_pll);
2201 * snd_soc_dai_set_fmt - configure DAI hardware audio format.
2203 * @fmt: SND_SOC_DAIFMT_ format value.
2205 * Configures the DAI hardware format and clocking.
2207 int snd_soc_dai_set_fmt(struct snd_soc_dai *dai, unsigned int fmt)
2209 if (dai->ops && dai->ops->set_fmt)
2210 return dai->ops->set_fmt(dai, fmt);
2214 EXPORT_SYMBOL_GPL(snd_soc_dai_set_fmt);
2217 * snd_soc_dai_set_tdm_slot - configure DAI TDM.
2219 * @mask: DAI specific mask representing used slots.
2220 * @slots: Number of slots in use.
2222 * Configures a DAI for TDM operation. Both mask and slots are codec and DAI
2225 int snd_soc_dai_set_tdm_slot(struct snd_soc_dai *dai,
2226 unsigned int mask, int slots)
2228 if (dai->ops && dai->ops->set_tdm_slot)
2229 return dai->ops->set_tdm_slot(dai, mask, slots);
2233 EXPORT_SYMBOL_GPL(snd_soc_dai_set_tdm_slot);
2236 * snd_soc_dai_set_tristate - configure DAI system or master clock.
2238 * @tristate: tristate enable
2240 * Tristates the DAI so that others can use it.
2242 int snd_soc_dai_set_tristate(struct snd_soc_dai *dai, int tristate)
2244 if (dai->ops && dai->ops->set_tristate)
2245 return dai->ops->set_tristate(dai, tristate);
2249 EXPORT_SYMBOL_GPL(snd_soc_dai_set_tristate);
2252 * snd_soc_dai_digital_mute - configure DAI system or master clock.
2254 * @mute: mute enable
2256 * Mutes the DAI DAC.
2258 int snd_soc_dai_digital_mute(struct snd_soc_dai *dai, int mute)
2260 if (dai->ops && dai->ops->digital_mute)
2261 return dai->ops->digital_mute(dai, mute);
2265 EXPORT_SYMBOL_GPL(snd_soc_dai_digital_mute);
2268 * snd_soc_register_card - Register a card with the ASoC core
2270 * @card: Card to register
2272 * Note that currently this is an internal only function: it will be
2273 * exposed to machine drivers after further backporting of ASoC v2
2274 * registration APIs.
2276 static int snd_soc_register_card(struct snd_soc_card *card)
2278 if (!card->name || !card->dev)
2281 INIT_LIST_HEAD(&card->list);
2282 card->instantiated = 0;
2284 mutex_lock(&client_mutex);
2285 list_add(&card->list, &card_list);
2286 snd_soc_instantiate_cards();
2287 mutex_unlock(&client_mutex);
2289 dev_dbg(card->dev, "Registered card '%s'\n", card->name);
2295 * snd_soc_unregister_card - Unregister a card with the ASoC core
2297 * @card: Card to unregister
2299 * Note that currently this is an internal only function: it will be
2300 * exposed to machine drivers after further backporting of ASoC v2
2301 * registration APIs.
2303 static int snd_soc_unregister_card(struct snd_soc_card *card)
2305 mutex_lock(&client_mutex);
2306 list_del(&card->list);
2307 mutex_unlock(&client_mutex);
2309 dev_dbg(card->dev, "Unregistered card '%s'\n", card->name);
2314 static struct snd_soc_dai_ops null_dai_ops = {
2318 * snd_soc_register_dai - Register a DAI with the ASoC core
2320 * @dai: DAI to register
2322 int snd_soc_register_dai(struct snd_soc_dai *dai)
2327 /* The device should become mandatory over time */
2329 printk(KERN_WARNING "No device for DAI %s\n", dai->name);
2332 dai->ops = &null_dai_ops;
2334 INIT_LIST_HEAD(&dai->list);
2336 mutex_lock(&client_mutex);
2337 list_add(&dai->list, &dai_list);
2338 snd_soc_instantiate_cards();
2339 mutex_unlock(&client_mutex);
2341 pr_debug("Registered DAI '%s'\n", dai->name);
2345 EXPORT_SYMBOL_GPL(snd_soc_register_dai);
2348 * snd_soc_unregister_dai - Unregister a DAI from the ASoC core
2350 * @dai: DAI to unregister
2352 void snd_soc_unregister_dai(struct snd_soc_dai *dai)
2354 mutex_lock(&client_mutex);
2355 list_del(&dai->list);
2356 mutex_unlock(&client_mutex);
2358 pr_debug("Unregistered DAI '%s'\n", dai->name);
2360 EXPORT_SYMBOL_GPL(snd_soc_unregister_dai);
2363 * snd_soc_register_dais - Register multiple DAIs with the ASoC core
2365 * @dai: Array of DAIs to register
2366 * @count: Number of DAIs
2368 int snd_soc_register_dais(struct snd_soc_dai *dai, size_t count)
2372 for (i = 0; i < count; i++) {
2373 ret = snd_soc_register_dai(&dai[i]);
2381 for (i--; i >= 0; i--)
2382 snd_soc_unregister_dai(&dai[i]);
2386 EXPORT_SYMBOL_GPL(snd_soc_register_dais);
2389 * snd_soc_unregister_dais - Unregister multiple DAIs from the ASoC core
2391 * @dai: Array of DAIs to unregister
2392 * @count: Number of DAIs
2394 void snd_soc_unregister_dais(struct snd_soc_dai *dai, size_t count)
2398 for (i = 0; i < count; i++)
2399 snd_soc_unregister_dai(&dai[i]);
2401 EXPORT_SYMBOL_GPL(snd_soc_unregister_dais);
2404 * snd_soc_register_platform - Register a platform with the ASoC core
2406 * @platform: platform to register
2408 int snd_soc_register_platform(struct snd_soc_platform *platform)
2410 if (!platform->name)
2413 INIT_LIST_HEAD(&platform->list);
2415 mutex_lock(&client_mutex);
2416 list_add(&platform->list, &platform_list);
2417 snd_soc_instantiate_cards();
2418 mutex_unlock(&client_mutex);
2420 pr_debug("Registered platform '%s'\n", platform->name);
2424 EXPORT_SYMBOL_GPL(snd_soc_register_platform);
2427 * snd_soc_unregister_platform - Unregister a platform from the ASoC core
2429 * @platform: platform to unregister
2431 void snd_soc_unregister_platform(struct snd_soc_platform *platform)
2433 mutex_lock(&client_mutex);
2434 list_del(&platform->list);
2435 mutex_unlock(&client_mutex);
2437 pr_debug("Unregistered platform '%s'\n", platform->name);
2439 EXPORT_SYMBOL_GPL(snd_soc_unregister_platform);
2441 static u64 codec_format_map[] = {
2442 SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S16_BE,
2443 SNDRV_PCM_FMTBIT_U16_LE | SNDRV_PCM_FMTBIT_U16_BE,
2444 SNDRV_PCM_FMTBIT_S24_LE | SNDRV_PCM_FMTBIT_S24_BE,
2445 SNDRV_PCM_FMTBIT_U24_LE | SNDRV_PCM_FMTBIT_U24_BE,
2446 SNDRV_PCM_FMTBIT_S32_LE | SNDRV_PCM_FMTBIT_S32_BE,
2447 SNDRV_PCM_FMTBIT_U32_LE | SNDRV_PCM_FMTBIT_U32_BE,
2448 SNDRV_PCM_FMTBIT_S24_3LE | SNDRV_PCM_FMTBIT_U24_3BE,
2449 SNDRV_PCM_FMTBIT_U24_3LE | SNDRV_PCM_FMTBIT_U24_3BE,
2450 SNDRV_PCM_FMTBIT_S20_3LE | SNDRV_PCM_FMTBIT_S20_3BE,
2451 SNDRV_PCM_FMTBIT_U20_3LE | SNDRV_PCM_FMTBIT_U20_3BE,
2452 SNDRV_PCM_FMTBIT_S18_3LE | SNDRV_PCM_FMTBIT_S18_3BE,
2453 SNDRV_PCM_FMTBIT_U18_3LE | SNDRV_PCM_FMTBIT_U18_3BE,
2454 SNDRV_PCM_FMTBIT_FLOAT_LE | SNDRV_PCM_FMTBIT_FLOAT_BE,
2455 SNDRV_PCM_FMTBIT_FLOAT64_LE | SNDRV_PCM_FMTBIT_FLOAT64_BE,
2456 SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE
2457 | SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE,
2460 /* Fix up the DAI formats for endianness: codecs don't actually see
2461 * the endianness of the data but we're using the CPU format
2462 * definitions which do need to include endianness so we ensure that
2463 * codec DAIs always have both big and little endian variants set.
2465 static void fixup_codec_formats(struct snd_soc_pcm_stream *stream)
2469 for (i = 0; i < ARRAY_SIZE(codec_format_map); i++)
2470 if (stream->formats & codec_format_map[i])
2471 stream->formats |= codec_format_map[i];
2475 * snd_soc_register_codec - Register a codec with the ASoC core
2477 * @codec: codec to register
2479 int snd_soc_register_codec(struct snd_soc_codec *codec)
2486 /* The device should become mandatory over time */
2488 printk(KERN_WARNING "No device for codec %s\n", codec->name);
2490 INIT_LIST_HEAD(&codec->list);
2492 for (i = 0; i < codec->num_dai; i++) {
2493 fixup_codec_formats(&codec->dai[i].playback);
2494 fixup_codec_formats(&codec->dai[i].capture);
2497 mutex_lock(&client_mutex);
2498 list_add(&codec->list, &codec_list);
2499 snd_soc_instantiate_cards();
2500 mutex_unlock(&client_mutex);
2502 pr_debug("Registered codec '%s'\n", codec->name);
2506 EXPORT_SYMBOL_GPL(snd_soc_register_codec);
2509 * snd_soc_unregister_codec - Unregister a codec from the ASoC core
2511 * @codec: codec to unregister
2513 void snd_soc_unregister_codec(struct snd_soc_codec *codec)
2515 mutex_lock(&client_mutex);
2516 list_del(&codec->list);
2517 mutex_unlock(&client_mutex);
2519 pr_debug("Unregistered codec '%s'\n", codec->name);
2521 EXPORT_SYMBOL_GPL(snd_soc_unregister_codec);
2523 static int __init snd_soc_init(void)
2525 #ifdef CONFIG_DEBUG_FS
2526 debugfs_root = debugfs_create_dir("asoc", NULL);
2527 if (IS_ERR(debugfs_root) || !debugfs_root) {
2529 "ASoC: Failed to create debugfs directory\n");
2530 debugfs_root = NULL;
2534 return platform_driver_register(&soc_driver);
2537 static void __exit snd_soc_exit(void)
2539 #ifdef CONFIG_DEBUG_FS
2540 debugfs_remove_recursive(debugfs_root);
2542 platform_driver_unregister(&soc_driver);
2545 module_init(snd_soc_init);
2546 module_exit(snd_soc_exit);
2548 /* Module information */
2549 MODULE_AUTHOR("Liam Girdwood, lrg@slimlogic.co.uk");
2550 MODULE_DESCRIPTION("ALSA SoC Core");
2551 MODULE_LICENSE("GPL");
2552 MODULE_ALIAS("platform:soc-audio");