Create native version of Thermal Throttling API. (1a5a8886) · Commits · e / os / platform_frameworks_native

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
		@@ -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: [
		@@ -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",
		],
		}