DEENESPTFRRUARHIKOZHNL

فئة ara::diag::DoIPTriggerVehicleAnnouncement

[SWS_DM_00820] Upstream: RS_Diag_04242

class DoIPTriggerVehicleAnnouncement {...};

DiagnosticDoIPTriggerVehicleAnnouncement.

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

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

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

يُستخدم للبدء الموجه لإعلانات مركبة DoIP على واجهة شبكة محددة.

تُستخدم الفئة [SWS_DM_00820] بواسطة Adaptive Applications لبدء إرسال إعلانات مركبة DoIP وفقًا للمعيار ISO 13400-2 على واجهة شبكة معينة صراحةً لدى Diagnostic Management. لا يتم الوصول عبر إنشاء نسخة خاصة، بل بشكل ثابت عبر مرجع كائن يوفره النظام ([SWS_DM_00821]). بالنسبة للواجهات ذات التحكم المعتمد على خط التنشيط، فإن الاستدعاء الصريح غير مسموح به، لأن الإرسال يتم هناك بشكل مؤتمت بالكامل ([SWS_DM_00822]).

السياق

توفر الفئة ara::diag::DoIPTriggerVehicleAnnouncement ([SWS_DM_00820]) في ملف الترويسة ara/diag/doip_trigger_vehicle_announcement.h (AUTOSAR_AP_SWS_Diagnostics §8.36.1 «Class: DoIPTriggerVehicleAnnouncement») واجهة برمجة تطبيقات (API) يمكن من خلالها لـ Adaptive Application بدء الإرسال الموجه لإعلانات مركبة DoIP («Vehicle Announcement Messages») ([SWS_DM_00815]، [SWS_DM_00822]).

في اتصال DoIP وفقًا للمعيار ISO 13400-2، يعد إرسال إعلانات المركبة في المقام الأول مهمة داخلية لـ Diagnostic Management (DM) (AUTOSAR_AP_SWS_Diagnostics §«About DiagnosticDoIPTriggerVehicleAnnouncementInterface»). يرسل DM هذه الرسائل افتراضيًا عند إقلاع الشبكة كبث إلى وحدات التحكم الإلكترونية عبر IP الأخرى والبوابات، وكذلك عند اكتشاف اتصال جهاز فحص تشخيص خارجي (AUTOSAR_AP_SWS_Diagnostics §«About DiagnosticDoIPTriggerVehicleAnnouncementInterface»). ومع ذلك، يُتاح للتطبيقات عبر ara::diag::DoIPTriggerVehicleAnnouncement إمكانية بدء هذا الإرسال صراحةً لواجهة شبكة محددة ([SWS_DM_00815]، [SWS_DM_00820]).

diag_kontext app Adaptive Application api ara::diag::DoIPTriggerVehicleAnnouncement app->api TriggerVehicleAnnouncement() dm Diagnostic Management (DM) api->dm Weiterleitung an DM net DoIP-Netzwerkschnittstelle dm->net Vehicle Announcement (ISO 13400-2)

مخطط السياق: أطراف التفاعل عند إطلاق إعلانات مركبة DoIP عبر Diagnostic Manager. المصادر: [SWS_DM_00815]، [SWS_DM_00820]، AUTOSAR_AP_SWS_Diagnostics §«About DiagnosticDoIPTriggerVehicleAnnouncementInterface».

دورة الحياة

يخضع إنشاء نسخ الفئة DoIPTriggerVehicleAnnouncement وتدميرها لتعليمات صارمة: تم التصريح عن كل من المنشئ الافتراضي ([SWS_DM_02100]) والمُهدم ([SWS_DM_02101]) كـ delete، وهما خاصان ويعتمدان في تجسيدهما الفعلي على الشركة المصنعة. وبالتالي، لا يمكن للتطبيقات إنشاء كائنات من هذه الفئة مباشرة ولا تدميرها.

