وحدة ara::sm — State Management
دليل الوحدةمولَّد بالذكاء الاصطناعي
ينسق حالات النظام ومجموعات الوظائف وأوضاع توفير الطاقة وتحديثات البرمجيات لـ Adaptive Machine.
ينسق حالات النظام ومجموعات الوظائف وأوضاع توفير الطاقة وتحديثات البرمجيات لـ Adaptive Machine.
يتحكم العنقود التكيفي State Management في أوضاع التشغيل على مستوى النظام وحالات مجموعات الوظائف ومراحل تحديث البرمجيات لـ Adaptive Machine بالتنسيق مع Execution Management وUCM EXP SWArchitecture ص. 51. ويقوم بمعالجة محفزات الانتقال بشكل حتمي عبر جداول وقوائم إجراءات مكوّنة، ويُبلغ عن الحالات الانتقالية عبر StateMachineNotification، وينسق Suspend-to-RAM عبر نمط المحور والتابع [SWS_SM_91107]، [SWS_SM_81110]. وتضمن الشروط المحددة، مثل الفحص الصارم لتصاريح التحديث ومسارات اعتراض الأخطاء الإلزامية لـ ANY، التشغيل القوي للمنصة [SWS_SM_91108].
يعمل العنقود الوظيفي State Management (SM) في AUTOSAR Adaptive Platform كشيطان منصة مركزي للتحكم في حالات الآلة ومجموعات الوظائف بالإضافة إلى أوضاع التنفيذ EXP SWArchitecture ص. 51. وهو يفصل بدقة منطق اتخاذ القرار الخاص بالمركبة في تطبيقات التحكم (SMControlApplication) عن إدارة العمليات الفعلية بواسطة Execution Management (EM) EXP PlatformDesign ص. 40. إلى جانب التطبيقات الخاصة بالشركات المصنعة، توفر AUTOSAR نهج StateMachine قياسيًا تتم فيه معالجة الانتقالات عبر نماذج أولية جدولية وقوائم إجراءات مكوّنة SWS StateManagement ص. 42.
يتم بدء انتقالات الحالة عبر الأسلوب RequestTransition الخاص بـ StateMachineService [SWS_SM_91107] والتحقق من صحتها مقابل TransitionRequestTable SWS StateManagement ص. 44. وأثناء تنفيذ ActionList المقترنة، تشير حقل الإشعار CurrentState إلى القيمة الانتقالية "inTransition" للتطبيقات المستهلكة قبل نشر الحالة المستهدفة بعد الإقرار الكامل [SWS_SM_91109]، SWS StateManagement ص. 67.
مخطط تسلسل: تسلسل انتقال حالة منتظم عبر StateMachineService والإشعار عبر StateMachineNotification. المصادر: [SWS_SM_91107]، [SWS_SM_91109]، SWS StateManagement ص. 51
لتنفيذ تحديثات البرمجيات، يوفر State Management الواجهة UpdateRequest لـ Update and Configuration Management (UCM) [SWS_SM_91102]، EXP SWArchitecture ص. 56. وبعد فحص الحقل التطبيقي UpdateAllowed، تقوم الوحدة بتنسيق خطوات الإعداد (PrepareUpdate) أو التحقق (VerifyUpdate) أو التراجع (PrepareRollback) بالإضافة إلى إعادة تشغيل الآلة عبر ResetMachine [SWS_SM_91100]، [SWS_SM_91103]، [SWS_SM_91108]. وبالنسبة لأوضاع توفير الطاقة مثل Suspend-to-RAM، يعمل S2RHub وS2RSatellite على مزامنة تجميد وإعادة تشغيل التطبيقات ونظام التشغيل [SWS_SM_81010]، [SWS_SM_81110]، [SWS_SM_71001].
في حالة الخطأ، يضمن SmErrorDomain [SWS_SM_81247] بالإضافة إلى مدخل اعتراض ANY الإلزامي في ErrorRecoveryTable اعتراض أخطاء التنفيذ غير المتوقعة من Execution Management أو Platform Health Management بشكل حتمي ونقل الإجراءات الجارية فورًا إلى حالات استرداد محددة SWS StateManagement ص. 42.
الدور والحدود الوظيفية للنظام ضمن مجمع المنصة
يشكل العنقود الوظيفي State Management (SM) في AUTOSAR Adaptive Platform الكيان المركزي لتنسيق أوضاع التشغيل ومجموعات الوظائف ودورات حياة العمليات على مستوى النظام EXP SWArchitecture ص. 51. وبصفته شيطان منصة يعمل بشكل مستقل، يفصل State Management تنفيذ الحالة الداخلي للمنصة عن منطق التحكم الخاص بالمركبة والشركة المصنعة، والذي يتم تغليفه عادةً في تطبيق تحكم مستقل (SMControlApplication) EXP PlatformDesign ص. 40. وبينما يتخذ State Management قرارات الحالة المنطقية ويتحقق من صحتها، فإنه يفوض البدء الفعلي والإنهاء والتبديل للعمليات عبر StateClient إلى Execution Management (EM) SWS StateManagement ص. 40.
معماريًا، تعتمد الوحدة على فلسفة تكامل مزدوجة: يمكن للمكاملين إما استخدام نهج StateMachine القياسي القائم على البيان لحزمة المنصة أو تنفيذ منطق حالة خاص بالشركة المصنعة بالكامل، نظرًا لأن واجهات State Management معلنة كواجهات عامة SWS StateManagement ص. 42. وفي النهج القياسي، يستجيب State Management بشكل حتمي للمحفزات الخارجية من تطبيقات التحكم، ورسائل الخطأ من Platform Health Management (PHM)، بالإضافة إلى تغييرات حالة الشبكة من Network Management (NM) SWS StateManagement ص. 45. وعلاوة على ذلك، يشكل State Management جهة التحكم المعتمدة لتحديثات البرمجيات بواسطة Update and Configuration Management (UCM) EXP SWArchitecture ص. 56.
مخطط سياق: تضمين العنقود الوظيفي State Management في مجمع نظام AUTOSAR Adaptive. المصادر: EXP PlatformDesign ص. 40، SWS StateManagement ص. 28
انتقالات الحالة والتحكم عبر واجهة StateMachineService
لبدء تغييرات الحالة، يوفر State Management الخدمة القائمة على الخدمات StateMachineService لكل مثيل مكوّن من StateMachine SWS StateManagement ص. 44. ويطلب التطبيق انتقالاً عبر أسلوب الخدمة RequestTransition [SWS_SM_91107]. يفحص State Management هذا الطلب بالاعتماد على TransitionRequestTable مخزنة بشكل ثابت في البيان مقابل الحالة الحالية لآلة الحالة SWS StateManagement ص. 44. وإذا كان الانتقال محددًا، يتم إيقاف تنفيذ قائمة الإجراءات الحالية (ActionList) وبدء التبديل إلى الحالة المستهدفة SWS StateManagement ص. 45.
بمجرد بدء انتقال الحالة، يعيّن State Management قيمة حقل الخدمة CurrentState لواجهة StateMachineNotification إلى "inTransition" [SWS_SM_91109]، SWS StateManagement ص. 67. وتشير هذه الحالة الانتقالية إلى Adaptive Applications التابعة عبر ara::com بأن إعادة تكوين النظام قيد التنفيذ EXP SWArchitecture ص. 52. وداخل قوائم الإجراءات، يمكن مزامنة مجموعات الوظائف عبر عناصر SYNC أو تشغيلها على التوازي لتمثيل التبعيات بدقة SWS StateManagement ص. 56. وفقط بعد معالجة جميع ActionListItems بالكامل وتجميع النتائج، يأخذ CurrentState الاسم النهائي للحالة الجديدة SWS StateManagement ص. 67.
مخطط تسلسل: تسلسل انتقال حالة منتظم عبر StateMachineService والإشعار عبر StateMachineNotification. المصادر: [SWS_SM_91107]، [SWS_SM_91109]، SWS StateManagement ص. 51، EXP SWArchitecture ص. 219
مخطط حالة: دورة الحياة النموذجية ومنطق الانتقال لـ StateMachine بالاستناد إلى TransitionRequestTable. المصادر: EXP InterfacesGuidelines ص. 22، SWS StateManagement ص. 44
تنسيق تحديثات البرمجيات بالتفاعل مع UCM
في إطار تحديثات البرمجيات، يتولى State Management وظيفة الواجهة البينية بين Update and Configuration Management (UCM) وحالات تنفيذ الآلة EXP SWArchitecture ص. 142. ولهذا الغرض، يوفر State Management الواجهة UpdateRequest، التي لا يجوز إنشاء أكثر من مثيل واحد منها لكل آلة، وتكون مرتبطة حصريًا بالعملية التي تدير آلة حالة وحدة التحكم SWS StateManagement ص. 79. يبدأ التحديث عندما يستدعي UCM الأسلوب RequestUpdateSession [SWS_SM_91102]. ولا يتخذ State Management القرار بشأن القبول بشكل مستقل، بل يستشير حقل الخدمة UpdateAllowed لـ UpdateAllowedService، الذي يتم تعيينه بواسطة منطق التحكم التطبيقي [SWS_SM_91108]، SWS StateManagement ص. 81.
إذا تمت الموافقة على الجلسة، تُميّز وحدة التحكم آلات الحالة المعنية بالعلامة ImpactedByUpdate SWS StateManagement ص. 81. وقبل التثبيت الفعلي، يستدعي UCM الأسلوب PrepareUpdate مع قائمة مجموعات الوظائف المعنية، وبناءً على ذلك يتم نقلها إلى حالات غير نشطة [SWS_SM_91103]، PlatformDesign ص. 58. وإذا كان التحديث يتطلب إعادة تشغيل، يطلب UCM عبر أسلوب الإطلاق والنسيان ResetMachine إعادة ضبط منظمة، يجب قبلها حفظ جميع البيانات [SWS_SM_91100]. ويُبلغ State Management نظام UCM بتغييرات الحالة أثناء إعادة الضبط عبر الحقل ResetMachineNotifier [SWS_SM_91106]، SWS StateManagement ص. 92. وبعد إعادة التشغيل أو التحديث، يتبع ذلك التحقق عبر VerifyUpdate [SWS_SM_91104]، SWS StateManagement ص. 87. وإذا فشل التحقق، يُعد PrepareRollback عملية التراجع [SWS_SM_91105]، SWS StateManagement ص. 88. ويتم تأكيد إتمام الدورة بأكملها باستخدام StopUpdateSession [SWS_SM_91101]، SWS StateManagement ص. 79.
مخطط تسلسل: تسلسل التفاعل لجلسة تحديث البرمجيات بين UCM وState Management ومنطق التحكم. المصادر: [SWS_SM_91100]، [SWS_SM_91102]، [SWS_SM_91103]، [SWS_SM_91104]، SWS StateManagement ص. 78
إدارة الطاقة وSuspend-to-RAM في مجمع المحور والتابع
لوظائف إدارة الطاقة المتقدمة مثل Suspend-to-RAM (S2R)، يطبق State Management نمط معمارية المحور والتابع EXP SWArchitecture ص. 54. وتستخدم وحدة التحكم المركزية في شيطان المنصة الفئة S2RHub [SWS_SM_81103]، بينما تدمج Adaptive Applications المشاركة في مساحة العمليات الخاصة بها مثيلات من S2RSatellite [SWS_SM_81003]، [SWS_SM_81014]، SWS StateManagement ص. 35. وتفعّل التوابع استعدادها لتلقي تغييرات الوضع عبر Offer [SWS_SM_81012] أو تعطلها عبر StopOffer [SWS_SM_81013]. كما تطبق الأساليب الافتراضية الصرفة EnterSuspendMode [SWS_SM_81010] وLeaveSuspendMode [SWS_SM_81011] كآلية رد نداء لإعداد السكون ومتابعته بعد الانتهاء.
عند بدء عملية تعليق، يخاطب S2RHub جميع التوابع المسجلة بشكل غير متزامن عبر RequestToEnterSuspendMode مع مهلة قابلة للتكوين [SWS_SM_81110]. وعندما تُكمل جميع التوابع استعداداتها للسكون بنجاح، يُصدر المحور عبر EnterSuspendToRamOs أمرًا بدخول نظام التشغيل في حالة الحفاظ على ذاكرة RAM [SWS_SM_81112]، SWS StateManagement ص. 101. وعلى مستوى مغلّف نظام التشغيل القريب من العتاد، يعتمد State Management على apext::sm::PowerStateInterface: وهي تتيح تعيين حالات تشغيل قريبة من العتاد عبر SetPowerState [SWS_SM_71001] استنادًا إلى التعداد PowerState [SWS_SM_71002]، بالإضافة إلى تسجيل وإلغاء تسجيل معالجات استيقاظ مستقلة عبر RegisterWakeUpHandler [SWS_SM_71003] وUnregisterWakeUpHandler [SWS_SM_71005] بنوع الدالة WakeUpHandler [SWS_SM_71004]، SWS StateManagement ص. 105. وبعد الاستيقاظ، يطلب المحور عبر RequestToLeaveSuspendMode إعادة التشغيل المنسقة لجميع التوابع [SWS_SM_81111].
مخطط تسلسل: تسلسل ثنائي المراحل عند نقل النظام إلى وضع Suspend-to-RAM والاستيقاظ اللاحق. المصادر: [SWS_SM_71001]، [SWS_SM_81110]، [SWS_SM_81112]، SWS StateManagement ص. 101
التصرف في حالة الخطأ
تحدد الوحدة لأخطائها التشغيلية الخاصة SmErrorDomain [SWS_SM_81247]، التي يتم استردادها عبر GetSmDomain [SWS_SM_81251] وتحمل المعرّف "Sm" [SWS_SM_81248]. وتوفر أوصافًا للأخطاء [SWS_SM_81249] وتحوّل الرموز في الحالات الاستثنائية عبر ThrowAsException إلى SmException [SWS_SM_81243]، [SWS_SM_81250]. وعبر التعداد SmErrc، يتم تصنيف أسباب الفشل المحددة، بما في ذلك kOfferFailed لانقطاع الاتصال بشيطان المنصة وkCommunicationFailed لفشل اتصال التوابع [SWS_SM_81240]، والتي يمكن إنشاؤها بواسطة MakeErrorCode [SWS_SM_81244].
في مجال آلات الحالة المنطقية، يفرض State Management معالجة شاملة للأخطاء عبر ErrorRecoveryTable SWS StateManagement ص. 69. ويجب أن يحتوي كل جدول إلزاميًا على إدخال واحد بالضبط بالقيمة ANY، والذي يعمل كمسار اعتراض حتمي لجميع أخطاء التنفيذ غير المعينة صراحةً SWS StateManagement ص. 42، SWS StateManagement ص. 69. وإذا أبلغ Platform Health Management أو Execution Management عن خطأ ولم تكن آلة الحالة المعنية مميزة بالعلامة ImpactedByUpdate، فإنها تعيّن علامة داخلية للإصلاح الجاري للخطأ، وتقطع قائمة الإجراءات الحالية فورًا وتنتقل فورًا إلى حالة الاسترداد المحددة بالمعاملات SWS StateManagement ص. 42. وفي حالة الأخطاء الحرجة لـ Execution Management مثل kIntegrityOrAuthenticityCheckFailed، يفترض State Management أن موثوقية المنصة قد تم اختراقها وأن الطلبات اللاحقة ستفشل، ولهذا السبب تقع الإجراءات التصحيحية خارج نطاق العنقود SWS StateManagement ص. 40.
مخطط نشاط: تسلسل اتخاذ القرار والمعالجة عند ورود أخطاء التنفيذ وتقييم ErrorRecoveryTable. المصادر: SWS StateManagement ص. 42، SWS StateManagement ص. 69
أدلة تفصيلية إضافية
تم إثبات المعمارية ومسارات التفاعل لـ State Management من خلال المتطلبات المعيارية ومحددات التصميم التالية:
- التحكم في النظام والانتقالات: يحدد [SWS_SM_91107] متطلب الانتقال الموجه بالخدمة، بينما ينظم [SWS_SM_91109] حقل الإشعار لفصل التطبيقات. ويتم دعم التحكم الجدولي بواسطة SWS StateManagement ص. 44.
- تكامل تحديث البرمجيات: تثبّت أساليب إدارة الجلسة [SWS_SM_91102]، والإعداد [SWS_SM_91103]، والتحقق [SWS_SM_91104]، وإعداد التراجع [SWS_SM_91105]، والإنهاء [SWS_SM_91101] بالإضافة إلى إعادة ضبط الآلة [SWS_SM_91100] وحقول التصريح [SWS_SM_91106]، [SWS_SM_91108] التفاعل مع UCM وفقًا لـ EXP SWArchitecture ص. 56.
- Suspend-to-RAM وإدارة الطاقة: يشكل التسلسل الهرمي الأصلي للفئات والواجهات حول
S2RHub[SWS_SM_81103]، [SWS_SM_81110]،S2RSatellite[SWS_SM_81003]، [SWS_SM_81010] وواجهة نظام التشغيل [SWS_SM_71001]، [SWS_SM_71003] الأساس المعياري لتوفير الطاقة EXP SWArchitecture ص. 54. - مجال الأخطاء: يستند تصميم نطاق الأخطاء القياسي مع مولدات الاستثناءات وErrorCode إلى [SWS_SM_81240] و[SWS_SM_81244] و[SWS_SM_81247].
تم إنشاء دليل الوحدات هذا بواسطة مساعد تنظيم مدعوم بالذكاء الاصطناعي استنادًا إلى مواصفات AUTOSAR Adaptive للإصدار R25-11، وهو يهيكل التوجيهات المعيارية المتعلقة بـ State Management.
function: 31 service method: 7 class: 5 type alias: 3 service field: 3 enumeration: 2
خريطة المواضيع
لا توجد بيانات عناصر لهذا الإصدار
apext::sm
class for power state coordination with OS
Power State Enumeration.
enum class PowerState : std::uint32_t {...};WakeUpHandler function.
using WakeUpHandler = std::function<void(void)>;ara::sm
Defines the error domain for State Management.
يرث من ara::core::ErrorDomain
Exception type thrown by State Management.
يرث من ara::core::Exception
Returns the global SmErrorDomain object.
constexpr const ara::core::ErrorDomain & GetSmDomain () noexcept;Creates an error code.
constexpr ara::core::ErrorCode MakeErrorCode (SmErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;Defines an enumeration class for the State Management error codes.
enum class SmErrc : ara::core::ErrorDomain::CodeType {...};ara::sm::s2r
S2RHub class.
S2RSatellite abstract class.
واجهات الخدمة
Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).
Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).
Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).
Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).
نطاقات الأسماء
- apext::sm 1 Klassen, 0 freie Funktionen
- ara::sm 2 Klassen, 2 freie Funktionen
- ara::sm::s2r 2 Klassen, 0 freie Funktionen
واجهات الخدمة (منمذجة عبر ara::com)
- StateMachineNotification 1 Mitglieder
- StateMachineService 1 Mitglieder
- UpdateAllowedService 1 Mitglieder
- UpdateRequest 7 Mitglieder
مخطط الفئات UML للوحدة
Abgerundete Rahmen = Namespaces; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = modulfremde bzw. externe Basisklassen. Klicken öffnet die Klassenseite.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني