為了準備 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/ surfaceflinger
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 服務,配置 HAL 服務應在hwservicemanager
準備就緒後儘早啟動。由於配置 HAL 服務不讀取外部文件,因此預計在啟動後會很快準備就緒。