/* * Copyright (C) 2016 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef android_hardware_gnss_V1_0_Gnss_H_ #define android_hardware_gnss_V1_0_Gnss_H_ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace android { namespace hardware { namespace gnss { namespace V1_0 { namespace implementation { using ::android::hardware::Return; using ::android::hardware::Void; using ::android::hardware::hidl_vec; using ::android::hardware::hidl_string; using ::android::sp; using LegacyGnssSystemInfo = ::GnssSystemInfo; /* * Represents the standard GNSS interface. Also contains wrapper methods to allow methods from * IGnssCallback interface to be passed into the conventional implementation of the GNSS HAL. */ class Gnss : public IGnss { public: Gnss(gps_device_t* gnss_device); ~Gnss(); /* * Methods from ::android::hardware::gnss::V1_0::IGnss follow. * These declarations were generated from Gnss.hal. */ Return setCallback(const sp& callback) override; Return start() override; Return stop() override; Return cleanup() override; Return injectLocation(double latitudeDegrees, double longitudeDegrees, float accuracyMeters) override; Return injectTime(int64_t timeMs, int64_t timeReferenceMs, int32_t uncertaintyMs) override; Return deleteAidingData(IGnss::GnssAidingData aidingDataFlags) override; Return setPositionMode(IGnss::GnssPositionMode mode, IGnss::GnssPositionRecurrence recurrence, uint32_t minIntervalMs, uint32_t preferredAccuracyMeters, uint32_t preferredTimeMs) override; Return> getExtensionAGnssRil() override; Return> getExtensionGnssGeofencing() override; Return> getExtensionAGnss() override; Return> getExtensionGnssNi() override; Return> getExtensionGnssMeasurement() override; Return> getExtensionGnssNavigationMessage() override; Return> getExtensionXtra() override; Return> getExtensionGnssConfiguration() override; Return> getExtensionGnssDebug() override; Return> getExtensionGnssBatching() override; /* * Callback methods to be passed into the conventional GNSS HAL by the default * implementation. These methods are not part of the IGnss base class. */ static void locationCb(GpsLocation* location); static void statusCb(GpsStatus* gnss_status); static void nmeaCb(GpsUtcTime timestamp, const char* nmea, int length); static void setCapabilitiesCb(uint32_t capabilities); static void acquireWakelockCb(); static void releaseWakelockCb(); static void requestUtcTimeCb(); static pthread_t createThreadCb(const char* name, void (*start)(void*), void* arg); static void gnssSvStatusCb(GnssSvStatus* status); /* * Deprecated callback added for backward compatibility to devices that do * not support GnssSvStatus. */ static void gpsSvStatusCb(GpsSvStatus* status); static void setSystemInfoCb(const LegacyGnssSystemInfo* info); /* * Wakelock consolidation, only needed for dual use of a gps.h & fused_location.h HAL * * Ensures that if the last call from either legacy .h was to acquire a wakelock, that a * wakelock is held. Otherwise releases it. */ static void acquireWakelockFused(); static void releaseWakelockFused(); /* * Holds function pointers to the callback methods. */ static GpsCallbacks sGnssCb; private: /* * For handling system-server death while GNSS service lives on. */ class GnssHidlDeathRecipient : public hidl_death_recipient { public: GnssHidlDeathRecipient(const sp gnss) : mGnss(gnss) { } virtual void serviceDied(uint64_t /*cookie*/, const wp<::android::hidl::base::V1_0::IBase>& /*who*/) { mGnss->handleHidlDeath(); } private: sp mGnss; }; // for wakelock consolidation, see above static void acquireWakelockGnss(); static void releaseWakelockGnss(); static void updateWakelock(); static bool sWakelockHeldGnss; static bool sWakelockHeldFused; /* * Cleanup for death notification */ void handleHidlDeath(); sp mGnssXtraIface = nullptr; sp mGnssRil = nullptr; sp mGnssGeofencingIface = nullptr; sp mAGnssIface = nullptr; sp mGnssNi = nullptr; sp mGnssMeasurement = nullptr; sp mGnssNavigationMessage = nullptr; sp mGnssDebug = nullptr; sp mGnssConfig = nullptr; sp mGnssBatching = nullptr; sp mDeathRecipient; const GpsInterface* mGnssIface = nullptr; static sp sGnssCbIface; static std::vector> sThreadFuncArgsList; static bool sInterfaceExists; // Values saved for resend static uint32_t sCapabilitiesCached; static uint16_t sYearOfHwCached; }; extern "C" IGnss* HIDL_FETCH_IGnss(const char* name); } // namespace implementation } // namespace V1_0 } // namespace gnss } // namespace hardware } // namespace android #endif // android_hardware_gnss_V1_0_Gnss_H_