1 /* 2 * TI LP8788 MFD - backlight driver 3 * 4 * Copyright 2012 Texas Instruments 5 * 6 * Author: Milo(Woogyom) Kim <milo.kim@ti.com> 7 * 8 * This program is free software; you can redistribute it and/or modify 9 * it under the terms of the GNU General Public License version 2 as 10 * published by the Free Software Foundation. 11 * 12 */ 13 14 #include <linux/backlight.h> 15 #include <linux/err.h> 16 #include <linux/mfd/lp8788.h> 17 #include <linux/module.h> 18 #include <linux/platform_device.h> 19 #include <linux/pwm.h> 20 #include <linux/slab.h> 21 22 /* Register address */ 23 #define LP8788_BL_CONFIG 0x96 24 #define LP8788_BL_EN BIT(0) 25 #define LP8788_BL_PWM_INPUT_EN BIT(5) 26 #define LP8788_BL_FULLSCALE_SHIFT 2 27 #define LP8788_BL_DIM_MODE_SHIFT 1 28 #define LP8788_BL_PWM_POLARITY_SHIFT 6 29 30 #define LP8788_BL_BRIGHTNESS 0x97 31 32 #define LP8788_BL_RAMP 0x98 33 #define LP8788_BL_RAMP_RISE_SHIFT 4 34 35 #define MAX_BRIGHTNESS 127 36 #define DEFAULT_BL_NAME "lcd-backlight" 37 38 struct lp8788_bl_config { 39 enum lp8788_bl_ctrl_mode bl_mode; 40 enum lp8788_bl_dim_mode dim_mode; 41 enum lp8788_bl_full_scale_current full_scale; 42 enum lp8788_bl_ramp_step rise_time; 43 enum lp8788_bl_ramp_step fall_time; 44 enum pwm_polarity pwm_pol; 45 }; 46 47 struct lp8788_bl { 48 struct lp8788 *lp; 49 struct backlight_device *bl_dev; 50 struct lp8788_backlight_platform_data *pdata; 51 enum lp8788_bl_ctrl_mode mode; 52 struct pwm_device *pwm; 53 }; 54 55 static struct lp8788_bl_config default_bl_config = { 56 .bl_mode = LP8788_BL_REGISTER_ONLY, 57 .dim_mode = LP8788_DIM_EXPONENTIAL, 58 .full_scale = LP8788_FULLSCALE_1900uA, 59 .rise_time = LP8788_RAMP_8192us, 60 .fall_time = LP8788_RAMP_8192us, 61 .pwm_pol = PWM_POLARITY_NORMAL, 62 }; 63 64 static inline bool is_brightness_ctrl_by_pwm(enum lp8788_bl_ctrl_mode mode) 65 { 66 return mode == LP8788_BL_COMB_PWM_BASED; 67 } 68 69 static inline bool is_brightness_ctrl_by_register(enum lp8788_bl_ctrl_mode mode) 70 { 71 return mode == LP8788_BL_REGISTER_ONLY || 72 mode == LP8788_BL_COMB_REGISTER_BASED; 73 } 74 75 static int lp8788_backlight_configure(struct lp8788_bl *bl) 76 { 77 struct lp8788_backlight_platform_data *pdata = bl->pdata; 78 struct lp8788_bl_config *cfg = &default_bl_config; 79 int ret; 80 u8 val; 81 82 /* 83 * Update chip configuration if platform data exists, 84 * otherwise use the default settings. 85 */ 86 if (pdata) { 87 cfg->bl_mode = pdata->bl_mode; 88 cfg->dim_mode = pdata->dim_mode; 89 cfg->full_scale = pdata->full_scale; 90 cfg->rise_time = pdata->rise_time; 91 cfg->fall_time = pdata->fall_time; 92 cfg->pwm_pol = pdata->pwm_pol; 93 } 94 95 /* Brightness ramp up/down */ 96 val = (cfg->rise_time << LP8788_BL_RAMP_RISE_SHIFT) | cfg->fall_time; 97 ret = lp8788_write_byte(bl->lp, LP8788_BL_RAMP, val); 98 if (ret) 99 return ret; 100 101 /* Fullscale current setting */ 102 val = (cfg->full_scale << LP8788_BL_FULLSCALE_SHIFT) | 103 (cfg->dim_mode << LP8788_BL_DIM_MODE_SHIFT); 104 105 /* Brightness control mode */ 106 switch (cfg->bl_mode) { 107 case LP8788_BL_REGISTER_ONLY: 108 val |= LP8788_BL_EN; 109 break; 110 case LP8788_BL_COMB_PWM_BASED: 111 case LP8788_BL_COMB_REGISTER_BASED: 112 val |= LP8788_BL_EN | LP8788_BL_PWM_INPUT_EN | 113 (cfg->pwm_pol << LP8788_BL_PWM_POLARITY_SHIFT); 114 break; 115 default: 116 dev_err(bl->lp->dev, "invalid mode: %d\n", cfg->bl_mode); 117 return -EINVAL; 118 } 119 120 bl->mode = cfg->bl_mode; 121 122 return lp8788_write_byte(bl->lp, LP8788_BL_CONFIG, val); 123 } 124 125 static void lp8788_pwm_ctrl(struct lp8788_bl *bl, int br, int max_br) 126 { 127 unsigned int period; 128 unsigned int duty; 129 struct device *dev; 130 struct pwm_device *pwm; 131 132 if (!bl->pdata) 133 return; 134 135 period = bl->pdata->period_ns; 136 duty = br * period / max_br; 137 dev = bl->lp->dev; 138 139 /* request PWM device with the consumer name */ 140 if (!bl->pwm) { 141 pwm = devm_pwm_get(dev, LP8788_DEV_BACKLIGHT); 142 if (IS_ERR(pwm)) { 143 dev_err(dev, "can not get PWM device\n"); 144 return; 145 } 146 147 bl->pwm = pwm; 148 } 149 150 pwm_config(bl->pwm, duty, period); 151 if (duty) 152 pwm_enable(bl->pwm); 153 else 154 pwm_disable(bl->pwm); 155 } 156 157 static int lp8788_bl_update_status(struct backlight_device *bl_dev) 158 { 159 struct lp8788_bl *bl = bl_get_data(bl_dev); 160 enum lp8788_bl_ctrl_mode mode = bl->mode; 161 162 if (bl_dev->props.state & BL_CORE_SUSPENDED) 163 bl_dev->props.brightness = 0; 164 165 if (is_brightness_ctrl_by_pwm(mode)) { 166 int brt = bl_dev->props.brightness; 167 int max = bl_dev->props.max_brightness; 168 169 lp8788_pwm_ctrl(bl, brt, max); 170 } else if (is_brightness_ctrl_by_register(mode)) { 171 u8 brt = bl_dev->props.brightness; 172 173 lp8788_write_byte(bl->lp, LP8788_BL_BRIGHTNESS, brt); 174 } 175 176 return 0; 177 } 178 179 static int lp8788_bl_get_brightness(struct backlight_device *bl_dev) 180 { 181 return bl_dev->props.brightness; 182 } 183 184 static const struct backlight_ops lp8788_bl_ops = { 185 .options = BL_CORE_SUSPENDRESUME, 186 .update_status = lp8788_bl_update_status, 187 .get_brightness = lp8788_bl_get_brightness, 188 }; 189 190 static int lp8788_backlight_register(struct lp8788_bl *bl) 191 { 192 struct backlight_device *bl_dev; 193 struct backlight_properties props; 194 struct lp8788_backlight_platform_data *pdata = bl->pdata; 195 int init_brt; 196 char *name; 197 198 props.type = BACKLIGHT_PLATFORM; 199 props.max_brightness = MAX_BRIGHTNESS; 200 201 /* Initial brightness */ 202 if (pdata) 203 init_brt = min_t(int, pdata->initial_brightness, 204 props.max_brightness); 205 else 206 init_brt = 0; 207 208 props.brightness = init_brt; 209 210 /* Backlight device name */ 211 if (!pdata || !pdata->name) 212 name = DEFAULT_BL_NAME; 213 else 214 name = pdata->name; 215 216 bl_dev = backlight_device_register(name, bl->lp->dev, bl, 217 &lp8788_bl_ops, &props); 218 if (IS_ERR(bl_dev)) 219 return PTR_ERR(bl_dev); 220 221 bl->bl_dev = bl_dev; 222 223 return 0; 224 } 225 226 static void lp8788_backlight_unregister(struct lp8788_bl *bl) 227 { 228 struct backlight_device *bl_dev = bl->bl_dev; 229 230 if (bl_dev) 231 backlight_device_unregister(bl_dev); 232 } 233 234 static ssize_t lp8788_get_bl_ctl_mode(struct device *dev, 235 struct device_attribute *attr, char *buf) 236 { 237 struct lp8788_bl *bl = dev_get_drvdata(dev); 238 enum lp8788_bl_ctrl_mode mode = bl->mode; 239 char *strmode; 240 241 if (is_brightness_ctrl_by_pwm(mode)) 242 strmode = "PWM based"; 243 else if (is_brightness_ctrl_by_register(mode)) 244 strmode = "Register based"; 245 else 246 strmode = "Invalid mode"; 247 248 return scnprintf(buf, PAGE_SIZE, "%s\n", strmode); 249 } 250 251 static DEVICE_ATTR(bl_ctl_mode, S_IRUGO, lp8788_get_bl_ctl_mode, NULL); 252 253 static struct attribute *lp8788_attributes[] = { 254 &dev_attr_bl_ctl_mode.attr, 255 NULL, 256 }; 257 258 static const struct attribute_group lp8788_attr_group = { 259 .attrs = lp8788_attributes, 260 }; 261 262 static int lp8788_backlight_probe(struct platform_device *pdev) 263 { 264 struct lp8788 *lp = dev_get_drvdata(pdev->dev.parent); 265 struct lp8788_bl *bl; 266 int ret; 267 268 bl = devm_kzalloc(lp->dev, sizeof(struct lp8788_bl), GFP_KERNEL); 269 if (!bl) 270 return -ENOMEM; 271 272 bl->lp = lp; 273 if (lp->pdata) 274 bl->pdata = lp->pdata->bl_pdata; 275 276 platform_set_drvdata(pdev, bl); 277 278 ret = lp8788_backlight_configure(bl); 279 if (ret) { 280 dev_err(lp->dev, "backlight config err: %d\n", ret); 281 goto err_dev; 282 } 283 284 ret = lp8788_backlight_register(bl); 285 if (ret) { 286 dev_err(lp->dev, "register backlight err: %d\n", ret); 287 goto err_dev; 288 } 289 290 ret = sysfs_create_group(&pdev->dev.kobj, &lp8788_attr_group); 291 if (ret) { 292 dev_err(lp->dev, "register sysfs err: %d\n", ret); 293 goto err_sysfs; 294 } 295 296 backlight_update_status(bl->bl_dev); 297 298 return 0; 299 300 err_sysfs: 301 lp8788_backlight_unregister(bl); 302 err_dev: 303 return ret; 304 } 305 306 static int lp8788_backlight_remove(struct platform_device *pdev) 307 { 308 struct lp8788_bl *bl = platform_get_drvdata(pdev); 309 struct backlight_device *bl_dev = bl->bl_dev; 310 311 bl_dev->props.brightness = 0; 312 backlight_update_status(bl_dev); 313 sysfs_remove_group(&pdev->dev.kobj, &lp8788_attr_group); 314 lp8788_backlight_unregister(bl); 315 316 return 0; 317 } 318 319 static struct platform_driver lp8788_bl_driver = { 320 .probe = lp8788_backlight_probe, 321 .remove = lp8788_backlight_remove, 322 .driver = { 323 .name = LP8788_DEV_BACKLIGHT, 324 .owner = THIS_MODULE, 325 }, 326 }; 327 module_platform_driver(lp8788_bl_driver); 328 329 MODULE_DESCRIPTION("Texas Instruments LP8788 Backlight Driver"); 330 MODULE_AUTHOR("Milo Kim"); 331 MODULE_LICENSE("GPL"); 332 MODULE_ALIAS("platform:lp8788-backlight"); 333