DEENESPTFRRUARHIKOZHNL

فئة ara::diag::Event

[SWS_DM_00646] Upstream: RS_Diag_04151

class Event final {...};

Class to implement operations on diagnostic Events.

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

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

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

يتيح للتطبيقات مراقبة أحداث التشخيص وإزالة الارتداد والاستعلام عن DTC حسب الحالة.

يوفر الصنف ara::diag::Event في AUTOSAR Adaptive عمليات لمراقبة أحداث التشخيص وحالة إزالة الارتداد والخطأ الخاصة بها. وتنشئ التطبيقات الكائن عبر InstanceSpecifier، وتسجل إشعارات تغيير اختيارية، وتستعلم عن معلومات التشخيص وDTC بشكل غير متزامن [SWS_DM_00647]. وكشرط أساسي، فإن المثيل غير قابل للنسخ أو النقل، وتتطلب معظم دوال الاستعلام مزامنة من جانب التطبيق عند الوصول المتزامن نظرًا لعدم توفر الأمان الخيطي [SWS_DM_00649].

السياق

يعمل الصنف ara::diag::Event في AUTOSAR Adaptive Platform كواجهة أساسية للتفاعل مع أحداث التشخيص. وهو بمثابة حلقة وصل بين البرنامج الخاص بالتطبيق والإدارة المركزية للتشخيص. وعبر هذه الواجهة، تراقب التطبيقات حالة التشخيص وإزالة الارتداد الحالية لحدث ما، أو تتلقى إشعارات بشأن تغييرات الحالة.

تشارك أساسًا ثلاثة أطراف في التفاعل ضمن سياق النظام:

  • برمجيات التطبيق: تُنشئ مثيلًا للفئة، وتبدأ استعلامات الحالة، وتستقبل تحديثات الحالة غير المتزامنة.
  • ara::diag::Event: تُغلّف منفذ التشخيص محدد النوع (PortPrototype لـ DiagnosticEventInterface) وتوفر دوال استعلام تعمل عبر الخيوط أو العمليات.
  • Diagnostic Management (DM): يُنفذ من جانب الخادم اكتشاف الأخطاء، وتعيينات DTC، وسلوك إزالة الارتداد (Debouncing).
app Anwendungssoftware event ara::diag::Event app->event Statusabfrage / Notifier dm Diagnostic Management event->dm Ereignisdaten / Notifikationen

مخطط السياق: موضع فئة الحدث بين برمجيات التطبيق و Diagnostic Management. المصادر: [SWS_DM_00647]، [SWS_DM_00653]

دورة الحياة

يتم إنشاء المثيل صراحةً عن طريق تمرير ara::core::InstanceSpecifier [SWS_DM_00647]. ويجب أن يُشير المعرّف إلى PortPrototype محدد النوع عبر DiagnosticEventInterface. دالة البناء آمنة من الاستثناءات وآمنة بالنسبة للخيوط [SWS_DM_00647].

فيما يتعلق بملكية الموارد، تُعرّف ara::diag::Event على أنها مثيل مفرد غير قابل للنسخ وغير قابل للنقل: فكل من دالة بناء النسخ [SWS_DM_01681] ودالة بناء النقل [SWS_DM_01682] وعاملي التعيين المقترنين بهما ([SWS_DM_01679]، [SWS_DM_01680]) محذوفة صراحةً (=delete). ولا يجوز إنشاء مثيل لـ InstanceSpecifier أكثر من مرة لكل عملية [SWS_DM_00647].

يتم التدمير عبر دالة الهدم ~Event() [SWS_DM_00648]. وعلى النقيض من دالة البناء، فإن دالة الهدم ليست آمنة بالنسبة للخيوط. كما تم تحديد دوال الأعضاء الأخرى (باستثناء GetDTCNumber) بأنها غير آمنة بالنسبة للخيوط، ولهذا السبب يجب مزامنة الاستدعاءات المتوازية على نفس المثيل من جانب التطبيق. في الإصدار R25-11، تم توحيد المصطلحات المتعلقة بذلك من Reentrancy إلى Concurrency AUTOSAR_AP_SWS_Diagnostics §1 «Change History».

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

