Default Error Tracer (DET)

يتلقى Default Error Tracer رسائل الخطأ من وحدات BSW وSW-Cs مركزياً. ولهذا الغرض يتوفر Det_ReportError لأخطاء التطوير، وDet_ReportRuntimeError لأخطاء وقت التشغيل، وDet_ReportTransientFault للأخطاء العابرة، مع تحديد معرف الوحدة والمثيل وواجهة برمجة التطبيقات (API) والخطأ لكل منها. يمرر DET كل رسالة إلى جميع الخطافات أو عمليات الاستدعاء الخارجية (Callouts) المكونة للمدمج [SWS_Det_00501]. ويبدأ التشغيل بواسطة Det_Init وDet_Start من EcuM. القيد الحدي الأكثر أهمية: Det_ReportError لا يعود إلى المتصل في R20-11، بل يوقف تدفق البرنامج مثل توكيد (Assertion) [SWS_Det_00009].

المزيد ›

يعد Default Error Tracer نقطة التجميع المركزية لرسائل الخطأ القادمة من البرمجيات الأساسية ومكونات البرمجيات. وهو يوفر ثلاث خدمات إبلاغ متماثلة البنية بالمعاملات ModuleId وInstanceId وApiId وErrorId أو FaultId: Det_ReportError لأخطاء التطوير، وDet_ReportRuntimeError لأخطاء وقت التشغيل، وDet_ReportTransientFault للأخطاء العابرة ([SWS_Det_00009]، [SWS_Det_01001]، [SWS_Det_01003]). ويضع EcuM الـ DET في الخدمة بواسطة Det_Init ثم Det_Start ([SWS_Det_00008]، SWS DET الشكل 1 ص. 34).

مخطط سياق: يستقبل DET الرسائل من وحدات BSW وSW-Cs ويوجهها إلى خطافات المدمج واختيارياً إلى Dlt. المصادر: SWS DET الشكل 2 ص. 28، [SWS_Det_00202]

لا يقيّم DET الرسائل بنفسه. تستدعي كل خدمة إبلاغ جميع الخطافات أو عمليات الاستدعاء الخارجية (Callouts) المكونة لها (DetErrorHook، DetReportRuntimeErrorCallout، DetReportTransientFaultCallout)، وذلك بنفس المعاملات الخاصة بالرسالة [SWS_Det_00501]. وعبر كود المدمج هذا، يصل DET أيضاً إلى DEM أو ذاكرة الأعطال. ويجب أن تقتصر عمليات الاستدعاء الخارجية على إجراءات قصيرة ومناسبة ErrorDescription ص. 10.

تبلغ SW-Cs عبر واجهة العميل-الخادم DETService. يكمل RTE كلاً من ModuleId وInstanceId كـ «port defined argument values» من تكوين DET، وتسترجع SW-C دائماً E_OK ([SWS_Det_00203]، [SWS_Det_00204]).

بالنسبة لحالات الخطأ، فإن كيفية عودة الخدمات الثلاث أمر حاسم. Det_ReportError لا يعود في R20-11: بعد الخطافات، يتم إيقاف تدفق التحكم، تماماً كما هو الحال في التوكيد (Assertion) ([SWS_Det_00009]، RS BSWGeneral ص. 33). في المقابل، تعود رسائل وقت التشغيل مع E_OK. وتمرر الرسائل العابرة قيمة الاستدعاء الخارجي (Callout)، وبدون استدعاء خارجي E_OK SWS DET الشكل 6 ص. 36. أُلغيت الأخطاء العابرة مع R24-11، واستدعاءات Dlt مع R25-11 SWS DET ص. 1.

مخطط تسلسلي: عند حدوث خطأ تطوير، يستدعي DET جميع الخطافات المكونة ثم يتوقف بعد ذلك دون العودة إلى جهة الإبلاغ. المصادر: SWS DET الشكل 9.2 ص. 34، [SWS_Det_00009]

المزيد ›

