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 द्वारा Diagnostic Management पर स्पष्ट रूप से किसी विशिष्ट नेटवर्क इंटरफ़ेस पर ISO 13400-2 के अनुसार DoIP वाहन घोषणाएं भेजने को ट्रिगर करने के लिए किया जाता है। एक्सेस अपने स्वयं के इंस्टेंस निर्माण के माध्यम से नहीं, बल्कि सिस्टम द्वारा प्रदान किए गए ऑब्जेक्ट संदर्भ ([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])।

ISO 13400-2 के अनुसार DoIP संचार में, वाहन घोषणाएं भेजना मुख्य रूप से Diagnostic Management (DM) का एक आंतरिक कार्य है (AUTOSAR_AP_SWS_Diagnostics §“About DiagnosticDoIPTriggerVehicleAnnouncementInterface”)। DM नेटवर्क के प्रारंभ होने पर अन्य IP नियंत्रण इकाइयों और गेटवे को प्रसारण (broadcast) के रूप में तथा बाहरी डायग्नोस्टिक टेस्टर के कनेक्शन का पता चलने पर डिफ़ॉल्ट रूप से ये संदेश भेजता है (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)

संदर्भ आरेख: Diagnostic Manager के माध्यम से DoIP वाहन घोषणाओं को ट्रिगर करने में सहभागिता भागीदार। स्रोत: [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 द्वारा प्रदान किए गए सेवा ऑब्जेक्ट का संदर्भ प्राप्त होता है। व्याख्या: निजी, हटाए गए (deleted) कंस्ट्रक्टरों और ऑब्जेक्ट संदर्भ की वापसी के कारण, वर्ग को आंतरिक रूप से DM द्वारा एक दीर्घकालिक सिंगलटन के रूप में प्रबंधित किया जाना चाहिए। प्रश्न 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])।
DoIP वाहन घोषणाओं को ट्रिगर करने का अनुक्रमAdaptive ApplicationDoIPTriggerVehicleAnnouncementनिदान प्रबंधनDoIP-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#f26bc76e
Content hash
f26bc76e
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#3c49119d
Content hash
3c49119d
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 · जर्मन मूल

इंटरफ़ेस ara::diag::DoIPTriggerVehicleAnnouncement [SWS_DM_00820] का मेथड TriggerVehicleAnnouncement निर्दिष्ट नेटवर्क इंटरफ़ेस पर ISO 13400-2 के अनुसार DoIP वाहन घोषणाएं भेजने के लिए Diagnostic Management (DM) को प्रेरित करने के लिए कार्य करता है [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 विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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#055c58b7
Content hash
055c58b7
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#cdacece4
Content hash
cdacece4
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