Cómo implementar referencias

Proporcionamos una implementación de referencia para el VHAL de AIDL. El subproceso de servicio principal se implementa en VehicleService.cpp. La implementación de la interfaz VHAL se encuentra en DefaultVehicleHal.cpp.

La implementación de referencia se basa en una arquitectura de dos capas. En la capa superior, DefaultVehicleHal, implementa la interfaz AIDL de VHAL y proporciona una lógica de VHAL genérica para todos los dispositivos de hardware. En la capa inferior, FakeVehicleHardware, implementa la interfaz IVehicleHardware. Esta clase simula la lógica de VHAL de interactuar con el hardware o el bus del vehículo real y es específica del dispositivo. De manera opcional, los proveedores pueden adaptar esta misma arquitectura, reutilizar la misma clase DefaultVehicleHal (extendiéndola para reemplazar un método) y proporcionar su propia implementación de IVehicleHardware.

DefaultVehicleHal contiene la siguiente lógica, que se considera genérica y se puede aplicar a cualquier implementación de VHAL.

• Implementa la interfaz IVehicle.
• Realiza verificaciones de entrada básicas, incluida una verificación de IDs duplicados.
• Asigna objetos de cliente (por ejemplo, GetValuesClient) para cada operación de cada cliente de Binder y los agrega a un grupo global.
• Administra la lógica de devoluciones de llamada asíncronas, como agregar una solicitud pendiente a un grupo de solicitudes pendientes. Resuelve las solicitudes pendientes cuando recibimos los resultados o muestra un error cuando se agota el tiempo de espera de una de las solicitudes pendientes.
• Serializa y deserializa LargeParcelable (consulta ParcelableUtils.h).
• Administra la suscripción (consulta SubscriptionManager.h).
• Verifica los permisos. (consulta las funciones checkReadPermission y checkWritePermission).
• Llama a IVehicleHardware.checkHealth de forma periódica y envía indicadores de actividad (consulta la función checkHealth).

IVehicleHardware es una interfaz genérica que se usa para representar la implementación específica de hardware de un VHAL. La implementación de referencia para IVehicleHardware es FakeVehicleHardware, que usa un mapa en la memoria para almacenar el valor de la propiedad y no se comunica con un bus de vehículo real. Su propósito es ejecutarse en un emulador y no tener dependencias específicas de hardware. Las implementaciones de los proveedores no deben usarlo tal como está y deben agregar una lógica específica del bus del vehículo.

A partir de Android 14, FakeVehicleHardware lee la configuración de propiedades admitidas durante el tiempo de ejecución durante la inicialización desde la carpeta /vendor/etc/automotive/vhalconfig/ del dispositivo, que contiene un archivo de configuración de estilo JSON. Consulta el archivo de información de VHAL de referencia para conocer el formato y el contenido del archivo de configuración.

FakeVehicleHardware también admite la anulación del archivo de configuración para pruebas. Si se establece la propiedad del sistema persist.vendor.vhal_init_value_override (esta propiedad se debe establecer en el momento de la compilación o muy al principio durante el inicio antes de la inicialización de VHAL), se usa el archivo de configuración de la carpeta /vendor/etc/automotive/vhaloverride/ en el dispositivo para anular la configuración existente. Una implementación del proveedor puede usar un enfoque similar para que la configuración de propiedades compatibles con VHAL no esté codificada de forma fija y se pueda decidir de forma dinámica en el momento del inicio. La lista de parámetros de configuración de propiedades del vehículo debe ser estática después de que se inicializa VHAL.

A partir de Android 16, GRPCVehicleHardware proporciona otra implementación de referencia de IVehicleHardware. Esta implementación asume que hay un servidor independiente que se ejecuta en una máquina o VM remota que contiene la lógica de control de propiedades. El VHAL que se ejecuta en dispositivos AAOS actúa como un proxy que reenvía solicitudes al servidor remoto. Consulta grpc para obtener más detalles.