soc-core.c 93.7 KB
Newer Older
Frank Mandarino's avatar
Frank Mandarino committed
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>
Frank Mandarino's avatar
Frank Mandarino committed
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>
Frank Mandarino's avatar
Frank Mandarino committed
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/of_graph.h>
38
#include <linux/dmi.h>
Frank Mandarino's avatar
Frank Mandarino committed
39
#include <sound/core.h>
40
#include <sound/jack.h>
Frank Mandarino's avatar
Frank Mandarino committed
41 42 43
#include <sound/pcm.h>
#include <sound/pcm_params.h>
#include <sound/soc.h>
44
#include <sound/soc-dpcm.h>
45
#include <sound/soc-topology.h>
Frank Mandarino's avatar
Frank Mandarino committed
46 47
#include <sound/initval.h>

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

51 52
#define NAME_SIZE	32

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

Mark Brown's avatar
Mark Brown committed
58
static DEFINE_MUTEX(client_mutex);
59
static LIST_HEAD(component_list);
Mark Brown's avatar
Mark Brown committed
60

Frank Mandarino's avatar
Frank Mandarino committed
61 62 63 64 65 66 67 68 69
/*
 * 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)");

70 71 72 73 74 75 76 77 78 79 80 81 82 83
/* If a DMI filed contain strings in this blacklist (e.g.
 * "Type2 - Board Manufacturer" or  "Type1 - TBD by OEM"), it will be taken
 * as invalid and dropped when setting the card long name from DMI info.
 */
static const char * const dmi_blacklist[] = {
	"To be filled by OEM",
	"TBD by OEM",
	"Default String",
	"Board Manufacturer",
	"Board Vendor Name",
	"Board Product Name",
	NULL,	/* terminator */
};

84 85 86
static ssize_t pmdown_time_show(struct device *dev,
				struct device_attribute *attr, char *buf)
{
87
	struct snd_soc_pcm_runtime *rtd = dev_get_drvdata(dev);
88

89
	return sprintf(buf, "%ld\n", rtd->pmdown_time);
90 91 92 93 94 95
}

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

99
	ret = kstrtol(buf, 10, &rtd->pmdown_time);
100 101
	if (ret)
		return ret;
102 103 104 105 106 107

	return count;
}

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

108 109 110 111 112 113 114 115 116 117 118 119 120
static struct attribute *soc_dev_attrs[] = {
	&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 */
121
	return rtd->num_codecs ? attr->mode : 0; /* enabled only with codec */
122 123 124 125 126 127 128
}

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

129
static const struct attribute_group soc_dev_group = {
130 131 132 133 134 135
	.attrs = soc_dev_attrs,
	.is_visible = soc_dev_attr_is_visible,
};

static const struct attribute_group *soc_dev_attr_groups[] = {
	&soc_dapm_dev_group,
136
	&soc_dev_group,
137 138 139
	NULL
};

140
#ifdef CONFIG_DEBUG_FS
141
static void soc_init_component_debugfs(struct snd_soc_component *component)
142
{
143 144 145
	if (!component->card->debugfs_card_root)
		return;

146 147
	if (component->debugfs_prefix) {
		char *name;
148

149 150 151 152 153 154 155 156 157 158 159
		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);
	}
160

161 162 163 164 165
	if (!component->debugfs_root) {
		dev_warn(component->dev,
			"ASoC: Failed to create component debugfs directory\n");
		return;
	}
166

167 168
	snd_soc_dapm_debugfs_init(snd_soc_component_get_dapm(component),
		component->debugfs_root);
169 170
}

171
static void soc_cleanup_component_debugfs(struct snd_soc_component *component)
172
{
173 174
	debugfs_remove_recursive(component->debugfs_root);
}
175

176
static int dai_list_show(struct seq_file *m, void *v)
Mark Brown's avatar
Mark Brown committed
177
{
178
	struct snd_soc_component *component;
Mark Brown's avatar
Mark Brown committed
179 180
	struct snd_soc_dai *dai;

181 182
	mutex_lock(&client_mutex);

183 184 185
	list_for_each_entry(component, &component_list, list)
		list_for_each_entry(dai, &component->dai_list, list)
			seq_printf(m, "%s\n", dai->name);
Mark Brown's avatar
Mark Brown committed
186

187 188
	mutex_unlock(&client_mutex);

189 190
	return 0;
}
191
DEFINE_SHOW_ATTRIBUTE(dai_list);
Mark Brown's avatar
Mark Brown committed
192

193 194
static void soc_init_card_debugfs(struct snd_soc_card *card)
{
195 196 197
	if (!snd_soc_debugfs_root)
		return;

198
	card->debugfs_card_root = debugfs_create_dir(card->name,
199
						     snd_soc_debugfs_root);
200
	if (!card->debugfs_card_root) {
201
		dev_warn(card->dev,
202
			 "ASoC: Failed to create card debugfs directory\n");
203 204 205 206 207 208 209 210
		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,
211
		       "ASoC: Failed to create pop time debugfs file\n");
212 213 214 215 216 217 218
}

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

219 220 221
static void snd_soc_debugfs_init(void)
{
	snd_soc_debugfs_root = debugfs_create_dir("asoc", NULL);
222
	if (IS_ERR_OR_NULL(snd_soc_debugfs_root)) {
223 224 225 226 227 228 229 230 231 232 233 234 235 236 237
		pr_warn("ASoC: Failed to create debugfs directory\n");
		snd_soc_debugfs_root = NULL;
		return;
	}

	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");
}

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

238 239
#else

240 241
static inline void soc_init_component_debugfs(
	struct snd_soc_component *component)
242 243 244
{
}

245 246
static inline void soc_cleanup_component_debugfs(
	struct snd_soc_component *component)
247 248 249
{
}

250 251 252 253 254 255 256
static inline void soc_init_card_debugfs(struct snd_soc_card *card)
{
}

static inline void soc_cleanup_card_debugfs(struct snd_soc_card *card)
{
}
257 258 259 260 261 262 263 264 265

static inline void snd_soc_debugfs_init(void)
{
}

static inline void snd_soc_debugfs_exit(void)
{
}

266 267
#endif

268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306
static int snd_soc_rtdcom_add(struct snd_soc_pcm_runtime *rtd,
			      struct snd_soc_component *component)
{
	struct snd_soc_rtdcom_list *rtdcom;
	struct snd_soc_rtdcom_list *new_rtdcom;

	for_each_rtdcom(rtd, rtdcom) {
		/* already connected */
		if (rtdcom->component == component)
			return 0;
	}

	new_rtdcom = kmalloc(sizeof(*new_rtdcom), GFP_KERNEL);
	if (!new_rtdcom)
		return -ENOMEM;

	new_rtdcom->component = component;
	INIT_LIST_HEAD(&new_rtdcom->list);

	list_add_tail(&new_rtdcom->list, &rtd->component_list);

	return 0;
}

static void snd_soc_rtdcom_del_all(struct snd_soc_pcm_runtime *rtd)
{
	struct snd_soc_rtdcom_list *rtdcom1, *rtdcom2;

	for_each_rtdcom_safe(rtd, rtdcom1, rtdcom2)
		kfree(rtdcom1);

	INIT_LIST_HEAD(&rtd->component_list);
}

struct snd_soc_component *snd_soc_rtdcom_lookup(struct snd_soc_pcm_runtime *rtd,
						const char *driver_name)
{
	struct snd_soc_rtdcom_list *rtdcom;

307 308 309
	if (!driver_name)
		return NULL;

310
	for_each_rtdcom(rtd, rtdcom) {
311 312 313 314 315 316 317
		const char *component_name = rtdcom->component->driver->name;

		if (!component_name)
			continue;

		if ((component_name == driver_name) ||
		    strcmp(component_name, driver_name) == 0)
318 319 320 321 322
			return rtdcom->component;
	}

	return NULL;
}
323
EXPORT_SYMBOL_GPL(snd_soc_rtdcom_lookup);
324

325 326 327
struct snd_pcm_substream *snd_soc_get_dai_substream(struct snd_soc_card *card,
		const char *dai_link, int stream)
{
328
	struct snd_soc_pcm_runtime *rtd;
329

330 331 332 333
	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;
334
	}
335
	dev_dbg(card->dev, "ASoC: failed to find dai link %s\n", dai_link);
336 337 338 339
	return NULL;
}
EXPORT_SYMBOL_GPL(snd_soc_get_dai_substream);

340 341
static const struct snd_soc_ops null_snd_soc_ops;

342 343 344 345 346 347 348 349 350
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;

351
	INIT_LIST_HEAD(&rtd->component_list);
352 353
	rtd->card = card;
	rtd->dai_link = dai_link;
354 355 356
	if (!rtd->dai_link->ops)
		rtd->dai_link->ops = &null_snd_soc_ops;

357 358 359 360 361 362 363 364 365 366 367 368 369
	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)
{
370
	kfree(rtd->codec_dais);
371
	snd_soc_rtdcom_del_all(rtd);
372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394
	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;
}

395 396 397
struct snd_soc_pcm_runtime *snd_soc_get_pcm_runtime(struct snd_soc_card *card,
		const char *dai_link)
{
398
	struct snd_soc_pcm_runtime *rtd;
399

400 401 402
	list_for_each_entry(rtd, &card->rtd_list, list) {
		if (!strcmp(rtd->dai_link->name, dai_link))
			return rtd;
403
	}
404
	dev_dbg(card->dev, "ASoC: failed to find rtd %s\n", dai_link);
405 406 407 408
	return NULL;
}
EXPORT_SYMBOL_GPL(snd_soc_get_pcm_runtime);

409 410 411 412 413 414 415 416 417
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.
	 */
}

418
#ifdef CONFIG_PM_SLEEP
Frank Mandarino's avatar
Frank Mandarino committed
419
/* powers down audio subsystem for suspend */
420
int snd_soc_suspend(struct device *dev)
Frank Mandarino's avatar
Frank Mandarino committed
421
{
422
	struct snd_soc_card *card = dev_get_drvdata(dev);
423
	struct snd_soc_component *component;
424 425
	struct snd_soc_pcm_runtime *rtd;
	int i;
Frank Mandarino's avatar
Frank Mandarino committed
426

427 428
	/* If the card is not initialized yet there is nothing to do */
	if (!card->instantiated)
429 430
		return 0;

431 432 433
	/* Due to the resume being scheduled into a workqueue we could
	* suspend before that's finished - wait for it to complete.
	 */
434
	snd_power_wait(card->snd_card, SNDRV_CTL_POWER_D0);
435 436

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

439
	/* mute any active DACs */
440
	list_for_each_entry(rtd, &card->rtd_list, list) {
441

442
		if (rtd->dai_link->ignore_suspend)
443 444
			continue;

445 446
		for (i = 0; i < rtd->num_codecs; i++) {
			struct snd_soc_dai *dai = rtd->codec_dais[i];
447 448 449 450 451
			struct snd_soc_dai_driver *drv = dai->driver;

			if (drv->ops->digital_mute && dai->playback_active)
				drv->ops->digital_mute(dai, 1);
		}
Frank Mandarino's avatar
Frank Mandarino committed
452 453
	}

454
	/* suspend all pcms */
455 456
	list_for_each_entry(rtd, &card->rtd_list, list) {
		if (rtd->dai_link->ignore_suspend)
457 458
			continue;

459
		snd_pcm_suspend_all(rtd->pcm);
460
	}
461

462
	if (card->suspend_pre)
463
		card->suspend_pre(card);
Frank Mandarino's avatar
Frank Mandarino committed
464

465 466
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
467

468
		if (rtd->dai_link->ignore_suspend)
469 470
			continue;

471
		if (cpu_dai->driver->suspend && !cpu_dai->driver->bus_control)
472
			cpu_dai->driver->suspend(cpu_dai);
Frank Mandarino's avatar
Frank Mandarino committed
473 474
	}

