FB_BA_SetTime

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 stSysTi vorgegeben.
Intern wird in dem Funktionsbaustein eine Instanz des Funktionsbausteins NT_SetLocalTime aus der TcUtilities-Bibliothek aufgerufen.

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

VAR_INPUT

bSet         : BOOL;
sNetId       : T_AmsNetId;
stSysTi      : TIMESTRUCT;
udiTiOut_sec : UDINT;

bSet: Aktivierung des Funktionsbausteins mit einer steigenden Flanke.

sNetId: 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 sNetId := ''; angegeben werden (siehe T_AmsNetId).

stSysTi: Struktur mit der neuen lokalen NT-Systemzeit (siehe TIMESTRUCT). 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 zusammen führt.

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

VAR_OUTPUT

bBusy           : BOOL;
bError          : BOOL;
sErrorDescr     : T_MAXSTRING;

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

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

sErrDescr: Enthält die Fehlerbeschreibung.

Grenzen der Zeitvorgabe

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

Voraussetzungen