ASoC: qdsp6: dt-bindings: Add apq8096 machine bindings
authorSrinivas Kandagatla <srinivas.kandagatla@linaro.org>
Fri, 18 May 2018 12:56:09 +0000 (13:56 +0100)
committerMark Brown <broonie@kernel.org>
Mon, 21 May 2018 15:43:06 +0000 (16:43 +0100)
Add devicetree bindings documentation file for Qualcomm apq8096 sound card.

Signed-off-by: Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
Reviewed-by: Rob Herring <robh@kernel.org>
Reviewed-by: Banajit Goswami <bgoswami@codeaurora.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
Documentation/devicetree/bindings/sound/qcom,apq8096.txt [new file with mode: 0644]

diff --git a/Documentation/devicetree/bindings/sound/qcom,apq8096.txt b/Documentation/devicetree/bindings/sound/qcom,apq8096.txt
new file mode 100644 (file)
index 0000000..aa54e49
--- /dev/null
@@ -0,0 +1,109 @@
+* Qualcomm Technologies APQ8096 ASoC sound card driver
+
+This binding describes the APQ8096 sound card, which uses qdsp for audio.
+
+- compatible:
+       Usage: required
+       Value type: <stringlist>
+       Definition: must be "qcom,apq8096-sndcard"
+
+- qcom,audio-routing:
+       Usage: Optional
+       Value type: <stringlist>
+       Definition:  A list of the connections between audio components.
+                 Each entry is a pair of strings, the first being the
+                 connection's sink, the second being the connection's
+                 source. Valid names could be power supplies, MicBias
+                 of codec and the jacks on the board:
+                 Valid names include:
+
+               Board Connectors:
+                       "Headphone Left"
+                       "Headphone Right"
+                       "Earphone"
+                       "Line Out1"
+                       "Line Out2"
+                       "Line Out3"
+                       "Line Out4"
+                       "Analog Mic1"
+                       "Analog Mic2"
+                       "Analog Mic3"
+                       "Analog Mic4"
+                       "Analog Mic5"
+                       "Analog Mic6"
+                       "Digital Mic2"
+                       "Digital Mic3"
+
+               Audio pins and MicBias on WCD9335 Codec:
+                       "MIC_BIAS1
+                       "MIC_BIAS2"
+                       "MIC_BIAS3"
+                       "MIC_BIAS4"
+                       "AMIC1"
+                       "AMIC2"
+                       "AMIC3"
+                       "AMIC4"
+                       "AMIC5"
+                       "AMIC6"
+                       "AMIC6"
+                       "DMIC1"
+                       "DMIC2"
+                       "DMIC3"
+= dailinks
+Each subnode of sndcard represents either a dailink, and subnodes of each
+dailinks would be cpu/codec/platform dais.
+
+- link-name:
+       Usage: required
+       Value type: <string>
+       Definition: User friendly name for dai link
+
+= CPU, PLATFORM, CODEC dais subnodes
+- cpu:
+       Usage: required
+       Value type: <subnode>
+       Definition: cpu dai sub-node
+
+- codec:
+       Usage: Optional
+       Value type: <subnode>
+       Definition: codec dai sub-node
+
+- platform:
+       Usage: Optional
+       Value type: <subnode>
+       Definition: platform dai sub-node
+
+- sound-dai:
+       Usage: required
+       Value type: <phandle with arguments>
+       Definition: dai phandle/s and port of CPU/CODEC/PLATFORM node.
+
+Example:
+
+audio {
+       compatible = "qcom,apq8096-sndcard";
+       qcom,model = "DB820c";
+
+       mm1-dai-link {
+               link-name = "MultiMedia1";
+               cpu {
+                       sound-dai = <&q6asmdai MSM_FRONTEND_DAI_MULTIMEDIA1>;
+               };
+       };
+
+       hdmi-dai-link {
+               link-name = "HDMI Playback";
+               cpu {
+                       sound-dai = <&q6afe HDMI_RX>;
+               };
+
+               platform {
+                       sound-dai = <&q6adm>;
+               };
+
+               codec {
+                       sound-dai = <&hdmi 0>;
+               };
+       };
+};