Implémenter le service

Pour préparer l'implémentation de HAL, vous pouvez générer un code d'interface ConfigStore de base, puis le modifier pour répondre à vos besoins.

Générer du code d'interface

Pour générer le code récurrent de l'interface, exécutez hidl-gen. Par exemple, pour générer du code pour 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

Modifier Android.mk

Ensuite, modifiez le fichier Android.mk pour ajouter le fichier d'implémentation (<modulename>Configs.cpp) à LOCAL_SRC_FILES et pour mapper les indicateurs de compilation dans les définitions de macro. Par exemple, vous pouvez modifier surfaceflinger dans 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

Si Android.mk inclut plusieurs blocs ifeq-endif, envisagez de déplacer votre code dans un nouveau fichier (c'est-à-dire surfaceflinger.mk), puis d'inclure ce fichier à partir de Android.mk.

Implémenter des fonctions

Pour remplir les fonctions afin d'implémenter le HAL, rappelez la fonction _hidl_cb avec différentes valeurs (conditionnées par les indicateurs de compilation). Par exemple, vous pouvez remplir les fonctions de surfaceflinger dans 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
}

Assurez-vous que l'implémentation ne contient pas de fonction nommée HIDL_FETCH_interface-name (par exemple, HIDL_FETCH_ISurfaceFlingerConfigs). Cette fonction est nécessaire pour le mode pass-through HIDL, qui n'est pas utilisé (et est interdit) par configstore. ConfigStore doit toujours s'exécuter en mode binderisé.

S'inscrire en tant que service

Enfin, enregistrez toutes les implémentations d'interface auprès du service configstore. Par exemple, vous pouvez enregistrer les implémentations surfaceflinger dans 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();

Bénéficier d'un accès anticipé

Pour qu'un module de framework puisse accéder de manière anticipée au service HAL, le service HAL de configuration doit démarrer le plus tôt possible, juste après que hwservicemanager est prêt. Étant donné que le service HAL de configuration ne lit pas les fichiers externes, il devrait être prêt rapidement après son lancement.