การใช้บริการ

เพื่อเตรียมพร้อมสำหรับการใช้งาน 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 passthrough ซึ่งไม่ได้ใช้ (และถูกห้าม) โดย configstore ConfigStore ต้องทำงานในโหมด Binderized เสมอ

การลงทะเบียนเป็นบริการ

สุดท้าย ให้ลงทะเบียนการใช้งานอินเทอร์เฟซทั้งหมดกับบริการ 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 ได้ก่อนใคร บริการ config HAL ควรเริ่มต้นโดยเร็วที่สุด หลังจากที่ hwservicemanager พร้อมแล้ว เนื่องจากบริการ config HAL ไม่อ่านไฟล์ภายนอก จึงคาดว่าจะพร้อมใช้งานได้อย่างรวดเร็วหลังจากเปิดตัว