La interfaz de capa de abstracción de hardware del vehículo (VHAL) define las propiedades que los OEM pueden implementar y contiene metadatos de propiedad (por ejemplo, si la propiedad es un int y qué modos de cambio están permitidos). La interfaz VHAL se basa en acceder (leer, escribir, suscribirse) a una propiedad, que es una abstracción para una función específica.
Interfaces HAL
El VHAL utiliza las siguientes interfaces:
-
getAllPropConfigs()
genera(vec<VehiclePropConfig>propConfigs)
Enumere la configuración de todas las propiedades admitidas por la VHAL. CarService solo usa propiedades admitidas. -
getPropConfigs(vec<int32_t> props)
genera(StatusCode status,vec<VehiclePropConfig> propConfigs);
Devuelve la configuración de las propiedades seleccionadas. -
set(VehiclePropValue propValue)
genera(StatusCodestatus);
Escribe un valor en la propiedad. El resultado de la escritura se define por propiedad. -
subscribe(IVehicleCallback callback, vec<SubscribeOptions> options)
genera(StatusCode status);
Comience a monitorear un cambio en el valor de una propiedad. Para la propiedad zonificada,unsubscribe(IVehicleCallback callback, int32_t propId)
genera(StatusCode status);
El VHAL utiliza las siguientes interfaces de devolución de llamada:
-
oneway onPropertyEvent(vec<VehiclePropValue>propValues);
Notifica el cambio de valor de la propiedad del vehículo. Debe hacerse solo para propiedades suscritas. -
oneway onPropertySetError(StatusCode errorCode,int32_t propId,int32_tareaId);
Devuelve el error de nivel de VHAL global o el error por propiedad. El error global hace que HAL se reinicie, lo que puede provocar que se reinicien otros componentes (incluidas las aplicaciones).
Propiedades del vehículo
Las propiedades pueden ser de solo lectura, de solo escritura (se utilizan para pasar información al nivel VHAL) o de lectura y escritura (la compatibilidad con la mayoría de las propiedades es opcional). Cada propiedad se identifica de forma única mediante una clave int32 y tiene un tipo predefinido ( value_type
):
-
BYTES
-
BOOLEAN
-
FLOAT
-
FLOAT[]
-
INT32
-
INT32[]
-
INT64
-
INT64[]
-
STRING
-
MIXED
Una propiedad dividida en zonas puede tener más de un valor, según el número de zonas admitidas por la propiedad.
Tipos de área
El VHAL define múltiples tipos de áreas:
Tipo de área | Descripción |
---|---|
GLOBAL | Esta propiedad es un singleton y no tiene varias áreas. |
WINDOW | Área basada en Windows, usa la enumeración VehicleAreaWindow . |
MIRROR | Área basada en espejos, usa la enumeración VehicleAreaMirror . |
SEAT | Área basada en asientos, usa la enumeración VehicleAreaSeat . |
DOOR | Área basada en puertas, usa la enumeración VehicleAreaDoor . |
WHEEL | Área basada en ruedas, usa la enumeración VehicleAreaWheel . |
Cada propiedad dividida en zonas debe utilizar un tipo de área predefinida. Cada tipo de área tiene un conjunto de indicadores de bits definidos en una enumeración para el tipo de área. Por ejemplo, el SEAT
área define VehicleAreaSeat
enumeraciones:
-
ROW_1_LEFT = 0x0001
-
ROW_1_CENTER = 0x0002
-
ROW_1_RIGHT = 0x0004
-
ROW_2_LEFT = 0x0010
-
ROW_2_CENTER = 0x0020
-
ROW_2_RIGHT = 0x0040
-
ROW_3_LEFT = 0x0100
- ...
ID de área
Las propiedades zonales se abordan a través de ID de área. Cada propiedad zonificada puede admitir una o más ID de área. Un ID de área se compone de uno o más indicadores de su respectiva enumeración. Por ejemplo, una propiedad que usa VehicleAreaSeat
puede usar los siguientes ID de área:
Articulo | Descripción |
---|---|
ROW_1_LEFT | ROW_1_RIGHT | La identificación de área se aplica a ambos asientos delanteros. |
ROW_2_LEFT | Se aplica solo al asiento trasero izquierdo. |
ROW_2_RIGHT | Se aplica solo al asiento trasero derecho. |
Estado de la propiedad
Cada valor de propiedad viene con un valor VehiclePropertyStatus
. Esto indica el estado actual de la propiedad:
Articulo | Descripción |
---|---|
AVAILABLE | La propiedad está disponible y el valor es válido. |
UNAVAILABLE | El valor de la propiedad no está disponible actualmente. Se utiliza para funciones deshabilitadas transitoriamente para una propiedad admitida. |
ERROR | Algo anda mal con esta propiedad. |
Configurar una propiedad
Utilice VehiclePropConfig
para proporcionar información de configuración para cada propiedad. La información incluye:
Variable | Descripción |
---|---|
access | r , w , rw |
changeMode | Representa cómo se monitorea una propiedad, en cambios versus continuos. |
areaConfigs | areaId , min y max . |
configArray | Parámetros de configuración adicionales. |
configString | Información adicional transmitida como una cadena. |
minSampleRate | maxSampleRate |
prop | ID de propiedad, int |
Propiedades de la zona de manipulación
Una propiedad dividida en zonas equivale a una colección de varias propiedades donde se puede acceder a cada subpropiedad con el valor de ID de área especificado.
-
get
llamada para propiedad zonificada siempre incluye el ID de área en la solicitud. Por lo tanto, solo se devuelve el valor actual para el ID de área solicitado. Si la propiedad es global, el ID de área es 0. -
set
llamada para la propiedad zonificada siempre incluye el ID de área en la solicitud. Por lo tanto, solo se cambia el ID de área solicitado. -
subscribe
llamada desubscribe
genera eventos para todos los ID de área de la propiedad.
Recibir llamadas
Durante la inicialización, es posible que el valor de la propiedad no esté disponible todavía, ya que aún no se ha recibido el mensaje de red del vehículo correspondiente. En tales casos, la llamada get
debería devolver -EAGAIN
. Algunas propiedades (como HVAC) tienen una propiedad de encendido / apagado separada. Llamar a get
para tal propiedad (cuando está apagado) debería devolver un estado UNAVAILABLE
en lugar de devolver un error. Por ejemplo, obtenga la temperatura de HVAC
Figura 1 . Obtenga la temperatura de HVAC (CS = CarService, VHAL = Vehicle HAL)
Establecer llamadas
Una llamada set
es una operación asíncrona que implica la notificación de eventos después de que se realiza un cambio solicitado. En una operación típica, una llamada set
lleva a realizar una solicitud de cambio en la red del vehículo. Algunos set
llamadas pueden requerir datos iniciales para estar listo, pero durante la inicialización, estos datos pueden no estar disponibles todavía. En tales casos, la llamada set
debe devolver -EAGAIN
. Algunas propiedades con encendido / apagado por separado deben devolver -ESHUTDOWN
cuando la propiedad está apagada y no se puede configurar. Hasta que set
se haga efectivo, get
no necesariamente devuelve el mismo valor que set. Por ejemplo, set HVAC Temperature
.
Figura 2 . Configure la temperatura de HVAC (CS = CarService, VHAL = Vehicle HAL)
Manejo de propiedades personalizadas
Para respaldar las necesidades específicas de los socios, VHAL permite propiedades personalizadas que están restringidas a las aplicaciones del sistema. Utilice las siguientes pautas cuando trabaje con propiedades personalizadas:
- La identificación de propiedad debe generarse utilizando los siguientes campos:
-
VehiclePropertyGroup:VENDOR
El grupoVENDOR
se usa solo para propiedades personalizadas. -
VehicleArea
Seleccione un tipo de área apropiado. -
VehiclePropertyType
Seleccione el tipo de datos adecuado.BYTES
tipoBYTES
permite el paso de datos sin procesar que es suficiente en la mayoría de los casos. Enviar macrodatos con frecuencia a través de propiedades personalizadas puede ralentizar el acceso a la red de vehículos completos; tenga cuidado al agregar una gran carga útil. -
Property ID
Elija un ID de cuatro nibble para la propiedad personalizada.
-
- Para evitar la fragmentación del ecosistema, las propiedades personalizadas no se deben utilizar para replicar las propiedades del vehículo que ya existen en el ( VehiclePropertyIds SDK).
- Complete
VehiclePropConfig.configString
con una breve descripción de la propiedad personalizada. Esto permite que las herramientas de verificación de la cordura señalen la replicación accidental de las propiedades existentes del vehículo. Por ejemplo, "estado de luz de peligro". - Acceda a través de
CarPropertyManager
(para componentes Java) o mediante la API de servicio de red de vehículos (para nativos). No modifique las API de otros automóviles, ya que hacerlo puede generar problemas de compatibilidad en el futuro. - Después de implementar las propiedades del proveedor, seleccione solo la lista de permisos en la enumeración
VehicleVendorPermission
para las propiedades del proveedor. La asignación de los permisos del proveedor a las propiedades del sistema romperá el CTS y el VTS.
Manejo de las propiedades de HVAC
Puede usar el VHAL para controlar HVAC estableciendo propiedades relacionadas con HVAC. La mayoría de las propiedades de HVAC son propiedades divididas en zonas, aunque varias son propiedades no divididas en zonas (globales). Las propiedades definidas de muestra incluyen:
Propiedad | Propósito |
---|---|
VEHICLE_PROPERTY_HVAC_TEMPERATURE_SET | Configure la temperatura por zona. |
VEHICLE_PROPERTY_HVAC_RECIRC_ON | Control de recirculación por zona. |
Para ver una lista completa de propiedades HVAC, busque VEHICLE_PROPERTY_HVAC_*
en types.hal
. Cuando la propiedad HVAC usa VehicleAreaSeat
, se aplican reglas adicionales para mapear una propiedad HVAC zonificada a ID de área. Cada asiento disponible en el automóvil debe ser parte de un ID de área en la matriz de ID de área.
Ejemplo uno. Un automóvil tiene dos asientos delanteros ( ROW_1_LEFT, ROW_1_RIGHT
) y tres asientos traseros ( ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT
). El automóvil tiene dos unidades de control de temperatura: el lado del conductor y el lado del pasajero.
- Un conjunto de mapeo válido de ID de área para
HVAC_TEMPERATURE SET
es:-
ROW_1_LEFT | ROW_2_LEFT
-
ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT
-
- Una asignación alternativa para la misma configuración de hardware es:
-
ROW_1_LEFT | ROW_2_LEFT | ROW_2_CENTER
-
ROW_1_RIGHT | ROW_2_RIGHT
-
Ejemplo dos. Un automóvil tiene tres filas de asientos con dos asientos en la primera fila ( ROW_1_LEFT, ROW_1_RIGHT
), tres asientos en la segunda ( ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT
) y tres en la tercera fila ( ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT
). El automóvil tiene tres unidades de control de temperatura: lado del conductor, lado del pasajero y parte trasera. Una forma razonable de asignar HVAC_TEMPERATURE_SET
a ID de área es como una matriz de tres elementos:
-
ROW_1_LEFT
-
ROW_1_RIGHT
-
ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
Manejo de las propiedades del sensor
Las propiedades del sensor VHAL representan datos reales del sensor o información de políticas, como el estado de conducción. Cualquier aplicación puede acceder a cierta información del sensor (como el estado de conducción y el modo día / noche) sin restricciones, ya que los datos son obligatorios para crear una aplicación segura para vehículos. Otra información del sensor (como la velocidad del vehículo) es más sensible y requiere permisos específicos que los usuarios pueden administrar.
Consulte las propiedades de sensor admitidas en ( types.hal ).
Servicio de mapas de vehículos
El Servicio de mapas de vehículos (VMS) proporciona un mecanismo para intercambiar datos de mapas entre clientes a través de una interfaz pub / sub para admitir características comunes del vehículo, como los sistemas avanzados de asistencia al conductor (ADAS) . Los clientes pueden incluir sistemas de vehículos interconectados a través de la propiedad VMS en VHAL o aplicaciones Android privilegiadas. Los datos compartidos en VMS están destinados a limitarse a datos de mapas para su uso por sistemas de vehículos y aplicaciones de apoyo.
VMS está diseñado para usarse solo en implementaciones de Android Automotive; AOSP no contiene clientes predeterminados que publiquen o se suscriban a VMS. Para la propiedad VMS en VHAL, los tipos de mensajes y las estructuras de datos se describen en VHAL 2.0 en la enumeración VmsMessageType , que enumera los tipos de mensajes VMS admitidos. Esta enumeración se usa como el primer número entero en la matriz de números enteros de la propiedad del vehículo y determina cómo se decodifica el resto del mensaje.