Linux Audio

Check our new training course

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