Вы можете обновить существующие модули HAL до модулей HIDL HAL, преобразовав заголовок в hardware/libhardware/include/hardware .
Использовать c2hal
Инструмент c2hal выполняет большую часть работы по конвертации, сокращая количество требуемых ручных изменений. Например, чтобы сгенерировать файл HIDL .hal для NFC HAL:
make c2hal
c2hal -r android.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport -p android.hardware.nfc@1.0 hardware/libhardware/include/hardware/nfc.h
Эти команды добавляют файлы в hardware/interfaces/nfc/1.0/ . Запуск hardware/interfaces/update-makefiles.sh из каталога $ANDROID_BUILD_TOP также добавляет требуемый makefile в HAL. Отсюда вы можете вручную вносить изменения, чтобы полностью преобразовать HAL.
c2hal деятельность
При запуске c2hal все содержимое заголовочного файла переносится в файлы .hal .
c2hal идентифицирует структуры, содержащие указатели функций в предоставленном заголовочном файле, и преобразует каждую структуру в отдельный файл интерфейса. Например, alloc_device_t преобразуется в модуль HAL IAllocDevice (в файле IAllocDevice.hal ).
Все остальные типы данных копируются в файл types.hal . Определения фунта перемещаются в перечисления, а элементы, не являющиеся частью HIDL или не подлежащие конвертации (например, объявления статических функций), копируются в комментарии, помеченные текстом " NOTE ".
Ручная деятельность
Инструмент c2hal не знает, что делать, когда он сталкивается с определенными конструкциями. Например, в HIDL нет концепции необработанных указателей; из-за этого, когда c2hal сталкивается с указателем в заголовочных файлах, он не знает, следует ли интерпретировать указатель как массив или как ссылку на другой объект. Пустые указатели также являются непрозрачными.
Поле, такое как int reserved[7] должно быть вручную удалено при переходе на HIDL. Такие элементы, как имя возвращаемого значения, должны быть обновлены на что-то более осмысленное; например, преобразование возвращаемого параметра методов, таких как write в NFC, из автоматически сгенерированного int32_t write_ret в Status status (где Status — это новое перечисление, содержащее возможные статусы NFC).
Внедрить HAL
После создания файлов .hal для представления вашего HAL, вы должны сгенерировать make-файлы (Make или Soong), которые создают поддержку языка в C++ и Java (если только HAL не использует функцию, не поддерживаемую в Java). Скрипт ./hardware/interfaces/update-makefiles.sh может автоматически генерировать make-файлы для HAL, расположенных в каталоге hardware/interfaces (для HAL в других местах просто обновите скрипт).
Когда makefiles обновлены, вы готовы генерировать файлы заголовков и реализовывать методы. Подробности реализации сгенерированного интерфейса см. в HIDL C++ (для реализаций C++) или HIDL Java (для реализаций Java).