Dient dem gezielten Anstoßen von DoIP-Fahrzeugankündigungen auf einer angegebenen Netzwerkschnittstelle.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: f854d0aec1c7HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Dient dem gezielten Anstoßen von DoIP-Fahrzeugankündigungen auf einer angegebenen Netzwerkschnittstelle.
Die Klasse [SWS_DM_00820] dient Adaptive Applications dazu, das Versenden von DoIP-Fahrzeugankündigungen gemäß ISO 13400-2 auf einer bestimmten Netzwerkschnittstelle explizit beim Diagnostic Management anzustoßen. Der Zugriff erfolgt nicht über eigene Instanziierung, sondern statisch über eine vom System bereitgestellte Objektreferenz ([SWS_DM_00821]). Für Schnittstellen mit aktivierungsleitungsabhängiger Steuerung ist der explizite Aufruf unzulässig, da der Versand dort vollautomatisch erfolgt ([SWS_DM_00822]).
Die Erzeugung und Zerstörung von Instanzen der Klasse DoIPTriggerVehicleAnnouncement unterliegt strikten Vorgaben: Sowohl der Standardkonstruktor ([SWS_DM_02100]) als auch der Destruktor ([SWS_DM_02101]) sind als delete deklariert, privat und in ihrer konkreten Ausprägung herstellerspezifisch. Anwendungen können Objekte dieser Klasse somit weder direkt instanziieren noch zerstören.
Der Zugriff auf die Schnittstelle erfolgt statisch über die Funktion GetDoIPTriggerVehicleAnnouncement() ([SWS_DM_00821]). Diese gibt ein ara::core::Result<std::reference_wrapper<DoIPTriggerVehicleAnnouncement>> zurück, wodurch der Aufrufer eine Referenz auf das vom DM bereitgestellte Dienstobjekt erhält. Interpretation: Wegen der privaten, gelöschten Konstruktoren und der Rückgabe einer Objektreferenz dürfte die Klasse intern vom DM als langlebiges Singleton verwaltet werden. Frage Q-cecb961746b3ad13 (offen)
Hinsichtlich der Nebenläufigkeit sind weder die Schnittstellenabfrage GetDoIPTriggerVehicleAnnouncement() noch der Methodenaufruf TriggerVehicleAnnouncement() thread-sicher spezifiziert („not thread-safe“) ([SWS_DM_00821], [SWS_DM_00822]). Ein gleichzeitiger Zugriff aus mehreren Threads erfordert daher eine externe Synchronisation. Beide Methoden sind als ausnahmesicher („exception safe“) spezifiziert ([SWS_DM_00821], [SWS_DM_00822]).
Nutzungspfad
Der typische Ablauf zur Anforderung einer DoIP-Fahrzeugankündigung gliedert sich in folgende Schritte:
Instanz abrufen: Die Anwendung ruft statisch ara::diag::DoIPTriggerVehicleAnnouncement::GetDoIPTriggerVehicleAnnouncement() auf ([SWS_DM_00821]).
Ergebnis auswerten: Das resultierende ara::core::Result wird auf Fehler geprüft; bei Erfolg wird die Referenz entpackt.
Ankündigung anfordern: Über die Methode TriggerVehicleAnnouncement(networkInterfaceId) wird der Versand auf der gewünschten Netzwerkschnittstelle angestoßen ([SWS_DM_00822]).
Nachrichtenversand durch DM: Der DM verarbeitet die Anfrage und sendet Fahrzeugankündigungsnachrichten gemäß ISO 13400-2 auf der durch networkInterfaceId identifizierten Schnittstelle ([SWS_DM_00815]).
Ein zentrales Fehlerszenario bei der Nutzung von TriggerVehicleAnnouncement betrifft aktivierungsleitungsabhängige Netzwerkschnittstellen: Gehört die übergebene networkInterfaceId zu einer Schnittstellenkonfiguration (DoIPNetworkConfiguration), bei der die Eigenschaft isActivationLineDependent = TRUE gesetzt ist, führt der Aufruf zu einem Fehler ([SWS_DM_00822]). Auf solchen Schnittstellen wird der Versand von Ankündigungsnachrichten bereits automatisch durch den DM ausgelöst, sobald die Aktivierungsleitung aktiv ist und eine IP-Adresse zugewiesen wurde ([SWS_DM_00816], [SWS_DM_00822]).
Für die Funktionen GetDoIPTriggerVehicleAnnouncement() und TriggerVehicleAnnouncement() sind keine standardisierten Fehlercodes spezifiziert ([SWS_DM_00821], [SWS_DM_00822]). Etwaige Laufzeitfehler oder herstellerspezifische Fehlerzustände werden im zurückgegebenen ara::core::Result transportiert und müssen von der aufrufenden Anwendung geprüft werden.
Dieser Klassen-Leitfaden wurde auf Basis der AUTOSAR-Adaptive-Spezifikation R25-11 generiert.
Called by application to trigger DM sending out vehicle announcements on the given network interface Id.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: fd0a2f72ec5aHerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Die Methode TriggerVehicleAnnouncement der Schnittstelle ara::diag::DoIPTriggerVehicleAnnouncement[SWS_DM_00820] dient dazu, das Diagnostic Management (DM) zum Versenden von DoIP-Fahrzeugankündigungen gemäß ISO 13400-2 auf einer angegebenen Netzwerkschnittstelle zu veranlassen [SWS_DM_00815], [SWS_DM_00822].
Verwendung und Semantik
Die Funktion nimmt den Parameter networkInterfaceId (std::uint8_t) entgegen, welcher die Ziel-Netzwerkschnittstelle identifiziert, und liefert ein ara::core::Result<void> zurück [SWS_DM_00822]. Sie ist als noexcept deklariert und wirft keine Ausnahmen [SWS_DM_00822].
Fehlerbehandlung und Randbedingungen
Standardisierte Fehlercodes sind für diese Methode nicht definiert [SWS_DM_00822]. Ein Fehlerfall liegt vor, wenn die übergebene networkInterfaceId zu einer Netzwerkkonfiguration mit der Eigenschaft isActivationLineDependent = TRUE gehört [SWS_DM_00822]. Auf solchen Schnittstellen wird die Aussendung bereits automatisch nach Aktivierung der Aktivierungsleitung oder IP-Adressvergabe initiiert [SWS_DM_00816], [SWS_DM_00822]. Interpretation: Da keine standardisierten Fehlercodes existieren, dürfte der Fehler über einen herstellerspezifischen Fehlercode im Result-Objekt signalisiert werden. Frage Q-ee2ea52f0b3064ce (offen)
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-medium· 2026-10-13