475
	/* close any waiting streams */
476 477
	list_for_each_entry(rtd, &card->rtd_list, list)
		flush_delayed_work(&rtd->delayed_work);
Frank Mandarino's avatar
Frank Mandarino committed
478

479
	list_for_each_entry(rtd, &card->rtd_list, list) {
480

481
		if (rtd->dai_link->ignore_suspend)
482 483
			continue;

484
		snd_soc_dapm_stream_event(rtd,
485 486
					  SNDRV_PCM_STREAM_PLAYBACK,
					  SND_SOC_DAPM_STREAM_SUSPEND);
487

488
		snd_soc_dapm_stream_event(rtd,
489 490
					  SNDRV_PCM_STREAM_CAPTURE,
					  SND_SOC_DAPM_STREAM_SUSPEND);
Frank Mandarino's avatar
Frank Mandarino committed
491 492
	}

493 494
	/* Recheck all endpoints too, their state is affected by suspend */
	dapm_mark_endpoints_dirty(card);
495 496
	snd_soc_dapm_sync(&card->dapm);

497
	/* suspend all COMPONENTs */
498 499 500
	list_for_each_entry(component, &card->component_dev_list, card_list) {
		struct snd_soc_dapm_context *dapm = snd_soc_component_get_dapm(component);

501
		/* If there are paths active then the COMPONENT will be held with
502
		 * bias _ON and should not be suspended. */
503
		if (!component->suspended) {
504
			switch (snd_soc_dapm_get_bias_level(dapm)) {
505
			case SND_SOC_BIAS_STANDBY:
506
				/*
507
				 * If the COMPONENT is capable of idle
508 509 510 511
				 * bias off then being in STANDBY
				 * means it's doing something,
				 * otherwise fall through.
				 */
512
				if (dapm->idle_bias_off) {
513
					dev_dbg(component->dev,
514
						"ASoC: idle_bias_off CODEC on over suspend\n");
515 516
					break;
				}
517

518
			case SND_SOC_BIAS_OFF:
519 520
				if (component->driver->suspend)
					component->driver->suspend(component);
521 522 523
				component->suspended = 1;
				if (component->regmap)
					regcache_mark_dirty(component->regmap);
524
				/* deactivate pins to sleep state */
525
				pinctrl_pm_select_sleep_state(component->dev);
526 527
				break;
			default:
528 529
				dev_dbg(component->dev,
					"ASoC: COMPONENT is on over suspend\n");
530 531
				break;
			}
532 533
		}
	}
Frank Mandarino's avatar
Frank Mandarino committed
534

535 536
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
537

538
		if (rtd->dai_link->ignore_suspend)
539 540
			continue;

541
		if (cpu_dai->driver->suspend && cpu_dai->driver->bus_control)
542
			cpu_dai->driver->suspend(cpu_dai);
543 544 545

		/* deactivate pins to sleep state */
		pinctrl_pm_select_sleep_state(cpu_dai->dev);
Frank Mandarino's avatar
Frank Mandarino committed
546 547
	}

548
	if (card->suspend_post)
549
		card->suspend_post(card);
Frank Mandarino's avatar
Frank Mandarino committed
550 551 552

	return 0;
}
553
EXPORT_SYMBOL_GPL(snd_soc_suspend);
Frank Mandarino's avatar
Frank Mandarino committed
554

555 556 557 558
/* 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)
Frank Mandarino's avatar
Frank Mandarino committed
559
{
560 561
	struct snd_soc_card *card =
			container_of(work, struct snd_soc_card, deferred_resume_work);
562
	struct snd_soc_pcm_runtime *rtd;
563
	struct snd_soc_component *component;
564
	int i;
Frank Mandarino's avatar
Frank Mandarino committed
565

566 567 568 569
	/* our power state is still SNDRV_CTL_POWER_D3hot from suspend time,
	 * so userspace apps are blocked from touching us
	 */

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

572
	/* Bring us up into D2 so that DAPM starts enabling things */
573
	snd_power_change_state(card->snd_card, SNDRV_CTL_POWER_D2);
574

575
	if (card->resume_pre)
576
		card->resume_pre(card);
Frank Mandarino's avatar
Frank Mandarino committed
577

578
	/* resume control bus DAIs */
579 580
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
581

582
		if (rtd->dai_link->ignore_suspend)
583 584
			continue;

585
		if (cpu_dai->driver->resume && cpu_dai->driver->bus_control)
586 587 588
			cpu_dai->driver->resume(cpu_dai);
	}

589
	list_for_each_entry(component, &card->component_dev_list, card_list) {
590
		if (component->suspended) {
591 592
			if (component->driver->resume)
				component->driver->resume(component);
593
			component->suspended = 0;
594 595
		}
	}
Frank Mandarino's avatar
Frank Mandarino committed
596

597
	list_for_each_entry(rtd, &card->rtd_list, list) {
598

599
		if (rtd->dai_link->ignore_suspend)
600 601
			continue;

602
		snd_soc_dapm_stream_event(rtd,
603
					  SNDRV_PCM_STREAM_PLAYBACK,
604
					  SND_SOC_DAPM_STREAM_RESUME);
605

606
		snd_soc_dapm_stream_event(rtd,
607
					  SNDRV_PCM_STREAM_CAPTURE,
608
					  SND_SOC_DAPM_STREAM_RESUME);
Frank Mandarino's avatar
Frank Mandarino committed
609 610
	}

611
	/* unmute any active DACs */
612
	list_for_each_entry(rtd, &card->rtd_list, list) {
613

614
		if (rtd->dai_link->ignore_suspend)
615 616
			continue;

617 618
		for (i = 0; i < rtd->num_codecs; i++) {
			struct snd_soc_dai *dai = rtd->codec_dais[i];
619 620 621 622 623
			struct snd_soc_dai_driver *drv = dai->driver;

			if (drv->ops->digital_mute && dai->playback_active)
				drv->ops->digital_mute(dai, 0);
		}
Frank Mandarino's avatar
Frank Mandarino committed
624 625
	}

626 627
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
628

629
		if (rtd->dai_link->ignore_suspend)
630 631
			continue;

632
		if (cpu_dai->driver->resume && !cpu_dai->driver->bus_control)
633
			cpu_dai->driver->resume(cpu_dai);
Frank Mandarino's avatar
Frank Mandarino committed
634 635
	}

636
	if (card->resume_post)
637
		card->resume_post(card);
Frank Mandarino's avatar
Frank Mandarino committed
638

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

641 642
	/* Recheck all endpoints too, their state is affected by suspend */
	dapm_mark_endpoints_dirty(card);
643
	snd_soc_dapm_sync(&card->dapm);
644 645 646

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

/* powers up audio subsystem after a suspend */
650
int snd_soc_resume(struct device *dev)
651
{
652
	struct snd_soc_card *card = dev_get_drvdata(dev);
653
	bool bus_control = false;
654
	struct snd_soc_pcm_runtime *rtd;
655

656 657
	/* If the card is not initialized yet there is nothing to do */
	if (!card->instantiated)
658 659
		return 0;

660
	/* activate pins from sleep state */
661
	list_for_each_entry(rtd, &card->rtd_list, list) {
662 663 664 665
		struct snd_soc_dai **codec_dais = rtd->codec_dais;
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
		int j;

666 667
		if (cpu_dai->active)
			pinctrl_pm_select_default_state(cpu_dai->dev);
668 669 670 671 672 673

		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);
		}
674 675
	}

676 677 678 679
	/*
	 * 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
680 681
	 * due to I/O costs and anti-pop so handle them out of line.
	 */
682 683
	list_for_each_entry(rtd, &card->rtd_list, list) {
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
684
		bus_control |= cpu_dai->driver->bus_control;
685
	}
686 687
	if (bus_control) {
		dev_dbg(dev, "ASoC: Resuming control bus master immediately\n");
688 689
		soc_resume_deferred(&card->deferred_resume_work);
	} else {
690
		dev_dbg(dev, "ASoC: Scheduling resume work\n");
691
		if (!schedule_work(&card->deferred_resume_work))
692
			dev_err(dev, "ASoC: resume work item may be lost\n");
693
	}
694

Frank Mandarino's avatar
Frank Mandarino committed
695 696
	return 0;
}
697
EXPORT_SYMBOL_GPL(snd_soc_resume);
Frank Mandarino's avatar
Frank Mandarino committed
698
#else
699 700
#define snd_soc_suspend NULL
#define snd_soc_resume NULL
Frank Mandarino's avatar
Frank Mandarino committed
701 702
#endif

703
static const struct snd_soc_dai_ops null_dai_ops = {
704 705
};

706 707
static struct snd_soc_component *soc_find_component(
	const struct device_node *of_node, const char *name)
708
{
709
	struct snd_soc_component *component;
710

711 712
	lockdep_assert_held(&client_mutex);

713 714 715 716 717 718
	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;
719 720 721 722 723 724
		}
	}

	return NULL;
}

725 726 727
/**
 * snd_soc_find_dai - Find a registered DAI
 *
728
 * @dlc: name of the DAI or the DAI driver and optional component info to match
729
 *
730
 * This function will search all registered components and their DAIs to
731 732 733 734 735
 * 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.
 */
736
struct snd_soc_dai *snd_soc_find_dai(
737
	const struct snd_soc_dai_link_component *dlc)
738
{
739 740
	struct snd_soc_component *component;
	struct snd_soc_dai *dai;
741
	struct device_node *component_of_node;
742

743 744
	lockdep_assert_held(&client_mutex);

745 746
	/* Find CPU DAI from registered DAIs*/
	list_for_each_entry(component, &component_list, list) {
747 748 749 750 751
		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)
752
			continue;
753
		if (dlc->name && strcmp(component->name, dlc->name))
754 755
			continue;
		list_for_each_entry(dai, &component->dai_list, list) {
756
			if (dlc->dai_name && strcmp(dai->name, dlc->dai_name)
757 758
			    && (!dai->driver->name
				|| strcmp(dai->driver->name, dlc->dai_name)))
759 760
				continue;

761
			return dai;
762 763 764 765 766
		}
	}

	return NULL;
}
767
EXPORT_SYMBOL_GPL(snd_soc_find_dai);
768

769 770 771 772 773 774 775

/**
 * 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
776
 * @stream_name: DAI link stream name to match, optional
777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810
 *
 * 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);

811 812 813 814 815 816 817 818 819 820 821 822 823
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;
}

824 825
static int soc_bind_dai_link(struct snd_soc_card *card,
	struct snd_soc_dai_link *dai_link)
Frank Mandarino's avatar
Frank Mandarino committed
826
{
827
	struct snd_soc_pcm_runtime *rtd;
828
	struct snd_soc_dai_link_component *codecs = dai_link->codecs;
829
	struct snd_soc_dai_link_component cpu_dai_component;
830
	struct snd_soc_component *component;
831
	struct snd_soc_dai **codec_dais;
832
	struct device_node *platform_of_node;
833
	const char *platform_name;
834
	int i;
835

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

838 839 840 841 842
	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;
	}
843

Sudip Mukherjee's avatar
Sudip Mukherjee committed
844 845 846 847
	rtd = soc_new_pcm_runtime(card, dai_link);
	if (!rtd)
		return -ENOMEM;

848 849 850 851
	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);
852
	if (!rtd->cpu_dai) {
853 854
		dev_info(card->dev, "ASoC: CPU DAI %s not registered\n",
			 dai_link->cpu_dai_name);
855
		goto _err_defer;
856
	}
857
	snd_soc_rtdcom_add(rtd, rtd->cpu_dai->component);
858

859
	rtd->num_codecs = dai_link->num_codecs;
860

861
	/* Find CODEC from registered CODECs */
