DEENESPTFRRUARHIKOZHNL

فئة <DataElement-Namespace>::<DataElementInterface>

[SWS_DM_00603] Upstream: RS_Diag_04169

class <DataElementInterface> {...};

DiagnosticDataElementInterface class

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Forwarding-Header#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }/<DataElementShortname>_fwd.h"
Scopenamespace <DataElement-Namespace>

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

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

تتيح للتطبيقات توفير استعلامات القراءة التشخيصية والرد عليها لصالح Diagnostic Manager.

تُستخدم الواجهة لتطبيقات Adaptive لتوفير البيانات التشخيصية لعمليات القراءة الخاصة بـ Diagnostic Management. بعد إنشاء المثيل عبر محدد المثيل، يجب على التطبيق تقديم الخدمة بشكل نشط حتى يمكن استلام طلبات القراءة الواردة [SWS_DM_00597]. وتتم معالجة الطلبات الواردة عبر دالة القراءة غير المتزامنة، والتي توفر بيانات الإخراج المطلوبة أو رموز الاستجابة السلبية في قيمة مستقبلية [SWS_DM_00596]. وبما أن عمليات النسخ والنقل محذوفة، فإن كل مثيل يكون مرتبطًا بشكل وثيق بسياقه.

السياق

تعمل فئة C++ المُولدة <DataElementInterface> ضمن المجموعة الوظيفية diag (AUTOSAR Adaptive Platform) كواجهة خادم قياسية لتوفير بيانات التشخيص القابلة للقراءة AUTOSAR_AP_SWS_Diagnostics ص. 68. وتحديدًا، تمثل DiagnosticDataElementInterface في الدور read، والذي يرسل عبره تطبيق Adaptive قيم البيانات لطلبات التشخيص (مثل UDS ReadDataByIdentifier) إلى Diagnostic Manager (DM) [SWS_DM_00596].

تتمثل أطراف التفاعل الرئيسية في Diagnostic Management لخفيّة المنصة (Daemon)، والتي تنسق طلبات التشخيص الواردة، بالإضافة إلى تطبيق Adaptive المنفّذ، الذي يرث من هذه الواجهة ويصيغ منطق التوفير. يتم إنشاء المثيل والتعيين إلى البنية البرمجية عبر نموذج أولي للمنفذ تم تصميمه وربطه عبر ara::core::InstanceSpecifier [SWS_DM_00587]. وتُغلف بيانات الإخراج في بنية خاصة بالنوع، حيث تُمثَّل وسائطها بواسطة عناصر إخراج مطابقة [SWS_DM_80023]، [SWS_DM_00581].

دورة الحياة

يتم إنشاء المثيل عبر المُنشئ مع تحديد ara::core::InstanceSpecifier بالإضافة إلى نمط التزامن ara::diag::ConcurrencyType [SWS_DM_00587]. وللحفاظ على تعيين فريد داخل العملية، تم حذف كل من مُنشئ النسخ ومُنشئ النقل [SWS_DM_01661]، [SWS_DM_01662]. وبالمثل، تم حذف معاملي إسناد النسخ والنقل بشكل صريح [SWS_DM_01659]، [SWS_DM_01660]. وبالتالي يظل المثيل ثابتًا في عنوانه الذي أُنشئ فيه.

فيما يتعلق بالتشغيل، يمر الكائن بمراحل محددة:

  • غير معروض (Not Offered): بعد الإنشاء، يكون الكائن في البداية في حالة غير نشطة لا يرسل فيها DM أي طلبات قراءة.
  • معروض (Offered): من خلال استدعاء Offer()، تُنشَّط الخدمة لدى DM، بحيث يتم توجيه طلبات القراءة الواردة [SWS_DM_00597].
  • ملغى التسجيل: يؤدي استدعاء StopOffer() إلى إلغاء تنشيط توجيه طلبات التشخيص المستقبلية بواسطة DM [SWS_DM_00617].
  • الهدم: يُنهي الهدام الافتراضي ~<DataElementInterface>() دورة حياة مثيل الواجهة [SWS_DM_00588].

في حين حُدِّد المنشئ بوصفه آمنًا بالنسبة للخيوط [SWS_DM_00587]، فإن Offer() وStopOffer() وRead() والهدام ليست آمنة بالنسبة للخيوط [SWS_DM_00597]، [SWS_DM_00617]، [SWS_DM_00596]، [SWS_DM_00588]. وتحدد المعلمة concurrencyType في المنشئ ما إذا كان تنفيذ المعالج منفذًا بشكل آمن بالنسبة للخيوط (kConcurrent) أو غير آمن بالنسبة للخيوط (kNotConcurrent) [SWS_DM_00587].