تنقسم حالة الاستخدام النموذجية إلى الاستدعاءات التالية:

  1. التهيئة: يُنشئ التطبيق المثيل عبر InstanceSpecifier الخاص به [SWS_DM_00647]. ويُرجّح أن يُنشئ الربط الاتصال مع عفريت التشخيص (daemon) في وقت التهيئة. سؤال Q-78e4462a0d147cfb (مفتوح)
  2. تسجيل المُخطر: للمراقبة، يتم تسجيل دالة استدعاء رد (callback) اختياريًا عبر SetEventStatusChangedNotifier [SWS_DM_00650]. وأي استدعاء لاحق يحل محل المُخطر المحدد سابقًا.
  3. استعلامات الحالة: أثناء التشغيل، يستعلم التطبيق عن بيانات التشخيص بشكل غير متزامن عبر ara::core::Future:
    • GetEventStatus() يُحدد بايت الحالة الحالي [SWS_DM_00649].
    • GetDebouncingStatus() يُعيد حالة إزالة الارتداد الحالية [SWS_DM_00654].
    • GetFaultDetectionCounter() يسترجع عدّاد اكتشاف الأخطاء (FDC) [SWS_DM_00656].
    • GetTestComplete() يتحقق مما إذا كان الاختبار قد اكتمل (وصول FDC إلى -128 أو 127) [SWS_DM_00655].
    • GetDTCNumber(dtcFormat) يُوفر رقم DTC المرتبط بالتنسيق المحدد وهو آمن بالنسبة للخيوط [SWS_DM_00653].
سير نموذجي لتفاعل حدث التشخيصالتطبيقara::diag::EventDiagnostic ManagementEvent(specifier)Verbindung registrierenSetEventStatusChangedNotifier(notifier)Result<void>GetEventStatus()Ereignisstatus anfordernEventStatusByteFuture<EventStatusByte>optتتغير حالة الحدثStatusaktualisierungnotifier(EventStatusByte)

مخطط التتابع: تسلسل التفاعل النموذجي بين التطبيق، ومثيل الحدث، و Diagnostic Management. المصادر: [SWS_DM_00647]، [SWS_DM_00650]، [SWS_DM_00649]، [SWS_DM_00653]

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

تحدث شروط الخطأ على شكل انتهاكات نمذجة (Violations) عند إنشاء المثيل أو كرموز أخطاء في وقت التشغيل:

  • الانتهاكات عند استدعاء الدالة الإنشائية [SWS_DM_00647]:
    • InstanceSpecifierMappingIntegrityViolation: لا يمكن حل المعرّف في النموذج أو أنه لا يُشير إلى PortPrototype.
    • PortInterfaceMappingViolation: الـ PortPrototype المُشار إليه ليس محدد النوع كـ DiagnosticEventInterface.
    • ProcessMappingViolation: لم يتم العثور على سياق منمذج متوافق مع العملية.
    • InstanceSpecifierAlreadyInUseViolation: المعرّف مستخدم بالفعل بواسطة مثيل نشط في نفس العملية.
  • رموز أخطاء وقت التشغيل عبر ara::core::Result أو ara::core::Future:
    • DiagErrc::kServiceNotAvailable: يحدث مع جميع استعلامات الحالة ([SWS_DM_00649]، [SWS_DM_00653]، [SWS_DM_00654]، [SWS_DM_00655]، [SWS_DM_00656]) إذا كانت وظائف الخلفية الأساسية لـ Diagnostic Management غير متاحة. ويُرجّح أن يتم الاتصال بشكل غير متزامن عبر IPC. سؤال (مفتوح)
    • DiagErrc::kNoSuchDTC: يُبلّغ عنه بواسطة GetDTCNumber إذا لم يكن هناك DTC مسجل للحدث [SWS_DM_00653].
    • DiagErrc::kInvalidArgument: يُعاد بواسطة SetEventStatusChangedNotifier، على سبيل المثال في حالة تمرير قيم غير صالحة [SWS_DM_00650].

يستند هذا الدليل إلى مواصفات AUTOSAR Adaptive Platform في الإصدار R25-11.

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

مخطط الفئة

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

