Description de la fonction

La fonction RRTC_DT_MS permet de récupérer la date et l'heure de l'automate en temps UTC (Coordinated Universal Time, temps universel coordonné) avec une précision de 10 ms. Le résultat est renvoyé par deux sorties présentant un format différent :

  • format d'affichage,

  • format de calcul.

NOTE : Sur les automates M580, les mots système %SW49 à %SW53 indiquent également la date et l'heure courantes en UTC (Coordinated Universal Time, temps universel coordonné). Pour obtenir l'heure locale, utilisez la fonction RRTC_DT.

Les paramètres supplémentaires EN et ENO peuvent être configurés.

Représentation en FBD

Représentation :

Représentation en LD

Représentation :

Représentation en IL

Représentation :

RRTC_DT_MS(Display, Calc, Status)

Représentation en ST

Représentation :

RRTC_DT_MS(Display, Calc, Status);

Description des paramètres

Le tableau suivant décrit les paramètres de sortie :

Paramètre

Type

Commentaire

Display

Display_NTPC

La sortie Display contient la date et l'heure de l'automate. Le type Display_NTPC est une structure prédéfinie comprenant un élément de type DT et un élément de type INT. Ce qui nous donne :

  • Display.DT_value contenant la date,

  • Display.Milisecond contenant le nombre de millisecondes de cette date, car la seconde est l'unité de mesure minimale du format DT.

Calc

Calc_NTPC

La sortie Calc contient les informations de date et d'heure provenant d'un serveur NTP (comme pour la variable Display), mais dans un format différent. Le type Calc_NTPC est une structure prédéfinie comprenant un élément de type UDINT et un élément de type INT. Ce qui nous donne :

  • Calc.Seconds contenant le nombre de secondes écoulées depuis le 1er janvier 1980 à 00:00.

  • Calc.Fraction_Second contenant le nombre de millisecondes à ajouter pour obtenir un résultat avec une précision de l'ordre de la milliseconde.

STATUS

INT

L'octet de poids faible est contrôlé par l'UC. Lorsque cet octet est réglé sur 1 :

  • la valeur d'horloge n'est pas disponible ;

  • la date et l'heure ne sont pas mises à jour au cours des deux dernières minutes.

Lorsque cet octet est réglé sur 0 :

  • la date et l'heure sont mises à jour au cours des deux dernières minutes ;

  • la date et l'heure sont acceptables.

Si le processeur est client NTP, l'octet de poids fort est géré par le module Ethernet. Lorsque cet octet est réglé sur 1, la valeur d'horloge transmise à l'UC n'est pas acceptable.

Lorsque cet octet est réglé sur 0, la date/heure mise à jour reçue du serveur et envoyée au module est :

  • comprise dans un intervalle de deux minutes,

  • acceptable (décalage de 10 ms maximum).

Pour que l'heure valide de l'UC soit valide, l'octet de poids fort et l'octet de poids faible du paramètre STATUS doivent être réglés sur 0. Dans le cas contraire, une erreur d'exécution est générée (voir ci-dessous).

Erreurs d'exécution

Si l'octet de poids faible ou de poids fort de la sortie STATUS est défini sur 1, le bit %S18 est défini sur 1 par le système de l'automate.