tools/iio/iio_event_monitor.c

   1 /* Industrialio event test code.
   2  *
   3  * Copyright (c) 2011-2012 Lars-Peter Clausen <lars@metafoo.de>
   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  * This program is primarily intended as an example application.
  10  * Reads the current buffer setup from sysfs and starts a short capture
  11  * from the specified device, pretty printing the result after appropriate
  12  * conversion.
  13  *
  14  * Usage:
  15  *      iio_event_monitor <device_name>
  16  */
  17
  18 #include <unistd.h>
  19 #include <stdlib.h>
  20 #include <stdbool.h>
  21 #include <stdio.h>
  22 #include <errno.h>
  23 #include <string.h>
  24 #include <poll.h>
  25 #include <fcntl.h>
  26 #include <sys/ioctl.h>
  27 #include "iio_utils.h"
  28 #include <linux/iio/events.h>
  29 #include <linux/iio/types.h>
  30
  31 static const char * const iio_chan_type_name_spec[] = {
  32         [IIO_VOLTAGE] = "voltage",
  33         [IIO_CURRENT] = "current",
  34         [IIO_POWER] = "power",
  35         [IIO_ACCEL] = "accel",
  36         [IIO_ANGL_VEL] = "anglvel",
  37         [IIO_MAGN] = "magn",
  38         [IIO_LIGHT] = "illuminance",
  39         [IIO_INTENSITY] = "intensity",
  40         [IIO_PROXIMITY] = "proximity",
  41         [IIO_TEMP] = "temp",
  42         [IIO_INCLI] = "incli",
  43         [IIO_ROT] = "rot",
  44         [IIO_ANGL] = "angl",
  45         [IIO_TIMESTAMP] = "timestamp",
  46         [IIO_CAPACITANCE] = "capacitance",
  47         [IIO_ALTVOLTAGE] = "altvoltage",
  48         [IIO_CCT] = "cct",
  49         [IIO_PRESSURE] = "pressure",
  50         [IIO_HUMIDITYRELATIVE] = "humidityrelative",
  51         [IIO_ACTIVITY] = "activity",
  52         [IIO_STEPS] = "steps",
  53         [IIO_ENERGY] = "energy",
  54         [IIO_DISTANCE] = "distance",
  55         [IIO_VELOCITY] = "velocity",
  56         [IIO_CONCENTRATION] = "concentration",
  57         [IIO_RESISTANCE] = "resistance",
  58         [IIO_PH] = "ph",
  59         [IIO_UVINDEX] = "uvindex",
  60 };
  61
  62 static const char * const iio_ev_type_text[] = {
  63         [IIO_EV_TYPE_THRESH] = "thresh",
  64         [IIO_EV_TYPE_MAG] = "mag",
  65         [IIO_EV_TYPE_ROC] = "roc",
  66         [IIO_EV_TYPE_THRESH_ADAPTIVE] = "thresh_adaptive",
  67         [IIO_EV_TYPE_MAG_ADAPTIVE] = "mag_adaptive",
  68         [IIO_EV_TYPE_CHANGE] = "change",
  69 };
  70
  71 static const char * const iio_ev_dir_text[] = {
  72         [IIO_EV_DIR_EITHER] = "either",
  73         [IIO_EV_DIR_RISING] = "rising",
  74         [IIO_EV_DIR_FALLING] = "falling"
  75 };
  76
  77 static const char * const iio_modifier_names[] = {
  78         [IIO_MOD_X] = "x",
  79         [IIO_MOD_Y] = "y",
  80         [IIO_MOD_Z] = "z",
  81         [IIO_MOD_X_AND_Y] = "x&y",
  82         [IIO_MOD_X_AND_Z] = "x&z",
  83         [IIO_MOD_Y_AND_Z] = "y&z",
  84         [IIO_MOD_X_AND_Y_AND_Z] = "x&y&z",
  85         [IIO_MOD_X_OR_Y] = "x|y",
  86         [IIO_MOD_X_OR_Z] = "x|z",
  87         [IIO_MOD_Y_OR_Z] = "y|z",
  88         [IIO_MOD_X_OR_Y_OR_Z] = "x|y|z",
  89         [IIO_MOD_LIGHT_BOTH] = "both",
  90         [IIO_MOD_LIGHT_IR] = "ir",
  91         [IIO_MOD_ROOT_SUM_SQUARED_X_Y] = "sqrt(x^2+y^2)",
  92         [IIO_MOD_SUM_SQUARED_X_Y_Z] = "x^2+y^2+z^2",
  93         [IIO_MOD_LIGHT_CLEAR] = "clear",
  94         [IIO_MOD_LIGHT_RED] = "red",
  95         [IIO_MOD_LIGHT_GREEN] = "green",
  96         [IIO_MOD_LIGHT_BLUE] = "blue",
  97         [IIO_MOD_LIGHT_UV] = "uv",
  98         [IIO_MOD_QUATERNION] = "quaternion",
  99         [IIO_MOD_TEMP_AMBIENT] = "ambient",
 100         [IIO_MOD_TEMP_OBJECT] = "object",
 101         [IIO_MOD_NORTH_MAGN] = "from_north_magnetic",
 102         [IIO_MOD_NORTH_TRUE] = "from_north_true",
 103         [IIO_MOD_NORTH_MAGN_TILT_COMP] = "from_north_magnetic_tilt_comp",
 104         [IIO_MOD_NORTH_TRUE_TILT_COMP] = "from_north_true_tilt_comp",
 105         [IIO_MOD_RUNNING] = "running",
 106         [IIO_MOD_JOGGING] = "jogging",
 107         [IIO_MOD_WALKING] = "walking",
 108         [IIO_MOD_STILL] = "still",
 109         [IIO_MOD_ROOT_SUM_SQUARED_X_Y_Z] = "sqrt(x^2+y^2+z^2)",
 110         [IIO_MOD_I] = "i",
 111         [IIO_MOD_Q] = "q",
 112         [IIO_MOD_CO2] = "co2",
 113         [IIO_MOD_VOC] = "voc",
 114 };
 115
 116 static bool event_is_known(struct iio_event_data *event)
 117 {
 118         enum iio_chan_type type = IIO_EVENT_CODE_EXTRACT_CHAN_TYPE(event->id);
 119         enum iio_modifier mod = IIO_EVENT_CODE_EXTRACT_MODIFIER(event->id);
 120         enum iio_event_type ev_type = IIO_EVENT_CODE_EXTRACT_TYPE(event->id);
 121         enum iio_event_direction dir = IIO_EVENT_CODE_EXTRACT_DIR(event->id);
 122
 123         switch (type) {
 124         case IIO_VOLTAGE:
 125         case IIO_CURRENT:
 126         case IIO_POWER:
 127         case IIO_ACCEL:
 128         case IIO_ANGL_VEL:
 129         case IIO_MAGN:
 130         case IIO_LIGHT:
 131         case IIO_INTENSITY:
 132         case IIO_PROXIMITY:
 133         case IIO_TEMP:
 134         case IIO_INCLI:
 135         case IIO_ROT:
 136         case IIO_ANGL:
 137         case IIO_TIMESTAMP:
 138         case IIO_CAPACITANCE:
 139         case IIO_ALTVOLTAGE:
 140         case IIO_CCT:
 141         case IIO_PRESSURE:
 142         case IIO_HUMIDITYRELATIVE:
 143         case IIO_ACTIVITY:
 144         case IIO_STEPS:
 145         case IIO_ENERGY:
 146         case IIO_DISTANCE:
 147         case IIO_VELOCITY:
 148         case IIO_CONCENTRATION:
 149         case IIO_RESISTANCE:
 150         case IIO_PH:
 151         case IIO_UVINDEX:
 152                 break;
 153         default:
 154                 return false;
 155         }
 156
 157         switch (mod) {
 158         case IIO_NO_MOD:
 159         case IIO_MOD_X:
 160         case IIO_MOD_Y:
 161         case IIO_MOD_Z:
 162         case IIO_MOD_X_AND_Y:
 163         case IIO_MOD_X_AND_Z:
 164         case IIO_MOD_Y_AND_Z:
 165         case IIO_MOD_X_AND_Y_AND_Z:
 166         case IIO_MOD_X_OR_Y:
 167         case IIO_MOD_X_OR_Z:
 168         case IIO_MOD_Y_OR_Z:
 169         case IIO_MOD_X_OR_Y_OR_Z:
 170         case IIO_MOD_LIGHT_BOTH:
 171         case IIO_MOD_LIGHT_IR:
 172         case IIO_MOD_ROOT_SUM_SQUARED_X_Y:
 173         case IIO_MOD_SUM_SQUARED_X_Y_Z:
 174         case IIO_MOD_LIGHT_CLEAR:
 175         case IIO_MOD_LIGHT_RED:
 176         case IIO_MOD_LIGHT_GREEN:
 177         case IIO_MOD_LIGHT_BLUE:
 178         case IIO_MOD_LIGHT_UV:
 179         case IIO_MOD_QUATERNION:
 180         case IIO_MOD_TEMP_AMBIENT:
 181         case IIO_MOD_TEMP_OBJECT:
 182         case IIO_MOD_NORTH_MAGN:
 183         case IIO_MOD_NORTH_TRUE:
 184         case IIO_MOD_NORTH_MAGN_TILT_COMP:
 185         case IIO_MOD_NORTH_TRUE_TILT_COMP:
 186         case IIO_MOD_RUNNING:
 187         case IIO_MOD_JOGGING:
 188         case IIO_MOD_WALKING:
 189         case IIO_MOD_STILL:
 190         case IIO_MOD_ROOT_SUM_SQUARED_X_Y_Z:
 191         case IIO_MOD_I:
 192         case IIO_MOD_Q:
 193         case IIO_MOD_CO2:
 194         case IIO_MOD_VOC:
 195                 break;
 196         default:
 197                 return false;
 198         }
 199
 200         switch (ev_type) {
 201         case IIO_EV_TYPE_THRESH:
 202         case IIO_EV_TYPE_MAG:
 203         case IIO_EV_TYPE_ROC:
 204         case IIO_EV_TYPE_THRESH_ADAPTIVE:
 205         case IIO_EV_TYPE_MAG_ADAPTIVE:
 206         case IIO_EV_TYPE_CHANGE:
 207                 break;
 208         default:
 209                 return false;
 210         }
 211
 212         switch (dir) {
 213         case IIO_EV_DIR_EITHER:
 214         case IIO_EV_DIR_RISING:
 215         case IIO_EV_DIR_FALLING:
 216         case IIO_EV_DIR_NONE:
 217                 break;
 218         default:
 219                 return false;
 220         }
 221
 222         return true;
 223 }
 224
 225 static void print_event(struct iio_event_data *event)
 226 {
 227         enum iio_chan_type type = IIO_EVENT_CODE_EXTRACT_CHAN_TYPE(event->id);
 228         enum iio_modifier mod = IIO_EVENT_CODE_EXTRACT_MODIFIER(event->id);
 229         enum iio_event_type ev_type = IIO_EVENT_CODE_EXTRACT_TYPE(event->id);
 230         enum iio_event_direction dir = IIO_EVENT_CODE_EXTRACT_DIR(event->id);
 231         int chan = IIO_EVENT_CODE_EXTRACT_CHAN(event->id);
 232         int chan2 = IIO_EVENT_CODE_EXTRACT_CHAN2(event->id);
 233         bool diff = IIO_EVENT_CODE_EXTRACT_DIFF(event->id);
 234
 235         if (!event_is_known(event)) {
 236                 fprintf(stderr, "Unknown event: time: %lld, id: %llx\n",
 237                         event->timestamp, event->id);
 238
 239                 return;
 240         }
 241
 242         printf("Event: time: %lld, type: %s", event->timestamp,
 243                iio_chan_type_name_spec[type]);
 244
 245         if (mod != IIO_NO_MOD)
 246                 printf("(%s)", iio_modifier_names[mod]);
 247
 248         if (chan >= 0) {
 249                 printf(", channel: %d", chan);
 250                 if (diff && chan2 >= 0)
 251                         printf("-%d", chan2);
 252         }
 253
 254         printf(", evtype: %s", iio_ev_type_text[ev_type]);
 255
 256         if (dir != IIO_EV_DIR_NONE)
 257                 printf(", direction: %s", iio_ev_dir_text[dir]);
 258
 259         printf("\n");
 260 }
 261
 262 int main(int argc, char **argv)
 263 {
 264         struct iio_event_data event;
 265         const char *device_name;
 266         char *chrdev_name;
 267         int ret;
 268         int dev_num;
 269         int fd, event_fd;
 270
 271         if (argc <= 1) {
 272                 fprintf(stderr, "Usage: %s <device_name>\n", argv[0]);
 273                 return -1;
 274         }
 275
 276         device_name = argv[1];
 277
 278         dev_num = find_type_by_name(device_name, "iio:device");
 279         if (dev_num >= 0) {
 280                 printf("Found IIO device with name %s with device number %d\n",
 281                        device_name, dev_num);
 282                 ret = asprintf(&chrdev_name, "/dev/iio:device%d", dev_num);
 283                 if (ret < 0)
 284                         return -ENOMEM;
 285         } else {
 286                 /*
 287                  * If we can't find an IIO device by name assume device_name is
 288                  * an IIO chrdev
 289                  */
 290                 chrdev_name = strdup(device_name);
 291                 if (!chrdev_name)
 292                         return -ENOMEM;
 293         }
 294
 295         fd = open(chrdev_name, 0);
 296         if (fd == -1) {
 297                 ret = -errno;
 298                 fprintf(stderr, "Failed to open %s\n", chrdev_name);
 299                 goto error_free_chrdev_name;
 300         }
 301
 302         ret = ioctl(fd, IIO_GET_EVENT_FD_IOCTL, &event_fd);
 303         if (ret == -1 || event_fd == -1) {
 304                 ret = -errno;
 305                 if (ret == -ENODEV)
 306                         fprintf(stderr,
 307                                 "This device does not support events\n");
 308                 else
 309                         fprintf(stderr, "Failed to retrieve event fd\n");
 310                 if (close(fd) == -1)
 311                         perror("Failed to close character device file");
 312
 313                 goto error_free_chrdev_name;
 314         }
 315
 316         if (close(fd) == -1)  {
 317                 ret = -errno;
 318                 goto error_free_chrdev_name;
 319         }
 320
 321         while (true) {
 322                 ret = read(event_fd, &event, sizeof(event));
 323                 if (ret == -1) {
 324                         if (errno == EAGAIN) {
 325                                 fprintf(stderr, "nothing available\n");
 326                                 continue;
 327                         } else {
 328                                 ret = -errno;
 329                                 perror("Failed to read event from device");
 330                                 break;
 331                         }
 332                 }
 333
 334                 if (ret != sizeof(event)) {
 335                         fprintf(stderr, "Reading event failed!\n");
 336                         ret = -EIO;
 337                         break;
 338                 }
 339
 340                 print_event(&event);
 341         }
 342
 343         if (close(event_fd) == -1)
 344                 perror("Failed to close event file");
 345
 346 error_free_chrdev_name:
 347         free(chrdev_name);
 348
 349         return ret;
 350 }