实现服务

为了准备 HAL 实现,您可以先生成基本的 configstore 接口代码,然后再对其进行修改以满足自己的需求。

生成接口代码

要为接口生成样板代码,请运行 hidl-gen。 例如,要为 surfaceflinger 生成代码,请运行以下命令:

hidl-gen -o hardware/interfaces/configstore/1.0/default \
    -Lc++-impl \
    -randroid.hardware:hardware/interfaces \
    -randroid.hidl:system/libhidl/transport \
    android.hardware.config@1.0::ISurfaceFlingerConfigs

注意:请勿使用 -Landroidbp-impl 运行 hidl-gen,因为这会生成 Android.bp。该模块必须通过 Android.mk 进行编译才能访问编译标记。

修改 Android.mk

接下来,请修改 Android.mk 文件,以便将实现文件 (<modulename>Configs.cpp) 添加到 LOCAL_SRC_FILES 并将编译标记映射到宏定义中。例如,您可以在 hardware/interface/configstore/1.0/default/Android.mk 中运行以下命令来修改 surfaceflinger

LOCAL_SRC_FILES += SurfaceFlingerConfigs.cpp
ifneq ($(NUM_FRAMEBUFFER_SURFACE_BUFFERS),)
    LOCAL_CFLAGS += -DNUM_FRAMEBUFFER_SURFACE_BUFFERS=$(NUM_FRAMEBUFFER_SURFACE_BUFFERS)
endif

ifeq ($(TARGET_RUNNING_WITHOUT_SYNC_FRAMEWORK),true)
    LOCAL_CFLAGS += -DRUNNING_WITHOUT_SYNC_FRAMEWORK
endif

如果 Android.mk 包含几个 ifeq-endif 块,请考虑将代码移动到新文件(即 surfaceflinger.mk)中,然后从 Android.mk 中引用该文件。

实现函数

要填充函数以实现 HAL,请以不同的值回调 _hidl_cb 函数(以编译标记为条件)。例如,您可以在 hardware/interfaces/configstore/1.0/default/SurfaceFlingerConfigs.cpp 中填充 surfaceflinger 的函数:

Return<void> SurfaceFlingerConfigs::numFramebufferSurfaceBuffers(
        numFramebufferSurfaceBuffers_cb _hidl_cb) {
    #if NUM_FRAMEBUFFER_SURFACE_BUFFERS 2
    _hidl_cb(NumBuffers.TWO);
    #else if NUM_FRAMEBUFFER_SURFACE_BUFFERS 3
    _hidl_cb(NumBuffers.THREE);
    #else
    _hidl_cb(NumBuffers.USE_DEFAULT);
    #endif
}

Return<void> SurfaceFlingerConfigs::runWithoutSyncFramework(
        runWithoutSyncFramework_cb _hidl_cb) {
    #ifdef RUNNING_WITHOUT_SYNC_FRAMEWORK
    _hidl_cb({true /* specified */, true /* value */});
    #else
    // when macro not defined, we can give any value to the second argument.
    // It will simply be ignored in the framework side.
    _hidl_cb({false /* specified */, false /* value */});
    #endif
}

请确保该实现不包含名为 HIDL_FETCH_<interface name> 的函数(例如 HIDL_FETCH_ISurfaceFlingerConfigs)。这是 HIDL 直通模式所需的函数,configstore 不使用(且被禁止使用)该函数。ConfigStore 必须始终在绑定模式下运行。

注册为服务

最后,将所有接口实现注册为 configstore 服务。例如,您可以在 hardware/interfaces/configstore/1.0/default/service.cpp 中注册 surfaceflinger 实现:

configureRpcThreadpool(maxThreads, true);
sp<ISurfaceFlingerConfigs> surfaceFlingerConfigs = new SurfaceFlingerConfigs;
status_t status = surfaceFlingerConfigs->registerAsService();

sp<IBluetoothConfigs> bluetoothConfigs = new BluetoothConfigs;
status = bluetoothConfigs->registerAsService();

// register more interfaces here
joinRpcThreadpool();

确保可尽早访问

为了确保框架模块可以尽早访问· HAL 服务,config HAL 服务应该在 hwservicemanager 准备就绪之后尽早启动。由于配置 HAL 服务不会读取外部文件,因此在启动之后预计很快就能准备就绪。