为了准备 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
修改 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 准备就绪之后。由于 config HAL 服务不读取外部文件,因此预计在启动后会很快准备就绪。