نطاق أسماء apext::sm

توفر مساحة الاسم apext::sm واجهات معيارية لتوسيع المنصة بغرض التنسيق بين حالات الطاقة بين AUTOSAR Adaptive State Management ونظام التشغيل المضيف SWS StateManagement §C.1 «Header: apext/sm/power_state_interface.h». عبر التعداد apext::sm::PowerState، يتم تمثيل أوضاع توفير الطاقة الخاصة بنظام Linux بطريقة ذات أنواع محددة [SWS_SM_71002]. بالإضافة إلى ذلك، يتيح رد الاتصال (callback) apext::sm::WakeUpHandler لنظام التشغيل إمكانية إطلاق خروج ذاتي من حالات السكون في State Management دون الحاجة إلى تطبيق تحكم مسبق [SWS_SM_71004]، مع العلم أن هذا الاستدعاء غير مصمم ليكون آمناً للخيوط.

المزيد ›

السياق

يوفر نطاق الأسماء apext::sm واجهات معيارية لتوسيع المنصة (Platform Extension Interfaces) لـ Functional Cluster الخاص بـ State Management ضمن AUTOSAR Adaptive Platform SWS StateManagement §C.1 «Header: apext/sm/power_state_interface.h». وبينما تخدم الواجهات القياسية لـ State Management في المقام الأول تنسيق حالات التطبيقات ومجموعات الوظائف وأنماط التنفيذ عبر حدود النماذج، يتعامل apext::sm مع الربط القريب من العتاد. صُممت واجهات التوسيع لكي تُستخدم أو تُوفَّر بواسطة مصنعي المعدات الأصلية (OEMs) أو مسؤولي التكامل، بهدف توسيع وظائف المنصة وتحقيق تفاعل منسق مع نظام التشغيل (OS) الأساسي SWS StateManagement §C.1 «Header: apext/sm/power_state_interface.h».

المكون المركزي لنطاق الأسماء هو الفئة PowerStateInterface، والتي تُستخدم لتنسيق حالات الطاقة مع نظام التشغيل. إلى جانب ذلك، يُعرّف ملف الرأس apext/sm/power_state_interface.h تعديدات نمطية وأسماء مستعارة لمعاودات الاتصال (callback aliases) تعمل كحلقة وصل بين مشغلات نظام التشغيل ومصادر الاستيقاظ الخارجية وإدارة الحالة الداخلية. إلى جانب نظام التشغيل، ترتبط هذه الواجهات من الناحية المفاهيمية بـ Controller التابع لـ State Management وكذلك بكيانات ذات مستوى أعلى مثل SMControlApplication أو Update and Configuration Management (UCM)، والتي يمكنها أيضًا التأثير على انتقالات الحالة SWS StateManagement §7.7.15.1 «Autonomous wake-up from suspend state».

مخطط السياق: التفاعل المتبادل بين نظام التشغيل وواجهات apext::sm وState Management. المصادر: SWS StateManagement §7.7.15.1 «Autonomous wake-up from suspend state»، SWS StateManagement §C.1 «Header: apext/sm/power_state_interface.h».

دورة الحياة

تتميز دورة الحياة في إطار apext::sm بحالات الطاقة المنفصلة المنمذجة في التعداد apext::sm::PowerState استنادًا إلى std::uint32_t [SWS_SM_71002]. وتُشتق هذه الحالات مباشرة من منظور نواة أنظمة تشغيل Linux:

• kPmSuspendToIdle (= 1): مشتقة من الحالة PM_SUSPEND_TO_IDLE [SWS_SM_71002].
• kPmSuspendToRam (= 2): مشتقة من الحالة PM_SUSPEND_TO_RAM [SWS_SM_71002].
• kPmHibernation (= 3): مشتقة من الحالة PM_HIBERNATION (Suspend-to-Disk) [SWS_SM_71002].
• kPmOff (= 4): مشتقة من الحالة PM_OFF (إيقاف تشغيل كامل) [SWS_SM_71002].

