Как реализовать сервис

Чтобы подготовиться к реализации 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 в 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. Например, вы можете зарегистрировать реализации surfaceflinger в 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();

Как обеспечить ранний доступ

Чтобы модуль фреймворка мог получить ранний доступ к сервису HAL, сервис HAL конфигурации должен запускаться как можно раньше, сразу после того, как будет готов hwservicemanager. Поскольку сервис HAL конфигурации не считывает внешние файлы, он должен быть готов к работе вскоре после запуска.