يتم الوصول إلى الواجهة بشكل ثابت عبر الدالة GetDoIPTriggerVehicleAnnouncement() ([SWS_DM_00821]). تُرجع هذه الدالة ara::core::Result<std::reference_wrapper<DoIPTriggerVehicleAnnouncement>>، وبذلك يحصل المستدعي على مرجع لكائن الخدمة المقدم من DM. تفسير: نظرًا للمنشئات الخاصة المحذوفة وإرجاع مرجع كائن، يُرجح أن الفئة تُدار داخليًا بواسطة DM ككائن أحادي (Singleton) طويل العمر. سؤال Q-cecb961746b3ad13 (مفتوح)

فيما يتعلق بالتزامن، لم يتم تحديد استعلام الواجهة GetDoIPTriggerVehicleAnnouncement() ولا استدعاء الدالة TriggerVehicleAnnouncement() على أنهما آمنان للخيوط («not thread-safe») ([SWS_DM_00821]، [SWS_DM_00822]). وبالتالي، يتطلب الوصول المتزامن من خيوط متعددة مزامنة خارجية. تم تحديد كلا الدالتين على أنهما آمنتان من الاستثناءات («exception safe») ([SWS_DM_00821]، [SWS_DM_00822]).

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

ينقسم المسار النموذجي لطلب إعلان مركبة DoIP إلى الخطوات التالية:

  1. استرداد النسخة: يستدعي التطبيق ara::diag::DoIPTriggerVehicleAnnouncement::GetDoIPTriggerVehicleAnnouncement() بشكل ثابت ([SWS_DM_00821]).
  2. تقييم النتيجة: يتم فحص ara::core::Result الناتج بحثًا عن أخطاء؛ وفي حالة النجاح، يتم فك المرجع.
  3. طلب الإعلان: عبر الدالة TriggerVehicleAnnouncement(networkInterfaceId)، يتم بدء الإرسال على واجهة الشبكة المطلوبة ([SWS_DM_00822]).
  4. إرسال الرسائل بواسطة DM: يعالج DM الطلب ويرسل رسائل إعلان المركبة وفقًا للمعيار ISO 13400-2 على الواجهة المحددة بواسطة networkInterfaceId ([SWS_DM_00815]).
تسلسل إطلاق إعلانات مركبة DoIPAdaptive ApplicationDoIPTriggerVehicleAnnouncementDiagnostic ManagementDoIP-NetzwerkGetDoIPTriggerVehicleAnnouncement()Result<reference_wrapper<DoIPTriggerVehicleAnnouncement>>TriggerVehicleAnnouncement(networkInterfaceId)بدء الإرسالVehicle Announcement Message (ISO 13400-2)Result<void>

مخطط تسلسلي: ترتيب الاستدعاء لإطلاق إعلانات مركبة DoIP. المصادر: [SWS_DM_00815]، [SWS_DM_00821]، [SWS_DM_00822].

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

يتعلق أحد سيناريوهات الخطأ المركزية عند استخدام TriggerVehicleAnnouncement بواجهات الشبكة المعتمدة على خط التنشيط: إذا كانت networkInterfaceId الممررة تنتمي إلى تكوين واجهة (DoIPNetworkConfiguration) تم فيه تعيين الخاصية isActivationLineDependent = TRUE، فإن الاستدعاء يؤدي إلى خطأ ([SWS_DM_00822]). في مثل هذه الواجهات، يتم بالفعل إطلاق إرسال رسائل الإعلان تلقائيًا بواسطة DM بمجرد أن يصبح خط التنشيط نشطًا ويتم تعيين عنوان IP ([SWS_DM_00816]، [SWS_DM_00822]).

لم يتم تحديد رموز خطأ قياسية للدالتين GetDoIPTriggerVehicleAnnouncement() وTriggerVehicleAnnouncement() ([SWS_DM_00821]، [SWS_DM_00822]). تُنقل أي أخطاء في وقت التشغيل أو حالات خطأ خاصة بالشركة المصنعة في ara::core::Result المُرجع ويجب فحصها من قِبل التطبيق المستدعي.

تم إنشاء دليل الفئة هذا بناءً على مواصفة AUTOSAR Adaptive R25-11.

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

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