تفسير: يُرجَّح أن تعمل الفئة PowerStateInterface كنقطة ارتكاز أساسية يستعلم من خلالها مسؤول التكامل عن هذه الحالات المستهدفة أو يرسلها إلى نظام التشغيل المضيف. سؤال Q-800acae699828764 (مفتوح) وخلال البقاء في حالة توفير طاقة مثل kPmSuspendToRam، تتوقف المعالجة العادية مؤقتًا إلى أن يبدأ حدث استيقاظ بالانتقال العكسي إلى نمط التشغيل النشط.

مسار الاستخدام

تتمثل إحدى حالات الاستخدام المركزية لنطاق الأسماء في الاستيقاظ الذاتي للنظام بأكمله من حالة التعليق (Autonomous wake-up from suspend state) SWS StateManagement §7.7.15.1 «Autonomous wake-up from suspend state». بينما يمكن لـ SMControlApplication طلب الخروج من وضع Suspend-to-RAM صراحةً، فإن State Management قادرة بالإضافة إلى ذلك على الاستجابة لإشارات الاستيقاظ بشكل ذاتي.

إذا أشار نظام التشغيل إلى حدث استيقاظ عبر الواجهة apext::sm::WakeUpHandler — شريطة أن تكون مطبقة —، فإن State Management تبدأ تسلسل استيقاظ بصورة مستقلة SWS StateManagement §7.7.15.1 «Autonomous wake-up from suspend state». يُعد apext::sm::WakeUpHandler اسمًا مستعارًا لدالة من النوع std::function<void(void)> [SWS_SM_71004]. ومن خلال استدعاء هذا المعالج، تنقل State Management آلة الحالة Controller من حالة التعليق الخاصة بها إلى الحالة LeaveSuspend المنمذجة خصيصًا لذلك [SWS_SM_CONSTR_00036]. وفي هذه الحالة، يُنفذ المتحكم عنصر الإجراء الإلزامي LeaveSuspendToRam، مما يؤدي إلى استئناف نشاط المنصة الاعتيادي دون تدخل مسبق من تطبيق التحكم [SWS_SM_CONSTR_00037]، SWS StateManagement §7.7.15.1 «Autonomous wake-up from suspend state».

مخطط التسلسل: تسلسل الاستيقاظ الذاتي عبر WakeUpHandler. المصادر: SWS StateManagement §7.7.15.1 «Autonomous wake-up from suspend state»، [SWS_SM_71004]، [SWS_SM_CONSTR_00036]، [SWS_SM_CONSTR_00037].

سيناريوهات الأخطاء

عند استخدام وتكامل apext::sm، يجب مراعاة الشروط الحدية الخاصة بالنظام ومخاطر التزامن:

• غياب أمان الخيوط: نوع الاستدعاء apext::sm::WakeUpHandler غير آمن للخيوط صراحةً وفقًا للمواصفة (not thread-safe) [SWS_SM_71004]. إذا أطلق نظام التشغيل أو سياق المقاطعة إشارات متعددة أو متوازية، يجب على مسؤول التكامل توفير آليات مزامنة مناسبة لمنع سباقات البيانات وانتقالات الحالة غير المتسقة في State Management.
• معالج غير مطبق: إذا لم يكن WakeUpHandler مطبقًا في النظام المستهدف، فلا يمكن حدوث استيقاظ ذاتي عبر نظام التشغيل؛ وفي هذه الحالة يظل النظام في حالة التعليق إلى حين وصول طلبات خارجية (على سبيل المثال بواسطة UCM عبر RequestUpdateSession) أو طلبات صريحة من التطبيق SWS StateManagement §7.7.15.1 «Autonomous wake-up from suspend state».
• خطأ في النمذجة في البيان (Manifest): إذا كانت الحالة LeaveSuspend الخاصة بـ Controller مفقودة في بيان النشر [SWS_SM_CONSTR_00036] أو إذا لم تكن تتضمن العنصر الإلزامي LeaveSuspendToRam [SWS_SM_CONSTR_00037]، يفشل الانتقال الآلي ولا تتمكن المنصة من استئناف التشغيل على النحو المنصوص عليه بعد حالة التعليق.