libs/gui/Sensor.cpp

   1 /*
   2  * Copyright (C) 2010 The Android Open Source Project
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #include <inttypes.h>
  18 #include <stdint.h>
  19 #include <sys/types.h>
  20 #include <sys/limits.h>
  21
  22 #include <utils/Errors.h>
  23 #include <utils/String8.h>
  24 #include <utils/Flattenable.h>
  25
  26 #include <hardware/sensors.h>
  27
  28 #include <binder/AppOpsManager.h>
  29 #include <binder/IServiceManager.h>
  30
  31 #include <gui/Sensor.h>
  32 #include <log/log.h>
  33
  34 // ----------------------------------------------------------------------------
  35 namespace android {
  36 // ----------------------------------------------------------------------------
  37
  38 Sensor::Sensor()
  39     : mHandle(0), mType(0),
  40       mMinValue(0), mMaxValue(0), mResolution(0),
  41       mPower(0), mMinDelay(0), mFifoReservedEventCount(0), mFifoMaxEventCount(0),
  42       mMaxDelay(0), mFlags(0)
  43 {
  44 }
  45
  46 Sensor::Sensor(struct sensor_t const* hwSensor, int halVersion)
  47 {
  48     mName = hwSensor->name;
  49     mVendor = hwSensor->vendor;
  50     mVersion = hwSensor->version;
  51     mHandle = hwSensor->handle;
  52     mType = hwSensor->type;
  53     mMinValue = 0;                      // FIXME: minValue
  54     mMaxValue = hwSensor->maxRange;     // FIXME: maxValue
  55     mResolution = hwSensor->resolution;
  56     mPower = hwSensor->power;
  57     mMinDelay = hwSensor->minDelay;
  58     mFlags = 0;
  59
  60     // Set fifo event count zero for older devices which do not support batching. Fused
  61     // sensors also have their fifo counts set to zero.
  62     if (halVersion > SENSORS_DEVICE_API_VERSION_1_0) {
  63         mFifoReservedEventCount = hwSensor->fifoReservedEventCount;
  64         mFifoMaxEventCount = hwSensor->fifoMaxEventCount;
  65     } else {
  66         mFifoReservedEventCount = 0;
  67         mFifoMaxEventCount = 0;
  68     }
  69
  70     if (halVersion >= SENSORS_DEVICE_API_VERSION_1_3) {
  71         if (hwSensor->maxDelay > INT_MAX) {
  72             // Max delay is declared as a 64 bit integer for 64 bit architectures. But it should
  73             // always fit in a 32 bit integer, log error and cap it to INT_MAX.
  74             ALOGE("Sensor maxDelay overflow error %s %" PRId64, mName.string(),
  75                   static_cast<int64_t>(hwSensor->maxDelay));
  76             mMaxDelay = INT_MAX;
  77         } else {
  78             mMaxDelay = static_cast<int32_t>(hwSensor->maxDelay);
  79         }
  80     } else {
  81         // For older hals set maxDelay to 0.
  82         mMaxDelay = 0;
  83     }
  84
  85     // Ensure existing sensors have correct string type, required permissions and reporting mode.
  86     // Set reportingMode for all android defined sensor types, set wake-up flag only for proximity
  87     // sensor, significant motion, tilt, pick_up gesture, wake gesture and glance gesture on older
  88     // HALs. Newer HALs can define both wake-up and non wake-up proximity sensors.
  89     // All the OEM defined defined sensors have flags set to whatever is provided by the HAL.
  90     switch (mType) {
  91     case SENSOR_TYPE_ACCELEROMETER:
  92         mStringType = SENSOR_STRING_TYPE_ACCELEROMETER;
  93         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
  94         break;
  95     case SENSOR_TYPE_AMBIENT_TEMPERATURE:
  96         mStringType = SENSOR_STRING_TYPE_AMBIENT_TEMPERATURE;
  97         mFlags |= SENSOR_FLAG_ON_CHANGE_MODE;
  98         break;
  99     case SENSOR_TYPE_GAME_ROTATION_VECTOR:
 100         mStringType = SENSOR_STRING_TYPE_GAME_ROTATION_VECTOR;
 101         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 102         break;
 103     case SENSOR_TYPE_GEOMAGNETIC_ROTATION_VECTOR:
 104         mStringType = SENSOR_STRING_TYPE_GEOMAGNETIC_ROTATION_VECTOR;
 105         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 106         break;
 107     case SENSOR_TYPE_GRAVITY:
 108         mStringType = SENSOR_STRING_TYPE_GRAVITY;
 109         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 110         break;
 111     case SENSOR_TYPE_GYROSCOPE:
 112         mStringType = SENSOR_STRING_TYPE_GYROSCOPE;
 113         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 114         break;
 115     case SENSOR_TYPE_GYROSCOPE_UNCALIBRATED:
 116         mStringType = SENSOR_STRING_TYPE_GYROSCOPE_UNCALIBRATED;
 117         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 118         break;
 119     case SENSOR_TYPE_HEART_RATE: {
 120         mStringType = SENSOR_STRING_TYPE_HEART_RATE;
 121         mRequiredPermission = SENSOR_PERMISSION_BODY_SENSORS;
 122         AppOpsManager appOps;
 123         mRequiredAppOp = appOps.permissionToOpCode(String16(SENSOR_PERMISSION_BODY_SENSORS));
 124         mFlags |= SENSOR_FLAG_ON_CHANGE_MODE;
 125         } break;
 126     case SENSOR_TYPE_LIGHT:
 127         mStringType = SENSOR_STRING_TYPE_LIGHT;
 128         mFlags |= SENSOR_FLAG_ON_CHANGE_MODE;
 129         break;
 130     case SENSOR_TYPE_LINEAR_ACCELERATION:
 131         mStringType = SENSOR_STRING_TYPE_LINEAR_ACCELERATION;
 132         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 133         break;
 134     case SENSOR_TYPE_MAGNETIC_FIELD:
 135         mStringType = SENSOR_STRING_TYPE_MAGNETIC_FIELD;
 136         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 137         break;
 138     case SENSOR_TYPE_MAGNETIC_FIELD_UNCALIBRATED:
 139         mStringType = SENSOR_STRING_TYPE_MAGNETIC_FIELD_UNCALIBRATED;
 140         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 141         break;
 142     case SENSOR_TYPE_ORIENTATION:
 143         mStringType = SENSOR_STRING_TYPE_ORIENTATION;
 144         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 145         break;
 146     case SENSOR_TYPE_PRESSURE:
 147         mStringType = SENSOR_STRING_TYPE_PRESSURE;
 148         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 149         break;
 150     case SENSOR_TYPE_PROXIMITY:
 151         mStringType = SENSOR_STRING_TYPE_PROXIMITY;
 152         mFlags |= SENSOR_FLAG_ON_CHANGE_MODE;
 153         if (halVersion < SENSORS_DEVICE_API_VERSION_1_3) {
 154             mFlags |= SENSOR_FLAG_WAKE_UP;
 155         }
 156         break;
 157     case SENSOR_TYPE_RELATIVE_HUMIDITY:
 158         mStringType = SENSOR_STRING_TYPE_RELATIVE_HUMIDITY;
 159         mFlags |= SENSOR_FLAG_ON_CHANGE_MODE;
 160         break;
 161     case SENSOR_TYPE_ROTATION_VECTOR:
 162         mStringType = SENSOR_STRING_TYPE_ROTATION_VECTOR;
 163         mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 164         break;
 165     case SENSOR_TYPE_SIGNIFICANT_MOTION:
 166         mStringType = SENSOR_STRING_TYPE_SIGNIFICANT_MOTION;
 167         mFlags |= SENSOR_FLAG_ONE_SHOT_MODE;
 168         if (halVersion < SENSORS_DEVICE_API_VERSION_1_3) {
 169             mFlags |= SENSOR_FLAG_WAKE_UP;
 170         }
 171         break;
 172     case SENSOR_TYPE_STEP_COUNTER:
 173         mStringType = SENSOR_STRING_TYPE_STEP_COUNTER;
 174         mFlags |= SENSOR_FLAG_ON_CHANGE_MODE;
 175         break;
 176     case SENSOR_TYPE_STEP_DETECTOR:
 177         mStringType = SENSOR_STRING_TYPE_STEP_DETECTOR;
 178         mFlags |= SENSOR_FLAG_SPECIAL_REPORTING_MODE;
 179         break;
 180     case SENSOR_TYPE_TEMPERATURE:
 181         mStringType = SENSOR_STRING_TYPE_TEMPERATURE;
 182         mFlags |= SENSOR_FLAG_ON_CHANGE_MODE;
 183         break;
 184     case SENSOR_TYPE_TILT_DETECTOR:
 185         mStringType = SENSOR_STRING_TYPE_TILT_DETECTOR;
 186         mFlags |= SENSOR_FLAG_SPECIAL_REPORTING_MODE;
 187         if (halVersion < SENSORS_DEVICE_API_VERSION_1_3) {
 188             mFlags |= SENSOR_FLAG_WAKE_UP;
 189         }
 190          break;
 191     case SENSOR_TYPE_WAKE_GESTURE:
 192         mStringType = SENSOR_STRING_TYPE_WAKE_GESTURE;
 193         mFlags |= SENSOR_FLAG_ONE_SHOT_MODE;
 194         if (halVersion < SENSORS_DEVICE_API_VERSION_1_3) {
 195             mFlags |= SENSOR_FLAG_WAKE_UP;
 196         }
 197         break;
 198     case SENSOR_TYPE_GLANCE_GESTURE:
 199         mStringType = SENSOR_STRING_TYPE_GLANCE_GESTURE;
 200         mFlags |= SENSOR_FLAG_ONE_SHOT_MODE;
 201         if (halVersion < SENSORS_DEVICE_API_VERSION_1_3) {
 202             mFlags |= SENSOR_FLAG_WAKE_UP;
 203         }
 204         break;
 205     case SENSOR_TYPE_PICK_UP_GESTURE:
 206         mStringType = SENSOR_STRING_TYPE_PICK_UP_GESTURE;
 207         mFlags |= SENSOR_FLAG_ONE_SHOT_MODE;
 208         if (halVersion < SENSORS_DEVICE_API_VERSION_1_3) {
 209             mFlags |= SENSOR_FLAG_WAKE_UP;
 210         }
 211         break;
 212     case SENSOR_TYPE_WRIST_TILT_GESTURE:
 213         mStringType = SENSOR_STRING_TYPE_WRIST_TILT_GESTURE;
 214         mFlags |= SENSOR_FLAG_SPECIAL_REPORTING_MODE;
 215         if (halVersion < SENSORS_DEVICE_API_VERSION_1_3) {
 216             mFlags |= SENSOR_FLAG_WAKE_UP;
 217         }
 218         break;
 219     default:
 220         // Only pipe the stringType, requiredPermission and flags for custom sensors.
 221         if (halVersion > SENSORS_DEVICE_API_VERSION_1_0 && hwSensor->stringType) {
 222             mStringType = hwSensor->stringType;
 223         }
 224         if (halVersion > SENSORS_DEVICE_API_VERSION_1_0 && hwSensor->requiredPermission) {
 225             mRequiredPermission = hwSensor->requiredPermission;
 226             if (!strcmp(mRequiredPermission, SENSOR_PERMISSION_BODY_SENSORS)) {
 227                 AppOpsManager appOps;
 228                 mRequiredAppOp = appOps.permissionToOpCode(String16(SENSOR_PERMISSION_BODY_SENSORS));
 229             }
 230         }
 231
 232         if (halVersion >= SENSORS_DEVICE_API_VERSION_1_3) {
 233             mFlags = static_cast<uint32_t>(hwSensor->flags);
 234         } else {
 235             // This is an OEM defined sensor on an older HAL. Use minDelay to determine the
 236             // reporting mode of the sensor.
 237             if (mMinDelay > 0) {
 238                 mFlags |= SENSOR_FLAG_CONTINUOUS_MODE;
 239             } else if (mMinDelay == 0) {
 240                 mFlags |= SENSOR_FLAG_ON_CHANGE_MODE;
 241             } else if (mMinDelay < 0) {
 242                 mFlags |= SENSOR_FLAG_ONE_SHOT_MODE;
 243             }
 244         }
 245         break;
 246     }
 247
 248     // Set DATA_INJECTION flag here. Defined in HAL 1_4.
 249     if (halVersion >= SENSORS_DEVICE_API_VERSION_1_4) {
 250         mFlags |= (hwSensor->flags & DATA_INJECTION_MASK);
 251     }
 252
 253     // For the newer HALs log errors if reporting mask flags are set incorrectly.
 254     if (halVersion >= SENSORS_DEVICE_API_VERSION_1_3) {
 255         // Wake-up flag is set here.
 256         mFlags |= (hwSensor->flags & SENSOR_FLAG_WAKE_UP);
 257         if (mFlags != hwSensor->flags) {
 258             int actualReportingMode =
 259                  (hwSensor->flags & REPORTING_MODE_MASK) >> REPORTING_MODE_SHIFT;
 260             int expectedReportingMode = (mFlags & REPORTING_MODE_MASK) >> REPORTING_MODE_SHIFT;
 261             if (actualReportingMode != expectedReportingMode) {
 262                 ALOGE("Reporting Mode incorrect: sensor %s handle=%d type=%d "
 263                        "actual=%d expected=%d",
 264                        mName.string(), mHandle, mType, actualReportingMode, expectedReportingMode);
 265             }
 266
 267         }
 268     }
 269
 270     if (mRequiredPermission.length() > 0) {
 271         // If the sensor is protected by a permission we need to know if it is
 272         // a runtime one to determine whether we can use the permission cache.
 273         sp<IBinder> binder = defaultServiceManager()->getService(String16("permission"));
 274         if (binder != 0) {
 275             sp<IPermissionController> permCtrl = interface_cast<IPermissionController>(binder);
 276             mRequiredPermissionRuntime = permCtrl->isRuntimePermission(
 277                     String16(mRequiredPermission));
 278         }
 279     }
 280 }
 281
 282 Sensor::~Sensor()
 283 {
 284 }
 285
 286 const String8& Sensor::getName() const {
 287     return mName;
 288 }
 289
 290 const String8& Sensor::getVendor() const {
 291     return mVendor;
 292 }
 293
 294 int32_t Sensor::getHandle() const {
 295     return mHandle;
 296 }
 297
 298 int32_t Sensor::getType() const {
 299     return mType;
 300 }
 301
 302 float Sensor::getMinValue() const {
 303     return mMinValue;
 304 }
 305
 306 float Sensor::getMaxValue() const {
 307     return mMaxValue;
 308 }
 309
 310 float Sensor::getResolution() const {
 311     return mResolution;
 312 }
 313
 314 float Sensor::getPowerUsage() const {
 315     return mPower;
 316 }
 317
 318 int32_t Sensor::getMinDelay() const {
 319     return mMinDelay;
 320 }
 321
 322 nsecs_t Sensor::getMinDelayNs() const {
 323     return getMinDelay() * 1000;
 324 }
 325
 326 int32_t Sensor::getVersion() const {
 327     return mVersion;
 328 }
 329
 330 uint32_t Sensor::getFifoReservedEventCount() const {
 331     return mFifoReservedEventCount;
 332 }
 333
 334 uint32_t Sensor::getFifoMaxEventCount() const {
 335     return mFifoMaxEventCount;
 336 }
 337
 338 const String8& Sensor::getStringType() const {
 339     return mStringType;
 340 }
 341
 342 const String8& Sensor::getRequiredPermission() const {
 343     return mRequiredPermission;
 344 }
 345
 346 bool Sensor::isRequiredPermissionRuntime() const {
 347     return mRequiredPermissionRuntime;
 348 }
 349
 350 int32_t Sensor::getRequiredAppOp() const {
 351     return mRequiredAppOp;
 352 }
 353
 354 int32_t Sensor::getMaxDelay() const {
 355     return mMaxDelay;
 356 }
 357
 358 uint32_t Sensor::getFlags() const {
 359     return mFlags;
 360 }
 361
 362 bool Sensor::isWakeUpSensor() const {
 363     return mFlags & SENSOR_FLAG_WAKE_UP;
 364 }
 365
 366 int32_t Sensor::getReportingMode() const {
 367     return ((mFlags & REPORTING_MODE_MASK) >> REPORTING_MODE_SHIFT);
 368 }
 369
 370 size_t Sensor::getFlattenedSize() const
 371 {
 372     size_t fixedSize =
 373             sizeof(int32_t) * 3 +
 374             sizeof(float) * 4 +
 375             sizeof(int32_t) * 6 +
 376             sizeof(bool);
 377
 378     size_t variableSize =
 379             sizeof(uint32_t) + FlattenableUtils::align<4>(mName.length()) +
 380             sizeof(uint32_t) + FlattenableUtils::align<4>(mVendor.length()) +
 381             sizeof(uint32_t) + FlattenableUtils::align<4>(mStringType.length()) +
 382             sizeof(uint32_t) + FlattenableUtils::align<4>(mRequiredPermission.length());
 383
 384     return fixedSize + variableSize;
 385 }
 386
 387 status_t Sensor::flatten(void* buffer, size_t size) const {
 388     if (size < getFlattenedSize()) {
 389         return NO_MEMORY;
 390     }
 391
 392     flattenString8(buffer, size, mName);
 393     flattenString8(buffer, size, mVendor);
 394     FlattenableUtils::write(buffer, size, mVersion);
 395     FlattenableUtils::write(buffer, size, mHandle);
 396     FlattenableUtils::write(buffer, size, mType);
 397     FlattenableUtils::write(buffer, size, mMinValue);
 398     FlattenableUtils::write(buffer, size, mMaxValue);
 399     FlattenableUtils::write(buffer, size, mResolution);
 400     FlattenableUtils::write(buffer, size, mPower);
 401     FlattenableUtils::write(buffer, size, mMinDelay);
 402     FlattenableUtils::write(buffer, size, mFifoReservedEventCount);
 403     FlattenableUtils::write(buffer, size, mFifoMaxEventCount);
 404     flattenString8(buffer, size, mStringType);
 405     flattenString8(buffer, size, mRequiredPermission);
 406     FlattenableUtils::write(buffer, size, mRequiredPermissionRuntime);
 407     FlattenableUtils::write(buffer, size, mRequiredAppOp);
 408     FlattenableUtils::write(buffer, size, mMaxDelay);
 409     FlattenableUtils::write(buffer, size, mFlags);
 410     return NO_ERROR;
 411 }
 412
 413 status_t Sensor::unflatten(void const* buffer, size_t size) {
 414     if (!unflattenString8(buffer, size, mName)) {
 415         return NO_MEMORY;
 416     }
 417     if (!unflattenString8(buffer, size, mVendor)) {
 418         return NO_MEMORY;
 419     }
 420
 421     size_t fixedSize =
 422             sizeof(int32_t) * 3 +
 423             sizeof(float) * 4 +
 424             sizeof(int32_t) * 5;
 425     if (size < fixedSize) {
 426         return NO_MEMORY;
 427     }
 428
 429     FlattenableUtils::read(buffer, size, mVersion);
 430     FlattenableUtils::read(buffer, size, mHandle);
 431     FlattenableUtils::read(buffer, size, mType);
 432     FlattenableUtils::read(buffer, size, mMinValue);
 433     FlattenableUtils::read(buffer, size, mMaxValue);
 434     FlattenableUtils::read(buffer, size, mResolution);
 435     FlattenableUtils::read(buffer, size, mPower);
 436     FlattenableUtils::read(buffer, size, mMinDelay);
 437     FlattenableUtils::read(buffer, size, mFifoReservedEventCount);
 438     FlattenableUtils::read(buffer, size, mFifoMaxEventCount);
 439
 440     if (!unflattenString8(buffer, size, mStringType)) {
 441         return NO_MEMORY;
 442     }
 443     if (!unflattenString8(buffer, size, mRequiredPermission)) {
 444         return NO_MEMORY;
 445     }
 446     FlattenableUtils::read(buffer, size, mRequiredPermissionRuntime);
 447     FlattenableUtils::read(buffer, size, mRequiredAppOp);
 448     FlattenableUtils::read(buffer, size, mMaxDelay);
 449     FlattenableUtils::read(buffer, size, mFlags);
 450     return NO_ERROR;
 451 }
 452
 453 void Sensor::flattenString8(void*& buffer, size_t& size,
 454         const String8& string8) {
 455     uint32_t len = static_cast<uint32_t>(string8.length());
 456     FlattenableUtils::write(buffer, size, len);
 457     memcpy(static_cast<char*>(buffer), string8.string(), len);
 458     FlattenableUtils::advance(buffer, size, FlattenableUtils::align<4>(len));
 459 }
 460
 461 bool Sensor::unflattenString8(void const*& buffer, size_t& size, String8& outputString8) {
 462     uint32_t len;
 463     if (size < sizeof(len)) {
 464         return false;
 465     }
 466     FlattenableUtils::read(buffer, size, len);
 467     if (size < len) {
 468         return false;
 469     }
 470     outputString8.setTo(static_cast<char const*>(buffer), len);
 471     FlattenableUtils::advance(buffer, size, FlattenableUtils::align<4>(len));
 472     return true;
 473 }
 474
 475 // ----------------------------------------------------------------------------
 476 }; // namespace android