xref: /linux/sound/soc/generic/simple-card.c (revision b6ebbac51bedf9e98e837688bc838f400196da5e)
1 /*
2  * ASoC simple sound card support
3  *
4  * Copyright (C) 2012 Renesas Solutions Corp.
5  * Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License version 2 as
9  * published by the Free Software Foundation.
10  */
11 #include <linux/clk.h>
12 #include <linux/device.h>
13 #include <linux/gpio.h>
14 #include <linux/module.h>
15 #include <linux/of.h>
16 #include <linux/of_gpio.h>
17 #include <linux/platform_device.h>
18 #include <linux/string.h>
19 #include <sound/jack.h>
20 #include <sound/simple_card.h>
21 #include <sound/soc-dai.h>
22 #include <sound/soc.h>
23 
24 struct asoc_simple_jack {
25 	struct snd_soc_jack jack;
26 	struct snd_soc_jack_pin pin;
27 	struct snd_soc_jack_gpio gpio;
28 };
29 
30 struct simple_card_data {
31 	struct snd_soc_card snd_card;
32 	struct simple_dai_props {
33 		struct asoc_simple_dai cpu_dai;
34 		struct asoc_simple_dai codec_dai;
35 		unsigned int mclk_fs;
36 	} *dai_props;
37 	unsigned int mclk_fs;
38 	struct asoc_simple_jack hp_jack;
39 	struct asoc_simple_jack mic_jack;
40 	struct snd_soc_dai_link dai_link[];	/* dynamically allocated */
41 };
42 
43 #define simple_priv_to_dev(priv) ((priv)->snd_card.dev)
44 #define simple_priv_to_link(priv, i) ((priv)->snd_card.dai_link + i)
45 #define simple_priv_to_props(priv, i) ((priv)->dai_props + i)
46 
47 #define PREFIX	"simple-audio-card,"
48 
49 #define asoc_simple_card_init_hp(card, sjack, prefix)\
50 	asoc_simple_card_init_jack(card, sjack, 1, prefix)
51 #define asoc_simple_card_init_mic(card, sjack, prefix)\
52 	asoc_simple_card_init_jack(card, sjack, 0, prefix)
53 static int asoc_simple_card_init_jack(struct snd_soc_card *card,
54 				      struct asoc_simple_jack *sjack,
55 				      int is_hp, char *prefix)
56 {
57 	struct device *dev = card->dev;
58 	enum of_gpio_flags flags;
59 	char prop[128];
60 	char *pin_name;
61 	char *gpio_name;
62 	int mask;
63 	int det;
64 
65 	sjack->gpio.gpio = -ENOENT;
66 
67 	if (is_hp) {
68 		snprintf(prop, sizeof(prop), "%shp-det-gpio", prefix);
69 		pin_name	= "Headphones";
70 		gpio_name	= "Headphone detection";
71 		mask		= SND_JACK_HEADPHONE;
72 	} else {
73 		snprintf(prop, sizeof(prop), "%smic-det-gpio", prefix);
74 		pin_name	= "Mic Jack";
75 		gpio_name	= "Mic detection";
76 		mask		= SND_JACK_MICROPHONE;
77 	}
78 
79 	det = of_get_named_gpio_flags(dev->of_node, prop, 0, &flags);
80 	if (det == -EPROBE_DEFER)
81 		return -EPROBE_DEFER;
82 
83 	if (gpio_is_valid(det)) {
84 		sjack->pin.pin		= pin_name;
85 		sjack->pin.mask		= mask;
86 
87 		sjack->gpio.name	= gpio_name;
88 		sjack->gpio.report	= mask;
89 		sjack->gpio.gpio	= det;
90 		sjack->gpio.invert	= !!(flags & OF_GPIO_ACTIVE_LOW);
91 		sjack->gpio.debounce_time = 150;
92 
93 		snd_soc_card_jack_new(card, pin_name, mask,
94 				      &sjack->jack,
95 				      &sjack->pin, 1);
96 
97 		snd_soc_jack_add_gpios(&sjack->jack, 1,
98 				       &sjack->gpio);
99 	}
100 
101 	return 0;
102 }
103 
104 static void asoc_simple_card_remove_jack(struct asoc_simple_jack *sjack)
105 {
106 	if (gpio_is_valid(sjack->gpio.gpio))
107 		snd_soc_jack_free_gpios(&sjack->jack, 1, &sjack->gpio);
108 }
109 
110 static int asoc_simple_card_startup(struct snd_pcm_substream *substream)
111 {
112 	struct snd_soc_pcm_runtime *rtd = substream->private_data;
113 	struct simple_card_data *priv =	snd_soc_card_get_drvdata(rtd->card);
114 	struct simple_dai_props *dai_props =
115 		&priv->dai_props[rtd->num];
116 	int ret;
117 
118 	ret = clk_prepare_enable(dai_props->cpu_dai.clk);
119 	if (ret)
120 		return ret;
121 
122 	ret = clk_prepare_enable(dai_props->codec_dai.clk);
123 	if (ret)
124 		clk_disable_unprepare(dai_props->cpu_dai.clk);
125 
126 	return ret;
127 }
128 
129 static void asoc_simple_card_shutdown(struct snd_pcm_substream *substream)
130 {
131 	struct snd_soc_pcm_runtime *rtd = substream->private_data;
132 	struct simple_card_data *priv =	snd_soc_card_get_drvdata(rtd->card);
133 	struct simple_dai_props *dai_props =
134 		&priv->dai_props[rtd->num];
135 
136 	clk_disable_unprepare(dai_props->cpu_dai.clk);
137 
138 	clk_disable_unprepare(dai_props->codec_dai.clk);
139 }
140 
141 static int asoc_simple_card_hw_params(struct snd_pcm_substream *substream,
142 				      struct snd_pcm_hw_params *params)
143 {
144 	struct snd_soc_pcm_runtime *rtd = substream->private_data;
145 	struct snd_soc_dai *codec_dai = rtd->codec_dai;
146 	struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
147 	struct simple_card_data *priv = snd_soc_card_get_drvdata(rtd->card);
148 	struct simple_dai_props *dai_props = &priv->dai_props[rtd->num];
149 	unsigned int mclk, mclk_fs = 0;
150 	int ret = 0;
151 
152 	if (priv->mclk_fs)
153 		mclk_fs = priv->mclk_fs;
154 	else if (dai_props->mclk_fs)
155 		mclk_fs = dai_props->mclk_fs;
156 
157 	if (mclk_fs) {
158 		mclk = params_rate(params) * mclk_fs;
159 		ret = snd_soc_dai_set_sysclk(codec_dai, 0, mclk,
160 					     SND_SOC_CLOCK_IN);
161 		if (ret && ret != -ENOTSUPP)
162 			goto err;
163 
164 		ret = snd_soc_dai_set_sysclk(cpu_dai, 0, mclk,
165 					     SND_SOC_CLOCK_OUT);
166 		if (ret && ret != -ENOTSUPP)
167 			goto err;
168 	}
169 	return 0;
170 err:
171 	return ret;
172 }
173 
174 static struct snd_soc_ops asoc_simple_card_ops = {
175 	.startup = asoc_simple_card_startup,
176 	.shutdown = asoc_simple_card_shutdown,
177 	.hw_params = asoc_simple_card_hw_params,
178 };
179 
180 static int __asoc_simple_card_dai_init(struct snd_soc_dai *dai,
181 				       struct asoc_simple_dai *set)
182 {
183 	int ret;
184 
185 	if (set->sysclk) {
186 		ret = snd_soc_dai_set_sysclk(dai, 0, set->sysclk, 0);
187 		if (ret && ret != -ENOTSUPP) {
188 			dev_err(dai->dev, "simple-card: set_sysclk error\n");
189 			goto err;
190 		}
191 	}
192 
193 	if (set->slots) {
194 		ret = snd_soc_dai_set_tdm_slot(dai,
195 					       set->tx_slot_mask,
196 					       set->rx_slot_mask,
197 						set->slots,
198 						set->slot_width);
199 		if (ret && ret != -ENOTSUPP) {
200 			dev_err(dai->dev, "simple-card: set_tdm_slot error\n");
201 			goto err;
202 		}
203 	}
204 
205 	ret = 0;
206 
207 err:
208 	return ret;
209 }
210 
211 static int asoc_simple_card_dai_init(struct snd_soc_pcm_runtime *rtd)
212 {
213 	struct simple_card_data *priv =	snd_soc_card_get_drvdata(rtd->card);
214 	struct snd_soc_dai *codec = rtd->codec_dai;
215 	struct snd_soc_dai *cpu = rtd->cpu_dai;
216 	struct simple_dai_props *dai_props;
217 	int ret;
218 
219 	dai_props = &priv->dai_props[rtd->num];
220 	ret = __asoc_simple_card_dai_init(codec, &dai_props->codec_dai);
221 	if (ret < 0)
222 		return ret;
223 
224 	ret = __asoc_simple_card_dai_init(cpu, &dai_props->cpu_dai);
225 	if (ret < 0)
226 		return ret;
227 
228 	ret = asoc_simple_card_init_hp(rtd->card, &priv->hp_jack, PREFIX);
229 	if (ret < 0)
230 		return ret;
231 
232 	ret = asoc_simple_card_init_mic(rtd->card, &priv->hp_jack, PREFIX);
233 	if (ret < 0)
234 		return ret;
235 
236 	return 0;
237 }
238 
239 static int
240 asoc_simple_card_sub_parse_of(struct device_node *np,
241 			      struct asoc_simple_dai *dai,
242 			      struct device_node **p_node,
243 			      const char **name,
244 			      int *args_count)
245 {
246 	struct of_phandle_args args;
247 	struct clk *clk;
248 	u32 val;
249 	int ret;
250 
251 	if (!np)
252 		return 0;
253 
254 	/*
255 	 * Get node via "sound-dai = <&phandle port>"
256 	 * it will be used as xxx_of_node on soc_bind_dai_link()
257 	 */
258 	ret = of_parse_phandle_with_args(np, "sound-dai",
259 					 "#sound-dai-cells", 0, &args);
260 	if (ret)
261 		return ret;
262 
263 	*p_node = args.np;
264 
265 	if (args_count)
266 		*args_count = args.args_count;
267 
268 	/* Get dai->name */
269 	if (name) {
270 		ret = snd_soc_of_get_dai_name(np, name);
271 		if (ret < 0)
272 			return ret;
273 	}
274 
275 	if (!dai)
276 		return 0;
277 
278 	/* Parse TDM slot */
279 	ret = snd_soc_of_parse_tdm_slot(np, &dai->tx_slot_mask,
280 					&dai->rx_slot_mask,
281 					&dai->slots, &dai->slot_width);
282 	if (ret)
283 		return ret;
284 
285 	/*
286 	 * Parse dai->sysclk come from "clocks = <&xxx>"
287 	 * (if system has common clock)
288 	 *  or "system-clock-frequency = <xxx>"
289 	 *  or device's module clock.
290 	 */
291 	if (of_property_read_bool(np, "clocks")) {
292 		clk = of_clk_get(np, 0);
293 		if (IS_ERR(clk)) {
294 			ret = PTR_ERR(clk);
295 			return ret;
296 		}
297 
298 		dai->sysclk = clk_get_rate(clk);
299 		dai->clk = clk;
300 	} else if (!of_property_read_u32(np, "system-clock-frequency", &val)) {
301 		dai->sysclk = val;
302 	} else {
303 		clk = of_clk_get(args.np, 0);
304 		if (!IS_ERR(clk))
305 			dai->sysclk = clk_get_rate(clk);
306 	}
307 
308 	return 0;
309 }
310 
311 static int asoc_simple_card_dai_link_of(struct device_node *node,
312 					struct simple_card_data *priv,
313 					int idx,
314 					bool is_top_level_node)
315 {
316 	struct device *dev = simple_priv_to_dev(priv);
317 	struct snd_soc_dai_link *dai_link = simple_priv_to_link(priv, idx);
318 	struct simple_dai_props *dai_props = simple_priv_to_props(priv, idx);
319 	struct device_node *cpu = NULL;
320 	struct device_node *plat = NULL;
321 	struct device_node *codec = NULL;
322 	char prop[128];
323 	char *prefix = "";
324 	int ret, cpu_args;
325 	u32 val;
326 
327 	/* For single DAI link & old style of DT node */
328 	if (is_top_level_node)
329 		prefix = PREFIX;
330 
331 	snprintf(prop, sizeof(prop), "%scpu", prefix);
332 	cpu = of_get_child_by_name(node, prop);
333 
334 	snprintf(prop, sizeof(prop), "%splat", prefix);
335 	plat = of_get_child_by_name(node, prop);
336 
337 	snprintf(prop, sizeof(prop), "%scodec", prefix);
338 	codec = of_get_child_by_name(node, prop);
339 
340 	if (!cpu || !codec) {
341 		ret = -EINVAL;
342 		dev_err(dev, "%s: Can't find %s DT node\n", __func__, prop);
343 		goto dai_link_of_err;
344 	}
345 
346 	ret = asoc_simple_card_parse_daifmt(dev, node, codec,
347 					    prefix, &dai_link->dai_fmt);
348 	if (ret < 0)
349 		goto dai_link_of_err;
350 
351 	if (!of_property_read_u32(node, "mclk-fs", &val))
352 		dai_props->mclk_fs = val;
353 
354 	ret = asoc_simple_card_sub_parse_of(cpu, &dai_props->cpu_dai,
355 					    &dai_link->cpu_of_node,
356 					    &dai_link->cpu_dai_name,
357 					    &cpu_args);
358 	if (ret < 0)
359 		goto dai_link_of_err;
360 
361 	ret = asoc_simple_card_sub_parse_of(codec, &dai_props->codec_dai,
362 					    &dai_link->codec_of_node,
363 					    &dai_link->codec_dai_name, NULL);
364 	if (ret < 0)
365 		goto dai_link_of_err;
366 
367 	ret = asoc_simple_card_sub_parse_of(plat, NULL,
368 					    &dai_link->platform_of_node,
369 					    NULL, NULL);
370 	if (ret < 0)
371 		goto dai_link_of_err;
372 
373 	if (!dai_link->cpu_dai_name || !dai_link->codec_dai_name) {
374 		ret = -EINVAL;
375 		goto dai_link_of_err;
376 	}
377 
378 	/* Assumes platform == cpu */
379 	if (!dai_link->platform_of_node)
380 		dai_link->platform_of_node = dai_link->cpu_of_node;
381 
382 	ret = asoc_simple_card_set_dailink_name(dev, dai_link,
383 						"%s-%s",
384 						dai_link->cpu_dai_name,
385 						dai_link->codec_dai_name);
386 	if (ret < 0)
387 		goto dai_link_of_err;
388 
389 	dai_link->ops = &asoc_simple_card_ops;
390 	dai_link->init = asoc_simple_card_dai_init;
391 
392 	dev_dbg(dev, "\tname : %s\n", dai_link->stream_name);
393 	dev_dbg(dev, "\tformat : %04x\n", dai_link->dai_fmt);
394 	dev_dbg(dev, "\tcpu : %s / %d\n",
395 		dai_link->cpu_dai_name,
396 		dai_props->cpu_dai.sysclk);
397 	dev_dbg(dev, "\tcodec : %s / %d\n",
398 		dai_link->codec_dai_name,
399 		dai_props->codec_dai.sysclk);
400 
401 	/*
402 	 * In soc_bind_dai_link() will check cpu name after
403 	 * of_node matching if dai_link has cpu_dai_name.
404 	 * but, it will never match if name was created by
405 	 * fmt_single_name() remove cpu_dai_name if cpu_args
406 	 * was 0. See:
407 	 *	fmt_single_name()
408 	 *	fmt_multiple_name()
409 	 */
410 	if (!cpu_args)
411 		dai_link->cpu_dai_name = NULL;
412 
413 dai_link_of_err:
414 	of_node_put(cpu);
415 	of_node_put(codec);
416 
417 	return ret;
418 }
419 
420 static int asoc_simple_card_parse_of(struct device_node *node,
421 				     struct simple_card_data *priv)
422 {
423 	struct device *dev = simple_priv_to_dev(priv);
424 	u32 val;
425 	int ret;
426 
427 	if (!node)
428 		return -EINVAL;
429 
430 	/* The off-codec widgets */
431 	if (of_property_read_bool(node, PREFIX "widgets")) {
432 		ret = snd_soc_of_parse_audio_simple_widgets(&priv->snd_card,
433 					PREFIX "widgets");
434 		if (ret)
435 			return ret;
436 	}
437 
438 	/* DAPM routes */
439 	if (of_property_read_bool(node, PREFIX "routing")) {
440 		ret = snd_soc_of_parse_audio_routing(&priv->snd_card,
441 					PREFIX "routing");
442 		if (ret)
443 			return ret;
444 	}
445 
446 	/* Factor to mclk, used in hw_params() */
447 	ret = of_property_read_u32(node, PREFIX "mclk-fs", &val);
448 	if (ret == 0)
449 		priv->mclk_fs = val;
450 
451 	/* Single/Muti DAI link(s) & New style of DT node */
452 	if (of_get_child_by_name(node, PREFIX "dai-link")) {
453 		struct device_node *np = NULL;
454 		int i = 0;
455 
456 		for_each_child_of_node(node, np) {
457 			dev_dbg(dev, "\tlink %d:\n", i);
458 			ret = asoc_simple_card_dai_link_of(np, priv,
459 							   i, false);
460 			if (ret < 0) {
461 				of_node_put(np);
462 				return ret;
463 			}
464 			i++;
465 		}
466 	} else {
467 		/* For single DAI link & old style of DT node */
468 		ret = asoc_simple_card_dai_link_of(node, priv, 0, true);
469 		if (ret < 0)
470 			return ret;
471 	}
472 
473 	ret = asoc_simple_card_parse_card_name(&priv->snd_card, PREFIX);
474 	if (ret)
475 		return ret;
476 
477 	return 0;
478 }
479 
480 /* Decrease the reference count of the device nodes */
481 static int asoc_simple_card_unref(struct snd_soc_card *card)
482 {
483 	struct snd_soc_dai_link *dai_link;
484 	int num_links;
485 
486 	for (num_links = 0, dai_link = card->dai_link;
487 	     num_links < card->num_links;
488 	     num_links++, dai_link++) {
489 		of_node_put(dai_link->cpu_of_node);
490 		of_node_put(dai_link->codec_of_node);
491 	}
492 	return 0;
493 }
494 
495 static int asoc_simple_card_probe(struct platform_device *pdev)
496 {
497 	struct simple_card_data *priv;
498 	struct snd_soc_dai_link *dai_link;
499 	struct device_node *np = pdev->dev.of_node;
500 	struct device *dev = &pdev->dev;
501 	int num_links, ret;
502 
503 	/* Get the number of DAI links */
504 	if (np && of_get_child_by_name(np, PREFIX "dai-link"))
505 		num_links = of_get_child_count(np);
506 	else
507 		num_links = 1;
508 
509 	/* Allocate the private data and the DAI link array */
510 	priv = devm_kzalloc(dev,
511 			sizeof(*priv) + sizeof(*dai_link) * num_links,
512 			GFP_KERNEL);
513 	if (!priv)
514 		return -ENOMEM;
515 
516 	/* Init snd_soc_card */
517 	priv->snd_card.owner = THIS_MODULE;
518 	priv->snd_card.dev = dev;
519 	dai_link = priv->dai_link;
520 	priv->snd_card.dai_link = dai_link;
521 	priv->snd_card.num_links = num_links;
522 
523 	/* Get room for the other properties */
524 	priv->dai_props = devm_kzalloc(dev,
525 			sizeof(*priv->dai_props) * num_links,
526 			GFP_KERNEL);
527 	if (!priv->dai_props)
528 		return -ENOMEM;
529 
530 	if (np && of_device_is_available(np)) {
531 
532 		ret = asoc_simple_card_parse_of(np, priv);
533 		if (ret < 0) {
534 			if (ret != -EPROBE_DEFER)
535 				dev_err(dev, "parse error %d\n", ret);
536 			goto err;
537 		}
538 
539 	} else {
540 		struct asoc_simple_card_info *cinfo;
541 
542 		cinfo = dev->platform_data;
543 		if (!cinfo) {
544 			dev_err(dev, "no info for asoc-simple-card\n");
545 			return -EINVAL;
546 		}
547 
548 		if (!cinfo->name ||
549 		    !cinfo->codec_dai.name ||
550 		    !cinfo->codec ||
551 		    !cinfo->platform ||
552 		    !cinfo->cpu_dai.name) {
553 			dev_err(dev, "insufficient asoc_simple_card_info settings\n");
554 			return -EINVAL;
555 		}
556 
557 		priv->snd_card.name	= (cinfo->card) ? cinfo->card : cinfo->name;
558 		dai_link->name		= cinfo->name;
559 		dai_link->stream_name	= cinfo->name;
560 		dai_link->platform_name	= cinfo->platform;
561 		dai_link->codec_name	= cinfo->codec;
562 		dai_link->cpu_dai_name	= cinfo->cpu_dai.name;
563 		dai_link->codec_dai_name = cinfo->codec_dai.name;
564 		dai_link->dai_fmt	= cinfo->daifmt;
565 		dai_link->init		= asoc_simple_card_dai_init;
566 		memcpy(&priv->dai_props->cpu_dai, &cinfo->cpu_dai,
567 					sizeof(priv->dai_props->cpu_dai));
568 		memcpy(&priv->dai_props->codec_dai, &cinfo->codec_dai,
569 					sizeof(priv->dai_props->codec_dai));
570 
571 	}
572 
573 	snd_soc_card_set_drvdata(&priv->snd_card, priv);
574 
575 	ret = devm_snd_soc_register_card(&pdev->dev, &priv->snd_card);
576 	if (ret >= 0)
577 		return ret;
578 
579 err:
580 	asoc_simple_card_unref(&priv->snd_card);
581 	return ret;
582 }
583 
584 static int asoc_simple_card_remove(struct platform_device *pdev)
585 {
586 	struct snd_soc_card *card = platform_get_drvdata(pdev);
587 	struct simple_card_data *priv = snd_soc_card_get_drvdata(card);
588 
589 	asoc_simple_card_remove_jack(&priv->hp_jack);
590 	asoc_simple_card_remove_jack(&priv->mic_jack);
591 
592 	return asoc_simple_card_unref(card);
593 }
594 
595 static const struct of_device_id asoc_simple_of_match[] = {
596 	{ .compatible = "simple-audio-card", },
597 	{},
598 };
599 MODULE_DEVICE_TABLE(of, asoc_simple_of_match);
600 
601 static struct platform_driver asoc_simple_card = {
602 	.driver = {
603 		.name = "asoc-simple-card",
604 		.pm = &snd_soc_pm_ops,
605 		.of_match_table = asoc_simple_of_match,
606 	},
607 	.probe = asoc_simple_card_probe,
608 	.remove = asoc_simple_card_remove,
609 };
610 
611 module_platform_driver(asoc_simple_card);
612 
613 MODULE_ALIAS("platform:asoc-simple-card");
614 MODULE_LICENSE("GPL");
615 MODULE_DESCRIPTION("ASoC Simple Sound Card");
616 MODULE_AUTHOR("Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>");
617