2 * Copyright (C) 2011 ST-Ericsson SA.
3 * Copyright (C) 2009 Motorola, Inc.
5 * License Terms: GNU General Public License v2
7 * Simple driver for National Semiconductor LM3530 Backlight driver chip
9 * Author: Shreshtha Kumar SAHU <shreshthakumar.sahu@stericsson.com>
10 * based on leds-lm3530.c by Dan Murphy <D.Murphy@motorola.com>
13 #include <linux/i2c.h>
14 #include <linux/leds.h>
15 #include <linux/slab.h>
16 #include <linux/platform_device.h>
17 #include <linux/input.h>
18 #include <linux/led-lm3530.h>
19 #include <linux/types.h>
20 #include <linux/regulator/consumer.h>
21 #include <linux/module.h>
23 #define LM3530_LED_DEV "lcd-backlight"
24 #define LM3530_NAME "lm3530-led"
26 #define LM3530_GEN_CONFIG 0x10
27 #define LM3530_ALS_CONFIG 0x20
28 #define LM3530_BRT_RAMP_RATE 0x30
29 #define LM3530_ALS_IMP_SELECT 0x41
30 #define LM3530_BRT_CTRL_REG 0xA0
31 #define LM3530_ALS_ZB0_REG 0x60
32 #define LM3530_ALS_ZB1_REG 0x61
33 #define LM3530_ALS_ZB2_REG 0x62
34 #define LM3530_ALS_ZB3_REG 0x63
35 #define LM3530_ALS_Z0T_REG 0x70
36 #define LM3530_ALS_Z1T_REG 0x71
37 #define LM3530_ALS_Z2T_REG 0x72
38 #define LM3530_ALS_Z3T_REG 0x73
39 #define LM3530_ALS_Z4T_REG 0x74
40 #define LM3530_REG_MAX 14
42 /* General Control Register */
43 #define LM3530_EN_I2C_SHIFT (0)
44 #define LM3530_RAMP_LAW_SHIFT (1)
45 #define LM3530_MAX_CURR_SHIFT (2)
46 #define LM3530_EN_PWM_SHIFT (5)
47 #define LM3530_PWM_POL_SHIFT (6)
48 #define LM3530_EN_PWM_SIMPLE_SHIFT (7)
50 #define LM3530_ENABLE_I2C (1 << LM3530_EN_I2C_SHIFT)
51 #define LM3530_ENABLE_PWM (1 << LM3530_EN_PWM_SHIFT)
52 #define LM3530_POL_LOW (1 << LM3530_PWM_POL_SHIFT)
53 #define LM3530_ENABLE_PWM_SIMPLE (1 << LM3530_EN_PWM_SIMPLE_SHIFT)
55 /* ALS Config Register Options */
56 #define LM3530_ALS_AVG_TIME_SHIFT (0)
57 #define LM3530_EN_ALS_SHIFT (3)
58 #define LM3530_ALS_SEL_SHIFT (5)
60 #define LM3530_ENABLE_ALS (3 << LM3530_EN_ALS_SHIFT)
62 /* Brightness Ramp Rate Register */
63 #define LM3530_BRT_RAMP_FALL_SHIFT (0)
64 #define LM3530_BRT_RAMP_RISE_SHIFT (3)
66 /* ALS Resistor Select */
67 #define LM3530_ALS1_IMP_SHIFT (0)
68 #define LM3530_ALS2_IMP_SHIFT (4)
70 /* Zone Boundary Register defaults */
71 #define LM3530_ALS_ZB_MAX (4)
72 #define LM3530_ALS_WINDOW_mV (1000)
73 #define LM3530_ALS_OFFSET_mV (4)
75 /* Zone Target Register defaults */
76 #define LM3530_DEF_ZT_0 (0x7F)
77 #define LM3530_DEF_ZT_1 (0x66)
78 #define LM3530_DEF_ZT_2 (0x4C)
79 #define LM3530_DEF_ZT_3 (0x33)
80 #define LM3530_DEF_ZT_4 (0x19)
82 /* 7 bits are used for the brightness : LM3530_BRT_CTRL_REG */
83 #define MAX_BRIGHTNESS (127)
85 struct lm3530_mode_map
{
87 enum lm3530_mode mode_val
;
90 static struct lm3530_mode_map mode_map
[] = {
91 { "man", LM3530_BL_MODE_MANUAL
},
92 { "als", LM3530_BL_MODE_ALS
},
93 { "pwm", LM3530_BL_MODE_PWM
},
98 * @led_dev: led class device
100 * @pdata: LM3530 platform data
101 * @mode: mode of operation - manual, ALS, PWM
102 * @regulator: regulator
103 * @brighness: previous brightness value
104 * @enable: regulator is enabled
107 struct led_classdev led_dev
;
108 struct i2c_client
*client
;
109 struct lm3530_platform_data
*pdata
;
110 enum lm3530_mode mode
;
111 struct regulator
*regulator
;
112 enum led_brightness brightness
;
117 * struct lm3530_als_data
118 * @config : value of ALS configuration register
119 * @imp_sel : value of ALS resistor select register
120 * @zone : values of ALS ZB(Zone Boundary) registers
122 struct lm3530_als_data
{
125 u8 zones
[LM3530_ALS_ZB_MAX
];
128 static const u8 lm3530_reg
[LM3530_REG_MAX
] = {
131 LM3530_BRT_RAMP_RATE
,
132 LM3530_ALS_IMP_SELECT
,
145 static int lm3530_get_mode_from_str(const char *str
)
149 for (i
= 0; i
< ARRAY_SIZE(mode_map
); i
++)
150 if (sysfs_streq(str
, mode_map
[i
].mode
))
151 return mode_map
[i
].mode_val
;
156 static void lm3530_als_configure(struct lm3530_platform_data
*pdata
,
157 struct lm3530_als_data
*als
)
160 u32 als_vmin
, als_vmax
, als_vstep
;
162 if (pdata
->als_vmax
== 0) {
164 pdata
->als_vmax
= LM3530_ALS_WINDOW_mV
;
167 als_vmin
= pdata
->als_vmin
;
168 als_vmax
= pdata
->als_vmax
;
170 if ((als_vmax
- als_vmin
) > LM3530_ALS_WINDOW_mV
)
171 pdata
->als_vmax
= als_vmax
= als_vmin
+ LM3530_ALS_WINDOW_mV
;
173 /* n zone boundary makes n+1 zones */
174 als_vstep
= (als_vmax
- als_vmin
) / (LM3530_ALS_ZB_MAX
+ 1);
176 for (i
= 0; i
< LM3530_ALS_ZB_MAX
; i
++)
177 als
->zones
[i
] = (((als_vmin
+ LM3530_ALS_OFFSET_mV
) +
178 als_vstep
+ (i
* als_vstep
)) * LED_FULL
) / 1000;
181 (pdata
->als_avrg_time
<< LM3530_ALS_AVG_TIME_SHIFT
) |
182 (LM3530_ENABLE_ALS
) |
183 (pdata
->als_input_mode
<< LM3530_ALS_SEL_SHIFT
);
186 (pdata
->als1_resistor_sel
<< LM3530_ALS1_IMP_SHIFT
) |
187 (pdata
->als2_resistor_sel
<< LM3530_ALS2_IMP_SHIFT
);
190 static int lm3530_led_enable(struct lm3530_data
*drvdata
)
197 ret
= regulator_enable(drvdata
->regulator
);
199 dev_err(drvdata
->led_dev
.dev
, "Failed to enable vin:%d\n", ret
);
203 drvdata
->enable
= true;
207 static void lm3530_led_disable(struct lm3530_data
*drvdata
)
211 if (!drvdata
->enable
)
214 ret
= regulator_disable(drvdata
->regulator
);
216 dev_err(drvdata
->led_dev
.dev
, "Failed to disable vin:%d\n",
221 drvdata
->enable
= false;
224 static int lm3530_init_registers(struct lm3530_data
*drvdata
)
231 u8 reg_val
[LM3530_REG_MAX
];
232 struct lm3530_platform_data
*pdata
= drvdata
->pdata
;
233 struct i2c_client
*client
= drvdata
->client
;
234 struct lm3530_pwm_data
*pwm
= &pdata
->pwm_data
;
235 struct lm3530_als_data als
;
237 memset(&als
, 0, sizeof(struct lm3530_als_data
));
239 gen_config
= (pdata
->brt_ramp_law
<< LM3530_RAMP_LAW_SHIFT
) |
240 ((pdata
->max_current
& 7) << LM3530_MAX_CURR_SHIFT
);
242 switch (drvdata
->mode
) {
243 case LM3530_BL_MODE_MANUAL
:
244 gen_config
|= LM3530_ENABLE_I2C
;
246 case LM3530_BL_MODE_ALS
:
247 gen_config
|= LM3530_ENABLE_I2C
;
248 lm3530_als_configure(pdata
, &als
);
250 case LM3530_BL_MODE_PWM
:
251 gen_config
|= LM3530_ENABLE_PWM
| LM3530_ENABLE_PWM_SIMPLE
|
252 (pdata
->pwm_pol_hi
<< LM3530_PWM_POL_SHIFT
);
256 brt_ramp
= (pdata
->brt_ramp_fall
<< LM3530_BRT_RAMP_FALL_SHIFT
) |
257 (pdata
->brt_ramp_rise
<< LM3530_BRT_RAMP_RISE_SHIFT
);
259 if (drvdata
->brightness
)
260 brightness
= drvdata
->brightness
;
262 brightness
= drvdata
->brightness
= pdata
->brt_val
;
264 if (brightness
> drvdata
->led_dev
.max_brightness
)
265 brightness
= drvdata
->led_dev
.max_brightness
;
267 reg_val
[0] = gen_config
; /* LM3530_GEN_CONFIG */
268 reg_val
[1] = als
.config
; /* LM3530_ALS_CONFIG */
269 reg_val
[2] = brt_ramp
; /* LM3530_BRT_RAMP_RATE */
270 reg_val
[3] = als
.imp_sel
; /* LM3530_ALS_IMP_SELECT */
271 reg_val
[4] = brightness
; /* LM3530_BRT_CTRL_REG */
272 reg_val
[5] = als
.zones
[0]; /* LM3530_ALS_ZB0_REG */
273 reg_val
[6] = als
.zones
[1]; /* LM3530_ALS_ZB1_REG */
274 reg_val
[7] = als
.zones
[2]; /* LM3530_ALS_ZB2_REG */
275 reg_val
[8] = als
.zones
[3]; /* LM3530_ALS_ZB3_REG */
276 reg_val
[9] = LM3530_DEF_ZT_0
; /* LM3530_ALS_Z0T_REG */
277 reg_val
[10] = LM3530_DEF_ZT_1
; /* LM3530_ALS_Z1T_REG */
278 reg_val
[11] = LM3530_DEF_ZT_2
; /* LM3530_ALS_Z2T_REG */
279 reg_val
[12] = LM3530_DEF_ZT_3
; /* LM3530_ALS_Z3T_REG */
280 reg_val
[13] = LM3530_DEF_ZT_4
; /* LM3530_ALS_Z4T_REG */
282 ret
= lm3530_led_enable(drvdata
);
286 for (i
= 0; i
< LM3530_REG_MAX
; i
++) {
287 /* do not update brightness register when pwm mode */
288 if (lm3530_reg
[i
] == LM3530_BRT_CTRL_REG
&&
289 drvdata
->mode
== LM3530_BL_MODE_PWM
) {
290 if (pwm
->pwm_set_intensity
)
291 pwm
->pwm_set_intensity(reg_val
[i
],
292 drvdata
->led_dev
.max_brightness
);
296 ret
= i2c_smbus_write_byte_data(client
,
297 lm3530_reg
[i
], reg_val
[i
]);
305 static void lm3530_brightness_set(struct led_classdev
*led_cdev
,
306 enum led_brightness brt_val
)
309 struct lm3530_data
*drvdata
=
310 container_of(led_cdev
, struct lm3530_data
, led_dev
);
311 struct lm3530_platform_data
*pdata
= drvdata
->pdata
;
312 struct lm3530_pwm_data
*pwm
= &pdata
->pwm_data
;
313 u8 max_brightness
= led_cdev
->max_brightness
;
315 switch (drvdata
->mode
) {
316 case LM3530_BL_MODE_MANUAL
:
318 if (!drvdata
->enable
) {
319 err
= lm3530_init_registers(drvdata
);
321 dev_err(&drvdata
->client
->dev
,
322 "Register Init failed: %d\n", err
);
327 /* set the brightness in brightness control register*/
328 err
= i2c_smbus_write_byte_data(drvdata
->client
,
329 LM3530_BRT_CTRL_REG
, brt_val
);
331 dev_err(&drvdata
->client
->dev
,
332 "Unable to set brightness: %d\n", err
);
334 drvdata
->brightness
= brt_val
;
337 lm3530_led_disable(drvdata
);
339 case LM3530_BL_MODE_ALS
:
341 case LM3530_BL_MODE_PWM
:
342 if (pwm
->pwm_set_intensity
)
343 pwm
->pwm_set_intensity(brt_val
, max_brightness
);
350 static ssize_t
lm3530_mode_get(struct device
*dev
,
351 struct device_attribute
*attr
, char *buf
)
353 struct led_classdev
*led_cdev
= dev_get_drvdata(dev
);
354 struct lm3530_data
*drvdata
;
357 drvdata
= container_of(led_cdev
, struct lm3530_data
, led_dev
);
358 for (i
= 0; i
< ARRAY_SIZE(mode_map
); i
++)
359 if (drvdata
->mode
== mode_map
[i
].mode_val
)
360 len
+= sprintf(buf
+ len
, "[%s] ", mode_map
[i
].mode
);
362 len
+= sprintf(buf
+ len
, "%s ", mode_map
[i
].mode
);
364 len
+= sprintf(buf
+ len
, "\n");
369 static ssize_t
lm3530_mode_set(struct device
*dev
, struct device_attribute
370 *attr
, const char *buf
, size_t size
)
372 struct led_classdev
*led_cdev
= dev_get_drvdata(dev
);
373 struct lm3530_data
*drvdata
;
374 struct lm3530_pwm_data
*pwm
;
378 drvdata
= container_of(led_cdev
, struct lm3530_data
, led_dev
);
379 pwm
= &drvdata
->pdata
->pwm_data
;
380 max_brightness
= led_cdev
->max_brightness
;
381 mode
= lm3530_get_mode_from_str(buf
);
383 dev_err(dev
, "Invalid mode\n");
387 drvdata
->mode
= mode
;
389 /* set pwm to low if unnecessary */
390 if (mode
!= LM3530_BL_MODE_PWM
&& pwm
->pwm_set_intensity
)
391 pwm
->pwm_set_intensity(0, max_brightness
);
393 err
= lm3530_init_registers(drvdata
);
395 dev_err(dev
, "Setting %s Mode failed :%d\n", buf
, err
);
399 return sizeof(drvdata
->mode
);
401 static DEVICE_ATTR(mode
, 0644, lm3530_mode_get
, lm3530_mode_set
);
403 static int lm3530_probe(struct i2c_client
*client
,
404 const struct i2c_device_id
*id
)
406 struct lm3530_platform_data
*pdata
= dev_get_platdata(&client
->dev
);
407 struct lm3530_data
*drvdata
;
411 dev_err(&client
->dev
, "platform data required\n");
416 if (pdata
->mode
> LM3530_BL_MODE_PWM
) {
417 dev_err(&client
->dev
, "Illegal Mode request\n");
421 if (!i2c_check_functionality(client
->adapter
, I2C_FUNC_I2C
)) {
422 dev_err(&client
->dev
, "I2C_FUNC_I2C not supported\n");
426 drvdata
= devm_kzalloc(&client
->dev
, sizeof(struct lm3530_data
),
431 drvdata
->mode
= pdata
->mode
;
432 drvdata
->client
= client
;
433 drvdata
->pdata
= pdata
;
434 drvdata
->brightness
= LED_OFF
;
435 drvdata
->enable
= false;
436 drvdata
->led_dev
.name
= LM3530_LED_DEV
;
437 drvdata
->led_dev
.brightness_set
= lm3530_brightness_set
;
438 drvdata
->led_dev
.max_brightness
= MAX_BRIGHTNESS
;
440 i2c_set_clientdata(client
, drvdata
);
442 drvdata
->regulator
= devm_regulator_get(&client
->dev
, "vin");
443 if (IS_ERR(drvdata
->regulator
)) {
444 dev_err(&client
->dev
, "regulator get failed\n");
445 err
= PTR_ERR(drvdata
->regulator
);
446 drvdata
->regulator
= NULL
;
450 if (drvdata
->pdata
->brt_val
) {
451 err
= lm3530_init_registers(drvdata
);
453 dev_err(&client
->dev
,
454 "Register Init failed: %d\n", err
);
458 err
= led_classdev_register(&client
->dev
, &drvdata
->led_dev
);
460 dev_err(&client
->dev
, "Register led class failed: %d\n", err
);
464 err
= device_create_file(drvdata
->led_dev
.dev
, &dev_attr_mode
);
466 dev_err(&client
->dev
, "File device creation failed: %d\n", err
);
468 goto err_create_file
;
474 led_classdev_unregister(&drvdata
->led_dev
);
478 static int lm3530_remove(struct i2c_client
*client
)
480 struct lm3530_data
*drvdata
= i2c_get_clientdata(client
);
482 device_remove_file(drvdata
->led_dev
.dev
, &dev_attr_mode
);
484 lm3530_led_disable(drvdata
);
485 led_classdev_unregister(&drvdata
->led_dev
);
489 static const struct i2c_device_id lm3530_id
[] = {
493 MODULE_DEVICE_TABLE(i2c
, lm3530_id
);
495 static struct i2c_driver lm3530_i2c_driver
= {
496 .probe
= lm3530_probe
,
497 .remove
= lm3530_remove
,
498 .id_table
= lm3530_id
,
501 .owner
= THIS_MODULE
,
505 module_i2c_driver(lm3530_i2c_driver
);
507 MODULE_DESCRIPTION("Back Light driver for LM3530");
508 MODULE_LICENSE("GPL v2");
509 MODULE_AUTHOR("Shreshtha Kumar SAHU <shreshthakumar.sahu@stericsson.com>");