دور Default Error Tracer عند حدود النظام

يعد Default Error Tracer (DET) نقطة التجميع المركزية التي تبلغ إليها وحدات البرمجيات الأساسية ومكونات البرمجيات عن الأخطاء المكتشفة. في R20-11، يوفر لهذا الغرض ثلاث خدمات إبلاغ متماثلة البنية: Det_ReportError لأخطاء التطوير [SWS_Det_00009]، وDet_ReportRuntimeError لأخطاء وقت التشغيل [SWS_Det_01001]، وDet_ReportTransientFault للأخطاء العابرة [SWS_Det_01003]. يُضاف إلى ذلك خدمات الإدارة Det_Init وDet_Start وDet_GetVersionInfo ([SWS_Det_00008]، [SWS_Det_00010]، [SWS_Det_00011]). لا يقيّم DET محتوى الرسائل بنفسه. بل يقوم بإشعار خطافات الأخطاء المكونة مع كل رسالة مستلمة SWS DET ص. 16.

يرتبط DET بالخارج بشكل ضيق. وتذكر المواصفات، باعتبارها الواجهة المتوقعة الوحيدة، إعادة التوجيه الاختيارية إلى Dlt عبر Dlt_DetForwardErrorTrace من Dlt_Det.h ([SWS_Det_00211]، SWS DET الشكل 2 ص. 28). ولا يصل DET إلى DEM وRTE إلا من خلال كود مخصص للمدمج في عمليات الاستدعاء الخارجية (Callouts) ErrorDescription ص. 10.

مخطط سياق: يستقبل DET الرسائل من وحدات BSW، وعبر RTE، من SW-Cs. ويتم بدء تشغيله بواسطة EcuM ولا يمرر الرسائل إلا إلى كود المدمج المكون واختيارياً إلى Dlt. المصادر: SWS DET الشكل 2 ص. 28، [SWS_Det_00202]، [SWS_Det_00211]، ErrorDescription ص. 10

بدء التشغيل: التهيئة والبدء بواسطة EcuM

يقوم ECU State Manager بتهيئة DET باستخدام Det_Init (Service-ID 0x00). وأثناء ذلك، يمرر مؤشراً إلى مجموعة التكوين المحددة من النوع Det_ConfigType، والتي يكون محتواها خاصاً بالتنفيذ ([SWS_Det_00008]، [SWS_Det_00210]). بعد ذلك يبدأ Det_Start (Service-ID 0x02) برنامج التتبع [SWS_Det_00010]. كلتا الخدمتين متزامنتان وغير قابليْن لإعادة الدخول (non-reentrant). يوضح الرسم التخطيطي لـ R20-11 كلا الاستدعاءين تباعاً من EcuM SWS DET الشكل 1 ص. 34. ويدرج EcuM كلاً من Det_Init وDet_ReportError تبعاً لذلك كواجهات اختيارية SWS EcuM ص. 142.

لا تبرر المواصفات سبب فصل التهيئة عن البدء. تفسير: من المرجح أن هذا التقسيم الثنائي يسمح بتهيئة DET في مرحلة مبكرة جداً من بدء التشغيل وتفعيل التشغيل المنتظم في خطوة لاحقة فقط [SWS_Det_00010]. سؤال Q-fee4462bdf189dcf (مفتوح)

مخطط تسلسلي: يستدعي EcuM أولاً Det_Init بشكل متزامن مع مؤشر التكوين، ثم Det_Start بعد ذلك. المصادر: SWS DET الشكل 1 ص. 34، [SWS_Det_00008]، [SWS_Det_00010]

مسارات الإبلاغ الثلاثة ومعرفاتها

تشترك جميع خدمات الإبلاغ الثلاث في بنية المعاملات نفسها:

• ModuleId (uint16)؛
• InstanceId (uint8)، وتكون القيمة 0 للوحدات ذات المثيل الواحد؛
• ApiId (uint8)؛
• ErrorId أو FaultId (uint8).

