clase ara::tsync::ProviderTimeBaseValidationNotification

La clase abstracta ara::tsync::ProviderTimeBaseValidationNotification sirve como interfaz de callback para poner a disposición de una aplicación validadora datos de medición registrados de una base de tiempo. A través de SetMasterTimingData, las implementaciones reciben bloques de medición del Time Master [SWS_TS_00421], así como datos de medición del Pdelay Responder [SWS_TS_00423] a través de SetPdelayResponderData. Los métodos están especificados como noexcept, pero no son seguros para hilos (thread-safe), por lo que deben evitarse las llamadas concurrentes sobre la misma instancia.

más ›

Contexto

La clase ara::tsync::ProviderTimeBaseValidationNotification actúa como interfaz de callback abstracta para la validación de bases de tiempo dentro del módulo de sincronización. A través de esta interfaz se notifica a una aplicación validadora receptora en cuanto se dispone de nuevos bloques de datos de medición registrados para una base de tiempo monitorizada. La interfaz define puntos de entrega para datos de medición específicos del temporizador (Time Master) según [SWS_TS_00421], así como para datos de medición del mecanismo de respuesta de retardo (Pdelay Responder) según [SWS_TS_00423]. Los interlocutores habituales son el mecanismo proveedor interno de la pila de sincronización de tiempo como fuente de datos y una instancia de validación del lado de la aplicación que evalúa los datos de tiempo recopilados.

Ciclo de vida y concurrencia

Como interfaz abstracta, ara::tsync::ProviderTimeBaseValidationNotification es derivada e implementada por la aplicación de validación concreta. El tiempo de vida de la implementación instanciada recae bajo la responsabilidad de la aplicación. La clase posee un destructor virtual predeterminado, declarado como seguro frente a excepciones (noexcept) [SWS_TS_01301]. Esto garantiza que las instancias de las clases derivadas puedan destruirse de forma polimórfica y segura para los recursos durante su desmantelamiento. En cuanto a la concurrencia, los métodos de notificación están clasificados explícitamente como no seguros para hilos (non_threadsafe) [SWS_TS_00421], [SWS_TS_00423]. Esto significa que las llamadas a SetMasterTimingData y SetPdelayResponderData para la misma instancia no deben realizarse de forma desprotegida desde hilos concurrentes; el proveedor de la base de tiempo llamante debería emitir estas llamadas secuencialmente o la aplicación debe garantizar la sincronización. Pregunta Q-8f59bb65825ead66 (abierta)

Ruta de uso

El flujo típico comienza con la provisión de una clase derivada de ara::tsync::ProviderTimeBaseValidationNotification por parte de la aplicación validadora. La instancia se registraría en el proveedor de la base de tiempo para suscribirse a los datos de medición correspondientes. Pregunta Q-0ddb9ee8a3e8f381 (abierta) Tan pronto como la pila de tiempo completa nuevos ciclos de medición de la base de tiempo, entrega los bloques recopilados a través de los métodos puramente virtuales de la interfaz. Para el análisis del Time Master, se invoca SetMasterTimingData con el parámetro measurementData de tipo TimeMasterMeasurementType [SWS_TS_00421]. Si hay datos de medición disponibles para la medición del tiempo de propagación de la señal de la base de tiempo, el proveedor los transmite mediante SetPdelayResponderData con el parámetro measurementData de tipo PdelayResponderMeasurementType [SWS_TS_00423]. Tras finalizar el modo de monitorización, la aplicación destruye la instancia de forma ordenada a través del destructor virtual [SWS_TS_01301].

Diagrama de secuencia: notificación típica a una aplicación validadora sobre nuevos bloques de datos de medición de base de tiempo. Fuentes: [SWS_TS_00421], [SWS_TS_00423], [SWS_TS_01301]

Escenarios de error y condiciones límite

Tanto SetMasterTimingData como SetPdelayResponderData están especificados como noexcept y cuentan con la clasificación exception safe [SWS_TS_00421], [SWS_TS_00423]. Por consiguiente, las implementaciones de esta interfaz no deben propagar excepciones al proveedor de sincronización llamante. Los métodos no devuelven ningún valor (void); por lo tanto, no se proporciona retroalimentación sobre datos de medición erróneos o no plausibles directamente a través de la llamada al método. Dado que la interfaz está declarada como non_threadsafe, una invocación concurrente sin sincronización externa provocará un comportamiento indefinido. Una precondición para la recepción de los datos es un objeto intacto cuyo tiempo de vida debe mantenerse durante todo el periodo de provisión del callback hasta su destrucción mediante el destructor [SWS_TS_01301].