DEENESPTFRRUARHIKOZHNL

فئة ara::diag::GenericDataIdentifier

[SWS_DM_00607] Upstream: RS_Diag_04169

class GenericDataIdentifier {...};

Generic DataIdentifier interface.

Header-Datei#include "ara/diag/generic_data_identifier.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

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

يمكّن التطبيقات من المعالجة العامة لطلبات القراءة والكتابة الخاصة بـ UDS لمعرّفات التشخيص.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 02c252ff66d0 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يمكّن التطبيقات من المعالجة العامة لطلبات القراءة والكتابة الخاصة بـ UDS لمعرّفات التشخيص.

تُستخدم الفئة ara::diag::GenericDataIdentifier كواجهة عامة للمعالجة غير المتزامنة لطلبات القراءة والكتابة الخاصة بـ UDS لمعرّفات التشخيص في AUTOSAR Adaptive [SWS_DM_00636]. بعد الربط بمنفذ والتمكين عبر Offer()، يوجّه Diagnostic Management الطلبات إلى الدوال المنفّذة [SWS_DM_00638]. وباعتباره نسخة مفردة، لا يمكن نسخ الكائن أو نقله، في حين يتم التحكم في الأمان الخيطي لمعالجة الطلبات عبر تكوين التزامن المختار عند المنشئ.

السياق

تمثل الفئة ara::diag::GenericDataIdentifier واجهة خدمة عامة داخل المجموعة الوظيفية Diagnostic Management (DM) لـ AUTOSAR Adaptive Platform SWS Diagnostics §8.2 «GenericDataIdentifier». وبينما ترتبط الواجهات محددة النوع بأنواع بيانات مصممة بشكل ثابت، يُستخدم GenericDataIdentifier للمعالجة المرنة لمعرّفات التشخيص (معرّفات البيانات، DIDs)، حيث يتم تمرير المعرّف ذي الـ 16 بت ديناميكيًا كمعامل.

تشارك ثلاثة أدوار رئيسية في معالجة التشخيص:

  • جهاز فحص التشخيص الخارجي، الذي يوجّه خدمات UDS القياسية مثل ReadDataByIdentifier (0x22) أو WriteDataByIdentifier (0x2E) إلى المركبة.
  • Diagnostic Management (DM)، الذي يستقبل طلبات التشخيص ويتحقق من صحتها ويوجهها عبر واجهات منافذ محددة إلى نسخة التطبيق المقابلة، شريطة أن تكون قد تم تنشيطها مسبقًا عبر Offer [SWS_DM_00638].
  • التنفيذ المخصص للتطبيق لـ GenericDataIdentifier، والذي يغلّف منطق المعالجة الفعلي من خلال توفير الدوال Read [SWS_DM_00636] و Write [SWS_DM_00637] وإرجاع البيانات بشكل غير متزامن.

دورة الحياة

يتم إنشاء نسخة من ara::diag::GenericDataIdentifier صراحةً عبر منشئها [SWS_DM_00634]. وعندئذٍ يربط المستدعي الكائن بـ ara::core::InstanceSpecifier يشير إلى PortPrototype الخاص بـ DiagnosticDataIdentifierGenericInterface منمذج. ويتم تحديد ما إذا كانت الطلبات تُمرر بالتزامن (kConcurrent) أو بالتسلسل (kNotConcurrent) إلى المعالج عبر المعامل concurrencyType (من النوع DataIdentifierConcurrencyType) [SWS_DM_00634].

فيما يتعلق بالملكية وعمر الكائن، تم تصميم GenericDataIdentifier كنسخة مفردة، غير قابلة للنسخ وغير قابلة للنقل:

بعد التهيئة، يكون الكائن في حالة غير نشطة؛ ولا يقوم Diagnostic Management بتوجيه أي طلبات بعد. يتم تنشيط التوجيه فقط من خلال استدعاء Offer() [SWS_DM_00638]. ولإلغاء تنشيط توجيه طلبات التشخيص مجددًا، يستدعي التطبيق StopOffer() [SWS_DM_00639]. ويتم تدمير الكائن عبر المدمّر الافتراضي [SWS_DM_00635].

