1 // SPDX-License-Identifier: GPL-2.0
3 // ASoC audio graph sound card support
5 // Copyright (C) 2016 Renesas Solutions Corp.
6 // Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
8 // based on ${LINUX}/sound/soc/generic/simple-card.c
10 #include <linux/clk.h>
11 #include <linux/device.h>
12 #include <linux/gpio.h>
13 #include <linux/gpio/consumer.h>
14 #include <linux/module.h>
16 #include <linux/of_device.h>
17 #include <linux/of_gpio.h>
18 #include <linux/of_graph.h>
19 #include <linux/platform_device.h>
20 #include <linux/string.h>
21 #include <sound/graph_card.h>
23 #define DPCM_SELECTABLE 1
25 #define PREFIX "audio-graph-card,"
27 static int graph_outdrv_event(struct snd_soc_dapm_widget *w,
28 struct snd_kcontrol *kcontrol,
31 struct snd_soc_dapm_context *dapm = w->dapm;
32 struct asoc_simple_priv *priv = snd_soc_card_get_drvdata(dapm->card);
35 case SND_SOC_DAPM_POST_PMU:
36 gpiod_set_value_cansleep(priv->pa_gpio, 1);
38 case SND_SOC_DAPM_PRE_PMD:
39 gpiod_set_value_cansleep(priv->pa_gpio, 0);
48 static const struct snd_soc_dapm_widget graph_dapm_widgets[] = {
49 SND_SOC_DAPM_OUT_DRV_E("Amplifier", SND_SOC_NOPM,
50 0, 0, NULL, 0, graph_outdrv_event,
51 SND_SOC_DAPM_POST_PMU | SND_SOC_DAPM_PRE_PMD),
54 static const struct snd_soc_ops graph_ops = {
55 .startup = asoc_simple_startup,
56 .shutdown = asoc_simple_shutdown,
57 .hw_params = asoc_simple_hw_params,
60 static int graph_get_dai_id(struct device_node *ep)
62 struct device_node *node;
63 struct device_node *endpoint;
64 struct of_endpoint info;
69 /* use driver specified DAI ID if exist */
70 ret = snd_soc_get_dai_id(ep);
74 /* use endpoint/port reg if exist */
75 ret = of_graph_parse_endpoint(ep, &info);
78 * Because it will count port/endpoint if it doesn't have "reg".
79 * But, we can't judge whether it has "no reg", or "reg = <0>"
80 * only of_graph_parse_endpoint().
81 * We need to check "reg" property
83 if (of_get_property(ep, "reg", NULL))
86 node = of_get_parent(ep);
87 reg = of_get_property(node, "reg", NULL);
92 node = of_graph_get_port_parent(ep);
95 * Non HDMI sound case, counting port/endpoint on its DT
96 * is enough. Let's count it.
100 for_each_endpoint_of_node(node, endpoint) {
114 static bool soc_component_is_pcm(struct snd_soc_dai_link_component *dlc)
116 struct snd_soc_dai *dai = snd_soc_find_dai_with_mutex(dlc);
118 if (dai && (dai->component->driver->pcm_construct ||
119 dai->driver->pcm_new))
125 static int asoc_simple_parse_dai(struct device_node *ep,
126 struct snd_soc_dai_link_component *dlc,
129 struct device_node *node;
130 struct of_phandle_args args;
136 node = of_graph_get_port_parent(ep);
140 args.args[0] = graph_get_dai_id(ep);
141 args.args_count = (of_graph_get_endpoint_count(node) > 1);
146 * Here, dlc->dai_name is pointer to CPU/Codec DAI name.
147 * If user unbinded CPU or Codec driver, but not for Sound Card,
148 * dlc->dai_name is keeping unbinded CPU or Codec
151 * If user re-bind CPU or Codec driver again, ALSA SoC will try
152 * to rebind Card via snd_soc_try_rebind_card(), but because of
153 * above reason, it might can't bind Sound Card.
154 * Because Sound Card is pointing to released dai_name pointer.
156 * To avoid this rebind Card issue,
157 * 1) It needs to alloc memory to keep dai_name eventhough
158 * CPU or Codec driver was unbinded, or
159 * 2) user need to rebind Sound Card everytime
160 * if he unbinded CPU or Codec.
162 ret = snd_soc_get_dai_name(&args, &dlc->dai_name);
169 *is_single_link = of_graph_get_endpoint_count(node) == 1;
174 static void graph_parse_convert(struct device *dev,
175 struct device_node *ep,
176 struct asoc_simple_data *adata)
178 struct device_node *top = dev->of_node;
179 struct device_node *port = of_get_parent(ep);
180 struct device_node *ports = of_get_parent(port);
181 struct device_node *node = of_graph_get_port_parent(ep);
183 asoc_simple_parse_convert(dev, top, NULL, adata);
184 asoc_simple_parse_convert(dev, node, PREFIX, adata);
185 asoc_simple_parse_convert(dev, ports, NULL, adata);
186 asoc_simple_parse_convert(dev, port, NULL, adata);
187 asoc_simple_parse_convert(dev, ep, NULL, adata);
194 static void graph_parse_mclk_fs(struct device_node *top,
195 struct device_node *ep,
196 struct simple_dai_props *props)
198 struct device_node *port = of_get_parent(ep);
199 struct device_node *ports = of_get_parent(port);
200 struct device_node *node = of_graph_get_port_parent(ep);
202 of_property_read_u32(top, "mclk-fs", &props->mclk_fs);
203 of_property_read_u32(ports, "mclk-fs", &props->mclk_fs);
204 of_property_read_u32(port, "mclk-fs", &props->mclk_fs);
205 of_property_read_u32(ep, "mclk-fs", &props->mclk_fs);
212 static int graph_dai_link_of_dpcm(struct asoc_simple_priv *priv,
213 struct device_node *cpu_ep,
214 struct device_node *codec_ep,
215 struct link_info *li)
217 struct device *dev = simple_priv_to_dev(priv);
218 struct snd_soc_card *card = simple_priv_to_card(priv);
219 struct snd_soc_dai_link *dai_link = simple_priv_to_link(priv, li->link);
220 struct simple_dai_props *dai_props = simple_priv_to_props(priv, li->link);
221 struct device_node *top = dev->of_node;
222 struct device_node *ep = li->cpu ? cpu_ep : codec_ep;
223 struct device_node *port;
224 struct device_node *ports;
225 struct device_node *node;
226 struct asoc_simple_dai *dai;
227 struct snd_soc_dai_link_component *cpus = dai_link->cpus;
228 struct snd_soc_dai_link_component *codecs = dai_link->codecs;
231 port = of_get_parent(ep);
232 ports = of_get_parent(port);
233 node = of_graph_get_port_parent(ep);
237 dev_dbg(dev, "link_of DPCM (%pOF)\n", ep);
240 int is_single_links = 0;
243 codecs->of_node = NULL;
244 codecs->dai_name = "snd-soc-dummy-dai";
245 codecs->name = "snd-soc-dummy";
248 dai_link->dynamic = 1;
249 dai_link->dpcm_merged_format = 1;
252 dai_props->cpu_dai = &priv->dais[li->dais++];
254 ret = asoc_simple_parse_cpu(ep, dai_link, &is_single_links);
258 ret = asoc_simple_parse_clk_cpu(dev, ep, dai_link, dai);
262 ret = asoc_simple_set_dailink_name(dev, dai_link,
270 * In BE<->BE connections it is not required to create
271 * PCM devices at CPU end of the dai link and thus 'no_pcm'
272 * flag needs to be set. It is useful when there are many
273 * BE components and some of these have to be connected to
274 * form a valid audio path.
276 * For example: FE <-> BE1 <-> BE2 <-> ... <-> BEn where
277 * there are 'n' BE components in the path.
279 if (card->component_chaining && !soc_component_is_pcm(cpus))
280 dai_link->no_pcm = 1;
282 /* card->num_links includes Codec */
283 asoc_simple_canonicalize_cpu(dai_link, is_single_links);
285 struct snd_soc_codec_conf *cconf;
288 cpus->of_node = NULL;
289 cpus->dai_name = "snd-soc-dummy-dai";
290 cpus->name = "snd-soc-dummy";
293 dai_link->no_pcm = 1;
294 dai_link->be_hw_params_fixup = asoc_simple_be_hw_params_fixup;
297 dai_props->codec_dai = &priv->dais[li->dais++];
300 dai_props->codec_conf = &priv->codec_conf[li->conf++];
302 ret = asoc_simple_parse_codec(ep, dai_link);
306 ret = asoc_simple_parse_clk_codec(dev, ep, dai_link, dai);
310 ret = asoc_simple_set_dailink_name(dev, dai_link,
317 /* check "prefix" from top node */
318 snd_soc_of_parse_node_prefix(top, cconf, codecs->of_node,
320 snd_soc_of_parse_node_prefix(node, cconf, codecs->of_node,
322 snd_soc_of_parse_node_prefix(ports, cconf, codecs->of_node,
324 snd_soc_of_parse_node_prefix(port, cconf, codecs->of_node,
328 graph_parse_convert(dev, ep, &dai_props->adata);
329 graph_parse_mclk_fs(top, ep, dai_props);
331 asoc_simple_canonicalize_platform(dai_link);
333 ret = asoc_simple_parse_tdm(ep, dai);
337 ret = asoc_simple_parse_daifmt(dev, cpu_ep, codec_ep,
338 NULL, &dai_link->dai_fmt);
342 snd_soc_dai_link_set_capabilities(dai_link);
344 dai_link->ops = &graph_ops;
346 /* Use custom snd_soc_ops callbacks if available */
348 dai_link->ops = priv->ops;
350 dai_link->init = asoc_simple_dai_init;
359 static int graph_dai_link_of(struct asoc_simple_priv *priv,
360 struct device_node *cpu_ep,
361 struct device_node *codec_ep,
362 struct link_info *li)
364 struct device *dev = simple_priv_to_dev(priv);
365 struct snd_soc_dai_link *dai_link = simple_priv_to_link(priv, li->link);
366 struct simple_dai_props *dai_props = simple_priv_to_props(priv, li->link);
367 struct device_node *top = dev->of_node;
368 struct asoc_simple_dai *cpu_dai;
369 struct asoc_simple_dai *codec_dai;
370 int ret, single_cpu = 0;
372 dev_dbg(dev, "link_of (%pOF)\n", cpu_ep);
377 dai_props->cpu_dai = &priv->dais[li->dais++];
379 dai_props->codec_dai = &priv->dais[li->dais++];
381 /* Factor to mclk, used in hw_params() */
382 graph_parse_mclk_fs(top, cpu_ep, dai_props);
383 graph_parse_mclk_fs(top, codec_ep, dai_props);
385 ret = asoc_simple_parse_daifmt(dev, cpu_ep, codec_ep,
386 NULL, &dai_link->dai_fmt);
390 ret = asoc_simple_parse_cpu(cpu_ep, dai_link, &single_cpu);
394 ret = asoc_simple_parse_codec(codec_ep, dai_link);
398 ret = asoc_simple_parse_tdm(cpu_ep, cpu_dai);
402 ret = asoc_simple_parse_tdm(codec_ep, codec_dai);
406 ret = asoc_simple_parse_clk_cpu(dev, cpu_ep, dai_link, cpu_dai);
410 ret = asoc_simple_parse_clk_codec(dev, codec_ep, dai_link, codec_dai);
414 ret = asoc_simple_set_dailink_name(dev, dai_link,
416 dai_link->cpus->dai_name,
417 dai_link->codecs->dai_name);
421 dai_link->ops = &graph_ops;
422 dai_link->init = asoc_simple_dai_init;
424 asoc_simple_canonicalize_cpu(dai_link, single_cpu);
425 asoc_simple_canonicalize_platform(dai_link);
430 static inline bool parse_as_dpcm_link(struct asoc_simple_priv *priv,
431 struct device_node *codec_port,
432 struct asoc_simple_data *adata)
434 if (priv->force_dpcm)
437 if (!priv->dpcm_selectable)
442 * if Codec port has many endpoints,
443 * or has convert-xxx property
445 if ((of_get_child_count(codec_port) > 1) ||
446 (adata->convert_rate || adata->convert_channels))
452 static int __graph_for_each_link(struct asoc_simple_priv *priv,
453 struct link_info *li,
454 int (*func_noml)(struct asoc_simple_priv *priv,
455 struct device_node *cpu_ep,
456 struct device_node *codec_ep,
457 struct link_info *li),
458 int (*func_dpcm)(struct asoc_simple_priv *priv,
459 struct device_node *cpu_ep,
460 struct device_node *codec_ep,
461 struct link_info *li))
463 struct of_phandle_iterator it;
464 struct device *dev = simple_priv_to_dev(priv);
465 struct device_node *node = dev->of_node;
466 struct device_node *cpu_port;
467 struct device_node *cpu_ep;
468 struct device_node *codec_ep;
469 struct device_node *codec_port;
470 struct device_node *codec_port_old = NULL;
471 struct asoc_simple_data adata;
474 /* loop for all listed CPU port */
475 of_for_each_phandle(&it, rc, node, "dais", NULL, 0) {
479 /* loop for all CPU endpoint */
481 cpu_ep = of_get_next_child(cpu_port, cpu_ep);
486 codec_ep = of_graph_get_remote_endpoint(cpu_ep);
487 codec_port = of_get_parent(codec_ep);
489 /* get convert-xxx property */
490 memset(&adata, 0, sizeof(adata));
491 graph_parse_convert(dev, codec_ep, &adata);
492 graph_parse_convert(dev, cpu_ep, &adata);
494 /* check if link requires DPCM parsing */
495 if (parse_as_dpcm_link(priv, codec_port, &adata)) {
497 * Codec endpoint can be NULL for pluggable audio HW.
498 * Platform DT can populate the Codec endpoint depending on the
501 /* Do it all CPU endpoint, and 1st Codec endpoint */
503 ((codec_port_old != codec_port) && codec_ep))
504 ret = func_dpcm(priv, cpu_ep, codec_ep, li);
505 /* else normal sound */
508 ret = func_noml(priv, cpu_ep, codec_ep, li);
511 of_node_put(codec_ep);
512 of_node_put(codec_port);
517 codec_port_old = codec_port;
524 static int graph_for_each_link(struct asoc_simple_priv *priv,
525 struct link_info *li,
526 int (*func_noml)(struct asoc_simple_priv *priv,
527 struct device_node *cpu_ep,
528 struct device_node *codec_ep,
529 struct link_info *li),
530 int (*func_dpcm)(struct asoc_simple_priv *priv,
531 struct device_node *cpu_ep,
532 struct device_node *codec_ep,
533 struct link_info *li))
537 * Detect all CPU first, and Detect all Codec 2nd.
539 * In Normal sound case, all DAIs are detected
542 * In DPCM sound case,
543 * all CPUs are detected as "CPU-dummy", and
544 * all Codecs are detected as "dummy-Codec".
545 * To avoid random sub-device numbering,
546 * detect "dummy-Codec" in last;
548 for (li->cpu = 1; li->cpu >= 0; li->cpu--) {
549 ret = __graph_for_each_link(priv, li, func_noml, func_dpcm);
557 static void graph_get_dais_count(struct asoc_simple_priv *priv,
558 struct link_info *li);
560 int audio_graph_parse_of(struct asoc_simple_priv *priv, struct device *dev)
562 struct snd_soc_card *card = simple_priv_to_card(priv);
566 card->owner = THIS_MODULE;
569 memset(&li, 0, sizeof(li));
570 graph_get_dais_count(priv, &li);
571 if (!li.link || !li.dais)
574 ret = asoc_simple_init_priv(priv, &li);
578 priv->pa_gpio = devm_gpiod_get_optional(dev, "pa", GPIOD_OUT_LOW);
579 if (IS_ERR(priv->pa_gpio)) {
580 ret = PTR_ERR(priv->pa_gpio);
581 dev_err(dev, "failed to get amplifier gpio: %d\n", ret);
585 ret = asoc_simple_parse_widgets(card, NULL);
589 ret = asoc_simple_parse_routing(card, NULL);
593 memset(&li, 0, sizeof(li));
594 ret = graph_for_each_link(priv, &li,
596 graph_dai_link_of_dpcm);
600 ret = asoc_simple_parse_card_name(card, NULL);
604 snd_soc_card_set_drvdata(card, priv);
606 asoc_simple_debug_info(priv);
608 ret = devm_snd_soc_register_card(dev, card);
615 asoc_simple_clean_reference(card);
617 if (ret != -EPROBE_DEFER)
618 dev_err(dev, "parse error %d\n", ret);
622 EXPORT_SYMBOL_GPL(audio_graph_parse_of);
624 static int graph_count_noml(struct asoc_simple_priv *priv,
625 struct device_node *cpu_ep,
626 struct device_node *codec_ep,
627 struct link_info *li)
629 struct device *dev = simple_priv_to_dev(priv);
631 if (li->link >= SNDRV_MINOR_DEVICES) {
632 dev_err(dev, "too many links\n");
636 li->num[li->link].cpus = 1;
637 li->num[li->link].codecs = 1;
638 li->num[li->link].platforms = 1;
640 li->link += 1; /* 1xCPU-Codec */
641 li->dais += 2; /* 1xCPU + 1xCodec */
643 dev_dbg(dev, "Count As Normal\n");
648 static int graph_count_dpcm(struct asoc_simple_priv *priv,
649 struct device_node *cpu_ep,
650 struct device_node *codec_ep,
651 struct link_info *li)
653 struct device *dev = simple_priv_to_dev(priv);
655 if (li->link >= SNDRV_MINOR_DEVICES) {
656 dev_err(dev, "too many links\n");
661 li->num[li->link].cpus = 1;
662 li->num[li->link].codecs = 1;
663 li->num[li->link].platforms = 1;
665 li->link++; /* 1xCPU-dummy */
666 li->dais++; /* 1xCPU */
668 li->num[li->link].cpus = 1;
669 li->num[li->link].codecs = 1;
670 li->num[li->link].platforms = 1;
672 li->link++; /* 1xdummy-Codec */
673 li->conf++; /* 1xdummy-Codec */
674 li->dais++; /* 1xCodec */
677 dev_dbg(dev, "Count As DPCM\n");
682 static void graph_get_dais_count(struct asoc_simple_priv *priv,
683 struct link_info *li)
685 struct device *dev = simple_priv_to_dev(priv);
688 * link_num : number of links.
689 * CPU-Codec / CPU-dummy / dummy-Codec
690 * dais_num : number of DAIs
691 * ccnf_num : number of codec_conf
692 * same number for "dummy-Codec"
695 * CPU0 --- Codec0 link : 5
696 * CPU1 --- Codec1 dais : 7
700 * => 5 links = 2xCPU-Codec + 2xCPU-dummy + 1xdummy-Codec
701 * => 7 DAIs = 4xCPU + 3xCodec
702 * => 1 ccnf = 1xdummy-Codec
705 * CPU0 --- Codec0 link : 5
706 * CPU1 --- Codec1 dais : 6
710 * => 5 links = 1xCPU-Codec + 3xCPU-dummy + 1xdummy-Codec
711 * => 6 DAIs = 4xCPU + 2xCodec
712 * => 1 ccnf = 1xdummy-Codec
715 * CPU0 --- Codec0 link : 6
717 * CPU2 --- Codec1 ccnf : 2
720 * => 6 links = 0xCPU-Codec + 4xCPU-dummy + 2xdummy-Codec
721 * => 6 DAIs = 4xCPU + 2xCodec
722 * => 2 ccnf = 2xdummy-Codec
725 * CPU0 --- Codec0 (convert-rate) link : 3
726 * CPU1 --- Codec1 dais : 4
729 * => 3 links = 1xCPU-Codec + 1xCPU-dummy + 1xdummy-Codec
730 * => 4 DAIs = 2xCPU + 2xCodec
731 * => 1 ccnf = 1xdummy-Codec
733 graph_for_each_link(priv, li,
736 dev_dbg(dev, "link %d, dais %d, ccnf %d\n",
737 li->link, li->dais, li->conf);
740 int audio_graph_card_probe(struct snd_soc_card *card)
742 struct asoc_simple_priv *priv = snd_soc_card_get_drvdata(card);
745 ret = asoc_simple_init_hp(card, &priv->hp_jack, NULL);
749 ret = asoc_simple_init_mic(card, &priv->mic_jack, NULL);
755 EXPORT_SYMBOL_GPL(audio_graph_card_probe);
757 static int graph_probe(struct platform_device *pdev)
759 struct asoc_simple_priv *priv;
760 struct device *dev = &pdev->dev;
761 struct snd_soc_card *card;
763 /* Allocate the private data and the DAI link array */
764 priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
768 card = simple_priv_to_card(priv);
769 card->dapm_widgets = graph_dapm_widgets;
770 card->num_dapm_widgets = ARRAY_SIZE(graph_dapm_widgets);
771 card->probe = audio_graph_card_probe;
773 if (of_device_get_match_data(dev))
774 priv->dpcm_selectable = 1;
776 return audio_graph_parse_of(priv, dev);
779 int audio_graph_remove(struct platform_device *pdev)
781 struct snd_soc_card *card = platform_get_drvdata(pdev);
783 return asoc_simple_clean_reference(card);
785 EXPORT_SYMBOL_GPL(audio_graph_remove);
787 static const struct of_device_id graph_of_match[] = {
788 { .compatible = "audio-graph-card", },
789 { .compatible = "audio-graph-scu-card",
790 .data = (void *)DPCM_SELECTABLE },
793 MODULE_DEVICE_TABLE(of, graph_of_match);
795 static struct platform_driver graph_card = {
797 .name = "asoc-audio-graph-card",
798 .pm = &snd_soc_pm_ops,
799 .of_match_table = graph_of_match,
801 .probe = graph_probe,
802 .remove = audio_graph_remove,
804 module_platform_driver(graph_card);
806 MODULE_ALIAS("platform:asoc-audio-graph-card");
807 MODULE_LICENSE("GPL v2");
808 MODULE_DESCRIPTION("ASoC Audio Graph Sound Card");
809 MODULE_AUTHOR("Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>");