G nara__diag__Event255 Event + Event() + operator=() + ~Event() + GetDTCNumber() + GetDebouncingStatus() + GetEventStatus() + GetFaultDetectionCounter() + GetTestComplete() + SetEventStatusChangedNotifier()

عرض التفاصيل

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

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

Event دالة 3

Constructor Event class.

التحميلات الزائدة Event 3
explicit Event (const ara::core::InstanceSpecifier &specifier) noexcept; SWS_DM_00647
Event (Event &)=delete; SWS_DM_01681
Event (Event &&) noexcept=delete; SWS_DM_01682
~Event دالة

Destructor of class Event.

~Event () noexcept;

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

Get the current debouncing status.

ara::core::Future< DebouncingState > GetDebouncingStatus () noexcept;
GetDTCNumber دالة

Returns the DTC number related to this event instance.

ara::core::Future< std::uint32_t > GetDTCNumber (DTCFormatType dtc Format) noexcept;

Returns the current diagnostic event status.

ara::core::Future< EventStatusByte > GetEventStatus () noexcept;

Returns the current value of the Fault Detection Counter (FDC) of this event.

ara::core::Future< std::int8_t > GetFaultDetectionCounter () noexcept;

Get the status if the event has matured to test completed (corresponds to FDC = -128 or FDC = 127).

ara::core::Future< bool > GetTestComplete () noexcept;

Register a notifier function which is called if a diagnostic event is changed. A consecutive call of this method will overwrite the previous registered notifier.

ara::core::Result< void > SetEventStatusChangedNotifier (EventStatus ByteNotifier notifier) noexcept;

المعاملات

operator= دالة 2

Event shall be a single not assign-able instance.

التحميلات الزائدة = 2
Event & operator= (Event &)=delete; SWS_DM_01679
Event & operator= (Event &&)=delete; SWS_DM_01680

توثيق الدوال

دالة Event [SWS_DM_00647] Upstream: RS_Diag_04151, RS_AP_00137, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

explicit Event (const ara::core::InstanceSpecifier &specifier) noexcept;

Constructor Event class.

Header-Datei#include "ara/diag/event.h"
Scopeclass ara::diag::Event
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 referenced by a pingViolation DiagnosticEventPortMapping needs to be typed by a DiagnosticEventInterface. 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 DiagnosticEventInterface.

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

Record
AUTOSAR/AP/record/SWS_DM_00647
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00647@rel:R25-11#37fc4793
Content hash
37fc4793
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00647
Status: valid/unmigrated Version: rel:R25-11#5add1f87 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_00647@rel:R25-11#5add1f87
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#f0666d8e2026-09-30
  • R19-11rel:R19-11#3c89d7ee2026-10-14
  • R20-11rel:R20-11#870e61ce2026-10-14
  • R21-11rel:R21-11#f7c5ed1f2026-10-14
  • R22-11rel:R22-11#8c18fb3e2026-10-14
  • R23-11rel:R23-11#f694eb632026-10-14
  • R24-11rel:R24-11#51cd865b2026-10-14
  • R25-11rel:R25-11#5add1f872026-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

دالة Event [SWS_DM_01681] Upstream: RS_AP_00147

Event (Event &)=delete;

Event shall be a single not copy-able instance.

Header-Datei#include "ara/diag/event.h"
Scopeclass ara::diag::Event

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

Record
AUTOSAR/AP/record/SWS_DM_01681
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01681@rel:R25-11#42e30d35
Content hash
42e30d35
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01681
Status: valid/unmigrated Version: rel:R25-11#99c774ff 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_01681@rel:R25-11#99c774ff
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#04d5b97d2026-09-30
  • R23-11rel:R23-11#43b1f1382026-10-14
  • R24-11rel:R24-11#99c774ff2026-10-14
  • R25-11rel:R25-11#99c774ff2026-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

دالة Event [SWS_DM_01682] Upstream: RS_AP_00147

Event (Event &&) noexcept=delete;

Move constructor of Event.

Header-Datei#include "ara/diag/event.h"
Scopeclass ara::diag::Event

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