فيما يتعلق بالتزامن، يُعد المنشئ آمنًا خيطيًا (thread-safe) [SWS_DM_00634]. في المقابل، تم تحديد الدوال الإدارية Offer() [SWS_DM_00638] و StopOffer() [SWS_DM_00639] وكذلك المدمّر [SWS_DM_00635] بأنها غير آمنة خيطيًا. يعتمد الأمان الخيطي للدالتين Read و Write بشكل مشروط على concurrencyType المختار [SWS_DM_00636]، [SWS_DM_00637].

lifecycle NichtInitialisiert غير مهيأ Inaktiv Inaktiv (StopOffer) NichtInitialisiert->Inaktiv Konstruktor Aktiv Aktiv (Offer) Inaktiv->Aktiv Offer() Beendet تم الإتلاف Inaktiv->Beendet Destruktor Aktiv->Inaktiv StopOffer() Aktiv->Beendet Destruktor

مخطط الحالة: دورة الحياة وانتقالات الحالة لنسخة المعالج بين عدم النشاط والجاهزية للتوجيه. المصادر: [SWS_DM_00634]، [SWS_DM_00638]، [SWS_DM_00639]، [SWS_DM_00635]

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

ينقسم المسار الرأسي النمطي لمعالجة طلبات التشخيص إلى الخطوات التالية:

  1. التهيئة: يُنشئ التطبيق فئة المعالج المشتقة الخاصة به مع تحديد InstanceSpecifier بالإضافة إلى تكوين التزامن [SWS_DM_00634]. تفسير: من المحتمل أن يتم ذلك في الممارسة العملية نمطيًا خلال مرحلة تهيئة عملية التطبيق. سؤال Q-32596fba68253958 (مفتوح)
  2. توفير الخدمة: يستدعي التطبيق Offer() [SWS_DM_00638]. يقوم Diagnostic Management بتنشيط توجيه طلبات DID الواردة.
  3. معالجة الطلب:
    • عند ورود أمر قراءة، يستدعي DM الدالة Read(dataIdentifier, metaInfo, cancellationHandler) [SWS_DM_00636]. يفحص التطبيق المعرّف الممرر ذي الـ 16 بت ويعيد ara::core::Future<OperationOutput> بشكل غير متزامن.
    • عند وصول أمر كتابة، يستدعي DM Write(dataIdentifier, requestData, metaInfo, cancellationHandler) [SWS_DM_00637]. تظل بيانات الحمولة في requestData صالحة حتى يتم استيفاء الوعد (Promise) المرتبط بها أو يتم إلغاء المعالجة.
  4. فحص الإلغاء: أثناء العمليات الطويلة، يمكن للمعالج التحقق عبر cancellationHandler.IsCanceled() مما إذا كانت المحادثة قد أُلغيت، أو تسجيل دالة إشعار عبر cancellationHandler.SetNotifier [SWS_DM_00636]، [SWS_DM_00637].
  5. إلغاء تسجيل الخدمة: قبل إنهاء المعالج، يستدعي التطبيق StopOffer() [SWS_DM_00639]، مما يجعل DM يوقف التوجيه.
سير طلب قراءة عامDiagnosetesterDiagnostic ManagementGenericDataIdentifierUse Case: DienstregistrierungOffer()Result<void> (Erfolg)Use Case: Leseanforderung (UDS 0x22)ReadDataByIdentifierRead(dataIdentifier, metaInfo, cancellationHandler)altDaten erfolgreich ermitteltFuture مع OperationOutputاستجابة UDS إيجابية مع بياناتFehlerfall / NRCFuture مع DiagUdsNrcErrcNegative UDS-Antwort (NRC)

مخطط تسلسلي: التفاعل بين جهاز الفحص الخارجي و Diagnostic Management و GenericDataIdentifier عند طلب قراءة UDS. المصادر: [SWS_DM_00638]، [SWS_DM_00636]

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

