SensorDevice.h revision 724d91d778e71c8186399f4955de14b54812b3ed
1b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross/* 2b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * Copyright (C) 2010 The Android Open Source Project 3b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * 4b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * Licensed under the Apache License, Version 2.0 (the "License"); 5b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * you may not use this file except in compliance with the License. 6b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * You may obtain a copy of the License at 7b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * 8b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * http://www.apache.org/licenses/LICENSE-2.0 9b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * 10b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * Unless required by applicable law or agreed to in writing, software 11b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * distributed under the License is distributed on an "AS IS" BASIS, 12b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * See the License for the specific language governing permissions and 14b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross * limitations under the License. 15b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross */ 16b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross 17b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross#ifndef ANDROID_SENSOR_DEVICE_H 18b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross#define ANDROID_SENSOR_DEVICE_H 19b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross 20b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross#include <stdint.h> 21b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross#include <sys/types.h> 22b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross 23b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross#include <utils/KeyedVector.h> 24b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross#include <utils/Singleton.h> 25b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross#include <utils/String8.h> 26b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross 27b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross#include <gui/Sensor.h> 28b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross 29b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross// --------------------------------------------------------------------------- 30b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross 31b731ae01b15682a3326dc4145f614f919b2789b5Colin Crossnamespace android { 32b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross// --------------------------------------------------------------------------- 339a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen 349a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissenclass SensorDevice : public Singleton<SensorDevice> { 355c0106e134366312206702f1b072347e20c90374Marco Nelissen friend class Singleton<SensorDevice>; 36ca13fa7dd4662921bc399e021e2ad92ddf5f5366Ruchi Kandoi sensors_poll_device_1_t* mSensorDevice; 37b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross struct sensors_module_t* mSensorModule; 38b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross static const nsecs_t MINIMUM_EVENTS_PERIOD = 1000000; // 1000 Hz 39b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross mutable Mutex mLock; // protect mActivationCount[].batchParams 40b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross // fixed-size array after construction 41b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross 42b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross // Struct to store all the parameters(samplingPeriod, maxBatchReportLatency and flags) from 43b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross // batch call. For continous mode clients, maxBatchReportLatency is set to zero. 44b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross struct BatchParams { 45b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross int flags; 46b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross nsecs_t batchDelay, batchTimeout; 4780d7fd86e05e6f14dffc9f0c9bf176a7c8680f8cDianne Hackborn BatchParams() : flags(0), batchDelay(0), batchTimeout(0) {} 4880d7fd86e05e6f14dffc9f0c9bf176a7c8680f8cDianne Hackborn BatchParams(int flag, nsecs_t delay, nsecs_t timeout): flags(flag), batchDelay(delay), 49b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross batchTimeout(timeout) { } 50b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross bool operator != (const BatchParams& other) { 51b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross return other.batchDelay != batchDelay || other.batchTimeout != batchTimeout || 52b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross other.flags != flags; 53b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross } 54ac1f70bb7135cd5fe73d6fbf121a62c779679c5aJeff Brown }; 55b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross 5680d7fd86e05e6f14dffc9f0c9bf176a7c8680f8cDianne Hackborn // Store batch parameters in the KeyedVector and the optimal batch_rate and timeout in 57ac1f70bb7135cd5fe73d6fbf121a62c779679c5aJeff Brown // bestBatchParams. For every batch() call corresponding params are stored in batchParams 58f74865eb525b34af7983777a522a5bfc496fc1c5Dianne Hackborn // vector. A continuous mode request is batch(... timeout=0 ..) followed by activate(). A batch 59b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross // mode request is batch(... timeout > 0 ...) followed by activate(). 60b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross // Info is a per-sensor data structure which contains the batch parameters for each client that 61b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross // has registered for this sensor. 629a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen struct Info { 639a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen BatchParams bestBatchParams; 649a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen // Key is the unique identifier(ident) for each client, value is the batch parameters 659a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen // requested by the client. 669a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen KeyedVector<void*, BatchParams> batchParams; 679a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen 689a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen Info() : bestBatchParams(-1, -1, -1) {} 699a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen // Sets batch parameters for this ident. Returns error if this ident is not already present 709a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen // in the KeyedVector above. 719a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen status_t setBatchParamsForIdent(void* ident, int flags, int64_t samplingPeriodNs, 729a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen int64_t maxBatchReportLatencyNs); 739a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen // Finds the optimal parameters for batching and stores them in bestBatchParams variable. 749a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen void selectBatchParams(); 759a7706bb174cdac279908f705191803dc5bfa0abMarco Nelissen // Removes batchParams for an ident and re-computes bestBatchParams. Returns the index of 76b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross // the removed ident. If index >=0, ident is present and successfully removed. 77b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross ssize_t removeBatchParamsForIdent(void* ident); 78b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross }; 79b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross DefaultKeyedVector<int, Info> mActivationCount; 80b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross 81b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross SensorDevice(); 82b731ae01b15682a3326dc4145f614f919b2789b5Colin Crosspublic: 83b731ae01b15682a3326dc4145f614f919b2789b5Colin Cross ssize_t getSensorList(sensor_t const** list); 845c0106e134366312206702f1b072347e20c90374Marco Nelissen status_t initCheck() const; 855c0106e134366312206702f1b072347e20c90374Marco Nelissen int getHalDeviceVersion() const; 865c0106e134366312206702f1b072347e20c90374Marco Nelissen ssize_t poll(sensors_event_t* buffer, size_t count); 875c0106e134366312206702f1b072347e20c90374Marco Nelissen status_t activate(void* ident, int handle, int enabled); 885c0106e134366312206702f1b072347e20c90374Marco Nelissen status_t batch(void* ident, int handle, int flags, int64_t samplingPeriodNs, 895c0106e134366312206702f1b072347e20c90374Marco Nelissen int64_t maxBatchReportLatencyNs); 905c0106e134366312206702f1b072347e20c90374Marco Nelissen // Call batch with timeout zero instead of calling setDelay() for newer devices. 915c0106e134366312206702f1b072347e20c90374Marco Nelissen status_t setDelay(void* ident, int handle, int64_t ns); 925c0106e134366312206702f1b072347e20c90374Marco Nelissen status_t flush(void* ident, int handle); 935c0106e134366312206702f1b072347e20c90374Marco Nelissen void autoDisable(void *ident, int handle); 94ca13fa7dd4662921bc399e021e2ad92ddf5f5366Ruchi Kandoi void dump(String8& result); 95ca13fa7dd4662921bc399e021e2ad92ddf5f5366Ruchi Kandoi}; 96ca13fa7dd4662921bc399e021e2ad92ddf5f5366Ruchi Kandoi 97ca13fa7dd4662921bc399e021e2ad92ddf5f5366Ruchi Kandoi// --------------------------------------------------------------------------- 98ca13fa7dd4662921bc399e021e2ad92ddf5f5366Ruchi Kandoi}; // namespace android 99ca13fa7dd4662921bc399e021e2ad92ddf5f5366Ruchi Kandoi 100ca13fa7dd4662921bc399e021e2ad92ddf5f5366Ruchi Kandoi#endif // ANDROID_SENSOR_DEVICE_H 101ca13fa7dd4662921bc399e021e2ad92ddf5f5366Ruchi Kandoi