ASoC: core - Make platform probe more like codec probe.
[linux-2.6.git] / sound / soc / soc-core.c
1 /*
2  * soc-core.c  --  ALSA SoC Audio Layer
3  *
4  * Copyright 2005 Wolfson Microelectronics PLC.
5  * Copyright 2005 Openedhand Ltd.
6  * Copyright (C) 2010 Slimlogic Ltd.
7  * Copyright (C) 2010 Texas Instruments Inc.
8  *
9  * Author: Liam Girdwood <lrg@slimlogic.co.uk>
10  *         with code, comments and ideas from :-
11  *         Richard Purdie <richard@openedhand.com>
12  *
13  *  This program is free software; you can redistribute  it and/or modify it
14  *  under  the terms of  the GNU General  Public License as published by the
15  *  Free Software Foundation;  either version 2 of the  License, or (at your
16  *  option) any later version.
17  *
18  *  TODO:
19  *   o Add hw rules to enforce rates, etc.
20  *   o More testing with other codecs/machines.
21  *   o Add more codecs and platforms to ensure good API coverage.
22  *   o Support TDM on PCM and I2S
23  */
24
25 #include <linux/module.h>
26 #include <linux/moduleparam.h>
27 #include <linux/init.h>
28 #include <linux/delay.h>
29 #include <linux/pm.h>
30 #include <linux/bitops.h>
31 #include <linux/debugfs.h>
32 #include <linux/platform_device.h>
33 #include <linux/slab.h>
34 #include <sound/ac97_codec.h>
35 #include <sound/core.h>
36 #include <sound/jack.h>
37 #include <sound/pcm.h>
38 #include <sound/pcm_params.h>
39 #include <sound/soc.h>
40 #include <sound/initval.h>
41
42 #define CREATE_TRACE_POINTS
43 #include <trace/events/asoc.h>
44
45 #define NAME_SIZE       32
46
47 static DECLARE_WAIT_QUEUE_HEAD(soc_pm_waitq);
48
49 #ifdef CONFIG_DEBUG_FS
50 struct dentry *snd_soc_debugfs_root;
51 EXPORT_SYMBOL_GPL(snd_soc_debugfs_root);
52 #endif
53
54 static DEFINE_MUTEX(client_mutex);
55 static LIST_HEAD(card_list);
56 static LIST_HEAD(dai_list);
57 static LIST_HEAD(platform_list);
58 static LIST_HEAD(codec_list);
59
60 int soc_new_pcm(struct snd_soc_pcm_runtime *rtd, int num);
61
62 /*
63  * This is a timeout to do a DAPM powerdown after a stream is closed().
64  * It can be used to eliminate pops between different playback streams, e.g.
65  * between two audio tracks.
66  */
67 static int pmdown_time = 5000;
68 module_param(pmdown_time, int, 0);
69 MODULE_PARM_DESC(pmdown_time, "DAPM stream powerdown time (msecs)");
70
71 /* returns the minimum number of bytes needed to represent
72  * a particular given value */
73 static int min_bytes_needed(unsigned long val)
74 {
75         int c = 0;
76         int i;
77
78         for (i = (sizeof val * 8) - 1; i >= 0; --i, ++c)
79                 if (val & (1UL << i))
80                         break;
81         c = (sizeof val * 8) - c;
82         if (!c || (c % 8))
83                 c = (c + 8) / 8;
84         else
85                 c /= 8;
86         return c;
87 }
88
89 /* fill buf which is 'len' bytes with a formatted
90  * string of the form 'reg: value\n' */
91 static int format_register_str(struct snd_soc_codec *codec,
92                                unsigned int reg, char *buf, size_t len)
93 {
94         int wordsize = min_bytes_needed(codec->driver->reg_cache_size) * 2;
95         int regsize = codec->driver->reg_word_size * 2;
96         int ret;
97         char tmpbuf[len + 1];
98         char regbuf[regsize + 1];
99
100         /* since tmpbuf is allocated on the stack, warn the callers if they
101          * try to abuse this function */
102         WARN_ON(len > 63);
103
104         /* +2 for ': ' and + 1 for '\n' */
105         if (wordsize + regsize + 2 + 1 != len)
106                 return -EINVAL;
107
108         ret = snd_soc_read(codec , reg);
109         if (ret < 0) {
110                 memset(regbuf, 'X', regsize);
111                 regbuf[regsize] = '\0';
112         } else {
113                 snprintf(regbuf, regsize + 1, "%.*x", regsize, ret);
114         }
115
116         /* prepare the buffer */
117         snprintf(tmpbuf, len + 1, "%.*x: %s\n", wordsize, reg, regbuf);
118         /* copy it back to the caller without the '\0' */
119         memcpy(buf, tmpbuf, len);
120
121         return 0;
122 }
123
124 /* codec register dump */
125 static ssize_t soc_codec_reg_show(struct snd_soc_codec *codec, char *buf,
126                                   size_t count, loff_t pos)
127 {
128         int i, step = 1;
129         int wordsize, regsize;
130         int len;
131         size_t total = 0;
132         loff_t p = 0;
133
134         wordsize = min_bytes_needed(codec->driver->reg_cache_size) * 2;
135         regsize = codec->driver->reg_word_size * 2;
136
137         len = wordsize + regsize + 2 + 1;
138
139         if (!codec->driver->reg_cache_size)
140                 return 0;
141
142         if (codec->driver->reg_cache_step)
143                 step = codec->driver->reg_cache_step;
144
145         for (i = 0; i < codec->driver->reg_cache_size; i += step) {
146                 if (codec->readable_register && !codec->readable_register(codec, i))
147                         continue;
148                 if (codec->driver->display_register) {
149                         count += codec->driver->display_register(codec, buf + count,
150                                                          PAGE_SIZE - count, i);
151                 } else {
152                         /* only support larger than PAGE_SIZE bytes debugfs
153                          * entries for the default case */
154                         if (p >= pos) {
155                                 if (total + len >= count - 1)
156                                         break;
157                                 format_register_str(codec, i, buf + total, len);
158                                 total += len;
159                         }
160                         p += len;
161                 }
162         }
163
164         total = min(total, count - 1);
165
166         return total;
167 }
168
169 static ssize_t codec_reg_show(struct device *dev,
170         struct device_attribute *attr, char *buf)
171 {
172         struct snd_soc_pcm_runtime *rtd =
173                         container_of(dev, struct snd_soc_pcm_runtime, dev);
174
175         return soc_codec_reg_show(rtd->codec, buf, PAGE_SIZE, 0);
176 }
177
178 static DEVICE_ATTR(codec_reg, 0444, codec_reg_show, NULL);
179
180 static ssize_t pmdown_time_show(struct device *dev,
181                                 struct device_attribute *attr, char *buf)
182 {
183         struct snd_soc_pcm_runtime *rtd =
184                         container_of(dev, struct snd_soc_pcm_runtime, dev);
185
186         return sprintf(buf, "%ld\n", rtd->pmdown_time);
187 }
188
189 static ssize_t pmdown_time_set(struct device *dev,
190                                struct device_attribute *attr,
191                                const char *buf, size_t count)
192 {
193         struct snd_soc_pcm_runtime *rtd =
194                         container_of(dev, struct snd_soc_pcm_runtime, dev);
195         int ret;
196
197         ret = strict_strtol(buf, 10, &rtd->pmdown_time);
198         if (ret)
199                 return ret;
200
201         return count;
202 }
203
204 static DEVICE_ATTR(pmdown_time, 0644, pmdown_time_show, pmdown_time_set);
205
206 #ifdef CONFIG_DEBUG_FS
207 static int codec_reg_open_file(struct inode *inode, struct file *file)
208 {
209         file->private_data = inode->i_private;
210         return 0;
211 }
212
213 static ssize_t codec_reg_read_file(struct file *file, char __user *user_buf,
214                                    size_t count, loff_t *ppos)
215 {
216         ssize_t ret;
217         struct snd_soc_codec *codec = file->private_data;
218         char *buf;
219
220         if (*ppos < 0 || !count)
221                 return -EINVAL;
222
223         buf = kmalloc(count, GFP_KERNEL);
224         if (!buf)
225                 return -ENOMEM;
226
227         ret = soc_codec_reg_show(codec, buf, count, *ppos);
228         if (ret >= 0) {
229                 if (copy_to_user(user_buf, buf, ret)) {
230                         kfree(buf);
231                         return -EFAULT;
232                 }
233                 *ppos += ret;
234         }
235
236         kfree(buf);
237         return ret;
238 }
239
240 static ssize_t codec_reg_write_file(struct file *file,
241                 const char __user *user_buf, size_t count, loff_t *ppos)
242 {
243         char buf[32];
244         size_t buf_size;
245         char *start = buf;
246         unsigned long reg, value;
247         int step = 1;
248         struct snd_soc_codec *codec = file->private_data;
249
250         buf_size = min(count, (sizeof(buf)-1));
251         if (copy_from_user(buf, user_buf, buf_size))
252                 return -EFAULT;
253         buf[buf_size] = 0;
254
255         if (codec->driver->reg_cache_step)
256                 step = codec->driver->reg_cache_step;
257
258         while (*start == ' ')
259                 start++;
260         reg = simple_strtoul(start, &start, 16);
261         while (*start == ' ')
262                 start++;
263         if (strict_strtoul(start, 16, &value))
264                 return -EINVAL;
265
266         /* Userspace has been fiddling around behind the kernel's back */
267         add_taint(TAINT_USER);
268
269         snd_soc_write(codec, reg, value);
270         return buf_size;
271 }
272
273 static const struct file_operations codec_reg_fops = {
274         .open = codec_reg_open_file,
275         .read = codec_reg_read_file,
276         .write = codec_reg_write_file,
277         .llseek = default_llseek,
278 };
279
280 static void soc_init_codec_debugfs(struct snd_soc_codec *codec)
281 {
282         struct dentry *debugfs_card_root = codec->card->debugfs_card_root;
283
284         codec->debugfs_codec_root = debugfs_create_dir(codec->name,
285                                                        debugfs_card_root);
286         if (!codec->debugfs_codec_root) {
287                 printk(KERN_WARNING
288                        "ASoC: Failed to create codec debugfs directory\n");
289                 return;
290         }
291
292         debugfs_create_bool("cache_sync", 0444, codec->debugfs_codec_root,
293                             &codec->cache_sync);
294         debugfs_create_bool("cache_only", 0444, codec->debugfs_codec_root,
295                             &codec->cache_only);
296
297         codec->debugfs_reg = debugfs_create_file("codec_reg", 0644,
298                                                  codec->debugfs_codec_root,
299                                                  codec, &codec_reg_fops);
300         if (!codec->debugfs_reg)
301                 printk(KERN_WARNING
302                        "ASoC: Failed to create codec register debugfs file\n");
303
304         snd_soc_dapm_debugfs_init(&codec->dapm, codec->debugfs_codec_root);
305 }
306
307 static void soc_cleanup_codec_debugfs(struct snd_soc_codec *codec)
308 {
309         debugfs_remove_recursive(codec->debugfs_codec_root);
310 }
311
312 static ssize_t codec_list_read_file(struct file *file, char __user *user_buf,
313                                     size_t count, loff_t *ppos)
314 {
315         char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
316         ssize_t len, ret = 0;
317         struct snd_soc_codec *codec;
318
319         if (!buf)
320                 return -ENOMEM;
321
322         list_for_each_entry(codec, &codec_list, list) {
323                 len = snprintf(buf + ret, PAGE_SIZE - ret, "%s\n",
324                                codec->name);
325                 if (len >= 0)
326                         ret += len;
327                 if (ret > PAGE_SIZE) {
328                         ret = PAGE_SIZE;
329                         break;
330                 }
331         }
332
333         if (ret >= 0)
334                 ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
335
336         kfree(buf);
337
338         return ret;
339 }
340
341 static const struct file_operations codec_list_fops = {
342         .read = codec_list_read_file,
343         .llseek = default_llseek,/* read accesses f_pos */
344 };
345
346 static ssize_t dai_list_read_file(struct file *file, char __user *user_buf,
347                                   size_t count, loff_t *ppos)
348 {
349         char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
350         ssize_t len, ret = 0;
351         struct snd_soc_dai *dai;
352
353         if (!buf)
354                 return -ENOMEM;
355
356         list_for_each_entry(dai, &dai_list, list) {
357                 len = snprintf(buf + ret, PAGE_SIZE - ret, "%s\n", dai->name);
358                 if (len >= 0)
359                         ret += len;
360                 if (ret > PAGE_SIZE) {
361                         ret = PAGE_SIZE;
362                         break;
363                 }
364         }
365
366         ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
367
368         kfree(buf);
369
370         return ret;
371 }
372
373 static const struct file_operations dai_list_fops = {
374         .read = dai_list_read_file,
375         .llseek = default_llseek,/* read accesses f_pos */
376 };
377
378 static ssize_t platform_list_read_file(struct file *file,
379                                        char __user *user_buf,
380                                        size_t count, loff_t *ppos)
381 {
382         char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
383         ssize_t len, ret = 0;
384         struct snd_soc_platform *platform;
385
386         if (!buf)
387                 return -ENOMEM;
388
389         list_for_each_entry(platform, &platform_list, list) {
390                 len = snprintf(buf + ret, PAGE_SIZE - ret, "%s\n",
391                                platform->name);
392                 if (len >= 0)
393                         ret += len;
394                 if (ret > PAGE_SIZE) {
395                         ret = PAGE_SIZE;
396                         break;
397                 }
398         }
399
400         ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
401
402         kfree(buf);
403
404         return ret;
405 }
406
407 static const struct file_operations platform_list_fops = {
408         .read = platform_list_read_file,
409         .llseek = default_llseek,/* read accesses f_pos */
410 };
411
412 static void soc_init_card_debugfs(struct snd_soc_card *card)
413 {
414         card->debugfs_card_root = debugfs_create_dir(card->name,
415                                                      snd_soc_debugfs_root);
416         if (!card->debugfs_card_root) {
417                 dev_warn(card->dev,
418                          "ASoC: Failed to create codec debugfs directory\n");
419                 return;
420         }
421
422         card->debugfs_pop_time = debugfs_create_u32("dapm_pop_time", 0644,
423                                                     card->debugfs_card_root,
424                                                     &card->pop_time);
425         if (!card->debugfs_pop_time)
426                 dev_warn(card->dev,
427                        "Failed to create pop time debugfs file\n");
428 }
429
430 static void soc_cleanup_card_debugfs(struct snd_soc_card *card)
431 {
432         debugfs_remove_recursive(card->debugfs_card_root);
433 }
434
435 #else
436
437 static inline void soc_init_codec_debugfs(struct snd_soc_codec *codec)
438 {
439 }
440
441 static inline void soc_cleanup_codec_debugfs(struct snd_soc_codec *codec)
442 {
443 }
444
445 static inline void soc_init_card_debugfs(struct snd_soc_card *card)
446 {
447 }
448
449 static inline void soc_cleanup_card_debugfs(struct snd_soc_card *card)
450 {
451 }
452 #endif
453
454 #ifdef CONFIG_SND_SOC_AC97_BUS
455 /* unregister ac97 codec */
456 static int soc_ac97_dev_unregister(struct snd_soc_codec *codec)
457 {
458         if (codec->ac97->dev.bus)
459                 device_unregister(&codec->ac97->dev);
460         return 0;
461 }
462
463 /* stop no dev release warning */
464 static void soc_ac97_device_release(struct device *dev){}
465
466 /* register ac97 codec to bus */
467 static int soc_ac97_dev_register(struct snd_soc_codec *codec)
468 {
469         int err;
470
471         codec->ac97->dev.bus = &ac97_bus_type;
472         codec->ac97->dev.parent = codec->card->dev;
473         codec->ac97->dev.release = soc_ac97_device_release;
474
475         dev_set_name(&codec->ac97->dev, "%d-%d:%s",
476                      codec->card->snd_card->number, 0, codec->name);
477         err = device_register(&codec->ac97->dev);
478         if (err < 0) {
479                 snd_printk(KERN_ERR "Can't register ac97 bus\n");
480                 codec->ac97->dev.bus = NULL;
481                 return err;
482         }
483         return 0;
484 }
485 #endif
486
487 #ifdef CONFIG_PM_SLEEP
488 /* powers down audio subsystem for suspend */
489 int snd_soc_suspend(struct device *dev)
490 {
491         struct snd_soc_card *card = dev_get_drvdata(dev);
492         struct snd_soc_codec *codec;
493         int i;
494
495         /* If the initialization of this soc device failed, there is no codec
496          * associated with it. Just bail out in this case.
497          */
498         if (list_empty(&card->codec_dev_list))
499                 return 0;
500
501         /* Due to the resume being scheduled into a workqueue we could
502         * suspend before that's finished - wait for it to complete.
503          */
504         snd_power_lock(card->snd_card);
505         snd_power_wait(card->snd_card, SNDRV_CTL_POWER_D0);
506         snd_power_unlock(card->snd_card);
507
508         /* we're going to block userspace touching us until resume completes */
509         snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D3hot);
510
511         /* mute any active DACs */
512         for (i = 0; i < card->num_rtd; i++) {
513                 struct snd_soc_dai *dai = card->rtd[i].codec_dai;
514                 struct snd_soc_dai_driver *drv = dai->driver;
515
516                 if (card->rtd[i].dai_link->ignore_suspend)
517                         continue;
518
519                 if (drv->ops->digital_mute && dai->playback_active)
520                         drv->ops->digital_mute(dai, 1);
521         }
522
523         /* suspend all pcms */
524         for (i = 0; i < card->num_rtd; i++) {
525                 if (card->rtd[i].dai_link->ignore_suspend)
526                         continue;
527
528                 snd_pcm_suspend_all(card->rtd[i].pcm);
529         }
530
531         if (card->suspend_pre)
532                 card->suspend_pre(card);
533
534         for (i = 0; i < card->num_rtd; i++) {
535                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
536                 struct snd_soc_platform *platform = card->rtd[i].platform;
537
538                 if (card->rtd[i].dai_link->ignore_suspend)
539                         continue;
540
541                 if (cpu_dai->driver->suspend && !cpu_dai->driver->ac97_control)
542                         cpu_dai->driver->suspend(cpu_dai);
543                 if (platform->driver->suspend && !platform->suspended) {
544                         platform->driver->suspend(cpu_dai);
545                         platform->suspended = 1;
546                 }
547         }
548
549         /* close any waiting streams and save state */
550         for (i = 0; i < card->num_rtd; i++) {
551                 flush_delayed_work_sync(&card->rtd[i].delayed_work);
552                 card->rtd[i].codec->dapm.suspend_bias_level = card->rtd[i].codec->dapm.bias_level;
553         }
554
555         for (i = 0; i < card->num_rtd; i++) {
556                 struct snd_soc_dai_driver *driver = card->rtd[i].codec_dai->driver;
557
558                 if (card->rtd[i].dai_link->ignore_suspend)
559                         continue;
560
561                 if (driver->playback.stream_name != NULL)
562                         snd_soc_dapm_stream_event(&card->rtd[i], driver->playback.stream_name,
563                                 SND_SOC_DAPM_STREAM_SUSPEND);
564
565                 if (driver->capture.stream_name != NULL)
566                         snd_soc_dapm_stream_event(&card->rtd[i], driver->capture.stream_name,
567                                 SND_SOC_DAPM_STREAM_SUSPEND);
568         }
569
570         /* suspend all CODECs */
571         list_for_each_entry(codec, &card->codec_dev_list, card_list) {
572                 /* If there are paths active then the CODEC will be held with
573                  * bias _ON and should not be suspended. */
574                 if (!codec->suspended && codec->driver->suspend) {
575                         switch (codec->dapm.bias_level) {
576                         case SND_SOC_BIAS_STANDBY:
577                         case SND_SOC_BIAS_OFF:
578                                 codec->driver->suspend(codec, PMSG_SUSPEND);
579                                 codec->suspended = 1;
580                                 break;
581                         default:
582                                 dev_dbg(codec->dev, "CODEC is on over suspend\n");
583                                 break;
584                         }
585                 }
586         }
587
588         for (i = 0; i < card->num_rtd; i++) {
589                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
590
591                 if (card->rtd[i].dai_link->ignore_suspend)
592                         continue;
593
594                 if (cpu_dai->driver->suspend && cpu_dai->driver->ac97_control)
595                         cpu_dai->driver->suspend(cpu_dai);
596         }
597
598         if (card->suspend_post)
599                 card->suspend_post(card);
600
601         return 0;
602 }
603 EXPORT_SYMBOL_GPL(snd_soc_suspend);
604
605 /* deferred resume work, so resume can complete before we finished
606  * setting our codec back up, which can be very slow on I2C
607  */
608 static void soc_resume_deferred(struct work_struct *work)
609 {
610         struct snd_soc_card *card =
611                         container_of(work, struct snd_soc_card, deferred_resume_work);
612         struct snd_soc_codec *codec;
613         int i;
614
615         /* our power state is still SNDRV_CTL_POWER_D3hot from suspend time,
616          * so userspace apps are blocked from touching us
617          */
618
619         dev_dbg(card->dev, "starting resume work\n");
620
621         /* Bring us up into D2 so that DAPM starts enabling things */
622         snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D2);
623
624         if (card->resume_pre)
625                 card->resume_pre(card);
626
627         /* resume AC97 DAIs */
628         for (i = 0; i < card->num_rtd; i++) {
629                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
630
631                 if (card->rtd[i].dai_link->ignore_suspend)
632                         continue;
633
634                 if (cpu_dai->driver->resume && cpu_dai->driver->ac97_control)
635                         cpu_dai->driver->resume(cpu_dai);
636         }
637
638         list_for_each_entry(codec, &card->codec_dev_list, card_list) {
639                 /* If the CODEC was idle over suspend then it will have been
640                  * left with bias OFF or STANDBY and suspended so we must now
641                  * resume.  Otherwise the suspend was suppressed.
642                  */
643                 if (codec->driver->resume && codec->suspended) {
644                         switch (codec->dapm.bias_level) {
645                         case SND_SOC_BIAS_STANDBY:
646                         case SND_SOC_BIAS_OFF:
647                                 codec->driver->resume(codec);
648                                 codec->suspended = 0;
649                                 break;
650                         default:
651                                 dev_dbg(codec->dev, "CODEC was on over suspend\n");
652                                 break;
653                         }
654                 }
655         }
656
657         for (i = 0; i < card->num_rtd; i++) {
658                 struct snd_soc_dai_driver *driver = card->rtd[i].codec_dai->driver;
659
660                 if (card->rtd[i].dai_link->ignore_suspend)
661                         continue;
662
663                 if (driver->playback.stream_name != NULL)
664                         snd_soc_dapm_stream_event(&card->rtd[i], driver->playback.stream_name,
665                                 SND_SOC_DAPM_STREAM_RESUME);
666
667                 if (driver->capture.stream_name != NULL)
668                         snd_soc_dapm_stream_event(&card->rtd[i], driver->capture.stream_name,
669                                 SND_SOC_DAPM_STREAM_RESUME);
670         }
671
672         /* unmute any active DACs */
673         for (i = 0; i < card->num_rtd; i++) {
674                 struct snd_soc_dai *dai = card->rtd[i].codec_dai;
675                 struct snd_soc_dai_driver *drv = dai->driver;
676
677                 if (card->rtd[i].dai_link->ignore_suspend)
678                         continue;
679
680                 if (drv->ops->digital_mute && dai->playback_active)
681                         drv->ops->digital_mute(dai, 0);
682         }
683
684         for (i = 0; i < card->num_rtd; i++) {
685                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
686                 struct snd_soc_platform *platform = card->rtd[i].platform;
687
688                 if (card->rtd[i].dai_link->ignore_suspend)
689                         continue;
690
691                 if (cpu_dai->driver->resume && !cpu_dai->driver->ac97_control)
692                         cpu_dai->driver->resume(cpu_dai);
693                 if (platform->driver->resume && platform->suspended) {
694                         platform->driver->resume(cpu_dai);
695                         platform->suspended = 0;
696                 }
697         }
698
699         if (card->resume_post)
700                 card->resume_post(card);
701
702         dev_dbg(card->dev, "resume work completed\n");
703
704         /* userspace can access us now we are back as we were before */
705         snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D0);
706 }
707
708 /* powers up audio subsystem after a suspend */
709 int snd_soc_resume(struct device *dev)
710 {
711         struct snd_soc_card *card = dev_get_drvdata(dev);
712         int i, ac97_control = 0;
713
714         /* AC97 devices might have other drivers hanging off them so
715          * need to resume immediately.  Other drivers don't have that
716          * problem and may take a substantial amount of time to resume
717          * due to I/O costs and anti-pop so handle them out of line.
718          */
719         for (i = 0; i < card->num_rtd; i++) {
720                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
721                 ac97_control |= cpu_dai->driver->ac97_control;
722         }
723         if (ac97_control) {
724                 dev_dbg(dev, "Resuming AC97 immediately\n");
725                 soc_resume_deferred(&card->deferred_resume_work);
726         } else {
727                 dev_dbg(dev, "Scheduling resume work\n");
728                 if (!schedule_work(&card->deferred_resume_work))
729                         dev_err(dev, "resume work item may be lost\n");
730         }
731
732         return 0;
733 }
734 EXPORT_SYMBOL_GPL(snd_soc_resume);
735 #else
736 #define snd_soc_suspend NULL
737 #define snd_soc_resume NULL
738 #endif
739
740 static struct snd_soc_dai_ops null_dai_ops = {
741 };
742
743 static int soc_bind_dai_link(struct snd_soc_card *card, int num)
744 {
745         struct snd_soc_dai_link *dai_link = &card->dai_link[num];
746         struct snd_soc_pcm_runtime *rtd = &card->rtd[num];
747         struct snd_soc_codec *codec;
748         struct snd_soc_platform *platform;
749         struct snd_soc_dai *codec_dai, *cpu_dai;
750         const char *platform_name;
751
752         if (rtd->complete)
753                 return 1;
754         dev_dbg(card->dev, "binding %s at idx %d\n", dai_link->name, num);
755
756         /* do we already have the CPU DAI for this link ? */
757         if (rtd->cpu_dai) {
758                 goto find_codec;
759         }
760         /* no, then find CPU DAI from registered DAIs*/
761         list_for_each_entry(cpu_dai, &dai_list, list) {
762                 if (!strcmp(cpu_dai->name, dai_link->cpu_dai_name)) {
763                         rtd->cpu_dai = cpu_dai;
764                         goto find_codec;
765                 }
766         }
767         dev_dbg(card->dev, "CPU DAI %s not registered\n",
768                         dai_link->cpu_dai_name);
769
770 find_codec:
771         /* do we already have the CODEC for this link ? */
772         if (rtd->codec) {
773                 goto find_platform;
774         }
775
776         /* no, then find CODEC from registered CODECs*/
777         list_for_each_entry(codec, &codec_list, list) {
778                 if (!strcmp(codec->name, dai_link->codec_name)) {
779                         rtd->codec = codec;
780
781                         /* CODEC found, so find CODEC DAI from registered DAIs from this CODEC*/
782                         list_for_each_entry(codec_dai, &dai_list, list) {
783                                 if (codec->dev == codec_dai->dev &&
784                                                 !strcmp(codec_dai->name, dai_link->codec_dai_name)) {
785                                         rtd->codec_dai = codec_dai;
786                                         goto find_platform;
787                                 }
788                         }
789                         dev_dbg(card->dev, "CODEC DAI %s not registered\n",
790                                         dai_link->codec_dai_name);
791
792                         goto find_platform;
793                 }
794         }
795         dev_dbg(card->dev, "CODEC %s not registered\n",
796                         dai_link->codec_name);
797
798 find_platform:
799         /* do we need a platform? */
800         if (rtd->platform)
801                 goto out;
802
803         /* if there's no platform we match on the empty platform */
804         platform_name = dai_link->platform_name;
805         if (!platform_name)
806                 platform_name = "snd-soc-dummy";
807
808         /* no, then find one from the set of registered platforms */
809         list_for_each_entry(platform, &platform_list, list) {
810                 if (!strcmp(platform->name, platform_name)) {
811                         rtd->platform = platform;
812                         goto out;
813                 }
814         }
815
816         dev_dbg(card->dev, "platform %s not registered\n",
817                         dai_link->platform_name);
818         return 0;
819
820 out:
821         /* mark rtd as complete if we found all 4 of our client devices */
822         if (rtd->codec && rtd->codec_dai && rtd->platform && rtd->cpu_dai) {
823                 rtd->complete = 1;
824                 card->num_rtd++;
825         }
826         return 1;
827 }
828
829 static void soc_remove_codec(struct snd_soc_codec *codec)
830 {
831         int err;
832
833         if (codec->driver->remove) {
834                 err = codec->driver->remove(codec);
835                 if (err < 0)
836                         dev_err(codec->dev,
837                                 "asoc: failed to remove %s: %d\n",
838                                 codec->name, err);
839         }
840
841         /* Make sure all DAPM widgets are freed */
842         snd_soc_dapm_free(&codec->dapm);
843
844         soc_cleanup_codec_debugfs(codec);
845         codec->probed = 0;
846         list_del(&codec->card_list);
847         module_put(codec->dev->driver->owner);
848 }
849
850 static void soc_remove_dai_link(struct snd_soc_card *card, int num, int order)
851 {
852         struct snd_soc_pcm_runtime *rtd = &card->rtd[num];
853         struct snd_soc_codec *codec = rtd->codec;
854         struct snd_soc_platform *platform = rtd->platform;
855         struct snd_soc_dai *codec_dai = rtd->codec_dai, *cpu_dai = rtd->cpu_dai;
856         int err;
857
858         /* unregister the rtd device */
859         if (rtd->dev_registered) {
860                 device_remove_file(&rtd->dev, &dev_attr_pmdown_time);
861                 device_remove_file(&rtd->dev, &dev_attr_codec_reg);
862                 device_unregister(&rtd->dev);
863                 rtd->dev_registered = 0;
864         }
865
866         /* remove the CODEC DAI */
867         if (codec_dai && codec_dai->probed &&
868                         codec_dai->driver->remove_order == order) {
869                 if (codec_dai->driver->remove) {
870                         err = codec_dai->driver->remove(codec_dai);
871                         if (err < 0)
872                                 printk(KERN_ERR "asoc: failed to remove %s\n", codec_dai->name);
873                 }
874                 codec_dai->probed = 0;
875                 list_del(&codec_dai->card_list);
876         }
877
878         /* remove the platform */
879         if (platform && platform->probed &&
880                         platform->driver->remove_order == order) {
881                 if (platform->driver->remove) {
882                         err = platform->driver->remove(platform);
883                         if (err < 0)
884                                 printk(KERN_ERR "asoc: failed to remove %s\n", platform->name);
885                 }
886                 platform->probed = 0;
887                 list_del(&platform->card_list);
888                 module_put(platform->dev->driver->owner);
889         }
890
891         /* remove the CODEC */
892         if (codec && codec->probed &&
893                         codec->driver->remove_order == order)
894                 soc_remove_codec(codec);
895
896         /* remove the cpu_dai */
897         if (cpu_dai && cpu_dai->probed &&
898                         cpu_dai->driver->remove_order == order) {
899                 if (cpu_dai->driver->remove) {
900                         err = cpu_dai->driver->remove(cpu_dai);
901                         if (err < 0)
902                                 printk(KERN_ERR "asoc: failed to remove %s\n", cpu_dai->name);
903                 }
904                 cpu_dai->probed = 0;
905                 list_del(&cpu_dai->card_list);
906                 module_put(cpu_dai->dev->driver->owner);
907         }
908 }
909
910 static void soc_remove_dai_links(struct snd_soc_card *card)
911 {
912         int dai, order;
913
914         for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
915                         order++) {
916                 for (dai = 0; dai < card->num_rtd; dai++)
917                         soc_remove_dai_link(card, dai, order);
918         }
919         card->num_rtd = 0;
920 }
921
922 static void soc_set_name_prefix(struct snd_soc_card *card,
923                                 struct snd_soc_codec *codec)
924 {
925         int i;
926
927         if (card->codec_conf == NULL)
928                 return;
929
930         for (i = 0; i < card->num_configs; i++) {
931                 struct snd_soc_codec_conf *map = &card->codec_conf[i];
932                 if (map->dev_name && !strcmp(codec->name, map->dev_name)) {
933                         codec->name_prefix = map->name_prefix;
934                         break;
935                 }
936         }
937 }
938
939 static int soc_probe_codec(struct snd_soc_card *card,
940                            struct snd_soc_codec *codec)
941 {
942         int ret = 0;
943         const struct snd_soc_codec_driver *driver = codec->driver;
944
945         codec->card = card;
946         codec->dapm.card = card;
947         soc_set_name_prefix(card, codec);
948
949         if (!try_module_get(codec->dev->driver->owner))
950                 return -ENODEV;
951
952         soc_init_codec_debugfs(codec);
953
954         if (driver->dapm_widgets)
955                 snd_soc_dapm_new_controls(&codec->dapm, driver->dapm_widgets,
956                                           driver->num_dapm_widgets);
957
958         if (driver->probe) {
959                 ret = driver->probe(codec);
960                 if (ret < 0) {
961                         dev_err(codec->dev,
962                                 "asoc: failed to probe CODEC %s: %d\n",
963                                 codec->name, ret);
964                         goto err_probe;
965                 }
966         }
967
968         if (driver->controls)
969                 snd_soc_add_controls(codec, driver->controls,
970                                      driver->num_controls);
971         if (driver->dapm_routes)
972                 snd_soc_dapm_add_routes(&codec->dapm, driver->dapm_routes,
973                                         driver->num_dapm_routes);
974
975         /* mark codec as probed and add to card codec list */
976         codec->probed = 1;
977         list_add(&codec->card_list, &card->codec_dev_list);
978         list_add(&codec->dapm.list, &card->dapm_list);
979
980         return 0;
981
982 err_probe:
983         soc_cleanup_codec_debugfs(codec);
984         module_put(codec->dev->driver->owner);
985
986         return ret;
987 }
988
989 static int soc_probe_platform(struct snd_soc_card *card,
990                            struct snd_soc_platform *platform)
991 {
992         int ret = 0;
993         const struct snd_soc_platform_driver *driver = platform->driver;
994
995         platform->card = card;
996
997         if (!try_module_get(platform->dev->driver->owner))
998                 return -ENODEV;
999
1000         if (driver->probe) {
1001                 ret = driver->probe(platform);
1002                 if (ret < 0) {
1003                         dev_err(platform->dev,
1004                                 "asoc: failed to probe platform %s: %d\n",
1005                                 platform->name, ret);
1006                         goto err_probe;
1007                 }
1008         }
1009
1010         /* mark platform as probed and add to card platform list */
1011         platform->probed = 1;
1012         list_add(&platform->card_list, &card->platform_dev_list);
1013
1014         return 0;
1015
1016 err_probe:
1017         module_put(platform->dev->driver->owner);
1018
1019         return ret;
1020 }
1021
1022 static void rtd_release(struct device *dev) {}
1023
1024 static int soc_post_component_init(struct snd_soc_card *card,
1025                                    struct snd_soc_codec *codec,
1026                                    int num, int dailess)
1027 {
1028         struct snd_soc_dai_link *dai_link = NULL;
1029         struct snd_soc_aux_dev *aux_dev = NULL;
1030         struct snd_soc_pcm_runtime *rtd;
1031         const char *temp, *name;
1032         int ret = 0;
1033
1034         if (!dailess) {
1035                 dai_link = &card->dai_link[num];
1036                 rtd = &card->rtd[num];
1037                 name = dai_link->name;
1038         } else {
1039                 aux_dev = &card->aux_dev[num];
1040                 rtd = &card->rtd_aux[num];
1041                 name = aux_dev->name;
1042         }
1043         rtd->card = card;
1044
1045         /* machine controls, routes and widgets are not prefixed */
1046         temp = codec->name_prefix;
1047         codec->name_prefix = NULL;
1048
1049         /* do machine specific initialization */
1050         if (!dailess && dai_link->init)
1051                 ret = dai_link->init(rtd);
1052         else if (dailess && aux_dev->init)
1053                 ret = aux_dev->init(&codec->dapm);
1054         if (ret < 0) {
1055                 dev_err(card->dev, "asoc: failed to init %s: %d\n", name, ret);
1056                 return ret;
1057         }
1058         codec->name_prefix = temp;
1059
1060         /* Make sure all DAPM widgets are instantiated */
1061         snd_soc_dapm_new_widgets(&codec->dapm);
1062
1063         /* register the rtd device */
1064         rtd->codec = codec;
1065         rtd->dev.parent = card->dev;
1066         rtd->dev.release = rtd_release;
1067         rtd->dev.init_name = name;
1068         mutex_init(&rtd->pcm_mutex);
1069         ret = device_register(&rtd->dev);
1070         if (ret < 0) {
1071                 dev_err(card->dev,
1072                         "asoc: failed to register runtime device: %d\n", ret);
1073                 return ret;
1074         }
1075         rtd->dev_registered = 1;
1076
1077         /* add DAPM sysfs entries for this codec */
1078         ret = snd_soc_dapm_sys_add(&rtd->dev);
1079         if (ret < 0)
1080                 dev_err(codec->dev,
1081                         "asoc: failed to add codec dapm sysfs entries: %d\n",
1082                         ret);
1083
1084         /* add codec sysfs entries */
1085         ret = device_create_file(&rtd->dev, &dev_attr_codec_reg);
1086         if (ret < 0)
1087                 dev_err(codec->dev,
1088                         "asoc: failed to add codec sysfs files: %d\n", ret);
1089
1090         return 0;
1091 }
1092
1093 static int soc_probe_dai_link(struct snd_soc_card *card, int num, int order)
1094 {
1095         struct snd_soc_dai_link *dai_link = &card->dai_link[num];
1096         struct snd_soc_pcm_runtime *rtd = &card->rtd[num];
1097         struct snd_soc_codec *codec = rtd->codec;
1098         struct snd_soc_platform *platform = rtd->platform;
1099         struct snd_soc_dai *codec_dai = rtd->codec_dai, *cpu_dai = rtd->cpu_dai;
1100         int ret;
1101
1102         dev_dbg(card->dev, "probe %s dai link %d late %d\n",
1103                         card->name, num, order);
1104
1105         /* config components */
1106         codec_dai->codec = codec;
1107         cpu_dai->platform = platform;
1108         codec_dai->card = card;
1109         cpu_dai->card = card;
1110
1111         /* set default power off timeout */
1112         rtd->pmdown_time = pmdown_time;
1113
1114         /* probe the cpu_dai */
1115         if (!cpu_dai->probed &&
1116                         cpu_dai->driver->probe_order == order) {
1117                 if (!try_module_get(cpu_dai->dev->driver->owner))
1118                         return -ENODEV;
1119
1120                 if (cpu_dai->driver->probe) {
1121                         ret = cpu_dai->driver->probe(cpu_dai);
1122                         if (ret < 0) {
1123                                 printk(KERN_ERR "asoc: failed to probe CPU DAI %s\n",
1124                                                 cpu_dai->name);
1125                                 module_put(cpu_dai->dev->driver->owner);
1126                                 return ret;
1127                         }
1128                 }
1129                 cpu_dai->probed = 1;
1130                 /* mark cpu_dai as probed and add to card cpu_dai list */
1131                 list_add(&cpu_dai->card_list, &card->dai_dev_list);
1132         }
1133
1134         /* probe the CODEC */
1135         if (!codec->probed &&
1136                         codec->driver->probe_order == order) {
1137                 ret = soc_probe_codec(card, codec);
1138                 if (ret < 0)
1139                         return ret;
1140         }
1141
1142         /* probe the platform */
1143         if (!platform->probed &&
1144                         platform->driver->probe_order == order) {
1145                 ret = soc_probe_platform(card, platform);
1146                 if (ret < 0)
1147                         return ret;
1148         }
1149
1150         /* probe the CODEC DAI */
1151         if (!codec_dai->probed && codec_dai->driver->probe_order == order) {
1152                 if (codec_dai->driver->probe) {
1153                         ret = codec_dai->driver->probe(codec_dai);
1154                         if (ret < 0) {
1155                                 printk(KERN_ERR "asoc: failed to probe CODEC DAI %s\n",
1156                                                 codec_dai->name);
1157                                 return ret;
1158                         }
1159                 }
1160
1161                 /* mark cpu_dai as probed and add to card cpu_dai list */
1162                 codec_dai->probed = 1;
1163                 list_add(&codec_dai->card_list, &card->dai_dev_list);
1164         }
1165
1166         /* complete DAI probe during last probe */
1167         if (order != SND_SOC_COMP_ORDER_LAST)
1168                 return 0;
1169
1170         ret = soc_post_component_init(card, codec, num, 0);
1171         if (ret)
1172                 return ret;
1173
1174         ret = device_create_file(&rtd->dev, &dev_attr_pmdown_time);
1175         if (ret < 0)
1176                 printk(KERN_WARNING "asoc: failed to add pmdown_time sysfs\n");
1177
1178         /* create the pcm */
1179         ret = soc_new_pcm(rtd, num);
1180         if (ret < 0) {
1181                 printk(KERN_ERR "asoc: can't create pcm %s\n", dai_link->stream_name);
1182                 return ret;
1183         }
1184
1185         /* add platform data for AC97 devices */
1186         if (rtd->codec_dai->driver->ac97_control)
1187                 snd_ac97_dev_add_pdata(codec->ac97, rtd->cpu_dai->ac97_pdata);
1188
1189         return 0;
1190 }
1191
1192 #ifdef CONFIG_SND_SOC_AC97_BUS
1193 static int soc_register_ac97_dai_link(struct snd_soc_pcm_runtime *rtd)
1194 {
1195         int ret;
1196
1197         /* Only instantiate AC97 if not already done by the adaptor
1198          * for the generic AC97 subsystem.
1199          */
1200         if (rtd->codec_dai->driver->ac97_control && !rtd->codec->ac97_registered) {
1201                 /*
1202                  * It is possible that the AC97 device is already registered to
1203                  * the device subsystem. This happens when the device is created
1204                  * via snd_ac97_mixer(). Currently only SoC codec that does so
1205                  * is the generic AC97 glue but others migh emerge.
1206                  *
1207                  * In those cases we don't try to register the device again.
1208                  */
1209                 if (!rtd->codec->ac97_created)
1210                         return 0;
1211
1212                 ret = soc_ac97_dev_register(rtd->codec);
1213                 if (ret < 0) {
1214                         printk(KERN_ERR "asoc: AC97 device register failed\n");
1215                         return ret;
1216                 }
1217
1218                 rtd->codec->ac97_registered = 1;
1219         }
1220         return 0;
1221 }
1222
1223 static void soc_unregister_ac97_dai_link(struct snd_soc_codec *codec)
1224 {
1225         if (codec->ac97_registered) {
1226                 soc_ac97_dev_unregister(codec);
1227                 codec->ac97_registered = 0;
1228         }
1229 }
1230 #endif
1231
1232 static int soc_probe_aux_dev(struct snd_soc_card *card, int num)
1233 {
1234         struct snd_soc_aux_dev *aux_dev = &card->aux_dev[num];
1235         struct snd_soc_codec *codec;
1236         int ret = -ENODEV;
1237
1238         /* find CODEC from registered CODECs*/
1239         list_for_each_entry(codec, &codec_list, list) {
1240                 if (!strcmp(codec->name, aux_dev->codec_name)) {
1241                         if (codec->probed) {
1242                                 dev_err(codec->dev,
1243                                         "asoc: codec already probed");
1244                                 ret = -EBUSY;
1245                                 goto out;
1246                         }
1247                         goto found;
1248                 }
1249         }
1250         /* codec not found */
1251         dev_err(card->dev, "asoc: codec %s not found", aux_dev->codec_name);
1252         goto out;
1253
1254 found:
1255         ret = soc_probe_codec(card, codec);
1256         if (ret < 0)
1257                 return ret;
1258
1259         ret = soc_post_component_init(card, codec, num, 1);
1260
1261 out:
1262         return ret;
1263 }
1264
1265 static void soc_remove_aux_dev(struct snd_soc_card *card, int num)
1266 {
1267         struct snd_soc_pcm_runtime *rtd = &card->rtd_aux[num];
1268         struct snd_soc_codec *codec = rtd->codec;
1269
1270         /* unregister the rtd device */
1271         if (rtd->dev_registered) {
1272                 device_remove_file(&rtd->dev, &dev_attr_codec_reg);
1273                 device_unregister(&rtd->dev);
1274                 rtd->dev_registered = 0;
1275         }
1276
1277         if (codec && codec->probed)
1278                 soc_remove_codec(codec);
1279 }
1280
1281 static int snd_soc_init_codec_cache(struct snd_soc_codec *codec,
1282                                     enum snd_soc_compress_type compress_type)
1283 {
1284         int ret;
1285
1286         if (codec->cache_init)
1287                 return 0;
1288
1289         /* override the compress_type if necessary */
1290         if (compress_type && codec->compress_type != compress_type)
1291                 codec->compress_type = compress_type;
1292         ret = snd_soc_cache_init(codec);
1293         if (ret < 0) {
1294                 dev_err(codec->dev, "Failed to set cache compression type: %d\n",
1295                         ret);
1296                 return ret;
1297         }
1298         codec->cache_init = 1;
1299         return 0;
1300 }
1301
1302 static void snd_soc_instantiate_card(struct snd_soc_card *card)
1303 {
1304         struct snd_soc_codec *codec;
1305         struct snd_soc_codec_conf *codec_conf;
1306         enum snd_soc_compress_type compress_type;
1307         int ret, i, order;
1308
1309         mutex_lock(&card->mutex);
1310
1311         if (card->instantiated) {
1312                 mutex_unlock(&card->mutex);
1313                 return;
1314         }
1315
1316         /* bind DAIs */
1317         for (i = 0; i < card->num_links; i++)
1318                 soc_bind_dai_link(card, i);
1319
1320         /* bind completed ? */
1321         if (card->num_rtd != card->num_links) {
1322                 mutex_unlock(&card->mutex);
1323                 return;
1324         }
1325
1326         /* initialize the register cache for each available codec */
1327         list_for_each_entry(codec, &codec_list, list) {
1328                 if (codec->cache_init)
1329                         continue;
1330                 /* by default we don't override the compress_type */
1331                 compress_type = 0;
1332                 /* check to see if we need to override the compress_type */
1333                 for (i = 0; i < card->num_configs; ++i) {
1334                         codec_conf = &card->codec_conf[i];
1335                         if (!strcmp(codec->name, codec_conf->dev_name)) {
1336                                 compress_type = codec_conf->compress_type;
1337                                 if (compress_type && compress_type
1338                                     != codec->compress_type)
1339                                         break;
1340                         }
1341                 }
1342                 ret = snd_soc_init_codec_cache(codec, compress_type);
1343                 if (ret < 0) {
1344                         mutex_unlock(&card->mutex);
1345                         return;
1346                 }
1347         }
1348
1349         /* card bind complete so register a sound card */
1350         ret = snd_card_create(SNDRV_DEFAULT_IDX1, SNDRV_DEFAULT_STR1,
1351                         card->owner, 0, &card->snd_card);
1352         if (ret < 0) {
1353                 printk(KERN_ERR "asoc: can't create sound card for card %s\n",
1354                         card->name);
1355                 mutex_unlock(&card->mutex);
1356                 return;
1357         }
1358         card->snd_card->dev = card->dev;
1359
1360         card->dapm.bias_level = SND_SOC_BIAS_OFF;
1361         card->dapm.dev = card->dev;
1362         card->dapm.card = card;
1363         list_add(&card->dapm.list, &card->dapm_list);
1364
1365 #ifdef CONFIG_DEBUG_FS
1366         snd_soc_dapm_debugfs_init(&card->dapm, card->debugfs_card_root);
1367 #endif
1368
1369 #ifdef CONFIG_PM_SLEEP
1370         /* deferred resume work */
1371         INIT_WORK(&card->deferred_resume_work, soc_resume_deferred);
1372 #endif
1373
1374         if (card->dapm_widgets)
1375                 snd_soc_dapm_new_controls(&card->dapm, card->dapm_widgets,
1376                                           card->num_dapm_widgets);
1377
1378         /* initialise the sound card only once */
1379         if (card->probe) {
1380                 ret = card->probe(card);
1381                 if (ret < 0)
1382                         goto card_probe_error;
1383         }
1384
1385         /* early DAI link probe */
1386         for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
1387                         order++) {
1388                 for (i = 0; i < card->num_links; i++) {
1389                         ret = soc_probe_dai_link(card, i, order);
1390                         if (ret < 0) {
1391                                 pr_err("asoc: failed to instantiate card %s: %d\n",
1392                                card->name, ret);
1393                                 goto probe_dai_err;
1394                         }
1395                 }
1396         }
1397
1398         for (i = 0; i < card->num_aux_devs; i++) {
1399                 ret = soc_probe_aux_dev(card, i);
1400                 if (ret < 0) {
1401                         pr_err("asoc: failed to add auxiliary devices %s: %d\n",
1402                                card->name, ret);
1403                         goto probe_aux_dev_err;
1404                 }
1405         }
1406
1407         /* We should have a non-codec control add function but we don't */
1408         if (card->controls)
1409                 snd_soc_add_controls(list_first_entry(&card->codec_dev_list,
1410                                                       struct snd_soc_codec,
1411                                                       card_list),
1412                                      card->controls,
1413                                      card->num_controls);
1414
1415         if (card->dapm_routes)
1416                 snd_soc_dapm_add_routes(&card->dapm, card->dapm_routes,
1417                                         card->num_dapm_routes);
1418
1419         snprintf(card->snd_card->shortname, sizeof(card->snd_card->shortname),
1420                  "%s", card->name);
1421         snprintf(card->snd_card->longname, sizeof(card->snd_card->longname),
1422                  "%s", card->long_name ? card->long_name : card->name);
1423         snprintf(card->snd_card->driver, sizeof(card->snd_card->driver),
1424                  "%s", card->driver_name ? card->driver_name : card->name);
1425
1426         if (card->late_probe) {
1427                 ret = card->late_probe(card);
1428                 if (ret < 0) {
1429                         dev_err(card->dev, "%s late_probe() failed: %d\n",
1430                                 card->name, ret);
1431                         goto probe_aux_dev_err;
1432                 }
1433         }
1434
1435         ret = snd_card_register(card->snd_card);
1436         if (ret < 0) {
1437                 printk(KERN_ERR "asoc: failed to register soundcard for %s\n", card->name);
1438                 goto probe_aux_dev_err;
1439         }
1440
1441 #ifdef CONFIG_SND_SOC_AC97_BUS
1442         /* register any AC97 codecs */
1443         for (i = 0; i < card->num_rtd; i++) {
1444                 ret = soc_register_ac97_dai_link(&card->rtd[i]);
1445                 if (ret < 0) {
1446                         printk(KERN_ERR "asoc: failed to register AC97 %s\n", card->name);
1447                         while (--i >= 0)
1448                                 soc_unregister_ac97_dai_link(card->rtd[i].codec);
1449                         goto probe_aux_dev_err;
1450                 }
1451         }
1452 #endif
1453
1454         card->instantiated = 1;
1455         mutex_unlock(&card->mutex);
1456         return;
1457
1458 probe_aux_dev_err:
1459         for (i = 0; i < card->num_aux_devs; i++)
1460                 soc_remove_aux_dev(card, i);
1461
1462 probe_dai_err:
1463         soc_remove_dai_links(card);
1464
1465 card_probe_error:
1466         if (card->remove)
1467                 card->remove(card);
1468
1469         snd_card_free(card->snd_card);
1470
1471         mutex_unlock(&card->mutex);
1472 }
1473
1474 /*
1475  * Attempt to initialise any uninitialised cards.  Must be called with
1476  * client_mutex.
1477  */
1478 static void snd_soc_instantiate_cards(void)
1479 {
1480         struct snd_soc_card *card;
1481         list_for_each_entry(card, &card_list, list)
1482                 snd_soc_instantiate_card(card);
1483 }
1484
1485 /* probes a new socdev */
1486 static int soc_probe(struct platform_device *pdev)
1487 {
1488         struct snd_soc_card *card = platform_get_drvdata(pdev);
1489         int ret = 0;
1490
1491         /*
1492          * no card, so machine driver should be registering card
1493          * we should not be here in that case so ret error
1494          */
1495         if (!card)
1496                 return -EINVAL;
1497
1498         /* Bodge while we unpick instantiation */
1499         card->dev = &pdev->dev;
1500
1501         ret = snd_soc_register_card(card);
1502         if (ret != 0) {
1503                 dev_err(&pdev->dev, "Failed to register card\n");
1504                 return ret;
1505         }
1506
1507         return 0;
1508 }
1509
1510 static int soc_cleanup_card_resources(struct snd_soc_card *card)
1511 {
1512         int i;
1513
1514         /* make sure any delayed work runs */
1515         for (i = 0; i < card->num_rtd; i++) {
1516                 struct snd_soc_pcm_runtime *rtd = &card->rtd[i];
1517                 flush_delayed_work_sync(&rtd->delayed_work);
1518         }
1519
1520         /* remove auxiliary devices */
1521         for (i = 0; i < card->num_aux_devs; i++)
1522                 soc_remove_aux_dev(card, i);
1523
1524         /* remove and free each DAI */
1525         soc_remove_dai_links(card);
1526
1527         soc_cleanup_card_debugfs(card);
1528
1529         /* remove the card */
1530         if (card->remove)
1531                 card->remove(card);
1532
1533         snd_soc_dapm_free(&card->dapm);
1534
1535         kfree(card->rtd);
1536         snd_card_free(card->snd_card);
1537         return 0;
1538
1539 }
1540
1541 /* removes a socdev */
1542 static int soc_remove(struct platform_device *pdev)
1543 {
1544         struct snd_soc_card *card = platform_get_drvdata(pdev);
1545
1546         snd_soc_unregister_card(card);
1547         return 0;
1548 }
1549
1550 int snd_soc_poweroff(struct device *dev)
1551 {
1552         struct snd_soc_card *card = dev_get_drvdata(dev);
1553         int i;
1554
1555         if (!card->instantiated)
1556                 return 0;
1557
1558         /* Flush out pmdown_time work - we actually do want to run it
1559          * now, we're shutting down so no imminent restart. */
1560         for (i = 0; i < card->num_rtd; i++) {
1561                 struct snd_soc_pcm_runtime *rtd = &card->rtd[i];
1562                 flush_delayed_work_sync(&rtd->delayed_work);
1563         }
1564
1565         snd_soc_dapm_shutdown(card);
1566
1567         return 0;
1568 }
1569 EXPORT_SYMBOL_GPL(snd_soc_poweroff);
1570
1571 const struct dev_pm_ops snd_soc_pm_ops = {
1572         .suspend = snd_soc_suspend,
1573         .resume = snd_soc_resume,
1574         .poweroff = snd_soc_poweroff,
1575 };
1576 EXPORT_SYMBOL_GPL(snd_soc_pm_ops);
1577
1578 /* ASoC platform driver */
1579 static struct platform_driver soc_driver = {
1580         .driver         = {
1581                 .name           = "soc-audio",
1582                 .owner          = THIS_MODULE,
1583                 .pm             = &snd_soc_pm_ops,
1584         },
1585         .probe          = soc_probe,
1586         .remove         = soc_remove,
1587 };
1588
1589 /**
1590  * snd_soc_codec_volatile_register: Report if a register is volatile.
1591  *
1592  * @codec: CODEC to query.
1593  * @reg: Register to query.
1594  *
1595  * Boolean function indiciating if a CODEC register is volatile.
1596  */
1597 int snd_soc_codec_volatile_register(struct snd_soc_codec *codec,
1598                                     unsigned int reg)
1599 {
1600         if (codec->volatile_register)
1601                 return codec->volatile_register(codec, reg);
1602         else
1603                 return 0;
1604 }
1605 EXPORT_SYMBOL_GPL(snd_soc_codec_volatile_register);
1606
1607 /**
1608  * snd_soc_codec_readable_register: Report if a register is readable.
1609  *
1610  * @codec: CODEC to query.
1611  * @reg: Register to query.
1612  *
1613  * Boolean function indicating if a CODEC register is readable.
1614  */
1615 int snd_soc_codec_readable_register(struct snd_soc_codec *codec,
1616                                     unsigned int reg)
1617 {
1618         if (codec->readable_register)
1619                 return codec->readable_register(codec, reg);
1620         else
1621                 return 0;
1622 }
1623 EXPORT_SYMBOL_GPL(snd_soc_codec_readable_register);
1624
1625 /**
1626  * snd_soc_codec_writable_register: Report if a register is writable.
1627  *
1628  * @codec: CODEC to query.
1629  * @reg: Register to query.
1630  *
1631  * Boolean function indicating if a CODEC register is writable.
1632  */
1633 int snd_soc_codec_writable_register(struct snd_soc_codec *codec,
1634                                     unsigned int reg)
1635 {
1636         if (codec->writable_register)
1637                 return codec->writable_register(codec, reg);
1638         else
1639                 return 0;
1640 }
1641 EXPORT_SYMBOL_GPL(snd_soc_codec_writable_register);
1642
1643 /**
1644  * snd_soc_new_ac97_codec - initailise AC97 device
1645  * @codec: audio codec
1646  * @ops: AC97 bus operations
1647  * @num: AC97 codec number
1648  *
1649  * Initialises AC97 codec resources for use by ad-hoc devices only.
1650  */
1651 int snd_soc_new_ac97_codec(struct snd_soc_codec *codec,
1652         struct snd_ac97_bus_ops *ops, int num)
1653 {
1654         mutex_lock(&codec->mutex);
1655
1656         codec->ac97 = kzalloc(sizeof(struct snd_ac97), GFP_KERNEL);
1657         if (codec->ac97 == NULL) {
1658                 mutex_unlock(&codec->mutex);
1659                 return -ENOMEM;
1660         }
1661
1662         codec->ac97->bus = kzalloc(sizeof(struct snd_ac97_bus), GFP_KERNEL);
1663         if (codec->ac97->bus == NULL) {
1664                 kfree(codec->ac97);
1665                 codec->ac97 = NULL;
1666                 mutex_unlock(&codec->mutex);
1667                 return -ENOMEM;
1668         }
1669
1670         codec->ac97->bus->ops = ops;
1671         codec->ac97->num = num;
1672
1673         /*
1674          * Mark the AC97 device to be created by us. This way we ensure that the
1675          * device will be registered with the device subsystem later on.
1676          */
1677         codec->ac97_created = 1;
1678
1679         mutex_unlock(&codec->mutex);
1680         return 0;
1681 }
1682 EXPORT_SYMBOL_GPL(snd_soc_new_ac97_codec);
1683
1684 /**
1685  * snd_soc_free_ac97_codec - free AC97 codec device
1686  * @codec: audio codec
1687  *
1688  * Frees AC97 codec device resources.
1689  */
1690 void snd_soc_free_ac97_codec(struct snd_soc_codec *codec)
1691 {
1692         mutex_lock(&codec->mutex);
1693 #ifdef CONFIG_SND_SOC_AC97_BUS
1694         soc_unregister_ac97_dai_link(codec);
1695 #endif
1696         kfree(codec->ac97->bus);
1697         kfree(codec->ac97);
1698         codec->ac97 = NULL;
1699         codec->ac97_created = 0;
1700         mutex_unlock(&codec->mutex);
1701 }
1702 EXPORT_SYMBOL_GPL(snd_soc_free_ac97_codec);
1703
1704 unsigned int snd_soc_read(struct snd_soc_codec *codec, unsigned int reg)
1705 {
1706         unsigned int ret;
1707
1708         ret = codec->read(codec, reg);
1709         dev_dbg(codec->dev, "read %x => %x\n", reg, ret);
1710         trace_snd_soc_reg_read(codec, reg, ret);
1711
1712         return ret;
1713 }
1714 EXPORT_SYMBOL_GPL(snd_soc_read);
1715
1716 unsigned int snd_soc_write(struct snd_soc_codec *codec,
1717                            unsigned int reg, unsigned int val)
1718 {
1719         dev_dbg(codec->dev, "write %x = %x\n", reg, val);
1720         trace_snd_soc_reg_write(codec, reg, val);
1721         return codec->write(codec, reg, val);
1722 }
1723 EXPORT_SYMBOL_GPL(snd_soc_write);
1724
1725 unsigned int snd_soc_bulk_write_raw(struct snd_soc_codec *codec,
1726                                     unsigned int reg, const void *data, size_t len)
1727 {
1728         return codec->bulk_write_raw(codec, reg, data, len);
1729 }
1730 EXPORT_SYMBOL_GPL(snd_soc_bulk_write_raw);
1731
1732 /**
1733  * snd_soc_update_bits - update codec register bits
1734  * @codec: audio codec
1735  * @reg: codec register
1736  * @mask: register mask
1737  * @value: new value
1738  *
1739  * Writes new register value.
1740  *
1741  * Returns 1 for change, 0 for no change, or negative error code.
1742  */
1743 int snd_soc_update_bits(struct snd_soc_codec *codec, unsigned short reg,
1744                                 unsigned int mask, unsigned int value)
1745 {
1746         int change;
1747         unsigned int old, new;
1748         int ret;
1749
1750         ret = snd_soc_read(codec, reg);
1751         if (ret < 0)
1752                 return ret;
1753
1754         old = ret;
1755         new = (old & ~mask) | (value & mask);
1756         change = old != new;
1757         if (change) {
1758                 ret = snd_soc_write(codec, reg, new);
1759                 if (ret < 0)
1760                         return ret;
1761         }
1762
1763         return change;
1764 }
1765 EXPORT_SYMBOL_GPL(snd_soc_update_bits);
1766
1767 /**
1768  * snd_soc_update_bits_locked - update codec register bits
1769  * @codec: audio codec
1770  * @reg: codec register
1771  * @mask: register mask
1772  * @value: new value
1773  *
1774  * Writes new register value, and takes the codec mutex.
1775  *
1776  * Returns 1 for change else 0.
1777  */
1778 int snd_soc_update_bits_locked(struct snd_soc_codec *codec,
1779                                unsigned short reg, unsigned int mask,
1780                                unsigned int value)
1781 {
1782         int change;
1783
1784         mutex_lock(&codec->mutex);
1785         change = snd_soc_update_bits(codec, reg, mask, value);
1786         mutex_unlock(&codec->mutex);
1787
1788         return change;
1789 }
1790 EXPORT_SYMBOL_GPL(snd_soc_update_bits_locked);
1791
1792 /**
1793  * snd_soc_test_bits - test register for change
1794  * @codec: audio codec
1795  * @reg: codec register
1796  * @mask: register mask
1797  * @value: new value
1798  *
1799  * Tests a register with a new value and checks if the new value is
1800  * different from the old value.
1801  *
1802  * Returns 1 for change else 0.
1803  */
1804 int snd_soc_test_bits(struct snd_soc_codec *codec, unsigned short reg,
1805                                 unsigned int mask, unsigned int value)
1806 {
1807         int change;
1808         unsigned int old, new;
1809
1810         old = snd_soc_read(codec, reg);
1811         new = (old & ~mask) | value;
1812         change = old != new;
1813
1814         return change;
1815 }
1816 EXPORT_SYMBOL_GPL(snd_soc_test_bits);
1817
1818 /**
1819  * snd_soc_set_runtime_hwparams - set the runtime hardware parameters
1820  * @substream: the pcm substream
1821  * @hw: the hardware parameters
1822  *
1823  * Sets the substream runtime hardware parameters.
1824  */
1825 int snd_soc_set_runtime_hwparams(struct snd_pcm_substream *substream,
1826         const struct snd_pcm_hardware *hw)
1827 {
1828         struct snd_pcm_runtime *runtime = substream->runtime;
1829         runtime->hw.info = hw->info;
1830         runtime->hw.formats = hw->formats;
1831         runtime->hw.period_bytes_min = hw->period_bytes_min;
1832         runtime->hw.period_bytes_max = hw->period_bytes_max;
1833         runtime->hw.periods_min = hw->periods_min;
1834         runtime->hw.periods_max = hw->periods_max;
1835         runtime->hw.buffer_bytes_max = hw->buffer_bytes_max;
1836         runtime->hw.fifo_size = hw->fifo_size;
1837         return 0;
1838 }
1839 EXPORT_SYMBOL_GPL(snd_soc_set_runtime_hwparams);
1840
1841 /**
1842  * snd_soc_cnew - create new control
1843  * @_template: control template
1844  * @data: control private data
1845  * @long_name: control long name
1846  * @prefix: control name prefix
1847  *
1848  * Create a new mixer control from a template control.
1849  *
1850  * Returns 0 for success, else error.
1851  */
1852 struct snd_kcontrol *snd_soc_cnew(const struct snd_kcontrol_new *_template,
1853                                   void *data, char *long_name,
1854                                   const char *prefix)
1855 {
1856         struct snd_kcontrol_new template;
1857         struct snd_kcontrol *kcontrol;
1858         char *name = NULL;
1859         int name_len;
1860
1861         memcpy(&template, _template, sizeof(template));
1862         template.index = 0;
1863
1864         if (!long_name)
1865                 long_name = template.name;
1866
1867         if (prefix) {
1868                 name_len = strlen(long_name) + strlen(prefix) + 2;
1869                 name = kmalloc(name_len, GFP_ATOMIC);
1870                 if (!name)
1871                         return NULL;
1872
1873                 snprintf(name, name_len, "%s %s", prefix, long_name);
1874
1875                 template.name = name;
1876         } else {
1877                 template.name = long_name;
1878         }
1879
1880         kcontrol = snd_ctl_new1(&template, data);
1881
1882         kfree(name);
1883
1884         return kcontrol;
1885 }
1886 EXPORT_SYMBOL_GPL(snd_soc_cnew);
1887
1888 /**
1889  * snd_soc_add_controls - add an array of controls to a codec.
1890  * Convienience function to add a list of controls. Many codecs were
1891  * duplicating this code.
1892  *
1893  * @codec: codec to add controls to
1894  * @controls: array of controls to add
1895  * @num_controls: number of elements in the array
1896  *
1897  * Return 0 for success, else error.
1898  */
1899 int snd_soc_add_controls(struct snd_soc_codec *codec,
1900         const struct snd_kcontrol_new *controls, int num_controls)
1901 {
1902         struct snd_card *card = codec->card->snd_card;
1903         int err, i;
1904
1905         for (i = 0; i < num_controls; i++) {
1906                 const struct snd_kcontrol_new *control = &controls[i];
1907                 err = snd_ctl_add(card, snd_soc_cnew(control, codec,
1908                                                      control->name,
1909                                                      codec->name_prefix));
1910                 if (err < 0) {
1911                         dev_err(codec->dev, "%s: Failed to add %s: %d\n",
1912                                 codec->name, control->name, err);
1913                         return err;
1914                 }
1915         }
1916
1917         return 0;
1918 }
1919 EXPORT_SYMBOL_GPL(snd_soc_add_controls);
1920
1921 /**
1922  * snd_soc_info_enum_double - enumerated double mixer info callback
1923  * @kcontrol: mixer control
1924  * @uinfo: control element information
1925  *
1926  * Callback to provide information about a double enumerated
1927  * mixer control.
1928  *
1929  * Returns 0 for success.
1930  */
1931 int snd_soc_info_enum_double(struct snd_kcontrol *kcontrol,
1932         struct snd_ctl_elem_info *uinfo)
1933 {
1934         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1935
1936         uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
1937         uinfo->count = e->shift_l == e->shift_r ? 1 : 2;
1938         uinfo->value.enumerated.items = e->max;
1939
1940         if (uinfo->value.enumerated.item > e->max - 1)
1941                 uinfo->value.enumerated.item = e->max - 1;
1942         strcpy(uinfo->value.enumerated.name,
1943                 e->texts[uinfo->value.enumerated.item]);
1944         return 0;
1945 }
1946 EXPORT_SYMBOL_GPL(snd_soc_info_enum_double);
1947
1948 /**
1949  * snd_soc_get_enum_double - enumerated double mixer get callback
1950  * @kcontrol: mixer control
1951  * @ucontrol: control element information
1952  *
1953  * Callback to get the value of a double enumerated mixer.
1954  *
1955  * Returns 0 for success.
1956  */
1957 int snd_soc_get_enum_double(struct snd_kcontrol *kcontrol,
1958         struct snd_ctl_elem_value *ucontrol)
1959 {
1960         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1961         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1962         unsigned int val, bitmask;
1963
1964         for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
1965                 ;
1966         val = snd_soc_read(codec, e->reg);
1967         ucontrol->value.enumerated.item[0]
1968                 = (val >> e->shift_l) & (bitmask - 1);
1969         if (e->shift_l != e->shift_r)
1970                 ucontrol->value.enumerated.item[1] =
1971                         (val >> e->shift_r) & (bitmask - 1);
1972
1973         return 0;
1974 }
1975 EXPORT_SYMBOL_GPL(snd_soc_get_enum_double);
1976
1977 /**
1978  * snd_soc_put_enum_double - enumerated double mixer put callback
1979  * @kcontrol: mixer control
1980  * @ucontrol: control element information
1981  *
1982  * Callback to set the value of a double enumerated mixer.
1983  *
1984  * Returns 0 for success.
1985  */
1986 int snd_soc_put_enum_double(struct snd_kcontrol *kcontrol,
1987         struct snd_ctl_elem_value *ucontrol)
1988 {
1989         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
1990         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
1991         unsigned int val;
1992         unsigned int mask, bitmask;
1993
1994         for (bitmask = 1; bitmask < e->max; bitmask <<= 1)
1995                 ;
1996         if (ucontrol->value.enumerated.item[0] > e->max - 1)
1997                 return -EINVAL;
1998         val = ucontrol->value.enumerated.item[0] << e->shift_l;
1999         mask = (bitmask - 1) << e->shift_l;
2000         if (e->shift_l != e->shift_r) {
2001                 if (ucontrol->value.enumerated.item[1] > e->max - 1)
2002                         return -EINVAL;
2003                 val |= ucontrol->value.enumerated.item[1] << e->shift_r;
2004                 mask |= (bitmask - 1) << e->shift_r;
2005         }
2006
2007         return snd_soc_update_bits_locked(codec, e->reg, mask, val);
2008 }
2009 EXPORT_SYMBOL_GPL(snd_soc_put_enum_double);
2010
2011 /**
2012  * snd_soc_get_value_enum_double - semi enumerated double mixer get callback
2013  * @kcontrol: mixer control
2014  * @ucontrol: control element information
2015  *
2016  * Callback to get the value of a double semi enumerated mixer.
2017  *
2018  * Semi enumerated mixer: the enumerated items are referred as values. Can be
2019  * used for handling bitfield coded enumeration for example.
2020  *
2021  * Returns 0 for success.
2022  */
2023 int snd_soc_get_value_enum_double(struct snd_kcontrol *kcontrol,
2024         struct snd_ctl_elem_value *ucontrol)
2025 {
2026         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2027         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2028         unsigned int reg_val, val, mux;
2029
2030         reg_val = snd_soc_read(codec, e->reg);
2031         val = (reg_val >> e->shift_l) & e->mask;
2032         for (mux = 0; mux < e->max; mux++) {
2033                 if (val == e->values[mux])
2034                         break;
2035         }
2036         ucontrol->value.enumerated.item[0] = mux;
2037         if (e->shift_l != e->shift_r) {
2038                 val = (reg_val >> e->shift_r) & e->mask;
2039                 for (mux = 0; mux < e->max; mux++) {
2040                         if (val == e->values[mux])
2041                                 break;
2042                 }
2043                 ucontrol->value.enumerated.item[1] = mux;
2044         }
2045
2046         return 0;
2047 }
2048 EXPORT_SYMBOL_GPL(snd_soc_get_value_enum_double);
2049
2050 /**
2051  * snd_soc_put_value_enum_double - semi enumerated double mixer put callback
2052  * @kcontrol: mixer control
2053  * @ucontrol: control element information
2054  *
2055  * Callback to set the value of a double semi enumerated mixer.
2056  *
2057  * Semi enumerated mixer: the enumerated items are referred as values. Can be
2058  * used for handling bitfield coded enumeration for example.
2059  *
2060  * Returns 0 for success.
2061  */
2062 int snd_soc_put_value_enum_double(struct snd_kcontrol *kcontrol,
2063         struct snd_ctl_elem_value *ucontrol)
2064 {
2065         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2066         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2067         unsigned int val;
2068         unsigned int mask;
2069
2070         if (ucontrol->value.enumerated.item[0] > e->max - 1)
2071                 return -EINVAL;
2072         val = e->values[ucontrol->value.enumerated.item[0]] << e->shift_l;
2073         mask = e->mask << e->shift_l;
2074         if (e->shift_l != e->shift_r) {
2075                 if (ucontrol->value.enumerated.item[1] > e->max - 1)
2076                         return -EINVAL;
2077                 val |= e->values[ucontrol->value.enumerated.item[1]] << e->shift_r;
2078                 mask |= e->mask << e->shift_r;
2079         }
2080
2081         return snd_soc_update_bits_locked(codec, e->reg, mask, val);
2082 }
2083 EXPORT_SYMBOL_GPL(snd_soc_put_value_enum_double);
2084
2085 /**
2086  * snd_soc_info_enum_ext - external enumerated single mixer info callback
2087  * @kcontrol: mixer control
2088  * @uinfo: control element information
2089  *
2090  * Callback to provide information about an external enumerated
2091  * single mixer.
2092  *
2093  * Returns 0 for success.
2094  */
2095 int snd_soc_info_enum_ext(struct snd_kcontrol *kcontrol,
2096         struct snd_ctl_elem_info *uinfo)
2097 {
2098         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2099
2100         uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
2101         uinfo->count = 1;
2102         uinfo->value.enumerated.items = e->max;
2103
2104         if (uinfo->value.enumerated.item > e->max - 1)
2105                 uinfo->value.enumerated.item = e->max - 1;
2106         strcpy(uinfo->value.enumerated.name,
2107                 e->texts[uinfo->value.enumerated.item]);
2108         return 0;
2109 }
2110 EXPORT_SYMBOL_GPL(snd_soc_info_enum_ext);
2111
2112 /**
2113  * snd_soc_info_volsw_ext - external single mixer info callback
2114  * @kcontrol: mixer control
2115  * @uinfo: control element information
2116  *
2117  * Callback to provide information about a single external mixer control.
2118  *
2119  * Returns 0 for success.
2120  */
2121 int snd_soc_info_volsw_ext(struct snd_kcontrol *kcontrol,
2122         struct snd_ctl_elem_info *uinfo)
2123 {
2124         int max = kcontrol->private_value;
2125
2126         if (max == 1 && !strstr(kcontrol->id.name, " Volume"))
2127                 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
2128         else
2129                 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
2130
2131         uinfo->count = 1;
2132         uinfo->value.integer.min = 0;
2133         uinfo->value.integer.max = max;
2134         return 0;
2135 }
2136 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_ext);
2137
2138 /**
2139  * snd_soc_info_volsw - single mixer info callback
2140  * @kcontrol: mixer control
2141  * @uinfo: control element information
2142  *
2143  * Callback to provide information about a single mixer control.
2144  *
2145  * Returns 0 for success.
2146  */
2147 int snd_soc_info_volsw(struct snd_kcontrol *kcontrol,
2148         struct snd_ctl_elem_info *uinfo)
2149 {
2150         struct soc_mixer_control *mc =
2151                 (struct soc_mixer_control *)kcontrol->private_value;
2152         int platform_max;
2153         unsigned int shift = mc->shift;
2154         unsigned int rshift = mc->rshift;
2155
2156         if (!mc->platform_max)
2157                 mc->platform_max = mc->max;
2158         platform_max = mc->platform_max;
2159
2160         if (platform_max == 1 && !strstr(kcontrol->id.name, " Volume"))
2161                 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
2162         else
2163                 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
2164
2165         uinfo->count = shift == rshift ? 1 : 2;
2166         uinfo->value.integer.min = 0;
2167         uinfo->value.integer.max = platform_max;
2168         return 0;
2169 }
2170 EXPORT_SYMBOL_GPL(snd_soc_info_volsw);
2171
2172 /**
2173  * snd_soc_get_volsw - single mixer get callback
2174  * @kcontrol: mixer control
2175  * @ucontrol: control element information
2176  *
2177  * Callback to get the value of a single mixer control.
2178  *
2179  * Returns 0 for success.
2180  */
2181 int snd_soc_get_volsw(struct snd_kcontrol *kcontrol,
2182         struct snd_ctl_elem_value *ucontrol)
2183 {
2184         struct soc_mixer_control *mc =
2185                 (struct soc_mixer_control *)kcontrol->private_value;
2186         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2187         unsigned int reg = mc->reg;
2188         unsigned int shift = mc->shift;
2189         unsigned int rshift = mc->rshift;
2190         int max = mc->max;
2191         unsigned int mask = (1 << fls(max)) - 1;
2192         unsigned int invert = mc->invert;
2193
2194         ucontrol->value.integer.value[0] =
2195                 (snd_soc_read(codec, reg) >> shift) & mask;
2196         if (shift != rshift)
2197                 ucontrol->value.integer.value[1] =
2198                         (snd_soc_read(codec, reg) >> rshift) & mask;
2199         if (invert) {
2200                 ucontrol->value.integer.value[0] =
2201                         max - ucontrol->value.integer.value[0];
2202                 if (shift != rshift)
2203                         ucontrol->value.integer.value[1] =
2204                                 max - ucontrol->value.integer.value[1];
2205         }
2206
2207         return 0;
2208 }
2209 EXPORT_SYMBOL_GPL(snd_soc_get_volsw);
2210
2211 /**
2212  * snd_soc_put_volsw - single mixer put callback
2213  * @kcontrol: mixer control
2214  * @ucontrol: control element information
2215  *
2216  * Callback to set the value of a single mixer control.
2217  *
2218  * Returns 0 for success.
2219  */
2220 int snd_soc_put_volsw(struct snd_kcontrol *kcontrol,
2221         struct snd_ctl_elem_value *ucontrol)
2222 {
2223         struct soc_mixer_control *mc =
2224                 (struct soc_mixer_control *)kcontrol->private_value;
2225         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2226         unsigned int reg = mc->reg;
2227         unsigned int shift = mc->shift;
2228         unsigned int rshift = mc->rshift;
2229         int max = mc->max;
2230         unsigned int mask = (1 << fls(max)) - 1;
2231         unsigned int invert = mc->invert;
2232         unsigned int val, val2, val_mask;
2233
2234         val = (ucontrol->value.integer.value[0] & mask);
2235         if (invert)
2236                 val = max - val;
2237         val_mask = mask << shift;
2238         val = val << shift;
2239         if (shift != rshift) {
2240                 val2 = (ucontrol->value.integer.value[1] & mask);
2241                 if (invert)
2242                         val2 = max - val2;
2243                 val_mask |= mask << rshift;
2244                 val |= val2 << rshift;
2245         }
2246         return snd_soc_update_bits_locked(codec, reg, val_mask, val);
2247 }
2248 EXPORT_SYMBOL_GPL(snd_soc_put_volsw);
2249
2250 /**
2251  * snd_soc_info_volsw_2r - double mixer info callback
2252  * @kcontrol: mixer control
2253  * @uinfo: control element information
2254  *
2255  * Callback to provide information about a double mixer control that
2256  * spans 2 codec registers.
2257  *
2258  * Returns 0 for success.
2259  */
2260 int snd_soc_info_volsw_2r(struct snd_kcontrol *kcontrol,
2261         struct snd_ctl_elem_info *uinfo)
2262 {
2263         struct soc_mixer_control *mc =
2264                 (struct soc_mixer_control *)kcontrol->private_value;
2265         int platform_max;
2266
2267         if (!mc->platform_max)
2268                 mc->platform_max = mc->max;
2269         platform_max = mc->platform_max;
2270
2271         if (platform_max == 1 && !strstr(kcontrol->id.name, " Volume"))
2272                 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
2273         else
2274                 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
2275
2276         uinfo->count = 2;
2277         uinfo->value.integer.min = 0;
2278         uinfo->value.integer.max = platform_max;
2279         return 0;
2280 }
2281 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_2r);
2282
2283 /**
2284  * snd_soc_get_volsw_2r - double mixer get callback
2285  * @kcontrol: mixer control
2286  * @ucontrol: control element information
2287  *
2288  * Callback to get the value of a double mixer control that spans 2 registers.
2289  *
2290  * Returns 0 for success.
2291  */
2292 int snd_soc_get_volsw_2r(struct snd_kcontrol *kcontrol,
2293         struct snd_ctl_elem_value *ucontrol)
2294 {
2295         struct soc_mixer_control *mc =
2296                 (struct soc_mixer_control *)kcontrol->private_value;
2297         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2298         unsigned int reg = mc->reg;
2299         unsigned int reg2 = mc->rreg;
2300         unsigned int shift = mc->shift;
2301         int max = mc->max;
2302         unsigned int mask = (1 << fls(max)) - 1;
2303         unsigned int invert = mc->invert;
2304
2305         ucontrol->value.integer.value[0] =
2306                 (snd_soc_read(codec, reg) >> shift) & mask;
2307         ucontrol->value.integer.value[1] =
2308                 (snd_soc_read(codec, reg2) >> shift) & mask;
2309         if (invert) {
2310                 ucontrol->value.integer.value[0] =
2311                         max - ucontrol->value.integer.value[0];
2312                 ucontrol->value.integer.value[1] =
2313                         max - ucontrol->value.integer.value[1];
2314         }
2315
2316         return 0;
2317 }
2318 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_2r);
2319
2320 /**
2321  * snd_soc_put_volsw_2r - double mixer set callback
2322  * @kcontrol: mixer control
2323  * @ucontrol: control element information
2324  *
2325  * Callback to set the value of a double mixer control that spans 2 registers.
2326  *
2327  * Returns 0 for success.
2328  */
2329 int snd_soc_put_volsw_2r(struct snd_kcontrol *kcontrol,
2330         struct snd_ctl_elem_value *ucontrol)
2331 {
2332         struct soc_mixer_control *mc =
2333                 (struct soc_mixer_control *)kcontrol->private_value;
2334         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2335         unsigned int reg = mc->reg;
2336         unsigned int reg2 = mc->rreg;
2337         unsigned int shift = mc->shift;
2338         int max = mc->max;
2339         unsigned int mask = (1 << fls(max)) - 1;
2340         unsigned int invert = mc->invert;
2341         int err;
2342         unsigned int val, val2, val_mask;
2343
2344         val_mask = mask << shift;
2345         val = (ucontrol->value.integer.value[0] & mask);
2346         val2 = (ucontrol->value.integer.value[1] & mask);
2347
2348         if (invert) {
2349                 val = max - val;
2350                 val2 = max - val2;
2351         }
2352
2353         val = val << shift;
2354         val2 = val2 << shift;
2355
2356         err = snd_soc_update_bits_locked(codec, reg, val_mask, val);
2357         if (err < 0)
2358                 return err;
2359
2360         err = snd_soc_update_bits_locked(codec, reg2, val_mask, val2);
2361         return err;
2362 }
2363 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_2r);
2364
2365 /**
2366  * snd_soc_info_volsw_s8 - signed mixer info callback
2367  * @kcontrol: mixer control
2368  * @uinfo: control element information
2369  *
2370  * Callback to provide information about a signed mixer control.
2371  *
2372  * Returns 0 for success.
2373  */
2374 int snd_soc_info_volsw_s8(struct snd_kcontrol *kcontrol,
2375         struct snd_ctl_elem_info *uinfo)
2376 {
2377         struct soc_mixer_control *mc =
2378                 (struct soc_mixer_control *)kcontrol->private_value;
2379         int platform_max;
2380         int min = mc->min;
2381
2382         if (!mc->platform_max)
2383                 mc->platform_max = mc->max;
2384         platform_max = mc->platform_max;
2385
2386         uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
2387         uinfo->count = 2;
2388         uinfo->value.integer.min = 0;
2389         uinfo->value.integer.max = platform_max - min;
2390         return 0;
2391 }
2392 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_s8);
2393
2394 /**
2395  * snd_soc_get_volsw_s8 - signed mixer get callback
2396  * @kcontrol: mixer control
2397  * @ucontrol: control element information
2398  *
2399  * Callback to get the value of a signed mixer control.
2400  *
2401  * Returns 0 for success.
2402  */
2403 int snd_soc_get_volsw_s8(struct snd_kcontrol *kcontrol,
2404         struct snd_ctl_elem_value *ucontrol)
2405 {
2406         struct soc_mixer_control *mc =
2407                 (struct soc_mixer_control *)kcontrol->private_value;
2408         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2409         unsigned int reg = mc->reg;
2410         int min = mc->min;
2411         int val = snd_soc_read(codec, reg);
2412
2413         ucontrol->value.integer.value[0] =
2414                 ((signed char)(val & 0xff))-min;
2415         ucontrol->value.integer.value[1] =
2416                 ((signed char)((val >> 8) & 0xff))-min;
2417         return 0;
2418 }
2419 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_s8);
2420
2421 /**
2422  * snd_soc_put_volsw_sgn - signed mixer put callback
2423  * @kcontrol: mixer control
2424  * @ucontrol: control element information
2425  *
2426  * Callback to set the value of a signed mixer control.
2427  *
2428  * Returns 0 for success.
2429  */
2430 int snd_soc_put_volsw_s8(struct snd_kcontrol *kcontrol,
2431         struct snd_ctl_elem_value *ucontrol)
2432 {
2433         struct soc_mixer_control *mc =
2434                 (struct soc_mixer_control *)kcontrol->private_value;
2435         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2436         unsigned int reg = mc->reg;
2437         int min = mc->min;
2438         unsigned int val;
2439
2440         val = (ucontrol->value.integer.value[0]+min) & 0xff;
2441         val |= ((ucontrol->value.integer.value[1]+min) & 0xff) << 8;
2442
2443         return snd_soc_update_bits_locked(codec, reg, 0xffff, val);
2444 }
2445 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_s8);
2446
2447 /**
2448  * snd_soc_limit_volume - Set new limit to an existing volume control.
2449  *
2450  * @codec: where to look for the control
2451  * @name: Name of the control
2452  * @max: new maximum limit
2453  *
2454  * Return 0 for success, else error.
2455  */
2456 int snd_soc_limit_volume(struct snd_soc_codec *codec,
2457         const char *name, int max)
2458 {
2459         struct snd_card *card = codec->card->snd_card;
2460         struct snd_kcontrol *kctl;
2461         struct soc_mixer_control *mc;
2462         int found = 0;
2463         int ret = -EINVAL;
2464
2465         /* Sanity check for name and max */
2466         if (unlikely(!name || max <= 0))
2467                 return -EINVAL;
2468
2469         list_for_each_entry(kctl, &card->controls, list) {
2470                 if (!strncmp(kctl->id.name, name, sizeof(kctl->id.name))) {
2471                         found = 1;
2472                         break;
2473                 }
2474         }
2475         if (found) {
2476                 mc = (struct soc_mixer_control *)kctl->private_value;
2477                 if (max <= mc->max) {
2478                         mc->platform_max = max;
2479                         ret = 0;
2480                 }
2481         }
2482         return ret;
2483 }
2484 EXPORT_SYMBOL_GPL(snd_soc_limit_volume);
2485
2486 /**
2487  * snd_soc_info_volsw_2r_sx - double with tlv and variable data size
2488  *  mixer info callback
2489  * @kcontrol: mixer control
2490  * @uinfo: control element information
2491  *
2492  * Returns 0 for success.
2493  */
2494 int snd_soc_info_volsw_2r_sx(struct snd_kcontrol *kcontrol,
2495                         struct snd_ctl_elem_info *uinfo)
2496 {
2497         struct soc_mixer_control *mc =
2498                 (struct soc_mixer_control *)kcontrol->private_value;
2499         int max = mc->max;
2500         int min = mc->min;
2501
2502         uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
2503         uinfo->count = 2;
2504         uinfo->value.integer.min = 0;
2505         uinfo->value.integer.max = max-min;
2506
2507         return 0;
2508 }
2509 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_2r_sx);
2510
2511 /**
2512  * snd_soc_get_volsw_2r_sx - double with tlv and variable data size
2513  *  mixer get callback
2514  * @kcontrol: mixer control
2515  * @uinfo: control element information
2516  *
2517  * Returns 0 for success.
2518  */
2519 int snd_soc_get_volsw_2r_sx(struct snd_kcontrol *kcontrol,
2520                         struct snd_ctl_elem_value *ucontrol)
2521 {
2522         struct soc_mixer_control *mc =
2523                 (struct soc_mixer_control *)kcontrol->private_value;
2524         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2525         unsigned int mask = (1<<mc->shift)-1;
2526         int min = mc->min;
2527         int val = snd_soc_read(codec, mc->reg) & mask;
2528         int valr = snd_soc_read(codec, mc->rreg) & mask;
2529
2530         ucontrol->value.integer.value[0] = ((val & 0xff)-min) & mask;
2531         ucontrol->value.integer.value[1] = ((valr & 0xff)-min) & mask;
2532         return 0;
2533 }
2534 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_2r_sx);
2535
2536 /**
2537  * snd_soc_put_volsw_2r_sx - double with tlv and variable data size
2538  *  mixer put callback
2539  * @kcontrol: mixer control
2540  * @uinfo: control element information
2541  *
2542  * Returns 0 for success.
2543  */
2544 int snd_soc_put_volsw_2r_sx(struct snd_kcontrol *kcontrol,
2545                         struct snd_ctl_elem_value *ucontrol)
2546 {
2547         struct soc_mixer_control *mc =
2548                 (struct soc_mixer_control *)kcontrol->private_value;
2549         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2550         unsigned int mask = (1<<mc->shift)-1;
2551         int min = mc->min;
2552         int ret;
2553         unsigned int val, valr, oval, ovalr;
2554
2555         val = ((ucontrol->value.integer.value[0]+min) & 0xff);
2556         val &= mask;
2557         valr = ((ucontrol->value.integer.value[1]+min) & 0xff);
2558         valr &= mask;
2559
2560         oval = snd_soc_read(codec, mc->reg) & mask;
2561         ovalr = snd_soc_read(codec, mc->rreg) & mask;
2562
2563         ret = 0;
2564         if (oval != val) {
2565                 ret = snd_soc_write(codec, mc->reg, val);
2566                 if (ret < 0)
2567                         return ret;
2568         }
2569         if (ovalr != valr) {
2570                 ret = snd_soc_write(codec, mc->rreg, valr);
2571                 if (ret < 0)
2572                         return ret;
2573         }
2574
2575         return 0;
2576 }
2577 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_2r_sx);
2578
2579 /**
2580  * snd_soc_dai_set_sysclk - configure DAI system or master clock.
2581  * @dai: DAI
2582  * @clk_id: DAI specific clock ID
2583  * @freq: new clock frequency in Hz
2584  * @dir: new clock direction - input/output.
2585  *
2586  * Configures the DAI master (MCLK) or system (SYSCLK) clocking.
2587  */
2588 int snd_soc_dai_set_sysclk(struct snd_soc_dai *dai, int clk_id,
2589         unsigned int freq, int dir)
2590 {
2591         if (dai->driver && dai->driver->ops->set_sysclk)
2592                 return dai->driver->ops->set_sysclk(dai, clk_id, freq, dir);
2593         else if (dai->codec && dai->codec->driver->set_sysclk)
2594                 return dai->codec->driver->set_sysclk(dai->codec, clk_id,
2595                                                       freq, dir);
2596         else
2597                 return -EINVAL;
2598 }
2599 EXPORT_SYMBOL_GPL(snd_soc_dai_set_sysclk);
2600
2601 /**
2602  * snd_soc_codec_set_sysclk - configure CODEC system or master clock.
2603  * @codec: CODEC
2604  * @clk_id: DAI specific clock ID
2605  * @freq: new clock frequency in Hz
2606  * @dir: new clock direction - input/output.
2607  *
2608  * Configures the CODEC master (MCLK) or system (SYSCLK) clocking.
2609  */
2610 int snd_soc_codec_set_sysclk(struct snd_soc_codec *codec, int clk_id,
2611         unsigned int freq, int dir)
2612 {
2613         if (codec->driver->set_sysclk)
2614                 return codec->driver->set_sysclk(codec, clk_id, freq, dir);
2615         else
2616                 return -EINVAL;
2617 }
2618 EXPORT_SYMBOL_GPL(snd_soc_codec_set_sysclk);
2619
2620 /**
2621  * snd_soc_dai_set_clkdiv - configure DAI clock dividers.
2622  * @dai: DAI
2623  * @div_id: DAI specific clock divider ID
2624  * @div: new clock divisor.
2625  *
2626  * Configures the clock dividers. This is used to derive the best DAI bit and
2627  * frame clocks from the system or master clock. It's best to set the DAI bit
2628  * and frame clocks as low as possible to save system power.
2629  */
2630 int snd_soc_dai_set_clkdiv(struct snd_soc_dai *dai,
2631         int div_id, int div)
2632 {
2633         if (dai->driver && dai->driver->ops->set_clkdiv)
2634                 return dai->driver->ops->set_clkdiv(dai, div_id, div);
2635         else
2636                 return -EINVAL;
2637 }
2638 EXPORT_SYMBOL_GPL(snd_soc_dai_set_clkdiv);
2639
2640 /**
2641  * snd_soc_dai_set_pll - configure DAI PLL.
2642  * @dai: DAI
2643  * @pll_id: DAI specific PLL ID
2644  * @source: DAI specific source for the PLL
2645  * @freq_in: PLL input clock frequency in Hz
2646  * @freq_out: requested PLL output clock frequency in Hz
2647  *
2648  * Configures and enables PLL to generate output clock based on input clock.
2649  */
2650 int snd_soc_dai_set_pll(struct snd_soc_dai *dai, int pll_id, int source,
2651         unsigned int freq_in, unsigned int freq_out)
2652 {
2653         if (dai->driver && dai->driver->ops->set_pll)
2654                 return dai->driver->ops->set_pll(dai, pll_id, source,
2655                                          freq_in, freq_out);
2656         else if (dai->codec && dai->codec->driver->set_pll)
2657                 return dai->codec->driver->set_pll(dai->codec, pll_id, source,
2658                                                    freq_in, freq_out);
2659         else
2660                 return -EINVAL;
2661 }
2662 EXPORT_SYMBOL_GPL(snd_soc_dai_set_pll);
2663
2664 /*
2665  * snd_soc_codec_set_pll - configure codec PLL.
2666  * @codec: CODEC
2667  * @pll_id: DAI specific PLL ID
2668  * @source: DAI specific source for the PLL
2669  * @freq_in: PLL input clock frequency in Hz
2670  * @freq_out: requested PLL output clock frequency in Hz
2671  *
2672  * Configures and enables PLL to generate output clock based on input clock.
2673  */
2674 int snd_soc_codec_set_pll(struct snd_soc_codec *codec, int pll_id, int source,
2675                           unsigned int freq_in, unsigned int freq_out)
2676 {
2677         if (codec->driver->set_pll)
2678                 return codec->driver->set_pll(codec, pll_id, source,
2679                                               freq_in, freq_out);
2680         else
2681                 return -EINVAL;
2682 }
2683 EXPORT_SYMBOL_GPL(snd_soc_codec_set_pll);
2684
2685 /**
2686  * snd_soc_dai_set_fmt - configure DAI hardware audio format.
2687  * @dai: DAI
2688  * @fmt: SND_SOC_DAIFMT_ format value.
2689  *
2690  * Configures the DAI hardware format and clocking.
2691  */
2692 int snd_soc_dai_set_fmt(struct snd_soc_dai *dai, unsigned int fmt)
2693 {
2694         if (dai->driver && dai->driver->ops->set_fmt)
2695                 return dai->driver->ops->set_fmt(dai, fmt);
2696         else
2697                 return -EINVAL;
2698 }
2699 EXPORT_SYMBOL_GPL(snd_soc_dai_set_fmt);
2700
2701 /**
2702  * snd_soc_dai_set_tdm_slot - configure DAI TDM.
2703  * @dai: DAI
2704  * @tx_mask: bitmask representing active TX slots.
2705  * @rx_mask: bitmask representing active RX slots.
2706  * @slots: Number of slots in use.
2707  * @slot_width: Width in bits for each slot.
2708  *
2709  * Configures a DAI for TDM operation. Both mask and slots are codec and DAI
2710  * specific.
2711  */
2712 int snd_soc_dai_set_tdm_slot(struct snd_soc_dai *dai,
2713         unsigned int tx_mask, unsigned int rx_mask, int slots, int slot_width)
2714 {
2715         if (dai->driver && dai->driver->ops->set_tdm_slot)
2716                 return dai->driver->ops->set_tdm_slot(dai, tx_mask, rx_mask,
2717                                 slots, slot_width);
2718         else
2719                 return -EINVAL;
2720 }
2721 EXPORT_SYMBOL_GPL(snd_soc_dai_set_tdm_slot);
2722
2723 /**
2724  * snd_soc_dai_set_channel_map - configure DAI audio channel map
2725  * @dai: DAI
2726  * @tx_num: how many TX channels
2727  * @tx_slot: pointer to an array which imply the TX slot number channel
2728  *           0~num-1 uses
2729  * @rx_num: how many RX channels
2730  * @rx_slot: pointer to an array which imply the RX slot number channel
2731  *           0~num-1 uses
2732  *
2733  * configure the relationship between channel number and TDM slot number.
2734  */
2735 int snd_soc_dai_set_channel_map(struct snd_soc_dai *dai,
2736         unsigned int tx_num, unsigned int *tx_slot,
2737         unsigned int rx_num, unsigned int *rx_slot)
2738 {
2739         if (dai->driver && dai->driver->ops->set_channel_map)
2740                 return dai->driver->ops->set_channel_map(dai, tx_num, tx_slot,
2741                         rx_num, rx_slot);
2742         else
2743                 return -EINVAL;
2744 }
2745 EXPORT_SYMBOL_GPL(snd_soc_dai_set_channel_map);
2746
2747 /**
2748  * snd_soc_dai_set_tristate - configure DAI system or master clock.
2749  * @dai: DAI
2750  * @tristate: tristate enable
2751  *
2752  * Tristates the DAI so that others can use it.
2753  */
2754 int snd_soc_dai_set_tristate(struct snd_soc_dai *dai, int tristate)
2755 {
2756         if (dai->driver && dai->driver->ops->set_tristate)
2757                 return dai->driver->ops->set_tristate(dai, tristate);
2758         else
2759                 return -EINVAL;
2760 }
2761 EXPORT_SYMBOL_GPL(snd_soc_dai_set_tristate);
2762
2763 /**
2764  * snd_soc_dai_digital_mute - configure DAI system or master clock.
2765  * @dai: DAI
2766  * @mute: mute enable
2767  *
2768  * Mutes the DAI DAC.
2769  */
2770 int snd_soc_dai_digital_mute(struct snd_soc_dai *dai, int mute)
2771 {
2772         if (dai->driver && dai->driver->ops->digital_mute)
2773                 return dai->driver->ops->digital_mute(dai, mute);
2774         else
2775                 return -EINVAL;
2776 }
2777 EXPORT_SYMBOL_GPL(snd_soc_dai_digital_mute);
2778
2779 /**
2780  * snd_soc_register_card - Register a card with the ASoC core
2781  *
2782  * @card: Card to register
2783  *
2784  */
2785 int snd_soc_register_card(struct snd_soc_card *card)
2786 {
2787         int i;
2788
2789         if (!card->name || !card->dev)
2790                 return -EINVAL;
2791
2792         dev_set_drvdata(card->dev, card);
2793
2794         snd_soc_initialize_card_lists(card);
2795
2796         soc_init_card_debugfs(card);
2797
2798         card->rtd = kzalloc(sizeof(struct snd_soc_pcm_runtime) *
2799                             (card->num_links + card->num_aux_devs),
2800                             GFP_KERNEL);
2801         if (card->rtd == NULL)
2802                 return -ENOMEM;
2803         card->rtd_aux = &card->rtd[card->num_links];
2804
2805         for (i = 0; i < card->num_links; i++)
2806                 card->rtd[i].dai_link = &card->dai_link[i];
2807
2808         INIT_LIST_HEAD(&card->list);
2809         card->instantiated = 0;
2810         mutex_init(&card->mutex);
2811
2812         mutex_lock(&client_mutex);
2813         list_add(&card->list, &card_list);
2814         snd_soc_instantiate_cards();
2815         mutex_unlock(&client_mutex);
2816
2817         dev_dbg(card->dev, "Registered card '%s'\n", card->name);
2818
2819         return 0;
2820 }
2821 EXPORT_SYMBOL_GPL(snd_soc_register_card);
2822
2823 /**
2824  * snd_soc_unregister_card - Unregister a card with the ASoC core
2825  *
2826  * @card: Card to unregister
2827  *
2828  */
2829 int snd_soc_unregister_card(struct snd_soc_card *card)
2830 {
2831         if (card->instantiated)
2832                 soc_cleanup_card_resources(card);
2833         mutex_lock(&client_mutex);
2834         list_del(&card->list);
2835         mutex_unlock(&client_mutex);
2836         dev_dbg(card->dev, "Unregistered card '%s'\n", card->name);
2837
2838         return 0;
2839 }
2840 EXPORT_SYMBOL_GPL(snd_soc_unregister_card);
2841
2842 /*
2843  * Simplify DAI link configuration by removing ".-1" from device names
2844  * and sanitizing names.
2845  */
2846 static char *fmt_single_name(struct device *dev, int *id)
2847 {
2848         char *found, name[NAME_SIZE];
2849         int id1, id2;
2850
2851         if (dev_name(dev) == NULL)
2852                 return NULL;
2853
2854         strlcpy(name, dev_name(dev), NAME_SIZE);
2855
2856         /* are we a "%s.%d" name (platform and SPI components) */
2857         found = strstr(name, dev->driver->name);
2858         if (found) {
2859                 /* get ID */
2860                 if (sscanf(&found[strlen(dev->driver->name)], ".%d", id) == 1) {
2861
2862                         /* discard ID from name if ID == -1 */
2863                         if (*id == -1)
2864                                 found[strlen(dev->driver->name)] = '\0';
2865                 }
2866
2867         } else {
2868                 /* I2C component devices are named "bus-addr"  */
2869                 if (sscanf(name, "%x-%x", &id1, &id2) == 2) {
2870                         char tmp[NAME_SIZE];
2871
2872                         /* create unique ID number from I2C addr and bus */
2873                         *id = ((id1 & 0xffff) << 16) + id2;
2874
2875                         /* sanitize component name for DAI link creation */
2876                         snprintf(tmp, NAME_SIZE, "%s.%s", dev->driver->name, name);
2877                         strlcpy(name, tmp, NAME_SIZE);
2878                 } else
2879                         *id = 0;
2880         }
2881
2882         return kstrdup(name, GFP_KERNEL);
2883 }
2884
2885 /*
2886  * Simplify DAI link naming for single devices with multiple DAIs by removing
2887  * any ".-1" and using the DAI name (instead of device name).
2888  */
2889 static inline char *fmt_multiple_name(struct device *dev,
2890                 struct snd_soc_dai_driver *dai_drv)
2891 {
2892         if (dai_drv->name == NULL) {
2893                 printk(KERN_ERR "asoc: error - multiple DAI %s registered with no name\n",
2894                                 dev_name(dev));
2895                 return NULL;
2896         }
2897
2898         return kstrdup(dai_drv->name, GFP_KERNEL);
2899 }
2900
2901 /**
2902  * snd_soc_register_dai - Register a DAI with the ASoC core
2903  *
2904  * @dai: DAI to register
2905  */
2906 int snd_soc_register_dai(struct device *dev,
2907                 struct snd_soc_dai_driver *dai_drv)
2908 {
2909         struct snd_soc_dai *dai;
2910
2911         dev_dbg(dev, "dai register %s\n", dev_name(dev));
2912
2913         dai = kzalloc(sizeof(struct snd_soc_dai), GFP_KERNEL);
2914         if (dai == NULL)
2915                 return -ENOMEM;
2916
2917         /* create DAI component name */
2918         dai->name = fmt_single_name(dev, &dai->id);
2919         if (dai->name == NULL) {
2920                 kfree(dai);
2921                 return -ENOMEM;
2922         }
2923
2924         dai->dev = dev;
2925         dai->driver = dai_drv;
2926         if (!dai->driver->ops)
2927                 dai->driver->ops = &null_dai_ops;
2928
2929         mutex_lock(&client_mutex);
2930         list_add(&dai->list, &dai_list);
2931         snd_soc_instantiate_cards();
2932         mutex_unlock(&client_mutex);
2933
2934         pr_debug("Registered DAI '%s'\n", dai->name);
2935
2936         return 0;
2937 }
2938 EXPORT_SYMBOL_GPL(snd_soc_register_dai);
2939
2940 /**
2941  * snd_soc_unregister_dai - Unregister a DAI from the ASoC core
2942  *
2943  * @dai: DAI to unregister
2944  */
2945 void snd_soc_unregister_dai(struct device *dev)
2946 {
2947         struct snd_soc_dai *dai;
2948
2949         list_for_each_entry(dai, &dai_list, list) {
2950                 if (dev == dai->dev)
2951                         goto found;
2952         }
2953         return;
2954
2955 found:
2956         mutex_lock(&client_mutex);
2957         list_del(&dai->list);
2958         mutex_unlock(&client_mutex);
2959
2960         pr_debug("Unregistered DAI '%s'\n", dai->name);
2961         kfree(dai->name);
2962         kfree(dai);
2963 }
2964 EXPORT_SYMBOL_GPL(snd_soc_unregister_dai);
2965
2966 /**
2967  * snd_soc_register_dais - Register multiple DAIs with the ASoC core
2968  *
2969  * @dai: Array of DAIs to register
2970  * @count: Number of DAIs
2971  */
2972 int snd_soc_register_dais(struct device *dev,
2973                 struct snd_soc_dai_driver *dai_drv, size_t count)
2974 {
2975         struct snd_soc_dai *dai;
2976         int i, ret = 0;
2977
2978         dev_dbg(dev, "dai register %s #%Zu\n", dev_name(dev), count);
2979
2980         for (i = 0; i < count; i++) {
2981
2982                 dai = kzalloc(sizeof(struct snd_soc_dai), GFP_KERNEL);
2983                 if (dai == NULL) {
2984                         ret = -ENOMEM;
2985                         goto err;
2986                 }
2987
2988                 /* create DAI component name */
2989                 dai->name = fmt_multiple_name(dev, &dai_drv[i]);
2990                 if (dai->name == NULL) {
2991                         kfree(dai);
2992                         ret = -EINVAL;
2993                         goto err;
2994                 }
2995
2996                 dai->dev = dev;
2997                 dai->driver = &dai_drv[i];
2998                 if (dai->driver->id)
2999                         dai->id = dai->driver->id;
3000                 else
3001                         dai->id = i;
3002                 if (!dai->driver->ops)
3003                         dai->driver->ops = &null_dai_ops;
3004
3005                 mutex_lock(&client_mutex);
3006                 list_add(&dai->list, &dai_list);
3007                 mutex_unlock(&client_mutex);
3008
3009                 pr_debug("Registered DAI '%s'\n", dai->name);
3010         }
3011
3012         mutex_lock(&client_mutex);
3013         snd_soc_instantiate_cards();
3014         mutex_unlock(&client_mutex);
3015         return 0;
3016
3017 err:
3018         for (i--; i >= 0; i--)
3019                 snd_soc_unregister_dai(dev);
3020
3021         return ret;
3022 }
3023 EXPORT_SYMBOL_GPL(snd_soc_register_dais);
3024
3025 /**
3026  * snd_soc_unregister_dais - Unregister multiple DAIs from the ASoC core
3027  *
3028  * @dai: Array of DAIs to unregister
3029  * @count: Number of DAIs
3030  */
3031 void snd_soc_unregister_dais(struct device *dev, size_t count)
3032 {
3033         int i;
3034
3035         for (i = 0; i < count; i++)
3036                 snd_soc_unregister_dai(dev);
3037 }
3038 EXPORT_SYMBOL_GPL(snd_soc_unregister_dais);
3039
3040 /**
3041  * snd_soc_register_platform - Register a platform with the ASoC core
3042  *
3043  * @platform: platform to register
3044  */
3045 int snd_soc_register_platform(struct device *dev,
3046                 struct snd_soc_platform_driver *platform_drv)
3047 {
3048         struct snd_soc_platform *platform;
3049
3050         dev_dbg(dev, "platform register %s\n", dev_name(dev));
3051
3052         platform = kzalloc(sizeof(struct snd_soc_platform), GFP_KERNEL);
3053         if (platform == NULL)
3054                 return -ENOMEM;
3055
3056         /* create platform component name */
3057         platform->name = fmt_single_name(dev, &platform->id);
3058         if (platform->name == NULL) {
3059                 kfree(platform);
3060                 return -ENOMEM;
3061         }
3062
3063         platform->dev = dev;
3064         platform->driver = platform_drv;
3065
3066         mutex_lock(&client_mutex);
3067         list_add(&platform->list, &platform_list);
3068         snd_soc_instantiate_cards();
3069         mutex_unlock(&client_mutex);
3070
3071         pr_debug("Registered platform '%s'\n", platform->name);
3072
3073         return 0;
3074 }
3075 EXPORT_SYMBOL_GPL(snd_soc_register_platform);
3076
3077 /**
3078  * snd_soc_unregister_platform - Unregister a platform from the ASoC core
3079  *
3080  * @platform: platform to unregister
3081  */
3082 void snd_soc_unregister_platform(struct device *dev)
3083 {
3084         struct snd_soc_platform *platform;
3085
3086         list_for_each_entry(platform, &platform_list, list) {
3087                 if (dev == platform->dev)
3088                         goto found;
3089         }
3090         return;
3091
3092 found:
3093         mutex_lock(&client_mutex);
3094         list_del(&platform->list);
3095         mutex_unlock(&client_mutex);
3096
3097         pr_debug("Unregistered platform '%s'\n", platform->name);
3098         kfree(platform->name);
3099         kfree(platform);
3100 }
3101 EXPORT_SYMBOL_GPL(snd_soc_unregister_platform);
3102
3103 static u64 codec_format_map[] = {
3104         SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S16_BE,
3105         SNDRV_PCM_FMTBIT_U16_LE | SNDRV_PCM_FMTBIT_U16_BE,
3106         SNDRV_PCM_FMTBIT_S24_LE | SNDRV_PCM_FMTBIT_S24_BE,
3107         SNDRV_PCM_FMTBIT_U24_LE | SNDRV_PCM_FMTBIT_U24_BE,
3108         SNDRV_PCM_FMTBIT_S32_LE | SNDRV_PCM_FMTBIT_S32_BE,
3109         SNDRV_PCM_FMTBIT_U32_LE | SNDRV_PCM_FMTBIT_U32_BE,
3110         SNDRV_PCM_FMTBIT_S24_3LE | SNDRV_PCM_FMTBIT_U24_3BE,
3111         SNDRV_PCM_FMTBIT_U24_3LE | SNDRV_PCM_FMTBIT_U24_3BE,
3112         SNDRV_PCM_FMTBIT_S20_3LE | SNDRV_PCM_FMTBIT_S20_3BE,
3113         SNDRV_PCM_FMTBIT_U20_3LE | SNDRV_PCM_FMTBIT_U20_3BE,
3114         SNDRV_PCM_FMTBIT_S18_3LE | SNDRV_PCM_FMTBIT_S18_3BE,
3115         SNDRV_PCM_FMTBIT_U18_3LE | SNDRV_PCM_FMTBIT_U18_3BE,
3116         SNDRV_PCM_FMTBIT_FLOAT_LE | SNDRV_PCM_FMTBIT_FLOAT_BE,
3117         SNDRV_PCM_FMTBIT_FLOAT64_LE | SNDRV_PCM_FMTBIT_FLOAT64_BE,
3118         SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE
3119         | SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE,
3120 };
3121
3122 /* Fix up the DAI formats for endianness: codecs don't actually see
3123  * the endianness of the data but we're using the CPU format
3124  * definitions which do need to include endianness so we ensure that
3125  * codec DAIs always have both big and little endian variants set.
3126  */
3127 static void fixup_codec_formats(struct snd_soc_pcm_stream *stream)
3128 {
3129         int i;
3130
3131         for (i = 0; i < ARRAY_SIZE(codec_format_map); i++)
3132                 if (stream->formats & codec_format_map[i])
3133                         stream->formats |= codec_format_map[i];
3134 }
3135
3136 /**
3137  * snd_soc_register_codec - Register a codec with the ASoC core
3138  *
3139  * @codec: codec to register
3140  */
3141 int snd_soc_register_codec(struct device *dev,
3142                            const struct snd_soc_codec_driver *codec_drv,
3143                            struct snd_soc_dai_driver *dai_drv,
3144                            int num_dai)
3145 {
3146         size_t reg_size;
3147         struct snd_soc_codec *codec;
3148         int ret, i;
3149
3150         dev_dbg(dev, "codec register %s\n", dev_name(dev));
3151
3152         codec = kzalloc(sizeof(struct snd_soc_codec), GFP_KERNEL);
3153         if (codec == NULL)
3154                 return -ENOMEM;
3155
3156         /* create CODEC component name */
3157         codec->name = fmt_single_name(dev, &codec->id);
3158         if (codec->name == NULL) {
3159                 kfree(codec);
3160                 return -ENOMEM;
3161         }
3162
3163         if (codec_drv->compress_type)
3164                 codec->compress_type = codec_drv->compress_type;
3165         else
3166                 codec->compress_type = SND_SOC_FLAT_COMPRESSION;
3167
3168         codec->write = codec_drv->write;
3169         codec->read = codec_drv->read;
3170         codec->volatile_register = codec_drv->volatile_register;
3171         codec->readable_register = codec_drv->readable_register;
3172         codec->writable_register = codec_drv->writable_register;
3173         codec->dapm.bias_level = SND_SOC_BIAS_OFF;
3174         codec->dapm.dev = dev;
3175         codec->dapm.codec = codec;
3176         codec->dapm.seq_notifier = codec_drv->seq_notifier;
3177         codec->dev = dev;
3178         codec->driver = codec_drv;
3179         codec->num_dai = num_dai;
3180         mutex_init(&codec->mutex);
3181
3182         /* allocate CODEC register cache */
3183         if (codec_drv->reg_cache_size && codec_drv->reg_word_size) {
3184                 reg_size = codec_drv->reg_cache_size * codec_drv->reg_word_size;
3185                 codec->reg_size = reg_size;
3186                 /* it is necessary to make a copy of the default register cache
3187                  * because in the case of using a compression type that requires
3188                  * the default register cache to be marked as __devinitconst the
3189                  * kernel might have freed the array by the time we initialize
3190                  * the cache.
3191                  */
3192                 if (codec_drv->reg_cache_default) {
3193                         codec->reg_def_copy = kmemdup(codec_drv->reg_cache_default,
3194                                                       reg_size, GFP_KERNEL);
3195                         if (!codec->reg_def_copy) {
3196                                 ret = -ENOMEM;
3197                                 goto fail;
3198                         }
3199                 }
3200         }
3201
3202         if (codec_drv->reg_access_size && codec_drv->reg_access_default) {
3203                 if (!codec->volatile_register)
3204                         codec->volatile_register = snd_soc_default_volatile_register;
3205                 if (!codec->readable_register)
3206                         codec->readable_register = snd_soc_default_readable_register;
3207                 if (!codec->writable_register)
3208                         codec->writable_register = snd_soc_default_writable_register;
3209         }
3210
3211         for (i = 0; i < num_dai; i++) {
3212                 fixup_codec_formats(&dai_drv[i].playback);
3213                 fixup_codec_formats(&dai_drv[i].capture);
3214         }
3215
3216         /* register any DAIs */
3217         if (num_dai) {
3218                 ret = snd_soc_register_dais(dev, dai_drv, num_dai);
3219                 if (ret < 0)
3220                         goto fail;
3221         }
3222
3223         mutex_lock(&client_mutex);
3224         list_add(&codec->list, &codec_list);
3225         snd_soc_instantiate_cards();
3226         mutex_unlock(&client_mutex);
3227
3228         pr_debug("Registered codec '%s'\n", codec->name);
3229         return 0;
3230
3231 fail:
3232         kfree(codec->reg_def_copy);
3233         codec->reg_def_copy = NULL;
3234         kfree(codec->name);
3235         kfree(codec);
3236         return ret;
3237 }
3238 EXPORT_SYMBOL_GPL(snd_soc_register_codec);
3239
3240 /**
3241  * snd_soc_unregister_codec - Unregister a codec from the ASoC core
3242  *
3243  * @codec: codec to unregister
3244  */
3245 void snd_soc_unregister_codec(struct device *dev)
3246 {
3247         struct snd_soc_codec *codec;
3248         int i;
3249
3250         list_for_each_entry(codec, &codec_list, list) {
3251                 if (dev == codec->dev)
3252                         goto found;
3253         }
3254         return;
3255
3256 found:
3257         if (codec->num_dai)
3258                 for (i = 0; i < codec->num_dai; i++)
3259                         snd_soc_unregister_dai(dev);
3260
3261         mutex_lock(&client_mutex);
3262         list_del(&codec->list);
3263         mutex_unlock(&client_mutex);
3264
3265         pr_debug("Unregistered codec '%s'\n", codec->name);
3266
3267         snd_soc_cache_exit(codec);
3268         kfree(codec->reg_def_copy);
3269         kfree(codec->name);
3270         kfree(codec);
3271 }
3272 EXPORT_SYMBOL_GPL(snd_soc_unregister_codec);
3273
3274 static int __init snd_soc_init(void)
3275 {
3276 #ifdef CONFIG_DEBUG_FS
3277         snd_soc_debugfs_root = debugfs_create_dir("asoc", NULL);
3278         if (IS_ERR(snd_soc_debugfs_root) || !snd_soc_debugfs_root) {
3279                 printk(KERN_WARNING
3280                        "ASoC: Failed to create debugfs directory\n");
3281                 snd_soc_debugfs_root = NULL;
3282         }
3283
3284         if (!debugfs_create_file("codecs", 0444, snd_soc_debugfs_root, NULL,
3285                                  &codec_list_fops))
3286                 pr_warn("ASoC: Failed to create CODEC list debugfs file\n");
3287
3288         if (!debugfs_create_file("dais", 0444, snd_soc_debugfs_root, NULL,
3289                                  &dai_list_fops))
3290                 pr_warn("ASoC: Failed to create DAI list debugfs file\n");
3291
3292         if (!debugfs_create_file("platforms", 0444, snd_soc_debugfs_root, NULL,
3293                                  &platform_list_fops))
3294                 pr_warn("ASoC: Failed to create platform list debugfs file\n");
3295 #endif
3296
3297         snd_soc_util_init();
3298
3299         return platform_driver_register(&soc_driver);
3300 }
3301 module_init(snd_soc_init);
3302
3303 static void __exit snd_soc_exit(void)
3304 {
3305         snd_soc_util_exit();
3306
3307 #ifdef CONFIG_DEBUG_FS
3308         debugfs_remove_recursive(snd_soc_debugfs_root);
3309 #endif
3310         platform_driver_unregister(&soc_driver);
3311 }
3312 module_exit(snd_soc_exit);
3313
3314 /* Module information */
3315 MODULE_AUTHOR("Liam Girdwood, lrg@slimlogic.co.uk");
3316 MODULE_DESCRIPTION("ALSA SoC Core");
3317 MODULE_LICENSE("GPL");
3318 MODULE_ALIAS("platform:soc-audio");