cf22a57c1a
IEvent was a synchronization primitive which caused some confusion in the interface. Originally the event object was paired with an asynchronous task, and the asynchronous task would signal this event when the corresponding output was ready to be used. In the case of IDevice::prepareModel, the function call would return an IPreparedModel object that was not guaranteed to be prepared until the runtime had returned from waiting on the corresponding event object. The event object has been changed to two explicit callbacks-- IPreparedModelCallback and IExecutionCallback. Now, IDevice::prepareModel no longer returns an unfinished IPreparedModel; instead, it will pass the IPreparedModel object to the runtime through IPreparedModelCallback::notify. When the runtime retreives the IPreparedModel object, the asynchronous task has already finished preparing the model. The two callbacks are used for different purposes. Each has its own version of notify to pass the data back to the runtime: * IPreparedModelCallback::notify(ErrorStatus, IPreparedModel) * IExecutionCallback::notify(ErrorStatus) Bug: 63905942 Test: mm, vts, ml/nn/runtime/tests Change-Id: I0c88cd262ba762e0af15e9da31ebe813a5d150b2
53 lines
2.4 KiB
Text
53 lines
2.4 KiB
Text
/*
|
|
* 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.neuralnetworks@1.0;
|
|
|
|
import IPreparedModel;
|
|
|
|
/**
|
|
* IPreparedModelCallback must be used to return a prepared model produced by an
|
|
* asynchronous task launched from IDevice::prepareModel.
|
|
*/
|
|
interface IPreparedModelCallback {
|
|
|
|
/**
|
|
* notify must be invoked immediately after the asynchronous task holding
|
|
* this callback has finished preparing the model. If the model was
|
|
* successfully prepared, notify must be invoked with ErrorStatus::NONE and
|
|
* the prepared model. If the model was not able to be successfully
|
|
* prepared, notify must be invoked with the appropriate ErrorStatus and
|
|
* nullptr as the IPreparedModel. If the asynchronous task holding this
|
|
* callback fails to launch or if the model provided to
|
|
* IDevice::prepareModel is invalid, notify must be invoked with the
|
|
* appropriate error as well as nullptr for the IPreparedModel.
|
|
*
|
|
* @param status Error status returned from the asynchronous model
|
|
* preparation task; must be:
|
|
* - NONE if the asynchronous task successfully prepared the
|
|
* model
|
|
* - DEVICE_UNAVAILABLE if driver is offline or busy
|
|
* - GENERAL_FAILURE if the asynchronous task resulted in an
|
|
* unspecified error
|
|
* - INVALID_ARGUMENT if one of the input arguments to
|
|
* prepareModel is invalid
|
|
* @param preparedModel A model that has been asynchronously prepared for
|
|
* execution. If the model was unable to be prepared
|
|
* due to an error, nullptr must be passed in place of
|
|
* the IPreparedModel object.
|
|
*/
|
|
oneway notify(ErrorStatus status, IPreparedModel preparedModel);
|
|
};
|