واجهة خدمة StateMachineNotification

توفر واجهة الخدمة StateMachineNotification لـ Adaptive Applications حالة آلة الحالة عبر الحقل CurrentState القابل للقراءة والاشتراك ([SWS_SM_91028]، [SWS_SM_91109]). وعند تغييرات الحالة، يشير الحقل إلى القيمة الوسيطة "inTransition"، إلى أن يتم تنفيذ جميع الإجراءات ([SWS_SM_00616]). ويتم تقديم الواجهة البينية بعد بدء آلة الحالة وسحبها مجددًا عند إنهائها ([SWS_SM_00618]، [SWS_SM_00619]).

المزيد ›

دور واجهة الخدمة وسياق النظام الخاص بها

يتم توفير واجهة الخدمة StateMachineNotification بواسطة الوحدة State Management (SM) الخاصة بـ AUTOSAR Adaptive Platform ([SWS_SM_91028]). وبينما تطلب تطبيقات التحكم انتقالات حالة جديدة عبر واجهات بينية منفصلة، يتفاعل StateMachineNotification أساسًا مع Adaptive Applications النظامية على مستوى التطبيق (AUTOSAR_AP_SWS_StateManagement ص. 44). وتعمل الخدمة كمزوّد (Skeleton)، بينما ترتبط التطبيقات المستهلكة كمستهلك (Proxy) عبر ara::com. وما دامت آلة حالة معينة قد جرى تكوينها لذلك، تُنشئ State Management مثيلًا خاصًا بها من هذه الواجهة البينية ([SWS_SM_00665]). وفي المشاريع التي تعمل فيها آلات حالة معينة داخليًا بشكل بحت ولا تكون ذات صلة بالتطبيقات، يمكن الاستغناء عن التكوين والتقديم (AUTOSAR_AP_SWS_StateManagement ص. 45).

الطرائق والأحداث والحقول

لا تحدد الواجهة البينية دوالًا كلاسيكية أو أحداثًا بحتة، بل تغلف حالة آلة الحالة المراقبة في حقل مركزي ([SWS_SM_91109]). يمتلك الحقل CurrentState نوع البيانات StateMachineStateNameType وهو مخصص للقراءة فقط: فهو يحتوي على دالة جلب (HasGetter: true) بالإضافة إلى جهة إخطار (HasNotifier: true)، ولكنه لا يمتلك دالة ضبط (HasSetter: false) ([SWS_SM_91109]). وبذلك يمكن لـ Adaptive Applications الاستعلام عن القيمة الحالية بصورة متزامنة عبر دالة الجلب، وكذلك الاشتراك في الإشعارات ليتم إعلامها بشكل غير متزامن عبر ara::com عند حدوث تغييرات في حالة آلة الحالة المعنية ([SWS_SM_91109]).

بمجرد بدء انتقال حالة لآلة الحالة، يتخذ الحقل CurrentState القيمة الثابتة "inTransition" ([SWS_SM_00616]). ويتم تعيين هذه الحالة الوسيطة بصرف النظر عن المصدر المحفّز — على سبيل المثال Execution Management أو Platform Health Management أو تطبيق تحكم — وتظل قائمة حتى لو حدثت انتقالات أخرى استجابة لإشعارات الخطأ (AUTOSAR_AP_SWS_StateManagement ص. 67). وفقط عندما تتم معالجة جميع الإجراءات المرتبطة بالكامل، يتم تحديث القيمة إلى الحالة المستهدفة الفعلية لآلة الحالة ([SWS_SM_00617]).

مخطط تسلسلي: التقديم والاستعلام وإشعارات جهة الإخطار عند انتقالات الحالة عبر StateMachineNotification. المصادر: [SWS_SM_00618]، [SWS_SM_91109]، [SWS_SM_00616]، [SWS_SM_00617]

دورة الحياة والتقديم واعتماديات الحالة

يُعد بدء آلة الحالة عملية متعددة المراحل (AUTOSAR_AP_SWS_StateManagement ص. 59). ولا تُعتبر آلة الحالة من منظور وحدات التحكم العليا قد بدأت إلا عندما تكون موجودة وتكون واجهاتها البينية المرتبطة معروضة للتقديم (AUTOSAR_AP_SWS_StateManagement ص. 59). ويتم تقديم (عرض) كل مثيل StateMachineNotification مكوَّن عبر ara::com بمجرد معالجة ActionListItem بالأمر StartStateMachine بنجاح ([SWS_SM_00618]). يتيح ذلك للتطبيقات الارتباط بالخدمة في مرحلة مبكرة.

إذا تم إنهاء آلة حالة أو إيقاف تشغيلها تدريجيًا، يتم سحب الخدمة مجددًا: تصبح الواجهة البينية غير متاحة (StopOffer) بدءًا من اللحظة التي تتم فيها معالجة إجراء الإنهاء المقابل ([SWS_SM_00619]). وإذا كانت آلات الحالة تُدار بواسطة وحدة تحكم، فإن النموذج الفوقي يتطلب علاوة على ذلك أن تشير كل قائمة إجراءات إلى المجموعة الكاملة من الوكلاء الخاضعين للتحكم ([SWS_SM_CONSTR_00016]).

معالجة الأخطاء والشروط الحدية

بالنسبة لـ StateMachineNotification، لم يتم تحديد أخطاء تطبيق خاصة بالتطبيق (مثل kOperationRejected) في نموذج الواجهة البينية، لأن الواجهة البينية تعمل كواجهة مراقبة بحتة ولا تقدم دوالًا معدِّلة ([SWS_SM_91109]). وتستند معالجة الأخطاء إلى آليات الاتصال الخاصة بـ ara::com عند الاستعلام عن الحقل، وكذلك إلى تقييم الحالة "inTransition": يُسمح للمستهلكين بتفسير هذه القيمة الوسيطة كعلامة على وجود عملية تبديل أو عملية معالجة أخطاء جارية (AUTOSAR_AP_SWS_StateManagement ص. 67).