Lifecycle Uninitialized Uninitialized NotOffered NotOffered Uninitialized->NotOffered Konstruktor Offered Offered NotOffered->Offered Offer() Destructed Destructed NotOffered->Destructed Destruktor Offered->NotOffered StopOffer() Offered->Destructed Destruktor

مخطط الحالة: مراحل حالة مثيل الواجهة بين التهيئة، وحالة النشر، والهدم. المصادر: [SWS_DM_00587]، [SWS_DM_00597]، [SWS_DM_00617]، [SWS_DM_00588].

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

يتبع المسار المنتظم لاستعلام البيانات تسلسلًا ثابتًا من الخطوات:

  1. إنشاء المثيل: يُنشئ التطبيق مثيلًا من فئة المعالج المشتقة باستخدام instanceSpec وconcurrencyType المطلوبين [SWS_DM_00587].
  2. إتاحة الخدمة: يستدعي التطبيق Offer()، مما يمكّن DM من توجيه طلبات القراءة [SWS_DM_00597].
  3. معالجة طلبات القراءة: عند وصول طلب قراءة إلى DM، فإنه يستدعي الدالة الافتراضية الصرفة Read(metaInfo, cancellationHandler) في المعالج [SWS_DM_00596]. ويقوم التطبيق بتقييم metaInfo ويمكنه التحقق عبر cancellationHandler.IsCanceled() مما إذا كانت المحادثة قد أُلغيت، أو تسجيل رد نداء عبر cancellationHandler.SetNotifier [SWS_DM_00596].
  4. الإفادة: تفسير: يُرجَّح أن يتم التحديد الفعلي لبيانات الإخراج بشكل غير متزامن عادةً؛ وتُوفَّر النتيجة في ara::core::Future مع كائن ReadOutput المقابل [SWS_DM_00596]، [SWS_DM_00581]. سؤال Q-ce317bd1275e4fd9 (مفتوح)
  5. إنهاء الخدمة: قبل إيقاف التشغيل، يستدعي التطبيق StopOffer() لمنع التوجيه [SWS_DM_00617]، متبوعًا بهدم الكائن [SWS_DM_00588].
تسلسل الاستدعاء لتوفير وقراءة عنصر بيانات تشخيصيةDiagnostic ManagementDataElement HandlerAnwendungskernUse Case: DienstregistrierungOffer()Result<void> (kSuccess)Use Case: Leseanfrage verarbeitenRead(metaInfo, cancellationHandler)Daten abfragen / ermittelnaltErfolgreich gelesenReadOutput bereitstellenFuture مع ReadOutputFehlerfall / NRCFehler aufgetretenFuture مع DiagUdsNrcErrcUse Case: DienstabmeldungStopOffer()

مخطط التتابع: تسلسل الاستدعاء بدءًا من تسجيل الخدمة مرورًا بالقراءة غير المتزامنة وحتى إلغاء التسجيل. المصادر: [SWS_DM_00597]، [SWS_DM_00596]، [SWS_DM_00617].

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

في حالة الخطأ، يجب النظر إلى مراحل الحياة المختلفة بشكل متمايز:

يمكن أن تحدث انتهاكات للسلامة بالفعل أثناء الإنشاء، ويُشار إليها عبر Violations محددة [SWS_DM_00587]:

  • InstanceSpecifierMappingIntegrityViolation: لا يمكن حل محدد المثيل في نموذج الملف القابل للتنفيذ أو أنه لا يشير إلى PortPrototype.
  • PortInterfaceMappingViolation: لا يُشار إلى PortPrototype المحدَّد نوعه بواسطة DiagnosticDataElementInterface من خلال DiagnosticDataPortMapping.
  • ProcessMappingViolation: على الرغم من وجود InstanceRef مناسبة، لم يُعثر على أي عملية منمذجة مطابقة تقابل عملية وقت التشغيل.
  • InstanceSpecifierAlreadyInUseViolation: استُدعي المنشئ باستخدام InstanceSpecifier قيد الاستخدام بالفعل في العملية الحالية.

إذا استُدعي Offer() لخدمة معروضة بالفعل، تُرجع الدالة ara::core::Result مع رمز الخطأ DiagOfferErrc::kAlreadyOffered (دلالات التراجع) [SWS_DM_00597].

