Merge branch 'stable/for-linus-5.2' of git://git.kernel.org/pub/scm/linux/kernel...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / regulator / rohm,bd71837-regulator.txt
1 ROHM BD71837 and BD71847 Power Management Integrated Circuit regulator bindings
2
3 Required properties:
4  - regulator-name: should be "buck1", ..., "buck8" and "ldo1", ..., "ldo7" for
5                    BD71837. For BD71847 names should be "buck1", ..., "buck6"
6                    and "ldo1", ..., "ldo6"
7
8 List of regulators provided by this controller. BD71837 regulators node
9 should be sub node of the BD71837 MFD node. See BD71837 MFD bindings at
10 Documentation/devicetree/bindings/mfd/rohm,bd71837-pmic.txt
11 Regulator nodes should be named to BUCK_<number> and LDO_<number>. The
12 definition for each of these nodes is defined using the standard
13 binding for regulators at
14 Documentation/devicetree/bindings/regulator/regulator.txt.
15 Note that if BD71837 starts at RUN state you probably want to use
16 regulator-boot-on at least for BUCK6 and BUCK7 so that those are not
17 disabled by driver at startup. LDO5 and LDO6 are supplied by those and
18 if they are disabled at startup the voltage monitoring for LDO5/LDO6 will
19 cause PMIC to reset.
20
21 The valid names for BD71837 regulator nodes are:
22 BUCK1, BUCK2, BUCK3, BUCK4, BUCK5, BUCK6, BUCK7, BUCK8
23 LDO1, LDO2, LDO3, LDO4, LDO5, LDO6, LDO7
24
25 The valid names for BD71847 regulator nodes are:
26 BUCK1, BUCK2, BUCK3, BUCK4, BUCK5, BUCK6
27 LDO1, LDO2, LDO3, LDO4, LDO5, LDO6
28
29 Optional properties:
30 - rohm,dvs-run-voltage          : PMIC default "RUN" state voltage in uV.
31                                   See below table for bucks which support this.
32 - rohm,dvs-idle-voltage         : PMIC default "IDLE" state voltage in uV.
33                                   See below table for bucks which support this.
34 - rohm,dvs-suspend-voltage      : PMIC default "SUSPEND" state voltage in uV.
35                                   See below table for bucks which support this.
36 - Any optional property defined in bindings/regulator/regulator.txt
37
38 Supported default DVS states:
39
40 BD71837:
41 buck    | dvs-run-voltage       | dvs-idle-voltage      | dvs-suspend-voltage
42 -----------------------------------------------------------------------------
43 1       | supported             | supported             | supported
44 ----------------------------------------------------------------------------
45 2       | supported             | supported             | not supported
46 ----------------------------------------------------------------------------
47 3       | supported             | not supported         | not supported
48 ----------------------------------------------------------------------------
49 4       | supported             | not supported         | not supported
50 ----------------------------------------------------------------------------
51 rest    | not supported         | not supported         | not supported
52
53 BD71847:
54 buck    | dvs-run-voltage       | dvs-idle-voltage      | dvs-suspend-voltage
55 -----------------------------------------------------------------------------
56 1       | supported             | supported             | supported
57 ----------------------------------------------------------------------------
58 2       | supported             | supported             | not supported
59 ----------------------------------------------------------------------------
60 rest    | not supported         | not supported         | not supported
61
62 Example:
63 regulators {
64         buck1: BUCK1 {
65                 regulator-name = "buck1";
66                 regulator-min-microvolt = <700000>;
67                 regulator-max-microvolt = <1300000>;
68                 regulator-boot-on;
69                 regulator-always-on;
70                 regulator-ramp-delay = <1250>;
71                 rohm,dvs-run-voltage = <900000>;
72                 rohm,dvs-idle-voltage = <850000>;
73                 rohm,dvs-suspend-voltage = <800000>;
74         };
75         buck2: BUCK2 {
76                 regulator-name = "buck2";
77                 regulator-min-microvolt = <700000>;
78                 regulator-max-microvolt = <1300000>;
79                 regulator-boot-on;
80                 regulator-always-on;
81                 regulator-ramp-delay = <1250>;
82                 rohm,dvs-run-voltage = <1000000>;
83                 rohm,dvs-idle-voltage = <900000>;
84         };
85         buck3: BUCK3 {
86                 regulator-name = "buck3";
87                 regulator-min-microvolt = <700000>;
88                 regulator-max-microvolt = <1300000>;
89                 regulator-boot-on;
90                 rohm,dvs-run-voltage = <1000000>;
91         };
92         buck4: BUCK4 {
93                 regulator-name = "buck4";
94                 regulator-min-microvolt = <700000>;
95                 regulator-max-microvolt = <1300000>;
96                 regulator-boot-on;
97                 rohm,dvs-run-voltage = <1000000>;
98         };
99         buck5: BUCK5 {
100                 regulator-name = "buck5";
101                 regulator-min-microvolt = <700000>;
102                 regulator-max-microvolt = <1350000>;
103                 regulator-boot-on;
104         };
105         buck6: BUCK6 {
106                 regulator-name = "buck6";
107                 regulator-min-microvolt = <3000000>;
108                 regulator-max-microvolt = <3300000>;
109                 regulator-boot-on;
110         };
111         buck7: BUCK7 {
112                 regulator-name = "buck7";
113                 regulator-min-microvolt = <1605000>;
114                 regulator-max-microvolt = <1995000>;
115                 regulator-boot-on;
116         };
117         buck8: BUCK8 {
118                 regulator-name = "buck8";
119                 regulator-min-microvolt = <800000>;
120                 regulator-max-microvolt = <1400000>;
121         };
122
123         ldo1: LDO1 {
124                 regulator-name = "ldo1";
125                 regulator-min-microvolt = <3000000>;
126                 regulator-max-microvolt = <3300000>;
127                 regulator-boot-on;
128         };
129         ldo2: LDO2 {
130                 regulator-name = "ldo2";
131                 regulator-min-microvolt = <900000>;
132                 regulator-max-microvolt = <900000>;
133                 regulator-boot-on;
134         };
135         ldo3: LDO3 {
136                 regulator-name = "ldo3";
137                 regulator-min-microvolt = <1800000>;
138                 regulator-max-microvolt = <3300000>;
139         };
140         ldo4: LDO4 {
141                 regulator-name = "ldo4";
142                 regulator-min-microvolt = <900000>;
143                 regulator-max-microvolt = <1800000>;
144         };
145         ldo5: LDO5 {
146                 regulator-name = "ldo5";
147                 regulator-min-microvolt = <1800000>;
148                 regulator-max-microvolt = <3300000>;
149         };
150         ldo6: LDO6 {
151                 regulator-name = "ldo6";
152                 regulator-min-microvolt = <900000>;
153                 regulator-max-microvolt = <1800000>;
154         };
155         ldo7_reg: LDO7 {
156                 regulator-name = "ldo7";
157                 regulator-min-microvolt = <1800000>;
158                 regulator-max-microvolt = <3300000>;
159         };
160 };
161
162