يمكن أن تحدث الأخطاء في مراحل مختلفة من التفاعل:

  • انتهاكات التكوين وتعيين المنافذ: إذا تعذر حل InstanceSpecifier في النموذج أو كان لا يشير إلى PortPrototype، فسيحدث InstanceSpecifierMappingIntegrityViolation [SWS_DM_00634]. وإذا كان التخصيص لـ DiagnosticDataPortMapping مفقودًا، فسيحدث PortInterfaceMappingViolation [SWS_DM_00634]. يؤدي تعيين العملية المفقود إلى ProcessMappingViolation، ويؤدي InstanceSpecifier المستخدم بالفعل إلى InstanceSpecifierAlreadyInUseViolation [SWS_DM_00634].
  • التقديم المتعدد: إذا تم استدعاء Offer() بالرغم من تقديم الخدمة بشكل نشط بالفعل، تعيد الدالة ara::core::Result مع رمز الخطأ DiagOfferErrc::kAlreadyOffered [SWS_DM_00638].
  • أخطاء التشخيص التخصصية: إذا تعذر تلبية طلب قراءة أو كتابة من الناحية التخصصية، فلا يعيد التطبيق حالة نجاح في Future، بل يعيد رمز NRC قياسي لـ UDS (كود الاستجابة السلبية) عبر DiagUdsNrcErrc وفقًا للمعيار ISO 14229-1 [SWS_DM_00636]، [SWS_DM_00637].

يستند هذا الدليل إلى مواصفة AUTOSAR الإصدار R25-11 وتم إنشاؤه تلقائيًا.

خريطة الأعضاء

المُنشئات والمُتلف

2

الدوال الأعضاء

4

المعاملات

1

الأنواع المضمنة

1

مخطط الفئة

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

G nara__diag__GenericDataIdentifier357 GenericDataIdentifier + GenericDataIdentifier() + operator=() + ~GenericDataIdentifier() + Offer() + Read() + StopOffer() + Write()

عرض التفاصيل

اختر عنصرًا من المخطط.

المُنشئات والمُتلف

Class for an GenericDataIdentifier.

التحميلات الزائدة GenericDataIdentifier 3
explicit GenericDataIdentifier (const ara::core::InstanceSpecifier &specifier, DataIdentifierConcurrencyType concurrencyType) noexcept; SWS_DM_00634
GenericDataIdentifier (GenericDataIdentifier &)=delete; SWS_DM_01653
GenericDataIdentifier (GenericDataIdentifier &&) noexcept=delete; SWS_DM_01654

Destructor of class GenericDataIdentifier .

virtual ~GenericDataIdentifier () noexcept;

الدوال الأعضاء

Offer دالة

This Offer will enable the DM to forward request messages to this handler.

ara::core::Result< void > Offer () noexcept;
Read دالة

Called for ReadDataByIdentifier request for this DiagnosticDataIdentifier.

virtual ara::core::Future< OperationOutput > Read (std::uint16_t data Identifier, const MetaInfo &metaInfo, CancellationHandler cancellation Handler) noexcept=0;
StopOffer دالة

This StopOffer will disable the forwarding of request messages from DM.

void StopOffer () noexcept;
Write دالة

Called for WriteDataByIdentifier request for this DiagnosticDataIdentifier.

virtual ara::core::Future< void > Write (std::uint16_t dataIdentifier, ara::core::Span< const std::uint8_t > requestData, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept;

المعاملات

operator= دالة 2

GenericDataIdentifier shall be a single not assignable instance.

التحميلات الزائدة = 2

الأنواع المضمنة

توثيق الدوال

دالة GenericDataIdentifier [SWS_DM_00634] Upstream: RS_AP_00137, RS_Diag_04169, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

explicit GenericDataIdentifier (const ara::core::InstanceSpecifier &specifier, DataIdentifierConcurrencyType concurrencyType) noexcept;

Class for an GenericDataIdentifier.

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe
Verletzungen (Violations)InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is typed by a pingViolation DiagnosticDataIdentifierGenericInterface needs to be referenced by a DiagnosticDataPortMapping. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.

Parameter (in)

ParameterBeschreibung
specifierInstanceSpecifier to a PortPrototype of a DiagnosticDataIdentifierGenericInterface.
concurrencyTypeSpecifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent)

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

