Merge branch 'stable/for-linus-4.11' of git://git.kernel.org/pub/scm/linux/kernel...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / sound / qcom,msm8916-wcd-analog.txt
1 msm8916 analog audio CODEC
2
3 Bindings for codec Analog IP which is integrated in pmic pm8916,
4
5 ## Bindings for codec core on pmic:
6
7 Required properties
8  - compatible = "qcom,pm8916-wcd-analog-codec";
9  - reg: represents the slave base address provided to the peripheral.
10  - interrupt-parent : The parent interrupt controller.
11  - interrupts: List of interrupts in given SPMI peripheral.
12  - interrupt-names: Names specified to above list of interrupts in same
13                     order. List of supported interrupt names are:
14   "cdc_spk_cnp_int" - Speaker click and pop interrupt.
15   "cdc_spk_clip_int" - Speaker clip interrupt.
16   "cdc_spk_ocp_int" - Speaker over current protect interrupt.
17   "mbhc_ins_rem_det1" - jack insert removal detect interrupt 1.
18   "mbhc_but_rel_det" - button release interrupt.
19   "mbhc_but_press_det" - button press event
20   "mbhc_ins_rem_det" - jack insert removal detect interrupt.
21   "mbhc_switch_int"     - multi button headset interrupt.
22   "cdc_ear_ocp_int" - Earphone over current protect interrupt.
23   "cdc_hphr_ocp_int" - Headphone R over current protect interrupt.
24   "cdc_hphl_ocp_det" - Headphone L over current protect interrupt.
25   "cdc_ear_cnp_int" - earphone cnp interrupt.
26   "cdc_hphr_cnp_int" - hphr click and pop interrupt.
27   "cdc_hphl_cnp_int" - hphl click and pop interrupt.
28
29  - clocks: Handle to mclk.
30  - clock-names: should be "mclk"
31  - vdd-cdc-io-supply: phandle to VDD_CDC_IO regulator DT node.
32  - vdd-cdc-tx-rx-cx-supply: phandle to VDD_CDC_TX/RX/CX regulator DT node.
33  - vdd-micbias-supply: phandle of VDD_MICBIAS supply's regulator DT node.
34
35 Optional Properties:
36 - qcom,micbias1-ext-cap: boolean, present if micbias1 has external capacitor
37                          connected.
38 - qcom,micbias2-ext-cap: boolean, present if micbias2 has external capacitor
39                          connected.
40
41 Example:
42
43 spmi_bus {
44         ...
45         audio-codec@f000{
46                 compatible = "qcom,pm8916-wcd-analog-codec";
47                 reg = <0xf000 0x200>;
48                 reg-names = "pmic-codec-core";
49                 clocks = <&gcc GCC_CODEC_DIGCODEC_CLK>;
50                 clock-names = "mclk";
51                 interrupt-parent = <&spmi_bus>;
52                 interrupts = <0x1 0xf0 0x0 IRQ_TYPE_NONE>,
53                              <0x1 0xf0 0x1 IRQ_TYPE_NONE>,
54                              <0x1 0xf0 0x2 IRQ_TYPE_NONE>,
55                              <0x1 0xf0 0x3 IRQ_TYPE_NONE>,
56                              <0x1 0xf0 0x4 IRQ_TYPE_NONE>,
57                              <0x1 0xf0 0x5 IRQ_TYPE_NONE>,
58                              <0x1 0xf0 0x6 IRQ_TYPE_NONE>,
59                              <0x1 0xf0 0x7 IRQ_TYPE_NONE>,
60                              <0x1 0xf1 0x0 IRQ_TYPE_NONE>,
61                              <0x1 0xf1 0x1 IRQ_TYPE_NONE>,
62                              <0x1 0xf1 0x2 IRQ_TYPE_NONE>,
63                              <0x1 0xf1 0x3 IRQ_TYPE_NONE>,
64                              <0x1 0xf1 0x4 IRQ_TYPE_NONE>,
65                              <0x1 0xf1 0x5 IRQ_TYPE_NONE>;
66                 interrupt-names = "cdc_spk_cnp_int",
67                                   "cdc_spk_clip_int",
68                                   "cdc_spk_ocp_int",
69                                   "mbhc_ins_rem_det1",
70                                   "mbhc_but_rel_det",
71                                   "mbhc_but_press_det",
72                                   "mbhc_ins_rem_det",
73                                   "mbhc_switch_int",
74                                   "cdc_ear_ocp_int",
75                                   "cdc_hphr_ocp_int",
76                                   "cdc_hphl_ocp_det",
77                                   "cdc_ear_cnp_int",
78                                   "cdc_hphr_cnp_int",
79                                   "cdc_hphl_cnp_int";
80                        VDD-CDC-IO-supply = <&pm8916_l5>;
81                        VDD-CDC-TX-RX-CX-supply = <&pm8916_l5>;
82                        VDD-MICBIAS-supply = <&pm8916_l13>;
83                        #sound-dai-cells = <1>;
84         };
85 };