soc-core.c 106.3 KB
Newer Older
F
Frank Mandarino 已提交
1 2 3 4
/*
 * soc-core.c  --  ALSA SoC Audio Layer
 *
 * Copyright 2005 Wolfson Microelectronics PLC.
5
 * Copyright 2005 Openedhand Ltd.
6 7
 * Copyright (C) 2010 Slimlogic Ltd.
 * Copyright (C) 2010 Texas Instruments Inc.
8
 *
9
 * Author: Liam Girdwood <lrg@slimlogic.co.uk>
10 11
 *         with code, comments and ideas from :-
 *         Richard Purdie <richard@openedhand.com>
F
Frank Mandarino 已提交
12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
 *
 *  This program is free software; you can redistribute  it and/or modify it
 *  under  the terms of  the GNU General  Public License as published by the
 *  Free Software Foundation;  either version 2 of the  License, or (at your
 *  option) any later version.
 *
 *  TODO:
 *   o Add hw rules to enforce rates, etc.
 *   o More testing with other codecs/machines.
 *   o Add more codecs and platforms to ensure good API coverage.
 *   o Support TDM on PCM and I2S
 */

#include <linux/module.h>
#include <linux/moduleparam.h>
#include <linux/init.h>
#include <linux/delay.h>
#include <linux/pm.h>
#include <linux/bitops.h>
31
#include <linux/debugfs.h>
F
Frank Mandarino 已提交
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/dmi.h>
F
Frank Mandarino 已提交
38
#include <sound/core.h>
39
#include <sound/jack.h>
F
Frank Mandarino 已提交
40 41 42
#include <sound/pcm.h>
#include <sound/pcm_params.h>
#include <sound/soc.h>
43
#include <sound/soc-dpcm.h>
44
#include <sound/soc-topology.h>
F
Frank Mandarino 已提交
45 46
#include <sound/initval.h>

47 48 49
#define CREATE_TRACE_POINTS
#include <trace/events/asoc.h>

50 51
#define NAME_SIZE	32

52
#ifdef CONFIG_DEBUG_FS
53 54
struct dentry *snd_soc_debugfs_root;
EXPORT_SYMBOL_GPL(snd_soc_debugfs_root);
55 56
#endif

M
Mark Brown 已提交
57
static DEFINE_MUTEX(client_mutex);
M
Mark Brown 已提交
58
static LIST_HEAD(platform_list);
M
Mark Brown 已提交
59
static LIST_HEAD(codec_list);
60
static LIST_HEAD(component_list);
M
Mark Brown 已提交
61

F
Frank Mandarino 已提交
62 63 64 65 66 67 68 69 70
/*
 * This is a timeout to do a DAPM powerdown after a stream is closed().
 * It can be used to eliminate pops between different playback streams, e.g.
 * between two audio tracks.
 */
static int pmdown_time = 5000;
module_param(pmdown_time, int, 0);
MODULE_PARM_DESC(pmdown_time, "DAPM stream powerdown time (msecs)");

71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88
/* returns the minimum number of bytes needed to represent
 * a particular given value */
static int min_bytes_needed(unsigned long val)
{
	int c = 0;
	int i;

	for (i = (sizeof val * 8) - 1; i >= 0; --i, ++c)
		if (val & (1UL << i))
			break;
	c = (sizeof val * 8) - c;
	if (!c || (c % 8))
		c = (c + 8) / 8;
	else
		c /= 8;
	return c;
}

89 90 91 92 93
/* fill buf which is 'len' bytes with a formatted
 * string of the form 'reg: value\n' */
static int format_register_str(struct snd_soc_codec *codec,
			       unsigned int reg, char *buf, size_t len)
{
94 95
	int wordsize = min_bytes_needed(codec->driver->reg_cache_size) * 2;
	int regsize = codec->driver->reg_word_size * 2;
96 97 98 99 100 101
	int ret;

	/* +2 for ': ' and + 1 for '\n' */
	if (wordsize + regsize + 2 + 1 != len)
		return -EINVAL;

102 103
	sprintf(buf, "%.*x: ", wordsize, reg);
	buf += wordsize + 2;
104

105 106 107 108 109 110 111
	ret = snd_soc_read(codec, reg);
	if (ret < 0)
		memset(buf, 'X', regsize);
	else
		sprintf(buf, "%.*x", regsize, ret);
	buf[regsize] = '\n';
	/* no NUL-termination needed */
112 113 114
	return 0;
}

115
/* codec register dump */
116 117
static ssize_t soc_codec_reg_show(struct snd_soc_codec *codec, char *buf,
				  size_t count, loff_t pos)
118
{
119
	int i, step = 1;
120
	int wordsize, regsize;
121 122 123
	int len;
	size_t total = 0;
	loff_t p = 0;
124

125 126
	wordsize = min_bytes_needed(codec->driver->reg_cache_size) * 2;
	regsize = codec->driver->reg_word_size * 2;
127

128 129
	len = wordsize + regsize + 2 + 1;

130
	if (!codec->driver->reg_cache_size)
131 132
		return 0;

133 134
	if (codec->driver->reg_cache_step)
		step = codec->driver->reg_cache_step;
135

136
	for (i = 0; i < codec->driver->reg_cache_size; i += step) {
137 138 139 140 141 142 143
		/* only support larger than PAGE_SIZE bytes debugfs
		 * entries for the default case */
		if (p >= pos) {
			if (total + len >= count - 1)
				break;
			format_register_str(codec, i, buf + total, len);
			total += len;
144
		}
145
		p += len;
146 147
	}

148
	total = min(total, count - 1);
149

150
	return total;
151
}
152

153 154 155
static ssize_t codec_reg_show(struct device *dev,
	struct device_attribute *attr, char *buf)
{
156
	struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);
157

158
	return soc_codec_reg_show(rtd->codec, buf, PAGE_SIZE, 0);
159 160 161 162
}

static DEVICE_ATTR(codec_reg, 0444, codec_reg_show, NULL);

163 164 165
static ssize_t pmdown_time_show(struct device *dev,
				struct device_attribute *attr, char *buf)
{
166
	struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);
167

168
	return sprintf(buf, "%ld\n", rtd->pmdown_time);
169 170 171 172 173 174
}

static ssize_t pmdown_time_set(struct device *dev,
			       struct device_attribute *attr,
			       const char *buf, size_t count)
{
175
	struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);
176
	int ret;
177

178
	ret = kstrtol(buf, 10, &rtd->pmdown_time);
179 180
	if (ret)
		return ret;
181 182 183 184 185 186

	return count;
}

static DEVICE_ATTR(pmdown_time, 0644, pmdown_time_show, pmdown_time_set);

187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219
static struct attribute *soc_dev_attrs[] = {
	&dev_attr_codec_reg.attr,
	&dev_attr_pmdown_time.attr,
	NULL
};

static umode_t soc_dev_attr_is_visible(struct kobject *kobj,
				       struct attribute *attr, int idx)
{
	struct device *dev = kobj_to_dev(kobj);
	struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);

	if (attr == &dev_attr_pmdown_time.attr)
		return attr->mode; /* always visible */
	return rtd->codec ? attr->mode : 0; /* enabled only with codec */
}

static const struct attribute_group soc_dapm_dev_group = {
	.attrs = soc_dapm_dev_attrs,
	.is_visible = soc_dev_attr_is_visible,
};

static const struct attribute_group soc_dev_roup = {
	.attrs = soc_dev_attrs,
	.is_visible = soc_dev_attr_is_visible,
};

static const struct attribute_group *soc_dev_attr_groups[] = {
	&soc_dapm_dev_group,
	&soc_dev_roup,
	NULL
};

220 221
#ifdef CONFIG_DEBUG_FS
static ssize_t codec_reg_read_file(struct file *file, char __user *user_buf,
222
				   size_t count, loff_t *ppos)
223 224 225
{
	ssize_t ret;
	struct snd_soc_codec *codec = file->private_data;
226 227 228 229 230 231
	char *buf;

	if (*ppos < 0 || !count)
		return -EINVAL;

	buf = kmalloc(count, GFP_KERNEL);
232 233
	if (!buf)
		return -ENOMEM;
234 235 236 237 238 239 240 241 242 243

	ret = soc_codec_reg_show(codec, buf, count, *ppos);
	if (ret >= 0) {
		if (copy_to_user(user_buf, buf, ret)) {
			kfree(buf);
			return -EFAULT;
		}
		*ppos += ret;
	}

244 245 246 247 248 249 250 251
	kfree(buf);
	return ret;
}

static ssize_t codec_reg_write_file(struct file *file,
		const char __user *user_buf, size_t count, loff_t *ppos)
{
	char buf[32];
252
	size_t buf_size;
253 254 255
	char *start = buf;
	unsigned long reg, value;
	struct snd_soc_codec *codec = file->private_data;
256
	int ret;
257 258 259 260 261 262 263 264 265 266 267

	buf_size = min(count, (sizeof(buf)-1));
	if (copy_from_user(buf, user_buf, buf_size))
		return -EFAULT;
	buf[buf_size] = 0;

	while (*start == ' ')
		start++;
	reg = simple_strtoul(start, &start, 16);
	while (*start == ' ')
		start++;
268 269 270
	ret = kstrtoul(start, 16, &value);
	if (ret)
		return ret;
271 272

	/* Userspace has been fiddling around behind the kernel's back */
273
	add_taint(TAINT_USER, LOCKDEP_NOW_UNRELIABLE);
274

275
	snd_soc_write(codec, reg, value);
276 277 278 279
	return buf_size;
}

static const struct file_operations codec_reg_fops = {
280
	.open = simple_open,
281 282
	.read = codec_reg_read_file,
	.write = codec_reg_write_file,
283
	.llseek = default_llseek,
284 285
};

286
static void soc_init_component_debugfs(struct snd_soc_component *component)
287
{
288 289 290
	if (!component->card->debugfs_card_root)
		return;

291 292
	if (component->debugfs_prefix) {
		char *name;
293

294 295 296 297 298 299 300 301 302 303 304
		name = kasprintf(GFP_KERNEL, "%s:%s",
			component->debugfs_prefix, component->name);
		if (name) {
			component->debugfs_root = debugfs_create_dir(name,
				component->card->debugfs_card_root);
			kfree(name);
		}
	} else {
		component->debugfs_root = debugfs_create_dir(component->name,
				component->card->debugfs_card_root);
	}
305

306 307 308 309 310
	if (!component->debugfs_root) {
		dev_warn(component->dev,
			"ASoC: Failed to create component debugfs directory\n");
		return;
	}
311

312 313
	snd_soc_dapm_debugfs_init(snd_soc_component_get_dapm(component),
		component->debugfs_root);
314

315 316
	if (component->init_debugfs)
		component->init_debugfs(component);
317 318
}

319
static void soc_cleanup_component_debugfs(struct snd_soc_component *component)
320
{
321 322
	debugfs_remove_recursive(component->debugfs_root);
}
323

324 325 326
static void soc_init_codec_debugfs(struct snd_soc_component *component)
{
	struct snd_soc_codec *codec = snd_soc_component_to_codec(component);
327 328

	codec->debugfs_reg = debugfs_create_file("codec_reg", 0644,
329
						 codec->component.debugfs_root,
330 331
						 codec, &codec_reg_fops);
	if (!codec->debugfs_reg)
332 333
		dev_warn(codec->dev,
			"ASoC: Failed to create codec register debugfs file\n");
334 335
}

336 337 338 339
static ssize_t codec_list_read_file(struct file *file, char __user *user_buf,
				    size_t count, loff_t *ppos)
{
	char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
340
	ssize_t len, ret = 0;
341 342 343 344 345
	struct snd_soc_codec *codec;

	if (!buf)
		return -ENOMEM;

346 347
	mutex_lock(&client_mutex);

348 349
	list_for_each_entry(codec, &codec_list, list) {
		len = snprintf(buf + ret, PAGE_SIZE - ret, "%s\n",
350
			       codec->component.name);
351 352 353 354 355 356 357
		if (len >= 0)
			ret += len;
		if (ret > PAGE_SIZE) {
			ret = PAGE_SIZE;
			break;
		}
	}
358

359 360
	mutex_unlock(&client_mutex);

361 362 363 364 365 366 367 368 369 370 371 372 373
	if (ret >= 0)
		ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);

	kfree(buf);

	return ret;
}

static const struct file_operations codec_list_fops = {
	.read = codec_list_read_file,
	.llseek = default_llseek,/* read accesses f_pos */
};

M
Mark Brown 已提交
374 375 376 377
static ssize_t dai_list_read_file(struct file *file, char __user *user_buf,
				  size_t count, loff_t *ppos)
{
	char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
378
	ssize_t len, ret = 0;
379
	struct snd_soc_component *component;
M
Mark Brown 已提交
380 381 382 383 384
	struct snd_soc_dai *dai;

	if (!buf)
		return -ENOMEM;

385 386
	mutex_lock(&client_mutex);

387 388 389 390 391 392 393 394 395 396
	list_for_each_entry(component, &component_list, list) {
		list_for_each_entry(dai, &component->dai_list, list) {
			len = snprintf(buf + ret, PAGE_SIZE - ret, "%s\n",
				dai->name);
			if (len >= 0)
				ret += len;
			if (ret > PAGE_SIZE) {
				ret = PAGE_SIZE;
				break;
			}
397 398
		}
	}
M
Mark Brown 已提交
399

400 401
	mutex_unlock(&client_mutex);

402
	ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
M
Mark Brown 已提交
403 404 405 406 407 408 409 410 411 412 413

	kfree(buf);

	return ret;
}

static const struct file_operations dai_list_fops = {
	.read = dai_list_read_file,
	.llseek = default_llseek,/* read accesses f_pos */
};

414 415 416 417 418
static ssize_t platform_list_read_file(struct file *file,
				       char __user *user_buf,
				       size_t count, loff_t *ppos)
{
	char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
419
	ssize_t len, ret = 0;
420 421 422 423 424
	struct snd_soc_platform *platform;

	if (!buf)
		return -ENOMEM;

425 426
	mutex_lock(&client_mutex);

427 428
	list_for_each_entry(platform, &platform_list, list) {
		len = snprintf(buf + ret, PAGE_SIZE - ret, "%s\n",
429
			       platform->component.name);
430 431 432 433 434 435 436
		if (len >= 0)
			ret += len;
		if (ret > PAGE_SIZE) {
			ret = PAGE_SIZE;
			break;
		}
	}
437

438 439
	mutex_unlock(&client_mutex);

440
	ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
441 442 443 444 445 446 447 448 449 450 451

	kfree(buf);

	return ret;
}

static const struct file_operations platform_list_fops = {
	.read = platform_list_read_file,
	.llseek = default_llseek,/* read accesses f_pos */
};

452 453
static void soc_init_card_debugfs(struct snd_soc_card *card)
{
454 455 456
	if (!snd_soc_debugfs_root)
		return;

457
	card->debugfs_card_root = debugfs_create_dir(card->name,
458
						     snd_soc_debugfs_root);
459
	if (!card->debugfs_card_root) {
460
		dev_warn(card->dev,
461
			 "ASoC: Failed to create card debugfs directory\n");
462 463 464 465 466 467 468 469
		return;
	}

	card->debugfs_pop_time = debugfs_create_u32("dapm_pop_time", 0644,
						    card->debugfs_card_root,
						    &card->pop_time);
	if (!card->debugfs_pop_time)
		dev_warn(card->dev,
470
		       "ASoC: Failed to create pop time debugfs file\n");
471 472 473 474 475 476 477
}

static void soc_cleanup_card_debugfs(struct snd_soc_card *card)
{
	debugfs_remove_recursive(card->debugfs_card_root);
}

478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505

static void snd_soc_debugfs_init(void)
{
	snd_soc_debugfs_root = debugfs_create_dir("asoc", NULL);
	if (IS_ERR(snd_soc_debugfs_root) || !snd_soc_debugfs_root) {
		pr_warn("ASoC: Failed to create debugfs directory\n");
		snd_soc_debugfs_root = NULL;
		return;
	}

	if (!debugfs_create_file("codecs", 0444, snd_soc_debugfs_root, NULL,
				 &codec_list_fops))
		pr_warn("ASoC: Failed to create CODEC list debugfs file\n");

	if (!debugfs_create_file("dais", 0444, snd_soc_debugfs_root, NULL,
				 &dai_list_fops))
		pr_warn("ASoC: Failed to create DAI list debugfs file\n");

	if (!debugfs_create_file("platforms", 0444, snd_soc_debugfs_root, NULL,
				 &platform_list_fops))
		pr_warn("ASoC: Failed to create platform list debugfs file\n");
}

static void snd_soc_debugfs_exit(void)
{
	debugfs_remove_recursive(snd_soc_debugfs_root);
}

506 507
#else

508
#define soc_init_codec_debugfs NULL
509

510 511
static inline void soc_init_component_debugfs(
	struct snd_soc_component *component)
512 513 514
{
}

515 516
static inline void soc_cleanup_component_debugfs(
	struct snd_soc_component *component)
517 518 519
{
}

520 521 522 523 524 525 526
static inline void soc_init_card_debugfs(struct snd_soc_card *card)
{
}

static inline void soc_cleanup_card_debugfs(struct snd_soc_card *card)
{
}
527 528 529 530 531 532 533 534 535

static inline void snd_soc_debugfs_init(void)
{
}

static inline void snd_soc_debugfs_exit(void)
{
}

536 537
#endif

538 539 540
struct snd_pcm_substream *snd_soc_get_dai_substream(struct snd_soc_card *card,
		const char *dai_link, int stream)
{
541
	struct snd_soc_pcm_runtime *rtd;
542

543 544 545 546
	list_for_each_entry(rtd, &card->rtd_list, list) {
		if (rtd->dai_link->no_pcm &&
			!strcmp(rtd->dai_link->name, dai_link))
			return rtd->pcm->streams[stream].substream;
547
	}
548
	dev_dbg(card->dev, "ASoC: failed to find dai link %s\n", dai_link);
549 550 551 552
	return NULL;
}
EXPORT_SYMBOL_GPL(snd_soc_get_dai_substream);

553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601
static struct snd_soc_pcm_runtime *soc_new_pcm_runtime(
	struct snd_soc_card *card, struct snd_soc_dai_link *dai_link)
{
	struct snd_soc_pcm_runtime *rtd;

	rtd = kzalloc(sizeof(struct snd_soc_pcm_runtime), GFP_KERNEL);
	if (!rtd)
		return NULL;

	rtd->card = card;
	rtd->dai_link = dai_link;
	rtd->codec_dais = kzalloc(sizeof(struct snd_soc_dai *) *
					dai_link->num_codecs,
					GFP_KERNEL);
	if (!rtd->codec_dais) {
		kfree(rtd);
		return NULL;
	}

	return rtd;
}

static void soc_free_pcm_runtime(struct snd_soc_pcm_runtime *rtd)
{
	if (rtd && rtd->codec_dais)
		kfree(rtd->codec_dais);
	kfree(rtd);
}

static void soc_add_pcm_runtime(struct snd_soc_card *card,
		struct snd_soc_pcm_runtime *rtd)
{
	list_add_tail(&rtd->list, &card->rtd_list);
	rtd->num = card->num_rtd;
	card->num_rtd++;
}

static void soc_remove_pcm_runtimes(struct snd_soc_card *card)
{
	struct snd_soc_pcm_runtime *rtd, *_rtd;

	list_for_each_entry_safe(rtd, _rtd, &card->rtd_list, list) {
		list_del(&rtd->list);
		soc_free_pcm_runtime(rtd);
	}

	card->num_rtd = 0;
}

