class ara::tsync::ProviderTimeBaseValidationNotification

Die abstrakte Klasse ara::tsync::ProviderTimeBaseValidationNotification dient als Callback-Schnittstelle zur Bereitstellung aufgezeichneter Zeitbasis-Messdaten an eine Validator-Anwendung. Implementierungen empfangen über SetMasterTimingData Messblöcke des Time Masters [SWS_TS_00421] sowie über SetPdelayResponderData Messdaten des Pdelay Responders [SWS_TS_00423]. Die Methoden sind als noexcept spezifiziert, jedoch nicht threadsicher, weshalb nebenläufige Aufrufe an derselben Instanz vermieden werden müssen.

mehr ›

Kontext

Die Klasse ara::tsync::ProviderTimeBaseValidationNotification fungiert als abstrakte Callback-Schnittstelle für die Validierung von Zeitbasen innerhalb des Synchronisationsmoduls. Über diese Schnittstelle wird eine empfangende Validator-Anwendung darüber benachrichtigt, sobald für eine überwachte Zeitbasis neue aufgezeichnete Messdatenblöcke vorliegen. Die Schnittstelle definiert Übergabepunkte für spezifische Messdaten des Zeitgebers (Time Master) gemäß [SWS_TS_00421] sowie für Messdaten des Verzögerungs-Antwortmechanismus (Pdelay Responder) gemäß [SWS_TS_00423]. Interaktionspartner sind hierbei typischerweise der interne Provider-Mechanismus des Zeit-Synchronisations-Stacks als Datenquelle sowie eine anwendungsseitige Validierungsinstanz, die die erfassten Zeitdaten auswertet.

Lebenszyklus und Nebenläufigkeit

Als abstrakte Schnittstelle wird ara::tsync::ProviderTimeBaseValidationNotification von der konkreten Validierungsanwendung abgeleitet und implementiert. Die Lebensdauer der instanziierten Implementierung unterliegt der Verantwortung der Anwendung. Die Klasse besitzt einen virtuellen Standard-Destruktor, der als ausnahmesicher (noexcept) deklariert ist [SWS_TS_01301]. Dadurch wird gewährleistet, dass abgeleitete Klasseninstanzen beim Abbau polymorph und ressourcensicher zerstört werden können. Hinsichtlich der Nebenläufigkeit sind die Benachrichtigungsmethoden explizit als nicht threadsicher (non_threadsafe) eingestuft [SWS_TS_00421], [SWS_TS_00423]. Dies bedeutet, dass Aufrufe von SetMasterTimingData und SetPdelayResponderData für dieselbe Instanz nicht ungeschützt aus konkurrierenden Threads erfolgen dürfen; der aufrufende Zeitbasis-Provider dürfte diese Aufrufe sequenziell absetzen oder die Anwendung muss eine Synchronisation sicherstellen. Frage Q-8f59bb65825ead66 (offen)

Nutzungspfad

Der typische Ablauf beginnt mit der Bereitstellung einer von ara::tsync::ProviderTimeBaseValidationNotification abgeleiteten Klasse durch die Validator-Anwendung. Die Instanz dürfte beim Zeitbasis-Provider registriert werden, um entsprechende Messdaten zu abonnieren. Frage Q-0ddb9ee8a3e8f381 (offen) Sobald der Zeit-Stack neue Messzyklen der Zeitbasis abgeschlossen hat, liefert er die erfassten Blöcke über die pure-virtual-Methoden der Schnittstelle aus. Für die Analyse des Time Masters erfolgt der Aufruf von SetMasterTimingData mit dem Parameter measurementData vom Typ TimeMasterMeasurementType [SWS_TS_00421]. Sind für die Zeitbasis Messdaten zur Signallaufzeitmessung verfügbar, übermittelt der Provider diese über SetPdelayResponderData mit dem Parameter measurementData vom Typ PdelayResponderMeasurementType [SWS_TS_00423]. Nach Beendigung des Überwachungsbetriebs zerstört die Anwendung die Instanz geordnet über den virtuellen Destruktor [SWS_TS_01301].

Sequenzdiagramm: Typische Benachrichtigung einer Validator-Anwendung über neue Zeitbasis-Messdatenblöcke. Quellen: [SWS_TS_00421], [SWS_TS_00423], [SWS_TS_01301]

Fehlerszenarien und Randbedingungen

Sowohl SetMasterTimingData als auch SetPdelayResponderData sind als noexcept spezifiziert und besitzen die Klassifikation exception safe [SWS_TS_00421], [SWS_TS_00423]. Implementierungen dieser Schnittstelle dürfen daher keine Ausnahmen an den aufrufenden Synchronisations-Provider weiterreichen. Die Methoden liefern keinen Rückgabewert (void); eine Rückmeldung über fehlerhafte oder unplausible Messdaten erfolgt somit nicht direkt über den Methodenaufruf. Da die Schnittstelle als non_threadsafe deklariert ist, führt ein nebenläufiger Aufruf ohne externe Synchronisation zu undefiniertem Verhalten. Eine Vorbedingung für die Entgegennahme der Daten ist ein intaktes Objekt, dessen Lebensdauer über den gesamten Zeitraum der Callback-Bereitstellung bis zur Zerstörung über den Destruktor aufrechterhalten werden muss [SWS_TS_01301].