FB_FileWrite

VAR_INPUT

VAR_INPUT
    sNetId          : T_AmsNetId;
    hFile           : UINT;
    pWriteBuff      : DWORD;
    cbWriteLen      : UDINT;
    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.

pWriteBuff : Enthält die Adresse des Puffers, der die zu schreibenden Daten enthält. Der Puffer kann eine Einzelvariable, ein Array oder eine Struktur sein, dessen Adresse mit dem ADR - Operator ermittelt werden kann.

cbWriteLen : Enthält die Anzahl der zu schreibenden Bytes.

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;
    cbWrite     : 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.

cbWrite : Enthält die Anzahl der zuletzt erfolgreich geschriebenen Datenbytes. Beim Schreibfehler ist die Anzahl der erfolgreich geschriebenen Datenbytes kleiner als die angeforderte Länge (cbWriteLen) oder Null. Ein Schreibfehler kann z.B. dann auftreten wenn der Datenträger voll ist. Beim Schreibfehler wird der bError-und nErrID-Ausgang nicht gesetzt. Da die SPS-Applikation die Anzahl der zu schreibenden Datenbytes kennt, kann sie die tatsächlich geschriebene Länge mit der angeforderten Länge vergleichen und so Schreibfehler erkennen. Beim Schreibfehler hat der interne Dateizeiger eine undefinierte Position.

Beispiel für den Aufruf des Bausteins in FBD:

PROGRAM Test
VAR
    fbFileWrite        : FB_FileWrite;
    hFile              : UINT;
    bFileWrite         : BOOL;
    bFileWriteBusy     : BOOL;
    bFileWriteError    : BOOL;
    nFileWriteErrorId  : UDINT;
    nFileWriteCount    : UDINT;
    FILEDATA           : ARRAY[0..9] OF BYTE;
END_VAR

Im Beispiel werden, nach steigender Flanke von "bExecute", 10 Byte des Arrays "FILEDATA" in die Datei geschrieben

Voraussetzungen