xref: /linux/drivers/video/backlight/as3711_bl.c (revision e0bf6c5ca2d3281f231c5f0c9bf145e9513644de)
1 /*
2  * AS3711 PMIC backlight driver, using DCDC Step Up Converters
3  *
4  * Copyright (C) 2012 Renesas Electronics Corporation
5  * Author: Guennadi Liakhovetski, <g.liakhovetski@gmx.de>
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the version 2 of the GNU General Public License as
9  * published by the Free Software Foundation
10  */
11 
12 #include <linux/backlight.h>
13 #include <linux/delay.h>
14 #include <linux/device.h>
15 #include <linux/err.h>
16 #include <linux/fb.h>
17 #include <linux/kernel.h>
18 #include <linux/mfd/as3711.h>
19 #include <linux/module.h>
20 #include <linux/platform_device.h>
21 #include <linux/regmap.h>
22 #include <linux/slab.h>
23 
24 enum as3711_bl_type {
25 	AS3711_BL_SU1,
26 	AS3711_BL_SU2,
27 };
28 
29 struct as3711_bl_data {
30 	bool powered;
31 	const char *fb_name;
32 	struct device *fb_dev;
33 	enum as3711_bl_type type;
34 	int brightness;
35 	struct backlight_device *bl;
36 };
37 
38 struct as3711_bl_supply {
39 	struct as3711_bl_data su1;
40 	struct as3711_bl_data su2;
41 	const struct as3711_bl_pdata *pdata;
42 	struct as3711 *as3711;
43 };
44 
45 static struct as3711_bl_supply *to_supply(struct as3711_bl_data *su)
46 {
47 	switch (su->type) {
48 	case AS3711_BL_SU1:
49 		return container_of(su, struct as3711_bl_supply, su1);
50 	case AS3711_BL_SU2:
51 		return container_of(su, struct as3711_bl_supply, su2);
52 	}
53 	return NULL;
54 }
55 
56 static int as3711_set_brightness_auto_i(struct as3711_bl_data *data,
57 					unsigned int brightness)
58 {
59 	struct as3711_bl_supply *supply = to_supply(data);
60 	struct as3711 *as3711 = supply->as3711;
61 	const struct as3711_bl_pdata *pdata = supply->pdata;
62 	int ret = 0;
63 
64 	/* Only all equal current values are supported */
65 	if (pdata->su2_auto_curr1)
66 		ret = regmap_write(as3711->regmap, AS3711_CURR1_VALUE,
67 				   brightness);
68 	if (!ret && pdata->su2_auto_curr2)
69 		ret = regmap_write(as3711->regmap, AS3711_CURR2_VALUE,
70 				   brightness);
71 	if (!ret && pdata->su2_auto_curr3)
72 		ret = regmap_write(as3711->regmap, AS3711_CURR3_VALUE,
73 				   brightness);
74 
75 	return ret;
76 }
77 
78 static int as3711_set_brightness_v(struct as3711 *as3711,
79 				   unsigned int brightness,
80 				   unsigned int reg)
81 {
82 	if (brightness > 31)
83 		return -EINVAL;
84 
85 	return regmap_update_bits(as3711->regmap, reg, 0xf0,
86 				  brightness << 4);
87 }
88 
89 static int as3711_bl_su2_reset(struct as3711_bl_supply *supply)
90 {
91 	struct as3711 *as3711 = supply->as3711;
92 	int ret = regmap_update_bits(as3711->regmap, AS3711_STEPUP_CONTROL_5,
93 				     3, supply->pdata->su2_fbprot);
94 	if (!ret)
95 		ret = regmap_update_bits(as3711->regmap,
96 					 AS3711_STEPUP_CONTROL_2, 1, 0);
97 	if (!ret)
98 		ret = regmap_update_bits(as3711->regmap,
99 					 AS3711_STEPUP_CONTROL_2, 1, 1);
100 	return ret;
101 }
102 
103 /*
104  * Someone with less fragile or less expensive hardware could try to simplify
105  * the brightness adjustment procedure.
106  */
107 static int as3711_bl_update_status(struct backlight_device *bl)
108 {
109 	struct as3711_bl_data *data = bl_get_data(bl);
110 	struct as3711_bl_supply *supply = to_supply(data);
111 	struct as3711 *as3711 = supply->as3711;
112 	int brightness = bl->props.brightness;
113 	int ret = 0;
114 
115 	dev_dbg(&bl->dev, "%s(): brightness %u, pwr %x, blank %x, state %x\n",
116 		__func__, bl->props.brightness, bl->props.power,
117 		bl->props.fb_blank, bl->props.state);
118 
119 	if (bl->props.power != FB_BLANK_UNBLANK ||
120 	    bl->props.fb_blank != FB_BLANK_UNBLANK ||
121 	    bl->props.state & (BL_CORE_SUSPENDED | BL_CORE_FBBLANK))
122 		brightness = 0;
123 
124 	if (data->type == AS3711_BL_SU1) {
125 		ret = as3711_set_brightness_v(as3711, brightness,
126 					      AS3711_STEPUP_CONTROL_1);
127 	} else {
128 		const struct as3711_bl_pdata *pdata = supply->pdata;
129 
130 		switch (pdata->su2_feedback) {
131 		case AS3711_SU2_VOLTAGE:
132 			ret = as3711_set_brightness_v(as3711, brightness,
133 						      AS3711_STEPUP_CONTROL_2);
134 			break;
135 		case AS3711_SU2_CURR_AUTO:
136 			ret = as3711_set_brightness_auto_i(data, brightness / 4);
137 			if (ret < 0)
138 				return ret;
139 			if (brightness) {
140 				ret = as3711_bl_su2_reset(supply);
141 				if (ret < 0)
142 					return ret;
143 				udelay(500);
144 				ret = as3711_set_brightness_auto_i(data, brightness);
145 			} else {
146 				ret = regmap_update_bits(as3711->regmap,
147 						AS3711_STEPUP_CONTROL_2, 1, 0);
148 			}
149 			break;
150 		/* Manual one current feedback pin below */
151 		case AS3711_SU2_CURR1:
152 			ret = regmap_write(as3711->regmap, AS3711_CURR1_VALUE,
153 					   brightness);
154 			break;
155 		case AS3711_SU2_CURR2:
156 			ret = regmap_write(as3711->regmap, AS3711_CURR2_VALUE,
157 					   brightness);
158 			break;
159 		case AS3711_SU2_CURR3:
160 			ret = regmap_write(as3711->regmap, AS3711_CURR3_VALUE,
161 					   brightness);
162 			break;
163 		default:
164 			ret = -EINVAL;
165 		}
166 	}
167 	if (!ret)
168 		data->brightness = brightness;
169 
170 	return ret;
171 }
172 
173 static int as3711_bl_get_brightness(struct backlight_device *bl)
174 {
175 	struct as3711_bl_data *data = bl_get_data(bl);
176 
177 	return data->brightness;
178 }
179 
180 static const struct backlight_ops as3711_bl_ops = {
181 	.update_status	= as3711_bl_update_status,
182 	.get_brightness	= as3711_bl_get_brightness,
183 };
184 
185 static int as3711_bl_init_su2(struct as3711_bl_supply *supply)
186 {
187 	struct as3711 *as3711 = supply->as3711;
188 	const struct as3711_bl_pdata *pdata = supply->pdata;
189 	u8 ctl = 0;
190 	int ret;
191 
192 	dev_dbg(as3711->dev, "%s(): use %u\n", __func__, pdata->su2_feedback);
193 
194 	/* Turn SU2 off */
195 	ret = regmap_write(as3711->regmap, AS3711_STEPUP_CONTROL_2, 0);
196 	if (ret < 0)
197 		return ret;
198 
199 	switch (pdata->su2_feedback) {
200 	case AS3711_SU2_VOLTAGE:
201 		ret = regmap_update_bits(as3711->regmap, AS3711_STEPUP_CONTROL_4, 3, 0);
202 		break;
203 	case AS3711_SU2_CURR1:
204 		ctl = 1;
205 		ret = regmap_update_bits(as3711->regmap, AS3711_STEPUP_CONTROL_4, 3, 1);
206 		break;
207 	case AS3711_SU2_CURR2:
208 		ctl = 4;
209 		ret = regmap_update_bits(as3711->regmap, AS3711_STEPUP_CONTROL_4, 3, 2);
210 		break;
211 	case AS3711_SU2_CURR3:
212 		ctl = 0x10;
213 		ret = regmap_update_bits(as3711->regmap, AS3711_STEPUP_CONTROL_4, 3, 3);
214 		break;
215 	case AS3711_SU2_CURR_AUTO:
216 		if (pdata->su2_auto_curr1)
217 			ctl = 2;
218 		if (pdata->su2_auto_curr2)
219 			ctl |= 8;
220 		if (pdata->su2_auto_curr3)
221 			ctl |= 0x20;
222 		ret = 0;
223 		break;
224 	default:
225 		return -EINVAL;
226 	}
227 
228 	if (!ret)
229 		ret = regmap_write(as3711->regmap, AS3711_CURR_CONTROL, ctl);
230 
231 	return ret;
232 }
233 
234 static int as3711_bl_register(struct platform_device *pdev,
235 			      unsigned int max_brightness, struct as3711_bl_data *su)
236 {
237 	struct backlight_properties props = {.type = BACKLIGHT_RAW,};
238 	struct backlight_device *bl;
239 
240 	/* max tuning I = 31uA for voltage- and 38250uA for current-feedback */
241 	props.max_brightness = max_brightness;
242 
243 	bl = devm_backlight_device_register(&pdev->dev,
244 				       su->type == AS3711_BL_SU1 ?
245 				       "as3711-su1" : "as3711-su2",
246 				       &pdev->dev, su,
247 				       &as3711_bl_ops, &props);
248 	if (IS_ERR(bl)) {
249 		dev_err(&pdev->dev, "failed to register backlight\n");
250 		return PTR_ERR(bl);
251 	}
252 
253 	bl->props.brightness = props.max_brightness;
254 
255 	backlight_update_status(bl);
256 
257 	su->bl = bl;
258 
259 	return 0;
260 }
261 
262 static int as3711_backlight_parse_dt(struct device *dev)
263 {
264 	struct as3711_bl_pdata *pdata = dev_get_platdata(dev);
265 	struct device_node *bl =
266 		of_find_node_by_name(dev->parent->of_node, "backlight"), *fb;
267 	int ret;
268 
269 	if (!bl) {
270 		dev_dbg(dev, "backlight node not found\n");
271 		return -ENODEV;
272 	}
273 
274 	fb = of_parse_phandle(bl, "su1-dev", 0);
275 	if (fb) {
276 		pdata->su1_fb = fb->full_name;
277 
278 		ret = of_property_read_u32(bl, "su1-max-uA", &pdata->su1_max_uA);
279 		if (pdata->su1_max_uA <= 0)
280 			ret = -EINVAL;
281 		if (ret < 0)
282 			return ret;
283 	}
284 
285 	fb = of_parse_phandle(bl, "su2-dev", 0);
286 	if (fb) {
287 		int count = 0;
288 
289 		pdata->su2_fb = fb->full_name;
290 
291 		ret = of_property_read_u32(bl, "su2-max-uA", &pdata->su2_max_uA);
292 		if (pdata->su2_max_uA <= 0)
293 			ret = -EINVAL;
294 		if (ret < 0)
295 			return ret;
296 
297 		if (of_find_property(bl, "su2-feedback-voltage", NULL)) {
298 			pdata->su2_feedback = AS3711_SU2_VOLTAGE;
299 			count++;
300 		}
301 		if (of_find_property(bl, "su2-feedback-curr1", NULL)) {
302 			pdata->su2_feedback = AS3711_SU2_CURR1;
303 			count++;
304 		}
305 		if (of_find_property(bl, "su2-feedback-curr2", NULL)) {
306 			pdata->su2_feedback = AS3711_SU2_CURR2;
307 			count++;
308 		}
309 		if (of_find_property(bl, "su2-feedback-curr3", NULL)) {
310 			pdata->su2_feedback = AS3711_SU2_CURR3;
311 			count++;
312 		}
313 		if (of_find_property(bl, "su2-feedback-curr-auto", NULL)) {
314 			pdata->su2_feedback = AS3711_SU2_CURR_AUTO;
315 			count++;
316 		}
317 		if (count != 1)
318 			return -EINVAL;
319 
320 		count = 0;
321 		if (of_find_property(bl, "su2-fbprot-lx-sd4", NULL)) {
322 			pdata->su2_fbprot = AS3711_SU2_LX_SD4;
323 			count++;
324 		}
325 		if (of_find_property(bl, "su2-fbprot-gpio2", NULL)) {
326 			pdata->su2_fbprot = AS3711_SU2_GPIO2;
327 			count++;
328 		}
329 		if (of_find_property(bl, "su2-fbprot-gpio3", NULL)) {
330 			pdata->su2_fbprot = AS3711_SU2_GPIO3;
331 			count++;
332 		}
333 		if (of_find_property(bl, "su2-fbprot-gpio4", NULL)) {
334 			pdata->su2_fbprot = AS3711_SU2_GPIO4;
335 			count++;
336 		}
337 		if (count != 1)
338 			return -EINVAL;
339 
340 		count = 0;
341 		if (of_find_property(bl, "su2-auto-curr1", NULL)) {
342 			pdata->su2_auto_curr1 = true;
343 			count++;
344 		}
345 		if (of_find_property(bl, "su2-auto-curr2", NULL)) {
346 			pdata->su2_auto_curr2 = true;
347 			count++;
348 		}
349 		if (of_find_property(bl, "su2-auto-curr3", NULL)) {
350 			pdata->su2_auto_curr3 = true;
351 			count++;
352 		}
353 
354 		/*
355 		 * At least one su2-auto-curr* must be specified iff
356 		 * AS3711_SU2_CURR_AUTO is used
357 		 */
358 		if (!count ^ (pdata->su2_feedback != AS3711_SU2_CURR_AUTO))
359 			return -EINVAL;
360 	}
361 
362 	return 0;
363 }
364 
365 static int as3711_backlight_probe(struct platform_device *pdev)
366 {
367 	struct as3711_bl_pdata *pdata = dev_get_platdata(&pdev->dev);
368 	struct as3711 *as3711 = dev_get_drvdata(pdev->dev.parent);
369 	struct as3711_bl_supply *supply;
370 	struct as3711_bl_data *su;
371 	unsigned int max_brightness;
372 	int ret;
373 
374 	if (!pdata) {
375 		dev_err(&pdev->dev, "No platform data, exiting...\n");
376 		return -ENODEV;
377 	}
378 
379 	if (pdev->dev.parent->of_node) {
380 		ret = as3711_backlight_parse_dt(&pdev->dev);
381 		if (ret < 0) {
382 			dev_err(&pdev->dev, "DT parsing failed: %d\n", ret);
383 			return ret;
384 		}
385 	}
386 
387 	if (!pdata->su1_fb && !pdata->su2_fb) {
388 		dev_err(&pdev->dev, "No framebuffer specified\n");
389 		return -EINVAL;
390 	}
391 
392 	/*
393 	 * Due to possible hardware damage I chose to block all modes,
394 	 * unsupported on my hardware. Anyone, wishing to use any of those modes
395 	 * will have to first review the code, then activate and test it.
396 	 */
397 	if (pdata->su1_fb ||
398 	    pdata->su2_fbprot != AS3711_SU2_GPIO4 ||
399 	    pdata->su2_feedback != AS3711_SU2_CURR_AUTO) {
400 		dev_warn(&pdev->dev,
401 			 "Attention! An untested mode has been chosen!\n"
402 			 "Please, review the code, enable, test, and report success:-)\n");
403 		return -EINVAL;
404 	}
405 
406 	supply = devm_kzalloc(&pdev->dev, sizeof(*supply), GFP_KERNEL);
407 	if (!supply)
408 		return -ENOMEM;
409 
410 	supply->as3711 = as3711;
411 	supply->pdata = pdata;
412 
413 	if (pdata->su1_fb) {
414 		su = &supply->su1;
415 		su->fb_name = pdata->su1_fb;
416 		su->type = AS3711_BL_SU1;
417 
418 		max_brightness = min(pdata->su1_max_uA, 31);
419 		ret = as3711_bl_register(pdev, max_brightness, su);
420 		if (ret < 0)
421 			return ret;
422 	}
423 
424 	if (pdata->su2_fb) {
425 		su = &supply->su2;
426 		su->fb_name = pdata->su2_fb;
427 		su->type = AS3711_BL_SU2;
428 
429 		switch (pdata->su2_fbprot) {
430 		case AS3711_SU2_GPIO2:
431 		case AS3711_SU2_GPIO3:
432 		case AS3711_SU2_GPIO4:
433 		case AS3711_SU2_LX_SD4:
434 			break;
435 		default:
436 			return -EINVAL;
437 		}
438 
439 		switch (pdata->su2_feedback) {
440 		case AS3711_SU2_VOLTAGE:
441 			max_brightness = min(pdata->su2_max_uA, 31);
442 			break;
443 		case AS3711_SU2_CURR1:
444 		case AS3711_SU2_CURR2:
445 		case AS3711_SU2_CURR3:
446 		case AS3711_SU2_CURR_AUTO:
447 			max_brightness = min(pdata->su2_max_uA / 150, 255);
448 			break;
449 		default:
450 			return -EINVAL;
451 		}
452 
453 		ret = as3711_bl_init_su2(supply);
454 		if (ret < 0)
455 			return ret;
456 
457 		ret = as3711_bl_register(pdev, max_brightness, su);
458 		if (ret < 0)
459 			return ret;
460 	}
461 
462 	platform_set_drvdata(pdev, supply);
463 
464 	return 0;
465 }
466 
467 static struct platform_driver as3711_backlight_driver = {
468 	.driver		= {
469 		.name	= "as3711-backlight",
470 	},
471 	.probe		= as3711_backlight_probe,
472 };
473 
474 module_platform_driver(as3711_backlight_driver);
475 
476 MODULE_DESCRIPTION("Backlight Driver for AS3711 PMICs");
477 MODULE_AUTHOR("Guennadi Liakhovetski <g.liakhovetski@gmx.de");
478 MODULE_LICENSE("GPL");
479 MODULE_ALIAS("platform:as3711-backlight");
480