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
107struct 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