Antarmuka VHAL

VHAL AIDL ditentukan di 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 memverifikasi bahwa metode dasar diterapkan dengan benar dan konfigurasi properti yang didukung sudah benar. Pengujian berjalan pada 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 setiap nilai properti, yang memiliki kolom berikut:

getValues dan setValues asinkron

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

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

Gambar 1. Proses asinkron.

Parcelable besar

Semua struktur yang bernama XXXs, seperti VehiclePropConfigs, SetValueRequests, dan VehiclePropValues disebut LargeParcelable (atau, StableLargeParcelable). Masing-masing mewakili daftar nilai yang digunakan untuk meneruskan data besar yang mungkin melebihi batasan binder (4 KB dalam implementasi library LargeParcelable) di seluruh batas binder. Masing-masing memiliki definisi struktur 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 non-null.

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

Sebagai klien Java untuk VHAL, Layanan Mobil menangani serialisasi dan deserialisasi untuk LargeParcelable. Untuk implementasi 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 implementasi VHAL yang mengirim hasil untuk getValues melalui binder ditampilkan di bawah ini:

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