تحدد SWS الخاصة بالوحدة المبلغة كلاً من معرفات واجهة برمجة التطبيقات (API) ومعرفات الخطأ ([SWS_Det_00009]، [SWS_Det_01001]، [SWS_Det_01003]). ويأتي معرف الوحدة (Module-ID) من قائمة وحدات البرمجيات الأساسية. وتستخدم البرمجيات الأساسية منه النطاق 0..255 فقط EXP LSA ص. 157.

يتحدد المسار الصحيح بناءً على تصنيف الخطأ. وتُعد الشروط المسبقة الأساسية المنتهكة أخطاء تطوير وتُعامل مثل التوكيد (Assertion)؛ ومن الأمثلة على ذلك أخطاء البرمجيات، أو التكامل الخاطئ، أو التكوين غير الصالح. أما بقية الأخطاء فهي أخطاء وقت التشغيل أو أخطاء إنتاج EXP LSA ص. 154. وإذا تم تكوين اكتشاف أخطاء التطوير، تبلغ وحدات BSW عن أخطاء التطوير بمعرف الوحدة المخصص لها عبر Det_ReportError SWS BSWGeneral ص. 57. ويقوم مفتاح المعالج الأولي مثل SPI_DEV_ERROR_DETECT بإظهار الاستدعاء أو إخفائه EXP LSA ص. 113.

مخطط نشاط: إذا تم انتهاك شرط مسبق أساسي، يتم الإبلاغ عن خطأ تطوير عبر Det_ReportError. وإلا فإن الصلة بالتشخيص تحدد الاختيار بين خطأ الإنتاج وخطأ وقت التشغيل (Det_ReportRuntimeError). المصادر: EXP LSA ص. 154، [SWS_Det_00009]، [SWS_Det_01001]

يتم الإبلاغ عن أخطاء وقت التشغيل، على سبيل المثال، بواسطة مشغل ADC باستخدام ADC_E_BUSY أو Dds عند تجاهل الرسائل، في كل حالة عبر Det_ReportRuntimeError (SWS Adc ص. 95، SWS Dds ص. 53). تصف وحدة BSW متطلباتها بنوع ServiceNeeds ErrorTracerNeeds. وهو يعرف الأدوار Det_ReportError وDet_ReportRuntimeError وDet_ReportTransientFault TPS BSWMDT ص. 266.

الخطافات (Hooks) وعمليات الاستدعاء الخارجية (Callouts) كجسر إلى كود المدمج

كل استدعاء لـ Det_ReportError يستدعي جميع الدوال المكونة في DetErrorHook. وبالمثل، يستدعي Det_ReportRuntimeError وDet_ReportTransientFault جميع استدعاءات callouts من DetReportRuntimeErrorCallout أو DetReportTransientFaultCallout على [SWS_Det_00501]. تمتلك الخطافات (hooks) واستدعاءات callouts توقيع الخدمة المشغلة وتتلقى المعلمات نفسها ([SWS_Det_00181]، [SWS_Det_00184]، [SWS_Det_00187]، SWS DET ص. 16). تمتلك واجهة الخطاف <User_Error_Hooks> معرف الخدمة 0x10. وهي متزامنة وقابلة لإعادة الدخول (reentrant) وتُرجع دائمًا E_OK SWS DET ص. 25.

يحدد القائم بالتكامل (integrator) ما تفعله استدعاءات callouts. في حالة أخطاء وقت التشغيل والأخطاء العابرة، ينبغي أن تقتصر على إجراءات قليلة: حفظ الحدث، أو استدعاء DEM، أو تنفيذ إجراء قصير ومناسب آخر ErrorDescription ص. 10. بعد استدعاء Det_ReportRuntimeError، يعود DET دائمًا بـ E_OK، سواء تم تكوين استدعاءات callouts أم لا (SWS DET الشكل 4 ص. 35، SWS DET الشكل 5 ص. 35).

