DEENESPTFRRUARHIKOZHNL

فئة ara::diag::DoIPActivationLine

[SWS_DM_00830] Upstream: RS_Diag_04242

class DoIPActivationLine {...};

DiagnosticDoIPActivationLineInterface.

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

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

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

يُستخدم لنقل حالة خط تفعيل DoIP وإدارتها لدى Diagnostic Manager.

تتيح الفئة ara::diag::DoIPActivationLine للتطبيق توفير حالة خط تفعيل DoIP ونقل التغييرات إلى Diagnostic Manager [SWS_DM_00830]. وبعد إنشاء النسخة بالاعتماد على المنفذ (port-based)، يتم تنشيط الخدمة بواسطة Offer()، وبناءً على ذلك يستعلم DM عن حالة الخط ومُعرّف الشبكة ID، ويتلقى تغيّرات الحالة عبر UpdateActivationLineState() [SWS_DM_00834]. وبوصفه شرطاً حافياً أساسياً، يجب تكوين واجهة الشبكة المرتبطة في النموذج لتكون معتمدة على خط التفعيل [SWS_DM_00833].

السياق

تمثّل الفئة ara::diag::DoIPActivationLine الواجهة DiagnosticDoIPActivationLineInterface وفقاً لـ [SWS_DM_00830]. وتتيح لـ Adaptive Application (AA) إبلاغ Diagnostic Manager (DM) بالحالة الفيزيائية أو المنطقية لخط تفعيل DoIP وتوفيرها له. وتتحكم التطبيقات بشكل غير مباشر عبر خط التفعيل هذا في إرسال رسائل الإعلان عن المركبة لـ DoIP (Vehicle Announcement Messages)، على النحو المحدد في AUTOSAR_AP_SWS_Diagnostics, ص. 107، دون تحفيز الإرسال ذاتياً وبشكل صريح.

يشارك في هذا التفاعل أساساً ثلاثة مكونات: الـ Adaptive Application المنفذة، ونسخة ara::diag::DoIPActivationLine بوصفها واجهة خدمة، بالإضافة إلى Diagnostic Manager للنظام الأساسي. وإذا اكتشف DM عبر هذه الواجهة تغيراً في حالة خط التفعيل، فإنه يُخطر واجهات الشبكة التابعة ويبدأ تسلسلات DoIP القياسية [SWS_DM_00816].

aa Adaptive Application line ara::diag::DoIPActivationLine aa->line Instanziierung / Offer() / UpdateActivationLineState() dm Diagnostic Management (DM) line->dm Zustandsbereitstellung dm->line GetActivationLineState() / GetNetworkInterfaceId()

مخطط السياق: أطراف التفاعل لخط تفعيل DoIP بين التطبيق وDiagnostic Management. المصادر: [SWS_DM_00830]، [SWS_DM_00816]، AUTOSAR_AP_SWS_Diagnostics, ص. 107.

دورة الحياة

يتم إنشاء نسخة من ara::diag::DoIPActivationLine عبر ara::core::InstanceSpecifier يشير إلى PortPrototype [SWS_DM_00831]. وتمثّل الفئة نسخة فريدة: فمُنشئات النسخ والنقل، وكذلك معاملات الإسناد بالنسخ والنقل محذوفة (=delete)، مما يمنع النقل أو التكرار ([SWS_DM_01631]، [SWS_DM_01632]، [SWS_DM_01633]، [SWS_DM_01634]).

