VHAL-интерфейс

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

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

Дополнительные сведения см. в разделах IVehicle.aidl и IVehicleCallback.aidl .

Реализация VHAL проверяется VHAL VTS по адресу VtsHalAutomotiveVehicle_TargetTest.cpp . Тест проверяет правильность реализации основных методов и правильность поддерживаемых конфигураций свойств.

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

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

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

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

// 'requests' are from the binder.
GetValueRequests requests;
expected, 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.
}