Figure 8: Getting Pwm output state

1. Diagrammtyp & Architektur-Kontext

• Klassifikation: UML-Sequenzdiagramm (Interaktionsdiagramm mit Modul-Stereotyp und Spezifikations-Notiz).
• Technischer Zweck: Spezifikation der synchronen Abfrage des aktuellen logischen Signalzustands eines PWM-Ausgangskanals.
• Architektur-Einordnung: AUTOSAR Classic Platform, Microcontroller Abstraction Layer (MCAL). Schnittstelle zwischen dem MCAL-Treiber Pwm und übergeordneten BSW-Modulen (insbesondere IoHwAb, Complex Device Drivers CDD) bzw. SWCs über das RTE/IoHwAb-Mapping.

2. Komponenten, Entitäten & Schnittstellen

• Akteure & Lifelines:
  • Pwm User: Aufrufende Entität / Client-Modul (z. B. I/O Hardware Abstraction).
  • «module» Pwm: Zielinstanz; hardwarenahes BSW-Modul (MCAL PWM Driver).
• Schnittstellen & Signaturen:
  • Synchroner Aufruf: Pwm_GetOutputState(...) (im Entwurfsdiagramm als Pwm_GetOutputState(Pwm_OutputStateType, Pwm_ChannelType) : Pwm_OutputStateType modelliert; C-Schnittstelle gemäß normativer SWS: Pwm_OutputStateType Pwm_GetOutputState(Pwm_ChannelType ChannelNumber)).
  • Rückgabewert (Return Edge): Typ Pwm_OutputStateType mit den normativen Enumerationswerten PWM_HIGH oder PWM_LOW.
• Metadaten (UML-Note): Historische Spezifikationsnotiz (Status: proposed by DB as per SWS Pwm Driver 1.0.9), dokumentiert den Lesevorgang des PWM-Kanalpegels.

3. Dynamisches Verhalten & Sequenzablauf

1. Trigger: Pwm User initiiert einen synchronen Funktionsaufruf an Pwm_GetOutputState.
2. Treiber-Verarbeitung:
   • Modul Pwm aktiviert seinen Execution Context (Execution Specification Balken).
   • Direktes Lesen des aktuellen Pegels des zugeordneten Timer-/Hardware-Ausgangspins bzw. des entsprechenden Port-/Output-Registers.
3. Rückmeldung: Unmittelbare, synchrone Rückkehr zum Aufrufer mit dem diskreten Zustand PWM_HIGH bzw. PWM_LOW.
4. Fehler- und Abbruchpfade (gemäß SWS-Regelwerk):
   • Bei uninitialisiertem Treiber (PWM_E_UNINIT) oder unzulässigem Parameter ChannelNumber (PWM_E_PARAM_CHANNEL) erfolgt bei aktivem Development Error Tracer ein synchroner Aufruf an Det_ReportError; die Funktion terminiert mit Default-Rückgabewert (PWM_LOW).

4. Normative Relevanz & Entwickler-Hinweise

• Präprozessor-Konfiguration: Die API ist optional. Sie wird über den Schalter PwmGetOutputStateApi (STD_ON / STD_OFF) einkompiliert ([SWS_Pwm_00085]). Bei STD_OFF existiert kein Symbol im Linker-Scope.
• Reentranz: Die Funktion ist reentrant für unterschiedliche ChannelNumber-Instanzen. Parallele Aufrufe auf denselben Kanal sind nicht reentrant.
• Semantik des Rückgabewerts: Pwm_GetOutputState liefert den instantanen logischen Pegel (High/Low) zum Zeitpunkt des Register-Lesezugriffs unter Berücksichtigung der konfigurierten Kanalpolarität (PwmPolarity), nicht den Duty-Cycle-Zustand oder Tastgrad-Mittelwert.