Add lights 2.0 hal. (f4488881) · Commits · e / os / android_hardware_interfaces

Android.bp

+1 −0

Original line number	Diff line number	Diff line
		@@ -5,6 +5,7 @@ subdirs = [
		"benchmarks/msgq/1.0",
		"memtrack/1.0",
		"memtrack/1.0/default",
		"light/2.0",
		"nfc/1.0",
		"nfc/1.0/default",
		"radio/1.0",

light/2.0/Android.bp

0 → 100644

+46 −0

Original line number	Diff line number	Diff line
		// This file is autogenerated by hidl-gen. Do not edit manually.

		genrule {
		name: "android.hardware.light@2.0_genc++",
		tool: "hidl-gen",
		cmd: "$tool -o $genDir -Lc++ -randroid.hardware:hardware/interfaces android.hardware.light@2.0",
		srcs: [
		"types.hal",
		"ILight.hal",
		],
		out: [
		"android/hardware/light/2.0/types.cpp",
		"android/hardware/light/2.0/LightAll.cpp",
		],
		}

		genrule {
		name: "android.hardware.light@2.0_genc++_headers",
		tool: "hidl-gen",
		cmd: "$tool -o $genDir -Lc++ -randroid.hardware:hardware/interfaces android.hardware.light@2.0",
		srcs: [
		"types.hal",
		"ILight.hal",
		],
		out: [
		"android/hardware/light/2.0/types.h",
		"android/hardware/light/2.0/ILight.h",
		"android/hardware/light/2.0/IHwLight.h",
		"android/hardware/light/2.0/BnLight.h",
		"android/hardware/light/2.0/BpLight.h",
		"android/hardware/light/2.0/BsLight.h",
		],
		}

		cc_library_shared {
		name: "android.hardware.light@2.0",
		generated_sources: ["android.hardware.light@2.0_genc++"],
		generated_headers: ["android.hardware.light@2.0_genc++_headers"],
		export_generated_headers: ["android.hardware.light@2.0_genc++_headers"],
		shared_libs: [
		"libhidl",
		"libhwbinder",
		"libutils",
		"libcutils",
		],
		}

light/2.0/Android.mk

0 → 100644

+238 −0

Original line number	Diff line number	Diff line
		# This file is autogenerated by hidl-gen. Do not edit manually.

		LOCAL_PATH := $(call my-dir)

		################################################################################

		include $(CLEAR_VARS)
		LOCAL_MODULE := android.hardware.light@2.0-java
		LOCAL_MODULE_CLASS := JAVA_LIBRARIES

		intermediates := $(local-generated-sources-dir)

		HIDL := $(HOST_OUT_EXECUTABLES)/hidl-gen$(HOST_EXECUTABLE_SUFFIX)

		#
		# Build types.hal (Brightness)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/Brightness.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.Brightness

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build types.hal (Flash)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/Flash.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.Flash

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build types.hal (LightState)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/LightState.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.LightState

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build types.hal (Status)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/Status.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.Status

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build types.hal (Type)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/Type.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.Type

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build ILight.hal
		#
		GEN := $(intermediates)/android/hardware/light/2.0/ILight.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/ILight.hal
		$(GEN): PRIVATE_DEPS += $(LOCAL_PATH)/types.hal
		$(GEN): $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::ILight

		$(GEN): $(LOCAL_PATH)/ILight.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)
		include $(BUILD_JAVA_LIBRARY)


		################################################################################

		include $(CLEAR_VARS)
		LOCAL_MODULE := android.hardware.light@2.0-java-static
		LOCAL_MODULE_CLASS := JAVA_LIBRARIES

		intermediates := $(local-generated-sources-dir)

		HIDL := $(HOST_OUT_EXECUTABLES)/hidl-gen$(HOST_EXECUTABLE_SUFFIX)

		#
		# Build types.hal (Brightness)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/Brightness.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.Brightness

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build types.hal (Flash)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/Flash.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.Flash

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build types.hal (LightState)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/LightState.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.LightState

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build types.hal (Status)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/Status.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.Status

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build types.hal (Type)
		#
		GEN := $(intermediates)/android/hardware/light/2.0/Type.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::types.Type

		$(GEN): $(LOCAL_PATH)/types.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)

		#
		# Build ILight.hal
		#
		GEN := $(intermediates)/android/hardware/light/2.0/ILight.java
		$(GEN): $(HIDL)
		$(GEN): PRIVATE_HIDL := $(HIDL)
		$(GEN): PRIVATE_DEPS := $(LOCAL_PATH)/ILight.hal
		$(GEN): PRIVATE_DEPS += $(LOCAL_PATH)/types.hal
		$(GEN): $(LOCAL_PATH)/types.hal
		$(GEN): PRIVATE_OUTPUT_DIR := $(intermediates)
		$(GEN): PRIVATE_CUSTOM_TOOL = \
		$(PRIVATE_HIDL) -o $(PRIVATE_OUTPUT_DIR) \
		-Ljava -randroid.hardware:hardware/interfaces \
		android.hardware.light@2.0::ILight

		$(GEN): $(LOCAL_PATH)/ILight.hal
		$(transform-generated-source)
		LOCAL_GENERATED_SOURCES += $(GEN)
		include $(BUILD_STATIC_JAVA_LIBRARY)



		include $(call all-makefiles-under,$(LOCAL_PATH))

