1 /* The industrial I/O core 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 * Handling of buffer allocation / resizing. 10 * 11 * 12 * Things to look at here. 13 * - Better memory allocation techniques? 14 * - Alternative access techniques? 15 */ 16 #include <linux/kernel.h> 17 #include <linux/export.h> 18 #include <linux/device.h> 19 #include <linux/fs.h> 20 #include <linux/cdev.h> 21 #include <linux/slab.h> 22 #include <linux/poll.h> 23 #include <linux/sched.h> 24 25 #include <linux/iio/iio.h> 26 #include "iio_core.h" 27 #include <linux/iio/sysfs.h> 28 #include <linux/iio/buffer.h> 29 30 static const char * const iio_endian_prefix[] = { 31 [IIO_BE] = "be", 32 [IIO_LE] = "le", 33 }; 34 35 static bool iio_buffer_is_active(struct iio_buffer *buf) 36 { 37 return !list_empty(&buf->buffer_list); 38 } 39 40 static size_t iio_buffer_data_available(struct iio_buffer *buf) 41 { 42 return buf->access->data_available(buf); 43 } 44 45 static int iio_buffer_flush_hwfifo(struct iio_dev *indio_dev, 46 struct iio_buffer *buf, size_t required) 47 { 48 if (!indio_dev->info->hwfifo_flush_to_buffer) 49 return -ENODEV; 50 51 return indio_dev->info->hwfifo_flush_to_buffer(indio_dev, required); 52 } 53 54 static bool iio_buffer_ready(struct iio_dev *indio_dev, struct iio_buffer *buf, 55 size_t to_wait, int to_flush) 56 { 57 size_t avail; 58 int flushed = 0; 59 60 /* wakeup if the device was unregistered */ 61 if (!indio_dev->info) 62 return true; 63 64 /* drain the buffer if it was disabled */ 65 if (!iio_buffer_is_active(buf)) { 66 to_wait = min_t(size_t, to_wait, 1); 67 to_flush = 0; 68 } 69 70 avail = iio_buffer_data_available(buf); 71 72 if (avail >= to_wait) { 73 /* force a flush for non-blocking reads */ 74 if (!to_wait && !avail && to_flush) 75 iio_buffer_flush_hwfifo(indio_dev, buf, to_flush); 76 return true; 77 } 78 79 if (to_flush) 80 flushed = iio_buffer_flush_hwfifo(indio_dev, buf, 81 to_wait - avail); 82 if (flushed <= 0) 83 return false; 84 85 if (avail + flushed >= to_wait) 86 return true; 87 88 return false; 89 } 90 91 /** 92 * iio_buffer_read_first_n_outer() - chrdev read for buffer access 93 * 94 * This function relies on all buffer implementations having an 95 * iio_buffer as their first element. 96 **/ 97 ssize_t iio_buffer_read_first_n_outer(struct file *filp, char __user *buf, 98 size_t n, loff_t *f_ps) 99 { 100 struct iio_dev *indio_dev = filp->private_data; 101 struct iio_buffer *rb = indio_dev->buffer; 102 size_t datum_size; 103 size_t to_wait = 0; 104 size_t to_read; 105 int ret; 106 107 if (!indio_dev->info) 108 return -ENODEV; 109 110 if (!rb || !rb->access->read_first_n) 111 return -EINVAL; 112 113 datum_size = rb->bytes_per_datum; 114 115 /* 116 * If datum_size is 0 there will never be anything to read from the 117 * buffer, so signal end of file now. 118 */ 119 if (!datum_size) 120 return 0; 121 122 to_read = min_t(size_t, n / datum_size, rb->watermark); 123 124 if (!(filp->f_flags & O_NONBLOCK)) 125 to_wait = to_read; 126 127 do { 128 ret = wait_event_interruptible(rb->pollq, 129 iio_buffer_ready(indio_dev, rb, to_wait, to_read)); 130 if (ret) 131 return ret; 132 133 if (!indio_dev->info) 134 return -ENODEV; 135 136 ret = rb->access->read_first_n(rb, n, buf); 137 if (ret == 0 && (filp->f_flags & O_NONBLOCK)) 138 ret = -EAGAIN; 139 } while (ret == 0); 140 141 return ret; 142 } 143 144 /** 145 * iio_buffer_poll() - poll the buffer to find out if it has data 146 */ 147 unsigned int iio_buffer_poll(struct file *filp, 148 struct poll_table_struct *wait) 149 { 150 struct iio_dev *indio_dev = filp->private_data; 151 struct iio_buffer *rb = indio_dev->buffer; 152 153 if (!indio_dev->info) 154 return -ENODEV; 155 156 poll_wait(filp, &rb->pollq, wait); 157 if (iio_buffer_ready(indio_dev, rb, rb->watermark, 0)) 158 return POLLIN | POLLRDNORM; 159 return 0; 160 } 161 162 /** 163 * iio_buffer_wakeup_poll - Wakes up the buffer waitqueue 164 * @indio_dev: The IIO device 165 * 166 * Wakes up the event waitqueue used for poll(). Should usually 167 * be called when the device is unregistered. 168 */ 169 void iio_buffer_wakeup_poll(struct iio_dev *indio_dev) 170 { 171 if (!indio_dev->buffer) 172 return; 173 174 wake_up(&indio_dev->buffer->pollq); 175 } 176 177 void iio_buffer_init(struct iio_buffer *buffer) 178 { 179 INIT_LIST_HEAD(&buffer->demux_list); 180 INIT_LIST_HEAD(&buffer->buffer_list); 181 init_waitqueue_head(&buffer->pollq); 182 kref_init(&buffer->ref); 183 buffer->watermark = 1; 184 } 185 EXPORT_SYMBOL(iio_buffer_init); 186 187 static ssize_t iio_show_scan_index(struct device *dev, 188 struct device_attribute *attr, 189 char *buf) 190 { 191 return sprintf(buf, "%u\n", to_iio_dev_attr(attr)->c->scan_index); 192 } 193 194 static ssize_t iio_show_fixed_type(struct device *dev, 195 struct device_attribute *attr, 196 char *buf) 197 { 198 struct iio_dev_attr *this_attr = to_iio_dev_attr(attr); 199 u8 type = this_attr->c->scan_type.endianness; 200 201 if (type == IIO_CPU) { 202 #ifdef __LITTLE_ENDIAN 203 type = IIO_LE; 204 #else 205 type = IIO_BE; 206 #endif 207 } 208 if (this_attr->c->scan_type.repeat > 1) 209 return sprintf(buf, "%s:%c%d/%dX%d>>%u\n", 210 iio_endian_prefix[type], 211 this_attr->c->scan_type.sign, 212 this_attr->c->scan_type.realbits, 213 this_attr->c->scan_type.storagebits, 214 this_attr->c->scan_type.repeat, 215 this_attr->c->scan_type.shift); 216 else 217 return sprintf(buf, "%s:%c%d/%d>>%u\n", 218 iio_endian_prefix[type], 219 this_attr->c->scan_type.sign, 220 this_attr->c->scan_type.realbits, 221 this_attr->c->scan_type.storagebits, 222 this_attr->c->scan_type.shift); 223 } 224 225 static ssize_t iio_scan_el_show(struct device *dev, 226 struct device_attribute *attr, 227 char *buf) 228 { 229 int ret; 230 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 231 232 /* Ensure ret is 0 or 1. */ 233 ret = !!test_bit(to_iio_dev_attr(attr)->address, 234 indio_dev->buffer->scan_mask); 235 236 return sprintf(buf, "%d\n", ret); 237 } 238 239 /* Note NULL used as error indicator as it doesn't make sense. */ 240 static const unsigned long *iio_scan_mask_match(const unsigned long *av_masks, 241 unsigned int masklength, 242 const unsigned long *mask) 243 { 244 if (bitmap_empty(mask, masklength)) 245 return NULL; 246 while (*av_masks) { 247 if (bitmap_subset(mask, av_masks, masklength)) 248 return av_masks; 249 av_masks += BITS_TO_LONGS(masklength); 250 } 251 return NULL; 252 } 253 254 static bool iio_validate_scan_mask(struct iio_dev *indio_dev, 255 const unsigned long *mask) 256 { 257 if (!indio_dev->setup_ops->validate_scan_mask) 258 return true; 259 260 return indio_dev->setup_ops->validate_scan_mask(indio_dev, mask); 261 } 262 263 /** 264 * iio_scan_mask_set() - set particular bit in the scan mask 265 * @indio_dev: the iio device 266 * @buffer: the buffer whose scan mask we are interested in 267 * @bit: the bit to be set. 268 * 269 * Note that at this point we have no way of knowing what other 270 * buffers might request, hence this code only verifies that the 271 * individual buffers request is plausible. 272 */ 273 static int iio_scan_mask_set(struct iio_dev *indio_dev, 274 struct iio_buffer *buffer, int bit) 275 { 276 const unsigned long *mask; 277 unsigned long *trialmask; 278 279 trialmask = kmalloc(sizeof(*trialmask)* 280 BITS_TO_LONGS(indio_dev->masklength), 281 GFP_KERNEL); 282 283 if (trialmask == NULL) 284 return -ENOMEM; 285 if (!indio_dev->masklength) { 286 WARN_ON("Trying to set scanmask prior to registering buffer\n"); 287 goto err_invalid_mask; 288 } 289 bitmap_copy(trialmask, buffer->scan_mask, indio_dev->masklength); 290 set_bit(bit, trialmask); 291 292 if (!iio_validate_scan_mask(indio_dev, trialmask)) 293 goto err_invalid_mask; 294 295 if (indio_dev->available_scan_masks) { 296 mask = iio_scan_mask_match(indio_dev->available_scan_masks, 297 indio_dev->masklength, 298 trialmask); 299 if (!mask) 300 goto err_invalid_mask; 301 } 302 bitmap_copy(buffer->scan_mask, trialmask, indio_dev->masklength); 303 304 kfree(trialmask); 305 306 return 0; 307 308 err_invalid_mask: 309 kfree(trialmask); 310 return -EINVAL; 311 } 312 313 static int iio_scan_mask_clear(struct iio_buffer *buffer, int bit) 314 { 315 clear_bit(bit, buffer->scan_mask); 316 return 0; 317 } 318 319 static ssize_t iio_scan_el_store(struct device *dev, 320 struct device_attribute *attr, 321 const char *buf, 322 size_t len) 323 { 324 int ret; 325 bool state; 326 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 327 struct iio_buffer *buffer = indio_dev->buffer; 328 struct iio_dev_attr *this_attr = to_iio_dev_attr(attr); 329 330 ret = strtobool(buf, &state); 331 if (ret < 0) 332 return ret; 333 mutex_lock(&indio_dev->mlock); 334 if (iio_buffer_is_active(indio_dev->buffer)) { 335 ret = -EBUSY; 336 goto error_ret; 337 } 338 ret = iio_scan_mask_query(indio_dev, buffer, this_attr->address); 339 if (ret < 0) 340 goto error_ret; 341 if (!state && ret) { 342 ret = iio_scan_mask_clear(buffer, this_attr->address); 343 if (ret) 344 goto error_ret; 345 } else if (state && !ret) { 346 ret = iio_scan_mask_set(indio_dev, buffer, this_attr->address); 347 if (ret) 348 goto error_ret; 349 } 350 351 error_ret: 352 mutex_unlock(&indio_dev->mlock); 353 354 return ret < 0 ? ret : len; 355 356 } 357 358 static ssize_t iio_scan_el_ts_show(struct device *dev, 359 struct device_attribute *attr, 360 char *buf) 361 { 362 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 363 return sprintf(buf, "%d\n", indio_dev->buffer->scan_timestamp); 364 } 365 366 static ssize_t iio_scan_el_ts_store(struct device *dev, 367 struct device_attribute *attr, 368 const char *buf, 369 size_t len) 370 { 371 int ret; 372 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 373 bool state; 374 375 ret = strtobool(buf, &state); 376 if (ret < 0) 377 return ret; 378 379 mutex_lock(&indio_dev->mlock); 380 if (iio_buffer_is_active(indio_dev->buffer)) { 381 ret = -EBUSY; 382 goto error_ret; 383 } 384 indio_dev->buffer->scan_timestamp = state; 385 error_ret: 386 mutex_unlock(&indio_dev->mlock); 387 388 return ret ? ret : len; 389 } 390 391 static int iio_buffer_add_channel_sysfs(struct iio_dev *indio_dev, 392 const struct iio_chan_spec *chan) 393 { 394 int ret, attrcount = 0; 395 struct iio_buffer *buffer = indio_dev->buffer; 396 397 ret = __iio_add_chan_devattr("index", 398 chan, 399 &iio_show_scan_index, 400 NULL, 401 0, 402 IIO_SEPARATE, 403 &indio_dev->dev, 404 &buffer->scan_el_dev_attr_list); 405 if (ret) 406 return ret; 407 attrcount++; 408 ret = __iio_add_chan_devattr("type", 409 chan, 410 &iio_show_fixed_type, 411 NULL, 412 0, 413 0, 414 &indio_dev->dev, 415 &buffer->scan_el_dev_attr_list); 416 if (ret) 417 return ret; 418 attrcount++; 419 if (chan->type != IIO_TIMESTAMP) 420 ret = __iio_add_chan_devattr("en", 421 chan, 422 &iio_scan_el_show, 423 &iio_scan_el_store, 424 chan->scan_index, 425 0, 426 &indio_dev->dev, 427 &buffer->scan_el_dev_attr_list); 428 else 429 ret = __iio_add_chan_devattr("en", 430 chan, 431 &iio_scan_el_ts_show, 432 &iio_scan_el_ts_store, 433 chan->scan_index, 434 0, 435 &indio_dev->dev, 436 &buffer->scan_el_dev_attr_list); 437 if (ret) 438 return ret; 439 attrcount++; 440 ret = attrcount; 441 return ret; 442 } 443 444 static ssize_t iio_buffer_read_length(struct device *dev, 445 struct device_attribute *attr, 446 char *buf) 447 { 448 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 449 struct iio_buffer *buffer = indio_dev->buffer; 450 451 return sprintf(buf, "%d\n", buffer->length); 452 } 453 454 static ssize_t iio_buffer_write_length(struct device *dev, 455 struct device_attribute *attr, 456 const char *buf, size_t len) 457 { 458 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 459 struct iio_buffer *buffer = indio_dev->buffer; 460 unsigned int val; 461 int ret; 462 463 ret = kstrtouint(buf, 10, &val); 464 if (ret) 465 return ret; 466 467 if (val == buffer->length) 468 return len; 469 470 mutex_lock(&indio_dev->mlock); 471 if (iio_buffer_is_active(indio_dev->buffer)) { 472 ret = -EBUSY; 473 } else { 474 buffer->access->set_length(buffer, val); 475 ret = 0; 476 } 477 if (ret) 478 goto out; 479 if (buffer->length && buffer->length < buffer->watermark) 480 buffer->watermark = buffer->length; 481 out: 482 mutex_unlock(&indio_dev->mlock); 483 484 return ret ? ret : len; 485 } 486 487 static ssize_t iio_buffer_show_enable(struct device *dev, 488 struct device_attribute *attr, 489 char *buf) 490 { 491 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 492 return sprintf(buf, "%d\n", iio_buffer_is_active(indio_dev->buffer)); 493 } 494 495 static int iio_compute_scan_bytes(struct iio_dev *indio_dev, 496 const unsigned long *mask, bool timestamp) 497 { 498 const struct iio_chan_spec *ch; 499 unsigned bytes = 0; 500 int length, i; 501 502 /* How much space will the demuxed element take? */ 503 for_each_set_bit(i, mask, 504 indio_dev->masklength) { 505 ch = iio_find_channel_from_si(indio_dev, i); 506 if (ch->scan_type.repeat > 1) 507 length = ch->scan_type.storagebits / 8 * 508 ch->scan_type.repeat; 509 else 510 length = ch->scan_type.storagebits / 8; 511 bytes = ALIGN(bytes, length); 512 bytes += length; 513 } 514 if (timestamp) { 515 ch = iio_find_channel_from_si(indio_dev, 516 indio_dev->scan_index_timestamp); 517 if (ch->scan_type.repeat > 1) 518 length = ch->scan_type.storagebits / 8 * 519 ch->scan_type.repeat; 520 else 521 length = ch->scan_type.storagebits / 8; 522 bytes = ALIGN(bytes, length); 523 bytes += length; 524 } 525 return bytes; 526 } 527 528 static void iio_buffer_activate(struct iio_dev *indio_dev, 529 struct iio_buffer *buffer) 530 { 531 iio_buffer_get(buffer); 532 list_add(&buffer->buffer_list, &indio_dev->buffer_list); 533 } 534 535 static void iio_buffer_deactivate(struct iio_buffer *buffer) 536 { 537 list_del_init(&buffer->buffer_list); 538 wake_up_interruptible(&buffer->pollq); 539 iio_buffer_put(buffer); 540 } 541 542 static void iio_buffer_update_bytes_per_datum(struct iio_dev *indio_dev, 543 struct iio_buffer *buffer) 544 { 545 unsigned int bytes; 546 547 if (!buffer->access->set_bytes_per_datum) 548 return; 549 550 bytes = iio_compute_scan_bytes(indio_dev, buffer->scan_mask, 551 buffer->scan_timestamp); 552 553 buffer->access->set_bytes_per_datum(buffer, bytes); 554 } 555 556 static int iio_buffer_request_update(struct iio_dev *indio_dev, 557 struct iio_buffer *buffer) 558 { 559 int ret; 560 561 iio_buffer_update_bytes_per_datum(indio_dev, buffer); 562 if (buffer->access->request_update) { 563 ret = buffer->access->request_update(buffer); 564 if (ret) { 565 dev_dbg(&indio_dev->dev, 566 "Buffer not started: buffer parameter update failed (%d)\n", 567 ret); 568 return ret; 569 } 570 } 571 572 return 0; 573 } 574 575 static void iio_free_scan_mask(struct iio_dev *indio_dev, 576 const unsigned long *mask) 577 { 578 /* If the mask is dynamically allocated free it, otherwise do nothing */ 579 if (!indio_dev->available_scan_masks) 580 kfree(mask); 581 } 582 583 struct iio_device_config { 584 unsigned int mode; 585 const unsigned long *scan_mask; 586 unsigned int scan_bytes; 587 bool scan_timestamp; 588 }; 589 590 static int iio_verify_update(struct iio_dev *indio_dev, 591 struct iio_buffer *insert_buffer, struct iio_buffer *remove_buffer, 592 struct iio_device_config *config) 593 { 594 unsigned long *compound_mask; 595 const unsigned long *scan_mask; 596 struct iio_buffer *buffer; 597 bool scan_timestamp; 598 599 memset(config, 0, sizeof(*config)); 600 601 /* 602 * If there is just one buffer and we are removing it there is nothing 603 * to verify. 604 */ 605 if (remove_buffer && !insert_buffer && 606 list_is_singular(&indio_dev->buffer_list)) 607 return 0; 608 609 /* Definitely possible for devices to support both of these. */ 610 if ((indio_dev->modes & INDIO_BUFFER_TRIGGERED) && indio_dev->trig) { 611 config->mode = INDIO_BUFFER_TRIGGERED; 612 } else if (indio_dev->modes & INDIO_BUFFER_HARDWARE) { 613 config->mode = INDIO_BUFFER_HARDWARE; 614 } else if (indio_dev->modes & INDIO_BUFFER_SOFTWARE) { 615 config->mode = INDIO_BUFFER_SOFTWARE; 616 } else { 617 /* Can only occur on first buffer */ 618 if (indio_dev->modes & INDIO_BUFFER_TRIGGERED) 619 dev_dbg(&indio_dev->dev, "Buffer not started: no trigger\n"); 620 return -EINVAL; 621 } 622 623 /* What scan mask do we actually have? */ 624 compound_mask = kcalloc(BITS_TO_LONGS(indio_dev->masklength), 625 sizeof(long), GFP_KERNEL); 626 if (compound_mask == NULL) 627 return -ENOMEM; 628 629 scan_timestamp = false; 630 631 list_for_each_entry(buffer, &indio_dev->buffer_list, buffer_list) { 632 if (buffer == remove_buffer) 633 continue; 634 bitmap_or(compound_mask, compound_mask, buffer->scan_mask, 635 indio_dev->masklength); 636 scan_timestamp |= buffer->scan_timestamp; 637 } 638 639 if (insert_buffer) { 640 bitmap_or(compound_mask, compound_mask, 641 insert_buffer->scan_mask, indio_dev->masklength); 642 scan_timestamp |= insert_buffer->scan_timestamp; 643 } 644 645 if (indio_dev->available_scan_masks) { 646 scan_mask = iio_scan_mask_match(indio_dev->available_scan_masks, 647 indio_dev->masklength, 648 compound_mask); 649 kfree(compound_mask); 650 if (scan_mask == NULL) 651 return -EINVAL; 652 } else { 653 scan_mask = compound_mask; 654 } 655 656 config->scan_bytes = iio_compute_scan_bytes(indio_dev, 657 scan_mask, scan_timestamp); 658 config->scan_mask = scan_mask; 659 config->scan_timestamp = scan_timestamp; 660 661 return 0; 662 } 663 664 static int iio_enable_buffers(struct iio_dev *indio_dev, 665 struct iio_device_config *config) 666 { 667 int ret; 668 669 indio_dev->active_scan_mask = config->scan_mask; 670 indio_dev->scan_timestamp = config->scan_timestamp; 671 indio_dev->scan_bytes = config->scan_bytes; 672 673 iio_update_demux(indio_dev); 674 675 /* Wind up again */ 676 if (indio_dev->setup_ops->preenable) { 677 ret = indio_dev->setup_ops->preenable(indio_dev); 678 if (ret) { 679 dev_dbg(&indio_dev->dev, 680 "Buffer not started: buffer preenable failed (%d)\n", ret); 681 goto err_undo_config; 682 } 683 } 684 685 if (indio_dev->info->update_scan_mode) { 686 ret = indio_dev->info 687 ->update_scan_mode(indio_dev, 688 indio_dev->active_scan_mask); 689 if (ret < 0) { 690 dev_dbg(&indio_dev->dev, 691 "Buffer not started: update scan mode failed (%d)\n", 692 ret); 693 goto err_run_postdisable; 694 } 695 } 696 697 indio_dev->currentmode = config->mode; 698 699 if (indio_dev->setup_ops->postenable) { 700 ret = indio_dev->setup_ops->postenable(indio_dev); 701 if (ret) { 702 dev_dbg(&indio_dev->dev, 703 "Buffer not started: postenable failed (%d)\n", ret); 704 goto err_run_postdisable; 705 } 706 } 707 708 return 0; 709 710 err_run_postdisable: 711 indio_dev->currentmode = INDIO_DIRECT_MODE; 712 if (indio_dev->setup_ops->postdisable) 713 indio_dev->setup_ops->postdisable(indio_dev); 714 err_undo_config: 715 indio_dev->active_scan_mask = NULL; 716 717 return ret; 718 } 719 720 static int iio_disable_buffers(struct iio_dev *indio_dev) 721 { 722 int ret; 723 724 /* Wind down existing buffers - iff there are any */ 725 if (list_empty(&indio_dev->buffer_list)) 726 return 0; 727 728 if (indio_dev->setup_ops->predisable) { 729 ret = indio_dev->setup_ops->predisable(indio_dev); 730 if (ret) 731 return ret; 732 } 733 734 indio_dev->currentmode = INDIO_DIRECT_MODE; 735 736 if (indio_dev->setup_ops->postdisable) { 737 ret = indio_dev->setup_ops->postdisable(indio_dev); 738 if (ret) 739 return ret; 740 } 741 742 return 0; 743 } 744 745 static int __iio_update_buffers(struct iio_dev *indio_dev, 746 struct iio_buffer *insert_buffer, 747 struct iio_buffer *remove_buffer) 748 { 749 int ret; 750 const unsigned long *old_mask; 751 struct iio_device_config new_config; 752 753 ret = iio_verify_update(indio_dev, insert_buffer, remove_buffer, 754 &new_config); 755 if (ret) 756 return ret; 757 758 if (insert_buffer) { 759 ret = iio_buffer_request_update(indio_dev, insert_buffer); 760 if (ret) 761 goto err_free_config; 762 } 763 764 /* Keep a copy of current setup to allow roll back */ 765 old_mask = indio_dev->active_scan_mask; 766 indio_dev->active_scan_mask = NULL; 767 768 ret = iio_disable_buffers(indio_dev); 769 if (ret) { 770 iio_free_scan_mask(indio_dev, old_mask); 771 goto err_free_config; 772 } 773 774 if (remove_buffer) 775 iio_buffer_deactivate(remove_buffer); 776 if (insert_buffer) 777 iio_buffer_activate(indio_dev, insert_buffer); 778 779 /* If no buffers in list, we are done */ 780 if (list_empty(&indio_dev->buffer_list)) { 781 iio_free_scan_mask(indio_dev, old_mask); 782 return 0; 783 } 784 785 ret = iio_enable_buffers(indio_dev, &new_config); 786 if (ret) { 787 if (insert_buffer) 788 iio_buffer_deactivate(insert_buffer); 789 indio_dev->active_scan_mask = old_mask; 790 goto err_free_config; 791 } 792 793 iio_free_scan_mask(indio_dev, old_mask); 794 return 0; 795 796 err_free_config: 797 iio_free_scan_mask(indio_dev, new_config.scan_mask); 798 return ret; 799 } 800 801 int iio_update_buffers(struct iio_dev *indio_dev, 802 struct iio_buffer *insert_buffer, 803 struct iio_buffer *remove_buffer) 804 { 805 int ret; 806 807 if (insert_buffer == remove_buffer) 808 return 0; 809 810 mutex_lock(&indio_dev->info_exist_lock); 811 mutex_lock(&indio_dev->mlock); 812 813 if (insert_buffer && iio_buffer_is_active(insert_buffer)) 814 insert_buffer = NULL; 815 816 if (remove_buffer && !iio_buffer_is_active(remove_buffer)) 817 remove_buffer = NULL; 818 819 if (!insert_buffer && !remove_buffer) { 820 ret = 0; 821 goto out_unlock; 822 } 823 824 if (indio_dev->info == NULL) { 825 ret = -ENODEV; 826 goto out_unlock; 827 } 828 829 ret = __iio_update_buffers(indio_dev, insert_buffer, remove_buffer); 830 831 out_unlock: 832 mutex_unlock(&indio_dev->mlock); 833 mutex_unlock(&indio_dev->info_exist_lock); 834 835 return ret; 836 } 837 EXPORT_SYMBOL_GPL(iio_update_buffers); 838 839 void iio_disable_all_buffers(struct iio_dev *indio_dev) 840 { 841 struct iio_buffer *buffer, *_buffer; 842 843 iio_disable_buffers(indio_dev); 844 iio_free_scan_mask(indio_dev, indio_dev->active_scan_mask); 845 indio_dev->active_scan_mask = NULL; 846 847 list_for_each_entry_safe(buffer, _buffer, 848 &indio_dev->buffer_list, buffer_list) 849 iio_buffer_deactivate(buffer); 850 } 851 852 static ssize_t iio_buffer_store_enable(struct device *dev, 853 struct device_attribute *attr, 854 const char *buf, 855 size_t len) 856 { 857 int ret; 858 bool requested_state; 859 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 860 bool inlist; 861 862 ret = strtobool(buf, &requested_state); 863 if (ret < 0) 864 return ret; 865 866 mutex_lock(&indio_dev->mlock); 867 868 /* Find out if it is in the list */ 869 inlist = iio_buffer_is_active(indio_dev->buffer); 870 /* Already in desired state */ 871 if (inlist == requested_state) 872 goto done; 873 874 if (requested_state) 875 ret = __iio_update_buffers(indio_dev, 876 indio_dev->buffer, NULL); 877 else 878 ret = __iio_update_buffers(indio_dev, 879 NULL, indio_dev->buffer); 880 881 if (ret < 0) 882 goto done; 883 done: 884 mutex_unlock(&indio_dev->mlock); 885 return (ret < 0) ? ret : len; 886 } 887 888 static const char * const iio_scan_elements_group_name = "scan_elements"; 889 890 static ssize_t iio_buffer_show_watermark(struct device *dev, 891 struct device_attribute *attr, 892 char *buf) 893 { 894 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 895 struct iio_buffer *buffer = indio_dev->buffer; 896 897 return sprintf(buf, "%u\n", buffer->watermark); 898 } 899 900 static ssize_t iio_buffer_store_watermark(struct device *dev, 901 struct device_attribute *attr, 902 const char *buf, 903 size_t len) 904 { 905 struct iio_dev *indio_dev = dev_to_iio_dev(dev); 906 struct iio_buffer *buffer = indio_dev->buffer; 907 unsigned int val; 908 int ret; 909 910 ret = kstrtouint(buf, 10, &val); 911 if (ret) 912 return ret; 913 if (!val) 914 return -EINVAL; 915 916 mutex_lock(&indio_dev->mlock); 917 918 if (val > buffer->length) { 919 ret = -EINVAL; 920 goto out; 921 } 922 923 if (iio_buffer_is_active(indio_dev->buffer)) { 924 ret = -EBUSY; 925 goto out; 926 } 927 928 buffer->watermark = val; 929 930 if (indio_dev->info->hwfifo_set_watermark) 931 indio_dev->info->hwfifo_set_watermark(indio_dev, val); 932 out: 933 mutex_unlock(&indio_dev->mlock); 934 935 return ret ? ret : len; 936 } 937 938 static DEVICE_ATTR(length, S_IRUGO | S_IWUSR, iio_buffer_read_length, 939 iio_buffer_write_length); 940 static struct device_attribute dev_attr_length_ro = __ATTR(length, 941 S_IRUGO, iio_buffer_read_length, NULL); 942 static DEVICE_ATTR(enable, S_IRUGO | S_IWUSR, 943 iio_buffer_show_enable, iio_buffer_store_enable); 944 static DEVICE_ATTR(watermark, S_IRUGO | S_IWUSR, 945 iio_buffer_show_watermark, iio_buffer_store_watermark); 946 947 static struct attribute *iio_buffer_attrs[] = { 948 &dev_attr_length.attr, 949 &dev_attr_enable.attr, 950 &dev_attr_watermark.attr, 951 }; 952 953 int iio_buffer_alloc_sysfs_and_mask(struct iio_dev *indio_dev) 954 { 955 struct iio_dev_attr *p; 956 struct attribute **attr; 957 struct iio_buffer *buffer = indio_dev->buffer; 958 int ret, i, attrn, attrcount, attrcount_orig = 0; 959 const struct iio_chan_spec *channels; 960 961 if (!buffer) 962 return 0; 963 964 attrcount = 0; 965 if (buffer->attrs) { 966 while (buffer->attrs[attrcount] != NULL) 967 attrcount++; 968 } 969 970 attr = kcalloc(attrcount + ARRAY_SIZE(iio_buffer_attrs) + 1, 971 sizeof(struct attribute *), GFP_KERNEL); 972 if (!attr) 973 return -ENOMEM; 974 975 memcpy(attr, iio_buffer_attrs, sizeof(iio_buffer_attrs)); 976 if (!buffer->access->set_length) 977 attr[0] = &dev_attr_length_ro.attr; 978 979 if (buffer->attrs) 980 memcpy(&attr[ARRAY_SIZE(iio_buffer_attrs)], buffer->attrs, 981 sizeof(struct attribute *) * attrcount); 982 983 attr[attrcount + ARRAY_SIZE(iio_buffer_attrs)] = NULL; 984 985 buffer->buffer_group.name = "buffer"; 986 buffer->buffer_group.attrs = attr; 987 988 indio_dev->groups[indio_dev->groupcounter++] = &buffer->buffer_group; 989 990 if (buffer->scan_el_attrs != NULL) { 991 attr = buffer->scan_el_attrs->attrs; 992 while (*attr++ != NULL) 993 attrcount_orig++; 994 } 995 attrcount = attrcount_orig; 996 INIT_LIST_HEAD(&buffer->scan_el_dev_attr_list); 997 channels = indio_dev->channels; 998 if (channels) { 999 /* new magic */ 1000 for (i = 0; i < indio_dev->num_channels; i++) { 1001 if (channels[i].scan_index < 0) 1002 continue; 1003 1004 /* Establish necessary mask length */ 1005 if (channels[i].scan_index > 1006 (int)indio_dev->masklength - 1) 1007 indio_dev->masklength 1008 = channels[i].scan_index + 1; 1009 1010 ret = iio_buffer_add_channel_sysfs(indio_dev, 1011 &channels[i]); 1012 if (ret < 0) 1013 goto error_cleanup_dynamic; 1014 attrcount += ret; 1015 if (channels[i].type == IIO_TIMESTAMP) 1016 indio_dev->scan_index_timestamp = 1017 channels[i].scan_index; 1018 } 1019 if (indio_dev->masklength && buffer->scan_mask == NULL) { 1020 buffer->scan_mask = kcalloc(BITS_TO_LONGS(indio_dev->masklength), 1021 sizeof(*buffer->scan_mask), 1022 GFP_KERNEL); 1023 if (buffer->scan_mask == NULL) { 1024 ret = -ENOMEM; 1025 goto error_cleanup_dynamic; 1026 } 1027 } 1028 } 1029 1030 buffer->scan_el_group.name = iio_scan_elements_group_name; 1031 1032 buffer->scan_el_group.attrs = kcalloc(attrcount + 1, 1033 sizeof(buffer->scan_el_group.attrs[0]), 1034 GFP_KERNEL); 1035 if (buffer->scan_el_group.attrs == NULL) { 1036 ret = -ENOMEM; 1037 goto error_free_scan_mask; 1038 } 1039 if (buffer->scan_el_attrs) 1040 memcpy(buffer->scan_el_group.attrs, buffer->scan_el_attrs, 1041 sizeof(buffer->scan_el_group.attrs[0])*attrcount_orig); 1042 attrn = attrcount_orig; 1043 1044 list_for_each_entry(p, &buffer->scan_el_dev_attr_list, l) 1045 buffer->scan_el_group.attrs[attrn++] = &p->dev_attr.attr; 1046 indio_dev->groups[indio_dev->groupcounter++] = &buffer->scan_el_group; 1047 1048 return 0; 1049 1050 error_free_scan_mask: 1051 kfree(buffer->scan_mask); 1052 error_cleanup_dynamic: 1053 iio_free_chan_devattr_list(&buffer->scan_el_dev_attr_list); 1054 kfree(indio_dev->buffer->buffer_group.attrs); 1055 1056 return ret; 1057 } 1058 1059 void iio_buffer_free_sysfs_and_mask(struct iio_dev *indio_dev) 1060 { 1061 if (!indio_dev->buffer) 1062 return; 1063 1064 kfree(indio_dev->buffer->scan_mask); 1065 kfree(indio_dev->buffer->buffer_group.attrs); 1066 kfree(indio_dev->buffer->scan_el_group.attrs); 1067 iio_free_chan_devattr_list(&indio_dev->buffer->scan_el_dev_attr_list); 1068 } 1069 1070 /** 1071 * iio_validate_scan_mask_onehot() - Validates that exactly one channel is selected 1072 * @indio_dev: the iio device 1073 * @mask: scan mask to be checked 1074 * 1075 * Return true if exactly one bit is set in the scan mask, false otherwise. It 1076 * can be used for devices where only one channel can be active for sampling at 1077 * a time. 1078 */ 1079 bool iio_validate_scan_mask_onehot(struct iio_dev *indio_dev, 1080 const unsigned long *mask) 1081 { 1082 return bitmap_weight(mask, indio_dev->masklength) == 1; 1083 } 1084 EXPORT_SYMBOL_GPL(iio_validate_scan_mask_onehot); 1085 1086 int iio_scan_mask_query(struct iio_dev *indio_dev, 1087 struct iio_buffer *buffer, int bit) 1088 { 1089 if (bit > indio_dev->masklength) 1090 return -EINVAL; 1091 1092 if (!buffer->scan_mask) 1093 return 0; 1094 1095 /* Ensure return value is 0 or 1. */ 1096 return !!test_bit(bit, buffer->scan_mask); 1097 }; 1098 EXPORT_SYMBOL_GPL(iio_scan_mask_query); 1099 1100 /** 1101 * struct iio_demux_table() - table describing demux memcpy ops 1102 * @from: index to copy from 1103 * @to: index to copy to 1104 * @length: how many bytes to copy 1105 * @l: list head used for management 1106 */ 1107 struct iio_demux_table { 1108 unsigned from; 1109 unsigned to; 1110 unsigned length; 1111 struct list_head l; 1112 }; 1113 1114 static const void *iio_demux(struct iio_buffer *buffer, 1115 const void *datain) 1116 { 1117 struct iio_demux_table *t; 1118 1119 if (list_empty(&buffer->demux_list)) 1120 return datain; 1121 list_for_each_entry(t, &buffer->demux_list, l) 1122 memcpy(buffer->demux_bounce + t->to, 1123 datain + t->from, t->length); 1124 1125 return buffer->demux_bounce; 1126 } 1127 1128 static int iio_push_to_buffer(struct iio_buffer *buffer, const void *data) 1129 { 1130 const void *dataout = iio_demux(buffer, data); 1131 int ret; 1132 1133 ret = buffer->access->store_to(buffer, dataout); 1134 if (ret) 1135 return ret; 1136 1137 /* 1138 * We can't just test for watermark to decide if we wake the poll queue 1139 * because read may request less samples than the watermark. 1140 */ 1141 wake_up_interruptible_poll(&buffer->pollq, POLLIN | POLLRDNORM); 1142 return 0; 1143 } 1144 1145 static void iio_buffer_demux_free(struct iio_buffer *buffer) 1146 { 1147 struct iio_demux_table *p, *q; 1148 list_for_each_entry_safe(p, q, &buffer->demux_list, l) { 1149 list_del(&p->l); 1150 kfree(p); 1151 } 1152 } 1153 1154 1155 int iio_push_to_buffers(struct iio_dev *indio_dev, const void *data) 1156 { 1157 int ret; 1158 struct iio_buffer *buf; 1159 1160 list_for_each_entry(buf, &indio_dev->buffer_list, buffer_list) { 1161 ret = iio_push_to_buffer(buf, data); 1162 if (ret < 0) 1163 return ret; 1164 } 1165 1166 return 0; 1167 } 1168 EXPORT_SYMBOL_GPL(iio_push_to_buffers); 1169 1170 static int iio_buffer_add_demux(struct iio_buffer *buffer, 1171 struct iio_demux_table **p, unsigned int in_loc, unsigned int out_loc, 1172 unsigned int length) 1173 { 1174 1175 if (*p && (*p)->from + (*p)->length == in_loc && 1176 (*p)->to + (*p)->length == out_loc) { 1177 (*p)->length += length; 1178 } else { 1179 *p = kmalloc(sizeof(**p), GFP_KERNEL); 1180 if (*p == NULL) 1181 return -ENOMEM; 1182 (*p)->from = in_loc; 1183 (*p)->to = out_loc; 1184 (*p)->length = length; 1185 list_add_tail(&(*p)->l, &buffer->demux_list); 1186 } 1187 1188 return 0; 1189 } 1190 1191 static int iio_buffer_update_demux(struct iio_dev *indio_dev, 1192 struct iio_buffer *buffer) 1193 { 1194 const struct iio_chan_spec *ch; 1195 int ret, in_ind = -1, out_ind, length; 1196 unsigned in_loc = 0, out_loc = 0; 1197 struct iio_demux_table *p = NULL; 1198 1199 /* Clear out any old demux */ 1200 iio_buffer_demux_free(buffer); 1201 kfree(buffer->demux_bounce); 1202 buffer->demux_bounce = NULL; 1203 1204 /* First work out which scan mode we will actually have */ 1205 if (bitmap_equal(indio_dev->active_scan_mask, 1206 buffer->scan_mask, 1207 indio_dev->masklength)) 1208 return 0; 1209 1210 /* Now we have the two masks, work from least sig and build up sizes */ 1211 for_each_set_bit(out_ind, 1212 buffer->scan_mask, 1213 indio_dev->masklength) { 1214 in_ind = find_next_bit(indio_dev->active_scan_mask, 1215 indio_dev->masklength, 1216 in_ind + 1); 1217 while (in_ind != out_ind) { 1218 in_ind = find_next_bit(indio_dev->active_scan_mask, 1219 indio_dev->masklength, 1220 in_ind + 1); 1221 ch = iio_find_channel_from_si(indio_dev, in_ind); 1222 if (ch->scan_type.repeat > 1) 1223 length = ch->scan_type.storagebits / 8 * 1224 ch->scan_type.repeat; 1225 else 1226 length = ch->scan_type.storagebits / 8; 1227 /* Make sure we are aligned */ 1228 in_loc = roundup(in_loc, length) + length; 1229 } 1230 ch = iio_find_channel_from_si(indio_dev, in_ind); 1231 if (ch->scan_type.repeat > 1) 1232 length = ch->scan_type.storagebits / 8 * 1233 ch->scan_type.repeat; 1234 else 1235 length = ch->scan_type.storagebits / 8; 1236 out_loc = roundup(out_loc, length); 1237 in_loc = roundup(in_loc, length); 1238 ret = iio_buffer_add_demux(buffer, &p, in_loc, out_loc, length); 1239 if (ret) 1240 goto error_clear_mux_table; 1241 out_loc += length; 1242 in_loc += length; 1243 } 1244 /* Relies on scan_timestamp being last */ 1245 if (buffer->scan_timestamp) { 1246 ch = iio_find_channel_from_si(indio_dev, 1247 indio_dev->scan_index_timestamp); 1248 if (ch->scan_type.repeat > 1) 1249 length = ch->scan_type.storagebits / 8 * 1250 ch->scan_type.repeat; 1251 else 1252 length = ch->scan_type.storagebits / 8; 1253 out_loc = roundup(out_loc, length); 1254 in_loc = roundup(in_loc, length); 1255 ret = iio_buffer_add_demux(buffer, &p, in_loc, out_loc, length); 1256 if (ret) 1257 goto error_clear_mux_table; 1258 out_loc += length; 1259 in_loc += length; 1260 } 1261 buffer->demux_bounce = kzalloc(out_loc, GFP_KERNEL); 1262 if (buffer->demux_bounce == NULL) { 1263 ret = -ENOMEM; 1264 goto error_clear_mux_table; 1265 } 1266 return 0; 1267 1268 error_clear_mux_table: 1269 iio_buffer_demux_free(buffer); 1270 1271 return ret; 1272 } 1273 1274 int iio_update_demux(struct iio_dev *indio_dev) 1275 { 1276 struct iio_buffer *buffer; 1277 int ret; 1278 1279 list_for_each_entry(buffer, &indio_dev->buffer_list, buffer_list) { 1280 ret = iio_buffer_update_demux(indio_dev, buffer); 1281 if (ret < 0) 1282 goto error_clear_mux_table; 1283 } 1284 return 0; 1285 1286 error_clear_mux_table: 1287 list_for_each_entry(buffer, &indio_dev->buffer_list, buffer_list) 1288 iio_buffer_demux_free(buffer); 1289 1290 return ret; 1291 } 1292 EXPORT_SYMBOL_GPL(iio_update_demux); 1293 1294 /** 1295 * iio_buffer_release() - Free a buffer's resources 1296 * @ref: Pointer to the kref embedded in the iio_buffer struct 1297 * 1298 * This function is called when the last reference to the buffer has been 1299 * dropped. It will typically free all resources allocated by the buffer. Do not 1300 * call this function manually, always use iio_buffer_put() when done using a 1301 * buffer. 1302 */ 1303 static void iio_buffer_release(struct kref *ref) 1304 { 1305 struct iio_buffer *buffer = container_of(ref, struct iio_buffer, ref); 1306 1307 buffer->access->release(buffer); 1308 } 1309 1310 /** 1311 * iio_buffer_get() - Grab a reference to the buffer 1312 * @buffer: The buffer to grab a reference for, may be NULL 1313 * 1314 * Returns the pointer to the buffer that was passed into the function. 1315 */ 1316 struct iio_buffer *iio_buffer_get(struct iio_buffer *buffer) 1317 { 1318 if (buffer) 1319 kref_get(&buffer->ref); 1320 1321 return buffer; 1322 } 1323 EXPORT_SYMBOL_GPL(iio_buffer_get); 1324 1325 /** 1326 * iio_buffer_put() - Release the reference to the buffer 1327 * @buffer: The buffer to release the reference for, may be NULL 1328 */ 1329 void iio_buffer_put(struct iio_buffer *buffer) 1330 { 1331 if (buffer) 1332 kref_put(&buffer->ref, iio_buffer_release); 1333 } 1334 EXPORT_SYMBOL_GPL(iio_buffer_put); 1335