FB_EcFoeOpen

FB_EcFoeOpen 1:

Mit diesem Funktionsbaustein wird der Kommunikationsport für das "File access over EtherCAT"-Mailbox-Protokoll geöffnet.

FB_EcFoeOpen 2: Eingänge

VAR_INPUT
    sNetId    : T_AmsNetId;
    nPort     : UINT;     
    sPathName : T_MaxString;
    dwPass    : DWORD;
    eMode     : E_EcFoeMode;
    bExecute  : BOOL; 
    tTimeout  : TIME := DEFAULT_ADS_TIMEOUT; 
END_VAR

Name

Typ

Beschreibung

sNetId

T_AmsNetId

String, der die AMS-Netzwerkkennung des EtherCAT-Master-Gerätes enthält.

nPort

UINT

Feste Adresse des EtherCAT-Gerätes

sPathName

T_MaxString

Dateipfadname ( z.B.: 'c:\TwinCAT\FOE\Data.fwp' )
(Siehe unten weitere Erläuterungen zum sPathName.)

dwPass

DWORD

Passwort

eMode

E_EcFoeMode

Zugriffsmode (Schreib-/Lesezugriff)

bExecute

BOOL

Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.

tTimeout

TIME

Maximale Zeit, die bei der Ausführung des Funktionsbausteins nicht überschritten werden darf.

sPathName

Als Dateipfadname ( z.B.: 'c:\TwinCAT\FOE\Data.fwp' ) aus dem eingegebenen Dateipfad wird standardmäßig nur der Dateiname, ohne Dateinamenserweiterung extrahiert und als Dateiname für das FoE-Protokoll verwendet (in diesem Beispiel: ‚Data‘ ). Ab der Bibliotheksversion >= 3.3.12.0 können auch Dateinamen inklusive der Dateinamenserweiterung verwendet werden (in diesem Beispiel: ‚Data.fwp‘ ).

Über die globale boolische Variable
Tc2_EtherCAT.bEcFoeOpenFileNameWithFileExt
kann die Verwendung der Dateinamenserweiterung für alle Instanzen des FB_EcFoeOpen-Funktionsbausteins aktiviert bzw. deaktiviert werden. Standardmäßig hat die Variable den Wert: FALSE (keine Dateinamenserweiterung). Wenn Sie den Wert auf TRUE setzen, wird die Verwendung der Dateinamenserweiterungen aktiviert.
Beachten Sie, dass die FoE-Funktionsbausteine ursprünglich für Firmwareupdates verwendet wurden, bei denen keine Dateinamenserweiterung verwendet wurde. Sollten Sie Firmwareupdates durchführen wollen, müssen Sie eventuell sicherstellen, dass die globale Variable ihren ursprünglichen Standardwert FALSE besitzt.

FB_EcFoeOpen 3: Ausgänge

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

Name

Typ

Beschreibung

bBusy

BOOL

Dieser Ausgang wird bei der Aktivierung des Funktionsbausteins gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

bError

BOOL

Dieser Ausgang wird gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde, wenn bei der Übertragung des Kommandos ein Fehler auftritt.

nErrId

UDINT

Liefert bei einem gesetzten bError-Ausgang den ADS-Fehlercode des zuletzt ausgeführten Befehls.

hFoe

T_HFoe

"File access over EtherCAT" - Handle

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS- Bibliotheken

TwinCAT v3.1.0

PC oder CX (x86, x64, ARM)

Tc2_EtherCAT