xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/as3722-regulator.txt (revision cfd6422a5217410fbd66f7a7a8a64d9d85e61229)
1Regulator of AMS AS3722 PMIC.
2Name of the regulator subnode must be "regulators".
3
4Optional properties:
5--------------------
6The input supply of regulators are the optional properties on the
7regulator node. The AS3722 is having 7 DCDC step-down regulators as
8sd[0-6], 10 LDOs as ldo[0-7], ldo[9-11]. The input supply of these
9regulators are provided through following properties:
10vsup-sd2-supply: Input supply for SD2.
11vsup-sd3-supply: Input supply for SD3.
12vsup-sd4-supply: Input supply for SD4.
13vsup-sd5-supply: Input supply for SD5.
14vin-ldo0-supply: Input supply for LDO0.
15vin-ldo1-6-supply: Input supply for LDO1 and LDO6.
16vin-ldo2-5-7-supply: Input supply for LDO2, LDO5 and LDO7.
17vin-ldo3-4-supply: Input supply for LDO3 and LDO4.
18vin-ldo9-10-supply: Input supply for LDO9 and LDO10.
19vin-ldo11-supply: Input supply for LDO11.
20
21Optional nodes:
22--------------
23- regulators : Must contain a sub-node per regulator from the list below.
24	       Each sub-node should contain the constraints and initialization
25	       information for that regulator. See regulator.txt for a
26	       description of standard properties for these sub-nodes.
27	       Additional custom properties  are listed below.
28	       sd[0-6], ldo[0-7], ldo[9-11].
29
30	       Optional sub-node properties:
31	       ----------------------------
32		ams,ext-control: External control of the rail. The option of
33			this properties will tell which external input is
34			controlling this rail. Valid values are 0, 1, 2 ad 3.
35			0: There is no external control of this rail.
36			1: Rail is controlled by ENABLE1 input pin.
37			2: Rail is controlled by ENABLE2 input pin.
38			3: Rail is controlled by ENABLE3 input pin.
39		ams,enable-tracking: Enable tracking with SD1, only supported
40			by LDO3.
41
42Example:
43-------
44	ams3722: ams3722 {
45		compatible = "ams,as3722";
46		reg = <0x40>;
47		...
48
49		regulators {
50			vsup-sd2-supply = <...>;
51			...
52
53			sd0 {
54				regulator-name = "vdd_cpu";
55				regulator-min-microvolt = <700000>;
56				regulator-max-microvolt = <1400000>;
57				regulator-always-on;
58				ams,ext-control = <2>;
59			};
60
61			sd1 {
62				regulator-name = "vdd_core";
63				regulator-min-microvolt = <700000>;
64				regulator-max-microvolt = <1400000>;
65				regulator-always-on;
66				ams,ext-control = <1>;
67			};
68
69			sd2 {
70				regulator-name = "vddio_ddr";
71				regulator-min-microvolt = <1350000>;
72				regulator-max-microvolt = <1350000>;
73				regulator-always-on;
74			};
75
76			sd4 {
77				regulator-name = "avdd-hdmi-pex";
78				regulator-min-microvolt = <1050000>;
79				regulator-max-microvolt = <1050000>;
80				regulator-always-on;
81			};
82
83			sd5 {
84				regulator-name = "vdd-1v8";
85				regulator-min-microvolt = <1800000>;
86				regulator-max-microvolt = <1800000>;
87				regulator-always-on;
88			};
89			....
90		};
91	};
92