602 603 604
struct snd_soc_pcm_runtime *snd_soc_get_pcm_runtime(struct snd_soc_card *card,
		const char *dai_link)
{
605
	struct snd_soc_pcm_runtime *rtd;
606

607 608 609
	list_for_each_entry(rtd, &card->rtd_list, list) {
		if (!strcmp(rtd->dai_link->name, dai_link))
			return rtd;
610
	}
611
	dev_dbg(card->dev, "ASoC: failed to find rtd %s\n", dai_link);
612 613 614 615
	return NULL;
}
EXPORT_SYMBOL_GPL(snd_soc_get_pcm_runtime);

616 617 618 619 620 621 622 623 624
static void codec2codec_close_delayed_work(struct work_struct *work)
{
	/* Currently nothing to do for c2c links
	 * Since c2c links are internal nodes in the DAPM graph and
	 * don't interface with the outside world or application layer
	 * we don't have to do any special handling on close.
	 */
}

625
#ifdef CONFIG_PM_SLEEP
F
Frank Mandarino 已提交
626
/* powers down audio subsystem for suspend */
627
int snd_soc_suspend(struct device *dev)
F
Frank Mandarino 已提交
628
{
629
	struct snd_soc_card *card = dev_get_drvdata(dev);
630
	struct snd_soc_component *component;
631 632
	struct snd_soc_pcm_runtime *rtd;
	int i;
F
Frank Mandarino 已提交
633

634 635
	/* If the card is not initialized yet there is nothing to do */
	if (!card->instantiated)
636 637
		return 0;

638 639 640
	/* Due to the resume being scheduled into a workqueue we could
	* suspend before that's finished - wait for it to complete.
	 */
641 642 643
	snd_power_lock(card->snd_card);
	snd_power_wait(card->snd_card, SNDRV_CTL_POWER_D0);
	snd_power_unlock(card->snd_card);
644 645

	/* we're going to block userspace touching us until resume completes */
646
	snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D3hot);
647

M
Mark Brown 已提交
648
	/* mute any active DACs */
649
	list_for_each_entry(rtd, &card->rtd_list, list) {
650

651
		if (rtd->dai_link->ignore_suspend)
652 653
			continue;

654 655
		for (i = 0; i < rtd->num_codecs; i++) {
			struct snd_soc_dai *dai = rtd->codec_dais[i];
656 657 658 659 660
			struct snd_soc_dai_driver *drv = dai->driver;

			if (drv->ops->digital_mute && dai->playback_active)
				drv->ops->digital_mute(dai, 1);
		}
F
Frank Mandarino 已提交
661 662
	}

663
	/* suspend all pcms */
664 665
	list_for_each_entry(rtd, &card->rtd_list, list) {
		if (rtd->dai_link->ignore_suspend)
666 667
			continue;

668
		snd_pcm_suspend_all(rtd->pcm);
669
	}
670

671
	if (card->suspend_pre)
672
		card->suspend_pre(card);
F
Frank Mandarino 已提交
673

674 675
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
676

677
		if (rtd->dai_link->ignore_suspend)
678 679
			continue;

680
		if (cpu_dai->driver->suspend && !cpu_dai->driver->bus_control)
681
			cpu_dai->driver->suspend(cpu_dai);
F
Frank Mandarino 已提交
682 683
	}

684
	/* close any waiting streams */
685 686
	list_for_each_entry(rtd, &card->rtd_list, list)
		flush_delayed_work(&rtd->delayed_work);
F
Frank Mandarino 已提交
687

688
	list_for_each_entry(rtd, &card->rtd_list, list) {
689

690
		if (rtd->dai_link->ignore_suspend)
691 692
			continue;

693
		snd_soc_dapm_stream_event(rtd,
694 695
					  SNDRV_PCM_STREAM_PLAYBACK,
					  SND_SOC_DAPM_STREAM_SUSPEND);
696

697
		snd_soc_dapm_stream_event(rtd,
698 699
					  SNDRV_PCM_STREAM_CAPTURE,
					  SND_SOC_DAPM_STREAM_SUSPEND);
F
Frank Mandarino 已提交
700 701
	}

702 703
	/* Recheck all endpoints too, their state is affected by suspend */
	dapm_mark_endpoints_dirty(card);
704 705
	snd_soc_dapm_sync(&card->dapm);

706
	/* suspend all COMPONENTs */
707 708 709
	list_for_each_entry(component, &card->component_dev_list, card_list) {
		struct snd_soc_dapm_context *dapm = snd_soc_component_get_dapm(component);

710
		/* If there are paths active then the COMPONENT will be held with
711
		 * bias _ON and should not be suspended. */
712
		if (!component->suspended) {
713
			switch (snd_soc_dapm_get_bias_level(dapm)) {
714
			case SND_SOC_BIAS_STANDBY:
715
				/*
716
				 * If the COMPONENT is capable of idle
717 718 719 720
				 * bias off then being in STANDBY
				 * means it's doing something,
				 * otherwise fall through.
				 */
721
				if (dapm->idle_bias_off) {
722
					dev_dbg(component->dev,
723
						"ASoC: idle_bias_off CODEC on over suspend\n");
724 725
					break;
				}
726

727
			case SND_SOC_BIAS_OFF:
728 729 730 731 732
				if (component->suspend)
					component->suspend(component);
				component->suspended = 1;
				if (component->regmap)
					regcache_mark_dirty(component->regmap);
733
				/* deactivate pins to sleep state */
734
				pinctrl_pm_select_sleep_state(component->dev);
735 736
				break;
			default:
737 738
				dev_dbg(component->dev,
					"ASoC: COMPONENT is on over suspend\n");
739 740
				break;
			}
741 742
		}
	}
F
Frank Mandarino 已提交
743

744 745
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
746

747
		if (rtd->dai_link->ignore_suspend)
748 749
			continue;

750
		if (cpu_dai->driver->suspend && cpu_dai->driver->bus_control)
751
			cpu_dai->driver->suspend(cpu_dai);
752 753 754

		/* deactivate pins to sleep state */
		pinctrl_pm_select_sleep_state(cpu_dai->dev);
F
Frank Mandarino 已提交
755 756
	}

757
	if (card->suspend_post)
758
		card->suspend_post(card);
F
Frank Mandarino 已提交
759 760 761

	return 0;
}
762
EXPORT_SYMBOL_GPL(snd_soc_suspend);
F
Frank Mandarino 已提交
763

764 765 766 767
/* deferred resume work, so resume can complete before we finished
 * setting our codec back up, which can be very slow on I2C
 */
static void soc_resume_deferred(struct work_struct *work)
F
Frank Mandarino 已提交
768
{
769 770
	struct snd_soc_card *card =
			container_of(work, struct snd_soc_card, deferred_resume_work);
771
	struct snd_soc_pcm_runtime *rtd;
772
	struct snd_soc_component *component;
773
	int i;
F
Frank Mandarino 已提交
774

775 776 777 778
	/* our power state is still SNDRV_CTL_POWER_D3hot from suspend time,
	 * so userspace apps are blocked from touching us
	 */

779
	dev_dbg(card->dev, "ASoC: starting resume work\n");
780

781
	/* Bring us up into D2 so that DAPM starts enabling things */
782
	snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D2);
783

784
	if (card->resume_pre)
785
		card->resume_pre(card);
F
Frank Mandarino 已提交
786

787
	/* resume control bus DAIs */
788 789
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
790

791
		if (rtd->dai_link->ignore_suspend)
792 793
			continue;

794
		if (cpu_dai->driver->resume && cpu_dai->driver->bus_control)
795 796 797
			cpu_dai->driver->resume(cpu_dai);
	}

798
	list_for_each_entry(component, &card->component_dev_list, card_list) {
799 800 801 802
		if (component->suspended) {
			if (component->resume)
				component->resume(component);
			component->suspended = 0;
803 804
		}
	}
F
Frank Mandarino 已提交
805

806
	list_for_each_entry(rtd, &card->rtd_list, list) {
807

808
		if (rtd->dai_link->ignore_suspend)
809 810
			continue;

811
		snd_soc_dapm_stream_event(rtd,
812
					  SNDRV_PCM_STREAM_PLAYBACK,
813
					  SND_SOC_DAPM_STREAM_RESUME);
814

815
		snd_soc_dapm_stream_event(rtd,
816
					  SNDRV_PCM_STREAM_CAPTURE,
817
					  SND_SOC_DAPM_STREAM_RESUME);
F
Frank Mandarino 已提交
818 819
	}

820
	/* unmute any active DACs */
821
	list_for_each_entry(rtd, &card->rtd_list, list) {
822

823
		if (rtd->dai_link->ignore_suspend)
824 825
			continue;

826 827
		for (i = 0; i < rtd->num_codecs; i++) {
			struct snd_soc_dai *dai = rtd->codec_dais[i];
828 829 830 831 832
			struct snd_soc_dai_driver *drv = dai->driver;

			if (drv->ops->digital_mute && dai->playback_active)
				drv->ops->digital_mute(dai, 0);
		}
F
Frank Mandarino 已提交
833 834
	}

835 836
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
837

838
		if (rtd->dai_link->ignore_suspend)
839 840
			continue;

841
		if (cpu_dai->driver->resume && !cpu_dai->driver->bus_control)
842
			cpu_dai->driver->resume(cpu_dai);
F
Frank Mandarino 已提交
843 844
	}

845
	if (card->resume_post)
846
		card->resume_post(card);
F
Frank Mandarino 已提交
847

848
	dev_dbg(card->dev, "ASoC: resume work completed\n");
849

850 851
	/* Recheck all endpoints too, their state is affected by suspend */
	dapm_mark_endpoints_dirty(card);
852
	snd_soc_dapm_sync(&card->dapm);
853 854 855

	/* userspace can access us now we are back as we were before */
	snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D0);
856 857 858
}

/* powers up audio subsystem after a suspend */
859
int snd_soc_resume(struct device *dev)
860
{
861
	struct snd_soc_card *card = dev_get_drvdata(dev);
862
	bool bus_control = false;
863
	struct snd_soc_pcm_runtime *rtd;
864

865 866
	/* If the card is not initialized yet there is nothing to do */
	if (!card->instantiated)
867 868
		return 0;

869
	/* activate pins from sleep state */
870
	list_for_each_entry(rtd, &card->rtd_list, list) {
871 872 873 874
		struct snd_soc_dai **codec_dais = rtd->codec_dais;
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
		int j;

875 876
		if (cpu_dai->active)
			pinctrl_pm_select_default_state(cpu_dai->dev);
877 878 879 880 881 882

		for (j = 0; j < rtd->num_codecs; j++) {
			struct snd_soc_dai *codec_dai = codec_dais[j];
			if (codec_dai->active)
				pinctrl_pm_select_default_state(codec_dai->dev);
		}
883 884
	}

885 886 887 888
	/*
	 * DAIs that also act as the control bus master might have other drivers
	 * hanging off them so need to resume immediately. Other drivers don't
	 * have that problem and may take a substantial amount of time to resume
889 890
	 * due to I/O costs and anti-pop so handle them out of line.
	 */
891 892
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
893
		bus_control |= cpu_dai->driver->bus_control;
894
	}
895 896
	if (bus_control) {
		dev_dbg(dev, "ASoC: Resuming control bus master immediately\n");
897 898
		soc_resume_deferred(&card->deferred_resume_work);
	} else {
899
		dev_dbg(dev, "ASoC: Scheduling resume work\n");
900
		if (!schedule_work(&card->deferred_resume_work))
901
			dev_err(dev, "ASoC: resume work item may be lost\n");
902
	}
903

F
Frank Mandarino 已提交
904 905
	return 0;
}
906
EXPORT_SYMBOL_GPL(snd_soc_resume);
F
Frank Mandarino 已提交
907
#else
908 909
#define snd_soc_suspend NULL
#define snd_soc_resume NULL
F
Frank Mandarino 已提交
910 911
#endif

912
static const struct snd_soc_dai_ops null_dai_ops = {
913 914
};

915 916
static struct snd_soc_component *soc_find_component(
	const struct device_node *of_node, const char *name)
917
{
918
	struct snd_soc_component *component;
919

920 921
	lockdep_assert_held(&client_mutex);

922 923 924 925 926 927
	list_for_each_entry(component, &component_list, list) {
		if (of_node) {
			if (component->dev->of_node == of_node)
				return component;
		} else if (strcmp(component->name, name) == 0) {
			return component;
928 929 930 931 932 933
		}
	}

	return NULL;
}

934 935 936 937 938 939 940 941 942 943 944
/**
 * snd_soc_find_dai - Find a registered DAI
 *
 * @dlc: name of the DAI and optional component info to match
 *
 * This function will search all regsitered components and their DAIs to
 * find the DAI of the same name. The component's of_node and name
 * should also match if being specified.
 *
 * Return: pointer of DAI, or NULL if not found.
 */
M
Mengdong Lin 已提交
945
struct snd_soc_dai *snd_soc_find_dai(
946
	const struct snd_soc_dai_link_component *dlc)
947
{
948 949
	struct snd_soc_component *component;
	struct snd_soc_dai *dai;
950
	struct device_node *component_of_node;
951

952 953
	lockdep_assert_held(&client_mutex);

954 955
	/* Find CPU DAI from registered DAIs*/
	list_for_each_entry(component, &component_list, list) {
956 957 958 959 960
		component_of_node = component->dev->of_node;
		if (!component_of_node && component->dev->parent)
			component_of_node = component->dev->parent->of_node;

		if (dlc->of_node && component_of_node != dlc->of_node)
961
			continue;
962
		if (dlc->name && strcmp(component->name, dlc->name))
963 964 965
			continue;
		list_for_each_entry(dai, &component->dai_list, list) {
			if (dlc->dai_name && strcmp(dai->name, dlc->dai_name))
966 967
				continue;

968
			return dai;
969 970 971 972 973
		}
	}

	return NULL;
}
M
Mengdong Lin 已提交
974
EXPORT_SYMBOL_GPL(snd_soc_find_dai);
975

M
Mengdong Lin 已提交
976 977 978 979 980 981 982

/**
 * snd_soc_find_dai_link - Find a DAI link
 *
 * @card: soc card
 * @id: DAI link ID to match
 * @name: DAI link name to match, optional
983
 * @stream_name: DAI link stream name to match, optional
M
Mengdong Lin 已提交
984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017
 *
 * This function will search all existing DAI links of the soc card to
 * find the link of the same ID. Since DAI links may not have their
 * unique ID, so name and stream name should also match if being
 * specified.
 *
 * Return: pointer of DAI link, or NULL if not found.
 */
struct snd_soc_dai_link *snd_soc_find_dai_link(struct snd_soc_card *card,
					       int id, const char *name,
					       const char *stream_name)
{
	struct snd_soc_dai_link *link, *_link;

	lockdep_assert_held(&client_mutex);

	list_for_each_entry_safe(link, _link, &card->dai_link_list, list) {
		if (link->id != id)
			continue;

		if (name && (!link->name || strcmp(name, link->name)))
			continue;

		if (stream_name && (!link->stream_name
			|| strcmp(stream_name, link->stream_name)))
			continue;

		return link;
	}

	return NULL;
}
EXPORT_SYMBOL_GPL(snd_soc_find_dai_link);

1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030
static bool soc_is_dai_link_bound(struct snd_soc_card *card,
		struct snd_soc_dai_link *dai_link)
{
	struct snd_soc_pcm_runtime *rtd;

	list_for_each_entry(rtd, &card->rtd_list, list) {
		if (rtd->dai_link == dai_link)
			return true;
	}

	return false;
}

1031 1032
static int soc_bind_dai_link(struct snd_soc_card *card,
	struct snd_soc_dai_link *dai_link)
F
Frank Mandarino 已提交
1033
{
1034
	struct snd_soc_pcm_runtime *rtd;
1035
	struct snd_soc_dai_link_component *codecs = dai_link->codecs;
1036
	struct snd_soc_dai_link_component cpu_dai_component;
1037
	struct snd_soc_dai **codec_dais;
1038
	struct snd_soc_platform *platform;
1039
	struct device_node *platform_of_node;
1040
	const char *platform_name;
1041
	int i;
1042

1043
	dev_dbg(card->dev, "ASoC: binding %s\n", dai_link->name);
1044

1045 1046 1047 1048 1049
	if (soc_is_dai_link_bound(card, dai_link)) {
		dev_dbg(card->dev, "ASoC: dai link %s already bound\n",
			dai_link->name);
		return 0;
	}
1050

S
Sudip Mukherjee 已提交
1051 1052 1053 1054
	rtd = soc_new_pcm_runtime(card, dai_link);
	if (!rtd)
		return -ENOMEM;

1055 1056 1057 1058
	cpu_dai_component.name = dai_link->cpu_name;
	cpu_dai_component.of_node = dai_link->cpu_of_node;
	cpu_dai_component.dai_name = dai_link->cpu_dai_name;
	rtd->cpu_dai = snd_soc_find_dai(&cpu_dai_component);
1059
	if (!rtd->cpu_dai) {
1060
		dev_err(card->dev, "ASoC: CPU DAI %s not registered\n",
1061
			dai_link->cpu_dai_name);
1062
		goto _err_defer;
1063 1064
	}

1065
	rtd->num_codecs = dai_link->num_codecs;
1066

1067
	/* Find CODEC from registered CODECs */
1068
	codec_dais = rtd->codec_dais;
1069
	for (i = 0; i < rtd->num_codecs; i++) {
1070
		codec_dais[i] = snd_soc_find_dai(&codecs[i]);
1071 1072 1073
		if (!codec_dais[i]) {
			dev_err(card->dev, "ASoC: CODEC DAI %s not registered\n",
				codecs[i].dai_name);
1074
			goto _err_defer;
1075
		}
1076 1077
	}

1078 1079 1080 1081
	/* Single codec links expect codec and codec_dai in runtime data */
	rtd->codec_dai = codec_dais[0];
	rtd->codec = rtd->codec_dai->codec;

1082 1083
	/* if there's no platform we match on the empty platform */
	platform_name = dai_link->platform_name;
1084
	if (!platform_name && !dai_link->platform_of_node)
1085 1086
		platform_name = "snd-soc-dummy";

1087
	/* find one from the set of registered platforms */
1088
	list_for_each_entry(platform, &platform_list, list) {
1089 1090 1091 1092
		platform_of_node = platform->dev->of_node;
		if (!platform_of_node && platform->dev->parent->of_node)
			platform_of_node = platform->dev->parent->of_node;

1093
		if (dai_link->platform_of_node) {
1094
			if (platform_of_node != dai_link->platform_of_node)
1095 1096
				continue;
		} else {
1097
			if (strcmp(platform->component.name, platform_name))
1098 1099
				continue;
		}
1100 1101

		rtd->platform = platform;
1102
	}
1103
	if (!rtd->platform) {
1104
		dev_err(card->dev, "ASoC: platform %s not registered\n",
1105
			dai_link->platform_name);
1106
		goto _err_defer;
1107
	}
1108

1109
	soc_add_pcm_runtime(card, rtd);
1110
	return 0;
1111 1112 1113 1114

_err_defer:
	soc_free_pcm_runtime(rtd);
	return  -EPROBE_DEFER;
1115 1116
}

1117
static void soc_remove_component(struct snd_soc_component *component)
1118
{
1119
	if (!component->card)
1120
		return;
1121

1122
	list_del(&component->card_list);
1123

1124 1125
	if (component->remove)
		component->remove(component);
1126

1127
	snd_soc_dapm_free(snd_soc_component_get_dapm(component));
1128

1129
	soc_cleanup_component_debugfs(component);
1130
	component->card = NULL;
1131
	module_put(component->dev->driver->owner);
1132 1133
}

