Dient voor het gericht initiëren van DoIP-voertuigaankondigingen op een opgegeven netwerkinterface.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: f854d0aec1c7HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
Dient voor het gericht initiëren van DoIP-voertuigaankondigingen op een opgegeven netwerkinterface.
De klasse [SWS_DM_00820] dient ertoe dat Adaptive Applications het verzenden van DoIP-voertuigaankondigingen conform ISO 13400-2 op een specifieke netwerkinterface expliciet initiëren bij het Diagnostic Management. De toegang verloopt niet via een eigen instantiëring, maar statisch via een door het systeem beschikbaar gestelde objectreferentie ([SWS_DM_00821]). Voor interfaces met aansturing afhankelijk van een activeringslijn is de expliciete aanroep niet toegestaan, omdat de verzending daar volautomatisch plaatsvindt ([SWS_DM_00822]).
Het aanmaken en vernietigen van instanties van de klasse DoIPTriggerVehicleAnnouncement is onderworpen aan strikte voorschriften: zowel de standaardconstructor ([SWS_DM_02100]) als de destructor ([SWS_DM_02101]) zijn gedeclareerd als delete, privaat en in hun concrete vorm fabrikantspecifiek. Applicaties kunnen objecten van deze klasse zodoende noch direct instantiëren noch vernietigen.
De toegang tot de interface verloopt statisch via de functie GetDoIPTriggerVehicleAnnouncement() ([SWS_DM_00821]). Deze retourneert een ara::core::Result<std::reference_wrapper<DoIPTriggerVehicleAnnouncement>>, waardoor de aanroeper een referentie verkrijgt naar het door de DM beschikbaar gestelde service-object. Interpretatie: vanwege de private, verwijderde constructors en het retourneren van een objectreferentie wordt de klasse intern door de DM vermoedelijk als een langlevende singleton beheerd. Vraag Q-cecb961746b3ad13 (open)
Wat betreft gelijktijdigheid zijn noch de interface-query GetDoIPTriggerVehicleAnnouncement() noch de methode-aanroep TriggerVehicleAnnouncement() gespecificeerd als thread-safe („not thread-safe”) ([SWS_DM_00821], [SWS_DM_00822]). Een gelijktijdige toegang vanuit meerdere threads vereist daarom externe synchronisatie. Beide methoden zijn gespecificeerd als uitzonderingsveilig („exception safe”) ([SWS_DM_00821], [SWS_DM_00822]).
Gebruikspad
Het typische verloop voor het aanvragen van een DoIP-voertuigaankondiging bestaat uit de volgende stappen:
Instantie ophalen: de applicatie roept statisch ara::diag::DoIPTriggerVehicleAnnouncement::GetDoIPTriggerVehicleAnnouncement() aan ([SWS_DM_00821]).
Resultaat evalueren: het resulterende ara::core::Result wordt gecontroleerd op fouten; bij succes wordt de referentie uitgepakt.
Aankondiging aanvragen: via de methode TriggerVehicleAnnouncement(networkInterfaceId) wordt de verzending op de gewenste netwerkinterface geïnitieerd ([SWS_DM_00822]).
Berichtverzending door DM: de DM verwerkt het verzoek en verzendt voertuigaankondigingsberichten conform ISO 13400-2 op de door networkInterfaceId geïdentificeerde interface ([SWS_DM_00815]).
Een cruciaal foutscenario bij het gebruik van TriggerVehicleAnnouncement betreft netwerkinterfaces die afhankelijk zijn van een activeringslijn: hoort de meegegeven networkInterfaceId bij een interfaceconfiguratie (DoIPNetworkConfiguration) waarbij de eigenschap isActivationLineDependent = TRUE is ingesteld, dan leidt de aanroep tot een fout ([SWS_DM_00822]). Op dergelijke interfaces wordt de verzending van aankondigingsberichten reeds automatisch getriggerd door de DM zodra de activeringslijn actief is en er een IP-adres is toegewezen ([SWS_DM_00816], [SWS_DM_00822]).
Voor de functies GetDoIPTriggerVehicleAnnouncement() en TriggerVehicleAnnouncement() zijn geen gestandaardiseerde foutcodes gespecificeerd ([SWS_DM_00821], [SWS_DM_00822]). Eventuele runtime-fouten of fabrikantspecifieke fouttoestanden worden getransporteerd in de geretourneerde ara::core::Result en moeten door de aanroepende applicatie worden gecontroleerd.
Deze klassenhandleiding is gegenereerd op basis van de AUTOSAR Adaptive-specificatie R25-11.
Called by application to trigger DM sending out vehicle announcements on the given network interface Id.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: fd0a2f72ec5aHerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
De methode TriggerVehicleAnnouncement van de interface ara::diag::DoIPTriggerVehicleAnnouncement[SWS_DM_00820] dient ertoe om het Diagnostic Management (DM) aan te zetten tot het verzenden van DoIP-voertuigaankondigingen conform ISO 13400-2 op een opgegeven netwerkinterface [SWS_DM_00815], [SWS_DM_00822].
Gebruik en semantiek
De functie accepteert de parameter networkInterfaceId (std::uint8_t), die de doelnetwerkinterface identificeert, en levert een ara::core::Result<void> terug [SWS_DM_00822]. Ze is gedeclareerd als noexcept en werpt geen excepties [SWS_DM_00822].
Foutafhandeling en randvoorwaarden
Gestandaardiseerde foutcodes zijn voor deze methode niet gedefinieerd [SWS_DM_00822]. Er is sprake van een fout wanneer de meegegeven networkInterfaceId behoort tot een netwerkconfiguratie met de eigenschap isActivationLineDependent = TRUE[SWS_DM_00822]. Op dergelijke interfaces wordt de uitzending al automatisch geïnitieerd na activering van de activeringslijn of toewijzing van het IP-adres [SWS_DM_00816], [SWS_DM_00822]. Interpretatie: Aangezien er geen gestandaardiseerde foutcodes bestaan, wordt de fout vermoedelijk gesignaleerd via een fabrikantspecifieke foutcode in het Result-object. Vraag Q-ee2ea52f0b3064ce (open)
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.
gemini-3.8-flash-low· 2026-10-13 · Duits origineel