Merge git://git.kernel.org/pub/scm/linux/kernel/git/pablo/nf
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / sound / qcom,apq8016-sbc.txt
1 * Qualcomm Technologies APQ8016 SBC ASoC machine driver
2
3 This node models the Qualcomm Technologies APQ8016 SBC ASoC machine driver
4
5 Required properties:
6
7 - compatible            : "qcom,apq8016-sbc-sndcard"
8
9 - pinctrl-N             : One property must exist for each entry in
10                           pinctrl-names.  See ../pinctrl/pinctrl-bindings.txt
11                           for details of the property values.
12 - pinctrl-names         : Must contain a "default" entry.
13 - reg                   : Must contain an address for each entry in reg-names.
14 - reg-names             : A list which must include the following entries:
15                                 * "mic-iomux"
16                                 * "spkr-iomux"
17 - qcom,model            : Name of the sound card.
18
19 - qcom,audio-routing    : A list of the connections between audio components.
20                           Each entry is a pair of strings, the first being the
21                           connection's sink, the second being the connection's
22                           source. Valid names could be power supplies, MicBias
23                           of msm8x16_wcd codec and the jacks on the board:
24
25                           Power supplies:
26                           * MIC BIAS External1
27                           * MIC BIAS External2
28                           * MIC BIAS Internal1
29                           * MIC BIAS Internal2
30
31                           Board connectors:
32                           * Headset Mic
33                           * Secondary Mic",
34                           * DMIC
35                           * Ext Spk
36
37 Dai-link subnode properties and subnodes:
38
39 Required dai-link subnodes:
40
41 - cpu                                   : CPU   sub-node
42 - codec                                 : CODEC sub-node
43
44 Required CPU/CODEC subnodes properties:
45
46 -link-name              : Name of the dai link.
47 -sound-dai              : phandle/s and port of CPU/CODEC
48
49 Example:
50
51 sound: sound {
52         compatible = "qcom,apq8016-sbc-sndcard";
53         reg = <0x07702000 0x4>, <0x07702004 0x4>;
54         reg-names = "mic-iomux", "spkr-iomux";
55         qcom,model = "DB410c";
56
57         qcom,audio-routing =
58                 "MIC BIAS External1", "Handset Mic",
59                 "MIC BIAS Internal2", "Headset Mic",
60                 "MIC BIAS External1", "Secondary Mic",
61                 "AMIC1", "MIC BIAS External1",
62                 "AMIC2", "MIC BIAS Internal2",
63                 "AMIC3", "MIC BIAS External1",
64                 "DMIC1", "MIC BIAS Internal1",
65                 "MIC BIAS Internal1", "Digital Mic1",
66                 "DMIC2", "MIC BIAS Internal1",
67                 "MIC BIAS Internal1", "Digital Mic2";
68
69         /* I2S - Internal codec */
70         internal-dai-link@0 {
71                 cpu { /* PRIMARY */
72                         sound-dai = <&lpass MI2S_PRIMARY>;
73                 };
74                 codec {
75                         sound-dai = <&lpass_codec 0>, <&wcd_codec 0>;
76                 };
77         };
78
79         /* External Primary or External Secondary -ADV7533 HDMI */
80         external-dai-link@0 {
81                 link-name = "ADV7533";
82                 cpu { /* QUAT */
83                         sound-dai = <&lpass MI2S_QUATERNARY>;
84                 };
85                 codec {
86                         sound-dai = <&adv_bridge 0>;
87                 };
88         };
89 };