1 /* SPDX-License-Identifier: GPL-2.0+ */ 2 /* 3 * Device driver for monitoring ambient light intensity (lux) 4 * and proximity (prox) within the TAOS TSL2772 family of devices. 5 * 6 * Copyright (c) 2012, TAOS Corporation. 7 * Copyright (c) 2017-2018 Brian Masney <masneyb@onstation.org> 8 */ 9 10 #ifndef __TSL2772_H 11 #define __TSL2772_H 12 13 struct tsl2772_lux { 14 unsigned int ch0; 15 unsigned int ch1; 16 }; 17 18 /* Max number of segments allowable in LUX table */ 19 #define TSL2772_MAX_LUX_TABLE_SIZE 6 20 /* The default LUX tables all have 3 elements. */ 21 #define TSL2772_DEF_LUX_TABLE_SZ 3 22 #define TSL2772_DEFAULT_TABLE_BYTES (sizeof(struct tsl2772_lux) * \ 23 TSL2772_DEF_LUX_TABLE_SZ) 24 25 /* Proximity diode to use */ 26 #define TSL2772_DIODE0 0x01 27 #define TSL2772_DIODE1 0x02 28 #define TSL2772_DIODE_BOTH 0x03 29 30 /* LED Power */ 31 #define TSL2772_100_mA 0x00 32 #define TSL2772_50_mA 0x01 33 #define TSL2772_25_mA 0x02 34 #define TSL2772_13_mA 0x03 35 36 /** 37 * struct tsl2772_settings - Settings for the tsl2772 driver 38 * @als_time: Integration time of the ALS channel ADCs in 2.73 ms 39 * increments. Total integration time is 40 * (256 - als_time) * 2.73. 41 * @als_gain: Index into the tsl2772_als_gain array. 42 * @als_gain_trim: Default gain trim to account for aperture effects. 43 * @wait_time: Time between proximity and ALS cycles in 2.73 44 * periods. 45 * @prox_time: Integration time of the proximity ADC in 2.73 ms 46 * increments. Total integration time is 47 * (256 - prx_time) * 2.73. 48 * @prox_gain: Index into the tsl2772_prx_gain array. 49 * @als_prox_config: The value of the ALS / Proximity configuration 50 * register. 51 * @als_cal_target: Known external ALS reading for calibration. 52 * @als_persistence: H/W Filters, Number of 'out of limits' ALS readings. 53 * @als_interrupt_en: Enable/Disable ALS interrupts 54 * @als_thresh_low: CH0 'low' count to trigger interrupt. 55 * @als_thresh_high: CH0 'high' count to trigger interrupt. 56 * @prox_persistence: H/W Filters, Number of 'out of limits' proximity 57 * readings. 58 * @prox_interrupt_en: Enable/Disable proximity interrupts. 59 * @prox_thres_low: Low threshold proximity detection. 60 * @prox_thres_high: High threshold proximity detection. 61 * @prox_pulse_count: Number if proximity emitter pulses. 62 * @prox_max_samples_cal: The number of samples that are taken when performing 63 * a proximity calibration. 64 * @prox_diode Which diode(s) to use for driving the external 65 * LED(s) for proximity sensing. 66 * @prox_power The amount of power to use for the external LED(s). 67 */ 68 struct tsl2772_settings { 69 int als_time; 70 int als_gain; 71 int als_gain_trim; 72 int wait_time; 73 int prox_time; 74 int prox_gain; 75 int als_prox_config; 76 int als_cal_target; 77 u8 als_persistence; 78 bool als_interrupt_en; 79 int als_thresh_low; 80 int als_thresh_high; 81 u8 prox_persistence; 82 bool prox_interrupt_en; 83 int prox_thres_low; 84 int prox_thres_high; 85 int prox_pulse_count; 86 int prox_max_samples_cal; 87 int prox_diode; 88 int prox_power; 89 }; 90 91 /** 92 * struct tsl2772_platform_data - Platform callback, glass and defaults 93 * @platform_lux_table: Device specific glass coefficents 94 * @platform_default_settings: Device specific power on defaults 95 */ 96 struct tsl2772_platform_data { 97 struct tsl2772_lux platform_lux_table[TSL2772_MAX_LUX_TABLE_SIZE]; 98 struct tsl2772_settings *platform_default_settings; 99 }; 100 101 #endif /* __TSL2772_H */ 102