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 ​​выполняются асинхронно, это означает, что функция может завершиться до того, как будет выполнена фактическая операция получения или установки значения. Результаты операций (например, значение свойства для 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.

В качестве 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.
}