862
	codec_dais = rtd->codec_dais;
863
	for (i = 0; i < rtd->num_codecs; i++) {
864
		codec_dais[i] = snd_soc_find_dai(&codecs[i]);
865 866 867
		if (!codec_dais[i]) {
			dev_err(card->dev, "ASoC: CODEC DAI %s not registered\n",
				codecs[i].dai_name);
868
			goto _err_defer;
869
		}
870
		snd_soc_rtdcom_add(rtd, codec_dais[i]->component);
871 872
	}

873 874 875
	/* Single codec links expect codec and codec_dai in runtime data */
	rtd->codec_dai = codec_dais[0];

876 877
	/* if there's no platform we match on the empty platform */
	platform_name = dai_link->platform_name;
878
	if (!platform_name && !dai_link->platform_of_node)
879 880
		platform_name = "snd-soc-dummy";

881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897
	/* find one from the set of registered platforms */
	list_for_each_entry(component, &component_list, list) {
		platform_of_node = component->dev->of_node;
		if (!platform_of_node && component->dev->parent->of_node)
			platform_of_node = component->dev->parent->of_node;

		if (dai_link->platform_of_node) {
			if (platform_of_node != dai_link->platform_of_node)
				continue;
		} else {
			if (strcmp(component->name, platform_name))
				continue;
		}

		snd_soc_rtdcom_add(rtd, component);
	}

898
	soc_add_pcm_runtime(card, rtd);
899
	return 0;
900 901 902 903

_err_defer:
	soc_free_pcm_runtime(rtd);
	return  -EPROBE_DEFER;
904 905
}

906
static void soc_remove_component(struct snd_soc_component *component)
907
{
908
	if (!component->card)
909
		return;
910

911
	list_del(&component->card_list);
912

913 914
	if (component->driver->remove)
		component->driver->remove(component);
915

916
	snd_soc_dapm_free(snd_soc_component_get_dapm(component));
917

918
	soc_cleanup_component_debugfs(component);
919
	component->card = NULL;
920
	module_put(component->dev->driver->owner);
921 922
}

923
static void soc_remove_dai(struct snd_soc_dai *dai, int order)
924 925 926
{
	int err;

927 928 929 930
	if (dai && dai->probed &&
			dai->driver->remove_order == order) {
		if (dai->driver->remove) {
			err = dai->driver->remove(dai);
931
			if (err < 0)
932
				dev_err(dai->dev,
933
					"ASoC: failed to remove %s: %d\n",
934
					dai->name, err);
935
		}
936
		dai->probed = 0;
937
	}
938 939
}

940 941
static void soc_remove_link_dais(struct snd_soc_card *card,
		struct snd_soc_pcm_runtime *rtd, int order)
942
{
943
	int i;
944 945 946 947 948 949 950 951

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

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

955
	soc_remove_dai(rtd->cpu_dai, order);
956
}
Frank Mandarino's avatar
Frank Mandarino committed
957

958 959
static void soc_remove_link_components(struct snd_soc_card *card,
	struct snd_soc_pcm_runtime *rtd, int order)
960
{
961
	struct snd_soc_component *component;
962
	struct snd_soc_rtdcom_list *rtdcom;
963

964 965
	for_each_rtdcom(rtd, rtdcom) {
		component = rtdcom->component;
966

967
		if (component->driver->remove_order == order)
968
			soc_remove_component(component);
969 970 971
	}
}

972 973
static void soc_remove_dai_links(struct snd_soc_card *card)
{
974 975
	int order;
	struct snd_soc_pcm_runtime *rtd;
976
	struct snd_soc_dai_link *link, *_link;
977

978 979
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
			order++) {
980 981
		list_for_each_entry(rtd, &card->rtd_list, list)
			soc_remove_link_dais(card, rtd, order);
982 983 984 985
	}

	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
			order++) {
986 987
		list_for_each_entry(rtd, &card->rtd_list, list)
			soc_remove_link_components(card, rtd, order);
988
	}
989

990 991 992 993 994 995 996 997
	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--;
	}
998 999
}

1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091
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;
1092 1093
}

1094 1095 1096 1097 1098 1099 1100 1101 1102
void snd_soc_disconnect_sync(struct device *dev)
{
	struct snd_soc_component *component = snd_soc_lookup_component(dev, NULL);

	if (!component || !component->card)
		return;

	snd_card_disconnect_sync(component->card->snd_card);
}
1103
EXPORT_SYMBOL_GPL(snd_soc_disconnect_sync);
1104

1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126
/**
 * 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);
1127 1128 1129 1130 1131 1132
	/* 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);

1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162
	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);
1163 1164 1165 1166 1167 1168
	/* 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);

1169 1170 1171 1172 1173 1174 1175 1176 1177 1178
	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);

1179
static void soc_set_name_prefix(struct snd_soc_card *card,
1180
				struct snd_soc_component *component)
1181 1182 1183
{
	int i;

1184
	if (card->codec_conf == NULL)
1185 1186
		return;

1187 1188
	for (i = 0; i < card->num_configs; i++) {
		struct snd_soc_codec_conf *map = &card->codec_conf[i];
1189 1190 1191 1192 1193 1194
		struct device_node *component_of_node = component->dev->of_node;

		if (!component_of_node && component->dev->parent)
			component_of_node = component->dev->parent->of_node;

		if (map->of_node && component_of_node != map->of_node)
1195
			continue;
1196
		if (map->dev_name && strcmp(component->name, map->dev_name))
1197
			continue;
1198
		component->name_prefix = map->name_prefix;
1199
		break;
1200 1201 1202
	}
}

1203 1204
static int soc_probe_component(struct snd_soc_card *card,
	struct snd_soc_component *component)
1205
{
1206
	struct snd_soc_dapm_context *dapm = snd_soc_component_get_dapm(component);
1207
	struct snd_soc_dai *dai;
1208
	int ret;
1209

1210
	if (!strcmp(component->name, "snd-soc-dummy"))
1211
		return 0;
1212

1213
	if (component->card) {
1214 1215 1216 1217 1218 1219 1220 1221
		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;
	}
1222

1223
	if (!try_module_get(component->dev->driver->owner))
1224 1225
		return -ENODEV;

1226 1227 1228
	component->card = card;
	dapm->card = card;
	soc_set_name_prefix(card, component);
1229

1230
	soc_init_component_debugfs(component);
1231

1232 1233 1234 1235
	if (component->driver->dapm_widgets) {
		ret = snd_soc_dapm_new_controls(dapm,
					component->driver->dapm_widgets,
					component->driver->num_dapm_widgets);
1236 1237

		if (ret != 0) {
1238
			dev_err(component->dev,
1239 1240 1241 1242
				"Failed to create new controls %d\n", ret);
			goto err_probe;
		}
	}
1243

1244 1245
	list_for_each_entry(dai, &component->dai_list, list) {
		ret = snd_soc_dapm_new_dai_widgets(dapm, dai);
1246
		if (ret != 0) {
1247
			dev_err(component->dev,
1248 1249 1250 1251
				"Failed to create DAI widgets %d\n", ret);
			goto err_probe;
		}
	}
1252

1253 1254
	if (component->driver->probe) {
		ret = component->driver->probe(component);
1255
		if (ret < 0) {
1256 1257
			dev_err(component->dev,
				"ASoC: failed to probe component %d\n", ret);
1258
			goto err_probe;
1259
		}
1260

1261 1262 1263 1264
		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);
1265 1266
	}

1267 1268 1269 1270 1271 1272 1273 1274 1275 1276
	/* 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;
		}
	}

1277 1278 1279 1280
	if (component->driver->controls)
		snd_soc_add_component_controls(component,
					       component->driver->controls,
					       component->driver->num_controls);
1281 1282 1283 1284
	if (component->driver->dapm_routes)
		snd_soc_dapm_add_routes(dapm,
					component->driver->dapm_routes,
					component->driver->num_dapm_routes);
1285

1286
	list_add(&dapm->list, &card->dapm_list);
1287
	list_add(&component->card_list, &card->component_dev_list);
1288 1289 1290 1291

	return 0;

err_probe:
1292
	soc_cleanup_component_debugfs(component);
1293
	component->card = NULL;
1294
	module_put(component->dev->driver->owner);
1295 1296 1297 1298

	return ret;
}

1299 1300 1301 1302
static void rtd_release(struct device *dev)
{
	kfree(dev);
}
1303

1304 1305
static int soc_post_component_init(struct snd_soc_pcm_runtime *rtd,
	const char *name)
1306
{
1307 1308 1309
	int ret = 0;

	/* register the rtd device */
1310 1311 1312 1313
	rtd->dev = kzalloc(sizeof(struct device), GFP_KERNEL);
	if (!rtd->dev)
		return -ENOMEM;
	device_initialize(rtd->dev);
1314
	rtd->dev->parent = rtd->card->dev;
1315
	rtd->dev->release = rtd_release;
1316
	rtd->dev->groups = soc_dev_attr_groups;
1317
	dev_set_name(rtd->dev, "%s", name);
1318
	dev_set_drvdata(rtd->dev, rtd);
1319
	mutex_init(&rtd->pcm_mutex);
1320 1321 1322 1323
	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);
1324
	ret = device_add(rtd->dev);
1325
	if (ret < 0) {
1326 1327
		/* calling put_device() here to free the rtd->dev */
		put_device(rtd->dev);
1328
		dev_err(rtd->card->dev,
1329
			"ASoC: failed to register runtime device: %d\n", ret);
1330 1331 1332 1333 1334 1335
		return ret;
	}
	rtd->dev_registered = 1;
	return 0;
}

1336 1337
static int soc_probe_link_components(struct snd_soc_card *card,
			struct snd_soc_pcm_runtime *rtd,
1338 1339
				     int order)
{
1340
	struct snd_soc_component *component;
1341 1342
	struct snd_soc_rtdcom_list *rtdcom;
	int ret;
1343

1344 1345
	for_each_rtdcom(rtd, rtdcom) {
		component = rtdcom->component;
1346

1347
		if (component->driver->probe_order == order) {
1348
			ret = soc_probe_component(card, component);
1349 1350 1351
			if (ret < 0)
				return ret;
		}
1352 1353 1354 1355 1356
	}

	return 0;
}

1357
static int soc_probe_dai(struct snd_soc_dai *dai, int order)
1358
{
1359 1360 1361
	if (dai->probed ||
	    dai->driver->probe_order != order)
		return 0;
1362

1363 1364 1365 1366 1367 1368
	if (dai->driver->probe) {
		int ret = dai->driver->probe(dai);
		if (ret < 0) {
			dev_err(dai->dev, "ASoC: failed to probe DAI %s: %d\n",
				dai->name, ret);
			return ret;
1369 1370 1371
		}
	}

1372 1373
	dai->probed = 1;

1374 1375 1376
	return 0;
}

1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397
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;
}

1398 1399
static int soc_link_dai_widgets(struct snd_soc_card *card,
				struct snd_soc_dai_link *dai_link,
1400
				struct snd_soc_pcm_runtime *rtd)
