Merge tag 'drivers-5.10-2020-10-12' of git://git.kernel.dk/linux-block
[linux-2.6-block.git] / Documentation / devicetree / bindings / regulator / qcom,smd-rpm-regulator.yaml
1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/regulator/qcom,smd-rpm-regulator.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: QCOM SMD RPM REGULATOR
8
9 description:
10   The Qualcomm RPM over SMD regulator is modelled as a subdevice of the RPM.
11   Because SMD is used as the communication transport mechanism, the RPM
12   resides as a subnode of the SMD.  As such, the SMD-RPM regulator requires
13   that the SMD and RPM nodes be present.
14
15   Please refer to Documentation/devicetree/bindings/soc/qcom/qcom,smd.txt for
16   information pertaining to the SMD node.
17
18   Please refer to Documentation/devicetree/bindings/soc/qcom/qcom,smd-rpm.yaml
19   for information regarding the RPM node.
20
21   The regulator node houses sub-nodes for each regulator within the device.
22   Each sub-node is identified using the node's name, with valid values listed
23   for each of the pmics below.
24
25   For mp5496, s2
26
27   For pm8841, s1, s2, s3, s4, s5, s6, s7, s8
28
29   For pm8916, s1, s2, s3, s4, l1, l2, l3, l4, l5, l6, l7, l8, l9, l10, l11,
30   l12, l13, l14, l15, l16, l17, l18
31
32   For pm8941, s1, s2, s3, s4, l1, l2, l3, l4, l5, l6, l7, l8, l9, l10, l11,
33   l12, l13, l14, l15, l16, l17, l18, l19, l20, l21, l22, l23, l24, lvs1, lvs2,
34   lvs3, 5vs1, 5vs2
35
36   For pm8950 and pm8953, s1, s2, s3, s4, s5, s6, s7, l1, l2, l3, l4, l5, l6,
37   l7, l8, l9, l10, l11, l12, l13, l14, l15, l16, l17, l18, l19, l20, l21, l22,
38   l23
39
40   For pm8994, s1, s2, s3, s4, s5, s6, s7, s8, s9, s10, s11, s12, l1, l2, l3,
41   l4, l5, l6, l7, l8, l9, l10, l11, l12, l13, l14, l15, l16, l17, l18, l19,
42   l20, l21, l22, l23, l24, l25, l26, l27, l28, l29, l30, l31, l32, lvs1, lvs2
43
44   For pm8998, s1, s2, s3, s4, s5, s6, s7, s8, s9, s10, s11, s12, s13, l1, l2,
45   l3, l4, l5, l6, l7, l8, l9, l10, l11, l12, l13, l14, l15, l16, l17, l18, l19,
46   l20, l21, l22, l23, l24, l25, l26, l27, l28, lvs1, lvs2
47
48   For pm660, s1, s2, s3, s4, s5, s6, l1, l2, l3, l5, l6, l7, l8, l9, l10, l22,
49   l12, l13, l14, l15, l16, l17, l18, l19
50
51   For pm660l s1, s2, s3, s5, l1, l2, l3, l4, l5, l6, l7, l8, l9, l10, bob
52
53   For pma8084, s1, s2, s3, s4, s5, s6, s7, s8, s9, s10, s11, s12, l1, l2, l3,
54   l4, l5, l6, l7, l8, l9, l10, l11, l12, l13, l14, l15, l16, l17, l18, l19,
55   l20, l21, l22, l23, l24, l25, l26, l27, lvs1, lvs2, lvs3, lvs4, 5vs1
56
57   For pmi8994, s1, s2, s3, boost-bypass
58
59   For pmi8998, bob
60
61   For pms405, s1, s2, s3, s4, s5, l1, l2, l3, l4, l5, l6, l7, l8, l9, l10, l11,
62   l12, l13
63
64 maintainers:
65   - Kathiravan T <kathirav@codeaurora.org>
66
67 properties:
68   compatible:
69     enum:
70       - qcom,rpm-mp5496-regulators
71       - qcom,rpm-pm8841-regulators
72       - qcom,rpm-pm8916-regulators
73       - qcom,rpm-pm8941-regulators
74       - qcom,rpm-pm8950-regulators
75       - qcom,rpm-pm8953-regulators
76       - qcom,rpm-pm8994-regulators
77       - qcom,rpm-pm8998-regulators
78       - qcom,rpm-pm660-regulators
79       - qcom,rpm-pm660l-regulators
80       - qcom,rpm-pma8084-regulators
81       - qcom,rpm-pmi8994-regulators
82       - qcom,rpm-pmi8998-regulators
83       - qcom,rpm-pms405-regulators
84
85 patternProperties:
86   ".*-supply$":
87     description: Input supply phandle(s) for this node
88
89   "^((s|l|lvs|5vs)[0-9]*)|(boost-bypass)|(bob)$":
90     description: List of regulators and its properties
91     $ref: regulator.yaml#
92
93 additionalProperties: false
94
95 required:
96   - compatible
97
98 examples:
99   - |
100     pm8941-regulators {
101         compatible = "qcom,rpm-pm8941-regulators";
102         vdd_l13_l20_l23_l24-supply = <&pm8941_boost>;
103
104         pm8941_s3: s3 {
105             regulator-min-microvolt = <1800000>;
106             regulator-max-microvolt = <1800000>;
107         };
108
109         pm8941_boost: s4 {
110             regulator-min-microvolt = <5000000>;
111             regulator-max-microvolt = <5000000>;
112         };
113
114         pm8941_l20: l20 {
115             regulator-min-microvolt = <2950000>;
116             regulator-max-microvolt = <2950000>;
117         };
118     };
119 ...