drivers/iio/industrialio-trigger.c

   1 /* The industrial I/O core, trigger handling functions
   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
  10 #include <linux/kernel.h>
  11 #include <linux/idr.h>
  12 #include <linux/err.h>
  13 #include <linux/device.h>
  14 #include <linux/interrupt.h>
  15 #include <linux/list.h>
  16 #include <linux/slab.h>
  17
  18 #include <linux/iio/iio.h>
  19 #include <linux/iio/trigger.h>
  20 #include "iio_core.h"
  21 #include "iio_core_trigger.h"
  22 #include <linux/iio/trigger_consumer.h>
  23
  24 /* RFC - Question of approach
  25  * Make the common case (single sensor single trigger)
  26  * simple by starting trigger capture from when first sensors
  27  * is added.
  28  *
  29  * Complex simultaneous start requires use of 'hold' functionality
  30  * of the trigger. (not implemented)
  31  *
  32  * Any other suggestions?
  33  */
  34
  35 static DEFINE_IDA(iio_trigger_ida);
  36
  37 /* Single list of all available triggers */
  38 static LIST_HEAD(iio_trigger_list);
  39 static DEFINE_MUTEX(iio_trigger_list_lock);
  40
  41 /**
  42  * iio_trigger_read_name() - retrieve useful identifying name
  43  * @dev:        device associated with the iio_trigger
  44  * @attr:       pointer to the device_attribute structure that is
  45  *              being processed
  46  * @buf:        buffer to print the name into
  47  *
  48  * Return: a negative number on failure or the number of written
  49  *         characters on success.
  50  */
  51 static ssize_t iio_trigger_read_name(struct device *dev,
  52                                      struct device_attribute *attr,
  53                                      char *buf)
  54 {
  55         struct iio_trigger *trig = to_iio_trigger(dev);
  56         return sprintf(buf, "%s\n", trig->name);
  57 }
  58
  59 static DEVICE_ATTR(name, S_IRUGO, iio_trigger_read_name, NULL);
  60
  61 static struct attribute *iio_trig_dev_attrs[] = {
  62         &dev_attr_name.attr,
  63         NULL,
  64 };
  65 ATTRIBUTE_GROUPS(iio_trig_dev);
  66
  67 static struct iio_trigger *__iio_trigger_find_by_name(const char *name);
  68
  69 int iio_trigger_register(struct iio_trigger *trig_info)
  70 {
  71         int ret;
  72
  73         /* trig_info->ops is required for the module member */
  74         if (!trig_info->ops)
  75                 return -EINVAL;
  76
  77         trig_info->id = ida_simple_get(&iio_trigger_ida, 0, 0, GFP_KERNEL);
  78         if (trig_info->id < 0)
  79                 return trig_info->id;
  80
  81         /* Set the name used for the sysfs directory etc */
  82         dev_set_name(&trig_info->dev, "trigger%ld",
  83                      (unsigned long) trig_info->id);
  84
  85         ret = device_add(&trig_info->dev);
  86         if (ret)
  87                 goto error_unregister_id;
  88
  89         /* Add to list of available triggers held by the IIO core */
  90         mutex_lock(&iio_trigger_list_lock);
  91         if (__iio_trigger_find_by_name(trig_info->name)) {
  92                 pr_err("Duplicate trigger name '%s'\n", trig_info->name);
  93                 ret = -EEXIST;
  94                 goto error_device_del;
  95         }
  96         list_add_tail(&trig_info->list, &iio_trigger_list);
  97         mutex_unlock(&iio_trigger_list_lock);
  98
  99         return 0;
 100
 101 error_device_del:
 102         mutex_unlock(&iio_trigger_list_lock);
 103         device_del(&trig_info->dev);
 104 error_unregister_id:
 105         ida_simple_remove(&iio_trigger_ida, trig_info->id);
 106         return ret;
 107 }
 108 EXPORT_SYMBOL(iio_trigger_register);
 109
 110 void iio_trigger_unregister(struct iio_trigger *trig_info)
 111 {
 112         mutex_lock(&iio_trigger_list_lock);
 113         list_del(&trig_info->list);
 114         mutex_unlock(&iio_trigger_list_lock);
 115
 116         ida_simple_remove(&iio_trigger_ida, trig_info->id);
 117         /* Possible issue in here */
 118         device_del(&trig_info->dev);
 119 }
 120 EXPORT_SYMBOL(iio_trigger_unregister);
 121
 122 int iio_trigger_set_immutable(struct iio_dev *indio_dev, struct iio_trigger *trig)
 123 {
 124         if (!indio_dev || !trig)
 125                 return -EINVAL;
 126
 127         mutex_lock(&indio_dev->mlock);
 128         WARN_ON(indio_dev->trig_readonly);
 129
 130         indio_dev->trig = iio_trigger_get(trig);
 131         indio_dev->trig_readonly = true;
 132         mutex_unlock(&indio_dev->mlock);
 133
 134         return 0;
 135 }
 136 EXPORT_SYMBOL(iio_trigger_set_immutable);
 137
 138 /* Search for trigger by name, assuming iio_trigger_list_lock held */
 139 static struct iio_trigger *__iio_trigger_find_by_name(const char *name)
 140 {
 141         struct iio_trigger *iter;
 142
 143         list_for_each_entry(iter, &iio_trigger_list, list)
 144                 if (!strcmp(iter->name, name))
 145                         return iter;
 146
 147         return NULL;
 148 }
 149
 150 static struct iio_trigger *iio_trigger_acquire_by_name(const char *name)
 151 {
 152         struct iio_trigger *trig = NULL, *iter;
 153
 154         mutex_lock(&iio_trigger_list_lock);
 155         list_for_each_entry(iter, &iio_trigger_list, list)
 156                 if (sysfs_streq(iter->name, name)) {
 157                         trig = iter;
 158                         iio_trigger_get(trig);
 159                         break;
 160                 }
 161         mutex_unlock(&iio_trigger_list_lock);
 162
 163         return trig;
 164 }
 165
 166 void iio_trigger_poll(struct iio_trigger *trig)
 167 {
 168         int i;
 169
 170         if (!atomic_read(&trig->use_count)) {
 171                 atomic_set(&trig->use_count, CONFIG_IIO_CONSUMERS_PER_TRIGGER);
 172
 173                 for (i = 0; i < CONFIG_IIO_CONSUMERS_PER_TRIGGER; i++) {
 174                         if (trig->subirqs[i].enabled)
 175                                 generic_handle_irq(trig->subirq_base + i);
 176                         else
 177                                 iio_trigger_notify_done(trig);
 178                 }
 179         }
 180 }
 181 EXPORT_SYMBOL(iio_trigger_poll);
 182
 183 irqreturn_t iio_trigger_generic_data_rdy_poll(int irq, void *private)
 184 {
 185         iio_trigger_poll(private);
 186         return IRQ_HANDLED;
 187 }
 188 EXPORT_SYMBOL(iio_trigger_generic_data_rdy_poll);
 189
 190 void iio_trigger_poll_chained(struct iio_trigger *trig)
 191 {
 192         int i;
 193
 194         if (!atomic_read(&trig->use_count)) {
 195                 atomic_set(&trig->use_count, CONFIG_IIO_CONSUMERS_PER_TRIGGER);
 196
 197                 for (i = 0; i < CONFIG_IIO_CONSUMERS_PER_TRIGGER; i++) {
 198                         if (trig->subirqs[i].enabled)
 199                                 handle_nested_irq(trig->subirq_base + i);
 200                         else
 201                                 iio_trigger_notify_done(trig);
 202                 }
 203         }
 204 }
 205 EXPORT_SYMBOL(iio_trigger_poll_chained);
 206
 207 void iio_trigger_notify_done(struct iio_trigger *trig)
 208 {
 209         if (atomic_dec_and_test(&trig->use_count) && trig->ops->try_reenable)
 210                 if (trig->ops->try_reenable(trig))
 211                         /* Missed an interrupt so launch new poll now */
 212                         iio_trigger_poll(trig);
 213 }
 214 EXPORT_SYMBOL(iio_trigger_notify_done);
 215
 216 /* Trigger Consumer related functions */
 217 static int iio_trigger_get_irq(struct iio_trigger *trig)
 218 {
 219         int ret;
 220         mutex_lock(&trig->pool_lock);
 221         ret = bitmap_find_free_region(trig->pool,
 222                                       CONFIG_IIO_CONSUMERS_PER_TRIGGER,
 223                                       ilog2(1));
 224         mutex_unlock(&trig->pool_lock);
 225         if (ret >= 0)
 226                 ret += trig->subirq_base;
 227
 228         return ret;
 229 }
 230
 231 static void iio_trigger_put_irq(struct iio_trigger *trig, int irq)
 232 {
 233         mutex_lock(&trig->pool_lock);
 234         clear_bit(irq - trig->subirq_base, trig->pool);
 235         mutex_unlock(&trig->pool_lock);
 236 }
 237
 238 /* Complexity in here.  With certain triggers (datardy) an acknowledgement
 239  * may be needed if the pollfuncs do not include the data read for the
 240  * triggering device.
 241  * This is not currently handled.  Alternative of not enabling trigger unless
 242  * the relevant function is in there may be the best option.
 243  */
 244 /* Worth protecting against double additions? */
 245 static int iio_trigger_attach_poll_func(struct iio_trigger *trig,
 246                                         struct iio_poll_func *pf)
 247 {
 248         int ret = 0;
 249         bool notinuse
 250                 = bitmap_empty(trig->pool, CONFIG_IIO_CONSUMERS_PER_TRIGGER);
 251
 252         /* Prevent the module from being removed whilst attached to a trigger */
 253         __module_get(pf->indio_dev->info->driver_module);
 254
 255         /* Get irq number */
 256         pf->irq = iio_trigger_get_irq(trig);
 257         if (pf->irq < 0)
 258                 goto out_put_module;
 259
 260         /* Request irq */
 261         ret = request_threaded_irq(pf->irq, pf->h, pf->thread,
 262                                    pf->type, pf->name,
 263                                    pf);
 264         if (ret < 0)
 265                 goto out_put_irq;
 266
 267         /* Enable trigger in driver */
 268         if (trig->ops->set_trigger_state && notinuse) {
 269                 ret = trig->ops->set_trigger_state(trig, true);
 270                 if (ret < 0)
 271                         goto out_free_irq;
 272         }
 273
 274         /*
 275          * Check if we just registered to our own trigger: we determine that
 276          * this is the case if the IIO device and the trigger device share the
 277          * same parent device.
 278          */
 279         if (pf->indio_dev->dev.parent == trig->dev.parent)
 280                 trig->attached_own_device = true;
 281
 282         return ret;
 283
 284 out_free_irq:
 285         free_irq(pf->irq, pf);
 286 out_put_irq:
 287         iio_trigger_put_irq(trig, pf->irq);
 288 out_put_module:
 289         module_put(pf->indio_dev->info->driver_module);
 290         return ret;
 291 }
 292
 293 static int iio_trigger_detach_poll_func(struct iio_trigger *trig,
 294                                          struct iio_poll_func *pf)
 295 {
 296         int ret = 0;
 297         bool no_other_users
 298                 = (bitmap_weight(trig->pool,
 299                                  CONFIG_IIO_CONSUMERS_PER_TRIGGER)
 300                    == 1);
 301         if (trig->ops->set_trigger_state && no_other_users) {
 302                 ret = trig->ops->set_trigger_state(trig, false);
 303                 if (ret)
 304                         return ret;
 305         }
 306         if (pf->indio_dev->dev.parent == trig->dev.parent)
 307                 trig->attached_own_device = false;
 308         iio_trigger_put_irq(trig, pf->irq);
 309         free_irq(pf->irq, pf);
 310         module_put(pf->indio_dev->info->driver_module);
 311
 312         return ret;
 313 }
 314
 315 irqreturn_t iio_pollfunc_store_time(int irq, void *p)
 316 {
 317         struct iio_poll_func *pf = p;
 318         pf->timestamp = iio_get_time_ns(pf->indio_dev);
 319         return IRQ_WAKE_THREAD;
 320 }
 321 EXPORT_SYMBOL(iio_pollfunc_store_time);
 322
 323 struct iio_poll_func
 324 *iio_alloc_pollfunc(irqreturn_t (*h)(int irq, void *p),
 325                     irqreturn_t (*thread)(int irq, void *p),
 326                     int type,
 327                     struct iio_dev *indio_dev,
 328                     const char *fmt,
 329                     ...)
 330 {
 331         va_list vargs;
 332         struct iio_poll_func *pf;
 333
 334         pf = kmalloc(sizeof *pf, GFP_KERNEL);
 335         if (pf == NULL)
 336                 return NULL;
 337         va_start(vargs, fmt);
 338         pf->name = kvasprintf(GFP_KERNEL, fmt, vargs);
 339         va_end(vargs);
 340         if (pf->name == NULL) {
 341                 kfree(pf);
 342                 return NULL;
 343         }
 344         pf->h = h;
 345         pf->thread = thread;
 346         pf->type = type;
 347         pf->indio_dev = indio_dev;
 348
 349         return pf;
 350 }
 351 EXPORT_SYMBOL_GPL(iio_alloc_pollfunc);
 352
 353 void iio_dealloc_pollfunc(struct iio_poll_func *pf)
 354 {
 355         kfree(pf->name);
 356         kfree(pf);
 357 }
 358 EXPORT_SYMBOL_GPL(iio_dealloc_pollfunc);
 359
 360 /**
 361  * iio_trigger_read_current() - trigger consumer sysfs query current trigger
 362  * @dev:        device associated with an industrial I/O device
 363  * @attr:       pointer to the device_attribute structure that
 364  *              is being processed
 365  * @buf:        buffer where the current trigger name will be printed into
 366  *
 367  * For trigger consumers the current_trigger interface allows the trigger
 368  * used by the device to be queried.
 369  *
 370  * Return: a negative number on failure, the number of characters written
 371  *         on success or 0 if no trigger is available
 372  */
 373 static ssize_t iio_trigger_read_current(struct device *dev,
 374                                         struct device_attribute *attr,
 375                                         char *buf)
 376 {
 377         struct iio_dev *indio_dev = dev_to_iio_dev(dev);
 378
 379         if (indio_dev->trig)
 380                 return sprintf(buf, "%s\n", indio_dev->trig->name);
 381         return 0;
 382 }
 383
 384 /**
 385  * iio_trigger_write_current() - trigger consumer sysfs set current trigger
 386  * @dev:        device associated with an industrial I/O device
 387  * @attr:       device attribute that is being processed
 388  * @buf:        string buffer that holds the name of the trigger
 389  * @len:        length of the trigger name held by buf
 390  *
 391  * For trigger consumers the current_trigger interface allows the trigger
 392  * used for this device to be specified at run time based on the trigger's
 393  * name.
 394  *
 395  * Return: negative error code on failure or length of the buffer
 396  *         on success
 397  */
 398 static ssize_t iio_trigger_write_current(struct device *dev,
 399                                          struct device_attribute *attr,
 400                                          const char *buf,
 401                                          size_t len)
 402 {
 403         struct iio_dev *indio_dev = dev_to_iio_dev(dev);
 404         struct iio_trigger *oldtrig = indio_dev->trig;
 405         struct iio_trigger *trig;
 406         int ret;
 407
 408         mutex_lock(&indio_dev->mlock);
 409         if (indio_dev->currentmode == INDIO_BUFFER_TRIGGERED) {
 410                 mutex_unlock(&indio_dev->mlock);
 411                 return -EBUSY;
 412         }
 413         if (indio_dev->trig_readonly) {
 414                 mutex_unlock(&indio_dev->mlock);
 415                 return -EPERM;
 416         }
 417         mutex_unlock(&indio_dev->mlock);
 418
 419         trig = iio_trigger_acquire_by_name(buf);
 420         if (oldtrig == trig) {
 421                 ret = len;
 422                 goto out_trigger_put;
 423         }
 424
 425         if (trig && indio_dev->info->validate_trigger) {
 426                 ret = indio_dev->info->validate_trigger(indio_dev, trig);
 427                 if (ret)
 428                         goto out_trigger_put;
 429         }
 430
 431         if (trig && trig->ops->validate_device) {
 432                 ret = trig->ops->validate_device(trig, indio_dev);
 433                 if (ret)
 434                         goto out_trigger_put;
 435         }
 436
 437         indio_dev->trig = trig;
 438
 439         if (oldtrig) {
 440                 if (indio_dev->modes & INDIO_EVENT_TRIGGERED)
 441                         iio_trigger_detach_poll_func(oldtrig,
 442                                                      indio_dev->pollfunc_event);
 443                 iio_trigger_put(oldtrig);
 444         }
 445         if (indio_dev->trig) {
 446                 if (indio_dev->modes & INDIO_EVENT_TRIGGERED)
 447                         iio_trigger_attach_poll_func(indio_dev->trig,
 448                                                      indio_dev->pollfunc_event);
 449         }
 450
 451         return len;
 452
 453 out_trigger_put:
 454         iio_trigger_put(trig);
 455         return ret;
 456 }
 457
 458 static DEVICE_ATTR(current_trigger, S_IRUGO | S_IWUSR,
 459                    iio_trigger_read_current,
 460                    iio_trigger_write_current);
 461
 462 static struct attribute *iio_trigger_consumer_attrs[] = {
 463         &dev_attr_current_trigger.attr,
 464         NULL,
 465 };
 466
 467 static const struct attribute_group iio_trigger_consumer_attr_group = {
 468         .name = "trigger",
 469         .attrs = iio_trigger_consumer_attrs,
 470 };
 471
 472 static void iio_trig_release(struct device *device)
 473 {
 474         struct iio_trigger *trig = to_iio_trigger(device);
 475         int i;
 476
 477         if (trig->subirq_base) {
 478                 for (i = 0; i < CONFIG_IIO_CONSUMERS_PER_TRIGGER; i++) {
 479                         irq_modify_status(trig->subirq_base + i,
 480                                           IRQ_NOAUTOEN,
 481                                           IRQ_NOREQUEST | IRQ_NOPROBE);
 482                         irq_set_chip(trig->subirq_base + i,
 483                                      NULL);
 484                         irq_set_handler(trig->subirq_base + i,
 485                                         NULL);
 486                 }
 487
 488                 irq_free_descs(trig->subirq_base,
 489                                CONFIG_IIO_CONSUMERS_PER_TRIGGER);
 490         }
 491         kfree(trig->name);
 492         kfree(trig);
 493 }
 494
 495 static const struct device_type iio_trig_type = {
 496         .release = iio_trig_release,
 497         .groups = iio_trig_dev_groups,
 498 };
 499
 500 static void iio_trig_subirqmask(struct irq_data *d)
 501 {
 502         struct irq_chip *chip = irq_data_get_irq_chip(d);
 503         struct iio_trigger *trig
 504                 = container_of(chip,
 505                                struct iio_trigger, subirq_chip);
 506         trig->subirqs[d->irq - trig->subirq_base].enabled = false;
 507 }
 508
 509 static void iio_trig_subirqunmask(struct irq_data *d)
 510 {
 511         struct irq_chip *chip = irq_data_get_irq_chip(d);
 512         struct iio_trigger *trig
 513                 = container_of(chip,
 514                                struct iio_trigger, subirq_chip);
 515         trig->subirqs[d->irq - trig->subirq_base].enabled = true;
 516 }
 517
 518 static struct iio_trigger *viio_trigger_alloc(const char *fmt, va_list vargs)
 519 {
 520         struct iio_trigger *trig;
 521         int i;
 522
 523         trig = kzalloc(sizeof *trig, GFP_KERNEL);
 524         if (!trig)
 525                 return NULL;
 526
 527         trig->dev.type = &iio_trig_type;
 528         trig->dev.bus = &iio_bus_type;
 529         device_initialize(&trig->dev);
 530
 531         mutex_init(&trig->pool_lock);
 532         trig->subirq_base = irq_alloc_descs(-1, 0,
 533                                             CONFIG_IIO_CONSUMERS_PER_TRIGGER,
 534                                             0);
 535         if (trig->subirq_base < 0)
 536                 goto free_trig;
 537
 538         trig->name = kvasprintf(GFP_KERNEL, fmt, vargs);
 539         if (trig->name == NULL)
 540                 goto free_descs;
 541
 542         trig->subirq_chip.name = trig->name;
 543         trig->subirq_chip.irq_mask = &iio_trig_subirqmask;
 544         trig->subirq_chip.irq_unmask = &iio_trig_subirqunmask;
 545         for (i = 0; i < CONFIG_IIO_CONSUMERS_PER_TRIGGER; i++) {
 546                 irq_set_chip(trig->subirq_base + i, &trig->subirq_chip);
 547                 irq_set_handler(trig->subirq_base + i, &handle_simple_irq);
 548                 irq_modify_status(trig->subirq_base + i,
 549                                   IRQ_NOREQUEST | IRQ_NOAUTOEN, IRQ_NOPROBE);
 550         }
 551         get_device(&trig->dev);
 552
 553         return trig;
 554
 555 free_descs:
 556         irq_free_descs(trig->subirq_base, CONFIG_IIO_CONSUMERS_PER_TRIGGER);
 557 free_trig:
 558         kfree(trig);
 559         return NULL;
 560 }
 561
 562 struct iio_trigger *iio_trigger_alloc(const char *fmt, ...)
 563 {
 564         struct iio_trigger *trig;
 565         va_list vargs;
 566
 567         va_start(vargs, fmt);
 568         trig = viio_trigger_alloc(fmt, vargs);
 569         va_end(vargs);
 570
 571         return trig;
 572 }
 573 EXPORT_SYMBOL(iio_trigger_alloc);
 574
 575 void iio_trigger_free(struct iio_trigger *trig)
 576 {
 577         if (trig)
 578                 put_device(&trig->dev);
 579 }
 580 EXPORT_SYMBOL(iio_trigger_free);
 581
 582 static void devm_iio_trigger_release(struct device *dev, void *res)
 583 {
 584         iio_trigger_free(*(struct iio_trigger **)res);
 585 }
 586
 587 static int devm_iio_trigger_match(struct device *dev, void *res, void *data)
 588 {
 589         struct iio_trigger **r = res;
 590
 591         if (!r || !*r) {
 592                 WARN_ON(!r || !*r);
 593                 return 0;
 594         }
 595
 596         return *r == data;
 597 }
 598
 599 /**
 600  * devm_iio_trigger_alloc - Resource-managed iio_trigger_alloc()
 601  * @dev:                Device to allocate iio_trigger for
 602  * @fmt:                trigger name format. If it includes format
 603  *                      specifiers, the additional arguments following
 604  *                      format are formatted and inserted in the resulting
 605  *                      string replacing their respective specifiers.
 606  *
 607  * Managed iio_trigger_alloc.  iio_trigger allocated with this function is
 608  * automatically freed on driver detach.
 609  *
 610  * If an iio_trigger allocated with this function needs to be freed separately,
 611  * devm_iio_trigger_free() must be used.
 612  *
 613  * RETURNS:
 614  * Pointer to allocated iio_trigger on success, NULL on failure.
 615  */
 616 struct iio_trigger *devm_iio_trigger_alloc(struct device *dev,
 617                                                 const char *fmt, ...)
 618 {
 619         struct iio_trigger **ptr, *trig;
 620         va_list vargs;
 621
 622         ptr = devres_alloc(devm_iio_trigger_release, sizeof(*ptr),
 623                            GFP_KERNEL);
 624         if (!ptr)
 625                 return NULL;
 626
 627         /* use raw alloc_dr for kmalloc caller tracing */
 628         va_start(vargs, fmt);
 629         trig = viio_trigger_alloc(fmt, vargs);
 630         va_end(vargs);
 631         if (trig) {
 632                 *ptr = trig;
 633                 devres_add(dev, ptr);
 634         } else {
 635                 devres_free(ptr);
 636         }
 637
 638         return trig;
 639 }
 640 EXPORT_SYMBOL_GPL(devm_iio_trigger_alloc);
 641
 642 /**
 643  * devm_iio_trigger_free - Resource-managed iio_trigger_free()
 644  * @dev:                Device this iio_dev belongs to
 645  * @iio_trig:           the iio_trigger associated with the device
 646  *
 647  * Free iio_trigger allocated with devm_iio_trigger_alloc().
 648  */
 649 void devm_iio_trigger_free(struct device *dev, struct iio_trigger *iio_trig)
 650 {
 651         int rc;
 652
 653         rc = devres_release(dev, devm_iio_trigger_release,
 654                             devm_iio_trigger_match, iio_trig);
 655         WARN_ON(rc);
 656 }
 657 EXPORT_SYMBOL_GPL(devm_iio_trigger_free);
 658
 659 static void devm_iio_trigger_unreg(struct device *dev, void *res)
 660 {
 661         iio_trigger_unregister(*(struct iio_trigger **)res);
 662 }
 663
 664 /**
 665  * devm_iio_trigger_register - Resource-managed iio_trigger_register()
 666  * @dev:        device this trigger was allocated for
 667  * @trig_info:  trigger to register
 668  *
 669  * Managed iio_trigger_register().  The IIO trigger registered with this
 670  * function is automatically unregistered on driver detach. This function
 671  * calls iio_trigger_register() internally. Refer to that function for more
 672  * information.
 673  *
 674  * If an iio_trigger registered with this function needs to be unregistered
 675  * separately, devm_iio_trigger_unregister() must be used.
 676  *
 677  * RETURNS:
 678  * 0 on success, negative error number on failure.
 679  */
 680 int devm_iio_trigger_register(struct device *dev, struct iio_trigger *trig_info)
 681 {
 682         struct iio_trigger **ptr;
 683         int ret;
 684
 685         ptr = devres_alloc(devm_iio_trigger_unreg, sizeof(*ptr), GFP_KERNEL);
 686         if (!ptr)
 687                 return -ENOMEM;
 688
 689         *ptr = trig_info;
 690         ret = iio_trigger_register(trig_info);
 691         if (!ret)
 692                 devres_add(dev, ptr);
 693         else
 694                 devres_free(ptr);
 695
 696         return ret;
 697 }
 698 EXPORT_SYMBOL_GPL(devm_iio_trigger_register);
 699
 700 /**
 701  * devm_iio_trigger_unregister - Resource-managed iio_trigger_unregister()
 702  * @dev:        device this iio_trigger belongs to
 703  * @trig_info:  the trigger associated with the device
 704  *
 705  * Unregister trigger registered with devm_iio_trigger_register().
 706  */
 707 void devm_iio_trigger_unregister(struct device *dev,
 708                                  struct iio_trigger *trig_info)
 709 {
 710         int rc;
 711
 712         rc = devres_release(dev, devm_iio_trigger_unreg, devm_iio_trigger_match,
 713                             trig_info);
 714         WARN_ON(rc);
 715 }
 716 EXPORT_SYMBOL_GPL(devm_iio_trigger_unregister);
 717
 718 bool iio_trigger_using_own(struct iio_dev *indio_dev)
 719 {
 720         return indio_dev->trig->attached_own_device;
 721 }
 722 EXPORT_SYMBOL(iio_trigger_using_own);
 723
 724 /**
 725  * iio_trigger_validate_own_device - Check if a trigger and IIO device belong to
 726  *  the same device
 727  * @trig: The IIO trigger to check
 728  * @indio_dev: the IIO device to check
 729  *
 730  * This function can be used as the validate_device callback for triggers that
 731  * can only be attached to their own device.
 732  *
 733  * Return: 0 if both the trigger and the IIO device belong to the same
 734  * device, -EINVAL otherwise.
 735  */
 736 int iio_trigger_validate_own_device(struct iio_trigger *trig,
 737         struct iio_dev *indio_dev)
 738 {
 739         if (indio_dev->dev.parent != trig->dev.parent)
 740                 return -EINVAL;
 741         return 0;
 742 }
 743 EXPORT_SYMBOL(iio_trigger_validate_own_device);
 744
 745 void iio_device_register_trigger_consumer(struct iio_dev *indio_dev)
 746 {
 747         indio_dev->groups[indio_dev->groupcounter++] =
 748                 &iio_trigger_consumer_attr_group;
 749 }
 750
 751 void iio_device_unregister_trigger_consumer(struct iio_dev *indio_dev)
 752 {
 753         /* Clean up an associated but not attached trigger reference */
 754         if (indio_dev->trig)
 755                 iio_trigger_put(indio_dev->trig);
 756 }
 757
 758 int iio_triggered_buffer_postenable(struct iio_dev *indio_dev)
 759 {
 760         return iio_trigger_attach_poll_func(indio_dev->trig,
 761                                             indio_dev->pollfunc);
 762 }
 763 EXPORT_SYMBOL(iio_triggered_buffer_postenable);
 764
 765 int iio_triggered_buffer_predisable(struct iio_dev *indio_dev)
 766 {
 767         return iio_trigger_detach_poll_func(indio_dev->trig,
 768                                              indio_dev->pollfunc);
 769 }
 770 EXPORT_SYMBOL(iio_triggered_buffer_predisable);