1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3 * Definitions and platform data for Analog Devices
4 * Backlight drivers ADP8860
5 *
6 * Copyright 2009-2010 Analog Devices Inc.
7 */
8
9 #ifndef __LINUX_I2C_ADP8860_H
10 #define __LINUX_I2C_ADP8860_H
11
12 #include <linux/leds.h>
13 #include <linux/types.h>
14
15 #define ID_ADP8860 8860
16
17 #define ADP8860_MAX_BRIGHTNESS 0x7F
18 #define FLAG_OFFT_SHIFT 8
19
20 /*
21 * LEDs subdevice platform data
22 */
23
24 #define ADP8860_LED_DIS_BLINK (0 << FLAG_OFFT_SHIFT)
25 #define ADP8860_LED_OFFT_600ms (1 << FLAG_OFFT_SHIFT)
26 #define ADP8860_LED_OFFT_1200ms (2 << FLAG_OFFT_SHIFT)
27 #define ADP8860_LED_OFFT_1800ms (3 << FLAG_OFFT_SHIFT)
28
29 #define ADP8860_LED_ONT_200ms 0
30 #define ADP8860_LED_ONT_600ms 1
31 #define ADP8860_LED_ONT_800ms 2
32 #define ADP8860_LED_ONT_1200ms 3
33
34 #define ADP8860_LED_D7 (7)
35 #define ADP8860_LED_D6 (6)
36 #define ADP8860_LED_D5 (5)
37 #define ADP8860_LED_D4 (4)
38 #define ADP8860_LED_D3 (3)
39 #define ADP8860_LED_D2 (2)
40 #define ADP8860_LED_D1 (1)
41
42 /*
43 * Backlight subdevice platform data
44 */
45
46 #define ADP8860_BL_D7 (1 << 6)
47 #define ADP8860_BL_D6 (1 << 5)
48 #define ADP8860_BL_D5 (1 << 4)
49 #define ADP8860_BL_D4 (1 << 3)
50 #define ADP8860_BL_D3 (1 << 2)
51 #define ADP8860_BL_D2 (1 << 1)
52 #define ADP8860_BL_D1 (1 << 0)
53
54 #define ADP8860_FADE_T_DIS 0 /* Fade Timer Disabled */
55 #define ADP8860_FADE_T_300ms 1 /* 0.3 Sec */
56 #define ADP8860_FADE_T_600ms 2
57 #define ADP8860_FADE_T_900ms 3
58 #define ADP8860_FADE_T_1200ms 4
59 #define ADP8860_FADE_T_1500ms 5
60 #define ADP8860_FADE_T_1800ms 6
61 #define ADP8860_FADE_T_2100ms 7
62 #define ADP8860_FADE_T_2400ms 8
63 #define ADP8860_FADE_T_2700ms 9
64 #define ADP8860_FADE_T_3000ms 10
65 #define ADP8860_FADE_T_3500ms 11
66 #define ADP8860_FADE_T_4000ms 12
67 #define ADP8860_FADE_T_4500ms 13
68 #define ADP8860_FADE_T_5000ms 14
69 #define ADP8860_FADE_T_5500ms 15 /* 5.5 Sec */
70
71 #define ADP8860_FADE_LAW_LINEAR 0
72 #define ADP8860_FADE_LAW_SQUARE 1
73 #define ADP8860_FADE_LAW_CUBIC1 2
74 #define ADP8860_FADE_LAW_CUBIC2 3
75
76 #define ADP8860_BL_AMBL_FILT_80ms 0 /* Light sensor filter time */
77 #define ADP8860_BL_AMBL_FILT_160ms 1
78 #define ADP8860_BL_AMBL_FILT_320ms 2
79 #define ADP8860_BL_AMBL_FILT_640ms 3
80 #define ADP8860_BL_AMBL_FILT_1280ms 4
81 #define ADP8860_BL_AMBL_FILT_2560ms 5
82 #define ADP8860_BL_AMBL_FILT_5120ms 6
83 #define ADP8860_BL_AMBL_FILT_10240ms 7 /* 10.24 sec */
84
85 /*
86 * Blacklight current 0..30mA
87 */
88 #define ADP8860_BL_CUR_mA(I) ((I * 127) / 30)
89
90 /*
91 * L2 comparator current 0..1106uA
92 */
93 #define ADP8860_L2_COMP_CURR_uA(I) ((I * 255) / 1106)
94
95 /*
96 * L3 comparator current 0..138uA
97 */
98 #define ADP8860_L3_COMP_CURR_uA(I) ((I * 255) / 138)
99
100 struct adp8860_backlight_platform_data {
101 u8 bl_led_assign; /* 1 = Backlight 0 = Individual LED */
102
103 u8 bl_fade_in; /* Backlight Fade-In Timer */
104 u8 bl_fade_out; /* Backlight Fade-Out Timer */
105 u8 bl_fade_law; /* fade-on/fade-off transfer characteristic */
106
107 u8 en_ambl_sens; /* 1 = enable ambient light sensor */
108 u8 abml_filt; /* Light sensor filter time */
109
110 u8 l1_daylight_max; /* use BL_CUR_mA(I) 0 <= I <= 30 mA */
111 u8 l1_daylight_dim; /* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
112 u8 l2_office_max; /* use BL_CUR_mA(I) 0 <= I <= 30 mA */
113 u8 l2_office_dim; /* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
114 u8 l3_dark_max; /* use BL_CUR_mA(I) 0 <= I <= 30 mA */
115 u8 l3_dark_dim; /* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
116
117 u8 l2_trip; /* use L2_COMP_CURR_uA(I) 0 <= I <= 1106 uA */
118 u8 l2_hyst; /* use L2_COMP_CURR_uA(I) 0 <= I <= 1106 uA */
119 u8 l3_trip; /* use L3_COMP_CURR_uA(I) 0 <= I <= 551 uA */
120 u8 l3_hyst; /* use L3_COMP_CURR_uA(I) 0 <= I <= 551 uA */
121
122 /**
123 * Independent Current Sinks / LEDS
124 * Sinks not assigned to the Backlight can be exposed to
125 * user space using the LEDS CLASS interface
126 */
127
128 int num_leds;
129 struct led_info *leds;
130 u8 led_fade_in; /* LED Fade-In Timer */
131 u8 led_fade_out; /* LED Fade-Out Timer */
132 u8 led_fade_law; /* fade-on/fade-off transfer characteristic */
133 u8 led_on_time;
134
135 /**
136 * Gain down disable. Setting this option does not allow the
137 * charge pump to switch to lower gains. NOT AVAILABLE on ADP8860
138 * 1 = the charge pump doesn't switch down in gain until all LEDs are 0.
139 * The charge pump switches up in gain as needed. This feature is
140 * useful if the ADP8863 charge pump is used to drive an external load.
141 * This feature must be used when utilizing small fly capacitors
142 * (0402 or smaller).
143 * 0 = the charge pump automatically switches up and down in gain.
144 * This provides optimal efficiency, but is not suitable for driving
145 * loads that are not connected through the ADP8863 diode drivers.
146 * Additionally, the charge pump fly capacitors should be low ESR
147 * and sized 0603 or greater.
148 */
149
150 u8 gdwn_dis;
151 };
152
153 #endif /* __LINUX_I2C_ADP8860_H */