VHAL arayüzü

AIDL VHAL, android.hardware.automotive.vehicle namespace içinde tanımlanır. VHAL arayüzü IVehicle.aidl adresinde tanımlanmıştır. Belirtilmediği sürece tüm yöntemler belirli bir VHAL sürümü için uygulanmalıdır.

Sürümler

Belirli bir Android sürümü için en yeni VHAL sürümünün uygulanması ÖNERİLİR.

İşlevler ve geri çağırmalar

VHAL işlevleri IVehicle.aidl adresinde tanımlanır.

Geri çağırmalar IVehicleCallback.aidl içinde tanımlanır ve şu yöntemleri içerir.

VHAL uygulaması, VtsHalAutomotiveVehicle_TargetTest.cpp adresindeki VHAL VTS tarafından doğrulanır.

Test, temel yöntemlerin doğru şekilde uygulandığını ve desteklenen mülk yapılandırmalarının doğru olduğunu doğrular. Test, cihazdaki tüm VHAL örneklerine karşı çalıştırılır ancak AAOS yalnızca varsayılan örneği (android.hardware.automotive.vehicle.IVehicle/default) kullanır.

Araç özelliği değeri

Her özelliğin değerini açıklamak için aşağıdaki alanlara sahip olan VehiclePropValue yapısını kullanın:

Eşzamansız getValues ve setValues

getValues ve setValues işlemleri eşzamansız olarak gerçekleştirilir. Bu nedenle, işlev, gerçek get veya set işlemi tamamlanmadan önce döndürülebilir. İşlem sonuçları (ör. getValues için mülk değeri ve setValues için başarılı veya hata durumu) bağımsız değişken olarak iletilen geri çağırmalar aracılığıyla sağlanır.

Uygulama, isteği işleyen bağlayıcı iş parçacığındaki sonucu engellememelidir. Bunun yerine, isteği bir istek kuyruğunda saklamanızı ve istekleri eşzamansız olarak işlemek için ayrı bir işleyici iş parçacığı kullanmanızı öneririz. Ayrıntılar için Referans Uygulaması'na bakın.

1. şekil. Eşzamansız işlem.

Büyük ayrıştırılabilir öğeler

XXXs olarak adlandırılan tüm yapılar (ör. VehiclePropConfigs, SetValueRequests ve VehiclePropValues) LargeParcelable (veya StableLargeParcelable) olarak adlandırılır. Her biri, bağlayıcı sınırlamalarını (LargeParcelable kitaplığı uygulamasında 4 KB) aşabilecek büyük verileri bağlayıcı sınırları arasında iletmek için kullanılan bir değer listesini temsil eder. Her birinin benzer bir yapı tanımı vardır ve bu tanım aşağıdaki alanları içerir.

Örneğin, VehiclePropConfigs şu şekilde tanımlanır:

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, boş olmayan yükler veya boş olmayan bir sharedMemoryFd içerir.

• payloads boş değilse gerçek verilerin listesini (özellik yapılandırması) depolar.
• sharedMemoryFd boş değilse VehiclePropConfigs öğesinin serileştirilmiş yapısını depolayan bir paylaşılan bellek dosyası içerir. Yapı, bir paketi serileştirmek için writeToParcel işlevini kullanır.

VHAL için bir Java istemcisi olarak Car Service, LargeParcelable için serileştirme ve seri durumdan çıkarma işlemlerini gerçekleştirir. VHAL uygulamaları ve yerel istemciler için LargeParcelable, LargeParcelable kitaplığı veya ParcelableUtils.h içindeki kitaplık için yararlı bir sarmalayıcı sınıf ile serileştirilmeli ve seri durumdan çıkarılmalıdır.

Örneğin, bir bağlayıcıdan alınan getValues için istekleri ayrıştıran bir yerel istemci aşağıdaki gibi olabilir:

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

Aşağıda, getValues için sonuçları bağlayıcı üzerinden gönderen örnek bir VHAL uygulaması gösterilmektedir:

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