ASoC: simple-card: Add DT documentation for multi-DAI links

Many couples of CPU/CODEC DAI links may be described in the DT
thanks to 'simple-audio-card,dai-link' containers.

Signed-off-by: Jean-Francois Moine <moinejf@free.fr>
Signed-off-by: Mark Brown <broonie@linaro.org>

diff --git a/Documentation/devicetree/bindings/sound/simple-card.txt b/Documentation/devicetree/bindings/sound/simple-card.txt
index 881914b139ca4d926eaa1939c1ea28636c37f0cc..131aa2ad7f1a3120d6ebeef6492c466f87ab461b 100644 (file)
--- a/Documentation/devicetree/bindings/sound/simple-card.txt
+++ b/Documentation/devicetree/bindings/sound/simple-card.txt
@@ -23,6 +23,11 @@ Optional properties:
 
 Required subnodes:
 
+- simple-audio-card,dai-link           : container for the CPU and CODEC sub-nodes
+                                         This container may be omitted when the
+                                         card has only one DAI link.
+                                         See the examples.
+
 - simple-audio-card,cpu                        : CPU   sub-node
 - simple-audio-card,codec              : CODEC sub-node
 
@@ -49,7 +54,7 @@ Note:
    CPU and CODEC sides as we need to keep the settings identical for both ends
    of the link.
 
-Example:
+Example 1 - single DAI link:
 
 sound {
        compatible = "simple-audio-card";
@@ -94,3 +99,38 @@ sh_fsi2: sh_fsi2@ec230000 {
        interrupt-parent = <&gic>;
        interrupts = <0 146 0x4>;
 };
+
+Example 2 - many DAI links:
+
+sound {
+       compatible = "simple-audio-card";
+       simple-audio-card,name = "Cubox Audio";
+       simple-audio-card,format = "i2s";
+
+       simple-audio-card,dai-link@0 {          /* I2S - HDMI */
+               simple-audio-card,cpu {
+                       sound-dai = <&audio1 0>;
+               };
+               simple-audio-card,codec {
+                       sound-dai = <&tda998x 0>;
+               };
+       };
+
+       simple-audio-card,dai-link@1 {          /* S/PDIF - HDMI */
+               simple-audio-card,cpu {
+                       sound-dai = <&audio1 1>;
+               };
+               simple-audio-card,codec {
+                       sound-dai = <&tda998x 1>;
+               };
+       };
+
+       simple-audio-card,dai-link@2 {          /* S/PDIF - S/PDIF */
+               simple-audio-card,cpu {
+                       sound-dai = <&audio1 1>;
+               };
+               simple-audio-card,codec {
+                       sound-dai = <&spdif_codec>;
+               };
+       };
+};