Merge changes from topic "hci_aidl_hal" (88150368) · Commits · e / os / android_hardware_interfaces

bluetooth/aidl/Android.bp

0 → 100644

+28 −0

Original line number	Diff line number	Diff line
		// This is the expected build file, but it may not be right in all cases

		aidl_interface {
		name: "android.hardware.bluetooth",
		vendor_available: true,
		host_supported: true,
		srcs: ["android/hardware/bluetooth/*.aidl"],
		stability: "vintf",
		backend: {
		cpp: {
		// FIXME should this be disabled?
		// prefer NDK backend which can be used anywhere
		// If you disable this, you also need to delete the C++
		// translate code.
		enabled: true,
		},
		java: {
		sdk_version: "module_current",
		},
		ndk: {
		apex_available: [
		"//apex_available:platform",
		"com.android.btservices",
		],
		min_sdk_version: "33",
		},
		},
		}

bluetooth/aidl/aidl_api/android.hardware.bluetooth/current/android/hardware/bluetooth/IBluetoothHci.aidl

0 → 100644

+43 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright 2022 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.bluetooth;
		@VintfStability
		interface IBluetoothHci {
		void close();
		void initialize(in android.hardware.bluetooth.IBluetoothHciCallbacks callback);
		void sendAclData(in byte[] data);
		void sendHciCommand(in byte[] command);
		void sendIsoData(in byte[] data);
		void sendScoData(in byte[] data);
		}

bluetooth/aidl/aidl_api/android.hardware.bluetooth/current/android/hardware/bluetooth/IBluetoothHciCallbacks.aidl

0 → 100644

+42 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright 2022 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.bluetooth;
		@VintfStability
		interface IBluetoothHciCallbacks {
		void aclDataReceived(in byte[] data);
		void hciEventReceived(in byte[] event);
		void initializationComplete(in android.hardware.bluetooth.Status status);
		void isoDataReceived(in byte[] data);
		void scoDataReceived(in byte[] data);
		}

bluetooth/aidl/aidl_api/android.hardware.bluetooth/current/android/hardware/bluetooth/Status.aidl

0 → 100644

+42 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright 2022 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.bluetooth;
		@Backing(type="int") @VintfStability
		enum Status {
		SUCCESS = 0,
		ALREADY_INITIALIZED = 1,
		UNABLE_TO_OPEN_INTERFACE = 2,
		HARDWARE_INITIALIZATION_ERROR = 3,
		UNKNOWN = 4,
		}

bluetooth/aidl/android/hardware/bluetooth/IBluetoothHci.aidl

0 → 100644

+73 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright 2022 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.bluetooth;

		import android.hardware.bluetooth.IBluetoothHciCallbacks;

		/**
		* The Host Controller Interface (HCI) is the layer defined by the Bluetooth
		* specification between the software that runs on the host and the Bluetooth
		* controller chip. This boundary is the natural choice for a Hardware
		* Abstraction Layer (HAL). Dealing only in HCI packets and events simplifies
		* the stack and abstracts away power management, initialization, and other
		* implementation-specific details related to the hardware.
		*/
		@VintfStability
		interface IBluetoothHci {
		/**
		* Close the HCI interface
		*/
		void close();

		/**
		* Initialize the Bluetooth interface and set the callbacks.
		*/
		void initialize(in IBluetoothHciCallbacks callback);

		/**
		* Send an HCI ACL data packet (as specified in the Bluetooth Specification
		* V4.2, Vol 2, Part 5, Section 5.4.2) to the Bluetooth controller.
		* Packets must be processed in order.
		* @param data HCI data packet to be sent
		*/
		void sendAclData(in byte[] data);

		/**
		* Send an HCI command (as specified in the Bluetooth Specification
		* V4.2, Vol 2, Part 5, Section 5.4.1) to the Bluetooth controller.
		* Commands must be executed in order.
		*
		* @param command is the HCI command to be sent
		*/
		void sendHciCommand(in byte[] command);

		/**
		* Send an ISO data packet (as specified in the Bluetooth Core
		* Specification v5.2) to the Bluetooth controller.
		* Packets must be processed in order.
		* @param data HCI data packet to be sent
		*/
		void sendIsoData(in byte[] data);

		/**
		* Send an SCO data packet (as specified in the Bluetooth Specification
		* V4.2, Vol 2, Part 5, Section 5.4.3) to the Bluetooth controller.
		* Packets must be processed in order.
		* @param data HCI data packet to be sent
		*/
		void sendScoData(in byte[] data);
		}