转换 HAL 模块

转载：https://source.android.com/devices/architecture/hidl/converting?hl=zh-cn

您可以通过转换 hardware/libhardware/include/hardware 中的标头将预装的 HAL 模块更新为 HIDL HAL 模块。

使用 c2hal

c2hal 工具可处理大部分转换工作，从而减少所需进行的手动更改次数。例如，要为 NFC HAL 生成 HIDL .hal 文件，请使用以下命令：

make c2hal c2hal -r android.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport -p [email protected] hardware/libhardware/include/hardware/nfc.h

这些命令会在 hardware/interfaces/nfc/1.0/ 中添加文件。从 $ANDROID_BUILD_TOP 目录运行hardware/interfaces/update-makefiles.sh 还会向 HAL 添加所需的 makefile。在这里，您可以进行手动更改，以完全转换 HAL。

c2hal 操作

当您运行 c2hal 时，标头文件中的所有内容都会转移到 .hal 文件。

c2hal 会识别在提供的标头文件中包含函数指针的结构体，并将每个结构体转换为单独的接口文件。 例如，alloc_device_t 会转换为 IAllocDevice HAL 模块（位于文件 IAllocDevice.hal 中）。

所有其他数据类型都会复制到 types.hal 文件。 磅定义已移到枚举中，不属于 HIDL 的项或不可转换的项（例如静态函数声明）会复制到标记有文字“NOTE”的备注中。

手动操作

c2hal 工具在遇到某些构造时不知该如何应对。例如，HIDL 没有原始指针的概念；因此，当 c2hal 遇到标头文件中的指针时，不知道应将指针解读为数组还是对其他对象的引用。它同样不理解无类型指针。

在转换到 HIDL 期间，必须手动移除 int reserved[7] 等字段。应将返回值的名称等项更新为更有意义的内容；例如，将方法的返回参数（例如，NFC 中的 write）从自动生成的 int32_t write_ret 转换为 Status status（其中 Status 是包含可能的 NFC 状态的新枚举）。

实现 HAL

创建 .hal 文件以表示您的 HAL 后，您必须生成在 C++ 和 Java 中创建语言支持的 makefile（Make 或 Soong），除非 HAL 使用的功能在 Java 中不受支持。./hardware/interfaces/update-makefiles.sh 脚本可以为 hardware/interfaces目录中的 HAL 自动生成 makefile（对于其他位置的 HAL，只需更新脚本即可）。

如果 makefile 是最新版本，则表示您已准备好生成标头文件和实现方法了。要详细了解如何实现生成的接口，请参阅HIDL C++（用于 C++ 实现）或 HIDL Java（用于 Java 实现）。