DEENESPTFRRUARHIKOZHNL

بنية ara::diag::DoIPEntityIdentification::EntityId

[SWS_DM_01363] Upstream: RS_Diag_00026

struct EntityId {...};

Entity Identification value ( EID ) as defined in ISO 13400-2 [2].

Literaturverzeichnis SWS Diagnostics: [2] ISO 13400-2:2019 – Road vehicles – Diagnostic communication over Internet Protocol (DoIP) – Part 2: Network and transport layer requirements and services (Edition 2, Release 2019-12) – www.iso.org

Header-Datei#include "ara/diag/doip_entity_identification.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopeclass ara::diag::DoIPEntityIdentification

دليل المستخدممولَّد بالذكاء الاصطناعي

يغلّف معرّف الكيان (EID) بطول ستة بايت لتعريف مركبة DoIP وفقًا للمعيار ISO 13400-2.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7deb2263acbf المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يغلّف معرّف الكيان (EID) بطول ستة بايت لتعريف مركبة DoIP وفقًا للمعيار ISO 13400-2.

يُستخدم الهيكل ara::diag::DoIPEntityIdentification::EntityId كوعاء بيانات لمعرّف الكيان (EID) بطول ستة بايت لحالة DoIP وفقًا للمعيار ISO 13400-2 ([SWS_DM_01496]). عند التهيئة المناسبة، يسترجع Diagnostic Manager هذا المعرّف عبر الطريقة ara::diag::DoIPEntityIdentification::GetEntityId من التطبيق التكيفي لتضمينه في رسائل بروتوكول DoIP مثل إعلان المركبة ([SWS_DM_01361]). وإذا لم تكن الواجهة جاهزة بعد أو فشل الاسترجاع، فسيتم تطبيق تراجع إلزامي كقيد حتمي إلى القيمة البديلة الثابتة المكونة بالكامل من بايتات بالقيمة 0xFF ([SWS_DM_01528]).

السياق

تُستخدم بنية البيانات ara::diag::DoIPEntityIdentification::EntityId لتمثيل معرّف الكيان القياسي (Entity Identification، EID) للاتصال التشخيصي عبر بروتوكول الإنترنت (DoIP) وفقًا للمعيار ISO 13400-2 ([SWS_DM_01496]، AUTOSAR_AP_SWS_Diagnostics §8.33 «Header: ara/diag/doip_entity_identification.h»). وضمن AUTOSAR Adaptive Platform، تم تعريفها كنوع بنية عامة داخل فئة API ara::diag::DoIPEntityIdentification ([SWS_DM_01362]، [SWS_DM_01496]).

