Interfejs AIDL VHAL

AIDL VHAL jest zdefiniowany w android.hardware.automotive.vehicle namespace. Interfejs VHAL jest zdefiniowany na stronie IVehicle.aidl. O ile nie określono inaczej, wszystkie metody muszą być zaimplementowane w określonej wersji VHAL.

Wersje

ZALECAMY wdrożenie najnowszej wersji VHAL dla konkretnej wersji Androida.

Funkcje i wywołania zwrotne

Funkcje VHAL są zdefiniowane na stronie IVehicle.aidl.

Funkcje zwrotne są zdefiniowane w IVehicleCallback.aidl i zawierają te metody.

Implementacja VHAL jest weryfikowana przez VHAL VTS na stronie VtsHalAutomotiveVehicle_TargetTest.cpp.

Test sprawdza, czy podstawowe metody są prawidłowo zaimplementowane, a obsługiwane konfiguracje usługi są poprawne. Test jest przeprowadzany na wszystkich instancjach VHAL na urządzeniu, ale AAOS używa tylko instancji domyślnej (android.hardware.automotive.vehicle.IVehicle/default).

Wartość właściwości pojazdu

Użyj struktury VehiclePropValue, aby opisać wartość każdej właściwości. Struktura ta zawiera te pola:

Asynchroniczne metody getValues i setValues

Operacje getValues i setValues są wykonywane asynchronicznie, co oznacza, że funkcja może zwrócić wartość przed zakończeniem rzeczywistej operacji pobierania lub ustawiania. Wyniki operacji (np. wartość właściwości dla getValues i stan powodzenia lub błędu dla setValues) są przekazywane za pomocą wywołań zwrotnych przekazywanych jako argumenty.

Implementacja nie może blokować wyniku w wątku powiązanym, który obsługuje żądanie. Zamiast tego zalecamy przechowywanie żądania w kolejce żądań i używanie osobnego wątku obsługi do asynchronicznego obsługiwania żądań. Szczegółowe informacje znajdziesz w implementacji referencyjnej.

Rysunek 1. Proces asynchroniczny.

Duże obiekty Parcelable

Wszystkie struktury o nazwie XXXs, takie jak VehiclePropConfigs, SetValueRequests i VehiclePropValues, są nazywane LargeParcelable (lub StableLargeParcelable). Każda z nich reprezentuje listę wartości używanych do przekazywania dużych ilości danych, które mogą przekraczać ograniczenia modułu Binder (4 KB w implementacji biblioteki LargeParcelable), przez granice modułu Binder. Każda z nich ma podobną definicję struktury, która zawiera te pola:

Na przykład VehiclePropConfigs jest zdefiniowane jako:

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 zawiera niepuste ładunki lub niepustą wartość sharedMemoryFd.

• Jeśli payloads nie jest pusta, przechowuje listę rzeczywistych danych, czyli konfigurację usługi.
• Jeśli sharedMemoryFd nie jest wartością null, zawiera plik pamięci współdzielonej, w którym jest przechowywana serializowana struktura VehiclePropConfigs. Struktura używa funkcji writeToParcel do serializacji obiektu Parcel.

Jako klient VHAL w języku Java usługa Car Service obsługuje serializację i deserializację dla LargeParcelable. W przypadku implementacji VHAL i klientów natywnych element LargeParcelable powinien być serializowany i deserializowany za pomocą biblioteki LargeParcelable lub przydatnej klasy opakowującej dla biblioteki w ParcelableUtils.h.

Na przykład klient natywny analizujący żądania dotyczące getValues otrzymane z bindera wygląda tak:

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

Przykładowe wdrożenie VHAL, które wysyła wyniki dla getValues za pomocą bindera, jest pokazane poniżej:

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