NT_SetTimeToRTCTime

	Diese Funktionalität ist in dem SPS-Laufzeitsystem unter Windows CE nicht verfügbar!

NT_SetTimeToRTCTime 2:

Mit dem Funktionsbaustein "NT_SetTimeToRTCTime" kann die lokale Windows-Systemzeit (wird in der Taskleiste eingeblendet) mit der Echtzeituhr des PCs (RTC-Zeit in BIOS) synchronisiert werden.

Bemerkungen

Beim Aufruf des Funktionsbausteins wird die Echtzeituhr des TwinCAT PCs mit der lokalen Windows-Systemzeit verglichen und die lokale Windows-Systemzeit um die ermittelte Differenz korrigiert. Zeitzonen und Sommerzeit werden dabei berücksichtigt. Zu beachten ist, dass es durch die Korrektur zu Zeitsprüngen während Messungen oder Logbuchaufzeichnungen führen kann.

Beim Setzen der lokalen Windows-Systemzeit wird vom Betriebssystem auch automatisch die RTC-Zeit auf die neue lokale Windows-Systemzeit gesetzt. Die neue RTC-Zeit wird dabei zwangsläufig durch die Umrechnung und Verzögerung mit einem kleinen Fehler behaftet. Der Fehler liegt im Millisekundenbereich. D.h. mit jedem Aufruf von NT_SetTimeToRTCTime wird die Echtzeituhr ein wenig verfälscht. Um möglichst kleine Abweichungen über einen längeren Zeitraum zu erreichen, sollte der Abgleich z.B. alle 24 Stunden und nicht in jedem SPS-Zyklus durchgeführt werden.

VAR_INPUT

VAR_INPUT
    NETID  : T_AmsNetId;
    SET    : BOOL;
    TMOUT  : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

NETID: Hier kann ein String mit der Netzwerkadresse des TwinCAT-Rechners angegeben werden, auf dem die lokale Windows-Systemzeit synchronisiert werden soll (Typ: T_AmsNetID). Für den lokalen Rechner kann auch ein Leerstring angegeben werden.

SET: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.

TMOUT: Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.

VAR_OUTPUT

VAR_OUTPUT
    BUSY  : BOOL;
    ERR   : BOOL;
    ERRID : UDINT;
END_VAR

BUSY: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

ERR: Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der BUSY-Ausgang zurückgesetzt wurde.

ERRID: Liefert bei einem gesetzten ERR-Ausgang die ADS-Fehlernummer.

Weitere Zeit-, Zeitzone-Funktionen und -Funktionsbausteine:

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.0	PC oder CX (WES7/Win7/Win10: TC RT x86/x64)	Tc2_Utilities (System)