Merge "Add thermal HAL 2.0" (abe2a121) · Commits · e / os / android_hardware_interfaces

compatibility_matrices/compatibility_matrix.current.xml

+1 −0

Original line number	Diff line number	Diff line
		@@ -398,6 +398,7 @@
		<hal format="hidl" optional="true">
		<name>android.hardware.thermal</name>
		<version>1.0-1</version>
		<version>2.0</version>
		<interface>
		<name>IThermal</name>
		<instance>default</instance>

thermal/2.0/Android.bp

0 → 100644

+29 −0

Original line number	Diff line number	Diff line
		// This file is autogenerated by hidl-gen -Landroidbp.

		hidl_interface {
		name: "android.hardware.thermal@2.0",
		root: "android.hardware",
		vndk: {
		enabled: true,
		},
		srcs: [
		"types.hal",
		"IThermal.hal",
		"IThermalChangedCallback.hal",
		],
		interfaces: [
		"android.hardware.thermal@1.0",
		"android.hidl.base@1.0",
		],
		types: [
		"CoolingDevice",
		"CoolingType",
		"Temperature",
		"TemperatureThreshold",
		"TemperatureType",
		"ThrottlingSeverity",
		"ThrottlingSeverityCount",
		],
		gen_java: true,
		}

thermal/2.0/IThermal.hal

0 → 100644

+113 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2018 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.thermal@2.0;

		import android.hardware.thermal@1.0::IThermal;
		import android.hardware.thermal@1.0::ThermalStatus;
		import IThermalChangedCallback;

		interface IThermal extends @1.0::IThermal {

		/**
		* Retrieves temperatures in Celsius.
		*
		* @param filterType whether to filter the result for a given type.
		* @param type the TemperatureType such as battery or skin.
		*
		* @return status Status of the operation. If status code is FAILURE,
		* the status.debugMessage must be populated with a human-readable
		* error message.
		*
		* @return temperatures If status code is SUCCESS, it's filled with the
		* current temperatures. The order of temperatures of built-in
		* devices (such as CPUs, GPUs and etc.) in the list must be kept
		* the same regardless of the number of calls to this method even if
		* they go offline, if these devices exist on boot. The method
		* always returns and never removes such temperatures.
		*/
		getCurrentTemperatures(bool filterType, TemperatureType type)
		generates (ThermalStatus status, vec<Temperature> temperatures);

		/**
		* Retrieves temperature thresholds in Celsius.
		*
		* @param filterType whether to filter the result for a given type.
		* @param type the TemperatureType such as battery or skin.
		*
		* @return status Status of the operation. If status code is FAILURE,
		* the status.debugMessage must be populated with a human-readable error message.
		* @return temperatureThresholds If status code is SUCCESS, it's filled with the
		* temperatures thresholds. The order of temperatures of built-in
		* devices (such as CPUs, GPUs and etc.) in the list must be kept
		* the same regardless of the number of calls to this method even if
		* they go offline, if these devices exist on boot. The method
		* always returns and never removes such temperatures.
		*/
		getTemperatureThresholds(bool filterType, TemperatureType type)
		generates (ThermalStatus status, vec<TemperatureThreshold> temperatureThresholds);

		/**
		* Register an IThermalChangedCallback, used by the Thermal HAL
		* to send thermal events when thermal mitigation status changed.
		* Multiple registrations with different IThermalChangedCallback must be allowed.
		* Multiple registrations with same IThermalChangedCallback is not allowed, client
		* should unregister the given IThermalChangedCallback first.
		*
		* @param callback the IThermalChangedCallback to use for sending
		* thermal events (cannot be nullptr).
		* @param filterType if filter for given sensor type.
		* @param type the type to be filtered.
		*
		* @return status Status of the operation. If status code is FAILURE,
		* the status.debugMessage must be populated with a human-readable error message.
		*/
		registerThermalChangedCallback(IThermalChangedCallback callback,
		bool filterType,
		TemperatureType type)
		generates (ThermalStatus status);

		/**
		* Register an IThermalChangedCallback, used by the Thermal HAL
		* to send thermal events when thermal mitigation status changed.
		*
		* @param callback the IThermalChangedCallback to use for sending
		* thermal events, or nullptr to set no callback.
		*
		* @return status Status of the operation. If status code is FAILURE,
		* the status.debugMessage must be populated with a human-readable error message.
		*/
		unregisterThermalChangedCallback(IThermalChangedCallback callback)
		generates (ThermalStatus status);

		/**
		* Retrieves the cooling devices information.
		*
		* @param filterType whether to filter the result for a given type.
		* @param type the CoolingDevice such as CPU/GPU.
		*
		* @return status Status of the operation. If status code is FAILURE,
		* the status.debugMessage must be populated with the human-readable
		* error message.
		* @return devices If status code is SUCCESS, it's filled with the current
		* cooling device information. The order of built-in cooling
		* devices in the list must be kept the same regardless of the number
		* of calls to this method even if they go offline, if these devices
		* exist on boot. The method always returns and never removes from
		* the list such cooling devices.
		*/
		getCurrentCoolingDevices(bool filterType, CoolingType type)
		generates (ThermalStatus status, vec<CoolingDevice> devices);
		};

thermal/2.0/IThermalChangedCallback.hal

0 → 100644

+33 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2018 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.thermal@2.0;

		import android.hardware.thermal@2.0::Temperature;

		/**
		* IThermalChangedCallback send throttling notification to clients.
		*/
		interface IThermalChangedCallback {
		/**
		* Send a thermal throttling event to all ThermalHAL
		* thermal event listeners.
		*
		* @param temperature The temperature associated with the
		* throttling event.
		*/
		oneway notifyThrottling (Temperature temperature);
		};

thermal/2.0/default/Android.bp

0 → 100644

+35 −0

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

		cc_binary {
		name: "android.hardware.thermal@2.0-service",
		defaults: ["hidl_defaults"],
		relative_install_path: "hw",
		vendor: true,
		init_rc: ["android.hardware.thermal@2.0-service.rc"],
		vintf_fragments: ["android.hardware.thermal@2.0-service.xml"],
		srcs: [
		"Thermal.cpp",
		"service.cpp"
		],
		shared_libs: [
		"libbase",
		"libhidlbase",
		"libhidltransport",
		"libutils",
		"android.hardware.thermal@2.0",
		"android.hardware.thermal@1.0",
		],
		}