إنشاء واجهة HAL

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يجب استخدام HIDL لوصف جميع علامات الإنشاء المستخدَمة ل compiling الإطار بشكل مشروط. يجب تجميع علامات الإنشاء ذات الصلة وتضمينها فيملف.hal واحد. تشمل مزايا استخدام HIDL لتحديد عناصر الضبط ما يلي:

• ذات إصدارات (لإضافة عناصر إعدادات جديدة، على المورّدين/الشركات المصنّعة الأصلية توسيع HAL بشكل صريح)
• موثّقة بشكل جيد
• التحكّم في الوصول باستخدام SELinux
• التحقّق من صحة عناصر الضبط من خلال مجموعة اختبارات المورّد (التحقّق من النطاق والتحقّق من الاعتماد المتبادل بين العناصر وما إلى ذلك)
• واجهات برمجة التطبيقات التي يتم إنشاؤها تلقائيًا بكل من C++ وJava

تحديد علامات الإنشاء التي يستخدمها إطار العمل

ابدأ بتحديد إعدادات الإنشاء المستخدَمة لتجميع الإطار المرجعي بشكل مشروط، ثمّ تخلَّص من الإعدادات القديمة لتصغير المجموعة. على سبيل المثال، تم تحديد المجموعة التالية من علامات الإنشاء لـ surfaceflinger:

• TARGET_USES_HWC2
• TARGET_BOARD_PLATFORM
• TARGET_DISABLE_TRIPLE_BUFFERING
• TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
• NUM_FRAMEBUFFER_SURFACE_BUFFERS
• TARGET_RUNNING_WITHOUT_SYNC_FRAMEWORK
• VSYNC_EVENT_PHASE_OFFSET_NS
• SF_VSYNC_EVENT_PHASE_OFFSET_NS
• PRESENT_TIME_OFFSET_FROM_VSYNC_NS
• MAX_VIRTUAL_DISPLAY_DIMENSION

إنشاء واجهة HAL

يتم الوصول إلى إعدادات الإنشاء لنظام فرعي من خلال واجهة HAL، في حين يتم تجميع واجهات تقديم قيم الضبط في حزمة HALandroid.hardware.configstore (الإصدار 1.0 حاليًا). على سبيل المثال، لإنشاء ملف واجهة HAL لـ surfaceflinger، في hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal:

package android.hardware.configstore@1.0;

interface ISurfaceFlingerConfigs {
    // TO-BE-FILLED-BELOW
};

بعد إنشاء ملف .hal، شغِّل hardware/interfaces/update-makefiles.sh لإضافة ملف .hal الجديد إلى الملفَين Android.bp و Android.mk.

إضافة دوال لعلامات الإنشاء

لكل علامة بناء، أضِف دالة جديدة إلى الواجهة. على سبيل المثال، في hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal:

interface ISurfaceFlingerConfigs {
    disableTripleBuffering() generates(OptionalBool ret);
    forceHwcForVirtualDisplays() generates(OptionalBool ret);
    enum NumBuffers: uint8_t {
        USE_DEFAULT = 0,
        TWO = 2,
        THREE = 3,
    };
    numFramebufferSurfaceBuffers() generates(NumBuffers ret);
    runWithoutSyncFramework() generates(OptionalBool ret);
    vsyncEventPhaseOffsetNs generates (OptionalUInt64 ret);
    presentTimeOffsetFromSyncNs generates (OptionalUInt64 ret);
    maxVirtualDisplayDimension() generates(OptionalInt32 ret);
};

عند إضافة دالة:

• احرص على أن تكون الأسماء موجزة. تجنَّب تحويل أسماء المتغيّرات في ملف الإنشاء إلى أسماء دوال، وتذكَّر أنّ البادئات TARGET_ و BOARD_ لم تعُد ضرورية.
• إضافة تعليقات: ساعد المطوّرين في فهم الغرض من عنصر الإعدادات وكيفية تغييره لسلوك إطار العمل والقيم الصالحة وغيرها من المعلومات ذات الصلة.