تتمثل مسؤوليتها الأساسية في تغليف قيمة التعريف الدقيقة المكونة من ستة بايت لكيان DoIP ([SWS_DM_01496]). في بنية المنصة، تتفاعل ثلاثة أطراف فاعلة رئيسية: أولاً التطبيق التكيفي، الذي يدير معرّف الكيان أو يقرأه من الأجهزة. ثانياً فئة الواجهة ara::diag::DoIPEntityIdentification، التي تقدم الطريقة لتوفير المعرّف ([SWS_DM_01362]). ثالثاً Diagnostic Manager (DM)، الذي يسترجع EID في إطار تعريف المركبة لرسائل DoIP الصادرة ([SWS_DM_01361]، AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

dm Diagnostic Manager api ara::diag::DoIPEntityIdentification dm->api GetEntityId() eid EntityId api->eid يوفّر app Adaptive Application app->api bietet an eid->dm 6-Byte-Kennung

مخطط سياق: دمج EntityId بين Diagnostic Manager وفئة الواجهة والتطبيق التكيفي. المصادر: [SWS_DM_01361]، [SWS_DM_01496].

دورة الحياة

كبنية بيانات ذات العضو الوحيد entityIdentification من النوع ara::core::Array<std::uint8_t, 6>، يمتلك EntityId خصائص كائن قيمة C++‎ خفيف الوزن ([SWS_DM_01496]). تفسير: في ظل غياب التخصيص الديناميكي للموارد، من المرجح أن تدعم البنية عمليات النسخ والنقل العادية افتراضيًا وألا تخضع لانتقالات حالة داخلية معقدة. سؤال Q-4a6f7d6e7368b436 (مفتوح)

يتم إنشاء مثيل لـ EntityId بواسطة التطبيق التكيفي بمجرد أن يستعلم Diagnostic Manager عن بيانات الهوية عبر استدعاء ara::diag::DoIPEntityIdentification::GetEntityId ([SWS_DM_01361]). ترتبط دورة حياة المثيل عادةً بدورة الإرجاع والمعالجة لاستدعاء الطريقة. بينما تحتوي فئة الخدمة المحيطة ara::diag::DoIPEntityIdentification على منشئات صريحة ([SWS_DM_01364]، AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.2.1 «DoIPEntityIdentification») ومدمّرات ([SWS_DM_01365]، AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.1.1 «Destructor»)، يتم تحرير كائن القيمة EntityId تلقائيًا عند مغادرة نطاق الصلاحية بعد قراءة بيانات الحقول بواسطة Diagnostic Manager.

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

يتبع الاستخدام المنتظم لـ EntityId تسلسلاً محددًا في مسار بروتوكول التشخيص:

  • التحقق من التهيئة: يتحقق Diagnostic Manager من السمة DoIpNetworkConfiguration.eidRetrieval. وإذا كان DoIpEidRetrievalEnum.eidUseApi مسجلاً هناك، فيجب على DM استرجاع المعرّف إلزاميًا عبر API ([SWS_DM_01361]).
  • الاسترجاع عبر API: يستدعي Diagnostic Manager الطريقة ara::diag::DoIPEntityIdentification::GetEntityId ([SWS_DM_01361]).
  • توفير البيانات: ينشئ التطبيق مثيلاً لـ EntityId، ويملأ العضو entityIdentification بالمعرّف المكون من 6 بايت وفقًا للمعيار ISO 13400-2 ([SWS_DM_01496]) ويمرر الهيكل.
  • استخدام البروتوكول: يأخذ Diagnostic Manager المعرّف ويضعه في رسائل DoIP مثل رسالة إعلان المركبة (Vehicle Announcement Message) ([SWS_DM_01361]، AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).
استرداد EntityId لرسائل بروتوكول DoIPDiagnostic ManagerDoIPEntityIdentificationAdaptive ApplicationUse Case: فحص التكوينفحص eidRetrieval == eidUseApiUse Case: EID-AbrufGetEntityId()Ermittlung anfordernaltالواجهة متاحةBereitstellung EntityIdEntityId مع مصفوفة من 6 بايتEID in DoIP-Nachrichten einbettenالواجهة غير متاحة / خطأفشل الاستردادإجراء احتياطي: تعيين EID إلى 0xFF

مخطط تسلسل: المسار عند استرجاع EntityId ومعالجته الإضافية بما في ذلك التراجع عند الخطأ. المصادر: [SWS_DM_01361]، [SWS_DM_01496]، [SWS_DM_01528].

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

ينشأ سيناريو خطأ مركزي عندما لا تكون الواجهة ara::diag::DoIPEntityIdentification معروضة بعد بواسطة التطبيق التكيفي في وقت الاستعلام المطلوب أو عندما يفشل الاسترجاع عبر GetEntityId ([SWS_DM_01528]، AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

لتجنب حظر إرسال رسائل DoIP بشكل دائم، تفرض المواصفة في هذه الحالة سلوك قيمة بديلة إلزاميًا: يجب على Diagnostic Manager إرسال حقل EID مكون من 6 بايت بالقيمة الثابتة 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF بدلاً من بيانات التطبيق العادية ([SWS_DM_01528]). وعلى مستوى الأنواع، تستبعد المصفوفة الثابتة ara::core::Array<std::uint8_t, 6> أخطاء الطول وتجاوز سعة المخزن المؤقت في وقت الترجمة ([SWS_DM_01496]).

تم إنشاء هذا الدليل بواسطة نظام ذكاء اصطناعي بناءً على مواصفة AUTOSAR AP R25-11 وتمت مراجعته تحريريًا.

مخطط الفئات UML

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__diag__DoIPEntityIdentification__EntityId720 «struct» EntityId + entityIdentification

الثوابت

entityIdentification متغير

Entity Identification value.

ara::core::Array<std::uint8_t, 6> entityIdentification;

توثيق الثوابت / المتغيرات

متغير entityIdentification [SWS_DM_01496] Upstream: RS_Diag_00026

ara::core::Array<std::uint8_t, 6> entityIdentification;

Entity Identification value.

Header-Datei#include "ara/diag/doip_entity_identification.h"
Scopestruct ara::diag::DoIPEntityIdentification::EntityId
SymbolentityIdentification
Typara::core::Array< std::uint8_t, 6 >

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01496
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01496@rel:R25-11#18ecc8b5
Content hash
18ecc8b5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01496
Status: valid/unmigrated Version: rel:R25-11#ae348f9f Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01496@rel:R25-11#ae348f9f
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#427b10f42026-09-30
  • R22-11rel:R22-11#fa5843222026-10-14
  • R23-11rel:R23-11#ae348f9f2026-10-14
  • R24-11rel:R24-11#ae348f9f2026-10-14
  • R25-11rel:R25-11#ae348f9f2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill