adp8870.h

  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 */