Loading include/android/CoolingDevice.h 0 → 100644 +49 −0 Original line number Diff line number Diff line /* * Copyright (C) 2020 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_OS_COOLINGDEVICE_H #define ANDROID_OS_COOLINGDEVICE_H #include <binder/Parcelable.h> #include <utils/RefBase.h> namespace android { namespace os { /** * CoolingDevice is a structure to encapsulate cooling device status. */ struct CoolingDevice : public android::Parcelable { /** Current throttle state of the cooling device. */ float mValue; /** A cooling device type from ThermalHAL */ uint32_t mType; /** Name of this cooling device */ String16 mName; CoolingDevice() : mValue(0.0f), mType(0), mName("") { } virtual status_t readFromParcel(const android::Parcel* parcel) override; virtual status_t writeToParcel(android::Parcel* parcel) const override; }; } // namespace os } // namespace android #endif /* ANDROID_OS_COOLINGDEVICE_H */ include/android/Temperature.h 0 → 100644 +53 −0 Original line number Diff line number Diff line /* * Copyright (C) 2020 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_OS_TEMPERATURE_H #define ANDROID_OS_TEMPERATURE_H #include <binder/Parcelable.h> #include <utils/RefBase.h> namespace android { namespace os { /** * Temperature is a structure to encapsulate temperature status. */ struct Temperature : public android::Parcelable { /** Temperature value */ float mValue; /** A Temperature type from ThermalHAL */ int32_t mType; /** Name of this Temperature */ String16 mName; /** The level of the sensor is currently in throttling */ int32_t mStatus; Temperature() : mValue(0.0f), mType(0), mName(""), mStatus(0) { } virtual status_t readFromParcel(const android::Parcel* parcel) override; virtual status_t writeToParcel(android::Parcel* parcel) const override; }; } // namespace os } // namespace android #endif /* ANDROID_OS_TEMPERATURE_H */ include/android/thermal.h 0 → 100644 +182 −0 Original line number Diff line number Diff line /* * Copyright (C) 2020 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. */ /** * @addtogroup Thermal * @{ */ /** * @file thermal.h */ #ifndef _ANDROID_THERMAL_H #define _ANDROID_THERMAL_H #include <sys/cdefs.h> /****************************************************************** * * IMPORTANT NOTICE: * * This file is part of Android's set of stable system headers * exposed by the Android NDK (Native Development Kit). * * Third-party source AND binary code relies on the definitions * here to be FROZEN ON ALL UPCOMING PLATFORM RELEASES. * * - DO NOT MODIFY ENUMS (EXCEPT IF YOU ADD NEW 32-BIT VALUES) * - DO NOT MODIFY CONSTANTS OR FUNCTIONAL MACROS * - DO NOT CHANGE THE SIGNATURE OF FUNCTIONS IN ANY WAY * - DO NOT CHANGE THE LAYOUT OR SIZE OF STRUCTURES */ /* * Structures and functions to access thermal status and register/unregister * thermal status listener in native code. */ #include <stdint.h> #include <sys/types.h> #if !defined(__INTRODUCED_IN) #define __INTRODUCED_IN(30) /* Introduced in API level 30 */ #endif #ifdef __cplusplus extern "C" { #endif #if __ANDROID_API__ >= 30 enum AThermalStatus { /** Error in thermal status. */ ATHERMAL_STATUS_ERROR = -1, /** Not under throttling. */ ATHERMAL_STATUS_NONE = 0, /** Light throttling where UX is not impacted. */ ATHERMAL_STATUS_LIGHT = 1, /** Moderate throttling where UX is not largely impacted. */ ATHERMAL_STATUS_MODERATE = 2, /** Severe throttling where UX is largely impacted. */ ATHERMAL_STATUS_SEVERE = 3, /** Platform has done everything to reduce power. */ ATHERMAL_STATUS_CRITICAL = 4, /** * Key components in platform are shutting down due to thermal condition. * Device functionalities will be limited. */ ATHERMAL_STATUS_EMERGENCY = 5, /** Need shutdown immediately. */ ATHERMAL_STATUS_SHUTDOWN = 6, }; /** * An opaque type representing a handle to a thermal manager. * An instance of thermal manager must be acquired prior to * using thermal status APIs and must be released after use. * * <p>To use:<ul> * <li>Create a new thermal manager instance by calling the * {@link AThermal_acquireManager} function.</li> * <li>Get current thermal status with * {@link AThermal_getCurrentThermalStatus}.</li> * <li>Register a thermal status listener with * {@link AThermal_registerThermalStatusListener}.</li> * <li>Unregister a thermal status listener with * {@link AThermal_unregisterThermalStatusListener}.</li> * <li>Release the thermal manager instance with * {@link AThermal_releaseManager}.</li></ul></p> * */ typedef struct AThermalManager AThermalManager; /** * Prototype of the function that is called when thermal status changes. * It's passed the updated thermal status as parameter, as well as the * pointer provided by the client that registered a callback. */ typedef int (*AThermal_StatusCallback)(void *data, AThermalStatus status); /** * Acquire an instance of the thermal manager. This must be freed using * {@link AThermal_releaseManager}. * * @return manager instance on success, nullptr on failure. */ AThermalManager* AThermal_acquireManager(); /** * Release the thermal manager pointer acquired via * {@link AThermal_acquireManager}. * * @param manager The manager to be released. * */ void AThermal_releaseManager(AThermalManager *manager); /** * Gets the current thermal status. * * @param manager The manager instance to use to query the thermal status. * Acquired via {@link AThermal_acquireManager}. * * @return current thermal status, ATHERMAL_STATUS_ERROR on failure. */ AThermalStatus AThermal_getCurrentThermalStatus(AThermalManager *manager); /** * Register the thermal status listener for thermal status change. * * @param manager The manager instance to use to register. * Acquired via {@link AThermal_acquireManager}. * @param callback The callback function to be called when thermal status updated. * @param data The data pointer to be passed when callback is called. * * @return 0 on success * EINVAL if the listener and data pointer were previously added and not removed. * EPERM if the required permission is not held. * EPIPE if communication with the system service has failed. */ int AThermal_registerThermalStatusListener(AThermalManager *manager, AThermal_StatusCallback callback, void *data); /** * Unregister the thermal status listener previously resgistered. * * @param manager The manager instance to use to unregister. * Acquired via {@link AThermal_acquireManager}. * @param callback The callback function to be called when thermal status updated. * @param data The data pointer to be passed when callback is called. * * @return 0 on success * EINVAL if the listener and data pointer were not previously added. * EPERM if the required permission is not held. * EPIPE if communication with the system service has failed. */ int AThermal_unregisterThermalStatusListener(AThermalManager *manager, AThermal_StatusCallback callback, void *data); #endif // __ANDROID_API__ >= 30 #ifdef __cplusplus } #endif #endif // _ANDROID_THERMAL_H /** @} */ include/powermanager/PowerManager.h +11 −0 Original line number Diff line number Diff line Loading @@ -33,6 +33,17 @@ enum { USER_ACTIVITY_EVENT_LAST = USER_ACTIVITY_EVENT_ACCESSIBILITY, // Last valid event code. }; /** Keep in sync with android.os.temprature and hardware/interfaces/thermal/2.0/types.hal */ enum class ThermalStatus : uint32_t { THERMAL_STATUS_NONE = 0, THERMAL_STATUS_LIGHT = 1, THERMAL_STATUS_MODERATE = 2, THERMAL_STATUS_SEVERE = 3, THERMAL_STATUS_CRITICAL = 4, THERMAL_STATUS_EMERGENCY = 5, THERMAL_STATUS_SHUTDOWN = 6, }; }; // namespace android #endif // ANDROID_POWERMANAGER_H services/powermanager/Android.bp +34 −1 Original line number Diff line number Diff line cc_library_shared { name: "libpowermanager", srcs: ["IPowerManager.cpp"], srcs: [ "IPowerManager.cpp", "Temperature.cpp", "CoolingDevice.cpp", ":libpowermanager_aidl", ], aidl: { local_include_dirs: ["."], include_dirs: [ "frameworks/base/core/java/android/os", ], export_aidl_headers: true }, shared_libs: [ "libutils", "libbinder", "liblog" ], cflags: [ Loading @@ -15,3 +29,22 @@ cc_library_shared { "-Wunreachable-code", ], } cc_test { name: "thermalmanager-test", srcs: ["IThermalManagerTest.cpp", ], cflags: [ "-Wall", "-Werror", "-Wextra", ], shared_libs: [ "libbase", "libhidlbase", "liblog", "libpowermanager", "libbinder", "libutils", ], } Loading
include/android/CoolingDevice.h 0 → 100644 +49 −0 Original line number Diff line number Diff line /* * Copyright (C) 2020 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_OS_COOLINGDEVICE_H #define ANDROID_OS_COOLINGDEVICE_H #include <binder/Parcelable.h> #include <utils/RefBase.h> namespace android { namespace os { /** * CoolingDevice is a structure to encapsulate cooling device status. */ struct CoolingDevice : public android::Parcelable { /** Current throttle state of the cooling device. */ float mValue; /** A cooling device type from ThermalHAL */ uint32_t mType; /** Name of this cooling device */ String16 mName; CoolingDevice() : mValue(0.0f), mType(0), mName("") { } virtual status_t readFromParcel(const android::Parcel* parcel) override; virtual status_t writeToParcel(android::Parcel* parcel) const override; }; } // namespace os } // namespace android #endif /* ANDROID_OS_COOLINGDEVICE_H */
include/android/Temperature.h 0 → 100644 +53 −0 Original line number Diff line number Diff line /* * Copyright (C) 2020 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_OS_TEMPERATURE_H #define ANDROID_OS_TEMPERATURE_H #include <binder/Parcelable.h> #include <utils/RefBase.h> namespace android { namespace os { /** * Temperature is a structure to encapsulate temperature status. */ struct Temperature : public android::Parcelable { /** Temperature value */ float mValue; /** A Temperature type from ThermalHAL */ int32_t mType; /** Name of this Temperature */ String16 mName; /** The level of the sensor is currently in throttling */ int32_t mStatus; Temperature() : mValue(0.0f), mType(0), mName(""), mStatus(0) { } virtual status_t readFromParcel(const android::Parcel* parcel) override; virtual status_t writeToParcel(android::Parcel* parcel) const override; }; } // namespace os } // namespace android #endif /* ANDROID_OS_TEMPERATURE_H */
include/android/thermal.h 0 → 100644 +182 −0 Original line number Diff line number Diff line /* * Copyright (C) 2020 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. */ /** * @addtogroup Thermal * @{ */ /** * @file thermal.h */ #ifndef _ANDROID_THERMAL_H #define _ANDROID_THERMAL_H #include <sys/cdefs.h> /****************************************************************** * * IMPORTANT NOTICE: * * This file is part of Android's set of stable system headers * exposed by the Android NDK (Native Development Kit). * * Third-party source AND binary code relies on the definitions * here to be FROZEN ON ALL UPCOMING PLATFORM RELEASES. * * - DO NOT MODIFY ENUMS (EXCEPT IF YOU ADD NEW 32-BIT VALUES) * - DO NOT MODIFY CONSTANTS OR FUNCTIONAL MACROS * - DO NOT CHANGE THE SIGNATURE OF FUNCTIONS IN ANY WAY * - DO NOT CHANGE THE LAYOUT OR SIZE OF STRUCTURES */ /* * Structures and functions to access thermal status and register/unregister * thermal status listener in native code. */ #include <stdint.h> #include <sys/types.h> #if !defined(__INTRODUCED_IN) #define __INTRODUCED_IN(30) /* Introduced in API level 30 */ #endif #ifdef __cplusplus extern "C" { #endif #if __ANDROID_API__ >= 30 enum AThermalStatus { /** Error in thermal status. */ ATHERMAL_STATUS_ERROR = -1, /** Not under throttling. */ ATHERMAL_STATUS_NONE = 0, /** Light throttling where UX is not impacted. */ ATHERMAL_STATUS_LIGHT = 1, /** Moderate throttling where UX is not largely impacted. */ ATHERMAL_STATUS_MODERATE = 2, /** Severe throttling where UX is largely impacted. */ ATHERMAL_STATUS_SEVERE = 3, /** Platform has done everything to reduce power. */ ATHERMAL_STATUS_CRITICAL = 4, /** * Key components in platform are shutting down due to thermal condition. * Device functionalities will be limited. */ ATHERMAL_STATUS_EMERGENCY = 5, /** Need shutdown immediately. */ ATHERMAL_STATUS_SHUTDOWN = 6, }; /** * An opaque type representing a handle to a thermal manager. * An instance of thermal manager must be acquired prior to * using thermal status APIs and must be released after use. * * <p>To use:<ul> * <li>Create a new thermal manager instance by calling the * {@link AThermal_acquireManager} function.</li> * <li>Get current thermal status with * {@link AThermal_getCurrentThermalStatus}.</li> * <li>Register a thermal status listener with * {@link AThermal_registerThermalStatusListener}.</li> * <li>Unregister a thermal status listener with * {@link AThermal_unregisterThermalStatusListener}.</li> * <li>Release the thermal manager instance with * {@link AThermal_releaseManager}.</li></ul></p> * */ typedef struct AThermalManager AThermalManager; /** * Prototype of the function that is called when thermal status changes. * It's passed the updated thermal status as parameter, as well as the * pointer provided by the client that registered a callback. */ typedef int (*AThermal_StatusCallback)(void *data, AThermalStatus status); /** * Acquire an instance of the thermal manager. This must be freed using * {@link AThermal_releaseManager}. * * @return manager instance on success, nullptr on failure. */ AThermalManager* AThermal_acquireManager(); /** * Release the thermal manager pointer acquired via * {@link AThermal_acquireManager}. * * @param manager The manager to be released. * */ void AThermal_releaseManager(AThermalManager *manager); /** * Gets the current thermal status. * * @param manager The manager instance to use to query the thermal status. * Acquired via {@link AThermal_acquireManager}. * * @return current thermal status, ATHERMAL_STATUS_ERROR on failure. */ AThermalStatus AThermal_getCurrentThermalStatus(AThermalManager *manager); /** * Register the thermal status listener for thermal status change. * * @param manager The manager instance to use to register. * Acquired via {@link AThermal_acquireManager}. * @param callback The callback function to be called when thermal status updated. * @param data The data pointer to be passed when callback is called. * * @return 0 on success * EINVAL if the listener and data pointer were previously added and not removed. * EPERM if the required permission is not held. * EPIPE if communication with the system service has failed. */ int AThermal_registerThermalStatusListener(AThermalManager *manager, AThermal_StatusCallback callback, void *data); /** * Unregister the thermal status listener previously resgistered. * * @param manager The manager instance to use to unregister. * Acquired via {@link AThermal_acquireManager}. * @param callback The callback function to be called when thermal status updated. * @param data The data pointer to be passed when callback is called. * * @return 0 on success * EINVAL if the listener and data pointer were not previously added. * EPERM if the required permission is not held. * EPIPE if communication with the system service has failed. */ int AThermal_unregisterThermalStatusListener(AThermalManager *manager, AThermal_StatusCallback callback, void *data); #endif // __ANDROID_API__ >= 30 #ifdef __cplusplus } #endif #endif // _ANDROID_THERMAL_H /** @} */
include/powermanager/PowerManager.h +11 −0 Original line number Diff line number Diff line Loading @@ -33,6 +33,17 @@ enum { USER_ACTIVITY_EVENT_LAST = USER_ACTIVITY_EVENT_ACCESSIBILITY, // Last valid event code. }; /** Keep in sync with android.os.temprature and hardware/interfaces/thermal/2.0/types.hal */ enum class ThermalStatus : uint32_t { THERMAL_STATUS_NONE = 0, THERMAL_STATUS_LIGHT = 1, THERMAL_STATUS_MODERATE = 2, THERMAL_STATUS_SEVERE = 3, THERMAL_STATUS_CRITICAL = 4, THERMAL_STATUS_EMERGENCY = 5, THERMAL_STATUS_SHUTDOWN = 6, }; }; // namespace android #endif // ANDROID_POWERMANAGER_H
services/powermanager/Android.bp +34 −1 Original line number Diff line number Diff line cc_library_shared { name: "libpowermanager", srcs: ["IPowerManager.cpp"], srcs: [ "IPowerManager.cpp", "Temperature.cpp", "CoolingDevice.cpp", ":libpowermanager_aidl", ], aidl: { local_include_dirs: ["."], include_dirs: [ "frameworks/base/core/java/android/os", ], export_aidl_headers: true }, shared_libs: [ "libutils", "libbinder", "liblog" ], cflags: [ Loading @@ -15,3 +29,22 @@ cc_library_shared { "-Wunreachable-code", ], } cc_test { name: "thermalmanager-test", srcs: ["IThermalManagerTest.cpp", ], cflags: [ "-Wall", "-Werror", "-Wextra", ], shared_libs: [ "libbase", "libhidlbase", "liblog", "libpowermanager", "libbinder", "libutils", ], }