1401
{
1402 1403
	struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
	struct snd_soc_dai *codec_dai = rtd->codec_dai;
1404
	struct snd_soc_dapm_widget *sink, *source;
1405 1406
	int ret;

1407 1408 1409
	if (rtd->num_codecs > 1)
		dev_warn(card->dev, "ASoC: Multiple codecs not supported yet\n");

1410
	/* link the DAI widgets */
1411 1412 1413
	sink = codec_dai->playback_widget;
	source = cpu_dai->capture_widget;
	if (sink && source) {
1414
		ret = snd_soc_dapm_new_pcm(card, dai_link->params,
1415 1416
					   dai_link->num_params,
					   source, sink);
1417 1418
		if (ret != 0) {
			dev_err(card->dev, "ASoC: Can't link %s to %s: %d\n",
1419
				sink->name, source->name, ret);
1420 1421 1422 1423
			return ret;
		}
	}

1424 1425 1426
	sink = cpu_dai->playback_widget;
	source = codec_dai->capture_widget;
	if (sink && source) {
1427
		ret = snd_soc_dapm_new_pcm(card, dai_link->params,
1428 1429
					   dai_link->num_params,
					   source, sink);
1430 1431
		if (ret != 0) {
			dev_err(card->dev, "ASoC: Can't link %s to %s: %d\n",
1432
				sink->name, source->name, ret);
1433 1434 1435 1436 1437 1438 1439
			return ret;
		}
	}

	return 0;
}

1440 1441
static int soc_probe_link_dais(struct snd_soc_card *card,
		struct snd_soc_pcm_runtime *rtd, int order)
1442
{
1443
	struct snd_soc_dai_link *dai_link = rtd->dai_link;
1444
	struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
1445
	int i, ret;
1446

1447
	dev_dbg(card->dev, "ASoC: probe %s dai link %d late %d\n",
1448
			card->name, rtd->num, order);
1449 1450 1451 1452

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

1453 1454 1455
	ret = soc_probe_dai(cpu_dai, order);
	if (ret)
		return ret;
Frank Mandarino's avatar
Frank Mandarino committed
1456

1457
	/* probe the CODEC DAI */
1458
	for (i = 0; i < rtd->num_codecs; i++) {
1459
		ret = soc_probe_dai(rtd->codec_dais[i], order);
1460 1461 1462
		if (ret)
			return ret;
	}
1463

1464 1465 1466 1467
	/* complete DAI probe during last probe */
	if (order != SND_SOC_COMP_ORDER_LAST)
		return 0;

1468 1469 1470 1471 1472 1473 1474 1475 1476 1477
	/* 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;
		}
	}

1478 1479 1480
	if (dai_link->dai_fmt)
		snd_soc_runtime_set_dai_fmt(rtd, dai_link->dai_fmt);

1481
	ret = soc_post_component_init(rtd, dai_link->name);
1482
	if (ret)
1483
		return ret;
1484

1485 1486
#ifdef CONFIG_DEBUG_FS
	/* add DPCM sysfs entries */
1487 1488
	if (dai_link->dynamic)
		soc_dpcm_debugfs_add(rtd);
1489 1490
#endif

1491
	if (cpu_dai->driver->compress_new) {
1492
		/*create compress_device"*/
1493
		ret = cpu_dai->driver->compress_new(rtd, rtd->num);
1494
		if (ret < 0) {
1495
			dev_err(card->dev, "ASoC: can't create compress %s\n",
1496
					 dai_link->stream_name);
1497 1498 1499
			return ret;
		}
	} else {
1500 1501 1502

		if (!dai_link->params) {
			/* create the pcm */
1503
			ret = soc_new_pcm(rtd, rtd->num);
1504
			if (ret < 0) {
1505
				dev_err(card->dev, "ASoC: can't create pcm %s :%d\n",
1506
				       dai_link->stream_name, ret);
1507 1508
				return ret;
			}
1509 1510 1511 1512 1513 1514 1515
			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;
1516
		} else {
1517 1518 1519
			INIT_DELAYED_WORK(&rtd->delayed_work,
						codec2codec_close_delayed_work);

1520
			/* link the DAI widgets */
1521
			ret = soc_link_dai_widgets(card, dai_link, rtd);
1522 1523
			if (ret)
				return ret;
1524
		}
1525 1526 1527 1528 1529
	}

	return 0;
}

1530
static int soc_bind_aux_dev(struct snd_soc_card *card, int num)
1531 1532
{
	struct snd_soc_aux_dev *aux_dev = &card->aux_dev[num];
1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555
	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;
1556
	}
1557

1558
	component->init = aux_dev->init;
1559
	list_add(&component->card_aux_list, &card->aux_comp_list);
1560

1561
	return 0;
1562 1563 1564 1565

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

1568
static int soc_probe_aux_devices(struct snd_soc_card *card)
1569
{
1570
	struct snd_soc_component *comp;
1571
	int order;
1572
	int ret;
1573

1574 1575
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
		order++) {
1576
		list_for_each_entry(comp, &card->aux_comp_list, card_aux_list) {
1577 1578 1579 1580 1581 1582 1583 1584 1585
			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;
				}
			}
1586 1587
		}
	}
1588

1589
	return 0;
1590 1591
}

1592
static void soc_remove_aux_devices(struct snd_soc_card *card)
1593
{
1594 1595
	struct snd_soc_component *comp, *_comp;
	int order;
1596

1597 1598 1599
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
		order++) {
		list_for_each_entry_safe(comp, _comp,
1600
			&card->aux_comp_list, card_aux_list) {
1601

1602 1603
			if (comp->driver->remove_order == order) {
				soc_remove_component(comp);
1604 1605
				/* remove it from the card's aux_comp_list */
				list_del(&comp->card_aux_list);
1606 1607
			}
		}
1608 1609 1610
	}
}

1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643
/**
 * 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 */
1644
	/* the component which has non_legacy_dai_naming is Codec */
1645
	if (cpu_dai->component->driver->non_legacy_dai_naming) {
1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675
		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;
}
1676
EXPORT_SYMBOL_GPL(snd_soc_runtime_set_dai_fmt);
1677

1678

1679
#ifdef CONFIG_DMI
1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698
/* 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';
}

1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709
/* Check if a DMI field is valid, i.e. not containing any string
 * in the black list.
 */
static int is_dmi_valid(const char *field)
{
	int i = 0;

	while (dmi_blacklist[i]) {
		if (strstr(field, dmi_blacklist[i]))
			return 0;
		i++;
1710
	}
1711 1712 1713 1714

	return 1;
}

1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756
/**
 * 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);
1757
	if (!vendor || !is_dmi_valid(vendor)) {
1758 1759 1760 1761
		dev_warn(card->dev, "ASoC: no DMI vendor name!\n");
		return 0;
	}

1762

1763 1764 1765 1766 1767
	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);
1768
	if (product && is_dmi_valid(product)) {
1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781
		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);
1782
		if (product_version && is_dmi_valid(product_version)) {
1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794
			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);
1795
	if (board && is_dmi_valid(board)) {
1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827
		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);
1828
#endif /* CONFIG_DMI */
1829

1830
static int snd_soc_instantiate_card(struct snd_soc_card *card)
1831
{
1832
	struct snd_soc_pcm_runtime *rtd;
1833
	struct snd_soc_dai_link *dai_link;
1834
	int ret, i, order;
1835

1836
	mutex_lock(&client_mutex);
1837
	mutex_lock_nested(&card->mutex, SND_SOC_CARD_CLASS_INIT);
1838

1839
	/* bind DAIs */
1840
	for (i = 0; i < card->num_links; i++) {
1841
		ret = soc_bind_dai_link(card, &card->dai_link[i]);
1842 1843 1844
		if (ret != 0)
			goto base_error;
	}
1845

1846
	/* bind aux_devs too */
1847
	for (i = 0; i < card->num_aux_devs; i++) {
1848
		ret = soc_bind_aux_dev(card, i);
1849 1850
		if (ret != 0)
			goto base_error;
1851
	}
1852

1853 1854 1855 1856
	/* 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);

1857
	/* card bind complete so register a sound card */
1858
	ret = snd_card_new(card->dev, SNDRV_DEFAULT_IDX1, SNDRV_DEFAULT_STR1,
1859 1860
			card->owner, 0, &card->snd_card);
	if (ret < 0) {
1861 1862 1863
		dev_err(card->dev,
			"ASoC: can't create sound card for card %s: %d\n",
			card->name, ret);
1864
		goto base_error;
1865 1866
	}

1867 1868
	soc_init_card_debugfs(card);

1869 1870 1871 1872 1873
	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);

1874 1875 1876 1877
#ifdef CONFIG_DEBUG_FS
	snd_soc_dapm_debugfs_init(&card->dapm, card->debugfs_card_root);
#endif

1878
#ifdef CONFIG_PM_SLEEP
1879 1880 1881
	/* deferred resume work */
	INIT_WORK(&card->deferred_resume_work, soc_resume_deferred);
#endif
Frank Mandarino's avatar
Frank Mandarino committed
1882

1883 1884 1885 1886
	if (card->dapm_widgets)
		snd_soc_dapm_new_controls(&card->dapm, card->dapm_widgets,
					  card->num_dapm_widgets);

1887 1888 1889 1890
	if (card->of_dapm_widgets)
		snd_soc_dapm_new_controls(&card->dapm, card->of_dapm_widgets,
					  card->num_of_dapm_widgets);

1891 1892
	/* initialise the sound card only once */
	if (card->probe) {
1893
		ret = card->probe(card);
1894 1895 1896
		if (ret < 0)
			goto card_probe_error;
	}
1897

1898
	/* probe all components used by DAI links on this card */
1899 1900
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
			order++) {
1901 1902
		list_for_each_entry(rtd, &card->rtd_list, list) {
			ret = soc_probe_link_components(card, rtd, order);
1903
			if (ret < 0) {
1904 1905 1906
				dev_err(card->dev,
					"ASoC: failed to instantiate card %d\n",
					ret);
1907 1908 1909 1910 1911
				goto probe_dai_err;
			}
		}
	}

1912 1913 1914 1915 1916
	/* probe auxiliary components */
	ret = soc_probe_aux_devices(card);
	if (ret < 0)
		goto probe_dai_err;

1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931
	/* 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;
	}

1932 1933 1934
	/* probe all DAI links on this card */
	for (order = SND_SOC_COMP_ORDER_FIRST; order <= SND_SOC_COMP_ORDER_LAST;
			order++) {
1935 1936
		list_for_each_entry(rtd, &card->rtd_list, list) {
			ret = soc_probe_link_dais(card, rtd, order);
1937
			if (ret < 0) {
1938 1939 1940
				dev_err(card->dev,
					"ASoC: failed to instantiate card %d\n",
					ret);
1941 1942
				goto probe_dai_err;
			}
1943 1944
		}
	}
Frank Mandarino's avatar
Frank Mandarino committed
1945

1946
	snd_soc_dapm_link_dai_widgets(card);
1947
	snd_soc_dapm_connect_dai_link_widgets(card);
1948

1949
	if (card->controls)
1950
		snd_soc_add_card_controls(card, card->controls, card->num_controls);
1951

1952 1953 1954 1955
	if (card->dapm_routes)
		snd_soc_dapm_add_routes(&card->dapm, card->dapm_routes,
					card->num_dapm_routes);

1956 1957 1958
	if (card->of_dapm_routes)
		snd_soc_dapm_add_routes(&card->dapm, card->of_dapm_routes,
					card->num_of_dapm_routes);
1959

