Commit | Line | Data |
---|---|---|
7be865ab KM |
1 | /* |
2 | * TI LP855x Backlight Driver | |
3 | * | |
4 | * Copyright (C) 2011 Texas Instruments | |
5 | * | |
6 | * This program is free software; you can redistribute it and/or modify | |
7 | * it under the terms of the GNU General Public License version 2 as | |
8 | * published by the Free Software Foundation. | |
9 | * | |
10 | */ | |
11 | ||
12 | #include <linux/module.h> | |
13 | #include <linux/slab.h> | |
14 | #include <linux/i2c.h> | |
15 | #include <linux/backlight.h> | |
16 | #include <linux/err.h> | |
4add0664 | 17 | #include <linux/of.h> |
f7f95056 | 18 | #include <linux/platform_data/lp855x.h> |
8cc9764c | 19 | #include <linux/pwm.h> |
829b030e | 20 | #include <linux/regulator/consumer.h> |
7be865ab | 21 | |
26e8ccc2 KM |
22 | /* LP8550/1/2/3/6 Registers */ |
23 | #define LP855X_BRIGHTNESS_CTRL 0x00 | |
24 | #define LP855X_DEVICE_CTRL 0x01 | |
25 | #define LP855X_EEPROM_START 0xA0 | |
26 | #define LP855X_EEPROM_END 0xA7 | |
27 | #define LP8556_EPROM_START 0xA0 | |
28 | #define LP8556_EPROM_END 0xAF | |
29 | ||
5812c13a | 30 | /* LP8555/7 Registers */ |
26e8ccc2 KM |
31 | #define LP8557_BL_CMD 0x00 |
32 | #define LP8557_BL_MASK 0x01 | |
33 | #define LP8557_BL_ON 0x01 | |
34 | #define LP8557_BL_OFF 0x00 | |
35 | #define LP8557_BRIGHTNESS_CTRL 0x04 | |
36 | #define LP8557_CONFIG 0x10 | |
5812c13a MK |
37 | #define LP8555_EPROM_START 0x10 |
38 | #define LP8555_EPROM_END 0x7A | |
26e8ccc2 KM |
39 | #define LP8557_EPROM_START 0x10 |
40 | #define LP8557_EPROM_END 0x1E | |
7be865ab | 41 | |
7be865ab KM |
42 | #define DEFAULT_BL_NAME "lcd-backlight" |
43 | #define MAX_BRIGHTNESS 255 | |
44 | ||
0b818573 KM |
45 | enum lp855x_brightness_ctrl_mode { |
46 | PWM_BASED = 1, | |
47 | REGISTER_BASED, | |
48 | }; | |
49 | ||
68853bc2 KM |
50 | struct lp855x; |
51 | ||
52 | /* | |
53 | * struct lp855x_device_config | |
54 | * @pre_init_device: init device function call before updating the brightness | |
55 | * @reg_brightness: register address for brigthenss control | |
56 | * @reg_devicectrl: register address for device control | |
57 | * @post_init_device: late init device function call | |
58 | */ | |
59 | struct lp855x_device_config { | |
60 | int (*pre_init_device)(struct lp855x *); | |
61 | u8 reg_brightness; | |
62 | u8 reg_devicectrl; | |
63 | int (*post_init_device)(struct lp855x *); | |
64 | }; | |
65 | ||
7be865ab KM |
66 | struct lp855x { |
67 | const char *chipname; | |
68 | enum lp855x_chip_id chip_id; | |
0b818573 | 69 | enum lp855x_brightness_ctrl_mode mode; |
68853bc2 | 70 | struct lp855x_device_config *cfg; |
7be865ab KM |
71 | struct i2c_client *client; |
72 | struct backlight_device *bl; | |
73 | struct device *dev; | |
7be865ab | 74 | struct lp855x_platform_data *pdata; |
8cc9764c | 75 | struct pwm_device *pwm; |
7be865ab KM |
76 | }; |
77 | ||
7be865ab KM |
78 | static int lp855x_write_byte(struct lp855x *lp, u8 reg, u8 data) |
79 | { | |
eaa4d02f | 80 | return i2c_smbus_write_byte_data(lp->client, reg, data); |
7be865ab KM |
81 | } |
82 | ||
26e8ccc2 KM |
83 | static int lp855x_update_bit(struct lp855x *lp, u8 reg, u8 mask, u8 data) |
84 | { | |
85 | int ret; | |
86 | u8 tmp; | |
87 | ||
88 | ret = i2c_smbus_read_byte_data(lp->client, reg); | |
89 | if (ret < 0) { | |
90 | dev_err(lp->dev, "failed to read 0x%.2x\n", reg); | |
91 | return ret; | |
92 | } | |
93 | ||
94 | tmp = (u8)ret; | |
95 | tmp &= ~mask; | |
96 | tmp |= data & mask; | |
97 | ||
98 | return lp855x_write_byte(lp, reg, tmp); | |
99 | } | |
100 | ||
7be865ab KM |
101 | static bool lp855x_is_valid_rom_area(struct lp855x *lp, u8 addr) |
102 | { | |
103 | u8 start, end; | |
104 | ||
105 | switch (lp->chip_id) { | |
106 | case LP8550: | |
107 | case LP8551: | |
108 | case LP8552: | |
109 | case LP8553: | |
26e8ccc2 KM |
110 | start = LP855X_EEPROM_START; |
111 | end = LP855X_EEPROM_END; | |
7be865ab KM |
112 | break; |
113 | case LP8556: | |
26e8ccc2 KM |
114 | start = LP8556_EPROM_START; |
115 | end = LP8556_EPROM_END; | |
116 | break; | |
5812c13a MK |
117 | case LP8555: |
118 | start = LP8555_EPROM_START; | |
119 | end = LP8555_EPROM_END; | |
120 | break; | |
26e8ccc2 KM |
121 | case LP8557: |
122 | start = LP8557_EPROM_START; | |
123 | end = LP8557_EPROM_END; | |
7be865ab KM |
124 | break; |
125 | default: | |
126 | return false; | |
127 | } | |
128 | ||
2ce23860 | 129 | return addr >= start && addr <= end; |
7be865ab KM |
130 | } |
131 | ||
26e8ccc2 KM |
132 | static int lp8557_bl_off(struct lp855x *lp) |
133 | { | |
134 | /* BL_ON = 0 before updating EPROM settings */ | |
135 | return lp855x_update_bit(lp, LP8557_BL_CMD, LP8557_BL_MASK, | |
136 | LP8557_BL_OFF); | |
137 | } | |
138 | ||
139 | static int lp8557_bl_on(struct lp855x *lp) | |
140 | { | |
141 | /* BL_ON = 1 after updating EPROM settings */ | |
142 | return lp855x_update_bit(lp, LP8557_BL_CMD, LP8557_BL_MASK, | |
143 | LP8557_BL_ON); | |
144 | } | |
145 | ||
68853bc2 | 146 | static struct lp855x_device_config lp855x_dev_cfg = { |
26e8ccc2 KM |
147 | .reg_brightness = LP855X_BRIGHTNESS_CTRL, |
148 | .reg_devicectrl = LP855X_DEVICE_CTRL, | |
149 | }; | |
150 | ||
151 | static struct lp855x_device_config lp8557_dev_cfg = { | |
152 | .reg_brightness = LP8557_BRIGHTNESS_CTRL, | |
153 | .reg_devicectrl = LP8557_CONFIG, | |
154 | .pre_init_device = lp8557_bl_off, | |
155 | .post_init_device = lp8557_bl_on, | |
68853bc2 KM |
156 | }; |
157 | ||
158 | /* | |
159 | * Device specific configuration flow | |
160 | * | |
161 | * a) pre_init_device(optional) | |
162 | * b) update the brightness register | |
163 | * c) update device control register | |
164 | * d) update ROM area(optional) | |
165 | * e) post_init_device(optional) | |
166 | * | |
167 | */ | |
168 | static int lp855x_configure(struct lp855x *lp) | |
7be865ab KM |
169 | { |
170 | u8 val, addr; | |
171 | int i, ret; | |
172 | struct lp855x_platform_data *pd = lp->pdata; | |
173 | ||
68853bc2 | 174 | switch (lp->chip_id) { |
5812c13a MK |
175 | case LP8550: |
176 | case LP8551: | |
177 | case LP8552: | |
178 | case LP8553: | |
179 | case LP8556: | |
68853bc2 KM |
180 | lp->cfg = &lp855x_dev_cfg; |
181 | break; | |
5812c13a | 182 | case LP8555: |
26e8ccc2 KM |
183 | case LP8557: |
184 | lp->cfg = &lp8557_dev_cfg; | |
185 | break; | |
68853bc2 KM |
186 | default: |
187 | return -EINVAL; | |
188 | } | |
189 | ||
190 | if (lp->cfg->pre_init_device) { | |
191 | ret = lp->cfg->pre_init_device(lp); | |
192 | if (ret) { | |
193 | dev_err(lp->dev, "pre init device err: %d\n", ret); | |
194 | goto err; | |
195 | } | |
196 | } | |
197 | ||
7be865ab | 198 | val = pd->initial_brightness; |
68853bc2 | 199 | ret = lp855x_write_byte(lp, lp->cfg->reg_brightness, val); |
7be865ab | 200 | if (ret) |
68853bc2 | 201 | goto err; |
7be865ab KM |
202 | |
203 | val = pd->device_control; | |
68853bc2 | 204 | ret = lp855x_write_byte(lp, lp->cfg->reg_devicectrl, val); |
7be865ab | 205 | if (ret) |
68853bc2 | 206 | goto err; |
7be865ab | 207 | |
c365e59d | 208 | if (pd->size_program > 0) { |
7be865ab KM |
209 | for (i = 0; i < pd->size_program; i++) { |
210 | addr = pd->rom_data[i].addr; | |
211 | val = pd->rom_data[i].val; | |
212 | if (!lp855x_is_valid_rom_area(lp, addr)) | |
213 | continue; | |
214 | ||
215 | ret = lp855x_write_byte(lp, addr, val); | |
216 | if (ret) | |
68853bc2 KM |
217 | goto err; |
218 | } | |
219 | } | |
220 | ||
221 | if (lp->cfg->post_init_device) { | |
222 | ret = lp->cfg->post_init_device(lp); | |
223 | if (ret) { | |
224 | dev_err(lp->dev, "post init device err: %d\n", ret); | |
225 | goto err; | |
7be865ab KM |
226 | } |
227 | } | |
228 | ||
68853bc2 KM |
229 | return 0; |
230 | ||
231 | err: | |
7be865ab KM |
232 | return ret; |
233 | } | |
234 | ||
8cc9764c KM |
235 | static void lp855x_pwm_ctrl(struct lp855x *lp, int br, int max_br) |
236 | { | |
237 | unsigned int period = lp->pdata->period_ns; | |
238 | unsigned int duty = br * period / max_br; | |
239 | struct pwm_device *pwm; | |
240 | ||
241 | /* request pwm device with the consumer name */ | |
242 | if (!lp->pwm) { | |
243 | pwm = devm_pwm_get(lp->dev, lp->chipname); | |
244 | if (IS_ERR(pwm)) | |
245 | return; | |
246 | ||
247 | lp->pwm = pwm; | |
248 | } | |
249 | ||
250 | pwm_config(lp->pwm, duty, period); | |
251 | if (duty) | |
252 | pwm_enable(lp->pwm); | |
253 | else | |
254 | pwm_disable(lp->pwm); | |
255 | } | |
256 | ||
7be865ab KM |
257 | static int lp855x_bl_update_status(struct backlight_device *bl) |
258 | { | |
259 | struct lp855x *lp = bl_get_data(bl); | |
61c1c614 | 260 | int brightness = bl->props.brightness; |
7be865ab | 261 | |
9f0a511f | 262 | if (bl->props.state & (BL_CORE_SUSPENDED | BL_CORE_FBBLANK)) |
61c1c614 | 263 | brightness = 0; |
7be865ab | 264 | |
61c1c614 SP |
265 | if (lp->mode == PWM_BASED) |
266 | lp855x_pwm_ctrl(lp, brightness, bl->props.max_brightness); | |
267 | else if (lp->mode == REGISTER_BASED) | |
268 | lp855x_write_byte(lp, lp->cfg->reg_brightness, (u8)brightness); | |
7be865ab KM |
269 | |
270 | return 0; | |
271 | } | |
272 | ||
7be865ab KM |
273 | static const struct backlight_ops lp855x_bl_ops = { |
274 | .options = BL_CORE_SUSPENDRESUME, | |
275 | .update_status = lp855x_bl_update_status, | |
7be865ab KM |
276 | }; |
277 | ||
278 | static int lp855x_backlight_register(struct lp855x *lp) | |
279 | { | |
280 | struct backlight_device *bl; | |
281 | struct backlight_properties props; | |
282 | struct lp855x_platform_data *pdata = lp->pdata; | |
600ffd33 | 283 | const char *name = pdata->name ? : DEFAULT_BL_NAME; |
7be865ab KM |
284 | |
285 | props.type = BACKLIGHT_PLATFORM; | |
286 | props.max_brightness = MAX_BRIGHTNESS; | |
287 | ||
288 | if (pdata->initial_brightness > props.max_brightness) | |
289 | pdata->initial_brightness = props.max_brightness; | |
290 | ||
291 | props.brightness = pdata->initial_brightness; | |
292 | ||
6255e8e9 | 293 | bl = devm_backlight_device_register(lp->dev, name, lp->dev, lp, |
7be865ab KM |
294 | &lp855x_bl_ops, &props); |
295 | if (IS_ERR(bl)) | |
296 | return PTR_ERR(bl); | |
297 | ||
298 | lp->bl = bl; | |
299 | ||
300 | return 0; | |
301 | } | |
302 | ||
7be865ab KM |
303 | static ssize_t lp855x_get_chip_id(struct device *dev, |
304 | struct device_attribute *attr, char *buf) | |
305 | { | |
306 | struct lp855x *lp = dev_get_drvdata(dev); | |
a94cb126 | 307 | |
6a7aeb1a | 308 | return scnprintf(buf, PAGE_SIZE, "%s\n", lp->chipname); |
7be865ab KM |
309 | } |
310 | ||
311 | static ssize_t lp855x_get_bl_ctl_mode(struct device *dev, | |
312 | struct device_attribute *attr, char *buf) | |
313 | { | |
314 | struct lp855x *lp = dev_get_drvdata(dev); | |
7be865ab KM |
315 | char *strmode = NULL; |
316 | ||
0b818573 | 317 | if (lp->mode == PWM_BASED) |
7be865ab | 318 | strmode = "pwm based"; |
0b818573 | 319 | else if (lp->mode == REGISTER_BASED) |
7be865ab KM |
320 | strmode = "register based"; |
321 | ||
6a7aeb1a | 322 | return scnprintf(buf, PAGE_SIZE, "%s\n", strmode); |
7be865ab KM |
323 | } |
324 | ||
325 | static DEVICE_ATTR(chip_id, S_IRUGO, lp855x_get_chip_id, NULL); | |
326 | static DEVICE_ATTR(bl_ctl_mode, S_IRUGO, lp855x_get_bl_ctl_mode, NULL); | |
327 | ||
328 | static struct attribute *lp855x_attributes[] = { | |
329 | &dev_attr_chip_id.attr, | |
330 | &dev_attr_bl_ctl_mode.attr, | |
331 | NULL, | |
332 | }; | |
333 | ||
334 | static const struct attribute_group lp855x_attr_group = { | |
335 | .attrs = lp855x_attributes, | |
336 | }; | |
337 | ||
4add0664 | 338 | #ifdef CONFIG_OF |
47726656 | 339 | static int lp855x_parse_dt(struct lp855x *lp) |
4add0664 | 340 | { |
47726656 SP |
341 | struct device *dev = lp->dev; |
342 | struct device_node *node = dev->of_node; | |
4add0664 KM |
343 | struct lp855x_platform_data *pdata; |
344 | int rom_length; | |
345 | ||
346 | if (!node) { | |
347 | dev_err(dev, "no platform data\n"); | |
348 | return -EINVAL; | |
349 | } | |
350 | ||
351 | pdata = devm_kzalloc(dev, sizeof(*pdata), GFP_KERNEL); | |
352 | if (!pdata) | |
353 | return -ENOMEM; | |
354 | ||
355 | of_property_read_string(node, "bl-name", &pdata->name); | |
356 | of_property_read_u8(node, "dev-ctrl", &pdata->device_control); | |
357 | of_property_read_u8(node, "init-brt", &pdata->initial_brightness); | |
358 | of_property_read_u32(node, "pwm-period", &pdata->period_ns); | |
359 | ||
360 | /* Fill ROM platform data if defined */ | |
361 | rom_length = of_get_child_count(node); | |
362 | if (rom_length > 0) { | |
363 | struct lp855x_rom_data *rom; | |
364 | struct device_node *child; | |
365 | int i = 0; | |
366 | ||
367 | rom = devm_kzalloc(dev, sizeof(*rom) * rom_length, GFP_KERNEL); | |
368 | if (!rom) | |
369 | return -ENOMEM; | |
370 | ||
371 | for_each_child_of_node(node, child) { | |
372 | of_property_read_u8(child, "rom-addr", &rom[i].addr); | |
373 | of_property_read_u8(child, "rom-val", &rom[i].val); | |
374 | i++; | |
375 | } | |
376 | ||
377 | pdata->size_program = rom_length; | |
378 | pdata->rom_data = &rom[0]; | |
379 | } | |
380 | ||
829b030e SP |
381 | pdata->supply = devm_regulator_get(dev, "power"); |
382 | if (IS_ERR(pdata->supply)) { | |
383 | if (PTR_ERR(pdata->supply) == -EPROBE_DEFER) | |
384 | return -EPROBE_DEFER; | |
385 | pdata->supply = NULL; | |
386 | } | |
387 | ||
47726656 | 388 | lp->pdata = pdata; |
4add0664 KM |
389 | |
390 | return 0; | |
391 | } | |
392 | #else | |
47726656 | 393 | static int lp855x_parse_dt(struct lp855x *lp) |
4add0664 KM |
394 | { |
395 | return -EINVAL; | |
396 | } | |
397 | #endif | |
398 | ||
7be865ab KM |
399 | static int lp855x_probe(struct i2c_client *cl, const struct i2c_device_id *id) |
400 | { | |
401 | struct lp855x *lp; | |
7be865ab KM |
402 | int ret; |
403 | ||
7be865ab KM |
404 | if (!i2c_check_functionality(cl->adapter, I2C_FUNC_SMBUS_I2C_BLOCK)) |
405 | return -EIO; | |
406 | ||
407 | lp = devm_kzalloc(&cl->dev, sizeof(struct lp855x), GFP_KERNEL); | |
408 | if (!lp) | |
409 | return -ENOMEM; | |
410 | ||
7be865ab KM |
411 | lp->client = cl; |
412 | lp->dev = &cl->dev; | |
7be865ab KM |
413 | lp->chipname = id->name; |
414 | lp->chip_id = id->driver_data; | |
47726656 SP |
415 | lp->pdata = dev_get_platdata(&cl->dev); |
416 | ||
417 | if (!lp->pdata) { | |
418 | ret = lp855x_parse_dt(lp); | |
419 | if (ret < 0) | |
420 | return ret; | |
421 | } | |
422 | ||
423 | if (lp->pdata->period_ns > 0) | |
424 | lp->mode = PWM_BASED; | |
425 | else | |
426 | lp->mode = REGISTER_BASED; | |
427 | ||
829b030e SP |
428 | if (lp->pdata->supply) { |
429 | ret = regulator_enable(lp->pdata->supply); | |
430 | if (ret < 0) { | |
431 | dev_err(&cl->dev, "failed to enable supply: %d\n", ret); | |
432 | return ret; | |
433 | } | |
434 | } | |
435 | ||
7be865ab KM |
436 | i2c_set_clientdata(cl, lp); |
437 | ||
68853bc2 | 438 | ret = lp855x_configure(lp); |
7be865ab | 439 | if (ret) { |
68853bc2 | 440 | dev_err(lp->dev, "device config err: %d", ret); |
6255e8e9 | 441 | return ret; |
7be865ab KM |
442 | } |
443 | ||
444 | ret = lp855x_backlight_register(lp); | |
445 | if (ret) { | |
446 | dev_err(lp->dev, | |
447 | "failed to register backlight. err: %d\n", ret); | |
6255e8e9 | 448 | return ret; |
7be865ab KM |
449 | } |
450 | ||
451 | ret = sysfs_create_group(&lp->dev->kobj, &lp855x_attr_group); | |
452 | if (ret) { | |
453 | dev_err(lp->dev, "failed to register sysfs. err: %d\n", ret); | |
6255e8e9 | 454 | return ret; |
7be865ab KM |
455 | } |
456 | ||
457 | backlight_update_status(lp->bl); | |
458 | return 0; | |
7be865ab KM |
459 | } |
460 | ||
7e4b9d0b | 461 | static int lp855x_remove(struct i2c_client *cl) |
7be865ab KM |
462 | { |
463 | struct lp855x *lp = i2c_get_clientdata(cl); | |
464 | ||
465 | lp->bl->props.brightness = 0; | |
466 | backlight_update_status(lp->bl); | |
829b030e SP |
467 | if (lp->pdata->supply) |
468 | regulator_disable(lp->pdata->supply); | |
7be865ab | 469 | sysfs_remove_group(&lp->dev->kobj, &lp855x_attr_group); |
7be865ab KM |
470 | |
471 | return 0; | |
472 | } | |
473 | ||
4add0664 KM |
474 | static const struct of_device_id lp855x_dt_ids[] = { |
475 | { .compatible = "ti,lp8550", }, | |
476 | { .compatible = "ti,lp8551", }, | |
477 | { .compatible = "ti,lp8552", }, | |
478 | { .compatible = "ti,lp8553", }, | |
5812c13a | 479 | { .compatible = "ti,lp8555", }, |
4add0664 KM |
480 | { .compatible = "ti,lp8556", }, |
481 | { .compatible = "ti,lp8557", }, | |
482 | { } | |
483 | }; | |
484 | MODULE_DEVICE_TABLE(of, lp855x_dt_ids); | |
485 | ||
7be865ab KM |
486 | static const struct i2c_device_id lp855x_ids[] = { |
487 | {"lp8550", LP8550}, | |
488 | {"lp8551", LP8551}, | |
489 | {"lp8552", LP8552}, | |
490 | {"lp8553", LP8553}, | |
5812c13a | 491 | {"lp8555", LP8555}, |
7be865ab | 492 | {"lp8556", LP8556}, |
26e8ccc2 | 493 | {"lp8557", LP8557}, |
7be865ab KM |
494 | { } |
495 | }; | |
496 | MODULE_DEVICE_TABLE(i2c, lp855x_ids); | |
497 | ||
498 | static struct i2c_driver lp855x_driver = { | |
499 | .driver = { | |
500 | .name = "lp855x", | |
4add0664 | 501 | .of_match_table = of_match_ptr(lp855x_dt_ids), |
7be865ab KM |
502 | }, |
503 | .probe = lp855x_probe, | |
d1723fa2 | 504 | .remove = lp855x_remove, |
7be865ab KM |
505 | .id_table = lp855x_ids, |
506 | }; | |
507 | ||
508 | module_i2c_driver(lp855x_driver); | |
509 | ||
510 | MODULE_DESCRIPTION("Texas Instruments LP855x Backlight driver"); | |
511 | MODULE_AUTHOR("Milo Kim <milo.kim@ti.com>"); | |
512 | MODULE_LICENSE("GPL"); |