स्ट्रक्चर ara::diag::SovdSwUpdate::UpdatePackageStatus

संरचना ara::diag::SovdSwUpdate::UpdatePackageStatus SOVD डायग्नोस्टिक्स अनुप्रयोगों के लिए एक सॉफ़्टवेयर अपडेट प्रक्रिया की स्थिति, चरण और प्रगति की जानकारी प्रदान करती है [SWS_DM_01902]। इसे GetUpdatePackageStatus को कॉल करके प्राप्त किया जाता है और यह निष्पादन चरणों, प्रतिशत प्रगति के साथ-साथ व्यक्तिगत चरणों की निरंतर निगरानी को सक्षम बनाता है। किसी त्रुटि की स्थिति में, संरचना विफलता का संकेत देती है और वैकल्पिक त्रुटि फ़ील्ड के माध्यम से डोमेन DiagSovdErrc [SWS_DM_01909] से सटीक त्रुटि कोड स्थानांतरित करती है। एक शुद्ध डेटा ट्रांसफर ऑब्जेक्ट के रूप में, संरचना को संभवतः समवर्ती एक्सेस के मामले में अनुप्रयोग-पक्षीय सिंक्रोनाइज़ेशन की आवश्यकता होती है। प्रश्न Q-1d228b6cab1b505e (खुला)

अधिक ›

संदर्भ

डेटा संरचना ara::diag::SovdSwUpdate::UpdatePackageStatus AUTOSAR Adaptive Platform SWS Diagnostics §8.58.5 “Struct: UpdatePackageStatus” [SWS_DM_01902] के मॉड्यूल diag का हिस्सा है। यह Service-Oriented Vehicle Diagnostics (SOVD) के ढांचे के भीतर एक सॉफ़्टवेयर अपडेट पैकेज की वर्तमान स्थिति को कैप्चर करने और प्रदान करने के लिए एक मानकीकृत सूचना वाहक के रूप में कार्य करती है। API फ़ंक्शन ara::diag::SovdSwUpdate::GetUpdatePackageStatus के माध्यम से, स्थिति ऑब्जेक्ट डायग्नोस्टिक इंटरफ़ेस द्वारा जनरेट किया जाता है और क्वेरी करने वाले इंस्टेंस को पास किया जाता है SWS Diagnostics §8.58.2.1.3.5 “GetUpdatePackageStatus” [SWS_DM_01921]।

सिस्टम आर्किटेक्चर के भीतर, संरचना निष्पादित करने वाले सेवा घटक SovdSwUpdate और बाह्य या आंतरिक डायग्नोस्टिक क्लाइंट्स के बीच एक डिकूपलिंग तत्व के रूप में कार्य करती है। जबकि सेवा वास्तविक पैकेज प्रसंस्करण और स्थापना को नियंत्रित करती है, UpdatePackageStatus प्रसंस्करण चरणों, प्रगति और संभावित त्रुटि स्थितियों के एक स्नैपशॉट को समाहित करती है [SWS_DM_01902]।

जीवनचक्र

एक शुद्ध डेटा कंटेनर (struct) के रूप में, UpdatePackageStatus का कोई अपना आंतरिक स्थिति लॉजिक नहीं होता है और यह कोई स्वतंत्र संसाधन प्रबंधन नहीं करता है SWS Diagnostics §8.58.5 “Struct: UpdatePackageStatus” [SWS_DM_01902]। GetUpdatePackageStatus के कॉल के दौरान इंस्टेंस बनाए जाते हैं, वर्तमान स्थिति मानों से भरे जाते हैं और मान द्वारा कॉलर को वापस लौटाए जाते हैं [SWS_DM_01921]। जीवनकाल प्राप्तकर्ता के स्कोप से बंधा होता है और उसके विनाश के साथ समाप्त होता है।

