1 // SPDX-License-Identifier: GPL-2.0-only
3 * vcnl4000.c - Support for Vishay VCNL4000/4010/4020/4040/4200 combined ambient
4 * light and proximity sensor
6 * Copyright 2012 Peter Meerwald <pmeerw@pmeerw.net>
7 * Copyright 2019 Pursim SPC
10 * VCNL4000/10/20 (7-bit I2C slave address 0x13)
11 * VCNL4040 (7-bit I2C slave address 0x60)
12 * VCNL4200 (7-bit I2C slave address 0x51)
15 * allow to adjust IR current
16 * proximity threshold and event handling
17 * periodic ALS/proximity measurement (VCNL4010/20)
18 * interrupts (VCNL4010/20/40, VCNL4200)
21 #include <linux/module.h>
22 #include <linux/i2c.h>
23 #include <linux/err.h>
24 #include <linux/delay.h>
26 #include <linux/iio/iio.h>
27 #include <linux/iio/sysfs.h>
29 #define VCNL4000_DRV_NAME "vcnl4000"
30 #define VCNL4000_PROD_ID 0x01
31 #define VCNL4010_PROD_ID 0x02 /* for VCNL4020, VCNL4010 */
32 #define VCNL4040_PROD_ID 0x86
33 #define VCNL4200_PROD_ID 0x58
35 #define VCNL4000_COMMAND 0x80 /* Command register */
36 #define VCNL4000_PROD_REV 0x81 /* Product ID and Revision ID */
37 #define VCNL4000_LED_CURRENT 0x83 /* IR LED current for proximity mode */
38 #define VCNL4000_AL_PARAM 0x84 /* Ambient light parameter register */
39 #define VCNL4000_AL_RESULT_HI 0x85 /* Ambient light result register, MSB */
40 #define VCNL4000_AL_RESULT_LO 0x86 /* Ambient light result register, LSB */
41 #define VCNL4000_PS_RESULT_HI 0x87 /* Proximity result register, MSB */
42 #define VCNL4000_PS_RESULT_LO 0x88 /* Proximity result register, LSB */
43 #define VCNL4000_PS_MEAS_FREQ 0x89 /* Proximity test signal frequency */
44 #define VCNL4000_PS_MOD_ADJ 0x8a /* Proximity modulator timing adjustment */
46 #define VCNL4200_AL_CONF 0x00 /* Ambient light configuration */
47 #define VCNL4200_PS_CONF1 0x03 /* Proximity configuration */
48 #define VCNL4200_PS_DATA 0x08 /* Proximity data */
49 #define VCNL4200_AL_DATA 0x09 /* Ambient light data */
50 #define VCNL4200_DEV_ID 0x0e /* Device ID, slave address and version */
52 #define VCNL4040_DEV_ID 0x0c /* Device ID and version */
54 /* Bit masks for COMMAND register */
55 #define VCNL4000_AL_RDY BIT(6) /* ALS data ready? */
56 #define VCNL4000_PS_RDY BIT(5) /* proximity data ready? */
57 #define VCNL4000_AL_OD BIT(4) /* start on-demand ALS measurement */
58 #define VCNL4000_PS_OD BIT(3) /* start on-demand proximity measurement */
60 enum vcnl4000_device_ids {
67 struct vcnl4200_channel {
69 ktime_t last_measurement;
70 ktime_t sampling_rate;
74 struct vcnl4000_data {
75 struct i2c_client *client;
76 enum vcnl4000_device_ids id;
79 const struct vcnl4000_chip_spec *chip_spec;
80 struct mutex vcnl4000_lock;
81 struct vcnl4200_channel vcnl4200_al;
82 struct vcnl4200_channel vcnl4200_ps;
85 struct vcnl4000_chip_spec {
87 int (*init)(struct vcnl4000_data *data);
88 int (*measure_light)(struct vcnl4000_data *data, int *val);
89 int (*measure_proximity)(struct vcnl4000_data *data, int *val);
92 static const struct i2c_device_id vcnl4000_id[] = {
93 { "vcnl4000", VCNL4000 },
94 { "vcnl4010", VCNL4010 },
95 { "vcnl4020", VCNL4010 },
96 { "vcnl4040", VCNL4040 },
97 { "vcnl4200", VCNL4200 },
100 MODULE_DEVICE_TABLE(i2c, vcnl4000_id);
102 static int vcnl4000_init(struct vcnl4000_data *data)
106 ret = i2c_smbus_read_byte_data(data->client, VCNL4000_PROD_REV);
112 case VCNL4000_PROD_ID:
113 if (data->id != VCNL4000)
114 dev_warn(&data->client->dev,
115 "wrong device id, use vcnl4000");
117 case VCNL4010_PROD_ID:
118 if (data->id != VCNL4010)
119 dev_warn(&data->client->dev,
120 "wrong device id, use vcnl4010/4020");
126 data->rev = ret & 0xf;
127 data->al_scale = 250000;
128 mutex_init(&data->vcnl4000_lock);
133 static int vcnl4200_init(struct vcnl4000_data *data)
137 ret = i2c_smbus_read_word_data(data->client, VCNL4200_DEV_ID);
143 if (id != VCNL4200_PROD_ID) {
144 ret = i2c_smbus_read_word_data(data->client, VCNL4040_DEV_ID);
150 if (id != VCNL4040_PROD_ID)
154 dev_dbg(&data->client->dev, "device id 0x%x", id);
156 data->rev = (ret >> 8) & 0xf;
158 /* Set defaults and enable both channels */
159 ret = i2c_smbus_write_word_data(data->client, VCNL4200_AL_CONF, 0);
162 ret = i2c_smbus_write_word_data(data->client, VCNL4200_PS_CONF1, 0);
166 data->al_scale = 24000;
167 data->vcnl4200_al.reg = VCNL4200_AL_DATA;
168 data->vcnl4200_ps.reg = VCNL4200_PS_DATA;
170 case VCNL4200_PROD_ID:
171 /* Integration time is 50ms, but the experiments */
172 /* show 54ms in total. */
173 data->vcnl4200_al.sampling_rate = ktime_set(0, 54000 * 1000);
174 data->vcnl4200_ps.sampling_rate = ktime_set(0, 4200 * 1000);
176 case VCNL4040_PROD_ID:
177 /* Integration time is 80ms, add 10ms. */
178 data->vcnl4200_al.sampling_rate = ktime_set(0, 100000 * 1000);
179 data->vcnl4200_ps.sampling_rate = ktime_set(0, 100000 * 1000);
182 data->vcnl4200_al.last_measurement = ktime_set(0, 0);
183 data->vcnl4200_ps.last_measurement = ktime_set(0, 0);
184 mutex_init(&data->vcnl4200_al.lock);
185 mutex_init(&data->vcnl4200_ps.lock);
190 static int vcnl4000_measure(struct vcnl4000_data *data, u8 req_mask,
191 u8 rdy_mask, u8 data_reg, int *val)
197 mutex_lock(&data->vcnl4000_lock);
199 ret = i2c_smbus_write_byte_data(data->client, VCNL4000_COMMAND,
204 /* wait for data to become ready */
206 ret = i2c_smbus_read_byte_data(data->client, VCNL4000_COMMAND);
211 msleep(20); /* measurement takes up to 100 ms */
215 dev_err(&data->client->dev,
216 "vcnl4000_measure() failed, data not ready\n");
221 ret = i2c_smbus_read_i2c_block_data(data->client,
222 data_reg, sizeof(buf), (u8 *) &buf);
226 mutex_unlock(&data->vcnl4000_lock);
227 *val = be16_to_cpu(buf);
232 mutex_unlock(&data->vcnl4000_lock);
236 static int vcnl4200_measure(struct vcnl4000_data *data,
237 struct vcnl4200_channel *chan, int *val)
241 ktime_t next_measurement;
243 mutex_lock(&chan->lock);
245 next_measurement = ktime_add(chan->last_measurement,
246 chan->sampling_rate);
247 delta = ktime_us_delta(next_measurement, ktime_get());
249 usleep_range(delta, delta + 500);
250 chan->last_measurement = ktime_get();
252 mutex_unlock(&chan->lock);
254 ret = i2c_smbus_read_word_data(data->client, chan->reg);
263 static int vcnl4000_measure_light(struct vcnl4000_data *data, int *val)
265 return vcnl4000_measure(data,
266 VCNL4000_AL_OD, VCNL4000_AL_RDY,
267 VCNL4000_AL_RESULT_HI, val);
270 static int vcnl4200_measure_light(struct vcnl4000_data *data, int *val)
272 return vcnl4200_measure(data, &data->vcnl4200_al, val);
275 static int vcnl4000_measure_proximity(struct vcnl4000_data *data, int *val)
277 return vcnl4000_measure(data,
278 VCNL4000_PS_OD, VCNL4000_PS_RDY,
279 VCNL4000_PS_RESULT_HI, val);
282 static int vcnl4200_measure_proximity(struct vcnl4000_data *data, int *val)
284 return vcnl4200_measure(data, &data->vcnl4200_ps, val);
287 static const struct vcnl4000_chip_spec vcnl4000_chip_spec_cfg[] = {
290 .init = vcnl4000_init,
291 .measure_light = vcnl4000_measure_light,
292 .measure_proximity = vcnl4000_measure_proximity,
295 .prod = "VCNL4010/4020",
296 .init = vcnl4000_init,
297 .measure_light = vcnl4000_measure_light,
298 .measure_proximity = vcnl4000_measure_proximity,
302 .init = vcnl4200_init,
303 .measure_light = vcnl4200_measure_light,
304 .measure_proximity = vcnl4200_measure_proximity,
308 .init = vcnl4200_init,
309 .measure_light = vcnl4200_measure_light,
310 .measure_proximity = vcnl4200_measure_proximity,
314 static const struct iio_chan_spec vcnl4000_channels[] = {
317 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
318 BIT(IIO_CHAN_INFO_SCALE),
320 .type = IIO_PROXIMITY,
321 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
325 static int vcnl4000_read_raw(struct iio_dev *indio_dev,
326 struct iio_chan_spec const *chan,
327 int *val, int *val2, long mask)
330 struct vcnl4000_data *data = iio_priv(indio_dev);
333 case IIO_CHAN_INFO_RAW:
334 switch (chan->type) {
336 ret = data->chip_spec->measure_light(data, val);
341 ret = data->chip_spec->measure_proximity(data, val);
348 case IIO_CHAN_INFO_SCALE:
349 if (chan->type != IIO_LIGHT)
353 *val2 = data->al_scale;
354 return IIO_VAL_INT_PLUS_MICRO;
360 static const struct iio_info vcnl4000_info = {
361 .read_raw = vcnl4000_read_raw,
364 static int vcnl4000_probe(struct i2c_client *client,
365 const struct i2c_device_id *id)
367 struct vcnl4000_data *data;
368 struct iio_dev *indio_dev;
371 indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
375 data = iio_priv(indio_dev);
376 i2c_set_clientdata(client, indio_dev);
377 data->client = client;
378 data->id = id->driver_data;
379 data->chip_spec = &vcnl4000_chip_spec_cfg[data->id];
381 ret = data->chip_spec->init(data);
385 dev_dbg(&client->dev, "%s Ambient light/proximity sensor, Rev: %02x\n",
386 data->chip_spec->prod, data->rev);
388 indio_dev->dev.parent = &client->dev;
389 indio_dev->info = &vcnl4000_info;
390 indio_dev->channels = vcnl4000_channels;
391 indio_dev->num_channels = ARRAY_SIZE(vcnl4000_channels);
392 indio_dev->name = VCNL4000_DRV_NAME;
393 indio_dev->modes = INDIO_DIRECT_MODE;
395 return devm_iio_device_register(&client->dev, indio_dev);
398 static const struct of_device_id vcnl_4000_of_match[] = {
400 .compatible = "vishay,vcnl4000",
404 .compatible = "vishay,vcnl4010",
408 .compatible = "vishay,vcnl4010",
412 .compatible = "vishay,vcnl4200",
417 MODULE_DEVICE_TABLE(of, vcnl_4000_of_match);
419 static struct i2c_driver vcnl4000_driver = {
421 .name = VCNL4000_DRV_NAME,
422 .of_match_table = vcnl_4000_of_match,
424 .probe = vcnl4000_probe,
425 .id_table = vcnl4000_id,
428 module_i2c_driver(vcnl4000_driver);
430 MODULE_AUTHOR("Peter Meerwald <pmeerw@pmeerw.net>");
431 MODULE_DESCRIPTION("Vishay VCNL4000 proximity/ambient light sensor driver");
432 MODULE_LICENSE("GPL");