Snap for 8211163 from 5d966b38 to tm-d1-release

// This file is autogenerated by hidl-gen -Landroidbp.

package {

    // See: http://go/android-license-faq

    // A large-scale-change added 'default_applicable_licenses' to import

    // all of the 'license_kinds' from "hardware_interfaces_license"

    // to get the below license kinds:

    //   SPDX-license-identifier-Apache-2.0

    default_applicable_licenses: ["hardware_interfaces_license"],

}

hidl_interface {

    name: "android.hardware.bluetooth.audio@2.2",

    root: "android.hardware",

    srcs: [

        "types.hal",

        "IBluetoothAudioPort.hal",

        "IBluetoothAudioProvider.hal",

        "IBluetoothAudioProvidersFactory.hal",

    ],

    interfaces: [

        "android.hardware.audio.common@5.0",

        "android.hardware.bluetooth.audio@2.0",

        "android.hardware.bluetooth.audio@2.1",

        "android.hidl.base@1.0",

        "android.hidl.safe_union@1.0",

    ],

    apex_available: [

        "//apex_available:platform",

        "com.android.bluetooth",

    ],

    gen_java: false,

}

/*

 * Copyright 2021 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.audio@2.2;

import @2.0::IBluetoothAudioPort;

import android.hardware.audio.common@5.0::SinkMetadata;

interface IBluetoothAudioPort extends @2.0::IBluetoothAudioPort  {

    /**

     * Called when the metadata of the stream's sink has been changed.

     *

     * @param sinkMetadata Description of the audio that is recorded by the

     *    clients.

     */

    updateSinkMetadata(SinkMetadata sinkMetadata);

};

/*

 * Copyright 2021 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.audio@2.2;

import @2.1::IBluetoothAudioProvider;

import @2.2::IBluetoothAudioPort;

import @2.0::Status;

/**

 * HAL interface from the Bluetooth stack to the Audio HAL

 *

 * The Bluetooth stack calls methods in this interface to start and end audio

 * sessions and sends callback events to the Audio HAL.

 *

 * Note: For HIDL APIs with a "generates" statement, the callback parameter used

 * for return value must be invoked synchronously before the API call returns.

 */

interface IBluetoothAudioProvider extends @2.1::IBluetoothAudioProvider {

    /**

     * This method indicates that the Bluetooth stack is ready to stream audio.

     * It registers an instance of IBluetoothAudioPort with and provides the

     * current negotiated codec to the Audio HAL. After this method is called,

     * the Audio HAL can invoke IBluetoothAudioPort.startStream().

     *

     * Note: endSession() must be called to unregister this IBluetoothAudioPort

     *

     * @param hostIf An instance of IBluetoothAudioPort for stream control

     * @param audioConfig The audio configuration negotiated with the remote

     *    device. The PCM parameters are set if software based encoding,

     *    otherwise the correct codec configuration is used for hardware

     *    encoding.

     *

     * @return status One of the following

     *    SUCCESS if this IBluetoothAudioPort was successfully registered with

     *        the Audio HAL

     *    UNSUPPORTED_CODEC_CONFIGURATION if the Audio HAL cannot register this

     *        IBluetoothAudioPort with the given codec configuration

     *    FAILURE if the Audio HAL cannot register this IBluetoothAudioPort for

     *        any other reason

     * @return dataMQ The fast message queue for audio data from/to this

     *    provider. Audio data will be in PCM format as specified by the

     *    audioConfig.pcmConfig parameter. Invalid if streaming is offloaded

     *    from/to hardware or on failure.

     */

    startSession_2_2(IBluetoothAudioPort hostIf, AudioConfiguration audioConfig)

                generates (Status status, fmq_sync<uint8_t> dataMQ);

    /**

     * Called when the audio configuration of the stream has been changed.

     *

     * @param audioConfig The audio configuration negotiated with the remote

     *    device. The PCM parameters are set if software based encoding,

     *    otherwise the correct codec configuration is used for hardware

     *    encoding.

     */

    updateAudioConfiguration(AudioConfiguration audioConfig);

    /**

     * Called when the supported latency mode is updated.

     *

     * @param allowed If the peripheral devices can't keep up with low latency

     * mode, the API will be called with supported is false.

     */

    setLowLatencyModeAllowed(bool allowed);

};

/*

 * Copyright 2021 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.audio@2.2;

import IBluetoothAudioProvider;

import @2.1::IBluetoothAudioProvidersFactory;

import @2.0::Status;

import @2.1::SessionType;

/**

 * This factory allows a HAL implementation to be split into multiple

 * independent providers.

 *

 * When the Bluetooth stack is ready to create an audio session, it must first

 * obtain the IBluetoothAudioProvider for that session type by calling

 * openProvider().

 *

 * Note: For HIDL APIs with a "generates" statement, the callback parameter used

 * for return value must be invoked synchronously before the API call returns.

 */

interface IBluetoothAudioProvidersFactory extends @2.1::IBluetoothAudioProvidersFactory {

    /**

     * Opens an audio provider for a session type. To close the provider, it is

     * necessary to release references to the returned provider object.

     *

     * @param sessionType The session type (e.g.

     *    LE_AUDIO_SOFTWARE_ENCODING_DATAPATH).

     *

     * @return status One of the following

     *    SUCCESS if the Audio HAL successfully opens the provider with the

     *        given session type

     *    FAILURE if the Audio HAL cannot open the provider

     * @return provider The provider of the specified session type

     */

    openProvider_2_2(SessionType sessionType)

        generates (Status status, IBluetoothAudioProvider provider);

    /**

     * Gets a list of audio capabilities for a session type.

     *

     * For software encoding, the PCM capabilities are returned.

     * For hardware encoding, the supported codecs and their capabilities are

     * returned.

     *

     * @param sessionType The session type (e.g.

     *    A2DP_SOFTWARE_ENCODING_DATAPATH).

     * @return audioCapabilities A list containing all the capabilities

     *    supported by the sesson type. The capabilities is a list of

     *    available options when configuring the codec for the session.

     *    For software encoding it is the PCM data rate.

     *    For hardware encoding it is the list of supported codecs and their

     *    capabilities.

     *    If a provider isn't supported, an empty list should be returned.

     *    Note: Only one entry should exist per codec when using hardware

     *    encoding.

     */

     getProviderCapabilities_2_2(SessionType sessionType)

         generates (vec<AudioCapabilities> audioCapabilities);

};

aliceypkuo@google.com

ugoyu@google.com

sattiraju@google.com