Record
AUTOSAR/AP/record/SWS_DM_00634
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00634@rel:R25-11#c3b52b98
Content hash
c3b52b98
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00634
Status: valid/unmigrated Version: rel:R25-11#71f09e07 Versionshistorie & Revisions (1 transition, 8 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_00634@rel:R25-11#71f09e07
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#9d754b4c2026-09-30
  • R19-11rel:R19-11#281ed5b12026-10-14
  • R20-11rel:R20-11#c8b741432026-10-14
  • R21-11rel:R21-11#161554792026-10-14
  • R22-11rel:R22-11#55a5b7df2026-10-14
  • R23-11rel:R23-11#571dfcd62026-10-14
  • R24-11rel:R24-11#4a63e6522026-10-14
  • R25-11rel:R25-11#71f09e072026-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

دالة GenericDataIdentifier [SWS_DM_01653] Upstream: RS_AP_00147

GenericDataIdentifier (GenericDataIdentifier &)=delete;

GenericDataIdentifier shall be a single not copy-able instance.

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier

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

Record
AUTOSAR/AP/record/SWS_DM_01653
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01653@rel:R25-11#3c19d87f
Content hash
3c19d87f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01653
Status: valid/unmigrated Version: rel:R25-11#3de9089c Versionshistorie & Revisions (1 transition, 4 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_01653@rel:R25-11#3de9089c
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#f309daca2026-09-30
  • R23-11rel:R23-11#ad3cab8a2026-10-14
  • R24-11rel:R24-11#d3cdff682026-10-14
  • R25-11rel:R25-11#3de9089c2026-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

دالة GenericDataIdentifier [SWS_DM_01654] Upstream: RS_AP_00147

GenericDataIdentifier (GenericDataIdentifier &&) noexcept=delete;

Move constructor of GenericDataIdentifier.

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier

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

Record
AUTOSAR/AP/record/SWS_DM_01654
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01654@rel:R25-11#b0176d18
Content hash
b0176d18
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01654
Status: valid/unmigrated Version: rel:R25-11#8f08b1d5 Versionshistorie & Revisions (1 transition, 4 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_01654@rel:R25-11#8f08b1d5
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#11d817c52026-09-30
  • R23-11rel:R23-11#5421592e2026-10-14
  • R24-11rel:R24-11#8f08b1d52026-10-14
  • R25-11rel:R25-11#8f08b1d52026-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

دالة Offer [SWS_DM_00638] Upstream: RS_AP_00139, RS_AP_00119, RS_Diag_04169

ara::core::Result< void > Offer () noexcept;

This Offer will enable the DM to forward request messages to this handler.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 860e6bd15d7f المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام: تُستخدم الدالة المتزامنة Offer للفئة ara::diag::GenericDataIdentifier ([SWS_DM_00638]) لتسجيل معالج معرّف بيانات عام لدى Diagnostic Management (DM). ومن خلال هذا الاستدعاء، يتم تخويل DM لإعادة توجيه طلبات التشخيص الواردة (Request Messages) لمعرّف البيانات المعني إلى هذا المعالج ([SWS_DM_00638]). ولا تقبل الدالة أي معلمات تمرير وتُرجع بشكل متزامن ara::core::Result<void> ([SWS_DM_00638])، والذي يفيد بالنجاح أو الخطأ.

معالجة الأخطاء: تم التصريح عن الدالة بـ noexcept وهي تضمن أمانًا تامًا من الاستثناءات (exception safe) ([SWS_DM_00638]). ويتم الإبلاغ عن الأخطاء المحتملة عبر ara::core::Result. وإذا كان المعالج قد تم توفيره بالفعل مسبقًا، تُرجع الدالة رمز الخطأ DiagOfferErrc::kAlreadyOffered بدلالة التراجع ([SWS_DM_00638]). ويتوافق هذا مع تعداد الأخطاء العام DiagErrc::kAlreadyOffered ([SWS_DM_00514]).

