classe ara::tsync::SynchronizedTimeBaseProvider

La classe déplaçable uniquement ara::tsync::SynchronizedTimeBaseProvider sert aux applications fournisseurs de temps pour l'injection, la correction de dérive et la validation d'une base de temps synchronisée [SWS_TS_01101] [SWS_TS_01110]. Les actualisations peuvent soit déclencher des transmissions immédiates sur le bus, soit être planifiées en tant que mise à jour locale pour le prochain cycle de transmission [SWS_TS_01107] [SWS_TS_01108]. Alors que les accès en lecture sont sûrs vis-à-vis des threads, toutes les méthodes modificatrices ainsi que l'enregistrement de notificateurs nécessitent un appel local au thread ou synchronisé [SWS_TS_01109] [SWS_TS_01114].

plus ›

Contexte

La classe ara::tsync::SynchronizedTimeBaseProvider fournit aux applications fournisseurs de temps l'accès de contrôle actif à une base de temps synchronisée, modélisée via un ara::core::InstanceSpecifier [SWS_TS_01101]. Dans AUTOSAR Adaptive, l'instance fait office d'interface entre la logique applicative fournisseuse, le démon local de Time-Sync et les bus de communication raccordés. Par le biais de ce composant, l'application injecte de nouvelles valeurs de temps et des données utiles spécifiques à l'utilisateur dans le système, compense les dérives par des corrections de taux et acquiert des paramètres de validation [SWS_TS_01107] [SWS_TS_01110] [SWS_TS_01114].

Diagramme de contexte : intégration du SynchronizedTimeBaseProvider entre l'application fournisseur, la validation et la transmission sur le bus. Sources : [SWS_TS_01101], [SWS_TS_01107], [SWS_TS_01114]

Cycle de vie

L'instanciation s'effectue explicitement via un ara::core::InstanceSpecifier, qui doit référencer un PortPrototype typé par un SynchronizedTimeBaseProviderInterface [SWS_TS_01101]. Le constructeur est déclaré sûr vis-à-vis des exceptions et des threads [SWS_TS_01101]. Un objet de la classe est un objet exclusif déplaçable uniquement : le constructeur de copie et l'opérateur d'affectation par copie sont explicitement supprimés [SWS_TS_01104] [SWS_TS_01105], tandis que la construction par déplacement et l'affectation par déplacement sont prises en charge [SWS_TS_01102] [SWS_TS_01103].

Concernant la concurrence, une séparation stricte s'applique : les opérations de pure lecture sur l'état telles que GetCurrentTime(), GetRateDeviation() et GetUserData() sont sûres vis-à-vis des threads et peuvent être exécutées de manière concurrente [SWS_TS_01109] [SWS_TS_01111] [SWS_TS_01113]. En revanche, toutes les opérations modificatrices, l'enregistrement de notifications ainsi que la destruction de l'objet via le destructeur ne sont pas sûrs vis-à-vis des threads et requièrent une synchronisation côté application [SWS_TS_01106] [SWS_TS_01107] [SWS_TS_01114].

Parcours d'utilisation

L'utilisation typique s'articule entre l'enregistrement pour les retours de validation et la transmission temporelle cyclique ou pilotée par événements :

• Enregistrer la validation : si nécessaire, l'application fournisseur enregistre via RegisterTimeValidationNotification() un objet de notification afin de recevoir de nouveaux blocs de données de synchronisation temporelle enregistrés [SWS_TS_01114]. Au maximum un récepteur de notifications peut être actif ; un nouvel enregistrement écrase un enregistrement existant [SWS_TS_01114], tandis que UnregisterTimeValidationNotification() supprime la liaison [SWS_TS_01115].
• Définir la valeur temporelle : en cas de distribution immédiatement requise, l'application appelle SetTime(). Cela définit la valeur temporelle locale et déclenche immédiatement la transmission sur le bus [SWS_TS_01107]. Si la transmission sur le bus ne doit avoir lieu qu'au prochain cycle régulier, UpdateTime() est utilisé, ce qui met d'abord à jour l'horloge uniquement au niveau local [SWS_TS_01108].
• Correction et données utiles : via SetRateCorrection(), la dérive de l'horloge locale peut être ajustée par un facteur de correction (des valeurs inférieures à 1.0 ralentissent l'horloge, des valeurs supérieures à 1.0 l'accélèrent) [SWS_TS_01110]. Des données de base de temps supplémentaires spécifiques à l'utilisateur peuvent être mises à jour via SetUserData() [SWS_TS_01112].

Diagramme de séquence : déroulement de l'enregistrement du notificateur et de l'actualisation temporelle avec chemins de transmission sur le bus alternatifs. Sources : [SWS_TS_01107], [SWS_TS_01108], [SWS_TS_01114]

Scénarios d'erreur

Les méthodes avec valeur de retour ara::core::Result<void> signalent les échecs via des codes d'erreur du type TsyncErrc sans sémantique de rollback :

• TsyncErrc::kInvalidUserDataSize : survient lors de SetTime(), UpdateTime() et SetUserData() lorsque les UserData transmis dépassent la longueur maximale de UserData::kMaxUserDataSize (actuellement 3 octets) [SWS_TS_01107] [SWS_TS_01108] [SWS_TS_01112].
• TsyncErrc::kDaemonConnectionLost : survient lors de SetTime() si la connexion IPC avec le démon de Time-Sync est interrompue au moment de l'appel [SWS_TS_01107].
• TsyncErrc::kLimitsExceeded : est renvoyé par SetRateCorrection() lorsque le facteur de correction de taux demandé se situe en dehors de la plage de valeurs autorisée [SWS_TS_01110].
• TsyncErrc::kFunctionNotSupported : est signalé par SetRateCorrection() lorsque la plateforme sous-jacente ou la base de temps ne prend pas en charge la correction de taux [SWS_TS_01110].