Linux-libre 4.19.8-gnu
[librecmc/linux-libre.git] / Documentation / devicetree / bindings / sound / qcom,apq8096.txt
1 * Qualcomm Technologies APQ8096 ASoC sound card driver
2
3 This binding describes the APQ8096 sound card, which uses qdsp for audio.
4
5 - compatible:
6         Usage: required
7         Value type: <stringlist>
8         Definition: must be "qcom,apq8096-sndcard"
9
10 - audio-routing:
11         Usage: Optional
12         Value type: <stringlist>
13         Definition:  A list of the connections between audio components.
14                   Each entry is a pair of strings, the first being the
15                   connection's sink, the second being the connection's
16                   source. Valid names could be power supplies, MicBias
17                   of codec and the jacks on the board:
18                   Valid names include:
19
20                 Board Connectors:
21                         "Headphone Left"
22                         "Headphone Right"
23                         "Earphone"
24                         "Line Out1"
25                         "Line Out2"
26                         "Line Out3"
27                         "Line Out4"
28                         "Analog Mic1"
29                         "Analog Mic2"
30                         "Analog Mic3"
31                         "Analog Mic4"
32                         "Analog Mic5"
33                         "Analog Mic6"
34                         "Digital Mic2"
35                         "Digital Mic3"
36
37                 Audio pins and MicBias on WCD9335 Codec:
38                         "MIC_BIAS1"
39                         "MIC_BIAS2"
40                         "MIC_BIAS3"
41                         "MIC_BIAS4"
42                         "AMIC1"
43                         "AMIC2"
44                         "AMIC3"
45                         "AMIC4"
46                         "AMIC5"
47                         "AMIC6"
48                         "AMIC6"
49                         "DMIC1"
50                         "DMIC2"
51                         "DMIC3"
52
53 - model:
54         Usage: required
55         Value type: <stringlist>
56         Definition: The user-visible name of this sound card.
57
58 = dailinks
59 Each subnode of sndcard represents either a dailink, and subnodes of each
60 dailinks would be cpu/codec/platform dais.
61
62 - link-name:
63         Usage: required
64         Value type: <string>
65         Definition: User friendly name for dai link
66
67 = CPU, PLATFORM, CODEC dais subnodes
68 - cpu:
69         Usage: required
70         Value type: <subnode>
71         Definition: cpu dai sub-node
72
73 - codec:
74         Usage: Optional
75         Value type: <subnode>
76         Definition: codec dai sub-node
77
78 - platform:
79         Usage: Optional
80         Value type: <subnode>
81         Definition: platform dai sub-node
82
83 - sound-dai:
84         Usage: required
85         Value type: <phandle with arguments>
86         Definition: dai phandle/s and port of CPU/CODEC/PLATFORM node.
87
88 Obsolete:
89         qcom,model: String for soundcard name (Use model instead)
90         qcom,audio-routing: A list of the connections between audio components.
91                             (Use audio-routing instead)
92
93 Example:
94
95 audio {
96         compatible = "qcom,apq8096-sndcard";
97         model = "DB820c";
98
99         mm1-dai-link {
100                 link-name = "MultiMedia1";
101                 cpu {
102                         sound-dai = <&q6asmdai MSM_FRONTEND_DAI_MULTIMEDIA1>;
103                 };
104         };
105
106         hdmi-dai-link {
107                 link-name = "HDMI Playback";
108                 cpu {
109                         sound-dai = <&q6afe HDMI_RX>;
110                 };
111
112                 platform {
113                         sound-dai = <&q6adm>;
114                 };
115
116                 codec {
117                         sound-dai = <&hdmi 0>;
118                 };
119         };
120 };