مخطط تسلسلي: يستدعي Det_ReportRuntimeError جميع استدعاءات callouts المكونة ويعود في كل الأحوال بـ E_OK إلى جهة الإبلاغ. المصادر: SWS DET الشكل 4 ص. 35، SWS DET الشكل 5 ص. 35، [SWS_Det_00501]

في حالة Det_ReportTransientFault، يُمرر DET في المقابل القيمة المعادة من الـ callout إلى جهة الإبلاغ. وبدون callout، فإنه يُرجع E_OK (SWS DET الشكل 6 ص. 36، SWS DET الشكل 7 ص. 36). بالنسبة لاستدعاءات callouts المتعددة، يصف إصدار لاحق عملية OR منطقية للقيم المعادة: لا يتم إرجاع E_OK إلا إذا أرجعت جميع استدعاءات callouts القيمة E_OK. يُرجح أن تنطبق هذه القاعدة بالفعل على R20-11 SWS DET ص. 24. سؤال (مفتوح)

مخطط تسلسلي: يُمرر Det_ReportTransientFault القيم المعادة لاستدعاءات callouts إلى جهة الإبلاغ؛ وبدون callout يُرجع E_OK. تم تمييز عملية OR في حالة استدعاءات callouts المتعددة كافتراض. المصادر: SWS DET الشكل 6 ص. 36، SWS DET الشكل 7 ص. 36، SWS DET ص. 24

ربط مكونات البرمجيات عبر منافذ الخدمة

تصل مكونات SW-Cs إلى DET عبر واجهة العميل-الخادم DETService. تستدعي عملياته Det_ReportError أو إشعار وقت التشغيل مع معرف الوحدة النمطية للمنفذ [SWS_Det_00202]. لا يُمرر ModuleId وInstanceId بواسطة SW-C نفسها، بل تكملهما RTE بصفتها «port defined argument values»، والتي تنبع قيمها من DetModuleId وDetInstanceId في تكوين DET ([SWS_Det_00204]، [SWS_Det_00205]، [SWS_Det_00206]). بالنسبة لمكونات SW-Cs، فإن ApiId وErrorId غير قياسيين ويمكن تخصيصهما بحرية في النطاق 0x00..0xFF. القيمة المعادة هي دائمًا E_OK [SWS_Det_00203]. تستخدم واجهة المنفذ أنواع بيانات AUTOSAR من النوعين uint8 وuint16 [SWS_Det_00200].

مخطط تسلسلي: تُمرر SW-C المعلمتين ApiId وErrorId فقط. تكمل RTE المعلمتين ModuleId وInstanceId من التكوين، وتكون القيمة المعادة E_OK. المصادر: [SWS_Det_00202]، [SWS_Det_00203]، [SWS_Det_00204]، SWS DET الشكل 3 ص. 33

تكوين الإشعارات

توجد دوال الإشعار في الحاوية الاختيارية DetNotification (التعددية 0..1). وتحتوي على القائمتين DetErrorHook وDetReportRuntimeErrorCallout (0..* لكل منهما). يتم تكوين DetErrorHook في وقت ما قبل التجميع (Pre-compile time) ويتطلب نوع الدالة Std_ReturnType (*f)(uint16, uint8, uint8, uint8) SWS DET ص. 37. في R20-11 يُضاف DetReportTransientFaultCallout [SWS_Det_00501]. يُظهر مخطط المعلمات أيضًا الحاوية الإلزامية DetGeneral مع DetVersionInfoApi وDetForwardToDlt SWS DET (alt) الشكل 6 ص. 43. من DetConfigSet/DetModule وDetModuleInstance، يُشكل التكوين المنافذ Det_{Name} متضمنة معرف الوحدة النمطية ومعرف المثيل [SWS_Det_00205].

التصرف في حالة الخطأ

