创建 HAL 接口

您必须使用 HIDL 来描述用于对框架进行条件式编译的所有 build 标志。相关 build 标志必须分组并包含在单个 .hal 文件中。使用 HIDL 指定配置项具有以下优势:

  • 可实施版本控制(为了添加新配置项,供应商/OEM 必须明确扩展 HAL)
  • 记录详尽
  • 可使用 SELinux 实现访问控制
  • 可通过供应商测试套件对配置项进行健全性检查(范围检查、各项内容之间的相互依赖性检查等)
  • 在 C++ 和 Java 中自动生成 API

确定框架使用的 build 标志

首先,请确定用于对框架进行条件式编译的 build 配置,然后舍弃过时的配置,缩小 build 标志集的范围。例如,下列 build 标志集已确定用于 surfaceflinger

  • TARGET_USES_HWC2
  • TARGET_BOARD_PLATFORM
  • TARGET_DISABLE_TRIPLE_BUFFERING
  • TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
  • NUM_FRAMEBUFFER_SURFACE_BUFFERS
  • TARGET_RUNNING_WITHOUT_SYNC_FRAMEWORK
  • VSYNC_EVENT_PHASE_OFFSET_NS
  • SF_VSYNC_EVENT_PHASE_OFFSET_NS
  • PRESENT_TIME_OFFSET_FROM_VSYNC_NS
  • MAX_VIRTUAL_DISPLAY_DIMENSION

创建 HAL 接口

子系统的 build 配置是通过 HAL 接口访问的,而用于提供配置值的接口会在 HAL 软件包 android.hardware.configstore(目前为 1.0 版)中进行分组。例如,如需为 surfaceflinger 创建 HAL 接口文件,请在 hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal 中运行以下命令:

package android.hardware.configstore@1.0;

interface ISurfaceFlingerConfigs {
    // TO-BE-FILLED-BELOW
};

创建 .hal 文件后,请运行 hardware/interfaces/update-makefiles.sh,将新的 .hal 文件添加到 Android.bpAndroid.mk 文件中。

为构建标记添加函数

对于每个 build 标志,请向相应接口各添加一个新函数。例如,在 hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal 中:

interface ISurfaceFlingerConfigs {
    disableTripleBuffering() generates(OptionalBool ret);
    forceHwcForVirtualDisplays() generates(OptionalBool ret);
    enum NumBuffers: uint8_t {
        USE_DEFAULT = 0,
        TWO = 2,
        THREE = 3,
    };
    numFramebufferSurfaceBuffers() generates(NumBuffers ret);
    runWithoutSyncFramework() generates(OptionalBool ret);
    vsyncEventPhaseOffsetNs generates (OptionalUInt64 ret);
    presentTimeOffsetFromSyncNs generates (OptionalUInt64 ret);
    maxVirtualDisplayDimension() generates(OptionalInt32 ret);
};

添加函数时,请注意以下事项:

  • 采用简洁的名称。请避免将 makefile 变量名称转换为函数名称,并切记 TARGET_BOARD_ 前缀不再是必需的。
  • 添加注释。帮助开发者了解配置项的用途,配置项如何改变框架行为、有效值以及其他相关信息。

函数返回类型可以是 Optional[Bool|String|Int32|UInt32|Int64|UInt64]。类型会在同一目录中的 types.hal 中进行定义,并使用字段(可表明原始值是否是由 HAL 指定)来封装原始值;如果原始值不是由 HAL 指定,则使用默认值。

struct OptionalString {
    bool specified;
    string value;
};

在适当的情况下,请定义最能代表配置项类型的枚举,并将该枚举用作返回类型。在上述示例中,NumBuffers 枚举会被定义为限制有效值的数量。在定义此类自定义数据类型时,请添加字段或枚举值(例如 USE_DEFAULT)来表示该值是否由 HAL 指定。

在 HIDL 中,单个 build 标志并不一定要变成单个函数。模块所有者也可以将密切相关的 build 标志汇总为一个结构体,并通过某个函数返回该结构体(这样做可以减少函数调用的次数)。

例如,用于在 hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal 中将两个 build 标志汇总到单个结构体的选项如下:

 interface ISurfaceFlingerConfigs {
    // other functions here
    struct SyncConfigs {
        OptionalInt64 vsyncEventPhaseoffsetNs;
        OptionalInt64 presentTimeoffsetFromSyncNs;
    };
    getSyncConfigs() generates (SyncConfigs ret);
    // other functions here
};

单个 HAL 函数的替代函数

作为针对所有 build 标志使用单个 HAL 函数的替代函数,HAL 接口还提供了 getBoolean(string key)getInteger(string key) 等简单函数。实际的 key=value 对会存储在单独的文件中,而 HAL 服务会通过读取/解析这些文件来提供值。

虽然这种方法很容易定义,但它不具备 HIDL 提供的优势(强制实施版本控制、便于记录、实现访问控制),因此不推荐使用。

单个接口与多个接口

面向配置项设计的 HAL 接口提供了以下两种选择:

  • 单个接口;涵盖所有配置项
  • 多个接口;每个接口分别涵盖一组相关配置项

单个接口更易于使用,但随着更多的配置项添加到单个文件中,单个接口可能会越来越难以维护。此外,由于访问控制不够精细,获得接口访问权限的进程可能会读取所有配置项(无法授予对部分配置项的访问权限)。此外,如果未授予访问权限,则无法读取任何配置项。

由于存在这些问题,Android 会针对一组相关配置项将多个接口与单个 HAL 接口搭配使用。例如,对 surfaceflinger 相关配置项使用 ISurfaceflingerConfigs,对蓝牙相关配置项使用 IBluetoothConfigs 等等。