Record
AUTOSAR/AP/record/SWS_DM_01682
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01682@rel:R25-11#7d797591
Content hash
7d797591
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01682
Status: valid/unmigrated Version: rel:R25-11#65729748 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_01682@rel:R25-11#65729748
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#8addd59c2026-09-30
  • R23-11rel:R23-11#30e0773c2026-10-14
  • R24-11rel:R24-11#657297482026-10-14
  • R25-11rel:R25-11#657297482026-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

دالة GetDTCNumber [SWS_DM_00653] Upstream: RS_Diag_04201, RS_AP_00139, RS_AP_00119

ara::core::Future< std::uint32_t > GetDTCNumber (DTCFormatType dtc Format) noexcept;

Returns the DTC number related to this event instance.

Header-Datei#include "ara/diag/event.h"
Scopeclass ara::diag::Event
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
dtcFormatDefine the DTC format for the return value.

Rückgabewert

TypBeschreibung
ara::core::Future<std::uint32_t >Return the DTC number in respective DTC format.

Fehler

FehlercodeBeschreibung
DiagErrc::kNoSuchDTCrollback_semantics No mapped DTC exits for the requested event.
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

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

Record
AUTOSAR/AP/record/SWS_DM_00653
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00653@rel:R25-11#ebad0cbc
Content hash
ebad0cbc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00653
Status: valid/unmigrated Version: rel:R25-11#5e084285 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_00653@rel:R25-11#5e084285
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#c154a4692026-09-30
  • R19-11rel:R19-11#5dafafb22026-10-14
  • R20-11rel:R20-11#bf458cb22026-10-14
  • R21-11rel:R21-11#06484d962026-10-14
  • R22-11rel:R22-11#8f25efce2026-10-14
  • R23-11rel:R23-11#481fbbe32026-10-14
  • R24-11rel:R24-11#07fccb8e2026-10-14
  • R25-11rel:R25-11#5e0842852026-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

دالة GetDebouncingStatus [SWS_DM_00654] Upstream: RS_Diag_04068, RS_Diag_04225, RS_AP_00139

ara::core::Future< DebouncingState > GetDebouncingStatus () noexcept;

Get the current debouncing status.

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

Rückgabewert

TypBeschreibung
ara::core::Future<DebouncingState >Return the current debouncing state of this event.

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

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

Record
AUTOSAR/AP/record/SWS_DM_00654
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00654@rel:R25-11#96ae938b
Content hash
96ae938b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00654
Status: valid/unmigrated Version: rel:R25-11#8bddb1d0 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_00654@rel:R25-11#8bddb1d0
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#aa2d0fb82026-09-30
  • R19-11rel:R19-11#343c856a2026-10-14
  • R20-11rel:R20-11#76fa6fa62026-10-14
  • R21-11rel:R21-11#76fa6fa62026-10-14
  • R22-11rel:R22-11#b0bcfa5d2026-10-14
  • R23-11rel:R23-11#773a565b2026-10-14
  • R24-11rel:R24-11#58de85e42026-10-14
  • R25-11rel:R25-11#8bddb1d02026-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

دالة GetEventStatus [SWS_DM_00649] Upstream: RS_Diag_04151, RS_AP_00139

ara::core::Future< EventStatusByte > GetEventStatus () noexcept;

Returns the current diagnostic event status.

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

Rückgabewert

TypBeschreibung
ara::core::Future< EventStatusByte >Return the current diagnostic event status

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

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

Record
AUTOSAR/AP/record/SWS_DM_00649
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00649@rel:R25-11#e5bdb269
Content hash
e5bdb269
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00649
Status: valid/unmigrated Version: rel:R25-11#88b46805 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_00649@rel:R25-11#88b46805
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#73c9caf02026-09-30
  • R19-11rel:R19-11#ac7535d32026-10-14
  • R20-11rel:R20-11#aa687a9f2026-10-14
  • R21-11rel:R21-11#aa687a9f2026-10-14
  • R22-11rel:R22-11#9ace322d2026-10-14
  • R23-11rel:R23-11#09d412822026-10-14
  • R24-11rel:R24-11#c1f9b0482026-10-14
  • R25-11rel:R25-11#88b468052026-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

دالة GetFaultDetectionCounter [SWS_DM_00656] Upstream: RS_Diag_04068, RS_AP_00139

