Figure 9.32: Interfaces for time base consumers

1. Diagrammtyp & Architektur-Kontext

UML-Klassendiagramm / Komponentenarchitektur-Diagramm der AUTOSAR Adaptive Platform (Modellierung der API- und Port-Schnittstellen für Time Base Consumers). Dargestellt ist die Anbindung einer Adaptive Application an den daemon-basierten funktionalen Cluster Time Synchronization («aapFunctionalCluster») über definierte Schnittstellenelemente.

2. Komponenten, Entitäten & Schnittstellen

• Komponenten / Entitäten:
  • Adaptive Application: Anwendungskomponente, die Zeitbasisinformationen konsumiert.
  • Time Synchronization («aapFunctionalCluster», Ausprägung: daemon-based): Funktionaler Cluster der Plattform zur Bereitstellung synchronisierter Zeitbasen.
• Schnittstellen & Beziehungen:
  • Time Synchronization::SynchronizedTimeBaseConsumer («aapAPI,aapPortInterface»): Port-Interface, realisiert vom funktionalen Cluster Time Synchronization (Realization/Interface Realization) und von Adaptive Application über einen Required Port angefordert («use», «aapRequiredPort»). Methoden:
    • + GetCurrentTime()
    • + GetRateDeviation()
    • + GetTimeWithStatus(): SynchronizedTimeBaseStatus
    • + RegisterStatusChangeNotifier()
    • + RegisterSynchronizationStateChangeNotifier()
    • + RegisterTimeLeapNotifier()
    • + RegisterTimePrecisionMeasurementNotifier()
    • + RegisterTimeValidationNotification()
    • + UnregisterStatusChangeNotifier()
    • + UnregisterSynchronizationStateChangeNotifier()
    • + UnregisterTimeLeapNotifier()
    • + UnregisterTimePrecisionMeasurementNotifier()
    • + UnregisterTimeValidationNotification()
  • Time Synchronization::SynchronizedTimeBaseStatus («aapAPI,aapNativeInterface»): Native Interface / Status-Datentyp, realisiert vom funktionalen Cluster Time Synchronization und genutzt («use») von Adaptive Application. Methoden:
    • + GetCreationTime()
    • + GetLeapJump()
    • + GetSynchronizationStatus()
    • + GetUserData()

3. Dynamisches Verhalten & Sequenzablauf

• Synchroner Zeitabruf: Die Anwendung fragt Zeitinformationen synchron über GetCurrentTime() oder zusammen mit Statusdaten über GetTimeWithStatus() ab, welches eine Instanz von SynchronizedTimeBaseStatus zurückgibt. Ratenabweichungen werden über GetRateDeviation() abgefragt.
• Asynchrones Notifier-Management: Registrierung und Deregistrierung von Callback- oder Event-Benachrichtigungen über Paare von Register*- und Unregister*-Methoden für Statuswechsel (StatusChangeNotifier), Synchronisationszustände (SynchronizationStateChangeNotifier), Zeitsprünge (TimeLeapNotifier), Präzisionsmessungen (TimePrecisionMeasurementNotifier) und Zeitvalidierung (TimeValidationNotification).
• Statusauswertung: Über das zurückgegebene SynchronizedTimeBaseStatus-Objekt können Erstellungszeitpunkt (GetCreationTime()), Zeitsprung-Deltas (GetLeapJump()), Synchronisationsstatus (GetSynchronizationStatus()) sowie anwenderspezifische Nutzdaten (GetUserData()) ausgelesen werden.

4. Normative Relevanz & Entwickler-Hinweise

• SynchronizedTimeBaseConsumer dient als Port-Interface («aapPortInterface») für standardisierte AUTOSAR Adaptive Interaktion und erfordert einen entsprechenden Port («aapRequiredPort») auf Anwendungsseite.
• SynchronizedTimeBaseStatus ist als native Schnittstelle («aapNativeInterface») deklariert und dient als Rückgabestruktur für detaillierte Status- und Metadaten des aktuellen Zeitwerts.
• Sämtliche Notifier-Registrierungen müssen im Lifecycle der Applikation sauber über die zugehörigen Unregister*-Methoden abgeräumt werden, um Ressourcenlecks oder ungültige Callback-Aufrufe im Daemon zu vermeiden.