स्ट्रक्चर ara::tsync::UserData

संरचना ara::tsync::UserData सिंक्रोनाइज़ किए गए टाइम बेस के दायरे में कॉम्पैक्ट अनुप्रयोग-विशिष्ट पेलोड डेटा के ट्रांसमिशन के लिए कार्य करती है। यह तीन बाइट की अपरिवर्तनीय ऊपरी सीमा के साथ एक स्थिर बफ़र का प्रबंधन करती है, जिसे kMaxUserDataSize के माध्यम से परिभाषित किया गया है [SWS_TS_14231]। अनुप्रयोग ऐरे में पेलोड डेटा लिखते हैं और फ़ील्ड size के माध्यम से वास्तव में मान्य बाइट्स की संख्या को चिह्नित करते हैं [SWS_TS_14232]। एक केंद्रीय बाधा के रूप में, उपयोग करने वाले प्रोग्राम तर्क को यह सुनिश्चित करना चाहिए कि size कभी भी निर्धारित अधिकतम क्षमता से अधिक न हो और अप्रारंभीकृत बफ़र क्षेत्रों तक पहुँचने से बचा जाए।

अधिक ›

संदर्भ

डेटा संरचना ara::tsync::UserData AUTOSAR Adaptive Platform के समय सिंक्रोनाइज़ेशन (tsync) के कार्यात्मक क्लस्टर के भीतर सिंक्रोनाइज़ किए गए टाइम बेस के संदर्भ में अनुप्रयोग-विशिष्ट पेलोड डेटा को इनकैप्सुलेट करने के लिए कार्य करती है। संरचना को हेडर फ़ाइल ara/tsync/synchronized_time_base_status.h में घोषित किया गया है। इसकी प्राथमिक ज़िम्मेदारी अनुप्रयोग-स्तरीय अतिरिक्त डेटा के लिए एक कॉम्पैक्ट, स्थिर रूप से आकार का मेमोरी क्षेत्र प्रदान करना है, जिसे समय की जानकारी के साथ प्रेषित या मूल्यांकित किया जाता है। इस पेलोड डेटा की अधिकतम सीमा स्थिर स्थिरांक kMaxUserDataSize द्वारा ठीक तीन बाइट निर्धारित की गई है [SWS_TS_14231]। वास्तविक पेलोड बाइट्स के बफ़रिंग के लिए ara::core::Array<ara::core::Byte, kMaxUserDataSize> प्रकार का ऐरे data उपयोग किया जाता है [SWS_TS_14233]। इस बफ़र को फ़ील्ड size द्वारा पूरक किया जाता है, जो बफ़र में वास्तव में मान्य पेलोड डेटा बाइट्स की संख्या को इंगित करता है [SWS_TS_14232]। Interpretation: हेडर ara/tsync/synchronized_time_base_status.h में परिभाषा स्थान के कारण, UserData मुख्य रूप से नियंत्रण फ़्लैग या काउंटर जैसी छोटी अनुप्रयोग-संबंधित अतिरिक्त जानकारी प्रेषित करने के लिए एक स्थिति फ़ील्ड के रूप में कार्य कर सकता है। इंटरैक्शन पार्टनर के रूप में आमतौर पर टाइम-प्रोवाइडिंग सेवाएँ और प्राप्तकर्ता अनुप्रयोग दिखाई देते हैं, जो सिंक्रोनाइज़ किए गए टाइम बेस की स्थिति की पूछताछ करते हैं या इसे आगे अग्रेषित करते हैं। प्रश्न Q-a0fb20686141f042 (खुला)

जीवनचक्र

