FB_BA_SetTime

FB_BA_SetTime 1:

Mit dem Funktionsbaustein FB_BA_SetTime kann die lokale NT-Systemzeit und das Datum eines TwinCAT-Systems gesetzt werden (die lokale NT-Systemzeit wird in der Taskleiste eingeblendet). Die Systemzeit wird über die Struktur tSysTi vorgegeben.
Intern wird in dem Funktionsbaustein eine Instanz des Funktionsbausteins NT_SetLocalTime aus der TcUtilities-Bibliothek aufgerufen.

FB_BA_SetTime 2:

Die lokale NT-Systemzeit können Sie auch mit der Hilfe des SNTP-Protokolls mit einer Referenzzeit synchronisieren. Mehr Informationen dazu finden Sie im Beckhoff Information System unter: Beckhoff Information System > Embedded-PC > Betriebssysteme > CE > SNTP: Simple Network Time Protocol

FB_BA_SetTime 3:

FB_BA_SetTime 4: Eingänge

VAR_INPUT
  bSet         : BOOL;
  tNetId       : T_AmsNetId;
  tSysTi       : TIMESTRUCT;
  nTiOut       : UDINT;
END_VAR

Name

Typ

Beschreibung

bSet

BOOL

Aktivierung des Funktionsbausteins mit einer steigenden Flanke.

tNetId

T_AmsNetID

Hier kann die AmsNetId des TwinCAT-Rechners angegeben werden dessen lokale NT-Systemzeit gesetzt werden soll. Für den lokalen Rechner kann auch ein Leerstring tNetId := ''; angegeben werden.

tSysTi

TIMESTRUCT

Struktur mit der neuen lokalen NT-Systemzeit. Ist die Zeit als Struktur nicht vorhanden, so empfiehlt sich die Verwendung des Bausteines FB_BA_CnvtTiSt, welcher die Teilvariablen von Datum und Uhrzeit in einer Struktur zusammenführt.

nTiOut

UDINT

Gibt die Timeout-Zeit [s] an, die bei der Ausführung nicht überschritten werden darf.

FB_BA_SetTime 5: Ausgänge

VAR_OUTPUT
  bBusy           : BOOL;
  bErr            : BOOL;
  sErrDescr       : T_MAXSTRING;
END_VAR

Name

Typ

Beschreibung

bBusy

BOOL

Bei der Aktivierung des Funktionsbausteins über eine steigende Flanke an bSet wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

bErr

BOOL

Dieser Ausgang wird auf TRUE geschaltet, wenn entweder die zu übertragene Systemzeit fehlerhaft ist oder aber ein ADS-Fehler in der Übertragung stattfindet.

sErrDescr

T_MAXSTRING

Enthält die Fehlerbeschreibung

Fehlerbeschreibung

01: Fehler: Fehler Bereichsüberschreitung Jahr

02: Fehler: Fehler Bereichsüberschreitung Monat

03: Fehler: Fehler Bereichsüberschreitung Monatstag

04: Fehler: Fehler Bereichsüberschreitung Stunde

05: Fehler: Fehler Bereichsüberschreitung Minute

06: Fehler: Fehler Bereichsüberschreitung Sekunde

07: Fehler: Fehler Bereichsüberschreitung Millisekunde

08: Warnung: Ein ADS-Fehler ist während des Setzens der Zeit aufgetreten (NT_SetLocalTime). Es wird die ADS-Fehlernummer angegeben.

Grenzen der Zeitvorgabe

Die angelegte Zeitstruktur stSysTi wird bausteinintern auf Grenzen geprüft (siehe TIMESTRUCT).

Voraussetzungen

Entwicklungsumgebung

Erforderliche SPS-Bibliothek

TwinCAT ab v3.1.4024.22

Tc3_BA2 ab v5.2.5.0