GNU Linux-libre 4.19.264-gnu1
[releases.git] / Documentation / devicetree / bindings / regulator / tps6586x.txt
1 TPS6586x family of regulators
2
3 Required properties:
4 - compatible: "ti,tps6586x"
5 - reg: I2C slave address
6 - interrupts: the interrupt outputs of the controller
7 - #gpio-cells: number of cells to describe a GPIO
8 - gpio-controller: mark the device as a GPIO controller
9 - regulators: A node that houses a sub-node for each regulator within the
10   device. Each sub-node is identified using the node's name (or the deprecated
11   regulator-compatible property if present), with valid values listed below.
12   The content of each sub-node is defined by the standard binding for
13   regulators; see regulator.txt.
14   sys, sm[0-2], ldo[0-9] and ldo_rtc
15 - sys-supply: The input supply for SYS.
16 - vin-sm0-supply: The input supply for the SM0.
17 - vin-sm1-supply: The input supply for the SM1.
18 - vin-sm2-supply: The input supply for the SM2.
19 - vinldo01-supply: The input supply for the LDO1 and LDO2
20 - vinldo23-supply: The input supply for the LDO2 and LDO3
21 - vinldo4-supply: The input supply for the LDO4
22 - vinldo678-supply: The input supply for the LDO6, LDO7 and LDO8
23 - vinldo9-supply: The input supply for the LDO9
24
25 Optional properties:
26 - ti,system-power-controller: Telling whether or not this pmic is controlling
27   the system power.
28
29 Each regulator is defined using the standard binding for regulators.
30
31 Note: LDO5 and LDO_RTC is supplied by SYS regulator internally and driver
32       take care of making proper parent child relationship.
33
34 Example:
35
36         pmu: tps6586x@34 {
37                 compatible = "ti,tps6586x";
38                 reg = <0x34>;
39                 interrupts = <0 88 0x4>;
40
41                 #gpio-cells = <2>;
42                 gpio-controller;
43
44                 ti,system-power-controller;
45
46                 sys-supply = <&some_reg>;
47                 vin-sm0-supply = <&some_reg>;
48                 vin-sm1-supply = <&some_reg>;
49                 vin-sm2-supply = <&some_reg>;
50                 vinldo01-supply = <...>;
51                 vinldo23-supply = <...>;
52                 vinldo4-supply = <...>;
53                 vinldo678-supply = <...>;
54                 vinldo9-supply = <...>;
55
56                 regulators {
57                         sys_reg: sys {
58                                 regulator-name = "vdd_sys";
59                                 regulator-boot-on;
60                                 regulator-always-on;
61                         };
62
63                         sm0_reg: sm0 {
64                                 regulator-min-microvolt = < 725000>;
65                                 regulator-max-microvolt = <1500000>;
66                                 regulator-boot-on;
67                                 regulator-always-on;
68                         };
69
70                         sm1_reg: sm1 {
71                                 regulator-min-microvolt = < 725000>;
72                                 regulator-max-microvolt = <1500000>;
73                                 regulator-boot-on;
74                                 regulator-always-on;
75                         };
76
77                         sm2_reg: sm2 {
78                                 regulator-min-microvolt = <3000000>;
79                                 regulator-max-microvolt = <4550000>;
80                                 regulator-boot-on;
81                                 regulator-always-on;
82                         };
83
84                         ldo0_reg: ldo0 {
85                                 regulator-name = "PCIE CLK";
86                                 regulator-min-microvolt = <3300000>;
87                                 regulator-max-microvolt = <3300000>;
88                         };
89
90                         ldo1_reg: ldo1 {
91                                 regulator-min-microvolt = < 725000>;
92                                 regulator-max-microvolt = <1500000>;
93                         };
94
95                         ldo2_reg: ldo2 {
96                                 regulator-min-microvolt = < 725000>;
97                                 regulator-max-microvolt = <1500000>;
98                         };
99
100                         ldo3_reg: ldo3 {
101                                 regulator-min-microvolt = <1250000>;
102                                 regulator-max-microvolt = <3300000>;
103                         };
104
105                         ldo4_reg: ldo4 {
106                                 regulator-min-microvolt = <1700000>;
107                                 regulator-max-microvolt = <2475000>;
108                         };
109
110                         ldo5_reg: ldo5 {
111                                 regulator-min-microvolt = <1250000>;
112                                 regulator-max-microvolt = <3300000>;
113                         };
114
115                         ldo6_reg: ldo6 {
116                                 regulator-min-microvolt = <1250000>;
117                                 regulator-max-microvolt = <3300000>;
118                         };
119
120                         ldo7_reg: ldo7 {
121                                 regulator-min-microvolt = <1250000>;
122                                 regulator-max-microvolt = <3300000>;
123                         };
124
125                         ldo8_reg: ldo8 {
126                                 regulator-min-microvolt = <1250000>;
127                                 regulator-max-microvolt = <3300000>;
128                         };
129
130                         ldo9_reg: ldo9 {
131                                 regulator-min-microvolt = <1250000>;
132                                 regulator-max-microvolt = <3300000>;
133                         };
134                 };
135         };