1960 1961 1962
	/* try to set some sane longname if DMI is available */
	snd_soc_set_dmi_name(card, NULL);

1963 1964
	snprintf(card->snd_card->shortname, sizeof(card->snd_card->shortname),
		 "%s", card->name);
1965 1966
	snprintf(card->snd_card->longname, sizeof(card->snd_card->longname),
		 "%s", card->long_name ? card->long_name : card->name);
1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980
	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;
		}
	}
1981

1982 1983 1984
	if (card->late_probe) {
		ret = card->late_probe(card);
		if (ret < 0) {
1985
			dev_err(card->dev, "ASoC: %s late_probe() failed: %d\n",
1986 1987 1988 1989 1990
				card->name, ret);
			goto probe_aux_dev_err;
		}
	}

1991
	snd_soc_dapm_new_widgets(card);
1992

1993 1994
	ret = snd_card_register(card->snd_card);
	if (ret < 0) {
1995 1996
		dev_err(card->dev, "ASoC: failed to register soundcard %d\n",
				ret);
1997
		goto probe_aux_dev_err;
Frank Mandarino's avatar
Frank Mandarino committed
1998 1999
	}

2000
	card->instantiated = 1;
2001
	snd_soc_dapm_sync(&card->dapm);
2002
	mutex_unlock(&card->mutex);
2003
	mutex_unlock(&client_mutex);
2004 2005

	return 0;
2006

2007
probe_aux_dev_err:
2008
	soc_remove_aux_devices(card);
2009

2010
probe_dai_err:
2011
	soc_remove_dai_links(card);
2012 2013

card_probe_error:
2014
	if (card->remove)
2015
		card->remove(card);
2016

2017
	snd_soc_dapm_free(&card->dapm);
2018
	soc_cleanup_card_debugfs(card);
2019 2020
	snd_card_free(card->snd_card);

2021
base_error:
2022
	soc_remove_pcm_runtimes(card);
2023
	mutex_unlock(&card->mutex);
2024
	mutex_unlock(&client_mutex);
Frank Mandarino's avatar
Frank Mandarino committed
2025

2026
	return ret;
2027 2028 2029 2030 2031
}

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

2034 2035 2036 2037 2038 2039 2040
	/*
	 * no card, so machine driver should be registering card
	 * we should not be here in that case so ret error
	 */
	if (!card)
		return -EINVAL;

2041
	dev_warn(&pdev->dev,
2042
		 "ASoC: machine %s should use snd_soc_register_card()\n",
2043 2044
		 card->name);

2045 2046
	/* Bodge while we unpick instantiation */
	card->dev = &pdev->dev;
2047

2048
	return snd_soc_register_card(card);
Frank Mandarino's avatar
Frank Mandarino committed
2049 2050
}

2051
static int soc_cleanup_card_resources(struct snd_soc_card *card)
Frank Mandarino's avatar
Frank Mandarino committed
2052
{
2053
	struct snd_soc_pcm_runtime *rtd;
Frank Mandarino's avatar
Frank Mandarino committed
2054

2055
	/* make sure any delayed work runs */
2056
	list_for_each_entry(rtd, &card->rtd_list, list)
2057
		flush_delayed_work(&rtd->delayed_work);
2058

2059 2060 2061
	/* free the ALSA card at first; this syncs with pending operations */
	snd_card_free(card->snd_card);

2062
	/* remove and free each DAI */
2063
	soc_remove_dai_links(card);
2064
	soc_remove_pcm_runtimes(card);
2065

2066 2067 2068
	/* remove auxiliary devices */
	soc_remove_aux_devices(card);

2069
	snd_soc_dapm_free(&card->dapm);
2070
	soc_cleanup_card_debugfs(card);
2071

2072 2073
	/* remove the card */
	if (card->remove)
2074
		card->remove(card);
2075

2076 2077 2078 2079 2080 2081 2082
	return 0;
}

/* removes a socdev */
static int soc_remove(struct platform_device *pdev)
{
	struct snd_soc_card *card = platform_get_drvdata(pdev);
Frank Mandarino's avatar
Frank Mandarino committed
2083

Mark Brown's avatar
Mark Brown committed
2084
	snd_soc_unregister_card(card);
Frank Mandarino's avatar
Frank Mandarino committed
2085 2086 2087
	return 0;
}

2088
int snd_soc_poweroff(struct device *dev)
Mark Brown's avatar
Mark Brown committed
2089
{
2090
	struct snd_soc_card *card = dev_get_drvdata(dev);
2091
	struct snd_soc_pcm_runtime *rtd;
Mark Brown's avatar
Mark Brown committed
2092 2093

	if (!card->instantiated)
Mark Brown's avatar
Mark Brown committed
2094
		return 0;
Mark Brown's avatar
Mark Brown committed
2095 2096 2097

	/* Flush out pmdown_time work - we actually do want to run it
	 * now, we're shutting down so no imminent restart. */
2098
	list_for_each_entry(rtd, &card->rtd_list, list)
2099
		flush_delayed_work(&rtd->delayed_work);
Mark Brown's avatar
Mark Brown committed
2100

2101
	snd_soc_dapm_shutdown(card);
Mark Brown's avatar
Mark Brown committed
2102

2103
	/* deactivate pins to sleep state */
2104
	list_for_each_entry(rtd, &card->rtd_list, list) {
2105
		struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
2106
		int i;
2107

2108
		pinctrl_pm_select_sleep_state(cpu_dai->dev);
2109 2110
		for (i = 0; i < rtd->num_codecs; i++) {
			struct snd_soc_dai *codec_dai = rtd->codec_dais[i];
2111 2112
			pinctrl_pm_select_sleep_state(codec_dai->dev);
		}
2113 2114
	}

Mark Brown's avatar
Mark Brown committed
2115
	return 0;
Mark Brown's avatar
Mark Brown committed
2116
}
2117
EXPORT_SYMBOL_GPL(snd_soc_poweroff);
Mark Brown's avatar
Mark Brown committed
2118

2119
const struct dev_pm_ops snd_soc_pm_ops = {
2120 2121 2122 2123
	.suspend = snd_soc_suspend,
	.resume = snd_soc_resume,
	.freeze = snd_soc_suspend,
	.thaw = snd_soc_resume,
2124
	.poweroff = snd_soc_poweroff,
2125
	.restore = snd_soc_resume,
Mark Brown's avatar
Mark Brown committed
2126
};
2127
EXPORT_SYMBOL_GPL(snd_soc_pm_ops);
Mark Brown's avatar
Mark Brown committed
2128

Frank Mandarino's avatar
Frank Mandarino committed
2129 2130 2131 2132
/* ASoC platform driver */
static struct platform_driver soc_driver = {
	.driver		= {
		.name		= "soc-audio",
2133
		.pm		= &snd_soc_pm_ops,
Frank Mandarino's avatar
Frank Mandarino committed
2134 2135 2136 2137 2138 2139 2140 2141 2142
	},
	.probe		= soc_probe,
	.remove		= soc_remove,
};

/**
 * snd_soc_cnew - create new control
 * @_template: control template
 * @data: control private data
2143
 * @long_name: control long name
2144
 * @prefix: control name prefix
Frank Mandarino's avatar
Frank Mandarino committed
2145 2146 2147 2148 2149 2150
 *
 * 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,
2151
				  void *data, const char *long_name,
2152
				  const char *prefix)
Frank Mandarino's avatar
Frank Mandarino committed
2153 2154
{
	struct snd_kcontrol_new template;
2155 2156
	struct snd_kcontrol *kcontrol;
	char *name = NULL;
Frank Mandarino's avatar
Frank Mandarino committed
2157 2158 2159 2160

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

2161 2162 2163 2164
	if (!long_name)
		long_name = template.name;

	if (prefix) {
2165
		name = kasprintf(GFP_KERNEL, "%s %s", prefix, long_name);
2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178
		if (!name)
			return NULL;

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

	kcontrol = snd_ctl_new1(&template, data);

	kfree(name);

	return kcontrol;
Frank Mandarino's avatar
Frank Mandarino committed
2179 2180 2181
}
EXPORT_SYMBOL_GPL(snd_soc_cnew);

2182 2183 2184 2185 2186 2187 2188 2189 2190 2191 2192
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) {
2193 2194
			dev_err(dev, "ASoC: Failed to add %s: %d\n",
				control->name, err);
2195 2196 2197 2198 2199 2200 2201
			return err;
		}
	}

	return 0;
}

2202 2203 2204 2205 2206 2207 2208 2209 2210 2211 2212 2213 2214 2215 2216 2217
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);

2218 2219 2220 2221 2222 2223 2224 2225 2226 2227 2228 2229 2230 2231 2232 2233 2234 2235 2236
/**
 * 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);

2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 2253 2254 2255 2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2267 2268 2269
/**
 * 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)
{
2270
	struct snd_card *card = dai->component->card->snd_card;
2271 2272 2273 2274 2275 2276

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

2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287 2288
/**
 * 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)
{
2289
	if (dai->driver->ops->set_sysclk)
2290
		return dai->driver->ops->set_sysclk(dai, clk_id, freq, dir);
2291 2292 2293

	return snd_soc_component_set_sysclk(dai->component, clk_id, 0,
					    freq, dir);
2294 2295 2296
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_sysclk);

2297 2298 2299 2300 2301 2302 2303 2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 2317
/**
 * snd_soc_component_set_sysclk - configure COMPONENT system or master clock.
 * @component: COMPONENT
 * @clk_id: DAI specific clock ID
 * @source: Source for the clock
 * @freq: new clock frequency in Hz
 * @dir: new clock direction - input/output.
 *
 * Configures the CODEC master (MCLK) or system (SYSCLK) clocking.
 */
int snd_soc_component_set_sysclk(struct snd_soc_component *component, int clk_id,
			     int source, unsigned int freq, int dir)
{
	if (component->driver->set_sysclk)
		return component->driver->set_sysclk(component, clk_id, source,
						 freq, dir);

	return -ENOTSUPP;
}
EXPORT_SYMBOL_GPL(snd_soc_component_set_sysclk);

2318 2319 2320
/**
 * snd_soc_dai_set_clkdiv - configure DAI clock dividers.
 * @dai: DAI
2321
 * @div_id: DAI specific clock divider ID
2322 2323 2324 2325 2326 2327 2328 2329 2330
 * @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)
{
2331
	if (dai->driver->ops->set_clkdiv)
2332
		return dai->driver->ops->set_clkdiv(dai, div_id, div);
2333 2334 2335 2336 2337 2338 2339 2340 2341
	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
2342
 * @source: DAI specific source for the PLL
2343 2344 2345 2346 2347
 * @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.
 */
2348 2349
int snd_soc_dai_set_pll(struct snd_soc_dai *dai, int pll_id, int source,
	unsigned int freq_in, unsigned int freq_out)
2350
{
2351
	if (dai->driver->ops->set_pll)
2352
		return dai->driver->ops->set_pll(dai, pll_id, source,
2353
					 freq_in, freq_out);
2354 2355 2356

	return snd_soc_component_set_pll(dai->component, pll_id, source,
					 freq_in, freq_out);
2357 2358 2359
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_pll);

