नेमस्पेस ara::phm::supervised_entities::{ <hierarchical-namespace-list-lower-skeleton>}

यह नेमस्पेस Platform Health Management में मॉनिटर की गई एंटिटीज़ के चेकपॉइंट्स के लिए दृढ़ता से टाइप किए गए एन्यूमिरेशन प्रदान करता है [SWS_PHM_00424]। प्रत्येक मॉनिटर की गई एंटिटी को बेस टाइप std::uint32_t के साथ अपना स्वयं का स्कोप्ड एन्यूमिरेशन प्राप्त होता है, जिसके घोषित एन्यूमरेटरों को चेकपॉइंट्स के रूप में इंटरफ़ेस ara::phm::PhmSupervisedEntityInterface को रिपोर्ट किया जाता है [SWS_PHM_00424], [SWS_PHM_00425]। टाइप-सुरक्षित नेमस्पेस में स्थिर प्रावधान के माध्यम से, कंपाइल-टाइम पर विभिन्न एंटिटीज़ के चेकपॉइंट्स के भ्रम को विश्वसनीय रूप से रोका जाता है।

अधिक ›

संदर्भ

C++ नेमस्पेस namespace ara::phm::supervised_entities::{ <hierarchical-namespace-list-lower-skeleton>} AUTOSAR Adaptive Platform के Platform Health Management (PHM) के भीतर मॉनिटर की गई कार्यात्मक इकाइयों (Supervised Entities) के टाइप-सुरक्षित चेकपॉइंट्स (Checkpoints) के लिए एक समर्पित क्षेत्र के रूप में कार्य करता है। [SWS_PHM_00424] के अनुसार, इस नेमस्पेस में enum class {<phmssi-sn>} : std::uint32_t प्रारूप के स्कोप्ड एन्यूमिरेशन शामिल हैं, जो इंटरफ़ेस ara::phm::PhmSupervisedEntityInterface के लिए असतत चेकपॉइंट्स को परिभाषित करते हैं। चेकपॉइंट सूची के प्रत्येक कॉन्फ़िगर किए गए तत्व के लिए एक अद्वितीय C++ एन्यूमरेटर घोषणा मौजूद है [SWS_PHM_00425]। यह इंटरैक्शन तीन कार्यात्मक मुख्य घटकों को एक साथ बांधता है: मॉनिटर किया गया एप्लिकेशन सॉफ़्टवेयर (Supervised Entity), नेमस्पेस द्वारा मॉडल किए गए टाइप किए गए चेकपॉइंट्स, और प्लेटफ़ॉर्म इंटरफ़ेस ara::phm::PhmSupervisedEntityInterface, जिसके माध्यम से मॉनिटरिंग इवेंट्स को PHM सेवा में अग्रेषित किया जाता है।

संदर्भ आरेख: मॉनिटर किए गए एप्लिकेशन सॉफ़्टवेयर, टाइप किए गए चेकपॉइंट गणना (enumeration) और प्लेटफ़ॉर्म इंटरफ़ेस के बीच परस्पर क्रिया। स्रोत: [SWS_PHM_00424], [SWS_PHM_00425]

जीवनचक्र

नेमस्पेस के भीतर के प्रकार और स्थिरांक स्थैतिक कंपाइल-टाइम विशेषता रखते हैं। वे हीप पर आवंटन या विमोचन के माध्यम से किसी गतिशील रनटाइम जीवनचक्र के अधीन नहीं होते हैं, बल्कि उन्हें अंतर्निहित प्रकार std::uint32_t के साथ टाइप किए गए C++11 स्कोप्ड एन्यूमिरेशन के रूप में प्रदान किया जाता है [SWS_PHM_00424]। व्याख्या: परिभाषाएं आमतौर पर निर्माण प्रक्रिया के दौरान AUTOSAR सेवा विवरण से स्वचालित रूप से जनरेट की जाती हैं, क्योंकि पथ और पहचानकर्ता इंटरफ़ेस के मॉडल मापदंडों पर निर्भर करते हैं। प्रश्न (खुला) समावेशन के लिए, मानक प्रत्येक मॉनिटर की गई इकाई के लिए #include "ara/phm/supervised_entities/{ <si-namespace-derived-directory-path-lower>}/{<phmssi-sn>}.h" के तहत एक समर्पित हेडर फ़ाइल उपलब्ध कराता है, जबकि सामान्य प्रकार की घोषणाओं को फॉरवर्डिंग हेडर #include "ara/phm/phm_fwd.h" के माध्यम से अग्रेषित-घोषित किया जा सकता है [SWS_PHM_00424]। इस प्रकार एन्यूमिरेटर स्थिरांक संपूर्ण प्रक्रिया जीवनकाल के दौरान एप्लिकेशन के लिए अपरिवर्तनीय रूप से उपलब्ध रहते हैं [SWS_PHM_00425]।