light/2.0/ILight.hal

0 → 100644

+37 −0

Original line number	Diff line number	Diff line
		/*
		* 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.
		*/

		package android.hardware.light@2.0;

		interface ILight {

		/**
		* Set the provided lights to the provided values.
		*
		* @param type logical light to set
		* @param state describes what the light should look like.
		* @return status result of applying state transformation.
		*/
		setLight(Type type, LightState state) generates (Status status);

		/**
		* Discover what indicator lights are available.
		*
		* @return types list of available lights
		*/
		getSupportedTypes() generates (vec<Type> types);

		};

light/2.0/types.hal

0 → 100644

+134 −0

Original line number	Diff line number	Diff line
		/*
		* 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.
		*/

		package android.hardware.light@2.0;

		enum Status : int32_t {
		SUCCESS,
		LIGHT_NOT_SUPPORTED,
		BRIGHTNESS_NOT_SUPPORTED,
		UNKNOWN,
		};

		enum Flash : int32_t {
		/*
		* Keep the light steady on or off.
		*/
		NONE,

		/*
		* Flash the light at specified rate.
		*/
		TIMED,

		/*
		* Flash the light using hardware assist.
		*/
		HARDWARE,
		};

		enum Brightness : int32_t {
		/**
		* Light brightness is managed by a user setting.
		*/
		USER,

		/**
		* Light brightness is managed by a light sensor.
		*/
		SENSOR,

		/**
		* Use a low-persistence mode for display backlights.
		*
		* When set, the device driver must switch to a mode optimized for low display
		* persistence that is intended to be used when the device is being treated as a
		* head mounted display (HMD). The actual display brightness in this mode is
		* implementation dependent, and any value set for color in light_state may be
		* overridden by the HAL implementation.
		*
		* For an optimal HMD viewing experience, the display must meet the following
		* criteria in this mode:
		* - Gray-to-Gray, White-to-Black, and Black-to-White switching time must be ≤ 3 ms.
		* - The display must support low-persistence with ≤ 3.5 ms persistence.
		* Persistence is defined as the amount of time for which a pixel is
		* emitting light for a single frame.
		* - Any "smart panel" or other frame buffering options that increase display
		* latency are disabled.
		* - Display brightness is set so that the display is still visible to the user
		* under normal indoor lighting.
		* - The display must update at 60 Hz at least, but higher refresh rates are
		* recommended for low latency.
		*
		*/
		LOW_PERSISTENCE,
		};

		/*
		* These light IDs correspond to logical lights, not physical.
		* So for example, if your INDICATOR light is in line with your
		* BUTTONS, it might make sense to also light the INDICATOR
		* light to a reasonable color when the BUTTONS are lit.
		*/
		enum Type : int32_t {
		BACKLIGHT,
		KEYBOARD,
		BUTTONS,
		BATTERY,
		NOTIFICATIONS,
		ATTENTION,
		BLUETOOTH,
		WIFI,

		COUNT,
		};

		/**
		* The parameters that can be set for a given light.
		*
		* Not all lights must support all parameters. If you
		* can do something backward-compatible, do it.
		*/
		struct LightState {
		/**
		* The color of the LED in ARGB.
		*
		* Do your best here.
		* - If your light can only do red or green, if they ask for blue,
		* you should do green.
		* - If you can only do a brightness ramp, then use this formula:
		* unsigned char brightness = ((77*((color>>16)&0x00ff))
		* + (150((color>>8)&0x00ff)) + (29(color&0x00ff))) >> 8;
		* - If you can only do on or off, 0 is off, anything else is on.
		*
		* The high byte should be ignored. Callers will set it to 0xff (which
		* would correspond to 255 alpha).
		*/
		uint32_t color;

		/**
		* To flash the light at a given rate, set flashMode to LIGHT_FLASH_TIMED,
		* and then flashOnMS should be set to the number of milliseconds to turn
		* the light on, followed by the number of milliseconds to turn the light
		* off.
		*/
		Flash flashMode;

		int32_t flashOnMs;
		int32_t flashOffMs;

		Brightness brightnessMode;
		};