Version:  2.6.34 2.6.35 2.6.36 2.6.37 2.6.38 2.6.39 3.0 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 3.10 3.11 3.12 3.13 3.14

Linux/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/pinctrl/consumer.h>
 34 #include <linux/ctype.h>
 35 #include <linux/slab.h>
 36 #include <linux/of.h>
 37 #include <linux/gpio.h>
 38 #include <linux/of_gpio.h>
 39 #include <sound/ac97_codec.h>
 40 #include <sound/core.h>
 41 #include <sound/jack.h>
 42 #include <sound/pcm.h>
 43 #include <sound/pcm_params.h>
 44 #include <sound/soc.h>
 45 #include <sound/soc-dpcm.h>
 46 #include <sound/initval.h>
 47 
 48 #define CREATE_TRACE_POINTS
 49 #include <trace/events/asoc.h>
 50 
 51 #define NAME_SIZE       32
 52 
 53 #ifdef CONFIG_DEBUG_FS
 54 struct dentry *snd_soc_debugfs_root;
 55 EXPORT_SYMBOL_GPL(snd_soc_debugfs_root);
 56 #endif
 57 
 58 static DEFINE_MUTEX(client_mutex);
 59 static LIST_HEAD(dai_list);
 60 static LIST_HEAD(platform_list);
 61 static LIST_HEAD(codec_list);
 62 static LIST_HEAD(component_list);
 63 
 64 /*
 65  * This is a timeout to do a DAPM powerdown after a stream is closed().
 66  * It can be used to eliminate pops between different playback streams, e.g.
 67  * between two audio tracks.
 68  */
 69 static int pmdown_time = 5000;
 70 module_param(pmdown_time, int, 0);
 71 MODULE_PARM_DESC(pmdown_time, "DAPM stream powerdown time (msecs)");
 72 
 73 struct snd_ac97_reset_cfg {
 74         struct pinctrl *pctl;
 75         struct pinctrl_state *pstate_reset;
 76         struct pinctrl_state *pstate_warm_reset;
 77         struct pinctrl_state *pstate_run;
 78         int gpio_sdata;
 79         int gpio_sync;
 80         int gpio_reset;
 81 };
 82 
 83 /* returns the minimum number of bytes needed to represent
 84  * a particular given value */
 85 static int min_bytes_needed(unsigned long val)
 86 {
 87         int c = 0;
 88         int i;
 89 
 90         for (i = (sizeof val * 8) - 1; i >= 0; --i, ++c)
 91                 if (val & (1UL << i))
 92                         break;
 93         c = (sizeof val * 8) - c;
 94         if (!c || (c % 8))
 95                 c = (c + 8) / 8;
 96         else
 97                 c /= 8;
 98         return c;
 99 }
