VHAL-интерфейс

Интерфейс VHAL AIDL определён в android.hardware.automotive.vehicle namespace . Интерфейс VHAL определён в IVehicle.aidl . Если не указано иное, все методы должны быть реализованы для конкретной версии VHAL.

Версии

РЕКОМЕНДУЕТСЯ реализовать последнюю версию VHAL для конкретной версии Android.

Функции и обратные вызовы

Функции VHAL определены в IVehicle.aidl .

Обратные вызовы определены в IVehicleCallback.aidl и содержат эти методы.

Реализация VHAL проверена VHAL VTS в VtsHalAutomotiveVehicle_TargetTest.cpp .

Тест проверяет корректность реализации базовых методов и корректность поддерживаемых конфигураций свойств. Тест выполняется для всех экземпляров VHAL на устройстве, однако AAOS использует только экземпляр по умолчанию ( android.hardware.automotive.vehicle.IVehicle/default ).

Стоимость имущества транспортного средства

Используйте структуру VehiclePropValue для описания значения каждого свойства, которое имеет следующие поля:

Асинхронные getValues ​​и setValues

Операции getValues ​​и setValues ​​выполняются асинхронно, то есть функция может завершиться до завершения самой операции get или set. Результаты операции (например, значение свойства для getValues ​​и статус успеха или ошибки для setValues ) передаются через обратные вызовы, передаваемые в качестве аргументов.

Реализация не должна блокировать результат в потоке связывателя, обрабатывающем запрос. Вместо этого мы рекомендуем сохранять запрос в очереди запросов и использовать отдельный поток-обработчик для асинхронной обработки запросов. Подробности см. в справочной реализации .

Рисунок 1. Асинхронный процесс.

Большие посылки

Все структуры с именем XXXs , такие как VehiclePropConfigs , SetValueRequests и VehiclePropValues ​​, называются LargeParcelable (или StableLargeParcelable ). Каждая из них представляет собой список значений, используемых для передачи больших объёмов данных, которые могут превышать ограничения связывателя (4 КБ в реализации библиотеки LargeParcelable ) через границы связывателя. Каждая из них имеет схожее определение структуры, содержащее следующие поля.

Например, VehiclePropConfigs определяется как:

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 содержит либо непустые полезные данные, либо ненулевой sharedMemoryFd .

• Если payloads не пусты, в них хранится список фактических данных, представляющий собой конфигурацию свойств.
• Если sharedMemoryFd не равно NULL, он содержит файл общей памяти, в котором хранится сериализованная структура VehiclePropConfigs . Эта структура использует функцию writeToParcel для сериализации Parcel.

Car Service, как Java-клиент для VHAL, выполняет сериализацию и десериализацию LargeParcelable . Для реализаций VHAL и нативных клиентов LargeParcelable следует сериализовать и десериализовать с помощью библиотеки LargeParcelable или удобного класса-обёртки для этой библиотеки в ParcelableUtils.h .

Например, собственный клиент, анализирующий запросы на getValues полученные от связующего компонента, выглядит следующим образом:

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

Ниже показан пример реализации VHAL, которая отправляет результаты для getValues ​​через связующее звено:

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