Merge tag 'platform-drivers-x86-v4.18-1' of git://git.infradead.org/linux-platform...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / regulator / rohm,bd71837-regulator.txt
1 ROHM BD71837 Power Management Integrated Circuit (PMIC) regulator bindings
2
3 BD71837MWV is a programmable Power Management
4 IC (PMIC) for powering single-core, dual-core, and
5 quad-core SoC’s such as NXP-i.MX 8M. It is optimized
6 for low BOM cost and compact solution footprint. It
7 integrates 8 Buck regulators and 7 LDO’s to provide all
8 the power rails required by the SoC and the commonly
9 used peripherals.
10
11 Required properties:
12  - regulator-name: should be "buck1", ..., "buck8" and "ldo1", ..., "ldo7"
13
14 List of regulators provided by this controller. BD71837 regulators node
15 should be sub node of the BD71837 MFD node. See BD71837 MFD bindings at
16 Documentation/devicetree/bindings/mfd/rohm,bd71837-pmic.txt
17 Regulator nodes should be named to BUCK_<number> and LDO_<number>. The
18 definition for each of these nodes is defined using the standard
19 binding for regulators at
20 Documentation/devicetree/bindings/regulator/regulator.txt.
21 Note that if BD71837 starts at RUN state you probably want to use
22 regulator-boot-on at least for BUCK6 and BUCK7 so that those are not
23 disabled by driver at startup. LDO5 and LDO6 are supplied by those and
24 if they are disabled at startup the voltage monitoring for LDO5/LDO6 will
25 cause PMIC to reset.
26
27 The valid names for regulator nodes are:
28 BUCK1, BUCK2, BUCK3, BUCK4, BUCK5, BUCK6, BUCK7, BUCK8
29 LDO1, LDO2, LDO3, LDO4, LDO5, LDO6, LDO7
30
31 Optional properties:
32 - Any optional property defined in bindings/regulator/regulator.txt
33
34 Example:
35 regulators {
36         buck1: BUCK1 {
37                 regulator-name = "buck1";
38                 regulator-min-microvolt = <700000>;
39                 regulator-max-microvolt = <1300000>;
40                 regulator-boot-on;
41                 regulator-ramp-delay = <1250>;
42         };
43         buck2: BUCK2 {
44                 regulator-name = "buck2";
45                 regulator-min-microvolt = <700000>;
46                 regulator-max-microvolt = <1300000>;
47                 regulator-boot-on;
48                 regulator-always-on;
49                 regulator-ramp-delay = <1250>;
50         };
51         buck3: BUCK3 {
52                 regulator-name = "buck3";
53                 regulator-min-microvolt = <700000>;
54                 regulator-max-microvolt = <1300000>;
55                 regulator-boot-on;
56         };
57         buck4: BUCK4 {
58                 regulator-name = "buck4";
59                 regulator-min-microvolt = <700000>;
60                 regulator-max-microvolt = <1300000>;
61                 regulator-boot-on;
62         };
63         buck5: BUCK5 {
64                 regulator-name = "buck5";
65                 regulator-min-microvolt = <700000>;
66                 regulator-max-microvolt = <1350000>;
67                 regulator-boot-on;
68         };
69         buck6: BUCK6 {
70                 regulator-name = "buck6";
71                 regulator-min-microvolt = <3000000>;
72                 regulator-max-microvolt = <3300000>;
73                 regulator-boot-on;
74         };
75         buck7: BUCK7 {
76                 regulator-name = "buck7";
77                 regulator-min-microvolt = <1605000>;
78                 regulator-max-microvolt = <1995000>;
79                 regulator-boot-on;
80         };
81         buck8: BUCK8 {
82                 regulator-name = "buck8";
83                 regulator-min-microvolt = <800000>;
84                 regulator-max-microvolt = <1400000>;
85         };
86
87         ldo1: LDO1 {
88                 regulator-name = "ldo1";
89                 regulator-min-microvolt = <3000000>;
90                 regulator-max-microvolt = <3300000>;
91                 regulator-boot-on;
92         };
93         ldo2: LDO2 {
94                 regulator-name = "ldo2";
95                 regulator-min-microvolt = <900000>;
96                 regulator-max-microvolt = <900000>;
97                 regulator-boot-on;
98         };
99         ldo3: LDO3 {
100                 regulator-name = "ldo3";
101                 regulator-min-microvolt = <1800000>;
102                 regulator-max-microvolt = <3300000>;
103         };
104         ldo4: LDO4 {
105                 regulator-name = "ldo4";
106                 regulator-min-microvolt = <900000>;
107                 regulator-max-microvolt = <1800000>;
108         };
109         ldo5: LDO5 {
110                 regulator-name = "ldo5";
111                 regulator-min-microvolt = <1800000>;
112                 regulator-max-microvolt = <3300000>;
113         };
114         ldo6: LDO6 {
115                 regulator-name = "ldo6";
116                 regulator-min-microvolt = <900000>;
117                 regulator-max-microvolt = <1800000>;
118         };
119         ldo7_reg: LDO7 {
120                 regulator-name = "ldo7";
121                 regulator-min-microvolt = <1800000>;
122                 regulator-max-microvolt = <3300000>;
123         };
124 };
125
126