2 * opt3001.c - Texas Instruments OPT3001 Light Sensor
4 * Copyright (C) 2014 Texas Instruments Incorporated - http://www.ti.com
6 * Author: Andreas Dannenberg <dannenberg@ti.com>
7 * Based on previous work from: Felipe Balbi <balbi@ti.com>
9 * This program is free software: you can redistribute it and/or modify it
10 * under the terms of the GNU General Public License version 2 of the License
11 * as published by the Free Software Foundation.
13 * This program is distributed in the hope that it will be useful, but WITHOUT
14 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
19 #include <linux/bitops.h>
20 #include <linux/delay.h>
21 #include <linux/device.h>
22 #include <linux/i2c.h>
23 #include <linux/interrupt.h>
24 #include <linux/irq.h>
25 #include <linux/kernel.h>
26 #include <linux/module.h>
27 #include <linux/mutex.h>
28 #include <linux/slab.h>
29 #include <linux/types.h>
31 #include <linux/iio/events.h>
32 #include <linux/iio/iio.h>
33 #include <linux/iio/sysfs.h>
35 #define OPT3001_RESULT 0x00
36 #define OPT3001_CONFIGURATION 0x01
37 #define OPT3001_LOW_LIMIT 0x02
38 #define OPT3001_HIGH_LIMIT 0x03
39 #define OPT3001_MANUFACTURER_ID 0x7e
40 #define OPT3001_DEVICE_ID 0x7f
42 #define OPT3001_CONFIGURATION_RN_MASK (0xf << 12)
43 #define OPT3001_CONFIGURATION_RN_AUTO (0xc << 12)
45 #define OPT3001_CONFIGURATION_CT BIT(11)
47 #define OPT3001_CONFIGURATION_M_MASK (3 << 9)
48 #define OPT3001_CONFIGURATION_M_SHUTDOWN (0 << 9)
49 #define OPT3001_CONFIGURATION_M_SINGLE (1 << 9)
50 #define OPT3001_CONFIGURATION_M_CONTINUOUS (2 << 9) /* also 3 << 9 */
52 #define OPT3001_CONFIGURATION_OVF BIT(8)
53 #define OPT3001_CONFIGURATION_CRF BIT(7)
54 #define OPT3001_CONFIGURATION_FH BIT(6)
55 #define OPT3001_CONFIGURATION_FL BIT(5)
56 #define OPT3001_CONFIGURATION_L BIT(4)
57 #define OPT3001_CONFIGURATION_POL BIT(3)
58 #define OPT3001_CONFIGURATION_ME BIT(2)
60 #define OPT3001_CONFIGURATION_FC_MASK (3 << 0)
62 /* The end-of-conversion enable is located in the low-limit register */
63 #define OPT3001_LOW_LIMIT_EOC_ENABLE 0xc000
65 #define OPT3001_REG_EXPONENT(n) ((n) >> 12)
66 #define OPT3001_REG_MANTISSA(n) ((n) & 0xfff)
68 #define OPT3001_INT_TIME_LONG 800000
69 #define OPT3001_INT_TIME_SHORT 100000
72 * Time to wait for conversion result to be ready. The device datasheet
73 * sect. 6.5 states results are ready after total integration time plus 3ms.
74 * This results in worst-case max values of 113ms or 883ms, respectively.
75 * Add some slack to be on the safe side.
77 #define OPT3001_RESULT_READY_SHORT 150
78 #define OPT3001_RESULT_READY_LONG 1000
81 struct i2c_client
*client
;
85 bool ok_to_ignore_lock
;
87 wait_queue_head_t result_ready_queue
;
93 u16 high_thresh_mantissa
;
94 u16 low_thresh_mantissa
;
102 struct opt3001_scale
{
107 static const struct opt3001_scale opt3001_scales
[] = {
154 static int opt3001_find_scale(const struct opt3001
*opt
, int val
,
155 int val2
, u8
*exponent
)
159 for (i
= 0; i
< ARRAY_SIZE(opt3001_scales
); i
++) {
160 const struct opt3001_scale
*scale
= &opt3001_scales
[i
];
163 * Combine the integer and micro parts for comparison
164 * purposes. Use milli lux precision to avoid 32-bit integer
167 if ((val
* 1000 + val2
/ 1000) <=
168 (scale
->val
* 1000 + scale
->val2
/ 1000)) {
177 static void opt3001_to_iio_ret(struct opt3001
*opt
, u8 exponent
,
178 u16 mantissa
, int *val
, int *val2
)
182 lux
= 10 * (mantissa
<< exponent
);
184 *val2
= (lux
- (*val
* 1000)) * 1000;
187 static void opt3001_set_mode(struct opt3001
*opt
, u16
*reg
, u16 mode
)
189 *reg
&= ~OPT3001_CONFIGURATION_M_MASK
;
194 static IIO_CONST_ATTR_INT_TIME_AVAIL("0.1 0.8");
196 static struct attribute
*opt3001_attributes
[] = {
197 &iio_const_attr_integration_time_available
.dev_attr
.attr
,
201 static const struct attribute_group opt3001_attribute_group
= {
202 .attrs
= opt3001_attributes
,
205 static const struct iio_event_spec opt3001_event_spec
[] = {
207 .type
= IIO_EV_TYPE_THRESH
,
208 .dir
= IIO_EV_DIR_RISING
,
209 .mask_separate
= BIT(IIO_EV_INFO_VALUE
) |
210 BIT(IIO_EV_INFO_ENABLE
),
213 .type
= IIO_EV_TYPE_THRESH
,
214 .dir
= IIO_EV_DIR_FALLING
,
215 .mask_separate
= BIT(IIO_EV_INFO_VALUE
) |
216 BIT(IIO_EV_INFO_ENABLE
),
220 static const struct iio_chan_spec opt3001_channels
[] = {
223 .info_mask_separate
= BIT(IIO_CHAN_INFO_PROCESSED
) |
224 BIT(IIO_CHAN_INFO_INT_TIME
),
225 .event_spec
= opt3001_event_spec
,
226 .num_event_specs
= ARRAY_SIZE(opt3001_event_spec
),
228 IIO_CHAN_SOFT_TIMESTAMP(1),
231 static int opt3001_get_lux(struct opt3001
*opt
, int *val
, int *val2
)
242 * Enable the end-of-conversion interrupt mechanism. Note that
243 * doing so will overwrite the low-level limit value however we
244 * will restore this value later on.
246 ret
= i2c_smbus_write_word_swapped(opt
->client
,
248 OPT3001_LOW_LIMIT_EOC_ENABLE
);
250 dev_err(opt
->dev
, "failed to write register %02x\n",
255 /* Allow IRQ to access the device despite lock being set */
256 opt
->ok_to_ignore_lock
= true;
259 /* Reset data-ready indicator flag */
260 opt
->result_ready
= false;
262 /* Configure for single-conversion mode and start a new conversion */
263 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_CONFIGURATION
);
265 dev_err(opt
->dev
, "failed to read register %02x\n",
266 OPT3001_CONFIGURATION
);
271 opt3001_set_mode(opt
, ®
, OPT3001_CONFIGURATION_M_SINGLE
);
273 ret
= i2c_smbus_write_word_swapped(opt
->client
, OPT3001_CONFIGURATION
,
276 dev_err(opt
->dev
, "failed to write register %02x\n",
277 OPT3001_CONFIGURATION
);
282 /* Wait for the IRQ to indicate the conversion is complete */
283 ret
= wait_event_timeout(opt
->result_ready_queue
,
285 msecs_to_jiffies(OPT3001_RESULT_READY_LONG
));
287 /* Sleep for result ready time */
288 timeout
= (opt
->int_time
== OPT3001_INT_TIME_SHORT
) ?
289 OPT3001_RESULT_READY_SHORT
: OPT3001_RESULT_READY_LONG
;
292 /* Check result ready flag */
293 ret
= i2c_smbus_read_word_swapped(opt
->client
,
294 OPT3001_CONFIGURATION
);
296 dev_err(opt
->dev
, "failed to read register %02x\n",
297 OPT3001_CONFIGURATION
);
301 if (!(ret
& OPT3001_CONFIGURATION_CRF
)) {
307 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_RESULT
);
309 dev_err(opt
->dev
, "failed to read register %02x\n",
314 opt
->result_ready
= true;
319 /* Disallow IRQ to access the device while lock is active */
320 opt
->ok_to_ignore_lock
= false;
329 * Disable the end-of-conversion interrupt mechanism by
330 * restoring the low-level limit value (clearing
331 * OPT3001_LOW_LIMIT_EOC_ENABLE). Note that selectively clearing
332 * those enable bits would affect the actual limit value due to
333 * bit-overlap and therefore can't be done.
335 value
= (opt
->low_thresh_exp
<< 12) | opt
->low_thresh_mantissa
;
336 ret
= i2c_smbus_write_word_swapped(opt
->client
,
340 dev_err(opt
->dev
, "failed to write register %02x\n",
346 exponent
= OPT3001_REG_EXPONENT(opt
->result
);
347 mantissa
= OPT3001_REG_MANTISSA(opt
->result
);
349 opt3001_to_iio_ret(opt
, exponent
, mantissa
, val
, val2
);
351 return IIO_VAL_INT_PLUS_MICRO
;
354 static int opt3001_get_int_time(struct opt3001
*opt
, int *val
, int *val2
)
357 *val2
= opt
->int_time
;
359 return IIO_VAL_INT_PLUS_MICRO
;
362 static int opt3001_set_int_time(struct opt3001
*opt
, int time
)
367 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_CONFIGURATION
);
369 dev_err(opt
->dev
, "failed to read register %02x\n",
370 OPT3001_CONFIGURATION
);
377 case OPT3001_INT_TIME_SHORT
:
378 reg
&= ~OPT3001_CONFIGURATION_CT
;
379 opt
->int_time
= OPT3001_INT_TIME_SHORT
;
381 case OPT3001_INT_TIME_LONG
:
382 reg
|= OPT3001_CONFIGURATION_CT
;
383 opt
->int_time
= OPT3001_INT_TIME_LONG
;
389 return i2c_smbus_write_word_swapped(opt
->client
, OPT3001_CONFIGURATION
,
393 static int opt3001_read_raw(struct iio_dev
*iio
,
394 struct iio_chan_spec
const *chan
, int *val
, int *val2
,
397 struct opt3001
*opt
= iio_priv(iio
);
400 if (opt
->mode
== OPT3001_CONFIGURATION_M_CONTINUOUS
)
403 if (chan
->type
!= IIO_LIGHT
)
406 mutex_lock(&opt
->lock
);
409 case IIO_CHAN_INFO_PROCESSED
:
410 ret
= opt3001_get_lux(opt
, val
, val2
);
412 case IIO_CHAN_INFO_INT_TIME
:
413 ret
= opt3001_get_int_time(opt
, val
, val2
);
419 mutex_unlock(&opt
->lock
);
424 static int opt3001_write_raw(struct iio_dev
*iio
,
425 struct iio_chan_spec
const *chan
, int val
, int val2
,
428 struct opt3001
*opt
= iio_priv(iio
);
431 if (opt
->mode
== OPT3001_CONFIGURATION_M_CONTINUOUS
)
434 if (chan
->type
!= IIO_LIGHT
)
437 if (mask
!= IIO_CHAN_INFO_INT_TIME
)
443 mutex_lock(&opt
->lock
);
444 ret
= opt3001_set_int_time(opt
, val2
);
445 mutex_unlock(&opt
->lock
);
450 static int opt3001_read_event_value(struct iio_dev
*iio
,
451 const struct iio_chan_spec
*chan
, enum iio_event_type type
,
452 enum iio_event_direction dir
, enum iio_event_info info
,
455 struct opt3001
*opt
= iio_priv(iio
);
456 int ret
= IIO_VAL_INT_PLUS_MICRO
;
458 mutex_lock(&opt
->lock
);
461 case IIO_EV_DIR_RISING
:
462 opt3001_to_iio_ret(opt
, opt
->high_thresh_exp
,
463 opt
->high_thresh_mantissa
, val
, val2
);
465 case IIO_EV_DIR_FALLING
:
466 opt3001_to_iio_ret(opt
, opt
->low_thresh_exp
,
467 opt
->low_thresh_mantissa
, val
, val2
);
473 mutex_unlock(&opt
->lock
);
478 static int opt3001_write_event_value(struct iio_dev
*iio
,
479 const struct iio_chan_spec
*chan
, enum iio_event_type type
,
480 enum iio_event_direction dir
, enum iio_event_info info
,
483 struct opt3001
*opt
= iio_priv(iio
);
495 mutex_lock(&opt
->lock
);
497 ret
= opt3001_find_scale(opt
, val
, val2
, &exponent
);
499 dev_err(opt
->dev
, "can't find scale for %d.%06u\n", val
, val2
);
503 mantissa
= (((val
* 1000) + (val2
/ 1000)) / 10) >> exponent
;
504 value
= (exponent
<< 12) | mantissa
;
507 case IIO_EV_DIR_RISING
:
508 reg
= OPT3001_HIGH_LIMIT
;
509 opt
->high_thresh_mantissa
= mantissa
;
510 opt
->high_thresh_exp
= exponent
;
512 case IIO_EV_DIR_FALLING
:
513 reg
= OPT3001_LOW_LIMIT
;
514 opt
->low_thresh_mantissa
= mantissa
;
515 opt
->low_thresh_exp
= exponent
;
522 ret
= i2c_smbus_write_word_swapped(opt
->client
, reg
, value
);
524 dev_err(opt
->dev
, "failed to write register %02x\n", reg
);
529 mutex_unlock(&opt
->lock
);
534 static int opt3001_read_event_config(struct iio_dev
*iio
,
535 const struct iio_chan_spec
*chan
, enum iio_event_type type
,
536 enum iio_event_direction dir
)
538 struct opt3001
*opt
= iio_priv(iio
);
540 return opt
->mode
== OPT3001_CONFIGURATION_M_CONTINUOUS
;
543 static int opt3001_write_event_config(struct iio_dev
*iio
,
544 const struct iio_chan_spec
*chan
, enum iio_event_type type
,
545 enum iio_event_direction dir
, int state
)
547 struct opt3001
*opt
= iio_priv(iio
);
552 if (state
&& opt
->mode
== OPT3001_CONFIGURATION_M_CONTINUOUS
)
555 if (!state
&& opt
->mode
== OPT3001_CONFIGURATION_M_SHUTDOWN
)
558 mutex_lock(&opt
->lock
);
560 mode
= state
? OPT3001_CONFIGURATION_M_CONTINUOUS
561 : OPT3001_CONFIGURATION_M_SHUTDOWN
;
563 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_CONFIGURATION
);
565 dev_err(opt
->dev
, "failed to read register %02x\n",
566 OPT3001_CONFIGURATION
);
571 opt3001_set_mode(opt
, ®
, mode
);
573 ret
= i2c_smbus_write_word_swapped(opt
->client
, OPT3001_CONFIGURATION
,
576 dev_err(opt
->dev
, "failed to write register %02x\n",
577 OPT3001_CONFIGURATION
);
582 mutex_unlock(&opt
->lock
);
587 static const struct iio_info opt3001_info
= {
588 .attrs
= &opt3001_attribute_group
,
589 .read_raw
= opt3001_read_raw
,
590 .write_raw
= opt3001_write_raw
,
591 .read_event_value
= opt3001_read_event_value
,
592 .write_event_value
= opt3001_write_event_value
,
593 .read_event_config
= opt3001_read_event_config
,
594 .write_event_config
= opt3001_write_event_config
,
597 static int opt3001_read_id(struct opt3001
*opt
)
599 char manufacturer
[2];
603 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_MANUFACTURER_ID
);
605 dev_err(opt
->dev
, "failed to read register %02x\n",
606 OPT3001_MANUFACTURER_ID
);
610 manufacturer
[0] = ret
>> 8;
611 manufacturer
[1] = ret
& 0xff;
613 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_DEVICE_ID
);
615 dev_err(opt
->dev
, "failed to read register %02x\n",
622 dev_info(opt
->dev
, "Found %c%c OPT%04x\n", manufacturer
[0],
623 manufacturer
[1], device_id
);
628 static int opt3001_configure(struct opt3001
*opt
)
633 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_CONFIGURATION
);
635 dev_err(opt
->dev
, "failed to read register %02x\n",
636 OPT3001_CONFIGURATION
);
642 /* Enable automatic full-scale setting mode */
643 reg
&= ~OPT3001_CONFIGURATION_RN_MASK
;
644 reg
|= OPT3001_CONFIGURATION_RN_AUTO
;
646 /* Reflect status of the device's integration time setting */
647 if (reg
& OPT3001_CONFIGURATION_CT
)
648 opt
->int_time
= OPT3001_INT_TIME_LONG
;
650 opt
->int_time
= OPT3001_INT_TIME_SHORT
;
652 /* Ensure device is in shutdown initially */
653 opt3001_set_mode(opt
, ®
, OPT3001_CONFIGURATION_M_SHUTDOWN
);
655 /* Configure for latched window-style comparison operation */
656 reg
|= OPT3001_CONFIGURATION_L
;
657 reg
&= ~OPT3001_CONFIGURATION_POL
;
658 reg
&= ~OPT3001_CONFIGURATION_ME
;
659 reg
&= ~OPT3001_CONFIGURATION_FC_MASK
;
661 ret
= i2c_smbus_write_word_swapped(opt
->client
, OPT3001_CONFIGURATION
,
664 dev_err(opt
->dev
, "failed to write register %02x\n",
665 OPT3001_CONFIGURATION
);
669 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_LOW_LIMIT
);
671 dev_err(opt
->dev
, "failed to read register %02x\n",
676 opt
->low_thresh_mantissa
= OPT3001_REG_MANTISSA(ret
);
677 opt
->low_thresh_exp
= OPT3001_REG_EXPONENT(ret
);
679 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_HIGH_LIMIT
);
681 dev_err(opt
->dev
, "failed to read register %02x\n",
686 opt
->high_thresh_mantissa
= OPT3001_REG_MANTISSA(ret
);
687 opt
->high_thresh_exp
= OPT3001_REG_EXPONENT(ret
);
692 static irqreturn_t
opt3001_irq(int irq
, void *_iio
)
694 struct iio_dev
*iio
= _iio
;
695 struct opt3001
*opt
= iio_priv(iio
);
697 bool wake_result_ready_queue
= false;
699 if (!opt
->ok_to_ignore_lock
)
700 mutex_lock(&opt
->lock
);
702 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_CONFIGURATION
);
704 dev_err(opt
->dev
, "failed to read register %02x\n",
705 OPT3001_CONFIGURATION
);
709 if ((ret
& OPT3001_CONFIGURATION_M_MASK
) ==
710 OPT3001_CONFIGURATION_M_CONTINUOUS
) {
711 if (ret
& OPT3001_CONFIGURATION_FH
)
713 IIO_UNMOD_EVENT_CODE(IIO_LIGHT
, 0,
716 iio_get_time_ns(iio
));
717 if (ret
& OPT3001_CONFIGURATION_FL
)
719 IIO_UNMOD_EVENT_CODE(IIO_LIGHT
, 0,
722 iio_get_time_ns(iio
));
723 } else if (ret
& OPT3001_CONFIGURATION_CRF
) {
724 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_RESULT
);
726 dev_err(opt
->dev
, "failed to read register %02x\n",
731 opt
->result_ready
= true;
732 wake_result_ready_queue
= true;
736 if (!opt
->ok_to_ignore_lock
)
737 mutex_unlock(&opt
->lock
);
739 if (wake_result_ready_queue
)
740 wake_up(&opt
->result_ready_queue
);
745 static int opt3001_probe(struct i2c_client
*client
,
746 const struct i2c_device_id
*id
)
748 struct device
*dev
= &client
->dev
;
752 int irq
= client
->irq
;
755 iio
= devm_iio_device_alloc(dev
, sizeof(*opt
));
760 opt
->client
= client
;
763 mutex_init(&opt
->lock
);
764 init_waitqueue_head(&opt
->result_ready_queue
);
765 i2c_set_clientdata(client
, iio
);
767 ret
= opt3001_read_id(opt
);
771 ret
= opt3001_configure(opt
);
775 iio
->name
= client
->name
;
776 iio
->channels
= opt3001_channels
;
777 iio
->num_channels
= ARRAY_SIZE(opt3001_channels
);
778 iio
->dev
.parent
= dev
;
779 iio
->modes
= INDIO_DIRECT_MODE
;
780 iio
->info
= &opt3001_info
;
782 ret
= devm_iio_device_register(dev
, iio
);
784 dev_err(dev
, "failed to register IIO device\n");
788 /* Make use of INT pin only if valid IRQ no. is given */
790 ret
= request_threaded_irq(irq
, NULL
, opt3001_irq
,
791 IRQF_TRIGGER_FALLING
| IRQF_ONESHOT
,
794 dev_err(dev
, "failed to request IRQ #%d\n", irq
);
799 dev_dbg(opt
->dev
, "enabling interrupt-less operation\n");
805 static int opt3001_remove(struct i2c_client
*client
)
807 struct iio_dev
*iio
= i2c_get_clientdata(client
);
808 struct opt3001
*opt
= iio_priv(iio
);
813 free_irq(client
->irq
, iio
);
815 ret
= i2c_smbus_read_word_swapped(opt
->client
, OPT3001_CONFIGURATION
);
817 dev_err(opt
->dev
, "failed to read register %02x\n",
818 OPT3001_CONFIGURATION
);
823 opt3001_set_mode(opt
, ®
, OPT3001_CONFIGURATION_M_SHUTDOWN
);
825 ret
= i2c_smbus_write_word_swapped(opt
->client
, OPT3001_CONFIGURATION
,
828 dev_err(opt
->dev
, "failed to write register %02x\n",
829 OPT3001_CONFIGURATION
);
836 static const struct i2c_device_id opt3001_id
[] = {
838 { } /* Terminating Entry */
840 MODULE_DEVICE_TABLE(i2c
, opt3001_id
);
842 static const struct of_device_id opt3001_of_match
[] = {
843 { .compatible
= "ti,opt3001" },
846 MODULE_DEVICE_TABLE(of
, opt3001_of_match
);
848 static struct i2c_driver opt3001_driver
= {
849 .probe
= opt3001_probe
,
850 .remove
= opt3001_remove
,
851 .id_table
= opt3001_id
,
855 .of_match_table
= of_match_ptr(opt3001_of_match
),
859 module_i2c_driver(opt3001_driver
);
861 MODULE_LICENSE("GPL v2");
862 MODULE_AUTHOR("Andreas Dannenberg <dannenberg@ti.com>");
863 MODULE_DESCRIPTION("Texas Instruments OPT3001 Light Sensor Driver");