ASoC: audio-graph-card2-custom-sample.dtsi: add Sample DT for Normal (Single)

Audio Graph Card2 settings is a little bit difficult for beginner,
and Customizing it also difficult/confusable too.
So, this patch adds sample for it.

You can easily use it by adding below line on your DT file,
and select CONFIGs to your .config.

	#include "../../../../../sound/soc/generic/audio-graph-card2-custom-sample.dtsi"

	CONFIG_SND_AUDIO_GRAPH_CARD2
	CONFIG_SND_AUDIO_GRAPH_CARD2_CUSTOM_SAMPLE
	CONFIG_SND_TEST_COMPONENT

This patch uses audio-graph-card2 base custom sample driver.
You can directly use audio-graph-card2 instead of custom sample driver
by modifing compatible.

	- compatible = "audio-graph-card2-custom-sample";
	+ compatible = "audio-graph-card2";

Sample custom driver will indicate customized print.

It is using Test-Component driver for CPU/Codec.
It can indicate more detail print of each behavior if user want to.
In such case, you need to update compatible to "xxx-nv" or "xxx-vv".

	- compatible = "test-cpu";
	+ compatible = "test-cpu-verbose";

Signed-off-by: Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
Link: https://lore.kernel.org/r/87tuhmlu35.wl-kuninori.morimoto.gx@renesas.com
Signed-off-by: Mark Brown <broonie@kernel.org>

diff --git a/sound/soc/generic/audio-graph-card2-custom-sample.dtsi b/sound/soc/generic/audio-graph-card2-custom-sample.dtsi
new file mode 100644 (file)
index 0000000..c2511da
--- /dev/null
+++ b/sound/soc/generic/audio-graph-card2-custom-sample.dtsi
@@ -0,0 +1,71 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * audio-graph-card2-custom-sample.dtsi
+ *
+ * Copyright (C) 2020 Renesas Electronics Corp.
+ * Copyright (C) 2020 Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
+ *
+ * This sample indicates how to use audio-graph-card2 and its
+ * custom driver. "audio-graph-card2-custom-sample" is the custome driver
+ * which is using audio-graph-card2.
+ *
+ * You can easily use this sample by adding below line on your DT file,
+ * and add new CONFIG to your .config.
+ *
+ *     #include "../../../../../sound/soc/generic/audio-graph-card2-custom-sample.dtsi"
+ *
+ *     CONFIG_SND_AUDIO_GRAPH_CARD2
+ *     CONFIG_SND_AUDIO_GRAPH_CARD2_CUSTOM_SAMPLE
+ *     CONFIG_SND_TEST_COMPONENT
+ */
+/ {
+       /*
+        * @ : used at links
+        *
+        * [Normal]
+        *      cpu0 <-@-----------------> codec0
+        */
+       audio-graph-card2-custom-sample {
+               /*
+                * You can use audio-graph-card2 directly by using
+                *
+                * compatible = "audio-graph-card2";
+                */
+               compatible = "audio-graph-card2-custom-sample";
+
+               links = <&cpu0                  /* normal: cpu side only */
+               >;
+       };
+
+       test_cpu {
+               /*
+                * update compatible to indicate more detail behaviour
+                * if you want. see test-compatible for more detail.
+                *
+                * ex)
+                *      - compatible = "test-cpu";
+                *      + compatible = "test-cpu-verbose";
+                */
+               compatible = "test-cpu";
+               ports {
+                       bitclock-master;
+                       frame-master;
+                       cpu0: port@0 { cpu0_ep: endpoint { remote-endpoint = <&codec0_ep>; }; };
+               };
+       };
+
+       test_codec {
+               /*
+                * update compatible to indicate more detail behaviour
+                * if you want. see test-compatible for more detail.
+                *
+                * ex)
+                *      - compatible = "test-codec";
+                *      + compatible = "test-codec-verbose";
+                */
+               compatible = "test-codec";
+               ports {
+                       port@0  { codec0_ep:  endpoint { remote-endpoint = <&cpu0_ep>; }; };
+               };
+       };
+};