التزامن والقيود: حُدّدت الدالة بأنها غير آمنة للخيوط (not thread-safe) ([SWS_DM_00638]). وبالتالي، يجب حماية الاستدعاءات على النسخة نفسها من الوصول المتزامن. وبما أنه لم يتم تحديد دالة إلغاء تسجيل منفصلة لـ GenericDataIdentifier، فمن المحتمل أن يكون عرض الخدمة مرتبطًا بفترة بقاء نسخة المعالج (تفسير). سؤال Q-7c64a5bd308464a8 (مفتوح)

التكامل والتفاعل: يتبع هذا الإجراء نمط التوفير المتسق لـ Diagnostic Management. وتوجد واجهات مماثلة لمعرّفات البيانات الخاصة بالنوع ([SWS_DM_00599])، والروتينات العامة ([SWS_DM_00557])، وكذلك خدمات UDS العامة ([SWS_DM_00619]).

تم إنشاء ملاحظة الاستخدام هذه بواسطة نظام ذكاء اصطناعي.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >Returns nothing or an error.

Fehler

FehlercodeBeschreibung
DiagOfferErrc::kAlreadyOfferedrollback_semantics The service is already offered.

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

Record
AUTOSAR/AP/record/SWS_DM_00638
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00638@rel:R25-11#a95047d3
Content hash
a95047d3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00638
Status: valid/unmigrated Version: rel:R25-11#1ea7c5d4 Versionshistorie & Revisions (1 transition, 8 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_00638@rel:R25-11#1ea7c5d4
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#d9e8c1292026-09-30
  • R19-11rel:R19-11#34f18c6b2026-10-14
  • R20-11rel:R20-11#f2c3beea2026-10-14
  • R21-11rel:R21-11#a7b6c9862026-10-14
  • R22-11rel:R22-11#533034aa2026-10-14
  • R23-11rel:R23-11#b980ade42026-10-14
  • R24-11rel:R24-11#198e42702026-10-14
  • R25-11rel:R25-11#1ea7c5d42026-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

دالة Read [SWS_DM_00636] Upstream: RS_AP_00138, RS_AP_00119, RS_Diag_04169, RS_Diag_04170, RS_ Diag_04172

virtual ara::core::Future< OperationOutput > Read (std::uint16_t data Identifier, const MetaInfo &metaInfo, CancellationHandler cancellation Handler) noexcept=0;

Called for ReadDataByIdentifier request for this DiagnosticDataIdentifier.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7772a86b7791 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستدعى الطريقة Read من الفئة ara::diag::GenericDataIdentifier بمجرد ورود طلب تشخيص لـ ReadDataByIdentifier (UDS 0x22) لمعرف البيانات المعني [SWS_DM_00636]. وكعوامل، تأخذ الدالة المعرف العددي dataIdentifier، والسياق metaInfo بالإضافة إلى cancellationHandler. وعبر cancellationHandler، يمكن للتطبيق الاستعلام عن حالة الإلغاء باستخدام IsCanceled أو تسجيل دالة إشعار للمحادثات الملغاة عبر SetNotifier [SWS_DM_00636]. وتتوفر النتيجة بشكل غير متزامن عبر ara::core::Future<OperationOutput>، والذي يُرجع حمولة البيانات (OperationOutput) في حالة النجاح [SWS_DM_00636].

معالجة الأخطاء

في حالة الخطأ، يرجع Future قيمة إرجاع UDS سلبية (NRC) وفقًا للمعيار ISO 14229-1 عبر DiagUdsNrcErrc [SWS_DM_00636]. وإذا كانت الواجهة غير معروضة بعدُ أو لم تعد معروضة عبر offer()، يستجيب Diagnostic Management (DM) تلقائيًا برمز NRC 0x94 (ResourceTemporarilyNotAvailable) [SWS_DM_01257]. وإذا تم الوصول إلى الحد المكوَّن لرسائل Response Pending، يقطع الخادم المعالجة ويستجيب بالرمز NRC 0x10 (generalReject) [SWS_DM_00369].