2360 2361 2362 2363 2364 2365 2366 2367 2368 2369 2370 2371 2372 2373 2374 2375 2376 2377 2378 2379 2380 2381
/*
 * snd_soc_component_set_pll - configure component PLL.
 * @component: COMPONENT
 * @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_component_set_pll(struct snd_soc_component *component, int pll_id,
			      int source, unsigned int freq_in,
			      unsigned int freq_out)
{
	if (component->driver->set_pll)
		return component->driver->set_pll(component, pll_id, source,
					      freq_in, freq_out);

	return -EINVAL;
}
EXPORT_SYMBOL_GPL(snd_soc_component_set_pll);

2382 2383 2384
/**
 * snd_soc_dai_set_bclk_ratio - configure BCLK to sample rate ratio.
 * @dai: DAI
2385
 * @ratio: Ratio of BCLK to Sample rate.
2386 2387 2388 2389 2390
 *
 * 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)
{
2391
	if (dai->driver->ops->set_bclk_ratio)
2392 2393 2394 2395 2396 2397
		return dai->driver->ops->set_bclk_ratio(dai, ratio);
	else
		return -EINVAL;
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_bclk_ratio);

2398 2399 2400
/**
 * snd_soc_dai_set_fmt - configure DAI hardware audio format.
 * @dai: DAI
2401
 * @fmt: SND_SOC_DAIFMT_* format value.
2402 2403 2404 2405 2406
 *
 * Configures the DAI hardware format and clocking.
 */
int snd_soc_dai_set_fmt(struct snd_soc_dai *dai, unsigned int fmt)
{
2407
	if (dai->driver == NULL)
2408
		return -EINVAL;
2409 2410 2411
	if (dai->driver->ops->set_fmt == NULL)
		return -ENOTSUPP;
	return dai->driver->ops->set_fmt(dai, fmt);
2412 2413 2414
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_fmt);

2415
/**
2416
 * snd_soc_xlate_tdm_slot - generate tx/rx slot mask.
2417 2418 2419 2420 2421 2422
 * @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.
 */
2423
static int snd_soc_xlate_tdm_slot_mask(unsigned int slots,
2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434 2435 2436 2437 2438
					  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;
}

2439
/**
2440 2441
 * snd_soc_dai_set_tdm_slot() - Configures a DAI for TDM operation
 * @dai: The DAI to configure
2442 2443
 * @tx_mask: bitmask representing active TX slots.
 * @rx_mask: bitmask representing active RX slots.
2444
 * @slots: Number of slots in use.
2445
 * @slot_width: Width in bits for each slot.
2446
 *
2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460
 * 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.
2461 2462
 */
int snd_soc_dai_set_tdm_slot(struct snd_soc_dai *dai,
2463
	unsigned int tx_mask, unsigned int rx_mask, int slots, int slot_width)
2464
{
2465
	if (dai->driver->ops->xlate_tdm_slot_mask)
2466
		dai->driver->ops->xlate_tdm_slot_mask(slots,
2467 2468
						&tx_mask, &rx_mask);
	else
2469
		snd_soc_xlate_tdm_slot_mask(slots, &tx_mask, &rx_mask);
2470

2471 2472 2473
	dai->tx_mask = tx_mask;
	dai->rx_mask = rx_mask;

2474
	if (dai->driver->ops->set_tdm_slot)
2475
		return dai->driver->ops->set_tdm_slot(dai, tx_mask, rx_mask,
2476
				slots, slot_width);
2477
	else
2478
		return -ENOTSUPP;
2479 2480 2481
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_tdm_slot);

2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 2496 2497
/**
 * 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)
{
2498
	if (dai->driver->ops->set_channel_map)
2499
		return dai->driver->ops->set_channel_map(dai, tx_num, tx_slot,
2500 2501 2502 2503 2504 2505
			rx_num, rx_slot);
	else
		return -EINVAL;
}
EXPORT_SYMBOL_GPL(snd_soc_dai_set_channel_map);

2506 2507 2508 2509 2510 2511 2512 2513 2514
/**
 * 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)
{
2515
	if (dai->driver->ops->set_tristate)
2516
		return dai->driver->ops->set_tristate(dai, tristate);
2517 2518 2519 2520 2521 2522 2523 2524 2525
	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
2526
 * @direction: stream to mute
2527 2528 2529
 *
 * Mutes the DAI DAC.
 */
2530 2531
int snd_soc_dai_digital_mute(struct snd_soc_dai *dai, int mute,
			     int direction)
2532
{
2533 2534 2535 2536 2537 2538 2539
	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)
2540
		return dai->driver->ops->digital_mute(dai, mute);
2541
	else
2542
		return -ENOTSUPP;
2543 2544 2545
}
EXPORT_SYMBOL_GPL(snd_soc_dai_digital_mute);

Mark Brown's avatar
Mark Brown committed
2546 2547 2548
/**
 * snd_soc_register_card - Register a card with the ASoC core
 *
2549
 * @card: Card to register
Mark Brown's avatar
Mark Brown committed
2550 2551
 *
 */
2552
int snd_soc_register_card(struct snd_soc_card *card)
Mark Brown's avatar
Mark Brown committed
2553
{
2554
	int i, ret;
2555
	struct snd_soc_pcm_runtime *rtd;
2556

Mark Brown's avatar
Mark Brown committed
2557 2558 2559
	if (!card->name || !card->dev)
		return -EINVAL;

2560 2561 2562
	for (i = 0; i < card->num_links; i++) {
		struct snd_soc_dai_link *link = &card->dai_link[i];

2563
		ret = soc_init_dai_link(card, link);
2564
		if (ret) {
2565
			dev_err(card->dev, "ASoC: failed to init link %s\n",
2566
				link->name);
2567
			return ret;
2568 2569 2570
		}
	}

2571 2572
	dev_set_drvdata(card->dev, card);

2573 2574
	snd_soc_initialize_card_lists(card);

2575 2576 2577
	INIT_LIST_HEAD(&card->dai_link_list);
	card->num_dai_links = 0;

2578 2579 2580
	INIT_LIST_HEAD(&card->rtd_list);
	card->num_rtd = 0;

2581
	INIT_LIST_HEAD(&card->dapm_dirty);
2582
	INIT_LIST_HEAD(&card->dobj_list);
Mark Brown's avatar
Mark Brown committed
2583
	card->instantiated = 0;
2584
	mutex_init(&card->mutex);
2585
	mutex_init(&card->dapm_mutex);
Mark Brown's avatar
Mark Brown committed
2586

2587 2588
	ret = snd_soc_instantiate_card(card);
	if (ret != 0)
2589
		return ret;
Mark Brown's avatar
Mark Brown committed
2590

2591
	/* deactivate pins to sleep state */
2592
	list_for_each_entry(rtd, &card->rtd_list, list)  {
2593 2594 2595 2596 2597 2598 2599 2600 2601
		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);
		}

2602 2603 2604 2605
		if (!cpu_dai->active)
			pinctrl_pm_select_sleep_state(cpu_dai->dev);
	}

2606
	return ret;
Mark Brown's avatar
Mark Brown committed
2607
}
2608
EXPORT_SYMBOL_GPL(snd_soc_register_card);
Mark Brown's avatar
Mark Brown committed
2609 2610 2611 2612

/**
 * snd_soc_unregister_card - Unregister a card with the ASoC core
 *
2613
 * @card: Card to unregister
Mark Brown's avatar
Mark Brown committed
2614 2615
 *
 */
2616
int snd_soc_unregister_card(struct snd_soc_card *card)
Mark Brown's avatar
Mark Brown committed
2617
{
2618 2619
	if (card->instantiated) {
		card->instantiated = false;
2620
		snd_soc_dapm_shutdown(card);
2621
		soc_cleanup_card_resources(card);
2622
		dev_dbg(card->dev, "ASoC: Unregistered card '%s'\n", card->name);
2623
	}
Mark Brown's avatar
Mark Brown committed
2624 2625 2626

	return 0;
}
2627
EXPORT_SYMBOL_GPL(snd_soc_unregister_card);
Mark Brown's avatar
Mark Brown committed
2628

2629 2630 2631 2632
/*
 * Simplify DAI link configuration by removing ".-1" from device names
 * and sanitizing names.
 */
2633
static char *fmt_single_name(struct device *dev, int *id)
2634 2635 2636 2637 2638 2639 2640
{
	char *found, name[NAME_SIZE];
	int id1, id2;

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

2641
	strlcpy(name, dev_name(dev), NAME_SIZE);
2642 2643 2644 2645 2646 2647 2648 2649 2650 2651 2652 2653 2654 2655 2656 2657 2658 2659

	/* 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 */
2660
			*id = ((id1 & 0xffff) << 16) + id2;
2661 2662 2663

			/* sanitize component name for DAI link creation */
			snprintf(tmp, NAME_SIZE, "%s.%s", dev->driver->name, name);
2664
			strlcpy(name, tmp, NAME_SIZE);
2665 2666 2667 2668 2669 2670 2671 2672 2673 2674 2675 2676 2677 2678 2679
		} 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) {
2680 2681 2682
		dev_err(dev,
			"ASoC: error - multiple DAI %s registered with no name\n",
			dev_name(dev));
2683 2684 2685 2686 2687 2688
		return NULL;
	}

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

Mark Brown's avatar
Mark Brown committed
2689
/**
2690
 * snd_soc_unregister_dai - Unregister DAIs from the ASoC core
Mark Brown's avatar
Mark Brown committed
2691
 *
2692
 * @component: The component for which the DAIs should be unregistered
Mark Brown's avatar
Mark Brown committed
2693
 */
2694
static void snd_soc_unregister_dais(struct snd_soc_component *component)
Mark Brown's avatar
Mark Brown committed
2695
{
2696
	struct snd_soc_dai *dai, *_dai;
Mark Brown's avatar
Mark Brown committed
2697

2698
	list_for_each_entry_safe(dai, _dai, &component->dai_list, list) {
2699 2700
		dev_dbg(component->dev, "ASoC: Unregistered DAI '%s'\n",
			dai->name);
2701
		list_del(&dai->list);
2702
		kfree(dai->name);
2703 2704
		kfree(dai);
	}
Mark Brown's avatar
Mark Brown committed
2705 2706
}

2707 2708 2709 2710 2711 2712 2713 2714 2715 2716 2717 2718 2719 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729 2730 2731 2732 2733 2734 2735 2736 2737 2738 2739 2740 2741 2742 2743 2744 2745 2746 2747 2748 2749
/* 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;

2750
	list_add_tail(&dai->list, &component->dai_list);
2751 2752 2753 2754 2755 2756
	component->num_dai++;

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

Mark Brown's avatar
Mark Brown committed
2757
/**
2758
 * snd_soc_register_dais - Register a DAI with the ASoC core
Mark Brown's avatar
Mark Brown committed
2759
 *
2760 2761
 * @component: The component the DAIs are registered for
 * @dai_drv: DAI driver to use for the DAIs
2762
 * @count: Number of DAIs
2763 2764
 * @legacy_dai_naming: Use the legacy naming scheme and let the DAI inherit the
 *                     parent's name.
Mark Brown's avatar
Mark Brown committed
2765
 */
2766
static int snd_soc_register_dais(struct snd_soc_component *component,
2767 2768
	struct snd_soc_dai_driver *dai_drv, size_t count,
	bool legacy_dai_naming)
Mark Brown's avatar
Mark Brown committed
2769
{
2770
	struct device *dev = component->dev;
2771
	struct snd_soc_dai *dai;
2772 2773
	unsigned int i;
	int ret;
2774

2775
	dev_dbg(dev, "ASoC: dai register %s #%zu\n", dev_name(dev), count);
Mark Brown's avatar
Mark Brown committed
2776 2777

	for (i = 0; i < count; i++) {
2778

2779 2780
		dai = soc_add_dai(component, dai_drv + i,
				count == 1 && legacy_dai_naming);
2781 2782 2783 2784
		if (dai == NULL) {
			ret = -ENOMEM;
			goto err;
		}
Mark Brown's avatar
Mark Brown committed
2785
	}
2786

Mark Brown's avatar
Mark Brown committed
2787
	return 0;
2788

Mark Brown's avatar
Mark Brown committed
2789
err:
2790
	snd_soc_unregister_dais(component);
2791

Mark Brown's avatar
Mark Brown committed
2792 2793 2794
	return ret;
}

