Figure 4: Pwm de-initialization

1. Diagrammtyp & Architektur-Kontext

• Klassifikation: UML-Sequenzdiagramm (Interaktionsdiagramm).
• Technischer Zweck: Spezifikation des synchronen De-Initialisierungsablaufs des AUTOSAR Classic MCAL PWM-Treibers (Pwm_DeInit).
• Architektur-Einordnung: Schnittstelle zwischen höheren Schichten (z. B. BSW Mode Manager BswM, ECU State Manager EcuM oder Complex Device Driver CDD) und dem hardwarenahen Peripherietreiber (Microcontroller Abstraction Layer, MCAL).

2. Komponenten, Entitäten & Schnittstellen

• Akteure / Lebenslinien:
  • Pwm User: Aufrufende Entität aus der BSW- oder Anwendungs-Ebene (typischerweise Zustands-/Modus-Manager zur ECU-Abschaltung oder Peripherie-Rekonfiguration).
  • «module» Pwm: Standardisierter AUTOSAR BSW-Treiberbaustein (MCAL-Modul) mit Stereotyp «module».
• Schnittstelle:
  • Funktionssignatur: void Pwm_DeInit(void)
  • Aufrufart: Synchroner Funktionsaufruf mit Rückkehrpfad (return).

3. Dynamisches Verhalten & Sequenzablauf

1. Trigger: Pwm User triggert die De-Initialisierung durch synchronen Aufruf von Pwm_DeInit().
2. Treiber-Interne Aktionen:
   • Statusprüfung (DET): Sofern PwmDevErrorDetect == STD_ON, Prüfung auf Modulinitialisierung; bei uninitialisiertem Modul wird PWM_E_UNINIT an das Default Error Tracer (DET) gemeldet und die Ausführung abgebrochen.
   • Interrupt-/Notification-Deaktivierung: Abschaltung aller aktiven Edge-/Period-Interrupts und kanalbezogenen Notifications.
   • Ausgangspegel: Überführung aller konfigurierten PWM-Ausgangskanäle in den im Konfigurationsparameter festgelegten Ruhezustand (PwmIdleState, z. B. PWM_LOW oder PWM_HIGH).
   • Zustandsübergang: Der Modulzustand wechselt deterministisch von PWM_INITIALIZED nach PWM_UNINIT.
3. Abschluss: Rückkehr zum Aufrufer (return), womit der synchrone Ablauf blockierungsfrei beendet ist.

4. Normative Relevanz & Entwickler-Hinweise

• Konfigurationsabhängigkeit: Die API ist optional und existiert nur, wenn der Pre-Compile-Parameter PwmDeInitApi == STD_ON gesetzt ist. Fehlt dieser, wird Pwm_DeInit() nicht kompiliert.
• Kanalzustände nach De-Init: Ausgangspins verharren nicht im undefinierten Tri-State oder im letzten Duty-Cycle-Zustand, sondern werden zwingend auf den konfigurierten PwmIdleState gezwungen, um unkontrollierte Aktuatoransteuerungen zu verhindern.
• Reentranz & Nebenläufigkeit: Pwm_DeInit ist Non-Reentrant. Sie darf nicht unterbrochen oder parallel aus mehreren Tasks/Interrupt-Kontexten aufgerufen werden. Vor dem Aufruf müssen alle aktiven Channel-APIs (z. B. Pwm_SetDutyCycle, Pwm_SetPeriodAndDuty) beendet sein.
• Folge-API-Vertrag: Nach erfolgreichem Pwm_DeInit() führen nachfolgende Aufrufe von Betriebs-APIs (außer Pwm_Init() und Pwm_GetVersionInfo()) bei aktivem DET deterministisch zum Fehler PWM_E_UNINIT.