التزامن والتفاعل

تم التصريح عن الدالة كـ noexcept وهي آمنة من الاستثناءات [SWS_DM_00636]. أما أمان الخيوط لديها فمشروط: إذ يُحدَّد ما إذا كان يجب أن يكون التنفيذ آمنًا للخيوط عبر ConcurrencyType الممرَّر في الدالة الإنشائية [SWS_DM_00636]. فإذا كان readWrite مضبوطًا على kConcurrent، يُسمح لـ DM ببدء عمليات الوصول للقراءة والكتابة على نحو متزامن، وإلا (kNotConcurrent) فيتم الاستدعاء بشكل تسلسلي [SWS_DM_00939]. وعلى خلاف الواجهات المحددة مثل [SWS_DM_00640]، يغطي GenericDataIdentifier نطاقات DID عامة بمرونة عبر المعرّف ID الممرَّر [SWS_DM_00636].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على مواصفات AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
dataIdentifierthe corresponding DataIdentifier
metaInfoMetaInfo of the request.
cancellationHandlerThis parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

TypBeschreibung
ara::core::Future<OperationOutput >A Future with either OperationOutput (for a positive response message) or an UDS NRC value (for a negative response message).

Fehler

FehlercodeBeschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

Record
AUTOSAR/AP/record/SWS_DM_00636
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00636@rel:R25-11#054fd0c3
Content hash
054fd0c3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00636
Status: valid/unmigrated Version: rel:R25-11#cfd80198 Versionshistorie & Revisions (1 transition, 8 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_00636@rel:R25-11#cfd80198
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#339b63522026-09-30
  • R19-11rel:R19-11#f8a15c312026-10-14
  • R20-11rel:R20-11#5e9a44792026-10-14
  • R21-11rel:R21-11#34887de02026-10-14
  • R22-11rel:R22-11#91d437d52026-10-14
  • R23-11rel:R23-11#6625968e2026-10-14
  • R24-11rel:R24-11#430ea0f32026-10-14
  • R25-11rel:R25-11#cfd801982026-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

دالة StopOffer [SWS_DM_00639] Upstream: RS_Diag_04169

void StopOffer () noexcept;

This StopOffer will disable the forwarding of request messages from DM.

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

الاستخدام وسياق الاستدعاء

تُستخدم الدالة العضو StopOffer للفئة ara::diag::GenericDataIdentifier لتعطيل إعادة توجيه رسائل الطلب الواردة من Diagnostic Management (DM) إلى المثيل المعني [SWS_DM_00639]. يتم الاستدعاء بشكل متزامن عبر الواجهة من ملف الرأس #include "ara/diag/generic_data_identifier.h" [SWS_DM_00639]. تمتلك الدالة التوقيع void StopOffer() noexcept;، ولا تقبل أي معاملات تمرير ولا تُرجع أي قيمة إرجاع [SWS_DM_00639].

معالجة الأخطاء والتزامن

تحدد المواصفة StopOffer بأنها آمنة من الاستثناءات (exception safe) وتضمن عبر المعرّف noexcept عدم حدوث استثناءات [SWS_DM_00639]. لا توجد رموز أخطاء أو استجابات أخطاء أو إخطارات محددة لـ DET أو DEM مخصصة لهذه العملية. وفيما يتعلق بالتزامن، تم تصنيف الطريقة على أنها غير آمنة لمؤشرات الترابط (not thread-safe) [SWS_DM_00639]. وبالتالي، يجب مزامنة الاستدعاءات المتوازية على نفس المثيل بواسطة المستدعي. تفسير: من المرجح أن تتم معالجة الطلبات التي بدأت بالفعل في Diagnostic Management بشكل منتظم قبل الإيقاف النهائي لإعادة التوجيه. سؤال Q-94a464dc832c055c (مفتوح)

التفاعل داخل وحدة التشخيص

