NN HAL: Upgrade IPreparedModel::execute to 1.3. am: 1b3f4266

26f04510a0b57aba5167c5c0a7c2f077c2acbb98b81902a072517829fd9fd67f android.hardware.health@2.1::IHealthInfoCallback

db47f4ceceb1f06c656f39caa70c557b0f8471ef59fd58611bea667ffca20101 android.hardware.health@2.1::types

9e59fffceed0dd72a9799e04505db5f777bbbea1af0695ba4107ef6d967c6fda android.hardware.neuralnetworks@1.3::IDevice

fd5a2b723b75acbdd9f31bd07e0f83293c52f99f8d9b87bf58eeb6018f665fde android.hardware.neuralnetworks@1.3::IPreparedModelCallback

4a6c3b3556da951b4def21ba579a227c022980fe4465df6cdfbe20628fa75f5a android.hardware.neuralnetworks@1.3::IPreparedModel

94e803236398bed1febb11cc21051bc42ec003700139b099d6c479e02a7ca3c3 android.hardware.neuralnetworks@1.3::IPreparedModelCallback

b74fe72cfe438f50e772e6a307657ff449d5bde83c15dd1f140ff2edbe73499c android.hardware.neuralnetworks@1.3::types

274fb1254a6d1a97824ec5c880eeefc0e410dc6d3a2a4c34052201169d2b7de0 android.hardware.radio@1.5::types

c8e81d912827a5d49b2ddcdc4eb4556c5d231a899a1dca879309e04210daa4a0 android.hardware.radio@1.5::IRadio

    srcs: [

        "types.hal",

        "IDevice.hal",

        "IPreparedModel.hal",

        "IPreparedModelCallback.hal",

    ],

    interfaces: [

/*

 * Copyright (C) 2019 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.neuralnetworks@1.3;

import @1.0::ErrorStatus;

import @1.0::Request;

import @1.2::MeasureTiming;

import @1.2::IExecutionCallback;

import @1.2::IPreparedModel;

/**

 * IPreparedModel describes a model that has been prepared for execution and

 * is used to launch executions.

 */

interface IPreparedModel extends @1.2::IPreparedModel {

    /**

     * Launches an asynchronous execution on a prepared model.

     *

     * The execution is performed asynchronously with respect to the caller.

     * execute_1_3 must verify the inputs to the function are correct. If there is

     * an error, execute_1_3 must immediately invoke the callback with the

     * appropriate ErrorStatus value, then return with the same ErrorStatus. If

     * the inputs to the function are valid and there is no error, execute_1_3 must

     * launch an asynchronous task to perform the execution in the background,

     * and immediately return with ErrorStatus::NONE. If the asynchronous task

     * fails to launch, execute_1_3 must immediately invoke the callback with

     * ErrorStatus::GENERAL_FAILURE, then return with

     * ErrorStatus::GENERAL_FAILURE.

     *

     * When the asynchronous task has finished its execution, it must

     * immediately invoke the callback object provided as an input to the

     * execute_1_3 function. This callback must be provided with the ErrorStatus of

     * the execution.

     *

     * If the launch is successful, the caller must not change the content of

     * any data object referenced by 'request' (described by the

     * {@link @1.0::DataLocation} of a {@link @1.0::RequestArgument}) until the

     * asynchronous task has invoked the callback object. The asynchronous task

     * must not change the content of any of the data objects corresponding to

     * 'request' inputs.

     *

     * If the prepared model was prepared from a model wherein all tensor

     * operands have fully specified dimensions, and the inputs to the function

     * are valid, then:

     * - the execution should launch successfully (ErrorStatus::NONE): There

     *   must be no failure unless the device itself is in a bad state.

     * - if at execution time every operation's input operands have legal

     *   values, the execution should complete successfully (ErrorStatus::NONE):

     *   There must be no failure unless the device itself is in a bad state.

     *

     * Any number of calls to the execute, execute_1_2, execute_1_3, and executeSynchronously

     * functions, in any combination, may be made concurrently, even on the same

     * IPreparedModel object.

     *

     * @param request The input and output information on which the prepared

     *                model is to be executed.

     * @param measure Specifies whether or not to measure duration of the execution.

     *                The duration runs from the time the driver sees the call

     *                to the execute_1_3 function to the time the driver invokes

     *                the callback.

     * @param callback A callback object used to return the error status of

     *                 the execution. The callback object's notify function must

     *                 be called exactly once, even if the execution was

     *                 unsuccessful.

     * @return status Error status of the call, must be:

     *                - NONE if task is successfully launched

     *                - DEVICE_UNAVAILABLE if driver is offline or busy

     *                - GENERAL_FAILURE if there is an unspecified error

     *                - OUTPUT_INSUFFICIENT_SIZE if provided output buffer is

     *                  not large enough to store the resultant values

     *                - INVALID_ARGUMENT if one of the input arguments is

     *                  invalid

     */

    execute_1_3(Request request, MeasureTiming measure, IExecutionCallback callback)

        generates (ErrorStatus status);

};

import @1.0::ErrorStatus;

import @1.2::IPreparedModelCallback;

import @1.2::IPreparedModel;

import IPreparedModel;

/**

 * IPreparedModelCallback must be used to return a prepared model produced by an

}

Return<void> PreparedModelCallback::notify_1_3(ErrorStatus errorStatus,

                                               const sp<V1_2::IPreparedModel>& preparedModel) {

                                               const sp<V1_3::IPreparedModel>& preparedModel) {

    return notify(errorStatus, preparedModel);

}