ara::core::Future< std::int8_t > GetFaultDetectionCounter () noexcept;

Returns the current value of the Fault Detection Counter (FDC) of this event.

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

Rückgabewert

TypBeschreibung
ara::core::Future<std::int8_t >Returns the current FaultDetectionCounter value.

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

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

Record
AUTOSAR/AP/record/SWS_DM_00656
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00656@rel:R25-11#a4666776
Content hash
a4666776
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00656
Status: valid/unmigrated Version: rel:R25-11#4907132c 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_00656@rel:R25-11#4907132c
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#94f917742026-09-30
  • R19-11rel:R19-11#f9f594e72026-10-14
  • R20-11rel:R20-11#57d52b342026-10-14
  • R21-11rel:R21-11#678c683c2026-10-14
  • R22-11rel:R22-11#845aefab2026-10-14
  • R23-11rel:R23-11#f314b0512026-10-14
  • R24-11rel:R24-11#b946e5e42026-10-14
  • R25-11rel:R25-11#4907132c2026-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

دالة GetTestComplete [SWS_DM_00655] Upstream: RS_Diag_04151, RS_AP_00139

ara::core::Future< bool > GetTestComplete () noexcept;

Get the status if the event has matured to test completed (corresponds to FDC = -128 or FDC = 127).

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

Rückgabewert

TypBeschreibung
ara::core::Future< bool >Return the current test_completed-state of this event. TRUE, if FDC = -128 or FDC = 127; FALSE in all other cases.

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

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

Record
AUTOSAR/AP/record/SWS_DM_00655
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00655@rel:R25-11#95745d18
Content hash
95745d18
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00655
Status: valid/unmigrated Version: rel:R25-11#567ebe83 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_00655@rel:R25-11#567ebe83
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#2124e8272026-09-30
  • R19-11rel:R19-11#3073277b2026-10-14
  • R20-11rel:R20-11#2be275092026-10-14
  • R21-11rel:R21-11#1d60449a2026-10-14
  • R22-11rel:R22-11#5d7ba70b2026-10-14
  • R23-11rel:R23-11#6d14f8702026-10-14
  • R24-11rel:R24-11#1273d1452026-10-14
  • R25-11rel:R25-11#567ebe832026-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

دالة SetEventStatusChangedNotifier [SWS_DM_00650] Upstream: RS_Diag_04183, RS_AP_00139

ara::core::Result< void > SetEventStatusChangedNotifier (EventStatus ByteNotifier notifier) noexcept;

Register a notifier function which is called if a diagnostic event is changed. A consecutive call of this method will overwrite the previous registered notifier.

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

من خلال الطريقة [SWS_DM_00650] للفئة ara::diag::Event (ملف الرأس ara/diag/event.h)، يسجل تطبيق Adaptive Application دالة رد نداء من النوع EventStatusByteNotifier. وبعد نجاح التسجيل، يستدعي Diagnostic Management (DM) هذا المُشعِر (Notifier) عند كل تغيير في حالة الحدث التشخيصي المرتبط [SWS_DM_01029]. يؤدي الاستدعاء المتتالي للطريقة إلى الكتابة فوق المُشعِر المسجل سابقًا [SWS_DM_00650]. تمتلك الدالة التوقيع ara::core::Result<void> SetEventStatusChangedNotifier(EventStatusByteNotifier notifier) noexcept وتُرجع في حالة النجاح نتيجة فارغة [SWS_DM_00650].

إذا حدث خطأ أثناء المعالجة، تُرجع الطريقة رمز الخطأ DiagErrc::kInvalidArgument [SWS_DM_00650]. ومع أن الواجهة مصرح بها على أنها آمنة من الاستثناءات (exception safe)، إلا أنها تُعد صراحة غير آمنة لخيوط المعالجة (not thread-safe) [SWS_DM_00650]. تفسير: يجب مزامنة عمليات الوصول المتزامنة إلى نفس المثيل من جانب التطبيق؛ وبالتالي يُرجح أن يتم إجراء التسجيل بشكل مفضل أثناء مرحلة تهيئة التطبيق. سؤال Q-d8ed099eaed6b197 (مفتوح)

