GNU Linux-libre 4.14.266-gnu1
[releases.git] / Documentation / devicetree / bindings / mfd / ti-lmu.txt
1 TI LMU (Lighting Management Unit) device tree bindings
2
3 TI LMU driver supports lighting devices below.
4
5    Name                  Child nodes
6   ------      ---------------------------------
7   LM3532       Backlight
8   LM3631       Backlight and regulator
9   LM3632       Backlight and regulator
10   LM3633       Backlight, LED and fault monitor
11   LM3695       Backlight
12   LM3697       Backlight and fault monitor
13
14 Required properties:
15   - compatible: Should be one of:
16                 "ti,lm3532"
17                 "ti,lm3631"
18                 "ti,lm3632"
19                 "ti,lm3633"
20                 "ti,lm3695"
21                 "ti,lm3697"
22   - reg: I2C slave address.
23          0x11 for LM3632
24          0x29 for LM3631
25          0x36 for LM3633, LM3697
26          0x38 for LM3532
27          0x63 for LM3695
28
29 Optional property:
30   - enable-gpios: A GPIO specifier for hardware enable pin.
31
32 Required node:
33   - backlight: All LMU devices have backlight child nodes.
34                For the properties, please refer to [1].
35
36 Optional nodes:
37   - fault-monitor: Hardware fault monitoring driver for LM3633 and LM3697.
38     Required properties:
39       - compatible: Should be one of:
40                     "ti,lm3633-fault-monitor"
41                     "ti,lm3697-fault-monitor"
42   - leds: LED properties for LM3633. Please refer to [2].
43   - regulators: Regulator properties for LM3631 and LM3632.
44                 Please refer to [3].
45
46 [1] ../leds/backlight/ti-lmu-backlight.txt
47 [2] ../leds/leds-lm3633.txt
48 [3] ../regulator/lm363x-regulator.txt
49
50 lm3532@38 {
51         compatible = "ti,lm3532";
52         reg = <0x38>;
53
54         enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>;
55
56         backlight {
57                 compatible = "ti,lm3532-backlight";
58
59                 lcd {
60                         led-sources = <0 1 2>;
61                         ramp-up-msec = <30>;
62                         ramp-down-msec = <0>;
63                 };
64         };
65 };
66
67 lm3631@29 {
68         compatible = "ti,lm3631";
69         reg = <0x29>;
70
71         regulators {
72                 compatible = "ti,lm363x-regulator";
73
74                 vboost {
75                         regulator-name = "lcd_boost";
76                         regulator-min-microvolt = <4500000>;
77                         regulator-max-microvolt = <6350000>;
78                         regulator-always-on;
79                 };
80
81                 vcont {
82                         regulator-name = "lcd_vcont";
83                         regulator-min-microvolt = <1800000>;
84                         regulator-max-microvolt = <3300000>;
85                 };
86
87                 voref {
88                         regulator-name = "lcd_voref";
89                         regulator-min-microvolt = <4000000>;
90                         regulator-max-microvolt = <6000000>;
91                 };
92
93                 vpos {
94                         regulator-name = "lcd_vpos";
95                         regulator-min-microvolt = <4000000>;
96                         regulator-max-microvolt = <6000000>;
97                         regulator-boot-on;
98                 };
99
100                 vneg {
101                         regulator-name = "lcd_vneg";
102                         regulator-min-microvolt = <4000000>;
103                         regulator-max-microvolt = <6000000>;
104                         regulator-boot-on;
105                 };
106         };
107
108         backlight {
109                 compatible = "ti,lm3631-backlight";
110
111                 lcd_bl {
112                         led-sources = <0 1>;
113                         ramp-up-msec = <300>;
114                 };
115         };
116 };
117
118 lm3632@11 {
119         compatible = "ti,lm3632";
120         reg = <0x11>;
121
122         enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>; /* PC2 */
123
124         regulators {
125                 compatible = "ti,lm363x-regulator";
126
127                 ti,lcm-en1-gpio = <&pioC 0 GPIO_ACTIVE_HIGH>; /* PC0 */
128                 ti,lcm-en2-gpio = <&pioC 1 GPIO_ACTIVE_HIGH>; /* PC1 */
129
130                 vboost {
131                         regulator-name = "lcd_boost";
132                         regulator-min-microvolt = <4500000>;
133                         regulator-max-microvolt = <6400000>;
134                         regulator-always-on;
135                 };
136
137                 vpos {
138                         regulator-name = "lcd_vpos";
139                         regulator-min-microvolt = <4000000>;
140                         regulator-max-microvolt = <6000000>;
141                 };
142
143                 vneg {
144                         regulator-name = "lcd_vneg";
145                         regulator-min-microvolt = <4000000>;
146                         regulator-max-microvolt = <6000000>;
147                 };
148         };
149
150         backlight {
151                 compatible = "ti,lm3632-backlight";
152
153                 pwms = <&pwm0 0 10000 0>; /* pwm number, period, polarity */
154                 pwm-names = "lmu-backlight";
155
156                 lcd {
157                         led-sources = <0 1>;
158                         pwm-period = <10000>;
159                 };
160         };
161 };
162
163 lm3633@36 {
164         compatible = "ti,lm3633";
165         reg = <0x36>;
166
167         enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>;
168
169         backlight {
170                 compatible = "ti,lm3633-backlight";
171
172                 main {
173                         label = "main_lcd";
174                         led-sources = <1 2>;
175                         ramp-up-msec = <500>;
176                         ramp-down-msec = <500>;
177                 };
178
179                 front {
180                         label = "front_lcd";
181                         led-sources = <0>;
182                         ramp-up-msec = <1000>;
183                         ramp-down-msec = <0>;
184                 };
185         };
186
187         leds {
188                 compatible = "ti,lm3633-leds";
189
190                 chan1 {
191                         label = "status";
192                         led-sources = <1>;
193                         led-max-microamp = <6000>;
194                 };
195
196                 chan345 {
197                         label = "rgb";
198                         led-sources = <3 4 5>;
199                         led-max-microamp = <10000>;
200                 };
201         };
202
203         fault-monitor {
204                 compatible = "ti,lm3633-fault-monitor";
205         };
206 };
207
208 lm3695@63 {
209         compatible = "ti,lm3695";
210         reg = <0x63>;
211
212         enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>;
213
214         backlight {
215                 compatible = "ti,lm3695-backlight";
216
217                 lcd {
218                         label = "bl";
219                         led-sources = <0 1>;
220                 };
221         };
222 };
223
224 lm3697@36 {
225         compatible = "ti,lm3697";
226         reg = <0x36>;
227
228         enable-gpios = <&pioC 2 GPIO_ACTIVE_HIGH>;
229
230         backlight {
231                 compatible = "ti,lm3697-backlight";
232
233                 lcd {
234                         led-sources = <0 1 2>;
235                         ramp-up-msec = <200>;
236                         ramp-down-msec = <200>;
237                 };
238         };
239
240         fault-monitor {
241                 compatible = "ti,lm3697-fault-monitor";
242         };
243 };