100 
101 /* fill buf which is 'len' bytes with a formatted
102  * string of the form 'reg: value\n' */
103 static int format_register_str(struct snd_soc_codec *codec,
104                                unsigned int reg, char *buf, size_t len)
105 {
106         int wordsize = min_bytes_needed(codec->driver->reg_cache_size) * 2;
107         int regsize = codec->driver->reg_word_size * 2;
108         int ret;
109         char tmpbuf[len + 1];
110         char regbuf[regsize + 1];
111 
112         /* since tmpbuf is allocated on the stack, warn the callers if they
113          * try to abuse this function */
114         WARN_ON(len > 63);
115 
116         /* +2 for ': ' and + 1 for '\n' */
117         if (wordsize + regsize + 2 + 1 != len)
118                 return -EINVAL;
119 
120         ret = snd_soc_read(codec, reg);
121         if (ret < 0) {
122                 memset(regbuf, 'X', regsize);
123                 regbuf[regsize] = '\0';
124         } else {
125                 snprintf(regbuf, regsize + 1, "%.*x", regsize, ret);
126         }
127 
128         /* prepare the buffer */
129         snprintf(tmpbuf, len + 1, "%.*x: %s\n", wordsize, reg, regbuf);
130         /* copy it back to the caller without the '\0' */
131         memcpy(buf, tmpbuf, len);
132 
133         return 0;
134 }
135 
136 /* codec register dump */
137 static ssize_t soc_codec_reg_show(struct snd_soc_codec *codec, char *buf,
138                                   size_t count, loff_t pos)
139 {
140         int i, step = 1;
141         int wordsize, regsize;
142         int len;
143         size_t total = 0;
144         loff_t p = 0;
145 
146         wordsize = min_bytes_needed(codec->driver->reg_cache_size) * 2;
147         regsize = codec->driver->reg_word_size * 2;
148 
149         len = wordsize + regsize + 2 + 1;
150 
151         if (!codec->driver->reg_cache_size)
152                 return 0;
153 
154         if (codec->driver->reg_cache_step)
155                 step = codec->driver->reg_cache_step;
156 
157         for (i = 0; i < codec->driver->reg_cache_size; i += step) {
158                 if (!snd_soc_codec_readable_register(codec, i))
159                         continue;
160                 if (codec->driver->display_register) {
161                         count += codec->driver->display_register(codec, buf + count,
162                                                          PAGE_SIZE - count, i);
163                 } else {
164                         /* only support larger than PAGE_SIZE bytes debugfs
165                          * entries for the default case */
166                         if (p >= pos) {
167                                 if (total + len >= count - 1)
168                                         break;
169                                 format_register_str(codec, i, buf + total, len);
170                                 total += len;
171                         }
172                         p += len;
173                 }
174         }
175 
176         total = min(total, count - 1);
177 
178         return total;
179 }
180 
181 static ssize_t codec_reg_show(struct device *dev,
182         struct device_attribute *attr, char *buf)
183 {
184         struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);
185 
186         return soc_codec_reg_show(rtd->codec, buf, PAGE_SIZE, 0);
187 }
188 
189 static DEVICE_ATTR(codec_reg, 0444, codec_reg_show, NULL);
190 
191 static ssize_t pmdown_time_show(struct device *dev,
192                                 struct device_attribute *attr, char *buf)
193 {
194         struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);
195 
196         return sprintf(buf, "%ld\n", rtd->pmdown_time);
197 }
198 
199 static ssize_t pmdown_time_set(struct device *dev,
200                                struct device_attribute *attr,
201                                const char *buf, size_t count)
202 {
203         struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);
204         int ret;
205 
206         ret = kstrtol(buf, 10, &rtd->pmdown_time);
207         if (ret)
208                 return ret;
209 
210         return count;
211 }
212 
213 static DEVICE_ATTR(pmdown_time, 0644, pmdown_time_show, pmdown_time_set);
214 
215 #ifdef CONFIG_DEBUG_FS
216 static ssize_t codec_reg_read_file(struct file *file, char __user *user_buf,
217                                    size_t count, loff_t *ppos)
218 {
219         ssize_t ret;
220         struct snd_soc_codec *codec = file->private_data;
221         char *buf;
222 
223         if (*ppos < 0 || !count)
224                 return -EINVAL;
225 
226         buf = kmalloc(count, GFP_KERNEL);
227         if (!buf)
228                 return -ENOMEM;
229 
230         ret = soc_codec_reg_show(codec, buf, count, *ppos);
231         if (ret >= 0) {
232                 if (copy_to_user(user_buf, buf, ret)) {
233                         kfree(buf);
234                         return -EFAULT;
235                 }
236                 *ppos += ret;
237         }
238 
239         kfree(buf);
240         return ret;
241 }
242 
243 static ssize_t codec_reg_write_file(struct file *file,
244                 const char __user *user_buf, size_t count, loff_t *ppos)
245 {
246         char buf[32];
247         size_t buf_size;
248         char *start = buf;
249         unsigned long reg, value;
250         struct snd_soc_codec *codec = file->private_data;
251         int ret;
252 
253         buf_size = min(count, (sizeof(buf)-1));
254         if (copy_from_user(buf, user_buf, buf_size))
255                 return -EFAULT;
256         buf[buf_size] = 0;
257 
258         while (*start == ' ')
259                 start++;
260         reg = simple_strtoul(start, &start, 16);
261         while (*start == ' ')
262                 start++;
263         ret = kstrtoul(start, 16, &value);
264         if (ret)
265                 return ret;
266 
267         /* Userspace has been fiddling around behind the kernel's back */
268         add_taint(TAINT_USER, LOCKDEP_NOW_UNRELIABLE);
269 
270         snd_soc_write(codec, reg, value);
271         return buf_size;
272 }
273 
274 static const struct file_operations codec_reg_fops = {
275         .open = simple_open,
276         .read = codec_reg_read_file,
277         .write = codec_reg_write_file,
278         .llseek = default_llseek,
279 };
280 
281 static void soc_init_codec_debugfs(struct snd_soc_codec *codec)
282 {
283         struct dentry *debugfs_card_root = codec->card->debugfs_card_root;
284 
285         codec->debugfs_codec_root = debugfs_create_dir(codec->name,
286                                                        debugfs_card_root);
287         if (!codec->debugfs_codec_root) {
288                 dev_warn(codec->dev,
289                         "ASoC: Failed to create codec debugfs directory\n");
290                 return;
291         }
292 
293         debugfs_create_bool("cache_sync", 0444, codec->debugfs_codec_root,
294                             &codec->cache_sync);
295         debugfs_create_bool("cache_only", 0444, codec->debugfs_codec_root,
296                             &codec->cache_only);
297 
298         codec->debugfs_reg = debugfs_create_file("codec_reg", 0644,
299                                                  codec->debugfs_codec_root,
300                                                  codec, &codec_reg_fops);
301         if (!codec->debugfs_reg)
302                 dev_warn(codec->dev,
303                         "ASoC: Failed to create codec register debugfs file\n");
304 
305         snd_soc_dapm_debugfs_init(&codec->dapm, codec->debugfs_codec_root);
306 }
307 
308 static void soc_cleanup_codec_debugfs(struct snd_soc_codec *codec)
309 {
310         debugfs_remove_recursive(codec->debugfs_codec_root);
311 }
312 
313 static void soc_init_platform_debugfs(struct snd_soc_platform *platform)
314 {
315         struct dentry *debugfs_card_root = platform->card->debugfs_card_root;
316 
317         platform->debugfs_platform_root = debugfs_create_dir(platform->name,
318                                                        debugfs_card_root);
319         if (!platform->debugfs_platform_root) {
320                 dev_warn(platform->dev,
321                         "ASoC: Failed to create platform debugfs directory\n");
322                 return;
323         }
324 
325         snd_soc_dapm_debugfs_init(&platform->dapm,
326                 platform->debugfs_platform_root);
327 }
328 
329 static void soc_cleanup_platform_debugfs(struct snd_soc_platform *platform)
330 {
331         debugfs_remove_recursive(platform->debugfs_platform_root);
332 }
333 
334 static ssize_t codec_list_read_file(struct file *file, char __user *user_buf,
335                                     size_t count, loff_t *ppos)
336 {
337         char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
338         ssize_t len, ret = 0;
339         struct snd_soc_codec *codec;
340 
341         if (!buf)
342                 return -ENOMEM;
343 
344         list_for_each_entry(codec, &codec_list, list) {
345                 len = snprintf(buf + ret, PAGE_SIZE - ret, "%s\n",
346                                codec->name);
347                 if (len >= 0)
348                         ret += len;
349                 if (ret > PAGE_SIZE) {
350                         ret = PAGE_SIZE;
351                         break;
352                 }
353         }
354 
355         if (ret >= 0)
356                 ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
357 
358         kfree(buf);
359 
360         return ret;
361 }
362 
363 static const struct file_operations codec_list_fops = {
364         .read = codec_list_read_file,
365         .llseek = default_llseek,/* read accesses f_pos */
366 };
367 
368 static ssize_t dai_list_read_file(struct file *file, char __user *user_buf,
369                                   size_t count, loff_t *ppos)
370 {
371         char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
372         ssize_t len, ret = 0;
373         struct snd_soc_dai *dai;
374 
375         if (!buf)
376                 return -ENOMEM;
377 
378         list_for_each_entry(dai, &dai_list, list) {
379                 len = snprintf(buf + ret, PAGE_SIZE - ret, "%s\n", dai->name);
380                 if (len >= 0)
381                         ret += len;
382                 if (ret > PAGE_SIZE) {
383                         ret = PAGE_SIZE;
384                         break;
385                 }
386         }
387 
388         ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
389 
390         kfree(buf);
391 
392         return ret;
393 }
394 
395 static const struct file_operations dai_list_fops = {
396         .read = dai_list_read_file,
397         .llseek = default_llseek,/* read accesses f_pos */
398 };
399 
400 static ssize_t platform_list_read_file(struct file *file,
401                                        char __user *user_buf,
402                                        size_t count, loff_t *ppos)
403 {
404         char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
405         ssize_t len, ret = 0;
406         struct snd_soc_platform *platform;
407 
408         if (!buf)
409                 return -ENOMEM;
410 
411         list_for_each_entry(platform, &platform_list, list) {
412                 len = snprintf(buf + ret, PAGE_SIZE - ret, "%s\n",
413                                platform->name);
414                 if (len >= 0)
415                         ret += len;
416                 if (ret > PAGE_SIZE) {
417                         ret = PAGE_SIZE;
418                         break;
419                 }
420         }
421 
422         ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
423 
424         kfree(buf);
425 
426         return ret;
427 }
428 
429 static const struct file_operations platform_list_fops = {
430         .read = platform_list_read_file,
431         .llseek = default_llseek,/* read accesses f_pos */
432 };
433 
434 static void soc_init_card_debugfs(struct snd_soc_card *card)
435 {
436         card->debugfs_card_root = debugfs_create_dir(card->name,
437                                                      snd_soc_debugfs_root);
438         if (!card->debugfs_card_root) {
439                 dev_warn(card->dev,
440                          "ASoC: Failed to create card debugfs directory\n");
441                 return;
442         }
443 
444         card->debugfs_pop_time = debugfs_create_u32("dapm_pop_time", 0644,
445                                                     card->debugfs_card_root,
446                                                     &card->pop_time);
447         if (!card->debugfs_pop_time)
448                 dev_warn(card->dev,
449                        "ASoC: Failed to create pop time debugfs file\n");
450 }
451 
452 static void soc_cleanup_card_debugfs(struct snd_soc_card *card)
453 {
454         debugfs_remove_recursive(card->debugfs_card_root);
455 }
456 
457 #else
458 
459 static inline void soc_init_codec_debugfs(struct snd_soc_codec *codec)
460 {
461 }
462 
463 static inline void soc_cleanup_codec_debugfs(struct snd_soc_codec *codec)
464 {
465 }
466 
467 static inline void soc_init_platform_debugfs(struct snd_soc_platform *platform)
468 {
469 }
470 
471 static inline void soc_cleanup_platform_debugfs(struct snd_soc_platform *platform)
472 {
473 }
474 
475 static inline void soc_init_card_debugfs(struct snd_soc_card *card)
476 {
477 }
478 
479 static inline void soc_cleanup_card_debugfs(struct snd_soc_card *card)
480 {
481 }
482 #endif
483 
484 struct snd_pcm_substream *snd_soc_get_dai_substream(struct snd_soc_card *card,
485                 const char *dai_link, int stream)
486 {
487         int i;
488 
489         for (i = 0; i < card->num_links; i++) {
490                 if (card->rtd[i].dai_link->no_pcm &&
491                         !strcmp(card->rtd[i].dai_link->name, dai_link))
492                         return card->rtd[i].pcm->streams[stream].substream;
493         }
494         dev_dbg(card->dev, "ASoC: failed to find dai link %s\n", dai_link);
495         return NULL;
496 }
497 EXPORT_SYMBOL_GPL(snd_soc_get_dai_substream);
498 
499 struct snd_soc_pcm_runtime *snd_soc_get_pcm_runtime(struct snd_soc_card *card,
500                 const char *dai_link)
501 {
502         int i;
503 
504         for (i = 0; i < card->num_links; i++) {
505                 if (!strcmp(card->rtd[i].dai_link->name, dai_link))
506                         return &card->rtd[i];
507         }
508         dev_dbg(card->dev, "ASoC: failed to find rtd %s\n", dai_link);
509         return NULL;
510 }
511 EXPORT_SYMBOL_GPL(snd_soc_get_pcm_runtime);
512 
513 #ifdef CONFIG_SND_SOC_AC97_BUS
514 /* unregister ac97 codec */
515 static int soc_ac97_dev_unregister(struct snd_soc_codec *codec)
516 {
517         if (codec->ac97->dev.bus)
518                 device_unregister(&codec->ac97->dev);
519         return 0;
520 }
521 
522 /* stop no dev release warning */
523 static void soc_ac97_device_release(struct device *dev){}
524 
525 /* register ac97 codec to bus */
526 static int soc_ac97_dev_register(struct snd_soc_codec *codec)
527 {
528         int err;
529 
530         codec->ac97->dev.bus = &ac97_bus_type;
531         codec->ac97->dev.parent = codec->card->dev;
532         codec->ac97->dev.release = soc_ac97_device_release;
533 
534         dev_set_name(&codec->ac97->dev, "%d-%d:%s",
535                      codec->card->snd_card->number, 0, codec->name);
536         err = device_register(&codec->ac97->dev);
537         if (err < 0) {
538                 dev_err(codec->dev, "ASoC: Can't register ac97 bus\n");
539                 codec->ac97->dev.bus = NULL;
540                 return err;
541         }
542         return 0;
543 }
544 #endif
545 
546 static void codec2codec_close_delayed_work(struct work_struct *work)
547 {
548         /* Currently nothing to do for c2c links
549          * Since c2c links are internal nodes in the DAPM graph and
550          * don't interface with the outside world or application layer
551          * we don't have to do any special handling on close.
552          */
553 }
554 
555 #ifdef CONFIG_PM_SLEEP
556 /* powers down audio subsystem for suspend */
557 int snd_soc_suspend(struct device *dev)
558 {
559         struct snd_soc_card *card = dev_get_drvdata(dev);
560         struct snd_soc_codec *codec;
561         int i;
562 
563         /* If the initialization of this soc device failed, there is no codec
564          * associated with it. Just bail out in this case.
565          */
566         if (list_empty(&card->codec_dev_list))
567                 return 0;
568 
569         /* Due to the resume being scheduled into a workqueue we could
570         * suspend before that's finished - wait for it to complete.
571          */
572         snd_power_lock(card->snd_card);
573         snd_power_wait(card->snd_card, SNDRV_CTL_POWER_D0);
574         snd_power_unlock(card->snd_card);
575 
576         /* we're going to block userspace touching us until resume completes */
577         snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D3hot);
578 
579         /* mute any active DACs */
580         for (i = 0; i < card->num_rtd; i++) {
581                 struct snd_soc_dai *dai = card->rtd[i].codec_dai;
582                 struct snd_soc_dai_driver *drv = dai->driver;
583 
584                 if (card->rtd[i].dai_link->ignore_suspend)
585                         continue;
586 
587                 if (drv->ops->digital_mute && dai->playback_active)
588                         drv->ops->digital_mute(dai, 1);
589         }
590 
591         /* suspend all pcms */
592         for (i = 0; i < card->num_rtd; i++) {
593                 if (card->rtd[i].dai_link->ignore_suspend)
594                         continue;
595 
596                 snd_pcm_suspend_all(card->rtd[i].pcm);
597         }
598 
599         if (card->suspend_pre)
600                 card->suspend_pre(card);
601 
602         for (i = 0; i < card->num_rtd; i++) {
603                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
604                 struct snd_soc_platform *platform = card->rtd[i].platform;
605 
606                 if (card->rtd[i].dai_link->ignore_suspend)
607                         continue;
608 
609                 if (cpu_dai->driver->suspend && !cpu_dai->driver->ac97_control)
610                         cpu_dai->driver->suspend(cpu_dai);
611                 if (platform->driver->suspend && !platform->suspended) {
612                         platform->driver->suspend(cpu_dai);
613                         platform->suspended = 1;
614                 }
615         }
616 
617         /* close any waiting streams and save state */
618         for (i = 0; i < card->num_rtd; i++) {
619                 flush_delayed_work(&card->rtd[i].delayed_work);
620                 card->rtd[i].codec->dapm.suspend_bias_level = card->rtd[i].codec->dapm.bias_level;
621         }
622 
623         for (i = 0; i < card->num_rtd; i++) {
624 
625                 if (card->rtd[i].dai_link->ignore_suspend)
626                         continue;
627 
628                 snd_soc_dapm_stream_event(&card->rtd[i],
629                                           SNDRV_PCM_STREAM_PLAYBACK,
630                                           SND_SOC_DAPM_STREAM_SUSPEND);
631 
632                 snd_soc_dapm_stream_event(&card->rtd[i],
633                                           SNDRV_PCM_STREAM_CAPTURE,
634                                           SND_SOC_DAPM_STREAM_SUSPEND);
635         }
636 
637         /* Recheck all analogue paths too */
638         dapm_mark_io_dirty(&card->dapm);
639         snd_soc_dapm_sync(&card->dapm);
640 
641         /* suspend all CODECs */
642         list_for_each_entry(codec, &card->codec_dev_list, card_list) {
643                 /* If there are paths active then the CODEC will be held with
644                  * bias _ON and should not be suspended. */
645                 if (!codec->suspended && codec->driver->suspend) {
646                         switch (codec->dapm.bias_level) {
647                         case SND_SOC_BIAS_STANDBY:
648                                 /*
649                                  * If the CODEC is capable of idle
650                                  * bias off then being in STANDBY
651                                  * means it's doing something,
652                                  * otherwise fall through.
653                                  */
654                                 if (codec->dapm.idle_bias_off) {
655                                         dev_dbg(codec->dev,
656                                                 "ASoC: idle_bias_off CODEC on over suspend\n");
657                                         break;
658                                 }
659                         case SND_SOC_BIAS_OFF:
660                                 codec->driver->suspend(codec);
661                                 codec->suspended = 1;
662                                 codec->cache_sync = 1;
663                                 if (codec->using_regmap)
664                                         regcache_mark_dirty(codec->control_data);
665                                 /* deactivate pins to sleep state */
666                                 pinctrl_pm_select_sleep_state(codec->dev);
667                                 break;
668                         default:
669                                 dev_dbg(codec->dev,
670                                         "ASoC: CODEC is on over suspend\n");
671                                 break;
672                         }
673                 }
674         }
675 
676         for (i = 0; i < card->num_rtd; i++) {
677                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
678 
679                 if (card->rtd[i].dai_link->ignore_suspend)
680                         continue;
681 
682                 if (cpu_dai->driver->suspend && cpu_dai->driver->ac97_control)
683                         cpu_dai->driver->suspend(cpu_dai);
684 
685                 /* deactivate pins to sleep state */
686                 pinctrl_pm_select_sleep_state(cpu_dai->dev);
687         }
688 
689         if (card->suspend_post)
690                 card->suspend_post(card);
691 
692         return 0;
693 }
694 EXPORT_SYMBOL_GPL(snd_soc_suspend);
695 
696 /* deferred resume work, so resume can complete before we finished
697  * setting our codec back up, which can be very slow on I2C
698  */
699 static void soc_resume_deferred(struct work_struct *work)
700 {
701         struct snd_soc_card *card =
702                         container_of(work, struct snd_soc_card, deferred_resume_work);
703         struct snd_soc_codec *codec;
704         int i;
705 
706         /* our power state is still SNDRV_CTL_POWER_D3hot from suspend time,
707          * so userspace apps are blocked from touching us
708          */
709 
710         dev_dbg(card->dev, "ASoC: starting resume work\n");
711 
712         /* Bring us up into D2 so that DAPM starts enabling things */
713         snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D2);
714 
715         if (card->resume_pre)
716                 card->resume_pre(card);
717 
718         /* resume AC97 DAIs */
719         for (i = 0; i < card->num_rtd; i++) {
720                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
721 
722                 if (card->rtd[i].dai_link->ignore_suspend)
723                         continue;
724 
725                 if (cpu_dai->driver->resume && cpu_dai->driver->ac97_control)
726                         cpu_dai->driver->resume(cpu_dai);
727         }
728 
729         list_for_each_entry(codec, &card->codec_dev_list, card_list) {
730                 /* If the CODEC was idle over suspend then it will have been
731                  * left with bias OFF or STANDBY and suspended so we must now
732                  * resume.  Otherwise the suspend was suppressed.
733                  */
734                 if (codec->driver->resume && codec->suspended) {
735                         switch (codec->dapm.bias_level) {
736                         case SND_SOC_BIAS_STANDBY:
737                         case SND_SOC_BIAS_OFF:
738                                 codec->driver->resume(codec);
739                                 codec->suspended = 0;
740                                 break;
741                         default:
742                                 dev_dbg(codec->dev,
743                                         "ASoC: CODEC was on over suspend\n");
744                                 break;
745                         }
746                 }
747         }
748 
749         for (i = 0; i < card->num_rtd; i++) {
750 
751                 if (card->rtd[i].dai_link->ignore_suspend)
752                         continue;
753 
754                 snd_soc_dapm_stream_event(&card->rtd[i],
755                                           SNDRV_PCM_STREAM_PLAYBACK,
756                                           SND_SOC_DAPM_STREAM_RESUME);
757 
758                 snd_soc_dapm_stream_event(&card->rtd[i],
759                                           SNDRV_PCM_STREAM_CAPTURE,
760                                           SND_SOC_DAPM_STREAM_RESUME);
761         }
762 
763         /* unmute any active DACs */
764         for (i = 0; i < card->num_rtd; i++) {
765                 struct snd_soc_dai *dai = card->rtd[i].codec_dai;
766                 struct snd_soc_dai_driver *drv = dai->driver;
767 
768                 if (card->rtd[i].dai_link->ignore_suspend)
769                         continue;
770 
771                 if (drv->ops->digital_mute && dai->playback_active)
772                         drv->ops->digital_mute(dai, 0);
773         }
774 
775         for (i = 0; i < card->num_rtd; i++) {
776                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
777                 struct snd_soc_platform *platform = card->rtd[i].platform;
778 
779                 if (card->rtd[i].dai_link->ignore_suspend)
780                         continue;
781 
782                 if (cpu_dai->driver->resume && !cpu_dai->driver->ac97_control)
783                         cpu_dai->driver->resume(cpu_dai);
784                 if (platform->driver->resume && platform->suspended) {
785                         platform->driver->resume(cpu_dai);
786                         platform->suspended = 0;
787                 }
788         }
789 
790         if (card->resume_post)
791                 card->resume_post(card);
792 
793         dev_dbg(card->dev, "ASoC: resume work completed\n");
794 
795         /* userspace can access us now we are back as we were before */
796         snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D0);
797 
798         /* Recheck all analogue paths too */
799         dapm_mark_io_dirty(&card->dapm);
800         snd_soc_dapm_sync(&card->dapm);
801 }
802 
803 /* powers up audio subsystem after a suspend */
804 int snd_soc_resume(struct device *dev)
805 {
806         struct snd_soc_card *card = dev_get_drvdata(dev);
807         int i, ac97_control = 0;
808 
809         /* If the initialization of this soc device failed, there is no codec
810          * associated with it. Just bail out in this case.
811          */
812         if (list_empty(&card->codec_dev_list))
813                 return 0;
814 
815         /* activate pins from sleep state */
816         for (i = 0; i < card->num_rtd; i++) {
817                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
818                 struct snd_soc_dai *codec_dai = card->rtd[i].codec_dai;
819                 if (cpu_dai->active)
820                         pinctrl_pm_select_default_state(cpu_dai->dev);
821                 if (codec_dai->active)
822                         pinctrl_pm_select_default_state(codec_dai->dev);
823         }
824 
825         /* AC97 devices might have other drivers hanging off them so
826          * need to resume immediately.  Other drivers don't have that
827          * problem and may take a substantial amount of time to resume
828          * due to I/O costs and anti-pop so handle them out of line.
829          */
830         for (i = 0; i < card->num_rtd; i++) {
831                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
832                 ac97_control |= cpu_dai->driver->ac97_control;
833         }
834         if (ac97_control) {
835                 dev_dbg(dev, "ASoC: Resuming AC97 immediately\n");
836                 soc_resume_deferred(&card->deferred_resume_work);
837         } else {
838                 dev_dbg(dev, "ASoC: Scheduling resume work\n");
839                 if (!schedule_work(&card->deferred_resume_work))
840                         dev_err(dev, "ASoC: resume work item may be lost\n");
841         }
842 
843         return 0;
844 }
845 EXPORT_SYMBOL_GPL(snd_soc_resume);
846 #else
847 #define snd_soc_suspend NULL
848 #define snd_soc_resume NULL
849 #endif
850 
851 static const struct snd_soc_dai_ops null_dai_ops = {
852 };
853 
854 static int soc_bind_dai_link(struct snd_soc_card *card, int num)
855 {
856         struct snd_soc_dai_link *dai_link = &card->dai_link[num];
857         struct snd_soc_pcm_runtime *rtd = &card->rtd[num];
858         struct snd_soc_codec *codec;
859         struct snd_soc_platform *platform;
860         struct snd_soc_dai *codec_dai, *cpu_dai;
861         const char *platform_name;
862 
863         dev_dbg(card->dev, "ASoC: binding %s at idx %d\n", dai_link->name, num);
864 
865         /* Find CPU DAI from registered DAIs*/
866         list_for_each_entry(cpu_dai, &dai_list, list) {
867                 if (dai_link->cpu_of_node &&
868                     (cpu_dai->dev->of_node != dai_link->cpu_of_node))
869                         continue;
870                 if (dai_link->cpu_name &&
871                     strcmp(dev_name(cpu_dai->dev), dai_link->cpu_name))
872                         continue;
873                 if (dai_link->cpu_dai_name &&
874                     strcmp(cpu_dai->name, dai_link->cpu_dai_name))
875                         continue;
876 
877                 rtd->cpu_dai = cpu_dai;
878         }
879 
880         if (!rtd->cpu_dai) {
881                 dev_err(card->dev, "ASoC: CPU DAI %s not registered\n",
882                         dai_link->cpu_dai_name);
883                 return -EPROBE_DEFER;
884         }
885 
886         /* Find CODEC from registered CODECs */
887         list_for_each_entry(codec, &codec_list, list) {
888                 if (dai_link->codec_of_node) {
889                         if (codec->dev->of_node != dai_link->codec_of_node)
890                                 continue;
891                 } else {
892                         if (strcmp(codec->name, dai_link->codec_name))
893                                 continue;
894                 }
895 
896                 rtd->codec = codec;
897 
898                 /*
899                  * CODEC found, so find CODEC DAI from registered DAIs from
900                  * this CODEC
901                  */
902                 list_for_each_entry(codec_dai, &dai_list, list) {
903                         if (codec->dev == codec_dai->dev &&
904                                 !strcmp(codec_dai->name,
905                                         dai_link->codec_dai_name)) {
906 
907                                 rtd->codec_dai = codec_dai;
908                         }
909                 }
910 
911                 if (!rtd->codec_dai) {
912                         dev_err(card->dev, "ASoC: CODEC DAI %s not registered\n",
913                                 dai_link->codec_dai_name);
914                         return -EPROBE_DEFER;
915                 }
916         }
917 
918         if (!rtd->codec) {
919                 dev_err(card->dev, "ASoC: CODEC %s not registered\n",
920                         dai_link->codec_name);
921                 return -EPROBE_DEFER;
922         }
923 
924         /* if there's no platform we match on the empty platform */
925         platform_name = dai_link->platform_name;
926         if (!platform_name && !dai_link->platform_of_node)
927                 platform_name = "snd-soc-dummy";
928 
929         /* find one from the set of registered platforms */
930         list_for_each_entry(platform, &platform_list, list) {
931                 if (dai_link->platform_of_node) {
932                         if (platform->dev->of_node !=
933                             dai_link->platform_of_node)
934                                 continue;
935                 } else {
936                         if (strcmp(platform->name, platform_name))
937                                 continue;
938                 }
939 
940                 rtd->platform = platform;
941         }
942         if (!rtd->platform) {
943                 dev_err(card->dev, "ASoC: platform %s not registered\n",
944                         dai_link->platform_name);
945                 return -EPROBE_DEFER;
946         }
947 
948         card->num_rtd++;
949 
950         return 0;
951 }
952 
953 static int soc_remove_platform(struct snd_soc_platform *platform)
954 {
955         int ret;
956 
957         if (platform->driver->remove) {
958                 ret = platform->driver->remove(platform);
959                 if (ret < 0)
960                         dev_err(platform->dev, "ASoC: failed to remove %d\n",
961                                 ret);
962         }
963 
964         /* Make sure all DAPM widgets are freed */
965         snd_soc_dapm_free(&platform->dapm);
966 
967         soc_cleanup_platform_debugfs(platform);
968         platform->probed = 0;
969         list_del(&platform->card_list);
970         module_put(platform->dev->driver->owner);
971 
972         return 0;
973 }
974 
975 static void soc_remove_codec(struct snd_soc_codec *codec)
976 {
977         int err;
978 
979         if (codec->driver->remove) {
980                 err = codec->driver->remove(codec);
981                 if (err < 0)
982                         dev_err(codec->dev, "ASoC: failed to remove %d\n", err);
983         }
984 
985         /* Make sure all DAPM widgets are freed */
986         snd_soc_dapm_free(&codec->dapm);
987 
988         soc_cleanup_codec_debugfs(codec);
989         codec->probed = 0;
990         list_del(&codec->card_list);
991         module_put(codec->dev->driver->owner);
992 }
993 
994 static void soc_remove_link_dais(struct snd_soc_card *card, int num, int order)
995 {
996         struct snd_soc_pcm_runtime *rtd = &card->rtd[num];
997         struct snd_soc_dai *codec_dai = rtd->codec_dai, *cpu_dai = rtd->cpu_dai;
998         int err;
999 
1000         /* unregister the rtd device */
1001         if (rtd->dev_registered) {
1002                 device_remove_file(rtd->dev, &dev_attr_pmdown_time);
1003                 device_remove_file(rtd->dev, &dev_attr_codec_reg);
1004                 device_unregister(rtd->dev);
1005                 rtd->dev_registered = 0;
1006         }
1007 
1008         /* remove the CODEC DAI */
1009         if (codec_dai && codec_dai->probed &&
1010                         codec_dai->driver->remove_order == order) {
1011                 if (codec_dai->driver->remove) {
1012                         err = codec_dai->driver->remove(codec_dai);
1013                         if (err < 0)
1014                                 dev_err(codec_dai->dev,
1015                                         "ASoC: failed to remove %s: %d\n",
1016                                         codec_dai->name, err);
1017                 }
1018                 codec_dai->probed = 0;
1019                 list_del(&codec_dai->card_list);
1020         }
1021 
1022         /* remove the cpu_dai */
1023         if (cpu_dai && cpu_dai->probed &&
1024                         cpu_dai->driver->remove_order == order) {
1025                 if (cpu_dai->driver->remove) {
1026                         err = cpu_dai->driver->remove(cpu_dai);
1027                         if (err < 0)
1028                                 dev_err(cpu_dai->dev,
1029                                         "ASoC: failed to remove %s: %d\n",
1030                                         cpu_dai->name, err);
1031                 }
1032                 cpu_dai->probed = 0;
1033                 list_del(&cpu_dai->card_list);
1034 
1035                 if (!cpu_dai->codec) {
1036                         snd_soc_dapm_free(&cpu_dai->dapm);
1037                         module_put(cpu_dai->dev->driver->owner);
1038                 }
1039         }
1040 }
1041 
1042 static void soc_remove_link_components(struct snd_soc_card *card, int num,
1043                                        int order)
1044 {
1045         struct snd_soc_pcm_runtime *rtd = &card->rtd[num];
1046         struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
1047         struct snd_soc_dai *codec_dai = rtd->codec_dai;
1048         struct snd_soc_platform *platform = rtd->platform;
1049         struct snd_soc_codec *codec;
1050 
1051         /* remove the platform */
1052         if (platform && platform->probed &&
1053             platform->driver->remove_order == order) {
1054                 soc_remove_platform(platform);
1055         }
1056 
1057         /* remove the CODEC-side CODEC */
1058         if (codec_dai) {
1059                 codec = codec_dai->codec;
1060                 if (codec && codec->probed &&
1061                     codec->driver->remove_order == order)
1062                         soc_remove_codec(codec);
1063         }
1064 
1065         /* remove any CPU-side CODEC */
1066         if (cpu_dai) {
1067                 codec = cpu_dai->codec;
1068                 if (codec && codec->probed &&
1069                     codec->driver->remove_order == order)
1070                         soc_remove_codec(codec);
1071         }
1072 }
1073 
1074 static void soc_remove_dai_links(struct snd_soc_card *card)
1075 {
1076         int dai, order;
1077 
1078         for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
1079                         order++) {
1080                 for (dai = 0; dai < card->num_rtd; dai++)
1081                         soc_remove_link_dais(card, dai, order);
1082         }
1083 
1084         for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
1085                         order++) {
1086                 for (dai = 0; dai < card->num_rtd; dai++)
1087                         soc_remove_link_components(card, dai, order);
1088         }
1089 
1090         card->num_rtd = 0;
1091 }
1092 
1093 static void soc_set_name_prefix(struct snd_soc_card *card,
1094                                 struct snd_soc_codec *codec)
1095 {
1096         int i;
1097 
1098         if (card->codec_conf == NULL)
1099                 return;
1100 
1101         for (i = 0; i < card->num_configs; i++) {
1102                 struct snd_soc_codec_conf *map = &card->codec_conf[i];
1103                 if (map->dev_name && !strcmp(codec->name, map->dev_name)) {
1104                         codec->name_prefix = map->name_prefix;
1105                         break;
1106                 }
1107         }
1108 }
1109 
1110 static int soc_probe_codec(struct snd_soc_card *card,
1111                            struct snd_soc_codec *codec)
1112 {
1113         int ret = 0;
1114         const struct snd_soc_codec_driver *driver = codec->driver;
1115         struct snd_soc_dai *dai;
1116 
1117         codec->card = card;
1118         codec->dapm.card = card;
1119         soc_set_name_prefix(card, codec);
1120 
1121         if (!try_module_get(codec->dev->driver->owner))
1122                 return -ENODEV;
1123 
1124         soc_init_codec_debugfs(codec);
1125 
1126         if (driver->dapm_widgets)
1127                 snd_soc_dapm_new_controls(&codec->dapm, driver->dapm_widgets,
1128                                           driver->num_dapm_widgets);
1129 
1130         /* Create DAPM widgets for each DAI stream */
1131         list_for_each_entry(dai, &dai_list, list) {
1132                 if (dai->dev != codec->dev)
1133                         continue;
1134 
1135                 snd_soc_dapm_new_dai_widgets(&codec->dapm, dai);
1136         }
1137 
1138         codec->dapm.idle_bias_off = driver->idle_bias_off;
1139 
1140         if (driver->probe) {
1141                 ret = driver->probe(codec);
1142                 if (ret < 0) {
1143                         dev_err(codec->dev,
1144                                 "ASoC: failed to probe CODEC %d\n", ret);
1145                         goto err_probe;
1146                 }
1147                 WARN(codec->dapm.idle_bias_off &&
1148                         codec->dapm.bias_level != SND_SOC_BIAS_OFF,
1149                         "codec %s can not start from non-off bias with idle_bias_off==1\n",
1150                         codec->name);
1151         }
1152 
1153         /* If the driver didn't set I/O up try regmap */
1154         if (!codec->write && dev_get_regmap(codec->dev, NULL))
1155                 snd_soc_codec_set_cache_io(codec, 0, 0, SND_SOC_REGMAP);
1156 
1157         if (driver->controls)
1158                 snd_soc_add_codec_controls(codec, driver->controls,
1159                                      driver->num_controls);
1160         if (driver->dapm_routes)
1161                 snd_soc_dapm_add_routes(&codec->dapm, driver->dapm_routes,
1162                                         driver->num_dapm_routes);
1163 
1164         /* mark codec as probed and add to card codec list */
1165         codec->probed = 1;
1166         list_add(&codec->card_list, &card->codec_dev_list);
1167         list_add(&codec->dapm.list, &card->dapm_list);
1168 
1169         return 0;
1170 
1171 err_probe:
1172         soc_cleanup_codec_debugfs(codec);
1173         module_put(codec->dev->driver->owner);
1174 
1175         return ret;
1176 }
1177 
1178 static int soc_probe_platform(struct snd_soc_card *card,
1179                            struct snd_soc_platform *platform)
1180 {
1181         int ret = 0;
1182         const struct snd_soc_platform_driver *driver = platform->driver;
1183         struct snd_soc_dai *dai;
1184 
1185         platform->card = card;
1186         platform->dapm.card = card;
1187 
1188         if (!try_module_get(platform->dev->driver->owner))
1189                 return -ENODEV;
1190 
1191         soc_init_platform_debugfs(platform);
1192 
1193         if (driver->dapm_widgets)
1194                 snd_soc_dapm_new_controls(&platform->dapm,
1195                         driver->dapm_widgets, driver->num_dapm_widgets);
1196 
1197         /* Create DAPM widgets for each DAI stream */
1198         list_for_each_entry(dai, &dai_list, list) {
1199                 if (dai->dev != platform->dev)
1200                         continue;
1201 
1202                 snd_soc_dapm_new_dai_widgets(&platform->dapm, dai);
1203         }
1204 
1205         platform->dapm.idle_bias_off = 1;
1206 
1207         if (driver->probe) {
1208                 ret = driver->probe(platform);
1209                 if (ret < 0) {
1210                         dev_err(platform->dev,
1211                                 "ASoC: failed to probe platform %d\n", ret);
1212                         goto err_probe;
1213                 }
1214         }
1215 
1216         if (driver->controls)
1217                 snd_soc_add_platform_controls(platform, driver->controls,
1218                                      driver->num_controls);
1219         if (driver->dapm_routes)
1220                 snd_soc_dapm_add_routes(&platform->dapm, driver->dapm_routes,
1221                                         driver->num_dapm_routes);
1222 
1223         /* mark platform as probed and add to card platform list */
1224         platform->probed = 1;
1225         list_add(&platform->card_list, &card->platform_dev_list);
1226         list_add(&platform->dapm.list, &card->dapm_list);
1227 
1228         return 0;
1229 
1230 err_probe:
1231         soc_cleanup_platform_debugfs(platform);
1232         module_put(platform->dev->driver->owner);
1233 
1234         return ret;
1235 }
1236 
1237 static void rtd_release(struct device *dev)
1238 {
1239         kfree(dev);
1240 }
1241 
1242 static int soc_post_component_init(struct snd_soc_card *card,
1243                                    struct snd_soc_codec *codec,
1244                                    int num, int dailess)
1245 {
1246         struct snd_soc_dai_link *dai_link = NULL;
1247         struct snd_soc_aux_dev *aux_dev = NULL;
1248         struct snd_soc_pcm_runtime *rtd;
1249         const char *temp, *name;
1250         int ret = 0;
1251 
1252         if (!dailess) {
1253                 dai_link = &card->dai_link[num];
1254                 rtd = &card->rtd[num];
1255                 name = dai_link->name;
1256         } else {
1257                 aux_dev = &card->aux_dev[num];
1258                 rtd = &card->rtd_aux[num];
1259                 name = aux_dev->name;
1260         }
1261         rtd->card = card;
1262 
1263         /* machine controls, routes and widgets are not prefixed */
1264         temp = codec->name_prefix;
1265         codec->name_prefix = NULL;
1266 
1267         /* do machine specific initialization */
1268         if (!dailess && dai_link->init)
1269                 ret = dai_link->init(rtd);
1270         else if (dailess && aux_dev->init)
1271                 ret = aux_dev->init(&codec->dapm);
1272         if (ret < 0) {
1273                 dev_err(card->dev, "ASoC: failed to init %s: %d\n", name, ret);
1274                 return ret;
1275         }
1276         codec->name_prefix = temp;
1277 
1278         /* register the rtd device */
1279         rtd->codec = codec;
1280 
1281         rtd->dev = kzalloc(sizeof(struct device), GFP_KERNEL);
1282         if (!rtd->dev)
1283                 return -ENOMEM;
1284         device_initialize(rtd->dev);
1285         rtd->dev->parent = card->dev;
1286         rtd->dev->release = rtd_release;
1287         rtd->dev->init_name = name;
1288         dev_set_drvdata(rtd->dev, rtd);
1289         mutex_init(&rtd->pcm_mutex);
1290         INIT_LIST_HEAD(&rtd->dpcm[SNDRV_PCM_STREAM_PLAYBACK].be_clients);
1291         INIT_LIST_HEAD(&rtd->dpcm[SNDRV_PCM_STREAM_CAPTURE].be_clients);
1292         INIT_LIST_HEAD(&rtd->dpcm[SNDRV_PCM_STREAM_PLAYBACK].fe_clients);
1293         INIT_LIST_HEAD(&rtd->dpcm[SNDRV_PCM_STREAM_CAPTURE].fe_clients);
1294         ret = device_add(rtd->dev);
1295         if (ret < 0) {
1296                 /* calling put_device() here to free the rtd->dev */
1297                 put_device(rtd->dev);
1298                 dev_err(card->dev,
1299                         "ASoC: failed to register runtime device: %d\n", ret);
1300                 return ret;
1301         }
1302         rtd->dev_registered = 1;
1303 
1304         /* add DAPM sysfs entries for this codec */
1305         ret = snd_soc_dapm_sys_add(rtd->dev);
1306         if (ret < 0)
1307                 dev_err(codec->dev,
1308                         "ASoC: failed to add codec dapm sysfs entries: %d\n", ret);
1309 
1310         /* add codec sysfs entries */
1311         ret = device_create_file(rtd->dev, &dev_attr_codec_reg);
1312         if (ret < 0)
1313                 dev_err(codec->dev,
1314                         "ASoC: failed to add codec sysfs files: %d\n", ret);
1315 
1316 #ifdef CONFIG_DEBUG_FS
1317         /* add DPCM sysfs entries */
1318         if (!dailess && !dai_link->dynamic)
1319                 goto out;
1320 
1321         ret = soc_dpcm_debugfs_add(rtd);
1322         if (ret < 0)
1323                 dev_err(rtd->dev, "ASoC: failed to add dpcm sysfs entries: %d\n", ret);
1324 
1325 out:
1326 #endif
1327         return 0;
1328 }
1329 
1330 static int soc_probe_link_components(struct snd_soc_card *card, int num,
1331                                      int order)
1332 {
1333         struct snd_soc_pcm_runtime *rtd = &card->rtd[num];
1334         struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
1335         struct snd_soc_dai *codec_dai = rtd->codec_dai;
1336         struct snd_soc_platform *platform = rtd->platform;
1337         int ret;
1338 
1339         /* probe the CPU-side component, if it is a CODEC */
1340         if (cpu_dai->codec &&
1341             !cpu_dai->codec->probed &&
1342             cpu_dai->codec->driver->probe_order == order) {
1343                 ret = soc_probe_codec(card, cpu_dai->codec);
1344                 if (ret < 0)
1345                         return ret;
1346         }
1347 
1348         /* probe the CODEC-side component */
1349         if (!codec_dai->codec->probed &&
1350             codec_dai->codec->driver->probe_order == order) {
1351                 ret = soc_probe_codec(card, codec_dai->codec);
1352                 if (ret < 0)
1353                         return ret;
1354         }
1355 
1356         /* probe the platform */
1357         if (!platform->probed &&
1358             platform->driver->probe_order == order) {
1359                 ret = soc_probe_platform(card, platform);
1360                 if (ret < 0)
1361                         return ret;
1362         }
1363 
1364         return 0;
1365 }
1366 
1367 static int soc_probe_link_dais(struct snd_soc_card *card, int num, int order)
1368 {
1369         struct snd_soc_dai_link *dai_link = &card->dai_link[num];
1370         struct snd_soc_pcm_runtime *rtd = &card->rtd[num];
1371         struct snd_soc_codec *codec = rtd->codec;
1372         struct snd_soc_platform *platform = rtd->platform;
1373         struct snd_soc_dai *codec_dai = rtd->codec_dai;
1374         struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
1375         struct snd_soc_dapm_widget *play_w, *capture_w;
1376         int ret;
1377 
1378         dev_dbg(card->dev, "ASoC: probe %s dai link %d late %d\n",
1379                         card->name, num, order);
1380 
1381         /* config components */
1382         cpu_dai->platform = platform;
1383         codec_dai->card = card;
1384         cpu_dai->card = card;
1385 
1386         /* set default power off timeout */
1387         rtd->pmdown_time = pmdown_time;
1388 
1389         /* probe the cpu_dai */
1390         if (!cpu_dai->probed &&
1391                         cpu_dai->driver->probe_order == order) {
1392                 if (!cpu_dai->codec) {
1393                         cpu_dai->dapm.card = card;
1394                         if (!try_module_get(cpu_dai->dev->driver->owner))
1395                                 return -ENODEV;
1396 
1397                         list_add(&cpu_dai->dapm.list, &card->dapm_list);
1398                 }
1399 
1400                 if (cpu_dai->driver->probe) {
1401                         ret = cpu_dai->driver->probe(cpu_dai);
1402                         if (ret < 0) {
1403                                 dev_err(cpu_dai->dev,
1404                                         "ASoC: failed to probe CPU DAI %s: %d\n",
1405                                         cpu_dai->name, ret);
1406                                 module_put(cpu_dai->dev->driver->owner);
1407                                 return ret;
1408                         }
1409                 }
1410                 cpu_dai->probed = 1;
1411                 /* mark cpu_dai as probed and add to card dai list */
1412                 list_add(&cpu_dai->card_list, &card->dai_dev_list);
1413         }
1414 
1415         /* probe the CODEC DAI */
1416         if (!codec_dai->probed && codec_dai->driver->probe_order == order) {
1417                 if (codec_dai->driver->probe) {
1418                         ret = codec_dai->driver->probe(codec_dai);
1419                         if (ret < 0) {
1420                                 dev_err(codec_dai->dev,
1421                                         "ASoC: failed to probe CODEC DAI %s: %d\n",
1422                                         codec_dai->name, ret);
1423                                 return ret;
1424                         }
1425                 }
1426 
1427                 /* mark codec_dai as probed and add to card dai list */
1428                 codec_dai->probed = 1;
1429                 list_add(&codec_dai->card_list, &card->dai_dev_list);
1430         }
1431 
1432         /* complete DAI probe during last probe */
1433         if (order != SND_SOC_COMP_ORDER_LAST)
1434                 return 0;
1435 
1436         ret = soc_post_component_init(card, codec, num, 0);
1437         if (ret)
1438                 return ret;
1439 
1440         ret = device_create_file(rtd->dev, &dev_attr_pmdown_time);
1441         if (ret < 0)
1442                 dev_warn(rtd->dev, "ASoC: failed to add pmdown_time sysfs: %d\n",
1443                         ret);
1444 
1445         if (cpu_dai->driver->compress_dai) {
1446                 /*create compress_device"*/
1447                 ret = soc_new_compress(rtd, num);
1448                 if (ret < 0) {
1449                         dev_err(card->dev, "ASoC: can't create compress %s\n",
1450                                          dai_link->stream_name);
1451                         return ret;
1452                 }
1453         } else {
1454 
1455                 if (!dai_link->params) {
1456                         /* create the pcm */
1457                         ret = soc_new_pcm(rtd, num);
1458                         if (ret < 0) {
1459                                 dev_err(card->dev, "ASoC: can't create pcm %s :%d\n",
1460                                        dai_link->stream_name, ret);
1461                                 return ret;
1462                         }
1463                 } else {
1464                         INIT_DELAYED_WORK(&rtd->delayed_work,
1465                                                 codec2codec_close_delayed_work);
1466 
1467                         /* link the DAI widgets */
1468                         play_w = codec_dai->playback_widget;
1469                         capture_w = cpu_dai->capture_widget;
1470                         if (play_w && capture_w) {
1471                                 ret = snd_soc_dapm_new_pcm(card, dai_link->params,
1472                                                    capture_w, play_w);
1473                                 if (ret != 0) {
1474                                         dev_err(card->dev, "ASoC: Can't link %s to %s: %d\n",
1475                                                 play_w->name, capture_w->name, ret);
1476                                         return ret;
1477                                 }
1478                         }
1479 
1480                         play_w = cpu_dai->playback_widget;
1481                         capture_w = codec_dai->capture_widget;
1482                         if (play_w && capture_w) {
1483                                 ret = snd_soc_dapm_new_pcm(card, dai_link->params,
1484                                                    capture_w, play_w);
1485                                 if (ret != 0) {
1486                                         dev_err(card->dev, "ASoC: Can't link %s to %s: %d\n",
1487                                                 play_w->name, capture_w->name, ret);
1488                                         return ret;
1489                                 }
1490                         }
1491                 }
1492         }
1493 
1494         /* add platform data for AC97 devices */
1495         if (rtd->codec_dai->driver->ac97_control)
1496                 snd_ac97_dev_add_pdata(codec->ac97, rtd->cpu_dai->ac97_pdata);
1497 
1498         return 0;
1499 }
1500 
1501 #ifdef CONFIG_SND_SOC_AC97_BUS
1502 static int soc_register_ac97_dai_link(struct snd_soc_pcm_runtime *rtd)
1503 {
1504         int ret;
1505 
1506         /* Only instantiate AC97 if not already done by the adaptor
1507          * for the generic AC97 subsystem.
1508          */
1509         if (rtd->codec_dai->driver->ac97_control && !rtd->codec->ac97_registered) {
1510                 /*
1511                  * It is possible that the AC97 device is already registered to
1512                  * the device subsystem. This happens when the device is created
1513                  * via snd_ac97_mixer(). Currently only SoC codec that does so
1514                  * is the generic AC97 glue but others migh emerge.
1515                  *
1516                  * In those cases we don't try to register the device again.
1517                  */
1518                 if (!rtd->codec->ac97_created)
1519                         return 0;
1520 
1521                 ret = soc_ac97_dev_register(rtd->codec);
1522                 if (ret < 0) {
1523                         dev_err(rtd->codec->dev,
1524                                 "ASoC: AC97 device register failed: %d\n", ret);
1525                         return ret;
1526                 }
1527 
1528                 rtd->codec->ac97_registered = 1;
1529         }
1530         return 0;
1531 }
1532 
1533 static void soc_unregister_ac97_dai_link(struct snd_soc_codec *codec)
1534 {
1535         if (codec->ac97_registered) {
1536                 soc_ac97_dev_unregister(codec);
1537                 codec->ac97_registered = 0;
1538         }
1539 }
1540 #endif
1541 
1542 static int soc_check_aux_dev(struct snd_soc_card *card, int num)
1543 {
1544         struct snd_soc_aux_dev *aux_dev = &card->aux_dev[num];
1545         struct snd_soc_codec *codec;
1546 
1547         /* find CODEC from registered CODECs*/
1548         list_for_each_entry(codec, &codec_list, list) {
1549                 if (!strcmp(codec->name, aux_dev->codec_name))
1550                         return 0;
1551         }
1552 
1553         dev_err(card->dev, "ASoC: %s not registered\n", aux_dev->codec_name);
1554 
1555         return -EPROBE_DEFER;
1556 }
1557 
1558 static int soc_probe_aux_dev(struct snd_soc_card *card, int num)
1559 {
1560         struct snd_soc_aux_dev *aux_dev = &card->aux_dev[num];
1561         struct snd_soc_codec *codec;
1562         int ret = -ENODEV;
1563 
1564         /* find CODEC from registered CODECs*/
1565         list_for_each_entry(codec, &codec_list, list) {
1566                 if (!strcmp(codec->name, aux_dev->codec_name)) {
1567                         if (codec->probed) {
1568                                 dev_err(codec->dev,
1569                                         "ASoC: codec already probed");
1570                                 ret = -EBUSY;
1571                                 goto out;
1572                         }
1573                         goto found;
1574                 }
1575         }
1576         /* codec not found */
1577         dev_err(card->dev, "ASoC: codec %s not found", aux_dev->codec_name);
1578         return -EPROBE_DEFER;
1579 
1580 found:
1581         ret = soc_probe_codec(card, codec);
1582         if (ret < 0)
1583                 return ret;
1584 
1585         ret = soc_post_component_init(card, codec, num, 1);
1586 
1587 out:
1588         return ret;
1589 }
1590 
1591 static void soc_remove_aux_dev(struct snd_soc_card *card, int num)
1592 {
1593         struct snd_soc_pcm_runtime *rtd = &card->rtd_aux[num];
1594         struct snd_soc_codec *codec = rtd->codec;
1595 
1596         /* unregister the rtd device */
1597         if (rtd->dev_registered) {
1598                 device_remove_file(rtd->dev, &dev_attr_codec_reg);
1599                 device_unregister(rtd->dev);
1600                 rtd->dev_registered = 0;
1601         }
1602 
1603         if (codec && codec->probed)
1604                 soc_remove_codec(codec);
1605 }
1606 
1607 static int snd_soc_init_codec_cache(struct snd_soc_codec *codec)
1608 {
1609         int ret;
1610 
1611         if (codec->cache_init)
1612                 return 0;
1613 
1614         ret = snd_soc_cache_init(codec);
1615         if (ret < 0) {
1616                 dev_err(codec->dev,
1617                         "ASoC: Failed to set cache compression type: %d\n",
1618                         ret);
1619                 return ret;
1620         }
1621         codec->cache_init = 1;
1622         return 0;
1623 }
1624 
1625 static int snd_soc_instantiate_card(struct snd_soc_card *card)
1626 {
1627         struct snd_soc_codec *codec;
1628         struct snd_soc_dai_link *dai_link;
1629         int ret, i, order, dai_fmt;
1630 
1631         mutex_lock_nested(&card->mutex, SND_SOC_CARD_CLASS_INIT);
1632 
1633         /* bind DAIs */
1634         for (i = 0; i < card->num_links; i++) {
1635                 ret = soc_bind_dai_link(card, i);
1636                 if (ret != 0)
1637                         goto base_error;
1638         }
1639 
1640         /* check aux_devs too */
1641         for (i = 0; i < card->num_aux_devs; i++) {
1642                 ret = soc_check_aux_dev(card, i);
1643                 if (ret != 0)
1644                         goto base_error;
1645         }
1646 
1647         /* initialize the register cache for each available codec */
1648         list_for_each_entry(codec, &codec_list, list) {
1649                 if (codec->cache_init)
1650                         continue;
1651                 ret = snd_soc_init_codec_cache(codec);
1652                 if (ret < 0)
1653                         goto base_error;
1654         }
1655 
1656         /* card bind complete so register a sound card */
1657         ret = snd_card_create(SNDRV_DEFAULT_IDX1, SNDRV_DEFAULT_STR1,
1658                         card->owner, 0, &card->snd_card);
1659         if (ret < 0) {
1660                 dev_err(card->dev,
1661                         "ASoC: can't create sound card for card %s: %d\n",
1662                         card->name, ret);
1663                 goto base_error;
1664         }
1665         card->snd_card->dev = card->dev;
1666 
1667         card->dapm.bias_level = SND_SOC_BIAS_OFF;
1668         card->dapm.dev = card->dev;
1669         card->dapm.card = card;
1670         list_add(&card->dapm.list, &card->dapm_list);
1671 
1672 #ifdef CONFIG_DEBUG_FS
1673         snd_soc_dapm_debugfs_init(&card->dapm, card->debugfs_card_root);
1674 #endif
1675 
1676 #ifdef CONFIG_PM_SLEEP
1677         /* deferred resume work */
1678         INIT_WORK(&card->deferred_resume_work, soc_resume_deferred);
1679 #endif
1680 
1681         if (card->dapm_widgets)
1682                 snd_soc_dapm_new_controls(&card->dapm, card->dapm_widgets,
1683                                           card->num_dapm_widgets);
1684 
1685         /* initialise the sound card only once */
1686         if (card->probe) {
1687                 ret = card->probe(card);
1688                 if (ret < 0)
1689                         goto card_probe_error;
1690         }
1691 
1692         /* probe all components used by DAI links on this card */
1693         for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
1694                         order++) {
1695                 for (i = 0; i < card->num_links; i++) {
1696                         ret = soc_probe_link_components(card, i, order);
1697                         if (ret < 0) {
1698                                 dev_err(card->dev,
1699                                         "ASoC: failed to instantiate card %d\n",
1700                                         ret);
1701                                 goto probe_dai_err;
1702                         }
1703                 }
1704         }
1705 
1706         /* probe all DAI links on this card */
1707         for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
1708                         order++) {
1709                 for (i = 0; i < card->num_links; i++) {
1710                         ret = soc_probe_link_dais(card, i, order);
1711                         if (ret < 0) {
1712                                 dev_err(card->dev,
1713                                         "ASoC: failed to instantiate card %d\n",
1714                                         ret);
1715                                 goto probe_dai_err;
1716                         }
1717                 }
1718         }
1719 
1720         for (i = 0; i < card->num_aux_devs; i++) {
1721                 ret = soc_probe_aux_dev(card, i);
1722                 if (ret < 0) {
1723                         dev_err(card->dev,
1724                                 "ASoC: failed to add auxiliary devices %d\n",
1725                                 ret);
1726                         goto probe_aux_dev_err;
1727                 }
1728         }
1729 
1730         snd_soc_dapm_link_dai_widgets(card);
1731         snd_soc_dapm_connect_dai_link_widgets(card);
1732 
1733         if (card->controls)
1734                 snd_soc_add_card_controls(card, card->controls, card->num_controls);
1735 
1736         if (card->dapm_routes)
1737                 snd_soc_dapm_add_routes(&card->dapm, card->dapm_routes,
1738                                         card->num_dapm_routes);
1739 
1740         for (i = 0; i < card->num_links; i++) {
1741                 dai_link = &card->dai_link[i];
1742                 dai_fmt = dai_link->dai_fmt;
1743 
1744                 if (dai_fmt) {
1745                         ret = snd_soc_dai_set_fmt(card->rtd[i].codec_dai,
1746                                                   dai_fmt);
1747                         if (ret != 0 && ret != -ENOTSUPP)
1748                                 dev_warn(card->rtd[i].codec_dai->dev,
1749                                          "ASoC: Failed to set DAI format: %d\n",
1750                                          ret);
1751                 }
1752 
1753                 /* If this is a regular CPU link there will be a platform */
1754                 if (dai_fmt &&
1755                     (dai_link->platform_name || dai_link->platform_of_node)) {
1756                         ret = snd_soc_dai_set_fmt(card->rtd[i].cpu_dai,
1757                                                   dai_fmt);
1758                         if (ret != 0 && ret != -ENOTSUPP)
1759                                 dev_warn(card->rtd[i].cpu_dai->dev,
1760                                          "ASoC: Failed to set DAI format: %d\n",
1761                                          ret);
1762                 } else if (dai_fmt) {
1763                         /* Flip the polarity for the "CPU" end */
1764                         dai_fmt &= ~SND_SOC_DAIFMT_MASTER_MASK;
1765                         switch (dai_link->dai_fmt &
1766                                 SND_SOC_DAIFMT_MASTER_MASK) {
1767                         case SND_SOC_DAIFMT_CBM_CFM:
1768                                 dai_fmt |= SND_SOC_DAIFMT_CBS_CFS;
1769                                 break;
1770                         case SND_SOC_DAIFMT_CBM_CFS:
1771                                 dai_fmt |= SND_SOC_DAIFMT_CBS_CFM;
1772                                 break;
1773                         case SND_SOC_DAIFMT_CBS_CFM:
1774                                 dai_fmt |= SND_SOC_DAIFMT_CBM_CFS;
1775                                 break;
1776                         case SND_SOC_DAIFMT_CBS_CFS:
1777                                 dai_fmt |= SND_SOC_DAIFMT_CBM_CFM;
1778                                 break;
1779                         }
1780 
1781                         ret = snd_soc_dai_set_fmt(card->rtd[i].cpu_dai,
1782                                                   dai_fmt);
1783                         if (ret != 0 && ret != -ENOTSUPP)
1784                                 dev_warn(card->rtd[i].cpu_dai->dev,
1785                                          "ASoC: Failed to set DAI format: %d\n",
1786                                          ret);
1787                 }
1788         }
1789 
1790         snprintf(card->snd_card->shortname, sizeof(card->snd_card->shortname),
1791                  "%s", card->name);
1792         snprintf(card->snd_card->longname, sizeof(card->snd_card->longname),
1793                  "%s", card->long_name ? card->long_name : card->name);
1794         snprintf(card->snd_card->driver, sizeof(card->snd_card->driver),
1795                  "%s", card->driver_name ? card->driver_name : card->name);
1796         for (i = 0; i < ARRAY_SIZE(card->snd_card->driver); i++) {
1797                 switch (card->snd_card->driver[i]) {
1798                 case '_':
1799                 case '-':
1800                 case '\0':
1801                         break;
1802                 default:
1803                         if (!isalnum(card->snd_card->driver[i]))
1804                                 card->snd_card->driver[i] = '_';
1805                         break;
1806                 }
1807         }
1808 
1809         if (card->late_probe) {
1810                 ret = card->late_probe(card);
1811                 if (ret < 0) {
1812                         dev_err(card->dev, "ASoC: %s late_probe() failed: %d\n",
1813                                 card->name, ret);
1814                         goto probe_aux_dev_err;
1815                 }
1816         }
1817 
1818         if (card->fully_routed)
1819                 list_for_each_entry(codec, &card->codec_dev_list, card_list)
1820                         snd_soc_dapm_auto_nc_codec_pins(codec);
1821 
1822         snd_soc_dapm_new_widgets(card);
1823 
1824         ret = snd_card_register(card->snd_card);
1825         if (ret < 0) {
1826                 dev_err(card->dev, "ASoC: failed to register soundcard %d\n",
1827                                 ret);
1828                 goto probe_aux_dev_err;
1829         }
1830 
1831 #ifdef CONFIG_SND_SOC_AC97_BUS
1832         /* register any AC97 codecs */
1833         for (i = 0; i < card->num_rtd; i++) {
1834                 ret = soc_register_ac97_dai_link(&card->rtd[i]);
1835                 if (ret < 0) {
1836                         dev_err(card->dev,
1837                                 "ASoC: failed to register AC97: %d\n", ret);
1838                         while (--i >= 0)
1839                                 soc_unregister_ac97_dai_link(card->rtd[i].codec);
1840                         goto probe_aux_dev_err;
1841                 }
1842         }
1843 #endif
1844 
1845         card->instantiated = 1;
1846         snd_soc_dapm_sync(&card->dapm);
1847         mutex_unlock(&card->mutex);
1848 
1849         return 0;
1850 
1851 probe_aux_dev_err:
1852         for (i = 0; i < card->num_aux_devs; i++)
1853                 soc_remove_aux_dev(card, i);
1854 
1855 probe_dai_err:
1856         soc_remove_dai_links(card);
1857 
1858 card_probe_error:
1859         if (card->remove)
1860                 card->remove(card);
1861 
1862         snd_card_free(card->snd_card);
1863 
1864 base_error:
1865         mutex_unlock(&card->mutex);
1866 
1867         return ret;
1868 }
1869 
1870 /* probes a new socdev */
1871 static int soc_probe(struct platform_device *pdev)
1872 {
1873         struct snd_soc_card *card = platform_get_drvdata(pdev);
1874 
1875         /*
1876          * no card, so machine driver should be registering card
1877          * we should not be here in that case so ret error
1878          */
1879         if (!card)
1880                 return -EINVAL;
1881 
1882         dev_warn(&pdev->dev,
1883                  "ASoC: machine %s should use snd_soc_register_card()\n",
1884                  card->name);
1885 
1886         /* Bodge while we unpick instantiation */
1887         card->dev = &pdev->dev;
1888 
1889         return snd_soc_register_card(card);
1890 }
1891 
1892 static int soc_cleanup_card_resources(struct snd_soc_card *card)
1893 {
1894         int i;
1895 
1896         /* make sure any delayed work runs */
1897         for (i = 0; i < card->num_rtd; i++) {
1898                 struct snd_soc_pcm_runtime *rtd = &card->rtd[i];
1899                 flush_delayed_work(&rtd->delayed_work);
1900         }
1901 
1902         /* remove auxiliary devices */
1903         for (i = 0; i < card->num_aux_devs; i++)
1904                 soc_remove_aux_dev(card, i);
1905 
1906         /* remove and free each DAI */
1907         soc_remove_dai_links(card);
1908 
1909         soc_cleanup_card_debugfs(card);
1910 
1911         /* remove the card */
1912         if (card->remove)
1913                 card->remove(card);
1914 
1915         snd_soc_dapm_free(&card->dapm);
1916 
1917         snd_card_free(card->snd_card);
1918         return 0;
1919 
1920 }
1921 
1922 /* removes a socdev */
1923 static int soc_remove(struct platform_device *pdev)
1924 {
1925         struct snd_soc_card *card = platform_get_drvdata(pdev);
1926 
1927         snd_soc_unregister_card(card);
1928         return 0;
1929 }
1930 
1931 int snd_soc_poweroff(struct device *dev)
1932 {
1933         struct snd_soc_card *card = dev_get_drvdata(dev);
1934         int i;
1935 
1936         if (!card->instantiated)
1937                 return 0;
1938 
1939         /* Flush out pmdown_time work - we actually do want to run it
1940          * now, we're shutting down so no imminent restart. */
1941         for (i = 0; i < card->num_rtd; i++) {
1942                 struct snd_soc_pcm_runtime *rtd = &card->rtd[i];
1943                 flush_delayed_work(&rtd->delayed_work);
1944         }
1945 
1946         snd_soc_dapm_shutdown(card);
1947 
1948         /* deactivate pins to sleep state */
1949         for (i = 0; i < card->num_rtd; i++) {
1950                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
1951                 struct snd_soc_dai *codec_dai = card->rtd[i].codec_dai;
1952                 pinctrl_pm_select_sleep_state(codec_dai->dev);
1953                 pinctrl_pm_select_sleep_state(cpu_dai->dev);
1954         }
1955 
1956         return 0;
1957 }
1958 EXPORT_SYMBOL_GPL(snd_soc_poweroff);
1959 
1960 const struct dev_pm_ops snd_soc_pm_ops = {
1961         .suspend = snd_soc_suspend,
1962         .resume = snd_soc_resume,
1963         .freeze = snd_soc_suspend,
1964         .thaw = snd_soc_resume,
1965         .poweroff = snd_soc_poweroff,
1966         .restore = snd_soc_resume,
1967 };
1968 EXPORT_SYMBOL_GPL(snd_soc_pm_ops);
1969 
1970 /* ASoC platform driver */
1971 static struct platform_driver soc_driver = {
1972         .driver         = {
1973                 .name           = "soc-audio",
1974                 .owner          = THIS_MODULE,
1975                 .pm             = &snd_soc_pm_ops,
1976         },
1977         .probe          = soc_probe,
1978         .remove         = soc_remove,
1979 };
1980 
1981 /**
1982  * snd_soc_codec_volatile_register: Report if a register is volatile.
1983  *
1984  * @codec: CODEC to query.
1985  * @reg: Register to query.
1986  *
1987  * Boolean function indiciating if a CODEC register is volatile.
1988  */
1989 int snd_soc_codec_volatile_register(struct snd_soc_codec *codec,
1990                                     unsigned int reg)
1991 {
1992         if (codec->volatile_register)
1993                 return codec->volatile_register(codec, reg);
1994         else
1995                 return 0;
1996 }
1997 EXPORT_SYMBOL_GPL(snd_soc_codec_volatile_register);
1998 
1999 /**
2000  * snd_soc_codec_readable_register: Report if a register is readable.
2001  *
2002  * @codec: CODEC to query.
2003  * @reg: Register to query.
2004  *
2005  * Boolean function indicating if a CODEC register is readable.
2006  */
2007 int snd_soc_codec_readable_register(struct snd_soc_codec *codec,
2008                                     unsigned int reg)
2009 {
2010         if (codec->readable_register)
2011                 return codec->readable_register(codec, reg);
2012         else
2013                 return 1;
2014 }
2015 EXPORT_SYMBOL_GPL(snd_soc_codec_readable_register);
2016 
2017 /**
2018  * snd_soc_codec_writable_register: Report if a register is writable.
2019  *
2020  * @codec: CODEC to query.
2021  * @reg: Register to query.
2022  *
2023  * Boolean function indicating if a CODEC register is writable.
2024  */
2025 int snd_soc_codec_writable_register(struct snd_soc_codec *codec,
2026                                     unsigned int reg)
2027 {
2028         if (codec->writable_register)
2029                 return codec->writable_register(codec, reg);
2030         else
2031                 return 1;
2032 }
2033 EXPORT_SYMBOL_GPL(snd_soc_codec_writable_register);
2034 
2035 int snd_soc_platform_read(struct snd_soc_platform *platform,
2036                                         unsigned int reg)
2037 {
2038         unsigned int ret;
2039 
2040         if (!platform->driver->read) {
2041                 dev_err(platform->dev, "ASoC: platform has no read back\n");
2042                 return -1;
2043         }
2044 
2045         ret = platform->driver->read(platform, reg);
2046         dev_dbg(platform->dev, "read %x => %x\n", reg, ret);
2047         trace_snd_soc_preg_read(platform, reg, ret);
2048 
2049         return ret;
2050 }
2051 EXPORT_SYMBOL_GPL(snd_soc_platform_read);
2052 
2053 int snd_soc_platform_write(struct snd_soc_platform *platform,
2054                                          unsigned int reg, unsigned int val)
2055 {
2056         if (!platform->driver->write) {
2057                 dev_err(platform->dev, "ASoC: platform has no write back\n");
2058                 return -1;
2059         }
2060 
2061         dev_dbg(platform->dev, "write %x = %x\n", reg, val);
2062         trace_snd_soc_preg_write(platform, reg, val);
2063         return platform->driver->write(platform, reg, val);
2064 }
2065 EXPORT_SYMBOL_GPL(snd_soc_platform_write);
2066 
2067 /**
2068  * snd_soc_new_ac97_codec - initailise AC97 device
2069  * @codec: audio codec
2070  * @ops: AC97 bus operations
2071  * @num: AC97 codec number
2072  *
2073  * Initialises AC97 codec resources for use by ad-hoc devices only.
2074  */
2075 int snd_soc_new_ac97_codec(struct snd_soc_codec *codec,
2076         struct snd_ac97_bus_ops *ops, int num)
2077 {
2078         mutex_lock(&codec->mutex);
2079 
2080         codec->ac97 = kzalloc(sizeof(struct snd_ac97), GFP_KERNEL);
2081         if (codec->ac97 == NULL) {
2082                 mutex_unlock(&codec->mutex);
2083                 return -ENOMEM;
2084         }
2085 
2086         codec->ac97->bus = kzalloc(sizeof(struct snd_ac97_bus), GFP_KERNEL);
2087         if (codec->ac97->bus == NULL) {
2088                 kfree(codec->ac97);
2089                 codec->ac97 = NULL;
2090                 mutex_unlock(&codec->mutex);
2091                 return -ENOMEM;
2092         }
2093 
2094         codec->ac97->bus->ops = ops;
2095         codec->ac97->num = num;
2096 
2097         /*
2098          * Mark the AC97 device to be created by us. This way we ensure that the
2099          * device will be registered with the device subsystem later on.
2100          */
2101         codec->ac97_created = 1;
2102 
2103         mutex_unlock(&codec->mutex);
2104         return 0;
2105 }
2106 EXPORT_SYMBOL_GPL(snd_soc_new_ac97_codec);
2107 
2108 static struct snd_ac97_reset_cfg snd_ac97_rst_cfg;
2109 
2110 static void snd_soc_ac97_warm_reset(struct snd_ac97 *ac97)
2111 {
2112         struct pinctrl *pctl = snd_ac97_rst_cfg.pctl;
2113 
2114         pinctrl_select_state(pctl, snd_ac97_rst_cfg.pstate_warm_reset);
2115 
2116         gpio_direction_output(snd_ac97_rst_cfg.gpio_sync, 1);
2117 
2118         udelay(10);
2119 
2120         gpio_direction_output(snd_ac97_rst_cfg.gpio_sync, 0);
2121 
2122         pinctrl_select_state(pctl, snd_ac97_rst_cfg.pstate_run);
2123         msleep(2);
2124 }
2125 
2126 static void snd_soc_ac97_reset(struct snd_ac97 *ac97)
2127 {
2128         struct pinctrl *pctl = snd_ac97_rst_cfg.pctl;
2129 
2130         pinctrl_select_state(pctl, snd_ac97_rst_cfg.pstate_reset);
2131 
2132         gpio_direction_output(snd_ac97_rst_cfg.gpio_sync, 0);
2133         gpio_direction_output(snd_ac97_rst_cfg.gpio_sdata, 0);
2134         gpio_direction_output(snd_ac97_rst_cfg.gpio_reset, 0);
2135 
2136         udelay(10);
2137 
2138         gpio_direction_output(snd_ac97_rst_cfg.gpio_reset, 1);
2139 
2140         pinctrl_select_state(pctl, snd_ac97_rst_cfg.pstate_run);
2141         msleep(2);
2142 }
2143 
2144 static int snd_soc_ac97_parse_pinctl(struct device *dev,
2145                 struct snd_ac97_reset_cfg *cfg)
2146 {
2147         struct pinctrl *p;
2148         struct pinctrl_state *state;
2149         int gpio;
2150         int ret;
2151 
2152         p = devm_pinctrl_get(dev);
2153         if (IS_ERR(p)) {
2154                 dev_err(dev, "Failed to get pinctrl\n");
2155                 return PTR_RET(p);
2156         }
2157         cfg->pctl = p;
2158 
2159         state = pinctrl_lookup_state(p, "ac97-reset");
2160         if (IS_ERR(state)) {
2161                 dev_err(dev, "Can't find pinctrl state ac97-reset\n");
2162                 return PTR_RET(state);
2163         }
2164         cfg->pstate_reset = state;
2165 
2166         state = pinctrl_lookup_state(p, "ac97-warm-reset");
2167         if (IS_ERR(state)) {
2168                 dev_err(dev, "Can't find pinctrl state ac97-warm-reset\n");
2169                 return PTR_RET(state);
2170         }
2171         cfg->pstate_warm_reset = state;
2172 
2173         state = pinctrl_lookup_state(p, "ac97-running");
2174         if (IS_ERR(state)) {
2175                 dev_err(dev, "Can't find pinctrl state ac97-running\n");
2176                 return PTR_RET(state);
2177         }
2178         cfg->pstate_run = state;
2179 
2180         gpio = of_get_named_gpio(dev->of_node, "ac97-gpios", 0);
2181         if (gpio < 0) {
2182                 dev_err(dev, "Can't find ac97-sync gpio\n");
2183                 return gpio;
2184         }
2185         ret = devm_gpio_request(dev, gpio, "AC97 link sync");
2186         if (ret) {
2187                 dev_err(dev, "Failed requesting ac97-sync gpio\n");
2188                 return ret;
2189         }
2190         cfg->gpio_sync = gpio;
2191 
2192         gpio = of_get_named_gpio(dev->of_node, "ac97-gpios", 1);
2193         if (gpio < 0) {
2194                 dev_err(dev, "Can't find ac97-sdata gpio %d\n", gpio);
2195                 return gpio;
2196         }
2197         ret = devm_gpio_request(dev, gpio, "AC97 link sdata");
2198         if (ret) {
2199                 dev_err(dev, "Failed requesting ac97-sdata gpio\n");
2200                 return ret;
2201         }
2202         cfg->gpio_sdata = gpio;
2203 
2204         gpio = of_get_named_gpio(dev->of_node, "ac97-gpios", 2);
2205         if (gpio < 0) {
2206                 dev_err(dev, "Can't find ac97-reset gpio\n");
2207                 return gpio;
2208         }
2209         ret = devm_gpio_request(dev, gpio, "AC97 link reset");
2210         if (ret) {
2211                 dev_err(dev, "Failed requesting ac97-reset gpio\n");
2212                 return ret;
2213         }
2214         cfg->gpio_reset = gpio;
2215 
2216         return 0;
2217 }
2218 
2219 struct snd_ac97_bus_ops *soc_ac97_ops;
2220 EXPORT_SYMBOL_GPL(soc_ac97_ops);
2221 
2222 int snd_soc_set_ac97_ops(struct snd_ac97_bus_ops *ops)
2223 {
2224         if (ops == soc_ac97_ops)
2225                 return 0;
2226 
2227         if (soc_ac97_ops && ops)
2228                 return -EBUSY;
2229 
2230         soc_ac97_ops = ops;
2231 
2232         return 0;
2233 }
2234 EXPORT_SYMBOL_GPL(snd_soc_set_ac97_ops);
2235 
2236 /**
2237  * snd_soc_set_ac97_ops_of_reset - Set ac97 ops with generic ac97 reset functions
2238  *
2239  * This function sets the reset and warm_reset properties of ops and parses
2240  * the device node of pdev to get pinctrl states and gpio numbers to use.
2241  */
2242 int snd_soc_set_ac97_ops_of_reset(struct snd_ac97_bus_ops *ops,
2243                 struct platform_device *pdev)
2244 {
2245         struct device *dev = &pdev->dev;
2246         struct snd_ac97_reset_cfg cfg;
2247         int ret;
2248 
2249         ret = snd_soc_ac97_parse_pinctl(dev, &cfg);
2250         if (ret)
2251                 return ret;
2252 
2253         ret = snd_soc_set_ac97_ops(ops);
2254         if (ret)
2255                 return ret;
2256 
2257         ops->warm_reset = snd_soc_ac97_warm_reset;
2258         ops->reset = snd_soc_ac97_reset;
2259 
2260         snd_ac97_rst_cfg = cfg;
2261         return 0;
2262 }
2263 EXPORT_SYMBOL_GPL(snd_soc_set_ac97_ops_of_reset);
2264 
2265 /**
2266  * snd_soc_free_ac97_codec - free AC97 codec device
2267  * @codec: audio codec
2268  *
2269  * Frees AC97 codec device resources.
2270  */
2271 void snd_soc_free_ac97_codec(struct snd_soc_codec *codec)
2272 {
2273         mutex_lock(&codec->mutex);
2274 #ifdef CONFIG_SND_SOC_AC97_BUS
2275         soc_unregister_ac97_dai_link(codec);
2276 #endif
2277         kfree(codec->ac97->bus);
2278         kfree(codec->ac97);
2279         codec->ac97 = NULL;
2280         codec->ac97_created = 0;
2281         mutex_unlock(&codec->mutex);
2282 }
2283 EXPORT_SYMBOL_GPL(snd_soc_free_ac97_codec);
2284 
2285 unsigned int snd_soc_read(struct snd_soc_codec *codec, unsigned int reg)
2286 {
2287         unsigned int ret;
2288 
2289         ret = codec->read(codec, reg);
2290         dev_dbg(codec->dev, "read %x => %x\n", reg, ret);
2291         trace_snd_soc_reg_read(codec, reg, ret);
2292 
2293         return ret;
2294 }
2295 EXPORT_SYMBOL_GPL(snd_soc_read);
2296 
2297 unsigned int snd_soc_write(struct snd_soc_codec *codec,
2298                            unsigned int reg, unsigned int val)
2299 {
2300         dev_dbg(codec->dev, "write %x = %x\n", reg, val);
2301         trace_snd_soc_reg_write(codec, reg, val);
2302         return codec->write(codec, reg, val);
2303 }
2304 EXPORT_SYMBOL_GPL(snd_soc_write);
2305 
2306 /**
2307  * snd_soc_update_bits - update codec register bits
2308  * @codec: audio codec
2309  * @reg: codec register
2310  * @mask: register mask
2311  * @value: new value
2312  *
2313  * Writes new register value.
2314  *
2315  * Returns 1 for change, 0 for no change, or negative error code.
2316  */
2317 int snd_soc_update_bits(struct snd_soc_codec *codec, unsigned short reg,
2318                                 unsigned int mask, unsigned int value)
2319 {
2320         bool change;
2321         unsigned int old, new;
2322         int ret;
2323 
2324         if (codec->using_regmap) {
2325                 ret = regmap_update_bits_check(codec->control_data, reg,
2326                                                mask, value, &change);
2327         } else {
2328                 ret = snd_soc_read(codec, reg);
2329                 if (ret < 0)
2330                         return ret;
2331 
2332                 old = ret;
2333                 new = (old & ~mask) | (value & mask);
2334                 change = old != new;
2335                 if (change)
2336                         ret = snd_soc_write(codec, reg, new);
2337         }
2338 
2339         if (ret < 0)
2340                 return ret;
2341 
2342         return change;
2343 }
2344 EXPORT_SYMBOL_GPL(snd_soc_update_bits);
2345 
2346 /**
2347  * snd_soc_update_bits_locked - update codec register bits
2348  * @codec: audio codec
2349  * @reg: codec register
2350  * @mask: register mask
2351  * @value: new value
2352  *
2353  * Writes new register value, and takes the codec mutex.
2354  *
2355  * Returns 1 for change else 0.
2356  */
2357 int snd_soc_update_bits_locked(struct snd_soc_codec *codec,
2358                                unsigned short reg, unsigned int mask,
2359                                unsigned int value)
2360 {
2361         int change;
2362 
2363         mutex_lock(&codec->mutex);
2364         change = snd_soc_update_bits(codec, reg, mask, value);
2365         mutex_unlock(&codec->mutex);
2366 
2367         return change;
2368 }
2369 EXPORT_SYMBOL_GPL(snd_soc_update_bits_locked);
2370 
2371 /**
2372  * snd_soc_test_bits - test register for change
2373  * @codec: audio codec
2374  * @reg: codec register
2375  * @mask: register mask
2376  * @value: new value
2377  *
2378  * Tests a register with a new value and checks if the new value is
2379  * different from the old value.
2380  *
2381  * Returns 1 for change else 0.
2382  */
2383 int snd_soc_test_bits(struct snd_soc_codec *codec, unsigned short reg,
2384                                 unsigned int mask, unsigned int value)
2385 {
2386         int change;
2387         unsigned int old, new;
2388 
2389         old = snd_soc_read(codec, reg);
2390         new = (old & ~mask) | value;
2391         change = old != new;
2392 
2393         return change;
2394 }
2395 EXPORT_SYMBOL_GPL(snd_soc_test_bits);
2396 
2397 /**
2398  * snd_soc_cnew - create new control
2399  * @_template: control template
2400  * @data: control private data
2401  * @long_name: control long name
2402  * @prefix: control name prefix
2403  *
2404  * Create a new mixer control from a template control.
2405  *
2406  * Returns 0 for success, else error.
2407  */
2408 struct snd_kcontrol *snd_soc_cnew(const struct snd_kcontrol_new *_template,
2409                                   void *data, const char *long_name,
2410                                   const char *prefix)
2411 {
2412         struct snd_kcontrol_new template;
2413         struct snd_kcontrol *kcontrol;
2414         char *name = NULL;
2415 
2416         memcpy(&template, _template, sizeof(template));
2417         template.index = 0;
2418 
2419         if (!long_name)
2420                 long_name = template.name;
2421 
2422         if (prefix) {
2423                 name = kasprintf(GFP_KERNEL, "%s %s", prefix, long_name);
2424                 if (!name)
2425                         return NULL;
2426 
2427                 template.name = name;
2428         } else {
2429                 template.name = long_name;
2430         }
2431 
2432         kcontrol = snd_ctl_new1(&template, data);
2433 
2434         kfree(name);
2435 
2436         return kcontrol;
2437 }
2438 EXPORT_SYMBOL_GPL(snd_soc_cnew);
2439 
2440 static int snd_soc_add_controls(struct snd_card *card, struct device *dev,
2441         const struct snd_kcontrol_new *controls, int num_controls,
2442         const char *prefix, void *data)
2443 {
2444         int err, i;
2445 
2446         for (i = 0; i < num_controls; i++) {
2447                 const struct snd_kcontrol_new *control = &controls[i];
2448                 err = snd_ctl_add(card, snd_soc_cnew(control, data,
2449                                                      control->name, prefix));
2450                 if (err < 0) {
2451                         dev_err(dev, "ASoC: Failed to add %s: %d\n",
2452                                 control->name, err);
2453                         return err;
2454                 }
2455         }
2456 
2457         return 0;
2458 }
2459 
2460 struct snd_kcontrol *snd_soc_card_get_kcontrol(struct snd_soc_card *soc_card,
2461                                                const char *name)
2462 {
2463         struct snd_card *card = soc_card->snd_card;
2464         struct snd_kcontrol *kctl;
2465 
2466         if (unlikely(!name))
2467                 return NULL;
2468 
2469         list_for_each_entry(kctl, &card->controls, list)
2470                 if (!strncmp(kctl->id.name, name, sizeof(kctl->id.name)))
2471                         return kctl;
2472         return NULL;
2473 }
2474 EXPORT_SYMBOL_GPL(snd_soc_card_get_kcontrol);
2475 
2476 /**
2477  * snd_soc_add_codec_controls - add an array of controls to a codec.
2478  * Convenience function to add a list of controls. Many codecs were
2479  * duplicating this code.
2480  *
2481  * @codec: codec to add controls to
2482  * @controls: array of controls to add
2483  * @num_controls: number of elements in the array
2484  *
2485  * Return 0 for success, else error.
2486  */
2487 int snd_soc_add_codec_controls(struct snd_soc_codec *codec,
2488         const struct snd_kcontrol_new *controls, int num_controls)
2489 {
2490         struct snd_card *card = codec->card->snd_card;
2491 
2492         return snd_soc_add_controls(card, codec->dev, controls, num_controls,
2493                         codec->name_prefix, codec);
2494 }
2495 EXPORT_SYMBOL_GPL(snd_soc_add_codec_controls);
2496 
2497 /**
2498  * snd_soc_add_platform_controls - add an array of controls to a platform.
2499  * Convenience function to add a list of controls.
2500  *
2501  * @platform: platform to add controls to
2502  * @controls: array of controls to add
2503  * @num_controls: number of elements in the array
2504  *
2505  * Return 0 for success, else error.
2506  */
2507 int snd_soc_add_platform_controls(struct snd_soc_platform *platform,
2508         const struct snd_kcontrol_new *controls, int num_controls)
2509 {
2510         struct snd_card *card = platform->card->snd_card;
2511 
2512         return snd_soc_add_controls(card, platform->dev, controls, num_controls,
2513                         NULL, platform);
2514 }
2515 EXPORT_SYMBOL_GPL(snd_soc_add_platform_controls);
2516 
2517 /**
2518  * snd_soc_add_card_controls - add an array of controls to a SoC card.
2519  * Convenience function to add a list of controls.
2520  *
2521  * @soc_card: SoC card to add controls to
2522  * @controls: array of controls to add
2523  * @num_controls: number of elements in the array
2524  *
2525  * Return 0 for success, else error.
2526  */
2527 int snd_soc_add_card_controls(struct snd_soc_card *soc_card,
2528         const struct snd_kcontrol_new *controls, int num_controls)
2529 {
2530         struct snd_card *card = soc_card->snd_card;
2531 
2532         return snd_soc_add_controls(card, soc_card->dev, controls, num_controls,
2533                         NULL, soc_card);
2534 }
2535 EXPORT_SYMBOL_GPL(snd_soc_add_card_controls);
2536 
2537 /**
2538  * snd_soc_add_dai_controls - add an array of controls to a DAI.
2539  * Convienience function to add a list of controls.
2540  *
2541  * @dai: DAI to add controls to
2542  * @controls: array of controls to add
2543  * @num_controls: number of elements in the array
2544  *
2545  * Return 0 for success, else error.
2546  */
2547 int snd_soc_add_dai_controls(struct snd_soc_dai *dai,
2548         const struct snd_kcontrol_new *controls, int num_controls)
2549 {
2550         struct snd_card *card = dai->card->snd_card;
2551 
2552         return snd_soc_add_controls(card, dai->dev, controls, num_controls,
2553                         NULL, dai);
2554 }
2555 EXPORT_SYMBOL_GPL(snd_soc_add_dai_controls);
2556 
2557 /**
2558  * snd_soc_info_enum_double - enumerated double mixer info callback
2559  * @kcontrol: mixer control
2560  * @uinfo: control element information
2561  *
2562  * Callback to provide information about a double enumerated
2563  * mixer control.
2564  *
2565  * Returns 0 for success.
2566  */
2567 int snd_soc_info_enum_double(struct snd_kcontrol *kcontrol,
2568         struct snd_ctl_elem_info *uinfo)
2569 {
2570         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2571 
2572         uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
2573         uinfo->count = e->shift_l == e->shift_r ? 1 : 2;
2574         uinfo->value.enumerated.items = e->max;
2575 
2576         if (uinfo->value.enumerated.item > e->max - 1)
2577                 uinfo->value.enumerated.item = e->max - 1;
2578         strlcpy(uinfo->value.enumerated.name,
2579                 e->texts[uinfo->value.enumerated.item],
2580                 sizeof(uinfo->value.enumerated.name));
2581         return 0;
2582 }
2583 EXPORT_SYMBOL_GPL(snd_soc_info_enum_double);
2584 
2585 /**
2586  * snd_soc_get_enum_double - enumerated double mixer get callback
2587  * @kcontrol: mixer control
2588  * @ucontrol: control element information
2589  *
2590  * Callback to get the value of a double enumerated mixer.
2591  *
2592  * Returns 0 for success.
2593  */
2594 int snd_soc_get_enum_double(struct snd_kcontrol *kcontrol,
2595         struct snd_ctl_elem_value *ucontrol)
2596 {
2597         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2598         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2599         unsigned int val;
2600 
2601         val = snd_soc_read(codec, e->reg);
2602         ucontrol->value.enumerated.item[0]
2603                 = (val >> e->shift_l) & e->mask;
2604         if (e->shift_l != e->shift_r)
2605                 ucontrol->value.enumerated.item[1] =
2606                         (val >> e->shift_r) & e->mask;
2607 
2608         return 0;
2609 }
2610 EXPORT_SYMBOL_GPL(snd_soc_get_enum_double);
2611 
2612 /**
2613  * snd_soc_put_enum_double - enumerated double mixer put callback
2614  * @kcontrol: mixer control
2615  * @ucontrol: control element information
2616  *
2617  * Callback to set the value of a double enumerated mixer.
2618  *
2619  * Returns 0 for success.
2620  */
2621 int snd_soc_put_enum_double(struct snd_kcontrol *kcontrol,
2622         struct snd_ctl_elem_value *ucontrol)
2623 {
2624         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2625         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2626         unsigned int val;
2627         unsigned int mask;
2628 
2629         if (ucontrol->value.enumerated.item[0] > e->max - 1)
2630                 return -EINVAL;
2631         val = ucontrol->value.enumerated.item[0] << e->shift_l;
2632         mask = e->mask << e->shift_l;
2633         if (e->shift_l != e->shift_r) {
2634                 if (ucontrol->value.enumerated.item[1] > e->max - 1)
2635                         return -EINVAL;
2636                 val |= ucontrol->value.enumerated.item[1] << e->shift_r;
2637                 mask |= e->mask << e->shift_r;
2638         }
2639 
2640         return snd_soc_update_bits_locked(codec, e->reg, mask, val);
2641 }
2642 EXPORT_SYMBOL_GPL(snd_soc_put_enum_double);
2643 
2644 /**
2645  * snd_soc_get_value_enum_double - semi enumerated double mixer get callback
2646  * @kcontrol: mixer control
2647  * @ucontrol: control element information
2648  *
2649  * Callback to get the value of a double semi enumerated mixer.
2650  *
2651  * Semi enumerated mixer: the enumerated items are referred as values. Can be
2652  * used for handling bitfield coded enumeration for example.
2653  *
2654  * Returns 0 for success.
2655  */
2656 int snd_soc_get_value_enum_double(struct snd_kcontrol *kcontrol,
2657         struct snd_ctl_elem_value *ucontrol)
2658 {
2659         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2660         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2661         unsigned int reg_val, val, mux;
2662 
2663         reg_val = snd_soc_read(codec, e->reg);
2664         val = (reg_val >> e->shift_l) & e->mask;
2665         for (mux = 0; mux < e->max; mux++) {
2666                 if (val == e->values[mux])
2667                         break;
2668         }
2669         ucontrol->value.enumerated.item[0] = mux;
2670         if (e->shift_l != e->shift_r) {
2671                 val = (reg_val >> e->shift_r) & e->mask;
2672                 for (mux = 0; mux < e->max; mux++) {
2673                         if (val == e->values[mux])
2674                                 break;
2675                 }
2676                 ucontrol->value.enumerated.item[1] = mux;
2677         }
2678 
2679         return 0;
2680 }
2681 EXPORT_SYMBOL_GPL(snd_soc_get_value_enum_double);
2682 
2683 /**
2684  * snd_soc_put_value_enum_double - semi enumerated double mixer put callback
2685  * @kcontrol: mixer control
2686  * @ucontrol: control element information
2687  *
2688  * Callback to set the value of a double semi enumerated mixer.
2689  *
2690  * Semi enumerated mixer: the enumerated items are referred as values. Can be
2691  * used for handling bitfield coded enumeration for example.
2692  *
2693  * Returns 0 for success.
2694  */
2695 int snd_soc_put_value_enum_double(struct snd_kcontrol *kcontrol,
2696         struct snd_ctl_elem_value *ucontrol)
2697 {
2698         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2699         struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
2700         unsigned int val;
2701         unsigned int mask;
2702 
2703         if (ucontrol->value.enumerated.item[0] > e->max - 1)
2704                 return -EINVAL;
2705         val = e->values[ucontrol->value.enumerated.item[0]] << e->shift_l;
2706         mask = e->mask << e->shift_l;
2707         if (e->shift_l != e->shift_r) {
2708                 if (ucontrol->value.enumerated.item[1] > e->max - 1)
2709                         return -EINVAL;
2710                 val |= e->values[ucontrol->value.enumerated.item[1]] << e->shift_r;
2711                 mask |= e->mask << e->shift_r;
2712         }
2713 
2714         return snd_soc_update_bits_locked(codec, e->reg, mask, val);
2715 }
2716 EXPORT_SYMBOL_GPL(snd_soc_put_value_enum_double);
2717 
2718 /**
2719  * snd_soc_info_volsw - single mixer info callback
2720  * @kcontrol: mixer control
2721  * @uinfo: control element information
2722  *
2723  * Callback to provide information about a single mixer control, or a double
2724  * mixer control that spans 2 registers.
2725  *
2726  * Returns 0 for success.
2727  */
2728 int snd_soc_info_volsw(struct snd_kcontrol *kcontrol,
2729         struct snd_ctl_elem_info *uinfo)
2730 {
2731         struct soc_mixer_control *mc =
2732                 (struct soc_mixer_control *)kcontrol->private_value;
2733         int platform_max;
2734 
2735         if (!mc->platform_max)
2736                 mc->platform_max = mc->max;
2737         platform_max = mc->platform_max;
2738 
2739         if (platform_max == 1 && !strstr(kcontrol->id.name, " Volume"))
2740                 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
2741         else
2742                 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
2743 
2744         uinfo->count = snd_soc_volsw_is_stereo(mc) ? 2 : 1;
2745         uinfo->value.integer.min = 0;
2746         uinfo->value.integer.max = platform_max;
2747         return 0;
2748 }
2749 EXPORT_SYMBOL_GPL(snd_soc_info_volsw);
2750 
2751 /**
2752  * snd_soc_get_volsw - single mixer get callback
2753  * @kcontrol: mixer control
2754  * @ucontrol: control element information
2755  *
2756  * Callback to get the value of a single mixer control, or a double mixer
2757  * control that spans 2 registers.
2758  *
2759  * Returns 0 for success.
2760  */
2761 int snd_soc_get_volsw(struct snd_kcontrol *kcontrol,
2762         struct snd_ctl_elem_value *ucontrol)
2763 {
2764         struct soc_mixer_control *mc =
2765                 (struct soc_mixer_control *)kcontrol->private_value;
2766         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2767         unsigned int reg = mc->reg;
2768         unsigned int reg2 = mc->rreg;
2769         unsigned int shift = mc->shift;
2770         unsigned int rshift = mc->rshift;
2771         int max = mc->max;
2772         unsigned int mask = (1 << fls(max)) - 1;
2773         unsigned int invert = mc->invert;
2774 
2775         ucontrol->value.integer.value[0] =
2776                 (snd_soc_read(codec, reg) >> shift) & mask;
2777         if (invert)
2778                 ucontrol->value.integer.value[0] =
2779                         max - ucontrol->value.integer.value[0];
2780 
2781         if (snd_soc_volsw_is_stereo(mc)) {
2782                 if (reg == reg2)
2783                         ucontrol->value.integer.value[1] =
2784                                 (snd_soc_read(codec, reg) >> rshift) & mask;
2785                 else
2786                         ucontrol->value.integer.value[1] =
2787                                 (snd_soc_read(codec, reg2) >> shift) & mask;
2788                 if (invert)
2789                         ucontrol->value.integer.value[1] =
2790                                 max - ucontrol->value.integer.value[1];
2791         }
2792 
2793         return 0;
2794 }
2795 EXPORT_SYMBOL_GPL(snd_soc_get_volsw);
2796 
2797 /**
2798  * snd_soc_put_volsw - single mixer put callback
2799  * @kcontrol: mixer control
2800  * @ucontrol: control element information
2801  *
2802  * Callback to set the value of a single mixer control, or a double mixer
2803  * control that spans 2 registers.
2804  *
2805  * Returns 0 for success.
2806  */
2807 int snd_soc_put_volsw(struct snd_kcontrol *kcontrol,
2808         struct snd_ctl_elem_value *ucontrol)
2809 {
2810         struct soc_mixer_control *mc =
2811                 (struct soc_mixer_control *)kcontrol->private_value;
2812         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2813         unsigned int reg = mc->reg;
2814         unsigned int reg2 = mc->rreg;
2815         unsigned int shift = mc->shift;
2816         unsigned int rshift = mc->rshift;
2817         int max = mc->max;
2818         unsigned int mask = (1 << fls(max)) - 1;
2819         unsigned int invert = mc->invert;
2820         int err;
2821         bool type_2r = 0;
2822         unsigned int val2 = 0;
2823         unsigned int val, val_mask;
2824 
2825         val = (ucontrol->value.integer.value[0] & mask);
2826         if (invert)
2827                 val = max - val;
2828         val_mask = mask << shift;
2829         val = val << shift;
2830         if (snd_soc_volsw_is_stereo(mc)) {
2831                 val2 = (ucontrol->value.integer.value[1] & mask);
2832                 if (invert)
2833                         val2 = max - val2;
2834                 if (reg == reg2) {
2835                         val_mask |= mask << rshift;
2836                         val |= val2 << rshift;
2837                 } else {
2838                         val2 = val2 << shift;
2839                         type_2r = 1;
2840                 }
2841         }
2842         err = snd_soc_update_bits_locked(codec, reg, val_mask, val);
2843         if (err < 0)
2844                 return err;
2845 
2846         if (type_2r)
2847                 err = snd_soc_update_bits_locked(codec, reg2, val_mask, val2);
2848 
2849         return err;
2850 }
2851 EXPORT_SYMBOL_GPL(snd_soc_put_volsw);
2852 
2853 /**
2854  * snd_soc_get_volsw_sx - single mixer get callback
2855  * @kcontrol: mixer control
2856  * @ucontrol: control element information
2857  *
2858  * Callback to get the value of a single mixer control, or a double mixer
2859  * control that spans 2 registers.
2860  *
2861  * Returns 0 for success.
2862  */
2863 int snd_soc_get_volsw_sx(struct snd_kcontrol *kcontrol,
2864                       struct snd_ctl_elem_value *ucontrol)
2865 {
2866         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2867         struct soc_mixer_control *mc =
2868             (struct soc_mixer_control *)kcontrol->private_value;
2869 
2870         unsigned int reg = mc->reg;
2871         unsigned int reg2 = mc->rreg;
2872         unsigned int shift = mc->shift;
2873         unsigned int rshift = mc->rshift;
2874         int max = mc->max;
2875         int min = mc->min;
2876         int mask = (1 << (fls(min + max) - 1)) - 1;
2877 
2878         ucontrol->value.integer.value[0] =
2879             ((snd_soc_read(codec, reg) >> shift) - min) & mask;
2880 
2881         if (snd_soc_volsw_is_stereo(mc))
2882                 ucontrol->value.integer.value[1] =
2883                         ((snd_soc_read(codec, reg2) >> rshift) - min) & mask;
2884 
2885         return 0;
2886 }
2887 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_sx);
2888 
2889 /**
2890  * snd_soc_put_volsw_sx - double mixer set callback
2891  * @kcontrol: mixer control
2892  * @uinfo: control element information
2893  *
2894  * Callback to set the value of a double mixer control that spans 2 registers.
2895  *
2896  * Returns 0 for success.
2897  */
2898 int snd_soc_put_volsw_sx(struct snd_kcontrol *kcontrol,
2899                          struct snd_ctl_elem_value *ucontrol)
2900 {
2901         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2902         struct soc_mixer_control *mc =
2903             (struct soc_mixer_control *)kcontrol->private_value;
2904 
2905         unsigned int reg = mc->reg;
2906         unsigned int reg2 = mc->rreg;
2907         unsigned int shift = mc->shift;
2908         unsigned int rshift = mc->rshift;
2909         int max = mc->max;
2910         int min = mc->min;
2911         int mask = (1 << (fls(min + max) - 1)) - 1;
2912         int err = 0;
2913         unsigned short val, val_mask, val2 = 0;
2914 
2915         val_mask = mask << shift;
2916         val = (ucontrol->value.integer.value[0] + min) & mask;
2917         val = val << shift;
2918 
2919         err = snd_soc_update_bits_locked(codec, reg, val_mask, val);
2920         if (err < 0)
2921                 return err;
2922 
2923         if (snd_soc_volsw_is_stereo(mc)) {
2924                 val_mask = mask << rshift;
2925                 val2 = (ucontrol->value.integer.value[1] + min) & mask;
2926                 val2 = val2 << rshift;
2927 
2928                 if (snd_soc_update_bits_locked(codec, reg2, val_mask, val2))
2929                         return err;
2930         }
2931         return 0;
2932 }
2933 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_sx);
2934 
2935 /**
2936  * snd_soc_info_volsw_s8 - signed mixer info callback
2937  * @kcontrol: mixer control
2938  * @uinfo: control element information
2939  *
2940  * Callback to provide information about a signed mixer control.
2941  *
2942  * Returns 0 for success.
2943  */
2944 int snd_soc_info_volsw_s8(struct snd_kcontrol *kcontrol,
2945         struct snd_ctl_elem_info *uinfo)
2946 {
2947         struct soc_mixer_control *mc =
2948                 (struct soc_mixer_control *)kcontrol->private_value;
2949         int platform_max;
2950         int min = mc->min;
2951 
2952         if (!mc->platform_max)
2953                 mc->platform_max = mc->max;
2954         platform_max = mc->platform_max;
2955 
2956         uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
2957         uinfo->count = 2;
2958         uinfo->value.integer.min = 0;
2959         uinfo->value.integer.max = platform_max - min;
2960         return 0;
2961 }
2962 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_s8);
2963 
2964 /**
2965  * snd_soc_get_volsw_s8 - signed mixer get callback
2966  * @kcontrol: mixer control
2967  * @ucontrol: control element information
2968  *
2969  * Callback to get the value of a signed mixer control.
2970  *
2971  * Returns 0 for success.
2972  */
2973 int snd_soc_get_volsw_s8(struct snd_kcontrol *kcontrol,
2974         struct snd_ctl_elem_value *ucontrol)
2975 {
2976         struct soc_mixer_control *mc =
2977                 (struct soc_mixer_control *)kcontrol->private_value;
2978         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
2979         unsigned int reg = mc->reg;
2980         int min = mc->min;
2981         int val = snd_soc_read(codec, reg);
2982 
2983         ucontrol->value.integer.value[0] =
2984                 ((signed char)(val & 0xff))-min;
2985         ucontrol->value.integer.value[1] =
2986                 ((signed char)((val >> 8) & 0xff))-min;
2987         return 0;
2988 }
2989 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_s8);
2990 
2991 /**
2992  * snd_soc_put_volsw_sgn - signed mixer put callback
2993  * @kcontrol: mixer control
2994  * @ucontrol: control element information
2995  *
2996  * Callback to set the value of a signed mixer control.
2997  *
2998  * Returns 0 for success.
2999  */
3000 int snd_soc_put_volsw_s8(struct snd_kcontrol *kcontrol,
3001         struct snd_ctl_elem_value *ucontrol)
3002 {
3003         struct soc_mixer_control *mc =
3004                 (struct soc_mixer_control *)kcontrol->private_value;
3005         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3006         unsigned int reg = mc->reg;
3007         int min = mc->min;
3008         unsigned int val;
3009 
3010         val = (ucontrol->value.integer.value[0]+min) & 0xff;
3011         val |= ((ucontrol->value.integer.value[1]+min) & 0xff) << 8;
3012 
3013         return snd_soc_update_bits_locked(codec, reg, 0xffff, val);
3014 }
3015 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_s8);
3016 
3017 /**
3018  * snd_soc_info_volsw_range - single mixer info callback with range.
3019  * @kcontrol: mixer control
3020  * @uinfo: control element information
3021  *
3022  * Callback to provide information, within a range, about a single
3023  * mixer control.
3024  *
3025  * returns 0 for success.
3026  */
3027 int snd_soc_info_volsw_range(struct snd_kcontrol *kcontrol,
3028         struct snd_ctl_elem_info *uinfo)
3029 {
3030         struct soc_mixer_control *mc =
3031                 (struct soc_mixer_control *)kcontrol->private_value;
3032         int platform_max;
3033         int min = mc->min;
3034 
3035         if (!mc->platform_max)
3036                 mc->platform_max = mc->max;
3037         platform_max = mc->platform_max;
3038 
3039         uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
3040         uinfo->count = snd_soc_volsw_is_stereo(mc) ? 2 : 1;
3041         uinfo->value.integer.min = 0;
3042         uinfo->value.integer.max = platform_max - min;
3043 
3044         return 0;
3045 }
3046 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_range);
3047 
3048 /**
3049  * snd_soc_put_volsw_range - single mixer put value callback with range.
3050  * @kcontrol: mixer control
3051  * @ucontrol: control element information
3052  *
3053  * Callback to set the value, within a range, for a single mixer control.
3054  *
3055  * Returns 0 for success.
3056  */
3057 int snd_soc_put_volsw_range(struct snd_kcontrol *kcontrol,
3058         struct snd_ctl_elem_value *ucontrol)
3059 {
3060         struct soc_mixer_control *mc =
3061                 (struct soc_mixer_control *)kcontrol->private_value;
3062         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3063         unsigned int reg = mc->reg;
3064         unsigned int rreg = mc->rreg;
3065         unsigned int shift = mc->shift;
3066         int min = mc->min;
3067         int max = mc->max;
3068         unsigned int mask = (1 << fls(max)) - 1;
3069         unsigned int invert = mc->invert;
3070         unsigned int val, val_mask;
3071         int ret;
3072 
3073         val = ((ucontrol->value.integer.value[0] + min) & mask);
3074         if (invert)
3075                 val = max - val;
3076         val_mask = mask << shift;
3077         val = val << shift;
3078 
3079         ret = snd_soc_update_bits_locked(codec, reg, val_mask, val);
3080         if (ret < 0)
3081                 return ret;
3082 
3083         if (snd_soc_volsw_is_stereo(mc)) {
3084                 val = ((ucontrol->value.integer.value[1] + min) & mask);
3085                 if (invert)
3086                         val = max - val;
3087                 val_mask = mask << shift;
3088                 val = val << shift;
3089 
3090                 ret = snd_soc_update_bits_locked(codec, rreg, val_mask, val);
3091         }
3092 
3093         return ret;
3094 }
3095 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_range);
3096 
3097 /**
3098  * snd_soc_get_volsw_range - single mixer get callback with range
3099  * @kcontrol: mixer control
3100  * @ucontrol: control element information
3101  *
3102  * Callback to get the value, within a range, of a single mixer control.
3103  *
3104  * Returns 0 for success.
3105  */
3106 int snd_soc_get_volsw_range(struct snd_kcontrol *kcontrol,
3107         struct snd_ctl_elem_value *ucontrol)
3108 {
3109         struct soc_mixer_control *mc =
3110                 (struct soc_mixer_control *)kcontrol->private_value;
3111         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3112         unsigned int reg = mc->reg;
3113         unsigned int rreg = mc->rreg;
3114         unsigned int shift = mc->shift;
3115         int min = mc->min;
3116         int max = mc->max;
3117         unsigned int mask = (1 << fls(max)) - 1;
3118         unsigned int invert = mc->invert;
3119 
3120         ucontrol->value.integer.value[0] =
3121                 (snd_soc_read(codec, reg) >> shift) & mask;
3122         if (invert)
3123                 ucontrol->value.integer.value[0] =
3124                         max - ucontrol->value.integer.value[0];
3125         ucontrol->value.integer.value[0] =
3126                 ucontrol->value.integer.value[0] - min;
3127 
3128         if (snd_soc_volsw_is_stereo(mc)) {
3129                 ucontrol->value.integer.value[1] =
3130                         (snd_soc_read(codec, rreg) >> shift) & mask;
3131                 if (invert)
3132                         ucontrol->value.integer.value[1] =
3133                                 max - ucontrol->value.integer.value[1];
3134                 ucontrol->value.integer.value[1] =
3135                         ucontrol->value.integer.value[1] - min;
3136         }
3137 
3138         return 0;
3139 }
3140 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_range);
3141 
3142 /**
3143  * snd_soc_limit_volume - Set new limit to an existing volume control.
3144  *
3145  * @codec: where to look for the control
3146  * @name: Name of the control
3147  * @max: new maximum limit
3148  *
3149  * Return 0 for success, else error.
3150  */
3151 int snd_soc_limit_volume(struct snd_soc_codec *codec,
3152         const char *name, int max)
3153 {
3154         struct snd_card *card = codec->card->snd_card;
3155         struct snd_kcontrol *kctl;
3156         struct soc_mixer_control *mc;
3157         int found = 0;
3158         int ret = -EINVAL;
3159 
3160         /* Sanity check for name and max */
3161         if (unlikely(!name || max <= 0))
3162                 return -EINVAL;
3163 
3164         list_for_each_entry(kctl, &card->controls, list) {
3165                 if (!strncmp(kctl->id.name, name, sizeof(kctl->id.name))) {
3166                         found = 1;
3167                         break;
3168                 }
3169         }
3170         if (found) {
3171                 mc = (struct soc_mixer_control *)kctl->private_value;
3172                 if (max <= mc->max) {
3173                         mc->platform_max = max;
3174                         ret = 0;
3175                 }
3176         }
3177         return ret;
3178 }
3179 EXPORT_SYMBOL_GPL(snd_soc_limit_volume);
3180 
3181 int snd_soc_bytes_info(struct snd_kcontrol *kcontrol,
3182                        struct snd_ctl_elem_info *uinfo)
3183 {
3184         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3185         struct soc_bytes *params = (void *)kcontrol->private_value;
3186 
3187         uinfo->type = SNDRV_CTL_ELEM_TYPE_BYTES;
3188         uinfo->count = params->num_regs * codec->val_bytes;
3189 
3190         return 0;
3191 }
3192 EXPORT_SYMBOL_GPL(snd_soc_bytes_info);
3193 
3194 int snd_soc_bytes_get(struct snd_kcontrol *kcontrol,
3195                       struct snd_ctl_elem_value *ucontrol)
3196 {
3197         struct soc_bytes *params = (void *)kcontrol->private_value;
3198         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3199         int ret;
3200 
3201         if (codec->using_regmap)
3202                 ret = regmap_raw_read(codec->control_data, params->base,
3203                                       ucontrol->value.bytes.data,
3204                                       params->num_regs * codec->val_bytes);
3205         else
3206                 ret = -EINVAL;
3207 
3208         /* Hide any masked bytes to ensure consistent data reporting */
3209         if (ret == 0 && params->mask) {
3210                 switch (codec->val_bytes) {
3211                 case 1:
3212                         ucontrol->value.bytes.data[0] &= ~params->mask;
3213                         break;
3214                 case 2:
3215                         ((u16 *)(&ucontrol->value.bytes.data))[0]
3216                                 &= cpu_to_be16(~params->mask);
3217                         break;
3218                 case 4:
3219                         ((u32 *)(&ucontrol->value.bytes.data))[0]
3220                                 &= cpu_to_be32(~params->mask);
3221                         break;
3222                 default:
3223                         return -EINVAL;
3224                 }
3225         }
3226 
3227         return ret;
3228 }
3229 EXPORT_SYMBOL_GPL(snd_soc_bytes_get);
3230 
3231 int snd_soc_bytes_put(struct snd_kcontrol *kcontrol,
3232                       struct snd_ctl_elem_value *ucontrol)
3233 {
3234         struct soc_bytes *params = (void *)kcontrol->private_value;
3235         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3236         int ret, len;
3237         unsigned int val;
3238         void *data;
3239 
3240         if (!codec->using_regmap)
3241                 return -EINVAL;
3242 
3243         len = params->num_regs * codec->val_bytes;
3244 
3245         data = kmemdup(ucontrol->value.bytes.data, len, GFP_KERNEL | GFP_DMA);
3246         if (!data)
3247                 return -ENOMEM;
3248 
3249         /*
3250          * If we've got a mask then we need to preserve the register
3251          * bits.  We shouldn't modify the incoming data so take a
3252          * copy.
3253          */
3254         if (params->mask) {
3255                 ret = regmap_read(codec->control_data, params->base, &val);
3256                 if (ret != 0)
3257                         goto out;
3258 
3259                 val &= params->mask;
3260 
3261                 switch (codec->val_bytes) {
3262                 case 1:
3263                         ((u8 *)data)[0] &= ~params->mask;
3264                         ((u8 *)data)[0] |= val;
3265                         break;
3266                 case 2:
3267                         ((u16 *)data)[0] &= cpu_to_be16(~params->mask);
3268                         ((u16 *)data)[0] |= cpu_to_be16(val);
3269                         break;
3270                 case 4:
3271                         ((u32 *)data)[0] &= cpu_to_be32(~params->mask);
3272                         ((u32 *)data)[0] |= cpu_to_be32(val);
3273                         break;
3274                 default:
3275                         ret = -EINVAL;
3276                         goto out;
3277                 }
3278         }
3279 
3280         ret = regmap_raw_write(codec->control_data, params->base,
3281                                data, len);
3282 
3283 out:
3284         kfree(data);
3285 
3286         return ret;
3287 }
3288 EXPORT_SYMBOL_GPL(snd_soc_bytes_put);
3289 
3290 /**
3291  * snd_soc_info_xr_sx - signed multi register info callback
3292  * @kcontrol: mreg control
3293  * @uinfo: control element information
3294  *
3295  * Callback to provide information of a control that can
3296  * span multiple codec registers which together
3297  * forms a single signed value in a MSB/LSB manner.
3298  *
3299  * Returns 0 for success.
3300  */
3301 int snd_soc_info_xr_sx(struct snd_kcontrol *kcontrol,
3302         struct snd_ctl_elem_info *uinfo)
3303 {
3304         struct soc_mreg_control *mc =
3305                 (struct soc_mreg_control *)kcontrol->private_value;
3306         uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
3307         uinfo->count = 1;
3308         uinfo->value.integer.min = mc->min;
3309         uinfo->value.integer.max = mc->max;
3310 
3311         return 0;
3312 }
3313 EXPORT_SYMBOL_GPL(snd_soc_info_xr_sx);
3314 
3315 /**
3316  * snd_soc_get_xr_sx - signed multi register get callback
3317  * @kcontrol: mreg control
3318  * @ucontrol: control element information
3319  *
3320  * Callback to get the value of a control that can span
3321  * multiple codec registers which together forms a single
3322  * signed value in a MSB/LSB manner. The control supports
3323  * specifying total no of bits used to allow for bitfields
3324  * across the multiple codec registers.
3325  *
3326  * Returns 0 for success.
3327  */
3328 int snd_soc_get_xr_sx(struct snd_kcontrol *kcontrol,
3329         struct snd_ctl_elem_value *ucontrol)
3330 {
3331         struct soc_mreg_control *mc =
3332                 (struct soc_mreg_control *)kcontrol->private_value;
3333         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3334         unsigned int regbase = mc->regbase;
3335         unsigned int regcount = mc->regcount;
3336         unsigned int regwshift = codec->driver->reg_word_size * BITS_PER_BYTE;
3337         unsigned int regwmask = (1<<regwshift)-1;
3338         unsigned int invert = mc->invert;
3339         unsigned long mask = (1UL<<mc->nbits)-1;
3340         long min = mc->min;
3341         long max = mc->max;
3342         long val = 0;
3343         unsigned long regval;
3344         unsigned int i;
3345 
3346         for (i = 0; i < regcount; i++) {
3347                 regval = snd_soc_read(codec, regbase+i) & regwmask;
3348                 val |= regval << (regwshift*(regcount-i-1));
3349         }
3350         val &= mask;
3351         if (min < 0 && val > max)
3352                 val |= ~mask;
3353         if (invert)
3354                 val = max - val;
3355         ucontrol->value.integer.value[0] = val;
3356 
3357         return 0;
3358 }
3359 EXPORT_SYMBOL_GPL(snd_soc_get_xr_sx);
3360 
3361 /**
3362  * snd_soc_put_xr_sx - signed multi register get callback
3363  * @kcontrol: mreg control
3364  * @ucontrol: control element information
3365  *
3366  * Callback to set the value of a control that can span
3367  * multiple codec registers which together forms a single
3368  * signed value in a MSB/LSB manner. The control supports
3369  * specifying total no of bits used to allow for bitfields
3370  * across the multiple codec registers.
3371  *
3372  * Returns 0 for success.
3373  */
3374 int snd_soc_put_xr_sx(struct snd_kcontrol *kcontrol,
3375         struct snd_ctl_elem_value *ucontrol)
3376 {
3377         struct soc_mreg_control *mc =
3378                 (struct soc_mreg_control *)kcontrol->private_value;
3379         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3380         unsigned int regbase = mc->regbase;
3381         unsigned int regcount = mc->regcount;
3382         unsigned int regwshift = codec->driver->reg_word_size * BITS_PER_BYTE;
3383         unsigned int regwmask = (1<<regwshift)-1;
3384         unsigned int invert = mc->invert;
3385         unsigned long mask = (1UL<<mc->nbits)-1;
3386         long max = mc->max;
3387         long val = ucontrol->value.integer.value[0];
3388         unsigned int i, regval, regmask;
3389         int err;
3390 
3391         if (invert)
3392                 val = max - val;
3393         val &= mask;
3394         for (i = 0; i < regcount; i++) {
3395                 regval = (val >> (regwshift*(regcount-i-1))) & regwmask;
3396                 regmask = (mask >> (regwshift*(regcount-i-1))) & regwmask;
3397                 err = snd_soc_update_bits_locked(codec, regbase+i,
3398                                 regmask, regval);
3399                 if (err < 0)
3400                         return err;
3401         }
3402 
3403         return 0;
3404 }
3405 EXPORT_SYMBOL_GPL(snd_soc_put_xr_sx);
3406 
3407 /**
3408  * snd_soc_get_strobe - strobe get callback
3409  * @kcontrol: mixer control
3410  * @ucontrol: control element information
3411  *
3412  * Callback get the value of a strobe mixer control.
3413  *
3414  * Returns 0 for success.
3415  */
3416 int snd_soc_get_strobe(struct snd_kcontrol *kcontrol,
3417         struct snd_ctl_elem_value *ucontrol)
3418 {
3419         struct soc_mixer_control *mc =
3420                 (struct soc_mixer_control *)kcontrol->private_value;
3421         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3422         unsigned int reg = mc->reg;
3423         unsigned int shift = mc->shift;
3424         unsigned int mask = 1 << shift;
3425         unsigned int invert = mc->invert != 0;
3426         unsigned int val = snd_soc_read(codec, reg) & mask;
3427 
3428         if (shift != 0 && val != 0)
3429                 val = val >> shift;
3430         ucontrol->value.enumerated.item[0] = val ^ invert;
3431 
3432         return 0;
3433 }
3434 EXPORT_SYMBOL_GPL(snd_soc_get_strobe);
3435 
3436 /**
3437  * snd_soc_put_strobe - strobe put callback
3438  * @kcontrol: mixer control
3439  * @ucontrol: control element information
3440  *
3441  * Callback strobe a register bit to high then low (or the inverse)
3442  * in one pass of a single mixer enum control.
3443  *
3444  * Returns 1 for success.
3445  */
3446 int snd_soc_put_strobe(struct snd_kcontrol *kcontrol,
3447         struct snd_ctl_elem_value *ucontrol)
3448 {
3449         struct soc_mixer_control *mc =
3450                 (struct soc_mixer_control *)kcontrol->private_value;
3451         struct snd_soc_codec *codec = snd_kcontrol_chip(kcontrol);
3452         unsigned int reg = mc->reg;
3453         unsigned int shift = mc->shift;
3454         unsigned int mask = 1 << shift;
3455         unsigned int invert = mc->invert != 0;
3456         unsigned int strobe = ucontrol->value.enumerated.item[0] != 0;
3457         unsigned int val1 = (strobe ^ invert) ? mask : 0;
3458         unsigned int val2 = (strobe ^ invert) ? 0 : mask;
3459         int err;
3460 
3461         err = snd_soc_update_bits_locked(codec, reg, mask, val1);
3462         if (err < 0)
3463                 return err;
3464 
3465         err = snd_soc_update_bits_locked(codec, reg, mask, val2);
3466         return err;
3467 }
3468 EXPORT_SYMBOL_GPL(snd_soc_put_strobe);
3469 
3470 /**
3471  * snd_soc_dai_set_sysclk - configure DAI system or master clock.
3472  * @dai: DAI
3473  * @clk_id: DAI specific clock ID
3474  * @freq: new clock frequency in Hz
3475  * @dir: new clock direction - input/output.
3476  *
3477  * Configures the DAI master (MCLK) or system (SYSCLK) clocking.
3478  */
3479 int snd_soc_dai_set_sysclk(struct snd_soc_dai *dai, int clk_id,
3480         unsigned int freq, int dir)
3481 {
3482         if (dai->driver && dai->driver->ops->set_sysclk)
3483                 return dai->driver->ops->set_sysclk(dai, clk_id, freq, dir);
3484         else if (dai->codec && dai->codec->driver->set_sysclk)
3485                 return dai->codec->driver->set_sysclk(dai->codec, clk_id, 0,
3486                                                       freq, dir);
3487         else
3488                 return -ENOTSUPP;
3489 }
3490 EXPORT_SYMBOL_GPL(snd_soc_dai_set_sysclk);
3491 
3492 /**
3493  * snd_soc_codec_set_sysclk - configure CODEC system or master clock.
3494  * @codec: CODEC
3495  * @clk_id: DAI specific clock ID
3496  * @source: Source for the clock
3497  * @freq: new clock frequency in Hz
3498  * @dir: new clock direction - input/output.
3499  *
3500  * Configures the CODEC master (MCLK) or system (SYSCLK) clocking.
3501  */
3502 int snd_soc_codec_set_sysclk(struct snd_soc_codec *codec, int clk_id,
3503                              int source, unsigned int freq, int dir)
3504 {
3505         if (codec->driver->set_sysclk)
3506                 return codec->driver->set_sysclk(codec, clk_id, source,
3507                                                  freq, dir);
3508         else
3509                 return -ENOTSUPP;
3510 }
3511 EXPORT_SYMBOL_GPL(snd_soc_codec_set_sysclk);
3512 
3513 /**
3514  * snd_soc_dai_set_clkdiv - configure DAI clock dividers.
3515  * @dai: DAI
3516  * @div_id: DAI specific clock divider ID
3517  * @div: new clock divisor.
3518  *
3519  * Configures the clock dividers. This is used to derive the best DAI bit and
3520  * frame clocks from the system or master clock. It's best to set the DAI bit
3521  * and frame clocks as low as possible to save system power.
3522  */
3523 int snd_soc_dai_set_clkdiv(struct snd_soc_dai *dai,
3524         int div_id, int div)
3525 {
3526         if (dai->driver && dai->driver->ops->set_clkdiv)
3527                 return dai->driver->ops->set_clkdiv(dai, div_id, div);
3528         else
3529                 return -EINVAL;
3530 }
3531 EXPORT_SYMBOL_GPL(snd_soc_dai_set_clkdiv);
3532 
3533 /**
3534  * snd_soc_dai_set_pll - configure DAI PLL.
3535  * @dai: DAI
3536  * @pll_id: DAI specific PLL ID
3537  * @source: DAI specific source for the PLL
3538  * @freq_in: PLL input clock frequency in Hz
3539  * @freq_out: requested PLL output clock frequency in Hz
3540  *
3541  * Configures and enables PLL to generate output clock based on input clock.
3542  */
3543 int snd_soc_dai_set_pll(struct snd_soc_dai *dai, int pll_id, int source,
3544         unsigned int freq_in, unsigned int freq_out)
3545 {
3546         if (dai->driver && dai->driver->ops->set_pll)
3547                 return dai->driver->ops->set_pll(dai, pll_id, source,
3548                                          freq_in, freq_out);
3549         else if (dai->codec && dai->codec->driver->set_pll)
3550                 return dai->codec->driver->set_pll(dai->codec, pll_id, source,
3551                                                    freq_in, freq_out);
3552         else
3553                 return -EINVAL;
3554 }
3555 EXPORT_SYMBOL_GPL(snd_soc_dai_set_pll);
3556 
3557 /*
3558  * snd_soc_codec_set_pll - configure codec PLL.
3559  * @codec: CODEC
3560  * @pll_id: DAI specific PLL ID
3561  * @source: DAI specific source for the PLL
3562  * @freq_in: PLL input clock frequency in Hz
3563  * @freq_out: requested PLL output clock frequency in Hz
3564  *
3565  * Configures and enables PLL to generate output clock based on input clock.
3566  */
3567 int snd_soc_codec_set_pll(struct snd_soc_codec *codec, int pll_id, int source,
3568                           unsigned int freq_in, unsigned int freq_out)
3569 {
3570         if (codec->driver->set_pll)
3571                 return codec->driver->set_pll(codec, pll_id, source,
3572                                               freq_in, freq_out);
3573         else
3574                 return -EINVAL;
3575 }
3576 EXPORT_SYMBOL_GPL(snd_soc_codec_set_pll);
3577 
3578 /**
3579  * snd_soc_dai_set_bclk_ratio - configure BCLK to sample rate ratio.
3580  * @dai: DAI
3581  * @ratio Ratio of BCLK to Sample rate.
3582  *
3583  * Configures the DAI for a preset BCLK to sample rate ratio.
3584  */
3585 int snd_soc_dai_set_bclk_ratio(struct snd_soc_dai *dai, unsigned int ratio)
3586 {
3587         if (dai->driver && dai->driver->ops->set_bclk_ratio)
3588                 return dai->driver->ops->set_bclk_ratio(dai, ratio);
3589         else
3590                 return -EINVAL;
3591 }
3592 EXPORT_SYMBOL_GPL(snd_soc_dai_set_bclk_ratio);
3593 
3594 /**
3595  * snd_soc_dai_set_fmt - configure DAI hardware audio format.
3596  * @dai: DAI
3597  * @fmt: SND_SOC_DAIFMT_ format value.
3598  *
3599  * Configures the DAI hardware format and clocking.
3600  */
3601 int snd_soc_dai_set_fmt(struct snd_soc_dai *dai, unsigned int fmt)
3602 {
3603         if (dai->driver == NULL)
3604                 return -EINVAL;
3605         if (dai->driver->ops->set_fmt == NULL)
3606                 return -ENOTSUPP;
3607         return dai->driver->ops->set_fmt(dai, fmt);
3608 }
3609 EXPORT_SYMBOL_GPL(snd_soc_dai_set_fmt);
3610 
3611 /**
3612  * snd_soc_dai_set_tdm_slot - configure DAI TDM.
3613  * @dai: DAI
3614  * @tx_mask: bitmask representing active TX slots.
3615  * @rx_mask: bitmask representing active RX slots.
3616  * @slots: Number of slots in use.
3617  * @slot_width: Width in bits for each slot.
3618  *
3619  * Configures a DAI for TDM operation. Both mask and slots are codec and DAI
3620  * specific.
3621  */
3622 int snd_soc_dai_set_tdm_slot(struct snd_soc_dai *dai,
3623         unsigned int tx_mask, unsigned int rx_mask, int slots, int slot_width)
3624 {
3625         if (dai->driver && dai->driver->ops->set_tdm_slot)
3626                 return dai->driver->ops->set_tdm_slot(dai, tx_mask, rx_mask,
3627                                 slots, slot_width);
3628         else
3629                 return -EINVAL;
3630 }
3631 EXPORT_SYMBOL_GPL(snd_soc_dai_set_tdm_slot);
3632 
3633 /**
3634  * snd_soc_dai_set_channel_map - configure DAI audio channel map
3635  * @dai: DAI
3636  * @tx_num: how many TX channels
3637  * @tx_slot: pointer to an array which imply the TX slot number channel
3638  *           0~num-1 uses
3639  * @rx_num: how many RX channels
3640  * @rx_slot: pointer to an array which imply the RX slot number channel
3641  *           0~num-1 uses
3642  *
3643  * configure the relationship between channel number and TDM slot number.
3644  */
3645 int snd_soc_dai_set_channel_map(struct snd_soc_dai *dai,
3646         unsigned int tx_num, unsigned int *tx_slot,
3647         unsigned int rx_num, unsigned int *rx_slot)
3648 {
3649         if (dai->driver && dai->driver->ops->set_channel_map)
3650                 return dai->driver->ops->set_channel_map(dai, tx_num, tx_slot,
3651                         rx_num, rx_slot);
3652         else
3653                 return -EINVAL;
3654 }
3655 EXPORT_SYMBOL_GPL(snd_soc_dai_set_channel_map);
3656 
3657 /**
3658  * snd_soc_dai_set_tristate - configure DAI system or master clock.
3659  * @dai: DAI
3660  * @tristate: tristate enable
3661  *
3662  * Tristates the DAI so that others can use it.
3663  */
3664 int snd_soc_dai_set_tristate(struct snd_soc_dai *dai, int tristate)
3665 {
3666         if (dai->driver && dai->driver->ops->set_tristate)
3667                 return dai->driver->ops->set_tristate(dai, tristate);
3668         else
3669                 return -EINVAL;
3670 }
3671 EXPORT_SYMBOL_GPL(snd_soc_dai_set_tristate);
3672 
3673 /**
3674  * snd_soc_dai_digital_mute - configure DAI system or master clock.
3675  * @dai: DAI
3676  * @mute: mute enable
3677  * @direction: stream to mute
3678  *
3679  * Mutes the DAI DAC.
3680  */
3681 int snd_soc_dai_digital_mute(struct snd_soc_dai *dai, int mute,
3682                              int direction)
3683 {
3684         if (!dai->driver)
3685                 return -ENOTSUPP;
3686 
3687         if (dai->driver->ops->mute_stream)
3688                 return dai->driver->ops->mute_stream(dai, mute, direction);
3689         else if (direction == SNDRV_PCM_STREAM_PLAYBACK &&
3690                  dai->driver->ops->digital_mute)
3691                 return dai->driver->ops->digital_mute(dai, mute);
3692         else
3693                 return -ENOTSUPP;
3694 }
3695 EXPORT_SYMBOL_GPL(snd_soc_dai_digital_mute);
3696 
3697 /**
3698  * snd_soc_register_card - Register a card with the ASoC core
3699  *
3700  * @card: Card to register
3701  *
3702  */
3703 int snd_soc_register_card(struct snd_soc_card *card)
3704 {
3705         int i, ret;
3706 
3707         if (!card->name || !card->dev)
3708                 return -EINVAL;
3709 
3710         for (i = 0; i < card->num_links; i++) {
3711                 struct snd_soc_dai_link *link = &card->dai_link[i];
3712 
3713                 /*
3714                  * Codec must be specified by 1 of name or OF node,
3715                  * not both or neither.
3716                  */
3717                 if (!!link->codec_name == !!link->codec_of_node) {
3718                         dev_err(card->dev,
3719                                 "ASoC: Neither/both codec name/of_node are set for %s\n",
3720                                 link->name);
3721                         return -EINVAL;
3722                 }
3723                 /* Codec DAI name must be specified */
3724                 if (!link->codec_dai_name) {
3725                         dev_err(card->dev,
3726                                 "ASoC: codec_dai_name not set for %s\n",
3727                                 link->name);
3728                         return -EINVAL;
3729                 }
3730 
3731                 /*
3732                  * Platform may be specified by either name or OF node, but
3733                  * can be left unspecified, and a dummy platform will be used.
3734                  */
3735                 if (link->platform_name && link->platform_of_node) {
3736                         dev_err(card->dev,
3737                                 "ASoC: Both platform name/of_node are set for %s\n",
3738                                 link->name);
3739                         return -EINVAL;
3740                 }
3741 
3742                 /*
3743                  * CPU device may be specified by either name or OF node, but
3744                  * can be left unspecified, and will be matched based on DAI
3745                  * name alone..
3746                  */
3747                 if (link->cpu_name && link->cpu_of_node) {
3748                         dev_err(card->dev,
3749                                 "ASoC: Neither/both cpu name/of_node are set for %s\n",
3750                                 link->name);
3751                         return -EINVAL;
3752                 }
3753                 /*
3754                  * At least one of CPU DAI name or CPU device name/node must be
3755                  * specified
3756                  */
3757                 if (!link->cpu_dai_name &&
3758                     !(link->cpu_name || link->cpu_of_node)) {
3759                         dev_err(card->dev,
3760                                 "ASoC: Neither cpu_dai_name nor cpu_name/of_node are set for %s\n",
3761                                 link->name);
3762                         return -EINVAL;
3763                 }
3764         }
3765 
3766         dev_set_drvdata(card->dev, card);
3767 
3768         snd_soc_initialize_card_lists(card);
3769 
3770         soc_init_card_debugfs(card);
3771 
3772         card->rtd = devm_kzalloc(card->dev,
3773                                  sizeof(struct snd_soc_pcm_runtime) *
3774                                  (card->num_links + card->num_aux_devs),
3775                                  GFP_KERNEL);
3776         if (card->rtd == NULL)
3777                 return -ENOMEM;
3778         card->num_rtd = 0;
3779         card->rtd_aux = &card->rtd[card->num_links];
3780 
3781         for (i = 0; i < card->num_links; i++)
3782                 card->rtd[i].dai_link = &card->dai_link[i];
3783 
3784         INIT_LIST_HEAD(&card->list);
3785         INIT_LIST_HEAD(&card->dapm_dirty);
3786         card->instantiated = 0;
3787         mutex_init(&card->mutex);
3788         mutex_init(&card->dapm_mutex);
3789 
3790         ret = snd_soc_instantiate_card(card);
3791         if (ret != 0)
3792                 soc_cleanup_card_debugfs(card);
3793 
3794         /* deactivate pins to sleep state */
3795         for (i = 0; i < card->num_rtd; i++) {
3796                 struct snd_soc_dai *cpu_dai = card->rtd[i].cpu_dai;
3797                 struct snd_soc_dai *codec_dai = card->rtd[i].codec_dai;
3798                 if (!codec_dai->active)
3799                         pinctrl_pm_select_sleep_state(codec_dai->dev);
3800                 if (!cpu_dai->active)
3801                         pinctrl_pm_select_sleep_state(cpu_dai->dev);
3802         }
3803 
3804         return ret;
3805 }
3806 EXPORT_SYMBOL_GPL(snd_soc_register_card);
3807 
3808 /**
3809  * snd_soc_unregister_card - Unregister a card with the ASoC core
3810  *
3811  * @card: Card to unregister
3812  *
3813  */
3814 int snd_soc_unregister_card(struct snd_soc_card *card)
3815 {
3816         if (card->instantiated)
3817                 soc_cleanup_card_resources(card);
3818         dev_dbg(card->dev, "ASoC: Unregistered card '%s'\n", card->name);
3819 
3820         return 0;
3821 }
3822 EXPORT_SYMBOL_GPL(snd_soc_unregister_card);
3823 
3824 /*
3825  * Simplify DAI link configuration by removing ".-1" from device names
3826  * and sanitizing names.
3827  */
3828 static char *fmt_single_name(struct device *dev, int *id)
3829 {
3830         char *found, name[NAME_SIZE];
3831         int id1, id2;
3832 
3833         if (dev_name(dev) == NULL)
3834                 return NULL;
3835 
3836         strlcpy(name, dev_name(dev), NAME_SIZE);
3837 
3838         /* are we a "%s.%d" name (platform and SPI components) */
3839         found = strstr(name, dev->driver->name);
3840         if (found) {
3841                 /* get ID */
3842                 if (sscanf(&found[strlen(dev->driver->name)], ".%d", id) == 1) {
3843 
3844                         /* discard ID from name if ID == -1 */
3845                         if (*id == -1)
3846                                 found[strlen(dev->driver->name)] = '\0';
3847                 }
3848 
3849         } else {
3850                 /* I2C component devices are named "bus-addr"  */
3851                 if (sscanf(name, "%x-%x", &id1, &id2) == 2) {
3852                         char tmp[NAME_SIZE];
3853 
3854                         /* create unique ID number from I2C addr and bus */
3855                         *id = ((id1 & 0xffff) << 16) + id2;
3856 
3857                         /* sanitize component name for DAI link creation */
3858                         snprintf(tmp, NAME_SIZE, "%s.%s", dev->driver->name, name);
3859                         strlcpy(name, tmp, NAME_SIZE);
3860                 } else
3861                         *id = 0;
3862         }
3863 
3864         return kstrdup(name, GFP_KERNEL);
3865 }
3866 
3867 /*
3868  * Simplify DAI link naming for single devices with multiple DAIs by removing
3869  * any ".-1" and using the DAI name (instead of device name).
3870  */
3871 static inline char *fmt_multiple_name(struct device *dev,
3872                 struct snd_soc_dai_driver *dai_drv)
3873 {
3874         if (dai_drv->name == NULL) {
3875                 dev_err(dev,
3876                         "ASoC: error - multiple DAI %s registered with no name\n",
3877                         dev_name(dev));
3878                 return NULL;
3879         }
3880 
3881         return kstrdup(dai_drv->name, GFP_KERNEL);
3882 }
3883 
3884 /**
3885  * snd_soc_register_dai - Register a DAI with the ASoC core
3886  *
3887  * @dai: DAI to register
3888  */
3889 static int snd_soc_register_dai(struct device *dev,
3890                 struct snd_soc_dai_driver *dai_drv)
3891 {
3892         struct snd_soc_codec *codec;
3893         struct snd_soc_dai *dai;
3894 
3895         dev_dbg(dev, "ASoC: dai register %s\n", dev_name(dev));
3896 
3897         dai = kzalloc(sizeof(struct snd_soc_dai), GFP_KERNEL);
3898         if (dai == NULL)
3899                 return -ENOMEM;
3900 
3901         /* create DAI component name */
3902         dai->name = fmt_single_name(dev, &dai->id);
3903         if (dai->name == NULL) {
3904                 kfree(dai);
3905                 return -ENOMEM;
3906         }
3907 
3908         dai->dev = dev;
3909         dai->driver = dai_drv;
3910         dai->dapm.dev = dev;
3911         if (!dai->driver->ops)
3912                 dai->driver->ops = &null_dai_ops;
3913 
3914         mutex_lock(&client_mutex);
3915 
3916         list_for_each_entry(codec, &codec_list, list) {
3917                 if (codec->dev == dev) {
3918                         dev_dbg(dev, "ASoC: Mapped DAI %s to CODEC %s\n",
3919                                 dai->name, codec->name);
3920                         dai->codec = codec;
3921                         break;
3922                 }
3923         }
3924 
3925         if (!dai->codec)
3926                 dai->dapm.idle_bias_off = 1;
3927 
3928         list_add(&dai->list, &dai_list);
3929 
3930         mutex_unlock(&client_mutex);
3931 
3932         dev_dbg(dev, "ASoC: Registered DAI '%s'\n", dai->name);
3933 
3934         return 0;
3935 }
3936 
3937 /**
3938  * snd_soc_unregister_dai - Unregister a DAI from the ASoC core
3939  *
3940  * @dai: DAI to unregister
3941  */
3942 static void snd_soc_unregister_dai(struct device *dev)
3943 {
3944         struct snd_soc_dai *dai;
3945 
3946         list_for_each_entry(dai, &dai_list, list) {
3947                 if (dev == dai->dev)
3948                         goto found;
3949         }
3950         return;
3951 
3952 found:
3953         mutex_lock(&client_mutex);
3954         list_del(&dai->list);
3955         mutex_unlock(&client_mutex);
3956 
3957         dev_dbg(dev, "ASoC: Unregistered DAI '%s'\n", dai->name);
3958         kfree(dai->name);
3959         kfree(dai);
3960 }
3961 
3962 /**
3963  * snd_soc_register_dais - Register multiple DAIs with the ASoC core
3964  *
3965  * @dai: Array of DAIs to register
3966  * @count: Number of DAIs
3967  */
3968 static int snd_soc_register_dais(struct device *dev,
3969                 struct snd_soc_dai_driver *dai_drv, size_t count)
3970 {
3971         struct snd_soc_codec *codec;
3972         struct snd_soc_dai *dai;
3973         int i, ret = 0;
3974 
3975         dev_dbg(dev, "ASoC: dai register %s #%Zu\n", dev_name(dev), count);
3976 
3977         for (i = 0; i < count; i++) {
3978 
3979                 dai = kzalloc(sizeof(struct snd_soc_dai), GFP_KERNEL);
3980                 if (dai == NULL) {
3981                         ret = -ENOMEM;
3982                         goto err;
3983                 }
3984 
3985                 /* create DAI component name */
3986                 dai->name = fmt_multiple_name(dev, &dai_drv[i]);
3987                 if (dai->name == NULL) {
3988                         kfree(dai);
3989                         ret = -EINVAL;
3990                         goto err;
3991                 }
3992 
3993                 dai->dev = dev;
3994                 dai->driver = &dai_drv[i];
3995                 if (dai->driver->id)
3996                         dai->id = dai->driver->id;
3997                 else
3998                         dai->id = i;
3999                 dai->dapm.dev = dev;
4000                 if (!dai->driver->ops)
4001                         dai->driver->ops = &null_dai_ops;
4002 
4003                 mutex_lock(&client_mutex);
4004 
4005                 list_for_each_entry(codec, &codec_list, list) {
4006                         if (codec->dev == dev) {
4007                                 dev_dbg(dev,
4008                                         "ASoC: Mapped DAI %s to CODEC %s\n",
4009                                         dai->name, codec->name);
4010                                 dai->codec = codec;
4011                                 break;
4012                         }
4013                 }
4014 
4015                 if (!dai->codec)
4016                         dai->dapm.idle_bias_off = 1;
4017 
4018                 list_add(&dai->list, &dai_list);
4019 
4020                 mutex_unlock(&client_mutex);
4021 
4022                 dev_dbg(dai->dev, "ASoC: Registered DAI '%s'\n", dai->name);
4023         }
4024 
4025         return 0;
4026 
4027 err:
4028         for (i--; i >= 0; i--)
4029                 snd_soc_unregister_dai(dev);
4030 
4031         return ret;
4032 }
4033 
4034 /**
4035  * snd_soc_unregister_dais - Unregister multiple DAIs from the ASoC core
4036  *
4037  * @dai: Array of DAIs to unregister
4038  * @count: Number of DAIs
4039  */
4040 static void snd_soc_unregister_dais(struct device *dev, size_t count)
4041 {
4042         int i;
4043 
4044         for (i = 0; i < count; i++)
4045                 snd_soc_unregister_dai(dev);
4046 }
4047 
4048 /**
4049  * snd_soc_register_component - Register a component with the ASoC core
4050  *
4051  */
4052 static int
4053 __snd_soc_register_component(struct device *dev,
4054                              struct snd_soc_component *cmpnt,
4055                              const struct snd_soc_component_driver *cmpnt_drv,
4056                              struct snd_soc_dai_driver *dai_drv,
4057                              int num_dai, bool allow_single_dai)
4058 {
4059         int ret;
4060 
4061         dev_dbg(dev, "component register %s\n", dev_name(dev));
4062 
4063         if (!cmpnt) {
4064                 dev_err(dev, "ASoC: Failed to connecting component\n");
4065                 return -ENOMEM;
4066         }
4067 
4068         cmpnt->name = fmt_single_name(dev, &cmpnt->id);
4069         if (!cmpnt->name) {
4070                 dev_err(dev, "ASoC: Failed to simplifying name\n");
4071                 return -ENOMEM;
4072         }
4073 
4074         cmpnt->dev      = dev;
4075         cmpnt->driver   = cmpnt_drv;
4076         cmpnt->dai_drv  = dai_drv;
4077         cmpnt->num_dai  = num_dai;
4078 
4079         /*
4080          * snd_soc_register_dai()  uses fmt_single_name(), and
4081          * snd_soc_register_dais() uses fmt_multiple_name()
4082          * for dai->name which is used for name based matching
4083          *
4084          * this function is used from cpu/codec.
4085          * allow_single_dai flag can ignore "codec" driver reworking
4086          * since it had been used snd_soc_register_dais(),
4087          */
4088         if ((1 == num_dai) && allow_single_dai)
4089                 ret = snd_soc_register_dai(dev, dai_drv);
4090         else
4091                 ret = snd_soc_register_dais(dev, dai_drv, num_dai);
4092         if (ret < 0) {
4093                 dev_err(dev, "ASoC: Failed to regster DAIs: %d\n", ret);
4094                 goto error_component_name;
4095         }
4096 
4097         mutex_lock(&client_mutex);
4098         list_add(&cmpnt->list, &component_list);
4099         mutex_unlock(&client_mutex);
4100 
4101         dev_dbg(cmpnt->dev, "ASoC: Registered component '%s'\n", cmpnt->name);
4102 
4103         return ret;
4104 
4105 error_component_name:
4106         kfree(cmpnt->name);
4107 
4108         return ret;
4109 }
4110 
4111 int snd_soc_register_component(struct device *dev,
4112                                const struct snd_soc_component_driver *cmpnt_drv,
4113                                struct snd_soc_dai_driver *dai_drv,
4114                                int num_dai)
4115 {
4116         struct snd_soc_component *cmpnt;
4117 
4118         cmpnt = devm_kzalloc(dev, sizeof(*cmpnt), GFP_KERNEL);
4119         if (!cmpnt) {
4120                 dev_err(dev, "ASoC: Failed to allocate memory\n");
4121                 return -ENOMEM;
4122         }
4123 
4124         return __snd_soc_register_component(dev, cmpnt, cmpnt_drv,
4125                                             dai_drv, num_dai, true);
4126 }
4127 EXPORT_SYMBOL_GPL(snd_soc_register_component);
4128 
4129 /**
4130  * snd_soc_unregister_component - Unregister a component from the ASoC core
4131  *
4132  */
4133 void snd_soc_unregister_component(struct device *dev)
4134 {
4135         struct snd_soc_component *cmpnt;
4136 
4137         list_for_each_entry(cmpnt, &component_list, list) {
4138                 if (dev == cmpnt->dev)
4139                         goto found;
4140         }
4141         return;
4142 
4143 found:
4144         snd_soc_unregister_dais(dev, cmpnt->num_dai);
4145 
4146         mutex_lock(&client_mutex);
4147         list_del(&cmpnt->list);
4148         mutex_unlock(&client_mutex);
4149 
4150         dev_dbg(dev, "ASoC: Unregistered component '%s'\n", cmpnt->name);
4151         kfree(cmpnt->name);
4152 }
4153 EXPORT_SYMBOL_GPL(snd_soc_unregister_component);
4154 
4155 /**
4156  * snd_soc_add_platform - Add a platform to the ASoC core
4157  * @dev: The parent device for the platform
4158  * @platform: The platform to add
4159  * @platform_driver: The driver for the platform
4160  */
4161 int snd_soc_add_platform(struct device *dev, struct snd_soc_platform *platform,
4162                 const struct snd_soc_platform_driver *platform_drv)
4163 {
4164         /* create platform component name */
4165         platform->name = fmt_single_name(dev, &platform->id);
4166         if (platform->name == NULL)
4167                 return -ENOMEM;
4168 
4169         platform->dev = dev;
4170         platform->driver = platform_drv;
4171         platform->dapm.dev = dev;
4172         platform->dapm.platform = platform;
4173         platform->dapm.stream_event = platform_drv->stream_event;
4174         mutex_init(&platform->mutex);
4175 
4176         mutex_lock(&client_mutex);
4177         list_add(&platform->list, &platform_list);
4178         mutex_unlock(&client_mutex);
4179 
4180         dev_dbg(dev, "ASoC: Registered platform '%s'\n", platform->name);
4181 
4182         return 0;
4183 }
4184 EXPORT_SYMBOL_GPL(snd_soc_add_platform);
4185 
4186 /**
4187  * snd_soc_register_platform - Register a platform with the ASoC core
4188  *
4189  * @platform: platform to register
4190  */
4191 int snd_soc_register_platform(struct device *dev,
4192                 const struct snd_soc_platform_driver *platform_drv)
4193 {
4194         struct snd_soc_platform *platform;
4195         int ret;
4196 
4197         dev_dbg(dev, "ASoC: platform register %s\n", dev_name(dev));
4198 
4199         platform = kzalloc(sizeof(struct snd_soc_platform), GFP_KERNEL);
4200         if (platform == NULL)
4201                 return -ENOMEM;
4202 
4203         ret = snd_soc_add_platform(dev, platform, platform_drv);
4204         if (ret)
4205                 kfree(platform);
4206 
4207         return ret;
4208 }
4209 EXPORT_SYMBOL_GPL(snd_soc_register_platform);
4210 
4211 /**
4212  * snd_soc_remove_platform - Remove a platform from the ASoC core
4213  * @platform: the platform to remove
4214  */
4215 void snd_soc_remove_platform(struct snd_soc_platform *platform)
4216 {
4217         mutex_lock(&client_mutex);
4218         list_del(&platform->list);
4219         mutex_unlock(&client_mutex);
4220 
4221         dev_dbg(platform->dev, "ASoC: Unregistered platform '%s'\n",
4222                 platform->name);
4223         kfree(platform->name);
4224 }
4225 EXPORT_SYMBOL_GPL(snd_soc_remove_platform);
4226 
4227 struct snd_soc_platform *snd_soc_lookup_platform(struct device *dev)
4228 {
4229         struct snd_soc_platform *platform;
4230 
4231         list_for_each_entry(platform, &platform_list, list) {
4232                 if (dev == platform->dev)
4233                         return platform;
4234         }
4235 
4236         return NULL;
4237 }
4238 EXPORT_SYMBOL_GPL(snd_soc_lookup_platform);
4239 
4240 /**
4241  * snd_soc_unregister_platform - Unregister a platform from the ASoC core
4242  *
4243  * @platform: platform to unregister
4244  */
4245 void snd_soc_unregister_platform(struct device *dev)
4246 {
4247         struct snd_soc_platform *platform;
4248 
4249         platform = snd_soc_lookup_platform(dev);
4250         if (!platform)
4251                 return;
4252 
4253         snd_soc_remove_platform(platform);
4254         kfree(platform);
4255 }
4256 EXPORT_SYMBOL_GPL(snd_soc_unregister_platform);
4257 
4258 static u64 codec_format_map[] = {
4259         SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S16_BE,
4260         SNDRV_PCM_FMTBIT_U16_LE | SNDRV_PCM_FMTBIT_U16_BE,
4261         SNDRV_PCM_FMTBIT_S24_LE | SNDRV_PCM_FMTBIT_S24_BE,
4262         SNDRV_PCM_FMTBIT_U24_LE | SNDRV_PCM_FMTBIT_U24_BE,
4263         SNDRV_PCM_FMTBIT_S32_LE | SNDRV_PCM_FMTBIT_S32_BE,
4264         SNDRV_PCM_FMTBIT_U32_LE | SNDRV_PCM_FMTBIT_U32_BE,
4265         SNDRV_PCM_FMTBIT_S24_3LE | SNDRV_PCM_FMTBIT_U24_3BE,
4266         SNDRV_PCM_FMTBIT_U24_3LE | SNDRV_PCM_FMTBIT_U24_3BE,
4267         SNDRV_PCM_FMTBIT_S20_3LE | SNDRV_PCM_FMTBIT_S20_3BE,
4268         SNDRV_PCM_FMTBIT_U20_3LE | SNDRV_PCM_FMTBIT_U20_3BE,
4269         SNDRV_PCM_FMTBIT_S18_3LE | SNDRV_PCM_FMTBIT_S18_3BE,
4270         SNDRV_PCM_FMTBIT_U18_3LE | SNDRV_PCM_FMTBIT_U18_3BE,
4271         SNDRV_PCM_FMTBIT_FLOAT_LE | SNDRV_PCM_FMTBIT_FLOAT_BE,
4272         SNDRV_PCM_FMTBIT_FLOAT64_LE | SNDRV_PCM_FMTBIT_FLOAT64_BE,
4273         SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE
4274         | SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE,
4275 };
4276 
4277 /* Fix up the DAI formats for endianness: codecs don't actually see
4278  * the endianness of the data but we're using the CPU format
4279  * definitions which do need to include endianness so we ensure that
4280  * codec DAIs always have both big and little endian variants set.
4281  */
4282 static void fixup_codec_formats(struct snd_soc_pcm_stream *stream)
4283 {
4284         int i;
4285 
4286         for (i = 0; i < ARRAY_SIZE(codec_format_map); i++)
4287                 if (stream->formats & codec_format_map[i])
4288                         stream->formats |= codec_format_map[i];
4289 }
4290 
4291 /**
4292  * snd_soc_register_codec - Register a codec with the ASoC core
4293  *
4294  * @codec: codec to register
4295  */
4296 int snd_soc_register_codec(struct device *dev,
4297                            const struct snd_soc_codec_driver *codec_drv,
4298                            struct snd_soc_dai_driver *dai_drv,
4299                            int num_dai)
4300 {
4301         struct snd_soc_codec *codec;
4302         int ret, i;
4303 
4304         dev_dbg(dev, "codec register %s\n", dev_name(dev));
4305 
4306         codec = kzalloc(sizeof(struct snd_soc_codec), GFP_KERNEL);
4307         if (codec == NULL)
4308                 return -ENOMEM;
4309 
4310         /* create CODEC component name */
4311         codec->name = fmt_single_name(dev, &codec->id);
4312         if (codec->name == NULL) {
4313                 ret = -ENOMEM;
4314                 goto fail_codec;
4315         }
4316 
4317         codec->write = codec_drv->write;
4318         codec->read = codec_drv->read;
4319         codec->volatile_register = codec_drv->volatile_register;
4320         codec->readable_register = codec_drv->readable_register;
4321         codec->writable_register = codec_drv->writable_register;
4322         codec->ignore_pmdown_time = codec_drv->ignore_pmdown_time;
4323         codec->dapm.bias_level = SND_SOC_BIAS_OFF;
4324         codec->dapm.dev = dev;
4325         codec->dapm.codec = codec;
4326         codec->dapm.seq_notifier = codec_drv->seq_notifier;
4327         codec->dapm.stream_event = codec_drv->stream_event;
4328         codec->dev = dev;
4329         codec->driver = codec_drv;
4330         codec->num_dai = num_dai;
4331         mutex_init(&codec->mutex);
4332 
4333         for (i = 0; i < num_dai; i++) {
4334                 fixup_codec_formats(&dai_drv[i].playback);
4335                 fixup_codec_formats(&dai_drv[i].capture);
4336         }
4337 
4338         mutex_lock(&client_mutex);
4339         list_add(&codec->list, &codec_list);
4340         mutex_unlock(&client_mutex);
4341 
4342         /* register component */
4343         ret = __snd_soc_register_component(dev, &codec->component,
4344                                            &codec_drv->component_driver,
4345                                            dai_drv, num_dai, false);
4346         if (ret < 0) {
4347                 dev_err(codec->dev, "ASoC: Failed to regster component: %d\n", ret);
4348                 goto fail_codec_name;
4349         }
4350 
4351         dev_dbg(codec->dev, "ASoC: Registered codec '%s'\n", codec->name);
4352         return 0;
4353 
4354 fail_codec_name:
4355         mutex_lock(&client_mutex);
4356         list_del(&codec->list);
4357         mutex_unlock(&client_mutex);
4358 
4359         kfree(codec->name);
4360 fail_codec:
4361         kfree(codec);
4362         return ret;
4363 }
4364 EXPORT_SYMBOL_GPL(snd_soc_register_codec);
4365 
4366 /**
4367  * snd_soc_unregister_codec - Unregister a codec from the ASoC core
4368  *
4369  * @codec: codec to unregister
4370  */
4371 void snd_soc_unregister_codec(struct device *dev)
4372 {
4373         struct snd_soc_codec *codec;
4374 
4375         list_for_each_entry(codec, &codec_list, list) {
4376                 if (dev == codec->dev)
4377                         goto found;
4378         }
4379         return;
4380 
4381 found:
4382         snd_soc_unregister_component(dev);
4383 
4384         mutex_lock(&client_mutex);
4385         list_del(&codec->list);
4386         mutex_unlock(&client_mutex);
4387 
4388         dev_dbg(codec->dev, "ASoC: Unregistered codec '%s'\n", codec->name);
4389 
4390         snd_soc_cache_exit(codec);
4391         kfree(codec->name);
4392         kfree(codec);
4393 }
4394 EXPORT_SYMBOL_GPL(snd_soc_unregister_codec);
4395 
4396 /* Retrieve a card's name from device tree */
4397 int snd_soc_of_parse_card_name(struct snd_soc_card *card,
4398                                const char *propname)
4399 {
4400         struct device_node *np = card->dev->of_node;
4401         int ret;
4402 
4403         ret = of_property_read_string_index(np, propname, 0, &card->name);
4404         /*
4405          * EINVAL means the property does not exist. This is fine providing
4406          * card->name was previously set, which is checked later in
4407          * snd_soc_register_card.
4408          */
4409         if (ret < 0 && ret != -EINVAL) {
4410                 dev_err(card->dev,
4411                         "ASoC: Property '%s' could not be read: %d\n",
4412                         propname, ret);
4413                 return ret;
4414         }
4415 
4416         return 0;
4417 }
4418 EXPORT_SYMBOL_GPL(snd_soc_of_parse_card_name);
4419 
4420 int snd_soc_of_parse_audio_routing(struct snd_soc_card *card,
4421                                    const char *propname)
4422 {
4423         struct device_node *np = card->dev->of_node;
4424         int num_routes;
4425         struct snd_soc_dapm_route *routes;
4426         int i, ret;
4427 
4428         num_routes = of_property_count_strings(np, propname);
4429         if (num_routes < 0 || num_routes & 1) {
4430                 dev_err(card->dev,
4431                         "ASoC: Property '%s' does not exist or its length is not even\n",
4432                         propname);
4433                 return -EINVAL;
4434         }
4435         num_routes /= 2;
4436         if (!num_routes) {
4437                 dev_err(card->dev, "ASoC: Property '%s's length is zero\n",
4438                         propname);
4439                 return -EINVAL;
4440         }
4441 
4442         routes = devm_kzalloc(card->dev, num_routes * sizeof(*routes),
4443                               GFP_KERNEL);
4444         if (!routes) {
4445                 dev_err(card->dev,
4446                         "ASoC: Could not allocate DAPM route table\n");
4447                 return -EINVAL;
4448         }
4449 
4450         for (i = 0; i < num_routes; i++) {
4451                 ret = of_property_read_string_index(np, propname,
4452                         2 * i, &routes[i].sink);
4453                 if (ret) {
4454                         dev_err(card->dev,
4455                                 "ASoC: Property '%s' index %d could not be read: %d\n",
4456                                 propname, 2 * i, ret);
4457                         return -EINVAL;
4458                 }
4459                 ret = of_property_read_string_index(np, propname,
4460                         (2 * i) + 1, &routes[i].source);
4461                 if (ret) {
4462                         dev_err(card->dev,
4463                                 "ASoC: Property '%s' index %d could not be read: %d\n",
4464                                 propname, (2 * i) + 1, ret);
4465                         return -EINVAL;
4466                 }
4467         }
4468 
4469         card->num_dapm_routes = num_routes;
4470         card->dapm_routes = routes;
4471 
4472         return 0;
4473 }
4474 EXPORT_SYMBOL_GPL(snd_soc_of_parse_audio_routing);
4475 
4476 unsigned int snd_soc_of_parse_daifmt(struct device_node *np,
4477                                      const char *prefix)
4478 {
4479         int ret, i;
4480         char prop[128];
4481         unsigned int format = 0;
4482         int bit, frame;
4483         const char *str;
4484         struct {
4485                 char *name;
4486                 unsigned int val;
4487         } of_fmt_table[] = {
4488                 { "i2s",        SND_SOC_DAIFMT_I2S },
4489                 { "right_j",    SND_SOC_DAIFMT_RIGHT_J },
4490                 { "left_j",     SND_SOC_DAIFMT_LEFT_J },
4491                 { "dsp_a",      SND_SOC_DAIFMT_DSP_A },
4492                 { "dsp_b",      SND_SOC_DAIFMT_DSP_B },
4493                 { "ac97",       SND_SOC_DAIFMT_AC97 },
4494                 { "pdm",        SND_SOC_DAIFMT_PDM},
4495                 { "msb",        SND_SOC_DAIFMT_MSB },
4496                 { "lsb",        SND_SOC_DAIFMT_LSB },
4497         };
4498 
4499         if (!prefix)
4500                 prefix = "";
4501 
4502         /*
4503          * check "[prefix]format = xxx"
4504          * SND_SOC_DAIFMT_FORMAT_MASK area
4505          */
4506         snprintf(prop, sizeof(prop), "%sformat", prefix);
4507         ret = of_property_read_string(np, prop, &str);
4508         if (ret == 0) {
4509                 for (i = 0; i < ARRAY_SIZE(of_fmt_table); i++) {
4510                         if (strcmp(str, of_fmt_table[i].name) == 0) {
4511                                 format |= of_fmt_table[i].val;
4512                                 break;
4513                         }
4514                 }
4515         }
4516 
4517         /*
4518          * check "[prefix]continuous-clock"
4519          * SND_SOC_DAIFMT_CLOCK_MASK area
4520          */
4521         snprintf(prop, sizeof(prop), "%scontinuous-clock", prefix);
4522         if (of_get_property(np, prop, NULL))
4523                 format |= SND_SOC_DAIFMT_CONT;
4524         else
4525                 format |= SND_SOC_DAIFMT_GATED;
4526 
4527         /*
4528          * check "[prefix]bitclock-inversion"
4529          * check "[prefix]frame-inversion"
4530          * SND_SOC_DAIFMT_INV_MASK area
4531          */
4532         snprintf(prop, sizeof(prop), "%sbitclock-inversion", prefix);
4533         bit = !!of_get_property(np, prop, NULL);
4534 
4535         snprintf(prop, sizeof(prop), "%sframe-inversion", prefix);
4536         frame = !!of_get_property(np, prop, NULL);
4537 
4538         switch ((bit << 4) + frame) {
4539         case 0x11:
4540                 format |= SND_SOC_DAIFMT_IB_IF;
4541                 break;
4542         case 0x10:
4543                 format |= SND_SOC_DAIFMT_IB_NF;
4544                 break;
4545         case 0x01:
4546                 format |= SND_SOC_DAIFMT_NB_IF;
4547                 break;
4548         default:
4549                 /* SND_SOC_DAIFMT_NB_NF is default */
4550                 break;
4551         }
4552 
4553         /*
4554          * check "[prefix]bitclock-master"
4555          * check "[prefix]frame-master"
4556          * SND_SOC_DAIFMT_MASTER_MASK area
4557          */
4558         snprintf(prop, sizeof(prop), "%sbitclock-master", prefix);
4559         bit = !!of_get_property(np, prop, NULL);
4560 
4561         snprintf(prop, sizeof(prop), "%sframe-master", prefix);
4562         frame = !!of_get_property(np, prop, NULL);
4563 
4564         switch ((bit << 4) + frame) {
4565         case 0x11:
4566                 format |= SND_SOC_DAIFMT_CBM_CFM;
4567                 break;
4568         case 0x10:
4569                 format |= SND_SOC_DAIFMT_CBM_CFS;
4570                 break;
4571         case 0x01:
4572                 format |= SND_SOC_DAIFMT_CBS_CFM;
4573                 break;
4574         default:
4575                 format |= SND_SOC_DAIFMT_CBS_CFS;
4576                 break;
4577         }
4578 
4579         return format;
4580 }
4581 EXPORT_SYMBOL_GPL(snd_soc_of_parse_daifmt);
4582 
4583 int snd_soc_of_get_dai_name(struct device_node *of_node,
4584                             const char **dai_name)
4585 {
4586         struct snd_soc_component *pos;
4587         struct of_phandle_args args;
4588         int ret;
4589 
4590         ret = of_parse_phandle_with_args(of_node, "sound-dai",
4591                                          "#sound-dai-cells", 0, &args);
4592         if (ret)
4593                 return ret;
4594 
4595         ret = -EPROBE_DEFER;
4596 
4597         mutex_lock(&client_mutex);
4598         list_for_each_entry(pos, &component_list, list) {
4599                 if (pos->dev->of_node != args.np)
4600                         continue;
4601 
4602                 if (pos->driver->of_xlate_dai_name) {
4603                         ret = pos->driver->of_xlate_dai_name(pos, &args, dai_name);
4604                 } else {
4605                         int id = -1;
4606 
4607                         switch (args.args_count) {
4608                         case 0:
4609                                 id = 0; /* same as dai_drv[0] */
4610                                 break;
4611                         case 1:
4612                                 id = args.args[0];
4613                                 break;
4614                         default:
4615                                 /* not supported */
4616                                 break;
4617                         }
4618 
4619                         if (id < 0 || id >= pos->num_dai) {
4620                                 ret = -EINVAL;
4621                                 break;
4622                         }
4623 
4624                         ret = 0;
4625 
4626                         *dai_name = pos->dai_drv[id].name;
4627                         if (!*dai_name)
4628                                 *dai_name = pos->name;
4629                 }
4630 
4631                 break;
4632         }
4633         mutex_unlock(&client_mutex);
4634 
4635         of_node_put(args.np);
4636 
4637         return ret;
4638 }
4639 EXPORT_SYMBOL_GPL(snd_soc_of_get_dai_name);
4640 
4641 static int __init snd_soc_init(void)
4642 {
4643 #ifdef CONFIG_DEBUG_FS
4644         snd_soc_debugfs_root = debugfs_create_dir("asoc", NULL);
4645         if (IS_ERR(snd_soc_debugfs_root) || !snd_soc_debugfs_root) {
4646                 pr_warn("ASoC: Failed to create debugfs directory\n");
4647                 snd_soc_debugfs_root = NULL;
4648         }
4649 
4650         if (!debugfs_create_file("codecs", 0444, snd_soc_debugfs_root, NULL,
4651                                  &codec_list_fops))
4652                 pr_warn("ASoC: Failed to create CODEC list debugfs file\n");
4653 
4654         if (!debugfs_create_file("dais", 0444, snd_soc_debugfs_root, NULL,
4655                                  &dai_list_fops))
4656                 pr_warn("ASoC: Failed to create DAI list debugfs file\n");
4657 
4658         if (!debugfs_create_file("platforms", 0444, snd_soc_debugfs_root, NULL,
4659                                  &platform_list_fops))
4660                 pr_warn("ASoC: Failed to create platform list debugfs file\n");
4661 #endif
4662 
4663         snd_soc_util_init();
4664 
4665         return platform_driver_register(&soc_driver);
4666 }
4667 module_init(snd_soc_init);
4668 
4669 static void __exit snd_soc_exit(void)
4670 {
4671         snd_soc_util_exit();
4672 
4673 #ifdef CONFIG_DEBUG_FS
4674         debugfs_remove_recursive(snd_soc_debugfs_root);
4675 #endif
4676         platform_driver_unregister(&soc_driver);
4677 }
4678 module_exit(snd_soc_exit);
4679 
4680 /* Module information */
4681 MODULE_AUTHOR("Liam Girdwood, lrg@slimlogic.co.uk");
4682 MODULE_DESCRIPTION("ALSA SoC Core");
4683 MODULE_LICENSE("GPL");
4684 MODULE_ALIAS("platform:soc-audio");
4685 

This page was automatically generated by LXR 0.3.1 (source).  •  Linux is a registered trademark of Linus Torvalds  •  Contact us