2
DoIPTriggerVehicleAnnouncement~DoIPTriggerVehicleAnnouncement

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

2
GetDoIPTriggerVehicleAnnouncementTriggerVehicleAnnouncement

مخطط الفئة

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

G nara__diag__DoIPTriggerVehicleAnnouncement193 DoIPTriggerVehicleAnnouncement + GetDoIPTriggerVehicleAnnouncement() + TriggerVehicleAnnouncement() + DoIPTriggerVehicleAnnouncement() + ~DoIPTriggerVehicleAnnouncement()

عرض التفاصيل

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

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

DoIPTriggerVehicleAnnouncement دالة

Ctor is vendor-specific.

DoIPTriggerVehicleAnnouncement ()=delete;
~DoIPTriggerVehicleAnnouncement دالة

Dtor is vendor-specific.

~DoIPTriggerVehicleAnnouncement () noexcept=delete;

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

GetDoIPTriggerVehicleAnnouncement دالة

Get DoIPTriggerVehicleAnnouncement interface from DM.

static ara::core::Result< std::reference_wrapper< DoIPTriggerVehicle Announcement > > GetDoIPTriggerVehicleAnnouncement () noexcept;
TriggerVehicleAnnouncement دالة

Called by application to trigger DM sending out vehicle announcements on the given network interface Id.

virtual ara::core::Result< void > TriggerVehicleAnnouncement (std::uint8_t networkInterfaceId) noexcept=0;

توثيق الدوال

دالة DoIPTriggerVehicleAnnouncement [SWS_DM_02100] Upstream: RS_Diag_04242

DoIPTriggerVehicleAnnouncement ()=delete;

Ctor is vendor-specific.

Header-Datei#include "ara/diag/doip_trigger_vehicle_announcement.h"
Scopeclass ara::diag::DoIPTriggerVehicleAnnouncement
Sichtbarkeitprivate

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

Record
AUTOSAR/AP/record/SWS_DM_02100
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02100@rel:R25-11#4c6bf8af
Content hash
4c6bf8af
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02100
Status: valid/unmigrated Version: rel:R25-11#1d989e18 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_02100@rel:R25-11#1d989e18
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#2f98fe402026-09-30
  • R24-11rel:R24-11#1d989e182026-10-14
  • R25-11rel:R25-11#1d989e182026-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

دالة GetDoIPTriggerVehicleAnnouncement [SWS_DM_00821] Upstream: RS_Diag_04242

static ara::core::Result< std::reference_wrapper< DoIPTriggerVehicle Announcement > > GetDoIPTriggerVehicleAnnouncement () noexcept;

Get DoIPTriggerVehicleAnnouncement interface from DM.

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

Rückgabewert

TypBeschreibung
ara::core::Result<std::reference_wrapper<DoIPTriggerVehicleAnnouncement > >DoIPTriggerVehicleAnnouncement object

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_00821
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00821@rel:R25-11#427ce5e8
Content hash
427ce5e8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00821
Status: valid/unmigrated Version: rel:R25-11#e62d6a96 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_00821@rel:R25-11#e62d6a96
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#6119e35a2026-09-30
  • R19-11rel:R19-11#e173afea2026-10-14
  • R20-11rel:R20-11#41c521af2026-10-14
  • R21-11rel:R21-11#41c521af2026-10-14
  • R22-11rel:R22-11#db12de522026-10-14
  • R23-11rel:R23-11#df1fdca12026-10-14
  • R24-11rel:R24-11#bfe464be2026-10-14
  • R25-11rel:R25-11#e62d6a962026-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

دالة TriggerVehicleAnnouncement [SWS_DM_00822] Upstream: RS_Diag_04242

virtual ara::core::Result< void > TriggerVehicleAnnouncement (std::uint8_t networkInterfaceId) noexcept=0;

Called by application to trigger DM sending out vehicle announcements on the given network interface Id.

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

