Merge tag 'for-4.19/post-20180822' of git://git.kernel.dk/linux-block
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / sound / qcom,sdm845.txt
1 * Qualcomm Technologies Inc. SDM845 ASoC sound card driver
2
3 This binding describes the SDM845 sound card, which uses qdsp for audio.
4
5 - compatible:
6         Usage: required
7         Value type: <stringlist>
8         Definition: must be "qcom,sdm845-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
19 - model:
20         Usage: required
21         Value type: <stringlist>
22         Definition: The user-visible name of this sound card.
23
24 = dailinks
25 Each subnode of sndcard represents either a dailink, and subnodes of each
26 dailinks would be cpu/codec/platform dais.
27
28 - link-name:
29         Usage: required
30         Value type: <string>
31         Definition: User friendly name for dai link
32
33 = CPU, PLATFORM, CODEC dais subnodes
34 - cpu:
35         Usage: required
36         Value type: <subnode>
37         Definition: cpu dai sub-node
38
39 - codec:
40         Usage: required
41         Value type: <subnode>
42         Definition: codec dai sub-node
43
44 - platform:
45         Usage: Optional
46         Value type: <subnode>
47         Definition: platform dai sub-node
48
49 - sound-dai:
50         Usage: required
51         Value type: <phandle>
52         Definition: dai phandle/s and port of CPU/CODEC/PLATFORM node.
53
54 Example:
55
56 audio {
57         compatible = "qcom,sdm845-sndcard";
58         model = "sdm845-snd-card";
59         pinctrl-names = "default", "sleep";
60         pinctrl-0 = <&pri_mi2s_active &pri_mi2s_ws_active>;
61         pinctrl-1 = <&pri_mi2s_sleep &pri_mi2s_ws_sleep>;
62
63         mm1-dai-link {
64                 link-name = "MultiMedia1";
65                 cpu {
66                         sound-dai = <&q6asmdai MSM_FRONTEND_DAI_MULTIMEDIA1>;
67                 };
68         };
69
70         pri-mi2s-dai-link {
71                 link-name = "PRI MI2S Playback";
72                 cpu {
73                         sound-dai = <&q6afedai PRIMARY_MI2S_RX>;
74                 };
75
76                 platform {
77                         sound-dai = <&q6routing>;
78                 };
79         };
80 };