xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/ltc3676.txt (revision d4eeb02986980bf33dd56c41ceb9fc5f180c0d47)
1Linear Technology LTC3676 8-output regulators
2
3Required properties:
4- compatible: "lltc,ltc3676"
5- reg: I2C slave address
6
7Required 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
12Each regulator is defined using the standard binding for regulators. The
13nodes for sw1, sw2, sw3, sw4, ldo1, ldo2 and ldo4 additionally need to specify
14the resistor values of their external feedback voltage dividers:
15
16Required 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
20Regulators sw1, sw2, sw3, sw4 can regulate the feedback reference from:
21412.5mV to 800mV in 12.5 mV steps. The output voltage thus ranges between
220.4125 * (1 + R1/R2) V and 0.8 * (1 + R1/R2) V.
23
24Regulators ldo1, ldo2, and ldo4 have a fixed 0.725 V reference and thus output
250.725 * (1 + R1/R2) V. The ldo3 regulator is fixed to 1.8 V.  The ldo1 standby
26regulator can not be disabled and thus should have the regulator-always-on
27property set.
28
29Example:
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	};
95