FB_FilePuts

FB_FilePuts 1:

Der Funktionsbaustein schreibt Strings in eine Datei. Der String wird bis zur Null-Terminierung aber ohne den Null-Character in die Datei geschrieben. Die Datei muss dafür im Textmodus geöffnet worden sein.

VAR_INPUT

VAR_INPUT
    sNetId      : T_AmsNetId;          
    hFile       : UINT;         
    sLine       : T_MaxString;    (* string to write *)
    bExecute    : BOOL;     
    tTimeout    : TIME;
END_VAR

sNetId    : Ist ein String, der die AMS-Netzwerkkennung des Zielgerätes enthält, an das der ADS-Befehl gerichtet wird.

hFile    : Datei-Handle.

sLine : Der String der in die Datei geschrieben werden soll.

bExecute    : Durch eine steigende Flanke an diesem Eingang wird der Funktionsbaustein aktiviert.

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

VAR_OUTPUT

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

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

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

nErrId:    Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.

 

Function specific ADS error code

Possible reason

0x703

Invalid or unknown file handle.

0x70E

File was opened with wrong method ( e.g. with 'obsolete' FILEOPEN function block ).

 

Beispiel für den Aufruf des Bausteins in FBD:

PROGRAM Test
VAR
    fbFilePuts      : FB_FilePuts;
    hFile           : UINT;
    bFilePuts       : BOOL;
    bFilePutsBusy   : BOOL;
    bFilePutsError  : BOOL;
    nFilePutsErrorId: UDINT;
END_VAR
FB_FilePuts 2:

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS Bibliotheken

TwinCAT v2.8.0

PC or CX (x86)

TcSystem.Lib

TwinCAT v2.10.0 Build >= 1301

CX (ARM)

TcSystem.Lib