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 関数をコールバックします。たとえば、次に示すように、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)が実装に含まれていないことを確認してください。これは、configstore では使用されない(禁止されている)HIDL パススルー モードで必要な関数です。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 サービスに早期アクセスできるようにするには、hwservicemanager の準備ができた直後に、できるだけ早く config HAL サービスを開始する必要があります。config HAL サービスは外部ファイルを読み込まないため、起動後すぐに準備できます。