بنية ara::diag::DoIPGroupIdentification::GidStatus

يُستخدم الهيكل ara::diag::DoIPGroupIdentification::GidStatus كحاوية بيانات لبيانات الاستجابة الإيجابية عند الاستعلام عن تعريف مجموعة DoIP [SWS_DM_00721]. ويوفره Adaptive Application عندما يطلب Diagnostic Management تعريف المجموعة عبر الواجهة GetGidStatus في حال عدم تهيئة DoIpInstantiation.gid [SWS_DM_00813]. ينقل الهيكل قيم GID المحددة مباشرة إلى Diagnostic Manager لإعادة توجيهها في بروتوكول DoIP. ويقتصر بشكل صارم على الاستجابات الناجحة ولا يحتوي على آليات لسيناريوهات الأخطاء.

المزيد ›

السياق

يمثل هيكل البيانات ara::diag::DoIPGroupIdentification::GidStatus بيانات الاستجابة الإيجابية لتعريف المجموعة في النظام الفرعي DoIP (Diagnostic over IP) لـ AUTOSAR Adaptive Platform [SWS_DM_00721]، AUTOSAR_AP_SWS_Diagnostics §8.34.2 «Struct: GidStatus». ويُستخدم كحاوية نتائج قياسية لبيانات تعريف المجموعة (GID) عندما تطلب عملاء تشخيص خارجيين معلومات حول تعريف المركبة أو المجموعة عبر DoIP. وفي منظومة النظام، يتفاعل ثلاثة شركاء رئيسيين: عميل DoIP الخارجي، وAUTOSAR Diagnostic Management (DM)، بالإضافة إلى Adaptive Application المخصص للتطبيق والذي يقدم الواجهة ara::diag::DoIPGroupIdentification. وما لم تكن GID محددة بشكل ثابت عبر معامل التهيئة DoIpInstantiation.gid، فإن DM ملزم وفقًا للمواصفة باسترداد GID عبر واجهة التطبيق [SWS_DM_00813]، AUTOSAR_AP_SWS_Diagnostics §8.34.1 «Providing the GID in DoIP protocol messages using application interface».

دورة الحياة

بصفته هيكل بيانات ++C‏ (struct)، لا يمتلك GidStatus دورة حياة مستقلة لعملية أو خدمة، بل يعمل ككائن نقل بيانات بحت [SWS_DM_00721]. ويُنشئ Adaptive Application المسؤول مثيلًا من GidStatus ويملؤه ببيانات التعريف الحالية بمجرد استدعاء دالة الاستعلام GetGidStatus [SWS_DM_00724]، AUTOSAR_AP_SWS_Diagnostics §8.34.1.1.3.1 «GetGidStatus». تفسير: يُرجح أن يُنشأ الهيكل عادةً ككائن قيمة مؤقت على مكدس الذاكرة، ويُمرر كجزء من القيمة المُرجعة عبر دلالات النسخ أو النقل إلى DM، وبذلك تنتهي دورة حياته بعد معالجة رسالة DoIP في DM. سؤال Q-4974fdbc2c6accbb (مفتوح) ونظرًا لإمكانية حدوث طلبات تشخيص متعددة أو معالجة متوازية لرسائل DoIP، يجب توفير البيانات المحفوظة داخل الهيكل بصورة آمنة تسلسليًا (thread-safe) أو إنشاؤها بشكل معزول لكل سياق استعلام.

مسار الاستخدام

ينقسم الاستخدام النموذجي لـ GidStatus إلى تسلسل تفاعل محدد بين عميل DoIP وDiagnostic Management وAdaptive Application:

مخطط تسلسلي: مسار توفير GidStatus عبر GetGidStatus عندما تكون GID غير مهيأة. المصادر: [SWS_DM_00721]، [SWS_DM_00724]، [SWS_DM_00813].

1. يرسل عميل DoIP خارجي طلب تشخيص أو تعريف عبر شبكة DoIP إلى المركبة.
2. يتحقق Diagnostic Management من التهيئة: إذا لم تكن DoIpInstantiation.gid مهيأة، يطلب DM تعريف المجموعة عبر GetGidStatus من Adaptive Application [SWS_DM_00813]، [SWS_DM_00724].
3. يحدد Adaptive Application سمات تعريف المجموعة، ويُنشئ مثيلًا من GidStatus يتضمن بيانات الاستجابة الإيجابية، ويُعيده إلى DM [SWS_DM_00721].
4. يستخرج DM البيانات من GidStatus ويرسل رسالة بروتوكول DoIP الكاملة إلى عميل DoIP الخارجي [SWS_DM_00813].

سيناريوهات الأخطاء

تُعرّف المواصفة GidStatus صراحةً بأنه بيانات استجابة إيجابية («Response data of positive response message») [SWS_DM_00721]، AUTOSAR_AP_SWS_Diagnostics §8.34.2 «Struct: GidStatus». تفسير: إذا لم يكن Adaptive Application قادرًا على توفير تعريف المجموعة، أو إذا وُجد خطأ داخلي، فيُرجح ألا يُعاد أي مثيل GidStatus نظامي؛ وبدلًا من ذلك، يُرجح أن تشير الدالة GetGidStatus إلى وجود خطأ لـ DM عبر آليات الأخطاء القياسية للمنصة (مثل رموز الخطأ في ara::core::Result). سؤال Q-01181eb14d27eeb2 (مفتوح) علاوة على ذلك، يوضح سياق واجهات DoIP ذات الصلة مثل ara::diag::DoIPPowerMode [SWS_DM_00814] أن DM يستخدم قيمًا افتراضية أو بديلة محددة عندما لا تكون الواجهات معروضة بعد [SWS_DM_01525]؛ أما بالنسبة لتعريف المجموعة، فإن غياب بيانات استجابة صالحة يتطلب معالجة سلبية مقابلة في بروتوكول DoIP، إذ لا يمكن نقل استجابة إيجابية صالحة بدون GID [SWS_DM_00813].