1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * Support code for Analog Devices Sigma-Delta ADCs
4 *
5 * Copyright 2012 Analog Devices Inc.
6 * Author: Lars-Peter Clausen <lars@metafoo.de>
7 */
8
9 #include <linux/align.h>
10 #include <linux/interrupt.h>
11 #include <linux/device.h>
12 #include <linux/kernel.h>
13 #include <linux/slab.h>
14 #include <linux/spi/spi.h>
15 #include <linux/err.h>
16 #include <linux/module.h>
17
18 #include <linux/iio/iio.h>
19 #include <linux/iio/sysfs.h>
20 #include <linux/iio/buffer.h>
21 #include <linux/iio/trigger.h>
22 #include <linux/iio/trigger_consumer.h>
23 #include <linux/iio/triggered_buffer.h>
24 #include <linux/iio/adc/ad_sigma_delta.h>
25
26 #include <linux/unaligned.h>
27
28
29 #define AD_SD_COMM_CHAN_MASK 0x3
30
31 #define AD_SD_REG_COMM 0x00
32 #define AD_SD_REG_DATA 0x03
33
34 /**
35 * ad_sd_set_comm() - Set communications register
36 *
37 * @sigma_delta: The sigma delta device
38 * @comm: New value for the communications register
39 */
ad_sd_set_comm(struct ad_sigma_delta * sigma_delta,uint8_t comm)40 void ad_sd_set_comm(struct ad_sigma_delta *sigma_delta, uint8_t comm)
41 {
42 /* Some variants use the lower two bits of the communications register
43 * to select the channel */
44 sigma_delta->comm = comm & AD_SD_COMM_CHAN_MASK;
45 }
46 EXPORT_SYMBOL_NS_GPL(ad_sd_set_comm, IIO_AD_SIGMA_DELTA);
47
48 /**
49 * ad_sd_write_reg() - Write a register
50 *
51 * @sigma_delta: The sigma delta device
52 * @reg: Address of the register
53 * @size: Size of the register (0-3)
54 * @val: Value to write to the register
55 *
56 * Returns 0 on success, an error code otherwise.
57 **/
ad_sd_write_reg(struct ad_sigma_delta * sigma_delta,unsigned int reg,unsigned int size,unsigned int val)58 int ad_sd_write_reg(struct ad_sigma_delta *sigma_delta, unsigned int reg,
59 unsigned int size, unsigned int val)
60 {
61 uint8_t *data = sigma_delta->tx_buf;
62 struct spi_transfer t = {
63 .tx_buf = data,
64 .len = size + 1,
65 .cs_change = sigma_delta->keep_cs_asserted,
66 };
67 struct spi_message m;
68 int ret;
69
70 data[0] = (reg << sigma_delta->info->addr_shift) | sigma_delta->comm;
71
72 switch (size) {
73 case 3:
74 put_unaligned_be24(val, &data[1]);
75 break;
76 case 2:
77 put_unaligned_be16(val, &data[1]);
78 break;
79 case 1:
80 data[1] = val;
81 break;
82 case 0:
83 break;
84 default:
85 return -EINVAL;
86 }
87
88 spi_message_init(&m);
89 spi_message_add_tail(&t, &m);
90
91 if (sigma_delta->bus_locked)
92 ret = spi_sync_locked(sigma_delta->spi, &m);
93 else
94 ret = spi_sync(sigma_delta->spi, &m);
95
96 return ret;
97 }
98 EXPORT_SYMBOL_NS_GPL(ad_sd_write_reg, IIO_AD_SIGMA_DELTA);
99
ad_sd_read_reg_raw(struct ad_sigma_delta * sigma_delta,unsigned int reg,unsigned int size,uint8_t * val)100 static int ad_sd_read_reg_raw(struct ad_sigma_delta *sigma_delta,
101 unsigned int reg, unsigned int size, uint8_t *val)
102 {
103 uint8_t *data = sigma_delta->tx_buf;
104 int ret;
105 struct spi_transfer t[] = {
106 {
107 .tx_buf = data,
108 .len = 1,
109 }, {
110 .rx_buf = val,
111 .len = size,
112 .cs_change = sigma_delta->bus_locked,
113 },
114 };
115 struct spi_message m;
116
117 spi_message_init(&m);
118
119 if (sigma_delta->info->has_registers) {
120 data[0] = reg << sigma_delta->info->addr_shift;
121 data[0] |= sigma_delta->info->read_mask;
122 data[0] |= sigma_delta->comm;
123 spi_message_add_tail(&t[0], &m);
124 }
125 spi_message_add_tail(&t[1], &m);
126
127 if (sigma_delta->bus_locked)
128 ret = spi_sync_locked(sigma_delta->spi, &m);
129 else
130 ret = spi_sync(sigma_delta->spi, &m);
131
132 return ret;
133 }
134
135 /**
136 * ad_sd_read_reg() - Read a register
137 *
138 * @sigma_delta: The sigma delta device
139 * @reg: Address of the register
140 * @size: Size of the register (1-4)
141 * @val: Read value
142 *
143 * Returns 0 on success, an error code otherwise.
144 **/
ad_sd_read_reg(struct ad_sigma_delta * sigma_delta,unsigned int reg,unsigned int size,unsigned int * val)145 int ad_sd_read_reg(struct ad_sigma_delta *sigma_delta,
146 unsigned int reg, unsigned int size, unsigned int *val)
147 {
148 int ret;
149
150 ret = ad_sd_read_reg_raw(sigma_delta, reg, size, sigma_delta->rx_buf);
151 if (ret < 0)
152 goto out;
153
154 switch (size) {
155 case 4:
156 *val = get_unaligned_be32(sigma_delta->rx_buf);
157 break;
158 case 3:
159 *val = get_unaligned_be24(sigma_delta->rx_buf);
160 break;
161 case 2:
162 *val = get_unaligned_be16(sigma_delta->rx_buf);
163 break;
164 case 1:
165 *val = sigma_delta->rx_buf[0];
166 break;
167 default:
168 ret = -EINVAL;
169 break;
170 }
171
172 out:
173 return ret;
174 }
175 EXPORT_SYMBOL_NS_GPL(ad_sd_read_reg, IIO_AD_SIGMA_DELTA);
176
177 /**
178 * ad_sd_reset() - Reset the serial interface
179 *
180 * @sigma_delta: The sigma delta device
181 * @reset_length: Number of SCLKs with DIN = 1
182 *
183 * Returns 0 on success, an error code otherwise.
184 **/
ad_sd_reset(struct ad_sigma_delta * sigma_delta,unsigned int reset_length)185 int ad_sd_reset(struct ad_sigma_delta *sigma_delta,
186 unsigned int reset_length)
187 {
188 uint8_t *buf;
189 unsigned int size;
190 int ret;
191
192 size = DIV_ROUND_UP(reset_length, 8);
193 buf = kcalloc(size, sizeof(*buf), GFP_KERNEL);
194 if (!buf)
195 return -ENOMEM;
196
197 memset(buf, 0xff, size);
198 ret = spi_write(sigma_delta->spi, buf, size);
199 kfree(buf);
200
201 return ret;
202 }
203 EXPORT_SYMBOL_NS_GPL(ad_sd_reset, IIO_AD_SIGMA_DELTA);
204
ad_sd_calibrate(struct ad_sigma_delta * sigma_delta,unsigned int mode,unsigned int channel)205 int ad_sd_calibrate(struct ad_sigma_delta *sigma_delta,
206 unsigned int mode, unsigned int channel)
207 {
208 int ret;
209 unsigned long time_left;
210
211 ret = ad_sigma_delta_set_channel(sigma_delta, channel);
212 if (ret)
213 return ret;
214
215 spi_bus_lock(sigma_delta->spi->controller);
216 sigma_delta->bus_locked = true;
217 sigma_delta->keep_cs_asserted = true;
218 reinit_completion(&sigma_delta->completion);
219
220 ret = ad_sigma_delta_set_mode(sigma_delta, mode);
221 if (ret < 0)
222 goto out;
223
224 sigma_delta->irq_dis = false;
225 enable_irq(sigma_delta->irq_line);
226 time_left = wait_for_completion_timeout(&sigma_delta->completion, 2 * HZ);
227 if (time_left == 0) {
228 sigma_delta->irq_dis = true;
229 disable_irq_nosync(sigma_delta->irq_line);
230 ret = -EIO;
231 } else {
232 ret = 0;
233 }
234 out:
235 sigma_delta->keep_cs_asserted = false;
236 ad_sigma_delta_set_mode(sigma_delta, AD_SD_MODE_IDLE);
237 sigma_delta->bus_locked = false;
238 spi_bus_unlock(sigma_delta->spi->controller);
239
240 return ret;
241 }
242 EXPORT_SYMBOL_NS_GPL(ad_sd_calibrate, IIO_AD_SIGMA_DELTA);
243
244 /**
245 * ad_sd_calibrate_all() - Performs channel calibration
246 * @sigma_delta: The sigma delta device
247 * @cb: Array of channels and calibration type to perform
248 * @n: Number of items in cb
249 *
250 * Returns 0 on success, an error code otherwise.
251 **/
ad_sd_calibrate_all(struct ad_sigma_delta * sigma_delta,const struct ad_sd_calib_data * cb,unsigned int n)252 int ad_sd_calibrate_all(struct ad_sigma_delta *sigma_delta,
253 const struct ad_sd_calib_data *cb, unsigned int n)
254 {
255 unsigned int i;
256 int ret;
257
258 for (i = 0; i < n; i++) {
259 ret = ad_sd_calibrate(sigma_delta, cb[i].mode, cb[i].channel);
260 if (ret)
261 return ret;
262 }
263
264 return 0;
265 }
266 EXPORT_SYMBOL_NS_GPL(ad_sd_calibrate_all, IIO_AD_SIGMA_DELTA);
267
268 /**
269 * ad_sigma_delta_single_conversion() - Performs a single data conversion
270 * @indio_dev: The IIO device
271 * @chan: The conversion is done for this channel
272 * @val: Pointer to the location where to store the read value
273 *
274 * Returns: 0 on success, an error value otherwise.
275 */
ad_sigma_delta_single_conversion(struct iio_dev * indio_dev,const struct iio_chan_spec * chan,int * val)276 int ad_sigma_delta_single_conversion(struct iio_dev *indio_dev,
277 const struct iio_chan_spec *chan, int *val)
278 {
279 struct ad_sigma_delta *sigma_delta = iio_device_get_drvdata(indio_dev);
280 unsigned int sample, raw_sample;
281 unsigned int data_reg;
282 int ret = 0;
283
284 ret = iio_device_claim_direct_mode(indio_dev);
285 if (ret)
286 return ret;
287
288 ad_sigma_delta_set_channel(sigma_delta, chan->address);
289
290 spi_bus_lock(sigma_delta->spi->controller);
291 sigma_delta->bus_locked = true;
292 sigma_delta->keep_cs_asserted = true;
293 reinit_completion(&sigma_delta->completion);
294
295 ad_sigma_delta_set_mode(sigma_delta, AD_SD_MODE_SINGLE);
296
297 sigma_delta->irq_dis = false;
298 enable_irq(sigma_delta->irq_line);
299 ret = wait_for_completion_interruptible_timeout(
300 &sigma_delta->completion, HZ);
301
302 if (ret == 0)
303 ret = -EIO;
304 if (ret < 0)
305 goto out;
306
307 if (sigma_delta->info->data_reg != 0)
308 data_reg = sigma_delta->info->data_reg;
309 else
310 data_reg = AD_SD_REG_DATA;
311
312 ret = ad_sd_read_reg(sigma_delta, data_reg,
313 DIV_ROUND_UP(chan->scan_type.realbits + chan->scan_type.shift, 8),
314 &raw_sample);
315
316 out:
317 if (!sigma_delta->irq_dis) {
318 disable_irq_nosync(sigma_delta->irq_line);
319 sigma_delta->irq_dis = true;
320 }
321
322 sigma_delta->keep_cs_asserted = false;
323 ad_sigma_delta_set_mode(sigma_delta, AD_SD_MODE_IDLE);
324 ad_sigma_delta_disable_one(sigma_delta, chan->address);
325 sigma_delta->bus_locked = false;
326 spi_bus_unlock(sigma_delta->spi->controller);
327 iio_device_release_direct_mode(indio_dev);
328
329 if (ret)
330 return ret;
331
332 sample = raw_sample >> chan->scan_type.shift;
333 sample &= (1 << chan->scan_type.realbits) - 1;
334 *val = sample;
335
336 ret = ad_sigma_delta_postprocess_sample(sigma_delta, raw_sample);
337 if (ret)
338 return ret;
339
340 return IIO_VAL_INT;
341 }
342 EXPORT_SYMBOL_NS_GPL(ad_sigma_delta_single_conversion, IIO_AD_SIGMA_DELTA);
343
ad_sd_buffer_postenable(struct iio_dev * indio_dev)344 static int ad_sd_buffer_postenable(struct iio_dev *indio_dev)
345 {
346 struct ad_sigma_delta *sigma_delta = iio_device_get_drvdata(indio_dev);
347 unsigned int i, slot, samples_buf_size;
348 unsigned int channel;
349 uint8_t *samples_buf;
350 int ret;
351
352 if (sigma_delta->num_slots == 1) {
353 channel = find_first_bit(indio_dev->active_scan_mask,
354 iio_get_masklength(indio_dev));
355 ret = ad_sigma_delta_set_channel(sigma_delta,
356 indio_dev->channels[channel].address);
357 if (ret)
358 return ret;
359 slot = 1;
360 } else {
361 /*
362 * At this point update_scan_mode already enabled the required channels.
363 * For sigma-delta sequencer drivers with multiple slots, an update_scan_mode
364 * implementation is mandatory.
365 */
366 slot = 0;
367 iio_for_each_active_channel(indio_dev, i) {
368 sigma_delta->slots[slot] = indio_dev->channels[i].address;
369 slot++;
370 }
371 }
372
373 sigma_delta->active_slots = slot;
374 sigma_delta->current_slot = 0;
375
376 if (sigma_delta->active_slots > 1) {
377 ret = ad_sigma_delta_append_status(sigma_delta, true);
378 if (ret)
379 return ret;
380 }
381
382 samples_buf_size = ALIGN(slot * indio_dev->channels[0].scan_type.storagebits / 8, 8);
383 samples_buf_size += sizeof(int64_t);
384 samples_buf = devm_krealloc(&sigma_delta->spi->dev, sigma_delta->samples_buf,
385 samples_buf_size, GFP_KERNEL);
386 if (!samples_buf)
387 return -ENOMEM;
388
389 sigma_delta->samples_buf = samples_buf;
390
391 spi_bus_lock(sigma_delta->spi->controller);
392 sigma_delta->bus_locked = true;
393 sigma_delta->keep_cs_asserted = true;
394
395 ret = ad_sigma_delta_set_mode(sigma_delta, AD_SD_MODE_CONTINUOUS);
396 if (ret)
397 goto err_unlock;
398
399 sigma_delta->irq_dis = false;
400 enable_irq(sigma_delta->irq_line);
401
402 return 0;
403
404 err_unlock:
405 spi_bus_unlock(sigma_delta->spi->controller);
406
407 return ret;
408 }
409
ad_sd_buffer_predisable(struct iio_dev * indio_dev)410 static int ad_sd_buffer_predisable(struct iio_dev *indio_dev)
411 {
412 struct ad_sigma_delta *sigma_delta = iio_device_get_drvdata(indio_dev);
413
414 reinit_completion(&sigma_delta->completion);
415 wait_for_completion_timeout(&sigma_delta->completion, HZ);
416
417 if (!sigma_delta->irq_dis) {
418 disable_irq_nosync(sigma_delta->irq_line);
419 sigma_delta->irq_dis = true;
420 }
421
422 sigma_delta->keep_cs_asserted = false;
423 ad_sigma_delta_set_mode(sigma_delta, AD_SD_MODE_IDLE);
424
425 if (sigma_delta->status_appended)
426 ad_sigma_delta_append_status(sigma_delta, false);
427
428 ad_sigma_delta_disable_all(sigma_delta);
429 sigma_delta->bus_locked = false;
430 return spi_bus_unlock(sigma_delta->spi->controller);
431 }
432
ad_sd_trigger_handler(int irq,void * p)433 static irqreturn_t ad_sd_trigger_handler(int irq, void *p)
434 {
435 struct iio_poll_func *pf = p;
436 struct iio_dev *indio_dev = pf->indio_dev;
437 struct ad_sigma_delta *sigma_delta = iio_device_get_drvdata(indio_dev);
438 uint8_t *data = sigma_delta->rx_buf;
439 unsigned int transfer_size;
440 unsigned int sample_size;
441 unsigned int sample_pos;
442 unsigned int status_pos;
443 unsigned int reg_size;
444 unsigned int data_reg;
445
446 reg_size = indio_dev->channels[0].scan_type.realbits +
447 indio_dev->channels[0].scan_type.shift;
448 reg_size = DIV_ROUND_UP(reg_size, 8);
449
450 if (sigma_delta->info->data_reg != 0)
451 data_reg = sigma_delta->info->data_reg;
452 else
453 data_reg = AD_SD_REG_DATA;
454
455 /* Status word will be appended to the sample during transfer */
456 if (sigma_delta->status_appended)
457 transfer_size = reg_size + 1;
458 else
459 transfer_size = reg_size;
460
461 switch (reg_size) {
462 case 4:
463 case 2:
464 case 1:
465 status_pos = reg_size;
466 ad_sd_read_reg_raw(sigma_delta, data_reg, transfer_size, &data[0]);
467 break;
468 case 3:
469 /*
470 * Data array after transfer will look like (if status is appended):
471 * data[] = { [0][sample][sample][sample][status] }
472 * Keeping the first byte 0 shifts the status postion by 1 byte to the right.
473 */
474 status_pos = reg_size + 1;
475
476 /* We store 24 bit samples in a 32 bit word. Keep the upper
477 * byte set to zero. */
478 ad_sd_read_reg_raw(sigma_delta, data_reg, transfer_size, &data[1]);
479 break;
480
481 default:
482 dev_err_ratelimited(&indio_dev->dev, "Unsupported reg_size: %u\n", reg_size);
483 goto irq_handled;
484 }
485
486 /*
487 * For devices sampling only one channel at
488 * once, there is no need for sample number tracking.
489 */
490 if (sigma_delta->active_slots == 1) {
491 iio_push_to_buffers_with_timestamp(indio_dev, data, pf->timestamp);
492 goto irq_handled;
493 }
494
495 if (sigma_delta->status_appended) {
496 u8 converted_channel;
497
498 converted_channel = data[status_pos] & sigma_delta->info->status_ch_mask;
499 if (converted_channel != sigma_delta->slots[sigma_delta->current_slot]) {
500 /*
501 * Desync occurred during continuous sampling of multiple channels.
502 * Drop this incomplete sample and start from first channel again.
503 */
504
505 sigma_delta->current_slot = 0;
506 goto irq_handled;
507 }
508 }
509
510 sample_size = indio_dev->channels[0].scan_type.storagebits / 8;
511 sample_pos = sample_size * sigma_delta->current_slot;
512 memcpy(&sigma_delta->samples_buf[sample_pos], data, sample_size);
513 sigma_delta->current_slot++;
514
515 if (sigma_delta->current_slot == sigma_delta->active_slots) {
516 sigma_delta->current_slot = 0;
517 iio_push_to_buffers_with_timestamp(indio_dev, sigma_delta->samples_buf,
518 pf->timestamp);
519 }
520
521 irq_handled:
522 iio_trigger_notify_done(indio_dev->trig);
523 sigma_delta->irq_dis = false;
524 enable_irq(sigma_delta->irq_line);
525
526 return IRQ_HANDLED;
527 }
528
ad_sd_validate_scan_mask(struct iio_dev * indio_dev,const unsigned long * mask)529 static bool ad_sd_validate_scan_mask(struct iio_dev *indio_dev, const unsigned long *mask)
530 {
531 struct ad_sigma_delta *sigma_delta = iio_device_get_drvdata(indio_dev);
532
533 return bitmap_weight(mask, iio_get_masklength(indio_dev)) <= sigma_delta->num_slots;
534 }
535
536 static const struct iio_buffer_setup_ops ad_sd_buffer_setup_ops = {
537 .postenable = &ad_sd_buffer_postenable,
538 .predisable = &ad_sd_buffer_predisable,
539 .validate_scan_mask = &ad_sd_validate_scan_mask,
540 };
541
ad_sd_data_rdy_trig_poll(int irq,void * private)542 static irqreturn_t ad_sd_data_rdy_trig_poll(int irq, void *private)
543 {
544 struct ad_sigma_delta *sigma_delta = private;
545
546 complete(&sigma_delta->completion);
547 disable_irq_nosync(irq);
548 sigma_delta->irq_dis = true;
549 iio_trigger_poll(sigma_delta->trig);
550
551 return IRQ_HANDLED;
552 }
553
554 /**
555 * ad_sd_validate_trigger() - validate_trigger callback for ad_sigma_delta devices
556 * @indio_dev: The IIO device
557 * @trig: The new trigger
558 *
559 * Returns: 0 if the 'trig' matches the trigger registered by the ad_sigma_delta
560 * device, -EINVAL otherwise.
561 */
ad_sd_validate_trigger(struct iio_dev * indio_dev,struct iio_trigger * trig)562 int ad_sd_validate_trigger(struct iio_dev *indio_dev, struct iio_trigger *trig)
563 {
564 struct ad_sigma_delta *sigma_delta = iio_device_get_drvdata(indio_dev);
565
566 if (sigma_delta->trig != trig)
567 return -EINVAL;
568
569 return 0;
570 }
571 EXPORT_SYMBOL_NS_GPL(ad_sd_validate_trigger, IIO_AD_SIGMA_DELTA);
572
devm_ad_sd_probe_trigger(struct device * dev,struct iio_dev * indio_dev)573 static int devm_ad_sd_probe_trigger(struct device *dev, struct iio_dev *indio_dev)
574 {
575 struct ad_sigma_delta *sigma_delta = iio_device_get_drvdata(indio_dev);
576 unsigned long irq_flags = irq_get_trigger_type(sigma_delta->irq_line);
577 int ret;
578
579 if (dev != &sigma_delta->spi->dev) {
580 dev_err(dev, "Trigger parent should be '%s', got '%s'\n",
581 dev_name(dev), dev_name(&sigma_delta->spi->dev));
582 return -EFAULT;
583 }
584
585 sigma_delta->trig = devm_iio_trigger_alloc(dev, "%s-dev%d", indio_dev->name,
586 iio_device_id(indio_dev));
587 if (sigma_delta->trig == NULL)
588 return -ENOMEM;
589
590 init_completion(&sigma_delta->completion);
591
592 sigma_delta->irq_dis = true;
593
594 /* the IRQ core clears IRQ_DISABLE_UNLAZY flag when freeing an IRQ */
595 irq_set_status_flags(sigma_delta->irq_line, IRQ_DISABLE_UNLAZY);
596
597 /* Allow overwriting the flags from firmware */
598 if (!irq_flags)
599 irq_flags = sigma_delta->info->irq_flags;
600
601 ret = devm_request_irq(dev, sigma_delta->irq_line,
602 ad_sd_data_rdy_trig_poll,
603 irq_flags | IRQF_NO_AUTOEN,
604 indio_dev->name,
605 sigma_delta);
606 if (ret)
607 return ret;
608
609 iio_trigger_set_drvdata(sigma_delta->trig, sigma_delta);
610
611 ret = devm_iio_trigger_register(dev, sigma_delta->trig);
612 if (ret)
613 return ret;
614
615 /* select default trigger */
616 indio_dev->trig = iio_trigger_get(sigma_delta->trig);
617
618 return 0;
619 }
620
621 /**
622 * devm_ad_sd_setup_buffer_and_trigger() - Device-managed buffer & trigger setup
623 * @dev: Device object to which to bind the life-time of the resources attached
624 * @indio_dev: The IIO device
625 */
devm_ad_sd_setup_buffer_and_trigger(struct device * dev,struct iio_dev * indio_dev)626 int devm_ad_sd_setup_buffer_and_trigger(struct device *dev, struct iio_dev *indio_dev)
627 {
628 struct ad_sigma_delta *sigma_delta = iio_device_get_drvdata(indio_dev);
629 int ret;
630
631 sigma_delta->slots = devm_kcalloc(dev, sigma_delta->num_slots,
632 sizeof(*sigma_delta->slots), GFP_KERNEL);
633 if (!sigma_delta->slots)
634 return -ENOMEM;
635
636 ret = devm_iio_triggered_buffer_setup(dev, indio_dev,
637 &iio_pollfunc_store_time,
638 &ad_sd_trigger_handler,
639 &ad_sd_buffer_setup_ops);
640 if (ret)
641 return ret;
642
643 return devm_ad_sd_probe_trigger(dev, indio_dev);
644 }
645 EXPORT_SYMBOL_NS_GPL(devm_ad_sd_setup_buffer_and_trigger, IIO_AD_SIGMA_DELTA);
646
647 /**
648 * ad_sd_init() - Initializes a ad_sigma_delta struct
649 * @sigma_delta: The ad_sigma_delta device
650 * @indio_dev: The IIO device which the Sigma Delta device is used for
651 * @spi: The SPI device for the ad_sigma_delta device
652 * @info: Device specific callbacks and options
653 *
654 * This function needs to be called before any other operations are performed on
655 * the ad_sigma_delta struct.
656 */
ad_sd_init(struct ad_sigma_delta * sigma_delta,struct iio_dev * indio_dev,struct spi_device * spi,const struct ad_sigma_delta_info * info)657 int ad_sd_init(struct ad_sigma_delta *sigma_delta, struct iio_dev *indio_dev,
658 struct spi_device *spi, const struct ad_sigma_delta_info *info)
659 {
660 sigma_delta->spi = spi;
661 sigma_delta->info = info;
662
663 /* If the field is unset in ad_sigma_delta_info, asume there can only be 1 slot. */
664 if (!info->num_slots)
665 sigma_delta->num_slots = 1;
666 else
667 sigma_delta->num_slots = info->num_slots;
668
669 if (sigma_delta->num_slots > 1) {
670 if (!indio_dev->info->update_scan_mode) {
671 dev_err(&spi->dev, "iio_dev lacks update_scan_mode().\n");
672 return -EINVAL;
673 }
674
675 if (!info->disable_all) {
676 dev_err(&spi->dev, "ad_sigma_delta_info lacks disable_all().\n");
677 return -EINVAL;
678 }
679 }
680
681 if (info->irq_line)
682 sigma_delta->irq_line = info->irq_line;
683 else
684 sigma_delta->irq_line = spi->irq;
685
686 iio_device_set_drvdata(indio_dev, sigma_delta);
687
688 return 0;
689 }
690 EXPORT_SYMBOL_NS_GPL(ad_sd_init, IIO_AD_SIGMA_DELTA);
691
692 MODULE_AUTHOR("Lars-Peter Clausen <lars@metafoo.de>");
693 MODULE_DESCRIPTION("Analog Devices Sigma-Delta ADCs");
694 MODULE_LICENSE("GPL v2");
695