Interfaccia VHAL

Il VHAL AIDL è definito in android.hardware.automotive.vehicle namespace. L'interfaccia VHAL è definita in IVehicle.aidl. Se non specificato, tutti i metodi devono essere implementati per una versione VHAL specifica.

Versioni

È CONSIGLIATO implementare la versione VHAL più recente per una versione specifica di Android.

Funzioni e callback

Le funzioni VHAL sono definite in IVehicle.aidl.

I callback sono definiti in IVehicleCallback.aidl e contengono questi metodi.

L'implementazione di VHAL viene convalidata dal VTS VHAL all'indirizzo VtsHalAutomotiveVehicle_TargetTest.cpp.

Il test verifica che i metodi di base siano implementati correttamente e che le configurazioni delle proprietà supportate siano corrette. Il test viene eseguito su tutte le istanze VHAL sul dispositivo, ma AAOS utilizza solo l'istanza predefinita (android.hardware.automotive.vehicle.IVehicle/default)

Valore della proprietà del veicolo

Utilizza la struttura VehiclePropValue per descrivere il valore di ogni proprietà, che contiene i seguenti campi:

getValues e setValues asincroni

Le operazioni getValues e setValues vengono eseguite in modo asincrono, il che significa che la funzione potrebbe restituire un valore prima del completamento dell'operazione get o set effettiva. I risultati dell'operazione (ad esempio il valore della proprietà per getValues e lo stato di esito positivo o di errore per setValues) vengono trasmessi tramite i callback passati come argomenti.

L'implementazione non deve bloccarsi sul risultato nel thread del binder che gestisce la richiesta. Ti consigliamo invece di memorizzare la richiesta in una coda di richieste e di utilizzare un thread di gestore distinto per gestire le richieste in modo asincrono. Per maggiori dettagli, consulta la sezione Implementazione di riferimento.

Figura 1. Processo asincrono.

Parcelable di grandi dimensioni

Tutte le strutture denominate XXXs, ad esempio VehiclePropConfigs, SetValueRequests e VehiclePropValues, sono chiamate LargeParcelable (o StableLargeParcelable). Ognuna rappresenta un elenco di valori utilizzati per trasmettere dati di grandi dimensioni che potrebbero superare le limitazioni del binder (4 KB nell'implementazione della libreria LargeParcelable) oltre i confini del binder. Ognuno ha una definizione di struttura simile che contiene i seguenti campi.

Ad esempio, VehiclePropConfigs è definito come:

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 payload non vuoti o un valore non nullo sharedMemoryFd.

• Se payloads non è vuoto, memorizza un elenco dei dati effettivi, ovvero la configurazione della proprietà.
• Se sharedMemoryFd non è nullo, contiene un file di memoria condivisa che memorizza la struttura serializzata di VehiclePropConfigs. La struttura utilizza la funzione writeToParcel per serializzare un pacchetto.

In qualità di client Java per VHAL, Car Service gestisce la serializzazione e la deserializzazione per LargeParcelable. Per le implementazioni VHAL e i client nativi, un LargeParcelable deve essere serializzato e deserializzato con la libreria LargeParcelable o con una classe wrapper utile per la libreria in ParcelableUtils.h.

Ad esempio, un client nativo che analizza le richieste per getValues ricevute da un binder è il seguente:

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

Di seguito è riportata un'implementazione di VHAL di esempio che invia i risultati per getValues tramite il binder:

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