Merge "Drop broadcastradio HAL 1.2."

    static_libs: [

        "android.hardware.broadcastradio@1.0",

        "android.hardware.broadcastradio@1.1",

        "android.hardware.broadcastradio@1.2",  // common-utils-lib dependency

        "android.hardware.broadcastradio@common-utils-1x-lib",

        "android.hardware.broadcastradio@vts-utils-lib",

        "libgmock",

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

hidl_interface {

    name: "android.hardware.broadcastradio@1.2",

    root: "android.hardware",

    vndk: {

        enabled: true,

    },

    srcs: [

        "types.hal",

        "IBroadcastRadioFactory.hal",

        "ITuner.hal",

        "ITunerCallback.hal",

    ],

    interfaces: [

        "android.hardware.broadcastradio@1.0",

        "android.hardware.broadcastradio@1.1",

        "android.hidl.base@1.0",

    ],

    types: [

        "IdentifierType",

    ],

    gen_java: false,

}

/*

 * Copyright (C) 2017 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.broadcastradio@1.2;

import @1.1::IBroadcastRadioFactory;

/**

 * To use 1.2 features you must cast specific interfaces returned from the

 * 1.0 HAL. For example V1_0::IBroadcastRadio::openTuner() returns V1_0::ITuner,

 * which can be cast with V1_2::ITuner::castFrom() call.

 *

 * The 1.2 server must always return the 1.2 version of specific interface.

 */

interface IBroadcastRadioFactory extends @1.1::IBroadcastRadioFactory {

};

/*

 * Copyright (C) 2017 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.broadcastradio@1.2;

import @1.1::ITuner;

interface ITuner extends @1.1::ITuner {

    /**

     * Generic method for setting vendor-specific parameter values.

     * The framework does not interpret the parameters, they are passed

     * in an opaque manner between a vendor application and HAL.

     *

     * Framework does not make any assumptions on the keys or values, other than

     * ones stated in VendorKeyValue documentation (a requirement of key

     * prefixes).

     *

     * For each pair in the result vector, the key must be one of the keys

     * contained in the input (possibly with wildcards expanded), and the value

     * must be a vendor-specific result status (i.e. the string "OK" or an error

     * code). The implementation may choose to return an empty vector, or only

     * return a status for a subset of the provided inputs, at its discretion.

     *

     * Application and HAL must not use keys with unknown prefix. In particular,

     * it must not place a key-value pair in results vector for unknown key from

     * parameters vector - instead, an unknown key should simply be ignored.

     * In other words, results vector may contain a subset of parameter keys

     * (however, the framework doesn't enforce a strict subset - the only

     * formal requirement is vendor domain prefix for keys).

     *

     * @param parameters Vendor-specific key-value pairs.

     * @return results Operation completion status for parameters being set.

     */

    setParameters(vec<VendorKeyValue> parameters)

            generates (vec<VendorKeyValue> results);

    /**

     * Generic method for retrieving vendor-specific parameter values.

     * The framework does not interpret the parameters, they are passed

     * in an opaque manner between a vendor application and HAL.

     *

     * Framework does not cache set/get requests, so it's allowed for

     * getParameter to return a different value than previous setParameter call.

     *

     * The syntax and semantics of keys are up to the vendor (as long as prefix

     * rules are obeyed). For instance, vendors may include some form of

     * wildcard support. In such case, result vector may be of different size

     * than requested keys vector. However, wildcards are not recognized by

     * framework and they are passed as-is to the HAL implementation.

     *

     * Unknown keys must be ignored and not placed into results vector.

     *

     * @param keys Parameter keys to fetch.

     * @return parameters Vendor-specific key-value pairs.

     */

    getParameters(vec<string> keys) generates (vec<VendorKeyValue> parameters);

};

/*

 * Copyright (C) 2017 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.broadcastradio@1.2;

import @1.1::ITunerCallback;

interface ITunerCallback extends @1.1::ITunerCallback {

    /**

     * Generic callback for passing updates to vendor-specific parameter values.

     * The framework does not interpret the parameters, they are passed

     * in an opaque manner between a vendor application and HAL.

     *

     * It's up to the HAL implementation if and how to implement this callback,

     * as long as it obeys the prefix rule. In particular, only selected keys

     * may be notified this way. However, setParameters must not trigger

     * this callback, while an internal event can change parameters

     * asynchronously.

     *

     * @param parameters Vendor-specific key-value pairs.

     */

    oneway parametersUpdated(vec<VendorKeyValue> parameters);

};