यद्यपि C++ ऑब्जेक्ट निष्क्रिय है, इसके सदस्य चर अंतर्निहित अद्यतन प्रक्रिया के जीवनचक्र का प्रतिनिधित्व करते हैं। SovdUpdatePhase प्रकार का फ़ील्ड phase समग्र प्रक्रिया के वर्तमान चरण का वर्णन करता है SWS Diagnostics §8.58.5.1.2 “phase” [SWS_DM_01903], जबकि SovdUpdateStatus प्रकार का चर status इस चरण की विशिष्ट स्थिति को इंगित करता है SWS Diagnostics §8.58.5.1.4 “status” [SWS_DM_01904]। चूँकि कोई आंतरिक म्यूटेक्स या सिंक्रोनाइज़ेशन तंत्र निर्दिष्ट नहीं हैं, इसलिए एक ही इंस्टेंस पर समवर्ती एक्सेस के लिए उपयोगिता द्वारा बाहरी सुरक्षा की आवश्यकता होती है।

उपयोग पथ

विशिष्ट उपयोग पथ में डायग्नोस्टिक क्लाइंट द्वारा पैकेज अद्यतन की चक्रीय या घटना-आधारित निगरानी शामिल है:

• स्थिति क्वेरी: क्लाइंट इंटरफ़ेस SovdSwUpdate पर विधि GetUpdatePackageStatus को कॉल करता है SWS Diagnostics §8.58.2.1.3.5 “GetUpdatePackageStatus” [SWS_DM_01921]।
• चरण और स्थिति मूल्यांकन: ऑब्जेक्ट [SWS_DM_01902] प्राप्त करने के बाद, क्लाइंट यह निर्धारित करने के लिए चर phase [SWS_DM_01903] और status [SWS_DM_01904] की जाँच करता है कि प्रक्रिया सामान्य रूप से आगे बढ़ रही है या पूर्ण हो चुकी है।
• प्रगति विश्लेषण: यदि कोई समग्र प्रतिशत प्रगति उपलब्ध है, तो वैकल्पिक सदस्य progress के माध्यम से इसका मूल्यांकन किया जाता है SWS Diagnostics §8.58.5.1.3 “progress” [SWS_DM_01905]। अतिरिक्त उप-चरणों को वेक्टर subprogress के माध्यम से देखा जा सकता है [SWS_DM_01906]।
• चरण प्रदर्शन: लॉगिंग या उपयोगकर्ता मार्गदर्शन के लिए, पाठ्य चरण नाम step [SWS_DM_01907] और स्थानीयकरण कुंजी step_translation_id का उपयोग किया जाता है [SWS_DM_01908]।

अनुक्रम आरेख: UpdatePackageStatus के सदस्य चरों की स्थिति क्वेरी और मूल्यांकन के लिए कॉल अनुक्रम। स्रोत: [SWS_DM_01921], [SWS_DM_01902], [SWS_DM_01904], [SWS_DM_01909]।

त्रुटि परिदृश्य

अद्यतन प्रवाह में त्रुटियों को डेटा संरचना की विशिष्ट विशेषताओं के माध्यम से पारदर्शी बनाया जाता है:

• विफल स्थिति: यदि प्रक्रिया में कोई समस्या आती है, तो फ़ील्ड status “failed” स्थिति ग्रहण कर लेता है [SWS_DM_01904]।
• त्रुटि विवरण: इस त्रुटि मामले में, ara::core::Optional<ara::diag::DiagSovdErrc> प्रकार का फ़ील्ड error उत्पन्न त्रुटि कोड निर्दिष्ट करता है SWS Diagnostics §8.58.5.1.1 “error” [SWS_DM_01909]।
• नियमित प्रवाह: यदि कोई त्रुटि नहीं है, तो वैकल्पिक फ़ील्ड error अप्रयुक्त रहना चाहिए, क्योंकि विनिर्देश के अनुसार यह स्पष्ट रूप से “failed” स्थिति से जुड़ा हुआ है [SWS_DM_01909]। प्रश्न Q-c26d1c1d25d7e938 (खुला)
• इंटरफ़ेस त्रुटि: यदि प्लेटफ़ॉर्म स्तर पर API कॉल GetUpdatePackageStatus विफल हो जाता है, तो संभवतः स्थिति ऑब्जेक्ट के स्थान पर एक प्लेटफ़ॉर्म-विशिष्ट त्रुटि स्थिति वापस की जाएगी [SWS_DM_01921]। प्रश्न Q-b029f911ee738cb1 (खुला)