Interfejs VHAL

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

Wersje

Zalecamy zaimplementowanie najnowszej wersji VHAL dla określonej wersji Androida.

Funkcje i wywołania zwrotne

Funkcje VHAL są zdefiniowane w IVehicle.aidl.

Wywołania zwrotne są zdefiniowane w IVehicleCallback.aidl i zawierają te metody.

Implementacja VHAL jest weryfikowana przez VHAL VTS w VtsHalAutomotiveVehicle_TargetTest.cpp.

Test sprawdza, czy podstawowe metody są prawidłowo zaimplementowane, a obsługiwane konfiguracje właściwości są prawidłowe. 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żywaj struktury VehiclePropValue do opisywania wartości każdej właściwości, która ma te pola:

Asynchroniczne getValues i setValues

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

Implementacja nie może blokować wyniku w wątku powiązań, 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ń. Więcej informacji 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 powiązań (4 KB w implementacji biblioteki LargeParcelable) przez granice powiązań. Każda z nich ma podobną definicję struktury, która zawiera te pola.

Na przykład VehiclePropConfigs jest zdefiniowany 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 niepusty element sharedMemoryFd.

• Jeśli payloads nie jest puste, przechowuje listę rzeczywistych danych, czyli konfigurację właściwości.
• Jeśli sharedMemoryFd nie jest puste, zawiera plik pamięci współdzielonej, który przechowuje serializowaną strukturę VehiclePropConfigs. Struktura używa funkcji writeToParcel do serializacji obiektu Parcel.

Jako klient Java VHAL usługa Car Service obsługuje serializację i deserializację dla LargeParcelable. W przypadku implementacji VHAL i klientów natywnych LargeParcelable należy serializować i deserializować za pomocą LargeParcelable biblioteki lub przydatnej klasy opakowującej bibliotekę w ParcelableUtils.h.

Na przykład klient natywny analizujący żądania getValues otrzymane z powiązania 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.
}

Poniżej znajdziesz przykładową implementację VHAL, która wysyła wyniki dla getValues za pomocą powiązania: pokazano 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.
}