如要準備實作 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,並將建構標記對應至巨集定義。舉例來說,您可以在 surfaceflinger 中修改 surfaceflinger:hardware/interface/configstore/1.0/default/Android.mk
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 函式 (以建構標記為條件)。舉例來說,您可以在 surfaceflinger 中填入 hardware/interfaces/configstore/1.0/default/SurfaceFlingerConfigs.cpp 的函式:
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 服務不會讀取外部檔案,因此啟動後應會很快就緒。