وظيفيًا، يمثل المُشعِر النظير غير المتزامن للاستعلام المتزامن عن الحالة عبر GetEventStatus [SWS_DM_00886]، كما هو موضح في SWS Diagnostics §7.3.4.1.7 «Event status change notifications». بالنسبة للمثيلات الجماعية، توفر الفئة ara::diag::MultipleEvent الطريقة المقابلة [SWS_DM_01708] مع تمرير إضافي لـ EventHandleType SWS Diagnostics §8.43.2.1.3.5 «SetEventStatusChangedNotifier».

تم توليد إشعار الاستخدام هذا آليًا استنادًا إلى مواصفة AUTOSAR Adaptive R25-11.

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

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

Parameter (in)

ParameterBeschreibung
notifierThe function to be called if a diagnostic event is changed.

Rückgabewert

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

Fehler

FehlercodeBeschreibung
DiagErrc::kInvalidArgumentrollback_semantics e.g. kPreFailed with internal debouncing

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

Record
AUTOSAR/AP/record/SWS_DM_00650
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00650@rel:R25-11#05cdf0da
Content hash
05cdf0da
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00650
Status: valid/unmigrated Version: rel:R25-11#2c7ca3fc 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_00650@rel:R25-11#2c7ca3fc
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#a0cbc3d82026-09-30
  • R19-11rel:R19-11#dc5182fc2026-10-14
  • R20-11rel:R20-11#23d7e9432026-10-14
  • R21-11rel:R21-11#dbbe3d9e2026-10-14
  • R22-11rel:R22-11#ed3ac0b02026-10-14
  • R23-11rel:R23-11#6fbd522f2026-10-14
  • R24-11rel:R24-11#019f01af2026-10-14
  • R25-11rel:R25-11#2c7ca3fc2026-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_01679] Upstream: RS_AP_00147

Event & operator= (Event &)=delete;

Event shall be a single not assign-able instance.

Header-Datei#include "ara/diag/event.h"
Scopeclass ara::diag::Event

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

Record
AUTOSAR/AP/record/SWS_DM_01679
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01679@rel:R25-11#1741f769
Content hash
1741f769
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01679
Status: valid/unmigrated Version: rel:R25-11#10ef80b0 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_01679@rel:R25-11#10ef80b0
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#2fa03c0a2026-09-30
  • R23-11rel:R23-11#fccd65ac2026-10-14
  • R24-11rel:R24-11#10abe0b52026-10-14
  • R25-11rel:R25-11#10ef80b02026-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_01680] Upstream: RS_AP_00147

Event & operator= (Event &&)=delete;

Move assignment operator of Event.

Header-Datei#include "ara/diag/event.h"
Scopeclass ara::diag::Event

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

Record
AUTOSAR/AP/record/SWS_DM_01680
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01680@rel:R25-11#945ff17c
Content hash
945ff17c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01680
Status: valid/unmigrated Version: rel:R25-11#c25e65da 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_01680@rel:R25-11#c25e65da
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#986c114c2026-09-30
  • R23-11rel:R23-11#89bb7bca2026-10-14
  • R24-11rel:R24-11#c25e65da2026-10-14
  • R25-11rel:R25-11#c25e65da2026-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

دالة ~Event [SWS_DM_00648] Upstream: RS_Diag_04151, RS_AP_00134

~Event () noexcept;

Destructor of class Event.

Header-Datei#include "ara/diag/event.h"
Scopeclass ara::diag::Event
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_00648
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00648@rel:R25-11#cacb7176
Content hash
cacb7176
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00648
Status: valid/unmigrated Version: rel:R25-11#a0bd8c99 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_00648@rel:R25-11#a0bd8c99
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#c8ade5942026-09-30
  • R19-11rel:R19-11#484b371b2026-10-14
  • R20-11rel:R20-11#98c042472026-10-14
  • R21-11rel:R21-11#4af04e862026-10-14
  • R22-11rel:R22-11#f870d3302026-10-14
  • R23-11rel:R23-11#9789d55a2026-10-14
  • R24-11rel:R24-11#bd9345702026-10-14
  • R25-11rel:R25-11#a0bd8c992026-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