1134
static void soc_remove_dai(struct snd_soc_dai *dai, int order)
1135 1136 1137
{
	int err;

1138 1139 1140 1141
	if (dai && dai->probed &&
			dai->driver->remove_order == order) {
		if (dai->driver->remove) {
			err = dai->driver->remove(dai);
1142
			if (err < 0)
1143
				dev_err(dai->dev,
1144
					"ASoC: failed to remove %s: %d\n",
1145
					dai->name, err);
1146
		}
1147
		dai->probed = 0;
1148
	}
1149 1150
}

1151 1152
static void soc_remove_link_dais(struct snd_soc_card *card,
		struct snd_soc_pcm_runtime *rtd, int order)
1153
{
1154
	int i;
1155 1156 1157 1158 1159 1160 1161 1162

	/* unregister the rtd device */
	if (rtd->dev_registered) {
		device_unregister(rtd->dev);
		rtd->dev_registered = 0;
	}

	/* remove the CODEC DAI */
1163
	for (i = 0; i < rtd->num_codecs; i++)
1164
		soc_remove_dai(rtd->codec_dais[i], order);
1165

1166
	soc_remove_dai(rtd->cpu_dai, order);
1167
}
F
Frank Mandarino 已提交
1168

1169 1170
static void soc_remove_link_components(struct snd_soc_card *card,
	struct snd_soc_pcm_runtime *rtd, int order)
1171 1172 1173
{
	struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
	struct snd_soc_platform *platform = rtd->platform;
1174
	struct snd_soc_component *component;
1175
	int i;
1176 1177

	/* remove the platform */
1178
	if (platform && platform->component.driver->remove_order == order)
1179
		soc_remove_component(&platform->component);
1180 1181

	/* remove the CODEC-side CODEC */
1182
	for (i = 0; i < rtd->num_codecs; i++) {
1183
		component = rtd->codec_dais[i]->component;
1184
		if (component->driver->remove_order == order)
1185
			soc_remove_component(component);
1186 1187 1188 1189
	}

	/* remove any CPU-side CODEC */
	if (cpu_dai) {
1190
		if (cpu_dai->component->driver->remove_order == order)
1191
			soc_remove_component(cpu_dai->component);
1192 1193 1194
	}
}

1195 1196
static void soc_remove_dai_links(struct snd_soc_card *card)
{
1197 1198
	int order;
	struct snd_soc_pcm_runtime *rtd;
1199
	struct snd_soc_dai_link *link, *_link;
1200

1201 1202
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
			order++) {
1203 1204
		list_for_each_entry(rtd, &card->rtd_list, list)
			soc_remove_link_dais(card, rtd, order);
1205 1206 1207 1208
	}

	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
			order++) {
1209 1210
		list_for_each_entry(rtd, &card->rtd_list, list)
			soc_remove_link_components(card, rtd, order);
1211
	}
1212

1213 1214 1215 1216 1217 1218 1219 1220
	list_for_each_entry_safe(link, _link, &card->dai_link_list, list) {
		if (link->dobj.type == SND_SOC_DOBJ_DAI_LINK)
			dev_warn(card->dev, "Topology forgot to remove link %s?\n",
				link->name);

		list_del(&link->list);
		card->num_dai_links--;
	}
1221 1222
}

1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314
static int snd_soc_init_multicodec(struct snd_soc_card *card,
				   struct snd_soc_dai_link *dai_link)
{
	/* Legacy codec/codec_dai link is a single entry in multicodec */
	if (dai_link->codec_name || dai_link->codec_of_node ||
	    dai_link->codec_dai_name) {
		dai_link->num_codecs = 1;

		dai_link->codecs = devm_kzalloc(card->dev,
				sizeof(struct snd_soc_dai_link_component),
				GFP_KERNEL);
		if (!dai_link->codecs)
			return -ENOMEM;

		dai_link->codecs[0].name = dai_link->codec_name;
		dai_link->codecs[0].of_node = dai_link->codec_of_node;
		dai_link->codecs[0].dai_name = dai_link->codec_dai_name;
	}

	if (!dai_link->codecs) {
		dev_err(card->dev, "ASoC: DAI link has no CODECs\n");
		return -EINVAL;
	}

	return 0;
}

static int soc_init_dai_link(struct snd_soc_card *card,
				   struct snd_soc_dai_link *link)
{
	int i, ret;

	ret = snd_soc_init_multicodec(card, link);
	if (ret) {
		dev_err(card->dev, "ASoC: failed to init multicodec\n");
		return ret;
	}

	for (i = 0; i < link->num_codecs; i++) {
		/*
		 * Codec must be specified by 1 of name or OF node,
		 * not both or neither.
		 */
		if (!!link->codecs[i].name ==
		    !!link->codecs[i].of_node) {
			dev_err(card->dev, "ASoC: Neither/both codec name/of_node are set for %s\n",
				link->name);
			return -EINVAL;
		}
		/* Codec DAI name must be specified */
		if (!link->codecs[i].dai_name) {
			dev_err(card->dev, "ASoC: codec_dai_name not set for %s\n",
				link->name);
			return -EINVAL;
		}
	}

	/*
	 * Platform may be specified by either name or OF node, but
	 * can be left unspecified, and a dummy platform will be used.
	 */
	if (link->platform_name && link->platform_of_node) {
		dev_err(card->dev,
			"ASoC: Both platform name/of_node are set for %s\n",
			link->name);
		return -EINVAL;
	}

	/*
	 * CPU device may be specified by either name or OF node, but
	 * can be left unspecified, and will be matched based on DAI
	 * name alone..
	 */
	if (link->cpu_name && link->cpu_of_node) {
		dev_err(card->dev,
			"ASoC: Neither/both cpu name/of_node are set for %s\n",
			link->name);
		return -EINVAL;
	}
	/*
	 * At least one of CPU DAI name or CPU device name/node must be
	 * specified
	 */
	if (!link->cpu_dai_name &&
	    !(link->cpu_name || link->cpu_of_node)) {
		dev_err(card->dev,
			"ASoC: Neither cpu_dai_name nor cpu_name/of_node are set for %s\n",
			link->name);
		return -EINVAL;
	}

	return 0;
1315 1316
}

1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338
/**
 * snd_soc_add_dai_link - Add a DAI link dynamically
 * @card: The ASoC card to which the DAI link is added
 * @dai_link: The new DAI link to add
 *
 * This function adds a DAI link to the ASoC card's link list.
 *
 * Note: Topology can use this API to add DAI links when probing the
 * topology component. And machine drivers can still define static
 * DAI links in dai_link array.
 */
int snd_soc_add_dai_link(struct snd_soc_card *card,
		struct snd_soc_dai_link *dai_link)
{
	if (dai_link->dobj.type
	    && dai_link->dobj.type != SND_SOC_DOBJ_DAI_LINK) {
		dev_err(card->dev, "Invalid dai link type %d\n",
			dai_link->dobj.type);
		return -EINVAL;
	}

	lockdep_assert_held(&client_mutex);
1339 1340 1341 1342 1343 1344
	/* Notify the machine driver for extra initialization
	 * on the link created by topology.
	 */
	if (dai_link->dobj.type && card->add_dai_link)
		card->add_dai_link(card, dai_link);

1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374
	list_add_tail(&dai_link->list, &card->dai_link_list);
	card->num_dai_links++;

	return 0;
}
EXPORT_SYMBOL_GPL(snd_soc_add_dai_link);

/**
 * snd_soc_remove_dai_link - Remove a DAI link from the list
 * @card: The ASoC card that owns the link
 * @dai_link: The DAI link to remove
 *
 * This function removes a DAI link from the ASoC card's link list.
 *
 * For DAI links previously added by topology, topology should
 * remove them by using the dobj embedded in the link.
 */
void snd_soc_remove_dai_link(struct snd_soc_card *card,
			     struct snd_soc_dai_link *dai_link)
{
	struct snd_soc_dai_link *link, *_link;

	if (dai_link->dobj.type
	    && dai_link->dobj.type != SND_SOC_DOBJ_DAI_LINK) {
		dev_err(card->dev, "Invalid dai link type %d\n",
			dai_link->dobj.type);
		return;
	}

	lockdep_assert_held(&client_mutex);
1375 1376 1377 1378 1379 1380
	/* Notify the machine driver for extra destruction
	 * on the link created by topology.
	 */
	if (dai_link->dobj.type && card->remove_dai_link)
		card->remove_dai_link(card, dai_link);

1381 1382 1383 1384 1385 1386 1387 1388 1389 1390
	list_for_each_entry_safe(link, _link, &card->dai_link_list, list) {
		if (link == dai_link) {
			list_del(&link->list);
			card->num_dai_links--;
			return;
		}
	}
}
EXPORT_SYMBOL_GPL(snd_soc_remove_dai_link);

1391
static void soc_set_name_prefix(struct snd_soc_card *card,
1392
				struct snd_soc_component *component)
1393 1394 1395
{
	int i;

1396
	if (card->codec_conf == NULL)
1397 1398
		return;

1399 1400
	for (i = 0; i < card->num_configs; i++) {
		struct snd_soc_codec_conf *map = &card->codec_conf[i];
1401
		if (map->of_node && component->dev->of_node != map->of_node)
1402
			continue;
1403
		if (map->dev_name && strcmp(component->name, map->dev_name))
1404
			continue;
1405
		component->name_prefix = map->name_prefix;
1406
		break;
1407 1408 1409
	}
}

1410 1411
static int soc_probe_component(struct snd_soc_card *card,
	struct snd_soc_component *component)
1412
{
1413
	struct snd_soc_dapm_context *dapm = snd_soc_component_get_dapm(component);
1414
	struct snd_soc_dai *dai;
1415
	int ret;
1416

1417
	if (!strcmp(component->name, "snd-soc-dummy"))
1418
		return 0;
1419

1420
	if (component->card) {
1421 1422 1423 1424 1425 1426 1427 1428
		if (component->card != card) {
			dev_err(component->dev,
				"Trying to bind component to card \"%s\" but is already bound to card \"%s\"\n",
				card->name, component->card->name);
			return -ENODEV;
		}
		return 0;
	}
1429

1430
	if (!try_module_get(component->dev->driver->owner))
1431 1432
		return -ENODEV;

1433 1434 1435
	component->card = card;
	dapm->card = card;
	soc_set_name_prefix(card, component);
1436

1437
	soc_init_component_debugfs(component);
1438

1439 1440 1441
	if (component->dapm_widgets) {
		ret = snd_soc_dapm_new_controls(dapm, component->dapm_widgets,
			component->num_dapm_widgets);
1442 1443

		if (ret != 0) {
1444
			dev_err(component->dev,
1445 1446 1447 1448
				"Failed to create new controls %d\n", ret);
			goto err_probe;
		}
	}
1449

1450 1451
	list_for_each_entry(dai, &component->dai_list, list) {
		ret = snd_soc_dapm_new_dai_widgets(dapm, dai);
1452
		if (ret != 0) {
1453
			dev_err(component->dev,
1454 1455 1456 1457
				"Failed to create DAI widgets %d\n", ret);
			goto err_probe;
		}
	}
1458

1459 1460
	if (component->probe) {
		ret = component->probe(component);
1461
		if (ret < 0) {
1462 1463
			dev_err(component->dev,
				"ASoC: failed to probe component %d\n", ret);
1464
			goto err_probe;
1465
		}
1466

1467 1468 1469 1470
		WARN(dapm->idle_bias_off &&
			dapm->bias_level != SND_SOC_BIAS_OFF,
			"codec %s can not start from non-off bias with idle_bias_off==1\n",
			component->name);
1471 1472
	}

1473 1474 1475 1476 1477 1478 1479 1480 1481 1482
	/* machine specific init */
	if (component->init) {
		ret = component->init(component);
		if (ret < 0) {
			dev_err(component->dev,
				"Failed to do machine specific init %d\n", ret);
			goto err_probe;
		}
	}

1483 1484 1485 1486 1487 1488
	if (component->controls)
		snd_soc_add_component_controls(component, component->controls,
				     component->num_controls);
	if (component->dapm_routes)
		snd_soc_dapm_add_routes(dapm, component->dapm_routes,
					component->num_dapm_routes);
1489

1490
	list_add(&dapm->list, &card->dapm_list);
1491
	list_add(&component->card_list, &card->component_dev_list);
1492 1493 1494 1495

	return 0;

err_probe:
1496
	soc_cleanup_component_debugfs(component);
1497
	component->card = NULL;
1498
	module_put(component->dev->driver->owner);
1499 1500 1501 1502

	return ret;
}

1503 1504 1505 1506
static void rtd_release(struct device *dev)
{
	kfree(dev);
}
1507

1508 1509
static int soc_post_component_init(struct snd_soc_pcm_runtime *rtd,
	const char *name)
1510
{
1511 1512 1513
	int ret = 0;

	/* register the rtd device */
1514 1515 1516 1517
	rtd->dev = kzalloc(sizeof(struct device), GFP_KERNEL);
	if (!rtd->dev)
		return -ENOMEM;
	device_initialize(rtd->dev);
1518
	rtd->dev->parent = rtd->card->dev;
1519
	rtd->dev->release = rtd_release;
1520
	rtd->dev->groups = soc_dev_attr_groups;
1521
	dev_set_name(rtd->dev, "%s", name);
1522
	dev_set_drvdata(rtd->dev, rtd);
L
Liam Girdwood 已提交
1523
	mutex_init(&rtd->pcm_mutex);
1524 1525 1526 1527
	INIT_LIST_HEAD(&rtd->dpcm[SNDRV_PCM_STREAM_PLAYBACK].be_clients);
	INIT_LIST_HEAD(&rtd->dpcm[SNDRV_PCM_STREAM_CAPTURE].be_clients);
	INIT_LIST_HEAD(&rtd->dpcm[SNDRV_PCM_STREAM_PLAYBACK].fe_clients);
	INIT_LIST_HEAD(&rtd->dpcm[SNDRV_PCM_STREAM_CAPTURE].fe_clients);
1528
	ret = device_add(rtd->dev);
1529
	if (ret < 0) {
1530 1531
		/* calling put_device() here to free the rtd->dev */
		put_device(rtd->dev);
1532
		dev_err(rtd->card->dev,
1533
			"ASoC: failed to register runtime device: %d\n", ret);
1534 1535 1536 1537 1538 1539
		return ret;
	}
	rtd->dev_registered = 1;
	return 0;
}

1540 1541
static int soc_probe_link_components(struct snd_soc_card *card,
			struct snd_soc_pcm_runtime *rtd,
1542 1543 1544
				     int order)
{
	struct snd_soc_platform *platform = rtd->platform;
1545
	struct snd_soc_component *component;
1546
	int i, ret;
1547 1548

	/* probe the CPU-side component, if it is a CODEC */
1549
	component = rtd->cpu_dai->component;
1550
	if (component->driver->probe_order == order) {
1551
		ret = soc_probe_component(card, component);
1552 1553 1554 1555
		if (ret < 0)
			return ret;
	}

1556 1557
	/* probe the CODEC-side components */
	for (i = 0; i < rtd->num_codecs; i++) {
1558
		component = rtd->codec_dais[i]->component;
1559
		if (component->driver->probe_order == order) {
1560
			ret = soc_probe_component(card, component);
1561 1562 1563
			if (ret < 0)
				return ret;
		}
1564 1565 1566
	}

	/* probe the platform */
1567
	if (platform->component.driver->probe_order == order) {
1568
		ret = soc_probe_component(card, &platform->component);
1569 1570 1571 1572 1573 1574 1575
		if (ret < 0)
			return ret;
	}

	return 0;
}

1576
static int soc_probe_dai(struct snd_soc_dai *dai, int order)
1577 1578 1579
{
	int ret;

1580 1581 1582
	if (!dai->probed && dai->driver->probe_order == order) {
		if (dai->driver->probe) {
			ret = dai->driver->probe(dai);
1583
			if (ret < 0) {
1584 1585 1586
				dev_err(dai->dev,
					"ASoC: failed to probe DAI %s: %d\n",
					dai->name, ret);
1587 1588 1589 1590
				return ret;
			}
		}

1591
		dai->probed = 1;
1592 1593 1594 1595 1596
	}

	return 0;
}

1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617
static int soc_link_dai_pcm_new(struct snd_soc_dai **dais, int num_dais,
				struct snd_soc_pcm_runtime *rtd)
{
	int i, ret = 0;

	for (i = 0; i < num_dais; ++i) {
		struct snd_soc_dai_driver *drv = dais[i]->driver;

		if (!rtd->dai_link->no_pcm && drv->pcm_new)
			ret = drv->pcm_new(rtd, dais[i]);
		if (ret < 0) {
			dev_err(dais[i]->dev,
				"ASoC: Failed to bind %s with pcm device\n",
				dais[i]->name);
			return ret;
		}
	}

	return 0;
}

1618 1619
static int soc_link_dai_widgets(struct snd_soc_card *card,
				struct snd_soc_dai_link *dai_link,
1620
				struct snd_soc_pcm_runtime *rtd)
1621
{
1622 1623
	struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
	struct snd_soc_dai *codec_dai = rtd->codec_dai;
1624
	struct snd_soc_dapm_widget *sink, *source;
1625 1626
	int ret;

1627 1628 1629
	if (rtd->num_codecs > 1)
		dev_warn(card->dev, "ASoC: Multiple codecs not supported yet\n");

1630
	/* link the DAI widgets */
1631 1632 1633
	sink = codec_dai->playback_widget;
	source = cpu_dai->capture_widget;
	if (sink && source) {
1634
		ret = snd_soc_dapm_new_pcm(card, dai_link->params,
1635 1636
					   dai_link->num_params,
					   source, sink);
1637 1638
		if (ret != 0) {
			dev_err(card->dev, "ASoC: Can't link %s to %s: %d\n",
1639
				sink->name, source->name, ret);
1640 1641 1642 1643
			return ret;
		}
	}

1644 1645 1646
	sink = cpu_dai->playback_widget;
	source = codec_dai->capture_widget;
	if (sink && source) {
1647
		ret = snd_soc_dapm_new_pcm(card, dai_link->params,
1648 1649
					   dai_link->num_params,
					   source, sink);
1650 1651
		if (ret != 0) {
			dev_err(card->dev, "ASoC: Can't link %s to %s: %d\n",
1652
				sink->name, source->name, ret);
1653 1654 1655 1656 1657 1658 1659
			return ret;
		}
	}

	return 0;
}

1660 1661
static int soc_probe_link_dais(struct snd_soc_card *card,
		struct snd_soc_pcm_runtime *rtd, int order)
