Home | History | Annotate | Download | only in sensorservice
      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 #ifndef ANDROID_SENSOR_EVENT_CONNECTION_H
     18 #define ANDROID_SENSOR_EVENT_CONNECTION_H
     19 
     20 #include <stdint.h>
     21 #include <sys/types.h>
     22 
     23 #include <utils/Vector.h>
     24 #include <utils/SortedVector.h>
     25 #include <utils/KeyedVector.h>
     26 #include <utils/threads.h>
     27 #include <utils/AndroidThreads.h>
     28 #include <utils/RefBase.h>
     29 #include <utils/Looper.h>
     30 #include <utils/String8.h>
     31 
     32 #include <binder/BinderService.h>
     33 
     34 #include <sensor/Sensor.h>
     35 #include <sensor/BitTube.h>
     36 #include <sensor/ISensorServer.h>
     37 #include <sensor/ISensorEventConnection.h>
     38 
     39 #include "SensorService.h"
     40 
     41 namespace android {
     42 
     43 class SensorService;
     44 
     45 class SensorService::SensorEventConnection:
     46     public BnSensorEventConnection, public LooperCallback {
     47 
     48     friend class SensorService;
     49 
     50 public:
     51     SensorEventConnection(const sp<SensorService>& service, uid_t uid, String8 packageName,
     52                           bool isDataInjectionMode, const String16& opPackageName,
     53                           bool hasSensorAccess);
     54 
     55     status_t sendEvents(sensors_event_t const* buffer, size_t count, sensors_event_t* scratch,
     56                         wp<const SensorEventConnection> const * mapFlushEventsToConnections = NULL);
     57     bool hasSensor(int32_t handle) const;
     58     bool hasAnySensor() const;
     59     bool hasOneShotSensors() const;
     60     bool addSensor(int32_t handle);
     61     bool removeSensor(int32_t handle);
     62     void setFirstFlushPending(int32_t handle, bool value);
     63     void dump(String8& result);
     64     bool needsWakeLock();
     65     void resetWakeLockRefCount();
     66     String8 getPackageName() const;
     67 
     68     uid_t getUid() const { return mUid; }
     69 
     70     void setSensorAccess(const bool hasAccess);
     71 
     72 private:
     73     virtual ~SensorEventConnection();
     74     virtual void onFirstRef();
     75     virtual sp<BitTube> getSensorChannel() const;
     76     virtual status_t enableDisable(int handle, bool enabled, nsecs_t samplingPeriodNs,
     77                                    nsecs_t maxBatchReportLatencyNs, int reservedFlags);
     78     virtual status_t setEventRate(int handle, nsecs_t samplingPeriodNs);
     79     virtual status_t flush();
     80     virtual int32_t configureChannel(int handle, int rateLevel);
     81     virtual void destroy();
     82 
     83     // Count the number of flush complete events which are about to be dropped in the buffer.
     84     // Increment mPendingFlushEventsToSend in mSensorInfo. These flush complete events will be sent
     85     // separately before the next batch of events.
     86     void countFlushCompleteEventsLocked(sensors_event_t const* scratch, int numEventsDropped);
     87 
     88     // Check if there are any wake up events in the buffer. If yes, return the index of the first
     89     // wake_up sensor event in the buffer else return -1.  This wake_up sensor event will have the
     90     // flag WAKE_UP_SENSOR_EVENT_NEEDS_ACK set. Exactly one event per packet will have the wake_up
     91     // flag set. SOCK_SEQPACKET ensures that either the entire packet is read or dropped.
     92     int findWakeUpSensorEventLocked(sensors_event_t const* scratch, int count);
     93 
     94     // Send pending flush_complete events. There may have been flush_complete_events that are
     95     // dropped which need to be sent separately before other events. On older HALs (1_0) this method
     96     // emulates the behavior of flush().
     97     void sendPendingFlushEventsLocked();
     98 
     99     // Writes events from mEventCache to the socket.
    100     void writeToSocketFromCache();
    101 
    102     // Compute the approximate cache size from the FIFO sizes of various sensors registered for this
    103     // connection. Wake up and non-wake up sensors have separate FIFOs but FIFO may be shared
    104     // amongst wake-up sensors and non-wake up sensors.
    105     int computeMaxCacheSizeLocked() const;
    106 
    107     // When more sensors register, the maximum cache size desired may change.  Compute max cache
    108     // size, reallocate memory and copy over events from the older cache.
    109     void reAllocateCacheLocked(sensors_event_t const* scratch, int count);
    110 
    111     // LooperCallback method. If there is data to read on this fd, it is an ack from the app that it
    112     // has read events from a wake up sensor, decrement mWakeLockRefCount.  If this fd is available
    113     // for writing send the data from the cache.
    114     virtual int handleEvent(int fd, int events, void* data);
    115 
    116     // Increment mPendingFlushEventsToSend for the given sensor handle.
    117     void incrementPendingFlushCount(int32_t handle);
    118 
    119     // Add or remove the file descriptor associated with the BitTube to the looper. If mDead is set
    120     // to true or there are no more sensors for this connection, the file descriptor is removed if
    121     // it has been previously added to the Looper. Depending on the state of the connection FD may
    122     // be added to the Looper. The flags to set are determined by the internal state of the
    123     // connection. FDs are added to the looper when wake-up sensors are registered (to poll for
    124     // acknowledgements) and when write fails on the socket when there are too many error and the
    125     // other end hangs up or when this client unregisters for this connection.
    126     void updateLooperRegistration(const sp<Looper>& looper); void
    127             updateLooperRegistrationLocked(const sp<Looper>& looper);
    128 
    129     sp<SensorService> const mService;
    130     sp<BitTube> mChannel;
    131     uid_t mUid;
    132     mutable Mutex mConnectionLock;
    133     // Number of events from wake up sensors which are still pending and haven't been delivered to
    134     // the corresponding application. It is incremented by one unit for each write to the socket.
    135     uint32_t mWakeLockRefCount;
    136 
    137     // If this flag is set to true, it means that the file descriptor associated with the BitTube
    138     // has been added to the Looper in SensorService. This flag is typically set when this
    139     // connection has wake-up sensors associated with it or when write has failed on this connection
    140     // and we're storing some events in the cache.
    141     bool mHasLooperCallbacks;
    142     // If there are any errors associated with the Looper this flag is set to true and
    143     // mWakeLockRefCount is reset to zero. needsWakeLock method will always return false, if this
    144     // flag is set.
    145     bool mDead;
    146 
    147     bool mDataInjectionMode;
    148     struct FlushInfo {
    149         // The number of flush complete events dropped for this sensor is stored here.  They are
    150         // sent separately before the next batch of events.
    151         int mPendingFlushEventsToSend;
    152 
    153         // Every activate is preceded by a flush. Only after the first flush complete is received,
    154         // the events for the sensor are sent on that *connection*.
    155         bool mFirstFlushPending;
    156 
    157         FlushInfo() : mPendingFlushEventsToSend(0), mFirstFlushPending(false) {}
    158     };
    159     // protected by SensorService::mLock. Key for this vector is the sensor handle.
    160     KeyedVector<int, FlushInfo> mSensorInfo;
    161 
    162     sensors_event_t *mEventCache;
    163     int mCacheSize, mMaxCacheSize;
    164     String8 mPackageName;
    165     const String16 mOpPackageName;
    166 #if DEBUG_CONNECTIONS
    167     int mEventsReceived, mEventsSent, mEventsSentFromCache;
    168     int mTotalAcksNeeded, mTotalAcksReceived;
    169 #endif
    170 
    171     mutable Mutex mDestroyLock;
    172     bool mDestroyed;
    173     bool mHasSensorAccess;
    174 };
    175 
    176 } // namepsace android
    177 
    178 #endif // ANDROID_SENSOR_EVENT_CONNECTION_H
    179 
    180