يتم استخدام نمط سحب توفير الخدمة بشكل موحد ومتسق في وحدة التشخيص. توجد طرق StopOffer مماثلة من بين أمور أخرى لكل من:

  • معرّفات البيانات الخاصة بالنوع عبر DataIdentifierInterface::StopOffer [SWS_DM_00600] وكذلك عناصر البيانات [SWS_DM_00617]،
  • الروتينات العامة عبر GenericRoutine::StopOffer [SWS_DM_00558] وواجهات الروتينات الخاصة بالنوع [SWS_DM_00595]،
  • خدمات تشخيص أخرى مثل خدمات UDS [SWS_DM_00620] أو الشاشات [SWS_DM_01089].

تم إنشاء ملاحظة الاستخدام هذه بشكل آلي استناداً إلى بيانات المواصفات.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_DM_00639
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00639@rel:R25-11#7ad63d93
Content hash
7ad63d93
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00639
Status: valid/unmigrated Version: rel:R25-11#9225c34d Versionshistorie & Revisions (1 transition, 8 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_00639@rel:R25-11#9225c34d
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0466e7b52026-09-30
  • R19-11rel:R19-11#e360cf692026-10-14
  • R20-11rel:R20-11#1bc0f5cd2026-10-14
  • R21-11rel:R21-11#3b09d7582026-10-14
  • R22-11rel:R22-11#77376b4a2026-10-14
  • R23-11rel:R23-11#6009f72f2026-10-14
  • R24-11rel:R24-11#d3d4a13c2026-10-14
  • R25-11rel:R25-11#9225c34d2026-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

دالة Write [SWS_DM_00637] Upstream: RS_AP_00138, RS_AP_00119, RS_Diag_04169, RS_Diag_04170