1662
{
1663
	struct snd_soc_dai_link *dai_link = rtd->dai_link;
1664
	struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
1665
	int i, ret;
1666

1667
	dev_dbg(card->dev, "ASoC: probe %s dai link %d late %d\n",
1668
			card->name, rtd->num, order);
1669 1670 1671 1672

	/* set default power off timeout */
	rtd->pmdown_time = pmdown_time;

1673 1674 1675
	ret = soc_probe_dai(cpu_dai, order);
	if (ret)
		return ret;
F
Frank Mandarino 已提交
1676

1677
	/* probe the CODEC DAI */
1678
	for (i = 0; i < rtd->num_codecs; i++) {
1679
		ret = soc_probe_dai(rtd->codec_dais[i], order);
1680 1681 1682
		if (ret)
			return ret;
	}
M
Mark Brown 已提交
1683

1684 1685 1686 1687
	/* complete DAI probe during last probe */
	if (order != SND_SOC_COMP_ORDER_LAST)
		return 0;

1688 1689 1690 1691 1692 1693 1694 1695 1696 1697
	/* do machine specific initialization */
	if (dai_link->init) {
		ret = dai_link->init(rtd);
		if (ret < 0) {
			dev_err(card->dev, "ASoC: failed to init %s: %d\n",
				dai_link->name, ret);
			return ret;
		}
	}

1698 1699 1700
	if (dai_link->dai_fmt)
		snd_soc_runtime_set_dai_fmt(rtd, dai_link->dai_fmt);

1701
	ret = soc_post_component_init(rtd, dai_link->name);
1702
	if (ret)
1703
		return ret;
M
Mark Brown 已提交
1704

1705 1706
#ifdef CONFIG_DEBUG_FS
	/* add DPCM sysfs entries */
1707 1708
	if (dai_link->dynamic)
		soc_dpcm_debugfs_add(rtd);
1709 1710
#endif

1711
	if (cpu_dai->driver->compress_new) {
1712
		/*create compress_device"*/
1713
		ret = cpu_dai->driver->compress_new(rtd, rtd->num);
1714
		if (ret < 0) {
1715
			dev_err(card->dev, "ASoC: can't create compress %s\n",
1716
					 dai_link->stream_name);
1717 1718 1719
			return ret;
		}
	} else {
1720 1721 1722

		if (!dai_link->params) {
			/* create the pcm */
1723
			ret = soc_new_pcm(rtd, rtd->num);
1724
			if (ret < 0) {
1725
				dev_err(card->dev, "ASoC: can't create pcm %s :%d\n",
1726
				       dai_link->stream_name, ret);
1727 1728
				return ret;
			}
1729 1730 1731 1732 1733 1734 1735
			ret = soc_link_dai_pcm_new(&cpu_dai, 1, rtd);
			if (ret < 0)
				return ret;
			ret = soc_link_dai_pcm_new(rtd->codec_dais,
						   rtd->num_codecs, rtd);
			if (ret < 0)
				return ret;
1736
		} else {
1737 1738 1739
			INIT_DELAYED_WORK(&rtd->delayed_work,
						codec2codec_close_delayed_work);

1740
			/* link the DAI widgets */
1741
			ret = soc_link_dai_widgets(card, dai_link, rtd);
1742 1743
			if (ret)
				return ret;
1744
		}
1745 1746 1747 1748 1749
	}

	return 0;
}

1750
static int soc_bind_aux_dev(struct snd_soc_card *card, int num)
1751 1752
{
	struct snd_soc_aux_dev *aux_dev = &card->aux_dev[num];
1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775
	struct snd_soc_component *component;
	const char *name;
	struct device_node *codec_of_node;

	if (aux_dev->codec_of_node || aux_dev->codec_name) {
		/* codecs, usually analog devices */
		name = aux_dev->codec_name;
		codec_of_node = aux_dev->codec_of_node;
		component = soc_find_component(codec_of_node, name);
		if (!component) {
			if (codec_of_node)
				name = of_node_full_name(codec_of_node);
			goto err_defer;
		}
	} else if (aux_dev->name) {
		/* generic components */
		name = aux_dev->name;
		component = soc_find_component(NULL, name);
		if (!component)
			goto err_defer;
	} else {
		dev_err(card->dev, "ASoC: Invalid auxiliary device\n");
		return -EINVAL;
1776
	}
1777

1778
	component->init = aux_dev->init;
1779
	component->auxiliary = 1;
1780
	list_add(&component->card_aux_list, &card->aux_comp_list);
1781

1782
	return 0;
1783 1784 1785 1786

err_defer:
	dev_err(card->dev, "ASoC: %s not registered\n", name);
	return -EPROBE_DEFER;
1787 1788
}

1789
static int soc_probe_aux_devices(struct snd_soc_card *card)
1790
{
1791
	struct snd_soc_component *comp, *tmp;
1792
	int order;
1793
	int ret;
1794

1795 1796
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
		order++) {
1797 1798
		list_for_each_entry_safe(comp, tmp, &card->aux_comp_list,
					 card_aux_list) {
1799 1800 1801 1802 1803 1804 1805 1806
			if (comp->driver->probe_order == order) {
				ret = soc_probe_component(card,	comp);
				if (ret < 0) {
					dev_err(card->dev,
						"ASoC: failed to probe aux component %s %d\n",
						comp->name, ret);
					return ret;
				}
1807
				list_del(&comp->card_aux_list);
1808
			}
1809 1810
		}
	}
1811

1812
	return 0;
1813 1814
}

1815
static void soc_remove_aux_devices(struct snd_soc_card *card)
1816
{
1817 1818
	struct snd_soc_component *comp, *_comp;
	int order;
1819

1820 1821 1822
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
		order++) {
		list_for_each_entry_safe(comp, _comp,
1823 1824 1825 1826 1827
			&card->component_dev_list, card_list) {

			if (!comp->auxiliary)
				continue;

1828 1829
			if (comp->driver->remove_order == order) {
				soc_remove_component(comp);
1830
				comp->auxiliary = 0;
1831 1832
			}
		}
1833 1834 1835
	}
}

1836
static int snd_soc_init_codec_cache(struct snd_soc_codec *codec)
1837 1838 1839 1840 1841 1842 1843 1844
{
	int ret;

	if (codec->cache_init)
		return 0;

	ret = snd_soc_cache_init(codec);
	if (ret < 0) {
1845 1846 1847
		dev_err(codec->dev,
			"ASoC: Failed to set cache compression type: %d\n",
			ret);
1848 1849 1850 1851 1852 1853
		return ret;
	}
	codec->cache_init = 1;
	return 0;
}

1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917
/**
 * snd_soc_runtime_set_dai_fmt() - Change DAI link format for a ASoC runtime
 * @rtd: The runtime for which the DAI link format should be changed
 * @dai_fmt: The new DAI link format
 *
 * This function updates the DAI link format for all DAIs connected to the DAI
 * link for the specified runtime.
 *
 * Note: For setups with a static format set the dai_fmt field in the
 * corresponding snd_dai_link struct instead of using this function.
 *
 * Returns 0 on success, otherwise a negative error code.
 */
int snd_soc_runtime_set_dai_fmt(struct snd_soc_pcm_runtime *rtd,
	unsigned int dai_fmt)
{
	struct snd_soc_dai **codec_dais = rtd->codec_dais;
	struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
	unsigned int i;
	int ret;

	for (i = 0; i < rtd->num_codecs; i++) {
		struct snd_soc_dai *codec_dai = codec_dais[i];

		ret = snd_soc_dai_set_fmt(codec_dai, dai_fmt);
		if (ret != 0 && ret != -ENOTSUPP) {
			dev_warn(codec_dai->dev,
				 "ASoC: Failed to set DAI format: %d\n", ret);
			return ret;
		}
	}

	/* Flip the polarity for the "CPU" end of a CODEC<->CODEC link */
	if (cpu_dai->codec) {
		unsigned int inv_dai_fmt;

		inv_dai_fmt = dai_fmt & ~SND_SOC_DAIFMT_MASTER_MASK;
		switch (dai_fmt & SND_SOC_DAIFMT_MASTER_MASK) {
		case SND_SOC_DAIFMT_CBM_CFM:
			inv_dai_fmt |= SND_SOC_DAIFMT_CBS_CFS;
			break;
		case SND_SOC_DAIFMT_CBM_CFS:
			inv_dai_fmt |= SND_SOC_DAIFMT_CBS_CFM;
			break;
		case SND_SOC_DAIFMT_CBS_CFM:
			inv_dai_fmt |= SND_SOC_DAIFMT_CBM_CFS;
			break;
		case SND_SOC_DAIFMT_CBS_CFS:
			inv_dai_fmt |= SND_SOC_DAIFMT_CBM_CFM;
			break;
		}

		dai_fmt = inv_dai_fmt;
	}

	ret = snd_soc_dai_set_fmt(cpu_dai, dai_fmt);
	if (ret != 0 && ret != -ENOTSUPP) {
		dev_warn(cpu_dai->dev,
			 "ASoC: Failed to set DAI format: %d\n", ret);
		return ret;
	}

	return 0;
}
1918
EXPORT_SYMBOL_GPL(snd_soc_runtime_set_dai_fmt);
1919

1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052

/* Trim special characters, and replace '-' with '_' since '-' is used to
 * separate different DMI fields in the card long name. Only number and
 * alphabet characters and a few separator characters are kept.
 */
static void cleanup_dmi_name(char *name)
{
	int i, j = 0;

	for (i = 0; name[i]; i++) {
		if (isalnum(name[i]) || (name[i] == '.')
		    || (name[i] == '_'))
			name[j++] = name[i];
		else if (name[i] == '-')
			name[j++] = '_';
	}

	name[j] = '\0';
}

/**
 * snd_soc_set_dmi_name() - Register DMI names to card
 * @card: The card to register DMI names
 * @flavour: The flavour "differentiator" for the card amongst its peers.
 *
 * An Intel machine driver may be used by many different devices but are
 * difficult for userspace to differentiate, since machine drivers ususally
 * use their own name as the card short name and leave the card long name
 * blank. To differentiate such devices and fix bugs due to lack of
 * device-specific configurations, this function allows DMI info to be used
 * as the sound card long name, in the format of
 * "vendor-product-version-board"
 * (Character '-' is used to separate different DMI fields here).
 * This will help the user space to load the device-specific Use Case Manager
 * (UCM) configurations for the card.
 *
 * Possible card long names may be:
 * DellInc.-XPS139343-01-0310JH
 * ASUSTeKCOMPUTERINC.-T100TA-1.0-T100TA
 * Circuitco-MinnowboardMaxD0PLATFORM-D0-MinnowBoardMAX
 *
 * This function also supports flavoring the card longname to provide
 * the extra differentiation, like "vendor-product-version-board-flavor".
 *
 * We only keep number and alphabet characters and a few separator characters
 * in the card long name since UCM in the user space uses the card long names
 * as card configuration directory names and AudoConf cannot support special
 * charactors like SPACE.
 *
 * Returns 0 on success, otherwise a negative error code.
 */
int snd_soc_set_dmi_name(struct snd_soc_card *card, const char *flavour)
{
	const char *vendor, *product, *product_version, *board;
	size_t longname_buf_size = sizeof(card->snd_card->longname);
	size_t len;

	if (card->long_name)
		return 0; /* long name already set by driver or from DMI */

	/* make up dmi long name as: vendor.product.version.board */
	vendor = dmi_get_system_info(DMI_BOARD_VENDOR);
	if (!vendor) {
		dev_warn(card->dev, "ASoC: no DMI vendor name!\n");
		return 0;
	}

	snprintf(card->dmi_longname, sizeof(card->snd_card->longname),
			 "%s", vendor);
	cleanup_dmi_name(card->dmi_longname);

	product = dmi_get_system_info(DMI_PRODUCT_NAME);
	if (product) {
		len = strlen(card->dmi_longname);
		snprintf(card->dmi_longname + len,
			 longname_buf_size - len,
			 "-%s", product);

		len++;	/* skip the separator "-" */
		if (len < longname_buf_size)
			cleanup_dmi_name(card->dmi_longname + len);

		/* some vendors like Lenovo may only put a self-explanatory
		 * name in the product version field
		 */
		product_version = dmi_get_system_info(DMI_PRODUCT_VERSION);
		if (product_version) {
			len = strlen(card->dmi_longname);
			snprintf(card->dmi_longname + len,
				 longname_buf_size - len,
				 "-%s", product_version);

			len++;
			if (len < longname_buf_size)
				cleanup_dmi_name(card->dmi_longname + len);
		}
	}

	board = dmi_get_system_info(DMI_BOARD_NAME);
	if (board) {
		len = strlen(card->dmi_longname);
		snprintf(card->dmi_longname + len,
			 longname_buf_size - len,
			 "-%s", board);

		len++;
		if (len < longname_buf_size)
			cleanup_dmi_name(card->dmi_longname + len);
	} else if (!product) {
		/* fall back to using legacy name */
		dev_warn(card->dev, "ASoC: no DMI board/product name!\n");
		return 0;
	}

	/* Add flavour to dmi long name */
	if (flavour) {
		len = strlen(card->dmi_longname);
		snprintf(card->dmi_longname + len,
			 longname_buf_size - len,
			 "-%s", flavour);

		len++;
		if (len < longname_buf_size)
			cleanup_dmi_name(card->dmi_longname + len);
	}

	/* set the card long name */
	card->long_name = card->dmi_longname;

	return 0;
}
EXPORT_SYMBOL_GPL(snd_soc_set_dmi_name);

2053
static int snd_soc_instantiate_card(struct snd_soc_card *card)
2054
{
2055
	struct snd_soc_codec *codec;
2056
	struct snd_soc_pcm_runtime *rtd;
2057
	struct snd_soc_dai_link *dai_link;
2058
	int ret, i, order;
M
Mark Brown 已提交
2059

2060
	mutex_lock(&client_mutex);
2061
	mutex_lock_nested(&card->mutex, SND_SOC_CARD_CLASS_INIT);
2062

2063
	/* bind DAIs */
2064
	for (i = 0; i < card->num_links; i++) {
2065
		ret = soc_bind_dai_link(card, &card->dai_link[i]);
2066 2067 2068
		if (ret != 0)
			goto base_error;
	}
M
Mark Brown 已提交
2069

2070
	/* bind aux_devs too */
2071
	for (i = 0; i < card->num_aux_devs; i++) {
2072
		ret = soc_bind_aux_dev(card, i);
2073 2074
		if (ret != 0)
			goto base_error;
2075
	}
2076

2077 2078 2079 2080
	/* add predefined DAI links to the list */
	for (i = 0; i < card->num_links; i++)
		snd_soc_add_dai_link(card, card->dai_link+i);

2081 2082 2083 2084
	/* initialize the register cache for each available codec */
	list_for_each_entry(codec, &codec_list, list) {
		if (codec->cache_init)
			continue;
2085
		ret = snd_soc_init_codec_cache(codec);
2086 2087
		if (ret < 0)
			goto base_error;
2088 2089
	}

2090
	/* card bind complete so register a sound card */
2091
	ret = snd_card_new(card->dev, SNDRV_DEFAULT_IDX1, SNDRV_DEFAULT_STR1,
2092 2093
			card->owner, 0, &card->snd_card);
	if (ret < 0) {
2094 2095 2096
		dev_err(card->dev,
			"ASoC: can't create sound card for card %s: %d\n",
			card->name, ret);
2097
		goto base_error;
2098 2099
	}

2100 2101
	soc_init_card_debugfs(card);

M
Mark Brown 已提交
2102 2103 2104 2105 2106
	card->dapm.bias_level = SND_SOC_BIAS_OFF;
	card->dapm.dev = card->dev;
	card->dapm.card = card;
	list_add(&card->dapm.list, &card->dapm_list);

2107 2108 2109 2110
#ifdef CONFIG_DEBUG_FS
	snd_soc_dapm_debugfs_init(&card->dapm, card->debugfs_card_root);
#endif

2111
#ifdef CONFIG_PM_SLEEP
2112 2113 2114
	/* deferred resume work */
	INIT_WORK(&card->deferred_resume_work, soc_resume_deferred);
#endif
F
Frank Mandarino 已提交
2115

2116 2117 2118 2119
	if (card->dapm_widgets)
		snd_soc_dapm_new_controls(&card->dapm, card->dapm_widgets,
					  card->num_dapm_widgets);

2120 2121 2122 2123
	if (card->of_dapm_widgets)
		snd_soc_dapm_new_controls(&card->dapm, card->of_dapm_widgets,
					  card->num_of_dapm_widgets);

2124 2125
	/* initialise the sound card only once */
	if (card->probe) {
2126
		ret = card->probe(card);
2127 2128 2129
		if (ret < 0)
			goto card_probe_error;
	}
M
Mark Brown 已提交
2130

2131
	/* probe all components used by DAI links on this card */
2132 2133
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
			order++) {
2134 2135
		list_for_each_entry(rtd, &card->rtd_list, list) {
			ret = soc_probe_link_components(card, rtd, order);
2136
			if (ret < 0) {
2137 2138 2139
				dev_err(card->dev,
					"ASoC: failed to instantiate card %d\n",
					ret);
2140 2141 2142 2143 2144
				goto probe_dai_err;
			}
		}
	}

2145 2146 2147 2148 2149
	/* probe auxiliary components */
	ret = soc_probe_aux_devices(card);
	if (ret < 0)
		goto probe_dai_err;

2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 2160 2161 2162 2163 2164
	/* Find new DAI links added during probing components and bind them.
	 * Components with topology may bring new DAIs and DAI links.
	 */
	list_for_each_entry(dai_link, &card->dai_link_list, list) {
		if (soc_is_dai_link_bound(card, dai_link))
			continue;

		ret = soc_init_dai_link(card, dai_link);
		if (ret)
			goto probe_dai_err;
		ret = soc_bind_dai_link(card, dai_link);
		if (ret)
			goto probe_dai_err;
	}

2165 2166 2167
	/* probe all DAI links on this card */
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
			order++) {
2168 2169
		list_for_each_entry(rtd, &card->rtd_list, list) {
			ret = soc_probe_link_dais(card, rtd, order);
2170
			if (ret < 0) {
2171 2172 2173
				dev_err(card->dev,
					"ASoC: failed to instantiate card %d\n",
					ret);
2174 2175
				goto probe_dai_err;
			}
2176 2177
		}
	}
F
Frank Mandarino 已提交
2178

2179
	snd_soc_dapm_link_dai_widgets(card);
2180
	snd_soc_dapm_connect_dai_link_widgets(card);
2181

2182
	if (card->controls)
2183
		snd_soc_add_card_controls(card, card->controls, card->num_controls);
2184

2185 2186 2187 2188
	if (card->dapm_routes)
		snd_soc_dapm_add_routes(&card->dapm, card->dapm_routes,
					card->num_dapm_routes);

2189 2190 2191
	if (card->of_dapm_routes)
		snd_soc_dapm_add_routes(&card->dapm, card->of_dapm_routes,
					card->num_of_dapm_routes);
2192

2193 2194
	snprintf(card->snd_card->shortname, sizeof(card->snd_card->shortname),
		 "%s", card->name);
2195 2196
	snprintf(card->snd_card->longname, sizeof(card->snd_card->longname),
		 "%s", card->long_name ? card->long_name : card->name);
2197 2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208 2209 2210
	snprintf(card->snd_card->driver, sizeof(card->snd_card->driver),
		 "%s", card->driver_name ? card->driver_name : card->name);
	for (i = 0; i < ARRAY_SIZE(card->snd_card->driver); i++) {
		switch (card->snd_card->driver[i]) {
		case '_':
		case '-':
		case '\0':
			break;
		default:
			if (!isalnum(card->snd_card->driver[i]))
				card->snd_card->driver[i] = '_';
			break;
		}
	}
2211

2212 2213 2214
	if (card->late_probe) {
		ret = card->late_probe(card);
		if (ret < 0) {
2215
			dev_err(card->dev, "ASoC: %s late_probe() failed: %d\n",
2216 2217 2218 2219 2220
				card->name, ret);
			goto probe_aux_dev_err;
		}
	}

2221
	snd_soc_dapm_new_widgets(card);
2222

2223 2224
	ret = snd_card_register(card->snd_card);
	if (ret < 0) {
2225 2226
		dev_err(card->dev, "ASoC: failed to register soundcard %d\n",
				ret);
2227
		goto probe_aux_dev_err;
F
Frank Mandarino 已提交
2228 2229
	}

2230
	card->instantiated = 1;
2231
	snd_soc_dapm_sync(&card->dapm);
2232
	mutex_unlock(&card->mutex);
2233
	mutex_unlock(&client_mutex);
2234 2235

	return 0;
2236

2237
probe_aux_dev_err:
2238
	soc_remove_aux_devices(card);
2239

2240
probe_dai_err:
2241
	soc_remove_dai_links(card);
2242 2243

card_probe_error:
2244
	if (card->remove)
2245
		card->remove(card);
2246

2247
	snd_soc_dapm_free(&card->dapm);