تُستخدم الدالة TriggerVehicleAnnouncement التابعة للواجهة ara::diag::DoIPTriggerVehicleAnnouncement [SWS_DM_00820] لجعل Diagnostic Management (DM) يرسل إعلانات مركبة DoIP وفقاً للمواصفة ISO 13400-2 على واجهة شبكة محددة [SWS_DM_00815]، [SWS_DM_00822].

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

تستقبل الدالة المعلمة networkInterfaceId (std::uint8_t)، التي تحدد واجهة الشبكة الهدف، وتُرجع ara::core::Result<void> [SWS_DM_00822]. وقد تم التصريح عنها كـ noexcept ولا تطلق أي استثناءات [SWS_DM_00822].

معالجة الأخطاء والشروط الحدية

لم يتم تحديد رموز خطأ معيارية لهذه الدالة [SWS_DM_00822]. وتحدث حالة خطأ إذا كانت networkInterfaceId المُمرَّرة تنتمي إلى تكوين شبكة يمتلك الخاصية isActivationLineDependent = TRUE [SWS_DM_00822]. ففي مثل هذه الواجهات، يتم بالفعل بدء الإرسال تلقائياً بعد تفعيل خط التنشيط أو تعيين عنوان IP [SWS_DM_00816]، [SWS_DM_00822]. التفسير: نظراً لعدم وجود رموز خطأ قياسية، فيُرجح أن تتم الإشارة إلى الخطأ عبر رمز خطأ خاص بالجهة المصنعة في الكائن Result. سؤال Q-ee2ea52f0b3064ce (مفتوح)

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

تم تحديد العملية بأنها غير آمنة بالنسبة للخيوط (not thread-safe) [SWS_DM_00822]. بالإضافة إلى ذلك، تشير المواصفة إلى أن الإعلان يمثل بالدرجة الأولى وظيفة داخلية لـ DM، وأن الإطلاق الصريح له بواسطة Adaptive Application ليس مخصصاً من الناحية المفاهيمية في الأصل AUTOSAR_AP_SWS_Diagnostics §7.x «About DiagnosticDoIPTriggerVehicleAnnouncementInterface».

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

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

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

Parameter (in)

ParameterBeschreibung
networkInterfaceIdnetwork interface id on which a vehicle announcement shall be sent.

Rückgabewert

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

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.
Hinweise: If the reported DoIPNetworkConfiguration.networkInterfaceId belongs to a DoIPNetwork Configuration with property isActivationLineDependent = TRUE, this is an error as on those interfaces sending of announcements happens automatically after activation line going up/IP address assignment.

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

Record
AUTOSAR/AP/record/SWS_DM_00822
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00822@rel:R25-11#0e351c6f
Content hash
0e351c6f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00822
Status: valid/unmigrated Version: rel:R25-11#a555ed27 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_00822@rel:R25-11#a555ed27
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#b92e3a472026-09-30
  • R19-11rel:R19-11#fc8292e52026-10-14
  • R20-11rel:R20-11#f9a672462026-10-14
  • R21-11rel:R21-11#c73179122026-10-14
  • R22-11rel:R22-11#5dc1998b2026-10-14
  • R23-11rel:R23-11#fee398c12026-10-14
  • R24-11rel:R24-11#bed5c8df2026-10-14
  • R25-11rel:R25-11#a555ed272026-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

دالة ~DoIPTriggerVehicleAnnouncement [SWS_DM_02101] Upstream: RS_Diag_04242

~DoIPTriggerVehicleAnnouncement () noexcept=delete;

Dtor is vendor-specific.

Header-Datei#include "ara/diag/doip_trigger_vehicle_announcement.h"
Scopeclass ara::diag::DoIPTriggerVehicleAnnouncement
Sichtbarkeitprivate

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

Record
AUTOSAR/AP/record/SWS_DM_02101
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02101@rel:R25-11#d84c36d6
Content hash
d84c36d6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02101
Status: valid/unmigrated Version: rel:R25-11#23915694 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_02101@rel:R25-11#23915694
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#a098acdb2026-09-30
  • R24-11rel:R24-11#239156942026-10-14
  • R25-11rel:R25-11#239156942026-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