Interface VHAL

L'AIDL VHAL est défini dans android.hardware.automotive.vehicle namespace. L'interface VHAL est définie sur IVehicle.aidl. Sauf indication contraire, toutes les méthodes doivent être implémentées pour une version VHAL spécifique.

Versions

Il est RECOMMANDÉ d'implémenter la dernière version de VHAL pour une version Android spécifique.

Fonctions et rappels

Les fonctions VHAL sont définies sur IVehicle.aidl.

Les rappels sont définis sur IVehicleCallback.aidl et contiennent ces méthodes.

L'implémentation VHAL est validée par le VTS VHAL à l'adresse VtsHalAutomotiveVehicle_TargetTest.cpp.

Le test vérifie que les méthodes de base sont implémentées correctement et que les configurations de propriétés compatibles sont correctes. Le test s'exécute sur toutes les instances VHAL de l'appareil, mais AAOS n'utilise que l'instance par défaut (android.hardware.automotive.vehicle.IVehicle/default).

Valeur de la propriété du véhicule

Utilisez la structure VehiclePropValue pour décrire la valeur de chaque propriété, qui comporte les champs suivants :

getValues et setValues asynchrones

Les opérations getValues et setValues sont effectuées de manière asynchrone, ce qui signifie que la fonction peut renvoyer des données avant la fin de l'opération get ou set. Les résultats de l'opération (par exemple, la valeur de la propriété pour getValues et l'état de réussite ou d'erreur pour setValues) sont fournis par le biais des rappels transmis en tant qu'arguments.

L'implémentation ne doit pas bloquer le résultat dans le thread Binder qui gère la requête. Nous vous recommandons plutôt de stocker la requête dans une file d'attente et d'utiliser un thread de gestionnaire distinct pour traiter les requêtes de manière asynchrone. Pour en savoir plus, consultez l'implémentation de référence.

Figure 1 : Processus asynchrone.

Parcelables volumineux

Toutes les structures nommées XXXs, telles que VehiclePropConfigs, SetValueRequests et VehiclePropValues, sont appelées LargeParcelable (ou StableLargeParcelable). Chacune représente une liste de valeurs utilisées pour transmettre de grandes quantités de données qui peuvent dépasser les limites du binder (4 ko dans l'implémentation de la bibliothèque LargeParcelable) au-delà des limites du binder. Chacun d'eux a une définition de structure similaire qui contient les champs suivants.

Par exemple, VehiclePropConfigs est défini comme suit :

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 contient des charges utiles non vides ou un sharedMemoryFd non nul.

• Si payloads n'est pas vide, il stocke une liste des données réelles, qui correspond à la configuration de la propriété.
• Si sharedMemoryFd n'est pas nul, il contient un fichier de mémoire partagée qui stocke la structure sérialisée de VehiclePropConfigs. La structure utilise la fonction writeToParcel pour sérialiser un Parcel.

En tant que client Java pour VHAL, Car Service gère la sérialisation et la désérialisation pour LargeParcelable. Pour les implémentations VHAL et les clients natifs, un LargeParcelable doit être sérialisé et désérialisé avec la bibliothèque LargeParcelable ou une classe wrapper utile pour la bibliothèque dans ParcelableUtils.h.

Par exemple, un client natif qui analyse les requêtes pour getValues reçues d'un binder se présente comme suit :

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

Vous trouverez ci-dessous un exemple d'implémentation VHAL qui envoie les résultats pour getValues via le binder :

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