2248
	soc_cleanup_card_debugfs(card);
2249 2250
	snd_card_free(card->snd_card);

2251
base_error:
2252
	soc_remove_pcm_runtimes(card);
2253
	mutex_unlock(&card->mutex);
2254
	mutex_unlock(&client_mutex);
F
Frank Mandarino 已提交
2255

2256
	return ret;
2257 2258 2259 2260 2261
}

/* probes a new socdev */
static int soc_probe(struct platform_device *pdev)
{
2262
	struct snd_soc_card *card = platform_get_drvdata(pdev);
2263

2264 2265 2266 2267 2268 2269 2270
	/*
	 * no card, so machine driver should be registering card
	 * we should not be here in that case so ret error
	 */
	if (!card)
		return -EINVAL;

2271
	dev_warn(&pdev->dev,
2272
		 "ASoC: machine %s should use snd_soc_register_card()\n",
2273 2274
		 card->name);

2275 2276
	/* Bodge while we unpick instantiation */
	card->dev = &pdev->dev;
2277

2278
	return snd_soc_register_card(card);
F
Frank Mandarino 已提交
2279 2280
}

2281
static int soc_cleanup_card_resources(struct snd_soc_card *card)
F
Frank Mandarino 已提交
2282
{
2283
	struct snd_soc_pcm_runtime *rtd;
F
Frank Mandarino 已提交
2284

2285
	/* make sure any delayed work runs */
2286
	list_for_each_entry(rtd, &card->rtd_list, list)
2287
		flush_delayed_work(&rtd->delayed_work);
2288

2289
	/* remove and free each DAI */
2290
	soc_remove_dai_links(card);
2291
	soc_remove_pcm_runtimes(card);
2292

2293 2294 2295
	/* remove auxiliary devices */
	soc_remove_aux_devices(card);

2296
	snd_soc_dapm_free(&card->dapm);
2297
	soc_cleanup_card_debugfs(card);
2298

2299 2300
	/* remove the card */
	if (card->remove)
2301
		card->remove(card);
2302

2303 2304 2305 2306 2307 2308 2309 2310 2311
	snd_card_free(card->snd_card);
	return 0;

}

/* removes a socdev */
static int soc_remove(struct platform_device *pdev)
{
	struct snd_soc_card *card = platform_get_drvdata(pdev);
F
Frank Mandarino 已提交
2312

M
Mark Brown 已提交
2313
	snd_soc_unregister_card(card);
F
Frank Mandarino 已提交
2314 2315 2316
	return 0;
}

2317
int snd_soc_poweroff(struct device *dev)
M
Mark Brown 已提交
2318
{
2319
	struct snd_soc_card *card = dev_get_drvdata(dev);
2320
	struct snd_soc_pcm_runtime *rtd;
M
Mark Brown 已提交
2321 2322

	if (!card->instantiated)
M
Mark Brown 已提交
2323
		return 0;
M
Mark Brown 已提交
2324 2325 2326

	/* Flush out pmdown_time work - we actually do want to run it
	 * now, we're shutting down so no imminent restart. */
2327
	list_for_each_entry(rtd, &card->rtd_list, list)
2328
		flush_delayed_work(&rtd->delayed_work);
M
Mark Brown 已提交
2329

2330
	snd_soc_dapm_shutdown(card);
M
Mark Brown 已提交
2331

2332
	/* deactivate pins to sleep state */
2333
	list_for_each_entry(rtd, &card->rtd_list, list) {
2334
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
2335
		int i;
2336

2337
		pinctrl_pm_select_sleep_state(cpu_dai->dev);
2338 2339
		for (i = 0; i < rtd->num_codecs; i++) {
			struct snd_soc_dai *codec_dai = rtd->codec_dais[i];
2340 2341
			pinctrl_pm_select_sleep_state(codec_dai->dev);
		}
2342 2343
	}

M
Mark Brown 已提交
2344
	return 0;
M
Mark Brown 已提交
2345
}
2346
EXPORT_SYMBOL_GPL(snd_soc_poweroff);
M
Mark Brown 已提交
2347

2348
const struct dev_pm_ops snd_soc_pm_ops = {
2349 2350 2351 2352
	.suspend = snd_soc_suspend,
	.resume = snd_soc_resume,
	.freeze = snd_soc_suspend,
	.thaw = snd_soc_resume,
2353
	.poweroff = snd_soc_poweroff,
2354
	.restore = snd_soc_resume,
M
Mark Brown 已提交
2355
};
2356
EXPORT_SYMBOL_GPL(snd_soc_pm_ops);
M
Mark Brown 已提交
2357

F
Frank Mandarino 已提交
2358 2359 2360 2361
/* ASoC platform driver */
static struct platform_driver soc_driver = {
	.driver		= {
		.name		= "soc-audio",
2362
		.pm		= &snd_soc_pm_ops,
F
Frank Mandarino 已提交
2363 2364 2365 2366 2367 2368 2369 2370 2371
	},
	.probe		= soc_probe,
	.remove		= soc_remove,
};

/**
 * snd_soc_cnew - create new control
 * @_template: control template
 * @data: control private data
M
Mark Brown 已提交
2372
 * @long_name: control long name
2373
 * @prefix: control name prefix
F
Frank Mandarino 已提交
2374 2375 2376 2377 2378 2379
 *
 * Create a new mixer control from a template control.
 *
 * Returns 0 for success, else error.
 */
struct snd_kcontrol *snd_soc_cnew(const struct snd_kcontrol_new *_template,
2380
				  void *data, const char *long_name,
2381
				  const char *prefix)
F
Frank Mandarino 已提交
2382 2383
{
	struct snd_kcontrol_new template;
2384 2385
	struct snd_kcontrol *kcontrol;
	char *name = NULL;
F
Frank Mandarino 已提交
2386 2387 2388 2389

	memcpy(&template, _template, sizeof(template));
	template.index = 0;

2390 2391 2392 2393
	if (!long_name)
		long_name = template.name;

	if (prefix) {
2394
		name = kasprintf(GFP_KERNEL, "%s %s", prefix, long_name);
2395 2396 2397 2398 2399 2400 2401 2402 2403 2404 2405 2406 2407
		if (!name)
			return NULL;

		template.name = name;
	} else {
		template.name = long_name;
	}

	kcontrol = snd_ctl_new1(&template, data);

	kfree(name);

	return kcontrol;
F
Frank Mandarino 已提交
2408 2409 2410
}
EXPORT_SYMBOL_GPL(snd_soc_cnew);

2411 2412 2413 2414 2415 2416 2417 2418 2419 2420 2421
static int snd_soc_add_controls(struct snd_card *card, struct device *dev,
	const struct snd_kcontrol_new *controls, int num_controls,
	const char *prefix, void *data)
{
	int err, i;

	for (i = 0; i < num_controls; i++) {
		const struct snd_kcontrol_new *control = &controls[i];
		err = snd_ctl_add(card, snd_soc_cnew(control, data,
						     control->name, prefix));
		if (err < 0) {
2422 2423
			dev_err(dev, "ASoC: Failed to add %s: %d\n",
				control->name, err);
2424 2425 2426 2427 2428 2429 2430
			return err;
		}
	}

	return 0;
}

2431 2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442 2443 2444 2445 2446
struct snd_kcontrol *snd_soc_card_get_kcontrol(struct snd_soc_card *soc_card,
					       const char *name)
{
	struct snd_card *card = soc_card->snd_card;
	struct snd_kcontrol *kctl;

	if (unlikely(!name))
		return NULL;

	list_for_each_entry(kctl, &card->controls, list)
		if (!strncmp(kctl->id.name, name, sizeof(kctl->id.name)))
			return kctl;
	return NULL;
}
EXPORT_SYMBOL_GPL(snd_soc_card_get_kcontrol);

2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 2462 2463 2464 2465
/**
 * snd_soc_add_component_controls - Add an array of controls to a component.
 *
 * @component: Component to add controls to
 * @controls: Array of controls to add
 * @num_controls: Number of elements in the array
 *
 * Return: 0 for success, else error.
 */
int snd_soc_add_component_controls(struct snd_soc_component *component,
	const struct snd_kcontrol_new *controls, unsigned int num_controls)
{
	struct snd_card *card = component->card->snd_card;

	return snd_soc_add_controls(card, component->dev, controls,
			num_controls, component->name_prefix, component);
}
EXPORT_SYMBOL_GPL(snd_soc_add_component_controls);

I
Ian Molton 已提交
2466
/**
2467 2468
 * snd_soc_add_codec_controls - add an array of controls to a codec.
 * Convenience function to add a list of controls. Many codecs were
I
Ian Molton 已提交
2469 2470 2471 2472 2473 2474 2475 2476
 * duplicating this code.
 *
 * @codec: codec to add controls to
 * @controls: array of controls to add
 * @num_controls: number of elements in the array
 *
 * Return 0 for success, else error.
 */
2477
int snd_soc_add_codec_controls(struct snd_soc_codec *codec,
2478
	const struct snd_kcontrol_new *controls, unsigned int num_controls)
I
Ian Molton 已提交
2479
{
2480 2481
	return snd_soc_add_component_controls(&codec->component, controls,
		num_controls);
I
Ian Molton 已提交
2482
}
2483
EXPORT_SYMBOL_GPL(snd_soc_add_codec_controls);
I
Ian Molton 已提交
2484

2485 2486
/**
 * snd_soc_add_platform_controls - add an array of controls to a platform.
2487
 * Convenience function to add a list of controls.
2488 2489 2490 2491 2492 2493 2494 2495
 *
 * @platform: platform to add controls to
 * @controls: array of controls to add
 * @num_controls: number of elements in the array
 *
 * Return 0 for success, else error.
 */
int snd_soc_add_platform_controls(struct snd_soc_platform *platform,
2496
	const struct snd_kcontrol_new *controls, unsigned int num_controls)
2497
{
2498 2499
	return snd_soc_add_component_controls(&platform->component, controls,
		num_controls);
2500 2501 2502
}
EXPORT_SYMBOL_GPL(snd_soc_add_platform_controls);

2503 2504 2505 2506 2507 2508 2509 2510 2511 2512 2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 2528 2529 2530 2531 2532 2533 2534 2535
/**
 * snd_soc_add_card_controls - add an array of controls to a SoC card.
 * Convenience function to add a list of controls.
 *
 * @soc_card: SoC card to add controls to
 * @controls: array of controls to add
 * @num_controls: number of elements in the array
 *
 * Return 0 for success, else error.
 */
int snd_soc_add_card_controls(struct snd_soc_card *soc_card,
	const struct snd_kcontrol_new *controls, int num_controls)
{
	struct snd_card *card = soc_card->snd_card;

	return snd_soc_add_controls(card, soc_card->dev, controls, num_controls,
			NULL, soc_card);
}
EXPORT_SYMBOL_GPL(snd_soc_add_card_controls);

/**
 * snd_soc_add_dai_controls - add an array of controls to a DAI.
 * Convienience function to add a list of controls.
 *
 * @dai: DAI to add controls to
 * @controls: array of controls to add
 * @num_controls: number of elements in the array
 *
 * Return 0 for success, else error.
 */
int snd_soc_add_dai_controls(struct snd_soc_dai *dai,
	const struct snd_kcontrol_new *controls, int num_controls)
{
2536
	struct snd_card *card = dai->component->card->snd_card;
2537 2538 2539 2540 2541 2542

	return snd_soc_add_controls(card, dai->dev, controls, num_controls,
			NULL, dai);
}
EXPORT_SYMBOL_GPL(snd_soc_add_dai_controls);

2543 2544 2545 2546 2547 2548 2549 2550 2551 2552 2553 2554
/**
 * snd_soc_dai_set_sysclk - configure DAI system or master clock.
 * @dai: DAI
 * @clk_id: DAI specific clock ID
 * @freq: new clock frequency in Hz
 * @dir: new clock direction - input/output.
 *
 * Configures the DAI master (MCLK) or system (SYSCLK) clocking.
 */
int snd_soc_dai_set_sysclk(struct snd_soc_dai *dai, int clk_id,
	unsigned int freq, int dir)
{
2555 2556
	if (dai->driver && dai->driver->ops->set_sysclk)
		return dai->driver->ops->set_sysclk(dai, clk_id, freq, dir);
2557
	else if (dai->codec && dai->codec->driver->set_sysclk)
2558
		return dai->codec->driver->set_sysclk(dai->codec, clk_id, 0,
2559
						      freq, dir);
2560
	else
2561
		return -ENOTSUPP;
2562 2563 2564
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_sysclk);

2565 2566 2567 2568
/**
 * snd_soc_codec_set_sysclk - configure CODEC system or master clock.
 * @codec: CODEC
 * @clk_id: DAI specific clock ID
2569
 * @source: Source for the clock
2570 2571 2572 2573 2574 2575
 * @freq: new clock frequency in Hz
 * @dir: new clock direction - input/output.
 *
 * Configures the CODEC master (MCLK) or system (SYSCLK) clocking.
 */
int snd_soc_codec_set_sysclk(struct snd_soc_codec *codec, int clk_id,
2576
			     int source, unsigned int freq, int dir)
2577 2578
{
	if (codec->driver->set_sysclk)
2579 2580
		return codec->driver->set_sysclk(codec, clk_id, source,
						 freq, dir);
2581
	else
2582
		return -ENOTSUPP;
2583 2584 2585
}
EXPORT_SYMBOL_GPL(snd_soc_codec_set_sysclk);

2586 2587 2588
/**
 * snd_soc_dai_set_clkdiv - configure DAI clock dividers.
 * @dai: DAI
M
Mark Brown 已提交
2589
 * @div_id: DAI specific clock divider ID
2590 2591 2592 2593 2594 2595 2596 2597 2598
 * @div: new clock divisor.
 *
 * Configures the clock dividers. This is used to derive the best DAI bit and
 * frame clocks from the system or master clock. It's best to set the DAI bit
 * and frame clocks as low as possible to save system power.
 */
int snd_soc_dai_set_clkdiv(struct snd_soc_dai *dai,
	int div_id, int div)
{
2599 2600
	if (dai->driver && dai->driver->ops->set_clkdiv)
		return dai->driver->ops->set_clkdiv(dai, div_id, div);
2601 2602 2603 2604 2605 2606 2607 2608 2609
	else
		return -EINVAL;
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_clkdiv);

/**
 * snd_soc_dai_set_pll - configure DAI PLL.
 * @dai: DAI
 * @pll_id: DAI specific PLL ID
2610
 * @source: DAI specific source for the PLL
2611 2612 2613 2614 2615
 * @freq_in: PLL input clock frequency in Hz
 * @freq_out: requested PLL output clock frequency in Hz
 *
 * Configures and enables PLL to generate output clock based on input clock.
 */
2616 2617
int snd_soc_dai_set_pll(struct snd_soc_dai *dai, int pll_id, int source,
	unsigned int freq_in, unsigned int freq_out)
2618
{
2619 2620
	if (dai->driver && dai->driver->ops->set_pll)
		return dai->driver->ops->set_pll(dai, pll_id, source,
2621
					 freq_in, freq_out);
2622 2623 2624
	else if (dai->codec && dai->codec->driver->set_pll)
		return dai->codec->driver->set_pll(dai->codec, pll_id, source,
						   freq_in, freq_out);
2625 2626 2627 2628 2629
	else
		return -EINVAL;
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_pll);

2630 2631 2632 2633 2634 2635 2636 2637 2638 2639 2640 2641 2642 2643 2644 2645 2646 2647 2648 2649 2650
/*
 * snd_soc_codec_set_pll - configure codec PLL.
 * @codec: CODEC
 * @pll_id: DAI specific PLL ID
 * @source: DAI specific source for the PLL
 * @freq_in: PLL input clock frequency in Hz
 * @freq_out: requested PLL output clock frequency in Hz
 *
 * Configures and enables PLL to generate output clock based on input clock.
 */
int snd_soc_codec_set_pll(struct snd_soc_codec *codec, int pll_id, int source,
			  unsigned int freq_in, unsigned int freq_out)
{
	if (codec->driver->set_pll)
		return codec->driver->set_pll(codec, pll_id, source,
					      freq_in, freq_out);
	else
		return -EINVAL;
}
EXPORT_SYMBOL_GPL(snd_soc_codec_set_pll);

2651 2652 2653
/**
 * snd_soc_dai_set_bclk_ratio - configure BCLK to sample rate ratio.
 * @dai: DAI
2654
 * @ratio: Ratio of BCLK to Sample rate.
2655 2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666
 *
 * Configures the DAI for a preset BCLK to sample rate ratio.
 */
int snd_soc_dai_set_bclk_ratio(struct snd_soc_dai *dai, unsigned int ratio)
{
	if (dai->driver && dai->driver->ops->set_bclk_ratio)
		return dai->driver->ops->set_bclk_ratio(dai, ratio);
	else
		return -EINVAL;
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_bclk_ratio);

2667 2668 2669 2670 2671 2672 2673 2674 2675
/**
 * snd_soc_dai_set_fmt - configure DAI hardware audio format.
 * @dai: DAI
 * @fmt: SND_SOC_DAIFMT_ format value.
 *
 * Configures the DAI hardware format and clocking.
 */
int snd_soc_dai_set_fmt(struct snd_soc_dai *dai, unsigned int fmt)
{
2676
	if (dai->driver == NULL)
2677
		return -EINVAL;
2678 2679 2680
	if (dai->driver->ops->set_fmt == NULL)
		return -ENOTSUPP;
	return dai->driver->ops->set_fmt(dai, fmt);
2681 2682 2683
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_fmt);

2684
/**
2685
 * snd_soc_xlate_tdm_slot - generate tx/rx slot mask.
2686 2687 2688 2689 2690 2691
 * @slots: Number of slots in use.
 * @tx_mask: bitmask representing active TX slots.
 * @rx_mask: bitmask representing active RX slots.
 *
 * Generates the TDM tx and rx slot default masks for DAI.
 */
2692
static int snd_soc_xlate_tdm_slot_mask(unsigned int slots,
2693 2694 2695 2696 2697 2698 2699 2700 2701 2702 2703 2704 2705 2706 2707
					  unsigned int *tx_mask,
					  unsigned int *rx_mask)
{
	if (*tx_mask || *rx_mask)
		return 0;

	if (!slots)
		return -EINVAL;

	*tx_mask = (1 << slots) - 1;
	*rx_mask = (1 << slots) - 1;

	return 0;
}

2708
/**
2709 2710
 * snd_soc_dai_set_tdm_slot() - Configures a DAI for TDM operation
 * @dai: The DAI to configure
2711 2712
 * @tx_mask: bitmask representing active TX slots.
 * @rx_mask: bitmask representing active RX slots.
2713
 * @slots: Number of slots in use.
2714
 * @slot_width: Width in bits for each slot.
2715
 *
2716 2717 2718 2719 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729
 * This function configures the specified DAI for TDM operation. @slot contains
 * the total number of slots of the TDM stream and @slot_with the width of each
 * slot in bit clock cycles. @tx_mask and @rx_mask are bitmasks specifying the
 * active slots of the TDM stream for the specified DAI, i.e. which slots the
 * DAI should write to or read from. If a bit is set the corresponding slot is
 * active, if a bit is cleared the corresponding slot is inactive. Bit 0 maps to
 * the first slot, bit 1 to the second slot and so on. The first active slot
 * maps to the first channel of the DAI, the second active slot to the second
 * channel and so on.
 *
 * TDM mode can be disabled by passing 0 for @slots. In this case @tx_mask,
 * @rx_mask and @slot_width will be ignored.
 *
 * Returns 0 on success, a negative error code otherwise.
2730 2731
 */
int snd_soc_dai_set_tdm_slot(struct snd_soc_dai *dai,
2732
	unsigned int tx_mask, unsigned int rx_mask, int slots, int slot_width)
