control.c

   1 /*
   2  * Copyright (C) 2014-2015 Intel Corporation.
   3  */
   4
   5 #include <stdlib.h>
   6 #include <ctype.h>
   7 #include <fcntl.h>
   8 #include <pthread.h>
   9 #include <time.h>
  10 #include <math.h>
  11 #include <sys/epoll.h>
  12 #include <sys/ioctl.h>
  13 #include <sys/socket.h>
  14 #include <utils/Log.h>
  15 #include <hardware/sensors.h>
  16 #include <linux/ioctl.h>
  17 #include "control.h"
  18 #include "enumeration.h"
  19 #include "utils.h"
  20 #include "transform.h"
  21 #include "calibration.h"
  22 #include "description.h"
  23 #include "filtering.h"
  24 #include <linux/iio/events.h>
  25 /* Currently active sensors count, per device */
  26 static int poll_sensors_per_dev[MAX_DEVICES];           /* poll-mode sensors                            */
  27 static int trig_sensors_per_dev[MAX_DEVICES];           /* trigger, event based                         */
  28
  29 static int device_fd[MAX_DEVICES];                      /* fd on the /dev/iio:deviceX file              */
  30 static int events_fd[MAX_DEVICES];                      /* fd on the /sys/bus/iio/devices/iio:deviceX/events/<event_name> file */
  31 static int has_iio_ts[MAX_DEVICES];                     /* ts channel available on this iio dev         */
  32 static int expected_dev_report_size[MAX_DEVICES];       /* expected iio scan len                        */
  33 static int poll_fd;                                     /* epoll instance covering all enabled sensors  */
  34
  35 static int active_poll_sensors;                         /* Number of enabled poll-mode sensors          */
  36
  37 /* We use pthread condition variables to get worker threads out of sleep */
  38 static pthread_condattr_t thread_cond_attr      [MAX_SENSORS];
  39 static pthread_cond_t     thread_release_cond   [MAX_SENSORS];
  40 static pthread_mutex_t    thread_release_mutex  [MAX_SENSORS];
  41
  42 /*
  43  * We associate tags to each of our poll set entries. These tags have the following values:
  44  * - a iio device number if the fd is a iio character device fd
  45  * - THREAD_REPORT_TAG_BASE + sensor handle if the fd is the receiving end of a pipe used by a sysfs data acquisition thread
  46  */
  47 #define THREAD_REPORT_TAG_BASE          1000
  48
  49 /* If buffer enable fails, we may want to retry a few times before giving up */
  50 #define ENABLE_BUFFER_RETRIES           3
  51 #define ENABLE_BUFFER_RETRY_DELAY_MS    10
  52
  53
  54 inline int is_enabled (int s)
  55 {
  56         return sensor[s].directly_enabled || sensor[s].ref_count;
  57 }
  58
  59
  60 static int check_state_change (int s, int enabled, int from_virtual)
  61 {
  62         if (enabled) {
  63                 if (sensor[s].directly_enabled)
  64                         return 0;                       /* We're being enabled but already were directly activated: no change. */
  65
  66                 if (!from_virtual)
  67                         sensor[s].directly_enabled = 1; /* We're being directly enabled */
  68
  69                 if (sensor[s].ref_count)
  70                         return 0;                       /* We were already indirectly enabled */
  71
  72                 return 1;                               /* Do continue enabling this sensor */
  73         }
  74
  75         if (!is_enabled(s))
  76                 return 0;                               /* We are being disabled but already were: no change */
  77
  78         if (from_virtual && sensor[s].directly_enabled)
  79                 return 0;                               /* We're indirectly disabled but the base is still active */
  80
  81         sensor[s].directly_enabled = 0;                 /* We're now directly disabled */
  82
  83         if (!from_virtual && sensor[s].ref_count)
  84                 return 0;                               /* We still have ref counts */
  85
  86         return 1;                                       /* Do continue disabling this sensor */
  87 }
  88
  89
  90 static int enable_buffer (int dev_num, int enabled)
  91 {
  92         char sysfs_path[PATH_MAX];
  93         int retries = ENABLE_BUFFER_RETRIES;
  94
  95         sprintf(sysfs_path, ENABLE_PATH, dev_num);
  96
  97         while (retries) {
  98                 /* Low level, non-multiplexed, enable/disable routine */
  99                 if (sysfs_write_int(sysfs_path, enabled) > 0)
 100                         return 0;
 101
 102                 ALOGE("Failed enabling buffer on dev%d, retrying", dev_num);
 103                 usleep(ENABLE_BUFFER_RETRY_DELAY_MS*1000);
 104                 retries--;
 105         }
 106
 107         ALOGE("Could not enable buffer\n");
 108         return -EIO;
 109 }
 110
 111
 112 static int setup_trigger (int s, const char* trigger_val)
 113 {
 114         char sysfs_path[PATH_MAX];
 115         int ret = -1, attempts = 5;
 116
 117         sprintf(sysfs_path, TRIGGER_PATH, sensor[s].dev_num);
 118
 119         if (trigger_val[0] != '\n')
 120                 ALOGI("Setting S%d (%s) trigger to %s\n", s, sensor[s].friendly_name, trigger_val);
 121
 122         while (ret == -1 && attempts) {
 123                 ret = sysfs_write_str(sysfs_path, trigger_val);
 124                 attempts--;
 125         }
 126
 127         if (ret != -1)
 128                 sensor[s].selected_trigger = trigger_val;
 129         else
 130                 ALOGE("Setting S%d (%s) trigger to %s FAILED.\n", s, sensor[s].friendly_name, trigger_val);
 131         return ret;
 132 }
 133
 134 static int enable_event(int dev_num, const char *name, int enabled)
 135 {
 136         char sysfs_path[PATH_MAX];
 137
 138         sprintf(sysfs_path, EVENTS_PATH "%s", dev_num, name);
 139         return sysfs_write_int(sysfs_path, enabled);
 140 }
 141
 142 static int enable_sensor(int dev_num, const char *tag, int enabled)
 143 {
 144         char sysfs_path[PATH_MAX];
 145
 146         sprintf(sysfs_path, SENSOR_ENABLE_PATH, dev_num, tag);
 147         return sysfs_write_int(sysfs_path, enabled);
 148 }
 149
 150 static void enable_iio_timestamp (int dev_num, int known_channels)
 151 {
 152         /* Check if we have a dedicated iio timestamp channel */
 153
 154         char spec_buf[MAX_TYPE_SPEC_LEN];
 155         char sysfs_path[PATH_MAX];
 156         int n;
 157
 158         sprintf(sysfs_path, CHANNEL_PATH "%s", dev_num, "in_timestamp_type");
 159
 160         n = sysfs_read_str(sysfs_path, spec_buf, sizeof(spec_buf));
 161
 162         if (n <= 0)
 163                 return;
 164
 165         if (strcmp(spec_buf, "le:s64/64>>0"))
 166                 return;
 167
 168         /* OK, type is int64_t as expected, in little endian representation */
 169
 170         sprintf(sysfs_path, CHANNEL_PATH"%s", dev_num, "in_timestamp_index");
 171
 172         if (sysfs_read_int(sysfs_path, &n))
 173                 return;
 174
 175         /* Check that the timestamp comes after the other fields we read */
 176         if (n != known_channels)
 177                 return;
 178
 179         /* Try enabling that channel */
 180         sprintf(sysfs_path, CHANNEL_PATH "%s", dev_num, "in_timestamp_en");
 181
 182         sysfs_write_int(sysfs_path, 1);
 183
 184         if (sysfs_read_int(sysfs_path, &n))
 185                 return;
 186
 187         if (n) {
 188                 ALOGI("Detected timestamp channel on iio device %d\n", dev_num);
 189                 has_iio_ts[dev_num] = 1;
 190         }
 191 }
 192
 193
 194 static int decode_type_spec (const char type_buf[MAX_TYPE_SPEC_LEN], datum_info_t *type_info)
 195 {
 196         /* Return size in bytes for this type specification, or -1 in error */
 197         char sign;
 198         char endianness;
 199         unsigned int realbits, storagebits, shift;
 200         int tokens;
 201
 202         /* Valid specs: "le:u10/16>>0", "le:s16/32>>0" or "le:s32/32>>0" */
 203
 204         tokens = sscanf(type_buf, "%ce:%c%u/%u>>%u", &endianness, &sign, &realbits, &storagebits, &shift);
 205
 206         if (tokens != 5 || (endianness != 'b' && endianness != 'l') || (sign != 'u' && sign != 's') ||
 207             realbits > storagebits || (storagebits != 16 && storagebits != 32 && storagebits != 64)) {
 208                         ALOGE("Invalid iio channel type spec: %s\n", type_buf);
 209                         return -1;
 210         }
 211
 212         type_info->endianness   =               endianness;
 213         type_info->sign         =               sign;
 214         type_info->realbits     =       (short) realbits;
 215         type_info->storagebits  =       (short) storagebits;
 216         type_info->shift        =       (short) shift;
 217
 218         return storagebits / 8;
 219 }
 220
 221
 222 void build_sensor_report_maps (int dev_num)
 223 {
 224         /*
 225          * Read sysfs files from a iio device's scan_element directory, and build a couple of tables from that data. These tables will tell, for
 226          * each sensor, where to gather relevant data in a device report, i.e. the structure that we read from the /dev/iio:deviceX file in order to
 227          * sensor report, itself being the data that we return to Android when a sensor poll completes. The mapping should be straightforward in the
 228          * case where we have a single sensor active per iio device but, this is not the general case. In general several sensors can be handled
 229          * through a single iio device, and the _en, _index and _type syfs entries all concur to paint a picture of what the structure of the
 230          * device report is.
 231          */
 232
 233         int s;
 234         int c;
 235         int n;
 236         int i;
 237         int ch_index;
 238         char* ch_spec;
 239         char spec_buf[MAX_TYPE_SPEC_LEN];
 240         datum_info_t* ch_info;
 241         int size;
 242         char sysfs_path[PATH_MAX];
 243         int known_channels;
 244         int offset;
 245         int channel_size_from_index[MAX_SENSORS * MAX_CHANNELS] = { 0 };
 246         int sensor_handle_from_index[MAX_SENSORS * MAX_CHANNELS] = { 0 };
 247         int channel_number_from_index[MAX_SENSORS * MAX_CHANNELS] = { 0 };
 248
 249         known_channels = 0;
 250
 251         /* For each sensor that is linked to this device */
 252         for (s=0; s<sensor_count; s++) {
 253                 if (sensor[s].dev_num != dev_num)
 254                         continue;
 255
 256                 i = sensor[s].catalog_index;
 257
 258                 /* Read channel details through sysfs attributes */
 259                 for (c=0; c<sensor[s].num_channels; c++) {
 260
 261                         /* Read _type file */
 262                         sprintf(sysfs_path, CHANNEL_PATH "%s", sensor[s].dev_num, sensor_catalog[i].channel[c].type_path);
 263
 264                         n = sysfs_read_str(sysfs_path, spec_buf, sizeof(spec_buf));
 265
 266                         if (n == -1) {
 267                                         ALOGW(  "Failed to read type: %s\n", sysfs_path);
 268                                         continue;
 269                         }
 270
 271                         ch_spec = sensor[s].channel[c].type_spec;
 272
 273                         memcpy(ch_spec, spec_buf, sizeof(spec_buf));
 274
 275                         ch_info = &sensor[s].channel[c].type_info;
 276
 277                         size = decode_type_spec(ch_spec, ch_info);
 278
 279                         /* Read _index file */
 280                         sprintf(sysfs_path, CHANNEL_PATH "%s", sensor[s].dev_num, sensor_catalog[i].channel[c].index_path);
 281
 282                         n = sysfs_read_int(sysfs_path, &ch_index);
 283
 284                         if (n == -1) {
 285                                         ALOGW(  "Failed to read index: %s\n", sysfs_path);
 286                                         continue;
 287                         }
 288
 289                         if (ch_index >= MAX_SENSORS) {
 290                                 ALOGE("Index out of bounds!: %s\n", sysfs_path);
 291                                 continue;
 292                         }
 293
 294                         /* Record what this index is about */
 295
 296                         sensor_handle_from_index [ch_index] = s;
 297                         channel_number_from_index[ch_index] = c;
 298                         channel_size_from_index  [ch_index] = size;
 299
 300                         known_channels++;
 301                 }
 302
 303                 /* Stop sampling - if we are recovering from hal restart */
 304                 enable_buffer(dev_num, 0);
 305                 setup_trigger(s, "\n");
 306
 307                 /* Turn on channels we're aware of */
 308                 for (c=0;c<sensor[s].num_channels; c++) {
 309                         sprintf(sysfs_path, CHANNEL_PATH "%s", sensor[s].dev_num, sensor_catalog[i].channel[c].en_path);
 310                         sysfs_write_int(sysfs_path, 1);
 311                 }
 312         }
 313
 314         ALOGI("Found %d channels on iio device %d\n", known_channels, dev_num);
 315
 316         /*
 317          * Now that we know which channels are defined, their sizes and their ordering, update channels offsets within device report. Note: there
 318          * is a possibility that several sensors share the same index, with their data fields being isolated by masking and shifting as specified
 319          * through the real bits and shift values in type attributes. This case is not currently supported. Also, the code below assumes no hole in
 320          * the sequence of indices, so it is dependent on discovery of all sensors.
 321          */
 322          offset = 0;
 323
 324          for (i=0; i<MAX_SENSORS * MAX_CHANNELS; i++) {
 325                 s =     sensor_handle_from_index[i];
 326                 c =     channel_number_from_index[i];
 327                 size =  channel_size_from_index[i];
 328
 329                 if (!size)
 330                         continue;
 331
 332                 ALOGI("S%d C%d : offset %d, size %d, type %s\n", s, c, offset, size, sensor[s].channel[c].type_spec);
 333
 334                 sensor[s].channel[c].offset     = offset;
 335                 sensor[s].channel[c].size               = size;
 336
 337                 offset += size;
 338          }
 339
 340         /* Enable the timestamp channel if there is one available */
 341         enable_iio_timestamp(dev_num, known_channels);
 342
 343         /* Add padding and timestamp size if it's enabled on this iio device */
 344         if (has_iio_ts[dev_num])
 345                 offset = (offset+7)/8*8 + sizeof(int64_t);
 346
 347         expected_dev_report_size[dev_num] = offset;
 348         ALOGI("Expecting %d scan length on iio dev %d\n", offset, dev_num);
 349
 350         if (expected_dev_report_size[dev_num] > MAX_DEVICE_REPORT_SIZE) {
 351                 ALOGE("Unexpectedly large scan buffer on iio dev%d: %d bytes\n", dev_num, expected_dev_report_size[dev_num]);
 352
 353                 expected_dev_report_size[dev_num] = MAX_DEVICE_REPORT_SIZE;
 354         }
 355 }
 356
 357
 358 int adjust_counters (int s, int enabled, int from_virtual)
 359 {
 360         /*
 361          * Adjust counters based on sensor enable action. Return values are:
 362          *  0 if the operation was completed and we're all set
 363          *  1 if we toggled the state of the sensor and there's work left
 364          * -1 in case of an error
 365          */
 366
 367         int dev_num = sensor[s].dev_num;
 368
 369         if (!check_state_change(s, enabled, from_virtual))
 370                 return 0; /* The state of the sensor remains the same: we're done */
 371
 372         if (enabled) {
 373                 ALOGI("Enabling sensor %d (iio device %d: %s)\n", s, dev_num, sensor[s].friendly_name);
 374
 375                 switch (sensor[s].type) {
 376                         case SENSOR_TYPE_ACCELEROMETER:
 377                                 accel_cal_init(s);
 378                                 break;
 379
 380                         case SENSOR_TYPE_MAGNETIC_FIELD:
 381                                 compass_read_data(s);
 382                                 break;
 383
 384                         case SENSOR_TYPE_GYROSCOPE:
 385                                 gyro_cal_init(s);
 386                                 break;
 387                 }
 388         } else {
 389                 ALOGI("Disabling sensor %d (iio device %d: %s)\n", s, dev_num, sensor[s].friendly_name);
 390
 391                 /* Sensor disabled, lower report available flag */
 392                 sensor[s].report_pending = 0;
 393
 394                 /* Save calibration data to persistent storage */
 395                 switch (sensor[s].type) {
 396                         case SENSOR_TYPE_ACCELEROMETER:
 397                                 accel_cal_store(s);
 398                                 break;
 399
 400                         case SENSOR_TYPE_MAGNETIC_FIELD:
 401                                 compass_store_data(s);
 402                                 break;
 403
 404                         case SENSOR_TYPE_GYROSCOPE:
 405                                 gyro_store_data(s);
 406                                 break;
 407                 }
 408         }
 409
 410         /* We changed the state of a sensor: adjust device ref counts */
 411
 412         switch(sensor[s].mode) {
 413         case MODE_TRIGGER:
 414                 if (enabled)
 415                         trig_sensors_per_dev[dev_num]++;
 416                 else
 417                         trig_sensors_per_dev[dev_num]--;
 418
 419                 return 1;
 420         case MODE_POLL:
 421                 if (enabled) {
 422                         active_poll_sensors++;
 423                         poll_sensors_per_dev[dev_num]++;
 424                         return 1;
 425                 } else {
 426                         active_poll_sensors--;
 427                         poll_sensors_per_dev[dev_num]--;
 428                         return 1;
 429                 }
 430         case MODE_EVENT:
 431                 return 1;
 432         default:
 433                 /* Invalid sensor mode */
 434                 return -1;
 435         }
 436 }
 437
 438
 439 static int get_field_count (int s, size_t *field_size)
 440 {
 441         *field_size = sizeof(float);
 442
 443         switch (sensor[s].type) {
 444                 case SENSOR_TYPE_ACCELEROMETER:         /* m/s^2        */
 445                 case SENSOR_TYPE_MAGNETIC_FIELD:        /* micro-tesla  */
 446                 case SENSOR_TYPE_ORIENTATION:           /* degrees      */
 447                 case SENSOR_TYPE_GYROSCOPE_UNCALIBRATED:
 448                 case SENSOR_TYPE_GYROSCOPE:             /* radians/s    */
 449                         return 3;
 450
 451                 case SENSOR_TYPE_INTERNAL_INTENSITY:
 452                 case SENSOR_TYPE_INTERNAL_ILLUMINANCE:
 453                 case SENSOR_TYPE_LIGHT:                 /* SI lux units */
 454                 case SENSOR_TYPE_AMBIENT_TEMPERATURE:   /* °C          */
 455                 case SENSOR_TYPE_TEMPERATURE:           /* °C          */
 456                 case SENSOR_TYPE_PROXIMITY:             /* centimeters  */
 457                 case SENSOR_TYPE_PRESSURE:              /* hecto-pascal */
 458                 case SENSOR_TYPE_RELATIVE_HUMIDITY:     /* percent */
 459                 case SENSOR_TYPE_STEP_DETECTOR:         /* event: always 1 */
 460                         return 1;
 461
 462                 case SENSOR_TYPE_ROTATION_VECTOR:
 463                         return 4;
 464
 465                 case SENSOR_TYPE_STEP_COUNTER:          /* number of steps */
 466                         *field_size = sizeof(uint64_t);
 467                         return 1;
 468                 default:
 469                         ALOGE("Unknown sensor type!\n");
 470                         return 0;                       /* Drop sample */
 471         }
 472 }
 473
 474 /*
 475  *  CTS acceptable thresholds:
 476  *      EventGapVerification.java: (th <= 1.8)
 477  *      FrequencyVerification.java: (0.9)*(expected freq) => (th <= 1.1111)
 478  */
 479 #define THRESHOLD 1.10
 480 #define MAX_DELAY 500000000 /* 500 ms */
 481
 482 void set_report_ts(int s, int64_t ts)
 483 {
 484         int64_t maxTs, period;
 485
 486         /*
 487         *  A bit of a hack to please a bunch of cts tests. They
 488         *  expect the timestamp to be exacly according to the set-up
 489         *  frequency but if we're simply getting the timestamp at hal level
 490         *  this may not be the case. Perhaps we'll get rid of this when
 491         *  we'll be reading the timestamp from the iio channel for all sensors
 492         */
 493         if (sensor[s].report_ts && sensor[s].sampling_rate &&
 494                 REPORTING_MODE(sensor_desc[s].flags) == SENSOR_FLAG_CONTINUOUS_MODE)
 495         {
 496                 period = (int64_t) (1000000000.0 / sensor[s].sampling_rate);
 497                 maxTs = sensor[s].report_ts + THRESHOLD * period;
 498                 /* If we're too far behind get back on track */
 499                 if (ts - maxTs >= MAX_DELAY)
 500                         maxTs = ts;
 501                 sensor[s].report_ts = (ts < maxTs ? ts : maxTs);
 502         } else {
 503                 sensor[s].report_ts = ts;
 504         }
 505 }
 506
 507 static void* acquisition_routine (void* param)
 508 {
 509         /*
 510          * Data acquisition routine run in a dedicated thread, covering a single sensor. This loop will periodically retrieve sampling data through
 511          * sysfs, then package it as a sample and transfer it to our master poll loop through a report fd. Checks for a cancellation signal quite
 512          * frequently, as the thread may be disposed of at any time. Note that Bionic does not provide pthread_cancel / pthread_testcancel...
 513          */
 514
 515         int s = (int) (size_t) param;
 516         int num_fields;
 517         sensors_event_t data = {0};
 518         int c;
 519         int ret;
 520         struct timespec target_time;
 521         int64_t timestamp, period, start, stop;
 522         size_t field_size;
 523
 524         if (s < 0 || s >= sensor_count) {
 525                 ALOGE("Invalid sensor handle!\n");
 526                 return NULL;
 527         }
 528
 529         ALOGI("Entering S%d (%s) data acquisition thread: rate:%g\n", s, sensor[s].friendly_name, sensor[s].sampling_rate);
 530
 531         if (sensor[s].sampling_rate <= 0) {
 532                 ALOGE("Invalid rate in acquisition routine for sensor %d: %g\n", s, sensor[s].sampling_rate);
 533                 return NULL;
 534         }
 535
 536         /* Initialize data fields that will be shared by all sensor reports */
 537         data.version    = sizeof(sensors_event_t);
 538         data.sensor     = s;
 539         data.type       = sensor_desc[s].type;
 540
 541         num_fields = get_field_count(s, &field_size);
 542
 543         /*
 544          * Each condition variable is associated to a mutex that has to be locked by the thread that's waiting on it. We use these condition
 545          * variables to get the acquisition threads out of sleep quickly after the sampling rate is adjusted, or the sensor is disabled.
 546          */
 547         pthread_mutex_lock(&thread_release_mutex[s]);
 548
 549         /* Pinpoint the moment we start sampling */
 550         timestamp = get_timestamp_monotonic();
 551
 552         /* Check and honor termination requests */
 553         while (sensor[s].thread_data_fd[1] != -1) {
 554                 start = get_timestamp_boot();
 555
 556                 /* Read values through sysfs */
 557                 for (c=0; c<num_fields; c++) {
 558                         if (field_size == sizeof(uint64_t))
 559                                 data.u64.data[c] = acquire_immediate_uint64_value(s, c);
 560                         else
 561                                 data.data[c] = acquire_immediate_float_value(s, c);
 562
 563                         /* Check and honor termination requests */
 564                         if (sensor[s].thread_data_fd[1] == -1)
 565                                 goto exit;
 566                 }
 567                 stop = get_timestamp_boot();
 568                 set_report_ts(s, start/2 + stop/2);
 569                 data.timestamp = sensor[s].report_ts;
 570                 /* If the sample looks good */
 571                 if (sensor[s].ops.finalize(s, &data)) {
 572
 573                         /* Pipe it for transmission to poll loop */
 574                         ret = write(sensor[s].thread_data_fd[1], &data, sizeof(sensors_event_t));
 575
 576                         if (ret != sizeof(sensors_event_t))
 577                                 ALOGE("S%d write failure: wrote %d, got %d\n", s, sizeof(sensors_event_t), ret);
 578                 }
 579
 580                 /* Check and honor termination requests */
 581                 if (sensor[s].thread_data_fd[1] == -1)
 582                         goto exit;
 583
 584                 /* Recalculate period assuming sensor[s].sampling_rate can be changed dynamically during the thread run */
 585                 if (sensor[s].sampling_rate <= 0) {
 586                         ALOGE("Unexpected sampling rate for sensor %d: %g\n", s, sensor[s].sampling_rate);
 587                         goto exit;
 588                 }
 589
 590                 period = (int64_t) (1000000000.0 / sensor[s].sampling_rate);
 591                 timestamp += period;
 592                 set_timestamp(&target_time, timestamp);
 593
 594                 /* Wait until the sampling time elapses, or a rate change is signaled, or a thread exit is requested */
 595                 ret = pthread_cond_timedwait(&thread_release_cond[s], &thread_release_mutex[s], &target_time);
 596         }
 597
 598 exit:
 599         ALOGV("Acquisition thread for S%d exiting\n", s);
 600         pthread_mutex_unlock(&thread_release_mutex[s]);
 601         pthread_exit(0);
 602         return NULL;
 603 }
 604
 605
 606 static void start_acquisition_thread (int s)
 607 {
 608         int incoming_data_fd;
 609         int ret;
 610
 611         struct epoll_event ev = {0};
 612
 613         ALOGV("Initializing acquisition context for sensor %d\n", s);
 614
 615         /* Create condition variable and mutex for quick thread release */
 616         ret = pthread_condattr_init(&thread_cond_attr[s]);
 617         ret = pthread_condattr_setclock(&thread_cond_attr[s], CLOCK_MONOTONIC);
 618         ret = pthread_cond_init(&thread_release_cond[s], &thread_cond_attr[s]);
 619         ret = pthread_mutex_init(&thread_release_mutex[s], NULL);
 620
 621         /* Create a pipe for inter thread communication */
 622         ret = pipe(sensor[s].thread_data_fd);
 623
 624         incoming_data_fd = sensor[s].thread_data_fd[0];
 625
 626         ev.events = EPOLLIN;
 627         ev.data.u32 = THREAD_REPORT_TAG_BASE + s;
 628
 629         /* Add incoming side of pipe to our poll set, with a suitable tag */
 630         ret = epoll_ctl(poll_fd, EPOLL_CTL_ADD, incoming_data_fd , &ev);
 631         if (ret == -1) {
 632                 ALOGE("Failed adding %d to poll set (%s)\n",
 633                         incoming_data_fd, strerror(errno));
 634         }
 635
 636         /* Create and start worker thread */
 637         ret = pthread_create(&sensor[s].acquisition_thread, NULL, acquisition_routine, (void*) (size_t) s);
 638 }
 639
 640
 641 static void stop_acquisition_thread (int s)
 642 {
 643         int incoming_data_fd = sensor[s].thread_data_fd[0];
 644         int outgoing_data_fd = sensor[s].thread_data_fd[1];
 645
 646         ALOGV("Tearing down acquisition context for sensor %d\n", s);
 647
 648         /* Delete the incoming side of the pipe from our poll set */
 649         epoll_ctl(poll_fd, EPOLL_CTL_DEL, incoming_data_fd, NULL);
 650
 651         /* Mark the pipe ends as invalid ; that's a cheap exit flag */
 652         sensor[s].thread_data_fd[0] = -1;
 653         sensor[s].thread_data_fd[1] = -1;
 654
 655         /* Close both sides of our pipe */
 656         close(incoming_data_fd);
 657         close(outgoing_data_fd);
 658
 659         /* Stop acquisition thread and clean up thread handle */
 660         pthread_cond_signal(&thread_release_cond[s]);
 661         pthread_join(sensor[s].acquisition_thread, NULL);
 662
 663         /* Clean up our sensor descriptor */
 664         sensor[s].acquisition_thread = -1;
 665
 666         /* Delete condition variable and mutex */
 667         pthread_cond_destroy(&thread_release_cond[s]);
 668         pthread_mutex_destroy(&thread_release_mutex[s]);
 669 }
 670
 671
 672 static int is_fast_accelerometer (int s)
 673 {
 674         /*
 675          * Some games don't react well to accelerometers using any-motion triggers. Even very low thresholds seem to trip them, and they tend to
 676          * request fairly high event rates. Favor continuous triggers if the sensor is an accelerometer and uses a sampling rate of at least 25.
 677          */
 678
 679         if (sensor[s].type != SENSOR_TYPE_ACCELEROMETER)
 680                 return 0;
 681
 682         if (sensor[s].sampling_rate < 25)
 683                 return 0;
 684
 685         return 1;
 686 }
 687
 688
 689 static void tentative_switch_trigger (int s)
 690 {
 691         /*
 692          * Under certain situations it may be beneficial to use an alternate trigger:
 693          *
 694          * - for applications using the accelerometer with high sampling rates, prefer the continuous trigger over the any-motion one, to avoid
 695          *   jumps related to motion thresholds
 696          */
 697
 698         if (is_fast_accelerometer(s) && !(sensor[s].quirks & QUIRK_TERSE_DRIVER) && sensor[s].selected_trigger == sensor[s].motion_trigger_name)
 699                 setup_trigger(s, sensor[s].init_trigger_name);
 700 }
 701
 702
 703 static float get_group_max_sampling_rate (int s)
 704 {
 705         /* Review the sampling rates of linked sensors and return the maximum */
 706
 707         int i, vi;
 708
 709         float arbitrated_rate = 0;
 710
 711         if (is_enabled(s))
 712                 arbitrated_rate = sensor[s].requested_rate;
 713
 714         /* If any of the currently active sensors built on top of this one need a higher sampling rate, switch to this rate */
 715         for (i = 0; i < sensor_count; i++)
 716                 for (vi = 0; vi < sensor[i].base_count; vi++)
 717                         if (sensor[i].base[vi] == s && is_enabled(i) && sensor[i].requested_rate > arbitrated_rate)     /* If sensor i depends on sensor s */
 718                                 arbitrated_rate = sensor[i].requested_rate;
 719
 720         /* If any of the currently active sensors we rely on is using a higher sampling rate, switch to this rate */
 721         for (vi = 0; vi < sensor[s].base_count; vi++) {
 722                 i = sensor[s].base[vi];
 723                 if (is_enabled(i) && sensor[i].requested_rate > arbitrated_rate)
 724                         arbitrated_rate = sensor[i].requested_rate;
 725         }
 726
 727         return arbitrated_rate;
 728 }
 729
 730
 731 static int sensor_set_rate (int s, float requested_rate)
 732 {
 733         /* Set the rate at which a specific sensor should report events. See Android sensors.h for indication on sensor trigger modes */
 734
 735         char sysfs_path[PATH_MAX];
 736         char avail_sysfs_path[PATH_MAX];
 737         int dev_num             =       sensor[s].dev_num;
 738         int i                   =       sensor[s].catalog_index;
 739         const char *prefix      =       sensor_catalog[i].tag;
 740         int per_sensor_sampling_rate;
 741         int per_device_sampling_rate;
 742         char freqs_buf[100];
 743         char* cursor;
 744         int n;
 745         float sr;
 746         float group_max_sampling_rate;
 747         float cur_sampling_rate; /* Currently used sampling rate              */
 748         float arb_sampling_rate; /* Granted sampling rate after arbitration   */
 749         char hrtimer_sampling_path[PATH_MAX];
 750         char trigger_path[PATH_MAX];
 751
 752         ALOGV("Sampling rate %g requested on sensor %d (%s)\n", requested_rate, s, sensor[s].friendly_name);
 753
 754         sensor[s].requested_rate = requested_rate;
 755
 756         arb_sampling_rate = requested_rate;
 757
 758         if (arb_sampling_rate < sensor[s].min_supported_rate) {
 759                 ALOGV("Sampling rate %g too low for %s, using %g instead\n", arb_sampling_rate, sensor[s].friendly_name, sensor[s].min_supported_rate);
 760                 arb_sampling_rate = sensor[s].min_supported_rate;
 761         }
 762
 763         /* If one of the linked sensors uses a higher rate, adopt it */
 764         group_max_sampling_rate = get_group_max_sampling_rate(s);
 765
 766         if (arb_sampling_rate < group_max_sampling_rate) {
 767                 ALOGV("Using %s sampling rate to %g too due to dependency\n", sensor[s].friendly_name, arb_sampling_rate);
 768                 arb_sampling_rate = group_max_sampling_rate;
 769         }
 770
 771         if (sensor[s].max_supported_rate && arb_sampling_rate > sensor[s].max_supported_rate) {
 772                 ALOGV("Sampling rate %g too high for %s, using %g instead\n", arb_sampling_rate, sensor[s].friendly_name, sensor[s].max_supported_rate);
 773                 arb_sampling_rate = sensor[s].max_supported_rate;
 774         }
 775
 776         sensor[s].sampling_rate = arb_sampling_rate;
 777
 778         /* If the sensor is virtual, we're done */
 779         if (sensor[s].is_virtual)
 780                 return 0;
 781
 782         /* If we're dealing with a poll-mode sensor */
 783         if (sensor[s].mode == MODE_POLL) {
 784                 if (is_enabled(s))
 785                         pthread_cond_signal(&thread_release_cond[s]); /* Wake up thread so the new sampling rate gets used */
 786                 return 0;
 787         }
 788
 789         sprintf(sysfs_path, SENSOR_SAMPLING_PATH, dev_num, prefix);
 790
 791         if (sysfs_read_float(sysfs_path, &cur_sampling_rate) != -1) {
 792                 per_sensor_sampling_rate = 1;
 793                 per_device_sampling_rate = 0;
 794         } else {
 795                 per_sensor_sampling_rate = 0;
 796
 797                 sprintf(sysfs_path, DEVICE_SAMPLING_PATH, dev_num);
 798
 799                 if (sysfs_read_float(sysfs_path, &cur_sampling_rate) != -1)
 800                         per_device_sampling_rate = 1;
 801                 else
 802                         per_device_sampling_rate = 0;
 803         }
 804
 805         if (!per_sensor_sampling_rate && !per_device_sampling_rate) {
 806                 ALOGE("No way to adjust sampling rate on sensor %d\n", s);
 807                 return -ENOSYS;
 808         }
 809
 810         if (sensor[s].hrtimer_trigger_name[0] != '\0') {
 811                 snprintf(trigger_path, PATH_MAX, "%s%s%d/", IIO_DEVICES, "trigger", sensor[s].trigger_nr);
 812                 snprintf(hrtimer_sampling_path, PATH_MAX, "%s%s", trigger_path, "sampling_frequency");
 813                 /* Enforce frequency update when software trigger
 814                  * frequency and current sampling rate are different */
 815                 if (sysfs_read_float(hrtimer_sampling_path, &sr) != -1 && sr != cur_sampling_rate)
 816                         cur_sampling_rate = -1;
 817         }
 818
 819         /* Check if we have contraints on allowed sampling rates */
 820
 821         sprintf(avail_sysfs_path, DEVICE_AVAIL_FREQ_PATH, dev_num);
 822
 823         if (sysfs_read_str(avail_sysfs_path, freqs_buf, sizeof(freqs_buf)) > 0) {
 824                 cursor = freqs_buf;
 825
 826                 /* Decode allowed sampling rates string, ex: "10 20 50 100" */
 827
 828                 /* While we're not at the end of the string */
 829                 while (*cursor && cursor[0]) {
 830
 831                         /* Decode a single value */
 832                         sr = strtod(cursor, NULL);
 833
 834                         /* If this matches the selected rate, we're happy.  Have some tolerance for rounding errors and avoid needless jumps to higher rates */
 835                         if (fabs(arb_sampling_rate - sr) <= 0.01) {
 836                                 arb_sampling_rate = sr;
 837                                 break;
 838                         }
 839
 840                         /*
 841                          * If we reached a higher value than the desired rate, adjust selected rate so it matches the first higher available one and
 842                          * stop parsing - this makes the assumption that rates are sorted by increasing value in the allowed frequencies string.
 843                          */
 844                         if (sr > arb_sampling_rate) {
 845                                 arb_sampling_rate = sr;
 846                                 break;
 847                         }
 848
 849                         /* Skip digits */
 850                         while (cursor[0] && !isspace(cursor[0]))
 851                                 cursor++;
 852
 853                         /* Skip spaces */
 854                         while (cursor[0] && isspace(cursor[0]))
 855                                         cursor++;
 856                 }
 857         }
 858
 859         if (sensor[s].max_supported_rate &&
 860                 arb_sampling_rate > sensor[s].max_supported_rate) {
 861                 arb_sampling_rate = sensor[s].max_supported_rate;
 862         }
 863
 864         /* Record the rate that was agreed upon with the sensor taken in isolation ; this avoid uncontrolled ripple effects between colocated sensor rates */
 865         sensor[s].semi_arbitrated_rate = arb_sampling_rate;
 866
 867         /* Coordinate with others active sensors on the same device, if any */
 868         if (per_device_sampling_rate)
 869                 for (n=0; n<sensor_count; n++)
 870                         if (n != s && sensor[n].dev_num == dev_num && sensor[n].num_channels && is_enabled(n) &&
 871                                 sensor[n].semi_arbitrated_rate > arb_sampling_rate) {
 872                                 ALOGV("Sampling rate shared between %s and %s, using %g instead of %g\n", sensor[s].friendly_name, sensor[n].friendly_name,
 873                                                                                                           sensor[n].semi_arbitrated_rate, arb_sampling_rate);
 874                                 arb_sampling_rate = sensor[n].semi_arbitrated_rate;
 875                         }
 876
 877         sensor[s].sampling_rate = arb_sampling_rate;
 878
 879         /* Update actual sampling rate field for this sensor and others which may be sharing the same sampling rate */
 880         if (per_device_sampling_rate)
 881                 for (n=0; n<sensor_count; n++)
 882                         if (sensor[n].dev_num == dev_num && n != s && sensor[n].num_channels)
 883                                 sensor[n].sampling_rate = arb_sampling_rate;
 884
 885         /* If the desired rate is already active we're all set */
 886         if (arb_sampling_rate == cur_sampling_rate)
 887                 return 0;
 888
 889         ALOGI("Sensor %d (%s) sampling rate set to %g\n", s, sensor[s].friendly_name, arb_sampling_rate);
 890
 891         if (sensor[s].hrtimer_trigger_name[0] != '\0')
 892                 sysfs_write_float(hrtimer_sampling_path, ceilf(arb_sampling_rate));
 893
 894         if (trig_sensors_per_dev[dev_num])
 895                 enable_buffer(dev_num, 0);
 896
 897         sysfs_write_float(sysfs_path, arb_sampling_rate);
 898
 899         /* Check if it makes sense to use an alternate trigger */
 900         tentative_switch_trigger(s);
 901
 902         if (trig_sensors_per_dev[dev_num])
 903                 enable_buffer(dev_num, 1);
 904
 905         return 0;
 906 }
 907
 908
 909 static void reapply_sampling_rates (int s)
 910 {
 911         /*
 912          * The specified sensor was either enabled or disabled. Other sensors in the same group may have constraints related to this sensor
 913          * sampling rate on their own sampling rate, so reevaluate them by retrying to use their requested sampling rate, rather than the one
 914          * that ended up being used after arbitration.
 915          */
 916
 917         int i, j, base;
 918
 919         if (sensor[s].is_virtual) {
 920                 /* Take care of downwards dependencies */
 921                 for (i=0; i<sensor[s].base_count; i++) {
 922                         base = sensor[s].base[i];
 923                         sensor_set_rate(base, sensor[base].requested_rate);
 924                 }
 925                 return;
 926         }
 927
 928         /* Upwards too */
 929         for (i=0; i<sensor_count; i++)
 930                 for (j=0; j<sensor[i].base_count; j++)
 931                         if (sensor[i].base[j] == s) /* If sensor i depends on sensor s */
 932                                 sensor_set_rate(i, sensor[i].requested_rate);
 933 }
 934
 935
 936 static int sensor_activate_virtual (int s, int enabled, int from_virtual)
 937 {
 938         int i, base;
 939
 940         sensor[s].event_count = 0;
 941         sensor[s].meta_data_pending = 0;
 942
 943         if (!check_state_change(s, enabled, from_virtual))
 944                 return 0;       /* The state of the sensor remains the same ; we're done */
 945
 946         if (enabled)
 947                 ALOGI("Enabling sensor %d (%s)\n", s, sensor[s].friendly_name);
 948         else
 949                 ALOGI("Disabling sensor %d (%s)\n", s, sensor[s].friendly_name);
 950
 951         sensor[s].report_pending = 0;
 952
 953         for (i=0; i<sensor[s].base_count; i++) {
 954
 955                 base = sensor[s].base[i];
 956                 sensor_activate(base, enabled, 1);
 957
 958                 if (enabled)
 959                         sensor[base].ref_count++;
 960                 else
 961                         sensor[base].ref_count--;
 962         }
 963
 964         /* Reevaluate sampling rates of linked sensors */
 965         reapply_sampling_rates(s);
 966         return 0;
 967 }
 968
 969
 970 int sensor_activate (int s, int enabled, int from_virtual)
 971 {
 972         char device_name[PATH_MAX];
 973         struct epoll_event ev = {0};
 974         int dev_fd, event_fd;
 975         int ret, c, d;
 976         int dev_num = sensor[s].dev_num;
 977         size_t field_size;
 978         int catalog_index = sensor[s].catalog_index;
 979
 980         if (sensor[s].is_virtual)
 981                 return sensor_activate_virtual(s, enabled, from_virtual);
 982
 983         /* Prepare the report timestamp field for the first event, see set_report_ts method */
 984         sensor[s].report_ts = 0;
 985
 986         ret = adjust_counters(s, enabled, from_virtual);
 987
 988         /* If the operation was neutral in terms of state, we're done */
 989         if (ret <= 0)
 990                 return ret;
 991
 992         sensor[s].event_count = 0;
 993         sensor[s].meta_data_pending = 0;
 994
 995         if (enabled)
 996                 setup_noise_filtering(s);       /* Initialize filtering data if required */
 997
 998         if (sensor[s].mode == MODE_TRIGGER) {
 999
1000                 /* Stop sampling */
1001                 enable_buffer(dev_num, 0);
1002                 setup_trigger(s, "\n");
1003
1004                 /* If there's at least one sensor enabled on this iio device */
1005                 if (trig_sensors_per_dev[dev_num]) {
1006
1007                         /* Start sampling */
1008                         if (sensor[s].hrtimer_trigger_name[0] != '\0')
1009                                 setup_trigger(s, sensor[s].hrtimer_trigger_name);
1010                         else
1011                                 setup_trigger(s, sensor[s].init_trigger_name);
1012
1013                         enable_buffer(dev_num, 1);
1014                 }
1015         } else if (sensor[s].mode == MODE_POLL) {
1016                 if (sensor[s].needs_enable) {
1017                         enable_sensor(dev_num, sensor_catalog[catalog_index].tag, enabled);
1018                 }
1019         }
1020
1021         /*
1022          * Make sure we have a fd on the character device ; conversely, close the fd if no one is using associated sensors anymore. The assumption
1023          * here is that the underlying driver will power on the relevant hardware block while someone holds a fd on the device.
1024          */
1025         dev_fd = device_fd[dev_num];
1026
1027         if (!enabled) {
1028                 if (sensor[s].mode == MODE_POLL)
1029                         stop_acquisition_thread(s);
1030
1031                 if (dev_fd != -1 && !poll_sensors_per_dev[dev_num] && !trig_sensors_per_dev[dev_num]) {
1032                                 /* Stop watching this fd. This should be a no-op in case this fd was not in the poll set. */
1033                                 epoll_ctl(poll_fd, EPOLL_CTL_DEL, dev_fd, NULL);
1034
1035                                 close(dev_fd);
1036                                 device_fd[dev_num] = -1;
1037                 }
1038
1039                 if (sensor[s].mode == MODE_EVENT) {
1040                         event_fd = events_fd[dev_num];
1041
1042                         for (c = 0; c < sensor_catalog[catalog_index].num_channels; c++) {
1043                                 for (d = 0; d < sensor_catalog[catalog_index].channel[c].num_events; d++)
1044                                         enable_event(dev_num, sensor_catalog[catalog_index].channel[c].event[d].ev_en_path, enabled);
1045                         }
1046
1047                         epoll_ctl(poll_fd, EPOLL_CTL_DEL, event_fd, NULL);
1048                         close(event_fd);
1049                         events_fd[dev_num] = -1;
1050
1051                 }
1052
1053                 /* Release any filtering data we may have accumulated */
1054                 release_noise_filtering_data(s);
1055
1056                 /* Reevaluate sampling rates of linked sensors */
1057                 reapply_sampling_rates(s);
1058                 return 0;
1059         }
1060
1061         if (dev_fd == -1) {
1062                 /* First enabled sensor on this iio device */
1063                 sprintf(device_name, DEV_FILE_PATH, dev_num);
1064                 dev_fd = open(device_name, O_RDONLY | O_NONBLOCK);
1065
1066                 device_fd[dev_num] = dev_fd;
1067
1068                 if (dev_fd == -1) {
1069                         ALOGE("Could not open fd on %s (%s)\n", device_name, strerror(errno));
1070                         adjust_counters(s, 0, from_virtual);
1071                         return -1;
1072                 }
1073
1074                 ALOGV("Opened %s: fd=%d\n", device_name, dev_fd);
1075
1076                 if (sensor[s].mode == MODE_TRIGGER) {
1077
1078                         /* Add this iio device fd to the set of watched fds */
1079                         ev.events = EPOLLIN;
1080                         ev.data.u32 = dev_num;
1081
1082                         ret = epoll_ctl(poll_fd, EPOLL_CTL_ADD, dev_fd, &ev);
1083
1084                         if (ret == -1) {
1085                                 ALOGE("Failed adding %d to poll set (%s)\n", dev_fd, strerror(errno));
1086                                 return -1;
1087                         }
1088
1089                         /* Note: poll-mode fds are not readable */
1090                 } else if (sensor[s].mode == MODE_EVENT) {
1091                         event_fd = events_fd[dev_num];
1092
1093                         ret = ioctl(dev_fd, IIO_GET_EVENT_FD_IOCTL, &event_fd);
1094                         if (ret == -1 || event_fd == -1) {
1095                                 ALOGE("Failed to retrieve event_fd from %d (%s)\n", dev_fd, strerror(errno));
1096                                 return -1;
1097                         }
1098                         events_fd[dev_num] = event_fd;
1099                         ALOGV("Opened fd=%d to receive events\n", event_fd);
1100
1101                         /* Add this event fd to the set of watched fds */
1102                         ev.events = EPOLLIN;
1103                         ev.data.u32 = dev_num;
1104
1105                         ret = epoll_ctl(poll_fd, EPOLL_CTL_ADD, event_fd, &ev);
1106                         if (ret == -1) {
1107                                 ALOGE("Failed adding %d to poll set (%s)\n", event_fd, strerror(errno));
1108                                 return -1;
1109                         }
1110                         for (c = 0; c < sensor_catalog[catalog_index].num_channels; c++) {
1111                                 int d;
1112                                 for (d = 0; d < sensor_catalog[catalog_index].channel[c].num_events; d++)
1113                                         enable_event(dev_num, sensor_catalog[catalog_index].channel[c].event[d].ev_en_path, enabled);
1114                         }
1115
1116                         if (!poll_sensors_per_dev[dev_num] && !trig_sensors_per_dev[dev_num]) {
1117                                 close(dev_fd);
1118                                 device_fd[dev_num] = -1;
1119                         }
1120                 }
1121         }
1122
1123         /* Ensure that on-change sensors send at least one event after enable */
1124         get_field_count(s, &field_size);
1125         if (field_size == sizeof(uint64_t))
1126                 sensor[s].prev_val.data64 = -1;
1127         else
1128                 sensor[s].prev_val.data = -1;
1129
1130         if (sensor[s].mode == MODE_POLL)
1131                 start_acquisition_thread(s);
1132
1133         /* Reevaluate sampling rates of linked sensors */
1134         reapply_sampling_rates(s);
1135
1136         return 0;
1137 }
1138
1139
1140 static void enable_motion_trigger (int dev_num)
1141 {
1142         /*
1143          * In the ideal case, we enumerate two triggers per iio device ; the default (periodically firing) trigger, and another one (the motion
1144          * trigger) that only fires up when motion is detected. This second one allows for lesser energy consumption, but requires periodic sample
1145          * duplication at the HAL level for sensors that Android defines as continuous. This "duplicate last sample" logic can only be engaged
1146          * once we got a first sample for the driver, so we start with the default trigger when an iio device is first opened, then adjust the
1147          * trigger when we got events for all active sensors. Unfortunately in the general case several sensors can be associated to a given iio
1148          * device, they can independently be controlled, and we have to adjust the trigger in use at the iio device level depending on whether or
1149          * not appropriate conditions are met at the sensor level.
1150          */
1151
1152         int s;
1153         int i;
1154         int active_sensors = trig_sensors_per_dev[dev_num];
1155         int candidate[MAX_SENSORS];
1156         int candidate_count = 0;
1157
1158         if  (!active_sensors)
1159                 return;
1160
1161         /* Check that all active sensors are ready to switch */
1162
1163         for (s=0; s<MAX_SENSORS; s++)
1164                 if (sensor[s].dev_num == dev_num && is_enabled(s) && sensor[s].num_channels &&
1165                     (!sensor[s].motion_trigger_name[0] || !sensor[s].report_initialized || is_fast_accelerometer(s) ||
1166                      (sensor[s].quirks & QUIRK_FORCE_CONTINUOUS)))
1167                         return; /* Nope */
1168
1169         /* Record which particular sensors need to switch */
1170
1171         for (s=0; s<MAX_SENSORS; s++)
1172                 if (sensor[s].dev_num == dev_num && is_enabled(s) && sensor[s].num_channels && sensor[s].selected_trigger != sensor[s].motion_trigger_name)
1173                                 candidate[candidate_count++] = s;
1174
1175         if (!candidate_count)
1176                 return;
1177
1178         /* Now engage the motion trigger for sensors which aren't using it */
1179
1180         enable_buffer(dev_num, 0);
1181
1182         for (i=0; i<candidate_count; i++) {
1183                 s = candidate[i];
1184                 setup_trigger(s, sensor[s].motion_trigger_name);
1185         }
1186
1187         enable_buffer(dev_num, 1);
1188 }
1189
1190 static void stamp_reports (int dev_num, int64_t ts)
1191 {
1192         int s;
1193
1194         for (s=0; s<MAX_SENSORS; s++)
1195                 if (sensor[s].dev_num == dev_num && is_enabled(s) && sensor[s].mode != MODE_POLL) {
1196                         if (sensor[s].quirks & QUIRK_SPOTTY)
1197                                 set_report_ts(s, ts);
1198                         else
1199                                 sensor[s].report_ts = ts;
1200                 }
1201 }
1202
1203
1204 static int integrate_device_report_from_dev(int dev_num, int fd)
1205 {
1206         int len;
1207         int s,c;
1208         unsigned char buf[MAX_DEVICE_REPORT_SIZE] = { 0 };
1209         int sr_offset;
1210         unsigned char *target;
1211         unsigned char *source;
1212         int size;
1213         int64_t ts = 0;
1214         int ts_offset = 0;      /* Offset of iio timestamp, if provided */
1215         int64_t boot_to_rt_delta;
1216
1217         /* There's an incoming report on the specified iio device char dev fd */
1218         if (fd == -1) {
1219                 ALOGE("Ignoring stale report on iio device %d\n", dev_num);
1220                 return -1;
1221         }
1222
1223         len = read(fd, buf, expected_dev_report_size[dev_num]);
1224
1225         if (len == -1) {
1226                 ALOGE("Could not read report from iio device %d (%s)\n", dev_num, strerror(errno));
1227                 return -1;
1228         }
1229
1230         ALOGV("Read %d bytes from iio device %d\n", len, dev_num);
1231
1232         /* Map device report to sensor reports */
1233
1234         for (s=0; s<MAX_SENSORS; s++)
1235                 if (sensor[s].dev_num == dev_num && is_enabled(s)) {
1236
1237                         sr_offset = 0;
1238
1239                         /* Copy data from device to sensor report buffer */
1240                         for (c=0; c<sensor[s].num_channels; c++) {
1241
1242                                 target = sensor[s].report_buffer + sr_offset;
1243
1244                                 source = buf + sensor[s].channel[c].offset;
1245
1246                                 size = sensor[s].channel[c].size;
1247
1248                                 memcpy(target, source, size);
1249
1250                                 sr_offset += size;
1251                         }
1252
1253                         ALOGV("Sensor %d report available (%d bytes)\n", s, sr_offset);
1254
1255                         sensor[s].report_pending = DATA_TRIGGER;
1256                         sensor[s].report_initialized = 1;
1257
1258                 }
1259
1260         /* Tentatively switch to an any-motion trigger if conditions are met */
1261         enable_motion_trigger(dev_num);
1262
1263         /* If no iio timestamp channel was detected for this device, bail out */
1264         if (!has_iio_ts[dev_num]) {
1265                 stamp_reports(dev_num, get_timestamp_boot());
1266                 return 0;
1267         }
1268
1269         /* Don't trust the timestamp channel in any-motion mode */
1270         for (s=0; s<MAX_SENSORS; s++)
1271                 if (sensor[s].dev_num == dev_num && is_enabled(s) && sensor[s].selected_trigger == sensor[s].motion_trigger_name) {
1272                         stamp_reports(dev_num, get_timestamp_boot());
1273                         return 0;
1274                 }
1275
1276         /* Align on a 64 bits boundary */
1277         ts_offset = expected_dev_report_size[dev_num] - sizeof(int64_t);
1278
1279         /* If we read an amount of data consistent with timestamp presence */
1280         if (len == expected_dev_report_size[dev_num])
1281                 ts = *(int64_t*) (buf + ts_offset);
1282
1283         if (ts == 0) {
1284                 ALOGV("Unreliable timestamp channel on iio dev %d\n", dev_num);
1285                 stamp_reports(dev_num, get_timestamp_boot());
1286                 return 0;
1287         }
1288
1289         ALOGV("Driver timestamp on iio device %d: ts=%lld\n", dev_num, ts);
1290
1291         boot_to_rt_delta = get_timestamp_boot() - get_timestamp_realtime();
1292
1293         stamp_reports(dev_num, ts + boot_to_rt_delta);
1294
1295         return 0;
1296 }
1297
1298 static int integrate_device_report_from_event(int dev_num, int fd)
1299 {
1300         int len, s;
1301         int64_t ts;
1302         struct iio_event_data event;
1303
1304         /* There's an incoming report on the specified iio device char dev fd */
1305         if (fd == -1) {
1306                 ALOGE("Ignoring stale report on event fd %d of device %d\n",
1307                         fd, dev_num);
1308                 return -1;
1309         }
1310
1311         len = read(fd, &event, sizeof(event));
1312
1313         if (len == -1) {
1314                 ALOGE("Could not read event from fd %d of device %d (%s)\n",
1315                         fd, dev_num, strerror(errno));
1316                 return -1;
1317         }
1318
1319         ts = event.timestamp;
1320
1321         ALOGV("Read event %lld from fd %d of iio device %d\n", event.id, fd, dev_num);
1322
1323         /* Map device report to sensor reports */
1324         for (s = 0; s < MAX_SENSORS; s++)
1325                 if (sensor[s].dev_num == dev_num &&
1326                     is_enabled(s)) {
1327                         sensor[s].event_id = event.id;
1328                         sensor[s].report_ts = ts;
1329                         sensor[s].report_pending = 1;
1330                         sensor[s].report_initialized = 1;
1331                         ALOGV("Sensor %d report available (1 byte)\n", s);
1332                 }
1333         return 0;
1334 }
1335
1336 static int integrate_device_report(int dev_num)
1337 {
1338         int ret = 0;
1339
1340         if (dev_num < 0 || dev_num >= MAX_DEVICES) {
1341                 ALOGE("Event reported on unexpected iio device %d\n", dev_num);
1342                 return -1;
1343         }
1344
1345         if (events_fd[dev_num] != -1) {
1346                 ret = integrate_device_report_from_event(dev_num, events_fd[dev_num]);
1347                 if (ret < 0)
1348                         return ret;
1349         }
1350
1351         if (device_fd[dev_num] != -1)
1352                 ret = integrate_device_report_from_dev(dev_num, device_fd[dev_num]);
1353
1354         return ret;
1355 }
1356
1357 static int propagate_vsensor_report (int s, sensors_event_t *data)
1358 {
1359         /* There's a new report stored in sensor.sample for this sensor; transmit it */
1360
1361         memcpy(data, &sensor[s].sample, sizeof(sensors_event_t));
1362
1363         data->sensor    = s;
1364         data->type      = sensor_desc[s].type; /* sensor_desc[s].type can differ from sensor[s].type ; internal types are remapped */
1365         return 1;
1366 }
1367
1368
1369 static int propagate_sensor_report (int s, sensors_event_t *data)
1370 {
1371         /* There's a sensor report pending for this sensor ; transmit it */
1372
1373         size_t field_size;
1374         int num_fields    = get_field_count(s, &field_size);
1375         int c;
1376         unsigned char* current_sample;
1377         int ret;
1378
1379         /* If there's nothing to return... we're done */
1380         if (!num_fields)
1381                 return 0;
1382
1383         ALOGV("Sample on sensor %d (type %d):\n", s, sensor[s].type);
1384
1385         if (sensor[s].mode == MODE_POLL) {
1386                 /* We received a good sample but we're not directly enabled so we'll drop */
1387                 if (!sensor[s].directly_enabled)
1388                         return 0;
1389                 /* Use the data provided by the acquisition thread */
1390                 ALOGV("Reporting data from worker thread for S%d\n", s);
1391                 memcpy(data, &sensor[s].sample, sizeof(sensors_event_t));
1392                 data->timestamp = sensor[s].report_ts;
1393                 return 1;
1394         }
1395
1396         memset(data, 0, sizeof(sensors_event_t));
1397
1398         data->version   = sizeof(sensors_event_t);
1399         data->sensor    = s;
1400         data->type      = sensor_desc[s].type;  /* sensor_desc[s].type can differ from sensor[s].type ; internal types are remapped */
1401         data->timestamp = sensor[s].report_ts;
1402
1403         if (sensor[s].mode == MODE_EVENT) {
1404                 ALOGV("Reporting event\n");
1405                 /* Android requires events to return 1.0 */
1406                 int dir = IIO_EVENT_CODE_EXTRACT_DIR(sensor[s].event_id);
1407                 switch (sensor[s].type) {
1408                         case SENSOR_TYPE_PROXIMITY:
1409                                 if (dir == IIO_EV_DIR_FALLING)
1410                                         data->data[0] = 0.0;
1411                                 else
1412                                         data->data[0] = 1.0;
1413                                 break;
1414                         default:
1415                                 data->data[0] = 1.0;
1416                                 break;
1417
1418                 }
1419                 data->data[1] = 0.0;
1420                 data->data[2] = 0.0;
1421                 return 1;
1422         }
1423
1424         /* Convert the data into the expected Android-level format */
1425
1426         current_sample = sensor[s].report_buffer;
1427
1428         for (c=0; c<num_fields; c++) {
1429
1430                 data->data[c] = sensor[s].ops.transform (s, c, current_sample);
1431
1432                 ALOGV("\tfield %d: %g\n", c, data->data[c]);
1433                 current_sample += sensor[s].channel[c].size;
1434         }
1435
1436         ret = sensor[s].ops.finalize(s, data);
1437
1438         /* We will drop samples if the sensor is not directly enabled */
1439         if (!sensor[s].directly_enabled)
1440                 return 0;
1441
1442         /* The finalize routine, in addition to its late sample processing duty, has the final say on whether or not the sample gets sent to Android */
1443         return ret;
1444 }
1445
1446
1447 static void synthetize_duplicate_samples (void)
1448 {
1449         /*
1450          * Some sensor types (ex: gyroscope) are defined as continuously firing by Android, despite the fact that
1451          * we can be dealing with iio drivers that only report events for new samples. For these we generate reports
1452          * periodically, duplicating the last data we got from the driver. This is not necessary for polling sensors.
1453          */
1454
1455         int s;
1456         int64_t current_ts;
1457         int64_t target_ts;
1458         int64_t period;
1459
1460         for (s=0; s<sensor_count; s++) {
1461
1462                 /* Ignore disabled sensors */
1463                 if (!is_enabled(s))
1464                         continue;
1465
1466                 /* If the sensor is continuously firing, leave it alone */
1467                 if (sensor[s].selected_trigger != sensor[s].motion_trigger_name)
1468                         continue;
1469
1470                 /* If we haven't seen a sample, there's nothing to duplicate */
1471                 if (!sensor[s].report_initialized)
1472                         continue;
1473
1474                 /* If a sample was recently buffered, leave it alone too */
1475                 if (sensor[s].report_pending)
1476                         continue;
1477
1478                 /* We also need a valid sampling rate to be configured */
1479                 if (!sensor[s].sampling_rate)
1480                         continue;
1481
1482                 period = (int64_t) (1000000000.0 / sensor[s].sampling_rate);
1483
1484                 current_ts = get_timestamp_boot();
1485                 target_ts = sensor[s].report_ts + period;
1486
1487                 if (target_ts <= current_ts) {
1488                         /* Mark the sensor for event generation */
1489                         set_report_ts(s, current_ts);
1490                         sensor[s].report_pending = DATA_DUPLICATE;
1491                 }
1492         }
1493 }
1494
1495
1496 static void integrate_thread_report (uint32_t tag)
1497 {
1498         int s = tag - THREAD_REPORT_TAG_BASE;
1499         int len;
1500
1501         len = read(sensor[s].thread_data_fd[0], &sensor[s].sample, sizeof(sensors_event_t));
1502
1503         if (len == sizeof(sensors_event_t))
1504                 sensor[s].report_pending = DATA_SYSFS;
1505 }
1506
1507
1508 static int get_poll_wait_timeout (void)
1509 {
1510         /*
1511          * Compute an appropriate timeout value, in ms, for the epoll_wait call that's going to await
1512          * for iio device reports and incoming reports from our sensor sysfs data reader threads.
1513          */
1514
1515         int s;
1516         int64_t target_ts = INT64_MAX;
1517         int64_t ms_to_wait;
1518         int64_t period;
1519
1520         /*
1521          * Check if we're dealing with a driver that only send events when there is motion, despite the fact that the associated Android sensor
1522          * type is continuous rather than on-change. In that case we have to duplicate events. Check deadline for the nearest upcoming event.
1523          */
1524         for (s=0; s<sensor_count; s++)
1525                 if (is_enabled(s) && sensor[s].selected_trigger == sensor[s].motion_trigger_name && sensor[s].sampling_rate) {
1526                         period = (int64_t) (1000000000.0 / sensor[s].sampling_rate);
1527
1528                         if (sensor[s].report_ts + period < target_ts)
1529                                 target_ts = sensor[s].report_ts + period;
1530                 }
1531
1532         /* If we don't have such a driver to deal with */
1533         if (target_ts == INT64_MAX)
1534                 return -1; /* Infinite wait */
1535
1536         ms_to_wait = (target_ts - get_timestamp_boot()) / 1000000;
1537
1538         /* If the target timestamp is already behind us, don't wait */
1539         if (ms_to_wait < 1)
1540                 return 0;
1541
1542         return ms_to_wait;
1543 }
1544
1545
1546 int sensor_poll (sensors_event_t* data, int count)
1547 {
1548         int s;
1549         int i;
1550         int nfds;
1551         struct epoll_event ev[MAX_DEVICES];
1552         int returned_events;
1553         int event_count;
1554
1555         /* Get one or more events from our collection of sensors */
1556 return_available_sensor_reports:
1557
1558         /* Synthetize duplicate samples if needed */
1559         synthetize_duplicate_samples();
1560
1561         returned_events = 0;
1562
1563         /* Check our sensor collection for available reports */
1564         for (s=0; s<sensor_count && returned_events < count; s++) {
1565
1566                 if (sensor[s].report_pending) {
1567                         event_count = 0;
1568
1569                         if (sensor[s].is_virtual)
1570                                 event_count = propagate_vsensor_report(s, &data[returned_events]);
1571                         else
1572                                 /* Report this event if it looks OK */
1573                                 event_count = propagate_sensor_report(s, &data[returned_events]);
1574
1575                         /* Lower flag */
1576                         sensor[s].report_pending = 0;
1577                         returned_events += event_count;
1578
1579                         /*
1580                          * If the sample was deemed invalid or unreportable, e.g. had the same value as the previously reported
1581                          * value for a 'on change' sensor, silently drop it.
1582                          */
1583                 }
1584
1585                 while (sensor[s].meta_data_pending) {
1586                         /* See sensors.h on these */
1587                         data[returned_events].version = META_DATA_VERSION;
1588                         data[returned_events].sensor = 0;
1589                         data[returned_events].type = SENSOR_TYPE_META_DATA;
1590                         data[returned_events].reserved0 = 0;
1591                         data[returned_events].timestamp = 0;
1592                         data[returned_events].meta_data.sensor = s;
1593                         data[returned_events].meta_data.what = META_DATA_FLUSH_COMPLETE;
1594                         returned_events++;
1595                         sensor[s].meta_data_pending--;
1596                 }
1597         }
1598
1599         if (returned_events)
1600                 return returned_events;
1601
1602 await_event:
1603
1604         ALOGV("Awaiting sensor data\n");
1605
1606         nfds = epoll_wait(poll_fd, ev, MAX_DEVICES, get_poll_wait_timeout());
1607
1608         if (nfds == -1) {
1609                 ALOGE("epoll_wait returned -1 (%s)\n", strerror(errno));
1610                 goto await_event;
1611         }
1612
1613         ALOGV("%d fds signalled\n", nfds);
1614
1615         /* For each of the signalled sources */
1616         for (i=0; i<nfds; i++)
1617                 if (ev[i].events == EPOLLIN)
1618                         switch (ev[i].data.u32) {
1619                                 case 0 ... MAX_DEVICES-1:
1620                                         /* Read report from iio char dev fd */
1621                                         integrate_device_report(ev[i].data.u32);
1622                                         break;
1623
1624                                 case THREAD_REPORT_TAG_BASE ...
1625                                      THREAD_REPORT_TAG_BASE + MAX_SENSORS-1:
1626                                         /* Get report from acquisition thread */
1627                                         integrate_thread_report(ev[i].data.u32);
1628                                         break;
1629
1630                                 default:
1631                                         ALOGW("Unexpected event source!\n");
1632                                         break;
1633                         }
1634
1635         goto return_available_sensor_reports;
1636 }
1637
1638
1639 int sensor_set_delay (int s, int64_t ns)
1640 {
1641         float requested_sampling_rate;
1642
1643         if (ns <= 0) {
1644                 ALOGE("Invalid delay requested on sensor %d: %lld\n", s, ns);
1645                 return -EINVAL;
1646         }
1647
1648         requested_sampling_rate = 1000000000.0 / ns;
1649
1650         ALOGV("Entering set delay S%d (%s): current rate: %g, requested: %g\n", s, sensor[s].friendly_name, sensor[s].sampling_rate, requested_sampling_rate);
1651
1652         /*
1653          * Only try to adjust the low level sampling rate if it's different from the current one, as set by the HAL. This saves a few sysfs
1654          * reads and writes as well as buffer enable/disable operations, since at the iio level most drivers require the buffer to be turned off
1655          * in order to accept a sampling rate change. Of course that implies that this field has to be kept up to date and that only this library
1656          * is changing the sampling rate.
1657          */
1658
1659         if (requested_sampling_rate != sensor[s].sampling_rate)
1660                 return sensor_set_rate(s, requested_sampling_rate);
1661
1662         return 0;
1663 }
1664
1665
1666 int sensor_flush (int s)
1667 {
1668         /* If one shot or not enabled return -EINVAL */
1669         if (sensor_desc[s].flags & SENSOR_FLAG_ONE_SHOT_MODE || !is_enabled(s))
1670                 return -EINVAL;
1671
1672         sensor[s].meta_data_pending++;
1673         return 0;
1674 }
1675
1676
1677 int allocate_control_data (void)
1678 {
1679         int i;
1680
1681         for (i=0; i<MAX_DEVICES; i++) {
1682                 device_fd[i] = -1;
1683                 events_fd[i] = -1;
1684         }
1685
1686         poll_fd = epoll_create(MAX_DEVICES);
1687
1688         if (poll_fd == -1) {
1689                 ALOGE("Can't create epoll instance for iio sensors!\n");
1690                 return -1;
1691         }
1692
1693         return poll_fd;
1694 }
1695
1696
1697 void delete_control_data (void)
1698 {
1699 }