Add CPU and GPU headroom HAL APIs (af05282a) · Commits · e / os / android_hardware_interfaces

power/aidl/aidl_api/android.hardware.power/current/android/hardware/power/CpuHeadroomParams.aidl

0 → 100644

+48 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2024 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.
		*/
		///////////////////////////////////////////////////////////////////////////////
		// THIS FILE IS IMMUTABLE. DO NOT EDIT IN ANY CASE. //
		///////////////////////////////////////////////////////////////////////////////

		// This file is a snapshot of an AIDL file. Do not edit it manually. There are
		// two cases:
		// 1). this is a frozen version file - do not edit this in any case.
		// 2). this is a 'current' file. If you make a backwards compatible change to
		// the interface (from the latest frozen version), the build system will
		// prompt you to update this file with `m <name>-update-api`.
		//
		// You must not make a backward incompatible change to any AIDL file built
		// with the aidl_interface module type with versions property set. The module
		// type is used to build AIDL files in a way that they can be used across
		// independently updatable components of the system. If a device is shipped
		// with such a backward incompatible change, it has a high risk of breaking
		// later when a module using the interface is updated, e.g., Mainline modules.

		package android.hardware.power;
		@JavaDerive(equals=true, toString=true) @VintfStability
		parcelable CpuHeadroomParams {
		android.hardware.power.CpuHeadroomParams.CalculationType calculationType;
		android.hardware.power.CpuHeadroomParams.SelectionType selectionType;
		int pid;
		enum CalculationType {
		MIN,
		AVERAGE,
		}
		enum SelectionType {
		ALL,
		PER_CORE,
		}
		}

power/aidl/aidl_api/android.hardware.power/current/android/hardware/power/GpuHeadroomParams.aidl

0 → 100644

+42 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2024 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.
		*/
		///////////////////////////////////////////////////////////////////////////////
		// THIS FILE IS IMMUTABLE. DO NOT EDIT IN ANY CASE. //
		///////////////////////////////////////////////////////////////////////////////

		// This file is a snapshot of an AIDL file. Do not edit it manually. There are
		// two cases:
		// 1). this is a frozen version file - do not edit this in any case.
		// 2). this is a 'current' file. If you make a backwards compatible change to
		// the interface (from the latest frozen version), the build system will
		// prompt you to update this file with `m <name>-update-api`.
		//
		// You must not make a backward incompatible change to any AIDL file built
		// with the aidl_interface module type with versions property set. The module
		// type is used to build AIDL files in a way that they can be used across
		// independently updatable components of the system. If a device is shipped
		// with such a backward incompatible change, it has a high risk of breaking
		// later when a module using the interface is updated, e.g., Mainline modules.

		package android.hardware.power;
		@JavaDerive(equals=true, toString=true) @VintfStability
		parcelable GpuHeadroomParams {
		android.hardware.power.GpuHeadroomParams.CalculationType calculationType;
		enum CalculationType {
		MIN,
		AVERAGE,
		}
		}

power/aidl/aidl_api/android.hardware.power/current/android/hardware/power/IPower.aidl

+4 −0

Original line number	Diff line number	Diff line
		@@ -44,4 +44,8 @@ interface IPower {
		android.hardware.power.ChannelConfig getSessionChannel(in int tgid, in int uid);
		oneway void closeSessionChannel(in int tgid, in int uid);
		android.hardware.power.SupportInfo getSupportInfo();
		float[] getCpuHeadroom(in android.hardware.power.CpuHeadroomParams params);
		float getGpuHeadroom(in android.hardware.power.GpuHeadroomParams params);
		long getCpuHeadroomMinIntervalMillis();
		long getGpuHeadroomMinIntervalMillis();
		}

power/aidl/android/hardware/power/CpuHeadroomParams.aidl

0 → 100644

+62 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2024 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.
		*/

		package android.hardware.power;

		@VintfStability
		@JavaDerive(equals=true, toString=true)
		parcelable CpuHeadroomParams {
		/**
		* Defines how to calculate the headroom.
		*/
		enum CalculationType {
		// Default to return the minimum headroom in a window.
		MIN,
		// Returns the average headroom in a window.
		AVERAGE,
		}

		/**
		* The calculation type.
		*/
		CalculationType calculationType;

		/**
		* Defines how to select the CPU.
		*/
		enum SelectionType {
		// Default to return a single value for all cores.
		ALL,
		// Returns per-core headroom in a list.
		PER_CORE,
		}

		/**
		* The CPU selection type.
		*/
		SelectionType selectionType;

		/**
		* The caller thread's PID.
		*
		* If pid is positive, return the headroom only for cores that are available
		* to the given pid, otherwise return the headroom(s) for all cores.
		*
		* This should handle all the cases including but not limited to thread core
		* affinity and app cpuset that change the available CPU cores for the caller.
		*/
		int pid;
		}

power/aidl/android/hardware/power/GpuHeadroomParams.aidl

0 → 100644

+36 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2024 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.
		*/

		package android.hardware.power;

		@VintfStability
		@JavaDerive(equals=true, toString=true)
		parcelable GpuHeadroomParams {
		/**
		* Defines how to calculate the headroom.
		*/
		enum CalculationType {
		// Default to return the minimum headroom in a window.
		MIN,
		// Returns the average headroom in a window.
		AVERAGE,
		}

		/**
		* The calculation type.
		*/
		CalculationType calculationType;
		}