2795 2796 2797 2798 2799 2800 2801 2802 2803 2804 2805 2806 2807 2808 2809 2810 2811
/**
 * 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;
2812

2813 2814 2815 2816
	if (dai_drv->dobj.type != SND_SOC_DOBJ_PCM) {
		dev_err(component->dev, "Invalid dai type %d\n",
			dai_drv->dobj.type);
		return -EINVAL;
Mark Brown's avatar
Mark Brown committed
2817 2818
	}

2819 2820 2821 2822
	lockdep_assert_held(&client_mutex);
	dai = soc_add_dai(component, dai_drv, false);
	if (!dai)
		return -ENOMEM;
Mark Brown's avatar
Mark Brown committed
2823

2824 2825 2826 2827 2828 2829 2830 2831
	/* 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);
	}
Mark Brown's avatar
Mark Brown committed
2832 2833 2834

	return ret;
}
2835
EXPORT_SYMBOL_GPL(snd_soc_register_dai);
Mark Brown's avatar
Mark Brown committed
2836

2837 2838
static void snd_soc_component_seq_notifier(struct snd_soc_dapm_context *dapm,
	enum snd_soc_dapm_type type, int subseq)
2839
{
2840
	struct snd_soc_component *component = dapm->component;
2841

2842 2843
	component->driver->seq_notifier(component, type, subseq);
}
2844

2845 2846 2847 2848
static int snd_soc_component_stream_event(struct snd_soc_dapm_context *dapm,
	int event)
{
	struct snd_soc_component *component = dapm->component;
2849

2850 2851
	return component->driver->stream_event(component, event);
}
2852

2853 2854 2855 2856 2857 2858 2859 2860
static int snd_soc_component_set_bias_level(struct snd_soc_dapm_context *dapm,
					enum snd_soc_bias_level level)
{
	struct snd_soc_component *component = dapm->component;

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

2861 2862
static int snd_soc_component_initialize(struct snd_soc_component *component,
	const struct snd_soc_component_driver *driver, struct device *dev)
2863
{
2864 2865
	struct snd_soc_dapm_context *dapm;

2866 2867 2868
	component->name = fmt_single_name(dev, &component->id);
	if (!component->name) {
		dev_err(dev, "ASoC: Failed to allocate name\n");
2869 2870 2871
		return -ENOMEM;
	}

2872 2873
	component->dev = dev;
	component->driver = driver;
2874

2875
	dapm = snd_soc_component_get_dapm(component);
2876 2877 2878
	dapm->dev = dev;
	dapm->component = component;
	dapm->bias_level = SND_SOC_BIAS_OFF;
2879 2880
	dapm->idle_bias_off = !driver->idle_bias_on;
	dapm->suspend_bias_off = driver->suspend_bias_off;
2881 2882 2883 2884
	if (driver->seq_notifier)
		dapm->seq_notifier = snd_soc_component_seq_notifier;
	if (driver->stream_event)
		dapm->stream_event = snd_soc_component_stream_event;
2885 2886
	if (driver->set_bias_level)
		dapm->set_bias_level = snd_soc_component_set_bias_level;
2887

2888 2889
	INIT_LIST_HEAD(&component->dai_list);
	mutex_init(&component->io_mutex);
2890

2891 2892
	return 0;
}
2893

2894
static void snd_soc_component_setup_regmap(struct snd_soc_component *component)
2895
{
2896 2897 2898 2899 2900 2901 2902
	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;
}

2903 2904
#ifdef CONFIG_REGMAP

2905 2906 2907 2908 2909 2910 2911 2912 2913 2914 2915 2916 2917 2918 2919
/**
 * 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);
2920
}
2921 2922 2923 2924 2925 2926 2927 2928 2929 2930 2931 2932 2933 2934 2935 2936 2937 2938
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);
2939

2940
#endif
2941

2942 2943
static void snd_soc_component_add_unlocked(struct snd_soc_component *component)
{
2944
	if (!component->driver->write && !component->driver->read) {
2945 2946 2947 2948 2949
		if (!component->regmap)
			component->regmap = dev_get_regmap(component->dev, NULL);
		if (component->regmap)
			snd_soc_component_setup_regmap(component);
	}
2950

2951
	list_add(&component->list, &component_list);
2952
	INIT_LIST_HEAD(&component->dobj_list);
2953
}
2954

2955 2956
static void snd_soc_component_add(struct snd_soc_component *component)
{
2957
	mutex_lock(&client_mutex);
2958
	snd_soc_component_add_unlocked(component);
2959
	mutex_unlock(&client_mutex);
2960
}
2961

2962 2963 2964 2965 2966
static void snd_soc_component_cleanup(struct snd_soc_component *component)
{
	snd_soc_unregister_dais(component);
	kfree(component->name);
}
2967

2968 2969
static void snd_soc_component_del_unlocked(struct snd_soc_component *component)
{
2970 2971 2972 2973 2974
	struct snd_soc_card *card = component->card;

	if (card)
		snd_soc_unregister_card(card);

2975 2976
	list_del(&component->list);
}
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
#define ENDIANNESS_MAP(name) \
	(SNDRV_PCM_FMTBIT_##name##LE | SNDRV_PCM_FMTBIT_##name##BE)
static u64 endianness_format_map[] = {
	ENDIANNESS_MAP(S16_),
	ENDIANNESS_MAP(U16_),
	ENDIANNESS_MAP(S24_),
	ENDIANNESS_MAP(U24_),
	ENDIANNESS_MAP(S32_),
	ENDIANNESS_MAP(U32_),
	ENDIANNESS_MAP(S24_3),
	ENDIANNESS_MAP(U24_3),
	ENDIANNESS_MAP(S20_3),
	ENDIANNESS_MAP(U20_3),
	ENDIANNESS_MAP(S18_3),
	ENDIANNESS_MAP(U18_3),
	ENDIANNESS_MAP(FLOAT_),
	ENDIANNESS_MAP(FLOAT64_),
	ENDIANNESS_MAP(IEC958_SUBFRAME_),
};

/*
 * 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 convert_endianness_formats(struct snd_soc_pcm_stream *stream)
{
	int i;

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

3013 3014 3015 3016 3017
int snd_soc_add_component(struct device *dev,
			struct snd_soc_component *component,
			const struct snd_soc_component_driver *component_driver,
			struct snd_soc_dai_driver *dai_drv,
			int num_dai)
3018
{
3019
	int ret;
3020
	int i;
3021

3022
	ret = snd_soc_component_initialize(component, component_driver, dev);
3023 3024 3025
	if (ret)
		goto err_free;

3026 3027 3028 3029 3030 3031 3032
	if (component_driver->endianness) {
		for (i = 0; i < num_dai; i++) {
			convert_endianness_formats(&dai_drv[i].playback);
			convert_endianness_formats(&dai_drv[i].capture);
		}
	}

3033 3034
	ret = snd_soc_register_dais(component, dai_drv, num_dai,
				    !component_driver->non_legacy_dai_naming);
3035
	if (ret < 0) {
3036
		dev_err(dev, "ASoC: Failed to register DAIs: %d\n", ret);
3037 3038
		goto err_cleanup;
	}
3039

3040
	snd_soc_component_add(component);
3041

3042
	return 0;
3043

3044
err_cleanup:
3045
	snd_soc_component_cleanup(component);
3046 3047
err_free:
	return ret;
3048
}
3049 3050 3051 3052 3053 3054 3055 3056 3057
EXPORT_SYMBOL_GPL(snd_soc_add_component);

int snd_soc_register_component(struct device *dev,
			const struct snd_soc_component_driver *component_driver,
			struct snd_soc_dai_driver *dai_drv,
			int num_dai)
{
	struct snd_soc_component *component;

3058
	component = devm_kzalloc(dev, sizeof(*component), GFP_KERNEL);
3059
	if (!component)
3060 3061 3062 3063 3064
		return -ENOMEM;

	return snd_soc_add_component(dev, component, component_driver,
				     dai_drv, num_dai);
}
3065
EXPORT_SYMBOL_GPL(snd_soc_register_component);
3066

3067
/**
3068 3069
 * snd_soc_unregister_component - Unregister all related component
 * from the ASoC core
3070
 *
3071
 * @dev: The device to unregister
3072
 */
3073
static int __snd_soc_unregister_component(struct device *dev)
3074
{
3075
	struct snd_soc_component *component;
3076
	int found = 0;
3077

3078
	mutex_lock(&client_mutex);
3079
	list_for_each_entry(component, &component_list, list) {
3080
		if (dev != component->dev)
3081 3082 3083 3084 3085 3086
			continue;

		snd_soc_tplg_component_remove(component, SND_SOC_TPLG_INDEX_ALL);
		snd_soc_component_del_unlocked(component);
		found = 1;
		break;
3087
	}
3088
	mutex_unlock(&client_mutex);
3089

3090 3091 3092
	if (found) {
		snd_soc_component_cleanup(component);
	}
3093 3094 3095 3096 3097 3098 3099

	return found;
}

void snd_soc_unregister_component(struct device *dev)
{
	while (__snd_soc_unregister_component(dev));
3100 3101 3102
}
EXPORT_SYMBOL_GPL(snd_soc_unregister_component);

3103 3104 3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128
struct snd_soc_component *snd_soc_lookup_component(struct device *dev,
						   const char *driver_name)
{
	struct snd_soc_component *component;
	struct snd_soc_component *ret;

	ret = NULL;
	mutex_lock(&client_mutex);
	list_for_each_entry(component, &component_list, list) {
		if (dev != component->dev)
			continue;

		if (driver_name &&
		    (driver_name != component->driver->name) &&
		    (strcmp(component->driver->name, driver_name) != 0))
			continue;

		ret = component;
		break;
	}
	mutex_unlock(&client_mutex);

	return ret;
}
EXPORT_SYMBOL_GPL(snd_soc_lookup_component);

3129
/* Retrieve a card's name from device tree */
3130 3131
int snd_soc_of_parse_card_name(struct snd_soc_card *card,
			       const char *propname)
3132
{
3133
	struct device_node *np;
3134 3135
	int ret;

3136 3137 3138 3139 3140
	if (!card->dev) {
		pr_err("card->dev is not set before calling %s\n", __func__);
		return -EINVAL;
	}

3141
	np = card->dev->of_node;
3142

3143 3144 3145 3146 3147 3148 3149 3150
	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,
3151
			"ASoC: Property '%s' could not be read: %d\n",
3152 3153 3154 3155 3156 3157
			propname, ret);
		return ret;
	}

	return 0;
}
3158
EXPORT_SYMBOL_GPL(snd_soc_of_parse_card_name);
3159

3160 3161 3162 3163 3164 3165 3166
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),
};

3167
int snd_soc_of_parse_audio_simple_widgets(struct snd_soc_card *card,
3168 3169
					  const char *propname)
{
3170
	struct device_node *np = card->dev->of_node;
3171 3172 3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230 3231 3232 3233 3234 3235 3236 3237 3238 3239
	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;
	}

3240 3241
	card->of_dapm_widgets = widgets;
	card->num_of_dapm_widgets = num_widgets;
