1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * Copyright (c) 2011 Jonathan Cameron 4 * 5 * Buffer handling elements of industrial I/O reference driver. 6 * Uses the kfifo buffer. 7 * 8 * To test without hardware use the sysfs trigger. 9 */ 10 11 #include <linux/kernel.h> 12 #include <linux/export.h> 13 #include <linux/slab.h> 14 #include <linux/interrupt.h> 15 #include <linux/irq.h> 16 #include <linux/bitmap.h> 17 18 #include <linux/iio/iio.h> 19 #include <linux/iio/trigger_consumer.h> 20 #include <linux/iio/buffer.h> 21 #include <linux/iio/kfifo_buf.h> 22 23 #include "iio_simple_dummy.h" 24 25 /* Some fake data */ 26 27 static const s16 fakedata[] = { 28 [DUMMY_INDEX_VOLTAGE_0] = 7, 29 [DUMMY_INDEX_DIFFVOLTAGE_1M2] = -33, 30 [DUMMY_INDEX_DIFFVOLTAGE_3M4] = -2, 31 [DUMMY_INDEX_ACCELX] = 344, 32 }; 33 34 /** 35 * iio_simple_dummy_trigger_h() - the trigger handler function 36 * @irq: the interrupt number 37 * @p: private data - always a pointer to the poll func. 38 * 39 * This is the guts of buffered capture. On a trigger event occurring, 40 * if the pollfunc is attached then this handler is called as a threaded 41 * interrupt (and hence may sleep). It is responsible for grabbing data 42 * from the device and pushing it into the associated buffer. 43 */ 44 static irqreturn_t iio_simple_dummy_trigger_h(int irq, void *p) 45 { 46 struct iio_poll_func *pf = p; 47 struct iio_dev *indio_dev = pf->indio_dev; 48 int len = 0; 49 u16 *data; 50 51 data = kmalloc(indio_dev->scan_bytes, GFP_KERNEL); 52 if (!data) 53 goto done; 54 55 if (!bitmap_empty(indio_dev->active_scan_mask, indio_dev->masklength)) { 56 /* 57 * Three common options here: 58 * hardware scans: certain combinations of channels make 59 * up a fast read. The capture will consist of all of them. 60 * Hence we just call the grab data function and fill the 61 * buffer without processing. 62 * software scans: can be considered to be random access 63 * so efficient reading is just a case of minimal bus 64 * transactions. 65 * software culled hardware scans: 66 * occasionally a driver may process the nearest hardware 67 * scan to avoid storing elements that are not desired. This 68 * is the fiddliest option by far. 69 * Here let's pretend we have random access. And the values are 70 * in the constant table fakedata. 71 */ 72 int i, j; 73 74 for (i = 0, j = 0; 75 i < bitmap_weight(indio_dev->active_scan_mask, 76 indio_dev->masklength); 77 i++, j++) { 78 j = find_next_bit(indio_dev->active_scan_mask, 79 indio_dev->masklength, j); 80 /* random access read from the 'device' */ 81 data[i] = fakedata[j]; 82 len += 2; 83 } 84 } 85 86 iio_push_to_buffers_with_timestamp(indio_dev, data, 87 iio_get_time_ns(indio_dev)); 88 89 kfree(data); 90 91 done: 92 /* 93 * Tell the core we are done with this trigger and ready for the 94 * next one. 95 */ 96 iio_trigger_notify_done(indio_dev->trig); 97 98 return IRQ_HANDLED; 99 } 100 101 static const struct iio_buffer_setup_ops iio_simple_dummy_buffer_setup_ops = { 102 }; 103 104 int iio_simple_dummy_configure_buffer(struct iio_dev *indio_dev) 105 { 106 int ret; 107 struct iio_buffer *buffer; 108 109 /* Allocate a buffer to use - here a kfifo */ 110 buffer = iio_kfifo_allocate(); 111 if (!buffer) { 112 ret = -ENOMEM; 113 goto error_ret; 114 } 115 116 iio_device_attach_buffer(indio_dev, buffer); 117 118 /* 119 * Tell the core what device type specific functions should 120 * be run on either side of buffer capture enable / disable. 121 */ 122 indio_dev->setup_ops = &iio_simple_dummy_buffer_setup_ops; 123 124 /* 125 * Configure a polling function. 126 * When a trigger event with this polling function connected 127 * occurs, this function is run. Typically this grabs data 128 * from the device. 129 * 130 * NULL for the bottom half. This is normally implemented only if we 131 * either want to ping a capture now pin (no sleeping) or grab 132 * a timestamp as close as possible to a data ready trigger firing. 133 * 134 * IRQF_ONESHOT ensures irqs are masked such that only one instance 135 * of the handler can run at a time. 136 * 137 * "iio_simple_dummy_consumer%d" formatting string for the irq 'name' 138 * as seen under /proc/interrupts. Remaining parameters as per printk. 139 */ 140 indio_dev->pollfunc = iio_alloc_pollfunc(NULL, 141 &iio_simple_dummy_trigger_h, 142 IRQF_ONESHOT, 143 indio_dev, 144 "iio_simple_dummy_consumer%d", 145 indio_dev->id); 146 147 if (!indio_dev->pollfunc) { 148 ret = -ENOMEM; 149 goto error_free_buffer; 150 } 151 152 /* 153 * Notify the core that this device is capable of buffered capture 154 * driven by a trigger. 155 */ 156 indio_dev->modes |= INDIO_BUFFER_TRIGGERED; 157 158 return 0; 159 160 error_free_buffer: 161 iio_kfifo_free(indio_dev->buffer); 162 error_ret: 163 return ret; 164 } 165 166 /** 167 * iio_simple_dummy_unconfigure_buffer() - release buffer resources 168 * @indio_dev: device instance state 169 */ 170 void iio_simple_dummy_unconfigure_buffer(struct iio_dev *indio_dev) 171 { 172 iio_dealloc_pollfunc(indio_dev->pollfunc); 173 iio_kfifo_free(indio_dev->buffer); 174 } 175