Figure 17: Main Function Activation for Watchdog Triggering

1. Diagrammtyp & Architektur-Kontext

UML-Sequenzdiagramm (sd Main Function Activation Trigger) im Kontext des AUTOSAR Basic Software (BSW) Watchdog Stacks. Das Diagramm spezifiziert die vertikale Trigger-Kaskade vom periodischen Aufruf durch den Scheduler über den Watchdog Manager (WdgM), das Watchdog Interface (WdgIf) und den Watchdog Driver (Wdg) bis hin zur physischen Watchdog-Hardware in Abhängigkeit vom globalen Überwachungsstatus.

2. Komponenten, Entitäten & Schnittstellen

Teilnehmende Instanzen (Lebenslinien):

• Scheduler (OS task or cyclic call): Triggernde Ablaufumgebung bzw. BSW-Scheduler / Betriebssystem-Task.
• :WdgM: Watchdog Manager (BSW-Modul der System Services).
• :WdgIf: Watchdog Interface (BSW-Abstraktionsschicht zur Kapselung hardwareabhängiger Treiberinstanzen).
• :Wdg: Watchdog Driver (MCAL- oder externer Peripherietreiber).
• Watchdog Hardware: Physische Watchdog-Einheit (interner oder externer Watchdog-Baustein).

Schnittstellen und Funktionsaufrufe:

• WdgM_MainFunction_Trigger(): Periodische Hauptfunktion des Watchdog Managers zur Ansteuerung des Triggerns.
• WdgIf_Trigger(DeviceIndex): Schnittstellenaufruf zur Weiterleitung des Trigger-Kommandos an die durch DeviceIndex adressierte Watchdog-Instanz.
• Wdg_Trigger(): Treiberspezifischer Aufruf zur Ausführung des Triggerns.
• Trigger Hardware: Hardwarenahe Aktion / Buszugriff / Toggeln zur physischen Watchdog-Bedienung.

3. Dynamisches Verhalten & Sequenzablauf

Ablaufsequenz:

1. Der Scheduler initiiert den Zyklus durch synchronen Aufruf von WdgM_MainFunction_Trigger() auf der :WdgM-Instanz.
2. Ein bedingter Block (alt Check Global Supervision Status) prüft den globalen Überwachungszustand des WdgM:
   • Zweig [else] (Überwachungsstatus erlaubt Triggern):
     • :WdgM ruft WdgIf_Trigger(DeviceIndex) auf der Instanz :WdgIf auf.
     • :WdgIf leitet den Aufruf über Wdg_Trigger() an den zuständigen Treiber :Wdg weiter.
     • :Wdg führt die Aktion Trigger Hardware direkt auf der Watchdog Hardware aus.
     • Die Rückkehr erfolgt sequenziell über die Return-Pfade von :Wdg zu :WdgIf und von :WdgIf zu :WdgM.
   • Zweig [WDGM_ALIVE_STOPPED] (Überwachung fehlgeschlagen bzw. gestoppt):
     • Es erfolgt kein Trigger-Aufruf; die Weiterleitung an :WdgIf unterbleibt vollständig, sodass der Hardware-Watchdog ausläuft (Timeout/Reset).
3. Nach Abschluss der Fallunterscheidung kehrt WdgM_MainFunction_Trigger() zum Scheduler zurück.

4. Normative Relevanz & Entwickler-Hinweise

Normative Vorgaben und Entwickler-Hinweise:

• Die Entkopplung des Watchdog-Triggerns in eine separate Hauptfunktion (WdgM_MainFunction_Trigger) ermöglicht eine vom Alive-Supervision-Zyklus (WdgM_MainFunction) abweichende, jitterarme und streng deterministische Task-Taktung.
• DeviceIndex stellt die normative Adressierung bei Mehrfach-Watchdog-Konfigurationen über das WdgIf dar.
• Befindet sich der globale Zustand im Fehlerfall WDGM_ALIVE_STOPPED, wird der Service WdgIf_Trigger bewusst unterdrückt, um deterministisch einen Watchdog-Reset herbeizuführen.
• Entwickler müssen sicherstellen, dass die Task-Priorität und Zykluszeit des Triggerns den Hardware-Watchdog-Fenstern (Window-Watchdog bzw. Timeout-Limits) genügen und nicht blockiert werden.