إذا تعذرت الإجابة بنجاح عن طلب قراءة في Read()، يجب أن يحتوي ara::core::Future المُرجع على ISO 14229-1 Negative Response Code (NRC) المقابل عبر DiagUdsNrcErrc أو على ApApplicationError [SWS_DM_00596].

يعتمد هذا الدليل على مواصفة AUTOSAR AP الإصدار R25-11 ويلخص متطلبات الوحدة diag.

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

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

5
<DataElementInterface>OfferReadStopOffer~<DataElementInterface>

المعاملات

1
operator=

الثوابت

1
<DataElementOutArg>

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

1
<DataElement>ReadOutput

مخطط الفئة

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

G n_DataElement_Namespace____DataElementInterface_750 <DataElementInterface> + <DataElementOutArg> + Offer() + Read() + StopOffer() + operator=() + <DataElementInterface>() + ~<DataElementInterface>()

عرض التفاصيل

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

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

<DataElementInterface> دالة 3

Construct a DataElement from an ara::core::InstanceSpecifier

التحميلات الزائدة <DataElementInterface> 3
<DataElementInterface1> (ara::core::InstanceSpecifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept; SWS_DM_00587
<DataElementInterface2> (const <DataElementInterface2> &other)=delete; SWS_DM_01661
<DataElementInterface4> (<DataElementInterface4> &&other)=delete; SWS_DM_01662
Offer دالة

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

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

Provision of a Read DataElement (DiagnosticDataElementInterface in the role read)

virtual ara::core::Future< <DataElement>ReadOutput > Read (const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;
StopOffer دالة

This StopOffer will disable the forwarding of request messages from DM

void StopOffer () noexcept;
~<DataElementInterface> دالة

Destruction of a DataElement

virtual ~<DataElementInterface6> () noexcept;

المعاملات

operator= دالة 2

Copy assignment constructor deletion

التحميلات الزائدة = 2
<DataElementInterface3> & operator= (const <DataElementInterface3> &other)=delete; SWS_DM_01659
<DataElementInterface5> & operator= ( <DataElementInterface5> &&other)=delete; SWS_DM_01660

الثوابت

<DataElementOutArg> متغير

Member declaration representing an out argument in an Output.

<DataElementOutArgType> <DataElementOutArg>;

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

<DataElement>ReadOutput فئة

توثيق الدوال

دالة <DataElementInterface> [SWS_DM_00587] Upstream: RS_AP_00137, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

<DataElementInterface1> (ara::core::InstanceSpecifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept;

Construct a DataElement from an ara::core::InstanceSpecifier

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

تُستخدم دالة المُنشئ [SWS_DM_00587] لإنشاء مثيل لـ <DataElementInterface> عبر ara::core::InstanceSpecifier وفقًا لـ AUTOSAR_AP_SWS_Diagnostics §8.28.2.2.1.6.

الاستخدام والمعلمات:

  • instanceSpec: يحدد المثيل الفعلي للخدمة في سياق النموذج.
  • concurrencyType: يحدد سلوك التزامن وما إذا كانت الواجهة تُنفذ بأمان مؤشري (kConcurrent) أو بدون أمان مؤشري (kNotConcurrent).

التزامن وأمان الاستثناءات: أُعلن عن الدالة كـ noexcept وصُنفت في المواصفة بأنها آمنة مؤشريًا (thread-safe) وآمنة استثنائيًا (exception-safe) [SWS_DM_00587].

معالجة الأخطاء وانتهاكات النمذجة: لا تؤدي الأخطاء إلى استثناءات C++‎، بل إلى انتهاكات (Violations) محددة:

  • InstanceSpecifierMappingIntegrityViolation: يحدث عندما يتعذر حل instanceSpec في سياق العملية أو لا يشير إلى PortPrototype.
  • PortInterfaceMappingViolation: يتم الإبلاغ عنه عندما لا تتم الإشارة إلى PortPrototype ذي النوع المحدد عبر DiagnosticDataElementInterface بواسطة DiagnosticDataPortMapping.
  • ProcessMappingViolation: يحدث عند وجود مرجع مثيل، مع عدم وجود عملية منمذجة مطابقة لعملية وقت التشغيل.
  • InstanceSpecifierAlreadyInUseViolation: يُرسل عندما يكون instanceSpec محجوزًا بالفعل بواسطة استدعاء مُنشئ في نفس العملية.

تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على AUTOSAR R25-11.

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

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
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 DiagnosticDataElementInterface 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
instanceSpecThe specifier of a specific instance of a service.
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_00587
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00587@rel:R25-11#672ff64a
Content hash
672ff64a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00587
Status: valid/unmigrated Version: rel:R25-11#3137c965 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_00587@rel:R25-11#3137c965
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#5035bc322026-09-30
  • R19-11rel:R19-11#362db1312026-10-14
  • R20-11rel:R20-11#2280335d2026-10-14
  • R21-11rel:R21-11#90eaccce2026-10-14
  • R22-11rel:R22-11#163504222026-10-14
  • R23-11rel:R23-11#bbe3ec942026-10-14
  • R24-11rel:R24-11#5f9d4fbd2026-10-14
  • R25-11rel:R25-11#3137c9652026-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

دالة <DataElementInterface> [SWS_DM_01661] Upstream: RS_AP_00147

<DataElementInterface2> (const <DataElementInterface2> &other)=delete;

Copy constructor deletion

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01661
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01661@rel:R25-11#a45923b6
Content hash
a45923b6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01661
Status: valid/unmigrated Version: rel:R25-11#2f60d744 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_01661@rel:R25-11#2f60d744
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#1cd9fb522026-09-30
  • R23-11rel:R23-11#0016469c2026-10-14
  • R24-11rel:R24-11#de93ef5f2026-10-14
  • R25-11rel:R25-11#2f60d7442026-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

دالة <DataElementInterface> [SWS_DM_01662] Upstream: RS_AP_00147

<DataElementInterface4> (<DataElementInterface4> &&other)=delete;

Move constructor

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01662
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01662@rel:R25-11#c4fd133e
Content hash
c4fd133e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01662
Status: valid/unmigrated Version: rel:R25-11#2bcbb47c 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_01662@rel:R25-11#2bcbb47c
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#91b60d862026-09-30
  • R23-11rel:R23-11#df8de15a2026-10-14
  • R24-11rel:R24-11#05b223222026-10-14
  • R25-11rel:R25-11#2bcbb47c2026-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_00597] Upstream: RS_AP_00119, RS_AP_00139, RS_Diag_04169, RS_Diag_04224

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 · درجة الحرارة: غير قابل للتحكم · الموجّه: 9d47ee9edbd8 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُفعل الطريقة المتزامنة Offer لـ DataElementInterface إعادة توجيه طلبات التشخيص الواردة بواسطة عفريت Diagnostic Management (DM) إلى المعالج المقترن ([SWS_DM_00597]). لا تستقبل معلمات، وتضمن أمان الاستثناءات (exception safe / noexcept) وتُرجع ara::core::Result<void> ([SWS_DM_00597]).

تنطبق المتطلبات التالية على معالجة الأخطاء والتزامن والترتيب:

  • معالجة الأخطاء: إذا تم تقديم الخدمة بالفعل في وقت سابق، يفشل الاستدعاء ويقدم رمز الخطأ DiagOfferErrc::kAlreadyOffered مع دلالات التراجع ([SWS_DM_00597]).
  • التزامن: تم تحديد الدالة على أنها غير آمنة لخيوط المعالجة (not thread-safe) ([SWS_DM_00597]). يجب مزامنة الاستدعاءات المتزامنة على نفس المثيل من جانب التطبيق.
  • شروط الترتيب: طالما لم يتم استدعاء Offer بواسطة التطبيق التكيفي (Adaptive Application)، فلن يقوم DM بإعادة توجيه أي طلبات إلى المعالج أو سيستخدم قيم احتياطية داخلية ([SWS_DM_01525]، [SWS_DM_01527]). من المرجح أن يتم الاستدعاء عادة في مرحلة بدء التطبيق (تفسير). سؤال Q-dca0925e698789c5 (مفتوح)

يُستخدم مفهوم التوفير عبر Offer بشكل متسق أيضاً مع معالجات DM الأخرى مثل الروتينات ([SWS_DM_00594]) ومعرّفات البيانات ([SWS_DM_00599]). على الرغم من أن التسمية مستوحاة من ara::com، إلا أنها تمثل تطبيقاً مستقلاً لـ DM (SWS Diagnostics §7.3.4.1.2 «Monitors»).

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

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

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >• If successful: an ara::core::Result containing a ara:: core::Result::value_type • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: diag::DiagOfferErrc

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_00597
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00597@rel:R25-11#8307ab46
Content hash
8307ab46
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00597
Status: valid/unmigrated Version: rel:R25-11#dc11c9cd 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_00597@rel:R25-11#dc11c9cd
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#872cc3392026-09-30
  • R19-11rel:R19-11#aef2a6c42026-10-14
  • R20-11rel:R20-11#dc31bf0e2026-10-14
  • R21-11rel:R21-11#38b1f8ef2026-10-14
  • R22-11rel:R22-11#3ac4d67f2026-10-14
  • R23-11rel:R23-11#c2a3f2c12026-10-14
  • R24-11rel:R24-11#9279c3692026-10-14
  • R25-11rel:R25-11#dc11c9cd2026-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_00596] Upstream: RS_AP_00114, RS_AP_00127, RS_AP_00128, RS_AP_00138

virtual ara::core::Future< <DataElement>ReadOutput > Read (const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;

Provision of a Read DataElement (DiagnosticDataElementInterface in the role read)

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

تُستخدم الطريقة Read لتوفير عنصر بيانات داخل مثيل DiagnosticDataElementInterface في الدور read [SWS_DM_00596]. يتم الاستدعاء بشكل غير متزامن بواسطة Diagnostic Manager لمعالجة طلبات القراءة التشخيصية.

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

تُرجع الواجهة ara::core::Future مع كائن ReadOutput محدد النوع وفقاً لـ [SWS_DM_00581] [SWS_DM_00596]. يعالج التنفيذ الطلب عبر المعلمات الممررة:

  • metaInfo: يمرر معلومات وصفية حول طلب التشخيص الوارد [SWS_DM_00596].
  • cancellationHandler: يتيح مراقبة الإلغاء المبكر لمحادثة التشخيص عبر cancellationHandler.IsCanceled() بالإضافة إلى تسجيل دالة إشعار عبر cancellationHandler.SetNotifier() [SWS_DM_00596].

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

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

فيما يتعلق بسياق التنفيذ، تم التصريح عن Read بأنه not thread-safe [SWS_DM_00596]. يتطابق التفاعل مع النمط العام لعمليات القراءة التشخيصية التكيفية، كما هي محددة بشكل مماثل لمعرّفات البيانات ([SWS_DM_00640]) أو سجلات البيانات الموسعة ([SWS_DM_02156]).

تم توليد ملاحظة الاستخدام هذه تلقائيًا على أساس مواصفة AUTOSAR.

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

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
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< {<data-element-name>}ReadOutput >• If successful: an ara::core::Future containing a ReadOutput object as per [SWS_DM_00581] • If unsuccessful: an ara::core::Future containing a corresponding DiagUdsNrcErrc or ApApplicationError.

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_00596
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00596@rel:R25-11#095a06d0
Content hash
095a06d0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00596
Status: valid/unmigrated Version: rel:R25-11#db56d6b8 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_00596@rel:R25-11#db56d6b8
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#46170e3a2026-09-30
  • R19-11rel:R19-11#27ec1d4b2026-10-14
  • R20-11rel:R20-11#7e478e7b2026-10-14
  • R21-11rel:R21-11#86f986be2026-10-14
  • R22-11rel:R22-11#d7f279f42026-10-14
  • R23-11rel:R23-11#05b772b12026-10-14
  • R24-11rel:R24-11#47e253022026-10-14
  • R25-11rel:R25-11#db56d6b82026-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_00617] Upstream: RS_Diag_04169

void StopOffer () noexcept;

This StopOffer will disable the forwarding of request messages from DM

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

تعطل الطريقة StopOffer في الواجهة <DataElement-Namespace>::<DataElementInterface> إعادة توجيه رسائل الطلب الواردة من Diagnostic Management (DM) إلى عنصر البيانات المعني [SWS_DM_00617]. يتم الاستدعاء بشكل متزامن، ولا يتطلب معلمات تمرير ولا يُرجع قيمة إرجاع [SWS_DM_00617].

فيما يتعلق بمعالجة الأخطاء، تم تحديد الدالة كـ exception safe والتصريح عنها بـ noexcept [SWS_DM_00617]. لا يتم إطلاق استثناءات C++ ولا يتم إرجاع رموز خطأ. تفسير: نظراً لأن المواصفة تنص فقط على منع إعادة توجيه الرسائل، فمن المرجح أن يؤدي استدعاء الطريقة فقط إلى رفض طلبات التشخيص المستقبلية، بينما تظل المعالجات الجارية بالفعل في وقت الاستدعاء دون تأثر. سؤال Q-a741bb87f41cfe59 (مفتوح)

فيما يتعلق بالتزامن، تم تعريف الواجهة كـ not thread-safe [SWS_DM_00617]. لذلك يجب على المتصلين تأمين عمليات الوصول المتوازية إلى نفس المثيل من خلال آليات المزامنة من جانب التطبيق. على الرغم من اختيار الاسم استناداً إلى ara::com، إلا أنها واجهة مستقلة خاصة بالتشخيص لمجموعة الوظائف Diagnostics AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

يندرج التعطيل ضمن النمط المعماري العام لـ DM: توجد طرق StopOffer مماثلة لمعرّفات البيانات [SWS_DM_00600]، والروتينات العامة [SWS_DM_00558]، وخدمات UDS العامة [SWS_DM_00620] بالإضافة إلى طلبات إعادة الضبط [SWS_DM_01017]، لإنهاء إعادة توجيه الطلبات إلى المعالج المقابل بطريقة منضبطة في كل حالة.

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

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

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
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_00617
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00617@rel:R25-11#b4638c03
Content hash
b4638c03
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00617
Status: valid/unmigrated Version: rel:R25-11#f93e3c48 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_00617@rel:R25-11#f93e3c48
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#c087b5492026-09-30
  • R19-11rel:R19-11#4686d8712026-10-14
  • R20-11rel:R20-11#302902f52026-10-14
  • R21-11rel:R21-11#60b4eb6e2026-10-14
  • R22-11rel:R22-11#630d49a22026-10-14
  • R23-11rel:R23-11#d3c624d92026-10-14
  • R24-11rel:R24-11#a0e4aac82026-10-14
  • R25-11rel:R25-11#f93e3c482026-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_01659] Upstream: RS_AP_00147

<DataElementInterface3> & operator= (const <DataElementInterface3> &other)=delete;

Copy assignment constructor deletion

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01659
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01659@rel:R25-11#9b606b3d
Content hash
9b606b3d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01659
Status: valid/unmigrated Version: rel:R25-11#af6f33fc 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_01659@rel:R25-11#af6f33fc
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#473419de2026-09-30
  • R23-11rel:R23-11#9013eaab2026-10-14
  • R24-11rel:R24-11#bd96b8662026-10-14
  • R25-11rel:R25-11#af6f33fc2026-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_01660] Upstream: RS_AP_00147

<DataElementInterface5> & operator= ( <DataElementInterface5> &&other)=delete;

Move assignment constructor

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01660
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01660@rel:R25-11#c22efff6
Content hash
c22efff6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01660
Status: valid/unmigrated Version: rel:R25-11#5711e300 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_01660@rel:R25-11#5711e300
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#e5b157292026-09-30
  • R23-11rel:R23-11#1e4f2e112026-10-14
  • R24-11rel:R24-11#92f17c3c2026-10-14
  • R25-11rel:R25-11#5711e3002026-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

دالة ~<DataElementInterface> [SWS_DM_00588] Upstream: RS_Diag_04169, RS_AP_00134

virtual ~<DataElementInterface6> () noexcept;

Destruction of a DataElement

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
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_00588
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00588@rel:R25-11#584dadfa
Content hash
584dadfa
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00588
Status: valid/unmigrated Version: rel:R25-11#ad7733a4 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_00588@rel:R25-11#ad7733a4
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#b88cfb3b2026-09-30
  • R19-11rel:R19-11#4c53dc262026-10-14
  • R20-11rel:R20-11#b2fa29ed2026-10-14
  • R21-11rel:R21-11#0f467e0d2026-10-14
  • R22-11rel:R22-11#b00f6d462026-10-14
  • R23-11rel:R23-11#28e88b432026-10-14
  • R24-11rel:R24-11#2cdc2f6c2026-10-14
  • R25-11rel:R25-11#ad7733a42026-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

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

متغير <DataElementOutArg> [SWS_DM_80023] Upstream: RS_Diag_04224, RS_Diag_04169

<DataElementOutArgType> <DataElementOutArg>;

Member declaration representing an out argument in an Output.

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Symbol<DataElementOutArg>
Typ<DataElementOutArgType>

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

Record
AUTOSAR/AP/record/SWS_DM_80023
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_80023@rel:R25-11#70ff66ce
Content hash
70ff66ce
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_80023
Status: valid/unmigrated Version: rel:R25-11#caed5afa Versionshistorie & Revisions (1 transition, 3 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_80023@rel:R25-11#caed5afa
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#98e36acc2026-09-30
  • R24-11rel:R24-11#b1ac80b72026-10-14
  • R25-11rel:R25-11#caed5afa2026-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