Interface VHAL

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

Versions

Nous vous RECOMMANDONS d'implémenter la dernière version de VHAL pour une version d'Android spécifique.

Fonctions et rappels

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

Les rappels sont définis à l'emplacement IVehicleCallback.aidl et contiennent ces méthodes.

L'implémentation de 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é compatibles sont correctes. Le test s'exécute sur toutes les instances VHAL de l'appareil. Toutefois, 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 être renvoyée avant la fin de l'opération d'obtention ou de définition. 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 transmis via les rappels transmis en tant qu'arguments.

L'implémentation ne doit pas bloquer sur le résultat dans le thread de liaison qui gère la requête. Nous vous recommandons plutôt de stocker la requête dans une file d'attente de requêtes et d'utiliser un thread de gestionnaire distinct pour gérer les requêtes de manière asynchrone. Pour en savoir plus, consultez la section 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 données qui peuvent dépasser les limites du liaisonneur (4 ko dans l'implémentation de la bibliothèque LargeParcelable) au-delà des limites du liaisonneur. Chacune d'elles 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 est 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 de wrapper utile pour la bibliothèque dans ParcelableUtils.h.

Par exemple, un client natif analysant les requêtes pour getValues reçues d'un liant est le suivant:

// '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 de VHAL qui envoie des résultats pour getValues via le liaisonneur:

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