Interface VHAL

O VHAL do AIDL é definido em android.hardware.automotive.vehicle namespace. A interface VHAL é definida em IVehicle.aidl. A menos que especificado, todos os métodos precisam ser implementados para uma versão específica do VHAL.

Versões

É RECOMENDÁVEL implementar a versão mais recente do VHAL para uma versão específica do Android.

Funções e callbacks

As funções VHAL são definidas em IVehicle.aidl.

Os callbacks são definidos em IVehicleCallback.aidl e contêm esses métodos.

A implementação da VHAL é validada pelo VTS da VHAL em VtsHalAutomotiveVehicle_TargetTest.cpp.

O teste verifica se os métodos básicos são implementados corretamente e se as configurações de propriedade com suporte estão corretas. O teste é executado em todas as instâncias do VHAL no dispositivo. No entanto, o AAOS usa apenas a instância padrão (android.hardware.automotive.vehicle.IVehicle/default).

Valor da propriedade do veículo

Use a estrutura VehiclePropValue para descrever o valor de cada propriedade, que tem estes campos:

getValues e setValues assíncronos

As operações getValues e setValues são realizadas de forma assíncrona, o que significa que a função pode retornar antes que a operação de busca ou definição seja concluída. Os resultados da operação (por exemplo, o valor da propriedade para getValues e o status de sucesso ou de erro para setValues) são enviados pelos callbacks transmitidos como argumentos.

A implementação não pode bloquear o resultado na linha de execução de vinculação que processa a solicitação. Em vez disso, recomendamos armazenar a solicitação em uma fila de solicitações e usar uma linha de execução de gerenciador separada para processar as solicitações de forma assíncrona. Consulte a Implementação de referência para mais detalhes.

Figura 1. Processo assíncrono.

Parcelables grandes

Todas as estruturas com o nome XXXs, como VehiclePropConfigs, SetValueRequests e VehiclePropValues, são chamadas de LargeParcelable (ou StableLargeParcelable). Cada uma representa uma lista de valores usados para transmitir dados grandes que podem exceder as limitações do binder (4 KB na implementação da biblioteca LargeParcelable) em limites de binder. Cada um tem uma definição de estrutura semelhante que contém os seguintes campos.

Por exemplo, VehiclePropConfigs é definido como:

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 contém payloads não vazios ou um sharedMemoryFd não nulo.

• Se payloads não estiver vazio, ele vai armazenar uma lista dos dados reais, que é a configuração da propriedade.
• Se sharedMemoryFd não for nulo, ele conterá um arquivo de memória compartilhada, que armazena a estrutura serializada de VehiclePropConfigs. A estrutura usa a função writeToParcel para serializar um pacote.

Como um cliente Java para VHAL, o Car Service processa a serialização e a desserialização de LargeParcelable. Para implementações de VHAL e clientes nativos, um LargeParcelable precisa ser serializado e desserializado com a biblioteca LargeParcelable ou uma classe de wrapper útil para a biblioteca em ParcelableUtils.h.

Por exemplo, uma análise de cliente nativo de solicitações de getValues recebidas de um vinculador é feita da seguinte maneira:

// '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.
}

Confira abaixo um exemplo de implementação do VHAL que envia resultados para getValues pelo vinculador:

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