2733
{
2734 2735
	if (dai->driver && dai->driver->ops->xlate_tdm_slot_mask)
		dai->driver->ops->xlate_tdm_slot_mask(slots,
2736 2737
						&tx_mask, &rx_mask);
	else
2738
		snd_soc_xlate_tdm_slot_mask(slots, &tx_mask, &rx_mask);
2739

2740 2741 2742
	dai->tx_mask = tx_mask;
	dai->rx_mask = rx_mask;

2743 2744
	if (dai->driver && dai->driver->ops->set_tdm_slot)
		return dai->driver->ops->set_tdm_slot(dai, tx_mask, rx_mask,
2745
				slots, slot_width);
2746
	else
2747
		return -ENOTSUPP;
2748 2749 2750
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_tdm_slot);

2751 2752 2753 2754 2755 2756 2757 2758 2759 2760 2761 2762 2763 2764 2765 2766
/**
 * snd_soc_dai_set_channel_map - configure DAI audio channel map
 * @dai: DAI
 * @tx_num: how many TX channels
 * @tx_slot: pointer to an array which imply the TX slot number channel
 *           0~num-1 uses
 * @rx_num: how many RX channels
 * @rx_slot: pointer to an array which imply the RX slot number channel
 *           0~num-1 uses
 *
 * configure the relationship between channel number and TDM slot number.
 */
int snd_soc_dai_set_channel_map(struct snd_soc_dai *dai,
	unsigned int tx_num, unsigned int *tx_slot,
	unsigned int rx_num, unsigned int *rx_slot)
{
2767 2768
	if (dai->driver && dai->driver->ops->set_channel_map)
		return dai->driver->ops->set_channel_map(dai, tx_num, tx_slot,
2769 2770 2771 2772 2773 2774
			rx_num, rx_slot);
	else
		return -EINVAL;
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_channel_map);

2775 2776 2777 2778 2779 2780 2781 2782 2783
/**
 * snd_soc_dai_set_tristate - configure DAI system or master clock.
 * @dai: DAI
 * @tristate: tristate enable
 *
 * Tristates the DAI so that others can use it.
 */
int snd_soc_dai_set_tristate(struct snd_soc_dai *dai, int tristate)
{
2784 2785
	if (dai->driver && dai->driver->ops->set_tristate)
		return dai->driver->ops->set_tristate(dai, tristate);
2786 2787 2788 2789 2790 2791 2792 2793 2794
	else
		return -EINVAL;
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_tristate);

/**
 * snd_soc_dai_digital_mute - configure DAI system or master clock.
 * @dai: DAI
 * @mute: mute enable
2795
 * @direction: stream to mute
2796 2797 2798
 *
 * Mutes the DAI DAC.
 */
2799 2800
int snd_soc_dai_digital_mute(struct snd_soc_dai *dai, int mute,
			     int direction)
2801
{
2802 2803 2804 2805 2806 2807 2808
	if (!dai->driver)
		return -ENOTSUPP;

	if (dai->driver->ops->mute_stream)
		return dai->driver->ops->mute_stream(dai, mute, direction);
	else if (direction == SNDRV_PCM_STREAM_PLAYBACK &&
		 dai->driver->ops->digital_mute)
2809
		return dai->driver->ops->digital_mute(dai, mute);
2810
	else
2811
		return -ENOTSUPP;
2812 2813 2814
}
EXPORT_SYMBOL_GPL(snd_soc_dai_digital_mute);

M
Mark Brown 已提交
2815 2816 2817
/**
 * snd_soc_register_card - Register a card with the ASoC core
 *
M
Mark Brown 已提交
2818
 * @card: Card to register
M
Mark Brown 已提交
2819 2820
 *
 */
2821
int snd_soc_register_card(struct snd_soc_card *card)
M
Mark Brown 已提交
2822
{
2823
	int i, ret;
2824
	struct snd_soc_pcm_runtime *rtd;
2825

M
Mark Brown 已提交
2826 2827 2828
	if (!card->name || !card->dev)
		return -EINVAL;

2829 2830 2831
	for (i = 0; i < card->num_links; i++) {
		struct snd_soc_dai_link *link = &card->dai_link[i];

2832
		ret = soc_init_dai_link(card, link);
2833
		if (ret) {
2834
			dev_err(card->dev, "ASoC: failed to init link %s\n",
2835
				link->name);
2836
			return ret;
2837 2838 2839
		}
	}

M
Mark Brown 已提交
2840 2841
	dev_set_drvdata(card->dev, card);

2842 2843
	snd_soc_initialize_card_lists(card);

2844 2845 2846
	INIT_LIST_HEAD(&card->dai_link_list);
	card->num_dai_links = 0;

2847 2848 2849
	INIT_LIST_HEAD(&card->rtd_list);
	card->num_rtd = 0;

2850
	INIT_LIST_HEAD(&card->dapm_dirty);
2851
	INIT_LIST_HEAD(&card->dobj_list);
M
Mark Brown 已提交
2852
	card->instantiated = 0;
2853
	mutex_init(&card->mutex);
2854
	mutex_init(&card->dapm_mutex);
M
Mark Brown 已提交
2855

2856 2857
	ret = snd_soc_instantiate_card(card);
	if (ret != 0)
2858
		return ret;
M
Mark Brown 已提交
2859

2860
	/* deactivate pins to sleep state */
2861
	list_for_each_entry(rtd, &card->rtd_list, list)  {
2862 2863 2864 2865 2866 2867 2868 2869 2870
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
		int j;

		for (j = 0; j < rtd->num_codecs; j++) {
			struct snd_soc_dai *codec_dai = rtd->codec_dais[j];
			if (!codec_dai->active)
				pinctrl_pm_select_sleep_state(codec_dai->dev);
		}

2871 2872 2873 2874
		if (!cpu_dai->active)
			pinctrl_pm_select_sleep_state(cpu_dai->dev);
	}

2875
	return ret;
M
Mark Brown 已提交
2876
}
2877
EXPORT_SYMBOL_GPL(snd_soc_register_card);
M
Mark Brown 已提交
2878 2879 2880 2881

/**
 * snd_soc_unregister_card - Unregister a card with the ASoC core
 *
M
Mark Brown 已提交
2882
 * @card: Card to unregister
M
Mark Brown 已提交
2883 2884
 *
 */
2885
int snd_soc_unregister_card(struct snd_soc_card *card)
M
Mark Brown 已提交
2886
{
2887 2888
	if (card->instantiated) {
		card->instantiated = false;
2889
		snd_soc_dapm_shutdown(card);
2890
		soc_cleanup_card_resources(card);
2891
		dev_dbg(card->dev, "ASoC: Unregistered card '%s'\n", card->name);
2892
	}
M
Mark Brown 已提交
2893 2894 2895

	return 0;
}
2896
EXPORT_SYMBOL_GPL(snd_soc_unregister_card);
M
Mark Brown 已提交
2897

2898 2899 2900 2901
/*
 * Simplify DAI link configuration by removing ".-1" from device names
 * and sanitizing names.
 */
2902
static char *fmt_single_name(struct device *dev, int *id)
2903 2904 2905 2906 2907 2908 2909
{
	char *found, name[NAME_SIZE];
	int id1, id2;

	if (dev_name(dev) == NULL)
		return NULL;

2910
	strlcpy(name, dev_name(dev), NAME_SIZE);
2911 2912 2913 2914 2915 2916 2917 2918 2919 2920 2921 2922 2923 2924 2925 2926 2927 2928

	/* are we a "%s.%d" name (platform and SPI components) */
	found = strstr(name, dev->driver->name);
	if (found) {
		/* get ID */
		if (sscanf(&found[strlen(dev->driver->name)], ".%d", id) == 1) {

			/* discard ID from name if ID == -1 */
			if (*id == -1)
				found[strlen(dev->driver->name)] = '\0';
		}

	} else {
		/* I2C component devices are named "bus-addr"  */
		if (sscanf(name, "%x-%x", &id1, &id2) == 2) {
			char tmp[NAME_SIZE];

			/* create unique ID number from I2C addr and bus */
2929
			*id = ((id1 & 0xffff) << 16) + id2;
2930 2931 2932

			/* sanitize component name for DAI link creation */
			snprintf(tmp, NAME_SIZE, "%s.%s", dev->driver->name, name);
2933
			strlcpy(name, tmp, NAME_SIZE);
2934 2935 2936 2937 2938 2939 2940 2941 2942 2943 2944 2945 2946 2947 2948
		} else
			*id = 0;
	}

	return kstrdup(name, GFP_KERNEL);
}

/*
 * Simplify DAI link naming for single devices with multiple DAIs by removing
 * any ".-1" and using the DAI name (instead of device name).
 */
static inline char *fmt_multiple_name(struct device *dev,
		struct snd_soc_dai_driver *dai_drv)
{
	if (dai_drv->name == NULL) {
2949 2950 2951
		dev_err(dev,
			"ASoC: error - multiple DAI %s registered with no name\n",
			dev_name(dev));
2952 2953 2954 2955 2956 2957
		return NULL;
	}

	return kstrdup(dai_drv->name, GFP_KERNEL);
}

M
Mark Brown 已提交
2958
/**
2959
 * snd_soc_unregister_dai - Unregister DAIs from the ASoC core
M
Mark Brown 已提交
2960
 *
2961
 * @component: The component for which the DAIs should be unregistered
M
Mark Brown 已提交
2962
 */
2963
static void snd_soc_unregister_dais(struct snd_soc_component *component)
M
Mark Brown 已提交
2964
{
L
Lars-Peter Clausen 已提交
2965
	struct snd_soc_dai *dai, *_dai;
M
Mark Brown 已提交
2966

L
Lars-Peter Clausen 已提交
2967
	list_for_each_entry_safe(dai, _dai, &component->dai_list, list) {
2968 2969
		dev_dbg(component->dev, "ASoC: Unregistered DAI '%s'\n",
			dai->name);
L
Lars-Peter Clausen 已提交
2970
		list_del(&dai->list);
2971
		kfree(dai->name);
2972 2973
		kfree(dai);
	}
M
Mark Brown 已提交
2974 2975
}

2976 2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989 2990 2991 2992 2993 2994 2995 2996 2997 2998 2999 3000 3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025
/* Create a DAI and add it to the component's DAI list */
static struct snd_soc_dai *soc_add_dai(struct snd_soc_component *component,
	struct snd_soc_dai_driver *dai_drv,
	bool legacy_dai_naming)
{
	struct device *dev = component->dev;
	struct snd_soc_dai *dai;

	dev_dbg(dev, "ASoC: dynamically register DAI %s\n", dev_name(dev));

	dai = kzalloc(sizeof(struct snd_soc_dai), GFP_KERNEL);
	if (dai == NULL)
		return NULL;

	/*
	 * Back in the old days when we still had component-less DAIs,
	 * instead of having a static name, component-less DAIs would
	 * inherit the name of the parent device so it is possible to
	 * register multiple instances of the DAI. We still need to keep
	 * the same naming style even though those DAIs are not
	 * component-less anymore.
	 */
	if (legacy_dai_naming &&
	   (dai_drv->id == 0 || dai_drv->name == NULL)) {
		dai->name = fmt_single_name(dev, &dai->id);
	} else {
		dai->name = fmt_multiple_name(dev, dai_drv);
		if (dai_drv->id)
			dai->id = dai_drv->id;
		else
			dai->id = component->num_dai;
	}
	if (dai->name == NULL) {
		kfree(dai);
		return NULL;
	}

	dai->component = component;
	dai->dev = dev;
	dai->driver = dai_drv;
	if (!dai->driver->ops)
		dai->driver->ops = &null_dai_ops;

	list_add(&dai->list, &component->dai_list);
	component->num_dai++;

	dev_dbg(dev, "ASoC: Registered DAI '%s'\n", dai->name);
	return dai;
}

M
Mark Brown 已提交
3026
/**
3027
 * snd_soc_register_dais - Register a DAI with the ASoC core
M
Mark Brown 已提交
3028
 *
3029 3030
 * @component: The component the DAIs are registered for
 * @dai_drv: DAI driver to use for the DAIs
M
Mark Brown 已提交
3031
 * @count: Number of DAIs
3032 3033
 * @legacy_dai_naming: Use the legacy naming scheme and let the DAI inherit the
 *                     parent's name.
M
Mark Brown 已提交
3034
 */
3035
static int snd_soc_register_dais(struct snd_soc_component *component,
3036 3037
	struct snd_soc_dai_driver *dai_drv, size_t count,
	bool legacy_dai_naming)
M
Mark Brown 已提交
3038
{
3039
	struct device *dev = component->dev;
3040
	struct snd_soc_dai *dai;
3041 3042
	unsigned int i;
	int ret;
3043

3044
	dev_dbg(dev, "ASoC: dai register %s #%zu\n", dev_name(dev), count);
M
Mark Brown 已提交
3045

3046 3047
	component->dai_drv = dai_drv;

M
Mark Brown 已提交
3048
	for (i = 0; i < count; i++) {
3049

3050 3051
		dai = soc_add_dai(component, dai_drv + i,
				count == 1 && legacy_dai_naming);
3052 3053 3054 3055
		if (dai == NULL) {
			ret = -ENOMEM;
			goto err;
		}
M
Mark Brown 已提交
3056
	}
3057

M
Mark Brown 已提交
3058
	return 0;
3059

M
Mark Brown 已提交
3060
err:
3061
	snd_soc_unregister_dais(component);
3062

M
Mark Brown 已提交
3063 3064 3065
	return ret;
}

3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082
/**
 * snd_soc_register_dai - Register a DAI dynamically & create its widgets
 *
 * @component: The component the DAIs are registered for
 * @dai_drv: DAI driver to use for the DAI
 *
 * Topology can use this API to register DAIs when probing a component.
 * These DAIs's widgets will be freed in the card cleanup and the DAIs
 * will be freed in the component cleanup.
 */
int snd_soc_register_dai(struct snd_soc_component *component,
	struct snd_soc_dai_driver *dai_drv)
{
	struct snd_soc_dapm_context *dapm =
		snd_soc_component_get_dapm(component);
	struct snd_soc_dai *dai;
	int ret;
3083

3084 3085 3086 3087
	if (dai_drv->dobj.type != SND_SOC_DOBJ_PCM) {
		dev_err(component->dev, "Invalid dai type %d\n",
			dai_drv->dobj.type);
		return -EINVAL;
M
Mark Brown 已提交
3088 3089
	}

3090 3091 3092 3093
	lockdep_assert_held(&client_mutex);
	dai = soc_add_dai(component, dai_drv, false);
	if (!dai)
		return -ENOMEM;
M
Mark Brown 已提交
3094

3095 3096 3097 3098 3099 3100 3101 3102
	/* Create the DAI widgets here. After adding DAIs, topology may
	 * also add routes that need these widgets as source or sink.
	 */
	ret = snd_soc_dapm_new_dai_widgets(dapm, dai);
	if (ret != 0) {
		dev_err(component->dev,
			"Failed to create DAI widgets %d\n", ret);
	}
M
Mark Brown 已提交
3103 3104 3105

	return ret;
}
3106
EXPORT_SYMBOL_GPL(snd_soc_register_dai);
M
Mark Brown 已提交
3107

3108 3109
static void snd_soc_component_seq_notifier(struct snd_soc_dapm_context *dapm,
	enum snd_soc_dapm_type type, int subseq)
3110
{
3111
	struct snd_soc_component *component = dapm->component;
3112

3113 3114
	component->driver->seq_notifier(component, type, subseq);
}
3115

3116 3117 3118 3119
static int snd_soc_component_stream_event(struct snd_soc_dapm_context *dapm,
	int event)
{
	struct snd_soc_component *component = dapm->component;
3120

3121 3122
	return component->driver->stream_event(component, event);
}
3123

3124 3125
static int snd_soc_component_initialize(struct snd_soc_component *component,
	const struct snd_soc_component_driver *driver, struct device *dev)
3126
{
3127 3128
	struct snd_soc_dapm_context *dapm;

3129 3130 3131
	component->name = fmt_single_name(dev, &component->id);
	if (!component->name) {
		dev_err(dev, "ASoC: Failed to allocate name\n");
3132 3133 3134
		return -ENOMEM;
	}

3135 3136
	component->dev = dev;
	component->driver = driver;
3137 3138
	component->probe = component->driver->probe;
	component->remove = component->driver->remove;
3139 3140
	component->suspend = component->driver->suspend;
	component->resume = component->driver->resume;
3141 3142
	component->pcm_new = component->driver->pcm_new;
	component->pcm_free= component->driver->pcm_free;
3143

3144
	dapm = &component->dapm;
3145 3146 3147
	dapm->dev = dev;
	dapm->component = component;
	dapm->bias_level = SND_SOC_BIAS_OFF;
3148
	dapm->idle_bias_off = true;
3149 3150 3151 3152
	if (driver->seq_notifier)
		dapm->seq_notifier = snd_soc_component_seq_notifier;
	if (driver->stream_event)
		dapm->stream_event = snd_soc_component_stream_event;
3153

3154 3155 3156 3157 3158 3159 3160
	component->controls = driver->controls;
	component->num_controls = driver->num_controls;
	component->dapm_widgets = driver->dapm_widgets;
	component->num_dapm_widgets = driver->num_dapm_widgets;
	component->dapm_routes = driver->dapm_routes;
	component->num_dapm_routes = driver->num_dapm_routes;

3161 3162
	INIT_LIST_HEAD(&component->dai_list);
	mutex_init(&component->io_mutex);
3163

3164 3165
	return 0;
}
3166

3167
static void snd_soc_component_setup_regmap(struct snd_soc_component *component)
3168
{
3169 3170 3171 3172 3173 3174 3175
	int val_bytes = regmap_get_val_bytes(component->regmap);

	/* Errors are legitimate for non-integer byte multiples */
	if (val_bytes > 0)
		component->val_bytes = val_bytes;
}

3176 3177
#ifdef CONFIG_REGMAP

3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192
/**
 * snd_soc_component_init_regmap() - Initialize regmap instance for the component
 * @component: The component for which to initialize the regmap instance
 * @regmap: The regmap instance that should be used by the component
 *
 * This function allows deferred assignment of the regmap instance that is
 * associated with the component. Only use this if the regmap instance is not
 * yet ready when the component is registered. The function must also be called
 * before the first IO attempt of the component.
 */
void snd_soc_component_init_regmap(struct snd_soc_component *component,
	struct regmap *regmap)
{
	component->regmap = regmap;
	snd_soc_component_setup_regmap(component);
3193
}
3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211
EXPORT_SYMBOL_GPL(snd_soc_component_init_regmap);

/**
 * snd_soc_component_exit_regmap() - De-initialize regmap instance for the component
 * @component: The component for which to de-initialize the regmap instance
 *
 * Calls regmap_exit() on the regmap instance associated to the component and
 * removes the regmap instance from the component.
 *
 * This function should only be used if snd_soc_component_init_regmap() was used
 * to initialize the regmap instance.
 */
void snd_soc_component_exit_regmap(struct snd_soc_component *component)
{
	regmap_exit(component->regmap);
	component->regmap = NULL;
}
EXPORT_SYMBOL_GPL(snd_soc_component_exit_regmap);
3212

3213
#endif
3214

3215 3216
static void snd_soc_component_add_unlocked(struct snd_soc_component *component)
{
3217 3218 3219 3220 3221 3222
	if (!component->write && !component->read) {
		if (!component->regmap)
			component->regmap = dev_get_regmap(component->dev, NULL);
		if (component->regmap)
			snd_soc_component_setup_regmap(component);
	}
3223

3224
	list_add(&component->list, &component_list);
3225
	INIT_LIST_HEAD(&component->dobj_list);
3226
}
3227

