regulator: dt: add policy to have property "regulator-compatible"
[deliverable/linux.git] / Documentation / devicetree / bindings / mfd / tps65910.txt
1 TPS65910 Power Management Integrated Circuit
2
3 Required properties:
4 - compatible: "ti,tps65910" or "ti,tps65911"
5 - reg: I2C slave address
6 - interrupts: the interrupt outputs of the controller
7 - #gpio-cells: number of cells to describe a GPIO, this should be 2.
8 The first cell is the GPIO number.
9 The second cell is used to specify additional options <unused>.
10 - gpio-controller: mark the device as a GPIO controller
11 - #interrupt-cells: the number of cells to describe an IRQ, this should be 2.
12 The first cell is the IRQ number.
13 The second cell is the flags, encoded as the trigger masks from
14 Documentation/devicetree/bindings/interrupts.txt
15 - regulators: This is the list of child nodes that specify the regulator
16 initialization data for defined regulators. Not all regulators for the given
17 device need to be present. The definition for each of these nodes is defined
18 using the standard binding for regulators found at
19 Documentation/devicetree/bindings/regulator/regulator.txt.
20 The regulator is matched with the regulator-compatible.
21
22 The valid regulator-compatible values are:
23 tps65910: vrtc, vio, vdd1, vdd2, vdd3, vdig1, vdig2, vpll, vdac, vaux1,
24 vaux2, vaux33, vmmc
25 tps65911: vrtc, vio, vdd1, vdd3, vddctrl, ldo1, ldo2, ldo3, ldo4, ldo5,
26 ldo6, ldo7, ldo8
27
28 Optional properties:
29 - ti,vmbch-threshold: (tps65911) main battery charged threshold
30 comparator. (see VMBCH_VSEL in TPS65910 datasheet)
31 - ti,vmbch2-threshold: (tps65911) main battery discharged threshold
32 comparator. (see VMBCH_VSEL in TPS65910 datasheet)
33 - ti,en-gpio-sleep: enable sleep control for gpios
34 There should be 9 entries here, one for each gpio.
35
36 Regulator Optional properties:
37 - ti,regulator-ext-sleep-control: enable external sleep
38 control through external inputs [0 (not enabled), 1 (EN1), 2 (EN2) or 4(EN3)]
39 If this property is not defined, it defaults to 0 (not enabled).
40
41 Example:
42
43 pmu: tps65910@d2 {
44 compatible = "ti,tps65910";
45 reg = <0xd2>;
46 interrupt-parent = <&intc>;
47 interrupts = < 0 118 0x04 >;
48
49 #gpio-cells = <2>;
50 gpio-controller;
51
52 #interrupt-cells = <2>;
53 interrupt-controller;
54
55 ti,vmbch-threshold = 0;
56 ti,vmbch2-threshold = 0;
57
58 ti,en-gpio-sleep = <0 0 1 0 0 0 0 0 0>;
59
60 regulators {
61 #address-cells = <1>;
62 #size-cells = <0>;
63
64 vdd1_reg: regulator@0 {
65 regulator-compatible = "vdd1";
66 reg = <0>;
67 regulator-min-microvolt = < 600000>;
68 regulator-max-microvolt = <1500000>;
69 regulator-always-on;
70 regulator-boot-on;
71 ti,regulator-ext-sleep-control = <0>;
72 };
73 vdd2_reg: regulator@1 {
74 regulator-compatible = "vdd2";
75 reg = <1>;
76 regulator-min-microvolt = < 600000>;
77 regulator-max-microvolt = <1500000>;
78 regulator-always-on;
79 regulator-boot-on;
80 ti,regulator-ext-sleep-control = <4>;
81 };
82 vddctrl_reg: regulator@2 {
83 regulator-compatible = "vddctrl";
84 reg = <2>;
85 regulator-min-microvolt = < 600000>;
86 regulator-max-microvolt = <1400000>;
87 regulator-always-on;
88 regulator-boot-on;
89 ti,regulator-ext-sleep-control = <0>;
90 };
91 vio_reg: regulator@3 {
92 regulator-compatible = "vio";
93 reg = <3>;
94 regulator-min-microvolt = <1500000>;
95 regulator-max-microvolt = <1800000>;
96 regulator-always-on;
97 regulator-boot-on;
98 ti,regulator-ext-sleep-control = <1>;
99 };
100 ldo1_reg: regulator@4 {
101 regulator-compatible = "ldo1";
102 reg = <4>;
103 regulator-min-microvolt = <1000000>;
104 regulator-max-microvolt = <3300000>;
105 ti,regulator-ext-sleep-control = <0>;
106 };
107 ldo2_reg: regulator@5 {
108 regulator-compatible = "ldo2";
109 reg = <5>;
110 regulator-min-microvolt = <1050000>;
111 regulator-max-microvolt = <1050000>;
112 ti,regulator-ext-sleep-control = <0>;
113 };
114 ldo3_reg: regulator@6 {
115 regulator-compatible = "ldo3";
116 reg = <6>;
117 regulator-min-microvolt = <1000000>;
118 regulator-max-microvolt = <3300000>;
119 ti,regulator-ext-sleep-control = <0>;
120 };
121 ldo4_reg: regulator@7 {
122 regulator-compatible = "ldo4";
123 reg = <7>;
124 regulator-min-microvolt = <1000000>;
125 regulator-max-microvolt = <3300000>;
126 regulator-always-on;
127 ti,regulator-ext-sleep-control = <0>;
128 };
129 ldo5_reg: regulator@8 {
130 regulator-compatible = "ldo5";
131 reg = <8>;
132 regulator-min-microvolt = <1000000>;
133 regulator-max-microvolt = <3300000>;
134 ti,regulator-ext-sleep-control = <0>;
135 };
136 ldo6_reg: regulator@9 {
137 regulator-compatible = "ldo6";
138 reg = <9>;
139 regulator-min-microvolt = <1200000>;
140 regulator-max-microvolt = <1200000>;
141 ti,regulator-ext-sleep-control = <0>;
142 };
143 ldo7_reg: regulator@10 {
144 regulator-compatible = "ldo7";
145 reg = <10>;
146 regulator-min-microvolt = <1200000>;
147 regulator-max-microvolt = <1200000>;
148 regulator-always-on;
149 regulator-boot-on;
150 ti,regulator-ext-sleep-control = <1>;
151 };
152 ldo8_reg: regulator@11 {
153 regulator-compatible = "ldo8";
154 reg = <11>;
155 regulator-min-microvolt = <1000000>;
156 regulator-max-microvolt = <3300000>;
157 regulator-always-on;
158 ti,regulator-ext-sleep-control = <1>;
159 };
160 };
161 };
This page took 0.036515 seconds and 5 git commands to generate.