Merge branch 'topic/cs46xx-drop-fw' into for-next
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / regulator / as3722-regulator.txt
1 Regulator of AMS AS3722 PMIC.
2 Name of the regulator subnode must be "regulators".
3
4 Optional properties:
5 --------------------
6 The input supply of regulators are the optional properties on the
7 regulator node. The AS3722 is having 7 DCDC step-down regulators as
8 sd[0-6], 10 LDOs as ldo[0-7], ldo[9-11]. The input supply of these
9 regulators are provided through following properties:
10 vsup-sd2-supply: Input supply for SD2.
11 vsup-sd3-supply: Input supply for SD3.
12 vsup-sd4-supply: Input supply for SD4.
13 vsup-sd5-supply: Input supply for SD5.
14 vin-ldo0-supply: Input supply for LDO0.
15 vin-ldo1-6-supply: Input supply for LDO1 and LDO6.
16 vin-ldo2-5-7-supply: Input supply for LDO2, LDO5 and LDO7.
17 vin-ldo3-4-supply: Input supply for LDO3 and LDO4.
18 vin-ldo9-10-supply: Input supply for LDO9 and LDO10.
19 vin-ldo11-supply: Input supply for LDO11.
20
21 Optional 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
42 Example:
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         };