1 // SPDX-License-Identifier: GPL-2.0-only
3 * ADS1015 - Texas Instruments Analog-to-Digital Converter
5 * Copyright (c) 2016, Intel Corporation.
7 * IIO driver for ADS1015 ADC 7-bit I2C slave address:
8 * * 0x48 - ADDR connected to Ground
9 * * 0x49 - ADDR connected to Vdd
10 * * 0x4A - ADDR connected to SDA
11 * * 0x4B - ADDR connected to SCL
14 #include <linux/module.h>
15 #include <linux/init.h>
16 #include <linux/irq.h>
17 #include <linux/i2c.h>
18 #include <linux/property.h>
19 #include <linux/regmap.h>
20 #include <linux/pm_runtime.h>
21 #include <linux/mutex.h>
22 #include <linux/delay.h>
24 #include <linux/iio/iio.h>
25 #include <linux/iio/types.h>
26 #include <linux/iio/sysfs.h>
27 #include <linux/iio/events.h>
28 #include <linux/iio/buffer.h>
29 #include <linux/iio/triggered_buffer.h>
30 #include <linux/iio/trigger_consumer.h>
32 #define ADS1015_DRV_NAME "ads1015"
34 #define ADS1015_CHANNELS 8
36 #define ADS1015_CONV_REG 0x00
37 #define ADS1015_CFG_REG 0x01
38 #define ADS1015_LO_THRESH_REG 0x02
39 #define ADS1015_HI_THRESH_REG 0x03
41 #define ADS1015_CFG_COMP_QUE_SHIFT 0
42 #define ADS1015_CFG_COMP_LAT_SHIFT 2
43 #define ADS1015_CFG_COMP_POL_SHIFT 3
44 #define ADS1015_CFG_COMP_MODE_SHIFT 4
45 #define ADS1015_CFG_DR_SHIFT 5
46 #define ADS1015_CFG_MOD_SHIFT 8
47 #define ADS1015_CFG_PGA_SHIFT 9
48 #define ADS1015_CFG_MUX_SHIFT 12
50 #define ADS1015_CFG_COMP_QUE_MASK GENMASK(1, 0)
51 #define ADS1015_CFG_COMP_LAT_MASK BIT(2)
52 #define ADS1015_CFG_COMP_POL_MASK BIT(3)
53 #define ADS1015_CFG_COMP_MODE_MASK BIT(4)
54 #define ADS1015_CFG_DR_MASK GENMASK(7, 5)
55 #define ADS1015_CFG_MOD_MASK BIT(8)
56 #define ADS1015_CFG_PGA_MASK GENMASK(11, 9)
57 #define ADS1015_CFG_MUX_MASK GENMASK(14, 12)
59 /* Comparator queue and disable field */
60 #define ADS1015_CFG_COMP_DISABLE 3
62 /* Comparator polarity field */
63 #define ADS1015_CFG_COMP_POL_LOW 0
64 #define ADS1015_CFG_COMP_POL_HIGH 1
66 /* Comparator mode field */
67 #define ADS1015_CFG_COMP_MODE_TRAD 0
68 #define ADS1015_CFG_COMP_MODE_WINDOW 1
70 /* device operating modes */
71 #define ADS1015_CONTINUOUS 0
72 #define ADS1015_SINGLESHOT 1
74 #define ADS1015_SLEEP_DELAY_MS 2000
75 #define ADS1015_DEFAULT_PGA 2
76 #define ADS1015_DEFAULT_DATA_RATE 4
77 #define ADS1015_DEFAULT_CHAN 0
85 enum ads1015_channels {
86 ADS1015_AIN0_AIN1 = 0,
97 static const unsigned int ads1015_data_rate[] = {
98 128, 250, 490, 920, 1600, 2400, 3300, 3300
101 static const unsigned int ads1115_data_rate[] = {
102 8, 16, 32, 64, 128, 250, 475, 860
106 * Translation from PGA bits to full-scale positive and negative input voltage
109 static int ads1015_fullscale_range[] = {
110 6144, 4096, 2048, 1024, 512, 256, 256, 256
114 * Translation from COMP_QUE field value to the number of successive readings
115 * exceed the threshold values before an interrupt is generated
117 static const int ads1015_comp_queue[] = { 1, 2, 4 };
119 static const struct iio_event_spec ads1015_events[] = {
121 .type = IIO_EV_TYPE_THRESH,
122 .dir = IIO_EV_DIR_RISING,
123 .mask_separate = BIT(IIO_EV_INFO_VALUE) |
124 BIT(IIO_EV_INFO_ENABLE),
126 .type = IIO_EV_TYPE_THRESH,
127 .dir = IIO_EV_DIR_FALLING,
128 .mask_separate = BIT(IIO_EV_INFO_VALUE),
130 .type = IIO_EV_TYPE_THRESH,
131 .dir = IIO_EV_DIR_EITHER,
132 .mask_separate = BIT(IIO_EV_INFO_ENABLE) |
133 BIT(IIO_EV_INFO_PERIOD),
137 #define ADS1015_V_CHAN(_chan, _addr) { \
138 .type = IIO_VOLTAGE, \
142 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) | \
143 BIT(IIO_CHAN_INFO_SCALE) | \
144 BIT(IIO_CHAN_INFO_SAMP_FREQ), \
145 .scan_index = _addr, \
151 .endianness = IIO_CPU, \
153 .event_spec = ads1015_events, \
154 .num_event_specs = ARRAY_SIZE(ads1015_events), \
155 .datasheet_name = "AIN"#_chan, \
158 #define ADS1015_V_DIFF_CHAN(_chan, _chan2, _addr) { \
159 .type = IIO_VOLTAGE, \
164 .channel2 = _chan2, \
165 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) | \
166 BIT(IIO_CHAN_INFO_SCALE) | \
167 BIT(IIO_CHAN_INFO_SAMP_FREQ), \
168 .scan_index = _addr, \
174 .endianness = IIO_CPU, \
176 .event_spec = ads1015_events, \
177 .num_event_specs = ARRAY_SIZE(ads1015_events), \
178 .datasheet_name = "AIN"#_chan"-AIN"#_chan2, \
181 #define ADS1115_V_CHAN(_chan, _addr) { \
182 .type = IIO_VOLTAGE, \
186 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) | \
187 BIT(IIO_CHAN_INFO_SCALE) | \
188 BIT(IIO_CHAN_INFO_SAMP_FREQ), \
189 .scan_index = _addr, \
194 .endianness = IIO_CPU, \
196 .event_spec = ads1015_events, \
197 .num_event_specs = ARRAY_SIZE(ads1015_events), \
198 .datasheet_name = "AIN"#_chan, \
201 #define ADS1115_V_DIFF_CHAN(_chan, _chan2, _addr) { \
202 .type = IIO_VOLTAGE, \
207 .channel2 = _chan2, \
208 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) | \
209 BIT(IIO_CHAN_INFO_SCALE) | \
210 BIT(IIO_CHAN_INFO_SAMP_FREQ), \
211 .scan_index = _addr, \
216 .endianness = IIO_CPU, \
218 .event_spec = ads1015_events, \
219 .num_event_specs = ARRAY_SIZE(ads1015_events), \
220 .datasheet_name = "AIN"#_chan"-AIN"#_chan2, \
223 struct ads1015_channel_data {
226 unsigned int data_rate;
229 struct ads1015_thresh_data {
230 unsigned int comp_queue;
235 struct ads1015_data {
236 struct regmap *regmap;
238 * Protects ADC ops, e.g: concurrent sysfs/buffered
239 * data reads, configuration updates
242 struct ads1015_channel_data channel_data[ADS1015_CHANNELS];
244 unsigned int event_channel;
245 unsigned int comp_mode;
246 struct ads1015_thresh_data thresh_data[ADS1015_CHANNELS];
248 unsigned int *data_rate;
250 * Set to true when the ADC is switched to the continuous-conversion
251 * mode and exits from a power-down state. This flag is used to avoid
252 * getting the stale result from the conversion register.
257 static bool ads1015_event_channel_enabled(struct ads1015_data *data)
259 return (data->event_channel != ADS1015_CHANNELS);
262 static void ads1015_event_channel_enable(struct ads1015_data *data, int chan,
265 WARN_ON(ads1015_event_channel_enabled(data));
267 data->event_channel = chan;
268 data->comp_mode = comp_mode;
271 static void ads1015_event_channel_disable(struct ads1015_data *data, int chan)
273 data->event_channel = ADS1015_CHANNELS;
276 static bool ads1015_is_writeable_reg(struct device *dev, unsigned int reg)
279 case ADS1015_CFG_REG:
280 case ADS1015_LO_THRESH_REG:
281 case ADS1015_HI_THRESH_REG:
288 static const struct regmap_config ads1015_regmap_config = {
291 .max_register = ADS1015_HI_THRESH_REG,
292 .writeable_reg = ads1015_is_writeable_reg,
295 static const struct iio_chan_spec ads1015_channels[] = {
296 ADS1015_V_DIFF_CHAN(0, 1, ADS1015_AIN0_AIN1),
297 ADS1015_V_DIFF_CHAN(0, 3, ADS1015_AIN0_AIN3),
298 ADS1015_V_DIFF_CHAN(1, 3, ADS1015_AIN1_AIN3),
299 ADS1015_V_DIFF_CHAN(2, 3, ADS1015_AIN2_AIN3),
300 ADS1015_V_CHAN(0, ADS1015_AIN0),
301 ADS1015_V_CHAN(1, ADS1015_AIN1),
302 ADS1015_V_CHAN(2, ADS1015_AIN2),
303 ADS1015_V_CHAN(3, ADS1015_AIN3),
304 IIO_CHAN_SOFT_TIMESTAMP(ADS1015_TIMESTAMP),
307 static const struct iio_chan_spec ads1115_channels[] = {
308 ADS1115_V_DIFF_CHAN(0, 1, ADS1015_AIN0_AIN1),
309 ADS1115_V_DIFF_CHAN(0, 3, ADS1015_AIN0_AIN3),
310 ADS1115_V_DIFF_CHAN(1, 3, ADS1015_AIN1_AIN3),
311 ADS1115_V_DIFF_CHAN(2, 3, ADS1015_AIN2_AIN3),
312 ADS1115_V_CHAN(0, ADS1015_AIN0),
313 ADS1115_V_CHAN(1, ADS1015_AIN1),
314 ADS1115_V_CHAN(2, ADS1015_AIN2),
315 ADS1115_V_CHAN(3, ADS1015_AIN3),
316 IIO_CHAN_SOFT_TIMESTAMP(ADS1015_TIMESTAMP),
319 static int ads1015_set_power_state(struct ads1015_data *data, bool on)
322 struct device *dev = regmap_get_device(data->regmap);
325 ret = pm_runtime_get_sync(dev);
327 pm_runtime_put_noidle(dev);
329 pm_runtime_mark_last_busy(dev);
330 ret = pm_runtime_put_autosuspend(dev);
333 return ret < 0 ? ret : 0;
337 int ads1015_get_adc_result(struct ads1015_data *data, int chan, int *val)
339 int ret, pga, dr, dr_old, conv_time;
340 unsigned int old, mask, cfg;
342 if (chan < 0 || chan >= ADS1015_CHANNELS)
345 ret = regmap_read(data->regmap, ADS1015_CFG_REG, &old);
349 pga = data->channel_data[chan].pga;
350 dr = data->channel_data[chan].data_rate;
351 mask = ADS1015_CFG_MUX_MASK | ADS1015_CFG_PGA_MASK |
353 cfg = chan << ADS1015_CFG_MUX_SHIFT | pga << ADS1015_CFG_PGA_SHIFT |
354 dr << ADS1015_CFG_DR_SHIFT;
356 if (ads1015_event_channel_enabled(data)) {
357 mask |= ADS1015_CFG_COMP_QUE_MASK | ADS1015_CFG_COMP_MODE_MASK;
358 cfg |= data->thresh_data[chan].comp_queue <<
359 ADS1015_CFG_COMP_QUE_SHIFT |
361 ADS1015_CFG_COMP_MODE_SHIFT;
364 cfg = (old & ~mask) | (cfg & mask);
366 ret = regmap_write(data->regmap, ADS1015_CFG_REG, cfg);
369 data->conv_invalid = true;
371 if (data->conv_invalid) {
372 dr_old = (old & ADS1015_CFG_DR_MASK) >> ADS1015_CFG_DR_SHIFT;
373 conv_time = DIV_ROUND_UP(USEC_PER_SEC, data->data_rate[dr_old]);
374 conv_time += DIV_ROUND_UP(USEC_PER_SEC, data->data_rate[dr]);
375 conv_time += conv_time / 10; /* 10% internal clock inaccuracy */
376 usleep_range(conv_time, conv_time + 1);
377 data->conv_invalid = false;
380 return regmap_read(data->regmap, ADS1015_CONV_REG, val);
383 static irqreturn_t ads1015_trigger_handler(int irq, void *p)
385 struct iio_poll_func *pf = p;
386 struct iio_dev *indio_dev = pf->indio_dev;
387 struct ads1015_data *data = iio_priv(indio_dev);
388 s16 buf[8]; /* 1x s16 ADC val + 3x s16 padding + 4x s16 timestamp */
391 memset(buf, 0, sizeof(buf));
393 mutex_lock(&data->lock);
394 chan = find_first_bit(indio_dev->active_scan_mask,
395 indio_dev->masklength);
396 ret = ads1015_get_adc_result(data, chan, &res);
398 mutex_unlock(&data->lock);
403 mutex_unlock(&data->lock);
405 iio_push_to_buffers_with_timestamp(indio_dev, buf,
406 iio_get_time_ns(indio_dev));
409 iio_trigger_notify_done(indio_dev->trig);
414 static int ads1015_set_scale(struct ads1015_data *data,
415 struct iio_chan_spec const *chan,
416 int scale, int uscale)
419 int fullscale = div_s64((scale * 1000000LL + uscale) <<
420 (chan->scan_type.realbits - 1), 1000000);
422 for (i = 0; i < ARRAY_SIZE(ads1015_fullscale_range); i++) {
423 if (ads1015_fullscale_range[i] == fullscale) {
424 data->channel_data[chan->address].pga = i;
432 static int ads1015_set_data_rate(struct ads1015_data *data, int chan, int rate)
436 for (i = 0; i < ARRAY_SIZE(ads1015_data_rate); i++) {
437 if (data->data_rate[i] == rate) {
438 data->channel_data[chan].data_rate = i;
446 static int ads1015_read_raw(struct iio_dev *indio_dev,
447 struct iio_chan_spec const *chan, int *val,
448 int *val2, long mask)
451 struct ads1015_data *data = iio_priv(indio_dev);
453 mutex_lock(&data->lock);
455 case IIO_CHAN_INFO_RAW: {
456 int shift = chan->scan_type.shift;
458 ret = iio_device_claim_direct_mode(indio_dev);
462 if (ads1015_event_channel_enabled(data) &&
463 data->event_channel != chan->address) {
468 ret = ads1015_set_power_state(data, true);
472 ret = ads1015_get_adc_result(data, chan->address, val);
474 ads1015_set_power_state(data, false);
478 *val = sign_extend32(*val >> shift, 15 - shift);
480 ret = ads1015_set_power_state(data, false);
486 iio_device_release_direct_mode(indio_dev);
489 case IIO_CHAN_INFO_SCALE:
490 idx = data->channel_data[chan->address].pga;
491 *val = ads1015_fullscale_range[idx];
492 *val2 = chan->scan_type.realbits - 1;
493 ret = IIO_VAL_FRACTIONAL_LOG2;
495 case IIO_CHAN_INFO_SAMP_FREQ:
496 idx = data->channel_data[chan->address].data_rate;
497 *val = data->data_rate[idx];
504 mutex_unlock(&data->lock);
509 static int ads1015_write_raw(struct iio_dev *indio_dev,
510 struct iio_chan_spec const *chan, int val,
513 struct ads1015_data *data = iio_priv(indio_dev);
516 mutex_lock(&data->lock);
518 case IIO_CHAN_INFO_SCALE:
519 ret = ads1015_set_scale(data, chan, val, val2);
521 case IIO_CHAN_INFO_SAMP_FREQ:
522 ret = ads1015_set_data_rate(data, chan->address, val);
528 mutex_unlock(&data->lock);
533 static int ads1015_read_event(struct iio_dev *indio_dev,
534 const struct iio_chan_spec *chan, enum iio_event_type type,
535 enum iio_event_direction dir, enum iio_event_info info, int *val,
538 struct ads1015_data *data = iio_priv(indio_dev);
540 unsigned int comp_queue;
544 mutex_lock(&data->lock);
547 case IIO_EV_INFO_VALUE:
548 *val = (dir == IIO_EV_DIR_RISING) ?
549 data->thresh_data[chan->address].high_thresh :
550 data->thresh_data[chan->address].low_thresh;
553 case IIO_EV_INFO_PERIOD:
554 dr = data->channel_data[chan->address].data_rate;
555 comp_queue = data->thresh_data[chan->address].comp_queue;
556 period = ads1015_comp_queue[comp_queue] *
557 USEC_PER_SEC / data->data_rate[dr];
559 *val = period / USEC_PER_SEC;
560 *val2 = period % USEC_PER_SEC;
561 ret = IIO_VAL_INT_PLUS_MICRO;
568 mutex_unlock(&data->lock);
573 static int ads1015_write_event(struct iio_dev *indio_dev,
574 const struct iio_chan_spec *chan, enum iio_event_type type,
575 enum iio_event_direction dir, enum iio_event_info info, int val,
578 struct ads1015_data *data = iio_priv(indio_dev);
579 int realbits = chan->scan_type.realbits;
585 mutex_lock(&data->lock);
588 case IIO_EV_INFO_VALUE:
589 if (val >= 1 << (realbits - 1) || val < -1 << (realbits - 1)) {
593 if (dir == IIO_EV_DIR_RISING)
594 data->thresh_data[chan->address].high_thresh = val;
596 data->thresh_data[chan->address].low_thresh = val;
598 case IIO_EV_INFO_PERIOD:
599 dr = data->channel_data[chan->address].data_rate;
600 period = val * USEC_PER_SEC + val2;
602 for (i = 0; i < ARRAY_SIZE(ads1015_comp_queue) - 1; i++) {
603 if (period <= ads1015_comp_queue[i] *
604 USEC_PER_SEC / data->data_rate[dr])
607 data->thresh_data[chan->address].comp_queue = i;
614 mutex_unlock(&data->lock);
619 static int ads1015_read_event_config(struct iio_dev *indio_dev,
620 const struct iio_chan_spec *chan, enum iio_event_type type,
621 enum iio_event_direction dir)
623 struct ads1015_data *data = iio_priv(indio_dev);
626 mutex_lock(&data->lock);
627 if (data->event_channel == chan->address) {
629 case IIO_EV_DIR_RISING:
632 case IIO_EV_DIR_EITHER:
633 ret = (data->comp_mode == ADS1015_CFG_COMP_MODE_WINDOW);
640 mutex_unlock(&data->lock);
645 static int ads1015_enable_event_config(struct ads1015_data *data,
646 const struct iio_chan_spec *chan, int comp_mode)
648 int low_thresh = data->thresh_data[chan->address].low_thresh;
649 int high_thresh = data->thresh_data[chan->address].high_thresh;
653 if (ads1015_event_channel_enabled(data)) {
654 if (data->event_channel != chan->address ||
655 (data->comp_mode == ADS1015_CFG_COMP_MODE_TRAD &&
656 comp_mode == ADS1015_CFG_COMP_MODE_WINDOW))
662 if (comp_mode == ADS1015_CFG_COMP_MODE_TRAD) {
663 low_thresh = max(-1 << (chan->scan_type.realbits - 1),
666 ret = regmap_write(data->regmap, ADS1015_LO_THRESH_REG,
667 low_thresh << chan->scan_type.shift);
671 ret = regmap_write(data->regmap, ADS1015_HI_THRESH_REG,
672 high_thresh << chan->scan_type.shift);
676 ret = ads1015_set_power_state(data, true);
680 ads1015_event_channel_enable(data, chan->address, comp_mode);
682 ret = ads1015_get_adc_result(data, chan->address, &val);
684 ads1015_event_channel_disable(data, chan->address);
685 ads1015_set_power_state(data, false);
691 static int ads1015_disable_event_config(struct ads1015_data *data,
692 const struct iio_chan_spec *chan, int comp_mode)
696 if (!ads1015_event_channel_enabled(data))
699 if (data->event_channel != chan->address)
702 if (data->comp_mode == ADS1015_CFG_COMP_MODE_TRAD &&
703 comp_mode == ADS1015_CFG_COMP_MODE_WINDOW)
706 ret = regmap_update_bits(data->regmap, ADS1015_CFG_REG,
707 ADS1015_CFG_COMP_QUE_MASK,
708 ADS1015_CFG_COMP_DISABLE <<
709 ADS1015_CFG_COMP_QUE_SHIFT);
713 ads1015_event_channel_disable(data, chan->address);
715 return ads1015_set_power_state(data, false);
718 static int ads1015_write_event_config(struct iio_dev *indio_dev,
719 const struct iio_chan_spec *chan, enum iio_event_type type,
720 enum iio_event_direction dir, int state)
722 struct ads1015_data *data = iio_priv(indio_dev);
724 int comp_mode = (dir == IIO_EV_DIR_EITHER) ?
725 ADS1015_CFG_COMP_MODE_WINDOW : ADS1015_CFG_COMP_MODE_TRAD;
727 mutex_lock(&data->lock);
729 /* Prevent from enabling both buffer and event at a time */
730 ret = iio_device_claim_direct_mode(indio_dev);
732 mutex_unlock(&data->lock);
737 ret = ads1015_enable_event_config(data, chan, comp_mode);
739 ret = ads1015_disable_event_config(data, chan, comp_mode);
741 iio_device_release_direct_mode(indio_dev);
742 mutex_unlock(&data->lock);
747 static irqreturn_t ads1015_event_handler(int irq, void *priv)
749 struct iio_dev *indio_dev = priv;
750 struct ads1015_data *data = iio_priv(indio_dev);
754 /* Clear the latched ALERT/RDY pin */
755 ret = regmap_read(data->regmap, ADS1015_CONV_REG, &val);
759 if (ads1015_event_channel_enabled(data)) {
760 enum iio_event_direction dir;
763 dir = data->comp_mode == ADS1015_CFG_COMP_MODE_TRAD ?
764 IIO_EV_DIR_RISING : IIO_EV_DIR_EITHER;
765 code = IIO_UNMOD_EVENT_CODE(IIO_VOLTAGE, data->event_channel,
766 IIO_EV_TYPE_THRESH, dir);
767 iio_push_event(indio_dev, code, iio_get_time_ns(indio_dev));
773 static int ads1015_buffer_preenable(struct iio_dev *indio_dev)
775 struct ads1015_data *data = iio_priv(indio_dev);
777 /* Prevent from enabling both buffer and event at a time */
778 if (ads1015_event_channel_enabled(data))
781 return ads1015_set_power_state(iio_priv(indio_dev), true);
784 static int ads1015_buffer_postdisable(struct iio_dev *indio_dev)
786 return ads1015_set_power_state(iio_priv(indio_dev), false);
789 static const struct iio_buffer_setup_ops ads1015_buffer_setup_ops = {
790 .preenable = ads1015_buffer_preenable,
791 .postenable = iio_triggered_buffer_postenable,
792 .predisable = iio_triggered_buffer_predisable,
793 .postdisable = ads1015_buffer_postdisable,
794 .validate_scan_mask = &iio_validate_scan_mask_onehot,
797 static IIO_CONST_ATTR_NAMED(ads1015_scale_available, scale_available,
798 "3 2 1 0.5 0.25 0.125");
799 static IIO_CONST_ATTR_NAMED(ads1115_scale_available, scale_available,
800 "0.1875 0.125 0.0625 0.03125 0.015625 0.007813");
802 static IIO_CONST_ATTR_NAMED(ads1015_sampling_frequency_available,
803 sampling_frequency_available, "128 250 490 920 1600 2400 3300");
804 static IIO_CONST_ATTR_NAMED(ads1115_sampling_frequency_available,
805 sampling_frequency_available, "8 16 32 64 128 250 475 860");
807 static struct attribute *ads1015_attributes[] = {
808 &iio_const_attr_ads1015_scale_available.dev_attr.attr,
809 &iio_const_attr_ads1015_sampling_frequency_available.dev_attr.attr,
813 static const struct attribute_group ads1015_attribute_group = {
814 .attrs = ads1015_attributes,
817 static struct attribute *ads1115_attributes[] = {
818 &iio_const_attr_ads1115_scale_available.dev_attr.attr,
819 &iio_const_attr_ads1115_sampling_frequency_available.dev_attr.attr,
823 static const struct attribute_group ads1115_attribute_group = {
824 .attrs = ads1115_attributes,
827 static const struct iio_info ads1015_info = {
828 .read_raw = ads1015_read_raw,
829 .write_raw = ads1015_write_raw,
830 .read_event_value = ads1015_read_event,
831 .write_event_value = ads1015_write_event,
832 .read_event_config = ads1015_read_event_config,
833 .write_event_config = ads1015_write_event_config,
834 .attrs = &ads1015_attribute_group,
837 static const struct iio_info ads1115_info = {
838 .read_raw = ads1015_read_raw,
839 .write_raw = ads1015_write_raw,
840 .read_event_value = ads1015_read_event,
841 .write_event_value = ads1015_write_event,
842 .read_event_config = ads1015_read_event_config,
843 .write_event_config = ads1015_write_event_config,
844 .attrs = &ads1115_attribute_group,
847 static int ads1015_client_get_channels_config(struct i2c_client *client)
849 struct iio_dev *indio_dev = i2c_get_clientdata(client);
850 struct ads1015_data *data = iio_priv(indio_dev);
851 struct device *dev = &client->dev;
852 struct fwnode_handle *node;
855 device_for_each_child_node(dev, node) {
857 unsigned int channel;
858 unsigned int pga = ADS1015_DEFAULT_PGA;
859 unsigned int data_rate = ADS1015_DEFAULT_DATA_RATE;
861 if (fwnode_property_read_u32(node, "reg", &pval)) {
862 dev_err(dev, "invalid reg on %pfw\n", node);
867 if (channel >= ADS1015_CHANNELS) {
868 dev_err(dev, "invalid channel index %d on %pfw\n",
873 if (!fwnode_property_read_u32(node, "ti,gain", &pval)) {
876 dev_err(dev, "invalid gain on %pfw\n", node);
877 fwnode_handle_put(node);
882 if (!fwnode_property_read_u32(node, "ti,datarate", &pval)) {
885 dev_err(dev, "invalid data_rate on %pfw\n", node);
886 fwnode_handle_put(node);
891 data->channel_data[channel].pga = pga;
892 data->channel_data[channel].data_rate = data_rate;
897 return i < 0 ? -EINVAL : 0;
900 static void ads1015_get_channels_config(struct i2c_client *client)
904 struct iio_dev *indio_dev = i2c_get_clientdata(client);
905 struct ads1015_data *data = iio_priv(indio_dev);
907 if (!ads1015_client_get_channels_config(client))
910 /* fallback on default configuration */
911 for (k = 0; k < ADS1015_CHANNELS; ++k) {
912 data->channel_data[k].pga = ADS1015_DEFAULT_PGA;
913 data->channel_data[k].data_rate = ADS1015_DEFAULT_DATA_RATE;
917 static int ads1015_set_conv_mode(struct ads1015_data *data, int mode)
919 return regmap_update_bits(data->regmap, ADS1015_CFG_REG,
920 ADS1015_CFG_MOD_MASK,
921 mode << ADS1015_CFG_MOD_SHIFT);
924 static int ads1015_probe(struct i2c_client *client,
925 const struct i2c_device_id *id)
927 struct iio_dev *indio_dev;
928 struct ads1015_data *data;
933 indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
937 data = iio_priv(indio_dev);
938 i2c_set_clientdata(client, indio_dev);
940 mutex_init(&data->lock);
942 indio_dev->dev.parent = &client->dev;
943 indio_dev->dev.of_node = client->dev.of_node;
944 indio_dev->name = ADS1015_DRV_NAME;
945 indio_dev->modes = INDIO_DIRECT_MODE;
947 chip = (enum chip_ids)device_get_match_data(&client->dev);
949 chip = id->driver_data;
952 indio_dev->channels = ads1015_channels;
953 indio_dev->num_channels = ARRAY_SIZE(ads1015_channels);
954 indio_dev->info = &ads1015_info;
955 data->data_rate = (unsigned int *) &ads1015_data_rate;
958 indio_dev->channels = ads1115_channels;
959 indio_dev->num_channels = ARRAY_SIZE(ads1115_channels);
960 indio_dev->info = &ads1115_info;
961 data->data_rate = (unsigned int *) &ads1115_data_rate;
964 dev_err(&client->dev, "Unknown chip %d\n", chip);
968 data->event_channel = ADS1015_CHANNELS;
970 * Set default lower and upper threshold to min and max value
973 for (i = 0; i < ADS1015_CHANNELS; i++) {
974 int realbits = indio_dev->channels[i].scan_type.realbits;
976 data->thresh_data[i].low_thresh = -1 << (realbits - 1);
977 data->thresh_data[i].high_thresh = (1 << (realbits - 1)) - 1;
980 /* we need to keep this ABI the same as used by hwmon ADS1015 driver */
981 ads1015_get_channels_config(client);
983 data->regmap = devm_regmap_init_i2c(client, &ads1015_regmap_config);
984 if (IS_ERR(data->regmap)) {
985 dev_err(&client->dev, "Failed to allocate register map\n");
986 return PTR_ERR(data->regmap);
989 ret = devm_iio_triggered_buffer_setup(&client->dev, indio_dev, NULL,
990 ads1015_trigger_handler,
991 &ads1015_buffer_setup_ops);
993 dev_err(&client->dev, "iio triggered buffer setup failed\n");
998 unsigned long irq_trig =
999 irqd_get_trigger_type(irq_get_irq_data(client->irq));
1000 unsigned int cfg_comp_mask = ADS1015_CFG_COMP_QUE_MASK |
1001 ADS1015_CFG_COMP_LAT_MASK | ADS1015_CFG_COMP_POL_MASK;
1002 unsigned int cfg_comp =
1003 ADS1015_CFG_COMP_DISABLE << ADS1015_CFG_COMP_QUE_SHIFT |
1004 1 << ADS1015_CFG_COMP_LAT_SHIFT;
1007 case IRQF_TRIGGER_LOW:
1008 cfg_comp |= ADS1015_CFG_COMP_POL_LOW <<
1009 ADS1015_CFG_COMP_POL_SHIFT;
1011 case IRQF_TRIGGER_HIGH:
1012 cfg_comp |= ADS1015_CFG_COMP_POL_HIGH <<
1013 ADS1015_CFG_COMP_POL_SHIFT;
1019 ret = regmap_update_bits(data->regmap, ADS1015_CFG_REG,
1020 cfg_comp_mask, cfg_comp);
1024 ret = devm_request_threaded_irq(&client->dev, client->irq,
1025 NULL, ads1015_event_handler,
1026 irq_trig | IRQF_ONESHOT,
1027 client->name, indio_dev);
1032 ret = ads1015_set_conv_mode(data, ADS1015_CONTINUOUS);
1036 data->conv_invalid = true;
1038 ret = pm_runtime_set_active(&client->dev);
1041 pm_runtime_set_autosuspend_delay(&client->dev, ADS1015_SLEEP_DELAY_MS);
1042 pm_runtime_use_autosuspend(&client->dev);
1043 pm_runtime_enable(&client->dev);
1045 ret = iio_device_register(indio_dev);
1047 dev_err(&client->dev, "Failed to register IIO device\n");
1054 static int ads1015_remove(struct i2c_client *client)
1056 struct iio_dev *indio_dev = i2c_get_clientdata(client);
1057 struct ads1015_data *data = iio_priv(indio_dev);
1059 iio_device_unregister(indio_dev);
1061 pm_runtime_disable(&client->dev);
1062 pm_runtime_set_suspended(&client->dev);
1063 pm_runtime_put_noidle(&client->dev);
1065 /* power down single shot mode */
1066 return ads1015_set_conv_mode(data, ADS1015_SINGLESHOT);
1070 static int ads1015_runtime_suspend(struct device *dev)
1072 struct iio_dev *indio_dev = i2c_get_clientdata(to_i2c_client(dev));
1073 struct ads1015_data *data = iio_priv(indio_dev);
1075 return ads1015_set_conv_mode(data, ADS1015_SINGLESHOT);
1078 static int ads1015_runtime_resume(struct device *dev)
1080 struct iio_dev *indio_dev = i2c_get_clientdata(to_i2c_client(dev));
1081 struct ads1015_data *data = iio_priv(indio_dev);
1084 ret = ads1015_set_conv_mode(data, ADS1015_CONTINUOUS);
1086 data->conv_invalid = true;
1092 static const struct dev_pm_ops ads1015_pm_ops = {
1093 SET_RUNTIME_PM_OPS(ads1015_runtime_suspend,
1094 ads1015_runtime_resume, NULL)
1097 static const struct i2c_device_id ads1015_id[] = {
1098 {"ads1015", ADS1015},
1099 {"ads1115", ADS1115},
1102 MODULE_DEVICE_TABLE(i2c, ads1015_id);
1104 static const struct of_device_id ads1015_of_match[] = {
1106 .compatible = "ti,ads1015",
1107 .data = (void *)ADS1015
1110 .compatible = "ti,ads1115",
1111 .data = (void *)ADS1115
1115 MODULE_DEVICE_TABLE(of, ads1015_of_match);
1117 static struct i2c_driver ads1015_driver = {
1119 .name = ADS1015_DRV_NAME,
1120 .of_match_table = ads1015_of_match,
1121 .pm = &ads1015_pm_ops,
1123 .probe = ads1015_probe,
1124 .remove = ads1015_remove,
1125 .id_table = ads1015_id,
1128 module_i2c_driver(ads1015_driver);
1130 MODULE_AUTHOR("Daniel Baluta <daniel.baluta@intel.com>");
1131 MODULE_DESCRIPTION("Texas Instruments ADS1015 ADC driver");
1132 MODULE_LICENSE("GPL v2");