Loading...
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * MAX44000 Ambient and Infrared Proximity Sensor
4 *
5 * Copyright (c) 2016, Intel Corporation.
6 *
7 * Data sheet: https://datasheets.maximintegrated.com/en/ds/MAX44000.pdf
8 *
9 * 7-bit I2C slave address 0x4a
10 */
11
12#include <linux/module.h>
13#include <linux/mod_devicetable.h>
14#include <linux/init.h>
15#include <linux/i2c.h>
16#include <linux/regmap.h>
17#include <linux/util_macros.h>
18#include <linux/iio/iio.h>
19#include <linux/iio/sysfs.h>
20#include <linux/iio/buffer.h>
21#include <linux/iio/trigger_consumer.h>
22#include <linux/iio/triggered_buffer.h>
23
24#define MAX44000_DRV_NAME "max44000"
25
26/* Registers in datasheet order */
27#define MAX44000_REG_STATUS 0x00
28#define MAX44000_REG_CFG_MAIN 0x01
29#define MAX44000_REG_CFG_RX 0x02
30#define MAX44000_REG_CFG_TX 0x03
31#define MAX44000_REG_ALS_DATA_HI 0x04
32#define MAX44000_REG_ALS_DATA_LO 0x05
33#define MAX44000_REG_PRX_DATA 0x16
34#define MAX44000_REG_ALS_UPTHR_HI 0x06
35#define MAX44000_REG_ALS_UPTHR_LO 0x07
36#define MAX44000_REG_ALS_LOTHR_HI 0x08
37#define MAX44000_REG_ALS_LOTHR_LO 0x09
38#define MAX44000_REG_PST 0x0a
39#define MAX44000_REG_PRX_IND 0x0b
40#define MAX44000_REG_PRX_THR 0x0c
41#define MAX44000_REG_TRIM_GAIN_GREEN 0x0f
42#define MAX44000_REG_TRIM_GAIN_IR 0x10
43
44/* REG_CFG bits */
45#define MAX44000_CFG_ALSINTE 0x01
46#define MAX44000_CFG_PRXINTE 0x02
47#define MAX44000_CFG_MASK 0x1c
48#define MAX44000_CFG_MODE_SHUTDOWN 0x00
49#define MAX44000_CFG_MODE_ALS_GIR 0x04
50#define MAX44000_CFG_MODE_ALS_G 0x08
51#define MAX44000_CFG_MODE_ALS_IR 0x0c
52#define MAX44000_CFG_MODE_ALS_PRX 0x10
53#define MAX44000_CFG_MODE_PRX 0x14
54#define MAX44000_CFG_TRIM 0x20
55
56/*
57 * Upper 4 bits are not documented but start as 1 on powerup
58 * Setting them to 0 causes proximity to misbehave so set them to 1
59 */
60#define MAX44000_REG_CFG_RX_DEFAULT 0xf0
61
62/* REG_RX bits */
63#define MAX44000_CFG_RX_ALSTIM_MASK 0x0c
64#define MAX44000_CFG_RX_ALSTIM_SHIFT 2
65#define MAX44000_CFG_RX_ALSPGA_MASK 0x03
66#define MAX44000_CFG_RX_ALSPGA_SHIFT 0
67
68/* REG_TX bits */
69#define MAX44000_LED_CURRENT_MASK 0xf
70#define MAX44000_LED_CURRENT_MAX 11
71#define MAX44000_LED_CURRENT_DEFAULT 6
72
73#define MAX44000_ALSDATA_OVERFLOW 0x4000
74
75struct max44000_data {
76 struct mutex lock;
77 struct regmap *regmap;
78 /* Ensure naturally aligned timestamp */
79 struct {
80 u16 channels[2];
81 s64 ts __aligned(8);
82 } scan;
83};
84
85/* Default scale is set to the minimum of 0.03125 or 1 / (1 << 5) lux */
86#define MAX44000_ALS_TO_LUX_DEFAULT_FRACTION_LOG2 5
87
88/* Scale can be multiplied by up to 128x via ALSPGA for measurement gain */
89static const int max44000_alspga_shift[] = {0, 2, 4, 7};
90#define MAX44000_ALSPGA_MAX_SHIFT 7
91
92/*
93 * Scale can be multiplied by up to 64x via ALSTIM because of lost resolution
94 *
95 * This scaling factor is hidden from userspace and instead accounted for when
96 * reading raw values from the device.
97 *
98 * This makes it possible to cleanly expose ALSPGA as IIO_CHAN_INFO_SCALE and
99 * ALSTIM as IIO_CHAN_INFO_INT_TIME without the values affecting each other.
100 *
101 * Handling this internally is also required for buffer support because the
102 * channel's scan_type can't be modified dynamically.
103 */
104#define MAX44000_ALSTIM_SHIFT(alstim) (2 * (alstim))
105
106/* Available integration times with pretty manual alignment: */
107static const int max44000_int_time_avail_ns_array[] = {
108 100000000,
109 25000000,
110 6250000,
111 1562500,
112};
113static const char max44000_int_time_avail_str[] =
114 "0.100 "
115 "0.025 "
116 "0.00625 "
117 "0.0015625";
118
119/* Available scales (internal to ulux) with pretty manual alignment: */
120static const int max44000_scale_avail_ulux_array[] = {
121 31250,
122 125000,
123 500000,
124 4000000,
125};
126static const char max44000_scale_avail_str[] =
127 "0.03125 "
128 "0.125 "
129 "0.5 "
130 "4";
131
132#define MAX44000_SCAN_INDEX_ALS 0
133#define MAX44000_SCAN_INDEX_PRX 1
134
135static const struct iio_chan_spec max44000_channels[] = {
136 {
137 .type = IIO_LIGHT,
138 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
139 .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE) |
140 BIT(IIO_CHAN_INFO_INT_TIME),
141 .scan_index = MAX44000_SCAN_INDEX_ALS,
142 .scan_type = {
143 .sign = 'u',
144 .realbits = 14,
145 .storagebits = 16,
146 }
147 },
148 {
149 .type = IIO_PROXIMITY,
150 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
151 .scan_index = MAX44000_SCAN_INDEX_PRX,
152 .scan_type = {
153 .sign = 'u',
154 .realbits = 8,
155 .storagebits = 16,
156 }
157 },
158 IIO_CHAN_SOFT_TIMESTAMP(2),
159 {
160 .type = IIO_CURRENT,
161 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
162 BIT(IIO_CHAN_INFO_SCALE),
163 .extend_name = "led",
164 .output = 1,
165 .scan_index = -1,
166 },
167};
168
169static int max44000_read_alstim(struct max44000_data *data)
170{
171 unsigned int val;
172 int ret;
173
174 ret = regmap_read(data->regmap, MAX44000_REG_CFG_RX, &val);
175 if (ret < 0)
176 return ret;
177 return (val & MAX44000_CFG_RX_ALSTIM_MASK) >> MAX44000_CFG_RX_ALSTIM_SHIFT;
178}
179
180static int max44000_write_alstim(struct max44000_data *data, int val)
181{
182 return regmap_write_bits(data->regmap, MAX44000_REG_CFG_RX,
183 MAX44000_CFG_RX_ALSTIM_MASK,
184 val << MAX44000_CFG_RX_ALSTIM_SHIFT);
185}
186
187static int max44000_read_alspga(struct max44000_data *data)
188{
189 unsigned int val;
190 int ret;
191
192 ret = regmap_read(data->regmap, MAX44000_REG_CFG_RX, &val);
193 if (ret < 0)
194 return ret;
195 return (val & MAX44000_CFG_RX_ALSPGA_MASK) >> MAX44000_CFG_RX_ALSPGA_SHIFT;
196}
197
198static int max44000_write_alspga(struct max44000_data *data, int val)
199{
200 return regmap_write_bits(data->regmap, MAX44000_REG_CFG_RX,
201 MAX44000_CFG_RX_ALSPGA_MASK,
202 val << MAX44000_CFG_RX_ALSPGA_SHIFT);
203}
204
205static int max44000_read_alsval(struct max44000_data *data)
206{
207 u16 regval;
208 __be16 val;
209 int alstim, ret;
210
211 ret = regmap_bulk_read(data->regmap, MAX44000_REG_ALS_DATA_HI,
212 &val, sizeof(val));
213 if (ret < 0)
214 return ret;
215 alstim = ret = max44000_read_alstim(data);
216 if (ret < 0)
217 return ret;
218
219 regval = be16_to_cpu(val);
220
221 /*
222 * Overflow is explained on datasheet page 17.
223 *
224 * It's a warning that either the G or IR channel has become saturated
225 * and that the value in the register is likely incorrect.
226 *
227 * The recommendation is to change the scale (ALSPGA).
228 * The driver just returns the max representable value.
229 */
230 if (regval & MAX44000_ALSDATA_OVERFLOW)
231 return 0x3FFF;
232
233 return regval << MAX44000_ALSTIM_SHIFT(alstim);
234}
235
236static int max44000_write_led_current_raw(struct max44000_data *data, int val)
237{
238 /* Maybe we should clamp the value instead? */
239 if (val < 0 || val > MAX44000_LED_CURRENT_MAX)
240 return -ERANGE;
241 if (val >= 8)
242 val += 4;
243 return regmap_write_bits(data->regmap, MAX44000_REG_CFG_TX,
244 MAX44000_LED_CURRENT_MASK, val);
245}
246
247static int max44000_read_led_current_raw(struct max44000_data *data)
248{
249 unsigned int regval;
250 int ret;
251
252 ret = regmap_read(data->regmap, MAX44000_REG_CFG_TX, ®val);
253 if (ret < 0)
254 return ret;
255 regval &= MAX44000_LED_CURRENT_MASK;
256 if (regval >= 8)
257 regval -= 4;
258 return regval;
259}
260
261static int max44000_read_raw(struct iio_dev *indio_dev,
262 struct iio_chan_spec const *chan,
263 int *val, int *val2, long mask)
264{
265 struct max44000_data *data = iio_priv(indio_dev);
266 int alstim, alspga;
267 unsigned int regval;
268 int ret;
269
270 switch (mask) {
271 case IIO_CHAN_INFO_RAW:
272 switch (chan->type) {
273 case IIO_LIGHT:
274 mutex_lock(&data->lock);
275 ret = max44000_read_alsval(data);
276 mutex_unlock(&data->lock);
277 if (ret < 0)
278 return ret;
279 *val = ret;
280 return IIO_VAL_INT;
281
282 case IIO_PROXIMITY:
283 mutex_lock(&data->lock);
284 ret = regmap_read(data->regmap, MAX44000_REG_PRX_DATA, ®val);
285 mutex_unlock(&data->lock);
286 if (ret < 0)
287 return ret;
288 *val = regval;
289 return IIO_VAL_INT;
290
291 case IIO_CURRENT:
292 mutex_lock(&data->lock);
293 ret = max44000_read_led_current_raw(data);
294 mutex_unlock(&data->lock);
295 if (ret < 0)
296 return ret;
297 *val = ret;
298 return IIO_VAL_INT;
299
300 default:
301 return -EINVAL;
302 }
303
304 case IIO_CHAN_INFO_SCALE:
305 switch (chan->type) {
306 case IIO_CURRENT:
307 /* Output register is in 10s of miliamps */
308 *val = 10;
309 return IIO_VAL_INT;
310
311 case IIO_LIGHT:
312 mutex_lock(&data->lock);
313 alspga = ret = max44000_read_alspga(data);
314 mutex_unlock(&data->lock);
315 if (ret < 0)
316 return ret;
317
318 /* Avoid negative shifts */
319 *val = (1 << MAX44000_ALSPGA_MAX_SHIFT);
320 *val2 = MAX44000_ALS_TO_LUX_DEFAULT_FRACTION_LOG2
321 + MAX44000_ALSPGA_MAX_SHIFT
322 - max44000_alspga_shift[alspga];
323 return IIO_VAL_FRACTIONAL_LOG2;
324
325 default:
326 return -EINVAL;
327 }
328
329 case IIO_CHAN_INFO_INT_TIME:
330 mutex_lock(&data->lock);
331 alstim = ret = max44000_read_alstim(data);
332 mutex_unlock(&data->lock);
333
334 if (ret < 0)
335 return ret;
336 *val = 0;
337 *val2 = max44000_int_time_avail_ns_array[alstim];
338 return IIO_VAL_INT_PLUS_NANO;
339
340 default:
341 return -EINVAL;
342 }
343}
344
345static int max44000_write_raw(struct iio_dev *indio_dev,
346 struct iio_chan_spec const *chan,
347 int val, int val2, long mask)
348{
349 struct max44000_data *data = iio_priv(indio_dev);
350 int ret;
351
352 if (mask == IIO_CHAN_INFO_RAW && chan->type == IIO_CURRENT) {
353 mutex_lock(&data->lock);
354 ret = max44000_write_led_current_raw(data, val);
355 mutex_unlock(&data->lock);
356 return ret;
357 } else if (mask == IIO_CHAN_INFO_INT_TIME && chan->type == IIO_LIGHT) {
358 s64 valns = val * NSEC_PER_SEC + val2;
359 int alstim = find_closest_descending(valns,
360 max44000_int_time_avail_ns_array,
361 ARRAY_SIZE(max44000_int_time_avail_ns_array));
362 mutex_lock(&data->lock);
363 ret = max44000_write_alstim(data, alstim);
364 mutex_unlock(&data->lock);
365 return ret;
366 } else if (mask == IIO_CHAN_INFO_SCALE && chan->type == IIO_LIGHT) {
367 s64 valus = val * USEC_PER_SEC + val2;
368 int alspga = find_closest(valus,
369 max44000_scale_avail_ulux_array,
370 ARRAY_SIZE(max44000_scale_avail_ulux_array));
371 mutex_lock(&data->lock);
372 ret = max44000_write_alspga(data, alspga);
373 mutex_unlock(&data->lock);
374 return ret;
375 }
376
377 return -EINVAL;
378}
379
380static int max44000_write_raw_get_fmt(struct iio_dev *indio_dev,
381 struct iio_chan_spec const *chan,
382 long mask)
383{
384 if (mask == IIO_CHAN_INFO_INT_TIME && chan->type == IIO_LIGHT)
385 return IIO_VAL_INT_PLUS_NANO;
386 else if (mask == IIO_CHAN_INFO_SCALE && chan->type == IIO_LIGHT)
387 return IIO_VAL_INT_PLUS_MICRO;
388 else
389 return IIO_VAL_INT;
390}
391
392static IIO_CONST_ATTR(illuminance_integration_time_available, max44000_int_time_avail_str);
393static IIO_CONST_ATTR(illuminance_scale_available, max44000_scale_avail_str);
394
395static struct attribute *max44000_attributes[] = {
396 &iio_const_attr_illuminance_integration_time_available.dev_attr.attr,
397 &iio_const_attr_illuminance_scale_available.dev_attr.attr,
398 NULL
399};
400
401static const struct attribute_group max44000_attribute_group = {
402 .attrs = max44000_attributes,
403};
404
405static const struct iio_info max44000_info = {
406 .read_raw = max44000_read_raw,
407 .write_raw = max44000_write_raw,
408 .write_raw_get_fmt = max44000_write_raw_get_fmt,
409 .attrs = &max44000_attribute_group,
410};
411
412static bool max44000_readable_reg(struct device *dev, unsigned int reg)
413{
414 switch (reg) {
415 case MAX44000_REG_STATUS:
416 case MAX44000_REG_CFG_MAIN:
417 case MAX44000_REG_CFG_RX:
418 case MAX44000_REG_CFG_TX:
419 case MAX44000_REG_ALS_DATA_HI:
420 case MAX44000_REG_ALS_DATA_LO:
421 case MAX44000_REG_PRX_DATA:
422 case MAX44000_REG_ALS_UPTHR_HI:
423 case MAX44000_REG_ALS_UPTHR_LO:
424 case MAX44000_REG_ALS_LOTHR_HI:
425 case MAX44000_REG_ALS_LOTHR_LO:
426 case MAX44000_REG_PST:
427 case MAX44000_REG_PRX_IND:
428 case MAX44000_REG_PRX_THR:
429 case MAX44000_REG_TRIM_GAIN_GREEN:
430 case MAX44000_REG_TRIM_GAIN_IR:
431 return true;
432 default:
433 return false;
434 }
435}
436
437static bool max44000_writeable_reg(struct device *dev, unsigned int reg)
438{
439 switch (reg) {
440 case MAX44000_REG_CFG_MAIN:
441 case MAX44000_REG_CFG_RX:
442 case MAX44000_REG_CFG_TX:
443 case MAX44000_REG_ALS_UPTHR_HI:
444 case MAX44000_REG_ALS_UPTHR_LO:
445 case MAX44000_REG_ALS_LOTHR_HI:
446 case MAX44000_REG_ALS_LOTHR_LO:
447 case MAX44000_REG_PST:
448 case MAX44000_REG_PRX_IND:
449 case MAX44000_REG_PRX_THR:
450 case MAX44000_REG_TRIM_GAIN_GREEN:
451 case MAX44000_REG_TRIM_GAIN_IR:
452 return true;
453 default:
454 return false;
455 }
456}
457
458static bool max44000_volatile_reg(struct device *dev, unsigned int reg)
459{
460 switch (reg) {
461 case MAX44000_REG_STATUS:
462 case MAX44000_REG_ALS_DATA_HI:
463 case MAX44000_REG_ALS_DATA_LO:
464 case MAX44000_REG_PRX_DATA:
465 return true;
466 default:
467 return false;
468 }
469}
470
471static bool max44000_precious_reg(struct device *dev, unsigned int reg)
472{
473 return reg == MAX44000_REG_STATUS;
474}
475
476static const struct regmap_config max44000_regmap_config = {
477 .reg_bits = 8,
478 .val_bits = 8,
479
480 .max_register = MAX44000_REG_PRX_DATA,
481 .readable_reg = max44000_readable_reg,
482 .writeable_reg = max44000_writeable_reg,
483 .volatile_reg = max44000_volatile_reg,
484 .precious_reg = max44000_precious_reg,
485
486 .use_single_read = true,
487 .use_single_write = true,
488 .cache_type = REGCACHE_RBTREE,
489};
490
491static irqreturn_t max44000_trigger_handler(int irq, void *p)
492{
493 struct iio_poll_func *pf = p;
494 struct iio_dev *indio_dev = pf->indio_dev;
495 struct max44000_data *data = iio_priv(indio_dev);
496 int index = 0;
497 unsigned int regval;
498 int ret;
499
500 mutex_lock(&data->lock);
501 if (test_bit(MAX44000_SCAN_INDEX_ALS, indio_dev->active_scan_mask)) {
502 ret = max44000_read_alsval(data);
503 if (ret < 0)
504 goto out_unlock;
505 data->scan.channels[index++] = ret;
506 }
507 if (test_bit(MAX44000_SCAN_INDEX_PRX, indio_dev->active_scan_mask)) {
508 ret = regmap_read(data->regmap, MAX44000_REG_PRX_DATA, ®val);
509 if (ret < 0)
510 goto out_unlock;
511 data->scan.channels[index] = regval;
512 }
513 mutex_unlock(&data->lock);
514
515 iio_push_to_buffers_with_timestamp(indio_dev, &data->scan,
516 iio_get_time_ns(indio_dev));
517 iio_trigger_notify_done(indio_dev->trig);
518 return IRQ_HANDLED;
519
520out_unlock:
521 mutex_unlock(&data->lock);
522 iio_trigger_notify_done(indio_dev->trig);
523 return IRQ_HANDLED;
524}
525
526static int max44000_probe(struct i2c_client *client)
527{
528 struct max44000_data *data;
529 struct iio_dev *indio_dev;
530 int ret, reg;
531
532 indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
533 if (!indio_dev)
534 return -ENOMEM;
535 data = iio_priv(indio_dev);
536 data->regmap = devm_regmap_init_i2c(client, &max44000_regmap_config);
537 if (IS_ERR(data->regmap)) {
538 dev_err(&client->dev, "regmap_init failed!\n");
539 return PTR_ERR(data->regmap);
540 }
541
542 mutex_init(&data->lock);
543 indio_dev->info = &max44000_info;
544 indio_dev->name = MAX44000_DRV_NAME;
545 indio_dev->channels = max44000_channels;
546 indio_dev->num_channels = ARRAY_SIZE(max44000_channels);
547
548 /*
549 * The device doesn't have a reset function so we just clear some
550 * important bits at probe time to ensure sane operation.
551 *
552 * Since we don't support interrupts/events the threshold values are
553 * not important. We also don't touch trim values.
554 */
555
556 /* Reset ALS scaling bits */
557 ret = regmap_write(data->regmap, MAX44000_REG_CFG_RX,
558 MAX44000_REG_CFG_RX_DEFAULT);
559 if (ret < 0) {
560 dev_err(&client->dev, "failed to write default CFG_RX: %d\n",
561 ret);
562 return ret;
563 }
564
565 /*
566 * By default the LED pulse used for the proximity sensor is disabled.
567 * Set a middle value so that we get some sort of valid data by default.
568 */
569 ret = max44000_write_led_current_raw(data, MAX44000_LED_CURRENT_DEFAULT);
570 if (ret < 0) {
571 dev_err(&client->dev, "failed to write init config: %d\n", ret);
572 return ret;
573 }
574
575 /* Reset CFG bits to ALS_PRX mode which allows easy reading of both values. */
576 reg = MAX44000_CFG_TRIM | MAX44000_CFG_MODE_ALS_PRX;
577 ret = regmap_write(data->regmap, MAX44000_REG_CFG_MAIN, reg);
578 if (ret < 0) {
579 dev_err(&client->dev, "failed to write init config: %d\n", ret);
580 return ret;
581 }
582
583 /* Read status at least once to clear any stale interrupt bits. */
584 ret = regmap_read(data->regmap, MAX44000_REG_STATUS, ®);
585 if (ret < 0) {
586 dev_err(&client->dev, "failed to read init status: %d\n", ret);
587 return ret;
588 }
589
590 ret = devm_iio_triggered_buffer_setup(&client->dev, indio_dev, NULL,
591 max44000_trigger_handler, NULL);
592 if (ret < 0) {
593 dev_err(&client->dev, "iio triggered buffer setup failed\n");
594 return ret;
595 }
596
597 return devm_iio_device_register(&client->dev, indio_dev);
598}
599
600static const struct i2c_device_id max44000_id[] = {
601 { "max44000" },
602 { }
603};
604MODULE_DEVICE_TABLE(i2c, max44000_id);
605
606static const struct acpi_device_id max44000_acpi_match[] = {
607 {"MAX44000", 0},
608 { }
609};
610MODULE_DEVICE_TABLE(acpi, max44000_acpi_match);
611
612static struct i2c_driver max44000_driver = {
613 .driver = {
614 .name = MAX44000_DRV_NAME,
615 .acpi_match_table = max44000_acpi_match,
616 },
617 .probe = max44000_probe,
618 .id_table = max44000_id,
619};
620
621module_i2c_driver(max44000_driver);
622
623MODULE_AUTHOR("Crestez Dan Leonard <leonard.crestez@intel.com>");
624MODULE_DESCRIPTION("MAX44000 Ambient and Infrared Proximity Sensor");
625MODULE_LICENSE("GPL v2");
1/*
2 * MAX44000 Ambient and Infrared Proximity Sensor
3 *
4 * Copyright (c) 2016, Intel Corporation.
5 *
6 * This file is subject to the terms and conditions of version 2 of
7 * the GNU General Public License. See the file COPYING in the main
8 * directory of this archive for more details.
9 *
10 * Data sheet: https://datasheets.maximintegrated.com/en/ds/MAX44000.pdf
11 *
12 * 7-bit I2C slave address 0x4a
13 */
14
15#include <linux/module.h>
16#include <linux/init.h>
17#include <linux/i2c.h>
18#include <linux/regmap.h>
19#include <linux/util_macros.h>
20#include <linux/iio/iio.h>
21#include <linux/iio/sysfs.h>
22#include <linux/iio/buffer.h>
23#include <linux/iio/trigger_consumer.h>
24#include <linux/iio/triggered_buffer.h>
25#include <linux/acpi.h>
26
27#define MAX44000_DRV_NAME "max44000"
28
29/* Registers in datasheet order */
30#define MAX44000_REG_STATUS 0x00
31#define MAX44000_REG_CFG_MAIN 0x01
32#define MAX44000_REG_CFG_RX 0x02
33#define MAX44000_REG_CFG_TX 0x03
34#define MAX44000_REG_ALS_DATA_HI 0x04
35#define MAX44000_REG_ALS_DATA_LO 0x05
36#define MAX44000_REG_PRX_DATA 0x16
37#define MAX44000_REG_ALS_UPTHR_HI 0x06
38#define MAX44000_REG_ALS_UPTHR_LO 0x07
39#define MAX44000_REG_ALS_LOTHR_HI 0x08
40#define MAX44000_REG_ALS_LOTHR_LO 0x09
41#define MAX44000_REG_PST 0x0a
42#define MAX44000_REG_PRX_IND 0x0b
43#define MAX44000_REG_PRX_THR 0x0c
44#define MAX44000_REG_TRIM_GAIN_GREEN 0x0f
45#define MAX44000_REG_TRIM_GAIN_IR 0x10
46
47/* REG_CFG bits */
48#define MAX44000_CFG_ALSINTE 0x01
49#define MAX44000_CFG_PRXINTE 0x02
50#define MAX44000_CFG_MASK 0x1c
51#define MAX44000_CFG_MODE_SHUTDOWN 0x00
52#define MAX44000_CFG_MODE_ALS_GIR 0x04
53#define MAX44000_CFG_MODE_ALS_G 0x08
54#define MAX44000_CFG_MODE_ALS_IR 0x0c
55#define MAX44000_CFG_MODE_ALS_PRX 0x10
56#define MAX44000_CFG_MODE_PRX 0x14
57#define MAX44000_CFG_TRIM 0x20
58
59/*
60 * Upper 4 bits are not documented but start as 1 on powerup
61 * Setting them to 0 causes proximity to misbehave so set them to 1
62 */
63#define MAX44000_REG_CFG_RX_DEFAULT 0xf0
64
65/* REG_RX bits */
66#define MAX44000_CFG_RX_ALSTIM_MASK 0x0c
67#define MAX44000_CFG_RX_ALSTIM_SHIFT 2
68#define MAX44000_CFG_RX_ALSPGA_MASK 0x03
69#define MAX44000_CFG_RX_ALSPGA_SHIFT 0
70
71/* REG_TX bits */
72#define MAX44000_LED_CURRENT_MASK 0xf
73#define MAX44000_LED_CURRENT_MAX 11
74#define MAX44000_LED_CURRENT_DEFAULT 6
75
76#define MAX44000_ALSDATA_OVERFLOW 0x4000
77
78struct max44000_data {
79 struct mutex lock;
80 struct regmap *regmap;
81};
82
83/* Default scale is set to the minimum of 0.03125 or 1 / (1 << 5) lux */
84#define MAX44000_ALS_TO_LUX_DEFAULT_FRACTION_LOG2 5
85
86/* Scale can be multiplied by up to 128x via ALSPGA for measurement gain */
87static const int max44000_alspga_shift[] = {0, 2, 4, 7};
88#define MAX44000_ALSPGA_MAX_SHIFT 7
89
90/*
91 * Scale can be multiplied by up to 64x via ALSTIM because of lost resolution
92 *
93 * This scaling factor is hidden from userspace and instead accounted for when
94 * reading raw values from the device.
95 *
96 * This makes it possible to cleanly expose ALSPGA as IIO_CHAN_INFO_SCALE and
97 * ALSTIM as IIO_CHAN_INFO_INT_TIME without the values affecting each other.
98 *
99 * Handling this internally is also required for buffer support because the
100 * channel's scan_type can't be modified dynamically.
101 */
102static const int max44000_alstim_shift[] = {0, 2, 4, 6};
103#define MAX44000_ALSTIM_SHIFT(alstim) (2 * (alstim))
104
105/* Available integration times with pretty manual alignment: */
106static const int max44000_int_time_avail_ns_array[] = {
107 100000000,
108 25000000,
109 6250000,
110 1562500,
111};
112static const char max44000_int_time_avail_str[] =
113 "0.100 "
114 "0.025 "
115 "0.00625 "
116 "0.0015625";
117
118/* Available scales (internal to ulux) with pretty manual alignment: */
119static const int max44000_scale_avail_ulux_array[] = {
120 31250,
121 125000,
122 500000,
123 4000000,
124};
125static const char max44000_scale_avail_str[] =
126 "0.03125 "
127 "0.125 "
128 "0.5 "
129 "4";
130
131#define MAX44000_SCAN_INDEX_ALS 0
132#define MAX44000_SCAN_INDEX_PRX 1
133
134static const struct iio_chan_spec max44000_channels[] = {
135 {
136 .type = IIO_LIGHT,
137 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
138 .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE) |
139 BIT(IIO_CHAN_INFO_INT_TIME),
140 .scan_index = MAX44000_SCAN_INDEX_ALS,
141 .scan_type = {
142 .sign = 'u',
143 .realbits = 14,
144 .storagebits = 16,
145 }
146 },
147 {
148 .type = IIO_PROXIMITY,
149 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
150 .scan_index = MAX44000_SCAN_INDEX_PRX,
151 .scan_type = {
152 .sign = 'u',
153 .realbits = 8,
154 .storagebits = 16,
155 }
156 },
157 IIO_CHAN_SOFT_TIMESTAMP(2),
158 {
159 .type = IIO_CURRENT,
160 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
161 BIT(IIO_CHAN_INFO_SCALE),
162 .extend_name = "led",
163 .output = 1,
164 .scan_index = -1,
165 },
166};
167
168static int max44000_read_alstim(struct max44000_data *data)
169{
170 unsigned int val;
171 int ret;
172
173 ret = regmap_read(data->regmap, MAX44000_REG_CFG_RX, &val);
174 if (ret < 0)
175 return ret;
176 return (val & MAX44000_CFG_RX_ALSTIM_MASK) >> MAX44000_CFG_RX_ALSTIM_SHIFT;
177}
178
179static int max44000_write_alstim(struct max44000_data *data, int val)
180{
181 return regmap_write_bits(data->regmap, MAX44000_REG_CFG_RX,
182 MAX44000_CFG_RX_ALSTIM_MASK,
183 val << MAX44000_CFG_RX_ALSTIM_SHIFT);
184}
185
186static int max44000_read_alspga(struct max44000_data *data)
187{
188 unsigned int val;
189 int ret;
190
191 ret = regmap_read(data->regmap, MAX44000_REG_CFG_RX, &val);
192 if (ret < 0)
193 return ret;
194 return (val & MAX44000_CFG_RX_ALSPGA_MASK) >> MAX44000_CFG_RX_ALSPGA_SHIFT;
195}
196
197static int max44000_write_alspga(struct max44000_data *data, int val)
198{
199 return regmap_write_bits(data->regmap, MAX44000_REG_CFG_RX,
200 MAX44000_CFG_RX_ALSPGA_MASK,
201 val << MAX44000_CFG_RX_ALSPGA_SHIFT);
202}
203
204static int max44000_read_alsval(struct max44000_data *data)
205{
206 u16 regval;
207 __be16 val;
208 int alstim, ret;
209
210 ret = regmap_bulk_read(data->regmap, MAX44000_REG_ALS_DATA_HI,
211 &val, sizeof(val));
212 if (ret < 0)
213 return ret;
214 alstim = ret = max44000_read_alstim(data);
215 if (ret < 0)
216 return ret;
217
218 regval = be16_to_cpu(val);
219
220 /*
221 * Overflow is explained on datasheet page 17.
222 *
223 * It's a warning that either the G or IR channel has become saturated
224 * and that the value in the register is likely incorrect.
225 *
226 * The recommendation is to change the scale (ALSPGA).
227 * The driver just returns the max representable value.
228 */
229 if (regval & MAX44000_ALSDATA_OVERFLOW)
230 return 0x3FFF;
231
232 return regval << MAX44000_ALSTIM_SHIFT(alstim);
233}
234
235static int max44000_write_led_current_raw(struct max44000_data *data, int val)
236{
237 /* Maybe we should clamp the value instead? */
238 if (val < 0 || val > MAX44000_LED_CURRENT_MAX)
239 return -ERANGE;
240 if (val >= 8)
241 val += 4;
242 return regmap_write_bits(data->regmap, MAX44000_REG_CFG_TX,
243 MAX44000_LED_CURRENT_MASK, val);
244}
245
246static int max44000_read_led_current_raw(struct max44000_data *data)
247{
248 unsigned int regval;
249 int ret;
250
251 ret = regmap_read(data->regmap, MAX44000_REG_CFG_TX, ®val);
252 if (ret < 0)
253 return ret;
254 regval &= MAX44000_LED_CURRENT_MASK;
255 if (regval >= 8)
256 regval -= 4;
257 return regval;
258}
259
260static int max44000_read_raw(struct iio_dev *indio_dev,
261 struct iio_chan_spec const *chan,
262 int *val, int *val2, long mask)
263{
264 struct max44000_data *data = iio_priv(indio_dev);
265 int alstim, alspga;
266 unsigned int regval;
267 int ret;
268
269 switch (mask) {
270 case IIO_CHAN_INFO_RAW:
271 switch (chan->type) {
272 case IIO_LIGHT:
273 mutex_lock(&data->lock);
274 ret = max44000_read_alsval(data);
275 mutex_unlock(&data->lock);
276 if (ret < 0)
277 return ret;
278 *val = ret;
279 return IIO_VAL_INT;
280
281 case IIO_PROXIMITY:
282 mutex_lock(&data->lock);
283 ret = regmap_read(data->regmap, MAX44000_REG_PRX_DATA, ®val);
284 mutex_unlock(&data->lock);
285 if (ret < 0)
286 return ret;
287 *val = regval;
288 return IIO_VAL_INT;
289
290 case IIO_CURRENT:
291 mutex_lock(&data->lock);
292 ret = max44000_read_led_current_raw(data);
293 mutex_unlock(&data->lock);
294 if (ret < 0)
295 return ret;
296 *val = ret;
297 return IIO_VAL_INT;
298
299 default:
300 return -EINVAL;
301 }
302
303 case IIO_CHAN_INFO_SCALE:
304 switch (chan->type) {
305 case IIO_CURRENT:
306 /* Output register is in 10s of miliamps */
307 *val = 10;
308 return IIO_VAL_INT;
309
310 case IIO_LIGHT:
311 mutex_lock(&data->lock);
312 alspga = ret = max44000_read_alspga(data);
313 mutex_unlock(&data->lock);
314 if (ret < 0)
315 return ret;
316
317 /* Avoid negative shifts */
318 *val = (1 << MAX44000_ALSPGA_MAX_SHIFT);
319 *val2 = MAX44000_ALS_TO_LUX_DEFAULT_FRACTION_LOG2
320 + MAX44000_ALSPGA_MAX_SHIFT
321 - max44000_alspga_shift[alspga];
322 return IIO_VAL_FRACTIONAL_LOG2;
323
324 default:
325 return -EINVAL;
326 }
327
328 case IIO_CHAN_INFO_INT_TIME:
329 mutex_lock(&data->lock);
330 alstim = ret = max44000_read_alstim(data);
331 mutex_unlock(&data->lock);
332
333 if (ret < 0)
334 return ret;
335 *val = 0;
336 *val2 = max44000_int_time_avail_ns_array[alstim];
337 return IIO_VAL_INT_PLUS_NANO;
338
339 default:
340 return -EINVAL;
341 }
342}
343
344static int max44000_write_raw(struct iio_dev *indio_dev,
345 struct iio_chan_spec const *chan,
346 int val, int val2, long mask)
347{
348 struct max44000_data *data = iio_priv(indio_dev);
349 int ret;
350
351 if (mask == IIO_CHAN_INFO_RAW && chan->type == IIO_CURRENT) {
352 mutex_lock(&data->lock);
353 ret = max44000_write_led_current_raw(data, val);
354 mutex_unlock(&data->lock);
355 return ret;
356 } else if (mask == IIO_CHAN_INFO_INT_TIME && chan->type == IIO_LIGHT) {
357 s64 valns = val * NSEC_PER_SEC + val2;
358 int alstim = find_closest_descending(valns,
359 max44000_int_time_avail_ns_array,
360 ARRAY_SIZE(max44000_int_time_avail_ns_array));
361 mutex_lock(&data->lock);
362 ret = max44000_write_alstim(data, alstim);
363 mutex_unlock(&data->lock);
364 return ret;
365 } else if (mask == IIO_CHAN_INFO_SCALE && chan->type == IIO_LIGHT) {
366 s64 valus = val * USEC_PER_SEC + val2;
367 int alspga = find_closest(valus,
368 max44000_scale_avail_ulux_array,
369 ARRAY_SIZE(max44000_scale_avail_ulux_array));
370 mutex_lock(&data->lock);
371 ret = max44000_write_alspga(data, alspga);
372 mutex_unlock(&data->lock);
373 return ret;
374 }
375
376 return -EINVAL;
377}
378
379static int max44000_write_raw_get_fmt(struct iio_dev *indio_dev,
380 struct iio_chan_spec const *chan,
381 long mask)
382{
383 if (mask == IIO_CHAN_INFO_INT_TIME && chan->type == IIO_LIGHT)
384 return IIO_VAL_INT_PLUS_NANO;
385 else if (mask == IIO_CHAN_INFO_SCALE && chan->type == IIO_LIGHT)
386 return IIO_VAL_INT_PLUS_MICRO;
387 else
388 return IIO_VAL_INT;
389}
390
391static IIO_CONST_ATTR(illuminance_integration_time_available, max44000_int_time_avail_str);
392static IIO_CONST_ATTR(illuminance_scale_available, max44000_scale_avail_str);
393
394static struct attribute *max44000_attributes[] = {
395 &iio_const_attr_illuminance_integration_time_available.dev_attr.attr,
396 &iio_const_attr_illuminance_scale_available.dev_attr.attr,
397 NULL
398};
399
400static const struct attribute_group max44000_attribute_group = {
401 .attrs = max44000_attributes,
402};
403
404static const struct iio_info max44000_info = {
405 .driver_module = THIS_MODULE,
406 .read_raw = max44000_read_raw,
407 .write_raw = max44000_write_raw,
408 .write_raw_get_fmt = max44000_write_raw_get_fmt,
409 .attrs = &max44000_attribute_group,
410};
411
412static bool max44000_readable_reg(struct device *dev, unsigned int reg)
413{
414 switch (reg) {
415 case MAX44000_REG_STATUS:
416 case MAX44000_REG_CFG_MAIN:
417 case MAX44000_REG_CFG_RX:
418 case MAX44000_REG_CFG_TX:
419 case MAX44000_REG_ALS_DATA_HI:
420 case MAX44000_REG_ALS_DATA_LO:
421 case MAX44000_REG_PRX_DATA:
422 case MAX44000_REG_ALS_UPTHR_HI:
423 case MAX44000_REG_ALS_UPTHR_LO:
424 case MAX44000_REG_ALS_LOTHR_HI:
425 case MAX44000_REG_ALS_LOTHR_LO:
426 case MAX44000_REG_PST:
427 case MAX44000_REG_PRX_IND:
428 case MAX44000_REG_PRX_THR:
429 case MAX44000_REG_TRIM_GAIN_GREEN:
430 case MAX44000_REG_TRIM_GAIN_IR:
431 return true;
432 default:
433 return false;
434 }
435}
436
437static bool max44000_writeable_reg(struct device *dev, unsigned int reg)
438{
439 switch (reg) {
440 case MAX44000_REG_CFG_MAIN:
441 case MAX44000_REG_CFG_RX:
442 case MAX44000_REG_CFG_TX:
443 case MAX44000_REG_ALS_UPTHR_HI:
444 case MAX44000_REG_ALS_UPTHR_LO:
445 case MAX44000_REG_ALS_LOTHR_HI:
446 case MAX44000_REG_ALS_LOTHR_LO:
447 case MAX44000_REG_PST:
448 case MAX44000_REG_PRX_IND:
449 case MAX44000_REG_PRX_THR:
450 case MAX44000_REG_TRIM_GAIN_GREEN:
451 case MAX44000_REG_TRIM_GAIN_IR:
452 return true;
453 default:
454 return false;
455 }
456}
457
458static bool max44000_volatile_reg(struct device *dev, unsigned int reg)
459{
460 switch (reg) {
461 case MAX44000_REG_STATUS:
462 case MAX44000_REG_ALS_DATA_HI:
463 case MAX44000_REG_ALS_DATA_LO:
464 case MAX44000_REG_PRX_DATA:
465 return true;
466 default:
467 return false;
468 }
469}
470
471static bool max44000_precious_reg(struct device *dev, unsigned int reg)
472{
473 return reg == MAX44000_REG_STATUS;
474}
475
476static const struct regmap_config max44000_regmap_config = {
477 .reg_bits = 8,
478 .val_bits = 8,
479
480 .max_register = MAX44000_REG_PRX_DATA,
481 .readable_reg = max44000_readable_reg,
482 .writeable_reg = max44000_writeable_reg,
483 .volatile_reg = max44000_volatile_reg,
484 .precious_reg = max44000_precious_reg,
485
486 .use_single_rw = 1,
487 .cache_type = REGCACHE_RBTREE,
488};
489
490static irqreturn_t max44000_trigger_handler(int irq, void *p)
491{
492 struct iio_poll_func *pf = p;
493 struct iio_dev *indio_dev = pf->indio_dev;
494 struct max44000_data *data = iio_priv(indio_dev);
495 u16 buf[8]; /* 2x u16 + padding + 8 bytes timestamp */
496 int index = 0;
497 unsigned int regval;
498 int ret;
499
500 mutex_lock(&data->lock);
501 if (test_bit(MAX44000_SCAN_INDEX_ALS, indio_dev->active_scan_mask)) {
502 ret = max44000_read_alsval(data);
503 if (ret < 0)
504 goto out_unlock;
505 buf[index++] = ret;
506 }
507 if (test_bit(MAX44000_SCAN_INDEX_PRX, indio_dev->active_scan_mask)) {
508 ret = regmap_read(data->regmap, MAX44000_REG_PRX_DATA, ®val);
509 if (ret < 0)
510 goto out_unlock;
511 buf[index] = regval;
512 }
513 mutex_unlock(&data->lock);
514
515 iio_push_to_buffers_with_timestamp(indio_dev, buf,
516 iio_get_time_ns(indio_dev));
517 iio_trigger_notify_done(indio_dev->trig);
518 return IRQ_HANDLED;
519
520out_unlock:
521 mutex_unlock(&data->lock);
522 iio_trigger_notify_done(indio_dev->trig);
523 return IRQ_HANDLED;
524}
525
526static int max44000_probe(struct i2c_client *client,
527 const struct i2c_device_id *id)
528{
529 struct max44000_data *data;
530 struct iio_dev *indio_dev;
531 int ret, reg;
532
533 indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
534 if (!indio_dev)
535 return -ENOMEM;
536 data = iio_priv(indio_dev);
537 data->regmap = devm_regmap_init_i2c(client, &max44000_regmap_config);
538 if (IS_ERR(data->regmap)) {
539 dev_err(&client->dev, "regmap_init failed!\n");
540 return PTR_ERR(data->regmap);
541 }
542
543 i2c_set_clientdata(client, indio_dev);
544 mutex_init(&data->lock);
545 indio_dev->dev.parent = &client->dev;
546 indio_dev->info = &max44000_info;
547 indio_dev->name = MAX44000_DRV_NAME;
548 indio_dev->channels = max44000_channels;
549 indio_dev->num_channels = ARRAY_SIZE(max44000_channels);
550
551 /*
552 * The device doesn't have a reset function so we just clear some
553 * important bits at probe time to ensure sane operation.
554 *
555 * Since we don't support interrupts/events the threshold values are
556 * not important. We also don't touch trim values.
557 */
558
559 /* Reset ALS scaling bits */
560 ret = regmap_write(data->regmap, MAX44000_REG_CFG_RX,
561 MAX44000_REG_CFG_RX_DEFAULT);
562 if (ret < 0) {
563 dev_err(&client->dev, "failed to write default CFG_RX: %d\n",
564 ret);
565 return ret;
566 }
567
568 /*
569 * By default the LED pulse used for the proximity sensor is disabled.
570 * Set a middle value so that we get some sort of valid data by default.
571 */
572 ret = max44000_write_led_current_raw(data, MAX44000_LED_CURRENT_DEFAULT);
573 if (ret < 0) {
574 dev_err(&client->dev, "failed to write init config: %d\n", ret);
575 return ret;
576 }
577
578 /* Reset CFG bits to ALS_PRX mode which allows easy reading of both values. */
579 reg = MAX44000_CFG_TRIM | MAX44000_CFG_MODE_ALS_PRX;
580 ret = regmap_write(data->regmap, MAX44000_REG_CFG_MAIN, reg);
581 if (ret < 0) {
582 dev_err(&client->dev, "failed to write init config: %d\n", ret);
583 return ret;
584 }
585
586 /* Read status at least once to clear any stale interrupt bits. */
587 ret = regmap_read(data->regmap, MAX44000_REG_STATUS, ®);
588 if (ret < 0) {
589 dev_err(&client->dev, "failed to read init status: %d\n", ret);
590 return ret;
591 }
592
593 ret = iio_triggered_buffer_setup(indio_dev, NULL, max44000_trigger_handler, NULL);
594 if (ret < 0) {
595 dev_err(&client->dev, "iio triggered buffer setup failed\n");
596 return ret;
597 }
598
599 return iio_device_register(indio_dev);
600}
601
602static int max44000_remove(struct i2c_client *client)
603{
604 struct iio_dev *indio_dev = i2c_get_clientdata(client);
605
606 iio_device_unregister(indio_dev);
607 iio_triggered_buffer_cleanup(indio_dev);
608
609 return 0;
610}
611
612static const struct i2c_device_id max44000_id[] = {
613 {"max44000", 0},
614 { }
615};
616MODULE_DEVICE_TABLE(i2c, max44000_id);
617
618#ifdef CONFIG_ACPI
619static const struct acpi_device_id max44000_acpi_match[] = {
620 {"MAX44000", 0},
621 { }
622};
623MODULE_DEVICE_TABLE(acpi, max44000_acpi_match);
624#endif
625
626static struct i2c_driver max44000_driver = {
627 .driver = {
628 .name = MAX44000_DRV_NAME,
629 .acpi_match_table = ACPI_PTR(max44000_acpi_match),
630 },
631 .probe = max44000_probe,
632 .remove = max44000_remove,
633 .id_table = max44000_id,
634};
635
636module_i2c_driver(max44000_driver);
637
638MODULE_AUTHOR("Crestez Dan Leonard <leonard.crestez@intel.com>");
639MODULE_DESCRIPTION("MAX44000 Ambient and Infrared Proximity Sensor");
640MODULE_LICENSE("GPL v2");