Convertendo Módulos HAL

Você pode atualizar módulos HAL pré-existentes para módulos HIDL HAL convertendo o cabeçalho em hardware/libhardware/include/hardware .

Usando c2hal

A ferramenta c2hal lida com a maior parte do trabalho de conversão, reduzindo o número de alterações manuais necessárias. Por exemplo, para gerar um arquivo HIDL .hal para o 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

Esses comandos adicionam arquivos em hardware/interfaces/nfc/1.0/ . A execução hardware/interfaces/update-makefiles.sh do diretório $ANDROID_BUILD_TOP também adicionará o makefile necessário ao HAL. A partir daqui, você pode fazer alterações manuais para converter totalmente o HAL.

atividades c2hal

Quando você executa c2hal , tudo no arquivo de cabeçalho é transferido para arquivos .hal .

c2hal identifica structs que contêm ponteiros de função no arquivo de cabeçalho fornecido e converte cada struct em um arquivo de interface separado. Por exemplo, alloc_device_t é convertido para o módulo IAllocDevice HAL (no arquivo IAllocDevice.hal ).

Todos os outros tipos de dados são copiados para um arquivo types.hal . As definições de libra são movidas para enums e os itens que não fazem parte do HIDL ou não são conversíveis (como declarações de função estática) são copiados em comentários marcados com o texto " NOTE ".

Atividades manuais

A ferramenta c2hal não sabe o que fazer quando encontra certas construções. Por exemplo, HIDL não tem o conceito de ponteiros brutos; por causa disso, quando c2hal encontra um ponteiro em arquivos de cabeçalho, ele não sabe se o ponteiro deve ser interpretado como um array ou como uma referência a outro objeto. Ponteiros vazios também são igualmente opacos.

Campos como int reserved[7] devem ser removidos manualmente durante a transição para HIDL. Itens como o nome do valor de retorno devem ser atualizados para algo mais significativo; por exemplo, convertendo o parâmetro de retorno de métodos como write in NFC do int32_t write_ret automaticamente para Status status (onde Status é um novo enum contendo possíveis status NFC).

Implementação do HAL

Depois de criar os arquivos .hal para representar seu HAL, você deve gerar os makefiles (Make ou Soong) que criam o suporte à linguagem em C++ e Java (a menos que o HAL use um recurso não suportado em Java). O script ./hardware/interfaces/update-makefiles.sh pode gerar automaticamente makefiles para HALs localizados no diretório hardware/interfaces (para HALs em outros locais, basta atualizar o script).

Quando os makefiles estiverem atualizados, você estará pronto para gerar arquivos de cabeçalho e implementar métodos. Para obter detalhes sobre como implementar a interface gerada, consulte HIDL C++ (para implementações de C++) ou HIDL Java (para implementações de Java).