एक सामान्य C++ संरचना (Value Object) के रूप में, UserData का कोई जटिल आंतरिक जीवनचक्र नहीं होता है और यह डायनेमिक मेमोरी आवंटन को पूरी तरह से छोड़ देता है। इंस्टेंस आमतौर पर स्टैक पर या उच्च-स्तरीय स्थिति संरचनाओं के एम्बेडेड डेटा तत्व के रूप में बनाए जाते हैं। आरंभीकरण सीधे सदस्य आरंभीकरण या मानक C++ असाइनमेंट के माध्यम से होता है। स्वामित्व संबंधों के संबंध में, संरचना मान सिमेंटिक्स (value semantics) के अधीन है: निर्माता घटक पूरी तरह से अपने स्थानीय इंस्टेंस के मालिक होते हैं और इसे कॉपी या संदर्भ द्वारा इंटरफ़ेस में पास करते हैं। चूँकि UserData कोई आंतरिक सिंक्रोनाइज़ेशन तंत्र या म्यूटेक्स लॉक लागू नहीं करता है, इसलिए कई थ्रेड्स से एक ही इंस्टेंस पर समवर्ती रीड और राइट एक्सेस थ्रेड-सुरक्षित नहीं है। अनुप्रयोगों को बाहरी सिंक्रोनाइज़ेशन उपायों द्वारा एक साथ पहुँच को सुरक्षित करना चाहिए, जबकि समवर्ती संदर्भों में एक दूसरे से स्वतंत्र इंस्टेंस का सुरक्षित रूप से उपयोग किया जा सकता है। विनाश के लिए संसाधनों की किसी स्पष्ट सफ़ाई की आवश्यकता नहीं होती है, क्योंकि निहित डेटा फ़ील्ड data [SWS_TS_14233] स्थिर रूप से आरक्षित होता है।

उपयोग पथ

एक विशिष्ट उपयोग पथ में डेटा बफ़र को भरना, अग्रेषित करना और मूल्यांकन करना शामिल है। सबसे पहले, एक भेजने वाला या स्थिति प्रदान करने वाला घटक UserData का एक इंस्टेंस बनाता है। इसके बाद, पेलोड डेटा को ऐरे data में कॉपी किया जाता है, जहाँ अधिकतम kMaxUserDataSize बाइट्स पर कब्जा किया जा सकता है [SWS_TS_14231], [SWS_TS_14233]। इसके तुरंत बाद, घटक फ़ील्ड size को लिखे गए बाइट्स की वास्तविक संख्या पर सेट करता है [SWS_TS_14232]। प्राप्तकर्ता पक्ष पर, प्रसंस्करण अनुप्रयोग पहले size [SWS_TS_14232] के मान की जाँच करता है। यदि size शून्य से अधिक है, तो अनुप्रयोग बफ़र data [SWS_TS_14233] से ठीक इसी मान्य उपसर्ग (prefix) को पढ़ता है। इस सीमा के बाहर के मान, यानी इंडेक्स size से kMaxUserDataSize - 1 तक, अनदेखा कर दिए जाते हैं, क्योंकि उनमें अपरिभाषित या पुराना अवशिष्ट डेटा हो सकता है।

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

UserData में त्रुटि स्थितियाँ मुख्य रूप से आकार विनिर्देश और बफ़र क्षमता के बीच विसंगतियों के कारण होती हैं। यदि फ़ील्ड size एक ऐसा मान लेता है जो तीन बाइट के परिभाषित अधिकतम आकार kMaxUserDataSize से अधिक है [SWS_TS_14231], तो यह विनिर्देश सीमाओं का उल्लंघन है। ऐसे मामले में, data [SWS_TS_14233] को पुनरावृत्त रूप से पढ़ने पर बफ़र ओवरफ़्लो या परिभाषित ऐरे सीमाओं के बाहर पहुँच का जोखिम होता है। एक अन्य जोखिम data को गलत तरीके से पढ़ना है जब size शून्य के बराबर हो [SWS_TS_14232], क्योंकि इस स्थिति में कोई मान्य पेलोड डेटा मौजूद नहीं होता है। संरचना द्वारा स्वयं कोई त्रुटि कोड या अपवाद उत्पन्न नहीं किए जाते हैं; पूर्वशर्तों का सत्यापन - विशेष रूप से size <= kMaxUserDataSize - इस प्रकार पूरी तरह से अनुप्रयोग प्रोग्राम तर्क पर निर्भर करता है।