Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 1 | /* The industrial I/O core - generic buffer interfaces. |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 2 | * |
| 3 | * Copyright (c) 2008 Jonathan Cameron |
| 4 | * |
| 5 | * This program is free software; you can redistribute it and/or modify it |
| 6 | * under the terms of the GNU General Public License version 2 as published by |
| 7 | * the Free Software Foundation. |
| 8 | */ |
| 9 | |
Jonathan Cameron | 3811cd6 | 2011-09-21 11:15:56 +0100 | [diff] [blame] | 10 | #ifndef _IIO_BUFFER_GENERIC_H_ |
| 11 | #define _IIO_BUFFER_GENERIC_H_ |
Jonathan Cameron | 26d25ae | 2011-09-02 17:14:40 +0100 | [diff] [blame] | 12 | #include <linux/sysfs.h> |
Jonathan Cameron | 06458e2 | 2012-04-25 15:54:58 +0100 | [diff] [blame] | 13 | #include <linux/iio/iio.h> |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 14 | |
Jonathan Cameron | f2a9624 | 2011-09-21 11:15:55 +0100 | [diff] [blame] | 15 | #ifdef CONFIG_IIO_BUFFER |
Jonathan Cameron | 2662051 | 2010-07-11 16:39:14 +0100 | [diff] [blame] | 16 | |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 17 | struct iio_buffer; |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 18 | |
| 19 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 20 | * struct iio_buffer_access_funcs - access functions for buffers. |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 21 | * @store_to: actually store stuff to the buffer |
Lars-Peter Clausen | 8fe6495 | 2011-12-12 09:33:14 +0100 | [diff] [blame] | 22 | * @read_first_n: try to get a specified number of bytes (must exist) |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 23 | * @request_update: if a parameter change has been marked, update underlying |
| 24 | * storage. |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 25 | * @get_bytes_per_datum:get current bytes per datum |
| 26 | * @set_bytes_per_datum:set number of bytes per datum |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 27 | * @get_length: get number of datums in buffer |
| 28 | * @set_length: set number of datums in buffer |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 29 | * |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 30 | * The purpose of this structure is to make the buffer element |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 31 | * modular as event for a given driver, different usecases may require |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 32 | * different buffer designs (space efficiency vs speed for example). |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 33 | * |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 34 | * It is worth noting that a given buffer implementation may only support a |
| 35 | * small proportion of these functions. The core code 'should' cope fine with |
| 36 | * any of them not existing. |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 37 | **/ |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 38 | struct iio_buffer_access_funcs { |
Lars-Peter Clausen | ce56ade | 2012-09-04 13:38:00 +0100 | [diff] [blame] | 39 | int (*store_to)(struct iio_buffer *buffer, u8 *data); |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 40 | int (*read_first_n)(struct iio_buffer *buffer, |
Jonathan Cameron | b428173 | 2011-04-15 18:55:55 +0100 | [diff] [blame] | 41 | size_t n, |
Jonathan Cameron | b26a218 | 2011-05-18 14:41:02 +0100 | [diff] [blame] | 42 | char __user *buf); |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 43 | |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 44 | int (*request_update)(struct iio_buffer *buffer); |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 45 | |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 46 | int (*get_bytes_per_datum)(struct iio_buffer *buffer); |
| 47 | int (*set_bytes_per_datum)(struct iio_buffer *buffer, size_t bpd); |
| 48 | int (*get_length)(struct iio_buffer *buffer); |
| 49 | int (*set_length)(struct iio_buffer *buffer, int length); |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 50 | }; |
| 51 | |
Jonathan Cameron | 6446e9c | 2011-08-30 12:41:13 +0100 | [diff] [blame] | 52 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 53 | * struct iio_buffer - general buffer structure |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 54 | * @length: [DEVICE] number of datums in buffer |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 55 | * @bytes_per_datum: [DEVICE] size of individual datum including timestamp |
Manuel Stahl | bf32963 | 2010-08-31 11:32:52 +0200 | [diff] [blame] | 56 | * @scan_el_attrs: [DRIVER] control of scan elements if that scan mode |
| 57 | * control method is used |
Manuel Stahl | bf32963 | 2010-08-31 11:32:52 +0200 | [diff] [blame] | 58 | * @scan_mask: [INTERN] bitmask used in masking scan mode elements |
| 59 | * @scan_timestamp: [INTERN] does the scan mode include a timestamp |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 60 | * @access: [DRIVER] buffer access functions associated with the |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 61 | * implementation. |
Jonathan Cameron | 5f070a3 | 2011-12-05 22:18:30 +0000 | [diff] [blame] | 62 | * @scan_el_dev_attr_list:[INTERN] list of scan element related attributes. |
| 63 | * @scan_el_group: [DRIVER] attribute group for those attributes not |
| 64 | * created from the iio_chan_info array. |
| 65 | * @pollq: [INTERN] wait queue to allow for polling on the buffer. |
| 66 | * @stufftoread: [INTERN] flag to indicate new data. |
Jonathan Cameron | 5ada4ea | 2011-12-05 21:37:14 +0000 | [diff] [blame] | 67 | * @demux_list: [INTERN] list of operations required to demux the scan. |
| 68 | * @demux_bounce: [INTERN] buffer for doing gather from incoming scan. |
Jonathan Cameron | 84b36ce | 2012-06-30 20:06:00 +0100 | [diff] [blame] | 69 | * @buffer_list: [INTERN] entry in the devices list of current buffers. |
| 70 | */ |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 71 | struct iio_buffer { |
Jonathan Cameron | 8d213f2 | 2011-05-18 14:42:34 +0100 | [diff] [blame] | 72 | int length; |
| 73 | int bytes_per_datum; |
Jonathan Cameron | 8d213f2 | 2011-05-18 14:42:34 +0100 | [diff] [blame] | 74 | struct attribute_group *scan_el_attrs; |
Jonathan Cameron | 32b5eec | 2011-09-02 17:14:38 +0100 | [diff] [blame] | 75 | long *scan_mask; |
Jonathan Cameron | 8d213f2 | 2011-05-18 14:42:34 +0100 | [diff] [blame] | 76 | bool scan_timestamp; |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 77 | const struct iio_buffer_access_funcs *access; |
Jonathan Cameron | 8d213f2 | 2011-05-18 14:42:34 +0100 | [diff] [blame] | 78 | struct list_head scan_el_dev_attr_list; |
Jonathan Cameron | 26d25ae | 2011-09-02 17:14:40 +0100 | [diff] [blame] | 79 | struct attribute_group scan_el_group; |
Jonathan Cameron | 8d213f2 | 2011-05-18 14:42:34 +0100 | [diff] [blame] | 80 | wait_queue_head_t pollq; |
| 81 | bool stufftoread; |
Jonathan Cameron | 1aa0427 | 2011-08-30 12:32:47 +0100 | [diff] [blame] | 82 | const struct attribute_group *attrs; |
Jonathan Cameron | 5ada4ea | 2011-12-05 21:37:14 +0000 | [diff] [blame] | 83 | struct list_head demux_list; |
| 84 | unsigned char *demux_bounce; |
Jonathan Cameron | 84b36ce | 2012-06-30 20:06:00 +0100 | [diff] [blame] | 85 | struct list_head buffer_list; |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 86 | }; |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 87 | |
| 88 | /** |
Jonathan Cameron | 84b36ce | 2012-06-30 20:06:00 +0100 | [diff] [blame] | 89 | * iio_update_buffers() - add or remove buffer from active list |
| 90 | * @indio_dev: device to add buffer to |
| 91 | * @insert_buffer: buffer to insert |
| 92 | * @remove_buffer: buffer_to_remove |
| 93 | * |
| 94 | * Note this will tear down the all buffering and build it up again |
| 95 | */ |
| 96 | int iio_update_buffers(struct iio_dev *indio_dev, |
| 97 | struct iio_buffer *insert_buffer, |
| 98 | struct iio_buffer *remove_buffer); |
| 99 | |
| 100 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 101 | * iio_buffer_init() - Initialize the buffer structure |
Peter Meerwald | 3bdff93 | 2012-07-01 00:47:43 +0200 | [diff] [blame] | 102 | * @buffer: buffer to be initialized |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 103 | **/ |
Jonathan Cameron | f79a909 | 2011-12-05 22:18:29 +0000 | [diff] [blame] | 104 | void iio_buffer_init(struct iio_buffer *buffer); |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 105 | |
| 106 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 107 | * __iio_update_buffer() - update common elements of buffers |
| 108 | * @buffer: buffer that is the event source |
Randy Dunlap | 4c57260 | 2009-10-04 19:34:02 -0700 | [diff] [blame] | 109 | * @bytes_per_datum: size of individual datum including timestamp |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 110 | * @length: number of datums in buffer |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 111 | **/ |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 112 | static inline void __iio_update_buffer(struct iio_buffer *buffer, |
| 113 | int bytes_per_datum, int length) |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 114 | { |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 115 | buffer->bytes_per_datum = bytes_per_datum; |
| 116 | buffer->length = length; |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 117 | } |
| 118 | |
Jonathan Cameron | f79a909 | 2011-12-05 22:18:29 +0000 | [diff] [blame] | 119 | int iio_scan_mask_query(struct iio_dev *indio_dev, |
| 120 | struct iio_buffer *buffer, int bit); |
Manuel Stahl | bf32963 | 2010-08-31 11:32:52 +0200 | [diff] [blame] | 121 | |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 122 | /** |
| 123 | * iio_scan_mask_set() - set particular bit in the scan mask |
Peter Meerwald | 3bdff93 | 2012-07-01 00:47:43 +0200 | [diff] [blame] | 124 | * @indio_dev IIO device structure |
| 125 | * @buffer: the buffer whose scan mask we are interested in |
| 126 | * @bit: the bit to be set. |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 127 | **/ |
Jonathan Cameron | f79a909 | 2011-12-05 22:18:29 +0000 | [diff] [blame] | 128 | int iio_scan_mask_set(struct iio_dev *indio_dev, |
| 129 | struct iio_buffer *buffer, int bit); |
Manuel Stahl | bf32963 | 2010-08-31 11:32:52 +0200 | [diff] [blame] | 130 | |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 131 | /** |
Jonathan Cameron | 84b36ce | 2012-06-30 20:06:00 +0100 | [diff] [blame] | 132 | * iio_push_to_buffers() - push to a registered buffer. |
| 133 | * @indio_dev: iio_dev structure for device. |
| 134 | * @data: Full scan. |
Jonathan Cameron | 5ada4ea | 2011-12-05 21:37:14 +0000 | [diff] [blame] | 135 | */ |
Jonathan Cameron | 84b36ce | 2012-06-30 20:06:00 +0100 | [diff] [blame] | 136 | int iio_push_to_buffers(struct iio_dev *indio_dev, unsigned char *data); |
Jonathan Cameron | 5ada4ea | 2011-12-05 21:37:14 +0000 | [diff] [blame] | 137 | |
| 138 | int iio_update_demux(struct iio_dev *indio_dev); |
| 139 | |
| 140 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 141 | * iio_buffer_register() - register the buffer with IIO core |
Peter Meerwald | 3bdff93 | 2012-07-01 00:47:43 +0200 | [diff] [blame] | 142 | * @indio_dev: device with the buffer to be registered |
| 143 | * @channels: the channel descriptions used to construct buffer |
| 144 | * @num_channels: the number of channels |
Jonathan Cameron | 1d89271 | 2011-05-18 14:40:51 +0100 | [diff] [blame] | 145 | **/ |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 146 | int iio_buffer_register(struct iio_dev *indio_dev, |
| 147 | const struct iio_chan_spec *channels, |
| 148 | int num_channels); |
Jonathan Cameron | 1d89271 | 2011-05-18 14:40:51 +0100 | [diff] [blame] | 149 | |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 150 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 151 | * iio_buffer_unregister() - unregister the buffer from IIO core |
Peter Meerwald | 3bdff93 | 2012-07-01 00:47:43 +0200 | [diff] [blame] | 152 | * @indio_dev: the device with the buffer to be unregistered |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 153 | **/ |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 154 | void iio_buffer_unregister(struct iio_dev *indio_dev); |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 155 | |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 156 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 157 | * iio_buffer_read_length() - attr func to get number of datums in the buffer |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 158 | **/ |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 159 | ssize_t iio_buffer_read_length(struct device *dev, |
| 160 | struct device_attribute *attr, |
| 161 | char *buf); |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 162 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 163 | * iio_buffer_write_length() - attr func to set number of datums in the buffer |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 164 | **/ |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 165 | ssize_t iio_buffer_write_length(struct device *dev, |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 166 | struct device_attribute *attr, |
| 167 | const char *buf, |
| 168 | size_t len); |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 169 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 170 | * iio_buffer_store_enable() - attr to turn the buffer on |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 171 | **/ |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 172 | ssize_t iio_buffer_store_enable(struct device *dev, |
| 173 | struct device_attribute *attr, |
| 174 | const char *buf, |
| 175 | size_t len); |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 176 | /** |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 177 | * iio_buffer_show_enable() - attr to see if the buffer is on |
Jonathan Cameron | c3e5d41 | 2010-09-04 17:54:45 +0100 | [diff] [blame] | 178 | **/ |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 179 | ssize_t iio_buffer_show_enable(struct device *dev, |
| 180 | struct device_attribute *attr, |
| 181 | char *buf); |
| 182 | #define IIO_BUFFER_LENGTH_ATTR DEVICE_ATTR(length, S_IRUGO | S_IWUSR, \ |
| 183 | iio_buffer_read_length, \ |
| 184 | iio_buffer_write_length) |
Jonathan Cameron | 5565a45 | 2011-05-18 14:42:24 +0100 | [diff] [blame] | 185 | |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 186 | #define IIO_BUFFER_ENABLE_ATTR DEVICE_ATTR(enable, S_IRUGO | S_IWUSR, \ |
| 187 | iio_buffer_show_enable, \ |
| 188 | iio_buffer_store_enable) |
| 189 | |
| 190 | int iio_sw_buffer_preenable(struct iio_dev *indio_dev); |
Jonathan Cameron | 5565a45 | 2011-05-18 14:42:24 +0100 | [diff] [blame] | 191 | |
Lars-Peter Clausen | 8163663 | 2012-07-09 10:00:00 +0100 | [diff] [blame] | 192 | bool iio_validate_scan_mask_onehot(struct iio_dev *indio_dev, |
| 193 | const unsigned long *mask); |
| 194 | |
Jonathan Cameron | f2a9624 | 2011-09-21 11:15:55 +0100 | [diff] [blame] | 195 | #else /* CONFIG_IIO_BUFFER */ |
Jonathan Cameron | 1d89271 | 2011-05-18 14:40:51 +0100 | [diff] [blame] | 196 | |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 197 | static inline int iio_buffer_register(struct iio_dev *indio_dev, |
Jonathan Cameron | c009f7e | 2011-08-30 12:41:14 +0100 | [diff] [blame] | 198 | struct iio_chan_spec *channels, |
| 199 | int num_channels) |
Jonathan Cameron | 1d89271 | 2011-05-18 14:40:51 +0100 | [diff] [blame] | 200 | { |
| 201 | return 0; |
| 202 | } |
| 203 | |
Jonathan Cameron | 14555b1 | 2011-09-21 11:15:57 +0100 | [diff] [blame] | 204 | static inline void iio_buffer_unregister(struct iio_dev *indio_dev) |
Peter Meerwald | 19ea4752 | 2012-06-18 20:33:03 +0200 | [diff] [blame] | 205 | {} |
Jonathan Cameron | 2662051 | 2010-07-11 16:39:14 +0100 | [diff] [blame] | 206 | |
Jonathan Cameron | f2a9624 | 2011-09-21 11:15:55 +0100 | [diff] [blame] | 207 | #endif /* CONFIG_IIO_BUFFER */ |
Jonathan Cameron | 7026ea4 | 2009-08-18 18:06:24 +0100 | [diff] [blame] | 208 | |
Jonathan Cameron | 3811cd6 | 2011-09-21 11:15:56 +0100 | [diff] [blame] | 209 | #endif /* _IIO_BUFFER_GENERIC_H_ */ |