Default Error Tracer (DET)

Default Error Tracer, BSW मॉड्यूल और SW-Cs से त्रुटि संदेश केंद्रीय रूप से प्राप्त करता है। इसके लिए विकास त्रुटियों के लिए Det_ReportError, रनटाइम त्रुटियों के लिए Det_ReportRuntimeError और क्षणिक (transient) त्रुटियों के लिए Det_ReportTransientFault उपलब्ध हैं, प्रत्येक मॉड्यूल, इंस्टेंस, API और त्रुटि पहचानकर्ता के साथ। DET प्रत्येक संदेश को इंटीग्रेटर के सभी कॉन्फ़िगर किए गए हुक या कॉलआउट पर अग्रेषित करता है [SWS_Det_00501]। EcuM से Det_Init और Det_Start संचालन शुरू करते हैं। सबसे महत्वपूर्ण सीमा शर्त: R20-11 में Det_ReportError कॉलर पर वापस नहीं लौटता है, बल्कि एक असर्शन की तरह प्रोग्राम प्रवाह को रोक देता है [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_Init और उसके बाद Det_Start के साथ DET को संचालन में लाता है ([SWS_Det_00008], SWS DET चित्र 1 पृ. 34)।

संदर्भ आरेख (Context diagram): DET, BSW मॉड्यूल और SW-Cs से संदेश प्राप्त करता है और उन्हें इंटीग्रेटर हुक तथा वैकल्पिक रूप से Dlt पर अग्रेषित करता है। स्रोत: SWS DET चित्र 2 पृ. 28, [SWS_Det_00202]

DET संदेशों का स्वयं मूल्यांकन नहीं करता है। प्रत्येक रिपोर्टिंग सेवा उन सभी हुक या कॉलआउट को कॉल करती है जो इसके लिए कॉन्फ़िगर किए गए हैं (DetErrorHook, DetReportRuntimeErrorCallout, DetReportTransientFaultCallout), और वह भी संदेश के समान पैरामीटर के साथ [SWS_Det_00501]। इस इंटीग्रेटर कोड के माध्यम से DET, DEM या त्रुटि मेमोरी तक भी पहुँचता है। कॉलआउट को संक्षिप्त, उचित कार्रवाइयों तक सीमित रहना चाहिए ErrorDescription पृ. 10।

SW-Cs क्लाइंट-सर्वर इंटरफ़ेस DETService के माध्यम से रिपोर्ट करते हैं। RTE DET कॉन्फ़िगरेशन से \"port defined argument values\" के रूप में ModuleId और InstanceId जोड़ता है, SW-C को हमेशा E_OK वापस मिलता है ([SWS_Det_00203], [SWS_Det_00204])।

त्रुटि स्थितियों के लिए यह महत्वपूर्ण है कि तीनों सेवाएँ कैसे वापस लौटती हैं। Det_ReportError R20-11 में वापस नहीं लौटता है: हुक के बाद नियंत्रण प्रवाह रोक दिया जाता है, ठीक एक असर्शन की तरह ([SWS_Det_00009], RS BSWGeneral पृ. 33)। इसके विपरीत रनटाइम संदेश E_OK के साथ वापस लौटते हैं। क्षणिक संदेश कॉलआउट मान को आगे बढ़ाते हैं, बिना कॉलआउट के E_OK SWS DET चित्र 6 पृ. 36। क्षणिक त्रुटियाँ R24-11 के साथ समाप्त हो जाती हैं, Dlt कॉल्स R25-11 के साथ समाप्त हो जाती हैं SWS DET पृ. 1।

अनुक्रम आरेख (Sequence diagram): विकास त्रुटि के मामले में, 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_Det.h से Dlt_DetForwardErrorTrace के माध्यम से Dlt पर वैकल्पिक अग्रेषण का उल्लेख करता है ([SWS_Det_00211], SWS DET चित्र 2 पृ. 28)। DET केवल कॉलआउट में इंटीग्रेटर-विशिष्ट कोड के माध्यम से DEM और RTE तक पहुँचता है ErrorDescription पृ. 10।

संदर्भ आरेख (Context diagram): 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 (सर्विस ID 0x00) के साथ प्रारंभ करता है। ऐसा करते समय, यह Det_ConfigType प्रकार के चयनित कॉन्फ़िगरेशन सेट पर एक पॉइंटर पास करता है, जिसकी सामग्री कार्यान्वयन-विशिष्ट होती है ([SWS_Det_00008], [SWS_Det_00210])। इसके बाद Det_Start (सर्विस 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 (खुला)

अनुक्रम आरेख (Sequence diagram): 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)।

API और त्रुटि पहचानकर्ता प्रत्येक रिपोर्टिंग मॉड्यूल के SWS द्वारा निर्धारित किए जाते हैं ([SWS_Det_00009], [SWS_Det_01001], [SWS_Det_01003])। मॉड्यूल ID बेसिक सॉफ़्टवेयर मॉड्यूल की सूची से आती है। बेसिक सॉफ़्टवेयर इसमें से केवल 0..255 रेंज का उपयोग करता है EXP LSA पृ. 157।

कौन सा मार्ग सही है, यह त्रुटि वर्गीकरण से तय होता है। उल्लंघन की गई मूलभूत पूर्वशर्तें विकास त्रुटियाँ हैं और इन्हें असर्शन की तरह माना जाता है; उदाहरण सॉफ़्टवेयर त्रुटियाँ, दोषपूर्ण एकीकरण या अमान्य कॉन्फ़िगरेशन हैं। शेष त्रुटियाँ रनटाइम या उत्पादन त्रुटियाँ हैं EXP LSA पृ. 154। यदि विकास त्रुटि पहचान कॉन्फ़िगर की गई है, तो BSW मॉड्यूल Det_ReportError के माध्यम से अपने सौंपे गए मॉड्यूल ID के साथ विकास त्रुटियों की रिपोर्ट करते हैं SWS BSWGeneral पृ. 57। SPI_DEV_ERROR_DETECT जैसा एक प्रीप्रोसेसर स्विच कॉल को दिखाता या छुपाता है EXP LSA पृ. 113।

गतिविधि आरेख (Activity diagram): यदि किसी मूलभूत पूर्वशर्त का उल्लंघन होता है, तो 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।

इंटीग्रेटर कोड के सेतु के रूप में हुक और कॉलआउट

Det_ReportError का प्रत्येक कॉल DetErrorHook में कॉन्फ़िगर किए गए सभी फ़ंक्शनों को कॉल करता है। इसी तरह Det_ReportRuntimeError और Det_ReportTransientFault क्रमशः DetReportRuntimeErrorCallout या DetReportTransientFaultCallout के सभी कॉलआउट को कॉल करते हैं [SWS_Det_00501]। हुक और कॉलआउट में ट्रिगर करने वाली सेवा का सिग्नेचर होता है और समान पैरामीटर प्राप्त होते हैं ([SWS_Det_00181], [SWS_Det_00184], [SWS_Det_00187], SWS DET पृ. 16)। हुक इंटरफ़ेस <User_Error_Hooks> में सर्विस ID 0x10 होती है। यह सिंक्रोनस और गैर-पुनःप्रवेशी (reentrant) है और हमेशा E_OK लौटाता है SWS DET पृ. 25।

कॉलआउट क्या करते हैं, यह इंटीग्रेटर तय करता है। रनटाइम और क्षणिक त्रुटियों के लिए, उन्हें कुछ कार्रवाइयों तक सीमित रहना चाहिए: घटना को सहेजना, DEM को कॉल करना या कोई अन्य संक्षिप्त, उचित कार्रवाई करना ErrorDescription पृ. 10। Det_ReportRuntimeError के कॉल के बाद, DET हमेशा E_OK के साथ वापस लौटता है, चाहे कॉलआउट कॉन्फ़िगर किए गए हों या नहीं (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 लौटाता है। कई Callouts के मामले में OR संयोजन को एक धारणा के रूप में चिह्नित किया गया है। स्रोत: SWS DET चित्र 6 पृ. 36, SWS DET चित्र 7 पृ. 36, SWS DET पृ. 24

Service-Ports के माध्यम से सॉफ्टवेयर घटकों का जुड़ाव

SW-Cs क्लाइंट-सर्वर इंटरफ़ेस DETService के माध्यम से DET को एक्सेस करते हैं। इसके ऑपरेशन्स Det_ReportError या पोर्ट की मॉड्यूल ID के साथ रनटाइम रिपोर्ट को कॉल करते हैं [SWS_Det_00202]। ModuleId और InstanceId स्वयं SW-C द्वारा पास नहीं किए जाते हैं। RTE उन्हें “port defined argument values” के रूप में जोड़ता है, जिनके मान DET कॉन्फ़िगरेशन के DetModuleId और DetInstanceId से आते हैं ([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 प्री-कंपाइल समय पर कॉन्फ़िगर किया जाता है और इसके लिए फ़ंक्शन प्रकार Std_ReturnType (*f)(uint16, uint8, uint8, uint8) की आवश्यकता होती है SWS DET पृ. 37। R20-11 में DetReportTransientFaultCallout जोड़ा गया है [SWS_Det_00501]। पैरामीटर आरेख DetVersionInfoApi और DetForwardToDlt के साथ अनिवार्य कंटेनर DetGeneral को भी दिखाता है SWS DET (alt) चित्र 6 पृ. 43। DetConfigSet/DetModule और DetModuleInstance से कॉन्फ़िगरेशन मॉड्यूल और इंस्टेंस पहचानकर्ता [SWS_Det_00205] सहित पोर्ट्स Det_{Name} बनाता है।

त्रुटि की स्थिति में व्यवहार

डेवलपमेंट त्रुटियों को असर्शन्स की तरह माना जाता है। कॉन्फ़िगर किए गए हुक्स को कॉल करने के बाद, सामान्य नियंत्रण प्रवाह जारी नहीं रहता है, और DET निष्पादन को रोक देता है, उदाहरण के लिए एक अनंत लूप या हाल्ट निर्देश RS BSWGeneral पृ. 33 के माध्यम से। यह Sync/Async के अंतर्गत R20-11 में Det_ReportError की प्रविष्टि से मेल खाता है: “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 को शून्य सूचक (नल पॉइंटर) के साथ कॉल किया जाता है [SWS_Det_00301]। बाद का एक संस्करण यह निर्धारित करता है कि इस त्रुटि की सूचना सभी कॉन्फ़िगर किए गए Callouts को दी जाती है। संभवतः R20-11 के लिए भी यही अर्थ अभिप्रेत है SWS DET पृ. 18। प्रश्न Q-3a7f5865d61186d4 (खुला)

आगे विस्तृत साक्ष्य

• [SWS_Det_00009]: Det_ReportError का सिग्नेचर, सर्विस ID 0x01, वापस नहीं लौटता है।
• [SWS_Det_01001], [SWS_Det_01003]: सर्विस IDs 0x04 और 0x05 के साथ रनटाइम और क्षणिक रिपोर्ट्स।
• [SWS_Det_00501]: सभी कॉन्फ़िगर किए गए हुक्स और Callouts को कॉल करने की अनिवार्यता।
• [SWS_Det_00181], [SWS_Det_00184], [SWS_Det_00187]: सर्विस IDs 0x10, 0x11 और 0x12 के साथ हुक्स और Callouts के सिग्नेचर।
• [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 के साथ क्षणिक त्रुटियों को और R25-11 के साथ Dlt कॉल्स को हटा दिया गया है SWS DET पृ. 1। R20-11 में दोनों फ़ंक्शन अभी भी विनिर्देश का हिस्सा हैं ([SWS_Det_01003], [SWS_Det_00211])।