Antarmuka VHAL

VHAL AIDL ditentukan dalam android.hardware.automotive.vehicle namespace. Antarmuka VHAL ditentukan di IVehicle.aidl. Kecuali jika ditentukan, semua metode harus diterapkan untuk versi VHAL tertentu.

Versi

SEBAIKNYA terapkan versi VHAL terbaru untuk versi Android tertentu.

Fungsi dan callback

Fungsi VHAL ditentukan di IVehicle.aidl.

Callback ditentukan di IVehicleCallback.aidl dan berisi metode ini.

Penerapan VHAL divalidasi oleh VTS VHAL di VtsHalAutomotiveVehicle_TargetTest.cpp.

Pengujian ini memverifikasi bahwa metode dasar diterapkan dengan benar dan konfigurasi properti yang didukung sudah benar. Pengujian dijalankan terhadap semua instance VHAL di perangkat, tetapi AAOS hanya menggunakan instance default (android.hardware.automotive.vehicle.IVehicle/default)

Nilai properti kendaraan

Gunakan struktur VehiclePropValue untuk mendeskripsikan nilai setiap properti, yang memiliki kolom berikut:

getValues dan setValues asinkron

Operasi getValues dan setValues dilakukan secara asinkron, artinya fungsi dapat ditampilkan sebelum operasi get atau set yang sebenarnya selesai. Hasil operasi (misalnya, nilai properti untuk getValues dan status berhasil atau status error untuk setValues) dikirimkan melalui callback yang diteruskan sebagai argumen.

Penerapan tidak boleh memblokir hasil di thread binder yang menangani permintaan. Sebagai gantinya, sebaiknya simpan permintaan dalam antrean permintaan dan gunakan thread handler terpisah untuk menangani permintaan secara asinkron. Lihat Implementasi Referensi untuk detailnya.

Gambar 1. Proses asinkron.

Parcelable besar

Semua struktur yang bernama XXXs, seperti VehiclePropConfigs, SetValueRequests, dan VehiclePropValues disebut LargeParcelable (atau, StableLargeParcelable). Setiap struktur merepresentasikan daftar nilai yang digunakan untuk meneruskan data besar yang mungkin melampaui batasan binder (4 KB dalam implementasi library LargeParcelable) di seluruh batas binder. Setiap struktur definisi memiliki struktur yang serupa yang berisi kolom berikut.

Misalnya, VehiclePropConfigs ditentukan sebagai:

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 berisi payload yang tidak kosong atau sharedMemoryFd yang tidak null.

• Jika payloads tidak kosong, payloads akan menyimpan daftar data aktual, yaitu konfigurasi properti.
• Jika sharedMemoryFd tidak null, maka akan berisi file memori bersama, yang menyimpan struktur VehiclePropConfigs yang diserialkan. Struktur ini menggunakan fungsi writeToParcel untuk melakukan serialisasi Parcel.

Sebagai klien Java untuk VHAL, Car Service menangani serialisasi dan deserialisasi untuk LargeParcelable. Untuk penerapan VHAL dan klien native, LargeParcelable harus diserialisasi dan dideserialisasi dengan library LargeParcelable atau class wrapper yang berguna untuk library di ParcelableUtils.h.

Misalnya, permintaan penguraian klien native untuk getValues yang diterima dari binder adalah sebagai berikut:

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

Contoh penerapan VHAL yang mengirimkan hasil untuk getValues melalui binder ditampilkan di bawah:

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