Figure 7: Setting Pwm output to idle

1. Diagrammtyp & Architektur-Kontext

• Klassifikation: UML-Sequenzdiagramm (Interaktionsdiagramm).
• Technischer Zweck: Spezifikation des Steuerungsablaufs zum Deaktivieren (Idle-Zustand) und Reaktivieren eines PWM-Kanals im MCAL (Microcontroller Abstraction Layer).
• Architektur-Einordnung: Schnittstelle zwischen oberen Schichten (z. B. I/O Hardware Abstraction IoHwAb, Complex Device Driver CDD oder Applikations-SW-C via RTE) und dem hardwarenahen PWM-Treiber (Pwm).

2. Komponenten, Entitäten & Schnittstellen

• Akteure / Lebenslinien:
  • Pwm User: Aufrufende Instanz oberhalb des MCAL (typischerweise BSW IoHwAb oder CDD).
  • «module» Pwm: AUTOSAR Classic Basic Software Module (MCAL-Treiber zur Ansteuerung hardwarebasierter Timer-/PWM-Einheiten).
• Verwendete Schnittstellen (C-APIs):
  • void Pwm_SetOutputToIdle(Pwm_ChannelType ChannelNumber): Versetzt den spezifizierten Kanal unmittelbar in den konfigurierten Ruhezustand.
  • void Pwm_SetPeriodAndDuty(Pwm_ChannelType ChannelNumber, Pwm_PeriodType Period, uint16 DutyCycle): Synchroner Dienst zur Neukonfiguration von Periodendauer und Tastverhältnis (skaliert von 0x0000 = 0 % bis 0x8000 = 100 %).
• Assoziierte Metadaten / Annotationen:
  • Diagramm-Metadatenbox: Status/Historie (proposed by DB as per SWS Pwm Driver 1.0.9, Zweck: Signal-Deaktivierung).
  • Spezifikationsnotizen zum Ausgangspegel und zur Signal-Reaktivierung.

3. Dynamisches Verhalten & Sequenzablauf

1. Idle-Trigger:
   • Pwm User führt synchronen Aufruf Pwm_SetOutputToIdle(ChannelNumber) aus.
   • Pwm-Treiber stoppt die Signalmodulation des Kanals und legt den Ausgang unmittelbar auf den vorkonfigurierten Pegel (PwmIdleState: PWM_LOW oder PWM_HIGH).
   • Rückkehr des Aufrufs an den Caller (Pwm_SetOutputToIdle()).
2. Kanalzustand im Ruhezustand:
   • Der Hardware-Pin verharrt statisch auf dem Idle-Pegel. Laufende Flankenwechsel und periodische Channel-Notifications (Interrupts) für diesen Kanal sind suspendiert.
3. Reaktivierung:
   • Zur Wiederaufnahme der Signalerzeugung ruft der Pwm User synchron Pwm_SetPeriodAndDuty(...) (oder alternativ Pwm_SetDutyCycle) auf.
   • Der Treiber initialisiert Perioden- und Duty-Register der Hardware neu und startet die Wellenformgenerierung ab der nächsten Periodengrenze mit definierten Parametern.

4. Normative Relevanz & Entwickler-Hinweise

• Präprozessor- & Konfigurationsabhängigkeit:
  • Pwm_SetOutputToIdle ist optional und erfordert PwmSetOutputToIdleSupported == STD_ON im Konfigurations-Containersatz (PwmGeneral).
  • Pwm_SetPeriodAndDuty erfordert PwmSetPeriodAndDutySupported == STD_ON sowie die Kanalklasse PWM_VARIABLE_PERIOD (PwmChannelClass). Für Kanäle mit fixer Periode ist zur Reaktivierung Pwm_SetDutyCycle() zu verwenden.
• Kanal-Ruhepegel (PwmIdleState):
  • Der physikalische Ausgangszustand wird statisch im EcuC-Parameter PwmIdleState (PWM_HIGH / PWM_LOW) definiert und darf nicht mit einem Duty-Cycle von 0 % verwechselt werden (Polaritätsabhängigkeit über PwmPolarity).
• Fehlerbehandlung (DET):
  • Uninitialisierter Aufruf führt zu PWM_E_UNINIT.
  • Ungültiger Kanalparameter führt zu PWM_E_PARAM_CHANNEL.
  • Bei Aufruf von Pwm_SetPeriodAndDuty an Kanälen ungleicher Klasse PWM_VARIABLE_PERIOD wird PWM_E_PERIOD_UNCHANGEABLE gemeldet.