Para se preparar para a implementação da HAL, gere um código básico da interface ConfigStore e modifique-o de acordo com suas necessidades.
Gerar código de interface
Para gerar código boilerplate para a interface, execute hidl-gen.
Por exemplo, para gerar código para 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
Modificar o Android.mk
Em seguida, modifique o arquivo Android.mk para adicionar o arquivo de implementação
(<modulename>Configs.cpp) a LOCAL_SRC_FILES e
mapear flags de build em definições de macro. Por exemplo, é possível modificar
surfaceflinger em
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
Se Android.mk incluir vários blocos ifeq-endif,
considere mover o código para um novo arquivo (ou seja,
surfaceflinger.mk) e inclua esse arquivo de
Android.mk.
Implementar funções
Para preencher as funções e implementar o HAL, chame de volta a
função _hidl_cb com valores diferentes (condicionados a flags
de build). Por exemplo, é possível preencher as funções de surfaceflinger
em
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
}
Verifique se a implementação não contém uma função chamada
HIDL_FETCH_interface-name (por exemplo,
HIDL_FETCH_ISurfaceFlingerConfigs). Essa função é necessária para o
modo de transferência direta do HIDL, que não é usado (e é proibido) pelo
configstore. O ConfigStore precisa sempre ser executado no modo binderizado.
Registrar como um serviço
Por fim, registre todas as implementações de interface no serviço
configstore. Por exemplo, é possível registrar implementações de
surfaceflinger em
hardware/interfaces/configstore/1.0/default/service.cpp:
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();
Garantir o acesso antecipado
Para garantir que um módulo de framework possa ter acesso antecipado ao serviço HAL, o serviço HAL de configuração precisa ser iniciado o mais cedo possível, logo após hwservicemanager estar pronto. Como o serviço HAL de configuração não lê arquivos externos, ele deve ficar pronto rapidamente após o lançamento.