כדי להתכונן להטמעה של HAL, אפשר ליצור קוד בסיסי של ממשק ConfigStore, ואז לשנות אותו בהתאם לצרכים שלכם.
יצירת קוד לממשק
כדי ליצור קוד boilerplate לממשק, מריצים את הפקודה 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
ולמפות את דגלי ה-build להגדרות מאקרו. לדוגמה, אפשר לשנות את
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
עם ערכים שונים (בהתאם לדגלי ה-build). לדוגמה, אפשר למלא את הפונקציות של surfaceflinger
in
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
). הפונקציה הזו נדרשת למצב העברה (passthrough) של HIDL, שלא נמצא בשימוש (ואסור) ב-configstore
. ההפעלה של ConfigStore חייבת להיות תמיד במצב binderized.
הרשמה כשירות
לבסוף, רושמים את כל ההטמעות של הממשק בשירות configstore
. לדוגמה, אפשר לרשום הטמעות של surfaceflinger
ב-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();
בדיקה אם יש גישה מוקדמת
כדי להבטיח שמודול framework יוכל לקבל גישה מוקדמת לשירות HAL, שירות HAL של ההגדרות צריך להתחיל לפעול מוקדם ככל האפשר, מיד אחרי ש-hwservicemanager
מוכן. שירות ה-HAL של התצורה לא קורא קבצים חיצוניים, ולכן הוא אמור להיות מוכן במהירות אחרי ההפעלה.