उपयोग पथ

Supervised Entity के रूप में कार्य करने वाले सॉफ़्टवेयर घटकों के लिए विशिष्ट उपयोग पथ तीन क्रमिक चरणों में विभाजित है:

• हेडर समावेशन: एप्लिकेशन फ़ाइल पथ ara/phm/supervised_entities/{ <si-namespace-derived-directory-path-lower>}/{<phmssi-sn>}.h या केंद्रीय अग्रेषण ara/phm/phm_fwd.h के माध्यम से मॉनिटर की गई इकाई के जनरेट किए गए हेडर को शामिल करता है [SWS_PHM_00424]।
• इंटरफ़ेस आरंभीकरण: एप्लिकेशन उस इंटरफ़ेस ara::phm::PhmSupervisedEntityInterface को त्वरित (instantiate) या बाध्य करता है, जिसके लिए एन्यूमिरेशन के चेकपॉइंट घोषित किए गए थे [SWS_PHM_00424]।
• चेकपॉइंट सिग्नलिंग: एल्गोरिदम में प्रासंगिक नियंत्रण बिंदुओं से गुजरते समय, एप्लिकेशन नेमस्पेस से संबंधित एन्यूमिरेटर {<symbol-phm-checkpoint>} का चयन करता है [SWS_PHM_00425] और इसे ara::phm::PhmSupervisedEntityInterface के इंस्टेंस को रिपोर्ट करता है [SWS_PHM_00424]।

अंतर्निहित प्रकार std::uint32_t [SWS_PHM_00424] से बाइंडिंग और प्रत्येक नियंत्रण बिंदु [SWS_PHM_00425] के स्पष्ट मान असाइनमेंट के माध्यम से, रनटाइम पर संबंधित प्रोग्राम चरणों की प्रकार-सुरक्षित और त्रुटिरहित पहचान की गारंटी दी जाती है।

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

इस नेमस्पेस के गलत उपयोग मुख्य रूप से मॉडल-संबंधी और प्रकार-संबंधी गलत कॉन्फ़िगरेशन के परिणामस्वरूप होते हैं। चूंकि यह एक enum class है [SWS_PHM_00424], इसलिए C++ प्रकार प्रणाली अंतर्निहित प्रकार रूपांतरणों को रोकती है; इस प्रकार गलत डेटा प्रकारों या अन्य Supervised Entities के एन्यूमिरेटर का उपयोग पहले ही संकलन समय पर पकड़ लिया जाता है। यदि मॉडल विवरण में कॉन्फ़िगरेशन एन्यूमिरेटर सूची से सटीक रूप से मेल नहीं खाता है, तो यह रनटाइम त्रुटियों का कारण बन सकता है: [SWS_PHM_00425] के अनुसार, प्रत्येक चेकपॉइंट के लिए एक संगत एन्यूमिरेटर घोषित होना चाहिए। व्याख्या: यदि कोई एप्लिकेशन अस्वीकार्य प्रकार रूपांतरण या पुराने हेडर फ़ाइलों के कारण मॉडल में अनकॉन्फ़िगर किए गए std::uint32_t मान को ara::phm::PhmSupervisedEntityInterface में पास करता है, तो PHM सेवा संभवतः इस चेकपॉइंट को मैप नहीं कर पाएगी और इसे एक निगरानी उल्लंघन मानेगी। प्रश्न Q-b8fb7472f6ea8d10 (खुला)