1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * Definitions and platform data for Analog Devices
4  * Backlight drivers ADP8870
5  *
6  * Copyright 2009-2010 Analog Devices Inc.
7  */
8 
9 #ifndef __LINUX_I2C_ADP8870_H
10 #define __LINUX_I2C_ADP8870_H
11 
12 #define ID_ADP8870		8870
13 
14 #define ADP8870_MAX_BRIGHTNESS	0x7F
15 #define FLAG_OFFT_SHIFT 8
16 
17 /*
18  * LEDs subdevice platform data
19  */
20 
21 #define ADP8870_LED_DIS_BLINK	(0 << FLAG_OFFT_SHIFT)
22 #define ADP8870_LED_OFFT_600ms	(1 << FLAG_OFFT_SHIFT)
23 #define ADP8870_LED_OFFT_1200ms	(2 << FLAG_OFFT_SHIFT)
24 #define ADP8870_LED_OFFT_1800ms	(3 << FLAG_OFFT_SHIFT)
25 
26 #define ADP8870_LED_ONT_200ms	0
27 #define ADP8870_LED_ONT_600ms	1
28 #define ADP8870_LED_ONT_800ms	2
29 #define ADP8870_LED_ONT_1200ms	3
30 
31 #define ADP8870_LED_D7		(7)
32 #define ADP8870_LED_D6		(6)
33 #define ADP8870_LED_D5		(5)
34 #define ADP8870_LED_D4		(4)
35 #define ADP8870_LED_D3		(3)
36 #define ADP8870_LED_D2		(2)
37 #define ADP8870_LED_D1		(1)
38 
39 /*
40  * Backlight subdevice platform data
41  */
42 
43 #define ADP8870_BL_D7		(1 << 6)
44 #define ADP8870_BL_D6		(1 << 5)
45 #define ADP8870_BL_D5		(1 << 4)
46 #define ADP8870_BL_D4		(1 << 3)
47 #define ADP8870_BL_D3		(1 << 2)
48 #define ADP8870_BL_D2		(1 << 1)
49 #define ADP8870_BL_D1		(1 << 0)
50 
51 #define ADP8870_FADE_T_DIS	0	/* Fade Timer Disabled */
52 #define ADP8870_FADE_T_300ms	1	/* 0.3 Sec */
53 #define ADP8870_FADE_T_600ms	2
54 #define ADP8870_FADE_T_900ms	3
55 #define ADP8870_FADE_T_1200ms	4
56 #define ADP8870_FADE_T_1500ms	5
57 #define ADP8870_FADE_T_1800ms	6
58 #define ADP8870_FADE_T_2100ms	7
59 #define ADP8870_FADE_T_2400ms	8
60 #define ADP8870_FADE_T_2700ms	9
61 #define ADP8870_FADE_T_3000ms	10
62 #define ADP8870_FADE_T_3500ms	11
63 #define ADP8870_FADE_T_4000ms	12
64 #define ADP8870_FADE_T_4500ms	13
65 #define ADP8870_FADE_T_5000ms	14
66 #define ADP8870_FADE_T_5500ms	15	/* 5.5 Sec */
67 
68 #define ADP8870_FADE_LAW_LINEAR	0
69 #define ADP8870_FADE_LAW_SQUARE	1
70 #define ADP8870_FADE_LAW_CUBIC1	2
71 #define ADP8870_FADE_LAW_CUBIC2	3
72 
73 #define ADP8870_BL_AMBL_FILT_80ms	0	/* Light sensor filter time */
74 #define ADP8870_BL_AMBL_FILT_160ms	1
75 #define ADP8870_BL_AMBL_FILT_320ms	2
76 #define ADP8870_BL_AMBL_FILT_640ms	3
77 #define ADP8870_BL_AMBL_FILT_1280ms	4
78 #define ADP8870_BL_AMBL_FILT_2560ms	5
79 #define ADP8870_BL_AMBL_FILT_5120ms	6
80 #define ADP8870_BL_AMBL_FILT_10240ms	7	/* 10.24 sec */
81 
82 /*
83  * Blacklight current 0..30mA
84  */
85 #define ADP8870_BL_CUR_mA(I)		((I * 127) / 30)
86 
87 /*
88  * L2 comparator current 0..1106uA
89  */
90 #define ADP8870_L2_COMP_CURR_uA(I)	((I * 255) / 1106)
91 
92 /*
93  * L3 comparator current 0..551uA
94  */
95 #define ADP8870_L3_COMP_CURR_uA(I)	((I * 255) / 551)
96 
97 /*
98  * L4 comparator current 0..275uA
99  */
100 #define ADP8870_L4_COMP_CURR_uA(I)	((I * 255) / 275)
101 
102 /*
103  * L5 comparator current 0..138uA
104  */
105 #define ADP8870_L5_COMP_CURR_uA(I)	((I * 255) / 138)
106 
107 struct adp8870_backlight_platform_data {
108 	u8 bl_led_assign;	/* 1 = Backlight 0 = Individual LED */
109 	u8 pwm_assign;		/* 1 = Enables PWM mode */
110 
111 	u8 bl_fade_in;		/* Backlight Fade-In Timer */
112 	u8 bl_fade_out;		/* Backlight Fade-Out Timer */
113 	u8 bl_fade_law;		/* fade-on/fade-off transfer characteristic */
114 
115 	u8 en_ambl_sens;	/* 1 = enable ambient light sensor */
116 	u8 abml_filt;		/* Light sensor filter time */
117 
118 	u8 l1_daylight_max;	/* use BL_CUR_mA(I) 0 <= I <= 30 mA */
119 	u8 l1_daylight_dim;	/* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
120 	u8 l2_bright_max;	/* use BL_CUR_mA(I) 0 <= I <= 30 mA */
121 	u8 l2_bright_dim;	/* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
122 	u8 l3_office_max;	/* use BL_CUR_mA(I) 0 <= I <= 30 mA */
123 	u8 l3_office_dim;	/* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
124 	u8 l4_indoor_max;	/* use BL_CUR_mA(I) 0 <= I <= 30 mA */
125 	u8 l4_indor_dim;	/* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
126 	u8 l5_dark_max;		/* use BL_CUR_mA(I) 0 <= I <= 30 mA */
127 	u8 l5_dark_dim;		/* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
128 
129 	u8 l2_trip;		/* use L2_COMP_CURR_uA(I) 0 <= I <= 1106 uA */
130 	u8 l2_hyst;		/* use L2_COMP_CURR_uA(I) 0 <= I <= 1106 uA */
131 	u8 l3_trip;		/* use L3_COMP_CURR_uA(I) 0 <= I <= 551 uA */
132 	u8 l3_hyst;		/* use L3_COMP_CURR_uA(I) 0 <= I <= 551 uA */
133 	u8 l4_trip;		/* use L4_COMP_CURR_uA(I) 0 <= I <= 275 uA */
134 	u8 l4_hyst;		/* use L4_COMP_CURR_uA(I) 0 <= I <= 275 uA */
135 	u8 l5_trip;		/* use L5_COMP_CURR_uA(I) 0 <= I <= 138 uA */
136 	u8 l5_hyst;		/* use L6_COMP_CURR_uA(I) 0 <= I <= 138 uA */
137 
138 	/**
139 	 * Independent Current Sinks / LEDS
140 	 * Sinks not assigned to the Backlight can be exposed to
141 	 * user space using the LEDS CLASS interface
142 	 */
143 
144 	int num_leds;
145 	struct led_info	*leds;
146 	u8 led_fade_in;		/* LED Fade-In Timer */
147 	u8 led_fade_out;	/* LED Fade-Out Timer */
148 	u8 led_fade_law;	/* fade-on/fade-off transfer characteristic */
149 	u8 led_on_time;
150 };
151 
152 #endif /* __LINUX_I2C_ADP8870_H */
153