بعد إنشاء النسخة، يكون الكائن في حالة «غير معروض». وعبر استدعاء Offer() يتم تفعيل التوفير، بحيث يمكن لـ DM الاستماع إلى تغيّرات حالة خط التفعيل [SWS_DM_00836]. وبواسطة StopOffer() يتم إلغاء تنشيط هذا التوفير مجدداً [SWS_DM_00837]. تم الإعلان عن المُدمّر الافتراضي كمُدمّر افتراضي قياسي ويقوم بتحرير الموارد [SWS_DM_00832]. وفيما يتعلق بالتزامن، فإن المُنشئ [SWS_DM_00831] واستعلامات القراءة البحتة GetActivationLineState() [SWS_DM_00835] وGetNetworkInterfaceId() [SWS_DM_00833] تم تنفيذها لتكون آمنة خيطياً، بينما Offer() [SWS_DM_00836] وStopOffer() [SWS_DM_00837] وUpdateActivationLineState() [SWS_DM_00834] ليست آمنة خيطياً.

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

يتضمن المسار المعتاد اشتقاق وتسجيل فئة خاصة بالتطبيق، بالإضافة إلى النقل المستمر للحالة:

  1. إنشاء النسخة: تقوم الـ Adaptive Application بإنشاء نسخة من الفئة المشتقة مع تحديد InstanceSpecifier المناسب [SWS_DM_00831].
  2. عرض الخدمة: يستدعي التطبيق Offer() لإتاحة الواجهة لـ DM [SWS_DM_00836].
  3. استعلام الشبكة والاستعلام الأولي: يحدد DM عبر الطريقة الافتراضية البحتة (pure virtual) GetNetworkInterfaceId() مُعرّف الواجهة Interface-ID المرتبط [SWS_DM_00833] ويستعلم باستخدام GetActivationLineState() عن حالة الخط الحالية [SWS_DM_00835]. وتُرجع كلتا الطريقتين ara::core::Future.
  4. تحديث الحالة: إذا تغيّرت الحالة الفيزيائية للخط (مثل تغيّر المستوى في خط عتادي)، يقوم التطبيق بإبلاغ DM تزامناً عبر UpdateActivationLineState() [SWS_DM_00834]. ويؤدي هذا إلى حثّ DM على اتخاذ إجراءات تابعة مثل إرسال إخطارات الحالة إلى واجهات الشبكة [SWS_DM_00816].
  5. الإنهاء: يستدعي التطبيق StopOffer() قبل إيقاف التشغيل أو عند إلغاء التنشيط [SWS_DM_00837].
Nutzungsablauf DoIPActivationLineAppDoIPActivationLineDiagnosticManagerUse Case: التهيئة والتسجيلDoIPActivationLine(specifier)Offer()Result<void>Use Case: Abfrage durch DMGetNetworkInterfaceId()Future<uint8_t>GetActivationLineState()Future<bool>Use Case: تحديث مستند إلى الأحداثUpdateActivationLineState(true)الإشارة إلى تغيير الحالةUse Case: DeaktivierungStopOffer()

مخطط التتابع: المسار النموذجي لتسجيل واستعلام وتحديث خط التفعيل. المصادر: [SWS_DM_00831]، [SWS_DM_00833]، [SWS_DM_00834]، [SWS_DM_00835]، [SWS_DM_00836]، [SWS_DM_00837].

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

عند استخدام ara::diag::DoIPActivationLine، يمكن أن تحدث أخطاء وظيفية وأخطاء في التكوين:

  • انتهاكات النموذج والمنفذ عند الإنشاء: يتحقق المُنشئ من صلاحية InstanceSpecifier [SWS_DM_00831]. وإذا فشل التحليل، يتم إطلاق إخطارات انتهاك قياسية: InstanceSpecifierMappingIntegrityViolation (عنصر نموذج غير صالح)، أو PortInterfaceMappingViolation (المنفذ غير محدّد النوع بواسطة DiagnosticDoIPActivationLineInterface)، أو ProcessMappingViolation (غياب الارتباط بالعملية)، أو InstanceSpecifierAlreadyInUseViolation (تم تعيين المحدد مسبقاً داخل العملية).
  • العرض المتعدد: إذا تم استدعاء Offer() أثناء كون الخدمة معروضة بالفعل، تفشل العملية برمز الخطأ DiagOfferErrc::kAlreadyOffered [SWS_DM_00836].
  • عدم اتساق تكوين واجهة الشبكة: إذا أبلغ التطبيق عبر GetNetworkInterfaceId() عن مُعرّف واجهة Interface-ID تمتلك DoIpNetworkConfiguration المرتبطة به الخاصية isActivationLineDependent = 'FALSE'، فإن هذا يُعد وفقاً للمواصفة صراحةً خطأ تكوين جسيماً [SWS_DM_00833].
  • أمان الاستثناءات: بينما تم تحديد المُنشئ ودوال الجلب (getters) وOffer() وStopOffer() والمُدمّر على أنها آمنة من حيث الاستثناءات (exception safe)، فإن UpdateActivationLineState() محدد صراحةً على أنه غير آمن من حيث الاستثناءات (not exception safe) [SWS_DM_00834]. ولذلك، يجب معالجة الأخطاء داخل هذا الاستدعاء بعناية من قِبل التطبيق المستدعي.

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

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

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