3228 3229
static void snd_soc_component_add(struct snd_soc_component *component)
{
3230
	mutex_lock(&client_mutex);
3231
	snd_soc_component_add_unlocked(component);
3232
	mutex_unlock(&client_mutex);
3233
}
3234

3235 3236 3237 3238 3239
static void snd_soc_component_cleanup(struct snd_soc_component *component)
{
	snd_soc_unregister_dais(component);
	kfree(component->name);
}
3240

3241 3242 3243 3244
static void snd_soc_component_del_unlocked(struct snd_soc_component *component)
{
	list_del(&component->list);
}
3245 3246 3247 3248 3249 3250 3251

int snd_soc_register_component(struct device *dev,
			       const struct snd_soc_component_driver *cmpnt_drv,
			       struct snd_soc_dai_driver *dai_drv,
			       int num_dai)
{
	struct snd_soc_component *cmpnt;
3252
	int ret;
3253

3254
	cmpnt = kzalloc(sizeof(*cmpnt), GFP_KERNEL);
3255 3256 3257 3258 3259
	if (!cmpnt) {
		dev_err(dev, "ASoC: Failed to allocate memory\n");
		return -ENOMEM;
	}

3260 3261 3262 3263
	ret = snd_soc_component_initialize(cmpnt, cmpnt_drv, dev);
	if (ret)
		goto err_free;

3264
	cmpnt->ignore_pmdown_time = true;
3265
	cmpnt->registered_as_component = true;
3266

3267 3268
	ret = snd_soc_register_dais(cmpnt, dai_drv, num_dai, true);
	if (ret < 0) {
3269
		dev_err(dev, "ASoC: Failed to register DAIs: %d\n", ret);
3270 3271
		goto err_cleanup;
	}
3272

3273
	snd_soc_component_add(cmpnt);
3274

3275
	return 0;
3276

3277 3278 3279 3280 3281
err_cleanup:
	snd_soc_component_cleanup(cmpnt);
err_free:
	kfree(cmpnt);
	return ret;
3282
}
3283
EXPORT_SYMBOL_GPL(snd_soc_register_component);
3284

3285 3286 3287
/**
 * snd_soc_unregister_component - Unregister a component from the ASoC core
 *
3288
 * @dev: The device to unregister
3289 3290 3291 3292 3293
 */
void snd_soc_unregister_component(struct device *dev)
{
	struct snd_soc_component *cmpnt;

3294
	mutex_lock(&client_mutex);
3295
	list_for_each_entry(cmpnt, &component_list, list) {
3296
		if (dev == cmpnt->dev && cmpnt->registered_as_component)
3297 3298
			goto found;
	}
3299
	mutex_unlock(&client_mutex);
3300 3301 3302
	return;

found:
3303
	snd_soc_tplg_component_remove(cmpnt, SND_SOC_TPLG_INDEX_ALL);
3304 3305
	snd_soc_component_del_unlocked(cmpnt);
	mutex_unlock(&client_mutex);
3306 3307
	snd_soc_component_cleanup(cmpnt);
	kfree(cmpnt);
3308 3309 3310
}
EXPORT_SYMBOL_GPL(snd_soc_unregister_component);

3311
static int snd_soc_platform_drv_probe(struct snd_soc_component *component)
3312 3313
{
	struct snd_soc_platform *platform = snd_soc_component_to_platform(component);
3314

3315
	return platform->driver->probe(platform);
3316 3317
}

3318
static void snd_soc_platform_drv_remove(struct snd_soc_component *component)
3319 3320 3321
{
	struct snd_soc_platform *platform = snd_soc_component_to_platform(component);

3322
	platform->driver->remove(platform);
3323 3324
}

3325 3326 3327 3328
static int snd_soc_platform_drv_pcm_new(struct snd_soc_pcm_runtime *rtd)
{
	struct snd_soc_platform *platform = rtd->platform;

3329 3330 3331 3332
	if (platform->driver->pcm_new)
		return platform->driver->pcm_new(rtd);
	else
		return 0;
3333 3334 3335 3336 3337 3338 3339
}

static void snd_soc_platform_drv_pcm_free(struct snd_pcm *pcm)
{
	struct snd_soc_pcm_runtime *rtd = pcm->private_data;
	struct snd_soc_platform *platform = rtd->platform;

3340 3341
	if (platform->driver->pcm_free)
		platform->driver->pcm_free(pcm);
3342 3343
}

M
Mark Brown 已提交
3344
/**
3345 3346 3347
 * snd_soc_add_platform - Add a platform to the ASoC core
 * @dev: The parent device for the platform
 * @platform: The platform to add
3348
 * @platform_drv: The driver for the platform
M
Mark Brown 已提交
3349
 */
3350
int snd_soc_add_platform(struct device *dev, struct snd_soc_platform *platform,
3351
		const struct snd_soc_platform_driver *platform_drv)
M
Mark Brown 已提交
3352
{
3353 3354
	int ret;

3355 3356 3357 3358
	ret = snd_soc_component_initialize(&platform->component,
			&platform_drv->component_driver, dev);
	if (ret)
		return ret;
M
Mark Brown 已提交
3359

3360 3361
	platform->dev = dev;
	platform->driver = platform_drv;
3362 3363 3364 3365 3366

	if (platform_drv->probe)
		platform->component.probe = snd_soc_platform_drv_probe;
	if (platform_drv->remove)
		platform->component.remove = snd_soc_platform_drv_remove;
3367 3368 3369 3370
	if (platform_drv->pcm_new)
		platform->component.pcm_new = snd_soc_platform_drv_pcm_new;
	if (platform_drv->pcm_free)
		platform->component.pcm_free = snd_soc_platform_drv_pcm_free;
M
Mark Brown 已提交
3371

3372 3373 3374
#ifdef CONFIG_DEBUG_FS
	platform->component.debugfs_prefix = "platform";
#endif
M
Mark Brown 已提交
3375 3376

	mutex_lock(&client_mutex);
3377
	snd_soc_component_add_unlocked(&platform->component);
M
Mark Brown 已提交
3378 3379 3380
	list_add(&platform->list, &platform_list);
	mutex_unlock(&client_mutex);

3381 3382
	dev_dbg(dev, "ASoC: Registered platform '%s'\n",
		platform->component.name);
M
Mark Brown 已提交
3383 3384 3385

	return 0;
}
3386
EXPORT_SYMBOL_GPL(snd_soc_add_platform);
M
Mark Brown 已提交
3387 3388

/**
3389
 * snd_soc_register_platform - Register a platform with the ASoC core
M
Mark Brown 已提交
3390
 *
3391 3392
 * @dev: The device for the platform
 * @platform_drv: The driver for the platform
M
Mark Brown 已提交
3393
 */
3394 3395
int snd_soc_register_platform(struct device *dev,
		const struct snd_soc_platform_driver *platform_drv)
M
Mark Brown 已提交
3396
{
3397
	struct snd_soc_platform *platform;
3398
	int ret;
3399

3400
	dev_dbg(dev, "ASoC: platform register %s\n", dev_name(dev));
3401

3402 3403 3404 3405 3406 3407 3408 3409 3410 3411 3412 3413 3414 3415 3416 3417 3418 3419
	platform = kzalloc(sizeof(struct snd_soc_platform), GFP_KERNEL);
	if (platform == NULL)
		return -ENOMEM;

	ret = snd_soc_add_platform(dev, platform, platform_drv);
	if (ret)
		kfree(platform);

	return ret;
}
EXPORT_SYMBOL_GPL(snd_soc_register_platform);

/**
 * snd_soc_remove_platform - Remove a platform from the ASoC core
 * @platform: the platform to remove
 */
void snd_soc_remove_platform(struct snd_soc_platform *platform)
{
3420

M
Mark Brown 已提交
3421 3422
	mutex_lock(&client_mutex);
	list_del(&platform->list);
3423
	snd_soc_component_del_unlocked(&platform->component);
M
Mark Brown 已提交
3424 3425
	mutex_unlock(&client_mutex);

3426
	dev_dbg(platform->dev, "ASoC: Unregistered platform '%s'\n",
3427
		platform->component.name);
3428 3429

	snd_soc_component_cleanup(&platform->component);
3430 3431 3432 3433 3434 3435 3436
}
EXPORT_SYMBOL_GPL(snd_soc_remove_platform);

struct snd_soc_platform *snd_soc_lookup_platform(struct device *dev)
{
	struct snd_soc_platform *platform;

3437
	mutex_lock(&client_mutex);
3438
	list_for_each_entry(platform, &platform_list, list) {
3439 3440
		if (dev == platform->dev) {
			mutex_unlock(&client_mutex);
3441
			return platform;
3442
		}
3443
	}
3444
	mutex_unlock(&client_mutex);
3445 3446 3447 3448 3449 3450 3451 3452

	return NULL;
}
EXPORT_SYMBOL_GPL(snd_soc_lookup_platform);

/**
 * snd_soc_unregister_platform - Unregister a platform from the ASoC core
 *
3453
 * @dev: platform to unregister
3454 3455 3456 3457 3458 3459 3460 3461 3462 3463
 */
void snd_soc_unregister_platform(struct device *dev)
{
	struct snd_soc_platform *platform;

	platform = snd_soc_lookup_platform(dev);
	if (!platform)
		return;

	snd_soc_remove_platform(platform);
3464
	kfree(platform);
M
Mark Brown 已提交
3465 3466 3467
}
EXPORT_SYMBOL_GPL(snd_soc_unregister_platform);

3468 3469 3470 3471 3472 3473 3474 3475 3476 3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487 3488 3489 3490 3491 3492 3493 3494 3495 3496 3497 3498 3499 3500
static u64 codec_format_map[] = {
	SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S16_BE,
	SNDRV_PCM_FMTBIT_U16_LE | SNDRV_PCM_FMTBIT_U16_BE,
	SNDRV_PCM_FMTBIT_S24_LE | SNDRV_PCM_FMTBIT_S24_BE,
	SNDRV_PCM_FMTBIT_U24_LE | SNDRV_PCM_FMTBIT_U24_BE,
	SNDRV_PCM_FMTBIT_S32_LE | SNDRV_PCM_FMTBIT_S32_BE,
	SNDRV_PCM_FMTBIT_U32_LE | SNDRV_PCM_FMTBIT_U32_BE,
	SNDRV_PCM_FMTBIT_S24_3LE | SNDRV_PCM_FMTBIT_U24_3BE,
	SNDRV_PCM_FMTBIT_U24_3LE | SNDRV_PCM_FMTBIT_U24_3BE,
	SNDRV_PCM_FMTBIT_S20_3LE | SNDRV_PCM_FMTBIT_S20_3BE,
	SNDRV_PCM_FMTBIT_U20_3LE | SNDRV_PCM_FMTBIT_U20_3BE,
	SNDRV_PCM_FMTBIT_S18_3LE | SNDRV_PCM_FMTBIT_S18_3BE,
	SNDRV_PCM_FMTBIT_U18_3LE | SNDRV_PCM_FMTBIT_U18_3BE,
	SNDRV_PCM_FMTBIT_FLOAT_LE | SNDRV_PCM_FMTBIT_FLOAT_BE,
	SNDRV_PCM_FMTBIT_FLOAT64_LE | SNDRV_PCM_FMTBIT_FLOAT64_BE,
	SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE
	| SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE,
};

/* Fix up the DAI formats for endianness: codecs don't actually see
 * the endianness of the data but we're using the CPU format
 * definitions which do need to include endianness so we ensure that
 * codec DAIs always have both big and little endian variants set.
 */
static void fixup_codec_formats(struct snd_soc_pcm_stream *stream)
{
	int i;

	for (i = 0; i < ARRAY_SIZE(codec_format_map); i++)
		if (stream->formats & codec_format_map[i])
			stream->formats |= codec_format_map[i];
}

3501 3502 3503 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514
static int snd_soc_codec_drv_probe(struct snd_soc_component *component)
{
	struct snd_soc_codec *codec = snd_soc_component_to_codec(component);

	return codec->driver->probe(codec);
}

static void snd_soc_codec_drv_remove(struct snd_soc_component *component)
{
	struct snd_soc_codec *codec = snd_soc_component_to_codec(component);

	codec->driver->remove(codec);
}

3515 3516 3517 3518 3519 3520 3521 3522 3523 3524 3525 3526 3527 3528
static int snd_soc_codec_drv_suspend(struct snd_soc_component *component)
{
	struct snd_soc_codec *codec = snd_soc_component_to_codec(component);

	return codec->driver->suspend(codec);
}

static int snd_soc_codec_drv_resume(struct snd_soc_component *component)
{
	struct snd_soc_codec *codec = snd_soc_component_to_codec(component);

	return codec->driver->resume(codec);
}

3529 3530 3531 3532 3533 3534 3535 3536 3537 3538 3539 3540 3541 3542 3543 3544 3545 3546
static int snd_soc_codec_drv_write(struct snd_soc_component *component,
	unsigned int reg, unsigned int val)
{
	struct snd_soc_codec *codec = snd_soc_component_to_codec(component);

	return codec->driver->write(codec, reg, val);
}

static int snd_soc_codec_drv_read(struct snd_soc_component *component,
	unsigned int reg, unsigned int *val)
{
	struct snd_soc_codec *codec = snd_soc_component_to_codec(component);

	*val = codec->driver->read(codec, reg);

	return 0;
}

3547 3548 3549 3550 3551 3552 3553 3554
static int snd_soc_codec_set_bias_level(struct snd_soc_dapm_context *dapm,
	enum snd_soc_bias_level level)
{
	struct snd_soc_codec *codec = snd_soc_dapm_to_codec(dapm);

	return codec->driver->set_bias_level(codec, level);
}

M
Mark Brown 已提交
3555 3556 3557
/**
 * snd_soc_register_codec - Register a codec with the ASoC core
 *
3558 3559 3560 3561
 * @dev: The parent device for this codec
 * @codec_drv: Codec driver
 * @dai_drv: The associated DAI driver
 * @num_dai: Number of DAIs
M
Mark Brown 已提交
3562
 */
3563
int snd_soc_register_codec(struct device *dev,
3564 3565 3566
			   const struct snd_soc_codec_driver *codec_drv,
			   struct snd_soc_dai_driver *dai_drv,
			   int num_dai)
M
Mark Brown 已提交
3567
{
3568
	struct snd_soc_dapm_context *dapm;
3569
	struct snd_soc_codec *codec;
3570
	struct snd_soc_dai *dai;
3571
	int ret, i;
3572

3573 3574 3575 3576 3577
	dev_dbg(dev, "codec register %s\n", dev_name(dev));

	codec = kzalloc(sizeof(struct snd_soc_codec), GFP_KERNEL);
	if (codec == NULL)
		return -ENOMEM;
M
Mark Brown 已提交
3578

3579
	codec->component.codec = codec;
3580

3581 3582 3583 3584
	ret = snd_soc_component_initialize(&codec->component,
			&codec_drv->component_driver, dev);
	if (ret)
		goto err_free;
3585

3586 3587 3588 3589
	if (codec_drv->probe)
		codec->component.probe = snd_soc_codec_drv_probe;
	if (codec_drv->remove)
		codec->component.remove = snd_soc_codec_drv_remove;
3590 3591 3592 3593
	if (codec_drv->suspend)
		codec->component.suspend = snd_soc_codec_drv_suspend;
	if (codec_drv->resume)
		codec->component.resume = snd_soc_codec_drv_resume;
3594 3595 3596 3597
	if (codec_drv->write)
		codec->component.write = snd_soc_codec_drv_write;
	if (codec_drv->read)
		codec->component.read = snd_soc_codec_drv_read;
3598
	codec->component.ignore_pmdown_time = codec_drv->ignore_pmdown_time;
3599 3600 3601 3602

	dapm = snd_soc_codec_get_dapm(codec);
	dapm->idle_bias_off = codec_drv->idle_bias_off;
	dapm->suspend_bias_off = codec_drv->suspend_bias_off;
3603
	if (codec_drv->seq_notifier)
3604
		dapm->seq_notifier = codec_drv->seq_notifier;
3605
	if (codec_drv->set_bias_level)
3606
		dapm->set_bias_level = snd_soc_codec_set_bias_level;
3607 3608
	codec->dev = dev;
	codec->driver = codec_drv;
3609
	codec->component.val_bytes = codec_drv->reg_word_size;
L
Liam Girdwood 已提交
3610

3611 3612 3613 3614 3615
#ifdef CONFIG_DEBUG_FS
	codec->component.init_debugfs = soc_init_codec_debugfs;
	codec->component.debugfs_prefix = "codec";
#endif

3616 3617
	if (codec_drv->get_regmap)
		codec->component.regmap = codec_drv->get_regmap(dev);
3618

3619 3620 3621 3622 3623
	for (i = 0; i < num_dai; i++) {
		fixup_codec_formats(&dai_drv[i].playback);
		fixup_codec_formats(&dai_drv[i].capture);
	}

3624
	ret = snd_soc_register_dais(&codec->component, dai_drv, num_dai, false);
3625
	if (ret < 0) {
3626
		dev_err(dev, "ASoC: Failed to register DAIs: %d\n", ret);
3627
		goto err_cleanup;
3628
	}
3629

3630 3631
	list_for_each_entry(dai, &codec->component.dai_list, list)
		dai->codec = codec;
3632

3633
	mutex_lock(&client_mutex);
3634
	snd_soc_component_add_unlocked(&codec->component);
3635
	list_add(&codec->list, &codec_list);
3636 3637
	mutex_unlock(&client_mutex);

3638 3639
	dev_dbg(codec->dev, "ASoC: Registered codec '%s'\n",
		codec->component.name);
M
Mark Brown 已提交
3640
	return 0;
3641

3642 3643 3644
err_cleanup:
	snd_soc_component_cleanup(&codec->component);
err_free:
3645 3646
	kfree(codec);
	return ret;
M
Mark Brown 已提交
3647 3648 3649 3650 3651 3652
}
EXPORT_SYMBOL_GPL(snd_soc_register_codec);

/**
 * snd_soc_unregister_codec - Unregister a codec from the ASoC core
 *
3653
 * @dev: codec to unregister
M
Mark Brown 已提交
3654
 */
3655
void snd_soc_unregister_codec(struct device *dev)
M
Mark Brown 已提交
3656
{
3657 3658
	struct snd_soc_codec *codec;

3659
	mutex_lock(&client_mutex);
3660 3661 3662 3663
	list_for_each_entry(codec, &codec_list, list) {
		if (dev == codec->dev)
			goto found;
	}
3664
	mutex_unlock(&client_mutex);
3665 3666 3667
	return;

found:
M
Mark Brown 已提交
3668
	list_del(&codec->list);
3669
	snd_soc_component_del_unlocked(&codec->component);
M
Mark Brown 已提交
3670 3671
	mutex_unlock(&client_mutex);

3672 3673
	dev_dbg(codec->dev, "ASoC: Unregistered codec '%s'\n",
			codec->component.name);
3674

3675
	snd_soc_component_cleanup(&codec->component);
3676
	snd_soc_cache_exit(codec);
3677
	kfree(codec);
M
Mark Brown 已提交
3678 3679 3680
}
EXPORT_SYMBOL_GPL(snd_soc_unregister_codec);

3681
/* Retrieve a card's name from device tree */
3682 3683
int snd_soc_of_parse_card_name(struct snd_soc_card *card,
			       const char *propname)
