From: Jerome Brunet <jbrunet@baylibre.com>
To: Mark Brown <broonie@kernel.org>,
Liam Girdwood <lgirdwood@gmail.com>,
Kevin Hilman <khilman@baylibre.com>,
Carlo Caione <carlo@caione.org>
Cc: Jerome Brunet <jbrunet@baylibre.com>,
alsa-devel@alsa-project.org, devicetree@vger.kernel.org,
linux-kernel@vger.kernel.org, linux-amlogic@lists.infradead.org
Subject: [PATCH 14/15] ASoC: meson: add axg sound card DT binding documentation
Date: Tue, 17 Jul 2018 17:36:41 +0200 [thread overview]
Message-ID: <20180717153643.8806-18-jbrunet@baylibre.com> (raw)
In-Reply-To: <20180717153643.8806-1-jbrunet@baylibre.com>
Add the DT binding documentation for axg sound card
Signed-off-by: Jerome Brunet <jbrunet@baylibre.com>
---
.../bindings/sound/amlogic,axg-sound-card.txt | 124 +++++++++++++++++++++
1 file changed, 124 insertions(+)
create mode 100644 Documentation/devicetree/bindings/sound/amlogic,axg-sound-card.txt
diff --git a/Documentation/devicetree/bindings/sound/amlogic,axg-sound-card.txt b/Documentation/devicetree/bindings/sound/amlogic,axg-sound-card.txt
new file mode 100644
index 000000000000..39e005da0407
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/amlogic,axg-sound-card.txt
@@ -0,0 +1,124 @@
+Amlogic AXG sound card:
+
+Required properties:
+
+- compatible: "amlogic,axg-sound-card"
+- amlogic,name : User specified audio sound card name, one string
+
+Optional properties:
+
+- amlogic,aux-devs : List of phandles pointing to auxiliary devices
+- amlogic,widgets : Please refer to widgets.txt.
+- amlogic,routing : A list of the connections between audio components.
+
+Subnodes:
+
+- amlogic,dai-link: Container for dai-link level properties and the
+ CODEC sub-nodes. There should be at least one (and
+ probably) subnode of this type.
+
+Required dai-link properties:
+
+- sound-dai: phandle and port of the CPU DAI.
+
+Required TDM Backend dai-link properties:
+- dai-format : CPU/CODEC common audio format
+
+Optional TDM Backend dai-link properties:
+- dai-tdm-slot-rx-mask-{0,1,2,3}: Receive direction slot masks
+- dai-tdm-slot-tx-mask-{0,1,2,3}: Transmit direction slot masks
+ When omitted, mask is assumed to have to no
+ slots. A valid must have at one slot, so at
+ least one these mask should be provided with
+ an enabled slot.
+- dai-tdm-slot-num : Please refer to tdm-slot.txt.
+ If omitted, slot number is set to accommodate the largest
+ mask provided.
+- dai-tdm-slot-width : Please refer to tdm-slot.txt. default to 32 if omitted.
+- mclk-fs : Multiplication factor between stream rate and mclk
+
+Backend dai-link subnodes:
+
+- codec: dai-link representing backend links should have at least one subnode.
+ One subnode for each codec of the dai-link.
+ dai-link representing frontend links have no codec, therefore have no
+ subnodes
+
+Required codec subnodes properties:
+
+- sound-dai: phandle and port of the CODEC DAI.
+
+Optional codec subnodes properties:
+
+- dai-tdm-slot-tx-mask : Please refer to tdm-slot.txt.
+- dai-tdm-slot-rx-mask : Please refer to tdm-slot.txt.
+
+Example:
+
+sound {
+ compatible = "amlogic,axg-sound-card";
+ amlogic,name = "AXG-S420";
+ amlogic,aux-devs = <&tdmin_a>, <&tdmout_c>;
+ amlogic,widgets = "Line", "Lineout",
+ "Line", "Linein",
+ "Speaker", "Speaker1 Left",
+ "Speaker", "Speaker1 Right";
+ "Speaker", "Speaker2 Left",
+ "Speaker", "Speaker2 Right";
+ amlogic,routing = "TDMOUT_C IN 0", "FRDDR_A OUT 2",
+ "SPDIFOUT IN 0", "FRDDR_A OUT 3",
+ "TDM_C Playback", "TDMOUT_C OUT",
+ "TDMIN_A IN 2", "TDM_C Capture",
+ "TDMIN_A IN 5", "TDM_C Loopback",
+ "TODDR_A IN 0", "TDMIN_A OUT",
+ "Lineout", "Lineout AOUTL",
+ "Lineout", "Lineout AOUTR",
+ "Speaker1 Left", "SPK1 OUT_A",
+ "Speaker2 Left", "SPK2 OUT_A",
+ "Speaker1 Right", "SPK1 OUT_B",
+ "Speaker2 Right", "SPK2 OUT_B",
+ "Linein AINL", "Linein",
+ "Linein AINR", "Linein";
+
+ amlogic,dai-link@0 {
+ sound-dai = <&frddr_a>;
+ };
+
+ amlogic,dai-link@1 {
+ sound-dai = <&toddr_a>;
+ };
+
+ amlogic,dai-link@2 {
+ sound-dai = <&tdmif_c>;
+ dai-format = "i2s";
+ dai-tdm-slot-tx-mask-2 = <1 1>;
+ dai-tdm-slot-tx-mask-3 = <1 1>;
+ dai-tdm-slot-rx-mask-1 = <1 1>;
+ mclk-fs = <256>;
+
+ codec@0 {
+ sound-dai = <&lineout>;
+ };
+
+ codec@1 {
+ sound-dai = <&speaker_amp1>;
+ };
+
+ codec@2 {
+ sound-dai = <&speaker_amp2>;
+ };
+
+ codec@3 {
+ sound-dai = <&linein>;
+ };
+
+ };
+
+ amlogic,dai-link@4 {
+ sound-dai = <&spdifout>;
+
+ codec {
+ sound-dai = <&spdif_dit>;
+ };
+ };
+};
--
2.14.4
next prev parent reply other threads:[~2018-07-17 15:37 UTC|newest]
Thread overview: 40+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-07-17 15:36 [PATCH 00/15] ASoC: meson: add axg audio subsystem support Jerome Brunet
2018-07-17 15:36 ` [PATCH 01/15] ASoC: meson: add axg fifos DT binding documentation Jerome Brunet
2018-07-18 12:27 ` Applied "ASoC: meson: add axg fifos DT binding documentation" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 02/15] ASoC: meson: add axg fifo base driver Jerome Brunet
2018-07-18 12:26 ` Applied "ASoC: meson: add axg fifo base driver" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 03/15] ASoC: meson: add axg frddr driver Jerome Brunet
2018-07-18 12:26 ` Applied "ASoC: meson: add axg frddr driver" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 04/15] ASoC: meson: add axg toddr driver Jerome Brunet
2018-07-18 12:25 ` Applied "ASoC: meson: add axg toddr driver" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 05/15] ASoC: meson: add axg spdif output DT binding documentation Jerome Brunet
2018-07-18 12:25 ` Applied "ASoC: meson: add axg spdif output DT bindings documentation" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 05/15] ASoC: meson: add axg spdif output DT bindings documentation Jerome Brunet
2018-07-17 15:36 ` [PATCH 06/15] ASoC: meson: add axg spdif output Jerome Brunet
2018-07-18 12:25 ` Applied "ASoC: meson: add axg spdif output" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 07/15] ASoC: meson: add axg tdm formatters DT binding documentation Jerome Brunet
2018-07-18 12:25 ` Applied "ASoC: meson: add axg tdm formatters DT bindings documentation" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 07/15] ASoC: meson: add axg tdm formatters DT bindings documentation Jerome Brunet
2018-07-17 15:36 ` [PATCH 08/15] ASoC: meson: add axg tdm interface DT binding documentation Jerome Brunet
2018-07-20 16:45 ` Applied "ASoC: meson: add axg tdm interface DT bindings documentation" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 08/15] ASoC: meson: add axg tdm interface DT bindings documentation Jerome Brunet
2018-07-17 15:36 ` [PATCH 09/15] ASoC: meson: add tdm formatter base driver Jerome Brunet
2018-07-20 16:44 ` Applied "ASoC: meson: add tdm formatter base driver" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 10/15] ASoC: meson: add tdm interface driver Jerome Brunet
2018-07-20 16:44 ` Applied "ASoC: meson: add tdm interface driver" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 11/15] ASoC: meson: add tdm output driver Jerome Brunet
2018-07-20 16:43 ` Applied "ASoC: meson: add tdm output driver" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 12/15] ASoC: meson: add tdm input driver Jerome Brunet
2018-07-20 16:43 ` Applied "ASoC: meson: add tdm input driver" to the asoc tree Mark Brown
2018-07-17 15:36 ` [PATCH 13/15] ASoC: export snd_soc_of_get_slot_mask Jerome Brunet
2018-07-20 16:43 ` Applied "ASoC: export snd_soc_of_get_slot_mask" to the asoc tree Mark Brown
2018-07-17 15:36 ` Jerome Brunet [this message]
2018-07-20 16:43 ` Applied "ASoC: meson: add axg sound card DT bindings documentation" " Mark Brown
2018-07-25 19:06 ` [PATCH 14/15] ASoC: meson: add axg sound card DT binding documentation Rob Herring
2018-07-25 21:12 ` jbrunet
2018-07-26 7:40 ` jbrunet
2018-07-26 13:20 ` Rob Herring
2018-07-17 15:36 ` [PATCH 14/15] ASoC: meson: add axg sound card DT bindings documentation Jerome Brunet
2018-07-17 15:36 ` [PATCH 15/15] ASoC: meson: add axg sound card support Jerome Brunet
2018-07-20 16:43 ` Applied "ASoC: meson: add axg sound card support" to the asoc tree Mark Brown
2018-07-17 15:38 ` [PATCH 00/15] ASoC: meson: add axg audio subsystem support Jerome Brunet
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180717153643.8806-18-jbrunet@baylibre.com \
--to=jbrunet@baylibre.com \
--cc=alsa-devel@alsa-project.org \
--cc=broonie@kernel.org \
--cc=carlo@caione.org \
--cc=devicetree@vger.kernel.org \
--cc=khilman@baylibre.com \
--cc=lgirdwood@gmail.com \
--cc=linux-amlogic@lists.infradead.org \
--cc=linux-kernel@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).