Interfaz de VHAL

bookmark_border Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

El VHAL de AIDL se define en android.hardware.automotive.vehicle namespace. La interfaz de VHAL se define en IVehicle.aidl. A menos que se especifique lo contrario, todos los métodos deben implementarse para una versión específica de VHAL.

Versiones

SE RECOMIENDA implementar la versión más reciente de VHAL para una versión específica de Android.

Funciones y devoluciones de llamada

Las funciones de VHAL se definen en IVehicle.aidl.

Las devoluciones de llamada se definen en IVehicleCallback.aidl y contienen estos métodos.

La implementación de VHAL se valida con la VTS de VHAL en VtsHalAutomotiveVehicle_TargetTest.cpp.

La prueba verifica que los métodos básicos se implementen correctamente y que las configuraciones de las propiedades compatibles sean correctas. La prueba se ejecuta en todas las instancias de VHAL del dispositivo. Sin embargo, AAOS solo usa la instancia predeterminada (android.hardware.automotive.vehicle.IVehicle/default).

Valor de la propiedad del vehículo

Usa la estructura VehiclePropValue para describir el valor de cada propiedad, que tiene estos campos:

getValues y setValues asíncronos

Las operaciones getValues y setValues se realizan de forma asíncrona, lo que significa que la función puede mostrarse antes de que se complete la operación de obtención o configuración real. Los resultados de la operación (por ejemplo, el valor de la propiedad para getValues y el estado de error o de éxito para setValues) se entregan a través de las devoluciones de llamadas que se pasan como argumentos.

La implementación no debe bloquearse en el resultado del subproceso de Binder que controla la solicitud. En su lugar, te recomendamos que almacenes la solicitud en una cola de solicitudes y que uses un subproceso de controlador independiente para controlar las solicitudes de forma asíncrona. Consulta la Implementación de referencia para obtener más detalles.

Figura 1: Proceso asíncrono.

Elementos parcelables grandes

Todas las estructuras denominadas XXXs, como VehiclePropConfigs, SetValueRequests y VehiclePropValues, se denominan LargeParcelable (o StableLargeParcelable). Cada una representa una lista de valores que se usan para pasar datos grandes que podrían superar las limitaciones de Binder (4 KB en la implementación de la biblioteca LargeParcelable) en los límites de Binder. Cada uno tiene una definición de estructura similar que contiene los siguientes campos.

Por ejemplo, VehiclePropConfigs se define de la siguiente manera:

parcelable VehiclePropConfigs {
    // The list of vehicle property configs if they fit the binder memory
    // limitation.
    VehiclePropConfig[] payloads;
    // Shared memory file to store configs if they exceed binder memory
    // limitation. Created by VHAL, readable only at client. Client could keep
    // the fd opened or keep the FD mapped to access configs.
    @nullable ParcelFileDescriptor sharedMemoryFd;
}

VehiclePropConfigs contiene cargas útiles no vacías o un sharedMemoryFd no nulo.

• Si payloads no está vacío, almacena una lista de los datos reales, que es la configuración de la propiedad.
• Si sharedMemoryFd no es nulo, contiene un archivo de memoria compartida, que almacena la estructura serializada de VehiclePropConfigs. La estructura usa la función writeToParcel para serializar un Parcel.

Como cliente de Java para VHAL, Car Service controla la serialización y deserialización de LargeParcelable. En el caso de las implementaciones de VHAL y los clientes nativos, se debe serializar y deserializar un LargeParcelable con la biblioteca LargeParcelable o una clase de wrapper útil para la biblioteca en ParcelableUtils.h.

Por ejemplo, un cliente nativo que analiza solicitudes de getValues recibidas de un vinculador es el siguiente:

// 'requests' are from the binder.
GetValueRequests requests;
expected<LargeParcelableBase::BorrowedOwnedObject, ScopedAStatus> deserializedResults = fromStableLargeParcelable(requests);
if (deserializedResults.ok()) {
    const std::vector& getValueRequests = deserializedResults.value().getObject()->payloads;
    // Use the getValueRequests.
  } else {
    // handle error.
}

A continuación, se muestra una implementación de ejemplo de VHAL que envía resultados para getValues a través del Binder:

std::vector results = getResults();
GetValueResults parcelableResults;
ScopedAStatus status = vectorToStableLargeParcelable(std::move(results), &parcelableResults);
if (status.isOk()) {
    // Send parcelableResults through callback.
} else {
    // Handle error.
}