FB_FileLoad

FB_FileLoad 1:

Mit dem Funktionsbaustein FB_FileLoad kann der Inhalt einer Datei ausgelesen werden. Die Datei wird implizit im Binär-Mode geöffnet, der Inhalt ausgelesen und die Datei daraufhin geschlossen.

	Dieser Funktionsbaustein ist nur bedingt für ein Logging in Echtzeit geeignet. Für eine gute Performance empfehlen wir die Verwendung des kostenpflichtigen Produkts TF3500 TwinCAT Analytics Logger.

Eingänge

VAR_INPUT
    sNetId     : T_AmsNetId;
    sPathName  : T_MaxString;
    pReadBuff  : PVOID;
    cbReadLen  : UDINT;
    bExecute   : BOOL;
    tTimeout   : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

Name	Typ	Beschreibung
sNetId	T_AmsNetId	String, der die AMS-Netzwerkkennung des Zielgerätes enthält, an das der ADS-Befehl gerichtet wird (Typ: T_AmsNetId).
sPathName	T_MaxString	Speicherpfad und Dateiname der zu öffnenden Datei. Der Pfad kann nur auf das lokale Dateisystem des Rechners zeigen. Netzwerkpfade können hier nicht angegeben werden (Typ: T_MaxString)
pReadBuff	PVOID	Adresse des Puffers, in den die Daten gelesen werden sollen. Der Puffer kann eine Einzelvariable, ein Array oder eine Struktur sein, dessen Adresse mit dem ADR-Operator ermittelt werden kann.
cbReadLen	UDINT	Anzahl der zu lesenden Bytes.
bExecute	BOOL	Durch eine steigende Flanke an diesem Eingang wird der Funktionsbaustein aktiviert.
tTimeout	TIME	Gibt die Timeout-Zeit an, die bei der Ausführung der internen ADS-Kommandos nicht überschritten werden darf.

Ausgänge

VAR_OUTPUT
    bBusy  : BOOL;
    bError : BOOL;
    nErrId : UDINT;
    cbRead : UDINT;    
END_VAR

Name	Typ	Beschreibung
bBusy	BOOL	Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang auf TRUE gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt. Solange bBusy = TRUE ist, kann kein neuer Befehl ausgeführt werden.
bError	BOOL	Wenn bei der Ausführung des Befehls ein Fehler auftritt, wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.
nErrId	UDINT	Liefert bei einem gesetzten bError-Ausgang den ADS-Fehlercode oder den befehlsspezifischen Fehlercode.
cbRead	UDINT	Anzahl der aktuell gelesenen Bytes

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.4022.0	PC oder CX (x86, x64, ARM)	Tc2_System (System) >= v3.4.22.0