2
DoIPActivationLine~DoIPActivationLine

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

5
GetActivationLineStateGetNetworkInterfaceIdOfferStopOfferUpdateActivationLineState

المعاملات

1
operator=

مخطط الفئة

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

G nara__diag__DoIPActivationLine856 DoIPActivationLine + DoIPActivationLine() + operator=() + ~DoIPActivationLine() + GetActivationLineState() + GetNetworkInterfaceId() + Offer() + StopOffer() + UpdateActivationLineState()

عرض التفاصيل

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

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

DoIPActivationLine دالة 3

Constructor of DoIPActivationLine.

التحميلات الزائدة DoIPActivationLine 3
explicit DoIPActivationLine (const ara::core::InstanceSpecifier &specifier) noexcept; SWS_DM_00831
DoIPActivationLine (DoIPActivationLine &)=delete; SWS_DM_01633
DoIPActivationLine (DoIPActivationLine &&) noexcept=delete; SWS_DM_01634
~DoIPActivationLine دالة

Destructor of DoIPActivationLine.

virtual ~DoIPActivationLine () noexcept=default;

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

GetActivationLineState دالة

Called to get the current activation line state.

virtual ara::core::Future< bool > GetActivationLineState () noexcept=0;
GetNetworkInterfaceId دالة

Called to get the network interface Id (see DoIpNetworkConfiguration. networkInterfaceId) for which this DoIPActivationLine instance is responsible.

virtual ara::core::Future< std::uint8_t > GetNetworkInterfaceId () noexcept=0;
Offer دالة

This Offer will enable the DM to listen to activation line state changes.

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

This StopOffer will disable the provision of activation line state to DM.

void StopOffer () noexcept;
UpdateActivationLineState دالة

Called to update current activation line state.

void UpdateActivationLineState (bool activation_line_state);

المعاملات

operator= دالة 2

DoIPActivationLine shall be a single not assignable instance.

التحميلات الزائدة = 2
DoIPActivationLine & operator= (DoIPActivationLine &)=delete; SWS_DM_01631
DoIPActivationLine & operator= (DoIPActivationLine &&)=delete; SWS_DM_01632

توثيق الدوال

دالة DoIPActivationLine [SWS_DM_00831] Upstream: RS_Diag_04242, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

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

Constructor of DoIPActivationLine.

Header-Datei#include "ara/diag/doip_activationline.h"
Scopeclass ara::diag::DoIPActivationLine
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 DiagnosticDoIpActivationLinePortMapping needs to be typed by a DiagnosticDoIPActivationLineInterface. 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 DiagnosticDoIPActivationLineInterface

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

Record
AUTOSAR/AP/record/SWS_DM_00831
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00831@rel:R25-11#c1440955
Content hash
c1440955
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00831
Status: valid/unmigrated Version: rel:R25-11#02e59d5a 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_00831@rel:R25-11#02e59d5a
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0d3576422026-09-30
  • R19-11rel:R19-11#1fa409022026-10-14
  • R20-11rel:R20-11#69e772552026-10-14
  • R21-11rel:R21-11#a475004c2026-10-14
  • R22-11rel:R22-11#c63185452026-10-14
  • R23-11rel:R23-11#2968f9562026-10-14
  • R24-11rel:R24-11#9847f0762026-10-14
  • R25-11rel:R25-11#02e59d5a2026-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

