Figure 7.2: Example Sequence Diagram for Activation Line and Vehicle Announcement API use case

1. Diagrammtyp & Architektur-Kontext

• Klassifikation: UML-Sequenzdiagramm (Interaktionsdiagramm mit kombiniertem Fragment alt und Objektlebenslinien).
• Technischer Zweck: Spezifikation des Zusammenspiels zwischen Adaptive Applications (AA) und dem Diagnostic Management (DM) der AUTOSAR Adaptive Platform (AP) gemäß ISO 13400-2 (DoIP). Es visualisiert den Lebenszyklus und die Ereigniskette für:
  1. Die Initialisierung und Registrierung von DoIP-Aktivierungsleitungen (DoIPActivationLine).
  2. Die Aktualisierung des Leitungszustands (UpdateActivationLineState).
  3. Die bedingte Auslösung von Fahrzeug-Ankündigungsnachrichten (Vehicle Announcement Messages) über das API DoIPTriggerVehicleAnnouncement in Abhängigkeit vom Manifest-Parameter isActivationLineDependent.

2. Komponenten, Entitäten & Schnittstellen

• Akteure & Lebenslinien:
  • AA (one or two): Gruppierungsrahmen für ein oder zwei Adaptive Applications, welche die physische Erfassung der DoIP-Aktivierungsleitung (z. B. via GPIO, Wake-up-Pin oder Transceiver) kapseln.
  • DoIPActivationLine_instance0 / DoIPActivationLine_instance1: Instanzen der C++-Schnittstelle ara::diag::DoIPActivationLine zur Abbildung separater physikalischer/logischer Netzwerk-Schnittstellen.
  • DM: Dämon/Funktionscluster Diagnostic Management (ara::diag), zuständig für DoIP-Session-Handling, Interface-Verwaltung und Routing.
  • DoIPTriggerVehicleAnnouncement: Instanz der C++-Klasse ara::diag::DoIPTriggerVehicleAnnouncement, über die Applikationen Ankündigungsnachrichten per Software anfordern können.
  • Ethernet_bus: Repräsentation des physikalischen Transportmediums (DoIP via UDP Port 13400 Multicast/Broadcast).
• Beziehungen & Datenstrukturen:
  • Kardinalität: 1 : n zwischen DM und DoIPActivationLine-Instanzen (im Diagramm exemplarisch für networkInterfaceId = 0 und networkInterfaceId = 1).
  • Konfigurationsobjekt: DoIpNetworkConfiguration mit den Attributen:
    • networkInterfaceId: Eindeutige Kennung der Netzwerkschnittstelle.
    • isActivationLineDependent: Boolesches Flag, das definiert, ob DoIP auf diesem Interface an das physische Aktivierungssignal gebunden ist.

3. Dynamisches Verhalten & Sequenzablauf

1. Initialisierung & Service-Registrierung:
   • Beide Instanzen (instance0, instance1) initialisieren sich autonom mit dem Standardzustand inaktiv (init with state false).
   • DM instanziiert die API-Klasse DoIPTriggerVehicleAnnouncement (create).
   • Die AAs melden die Instanzen beim DM über Offer() an; DM bestätigt jeweils synchron mit Ok.
   • Die AAs fragen über GetNetworkInterfaceId() die zugewiesene Schnittstellen-ID ab; DM antwortet mit den konfigurierten Werten (networkInterfaceId=0 bzw. networkInterfaceId=1).
2. Signalüberwachung & Zustandsänderung:
   • Ein externes Startereignis tritt auf: activation line state changed (z. B. Kl. 15 / Ignition Ein oder Pin-Flanke).
   • DoIPActivationLine_instance0 meldet die Pegeländerung an den DM via UpdateActivationLineState( true ).
   • DM startet die interne Überwachung (monitors active DoIP lines).
3. Verzweigung bei manueller Ankündigungsanforderung (alt-Fragment):
   • Pfad A (isActivationLineDependent == 'FALSE'):
     • DoIPTriggerVehicleAnnouncement ruft TriggerVehicleAnnouncement( networkInterfaceId = x ) am DM auf.
     • Da keine Leitungsabhängigkeit besteht, setzt DM die Anforderung direkt um und sendet die DoIP-Broadcast-/Multicast-Nachrichten DoIP_TriggerVehicleAnnouncement auf den Ethernet_bus.
   • Pfad B (isActivationLineDependent == 'TRUE'):
     • DoIPTriggerVehicleAnnouncement ruft TriggerVehicleAnnouncement( networkInterfaceId = x ) am DM auf.
     • Da das Interface als abhängig konfiguriert ist, darf die Ankündigung ausschließlich durch den Pegelwechsel der Hardwareleitung gesteuert werden (ISO 13400-2). DM verweigert die Ausführung und meldet einen synchronen Fehler (error) an den Aufrufer zurück.

4. Normative Relevanz & Entwickler-Hinweise

• Zuordnung zu AUTOSAR-Anforderungen:
  • RS_Diag_00140: Unterstützung der DoIP Activation Line zur Steuerung der DoIP-Kommunikationsbereitschaft.
  • RS_Diag_04166 / SWS_DM_01981: Bereitstellung des API ara::diag::DoIPTriggerVehicleAnnouncement.
  • SWS_DM_01979: Pflicht zur Aussendung der Vehicle Announcement Messages, wenn isActivationLineDependent == false.
  • SWS_DM_01980: Zwingende Ablehnung des API-Aufrufs mit Fehler (ara::core::Result im Fehlerzustand), wenn isActivationLineDependent == true.
• Entwickler-Richtlinien (Stack & Applikation):
  • API-Nutzung: Applikationsentwickler dürfen TriggerVehicleAnnouncement() niemals blind für alle Interfaces aufrufen. Vorab muss die Konfiguration geprüft werden, da für leitungsabhängige Interfaces deterministisch ein Fehler zurückgegeben wird.
  • Initialisierungsreihenfolge: Vor dem Absetzen von UpdateActivationLineState() muss Offer() erfolgreich quittiert worden sein. Der Initialzustand muss zwingend false betragen, um unkontrollierte DoIP-Broadcast-Bursts beim ECU-Boot zu verhindern.
  • Manifest-Design: Im ARXML/JSON-Execution- und Service-Instance-Manifest müssen networkInterfaceId und isActivationLineDependent konsistent zu den physikalischen Gegebenheiten der Hardware (z. B. OBD-Pin 8 Beschaltung) modelliert werden.