Lines Matching +full:iio +full:- +full:consumer
1 // SPDX-License-Identifier: GPL-2.0-only
3 * Framework to handle complex IIO aggregate devices.
6 * can be "linked" against one or multiple backend devices. All the IIO and
11 * -------------------------------------------------------
12 * ------------------ | ------------ ------------ ------- FPGA|
13 * | ADC |------------------------| | ADC CORE |---------| DMA CORE |------| RAM | |
14 * | (Frontend/IIO) | Serial Data (eg: LVDS) | |(backend) |---------| |------| | |
15 * | |------------------------| ------------ ------------ ------- |
16 * ------------------ -------------------------------------------------------
19 * - Backends should register themselves with devm_iio_backend_register()
20 * - Frontend devices should get backends with devm_iio_backend_get()
24 * devices. On top of that, this is "generic" for all IIO which means any kind
27 * the industrialio-backend.c is only left with the really generic stuff. Then,
30 * Copyright (C) 2023-2024 Analog Devices Inc.
32 #define dev_fmt(fmt) "iio-backend: " fmt
47 #include <linux/iio/backend.h>
48 #include <linux/iio/iio.h>
86 if (!____back->ops->op) \
87 ____ret = -EOPNOTSUPP; \
98 __ret = __back->ops->op(__back, ##args); \
112 ptr_err = __back->ops->op(__back, ##args); \
123 __back->ops->op(__back, ##args); \
125 dev_dbg(__back->dev, "Op(%s) not implemented\n",\
133 struct iio_backend *back = file->private_data; in iio_backend_debugfs_read_reg()
139 back->cached_reg_addr, 0, &val); in iio_backend_debugfs_read_reg()
152 struct iio_backend *back = file->private_data; in iio_backend_debugfs_write_reg()
158 rc = simple_write_to_buffer(buf, sizeof(buf) - 1, ppos, userbuf, count); in iio_backend_debugfs_write_reg()
164 ret = sscanf(buf, "%i %i", &back->cached_reg_addr, &val); in iio_backend_debugfs_write_reg()
171 back->cached_reg_addr, val, NULL); in iio_backend_debugfs_write_reg()
176 return -EINVAL; in iio_backend_debugfs_write_reg()
190 struct iio_backend *back = file->private_data; in iio_backend_debugfs_read_name()
194 len = scnprintf(name, sizeof(name), "%s\n", back->name); in iio_backend_debugfs_read_name()
205 * iio_backend_debugfs_add - Add debugfs interfaces for Backends
207 * @indio_dev: IIO device
218 if (!back->ops->debugfs_reg_access && !back->name) in iio_backend_debugfs_add()
221 snprintf(name, sizeof(name), "backend%d", back->idx); in iio_backend_debugfs_add()
227 if (back->ops->debugfs_reg_access) in iio_backend_debugfs_add()
231 if (back->name) in iio_backend_debugfs_add()
238 * iio_backend_debugfs_print_chan_status - Print channel status
256 return -ENODEV; in iio_backend_debugfs_print_chan_status()
264 * iio_backend_chan_enable - Enable a backend channel
278 * iio_backend_chan_disable - Disable a backend channel
297 * iio_backend_disable - Backend disable
307 * iio_backend_enable - Backend enable
320 * devm_iio_backend_enable - Device managed backend enable
321 * @dev: Consumer device for the backend
340 * iio_backend_data_format_set - Configure the channel data format
354 if (!data || data->type >= IIO_BACKEND_DATA_TYPE_MAX) in iio_backend_data_format_set()
355 return -EINVAL; in iio_backend_data_format_set()
362 * iio_backend_data_source_set - Select data source
377 return -EINVAL; in iio_backend_data_source_set()
384 * iio_backend_set_sampling_freq - Set channel sampling rate
400 * iio_backend_test_pattern_set - Configure a test pattern
416 return -EINVAL; in iio_backend_test_pattern_set()
423 * iio_backend_chan_status - Get the channel status
442 * iio_backend_iodelay_set - Set digital I/O delay
465 * iio_backend_data_sample_trigger - Control when to sample data
479 return -EINVAL; in iio_backend_data_sample_trigger()
489 iio_backend_void_op_call(pair->back, free_buffer, pair->buffer); in iio_backend_free_buffer()
493 * devm_iio_backend_request_buffer - Device managed buffer request
494 * @dev: Consumer device for the backend
496 * @indio_dev: IIO device
498 * Request an IIO buffer from the backend. The type of the buffer (typically
516 return -ENOMEM; in devm_iio_backend_request_buffer()
523 pair->back = back; in devm_iio_backend_request_buffer()
524 pair->buffer = buffer; in devm_iio_backend_request_buffer()
531 * iio_backend_read_raw - Read a channel attribute from a backend device.
533 * @chan: IIO channel reference
551 struct iio_backend *back = ERR_PTR(-ENODEV), *iter; in iio_backend_from_indio_dev_parent()
562 if (dev == iter->frontend_dev) { in iio_backend_from_indio_dev_parent()
566 return ERR_PTR(-ENODEV); in iio_backend_from_indio_dev_parent()
577 * iio_backend_ext_info_get - IIO ext_info read callback
578 * @indio_dev: IIO device
580 * @chan: IIO channel
583 * This helper is intended to be used by backends that extend an IIO channel
603 back = iio_backend_from_indio_dev_parent(indio_dev->dev.parent); in iio_backend_ext_info_get()
612 * iio_backend_ext_info_set - IIO ext_info write callback
613 * @indio_dev: IIO device
615 * @chan: IIO channel
619 * This helper is intended to be used by backends that extend an IIO channel
633 back = iio_backend_from_indio_dev_parent(indio_dev->dev.parent); in iio_backend_ext_info_set()
642 * iio_backend_interface_type_get - get the interface type used.
659 return -EINVAL; in iio_backend_interface_type_get()
666 * iio_backend_data_size_set - set the data width/size in the data bus.
680 return -EINVAL; in iio_backend_data_size_set()
687 * iio_backend_oversampling_ratio_set - set the oversampling ratio
689 * @ratio: The oversampling ratio - value 1 corresponds to no oversampling.
702 * iio_backend_extend_chan_spec - Extend an IIO channel
704 * @chan: IIO channel
715 const struct iio_chan_spec_ext_info *frontend_ext_info = chan->ext_info; in iio_backend_extend_chan_spec()
727 if (frontend_ext_info && chan->ext_info != frontend_ext_info) in iio_backend_extend_chan_spec()
728 return -EOPNOTSUPP; in iio_backend_extend_chan_spec()
729 if (!chan->ext_info) in iio_backend_extend_chan_spec()
733 for (back_ext_info = chan->ext_info; back_ext_info->name; back_ext_info++) { in iio_backend_extend_chan_spec()
734 if (back_ext_info->read != iio_backend_ext_info_get) in iio_backend_extend_chan_spec()
735 return -EINVAL; in iio_backend_extend_chan_spec()
736 if (back_ext_info->write != iio_backend_ext_info_set) in iio_backend_extend_chan_spec()
737 return -EINVAL; in iio_backend_extend_chan_spec()
748 module_put(back->owner); in iio_backend_release()
757 * Make sure the provider cannot be unloaded before the consumer module. in __devm_iio_backend_get()
759 * accessible (and breaks) but this makes it explicit that the consumer in __devm_iio_backend_get()
762 if (!try_module_get(back->owner)) in __devm_iio_backend_get()
763 return dev_err_probe(dev, -ENODEV, in __devm_iio_backend_get()
770 link = device_link_add(dev, back->dev, DL_FLAG_AUTOREMOVE_CONSUMER); in __devm_iio_backend_get()
772 return dev_err_probe(dev, -EINVAL, in __devm_iio_backend_get()
774 dev_name(back->dev)); in __devm_iio_backend_get()
776 back->frontend_dev = dev; in __devm_iio_backend_get()
778 dev_dbg(dev, "Found backend(%s) device\n", dev_name(back->dev)); in __devm_iio_backend_get()
784 * iio_backend_ddr_enable - Enable interface DDR (Double Data Rate) mode
800 * iio_backend_ddr_disable - Disable interface DDR (Double Data Rate) mode
815 * iio_backend_data_stream_enable - Enable data stream
830 * iio_backend_data_stream_disable - Disable data stream
845 * iio_backend_data_transfer_addr - Set data address.
870 ret = device_property_match_string(dev, "io-backend-names", in __devm_iio_backend_fwnode_get()
879 fwnode_back = fwnode_find_reference(fwnode, "io-backends", index); in __devm_iio_backend_fwnode_get()
886 if (!device_match_fwnode(back->dev, fwnode_back)) in __devm_iio_backend_fwnode_get()
895 back->idx = index; in __devm_iio_backend_fwnode_get()
901 return ERR_PTR(-EPROBE_DEFER); in __devm_iio_backend_fwnode_get()
905 * devm_iio_backend_get - Device managed backend device get
906 * @dev: Consumer device for the backend
921 * devm_iio_backend_fwnode_get - Device managed backend firmware node get
922 * @dev: Consumer device for the backend
924 * @fwnode: Firmware node of the backend consumer
940 * __devm_iio_backend_get_from_fwnode_lookup - Device managed fwnode backend device get
941 * @dev: Consumer device for the backend
960 if (!device_match_fwnode(back->dev, fwnode)) in __devm_iio_backend_get_from_fwnode_lookup()
970 return ERR_PTR(-EPROBE_DEFER); in __devm_iio_backend_get_from_fwnode_lookup()
975 * iio_backend_get_priv - Get driver private data
980 return back->priv; in iio_backend_get_priv()
989 list_del(&back->entry); in iio_backend_unregister()
993 * devm_iio_backend_register - Device managed backend device register
998 * @info is mandatory. Not providing it results in -EINVAL.
1008 if (!info || !info->ops) in devm_iio_backend_register()
1009 return dev_err_probe(dev, -EINVAL, "No backend ops given\n"); in devm_iio_backend_register()
1015 * removing it will tear the frontend/consumer down. in devm_iio_backend_register()
1019 return -ENOMEM; in devm_iio_backend_register()
1021 back->ops = info->ops; in devm_iio_backend_register()
1022 back->name = info->name; in devm_iio_backend_register()
1023 back->owner = dev->driver->owner; in devm_iio_backend_register()
1024 back->dev = dev; in devm_iio_backend_register()
1025 back->priv = priv; in devm_iio_backend_register()
1027 list_add(&back->entry, &iio_back_list); in devm_iio_backend_register()
1034 MODULE_DESCRIPTION("Framework to handle complex IIO aggregate devices");