1 /* SPDX-License-Identifier: GPL-2.0-only */ <<
2 /* 1 /*
3 * Copyright (C) 2011 ST-Ericsson SA. 2 * Copyright (C) 2011 ST-Ericsson SA.
4 * Copyright (C) 2009 Motorola, Inc. 3 * Copyright (C) 2009 Motorola, Inc.
>> 4 *
>> 5 * License Terms: GNU General Public License v2
5 * 6 *
6 * Simple driver for National Semiconductor LM 7 * Simple driver for National Semiconductor LM35330 Backlight driver chip
7 * 8 *
8 * Author: Shreshtha Kumar SAHU <shreshthakuma 9 * Author: Shreshtha Kumar SAHU <shreshthakumar.sahu@stericsson.com>
9 * based on leds-lm3530.c by Dan Murphy <D.Mur 10 * based on leds-lm3530.c by Dan Murphy <D.Murphy@motorola.com>
10 */ 11 */
11 12
12 #ifndef _LINUX_LED_LM3530_H__ 13 #ifndef _LINUX_LED_LM3530_H__
13 #define _LINUX_LED_LM3530_H__ 14 #define _LINUX_LED_LM3530_H__
14 15
15 #define LM3530_FS_CURR_5mA (0) /* 16 #define LM3530_FS_CURR_5mA (0) /* Full Scale Current */
16 #define LM3530_FS_CURR_8mA (1) 17 #define LM3530_FS_CURR_8mA (1)
17 #define LM3530_FS_CURR_12mA (2) 18 #define LM3530_FS_CURR_12mA (2)
18 #define LM3530_FS_CURR_15mA (3) 19 #define LM3530_FS_CURR_15mA (3)
19 #define LM3530_FS_CURR_19mA (4) 20 #define LM3530_FS_CURR_19mA (4)
20 #define LM3530_FS_CURR_22mA (5) 21 #define LM3530_FS_CURR_22mA (5)
21 #define LM3530_FS_CURR_26mA (6) 22 #define LM3530_FS_CURR_26mA (6)
22 #define LM3530_FS_CURR_29mA (7) 23 #define LM3530_FS_CURR_29mA (7)
23 24
24 #define LM3530_ALS_AVRG_TIME_32ms (0) /* 25 #define LM3530_ALS_AVRG_TIME_32ms (0) /* ALS Averaging Time */
25 #define LM3530_ALS_AVRG_TIME_64ms (1) 26 #define LM3530_ALS_AVRG_TIME_64ms (1)
26 #define LM3530_ALS_AVRG_TIME_128ms (2) 27 #define LM3530_ALS_AVRG_TIME_128ms (2)
27 #define LM3530_ALS_AVRG_TIME_256ms (3) 28 #define LM3530_ALS_AVRG_TIME_256ms (3)
28 #define LM3530_ALS_AVRG_TIME_512ms (4) 29 #define LM3530_ALS_AVRG_TIME_512ms (4)
29 #define LM3530_ALS_AVRG_TIME_1024ms (5) 30 #define LM3530_ALS_AVRG_TIME_1024ms (5)
30 #define LM3530_ALS_AVRG_TIME_2048ms (6) 31 #define LM3530_ALS_AVRG_TIME_2048ms (6)
31 #define LM3530_ALS_AVRG_TIME_4096ms (7) 32 #define LM3530_ALS_AVRG_TIME_4096ms (7)
32 33
33 #define LM3530_RAMP_TIME_1ms (0) /* 34 #define LM3530_RAMP_TIME_1ms (0) /* Brigtness Ramp Time */
34 #define LM3530_RAMP_TIME_130ms (1) /* 35 #define LM3530_RAMP_TIME_130ms (1) /* Max to 0 and vice versa */
35 #define LM3530_RAMP_TIME_260ms (2) 36 #define LM3530_RAMP_TIME_260ms (2)
36 #define LM3530_RAMP_TIME_520ms (3) 37 #define LM3530_RAMP_TIME_520ms (3)
37 #define LM3530_RAMP_TIME_1s (4) 38 #define LM3530_RAMP_TIME_1s (4)
38 #define LM3530_RAMP_TIME_2s (5) 39 #define LM3530_RAMP_TIME_2s (5)
39 #define LM3530_RAMP_TIME_4s (6) 40 #define LM3530_RAMP_TIME_4s (6)
40 #define LM3530_RAMP_TIME_8s (7) 41 #define LM3530_RAMP_TIME_8s (7)
41 42
42 /* ALS Resistor Select */ 43 /* ALS Resistor Select */
43 #define LM3530_ALS_IMPD_Z (0x00) 44 #define LM3530_ALS_IMPD_Z (0x00) /* ALS Impedance */
44 #define LM3530_ALS_IMPD_13_53kOhm (0x01) 45 #define LM3530_ALS_IMPD_13_53kOhm (0x01)
45 #define LM3530_ALS_IMPD_9_01kOhm (0x02) 46 #define LM3530_ALS_IMPD_9_01kOhm (0x02)
46 #define LM3530_ALS_IMPD_5_41kOhm (0x03) 47 #define LM3530_ALS_IMPD_5_41kOhm (0x03)
47 #define LM3530_ALS_IMPD_2_27kOhm (0x04) 48 #define LM3530_ALS_IMPD_2_27kOhm (0x04)
48 #define LM3530_ALS_IMPD_1_94kOhm (0x05) 49 #define LM3530_ALS_IMPD_1_94kOhm (0x05)
49 #define LM3530_ALS_IMPD_1_81kOhm (0x06) 50 #define LM3530_ALS_IMPD_1_81kOhm (0x06)
50 #define LM3530_ALS_IMPD_1_6kOhm (0x07) 51 #define LM3530_ALS_IMPD_1_6kOhm (0x07)
51 #define LM3530_ALS_IMPD_1_138kOhm (0x08) 52 #define LM3530_ALS_IMPD_1_138kOhm (0x08)
52 #define LM3530_ALS_IMPD_1_05kOhm (0x09) 53 #define LM3530_ALS_IMPD_1_05kOhm (0x09)
53 #define LM3530_ALS_IMPD_1_011kOhm (0x0A) 54 #define LM3530_ALS_IMPD_1_011kOhm (0x0A)
54 #define LM3530_ALS_IMPD_941Ohm (0x0B) 55 #define LM3530_ALS_IMPD_941Ohm (0x0B)
55 #define LM3530_ALS_IMPD_759Ohm (0x0C) 56 #define LM3530_ALS_IMPD_759Ohm (0x0C)
56 #define LM3530_ALS_IMPD_719Ohm (0x0D) 57 #define LM3530_ALS_IMPD_719Ohm (0x0D)
57 #define LM3530_ALS_IMPD_700Ohm (0x0E) 58 #define LM3530_ALS_IMPD_700Ohm (0x0E)
58 #define LM3530_ALS_IMPD_667Ohm (0x0F) 59 #define LM3530_ALS_IMPD_667Ohm (0x0F)
59 60
60 enum lm3530_mode { 61 enum lm3530_mode {
61 LM3530_BL_MODE_MANUAL = 0, /* "ma 62 LM3530_BL_MODE_MANUAL = 0, /* "man" */
62 LM3530_BL_MODE_ALS, /* "al 63 LM3530_BL_MODE_ALS, /* "als" */
63 LM3530_BL_MODE_PWM, /* "pw 64 LM3530_BL_MODE_PWM, /* "pwm" */
64 }; 65 };
65 66
66 /* ALS input select */ 67 /* ALS input select */
67 enum lm3530_als_mode { 68 enum lm3530_als_mode {
68 LM3530_INPUT_AVRG = 0, /* ALS1 and AL 69 LM3530_INPUT_AVRG = 0, /* ALS1 and ALS2 input average */
69 LM3530_INPUT_ALS1, /* ALS1 Input 70 LM3530_INPUT_ALS1, /* ALS1 Input */
70 LM3530_INPUT_ALS2, /* ALS2 Input 71 LM3530_INPUT_ALS2, /* ALS2 Input */
71 LM3530_INPUT_CEIL, /* Max of ALS1 72 LM3530_INPUT_CEIL, /* Max of ALS1 and ALS2 */
72 }; 73 };
73 74
74 /* PWM Platform Specific Data */ 75 /* PWM Platform Specific Data */
75 struct lm3530_pwm_data { 76 struct lm3530_pwm_data {
76 void (*pwm_set_intensity) (int brightn 77 void (*pwm_set_intensity) (int brightness, int max_brightness);
77 int (*pwm_get_intensity) (int max_brig 78 int (*pwm_get_intensity) (int max_brightness);
78 }; 79 };
79 80
80 /** 81 /**
81 * struct lm3530_platform_data 82 * struct lm3530_platform_data
82 * @mode: mode of operation i.e. Manual, ALS o 83 * @mode: mode of operation i.e. Manual, ALS or PWM
83 * @als_input_mode: select source of ALS input 84 * @als_input_mode: select source of ALS input - ALS1/2 or average
84 * @max_current: full scale LED current 85 * @max_current: full scale LED current
85 * @pwm_pol_hi: PWM input polarity - active hi 86 * @pwm_pol_hi: PWM input polarity - active high/active low
86 * @als_avrg_time: ALS input averaging time 87 * @als_avrg_time: ALS input averaging time
87 * @brt_ramp_law: brightness mapping mode - ex 88 * @brt_ramp_law: brightness mapping mode - exponential/linear
88 * @brt_ramp_fall: rate of fall of led current 89 * @brt_ramp_fall: rate of fall of led current
89 * @brt_ramp_rise: rate of rise of led current 90 * @brt_ramp_rise: rate of rise of led current
90 * @als1_resistor_sel: internal resistance fro 91 * @als1_resistor_sel: internal resistance from ALS1 input to ground
91 * @als2_resistor_sel: internal resistance fro 92 * @als2_resistor_sel: internal resistance from ALS2 input to ground
92 * @als_vmin: als input voltage calibrated for 93 * @als_vmin: als input voltage calibrated for max brightness in mV
93 * @als_vmax: als input voltage calibrated for 94 * @als_vmax: als input voltage calibrated for min brightness in mV
94 * @brt_val: brightness value (0-127) 95 * @brt_val: brightness value (0-127)
95 * @pwm_data: PWM control functions (only vali 96 * @pwm_data: PWM control functions (only valid when the mode is PWM)
96 */ 97 */
97 struct lm3530_platform_data { 98 struct lm3530_platform_data {
98 enum lm3530_mode mode; 99 enum lm3530_mode mode;
99 enum lm3530_als_mode als_input_mode; 100 enum lm3530_als_mode als_input_mode;
100 101
101 u8 max_current; 102 u8 max_current;
102 bool pwm_pol_hi; 103 bool pwm_pol_hi;
103 u8 als_avrg_time; 104 u8 als_avrg_time;
104 105
105 bool brt_ramp_law; 106 bool brt_ramp_law;
106 u8 brt_ramp_fall; 107 u8 brt_ramp_fall;
107 u8 brt_ramp_rise; 108 u8 brt_ramp_rise;
108 109
109 u8 als1_resistor_sel; 110 u8 als1_resistor_sel;
110 u8 als2_resistor_sel; 111 u8 als2_resistor_sel;
111 112
112 u32 als_vmin; 113 u32 als_vmin;
113 u32 als_vmax; 114 u32 als_vmax;
114 115
115 u8 brt_val; 116 u8 brt_val;
116 117
117 struct lm3530_pwm_data pwm_data; 118 struct lm3530_pwm_data pwm_data;
118 }; 119 };
119 120
120 #endif /* _LINUX_LED_LM3530_H__ */ 121 #endif /* _LINUX_LED_LM3530_H__ */
121 122
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.