Android Automotive OS (AAOS) содержит общие свойства VHAL, которые можно просмотреть в окне VHAL эмулятора. В результате вы можете просмотреть множество информации о VHAL, включая имена, описания и значения значений. Информация извлекается из метаданных свойств VHAL, которые жестко закодированы в эмуляторе QEMU .
Когда вы добавляете свои собственные свойства VHAL для эксклюзивного использования на своих устройствах, для просмотра метаданных VHAL в окне VHAL вам потребуется изменить код и создать собственный эмулятор QEMU. Чтобы обойти эту проблему, вы можете написать свои собственные описания в формате JSON и добавить их в образ вашей системы.
Обзор
На этой странице подробно описано, как можно расширить описания свойств VHAL в эмуляторе AAOS.
Создайте метаданные JSON для расширения свойств VHAL.
Эмулятор ищет дополнительные метаданные во всех файлах, заканчивающихся на -types-meta.json в пути к виртуальному устройству Android (AVD). Ожидается, что файлы JSON будут состоять из массива объектов Enum , как показано ниже.
Объект перечисления
Объект Enum с именем VehicleProperty — это особый случай, в котором его можно рассматривать как корень. Его содержимое добавляется на карту свойств автомобиля. Другие Enums (с именем, отличным от VehicleProperty ) определяют карты имен пользовательских значений.
Enum: {
"name" : String,
"values" : Array of { ValueObject }
}
ValueObject
ValueObject: {
"name" : String,
"value" : Integer,
"data_enum" : String, VehicleProperty only, optional,
}
Для VehicleProperty имя Enum описывает, как это свойство отображается в окне VHAL эмулятора. Значением является property_id свойства, описанного ValueObject . data_enum связывает ValueObject с другим Enum . Эта ассоциация используется для преобразования значения в удобочитаемую строку и существует только для ValueObjects в Enum для VehicleProperty . Пример VehicleProperty показан ниже:
[
{
"name": "VehicleProperty",
"values": [
{
"name": "CURRENT_GEAR",
"value": 289408001
}
]
}
]
В этом примере property_id со value 289408001 предоставляется в качестве name для CURRENT_GEAR . В эмуляторе это свойство уже жестко запрограммировано как имя Current Gear . (Вы не можете воспроизвести этот сценарий, поскольку эта страница была создана после удаления всех жестко запрограммированных свойств в демонстрационных целях.)
Рисунок 1. VehicleProperty, определенный с именем и значением.
На вкладке свойств VHAL эмулятора имя обновляется и становится CURRENT_GEAR , как и ожидалось.
data_enum
В приведенном выше примере отображаемое значение равно 4, когда передача установлена на P.
Рисунок 2. Значение отображается как 4.
Как и предполагалось, на вкладке «Свойства VHAL» в эмуляторе имя отображается как CURRENT_GEAR . В этом отличие от существующего эмулятора, где он отображается как P.
enum VehicleGear {
GEAR_UNKNOWN = 0x0000,
GEAR_NEUTRAL = 0x0001,
GEAR_REVERSE = 0x0002,
GEAR_PARK = 0x0004,
GEAR_DRIVE = 0x0008,
GEAR_1 = 0x0010,
GEAR_2 = 0x0020,
GEAR_3 = 0x0040,
GEAR_4 = 0x0080,
GEAR_5 = 0x0100,
GEAR_6 = 0x0200,
GEAR_7 = 0x0400,
GEAR_8 = 0x0800,
GEAR_9 = 0x1000,
}
Чтобы узнать больше, см. определение AIDL .
Как определено в AIDL, значение механизма парковки равно 4 , что означает, что вам необходимо перевести значение 4 в P. Это когда вы используете data_enum , который сопоставляет значение этого свойства с удобочитаемой строкой в другом Enum . Эмулятор использует эту карту для перевода значений свойств. Например:
[
{
"name": "VehicleProperty",
"values": [
{
"name": "CURRENT_GEAR",
"value": 289408001,
"data_enum": "VehicleGear"
}
]
},
{
"name": "VehicleGear",
"values": [
{
"name": "GEAR_UNKNOWN",
"value": 0
},
{
"name": "GEAR_PARK",
"value": 4
}
]
}
]
Добавьте "data_enum": "VehicleGear" , чтобы эмулятор использовал Enum с именем VehicleGear для перевода значения свойства. Добавьте еще один Enum с именем VehicleGear , значение которого представляет собой массив ValueObject , где значение свойства (со значением) должно отображаться как имя.
Рисунок 3. Значение отображается как GEAR_PARK.
На вкладке «Свойства VHAL» для эмулятора имя обновляется и становится CURRENT_GEAR , как и ожидалось. Значение свойства 4 отображается как GEAR_PARK .
Используйте метаданные JSON для расширения свойств VHAL.
Чтобы использовать метаданные JSON для расширения свойств VHAL, запустите этот сценарий Python (содержащийся в исходном коде Android), чтобы сгенерировать JSON расширенного свойства на основе информации в AIDL.
Результирующий JSON включает в себя некоторые избыточные значения, такие change_mode , access и unit . Хотя эта информация является частью свойства VHAL, эти значения JSON не влияют на то, что отображается в окне свойств VHAL эмулятора.
Добавьте метаданные JSON в образ системы
Помните, что имя файла должно заканчиваться на -types-meta.json . В противном случае файл игнорируется.
Добавить цель сборки
Добавьте файл -types-meta.json в PRODUCT_COPY_FILE . Например:
PRODUCT_COPY_FILES += \
device/generic/car/common/vehicle-types-meta.json:vehicle-types-meta.json
Этот код копирует файл в out/target/product/{your_target_path}/ , корень созданного вами целевого вывода.