Implémenter le service

Pour préparer l'implémentation du HAL, vous pouvez générer le code de l'interface ConfigStore de base, puis le modifier en fonction de vos besoins.

Générer le code d'interface

Pour générer du code récurrent pour l'interface, exécutez hidl-gen. Par exemple, afin de 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 incluez ce fichier à partir de Android.mk.

Implémenter des fonctions

Pour remplir les fonctions permettant d'implémenter le HAL, rappelez la fonction _hidl_cb avec des valeurs différentes (en fonction des indicateurs de compilation). Par exemple, vous pouvez remplir les fonctions pour 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 passthrough HIDL, qui est inutilisé (et interdit) par configstore. ConfigStore doit toujours s'exécuter en mode lié.

Enregistrer en tant que service

Enfin, enregistrez toutes les implémentations d'interface dans le 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();

Garantir un accès anticipé

Pour garantir qu'un module de framework peut obtenir un accès anticipé 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 est censé être prêt rapidement après son lancement.