VHAL arayüzü

AIDL VHAL, android.hardware.automotive.vehicle namespace içinde tanımlanır. VHAL arayüzü IVehicle.aidl adresinde tanımlanı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 son VHAL sürümünün uygulanması ÖNERİLİR.

İşlevler ve geri çağırma işlevleri

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

Geri çağırma işlevleri IVehicleCallback.aidl bölümünde tanımlanır ve bu yöntemleri içerir.

VHAL uygulaması, VtsHalAutomotiveVehicle_TargetTest.cpp tarihinde VHAL VTS tarafından doğrulandı.

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ışır ancak AAOS yalnızca varsayılan örneği (android.hardware.automotive.vehicle.IVehicle/default) kullanır.

Araç özelliği değeri

Her bir mülkün değerini açıklamak için şu alanları içeren 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, işlevin gerçek alma veya ayarlama işlemi tamamlanmadan önce döndürülebileceği anlamına gelir. İşlem sonuçları (örneğin, getValues için mülk değeri ve setValues için başarı veya hata durumu), bağımsız değişken olarak iletilen geri çağırma işlevleri aracılığıyla sağlanır.

Uygulama, isteği işleyen bağlayıcı iş parçacığındaki sonuçta tıkanıklık oluşturmamalıdır. 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 Uygulama bölümüne bakın.

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

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

VehiclePropConfigs, SetValueRequests ve VehiclePropValues gibi XXXs adlı tüm yapılar LargeParcelable (veya StableLargeParcelable) olarak adlandırılır. Her biri, bağlayıcı sınırları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 aşağıdaki alanları içeren benzer bir yapı tanımı vardır.

Ö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ük verileri veya null olmayan bir sharedMemoryFd içeriyor.

• payloads boş değilse mülk yapılandırması olan gerçek verilerin listesini depolar.
• sharedMemoryFd null değilse VehiclePropConfigs değerinin serileştirilmiş yapısını depolayan bir paylaşılan hafıza dosyası içerir. Yapı, bir paketi serileştirmek için writeToParcel işlevini kullanır.

VHAL için Java istemcisi olan Car Service, LargeParcelable için serileştirme ve seri bozma işlemlerini yönetir. VHAL uygulamaları ve yerel istemciler için LargeParcelable, LargeParcelable kitaplığı veya ParcelableUtils.h'teki kitaplık için kullanışlı bir sarmalayıcı sınıfıyla serileştirilmeli ve seri dışına çıkarılmalıdır.

Örneğin, bir bağlayıcıdan alınan getValues isteklerini ayrıştıran yerel istemci aşağıdaki gibidir:

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

Bağlayıcı üzerinden getValues sonuçları gönderen örnek bir VHAL uygulaması aşağıda gösterilmiştir:

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