Loading...
1// SPDX-License-Identifier: GPL-2.0-only
2/* The industrial I/O core in kernel channel mapping
3 *
4 * Copyright (c) 2011 Jonathan Cameron
5 */
6#include <linux/cleanup.h>
7#include <linux/err.h>
8#include <linux/export.h>
9#include <linux/minmax.h>
10#include <linux/mutex.h>
11#include <linux/property.h>
12#include <linux/slab.h>
13
14#include <linux/iio/iio.h>
15#include <linux/iio/iio-opaque.h>
16#include "iio_core.h"
17#include <linux/iio/machine.h>
18#include <linux/iio/driver.h>
19#include <linux/iio/consumer.h>
20
21struct iio_map_internal {
22 struct iio_dev *indio_dev;
23 const struct iio_map *map;
24 struct list_head l;
25};
26
27static LIST_HEAD(iio_map_list);
28static DEFINE_MUTEX(iio_map_list_lock);
29
30static int iio_map_array_unregister_locked(struct iio_dev *indio_dev)
31{
32 int ret = -ENODEV;
33 struct iio_map_internal *mapi, *next;
34
35 list_for_each_entry_safe(mapi, next, &iio_map_list, l) {
36 if (indio_dev == mapi->indio_dev) {
37 list_del(&mapi->l);
38 kfree(mapi);
39 ret = 0;
40 }
41 }
42 return ret;
43}
44
45int iio_map_array_register(struct iio_dev *indio_dev, const struct iio_map *maps)
46{
47 struct iio_map_internal *mapi;
48 int i = 0;
49 int ret;
50
51 if (!maps)
52 return 0;
53
54 guard(mutex)(&iio_map_list_lock);
55 while (maps[i].consumer_dev_name) {
56 mapi = kzalloc(sizeof(*mapi), GFP_KERNEL);
57 if (!mapi) {
58 ret = -ENOMEM;
59 goto error_ret;
60 }
61 mapi->map = &maps[i];
62 mapi->indio_dev = indio_dev;
63 list_add_tail(&mapi->l, &iio_map_list);
64 i++;
65 }
66
67 return 0;
68error_ret:
69 iio_map_array_unregister_locked(indio_dev);
70 return ret;
71}
72EXPORT_SYMBOL_GPL(iio_map_array_register);
73
74/*
75 * Remove all map entries associated with the given iio device
76 */
77int iio_map_array_unregister(struct iio_dev *indio_dev)
78{
79 guard(mutex)(&iio_map_list_lock);
80 return iio_map_array_unregister_locked(indio_dev);
81}
82EXPORT_SYMBOL_GPL(iio_map_array_unregister);
83
84static void iio_map_array_unregister_cb(void *indio_dev)
85{
86 iio_map_array_unregister(indio_dev);
87}
88
89int devm_iio_map_array_register(struct device *dev, struct iio_dev *indio_dev,
90 const struct iio_map *maps)
91{
92 int ret;
93
94 ret = iio_map_array_register(indio_dev, maps);
95 if (ret)
96 return ret;
97
98 return devm_add_action_or_reset(dev, iio_map_array_unregister_cb, indio_dev);
99}
100EXPORT_SYMBOL_GPL(devm_iio_map_array_register);
101
102static const struct iio_chan_spec
103*iio_chan_spec_from_name(const struct iio_dev *indio_dev, const char *name)
104{
105 int i;
106 const struct iio_chan_spec *chan = NULL;
107
108 for (i = 0; i < indio_dev->num_channels; i++)
109 if (indio_dev->channels[i].datasheet_name &&
110 strcmp(name, indio_dev->channels[i].datasheet_name) == 0) {
111 chan = &indio_dev->channels[i];
112 break;
113 }
114 return chan;
115}
116
117/**
118 * __fwnode_iio_simple_xlate - translate iiospec to the IIO channel index
119 * @indio_dev: pointer to the iio_dev structure
120 * @iiospec: IIO specifier as found in the device tree
121 *
122 * This is simple translation function, suitable for the most 1:1 mapped
123 * channels in IIO chips. This function performs only one sanity check:
124 * whether IIO index is less than num_channels (that is specified in the
125 * iio_dev).
126 */
127static int __fwnode_iio_simple_xlate(struct iio_dev *indio_dev,
128 const struct fwnode_reference_args *iiospec)
129{
130 if (!iiospec->nargs)
131 return 0;
132
133 if (iiospec->args[0] >= indio_dev->num_channels) {
134 dev_err(&indio_dev->dev, "invalid channel index %llu\n",
135 iiospec->args[0]);
136 return -EINVAL;
137 }
138
139 return iiospec->args[0];
140}
141
142static int __fwnode_iio_channel_get(struct iio_channel *channel,
143 struct fwnode_handle *fwnode, int index)
144{
145 struct fwnode_reference_args iiospec;
146 struct device *idev;
147 struct iio_dev *indio_dev;
148 int err;
149
150 err = fwnode_property_get_reference_args(fwnode, "io-channels",
151 "#io-channel-cells", 0,
152 index, &iiospec);
153 if (err)
154 return err;
155
156 idev = bus_find_device_by_fwnode(&iio_bus_type, iiospec.fwnode);
157 if (!idev) {
158 fwnode_handle_put(iiospec.fwnode);
159 return -EPROBE_DEFER;
160 }
161
162 indio_dev = dev_to_iio_dev(idev);
163 channel->indio_dev = indio_dev;
164 if (indio_dev->info->fwnode_xlate)
165 index = indio_dev->info->fwnode_xlate(indio_dev, &iiospec);
166 else
167 index = __fwnode_iio_simple_xlate(indio_dev, &iiospec);
168 fwnode_handle_put(iiospec.fwnode);
169 if (index < 0)
170 goto err_put;
171 channel->channel = &indio_dev->channels[index];
172
173 return 0;
174
175err_put:
176 iio_device_put(indio_dev);
177 return index;
178}
179
180static struct iio_channel *fwnode_iio_channel_get(struct fwnode_handle *fwnode,
181 int index)
182{
183 int err;
184
185 if (index < 0)
186 return ERR_PTR(-EINVAL);
187
188 struct iio_channel *channel __free(kfree) =
189 kzalloc(sizeof(*channel), GFP_KERNEL);
190 if (!channel)
191 return ERR_PTR(-ENOMEM);
192
193 err = __fwnode_iio_channel_get(channel, fwnode, index);
194 if (err)
195 return ERR_PTR(err);
196
197 return_ptr(channel);
198}
199
200static struct iio_channel *
201__fwnode_iio_channel_get_by_name(struct fwnode_handle *fwnode, const char *name)
202{
203 struct iio_channel *chan;
204 int index = 0;
205
206 /*
207 * For named iio channels, first look up the name in the
208 * "io-channel-names" property. If it cannot be found, the
209 * index will be an error code, and fwnode_iio_channel_get()
210 * will fail.
211 */
212 if (name)
213 index = fwnode_property_match_string(fwnode, "io-channel-names",
214 name);
215
216 chan = fwnode_iio_channel_get(fwnode, index);
217 if (!IS_ERR(chan) || PTR_ERR(chan) == -EPROBE_DEFER)
218 return chan;
219 if (name) {
220 if (index >= 0) {
221 pr_err("ERROR: could not get IIO channel %pfw:%s(%i)\n",
222 fwnode, name, index);
223 /*
224 * In this case, we found 'name' in 'io-channel-names'
225 * but somehow we still fail so that we should not proceed
226 * with any other lookup. Hence, explicitly return -EINVAL
227 * (maybe not the better error code) so that the caller
228 * won't do a system lookup.
229 */
230 return ERR_PTR(-EINVAL);
231 }
232 /*
233 * If index < 0, then fwnode_property_get_reference_args() fails
234 * with -EINVAL or -ENOENT (ACPI case) which is expected. We
235 * should not proceed if we get any other error.
236 */
237 if (PTR_ERR(chan) != -EINVAL && PTR_ERR(chan) != -ENOENT)
238 return chan;
239 } else if (PTR_ERR(chan) != -ENOENT) {
240 /*
241 * if !name, then we should only proceed the lookup if
242 * fwnode_property_get_reference_args() returns -ENOENT.
243 */
244 return chan;
245 }
246
247 /* so we continue the lookup */
248 return ERR_PTR(-ENODEV);
249}
250
251struct iio_channel *fwnode_iio_channel_get_by_name(struct fwnode_handle *fwnode,
252 const char *name)
253{
254 struct fwnode_handle *parent;
255 struct iio_channel *chan;
256
257 /* Walk up the tree of devices looking for a matching iio channel */
258 chan = __fwnode_iio_channel_get_by_name(fwnode, name);
259 if (!IS_ERR(chan) || PTR_ERR(chan) != -ENODEV)
260 return chan;
261
262 /*
263 * No matching IIO channel found on this node.
264 * If the parent node has a "io-channel-ranges" property,
265 * then we can try one of its channels.
266 */
267 fwnode_for_each_parent_node(fwnode, parent) {
268 if (!fwnode_property_present(parent, "io-channel-ranges")) {
269 fwnode_handle_put(parent);
270 return ERR_PTR(-ENODEV);
271 }
272
273 chan = __fwnode_iio_channel_get_by_name(parent, name);
274 if (!IS_ERR(chan) || PTR_ERR(chan) != -ENODEV) {
275 fwnode_handle_put(parent);
276 return chan;
277 }
278 }
279
280 return ERR_PTR(-ENODEV);
281}
282EXPORT_SYMBOL_GPL(fwnode_iio_channel_get_by_name);
283
284static struct iio_channel *fwnode_iio_channel_get_all(struct device *dev)
285{
286 struct fwnode_handle *fwnode = dev_fwnode(dev);
287 int i, mapind, nummaps = 0;
288 int ret;
289
290 do {
291 ret = fwnode_property_get_reference_args(fwnode, "io-channels",
292 "#io-channel-cells", 0,
293 nummaps, NULL);
294 if (ret < 0)
295 break;
296 } while (++nummaps);
297
298 if (nummaps == 0)
299 return ERR_PTR(-ENODEV);
300
301 /* NULL terminated array to save passing size */
302 struct iio_channel *chans __free(kfree) =
303 kcalloc(nummaps + 1, sizeof(*chans), GFP_KERNEL);
304 if (!chans)
305 return ERR_PTR(-ENOMEM);
306
307 /* Search for FW matches */
308 for (mapind = 0; mapind < nummaps; mapind++) {
309 ret = __fwnode_iio_channel_get(&chans[mapind], fwnode, mapind);
310 if (ret)
311 goto error_free_chans;
312 }
313 return_ptr(chans);
314
315error_free_chans:
316 for (i = 0; i < mapind; i++)
317 iio_device_put(chans[i].indio_dev);
318 return ERR_PTR(ret);
319}
320
321static struct iio_channel *iio_channel_get_sys(const char *name,
322 const char *channel_name)
323{
324 struct iio_map_internal *c_i = NULL, *c = NULL;
325 int err;
326
327 if (!(name || channel_name))
328 return ERR_PTR(-ENODEV);
329
330 /* first find matching entry the channel map */
331 scoped_guard(mutex, &iio_map_list_lock) {
332 list_for_each_entry(c_i, &iio_map_list, l) {
333 if ((name && strcmp(name, c_i->map->consumer_dev_name) != 0) ||
334 (channel_name &&
335 strcmp(channel_name, c_i->map->consumer_channel) != 0))
336 continue;
337 c = c_i;
338 iio_device_get(c->indio_dev);
339 break;
340 }
341 }
342 if (!c)
343 return ERR_PTR(-ENODEV);
344
345 struct iio_channel *channel __free(kfree) =
346 kzalloc(sizeof(*channel), GFP_KERNEL);
347 if (!channel) {
348 err = -ENOMEM;
349 goto error_no_mem;
350 }
351
352 channel->indio_dev = c->indio_dev;
353
354 if (c->map->adc_channel_label) {
355 channel->channel =
356 iio_chan_spec_from_name(channel->indio_dev,
357 c->map->adc_channel_label);
358
359 if (!channel->channel) {
360 err = -EINVAL;
361 goto error_no_mem;
362 }
363 }
364
365 return_ptr(channel);
366
367error_no_mem:
368 iio_device_put(c->indio_dev);
369 return ERR_PTR(err);
370}
371
372struct iio_channel *iio_channel_get(struct device *dev,
373 const char *channel_name)
374{
375 const char *name = dev ? dev_name(dev) : NULL;
376 struct iio_channel *channel;
377
378 if (dev) {
379 channel = fwnode_iio_channel_get_by_name(dev_fwnode(dev),
380 channel_name);
381 if (!IS_ERR(channel) || PTR_ERR(channel) != -ENODEV)
382 return channel;
383 }
384
385 return iio_channel_get_sys(name, channel_name);
386}
387EXPORT_SYMBOL_GPL(iio_channel_get);
388
389void iio_channel_release(struct iio_channel *channel)
390{
391 if (!channel)
392 return;
393 iio_device_put(channel->indio_dev);
394 kfree(channel);
395}
396EXPORT_SYMBOL_GPL(iio_channel_release);
397
398static void devm_iio_channel_free(void *iio_channel)
399{
400 iio_channel_release(iio_channel);
401}
402
403struct iio_channel *devm_iio_channel_get(struct device *dev,
404 const char *channel_name)
405{
406 struct iio_channel *channel;
407 int ret;
408
409 channel = iio_channel_get(dev, channel_name);
410 if (IS_ERR(channel))
411 return channel;
412
413 ret = devm_add_action_or_reset(dev, devm_iio_channel_free, channel);
414 if (ret)
415 return ERR_PTR(ret);
416
417 return channel;
418}
419EXPORT_SYMBOL_GPL(devm_iio_channel_get);
420
421struct iio_channel *devm_fwnode_iio_channel_get_by_name(struct device *dev,
422 struct fwnode_handle *fwnode,
423 const char *channel_name)
424{
425 struct iio_channel *channel;
426 int ret;
427
428 channel = fwnode_iio_channel_get_by_name(fwnode, channel_name);
429 if (IS_ERR(channel))
430 return channel;
431
432 ret = devm_add_action_or_reset(dev, devm_iio_channel_free, channel);
433 if (ret)
434 return ERR_PTR(ret);
435
436 return channel;
437}
438EXPORT_SYMBOL_GPL(devm_fwnode_iio_channel_get_by_name);
439
440struct iio_channel *iio_channel_get_all(struct device *dev)
441{
442 const char *name;
443 struct iio_map_internal *c = NULL;
444 struct iio_channel *fw_chans;
445 int nummaps = 0;
446 int mapind = 0;
447 int i, ret;
448
449 if (!dev)
450 return ERR_PTR(-EINVAL);
451
452 fw_chans = fwnode_iio_channel_get_all(dev);
453 /*
454 * We only want to carry on if the error is -ENODEV. Anything else
455 * should be reported up the stack.
456 */
457 if (!IS_ERR(fw_chans) || PTR_ERR(fw_chans) != -ENODEV)
458 return fw_chans;
459
460 name = dev_name(dev);
461
462 guard(mutex)(&iio_map_list_lock);
463 /* first count the matching maps */
464 list_for_each_entry(c, &iio_map_list, l)
465 if (name && strcmp(name, c->map->consumer_dev_name) != 0)
466 continue;
467 else
468 nummaps++;
469
470 if (nummaps == 0)
471 return ERR_PTR(-ENODEV);
472
473 /* NULL terminated array to save passing size */
474 struct iio_channel *chans __free(kfree) =
475 kcalloc(nummaps + 1, sizeof(*chans), GFP_KERNEL);
476 if (!chans)
477 return ERR_PTR(-ENOMEM);
478
479 /* for each map fill in the chans element */
480 list_for_each_entry(c, &iio_map_list, l) {
481 if (name && strcmp(name, c->map->consumer_dev_name) != 0)
482 continue;
483 chans[mapind].indio_dev = c->indio_dev;
484 chans[mapind].data = c->map->consumer_data;
485 chans[mapind].channel =
486 iio_chan_spec_from_name(chans[mapind].indio_dev,
487 c->map->adc_channel_label);
488 if (!chans[mapind].channel) {
489 ret = -EINVAL;
490 goto error_free_chans;
491 }
492 iio_device_get(chans[mapind].indio_dev);
493 mapind++;
494 }
495 if (mapind == 0) {
496 ret = -ENODEV;
497 goto error_free_chans;
498 }
499
500 return_ptr(chans);
501
502error_free_chans:
503 for (i = 0; i < mapind; i++)
504 iio_device_put(chans[i].indio_dev);
505 return ERR_PTR(ret);
506}
507EXPORT_SYMBOL_GPL(iio_channel_get_all);
508
509void iio_channel_release_all(struct iio_channel *channels)
510{
511 struct iio_channel *chan = &channels[0];
512
513 while (chan->indio_dev) {
514 iio_device_put(chan->indio_dev);
515 chan++;
516 }
517 kfree(channels);
518}
519EXPORT_SYMBOL_GPL(iio_channel_release_all);
520
521static void devm_iio_channel_free_all(void *iio_channels)
522{
523 iio_channel_release_all(iio_channels);
524}
525
526struct iio_channel *devm_iio_channel_get_all(struct device *dev)
527{
528 struct iio_channel *channels;
529 int ret;
530
531 channels = iio_channel_get_all(dev);
532 if (IS_ERR(channels))
533 return channels;
534
535 ret = devm_add_action_or_reset(dev, devm_iio_channel_free_all,
536 channels);
537 if (ret)
538 return ERR_PTR(ret);
539
540 return channels;
541}
542EXPORT_SYMBOL_GPL(devm_iio_channel_get_all);
543
544static int iio_channel_read(struct iio_channel *chan, int *val, int *val2,
545 enum iio_chan_info_enum info)
546{
547 const struct iio_info *iio_info = chan->indio_dev->info;
548 int unused;
549 int vals[INDIO_MAX_RAW_ELEMENTS];
550 int ret;
551 int val_len = 2;
552
553 if (!val2)
554 val2 = &unused;
555
556 if (!iio_channel_has_info(chan->channel, info))
557 return -EINVAL;
558
559 if (iio_info->read_raw_multi) {
560 ret = iio_info->read_raw_multi(chan->indio_dev,
561 chan->channel,
562 INDIO_MAX_RAW_ELEMENTS,
563 vals, &val_len, info);
564 *val = vals[0];
565 *val2 = vals[1];
566 } else if (iio_info->read_raw) {
567 ret = iio_info->read_raw(chan->indio_dev,
568 chan->channel, val, val2, info);
569 } else {
570 return -EINVAL;
571 }
572
573 return ret;
574}
575
576int iio_read_channel_raw(struct iio_channel *chan, int *val)
577{
578 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
579
580 guard(mutex)(&iio_dev_opaque->info_exist_lock);
581 if (!chan->indio_dev->info)
582 return -ENODEV;
583
584 return iio_channel_read(chan, val, NULL, IIO_CHAN_INFO_RAW);
585}
586EXPORT_SYMBOL_GPL(iio_read_channel_raw);
587
588int iio_read_channel_average_raw(struct iio_channel *chan, int *val)
589{
590 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
591
592 guard(mutex)(&iio_dev_opaque->info_exist_lock);
593 if (!chan->indio_dev->info)
594 return -ENODEV;
595
596 return iio_channel_read(chan, val, NULL, IIO_CHAN_INFO_AVERAGE_RAW);
597}
598EXPORT_SYMBOL_GPL(iio_read_channel_average_raw);
599
600static int iio_convert_raw_to_processed_unlocked(struct iio_channel *chan,
601 int raw, int *processed,
602 unsigned int scale)
603{
604 int scale_type, scale_val, scale_val2;
605 int offset_type, offset_val, offset_val2;
606 s64 raw64 = raw;
607
608 offset_type = iio_channel_read(chan, &offset_val, &offset_val2,
609 IIO_CHAN_INFO_OFFSET);
610 if (offset_type >= 0) {
611 switch (offset_type) {
612 case IIO_VAL_INT:
613 break;
614 case IIO_VAL_INT_PLUS_MICRO:
615 case IIO_VAL_INT_PLUS_NANO:
616 /*
617 * Both IIO_VAL_INT_PLUS_MICRO and IIO_VAL_INT_PLUS_NANO
618 * implicitely truncate the offset to it's integer form.
619 */
620 break;
621 case IIO_VAL_FRACTIONAL:
622 offset_val /= offset_val2;
623 break;
624 case IIO_VAL_FRACTIONAL_LOG2:
625 offset_val >>= offset_val2;
626 break;
627 default:
628 return -EINVAL;
629 }
630
631 raw64 += offset_val;
632 }
633
634 scale_type = iio_channel_read(chan, &scale_val, &scale_val2,
635 IIO_CHAN_INFO_SCALE);
636 if (scale_type < 0) {
637 /*
638 * If no channel scaling is available apply consumer scale to
639 * raw value and return.
640 */
641 *processed = raw * scale;
642 return 0;
643 }
644
645 switch (scale_type) {
646 case IIO_VAL_INT:
647 *processed = raw64 * scale_val * scale;
648 break;
649 case IIO_VAL_INT_PLUS_MICRO:
650 if (scale_val2 < 0)
651 *processed = -raw64 * scale_val * scale;
652 else
653 *processed = raw64 * scale_val * scale;
654 *processed += div_s64(raw64 * (s64)scale_val2 * scale,
655 1000000LL);
656 break;
657 case IIO_VAL_INT_PLUS_NANO:
658 if (scale_val2 < 0)
659 *processed = -raw64 * scale_val * scale;
660 else
661 *processed = raw64 * scale_val * scale;
662 *processed += div_s64(raw64 * (s64)scale_val2 * scale,
663 1000000000LL);
664 break;
665 case IIO_VAL_FRACTIONAL:
666 *processed = div_s64(raw64 * (s64)scale_val * scale,
667 scale_val2);
668 break;
669 case IIO_VAL_FRACTIONAL_LOG2:
670 *processed = (raw64 * (s64)scale_val * scale) >> scale_val2;
671 break;
672 default:
673 return -EINVAL;
674 }
675
676 return 0;
677}
678
679int iio_convert_raw_to_processed(struct iio_channel *chan, int raw,
680 int *processed, unsigned int scale)
681{
682 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
683
684 guard(mutex)(&iio_dev_opaque->info_exist_lock);
685 if (!chan->indio_dev->info)
686 return -ENODEV;
687
688 return iio_convert_raw_to_processed_unlocked(chan, raw, processed,
689 scale);
690}
691EXPORT_SYMBOL_GPL(iio_convert_raw_to_processed);
692
693int iio_read_channel_attribute(struct iio_channel *chan, int *val, int *val2,
694 enum iio_chan_info_enum attribute)
695{
696 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
697
698 guard(mutex)(&iio_dev_opaque->info_exist_lock);
699 if (!chan->indio_dev->info)
700 return -ENODEV;
701
702 return iio_channel_read(chan, val, val2, attribute);
703}
704EXPORT_SYMBOL_GPL(iio_read_channel_attribute);
705
706int iio_read_channel_offset(struct iio_channel *chan, int *val, int *val2)
707{
708 return iio_read_channel_attribute(chan, val, val2, IIO_CHAN_INFO_OFFSET);
709}
710EXPORT_SYMBOL_GPL(iio_read_channel_offset);
711
712int iio_read_channel_processed_scale(struct iio_channel *chan, int *val,
713 unsigned int scale)
714{
715 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
716 int ret;
717
718 guard(mutex)(&iio_dev_opaque->info_exist_lock);
719 if (!chan->indio_dev->info)
720 return -ENODEV;
721
722 if (iio_channel_has_info(chan->channel, IIO_CHAN_INFO_PROCESSED)) {
723 ret = iio_channel_read(chan, val, NULL,
724 IIO_CHAN_INFO_PROCESSED);
725 if (ret < 0)
726 return ret;
727 *val *= scale;
728
729 return ret;
730 } else {
731 ret = iio_channel_read(chan, val, NULL, IIO_CHAN_INFO_RAW);
732 if (ret < 0)
733 return ret;
734
735 return iio_convert_raw_to_processed_unlocked(chan, *val, val,
736 scale);
737 }
738}
739EXPORT_SYMBOL_GPL(iio_read_channel_processed_scale);
740
741int iio_read_channel_processed(struct iio_channel *chan, int *val)
742{
743 /* This is just a special case with scale factor 1 */
744 return iio_read_channel_processed_scale(chan, val, 1);
745}
746EXPORT_SYMBOL_GPL(iio_read_channel_processed);
747
748int iio_read_channel_scale(struct iio_channel *chan, int *val, int *val2)
749{
750 return iio_read_channel_attribute(chan, val, val2, IIO_CHAN_INFO_SCALE);
751}
752EXPORT_SYMBOL_GPL(iio_read_channel_scale);
753
754static int iio_channel_read_avail(struct iio_channel *chan,
755 const int **vals, int *type, int *length,
756 enum iio_chan_info_enum info)
757{
758 const struct iio_info *iio_info = chan->indio_dev->info;
759
760 if (!iio_channel_has_available(chan->channel, info))
761 return -EINVAL;
762
763 if (iio_info->read_avail)
764 return iio_info->read_avail(chan->indio_dev, chan->channel,
765 vals, type, length, info);
766 return -EINVAL;
767}
768
769int iio_read_avail_channel_attribute(struct iio_channel *chan,
770 const int **vals, int *type, int *length,
771 enum iio_chan_info_enum attribute)
772{
773 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
774
775 guard(mutex)(&iio_dev_opaque->info_exist_lock);
776 if (!chan->indio_dev->info)
777 return -ENODEV;
778
779 return iio_channel_read_avail(chan, vals, type, length, attribute);
780}
781EXPORT_SYMBOL_GPL(iio_read_avail_channel_attribute);
782
783int iio_read_avail_channel_raw(struct iio_channel *chan,
784 const int **vals, int *length)
785{
786 int ret;
787 int type;
788
789 ret = iio_read_avail_channel_attribute(chan, vals, &type, length,
790 IIO_CHAN_INFO_RAW);
791
792 if (ret >= 0 && type != IIO_VAL_INT)
793 /* raw values are assumed to be IIO_VAL_INT */
794 ret = -EINVAL;
795
796 return ret;
797}
798EXPORT_SYMBOL_GPL(iio_read_avail_channel_raw);
799
800static int iio_channel_read_max(struct iio_channel *chan,
801 int *val, int *val2, int *type,
802 enum iio_chan_info_enum info)
803{
804 const int *vals;
805 int length;
806 int ret;
807
808 ret = iio_channel_read_avail(chan, &vals, type, &length, info);
809 if (ret < 0)
810 return ret;
811
812 switch (ret) {
813 case IIO_AVAIL_RANGE:
814 switch (*type) {
815 case IIO_VAL_INT:
816 *val = vals[2];
817 break;
818 default:
819 *val = vals[4];
820 if (val2)
821 *val2 = vals[5];
822 }
823 return 0;
824
825 case IIO_AVAIL_LIST:
826 if (length <= 0)
827 return -EINVAL;
828 switch (*type) {
829 case IIO_VAL_INT:
830 *val = max_array(vals, length);
831 break;
832 default:
833 /* TODO: learn about max for other iio values */
834 return -EINVAL;
835 }
836 return 0;
837
838 default:
839 return -EINVAL;
840 }
841}
842
843int iio_read_max_channel_raw(struct iio_channel *chan, int *val)
844{
845 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
846 int type;
847
848 guard(mutex)(&iio_dev_opaque->info_exist_lock);
849 if (!chan->indio_dev->info)
850 return -ENODEV;
851
852 return iio_channel_read_max(chan, val, NULL, &type, IIO_CHAN_INFO_RAW);
853}
854EXPORT_SYMBOL_GPL(iio_read_max_channel_raw);
855
856static int iio_channel_read_min(struct iio_channel *chan,
857 int *val, int *val2, int *type,
858 enum iio_chan_info_enum info)
859{
860 const int *vals;
861 int length;
862 int ret;
863
864 ret = iio_channel_read_avail(chan, &vals, type, &length, info);
865 if (ret < 0)
866 return ret;
867
868 switch (ret) {
869 case IIO_AVAIL_RANGE:
870 switch (*type) {
871 case IIO_VAL_INT:
872 *val = vals[0];
873 break;
874 default:
875 *val = vals[0];
876 if (val2)
877 *val2 = vals[1];
878 }
879 return 0;
880
881 case IIO_AVAIL_LIST:
882 if (length <= 0)
883 return -EINVAL;
884 switch (*type) {
885 case IIO_VAL_INT:
886 *val = min_array(vals, length);
887 break;
888 default:
889 /* TODO: learn about min for other iio values */
890 return -EINVAL;
891 }
892 return 0;
893
894 default:
895 return -EINVAL;
896 }
897}
898
899int iio_read_min_channel_raw(struct iio_channel *chan, int *val)
900{
901 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
902 int type;
903
904 guard(mutex)(&iio_dev_opaque->info_exist_lock);
905 if (!chan->indio_dev->info)
906 return -ENODEV;
907
908 return iio_channel_read_min(chan, val, NULL, &type, IIO_CHAN_INFO_RAW);
909}
910EXPORT_SYMBOL_GPL(iio_read_min_channel_raw);
911
912int iio_get_channel_type(struct iio_channel *chan, enum iio_chan_type *type)
913{
914 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
915
916 guard(mutex)(&iio_dev_opaque->info_exist_lock);
917 if (!chan->indio_dev->info)
918 return -ENODEV;
919
920 *type = chan->channel->type;
921
922 return 0;
923}
924EXPORT_SYMBOL_GPL(iio_get_channel_type);
925
926static int iio_channel_write(struct iio_channel *chan, int val, int val2,
927 enum iio_chan_info_enum info)
928{
929 const struct iio_info *iio_info = chan->indio_dev->info;
930
931 if (iio_info->write_raw)
932 return iio_info->write_raw(chan->indio_dev,
933 chan->channel, val, val2, info);
934 return -EINVAL;
935}
936
937int iio_write_channel_attribute(struct iio_channel *chan, int val, int val2,
938 enum iio_chan_info_enum attribute)
939{
940 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
941
942 guard(mutex)(&iio_dev_opaque->info_exist_lock);
943 if (!chan->indio_dev->info)
944 return -ENODEV;
945
946 return iio_channel_write(chan, val, val2, attribute);
947}
948EXPORT_SYMBOL_GPL(iio_write_channel_attribute);
949
950int iio_write_channel_raw(struct iio_channel *chan, int val)
951{
952 return iio_write_channel_attribute(chan, val, 0, IIO_CHAN_INFO_RAW);
953}
954EXPORT_SYMBOL_GPL(iio_write_channel_raw);
955
956unsigned int iio_get_channel_ext_info_count(struct iio_channel *chan)
957{
958 const struct iio_chan_spec_ext_info *ext_info;
959 unsigned int i = 0;
960
961 if (!chan->channel->ext_info)
962 return i;
963
964 for (ext_info = chan->channel->ext_info; ext_info->name; ext_info++)
965 ++i;
966
967 return i;
968}
969EXPORT_SYMBOL_GPL(iio_get_channel_ext_info_count);
970
971static const struct iio_chan_spec_ext_info *
972iio_lookup_ext_info(const struct iio_channel *chan, const char *attr)
973{
974 const struct iio_chan_spec_ext_info *ext_info;
975
976 if (!chan->channel->ext_info)
977 return NULL;
978
979 for (ext_info = chan->channel->ext_info; ext_info->name; ++ext_info) {
980 if (!strcmp(attr, ext_info->name))
981 return ext_info;
982 }
983
984 return NULL;
985}
986
987ssize_t iio_read_channel_ext_info(struct iio_channel *chan,
988 const char *attr, char *buf)
989{
990 const struct iio_chan_spec_ext_info *ext_info;
991
992 ext_info = iio_lookup_ext_info(chan, attr);
993 if (!ext_info)
994 return -EINVAL;
995
996 return ext_info->read(chan->indio_dev, ext_info->private,
997 chan->channel, buf);
998}
999EXPORT_SYMBOL_GPL(iio_read_channel_ext_info);
1000
1001ssize_t iio_write_channel_ext_info(struct iio_channel *chan, const char *attr,
1002 const char *buf, size_t len)
1003{
1004 const struct iio_chan_spec_ext_info *ext_info;
1005
1006 ext_info = iio_lookup_ext_info(chan, attr);
1007 if (!ext_info)
1008 return -EINVAL;
1009
1010 return ext_info->write(chan->indio_dev, ext_info->private,
1011 chan->channel, buf, len);
1012}
1013EXPORT_SYMBOL_GPL(iio_write_channel_ext_info);
1014
1015ssize_t iio_read_channel_label(struct iio_channel *chan, char *buf)
1016{
1017 return do_iio_read_channel_label(chan->indio_dev, chan->channel, buf);
1018}
1019EXPORT_SYMBOL_GPL(iio_read_channel_label);
1// SPDX-License-Identifier: GPL-2.0-only
2/* The industrial I/O core in kernel channel mapping
3 *
4 * Copyright (c) 2011 Jonathan Cameron
5 */
6#include <linux/err.h>
7#include <linux/export.h>
8#include <linux/minmax.h>
9#include <linux/mutex.h>
10#include <linux/property.h>
11#include <linux/slab.h>
12
13#include <linux/iio/iio.h>
14#include <linux/iio/iio-opaque.h>
15#include "iio_core.h"
16#include <linux/iio/machine.h>
17#include <linux/iio/driver.h>
18#include <linux/iio/consumer.h>
19
20struct iio_map_internal {
21 struct iio_dev *indio_dev;
22 struct iio_map *map;
23 struct list_head l;
24};
25
26static LIST_HEAD(iio_map_list);
27static DEFINE_MUTEX(iio_map_list_lock);
28
29static int iio_map_array_unregister_locked(struct iio_dev *indio_dev)
30{
31 int ret = -ENODEV;
32 struct iio_map_internal *mapi, *next;
33
34 list_for_each_entry_safe(mapi, next, &iio_map_list, l) {
35 if (indio_dev == mapi->indio_dev) {
36 list_del(&mapi->l);
37 kfree(mapi);
38 ret = 0;
39 }
40 }
41 return ret;
42}
43
44int iio_map_array_register(struct iio_dev *indio_dev, struct iio_map *maps)
45{
46 int i = 0, ret = 0;
47 struct iio_map_internal *mapi;
48
49 if (!maps)
50 return 0;
51
52 mutex_lock(&iio_map_list_lock);
53 while (maps[i].consumer_dev_name) {
54 mapi = kzalloc(sizeof(*mapi), GFP_KERNEL);
55 if (!mapi) {
56 ret = -ENOMEM;
57 goto error_ret;
58 }
59 mapi->map = &maps[i];
60 mapi->indio_dev = indio_dev;
61 list_add_tail(&mapi->l, &iio_map_list);
62 i++;
63 }
64error_ret:
65 if (ret)
66 iio_map_array_unregister_locked(indio_dev);
67 mutex_unlock(&iio_map_list_lock);
68
69 return ret;
70}
71EXPORT_SYMBOL_GPL(iio_map_array_register);
72
73/*
74 * Remove all map entries associated with the given iio device
75 */
76int iio_map_array_unregister(struct iio_dev *indio_dev)
77{
78 int ret;
79
80 mutex_lock(&iio_map_list_lock);
81 ret = iio_map_array_unregister_locked(indio_dev);
82 mutex_unlock(&iio_map_list_lock);
83
84 return ret;
85}
86EXPORT_SYMBOL_GPL(iio_map_array_unregister);
87
88static void iio_map_array_unregister_cb(void *indio_dev)
89{
90 iio_map_array_unregister(indio_dev);
91}
92
93int devm_iio_map_array_register(struct device *dev, struct iio_dev *indio_dev, struct iio_map *maps)
94{
95 int ret;
96
97 ret = iio_map_array_register(indio_dev, maps);
98 if (ret)
99 return ret;
100
101 return devm_add_action_or_reset(dev, iio_map_array_unregister_cb, indio_dev);
102}
103EXPORT_SYMBOL_GPL(devm_iio_map_array_register);
104
105static const struct iio_chan_spec
106*iio_chan_spec_from_name(const struct iio_dev *indio_dev, const char *name)
107{
108 int i;
109 const struct iio_chan_spec *chan = NULL;
110
111 for (i = 0; i < indio_dev->num_channels; i++)
112 if (indio_dev->channels[i].datasheet_name &&
113 strcmp(name, indio_dev->channels[i].datasheet_name) == 0) {
114 chan = &indio_dev->channels[i];
115 break;
116 }
117 return chan;
118}
119
120/**
121 * __fwnode_iio_simple_xlate - translate iiospec to the IIO channel index
122 * @indio_dev: pointer to the iio_dev structure
123 * @iiospec: IIO specifier as found in the device tree
124 *
125 * This is simple translation function, suitable for the most 1:1 mapped
126 * channels in IIO chips. This function performs only one sanity check:
127 * whether IIO index is less than num_channels (that is specified in the
128 * iio_dev).
129 */
130static int __fwnode_iio_simple_xlate(struct iio_dev *indio_dev,
131 const struct fwnode_reference_args *iiospec)
132{
133 if (!iiospec->nargs)
134 return 0;
135
136 if (iiospec->args[0] >= indio_dev->num_channels) {
137 dev_err(&indio_dev->dev, "invalid channel index %llu\n",
138 iiospec->args[0]);
139 return -EINVAL;
140 }
141
142 return iiospec->args[0];
143}
144
145static int __fwnode_iio_channel_get(struct iio_channel *channel,
146 struct fwnode_handle *fwnode, int index)
147{
148 struct fwnode_reference_args iiospec;
149 struct device *idev;
150 struct iio_dev *indio_dev;
151 int err;
152
153 err = fwnode_property_get_reference_args(fwnode, "io-channels",
154 "#io-channel-cells", 0,
155 index, &iiospec);
156 if (err)
157 return err;
158
159 idev = bus_find_device_by_fwnode(&iio_bus_type, iiospec.fwnode);
160 if (!idev) {
161 fwnode_handle_put(iiospec.fwnode);
162 return -EPROBE_DEFER;
163 }
164
165 indio_dev = dev_to_iio_dev(idev);
166 channel->indio_dev = indio_dev;
167 if (indio_dev->info->fwnode_xlate)
168 index = indio_dev->info->fwnode_xlate(indio_dev, &iiospec);
169 else
170 index = __fwnode_iio_simple_xlate(indio_dev, &iiospec);
171 fwnode_handle_put(iiospec.fwnode);
172 if (index < 0)
173 goto err_put;
174 channel->channel = &indio_dev->channels[index];
175
176 return 0;
177
178err_put:
179 iio_device_put(indio_dev);
180 return index;
181}
182
183static struct iio_channel *fwnode_iio_channel_get(struct fwnode_handle *fwnode,
184 int index)
185{
186 struct iio_channel *channel;
187 int err;
188
189 if (index < 0)
190 return ERR_PTR(-EINVAL);
191
192 channel = kzalloc(sizeof(*channel), GFP_KERNEL);
193 if (!channel)
194 return ERR_PTR(-ENOMEM);
195
196 err = __fwnode_iio_channel_get(channel, fwnode, index);
197 if (err)
198 goto err_free_channel;
199
200 return channel;
201
202err_free_channel:
203 kfree(channel);
204 return ERR_PTR(err);
205}
206
207static struct iio_channel *
208__fwnode_iio_channel_get_by_name(struct fwnode_handle *fwnode, const char *name)
209{
210 struct iio_channel *chan;
211 int index = 0;
212
213 /*
214 * For named iio channels, first look up the name in the
215 * "io-channel-names" property. If it cannot be found, the
216 * index will be an error code, and fwnode_iio_channel_get()
217 * will fail.
218 */
219 if (name)
220 index = fwnode_property_match_string(fwnode, "io-channel-names",
221 name);
222
223 chan = fwnode_iio_channel_get(fwnode, index);
224 if (!IS_ERR(chan) || PTR_ERR(chan) == -EPROBE_DEFER)
225 return chan;
226 if (name) {
227 if (index >= 0) {
228 pr_err("ERROR: could not get IIO channel %pfw:%s(%i)\n",
229 fwnode, name, index);
230 /*
231 * In this case, we found 'name' in 'io-channel-names'
232 * but somehow we still fail so that we should not proceed
233 * with any other lookup. Hence, explicitly return -EINVAL
234 * (maybe not the better error code) so that the caller
235 * won't do a system lookup.
236 */
237 return ERR_PTR(-EINVAL);
238 }
239 /*
240 * If index < 0, then fwnode_property_get_reference_args() fails
241 * with -EINVAL or -ENOENT (ACPI case) which is expected. We
242 * should not proceed if we get any other error.
243 */
244 if (PTR_ERR(chan) != -EINVAL && PTR_ERR(chan) != -ENOENT)
245 return chan;
246 } else if (PTR_ERR(chan) != -ENOENT) {
247 /*
248 * if !name, then we should only proceed the lookup if
249 * fwnode_property_get_reference_args() returns -ENOENT.
250 */
251 return chan;
252 }
253
254 /* so we continue the lookup */
255 return ERR_PTR(-ENODEV);
256}
257
258struct iio_channel *fwnode_iio_channel_get_by_name(struct fwnode_handle *fwnode,
259 const char *name)
260{
261 struct fwnode_handle *parent;
262 struct iio_channel *chan;
263
264 /* Walk up the tree of devices looking for a matching iio channel */
265 chan = __fwnode_iio_channel_get_by_name(fwnode, name);
266 if (!IS_ERR(chan) || PTR_ERR(chan) != -ENODEV)
267 return chan;
268
269 /*
270 * No matching IIO channel found on this node.
271 * If the parent node has a "io-channel-ranges" property,
272 * then we can try one of its channels.
273 */
274 fwnode_for_each_parent_node(fwnode, parent) {
275 if (!fwnode_property_present(parent, "io-channel-ranges")) {
276 fwnode_handle_put(parent);
277 return ERR_PTR(-ENODEV);
278 }
279
280 chan = __fwnode_iio_channel_get_by_name(fwnode, name);
281 if (!IS_ERR(chan) || PTR_ERR(chan) != -ENODEV) {
282 fwnode_handle_put(parent);
283 return chan;
284 }
285 }
286
287 return ERR_PTR(-ENODEV);
288}
289EXPORT_SYMBOL_GPL(fwnode_iio_channel_get_by_name);
290
291static struct iio_channel *fwnode_iio_channel_get_all(struct device *dev)
292{
293 struct fwnode_handle *fwnode = dev_fwnode(dev);
294 struct iio_channel *chans;
295 int i, mapind, nummaps = 0;
296 int ret;
297
298 do {
299 ret = fwnode_property_get_reference_args(fwnode, "io-channels",
300 "#io-channel-cells", 0,
301 nummaps, NULL);
302 if (ret < 0)
303 break;
304 } while (++nummaps);
305
306 if (nummaps == 0)
307 return ERR_PTR(-ENODEV);
308
309 /* NULL terminated array to save passing size */
310 chans = kcalloc(nummaps + 1, sizeof(*chans), GFP_KERNEL);
311 if (!chans)
312 return ERR_PTR(-ENOMEM);
313
314 /* Search for FW matches */
315 for (mapind = 0; mapind < nummaps; mapind++) {
316 ret = __fwnode_iio_channel_get(&chans[mapind], fwnode, mapind);
317 if (ret)
318 goto error_free_chans;
319 }
320 return chans;
321
322error_free_chans:
323 for (i = 0; i < mapind; i++)
324 iio_device_put(chans[i].indio_dev);
325 kfree(chans);
326 return ERR_PTR(ret);
327}
328
329static struct iio_channel *iio_channel_get_sys(const char *name,
330 const char *channel_name)
331{
332 struct iio_map_internal *c_i = NULL, *c = NULL;
333 struct iio_channel *channel;
334 int err;
335
336 if (!(name || channel_name))
337 return ERR_PTR(-ENODEV);
338
339 /* first find matching entry the channel map */
340 mutex_lock(&iio_map_list_lock);
341 list_for_each_entry(c_i, &iio_map_list, l) {
342 if ((name && strcmp(name, c_i->map->consumer_dev_name) != 0) ||
343 (channel_name &&
344 strcmp(channel_name, c_i->map->consumer_channel) != 0))
345 continue;
346 c = c_i;
347 iio_device_get(c->indio_dev);
348 break;
349 }
350 mutex_unlock(&iio_map_list_lock);
351 if (!c)
352 return ERR_PTR(-ENODEV);
353
354 channel = kzalloc(sizeof(*channel), GFP_KERNEL);
355 if (!channel) {
356 err = -ENOMEM;
357 goto error_no_mem;
358 }
359
360 channel->indio_dev = c->indio_dev;
361
362 if (c->map->adc_channel_label) {
363 channel->channel =
364 iio_chan_spec_from_name(channel->indio_dev,
365 c->map->adc_channel_label);
366
367 if (!channel->channel) {
368 err = -EINVAL;
369 goto error_no_chan;
370 }
371 }
372
373 return channel;
374
375error_no_chan:
376 kfree(channel);
377error_no_mem:
378 iio_device_put(c->indio_dev);
379 return ERR_PTR(err);
380}
381
382struct iio_channel *iio_channel_get(struct device *dev,
383 const char *channel_name)
384{
385 const char *name = dev ? dev_name(dev) : NULL;
386 struct iio_channel *channel;
387
388 if (dev) {
389 channel = fwnode_iio_channel_get_by_name(dev_fwnode(dev),
390 channel_name);
391 if (!IS_ERR(channel) || PTR_ERR(channel) != -ENODEV)
392 return channel;
393 }
394
395 return iio_channel_get_sys(name, channel_name);
396}
397EXPORT_SYMBOL_GPL(iio_channel_get);
398
399void iio_channel_release(struct iio_channel *channel)
400{
401 if (!channel)
402 return;
403 iio_device_put(channel->indio_dev);
404 kfree(channel);
405}
406EXPORT_SYMBOL_GPL(iio_channel_release);
407
408static void devm_iio_channel_free(void *iio_channel)
409{
410 iio_channel_release(iio_channel);
411}
412
413struct iio_channel *devm_iio_channel_get(struct device *dev,
414 const char *channel_name)
415{
416 struct iio_channel *channel;
417 int ret;
418
419 channel = iio_channel_get(dev, channel_name);
420 if (IS_ERR(channel))
421 return channel;
422
423 ret = devm_add_action_or_reset(dev, devm_iio_channel_free, channel);
424 if (ret)
425 return ERR_PTR(ret);
426
427 return channel;
428}
429EXPORT_SYMBOL_GPL(devm_iio_channel_get);
430
431struct iio_channel *devm_fwnode_iio_channel_get_by_name(struct device *dev,
432 struct fwnode_handle *fwnode,
433 const char *channel_name)
434{
435 struct iio_channel *channel;
436 int ret;
437
438 channel = fwnode_iio_channel_get_by_name(fwnode, channel_name);
439 if (IS_ERR(channel))
440 return channel;
441
442 ret = devm_add_action_or_reset(dev, devm_iio_channel_free, channel);
443 if (ret)
444 return ERR_PTR(ret);
445
446 return channel;
447}
448EXPORT_SYMBOL_GPL(devm_fwnode_iio_channel_get_by_name);
449
450struct iio_channel *iio_channel_get_all(struct device *dev)
451{
452 const char *name;
453 struct iio_channel *chans;
454 struct iio_map_internal *c = NULL;
455 int nummaps = 0;
456 int mapind = 0;
457 int i, ret;
458
459 if (!dev)
460 return ERR_PTR(-EINVAL);
461
462 chans = fwnode_iio_channel_get_all(dev);
463 /*
464 * We only want to carry on if the error is -ENODEV. Anything else
465 * should be reported up the stack.
466 */
467 if (!IS_ERR(chans) || PTR_ERR(chans) != -ENODEV)
468 return chans;
469
470 name = dev_name(dev);
471
472 mutex_lock(&iio_map_list_lock);
473 /* first count the matching maps */
474 list_for_each_entry(c, &iio_map_list, l)
475 if (name && strcmp(name, c->map->consumer_dev_name) != 0)
476 continue;
477 else
478 nummaps++;
479
480 if (nummaps == 0) {
481 ret = -ENODEV;
482 goto error_ret;
483 }
484
485 /* NULL terminated array to save passing size */
486 chans = kcalloc(nummaps + 1, sizeof(*chans), GFP_KERNEL);
487 if (!chans) {
488 ret = -ENOMEM;
489 goto error_ret;
490 }
491
492 /* for each map fill in the chans element */
493 list_for_each_entry(c, &iio_map_list, l) {
494 if (name && strcmp(name, c->map->consumer_dev_name) != 0)
495 continue;
496 chans[mapind].indio_dev = c->indio_dev;
497 chans[mapind].data = c->map->consumer_data;
498 chans[mapind].channel =
499 iio_chan_spec_from_name(chans[mapind].indio_dev,
500 c->map->adc_channel_label);
501 if (!chans[mapind].channel) {
502 ret = -EINVAL;
503 goto error_free_chans;
504 }
505 iio_device_get(chans[mapind].indio_dev);
506 mapind++;
507 }
508 if (mapind == 0) {
509 ret = -ENODEV;
510 goto error_free_chans;
511 }
512 mutex_unlock(&iio_map_list_lock);
513
514 return chans;
515
516error_free_chans:
517 for (i = 0; i < nummaps; i++)
518 iio_device_put(chans[i].indio_dev);
519 kfree(chans);
520error_ret:
521 mutex_unlock(&iio_map_list_lock);
522
523 return ERR_PTR(ret);
524}
525EXPORT_SYMBOL_GPL(iio_channel_get_all);
526
527void iio_channel_release_all(struct iio_channel *channels)
528{
529 struct iio_channel *chan = &channels[0];
530
531 while (chan->indio_dev) {
532 iio_device_put(chan->indio_dev);
533 chan++;
534 }
535 kfree(channels);
536}
537EXPORT_SYMBOL_GPL(iio_channel_release_all);
538
539static void devm_iio_channel_free_all(void *iio_channels)
540{
541 iio_channel_release_all(iio_channels);
542}
543
544struct iio_channel *devm_iio_channel_get_all(struct device *dev)
545{
546 struct iio_channel *channels;
547 int ret;
548
549 channels = iio_channel_get_all(dev);
550 if (IS_ERR(channels))
551 return channels;
552
553 ret = devm_add_action_or_reset(dev, devm_iio_channel_free_all,
554 channels);
555 if (ret)
556 return ERR_PTR(ret);
557
558 return channels;
559}
560EXPORT_SYMBOL_GPL(devm_iio_channel_get_all);
561
562static int iio_channel_read(struct iio_channel *chan, int *val, int *val2,
563 enum iio_chan_info_enum info)
564{
565 int unused;
566 int vals[INDIO_MAX_RAW_ELEMENTS];
567 int ret;
568 int val_len = 2;
569
570 if (!val2)
571 val2 = &unused;
572
573 if (!iio_channel_has_info(chan->channel, info))
574 return -EINVAL;
575
576 if (chan->indio_dev->info->read_raw_multi) {
577 ret = chan->indio_dev->info->read_raw_multi(chan->indio_dev,
578 chan->channel, INDIO_MAX_RAW_ELEMENTS,
579 vals, &val_len, info);
580 *val = vals[0];
581 *val2 = vals[1];
582 } else {
583 ret = chan->indio_dev->info->read_raw(chan->indio_dev,
584 chan->channel, val, val2, info);
585 }
586
587 return ret;
588}
589
590int iio_read_channel_raw(struct iio_channel *chan, int *val)
591{
592 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
593 int ret;
594
595 mutex_lock(&iio_dev_opaque->info_exist_lock);
596 if (!chan->indio_dev->info) {
597 ret = -ENODEV;
598 goto err_unlock;
599 }
600
601 ret = iio_channel_read(chan, val, NULL, IIO_CHAN_INFO_RAW);
602err_unlock:
603 mutex_unlock(&iio_dev_opaque->info_exist_lock);
604
605 return ret;
606}
607EXPORT_SYMBOL_GPL(iio_read_channel_raw);
608
609int iio_read_channel_average_raw(struct iio_channel *chan, int *val)
610{
611 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
612 int ret;
613
614 mutex_lock(&iio_dev_opaque->info_exist_lock);
615 if (!chan->indio_dev->info) {
616 ret = -ENODEV;
617 goto err_unlock;
618 }
619
620 ret = iio_channel_read(chan, val, NULL, IIO_CHAN_INFO_AVERAGE_RAW);
621err_unlock:
622 mutex_unlock(&iio_dev_opaque->info_exist_lock);
623
624 return ret;
625}
626EXPORT_SYMBOL_GPL(iio_read_channel_average_raw);
627
628static int iio_convert_raw_to_processed_unlocked(struct iio_channel *chan,
629 int raw, int *processed,
630 unsigned int scale)
631{
632 int scale_type, scale_val, scale_val2;
633 int offset_type, offset_val, offset_val2;
634 s64 raw64 = raw;
635
636 offset_type = iio_channel_read(chan, &offset_val, &offset_val2,
637 IIO_CHAN_INFO_OFFSET);
638 if (offset_type >= 0) {
639 switch (offset_type) {
640 case IIO_VAL_INT:
641 break;
642 case IIO_VAL_INT_PLUS_MICRO:
643 case IIO_VAL_INT_PLUS_NANO:
644 /*
645 * Both IIO_VAL_INT_PLUS_MICRO and IIO_VAL_INT_PLUS_NANO
646 * implicitely truncate the offset to it's integer form.
647 */
648 break;
649 case IIO_VAL_FRACTIONAL:
650 offset_val /= offset_val2;
651 break;
652 case IIO_VAL_FRACTIONAL_LOG2:
653 offset_val >>= offset_val2;
654 break;
655 default:
656 return -EINVAL;
657 }
658
659 raw64 += offset_val;
660 }
661
662 scale_type = iio_channel_read(chan, &scale_val, &scale_val2,
663 IIO_CHAN_INFO_SCALE);
664 if (scale_type < 0) {
665 /*
666 * If no channel scaling is available apply consumer scale to
667 * raw value and return.
668 */
669 *processed = raw * scale;
670 return 0;
671 }
672
673 switch (scale_type) {
674 case IIO_VAL_INT:
675 *processed = raw64 * scale_val * scale;
676 break;
677 case IIO_VAL_INT_PLUS_MICRO:
678 if (scale_val2 < 0)
679 *processed = -raw64 * scale_val;
680 else
681 *processed = raw64 * scale_val;
682 *processed += div_s64(raw64 * (s64)scale_val2 * scale,
683 1000000LL);
684 break;
685 case IIO_VAL_INT_PLUS_NANO:
686 if (scale_val2 < 0)
687 *processed = -raw64 * scale_val;
688 else
689 *processed = raw64 * scale_val;
690 *processed += div_s64(raw64 * (s64)scale_val2 * scale,
691 1000000000LL);
692 break;
693 case IIO_VAL_FRACTIONAL:
694 *processed = div_s64(raw64 * (s64)scale_val * scale,
695 scale_val2);
696 break;
697 case IIO_VAL_FRACTIONAL_LOG2:
698 *processed = (raw64 * (s64)scale_val * scale) >> scale_val2;
699 break;
700 default:
701 return -EINVAL;
702 }
703
704 return 0;
705}
706
707int iio_convert_raw_to_processed(struct iio_channel *chan, int raw,
708 int *processed, unsigned int scale)
709{
710 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
711 int ret;
712
713 mutex_lock(&iio_dev_opaque->info_exist_lock);
714 if (!chan->indio_dev->info) {
715 ret = -ENODEV;
716 goto err_unlock;
717 }
718
719 ret = iio_convert_raw_to_processed_unlocked(chan, raw, processed,
720 scale);
721err_unlock:
722 mutex_unlock(&iio_dev_opaque->info_exist_lock);
723
724 return ret;
725}
726EXPORT_SYMBOL_GPL(iio_convert_raw_to_processed);
727
728int iio_read_channel_attribute(struct iio_channel *chan, int *val, int *val2,
729 enum iio_chan_info_enum attribute)
730{
731 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
732 int ret;
733
734 mutex_lock(&iio_dev_opaque->info_exist_lock);
735 if (!chan->indio_dev->info) {
736 ret = -ENODEV;
737 goto err_unlock;
738 }
739
740 ret = iio_channel_read(chan, val, val2, attribute);
741err_unlock:
742 mutex_unlock(&iio_dev_opaque->info_exist_lock);
743
744 return ret;
745}
746EXPORT_SYMBOL_GPL(iio_read_channel_attribute);
747
748int iio_read_channel_offset(struct iio_channel *chan, int *val, int *val2)
749{
750 return iio_read_channel_attribute(chan, val, val2, IIO_CHAN_INFO_OFFSET);
751}
752EXPORT_SYMBOL_GPL(iio_read_channel_offset);
753
754int iio_read_channel_processed_scale(struct iio_channel *chan, int *val,
755 unsigned int scale)
756{
757 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
758 int ret;
759
760 mutex_lock(&iio_dev_opaque->info_exist_lock);
761 if (!chan->indio_dev->info) {
762 ret = -ENODEV;
763 goto err_unlock;
764 }
765
766 if (iio_channel_has_info(chan->channel, IIO_CHAN_INFO_PROCESSED)) {
767 ret = iio_channel_read(chan, val, NULL,
768 IIO_CHAN_INFO_PROCESSED);
769 if (ret < 0)
770 goto err_unlock;
771 *val *= scale;
772 } else {
773 ret = iio_channel_read(chan, val, NULL, IIO_CHAN_INFO_RAW);
774 if (ret < 0)
775 goto err_unlock;
776 ret = iio_convert_raw_to_processed_unlocked(chan, *val, val,
777 scale);
778 }
779
780err_unlock:
781 mutex_unlock(&iio_dev_opaque->info_exist_lock);
782
783 return ret;
784}
785EXPORT_SYMBOL_GPL(iio_read_channel_processed_scale);
786
787int iio_read_channel_processed(struct iio_channel *chan, int *val)
788{
789 /* This is just a special case with scale factor 1 */
790 return iio_read_channel_processed_scale(chan, val, 1);
791}
792EXPORT_SYMBOL_GPL(iio_read_channel_processed);
793
794int iio_read_channel_scale(struct iio_channel *chan, int *val, int *val2)
795{
796 return iio_read_channel_attribute(chan, val, val2, IIO_CHAN_INFO_SCALE);
797}
798EXPORT_SYMBOL_GPL(iio_read_channel_scale);
799
800static int iio_channel_read_avail(struct iio_channel *chan,
801 const int **vals, int *type, int *length,
802 enum iio_chan_info_enum info)
803{
804 if (!iio_channel_has_available(chan->channel, info))
805 return -EINVAL;
806
807 return chan->indio_dev->info->read_avail(chan->indio_dev, chan->channel,
808 vals, type, length, info);
809}
810
811int iio_read_avail_channel_attribute(struct iio_channel *chan,
812 const int **vals, int *type, int *length,
813 enum iio_chan_info_enum attribute)
814{
815 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
816 int ret;
817
818 mutex_lock(&iio_dev_opaque->info_exist_lock);
819 if (!chan->indio_dev->info) {
820 ret = -ENODEV;
821 goto err_unlock;
822 }
823
824 ret = iio_channel_read_avail(chan, vals, type, length, attribute);
825err_unlock:
826 mutex_unlock(&iio_dev_opaque->info_exist_lock);
827
828 return ret;
829}
830EXPORT_SYMBOL_GPL(iio_read_avail_channel_attribute);
831
832int iio_read_avail_channel_raw(struct iio_channel *chan,
833 const int **vals, int *length)
834{
835 int ret;
836 int type;
837
838 ret = iio_read_avail_channel_attribute(chan, vals, &type, length,
839 IIO_CHAN_INFO_RAW);
840
841 if (ret >= 0 && type != IIO_VAL_INT)
842 /* raw values are assumed to be IIO_VAL_INT */
843 ret = -EINVAL;
844
845 return ret;
846}
847EXPORT_SYMBOL_GPL(iio_read_avail_channel_raw);
848
849static int iio_channel_read_max(struct iio_channel *chan,
850 int *val, int *val2, int *type,
851 enum iio_chan_info_enum info)
852{
853 const int *vals;
854 int length;
855 int ret;
856
857 ret = iio_channel_read_avail(chan, &vals, type, &length, info);
858 if (ret < 0)
859 return ret;
860
861 switch (ret) {
862 case IIO_AVAIL_RANGE:
863 switch (*type) {
864 case IIO_VAL_INT:
865 *val = vals[2];
866 break;
867 default:
868 *val = vals[4];
869 if (val2)
870 *val2 = vals[5];
871 }
872 return 0;
873
874 case IIO_AVAIL_LIST:
875 if (length <= 0)
876 return -EINVAL;
877 switch (*type) {
878 case IIO_VAL_INT:
879 *val = max_array(vals, length);
880 break;
881 default:
882 /* TODO: learn about max for other iio values */
883 return -EINVAL;
884 }
885 return 0;
886
887 default:
888 return -EINVAL;
889 }
890}
891
892int iio_read_max_channel_raw(struct iio_channel *chan, int *val)
893{
894 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
895 int ret;
896 int type;
897
898 mutex_lock(&iio_dev_opaque->info_exist_lock);
899 if (!chan->indio_dev->info) {
900 ret = -ENODEV;
901 goto err_unlock;
902 }
903
904 ret = iio_channel_read_max(chan, val, NULL, &type, IIO_CHAN_INFO_RAW);
905err_unlock:
906 mutex_unlock(&iio_dev_opaque->info_exist_lock);
907
908 return ret;
909}
910EXPORT_SYMBOL_GPL(iio_read_max_channel_raw);
911
912static int iio_channel_read_min(struct iio_channel *chan,
913 int *val, int *val2, int *type,
914 enum iio_chan_info_enum info)
915{
916 const int *vals;
917 int length;
918 int ret;
919
920 ret = iio_channel_read_avail(chan, &vals, type, &length, info);
921 if (ret < 0)
922 return ret;
923
924 switch (ret) {
925 case IIO_AVAIL_RANGE:
926 switch (*type) {
927 case IIO_VAL_INT:
928 *val = vals[0];
929 break;
930 default:
931 *val = vals[0];
932 if (val2)
933 *val2 = vals[1];
934 }
935 return 0;
936
937 case IIO_AVAIL_LIST:
938 if (length <= 0)
939 return -EINVAL;
940 switch (*type) {
941 case IIO_VAL_INT:
942 *val = min_array(vals, length);
943 break;
944 default:
945 /* TODO: learn about min for other iio values */
946 return -EINVAL;
947 }
948 return 0;
949
950 default:
951 return -EINVAL;
952 }
953}
954
955int iio_read_min_channel_raw(struct iio_channel *chan, int *val)
956{
957 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
958 int ret;
959 int type;
960
961 mutex_lock(&iio_dev_opaque->info_exist_lock);
962 if (!chan->indio_dev->info) {
963 ret = -ENODEV;
964 goto err_unlock;
965 }
966
967 ret = iio_channel_read_min(chan, val, NULL, &type, IIO_CHAN_INFO_RAW);
968err_unlock:
969 mutex_unlock(&iio_dev_opaque->info_exist_lock);
970
971 return ret;
972}
973EXPORT_SYMBOL_GPL(iio_read_min_channel_raw);
974
975int iio_get_channel_type(struct iio_channel *chan, enum iio_chan_type *type)
976{
977 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
978 int ret = 0;
979 /* Need to verify underlying driver has not gone away */
980
981 mutex_lock(&iio_dev_opaque->info_exist_lock);
982 if (!chan->indio_dev->info) {
983 ret = -ENODEV;
984 goto err_unlock;
985 }
986
987 *type = chan->channel->type;
988err_unlock:
989 mutex_unlock(&iio_dev_opaque->info_exist_lock);
990
991 return ret;
992}
993EXPORT_SYMBOL_GPL(iio_get_channel_type);
994
995static int iio_channel_write(struct iio_channel *chan, int val, int val2,
996 enum iio_chan_info_enum info)
997{
998 return chan->indio_dev->info->write_raw(chan->indio_dev,
999 chan->channel, val, val2, info);
1000}
1001
1002int iio_write_channel_attribute(struct iio_channel *chan, int val, int val2,
1003 enum iio_chan_info_enum attribute)
1004{
1005 struct iio_dev_opaque *iio_dev_opaque = to_iio_dev_opaque(chan->indio_dev);
1006 int ret;
1007
1008 mutex_lock(&iio_dev_opaque->info_exist_lock);
1009 if (!chan->indio_dev->info) {
1010 ret = -ENODEV;
1011 goto err_unlock;
1012 }
1013
1014 ret = iio_channel_write(chan, val, val2, attribute);
1015err_unlock:
1016 mutex_unlock(&iio_dev_opaque->info_exist_lock);
1017
1018 return ret;
1019}
1020EXPORT_SYMBOL_GPL(iio_write_channel_attribute);
1021
1022int iio_write_channel_raw(struct iio_channel *chan, int val)
1023{
1024 return iio_write_channel_attribute(chan, val, 0, IIO_CHAN_INFO_RAW);
1025}
1026EXPORT_SYMBOL_GPL(iio_write_channel_raw);
1027
1028unsigned int iio_get_channel_ext_info_count(struct iio_channel *chan)
1029{
1030 const struct iio_chan_spec_ext_info *ext_info;
1031 unsigned int i = 0;
1032
1033 if (!chan->channel->ext_info)
1034 return i;
1035
1036 for (ext_info = chan->channel->ext_info; ext_info->name; ext_info++)
1037 ++i;
1038
1039 return i;
1040}
1041EXPORT_SYMBOL_GPL(iio_get_channel_ext_info_count);
1042
1043static const struct iio_chan_spec_ext_info *
1044iio_lookup_ext_info(const struct iio_channel *chan, const char *attr)
1045{
1046 const struct iio_chan_spec_ext_info *ext_info;
1047
1048 if (!chan->channel->ext_info)
1049 return NULL;
1050
1051 for (ext_info = chan->channel->ext_info; ext_info->name; ++ext_info) {
1052 if (!strcmp(attr, ext_info->name))
1053 return ext_info;
1054 }
1055
1056 return NULL;
1057}
1058
1059ssize_t iio_read_channel_ext_info(struct iio_channel *chan,
1060 const char *attr, char *buf)
1061{
1062 const struct iio_chan_spec_ext_info *ext_info;
1063
1064 ext_info = iio_lookup_ext_info(chan, attr);
1065 if (!ext_info)
1066 return -EINVAL;
1067
1068 return ext_info->read(chan->indio_dev, ext_info->private,
1069 chan->channel, buf);
1070}
1071EXPORT_SYMBOL_GPL(iio_read_channel_ext_info);
1072
1073ssize_t iio_write_channel_ext_info(struct iio_channel *chan, const char *attr,
1074 const char *buf, size_t len)
1075{
1076 const struct iio_chan_spec_ext_info *ext_info;
1077
1078 ext_info = iio_lookup_ext_info(chan, attr);
1079 if (!ext_info)
1080 return -EINVAL;
1081
1082 return ext_info->write(chan->indio_dev, ext_info->private,
1083 chan->channel, buf, len);
1084}
1085EXPORT_SYMBOL_GPL(iio_write_channel_ext_info);