virtual ara::core::Future< void > Write (std::uint16_t dataIdentifier, ara::core::Span< const std::uint8_t > requestData, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept;

Called for WriteDataByIdentifier request for this DiagnosticDataIdentifier.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7b195835c98c المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتم استدعاء الدالة Write للفئة ara::diag::GenericDataIdentifier بواسطة Diagnostic Management بمجرد تلقي طلب UDS للخدمة WriteDataByIdentifier (0x2E) [SWS_DM_00637]. ويشترط للاستدعاء أن يكون معرّف البيانات المطلوب مدعومًا، وأن تسمح جلسة التشخيص الحالية ومستوى الأمان بالتنفيذ [SWS_DM_00186]، [SWS_DM_00415]، [SWS_DM_00416].

يتم الاستدعاء بالمعلمات التالية [SWS_DM_00637]:

  • dataIdentifier: معرّف الـ 16 بت لمعرّف البيانات المراد كتابته.
  • requestData: ara::core::Span يحتوي على البيانات الخام للطلب بدون بادئة DID. ويظل المخزن المؤقت صالحًا حتى يتم استيفاء الوعد المقترن به أو إلغاء المعالجة.
  • metaInfo: بيانات وصفية إضافية لطلب التشخيص.
  • cancellationHandler: يُستخدم لمراقبة الإلغاء المبكر للمحادثة عبر IsCanceled وكذلك لتسجيل إشعار بالإلغاء عبر SetNotifier.

يتم التنفيذ بشكل غير متزامن ويُرجع ara::core::Future<void> [SWS_DM_00637]. وعند المعالجة بنجاح، يتم استيفاء الوعد بـ void لرسالة استجابة إيجابية. وفي حال حدوث خطأ، يجب إكمال الـ Future بقيمة إرجاع UDS سلبية مناسبة (NRC) وفقًا للمعيار ISO 14229-1 عبر DiagUdsNrcErrc [SWS_DM_00637]. وقد تم التصريح عن الدالة كـ noexcept ويجب تنفيذها لتكون آمنة من الاستثناءات [SWS_DM_00637].

فيما يتعلق بالتزامن، فإن أمان الخيوط مشروط: إذ يعتمد ما إذا كان يجب تنفيذ Write ليكون آمنًا للخيوط على ConcurrencyType الممرَّر عند إنشاء النسخة في الدالة الإنشائية [SWS_DM_00637]. ويتم التحكم في التنفيذ المتوازي لعمليات الوصول للقراءة والكتابة عبر الراية readWrite [SWS_DM_00939].

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

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
dataIdentifierthe corresponding DataIdentifier
requestDataContent of request message (without DataIdentifier). Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
metaInfoMetaInfo of the request.
cancellationHandlerThis parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

TypBeschreibung
ara::core::Future< void >A Future with either void (for a positive response message) or an UDS NRC value (for a negative response message).

Fehler

FehlercodeBeschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

Record
AUTOSAR/AP/record/SWS_DM_00637
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00637@rel:R25-11#59d58166
Content hash
59d58166
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00637
Status: valid/unmigrated Version: rel:R25-11#b7a94afa Versionshistorie & Revisions (1 transition, 8 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_00637@rel:R25-11#b7a94afa
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#889963442026-09-30
  • R19-11rel:R19-11#8d85d1592026-10-14
  • R20-11rel:R20-11#701ab1d02026-10-14
  • R21-11rel:R21-11#10093f0c2026-10-14
  • R22-11rel:R22-11#9b15c55f2026-10-14
  • R23-11rel:R23-11#a7e012442026-10-14
  • R24-11rel:R24-11#9c761e5e2026-10-14
  • R25-11rel:R25-11#b7a94afa2026-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

دالة operator= [SWS_DM_01651] Upstream: RS_AP_00147

GenericDataIdentifier & operator= (GenericDataIdentifier &)=delete;

GenericDataIdentifier shall be a single not assignable instance.

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier

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

Record
AUTOSAR/AP/record/SWS_DM_01651
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01651@rel:R25-11#869bd491
Content hash
869bd491
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01651
Status: valid/unmigrated Version: rel:R25-11#9b814f4a Versionshistorie & Revisions (1 transition, 4 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_01651@rel:R25-11#9b814f4a
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#0a92f77c2026-09-30
  • R23-11rel:R23-11#1cfb26532026-10-14
  • R24-11rel:R24-11#211cc0882026-10-14
  • R25-11rel:R25-11#9b814f4a2026-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

دالة operator= [SWS_DM_01652] Upstream: RS_AP_00147

GenericDataIdentifier & operator= (GenericDataIdentifier &&)=delete;

Move assignment operator of GenericDataIdentifier.

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier

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

Record
AUTOSAR/AP/record/SWS_DM_01652
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01652@rel:R25-11#1a159834
Content hash
1a159834
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01652
Status: valid/unmigrated Version: rel:R25-11#7c21b544 Versionshistorie & Revisions (1 transition, 4 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_01652@rel:R25-11#7c21b544
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#5c58a4142026-09-30
  • R23-11rel:R23-11#1428a6912026-10-14
  • R24-11rel:R24-11#7c21b5442026-10-14
  • R25-11rel:R25-11#7c21b5442026-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

دالة ~GenericDataIdentifier [SWS_DM_00635] Upstream: RS_AP_00134, RS_Diag_04169

virtual ~GenericDataIdentifier () noexcept;

Destructor of class GenericDataIdentifier .

Header-Datei#include "ara/diag/generic_data_identifier.h"
Scopeclass ara::diag::GenericDataIdentifier
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_DM_00635
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00635@rel:R25-11#0472ef02
Content hash
0472ef02
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00635
Status: valid/unmigrated Version: rel:R25-11#fc24e0db Versionshistorie & Revisions (1 transition, 8 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_00635@rel:R25-11#fc24e0db
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#882197f52026-09-30
  • R19-11rel:R19-11#ae023e7c2026-10-14
  • R20-11rel:R20-11#6892d8702026-10-14
  • R21-11rel:R21-11#cf811fb72026-10-14
  • R22-11rel:R22-11#0ec9aa792026-10-14
  • R23-11rel:R23-11#924c98d82026-10-14
  • R24-11rel:R24-11#fc24e0db2026-10-14
  • R25-11rel:R25-11#fc24e0db2026-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