Merge branch 'pm-cpufreq'
[cascardo/linux.git] / Documentation / devicetree / bindings / regulator / ltc3676.txt
1 Linear Technology LTC3676 8-output regulators
2
3 Required properties:
4 - compatible: "lltc,ltc3676"
5 - reg: I2C slave address
6
7 Required child node:
8 - regulators: Contains eight regulator child nodes sw1, sw2, sw3, sw4,
9   ldo1, ldo2, ldo3, and ldo4, specifying the initialization data as
10   documented in Documentation/devicetree/bindings/regulator/regulator.txt.
11
12 Each regulator is defined using the standard binding for regulators. The
13 nodes for sw1, sw2, sw3, sw4, ldo1, ldo2 and ldo4 additionally need to specify
14 the resistor values of their external feedback voltage dividers:
15
16 Required properties (not on ldo3):
17 - lltc,fb-voltage-divider: An array of two integers containing the resistor
18   values R1 and R2 of the feedback voltage divider in ohms.
19
20 Regulators sw1, sw2, sw3, sw4 can regulate the feedback reference from:
21 412.5mV to 800mV in 12.5 mV steps. The output voltage thus ranges between
22 0.4125 * (1 + R1/R2) V and 0.8 * (1 + R1/R2) V.
23
24 Regulators ldo1, ldo2, and ldo4 have a fixed 0.725 V reference and thus output
25 0.725 * (1 + R1/R2) V. The ldo3 regulator is fixed to 1.8 V.  The ldo1 standby
26 regulator can not be disabled and thus should have the regulator-always-on
27 property set.
28
29 Example:
30
31         ltc3676: pmic@3c {
32                 compatible = "lltc,ltc3676";
33                 reg = <0x3c>;
34
35                 regulators {
36                         sw1_reg: sw1 {
37                                 regulator-min-microvolt = <674400>;
38                                 regulator-max-microvolt = <1308000>;
39                                 lltc,fb-voltage-divider = <127000 200000>;
40                                 regulator-ramp-delay = <7000>;
41                                 regulator-boot-on;
42                                 regulator-always-on;
43                         };
44
45                         sw2_reg: sw2 {
46                                 regulator-min-microvolt = <1033310>;
47                                 regulator-max-microvolt = <200400>;
48                                 lltc,fb-voltage-divider = <301000 200000>;
49                                 regulator-ramp-delay = <7000>;
50                                 regulator-boot-on;
51                                 regulator-always-on;
52                         };
53
54                         sw3_reg: sw3 {
55                                 regulator-min-microvolt = <674400>;
56                                 regulator-max-microvolt = <130800>;
57                                 lltc,fb-voltage-divider = <127000 200000>;
58                                 regulator-ramp-delay = <7000>;
59                                 regulator-boot-on;
60                                 regulator-always-on;
61                         };
62
63                         sw4_reg: sw4 {
64                                 regulator-min-microvolt = <868310>;
65                                 regulator-max-microvolt = <168400>;
66                                 lltc,fb-voltage-divider = <221000 200000>;
67                                 regulator-ramp-delay = <7000>;
68                                 regulator-boot-on;
69                                 regulator-always-on;
70                         };
71
72                         ldo2_reg: ldo2 {
73                                 regulator-min-microvolt = <2490375>;
74                                 regulator-max-microvolt = <2490375>;
75                                 lltc,fb-voltage-divider = <487000 200000>;
76                                 regulator-boot-on;
77                                 regulator-always-on;
78                         };
79
80                         ldo3_reg: ldo3 {
81                                 regulator-min-microvolt = <1800000>;
82                                 regulator-max-microvolt = <1800000>;
83                                 regulator-boot-on;
84                         };
85
86                         ldo4_reg: ldo4 {
87                                 regulator-min-microvolt = <3023250>;
88                                 regulator-max-microvolt = <3023250>;
89                                 lltc,fb-voltage-divider = <634000 200000>;
90                                 regulator-boot-on;
91                                 regulator-always-on;
92                         };
93                 };
94         };