1*2b27bdccSThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-only */
2610387d1SWolfram Sang /*
3610387d1SWolfram Sang  * This file is part of the APDS990x sensor driver.
4610387d1SWolfram Sang  * Chip is combined proximity and ambient light sensor.
5610387d1SWolfram Sang  *
6610387d1SWolfram Sang  * Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
7610387d1SWolfram Sang  *
8610387d1SWolfram Sang  * Contact: Samu Onkalo <[email protected]>
9610387d1SWolfram Sang  */
10610387d1SWolfram Sang 
11610387d1SWolfram Sang #ifndef __APDS990X_H__
12610387d1SWolfram Sang #define __APDS990X_H__
13610387d1SWolfram Sang 
14610387d1SWolfram Sang 
15610387d1SWolfram Sang #define APDS_IRLED_CURR_12mA	0x3
16610387d1SWolfram Sang #define APDS_IRLED_CURR_25mA	0x2
17610387d1SWolfram Sang #define APDS_IRLED_CURR_50mA	0x1
18610387d1SWolfram Sang #define APDS_IRLED_CURR_100mA	0x0
19610387d1SWolfram Sang 
20610387d1SWolfram Sang /**
21610387d1SWolfram Sang  * struct apds990x_chip_factors - defines effect of the cover window
22610387d1SWolfram Sang  * @ga: Total glass attenuation
23610387d1SWolfram Sang  * @cf1: clear channel factor 1 for raw to lux conversion
24610387d1SWolfram Sang  * @irf1: IR channel factor 1 for raw to lux conversion
25610387d1SWolfram Sang  * @cf2: clear channel factor 2 for raw to lux conversion
26610387d1SWolfram Sang  * @irf2: IR channel factor 2 for raw to lux conversion
27610387d1SWolfram Sang  * @df: device factor for conversion formulas
28610387d1SWolfram Sang  *
29610387d1SWolfram Sang  * Structure for tuning ALS calculation to match with environment.
30610387d1SWolfram Sang  * Values depend on the material above the sensor and the sensor
31610387d1SWolfram Sang  * itself. If the GA is zero, driver will use uncovered sensor default values
32610387d1SWolfram Sang  * format: decimal value * APDS_PARAM_SCALE except df which is plain integer.
33610387d1SWolfram Sang  */
34610387d1SWolfram Sang #define APDS_PARAM_SCALE 4096
35610387d1SWolfram Sang struct apds990x_chip_factors {
36610387d1SWolfram Sang 	int ga;
37610387d1SWolfram Sang 	int cf1;
38610387d1SWolfram Sang 	int irf1;
39610387d1SWolfram Sang 	int cf2;
40610387d1SWolfram Sang 	int irf2;
41610387d1SWolfram Sang 	int df;
42610387d1SWolfram Sang };
43610387d1SWolfram Sang 
44610387d1SWolfram Sang /**
45610387d1SWolfram Sang  * struct apds990x_platform_data - platform data for apsd990x.c driver
46610387d1SWolfram Sang  * @cf: chip factor data
47610387d1SWolfram Sang  * @pddrive: IR-led driving current
48610387d1SWolfram Sang  * @ppcount: number of IR pulses used for proximity estimation
49610387d1SWolfram Sang  * @setup_resources: interrupt line setup call back function
50610387d1SWolfram Sang  * @release_resources: interrupt line release call back function
51610387d1SWolfram Sang  *
52610387d1SWolfram Sang  * Proximity detection result depends heavily on correct ppcount, pdrive
53610387d1SWolfram Sang  * and cover window.
54610387d1SWolfram Sang  *
55610387d1SWolfram Sang  */
56610387d1SWolfram Sang 
57610387d1SWolfram Sang struct apds990x_platform_data {
58610387d1SWolfram Sang 	struct apds990x_chip_factors cf;
59610387d1SWolfram Sang 	u8     pdrive;
60610387d1SWolfram Sang 	u8     ppcount;
61610387d1SWolfram Sang 	int    (*setup_resources)(void);
62610387d1SWolfram Sang 	int    (*release_resources)(void);
63610387d1SWolfram Sang };
64610387d1SWolfram Sang 
65610387d1SWolfram Sang #endif
66