summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/sound/qcom,pm8916-wcd-analog-codec.yaml
blob: 94e7a1860977e8719fd534e638279ffc961586cd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/sound/qcom,pm8916-wcd-analog-codec.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Qualcomm PM8916 WCD Analog Audio Codec

maintainers:
  - Konrad Dybcio <konradybcio@kernel.org>

description:
  The analog WCD audio codec found on Qualcomm PM8916 PMIC.

properties:
  compatible:
    const: qcom,pm8916-wcd-analog-codec

  reg:
    maxItems: 1

  interrupts:
    maxItems: 14

  interrupt-names:
    items:
      - const: cdc_spk_cnp_int
      - const: cdc_spk_clip_int
      - const: cdc_spk_ocp_int
      - const: mbhc_ins_rem_det1
      - const: mbhc_but_rel_det
      - const: mbhc_but_press_det
      - const: mbhc_ins_rem_det
      - const: mbhc_switch_int
      - const: cdc_ear_ocp_int
      - const: cdc_hphr_ocp_int
      - const: cdc_hphl_ocp_det
      - const: cdc_ear_cnp_int
      - const: cdc_hphr_cnp_int
      - const: cdc_hphl_cnp_int

  vdd-cdc-io-supply:
    description: 1.8V buck supply

  vdd-cdc-tx-rx-cx-supply:
    description: 1.8V SIDO buck supply

  vdd-micbias-supply:
    description: micbias supply

  qcom,mbhc-vthreshold-low:
    $ref: /schemas/types.yaml#/definitions/uint32-array
    description:
      Array of 5 threshold voltages in mV for 5-button detection on
      headset when MBHC is powered by an internal current source.
    minItems: 5
    maxItems: 5

  qcom,mbhc-vthreshold-high:
    $ref: /schemas/types.yaml#/definitions/uint32-array
    description:
      Array of 5 threshold voltages in mV for 5-button detection on
      headset when MBHC is powered from micbias.
    minItems: 5
    maxItems: 5

  qcom,micbias-lvl:
    $ref: /schemas/types.yaml#/definitions/uint32
    description:
      Voltage (mV) for Mic Bias

  qcom,hphl-jack-type-normally-open:
    type: boolean
    description:
      True if the HPHL pin on the jack is NO (Normally Open), false if it's
      NC (Normally Closed).

  qcom,gnd-jack-type-normally-open:
    type: boolean
    description:
      True if the GND pin on the jack is NO (Normally Open), false if it's
      NC (Normally Closed).

  qcom,micbias1-ext-cap:
    type: boolean
    description:
      True if micbias1 has an external capacitor.

  qcom,micbias2-ext-cap:
    type: boolean
    description:
      True if micbias2 has an external capacitor.

  "#sound-dai-cells":
    const: 1

required:
  - compatible
  - reg

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    #include <dt-bindings/spmi/spmi.h>

    pmic@1 {
      compatible = "qcom,pm8916", "qcom,spmi-pmic";
      reg = <0x1 SPMI_USID>;
      #address-cells = <1>;
      #size-cells = <0>;

      audio-codec@f000 {
        compatible = "qcom,pm8916-wcd-analog-codec";
        reg = <0xf000>;
        qcom,mbhc-vthreshold-low = <75 150 237 450 500>;
        qcom,mbhc-vthreshold-high = <75 150 237 450 500>;
        interrupt-parent = <&spmi_bus>;
        interrupts = <0x1 0xf0 0x0 IRQ_TYPE_NONE>,
              <0x1 0xf0 0x1 IRQ_TYPE_NONE>,
              <0x1 0xf0 0x2 IRQ_TYPE_NONE>,
              <0x1 0xf0 0x3 IRQ_TYPE_NONE>,
              <0x1 0xf0 0x4 IRQ_TYPE_NONE>,
              <0x1 0xf0 0x5 IRQ_TYPE_NONE>,
              <0x1 0xf0 0x6 IRQ_TYPE_NONE>,
              <0x1 0xf0 0x7 IRQ_TYPE_NONE>,
              <0x1 0xf1 0x0 IRQ_TYPE_NONE>,
              <0x1 0xf1 0x1 IRQ_TYPE_NONE>,
              <0x1 0xf1 0x2 IRQ_TYPE_NONE>,
              <0x1 0xf1 0x3 IRQ_TYPE_NONE>,
              <0x1 0xf1 0x4 IRQ_TYPE_NONE>,
              <0x1 0xf1 0x5 IRQ_TYPE_NONE>;
        interrupt-names = "cdc_spk_cnp_int",
                          "cdc_spk_clip_int",
                          "cdc_spk_ocp_int",
                          "mbhc_ins_rem_det1",
                          "mbhc_but_rel_det",
                          "mbhc_but_press_det",
                          "mbhc_ins_rem_det",
                          "mbhc_switch_int",
                          "cdc_ear_ocp_int",
                          "cdc_hphr_ocp_int",
                          "cdc_hphl_ocp_det",
                          "cdc_ear_cnp_int",
                          "cdc_hphr_cnp_int",
                          "cdc_hphl_cnp_int";
        vdd-cdc-io-supply = <&pm8916_l5>;
        vdd-cdc-tx-rx-cx-supply = <&pm8916_l5>;
        vdd-micbias-supply = <&pm8916_l13>;
        #sound-dai-cells = <1>;
      };
    };