Implementação de referência

Fornecemos uma implementação de referência para a VHAL da AIDL. A linha de execução de serviço principal é implementada em VehicleService.cpp. A implementação da interface VHAL está localizada em DefaultVehicleHal.cpp.

A implementação de referência é baseada em uma arquitetura de duas camadas. Na camada superior, DefaultVehicleHal, implementa a interface AIDL VHAL e fornece a lógica VHAL genérica para todos os dispositivos de hardware. Na camada inferior, FakeVehicleHardware, implementa a interface IVehicleHardware. Essa classe simula a lógica da VHAL para interagir com o hardware real ou o barramento do veículo e é específica do dispositivo. Opcionalmente, os fornecedores podem adaptar essa mesma arquitetura, reutilizar a mesma classe DefaultVehicleHal (estendendo-a para substituir um método) e fornecer a própria implementação de IVehicleHardware.

DefaultVehicleHal contém a lógica a seguir, que é considerada genérica e pode ser aplicada a qualquer implementação do VHAL.

• Implementa a interface IVehicle.
• Realiza verificações básicas de entrada, incluindo uma verificação de IDs duplicados.
• Aloca objetos de cliente (por exemplo, GetValuesClient) para cada operação de cada cliente de vinculação e adiciona cada um a um pool global.
• Gerencia a lógica de callbacks assíncronos, como adicionar uma solicitação pendente a um pool de solicitações pendentes. Resolve solicitações pendentes quando recebemos os resultados ou retorna um erro quando uma das solicitações pendentes expira.
• Serializa e desserializa LargeParcelable (consulte ParcelableUtils.h).
• Gerencia a assinatura (consulte SubscriptionManager.h).
• Verifica as permissões. Consulte as funções checkReadPermission e checkWritePermission.
• Chama IVehicleHardware.checkHealth periodicamente e envia sinais de batimento cardíaco (consulte a função checkHealth).

IVehicleHardware é uma interface genérica usada para representar a implementação específica de hardware de uma VHAL. A implementação de referência para IVehicleHardware é FakeVehicleHardware, que usa um mapa na memória para armazenar o valor da propriedade e não se comunica com um barramento de veículo real. Ele é destinado a ser executado em um emulador e não tem dependências específicas de hardware. As implementações do fornecedor não podem usá-lo como está e precisam adicionar uma lógica específica da bus do veículo.

A partir do Android 14, FakeVehicleHardware lê a configuração de propriedade com suporte no tempo de execução durante a inicialização na pasta /vendor/etc/automotive/vhalconfig/ do dispositivo, que contém um arquivo de configuração no estilo JSON. Consulte o arquivo README de referência do VHAL para saber o formato e o conteúdo do arquivo de configuração.

FakeVehicleHardware também oferece suporte à substituição de arquivos de configuração para testes. Se a propriedade do sistema persist.vendor.vhal_init_value_override estiver definida (essa propriedade precisa ser definida no momento da build ou muito cedo durante a inicialização, antes da inicialização do VHAL), ela usará o arquivo de configuração da pasta /vendor/etc/automotive/vhaloverride/ no dispositivo para substituir a configuração atual. Uma implementação do fornecedor pode usar uma abordagem semelhante para que a configuração de propriedade compatível com o VHAL não seja codificada e possa ser decidida dinamicamente no início. A lista de configurações de propriedade do veículo precisa ser estática depois que a VHAL for inicializada.

A partir do Android 16, o GRPCVehicleHardware fornece outra implementação de referência IVehicleHardware. Essa implementação pressupõe que há um servidor separado em execução em uma máquina remota ou VM que contém a lógica de processamento da propriedade. O VHAL em execução em dispositivos AAOS funciona como um proxy que encaminha solicitações para o servidor remoto. Consulte grpc para mais detalhes.