دالة DoIPActivationLine [SWS_DM_01633] Upstream: RS_AP_00147

DoIPActivationLine (DoIPActivationLine &)=delete;

DoIPActivationLine shall be a single not copy-able instance.

Header-Datei#include "ara/diag/doip_activationline.h"
Scopeclass ara::diag::DoIPActivationLine

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

Record
AUTOSAR/AP/record/SWS_DM_01633
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01633@rel:R25-11#87601382
Content hash
87601382
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01633
Status: valid/unmigrated Version: rel:R25-11#af888c8e 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_01633@rel:R25-11#af888c8e
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#2af8a7bb2026-09-30
  • R23-11rel:R23-11#4c32a80e2026-10-14
  • R24-11rel:R24-11#af888c8e2026-10-14
  • R25-11rel:R25-11#af888c8e2026-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

دالة DoIPActivationLine [SWS_DM_01634] Upstream: RS_AP_00147

DoIPActivationLine (DoIPActivationLine &&) noexcept=delete;

Move constructor of DoIPActivationLine.

Header-Datei#include "ara/diag/doip_activationline.h"
Scopeclass ara::diag::DoIPActivationLine

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

Record
AUTOSAR/AP/record/SWS_DM_01634
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01634@rel:R25-11#d5b5b93b
Content hash
d5b5b93b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01634
Status: valid/unmigrated Version: rel:R25-11#1802a1ef 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_01634@rel:R25-11#1802a1ef
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#73cbce7c2026-09-30
  • R23-11rel:R23-11#2946af112026-10-14
  • R24-11rel:R24-11#1802a1ef2026-10-14
  • R25-11rel:R25-11#1802a1ef2026-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

دالة GetActivationLineState [SWS_DM_00835] Upstream: RS_Diag_04242

virtual ara::core::Future< bool > GetActivationLineState () noexcept=0;

Called to get the current activation line state.

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

Rückgabewert

TypBeschreibung
ara::core::Future< bool >TRUE in case the activation line is active, else FALSE.

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_DM_00835
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00835@rel:R25-11#b54bc23a
Content hash
b54bc23a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00835
Status: valid/unmigrated Version: rel:R25-11#cf922a21 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_00835@rel:R25-11#cf922a21
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#aa66ee3b2026-09-30
  • R19-11rel:R19-11#2d47c0942026-10-14
  • R20-11rel:R20-11#e6d4e1fb2026-10-14
  • R21-11rel:R21-11#e6d4e1fb2026-10-14
  • R22-11rel:R22-11#6873386f2026-10-14
  • R23-11rel:R23-11#d58b1d652026-10-14
  • R24-11rel:R24-11#dc8ab3bf2026-10-14
  • R25-11rel:R25-11#cf922a212026-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

دالة GetNetworkInterfaceId [SWS_DM_00833] Upstream: RS_Diag_04242

virtual ara::core::Future< std::uint8_t > GetNetworkInterfaceId () noexcept=0;

Called to get the network interface Id (see DoIpNetworkConfiguration. networkInterfaceId) for which this DoIPActivationLine instance is responsible.

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

Rückgabewert

TypBeschreibung
ara::core::Future<std::uint8_t >network interface id for which this activation line is responsible.

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.
Hinweise: If the reported DoIpNetworkConfiguration.networkInterfaceId belongs to a DoIpNetworkConfiguration with property isActivationLineDependent = ’FALSE’, this is an error!

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

