lp855x_bl.c 9.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429
  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. #include <linux/module.h>
  12. #include <linux/slab.h>
  13. #include <linux/i2c.h>
  14. #include <linux/backlight.h>
  15. #include <linux/err.h>
  16. #include <linux/platform_data/lp855x.h>
  17. #include <linux/pwm.h>
  18. /* LP8550/1/2/3/6 Registers */
  19. #define LP855X_BRIGHTNESS_CTRL 0x00
  20. #define LP855X_DEVICE_CTRL 0x01
  21. #define LP855X_EEPROM_START 0xA0
  22. #define LP855X_EEPROM_END 0xA7
  23. #define LP8556_EPROM_START 0xA0
  24. #define LP8556_EPROM_END 0xAF
  25. /* LP8557 Registers */
  26. #define LP8557_BL_CMD 0x00
  27. #define LP8557_BL_MASK 0x01
  28. #define LP8557_BL_ON 0x01
  29. #define LP8557_BL_OFF 0x00
  30. #define LP8557_BRIGHTNESS_CTRL 0x04
  31. #define LP8557_CONFIG 0x10
  32. #define LP8557_EPROM_START 0x10
  33. #define LP8557_EPROM_END 0x1E
  34. #define BUF_SIZE 20
  35. #define DEFAULT_BL_NAME "lcd-backlight"
  36. #define MAX_BRIGHTNESS 255
  37. struct lp855x;
  38. /*
  39. * struct lp855x_device_config
  40. * @pre_init_device: init device function call before updating the brightness
  41. * @reg_brightness: register address for brigthenss control
  42. * @reg_devicectrl: register address for device control
  43. * @post_init_device: late init device function call
  44. */
  45. struct lp855x_device_config {
  46. int (*pre_init_device)(struct lp855x *);
  47. u8 reg_brightness;
  48. u8 reg_devicectrl;
  49. int (*post_init_device)(struct lp855x *);
  50. };
  51. struct lp855x {
  52. const char *chipname;
  53. enum lp855x_chip_id chip_id;
  54. struct lp855x_device_config *cfg;
  55. struct i2c_client *client;
  56. struct backlight_device *bl;
  57. struct device *dev;
  58. struct lp855x_platform_data *pdata;
  59. struct pwm_device *pwm;
  60. };
  61. static int lp855x_write_byte(struct lp855x *lp, u8 reg, u8 data)
  62. {
  63. return i2c_smbus_write_byte_data(lp->client, reg, data);
  64. }
  65. static int lp855x_update_bit(struct lp855x *lp, u8 reg, u8 mask, u8 data)
  66. {
  67. int ret;
  68. u8 tmp;
  69. ret = i2c_smbus_read_byte_data(lp->client, reg);
  70. if (ret < 0) {
  71. dev_err(lp->dev, "failed to read 0x%.2x\n", reg);
  72. return ret;
  73. }
  74. tmp = (u8)ret;
  75. tmp &= ~mask;
  76. tmp |= data & mask;
  77. return lp855x_write_byte(lp, reg, tmp);
  78. }
  79. static bool lp855x_is_valid_rom_area(struct lp855x *lp, u8 addr)
  80. {
  81. u8 start, end;
  82. switch (lp->chip_id) {
  83. case LP8550:
  84. case LP8551:
  85. case LP8552:
  86. case LP8553:
  87. start = LP855X_EEPROM_START;
  88. end = LP855X_EEPROM_END;
  89. break;
  90. case LP8556:
  91. start = LP8556_EPROM_START;
  92. end = LP8556_EPROM_END;
  93. break;
  94. case LP8557:
  95. start = LP8557_EPROM_START;
  96. end = LP8557_EPROM_END;
  97. break;
  98. default:
  99. return false;
  100. }
  101. return (addr >= start && addr <= end);
  102. }
  103. static int lp8557_bl_off(struct lp855x *lp)
  104. {
  105. /* BL_ON = 0 before updating EPROM settings */
  106. return lp855x_update_bit(lp, LP8557_BL_CMD, LP8557_BL_MASK,
  107. LP8557_BL_OFF);
  108. }
  109. static int lp8557_bl_on(struct lp855x *lp)
  110. {
  111. /* BL_ON = 1 after updating EPROM settings */
  112. return lp855x_update_bit(lp, LP8557_BL_CMD, LP8557_BL_MASK,
  113. LP8557_BL_ON);
  114. }
  115. static struct lp855x_device_config lp855x_dev_cfg = {
  116. .reg_brightness = LP855X_BRIGHTNESS_CTRL,
  117. .reg_devicectrl = LP855X_DEVICE_CTRL,
  118. };
  119. static struct lp855x_device_config lp8557_dev_cfg = {
  120. .reg_brightness = LP8557_BRIGHTNESS_CTRL,
  121. .reg_devicectrl = LP8557_CONFIG,
  122. .pre_init_device = lp8557_bl_off,
  123. .post_init_device = lp8557_bl_on,
  124. };
  125. /*
  126. * Device specific configuration flow
  127. *
  128. * a) pre_init_device(optional)
  129. * b) update the brightness register
  130. * c) update device control register
  131. * d) update ROM area(optional)
  132. * e) post_init_device(optional)
  133. *
  134. */
  135. static int lp855x_configure(struct lp855x *lp)
  136. {
  137. u8 val, addr;
  138. int i, ret;
  139. struct lp855x_platform_data *pd = lp->pdata;
  140. switch (lp->chip_id) {
  141. case LP8550 ... LP8556:
  142. lp->cfg = &lp855x_dev_cfg;
  143. break;
  144. case LP8557:
  145. lp->cfg = &lp8557_dev_cfg;
  146. break;
  147. default:
  148. return -EINVAL;
  149. }
  150. if (lp->cfg->pre_init_device) {
  151. ret = lp->cfg->pre_init_device(lp);
  152. if (ret) {
  153. dev_err(lp->dev, "pre init device err: %d\n", ret);
  154. goto err;
  155. }
  156. }
  157. val = pd->initial_brightness;
  158. ret = lp855x_write_byte(lp, lp->cfg->reg_brightness, val);
  159. if (ret)
  160. goto err;
  161. val = pd->device_control;
  162. ret = lp855x_write_byte(lp, lp->cfg->reg_devicectrl, val);
  163. if (ret)
  164. goto err;
  165. if (pd->load_new_rom_data && pd->size_program) {
  166. for (i = 0; i < pd->size_program; i++) {
  167. addr = pd->rom_data[i].addr;
  168. val = pd->rom_data[i].val;
  169. if (!lp855x_is_valid_rom_area(lp, addr))
  170. continue;
  171. ret = lp855x_write_byte(lp, addr, val);
  172. if (ret)
  173. goto err;
  174. }
  175. }
  176. if (lp->cfg->post_init_device) {
  177. ret = lp->cfg->post_init_device(lp);
  178. if (ret) {
  179. dev_err(lp->dev, "post init device err: %d\n", ret);
  180. goto err;
  181. }
  182. }
  183. return 0;
  184. err:
  185. return ret;
  186. }
  187. static void lp855x_pwm_ctrl(struct lp855x *lp, int br, int max_br)
  188. {
  189. unsigned int period = lp->pdata->period_ns;
  190. unsigned int duty = br * period / max_br;
  191. struct pwm_device *pwm;
  192. /* request pwm device with the consumer name */
  193. if (!lp->pwm) {
  194. pwm = devm_pwm_get(lp->dev, lp->chipname);
  195. if (IS_ERR(pwm))
  196. return;
  197. lp->pwm = pwm;
  198. }
  199. pwm_config(lp->pwm, duty, period);
  200. if (duty)
  201. pwm_enable(lp->pwm);
  202. else
  203. pwm_disable(lp->pwm);
  204. }
  205. static int lp855x_bl_update_status(struct backlight_device *bl)
  206. {
  207. struct lp855x *lp = bl_get_data(bl);
  208. enum lp855x_brightness_ctrl_mode mode = lp->pdata->mode;
  209. if (bl->props.state & BL_CORE_SUSPENDED)
  210. bl->props.brightness = 0;
  211. if (mode == PWM_BASED) {
  212. int br = bl->props.brightness;
  213. int max_br = bl->props.max_brightness;
  214. lp855x_pwm_ctrl(lp, br, max_br);
  215. } else if (mode == REGISTER_BASED) {
  216. u8 val = bl->props.brightness;
  217. lp855x_write_byte(lp, lp->cfg->reg_brightness, val);
  218. }
  219. return 0;
  220. }
  221. static int lp855x_bl_get_brightness(struct backlight_device *bl)
  222. {
  223. return bl->props.brightness;
  224. }
  225. static const struct backlight_ops lp855x_bl_ops = {
  226. .options = BL_CORE_SUSPENDRESUME,
  227. .update_status = lp855x_bl_update_status,
  228. .get_brightness = lp855x_bl_get_brightness,
  229. };
  230. static int lp855x_backlight_register(struct lp855x *lp)
  231. {
  232. struct backlight_device *bl;
  233. struct backlight_properties props;
  234. struct lp855x_platform_data *pdata = lp->pdata;
  235. char *name = pdata->name ? : DEFAULT_BL_NAME;
  236. props.type = BACKLIGHT_PLATFORM;
  237. props.max_brightness = MAX_BRIGHTNESS;
  238. if (pdata->initial_brightness > props.max_brightness)
  239. pdata->initial_brightness = props.max_brightness;
  240. props.brightness = pdata->initial_brightness;
  241. bl = backlight_device_register(name, lp->dev, lp,
  242. &lp855x_bl_ops, &props);
  243. if (IS_ERR(bl))
  244. return PTR_ERR(bl);
  245. lp->bl = bl;
  246. return 0;
  247. }
  248. static void lp855x_backlight_unregister(struct lp855x *lp)
  249. {
  250. if (lp->bl)
  251. backlight_device_unregister(lp->bl);
  252. }
  253. static ssize_t lp855x_get_chip_id(struct device *dev,
  254. struct device_attribute *attr, char *buf)
  255. {
  256. struct lp855x *lp = dev_get_drvdata(dev);
  257. return scnprintf(buf, BUF_SIZE, "%s\n", lp->chipname);
  258. }
  259. static ssize_t lp855x_get_bl_ctl_mode(struct device *dev,
  260. struct device_attribute *attr, char *buf)
  261. {
  262. struct lp855x *lp = dev_get_drvdata(dev);
  263. enum lp855x_brightness_ctrl_mode mode = lp->pdata->mode;
  264. char *strmode = NULL;
  265. if (mode == PWM_BASED)
  266. strmode = "pwm based";
  267. else if (mode == REGISTER_BASED)
  268. strmode = "register based";
  269. return scnprintf(buf, BUF_SIZE, "%s\n", strmode);
  270. }
  271. static DEVICE_ATTR(chip_id, S_IRUGO, lp855x_get_chip_id, NULL);
  272. static DEVICE_ATTR(bl_ctl_mode, S_IRUGO, lp855x_get_bl_ctl_mode, NULL);
  273. static struct attribute *lp855x_attributes[] = {
  274. &dev_attr_chip_id.attr,
  275. &dev_attr_bl_ctl_mode.attr,
  276. NULL,
  277. };
  278. static const struct attribute_group lp855x_attr_group = {
  279. .attrs = lp855x_attributes,
  280. };
  281. static int lp855x_probe(struct i2c_client *cl, const struct i2c_device_id *id)
  282. {
  283. struct lp855x *lp;
  284. struct lp855x_platform_data *pdata = cl->dev.platform_data;
  285. enum lp855x_brightness_ctrl_mode mode;
  286. int ret;
  287. if (!pdata) {
  288. dev_err(&cl->dev, "no platform data supplied\n");
  289. return -EINVAL;
  290. }
  291. if (!i2c_check_functionality(cl->adapter, I2C_FUNC_SMBUS_I2C_BLOCK))
  292. return -EIO;
  293. lp = devm_kzalloc(&cl->dev, sizeof(struct lp855x), GFP_KERNEL);
  294. if (!lp)
  295. return -ENOMEM;
  296. mode = pdata->mode;
  297. lp->client = cl;
  298. lp->dev = &cl->dev;
  299. lp->pdata = pdata;
  300. lp->chipname = id->name;
  301. lp->chip_id = id->driver_data;
  302. i2c_set_clientdata(cl, lp);
  303. ret = lp855x_configure(lp);
  304. if (ret) {
  305. dev_err(lp->dev, "device config err: %d", ret);
  306. goto err_dev;
  307. }
  308. ret = lp855x_backlight_register(lp);
  309. if (ret) {
  310. dev_err(lp->dev,
  311. "failed to register backlight. err: %d\n", ret);
  312. goto err_dev;
  313. }
  314. ret = sysfs_create_group(&lp->dev->kobj, &lp855x_attr_group);
  315. if (ret) {
  316. dev_err(lp->dev, "failed to register sysfs. err: %d\n", ret);
  317. goto err_sysfs;
  318. }
  319. backlight_update_status(lp->bl);
  320. return 0;
  321. err_sysfs:
  322. lp855x_backlight_unregister(lp);
  323. err_dev:
  324. return ret;
  325. }
  326. static int lp855x_remove(struct i2c_client *cl)
  327. {
  328. struct lp855x *lp = i2c_get_clientdata(cl);
  329. lp->bl->props.brightness = 0;
  330. backlight_update_status(lp->bl);
  331. sysfs_remove_group(&lp->dev->kobj, &lp855x_attr_group);
  332. lp855x_backlight_unregister(lp);
  333. return 0;
  334. }
  335. static const struct i2c_device_id lp855x_ids[] = {
  336. {"lp8550", LP8550},
  337. {"lp8551", LP8551},
  338. {"lp8552", LP8552},
  339. {"lp8553", LP8553},
  340. {"lp8556", LP8556},
  341. {"lp8557", LP8557},
  342. { }
  343. };
  344. MODULE_DEVICE_TABLE(i2c, lp855x_ids);
  345. static struct i2c_driver lp855x_driver = {
  346. .driver = {
  347. .name = "lp855x",
  348. },
  349. .probe = lp855x_probe,
  350. .remove = lp855x_remove,
  351. .id_table = lp855x_ids,
  352. };
  353. module_i2c_driver(lp855x_driver);
  354. MODULE_DESCRIPTION("Texas Instruments LP855x Backlight driver");
  355. MODULE_AUTHOR("Milo Kim <milo.kim@ti.com>");
  356. MODULE_LICENSE("GPL");