3242 3243 3244

	return 0;
}
3245
EXPORT_SYMBOL_GPL(snd_soc_of_parse_audio_simple_widgets);
3246

3247 3248 3249 3250 3251
static int snd_soc_of_get_slot_mask(struct device_node *np,
				    const char *prop_name,
				    unsigned int *mask)
{
	u32 val;
3252
	const __be32 *of_slot_mask = of_get_property(np, prop_name, &val);
3253 3254 3255 3256 3257 3258 3259 3260 3261 3262 3263 3264
	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;
}

3265
int snd_soc_of_parse_tdm_slot(struct device_node *np,
3266 3267
			      unsigned int *tx_mask,
			      unsigned int *rx_mask,
3268 3269 3270 3271 3272 3273
			      unsigned int *slots,
			      unsigned int *slot_width)
{
	u32 val;
	int ret;

3274 3275 3276 3277 3278
	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);

3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296 3297 3298 3299 3300
	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);

3301
void snd_soc_of_parse_audio_prefix(struct snd_soc_card *card,
3302 3303 3304 3305
				   struct snd_soc_codec_conf *codec_conf,
				   struct device_node *of_node,
				   const char *propname)
{
3306
	struct device_node *np = card->dev->of_node;
3307 3308 3309 3310 3311 3312 3313 3314 3315 3316 3317 3318
	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;
}
3319
EXPORT_SYMBOL_GPL(snd_soc_of_parse_audio_prefix);
3320

3321
int snd_soc_of_parse_audio_routing(struct snd_soc_card *card,
3322 3323
				   const char *propname)
{
3324
	struct device_node *np = card->dev->of_node;
3325
	int num_routes;
3326 3327 3328 3329
	struct snd_soc_dapm_route *routes;
	int i, ret;

	num_routes = of_property_count_strings(np, propname);
3330
	if (num_routes < 0 || num_routes & 1) {
3331 3332 3333
		dev_err(card->dev,
			"ASoC: Property '%s' does not exist or its length is not even\n",
			propname);
3334 3335 3336 3337
		return -EINVAL;
	}
	num_routes /= 2;
	if (!num_routes) {
3338
		dev_err(card->dev, "ASoC: Property '%s's length is zero\n",
3339 3340 3341 3342
			propname);
		return -EINVAL;
	}

3343
	routes = devm_kzalloc(card->dev, num_routes * sizeof(*routes),
3344 3345 3346
			      GFP_KERNEL);
	if (!routes) {
		dev_err(card->dev,
3347
			"ASoC: Could not allocate DAPM route table\n");
3348 3349 3350 3351 3352
		return -EINVAL;
	}

	for (i = 0; i < num_routes; i++) {
		ret = of_property_read_string_index(np, propname,
3353
			2 * i, &routes[i].sink);
3354
		if (ret) {
3355 3356 3357
			dev_err(card->dev,
				"ASoC: Property '%s' index %d could not be read: %d\n",
				propname, 2 * i, ret);
3358 3359 3360
			return -EINVAL;
		}
		ret = of_property_read_string_index(np, propname,
3361
			(2 * i) + 1, &routes[i].source);
3362 3363
		if (ret) {
			dev_err(card->dev,
3364 3365
				"ASoC: Property '%s' index %d could not be read: %d\n",
				propname, (2 * i) + 1, ret);
3366 3367 3368 3369
			return -EINVAL;
		}
	}

3370 3371
	card->num_of_dapm_routes = num_routes;
	card->of_dapm_routes = routes;
3372 3373 3374

	return 0;
}
3375
EXPORT_SYMBOL_GPL(snd_soc_of_parse_audio_routing);
3376

3377
unsigned int snd_soc_of_parse_daifmt(struct device_node *np,
3378 3379 3380
				     const char *prefix,
				     struct device_node **bitclkmaster,
				     struct device_node **framemaster)
3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405
{
	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 = "";

	/*
3406 3407
	 * check "dai-format = xxx"
	 * or    "[prefix]format = xxx"
3408 3409
	 * SND_SOC_DAIFMT_FORMAT_MASK area
	 */
3410 3411 3412 3413 3414
	ret = of_property_read_string(np, "dai-format", &str);
	if (ret < 0) {
		snprintf(prop, sizeof(prop), "%sformat", prefix);
		ret = of_property_read_string(np, prop, &str);
	}
3415 3416 3417 3418 3419 3420 3421 3422 3423 3424
	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;
			}
		}
	}

	/*
3425
	 * check "[prefix]continuous-clock"
3426 3427
	 * SND_SOC_DAIFMT_CLOCK_MASK area
	 */
3428
	snprintf(prop, sizeof(prop), "%scontinuous-clock", prefix);
3429
	if (of_property_read_bool(np, prop))
3430 3431 3432
		format |= SND_SOC_DAIFMT_CONT;
	else
		format |= SND_SOC_DAIFMT_GATED;
3433 3434 3435 3436 3437 3438 3439 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449 3450 3451 3452 3453 3454 3455 3456 3457 3458 3459 3460 3461 3462 3463 3464 3465 3466

	/*
	 * 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);
3467 3468
	if (bit && bitclkmaster)
		*bitclkmaster = of_parse_phandle(np, prop, 0);
3469 3470 3471

	snprintf(prop, sizeof(prop), "%sframe-master", prefix);
	frame = !!of_get_property(np, prop, NULL);
3472 3473
	if (frame && framemaster)
		*framemaster = of_parse_phandle(np, prop, 0);
3474 3475 3476 3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487 3488 3489 3490 3491 3492 3493

	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);

3494 3495 3496 3497 3498 3499 3500 3501 3502 3503 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514 3515 3516 3517 3518 3519 3520 3521 3522 3523 3524 3525
int snd_soc_get_dai_id(struct device_node *ep)
{
	struct snd_soc_component *pos;
	struct device_node *node;
	int ret;

	node = of_graph_get_port_parent(ep);

	/*
	 * For example HDMI case, HDMI has video/sound port,
	 * but ALSA SoC needs sound port number only.
	 * Thus counting HDMI DT port/endpoint doesn't work.
	 * Then, it should have .of_xlate_dai_id
	 */
	ret = -ENOTSUPP;
	mutex_lock(&client_mutex);
	list_for_each_entry(pos, &component_list, list) {
		struct device_node *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 != node)
			continue;

		if (pos->driver->of_xlate_dai_id)
			ret = pos->driver->of_xlate_dai_id(pos, ep);

		break;
	}
	mutex_unlock(&client_mutex);

3526 3527
	of_node_put(node);

3528 3529 3530 3531
	return ret;
}
EXPORT_SYMBOL_GPL(snd_soc_get_dai_id);

3532
int snd_soc_get_dai_name(struct of_phandle_args *args,
3533
				const char **dai_name)
3534 3535
{
	struct snd_soc_component *pos;
3536
	struct device_node *component_of_node;
3537
	int ret = -EPROBE_DEFER;
3538 3539 3540

	mutex_lock(&client_mutex);
	list_for_each_entry(pos, &component_list, list) {
3541 3542 3543 3544 3545
		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)
3546 3547
			continue;

3548
		if (pos->driver->of_xlate_dai_name) {
3549 3550 3551
			ret = pos->driver->of_xlate_dai_name(pos,
							     args,
							     dai_name);
3552
		} else {
3553
			struct snd_soc_dai *dai;
3554 3555
			int id = -1;

3556
			switch (args->args_count) {
3557 3558 3559 3560
			case 0:
				id = 0; /* same as dai_drv[0] */
				break;
			case 1:
3561
				id = args->args[0];
3562 3563 3564 3565 3566 3567 3568 3569
				break;
			default:
				/* not supported */
				break;
			}

			if (id < 0 || id >= pos->num_dai) {
				ret = -EINVAL;
3570
				continue;
3571
			}
3572 3573 3574

			ret = 0;

3575 3576 3577 3578 3579 3580 3581 3582
			/* find target DAI */
			list_for_each_entry(dai, &pos->dai_list, list) {
				if (id == 0)
					break;
				id--;
			}

			*dai_name = dai->driver->name;
3583 3584
			if (!*dai_name)
				*dai_name = pos->name;
3585 3586 3587 3588 3589
		}

		break;
	}
	mutex_unlock(&client_mutex);
3590 3591
	return ret;
}
3592
EXPORT_SYMBOL_GPL(snd_soc_get_dai_name);
3593 3594 3595 3596 3597 3598 3599 3600 3601 3602 3603 3604 3605

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);
3606 3607 3608 3609 3610 3611 3612

	of_node_put(args.np);

	return ret;
}
EXPORT_SYMBOL_GPL(snd_soc_of_get_dai_name);

3613 3614 3615 3616 3617 3618 3619 3620 3621 3622 3623 3624 3625 3626 3627 3628 3629 3630 3631 3632
/*
 * snd_soc_of_put_dai_link_codecs - Dereference device nodes in the codecs array
 * @dai_link: DAI link
 *
 * Dereference device nodes acquired by snd_soc_of_get_dai_link_codecs().
 */
void snd_soc_of_put_dai_link_codecs(struct snd_soc_dai_link *dai_link)
{
	struct snd_soc_dai_link_component *component = dai_link->codecs;
	int index;

	for (index = 0; index < dai_link->num_codecs; index++, component++) {
		if (!component->of_node)
			break;
		of_node_put(component->of_node);
		component->of_node = NULL;
	}
}
EXPORT_SYMBOL_GPL(snd_soc_of_put_dai_link_codecs);

3633 3634 3635 3636 3637 3638 3639 3640 3641
/*
 * 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.
3642 3643
 * The device nodes in the array (of_node) must be dereferenced by calling
 * snd_soc_of_put_dai_link_codecs() on @dai_link.
3644 3645 3646 3647 3648 3649 3650 3651 3652 3653 3654 3655 3656 3657 3658 3659 3660 3661 3662 3663 3664 3665 3666 3667 3668 3669 3670 3671 3672 3673 3674 3675 3676 3677 3678 3679 3680 3681 3682 3683 3684 3685 3686 3687 3688 3689 3690
 *
 * 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:
3691
	snd_soc_of_put_dai_link_codecs(dai_link);
3692 3693 3694 3695 3696 3697
	dai_link->codecs = NULL;
	dai_link->num_codecs = 0;
	return ret;
}
EXPORT_SYMBOL_GPL(snd_soc_of_get_dai_link_codecs);

3698
static int __init snd_soc_init(void)
Frank Mandarino's avatar
Frank Mandarino committed
3699
{
3700
	snd_soc_debugfs_init();
3701 3702
	snd_soc_util_init();

Frank Mandarino's avatar
Frank Mandarino committed
3703 3704
	return platform_driver_register(&soc_driver);
}
3705
module_init(snd_soc_init);
Frank Mandarino's avatar
Frank Mandarino committed
3706

3707
static void __exit snd_soc_exit(void)
Frank Mandarino's avatar
Frank Mandarino committed
3708
{
3709
	snd_soc_util_exit();
3710
	snd_soc_debugfs_exit();
3711

3712
	platform_driver_unregister(&soc_driver);
Frank Mandarino's avatar
Frank Mandarino committed
3713 3714 3715 3716
}
module_exit(snd_soc_exit);

/* Module information */
3717
MODULE_AUTHOR("Liam Girdwood, lrg@slimlogic.co.uk");
Frank Mandarino's avatar
Frank Mandarino committed
3718 3719
MODULE_DESCRIPTION("ALSA SoC Core");
MODULE_LICENSE("GPL");
3720
MODULE_ALIAS("platform:soc-audio");