تُعامل أخطاء التطوير مثل توكيدات (assertions). بعد استدعاء الخطافات المكونة، لا يستمر مسار التحكم الطبيعي، ويوقف DET التنفيذ، على سبيل المثال من خلال حلقة لا نهائية أو تعليمة إيقاف (Halt) RS BSWGeneral ص. 33. ويتوافق مع ذلك الإدخال الخاص بـ Det_ReportError في R20-11 تحت Sync/Async: «Not Applicable: The function never returns» [SWS_Det_00009]. تُظهر المخططات حالة HALT هذه مع وجود خطاف مكون وبدونه (SWS DET الشكل 9.2 ص. 34، SWS DET الشكل 9.3 ص. 35).

مخطط تسلسلي: تكتشف وحدة BSW خطأ تطوير وتستدعي Det_ReportError. يستدعي DET جميع الخطافات المكونة ثم يتوقف بعد ذلك دون العودة إلى جهة الإبلاغ. المصادر: SWS DET الشكل 9.2 ص. 34، SWS DET الشكل 9.3 ص. 35، [SWS_Det_00009]، [SWS_Det_00501]

تنحرف بعض المخططات عن ذلك؛ حيث يشير مخطط تسلسلي إلى أن السلوك المتزامن أو غير المتزامن يعتمد على التنفيذ، ويرسم عودة إلى المتصل SWS DET الشكل 5 ص. 36. كما يُظهر مخطط Dio عودة بعد Det_ReportError SWS Dio الشكل 5 ص. 41. المرجع المعياري لـ R20-11 هو [SWS_Det_00009]. وجاء توضيح بيان Sync/Async لاحقًا مع R21-11 SWS DET ص. 1.

لا تقطع أخطاء وقت التشغيل والأخطاء العابرة مسار البرنامج: يعود DET بقيمة معادة إلى جهة الإبلاغ ([SWS_Det_01001]، [SWS_Det_01003]). لا يعرف DET نفسه سوى خطأ تطوير خاص به واحد. ينشأ DET_E_PARAM_POINTER (0x01) عند استدعاء Det_GetVersionInfo بمؤشر فارغ (null pointer) [SWS_Det_00301]. يحدد إصدار لاحق إبلاغ هذا الخطأ إلى جميع استدعاءات callouts المكونة. ويُرجح أن هذا هو المقصود أيضًا بالنسبة لـ R20-11 SWS DET ص. 18. سؤال Q-3a7f5865d61186d4 (مفتوح)

أدلة تفصيلية إضافية

• [SWS_Det_00009]: توقيع Det_ReportError، معرف الخدمة 0x01، لا يعود.
• [SWS_Det_01001]، [SWS_Det_01003]: إشعارات وقت التشغيل والإشعارات العابرة بمعرفي الخدمة 0x04 و0x05.
• [SWS_Det_00501]: إلزامية استدعاء جميع الخطافات واستدعاءات callouts المكونة.
• [SWS_Det_00181]، [SWS_Det_00184]، [SWS_Det_00187]: توقيعات الخطافات واستدعاءات callouts بمعرفات الخدمة 0x10 و0x11 و0x12.
• [SWS_Det_00202] إلى [SWS_Det_00206]: نموذج منفذ الخدمة لمكونات SW-Cs.
• [SWS_Det_00008]، [SWS_Det_00010]، [SWS_Det_00210]: بدء التشغيل ونوع التكوين.
• [SWS_Det_00211]، [SWS_Det_00301]: إعادة التوجيه إلى Dlt وخطأ التطوير الخاص.

تغير الإصدارات اللاحقة نطاق الوظائف. يميز إصدار من R23-11/R24-11 Det_ReportTransientFault بأنه OBSOLETE SWS DET ص. 24. ووفقًا لسجل التغييرات، يتم حذف الأخطاء العابرة مع R24-11 واستدعاءات Dlt مع R25-11 SWS DET ص. 1. في R20-11، لا تزال كلتا الوظيفتين جزءًا من المواصفة ([SWS_Det_01003]، [SWS_Det_00211]).