FB_LicFileRead

FB_LicFileRead 1:

Der Funktionsbaustein liest über eine steigende Flanke an bExecute eine Datei vom Lizenz-Dongle in einen bereitgestellten Buffer (pDestBuff und cbReadLen). Der Buffer muss groß genug für die Datei sein, sonst wird nur der vordere Teil der Datei gelesen.

FB_LicFileRead 2: Eingänge

VAR_INPUT
    sNetId      : T_AmsNetId;
    nPort       : UINT;
    sFileName   : STRING;
    pDestBuff   : PVOID;
    cbReadLen   : UDINT
    bExecute    : BOOL;
    dwPassCode  : DWORD;
    tTimeout    : TIME       := DEFAULT_ADS_TIMEOUT;
END_VAR

Name

Typ

Beschreibung

sNetId

T_AmsNetId

AmsNetId (AMS-Netzwerkkennung) des Lizenz-Dongles

  • USB-Dongle: AmsNetId des TwinCAT-Rechners. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.
  • EL6070: AmsNetId des EtherCAT-Masters (siehe AdsAddr.netId in den InfoData der EL6070)

nPort

UINT

AMS-Port des Lizenz-Dongles

  • USB: ADS-Port des ESB-Geräts (siehe ADS-Port auf dem ESB Device Tab vom USB-Dongle, Default ist 16#7100)
  • EL6070: ADS-Port des EtherCAT-Terminals (siehe AdsAddr.port in den InfoData der EL6070)

sFileName

STRING

Name der zu lesenden Datei

pDestBuff

PVOID

Buffer address for read

cbReadLen

UDINT

Count of bytes for read

bExecute

BOOL

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

dwPassCode

DWORD

Passcode für den Dateizugriff

tTimeout

TIME

Timeout-Zeit, die bei Ausführung des Befehls nicht überschritten werden darf.

FB_LicFileRead 3: Ausgänge

VAR_OUTPUT
    bBusy        : BOOL;
    bError       : BOOL;
    nErrorId     : UDINT;
    cbBytesread  : UDINT;
END_VAR

Name

Typ

Beschreibung

bBusy

BOOL

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

bError

BOOL

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

nErrorId

UDINT

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

cbBytesRead

UDINT

 

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS-Bibliotheken

TwinCAT v3.1.4022

PC oder CX (x64, x86)

Tc2_Utilties >= 3.3.26.0