يمكن أن تكون أنواع عرض الدالة Optional[Bool|String|Int32|UInt32|Int64|UInt64]. يتم تعريف الأنواع في types.hal في الدليل نفسه ويتم لف القيم الأساسية في حقل يشير إلى ما إذا كانت القيمة محدّدة من خلال HAL، وإذا لم تكن كذلك، يتم استخدام القيمة التلقائية.

struct OptionalString {
    bool specified;
    string value;
};

حدِّد القائمة الثابتة التي تمثّل على أفضل وجه نوع عنصر الإعدادات واستخدِم هذه القائمة الثابتة كنوع الإرجاع، وذلك عند الاقتضاء. في المثال أعلاه، يتم تعريف التعداد NumBuffers لتقييد عدد القيم الصالحة. عند تحديد أنواع البيانات المخصّصة هذه، أضِف حقلًا أو قيمة مصنّفة (مثلUSE_DEFAULT) للإشارة إلى ما إذا كانت القيمة محدّدة من قِبل HAL أم لا.

ليس من الضروري أن يصبح علامة بناء واحدة دالة واحدة في HIDL. يمكن لمالكي الوحدات بدلاً من ذلك تجميع علامات الإنشاء ذات الصلة ببعضها في بنية وإنشاء دالة تعرض هذه البنية (يمكن أن يؤدي ذلك إلى تقليل عدد طلبات الدالة).

على سبيل المثال، خيار لتجميع علامتَي تجميع في بنية واحدة في hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal هو:

 interface ISurfaceFlingerConfigs {
    // other functions here
    struct SyncConfigs {
        OptionalInt64 vsyncEventPhaseoffsetNs;
        OptionalInt64 presentTimeoffsetFromSyncNs;
    };
    getSyncConfigs() generates (SyncConfigs ret);
    // other functions here
};

بدائل لدالة HAL واحدة

كبديل لاستخدام دالة HAL واحدة لجميع علامات الإنشاء، توفّر واجهة HAL أيضًا دوال بسيطة مثل getBoolean(string key) وgetInteger(string key). يتم تخزين أزواج key=value الفعلية في ملفات منفصلة، وتقدّم خدمة HAL القيم من خلال قراءة هذه الملفات أو تحليلها.

على الرغم من أنّ من السهل تحديد هذا النهج، إلا أنّه لا يتضمن المزايا التي يوفّرها HIDL (إصدار مُطبَّق وسهولة إعداد المستندات والتحكّم في الوصول)، وبالتالي لا يُنصح به.

الواجهات الفردية والمتعدّدة

يقدّم تصميم واجهة HAL لعناصر الضبط خيارين:

• واجهة واحدة تتناول جميع عناصر الضبط
• واجهات متعددة تغطي كلّ منها مجموعة من عناصر الضبط المرتبط

إنّ الواجهة الواحدة أسهل، ولكن يمكن أن تصبح غير قابلة للصيانة عند إضافة المزيد من عناصر الضبط إلى الملف الواحد. بالإضافة إلى ذلك، لا يكون التحكّم في الوصول دقیقًا، لذا يمكن لعملية تم منحها إذن الوصول إلى الواجهة قراءة جميع عناصر الضبط (لا يمكن منح إذن الوصول إلى مجموعة جزئية من عناصر الضبط). بدلاً من ذلك، إذا لم يتم منح إذن الوصول، لا يمكن قراءة عناصر الضبط.

بسبب هذه المشاكل، يستخدم Android واجهات متعددة مع واجهة HAL واحدة لمجموعة من عناصر الضبط ذات الصلة. على سبيل المثال، ISurfaceflingerConfigs لعناصر الضبط المتعلقةsurfaceflinger وIBluetoothConfigs لعناصر الضبط المتعلقةsurfaceflinger.