1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
2 | /* |
3 | * Definitions and platform data for Analog Devices |
4 | * ADP5520/ADP5501 MFD PMICs (Backlight, LED, GPIO and Keys) |
5 | * |
6 | * Copyright 2009 Analog Devices Inc. |
7 | */ |
8 | |
9 | |
10 | #ifndef __LINUX_MFD_ADP5520_H |
11 | #define __LINUX_MFD_ADP5520_H |
12 | |
13 | #define ID_ADP5520 5520 |
14 | #define ID_ADP5501 5501 |
15 | |
16 | /* |
17 | * ADP5520/ADP5501 Register Map |
18 | */ |
19 | |
20 | #define ADP5520_MODE_STATUS 0x00 |
21 | #define ADP5520_INTERRUPT_ENABLE 0x01 |
22 | #define ADP5520_BL_CONTROL 0x02 |
23 | #define ADP5520_BL_TIME 0x03 |
24 | #define ADP5520_BL_FADE 0x04 |
25 | #define ADP5520_DAYLIGHT_MAX 0x05 |
26 | #define ADP5520_DAYLIGHT_DIM 0x06 |
27 | #define ADP5520_OFFICE_MAX 0x07 |
28 | #define ADP5520_OFFICE_DIM 0x08 |
29 | #define ADP5520_DARK_MAX 0x09 |
30 | #define ADP5520_DARK_DIM 0x0A |
31 | #define ADP5520_BL_VALUE 0x0B |
32 | #define ADP5520_ALS_CMPR_CFG 0x0C |
33 | #define ADP5520_L2_TRIP 0x0D |
34 | #define ADP5520_L2_HYS 0x0E |
35 | #define ADP5520_L3_TRIP 0x0F |
36 | #define ADP5520_L3_HYS 0x10 |
37 | #define ADP5520_LED_CONTROL 0x11 |
38 | #define ADP5520_LED_TIME 0x12 |
39 | #define ADP5520_LED_FADE 0x13 |
40 | #define ADP5520_LED1_CURRENT 0x14 |
41 | #define ADP5520_LED2_CURRENT 0x15 |
42 | #define ADP5520_LED3_CURRENT 0x16 |
43 | |
44 | /* |
45 | * ADP5520 Register Map |
46 | */ |
47 | |
48 | #define ADP5520_GPIO_CFG_1 0x17 |
49 | #define ADP5520_GPIO_CFG_2 0x18 |
50 | #define ADP5520_GPIO_IN 0x19 |
51 | #define ADP5520_GPIO_OUT 0x1A |
52 | #define ADP5520_GPIO_INT_EN 0x1B |
53 | #define ADP5520_GPIO_INT_STAT 0x1C |
54 | #define ADP5520_GPIO_INT_LVL 0x1D |
55 | #define ADP5520_GPIO_DEBOUNCE 0x1E |
56 | #define ADP5520_GPIO_PULLUP 0x1F |
57 | #define ADP5520_KP_INT_STAT_1 0x20 |
58 | #define ADP5520_KP_INT_STAT_2 0x21 |
59 | #define ADP5520_KR_INT_STAT_1 0x22 |
60 | #define ADP5520_KR_INT_STAT_2 0x23 |
61 | #define ADP5520_KEY_STAT_1 0x24 |
62 | #define ADP5520_KEY_STAT_2 0x25 |
63 | |
64 | /* |
65 | * MODE_STATUS bits |
66 | */ |
67 | |
68 | #define ADP5520_nSTNBY (1 << 7) |
69 | #define ADP5520_BL_EN (1 << 6) |
70 | #define ADP5520_DIM_EN (1 << 5) |
71 | #define ADP5520_OVP_INT (1 << 4) |
72 | #define ADP5520_CMPR_INT (1 << 3) |
73 | #define ADP5520_GPI_INT (1 << 2) |
74 | #define ADP5520_KR_INT (1 << 1) |
75 | #define ADP5520_KP_INT (1 << 0) |
76 | |
77 | /* |
78 | * INTERRUPT_ENABLE bits |
79 | */ |
80 | |
81 | #define ADP5520_AUTO_LD_EN (1 << 4) |
82 | #define ADP5520_CMPR_IEN (1 << 3) |
83 | #define ADP5520_OVP_IEN (1 << 2) |
84 | #define ADP5520_KR_IEN (1 << 1) |
85 | #define ADP5520_KP_IEN (1 << 0) |
86 | |
87 | /* |
88 | * BL_CONTROL bits |
89 | */ |
90 | |
91 | #define ADP5520_BL_LVL ((x) << 5) |
92 | #define ADP5520_BL_LAW ((x) << 4) |
93 | #define ADP5520_BL_AUTO_ADJ (1 << 3) |
94 | #define ADP5520_OVP_EN (1 << 2) |
95 | #define ADP5520_FOVR (1 << 1) |
96 | #define ADP5520_KP_BL_EN (1 << 0) |
97 | |
98 | /* |
99 | * ALS_CMPR_CFG bits |
100 | */ |
101 | |
102 | #define ADP5520_L3_OUT (1 << 3) |
103 | #define ADP5520_L2_OUT (1 << 2) |
104 | #define ADP5520_L3_EN (1 << 1) |
105 | |
106 | #define ADP5020_MAX_BRIGHTNESS 0x7F |
107 | |
108 | #define FADE_VAL(in, out) ((0xF & (in)) | ((0xF & (out)) << 4)) |
109 | #define BL_CTRL_VAL(law, auto) (((1 & (auto)) << 3) | ((0x3 & (law)) << 4)) |
110 | #define ALS_CMPR_CFG_VAL(filt, l3_en) (((0x7 & filt) << 5) | l3_en) |
111 | |
112 | /* |
113 | * LEDs subdevice bits and masks |
114 | */ |
115 | |
116 | #define ADP5520_01_MAXLEDS 3 |
117 | |
118 | #define ADP5520_FLAG_LED_MASK 0x3 |
119 | #define ADP5520_FLAG_OFFT_SHIFT 8 |
120 | #define ADP5520_FLAG_OFFT_MASK 0x3 |
121 | |
122 | #define ADP5520_R3_MODE (1 << 5) |
123 | #define ADP5520_C3_MODE (1 << 4) |
124 | #define ADP5520_LED_LAW (1 << 3) |
125 | #define ADP5520_LED3_EN (1 << 2) |
126 | #define ADP5520_LED2_EN (1 << 1) |
127 | #define ADP5520_LED1_EN (1 << 0) |
128 | |
129 | /* |
130 | * GPIO subdevice bits and masks |
131 | */ |
132 | |
133 | #define ADP5520_MAXGPIOS 8 |
134 | |
135 | #define ADP5520_GPIO_C3 (1 << 7) /* LED2 or GPIO7 aka C3 */ |
136 | #define ADP5520_GPIO_C2 (1 << 6) |
137 | #define ADP5520_GPIO_C1 (1 << 5) |
138 | #define ADP5520_GPIO_C0 (1 << 4) |
139 | #define ADP5520_GPIO_R3 (1 << 3) /* LED3 or GPIO3 aka R3 */ |
140 | #define ADP5520_GPIO_R2 (1 << 2) |
141 | #define ADP5520_GPIO_R1 (1 << 1) |
142 | #define ADP5520_GPIO_R0 (1 << 0) |
143 | |
144 | struct adp5520_gpio_platform_data { |
145 | unsigned gpio_start; |
146 | u8 gpio_en_mask; |
147 | u8 gpio_pullup_mask; |
148 | }; |
149 | |
150 | /* |
151 | * Keypad subdevice bits and masks |
152 | */ |
153 | |
154 | #define ADP5520_MAXKEYS 16 |
155 | |
156 | #define ADP5520_COL_C3 (1 << 7) /* LED2 or GPIO7 aka C3 */ |
157 | #define ADP5520_COL_C2 (1 << 6) |
158 | #define ADP5520_COL_C1 (1 << 5) |
159 | #define ADP5520_COL_C0 (1 << 4) |
160 | #define ADP5520_ROW_R3 (1 << 3) /* LED3 or GPIO3 aka R3 */ |
161 | #define ADP5520_ROW_R2 (1 << 2) |
162 | #define ADP5520_ROW_R1 (1 << 1) |
163 | #define ADP5520_ROW_R0 (1 << 0) |
164 | |
165 | #define ADP5520_KEY(row, col) (col + row * 4) |
166 | #define ADP5520_KEYMAPSIZE ADP5520_MAXKEYS |
167 | |
168 | struct adp5520_keys_platform_data { |
169 | int rows_en_mask; /* Number of rows */ |
170 | int cols_en_mask; /* Number of columns */ |
171 | const unsigned short *keymap; /* Pointer to keymap */ |
172 | unsigned short keymapsize; /* Keymap size */ |
173 | unsigned repeat:1; /* Enable key repeat */ |
174 | }; |
175 | |
176 | |
177 | /* |
178 | * LEDs subdevice platform data |
179 | */ |
180 | |
181 | #define FLAG_ID_ADP5520_LED1_ADP5501_LED0 1 /* ADP5520 PIN ILED */ |
182 | #define FLAG_ID_ADP5520_LED2_ADP5501_LED1 2 /* ADP5520 PIN C3 */ |
183 | #define FLAG_ID_ADP5520_LED3_ADP5501_LED2 3 /* ADP5520 PIN R3 */ |
184 | |
185 | #define ADP5520_LED_DIS_BLINK (0 << ADP5520_FLAG_OFFT_SHIFT) |
186 | #define ADP5520_LED_OFFT_600ms (1 << ADP5520_FLAG_OFFT_SHIFT) |
187 | #define ADP5520_LED_OFFT_800ms (2 << ADP5520_FLAG_OFFT_SHIFT) |
188 | #define ADP5520_LED_OFFT_1200ms (3 << ADP5520_FLAG_OFFT_SHIFT) |
189 | |
190 | #define ADP5520_LED_ONT_200ms 0 |
191 | #define ADP5520_LED_ONT_600ms 1 |
192 | #define ADP5520_LED_ONT_800ms 2 |
193 | #define ADP5520_LED_ONT_1200ms 3 |
194 | |
195 | struct adp5520_leds_platform_data { |
196 | int num_leds; |
197 | struct led_info *leds; |
198 | u8 fade_in; /* Backlight Fade-In Timer */ |
199 | u8 fade_out; /* Backlight Fade-Out Timer */ |
200 | u8 led_on_time; |
201 | }; |
202 | |
203 | /* |
204 | * Backlight subdevice platform data |
205 | */ |
206 | |
207 | #define ADP5520_FADE_T_DIS 0 /* Fade Timer Disabled */ |
208 | #define ADP5520_FADE_T_300ms 1 /* 0.3 Sec */ |
209 | #define ADP5520_FADE_T_600ms 2 |
210 | #define ADP5520_FADE_T_900ms 3 |
211 | #define ADP5520_FADE_T_1200ms 4 |
212 | #define ADP5520_FADE_T_1500ms 5 |
213 | #define ADP5520_FADE_T_1800ms 6 |
214 | #define ADP5520_FADE_T_2100ms 7 |
215 | #define ADP5520_FADE_T_2400ms 8 |
216 | #define ADP5520_FADE_T_2700ms 9 |
217 | #define ADP5520_FADE_T_3000ms 10 |
218 | #define ADP5520_FADE_T_3500ms 11 |
219 | #define ADP5520_FADE_T_4000ms 12 |
220 | #define ADP5520_FADE_T_4500ms 13 |
221 | #define ADP5520_FADE_T_5000ms 14 |
222 | #define ADP5520_FADE_T_5500ms 15 /* 5.5 Sec */ |
223 | |
224 | #define ADP5520_BL_LAW_LINEAR 0 |
225 | #define ADP5520_BL_LAW_SQUARE 1 |
226 | #define ADP5520_BL_LAW_CUBIC1 2 |
227 | #define ADP5520_BL_LAW_CUBIC2 3 |
228 | |
229 | #define ADP5520_BL_AMBL_FILT_80ms 0 /* Light sensor filter time */ |
230 | #define ADP5520_BL_AMBL_FILT_160ms 1 |
231 | #define ADP5520_BL_AMBL_FILT_320ms 2 |
232 | #define ADP5520_BL_AMBL_FILT_640ms 3 |
233 | #define ADP5520_BL_AMBL_FILT_1280ms 4 |
234 | #define ADP5520_BL_AMBL_FILT_2560ms 5 |
235 | #define ADP5520_BL_AMBL_FILT_5120ms 6 |
236 | #define ADP5520_BL_AMBL_FILT_10240ms 7 /* 10.24 sec */ |
237 | |
238 | /* |
239 | * Blacklight current 0..30mA |
240 | */ |
241 | #define ADP5520_BL_CUR_mA(I) ((I * 127) / 30) |
242 | |
243 | /* |
244 | * L2 comparator current 0..1000uA |
245 | */ |
246 | #define ADP5520_L2_COMP_CURR_uA(I) ((I * 255) / 1000) |
247 | |
248 | /* |
249 | * L3 comparator current 0..127uA |
250 | */ |
251 | #define ADP5520_L3_COMP_CURR_uA(I) ((I * 255) / 127) |
252 | |
253 | struct adp5520_backlight_platform_data { |
254 | u8 fade_in; /* Backlight Fade-In Timer */ |
255 | u8 fade_out; /* Backlight Fade-Out Timer */ |
256 | u8 fade_led_law; /* fade-on/fade-off transfer characteristic */ |
257 | |
258 | u8 en_ambl_sens; /* 1 = enable ambient light sensor */ |
259 | u8 abml_filt; /* Light sensor filter time */ |
260 | u8 l1_daylight_max; /* use BL_CUR_mA(I) 0 <= I <= 30 mA */ |
261 | u8 l1_daylight_dim; /* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */ |
262 | u8 l2_office_max; /* use BL_CUR_mA(I) 0 <= I <= 30 mA */ |
263 | u8 l2_office_dim; /* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */ |
264 | u8 l3_dark_max; /* use BL_CUR_mA(I) 0 <= I <= 30 mA */ |
265 | u8 l3_dark_dim; /* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */ |
266 | u8 l2_trip; /* use L2_COMP_CURR_uA(I) 0 <= I <= 1000 uA */ |
267 | u8 l2_hyst; /* use L2_COMP_CURR_uA(I) 0 <= I <= 1000 uA */ |
268 | u8 l3_trip; /* use L3_COMP_CURR_uA(I) 0 <= I <= 127 uA */ |
269 | u8 l3_hyst; /* use L3_COMP_CURR_uA(I) 0 <= I <= 127 uA */ |
270 | }; |
271 | |
272 | /* |
273 | * MFD chip platform data |
274 | */ |
275 | |
276 | struct adp5520_platform_data { |
277 | struct adp5520_keys_platform_data *keys; |
278 | struct adp5520_gpio_platform_data *gpio; |
279 | struct adp5520_leds_platform_data *leds; |
280 | struct adp5520_backlight_platform_data *backlight; |
281 | }; |
282 | |
283 | /* |
284 | * MFD chip functions |
285 | */ |
286 | |
287 | extern int adp5520_read(struct device *dev, int reg, uint8_t *val); |
288 | extern int adp5520_write(struct device *dev, int reg, u8 val); |
289 | extern int adp5520_clr_bits(struct device *dev, int reg, uint8_t bit_mask); |
290 | extern int adp5520_set_bits(struct device *dev, int reg, uint8_t bit_mask); |
291 | |
292 | extern int adp5520_register_notifier(struct device *dev, |
293 | struct notifier_block *nb, unsigned int events); |
294 | |
295 | extern int adp5520_unregister_notifier(struct device *dev, |
296 | struct notifier_block *nb, unsigned int events); |
297 | |
298 | #endif /* __LINUX_MFD_ADP5520_H */ |
299 | |