3684
{
3685
	struct device_node *np;
3686 3687
	int ret;

3688 3689 3690 3691 3692
	if (!card->dev) {
		pr_err("card->dev is not set before calling %s\n", __func__);
		return -EINVAL;
	}

3693
	np = card->dev->of_node;
3694

3695 3696 3697 3698 3699 3700 3701 3702
	ret = of_property_read_string_index(np, propname, 0, &card->name);
	/*
	 * EINVAL means the property does not exist. This is fine providing
	 * card->name was previously set, which is checked later in
	 * snd_soc_register_card.
	 */
	if (ret < 0 && ret != -EINVAL) {
		dev_err(card->dev,
3703
			"ASoC: Property '%s' could not be read: %d\n",
3704 3705 3706 3707 3708 3709
			propname, ret);
		return ret;
	}

	return 0;
}
3710
EXPORT_SYMBOL_GPL(snd_soc_of_parse_card_name);
3711

3712 3713 3714 3715 3716 3717 3718
static const struct snd_soc_dapm_widget simple_widgets[] = {
	SND_SOC_DAPM_MIC("Microphone", NULL),
	SND_SOC_DAPM_LINE("Line", NULL),
	SND_SOC_DAPM_HP("Headphone", NULL),
	SND_SOC_DAPM_SPK("Speaker", NULL),
};

3719
int snd_soc_of_parse_audio_simple_widgets(struct snd_soc_card *card,
3720 3721
					  const char *propname)
{
3722
	struct device_node *np = card->dev->of_node;
3723 3724 3725 3726 3727 3728 3729 3730 3731 3732 3733 3734 3735 3736 3737 3738 3739 3740 3741 3742 3743 3744 3745 3746 3747 3748 3749 3750 3751 3752 3753 3754 3755 3756 3757 3758 3759 3760 3761 3762 3763 3764 3765 3766 3767 3768 3769 3770 3771 3772 3773 3774 3775 3776 3777 3778 3779 3780 3781 3782 3783 3784 3785 3786 3787 3788 3789 3790 3791
	struct snd_soc_dapm_widget *widgets;
	const char *template, *wname;
	int i, j, num_widgets, ret;

	num_widgets = of_property_count_strings(np, propname);
	if (num_widgets < 0) {
		dev_err(card->dev,
			"ASoC: Property '%s' does not exist\n",	propname);
		return -EINVAL;
	}
	if (num_widgets & 1) {
		dev_err(card->dev,
			"ASoC: Property '%s' length is not even\n", propname);
		return -EINVAL;
	}

	num_widgets /= 2;
	if (!num_widgets) {
		dev_err(card->dev, "ASoC: Property '%s's length is zero\n",
			propname);
		return -EINVAL;
	}

	widgets = devm_kcalloc(card->dev, num_widgets, sizeof(*widgets),
			       GFP_KERNEL);
	if (!widgets) {
		dev_err(card->dev,
			"ASoC: Could not allocate memory for widgets\n");
		return -ENOMEM;
	}

	for (i = 0; i < num_widgets; i++) {
		ret = of_property_read_string_index(np, propname,
			2 * i, &template);
		if (ret) {
			dev_err(card->dev,
				"ASoC: Property '%s' index %d read error:%d\n",
				propname, 2 * i, ret);
			return -EINVAL;
		}

		for (j = 0; j < ARRAY_SIZE(simple_widgets); j++) {
			if (!strncmp(template, simple_widgets[j].name,
				     strlen(simple_widgets[j].name))) {
				widgets[i] = simple_widgets[j];
				break;
			}
		}

		if (j >= ARRAY_SIZE(simple_widgets)) {
			dev_err(card->dev,
				"ASoC: DAPM widget '%s' is not supported\n",
				template);
			return -EINVAL;
		}

		ret = of_property_read_string_index(np, propname,
						    (2 * i) + 1,
						    &wname);
		if (ret) {
			dev_err(card->dev,
				"ASoC: Property '%s' index %d read error:%d\n",
				propname, (2 * i) + 1, ret);
			return -EINVAL;
		}

		widgets[i].name = wname;
	}

3792 3793
	card->of_dapm_widgets = widgets;
	card->num_of_dapm_widgets = num_widgets;
3794 3795 3796

	return 0;
}
3797
EXPORT_SYMBOL_GPL(snd_soc_of_parse_audio_simple_widgets);
3798

3799 3800 3801 3802 3803
static int snd_soc_of_get_slot_mask(struct device_node *np,
				    const char *prop_name,
				    unsigned int *mask)
{
	u32 val;
3804
	const __be32 *of_slot_mask = of_get_property(np, prop_name, &val);
3805 3806 3807 3808 3809 3810 3811 3812 3813 3814 3815 3816
	int i;

	if (!of_slot_mask)
		return 0;
	val /= sizeof(u32);
	for (i = 0; i < val; i++)
		if (be32_to_cpup(&of_slot_mask[i]))
			*mask |= (1 << i);

	return val;
}

3817
int snd_soc_of_parse_tdm_slot(struct device_node *np,
3818 3819
			      unsigned int *tx_mask,
			      unsigned int *rx_mask,
3820 3821 3822 3823 3824 3825
			      unsigned int *slots,
			      unsigned int *slot_width)
{
	u32 val;
	int ret;

3826 3827 3828 3829 3830
	if (tx_mask)
		snd_soc_of_get_slot_mask(np, "dai-tdm-slot-tx-mask", tx_mask);
	if (rx_mask)
		snd_soc_of_get_slot_mask(np, "dai-tdm-slot-rx-mask", rx_mask);

3831 3832 3833 3834 3835 3836 3837 3838 3839 3840 3841 3842 3843 3844 3845 3846 3847 3848 3849 3850 3851 3852
	if (of_property_read_bool(np, "dai-tdm-slot-num")) {
		ret = of_property_read_u32(np, "dai-tdm-slot-num", &val);
		if (ret)
			return ret;

		if (slots)
			*slots = val;
	}

	if (of_property_read_bool(np, "dai-tdm-slot-width")) {
		ret = of_property_read_u32(np, "dai-tdm-slot-width", &val);
		if (ret)
			return ret;

		if (slot_width)
			*slot_width = val;
	}

	return 0;
}
EXPORT_SYMBOL_GPL(snd_soc_of_parse_tdm_slot);

3853
void snd_soc_of_parse_audio_prefix(struct snd_soc_card *card,
3854 3855 3856 3857
				   struct snd_soc_codec_conf *codec_conf,
				   struct device_node *of_node,
				   const char *propname)
{
3858
	struct device_node *np = card->dev->of_node;
3859 3860 3861 3862 3863 3864 3865 3866 3867 3868 3869 3870
	const char *str;
	int ret;

	ret = of_property_read_string(np, propname, &str);
	if (ret < 0) {
		/* no prefix is not error */
		return;
	}

	codec_conf->of_node	= of_node;
	codec_conf->name_prefix	= str;
}
3871
EXPORT_SYMBOL_GPL(snd_soc_of_parse_audio_prefix);
3872

3873
int snd_soc_of_parse_audio_routing(struct snd_soc_card *card,
3874 3875
				   const char *propname)
{
3876
	struct device_node *np = card->dev->of_node;
3877
	int num_routes;
3878 3879 3880 3881
	struct snd_soc_dapm_route *routes;
	int i, ret;

	num_routes = of_property_count_strings(np, propname);
3882
	if (num_routes < 0 || num_routes & 1) {
3883 3884 3885
		dev_err(card->dev,
			"ASoC: Property '%s' does not exist or its length is not even\n",
			propname);
3886 3887 3888 3889
		return -EINVAL;
	}
	num_routes /= 2;
	if (!num_routes) {
3890
		dev_err(card->dev, "ASoC: Property '%s's length is zero\n",
3891 3892 3893 3894
			propname);
		return -EINVAL;
	}

3895
	routes = devm_kzalloc(card->dev, num_routes * sizeof(*routes),
3896 3897 3898
			      GFP_KERNEL);
	if (!routes) {
		dev_err(card->dev,
3899
			"ASoC: Could not allocate DAPM route table\n");
3900 3901 3902 3903 3904
		return -EINVAL;
	}

	for (i = 0; i < num_routes; i++) {
		ret = of_property_read_string_index(np, propname,
3905
			2 * i, &routes[i].sink);
3906
		if (ret) {
3907 3908 3909
			dev_err(card->dev,
				"ASoC: Property '%s' index %d could not be read: %d\n",
				propname, 2 * i, ret);
3910 3911 3912
			return -EINVAL;
		}
		ret = of_property_read_string_index(np, propname,
3913
			(2 * i) + 1, &routes[i].source);
3914 3915
		if (ret) {
			dev_err(card->dev,
3916 3917
				"ASoC: Property '%s' index %d could not be read: %d\n",
				propname, (2 * i) + 1, ret);
3918 3919 3920 3921
			return -EINVAL;
		}
	}

3922 3923
	card->num_of_dapm_routes = num_routes;
	card->of_dapm_routes = routes;
3924 3925 3926

	return 0;
}
3927
EXPORT_SYMBOL_GPL(snd_soc_of_parse_audio_routing);
3928

3929
unsigned int snd_soc_of_parse_daifmt(struct device_node *np,
3930 3931 3932
				     const char *prefix,
				     struct device_node **bitclkmaster,
				     struct device_node **framemaster)
3933 3934 3935 3936 3937 3938 3939 3940 3941 3942 3943 3944 3945 3946 3947 3948 3949 3950 3951 3952 3953 3954 3955 3956 3957 3958 3959 3960 3961 3962 3963 3964 3965 3966 3967 3968 3969 3970 3971 3972
{
	int ret, i;
	char prop[128];
	unsigned int format = 0;
	int bit, frame;
	const char *str;
	struct {
		char *name;
		unsigned int val;
	} of_fmt_table[] = {
		{ "i2s",	SND_SOC_DAIFMT_I2S },
		{ "right_j",	SND_SOC_DAIFMT_RIGHT_J },
		{ "left_j",	SND_SOC_DAIFMT_LEFT_J },
		{ "dsp_a",	SND_SOC_DAIFMT_DSP_A },
		{ "dsp_b",	SND_SOC_DAIFMT_DSP_B },
		{ "ac97",	SND_SOC_DAIFMT_AC97 },
		{ "pdm",	SND_SOC_DAIFMT_PDM},
		{ "msb",	SND_SOC_DAIFMT_MSB },
		{ "lsb",	SND_SOC_DAIFMT_LSB },
	};

	if (!prefix)
		prefix = "";

	/*
	 * check "[prefix]format = xxx"
	 * SND_SOC_DAIFMT_FORMAT_MASK area
	 */
	snprintf(prop, sizeof(prop), "%sformat", prefix);
	ret = of_property_read_string(np, prop, &str);
	if (ret == 0) {
		for (i = 0; i < ARRAY_SIZE(of_fmt_table); i++) {
			if (strcmp(str, of_fmt_table[i].name) == 0) {
				format |= of_fmt_table[i].val;
				break;
			}
		}
	}

	/*
3973
	 * check "[prefix]continuous-clock"
3974 3975
	 * SND_SOC_DAIFMT_CLOCK_MASK area
	 */
3976
	snprintf(prop, sizeof(prop), "%scontinuous-clock", prefix);
J
Julia Lawall 已提交
3977
	if (of_property_read_bool(np, prop))
3978 3979 3980
		format |= SND_SOC_DAIFMT_CONT;
	else
		format |= SND_SOC_DAIFMT_GATED;
3981 3982 3983 3984 3985 3986 3987 3988 3989 3990 3991 3992 3993 3994 3995 3996 3997 3998 3999 4000 4001 4002 4003 4004 4005 4006 4007 4008 4009 4010 4011 4012 4013 4014

	/*
	 * check "[prefix]bitclock-inversion"
	 * check "[prefix]frame-inversion"
	 * SND_SOC_DAIFMT_INV_MASK area
	 */
	snprintf(prop, sizeof(prop), "%sbitclock-inversion", prefix);
	bit = !!of_get_property(np, prop, NULL);

	snprintf(prop, sizeof(prop), "%sframe-inversion", prefix);
	frame = !!of_get_property(np, prop, NULL);

	switch ((bit << 4) + frame) {
	case 0x11:
		format |= SND_SOC_DAIFMT_IB_IF;
		break;
	case 0x10:
		format |= SND_SOC_DAIFMT_IB_NF;
		break;
	case 0x01:
		format |= SND_SOC_DAIFMT_NB_IF;
		break;
	default:
		/* SND_SOC_DAIFMT_NB_NF is default */
		break;
	}

	/*
	 * check "[prefix]bitclock-master"
	 * check "[prefix]frame-master"
	 * SND_SOC_DAIFMT_MASTER_MASK area
	 */
	snprintf(prop, sizeof(prop), "%sbitclock-master", prefix);
	bit = !!of_get_property(np, prop, NULL);
4015 4016
	if (bit && bitclkmaster)
		*bitclkmaster = of_parse_phandle(np, prop, 0);
4017 4018 4019

	snprintf(prop, sizeof(prop), "%sframe-master", prefix);
	frame = !!of_get_property(np, prop, NULL);
4020 4021
	if (frame && framemaster)
		*framemaster = of_parse_phandle(np, prop, 0);
4022 4023 4024 4025 4026 4027 4028 4029 4030 4031 4032 4033 4034 4035 4036 4037 4038 4039 4040 4041

	switch ((bit << 4) + frame) {
	case 0x11:
		format |= SND_SOC_DAIFMT_CBM_CFM;
		break;
	case 0x10:
		format |= SND_SOC_DAIFMT_CBM_CFS;
		break;
	case 0x01:
		format |= SND_SOC_DAIFMT_CBS_CFM;
		break;
	default:
		format |= SND_SOC_DAIFMT_CBS_CFS;
		break;
	}

	return format;
}
EXPORT_SYMBOL_GPL(snd_soc_of_parse_daifmt);

4042
int snd_soc_get_dai_name(struct of_phandle_args *args,
4043
				const char **dai_name)
4044 4045
{
	struct snd_soc_component *pos;
4046
	struct device_node *component_of_node;
4047
	int ret = -EPROBE_DEFER;
4048 4049 4050

	mutex_lock(&client_mutex);
	list_for_each_entry(pos, &component_list, list) {
4051 4052 4053 4054 4055
		component_of_node = pos->dev->of_node;
		if (!component_of_node && pos->dev->parent)
			component_of_node = pos->dev->parent->of_node;

		if (component_of_node != args->np)
4056 4057
			continue;

4058
		if (pos->driver->of_xlate_dai_name) {
4059 4060 4061
			ret = pos->driver->of_xlate_dai_name(pos,
							     args,
							     dai_name);
4062 4063 4064
		} else {
			int id = -1;

4065
			switch (args->args_count) {
4066 4067 4068 4069
			case 0:
				id = 0; /* same as dai_drv[0] */
				break;
			case 1:
4070
				id = args->args[0];
4071 4072 4073 4074 4075 4076 4077 4078
				break;
			default:
				/* not supported */
				break;
			}

			if (id < 0 || id >= pos->num_dai) {
				ret = -EINVAL;
4079
				continue;
4080
			}
X
Xiubo Li 已提交
4081 4082 4083 4084 4085 4086

			ret = 0;

			*dai_name = pos->dai_drv[id].name;
			if (!*dai_name)
				*dai_name = pos->name;
4087 4088 4089 4090 4091
		}

		break;
	}
	mutex_unlock(&client_mutex);
4092 4093
	return ret;
}
4094
EXPORT_SYMBOL_GPL(snd_soc_get_dai_name);
4095 4096 4097 4098 4099 4100 4101 4102 4103 4104 4105 4106 4107

int snd_soc_of_get_dai_name(struct device_node *of_node,
			    const char **dai_name)
{
	struct of_phandle_args args;
	int ret;

	ret = of_parse_phandle_with_args(of_node, "sound-dai",
					 "#sound-dai-cells", 0, &args);
	if (ret)
		return ret;

	ret = snd_soc_get_dai_name(&args, dai_name);
4108 4109 4110 4111 4112 4113 4114

	of_node_put(args.np);

	return ret;
}
EXPORT_SYMBOL_GPL(snd_soc_of_get_dai_name);

4115 4116 4117 4118 4119 4120 4121 4122 4123 4124 4125 4126 4127 4128 4129 4130 4131 4132 4133 4134 4135 4136 4137 4138 4139 4140 4141 4142 4143 4144 4145 4146 4147 4148 4149 4150 4151 4152 4153 4154 4155 4156 4157 4158 4159 4160 4161 4162 4163 4164 4165 4166 4167 4168 4169 4170 4171 4172 4173 4174 4175 4176 4177 4178 4179 4180 4181 4182 4183 4184 4185
/*
 * snd_soc_of_get_dai_link_codecs - Parse a list of CODECs in the devicetree
 * @dev: Card device
 * @of_node: Device node
 * @dai_link: DAI link
 *
 * Builds an array of CODEC DAI components from the DAI link property
 * 'sound-dai'.
 * The array is set in the DAI link and the number of DAIs is set accordingly.
 * The device nodes in the array (of_node) must be dereferenced by the caller.
 *
 * Returns 0 for success
 */
int snd_soc_of_get_dai_link_codecs(struct device *dev,
				   struct device_node *of_node,
				   struct snd_soc_dai_link *dai_link)
{
	struct of_phandle_args args;
	struct snd_soc_dai_link_component *component;
	char *name;
	int index, num_codecs, ret;

	/* Count the number of CODECs */
	name = "sound-dai";
	num_codecs = of_count_phandle_with_args(of_node, name,
						"#sound-dai-cells");
	if (num_codecs <= 0) {
		if (num_codecs == -ENOENT)
			dev_err(dev, "No 'sound-dai' property\n");
		else
			dev_err(dev, "Bad phandle in 'sound-dai'\n");
		return num_codecs;
	}
	component = devm_kzalloc(dev,
				 sizeof *component * num_codecs,
				 GFP_KERNEL);
	if (!component)
		return -ENOMEM;
	dai_link->codecs = component;
	dai_link->num_codecs = num_codecs;

	/* Parse the list */
	for (index = 0, component = dai_link->codecs;
	     index < dai_link->num_codecs;
	     index++, component++) {
		ret = of_parse_phandle_with_args(of_node, name,
						 "#sound-dai-cells",
						  index, &args);
		if (ret)
			goto err;
		component->of_node = args.np;
		ret = snd_soc_get_dai_name(&args, &component->dai_name);
		if (ret < 0)
			goto err;
	}
	return 0;
err:
	for (index = 0, component = dai_link->codecs;
	     index < dai_link->num_codecs;
	     index++, component++) {
		if (!component->of_node)
			break;
		of_node_put(component->of_node);
		component->of_node = NULL;
	}
	dai_link->codecs = NULL;
	dai_link->num_codecs = 0;
	return ret;
}
EXPORT_SYMBOL_GPL(snd_soc_of_get_dai_link_codecs);

4186
static int __init snd_soc_init(void)
F
Frank Mandarino 已提交
4187
{
4188
	snd_soc_debugfs_init();
4189 4190
	snd_soc_util_init();

F
Frank Mandarino 已提交
4191 4192
	return platform_driver_register(&soc_driver);
}
4193
module_init(snd_soc_init);
F
Frank Mandarino 已提交
4194

M
Mark Brown 已提交
4195
static void __exit snd_soc_exit(void)
F
Frank Mandarino 已提交
4196
{
4197
	snd_soc_util_exit();
4198
	snd_soc_debugfs_exit();
4199

4200
	platform_driver_unregister(&soc_driver);
F
Frank Mandarino 已提交
4201 4202 4203 4204
}
module_exit(snd_soc_exit);

/* Module information */
4205
MODULE_AUTHOR("Liam Girdwood, lrg@slimlogic.co.uk");
F
Frank Mandarino 已提交
4206 4207
MODULE_DESCRIPTION("ALSA SoC Core");
MODULE_LICENSE("GPL");
4208
MODULE_ALIAS("platform:soc-audio");