VHAL-интерфейс

AIDL VHAL определен в 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 не равен нулю, он содержит файл общей памяти, в котором хранится сериализованная структура VehiclePropConfigs . Структура использует функцию writeToParcel для сериализации Parcel.

Как клиент Java для VHAL, Car Service обрабатывает сериализацию и десериализацию для 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.
}