xref: /openbmc/linux/sound/soc/soc-core.c (revision 5f32c314)
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