Merge drm/drm-next into drm-intel-next-queued
[linux-2.6-microblaze.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 one of this
9                         "qcom,sdm845-sndcard"
10                         "qcom,db845c-sndcard"
11                         "lenovo,yoga-c630-sndcard"
12
13 - audio-routing:
14         Usage: Optional
15         Value type: <stringlist>
16         Definition:  A list of the connections between audio components.
17                   Each entry is a pair of strings, the first being the
18                   connection's sink, the second being the connection's
19                   source. Valid names could be power supplies, MicBias
20                   of codec and the jacks on the board.
21
22 - model:
23         Usage: required
24         Value type: <stringlist>
25         Definition: The user-visible name of this sound card.
26
27 - aux-devs
28         Usage: optional
29         Value type: <array of phandles>
30         Definition: A list of phandles for auxiliary devices (e.g. analog
31                     amplifiers) that do not appear directly within the DAI
32                     links. Should be connected to another audio component
33                     using "audio-routing".
34
35 = dailinks
36 Each subnode of sndcard represents either a dailink, and subnodes of each
37 dailinks would be cpu/codec/platform dais.
38
39 - link-name:
40         Usage: required
41         Value type: <string>
42         Definition: User friendly name for dai link
43
44 = CPU, PLATFORM, CODEC dais subnodes
45 - cpu:
46         Usage: required
47         Value type: <subnode>
48         Definition: cpu dai sub-node
49
50 - codec:
51         Usage: required
52         Value type: <subnode>
53         Definition: codec dai sub-node
54
55 - platform:
56         Usage: Optional
57         Value type: <subnode>
58         Definition: platform dai sub-node
59
60 - sound-dai:
61         Usage: required
62         Value type: <phandle>
63         Definition: dai phandle/s and port of CPU/CODEC/PLATFORM node.
64
65 Example:
66
67 audio {
68         compatible = "qcom,sdm845-sndcard";
69         model = "sdm845-snd-card";
70         pinctrl-names = "default", "sleep";
71         pinctrl-0 = <&pri_mi2s_active &pri_mi2s_ws_active>;
72         pinctrl-1 = <&pri_mi2s_sleep &pri_mi2s_ws_sleep>;
73
74         mm1-dai-link {
75                 link-name = "MultiMedia1";
76                 cpu {
77                         sound-dai = <&q6asmdai MSM_FRONTEND_DAI_MULTIMEDIA1>;
78                 };
79         };
80
81         pri-mi2s-dai-link {
82                 link-name = "PRI MI2S Playback";
83                 cpu {
84                         sound-dai = <&q6afedai PRIMARY_MI2S_RX>;
85                 };
86
87                 platform {
88                         sound-dai = <&q6routing>;
89                 };
90         };
91 };