Record
AUTOSAR/AP/record/SWS_DM_00833
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00833@rel:R25-11#1b1a35a5
Content hash
1b1a35a5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00833
Status: valid/unmigrated Version: rel:R25-11#43f7d605 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_00833@rel:R25-11#43f7d605
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#4310a8ab2026-09-30
  • R19-11rel:R19-11#4310f8222026-10-14
  • R20-11rel:R20-11#545ef8b52026-10-14
  • R21-11rel:R21-11#545ef8b52026-10-14
  • R22-11rel:R22-11#6888adac2026-10-14
  • R23-11rel:R23-11#415a29a22026-10-14
  • R24-11rel:R24-11#a298c0c42026-10-14
  • R25-11rel:R25-11#43f7d6052026-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_00836] Upstream: RS_Diag_04242, RS_AP_00119

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

This Offer will enable the DM to listen to activation line state changes.

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

تمكّن الطريقة المتزامنة Offer من الفئة ara::diag::DoIPActivationLine ([SWS_DM_00836]، ملف الرأس #include "ara/diag/doip_activationline.h") Diagnostic Management (DM) من اكتشاف تغييرات حالة خط التنشيط. لا تحتوي العملية على معلمات تمرير وتبلغ بالنتيجة عبر نوع الإرجاع ara::core::Result<void>.

بمجرد توفير الواجهة بواسطة Offer، يراقب DM خط التنشيط. إذا اكتشف DM انتقالاً إلى الحالة «active»، فإنه يبادر بإرسال رسائل إعلان المركبة (Vehicle Announcement Messages) وفقاً للمعيار ISO 13400-2 على واجهات الشبكة المعنية ([SWS_DM_00816]، AUTOSAR_AP_SWS_Diagnostics §[SWS_DM_00816] ص. 106). تفسير: يُرجح أن يتم استدعاء Offer عادةً في مرحلة تهيئة التطبيق، وذلك لاكتشاف تغييرات الحالة في وقت مبكر. سؤال Q-254ced2fd3a1e3d2 (مفتوح)

في حالة الخطأ، يتم إرجاع رمز خطأ مناسب في Result. وإذا تم استدعاء الطريقة بشكل متكرر لنفس المثيل أثناء تقديم الخدمة بالفعل، فإنها تعيد رمز الخطأ DiagOfferErrc::kAlreadyOffered مع دلالات التراجع ([SWS_DM_00836]).

فيما يتعلق بالتزامن، تم تحديد الطريقة على أنها غير آمنة لمؤشرات الترابط (not thread-safe) ([SWS_DM_00836]). ولذلك، يجب مزامنة الاستدعاءات المتزامنة على نفس المثيل من جانب التطبيق. وبفضل التصريح عنها كـ noexcept، تكون الدالة آمنة تماماً من الاستثناءات ([SWS_DM_00836]).

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

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

Header-Datei#include "ara/diag/doip_activationline.h"
Scopeclass ara::diag::DoIPActivationLine
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_00836
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00836@rel:R25-11#1468fafc
Content hash
1468fafc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00836
Status: valid/unmigrated Version: rel:R25-11#8f2ee357 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_00836@rel:R25-11#8f2ee357
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#94952ae82026-09-30
  • R19-11rel:R19-11#debb2b0e2026-10-14
  • R20-11rel:R20-11#db6aa10a2026-10-14
  • R21-11rel:R21-11#7e662f9a2026-10-14
  • R22-11rel:R22-11#b0dd4c452026-10-14
  • R23-11rel:R23-11#e3ff8ae12026-10-14
  • R24-11rel:R24-11#0d9d89c12026-10-14
  • R25-11rel:R25-11#8f2ee3572026-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_00837] Upstream: RS_Diag_04242

void StopOffer () noexcept;

This StopOffer will disable the provision of activation line state to DM.

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

تنهي الدالة ara::diag::DoIPActivationLine::StopOffer توفير حالة خط تنشيط DoIP (Activation Line) لـ Diagnostic Management (DM) وفقاً لـ [SWS_DM_00837].

تمتلك الدالة البنية void StopOffer() noexcept ويتم تنفيذها بشكل متزامن على نسخة من ara::diag::DoIPActivationLine (AUTOSAR_AP_SWS_Diagnostics §5 «Overview»). ولا تقبل أي معلمات ولا تُرجع أي قيمة. ومن خلال الاستدعاء، يتم تعطيل الإرسال النشط لتغييرات حالة خط التنشيط إلى Diagnostic Manager.

فيما يتعلق بمعالجة الأخطاء، تم تحديد الدالة بأنها exception safe وتضمن عبر noexcept عدم إطلاق أي استثناءات ([SWS_DM_00837]). ونظراً لأن العملية not thread-safe وفقاً للمواصفة، فلا يجوز أن تحدث الاستدعاءات على نفس النسخة بشكل متزامن دون حماية من عدة خيوط؛ وتتطلب عمليات الوصول المتوازية حتماً مزامنة من جانب التطبيق.

يتبع نمط التصميم التسمية المعتمدة في منصة Adaptive لتوفير الخدمة (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»). وبينما تعطل StopOffer في فئات DoIP ذات الصلة مثل ara::diag::DoIPGroupIdentification ([SWS_DM_00726]) أو ara::diag::DoIPPowerMode ([SWS_DM_00736]) إعادة توجيه طلبات DM الواردة، فإنها توقف هنا تحديداً إبلاغ حالة خط التنشيط إلى DM. التفسير: من أجل سير عمل متسق، يُرجح افتراض أنه تم بالفعل بدء التوفير بنشاط عبر نفس النسخة قبل استدعاء StopOffer. سؤال Q-c5d38151ef8198e7 (مفتوح)

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

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

Header-Datei#include "ara/diag/doip_activationline.h"
Scopeclass ara::diag::DoIPActivationLine
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_00837
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00837@rel:R25-11#fc74ffd6
Content hash
fc74ffd6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00837
Status: valid/unmigrated Version: rel:R25-11#244dc5c1 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_00837@rel:R25-11#244dc5c1
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#a103f7852026-09-30
  • R19-11rel:R19-11#b476ed0b2026-10-14
  • R20-11rel:R20-11#cfbb794a2026-10-14
  • R21-11rel:R21-11#aa427ca72026-10-14
  • R22-11rel:R22-11#03b79a162026-10-14
  • R23-11rel:R23-11#4e8a10d62026-10-14
  • R24-11rel:R24-11#9c2fce6a2026-10-14
  • R25-11rel:R25-11#244dc5c12026-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

دالة UpdateActivationLineState [SWS_DM_00834] Upstream: RS_Diag_04242

void UpdateActivationLineState (bool activation_line_state);

Called to update current activation line state.

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

تُستخدم الدالة UpdateActivationLineState التابعة للفئة ara::diag::DoIPActivationLine لإرسال الحالة الحالية لخط تنشيط DoIP إلى إدارة التشخيص التكيفية [SWS_DM_00834] (AUTOSAR_AP_SWS_Diagnostics §8.32.1.1.3.5). ويتم توفير التصريح عبر ملف الترويسة ara/diag/doip_activationline.h.

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

  • المعلمات: تُشير معلمة التمرير المنطقية activation_line_state للنظام إلى ما إذا كان خط التنشيط نشطاً (TRUE) أم غير نشط (FALSE) [SWS_DM_00834].
  • قيمة الإرجاع: ليس للعملية قيمة إرجاع (void) وتعمل بشكل متزامن.

التزامن والقيود:

  • أمان الخيوط: تم تحديد الدالة صراحةً بأنها not thread-safe [SWS_DM_00834]. التفسير: يجب مزامنة الاستدعاءات على نفس النسخة من DoIPActivationLine من قِبل التطبيق المستدعي لتجنب تضارب البيانات. سؤال Q-d1c43b8ffc4bdcff (مفتوح)
  • معالجة الأخطاء: تم التصريح عن الدالة بأنها not exception safe [SWS_DM_00834]. ولم يتم تحديد رموز خطأ أو استثناءات معينة؛ ويُرجح ألا يتمكن التطبيق المستدعي في الحالة العامة من التقاط أي استثناءات. سؤال Q-394304b9d771cf69 (مفتوح)

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

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

Header-Datei#include "ara/diag/doip_activationline.h"
Scopeclass ara::diag::DoIPActivationLine
Exception-Sicherheitnot exception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
activation_line_stateTRUE in case the activation line is active, else FALSE

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_DM_00834
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00834@rel:R25-11#ba2744d8
Content hash
ba2744d8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00834
Status: valid/unmigrated Version: rel:R25-11#72b4970c 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_00834@rel:R25-11#72b4970c
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#adb4aebc2026-09-30
  • R19-11rel:R19-11#8dc119ec2026-10-14
  • R20-11rel:R20-11#2253aea22026-10-14
  • R21-11rel:R21-11#271c0ee82026-10-14
  • R22-11rel:R22-11#d0fcfa8e2026-10-14
  • R23-11rel:R23-11#500f07a82026-10-14
  • R24-11rel:R24-11#6f6ff0f32026-10-14
  • R25-11rel:R25-11#72b4970c2026-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_01631] Upstream: RS_AP_00147

DoIPActivationLine & operator= (DoIPActivationLine &)=delete;

DoIPActivationLine shall be a single not assignable instance.

Header-Datei#include "ara/diag/doip_activationline.h"
Scopeclass ara::diag::DoIPActivationLine

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

Record
AUTOSAR/AP/record/SWS_DM_01631
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01631@rel:R25-11#ee301c6a
Content hash
ee301c6a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01631
Status: valid/unmigrated Version: rel:R25-11#901f299c 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_01631@rel:R25-11#901f299c
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#02e44c262026-09-30
  • R23-11rel:R23-11#88f27ae82026-10-14
  • R24-11rel:R24-11#901f299c2026-10-14
  • R25-11rel:R25-11#901f299c2026-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_01632] Upstream: RS_AP_00147

DoIPActivationLine & operator= (DoIPActivationLine &&)=delete;

Move assignment operator of DoIPActivationLine.

Header-Datei#include "ara/diag/doip_activationline.h"
Scopeclass ara::diag::DoIPActivationLine

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

Record
AUTOSAR/AP/record/SWS_DM_01632
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01632@rel:R25-11#cbd6391f
Content hash
cbd6391f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01632
Status: valid/unmigrated Version: rel:R25-11#e7735ad6 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_01632@rel:R25-11#e7735ad6
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#f1dff05c2026-09-30
  • R23-11rel:R23-11#46070e9d2026-10-14
  • R24-11rel:R24-11#e7735ad62026-10-14
  • R25-11rel:R25-11#e7735ad62026-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

دالة ~DoIPActivationLine [SWS_DM_00832] Upstream: RS_Diag_04242, RS_AP_00134

virtual ~DoIPActivationLine () noexcept=default;

Destructor of DoIPActivationLine.

Header-Datei#include "ara/diag/doip_activationline.h"
Scopeclass ara::diag::DoIPActivationLine
Exception-Sicherheitexception safe

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

Record
AUTOSAR/AP/record/SWS_DM_00832
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00832@rel:R25-11#44692e8e
Content hash
44692e8e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00832
Status: valid/unmigrated Version: rel:R25-11#e7403097 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_00832@rel:R25-11#e7403097
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#2b5a4fc62026-09-30
  • R19-11rel:R19-11#dcbc6e5f2026-10-14
  • R20-11rel:R20-11#46022f492026-10-14
  • R21-11rel:R21-11#46022f492026-10-14
  • R22-11rel:R22-11#ba7198cc2026-10-14
  • R23-11rel:R23-11#2458401d2026-10-14
  • R24-11rel:R24-11#d06b38812026-10-14
  • R25-11rel:R25-11#e74030972026-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