TF6300 TC3 FTP CLIENT DE - download.beckhoff.com · Übersicht ArtikelSystemvoraussetzungen [...

Handbuch

TC3 FTP Client

TwinCAT 3

1.017.06.2015TF6300

VersionDatumBestell-Nr.

Inhaltsverzeichnis

Inhaltsverzeichnis1 Vorwort ....................................................................................................................................................... 5

1.1 Hinweise zur Dokumentation ............................................................................................................ 51.2 Sicherheitshinweise .......................................................................................................................... 6

2 Übersicht .................................................................................................................................................... 7

3 Installation.................................................................................................................................................. 93.1 Systemvoraussetzungen .................................................................................................................. 93.2 Installation......................................................................................................................................... 93.3 Lizensierung ................................................................................................................................... 12

4 Konfiguration ........................................................................................................................................... 174.1 Grundlagen zum File Transfer Protocol (FTP)................................................................................ 174.2 Konfiguration der Data-Ports für aktives FTP ................................................................................. 184.3 Aktivierung einer Fehlerprotokolldatei ............................................................................................ 20

5 SPS-Bibliotheken..................................................................................................................................... 225.1 Tc2_FTP ......................................................................................................................................... 225.2 Funktionsbausteine......................................................................................................................... 23

5.2.1 FB_FTP_HostResolve ........................................................................................................ 235.2.2 FB_FTP_Open.................................................................................................................... 245.2.3 FB_FTP_OpenEx................................................................................................................ 255.2.4 FB_FTP_Close ................................................................................................................... 265.2.5 FB_FTP_CloseAll ............................................................................................................... 275.2.6 FB_FTP_Info....................................................................................................................... 285.2.7 FB_FTP_FileUpload ........................................................................................................... 295.2.8 FB_FTP_FileUploadEx ....................................................................................................... 305.2.9 FB_FTP_FileDownload....................................................................................................... 325.2.10 FB_FTP_FileDownloadEx................................................................................................... 335.2.11 FB_FTP_DirCreate ............................................................................................................. 345.2.12 FB_FTP_DirRemove........................................................................................................... 355.2.13 FB_FTP_FileList ................................................................................................................. 365.2.14 FB_FTP_FileListEx ............................................................................................................. 375.2.15 FB_FTP_FileExist ............................................................................................................... 395.2.16 FB_FTP_FileRemove ......................................................................................................... 405.2.17 FB_FTP_FileRename ......................................................................................................... 415.2.18 FB_GetStateTcFTPClient ................................................................................................... 42

5.3 Funktionen [veraltet] ....................................................................................................................... 435.3.1 F_GetVersionTcFTPClient.................................................................................................. 43

5.4 Datentypen ..................................................................................................................................... 445.4.1 T_HFTP .............................................................................................................................. 445.4.2 ST_FTP_ConnInfo .............................................................................................................. 445.4.3 ST_FTP_FileDetails............................................................................................................ 455.4.4 E_FTP_ConnMode ............................................................................................................. 45

5.5 Konstanten...................................................................................................................................... 465.5.1 Konstanten.......................................................................................................................... 46

6 Beispiele................................................................................................................................................... 476.1 Beispiele ......................................................................................................................................... 476.2 TwinCAT FTP Client: Hochladen einer Datei auf einen FTP Server .............................................. 476.3 TwinCAT FTP Client: Herunterladen einer Datei von einem FTP Server auf ein CX-Gerät........... 486.4 TwinCAT FTP Client: Auslesen der Verbindungsinformationen mit FB_FTP_Info......................... 506.5 TwinCAT FTP Client: Löschen einer Datei vom FTP Server.......................................................... 516.6 TwinCAT FTP Client: Auslesen einer Dateiliste von einem FTP Server ........................................ 52

TC3 FTP Client 3Version 1.0

Inhaltsverzeichnis

7 Anhang ..................................................................................................................................................... 557.1 Return Codes.................................................................................................................................. 55

7.1.1 Übersicht der Fehlercodes des TwinCAT FTP Client ......................................................... 557.1.2 ADS Return Codes ............................................................................................................. 557.1.3 FTP Client Return Codes.................................................................................................... 59

7.2 Troubleshooting .............................................................................................................................. 617.2.1 Troubleshooting .................................................................................................................. 617.2.2 Kontakt Beckhoff Support ................................................................................................... 61

TC3 FTP Client4 Version 1.0

Vorwort

1 Vorwort

1.1 Hinweise zur DokumentationDiese Beschreibung wendet sich ausschließlich an ausgebildetes Fachpersonal der Steuerungs- undAutomatisierungstechnik, das mit den geltenden nationalen Normen vertraut ist.Zur Installation und Inbetriebnahme der Komponenten ist die Beachtung der nachfolgenden Hinweise undErklärungen unbedingt notwendig.

Das Fachpersonal hat sicherzustellen, dass die Anwendung bzw. der Einsatz der beschriebenen Produktealle Sicherheitsanforderungen, einschließlich sämtlicher anwendbaren Gesetze, Vorschriften, Bestimmungenund Normen erfüllt.

DisclaimerDiese Dokumentation wurde sorgfältig erstellt. Die beschriebenen Produkte werden jedoch ständig weiterentwickelt.Deshalb ist die Dokumentation nicht in jedem Fall vollständig auf die Übereinstimmung mit denbeschriebenen Leistungsdaten, Normen oder sonstigen Merkmalen geprüft.Falls sie technische oder redaktionelle Fehler enthält, behalten wir uns das Recht vor, Änderungen jederzeitund ohne Ankündigung vorzunehmen.Aus den Angaben, Abbildungen und Beschreibungen in dieser Dokumentation können keine Ansprüche aufÄnderung bereits gelieferter Produkte geltend gemacht werden.

MarkenBeckhoff®, TwinCAT®, EtherCAT®, Safety over EtherCAT®, TwinSAFE®, XFC®und XTS® sind eingetrageneund lizenzierte Marken der Beckhoff Automation GmbH.Die Verwendung anderer in dieser Dokumentation enthaltenen Marken oder Kennzeichen durch Dritte kannzu einer Verletzung von Rechten der Inhaber der entsprechenden Bezeichnungen führen.

PatenteDie EtherCAT Technologie ist patentrechtlich geschützt, insbesondere durch folgende Anmeldungen undPatente:EP1590927, EP1789857, DE102004044764, DE102007017835mit den entsprechenden Anmeldungen und Eintragungen in verschiedenen anderen Ländern.

Die TwinCAT Technologie ist patentrechtlich geschützt, insbesondere durch folgende Anmeldungen undPatente:EP0851348, US6167425 mit den entsprechenden Anmeldungen und Eintragungen in verschiedenenanderen Ländern.

EtherCAT® ist eine eingetragene Marke und patentierte Technologie lizensiert durch die BeckhoffAutomation GmbH, Deutschland

Copyright© Beckhoff Automation GmbH & Co. KG, Deutschland.Weitergabe sowie Vervielfältigung dieses Dokuments, Verwertung und Mitteilung seines Inhalts sindverboten, soweit nicht ausdrücklich gestattet.Zuwiderhandlungen verpflichten zu Schadenersatz. Alle Rechte für den Fall der Patent-, Gebrauchsmuster-oder Geschmacksmustereintragung vorbehalten.


Vorwort

1.2 Sicherheitshinweise

SicherheitsbestimmungenBeachten Sie die folgenden Sicherheitshinweise und Erklärungen!Produktspezifische Sicherheitshinweise finden Sie auf den folgenden Seiten oder in den Bereichen Montage,Verdrahtung, Inbetriebnahme usw.

HaftungsausschlussDie gesamten Komponenten werden je nach Anwendungsbestimmungen in bestimmten Hard- und Software-Konfigurationen ausgeliefert. Änderungen der Hard- oder Software-Konfiguration, die über diedokumentierten Möglichkeiten hinausgehen, sind unzulässig und bewirken den Haftungsausschluss derBeckhoff Automation GmbH & Co. KG.

Qualifikation des PersonalsDiese Beschreibung wendet sich ausschließlich an ausgebildetes Fachpersonal der Steuerungs-,Automatisierungs- und Antriebstechnik, das mit den geltenden Normen vertraut ist.

Erklärung der SymboleIn der vorliegenden Dokumentation werden die folgenden Symbole mit einem nebenstehendenSicherheitshinweis oder Hinweistext verwendet. Die Sicherheitshinweise sind aufmerksam zu lesen undunbedingt zu befolgen!

GEFAHR

Akute Verletzungsgefahr!Wenn der Sicherheitshinweis neben diesem Symbol nicht beachtet wird, besteht unmittel-bare Gefahr für Leben und Gesundheit von Personen!

WARNUNG

Verletzungsgefahr!Wenn der Sicherheitshinweis neben diesem Symbol nicht beachtet wird, besteht Gefahr fürLeben und Gesundheit von Personen!

VORSICHT

Schädigung von Personen!Wenn der Sicherheitshinweis neben diesem Symbol nicht beachtet wird, können Personengeschädigt werden!

Achtung

Schädigung von Umwelt oder GerätenWenn der Hinweis neben diesem Symbol nicht beachtet wird, können Umwelt oder Gerätegeschädigt werden.

Hinweis

Tipp oder FingerzeigDieses Symbol kennzeichnet Informationen, die zum besseren Verständnis beitragen.


Übersicht

2 ÜbersichtDie TwinCAT 3 Function TF6300 FTP bietet Ihnen die Möglichkeit, einen FTP-Client in der TwinCAT SPS zuimplementieren, um dadurch über das standardisierte File Transfer Protocol (FTP) mit einem FTP Server zukommunizieren, zum Beispiel um Dateien zu übertragen. Die Nutzung dieser Funktionalität erfolgt hierbeiüber Funktionsbausteine direkt aus einem SPS-Programm.

Die folgenden Funktionen stehen zur Verfügung:

Verbindungsaufbau:• Authentifizierung an einem FTP-Server• Verbindungsaufbau über aktives FTP (ab Version 1.0.8)• Verbindungsaufbau über passives FTP

Datei-Übertragungsfunktionen:• Hochladen von Dateien zu einem FTP-Server• Herunterladen von Dateien von einem FTP-Server

Dateifunktionen:• Umbenennen von Dateien auf einem FTP-Server• Löschen von Dateien auf einem FTP-Server• Suchen nach Dateien auf einem FTP-Server• Verzeichnisse auf einem FTP-Server erstellen• Verzeichnisse von einem FTP-Server löschen

Alle Funktionalitäten können mit Hilfe von Funktionsblöcken direkt aus der SPS heraus aufgerufen werden.Es können mehrere Verbindungen zu unterschiedlichen Servern aufgebaut werden, die jeweils durchsogenannte "Handles" unterschieden und benutzt werden können. Hierdurch müssen Sie zum Beispiel nichtbei jeder Dateiübertragung alle Verbindungspezifischen Parameter (z.B. IP-Adresse und Port des Servers,Anmeldedaten, etc.) mit angeben, sondern sich lediglich auf das "Handle" beziehen.

Es wird empfohlen sich im Rahmen dieser Dokumentation nun mit den folgenden Artikeln zu beschäftigen:


Übersicht

Artikel InhaltSystemvoraussetzungen [} 9] Beschreibt die Systemvoraussetzungen für den

TwinCAT FTP Client.Installation Installationsanleitung des TwinCAT FTP Client.Lizensierung Anleitung zur Lizensierung des TwinCAT FTP Client.Grundlagen zum File Transfer Protocol (FTP) [} 17] Wichtiger Grundlagenartikel. Beschreibt den Aufbau

von FTP und erläutert kurz dessen Spezifikation.Konfiguration der Data-Ports für aktives FTP [} 18] Beschreibt eine Möglichkeit die zu verwendenden

Data-Ports des TwinCAT FTP Client bei Verwendungvon aktivem FTP fest zu definieren

Aktivierung einer Fehlerprotokolldatei [} 20] Beschreibt wie eine Protokolldatei zur Diagnoseaktiviert werden kann.

Übersicht über Funktionsbausteine [} 22] Bietet eine Übersicht über alle SPSFunktionsbausteine des TwinCAT FTP Client.

Beispiele [} 47] Übersicht über alle verfügbaren Beispiele inkl.Download.

Desweiteren finden Sie in dem Kapitel "Beispiele " diverse SPS-Programme, welche die Benutzung desTwinCAT FTP Client veranschaulichen.

Voraussetzungen

Entwicklungsumgebung Zielplattform Einzubindende SPS-BibliothekenTwinCAT v3.0 Build 3102 PC oder CX (x86) Tc2_FTP


Installation

3 Installation

3.1 SystemvoraussetzungenEs gelten die folgenden Systemvoraussetzungen:

Betriebssysteme:

• Windows XP Pro SP3• Windows 7 Pro (32-bit)• Windows XP Embedded• Windows Embedded Standard 2009• Windows Embedded Standard 7

TwinCAT:

• TwinCAT 3 XAR Build 3102 (oder höher)• TwinCAT 3 XAE Build 3102 (oder höher)• Sonstiges:• .NET Framework 2.0 SP1

3.2 InstallationDie Installation der TwinCAT 3 Function für Windows basierte Betriebssysteme erfolgt Schritt-für-Schritt.

1. Führen Sie einen Doppelklick auf die herunter geladene Datei „TFxxxx" aus.Hinweis: Bitte starten Sie die Installation unter Windows per „Als Administrator ausführen", indem Siedie Setup-Dateien mit der rechten Maus anklicken und die entsprechende Option im Kontextmenüauswählen.

2. Klicken Sie auf „Next" und akzeptieren Sie dann die Endbenutzervereinbarung


Installation

3. Geben Sie Ihre Benutzerdaten ein.

4. Für eine vollständige Installation wählen Sie „Complete" als Installationstyp. Alternativ können Sie jedeKomponente separat installieren, indem Sie "Custom" wählen.


Installation

5. Wählen Sie „Next“ und „Install" um die Installation zu beginnen.

Das TwinCAT System muss gestoppt werden um mit der Installation fortzufahren.

6. Bestätigen Sie den Dialog mit „Yes“


Installation

7. Wählen Sie „Finish" um das Setup zu beenden.

ð Damit ist die Installation abgeschlossen.

Der nächste Schritt nach einer erfolgreichen Installation ist die Lizensierung der TC3 Function [} 12].

3.3 LizensierungDie TwinCAT 3 Function ist zusätzlich zur Vollversion auch in einer 7-Tage Testversion freischaltbar. BeideLizenztypen sind über TwinCAT XAE aktivierbar. Weitere Information zum TwinCAT 3Lizensierungsverfahren finden Sie im TwinCAT 3 Hilfesystem. Das folgende Dokument beschreibt denLizensierungsvorgang einer TwinCAT 3 Function und gliedert sich dabei in die folgenden beidenUnterkapitel:

• Lizensierung einer 7-Tage Testversion [} 12]

• Lizensierung einer Vollversion [} 13]

Lizensierung einer 7-Tage Testversion1. Starten Sie TwinCAT XAE2. Öffnen Sie ein bestehendes TwinCAT 3 Projekt, oder legen Sie ein neues Projekt an3. Navigieren Sie im “Solution Explorer” zum Eintrag „System\License“


Installation

4. Öffnen Sie die Registerkarte „Manage Licenses" und fügen Sie eine „Runtime License" für IhrProdukt hinzu (in diesem Screenshot „TE1300: TC3 Scope View Professional")

5. Optional : Möchten Sie die Lizenz für ein Remote Gerät hinzufügen, müssen Sie sich zunächst mitdiesem Gerät über die TwinCAT XAE Toolbar verbinden

6. Aktivieren Sie in der Registerkarte „Order Information" über den Button „Activate 7 Days TrialLicense..." eine Testversion

7. Starten Sie im Anschluss daran das TwinCAT 3 System einmal neu

Lizensierung einer Vollversion8. Starten Sie TwinCAT XAE9. Öffnen Sie ein bestehendes TwinCAT 3 Projekt oder legen Sie ein neues Projekt an


Installation

10. Navigieren Sie im "Solution Explorer" zum Eintrag „SYSTEM/License"

11. Öffnen Sie die Registerkarte „Manage Licenses" und fügen Sie eine „Runtime License" für IhrProdukt hinzu (in diesem Screenshot " TE1300: TC3 Scope View Professional ").

12. Optional: Möchten Sie die Lizenz für ein Remote Gerät hinzufügen, müssen Sie sich zunächst mitdiesem Gerät über die TwinCAT XAE Toolbar verbinden

13. Öffnen Sie die Registerkarte „Order Information"Die Felder „System-ID" und „HW Platform" können nicht geändert werden, sie beschreiben die zulizensierende Plattform. Generell wird eine TwinCAT 3 Lizenz an zwei Kennzahlen gebunden:Die „System-ID" identifiziert Ihr Gerät eindeutig.Die „HW Platform" ist eine Kennzahl für die Performanz des Gerätes.

14. Tragen Sie optional eine eigene Bestellnummer und einen Kommentar für Ihre Zwecke ein


Installation

15. Generieren Sie in der Registerkarte „Order Information" über den Button „Generate LicenseRequest File..." eine Lizenzanforderungs-Datei, die durch einen Beckhoff-Lizenzserver validiert wird(wenn Ihnen Ihre „Beckhoff License ID“ nicht bekannt ist, wenden Sie sich an Ihren Ansprechpartneraus dem Beckhoff Vertrieb).

16. Nachdem Sie das „License Request File“ gespeichert haben, fragt das System, ob die Datei per Mail anden Beckhoff Lizenz Server geschickt werden soll:

17. Wenn Sie den Dialog mit „Yes" bestätigen, öffnet sich Ihr Standard E-Mail Client und erzeugt eine neueE-Mail für „[email protected]", die das „License Request File" enthält

18. Senden Sie diesen Activation Request an BeckhoffHINWEIS! das „License Response File“ wird an die dieselbe E-Mail Adresse versendet, die das

„License Request File“ verschickt hat19. Kurz darauf erhalten Sie vom Beckhoff-Lizenzserver eine Lizenzdatei,

importieren Sie sie über den Button „Activate License Response File...“, um das Produkt zu aktivieren


mailto:[email protected]

Installation

20. Wählen Sie in Ihrem Ordnersystem das erhaltene „License Response File" aus

21. Das „License Response File" wird importiert und alle enthaltenen Lizenzen werden aktiviert, sämtlichebetroffenen Demo-Lizenzen werden entfernt

22. Starten Sie TwinCAT neu, um die Lizenz zu aktivieren

HINWEIS! Das Lizenzfile wird automatisch auf Ihre lokale Festplatte unter „...\TwinCAT\3.1\Target\License" kopiert.


Konfiguration

4 Konfiguration

4.1 Grundlagen zum File Transfer Protocol (FTP)Dieses Kapitel der Dokumentation erklärt einige Grundlagen zum File Transfer Protocol und bietet einenguten Einstieg in die Materie, sowie Links zu weiterführender Dokumentation.

AllgemeinesDas File Transfer Protocol (FTP) basiert ausschliesslich auf TCP-basierten Kommunikationsverbindungen.FTP spezifiziert zwei TCP-Ports, welche für die Datenübertragung wichtig sind:

• Port 20/tcp: Dieser Port wird auch als Data-Port bezeichnet und dient zum Senden/Empfangen vonDateien und Verzeichnislisten.

• Port 21/tcp: Dieser Port wird allgemein auch als Command-Port bezeichnet und dient zum Austauschvon Statusinformationen zwischen Client und Server.

Zum Senden und Empfangen von Dateien (Data-Port) sowie zur Übertragung von Kommandos (Command-Port) wird jeweils eine separate TCP-Verbindung verwendet. FTP kennt für den Aufbau solcherVerbindungen zwei Verbindungsmodi: "Aktives FTP" und "Passives FTP". Abhängig vom jeweiligenVerbindungsmodus werden die beiden oben genannten Ports unterschiedlich initiiert, was im Folgendennäher beschrieben werden soll.

Hinweis: Der TwinCAT FTP Client unterstützt ab Version 1.0.8 beide Verbindungsmodi. Bei älterenVersionen wird nur "Passives FTP" unterstützt. Die Auswahl des Verbindungsmodus erfolgt z.B. imFunktionsbaustein FB_FTP_OpenEx [} 25] über den Eingangsparameter eMode vom Typ E_FTP_ConnMode[} 45].

Aktives FTPBeim aktiven FTP verbindet sich der Client mit dem Command-Port des FTP-Servers. Als Quell-Portverwendet der Client hierbei einen zufälligen Port N, z.B. 4242/tcp. Anschliessend lauscht der Client auf PortN+1 und teilt diesen Port dann dem Server mit. Der Server verbindet sich dann mit dem Client auf Port N+1und verwendet hierbei als Quell-Port seinen Data-Port.

Ein Problem beim aktiven FTP ist, dass der Client selbst keine Verbindung zum Data-Port des Serversherstellt, sondern dem Server einen Port (N+1) mitteilt und dieser sich dann über seinen Data-Port mit demClient verbindet. Im Falle von Firewalls oder NAT-Geräten, welche vor den Client geschaltet wurden, könntedies also mit zusätzlichem Konfigurationsaufwand auf Client-Seite verbunden sein, da der Data-Port desClients hinter der Firewall ja für den Server erreichbar sein muss (vgl. Bild "Connect 4243"). Die zuverwendenden Data-Ports des TwinCAT FTP-Clients lassen sich fest definieren, was die Firewall-Konfiguration wesentlich vereinfacht. Hierzu existieren diverse Registry Keys zur Konfiguration der Data-Ports für aktives FTP [} 18].


Konfiguration

Passives FTPDiese Technik wird eingesetzt, wenn der Client für den Server nicht direkt erreichbar ist. Dies istbeispielsweise der Fall, wenn der Client sich hinter einer Firewall befindet, welche die Adresse des Clientsmittels NAT umschreibt. Beim passiven FTP initiiert der FTP-Client eine Verbindung über zwei zufällige TCP-Ports N (Command-Port) und N+1 (Data-Port). Der erste Port wird verwendet, um sich mit dem Command-Port des Servers zu verbinden. Anstelle dass der Client nun jedoch seinen Port N+1 dem Server mitteilt,damit der Server eine Verbindung dahin öffnen kann (vgl. aktives FTP), übermittelt der Client nun zunächstdas sogenannte PASV-Kommando. Der Server weiß nun, dass es sich um eine Verbindung via passivemFTP handelt. Als Resultat öffnet der Server einen (zufälligen) Port P als Data-Port und übermittelt diesendem Client. Der Client initiiert dann eine Verbindung mit dem Port P und benutzt hierbei als Quell-Portseinen Port N+1 (Data-Port). Diese Verbindung wird dann benutzt um die Daten zu übertragen.

Bei näherer Betrachtung erkennt man, dass sich das Firewall-Problem des aktiven FTP beim passiven FTPgenau anders herum verhält. Server-seitig muss die Firewall so konfiguriert werden, dass der Data-Port desServers entsprechend für den Client erreichbar ist. Viele FTP-Server bieten dazu die Möglichkeit, die zuverwendenden Data-Ports zu konfigurieren, so zum Beispiel auch der Microsoft IIS, wie im entsprechendenKnowledgeBase Artikel zum Passiven FTP im IIS beschrieben ist.

Quellen

Wikipedia: File Transfer Protocol URL: http://de.wikipedia.org/wiki/File_Transfer_Protocol Stand: 10. April2011

Microsoft Technet: About Active and Passive FTP Connections: http://technet.microsoft.com/en-us/library/cc973739(v=bts.10).aspx Stand: 04.01.2012

Voraussetzungen


4.2 Konfiguration der Data-Ports für aktives FTPBeim aktiven FTP Verbindungsmodus wird der Data-Port für die Verbindung mit dem FTP-Server vom Clientaus vorgegeben und der Server verbindet sich mit diesem Port. Soll der TwinCAT FTP Client im aktiven FTPModus betrieben werden, kann ein Portbereich definiert werden, aus dem ein freier Port für denVerbindungsaufbau verwendet werden soll.

Das Einstellen des Portbereiches erfolgt über die folgenden drei Registrykeys.


http://support.microsoft.com/kb/555022

http://de.wikipedia.org/wiki/File_Transfer_Protocol

http://technet.microsoft.com/en-us/library/cc973739(v=bts.10).aspx

http://technet.microsoft.com/en-us/library/cc973739(v=bts.10).aspx

Konfiguration

"HKEY_LOCAL_MACHINE\\Software\\Beckhoff\\TwinCAT FTP Client\\Configuration\ACTIVE_PortRangeEnabled" "HKEY_LOCAL_MACHINE\\Software\\Beckhoff\\TwinCAT FTP Client\\Configuration\ACTIVE_MaxPort" "HKEY_LOCAL_MACHINE\\Software\\Beckhoff\\TwinCAT FTP Client\\Configuration\ACTIVE_MinPort"

Zum Aktivieren des Portbereiches muss der Registrykey "ACTIVE_PortRangeEnabled" zunächst auf 1gesetzt werden. Andernfalls wird der TwinCAT FTP Client einen beliebigen freien Port für denVerbindungsaufbau verwenden.

Mit den Registrykeys "ACTIVE_MaxPort" und "ACTIVE_MinPort" können die obere bzw. untere Grenze desPortbereiches definiert werden.

Hinweis: Um mehrere gleichzeitige FTP-Verbindungen zu ermöglichen, muss der Portbereich entsprechendgroß gewählt werden. Beispiel: Soll sich der TwinCAT FTP Client gleichzeitig mit drei FTP-Servernverbinden und über jede Verbindung eine Dateiübertragung starten, so muss der Portbereich mindestens 3Ports beinhalten.

Abb. 1: RegKey2

Voraussetzungen



Konfiguration

4.3 Aktivierung einer FehlerprotokolldateiUm auftretende Fehler besser lokalisieren zu können und im Fehlerfall eine bessere Beschreibung zuerhalten, bietet der TwinCAT FTP Client die Möglichkeit, auftretende Fehler in einer Textdatei zuprotokollieren.

Die Textdatei mit dem Namen "TcFTPErrorLog.txt" wird immer in dem Ordner erzeugt, in dem auch die"EXE" des TwinCAT FTP Clients liegt.

Sie können diese Funktionalität durch das Erzeugen des folgenden Registry Keys aktivieren:

"HKEY_LOCAL_MACHINE\\Software\\Beckhoff\\TwinCAT FTP Client\\Configuration\ErrorLog"

Mit dem Wert 0 wird die Funktionalität nach einem Restart des TwinCAT Systems gestoppt.

Mit dem Wert 1 wird die Funktionalität nach einem Restart des TwinCAT Systems gestartet und eineeinfache Fehlerprotokollierung wird durchgeführt.

Mit dem Wert 2 wird die Funktionalität nach einem Restart des TwinCAT Systems gestartet und eineerweiterte Fehlerprotokollierung wird durchgeführt.

Achtung

Schädigung des FlashmediumsDas zyklische Schreiben auf das Flashmedium kann dieses beschädigen. Des Weiterenbesteht die Möglichkeit, dass der Speicher des Flashmediums durch das zyklische Schrei-ben voll geschrieben wird.

Achtung

Schädigung des FlashmediumsDas Fehlerloggen nur beim Testen verwenden!


Konfiguration

Voraussetzungen



SPS-Bibliotheken

5 SPS-Bibliotheken

5.1 Tc2_FTP

ÜbersichtDie Tc2_FTP Bibliothek beinhaltet Funktionsblöcke zum Steuern und Konfigurieren des TwinCAT FTPClients.

Funktionsblöcke

Name BeschreibungFB_GetStateTcFTPClient [} 42] Statusinformationen abrufen.

FB_FTP_HostResolve [} 23] Löst den angegebenen Hostnamen auf und gibt dieentsprechende IPv4 Adresse aus

FB_FTP_Open [} 24] Öffnet eine Verbindung zu einem FTP Server(Passiv)

FB_FTP_OpenEx [} 25] Öffnet eine Verbindung zu einem FTP Server(Passive / Aktiv)

FB_FTP_Close [} 26] Schließt eine Verbindung zu einem FTP Server

FB_FTP_CloseAll [} 27] Schließt alle Verbindungen zu einem FTP Server

FB_FTP_Info [} 28] Gibt Informationen von den geöffneten Verbindungenzurück

FB_FTP_FileUpload [} 29] Kopiert eine Quelldatei auf einen FTP Server übereine bereits geöffnete Verbindung

FB_FTP_FileUploadEx [} 30] Kopiert eine Quelldatei auf einen FTP Server

FB_FTP_FileDownload [} 32] Kopiert eine Quelldatei von einem FTP Server aufeinen Zielrechner über eine bereits geöffneteVerbindung

FB_FTP_FileDownloadEx [} 33] Kopiert eine Quelldatei von einem FTP Server

FB_FTP_DirCreate [} 34] Erzeugt ein Verzeichnis auf einen FTP Server

FB_FTP_DirRemove [} 35] Löscht ein Verzeichnis von einem FTP Server

FB_FTP_FileList [} 36] Liest Datei- und Ordnernamen vom FTP Server undgibt sie als Array zurück.

FB_FTP_FileListEx [} 37] Liest Datei- und Ordnernamen mit zusätzlichenDetailinformationen vom FTP Server und gibt sie alsArray zurück.

FB_FTP_FileExist [} 39] Überprüft ob eine bestimmte Datei auf dem FTPServer existiert

FB_FTP_FileRemove [} 40] Löscht eine Datei vom FTP Server

FB_FTP_FileRename [} 41] Benennt eine Datei auf dem FTP Server um

Funktionen

Name BeschreibungF_GetVersionTcFTPClient [} 43] Versionsinformationen abrufen.


SPS-Bibliotheken

Datentypen

Name BeschreibungT_HFTP [} 44] Handle des FTP Servers.

ST_FTP_ConnInfo [} 44] Informationen einer bestehenden FTP Verbindung.

ST_FTP_FileDetails [} 45] Dateiinformationen zurückgeliefert vom FTP "LIST"Kommando.

E_FTP_ConnMode [} 45] FTP Verbindungsarten (Passiv / Aktiv).

Voraussetzungen


5.2 Funktionsbausteine

5.2.1 FB_FTP_HostResolve

Mit dem Funktionsbaustein FB_FTP_HostResolve können Hostnamen von FTP Servern aufgelöst werden.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; sHostname : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR

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

sHostname : Hostname der in die dazugehörige IPv4 Adresse aufgelöst werden soll.

bExecute : Mit der steigende Flanke wird der Funktionsblock ausgeführt.

tTimeout : Gibt die Timeout-Zeit an.

VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT; sIPv4Addr : T_IPv4Addr;END_VAR


SPS-Bibliotheken

bBusy : Kommando wird gerade per ADS übertragen. Solange bBusy auf TRUE, wird kein neuesKommando angenommen.

bError : Wird TRUE, sobald ein Fehler eintritt.

nErrID : Liefert bei einem gesetzten bError-Ausgang den dazugehörigen Fehlercode [} 55].

sIPv4Addr : Liefert die passende IPv4 Adresse zum angegebenen Hostnamen zurück.

Voraussetzungen


5.2.2 FB_FTP_Open

Mit dem Funktionsbaustein FB_FTP_Open kann eine Verbindung zu einem FTP-Server hergestellt werden.Mit dem zurück gelieferten Handle können dann weitere Aktionen am FTP-Server durchgeführt werden. Dieverwendete Verbindungsart ist Passives-FTP.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; sHost : T_IPv4Addr := '127.0.0.1'; nPort : UDINT := 21; sUsername : STRING := ''; sPassword : STRING := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR


sHost : Ist ein String, der die IPv4 Adresse des FTP-Server enthält.

nPort : FTP Port (default 21).

sUsername : Benutzername für FTP Server Authentifizierung

sPassword : Passwort für FTP Server Authentifizierung

bExecute : Mit der steigenden Flanke wird der Funktionsblock ausgeführt.



SPS-Bibliotheken

VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT; hFTP : T_HFTP;END_VAR




hFTP : Handle der FTP-Verbindung

Voraussetzungen


Sehen Sie dazu auch2 T_HFTP [} 44]

5.2.3 FB_FTP_OpenEx

Mit dem Funktionsbaustein FB_FTP_OpenEx kann eine Verbindung zu einem FTP-Server hergestelltwerden. Mit dem zurück gelieferten Handle können dann weitere Aktionen am FTP-Server durchgeführtwerden. Zusätzlich kann die Verbindungsart, Passives oder Aktives FTP, ausgewählt werden.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; sHost : T_IPv4Addr := '127.0.0.1'; nPort : UDINT := 21; eMode : E_FTP_ConnMode := eConnMode_PASSIVE; sUsername : STRING := ''; sPassword : STRING := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR

E_FTP_ConnMode [} 45]


SPS-Bibliotheken




eMode : FTP Verbindungsart (Aktiv / Passiv).





VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT; hFTP : T_HFTP;END_VAR




hFTP : Handle der FTP-Verbindung

Voraussetzungen



5.2.4 FB_FTP_Close

Mit dem Funktionsbaustein FB_FTP_Close kann eine bestehende Verbindung zu einem FTP-Servergeschlossen werden.


SPS-Bibliotheken

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR


hFTP : Handle des FTP Servers.



VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT;END_VAR




Voraussetzungen



5.2.5 FB_FTP_CloseAll

Mit dem Funktionsbaustein FB_FTP_CloseAll können alle bestehenden Verbindungen zu einem FTP-Servergeschlossen werden.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; bExecute : BOOL;


SPS-Bibliotheken

tTimeout : TIME := T#15s;END_VAR








Voraussetzungen


5.2.6 FB_FTP_Info

Mit dem Funktionsbaustein FB_FTP_Info können Informationen zu den erzeugten FTP-Server-Verbindungenabgerufen werden.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; pList : POINTER TO ST_FTP_ConnInfo; cbList : UDINT := 0; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR


pList : Pointer Adresse zu einer Variablen vom Typ ST_FTP_ConnInfo. Diese Variable kann auch ein Arrayvom Typ ST_FTPConnInfo sein.


SPS-Bibliotheken


tTimeout : Gibt die Timeoutzeit an.

VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT; nEntries : UDINT;END_VAR




nEntries : Anzahl der bestehenden Verbindungen.

Voraussetzungen


Sehen Sie dazu auch2 ST_FTP_ConnInfo [} 44]

5.2.7 FB_FTP_FileUpload

Mit dem Funktionsbaustein FB_FTP_FileUpload können Dateien vom ADS-Device auf einen FTP-Serverübermittelt werden. Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP-Server

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP; sSrcFile : T_MaxString := ''; sDesFile : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR



SPS-Bibliotheken


sSrcFile : Quelldatei die auf den FTP Server kopiert werden soll

sDesFile : Zieldateiname mit Pfadangabe



VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT; nProgress : UDINT;END_VAR



nErrID : Liefert bei einem gesetzten bError-Ausgang den ADS Error Code.

nProgress : Zeigt den aktuellen Status der Übermittlung in Prozent an.

Voraussetzungen


Sehen Sie dazu auch2 T_HFTP [} 44]2 Übersicht der Fehlercodes des TwinCAT FTP Client [} 55]

5.2.8 FB_FTP_FileUploadEx

Mit dem Funktionsbaustein FB_FTP_FileUploadEx können Dateien vom ADS-Device auf einen FTP-Serverübermittelt werden. Die verwendete Verbindungsart ist Passives-FTP.


SPS-Bibliotheken

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; sHost : T_IPv4Addr := '127.0.0.1'; nPort : UDINT := 21; sUsername : STRING := ''; sPassword : STRING := ''; sSrcFile : T_MaxString := ''; sDesFile : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR


sHost : Ist ein String, der die IPv4 Adresse des FTP-Servers enthält.




sSrcFile : Quelldatei die auf den FTP Server kopiert werden soll








nProgress : Zeigt den aktuellen Status der Übermittlung in Prozent an.

Voraussetzungen



SPS-Bibliotheken

5.2.9 FB_FTP_FileDownload

Mit dem Funktionsbaustein FB_FTP_FileDownload können Dateien vom FTP-Server auf ein ADS-Deviceübermittelt werden. Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP Server.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP sSrcFile : T_MaxString := ''; sDesFile : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR



sSrcFile : Quelldatei, die vom FTP Server kopiert werden soll








nProgress : Zeigt den aktuellen Status der Übermittlung in Prozent an. Bei CE FTP Server werden keineZwischenwerte zurückgeliefert nur 0% und 100%.

Voraussetzungen



SPS-Bibliotheken


5.2.10 FB_FTP_FileDownloadEx

Mit dem Funktionsbaustein FB_FTP_FileDownloadEx können Dateien von einem FTP-Server auf ein ADS-Device übermittelt werden. Die verwendete Verbindungsart ist Passives-FTP.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; sHost : T_IPv4Addr := '127.0.0.1'; nPort : UDINT := 21; sUsername : STRING := ''; sPassword : STRING := ''; sSrcFile : T_MaxString := ''; sDesFile : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR






sSrcFile : Quelldatei, die vom FTP Server kopiert werden soll








SPS-Bibliotheken


nProgress : Zeigt den aktuellen Status der Übermittlung in Prozent an. Bei CE FTP Server werden keineZwischenwerte zurückgeliefert nur 0% und 100%.

Voraussetzungen


5.2.11 FB_FTP_DirCreate

Mit dem Funktionsbaustein FB_FTP_DirCreate können Verzeichnisse auf einen FTP-Server erstellt werden.Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP-Server.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP := 0; sDirName : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR



sDirectory : Der Name des zu erstellenden Verzeichnisses.








SPS-Bibliotheken

Voraussetzungen



5.2.12 FB_FTP_DirRemove

Mit dem Funktionsbaustein FB_FTP_DirRemove können Verzeichnisse vom FTP-Server gelöscht werden.Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP-Server.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP; sDirectory : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR



sDirectory : Der Name des Verzeichnisses, welches gelöscht werden soll.








SPS-Bibliotheken

Voraussetzungen



5.2.13 FB_FTP_FileList

Mit dem Funktionsbaustein FB_FTP_FileList können Datei- und Ordnernamen vom FTP-Server gelesenbzw. gesucht werden. Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP-Server

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP; sMask : T_MaxString := ''; nIndex : UDINT; pList : POINTER TO ARRAY [0..MAX_FILELIST_ITEMS] OF STRING(80); cbList : UDINT; bExecute : BOOL; tTimeout : TIME := T#20s;END_VAR



sMask : Suchmaske zum Filtern entsprechender Dateien.

Beispiel*.* Liest alle Dateien aus* Liest alle Dateien und alle Ordnernamen aus*.txt Liest alle Dateien mit der Endung "TXT" aus\Test\*.* Liest alle Dateien aus dem Unterordner Test aus

nIndex : Gibt den Index des ersten zu lesenden Dateinamens an

pList : Gibt die Adresse des Stringarrays an in das die Dateinamen geschrieben werden soll

cbList : Gibt die Größe des Stringarrays in Byte an


SPS-Bibliotheken



VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT; nItems : UDINT;END_VAR




nItems : Liefert die Gesamtanzahl der Dateilisteinträge zurück.

Voraussetzungen


Sehen Sie dazu auch2 T_HFTP [} 44]2 Übersicht der Fehlercodes des TwinCAT FTP Client [} 55]

5.2.14 FB_FTP_FileListEx

Mit dem Funktionsbaustein FB_FTP_FileListEx können Datei- und Ordnernamen vom FTP-Server gelesenbzw. gesucht werden. Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP-Server. ImGegensatz zu dem Baustein FB_FTP_FileList werden auch Details zu den Dateien/Ordnern zurückgeliefert.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP; sMask : T_MaxString := ''; bRawValues : BOOL; nIndex : UDINT; pList : UDINT; cbList : UDINT;


SPS-Bibliotheken

bExecute : BOOL; tTimeout : TIME := T#20s;END_VAR



sMask : Suchmaske zum Filtern entsprechender Dateien.

Beispiel*.* Liest alle Dateien aus* Liest alle Dateien und alle Ordnernamen aus*.txt Liest alle Dateien mit der Endung "TXT" aus\Test\*.* Liest alle Dateien aus dem Unterordner Test aus

bRawValues : Gibt an in welcher Form die Dateiliste zurückgeliefert werden soll.

bRawValues := TRUE Informationen werden in Form eines T_MaxString Arrays zurückgeliefert.

bRawValues := FALSE Informationen werden in Form eines ST_FTP_FileDetails [} 45] Arrayszurückgeliefert. (Wird nicht von jedem FTP Server unterstützt)

nIndex : Gibt den Index der ersten zu lesenden Datei an

pList : Gibt die Adresse des Arrays an in das die Dateiliste geschrieben werden soll. Maximale Arraygröße256 Elemente.

cbList : Gibt die Größe des Arrays in Byte an



VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT; nItems : UDINT;END_VAR




nItems : Liefert die Gesamtanzahl der Dateilisteinträge zurück.

Voraussetzungen




SPS-Bibliotheken

2 Übersicht der Fehlercodes des TwinCAT FTP Client [} 55]

5.2.15 FB_FTP_FileExist

Mit dem Funktionsbaustein FB_FTP_FileExist kann überprüft werden ob eine bestimmte Datei auf dem FTP-Server vorhanden ist. Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP-Server.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP; sFile : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR



sFile : Dateiname nach dem gesucht wird.


tTimeout : Gibt die Timeout Zeit an.

VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT; bExist : BOOL;END_VAR




bExist : Wird TRUE, wenn die angegebene Datei gefunden wurde.

Voraussetzungen



SPS-Bibliotheken


5.2.16 FB_FTP_FileRemove

Mit dem Funktionsbaustein FB_FTP_FileRemove können Dateien auf einem FTP-Server gelöscht werden.Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP-Server.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP; sFile : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR



sFile : Der Name der Datei, welche gelöscht werden soll.







Voraussetzungen


Sehen Sie dazu auch


SPS-Bibliotheken

2 T_HFTP [} 44]

5.2.17 FB_FTP_FileRename

Mit dem Funktionsbaustein FB_FTP_FileRename können Dateien auf einem FTP-Server umbenanntwerden. Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP-Server.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetId := ''; hFTP : T_HFTP; sOLDFilename : T_MaxString := ''; sNEWFilename : T_MaxString := ''; bExecute : BOOL; tTimeout : TIME := T#15s;END_VAR



sOLDFilename : Der alte Dateiname der zu ändernden Datei.

sNEWFilename : Der neue Dateiname.







Voraussetzungen



SPS-Bibliotheken


5.2.18 FB_GetStateTcFTPClient

Mit dem Funktionsbaustein FB_GetStateTcFTPClient kann der aktuelle Status des FTP Clients abgefragtwerden.

VAR_INPUTVAR_INPUT sNetID : T_AmsNetID; bExecute : BOOL; tTimeout : TIME;END_VAR


bExecute : Mit der steigende Flanke wird das Kommando ausgeführt.

tTimeout : Gibt die Timeoutzeit an.

VAR_OUTPUTVAR_OUTPUT bBusy : BOOL; bError : BOOL; nErrID : UDINT; nAdsState : UINT; nDevState : UINT;END_VAR




nAdsState : Enthält die Zustandskennzahl des ADS-Zielgerätes. Die hier zurück gelieferten Codes sindfestgelegt für alle ADS-Server:

• ADSSTATE_INVALID =0 ;• ADSSTATE_IDLE =1 ;• ADSSTATE_RESET =2 ;• ADSSTATE_INIT =3 ;• ADSSTATE_START =4 ;• ADSSTATE_RUN =5 ;• ADSSTATE_STOP =6 ;• ADSSTATE_SAVECFG =7 ;• ADSSTATE_LOADCFG =8 ;


SPS-Bibliotheken

• ADSSTATE_POWERFAILURE =9 ;• ADSSTATE_POWERGOOD =10 ;• ADSSTATE_ERROR =11;

nDevState : Enthält die spezifische Zustandskennzahl des ADS-Zielgerätes. Die hier zurück geliefertenCodes sind Zusatzinformationen, die für das ADS-Gerät spezifisch sind.

• 1 = TwinCAT FTP Client gestartet

Voraussetzungen


5.3 Funktionen [veraltet]

5.3.1 F_GetVersionTcFTPClient

Mit dieser Funktion können Versionsinformationen der SPS-Bibliothek ausgelesen werden.

FUNCTION F_GetVersionTcFTPClient: UINTVAR_INPUT nVersionElement : INT;END_VAR

nVersionElement : Versionselement, das gelesen werden soll. Mögliche Parameter:

• 1 : major number;• 2 : minor number;• 3 : revision number;

Voraussetzungen



SPS-Bibliotheken

5.4 Datentypen

5.4.1 T_HFTP

VAR_INPUTTYPE T_HFTP :STRUCT hClient :UDINT;END_STRUCTEND_TYPE

hClient : Gibt den Handle der FTP Verbindung an.

Voraussetzungen


5.4.2 ST_FTP_ConnInfo

VAR_INPUTTYPE ST_FTP_ConnInfo :STRUCT sHost : T_IPv4Addr; nPort : UDINT; hFTP : T_HFTP; sUsername : STRING;END_STRUCTEND_TYPE

sHost : Gibt die IP-Adresse des FTP Servers an.

nPort : Gibt den Port der FTP Verbindung an.

hFTP : Gibt den Handle der FTP Verbindung an.

sUsername : Gibt den Namen des angemeldeten Benutzers an.

Voraussetzungen



SPS-Bibliotheken

5.4.3 ST_FTP_FileDetails

VAR_INPUTTYPE ST_FTP_FileDetails:STRUCT bDir : BOOL; sPermission : STRING(10); nSize : UDINT; nFilecode : UDINT; tTimestamp : DT; sOwner : STRING(79); sGroup : STRING(79); sFilename : STRING(79);END_STRUCTEND_TYPE

bDir : Gibt an ob es sich um eine Datei oder ein Verzeichnis handelt. (wird nicht von jedem FTP Serverunterstützt)

sPermission : Gibt die Berechtigungsparameter der Datei/Verzeichnis an. (wird nicht von jedem FTP Serverunterstützt)

nSize : Gibt die Größe der Datei an

nFilecode : Gibt den Dateicode zurück. (wird nicht von jedem FTP Server unterstützt)

tTimstamp : Gibt den Zeitstempel der Datei an.

sOwner : Gibt den Benutzer zurück. (wird nicht von jedem FTP Server unterstützt)

sGroup : Gibt die zugehörige Groupe an. (wird nicht von jedem FTP Server unterstützt)

sFilename : Gibt den Namen der Datei/Verzeichnis an.

Voraussetzungen


5.4.4 E_FTP_ConnModeTYPE E_FTP_ConnMode :(eConnMode_PASSIVE := 0,eConnMode_ACTIVE := 1);END_TYPE

Voraussetzungen



SPS-Bibliotheken

5.5 Konstanten

5.5.1 Konstanten AMSPORT_FTPADSSRV : UINT := 10900;

FTPADS_IGR_CONNOPEN : UDINT := 16#100; FTPADS_IGR_RESOLVEDNS : UDINT := 16#101; FTPADS_IGR_CONNCLOSE : UDINT := 16#200; FTPADS_IGR_CONNCLOSEALL : UDINT := 16#201;

FTPADS_IGR_CONNINFO : UDINT := 16#300;

FTPADS_IGR_FILEUPLOAD : UDINT := 16#10000; FTPADS_IGR_FILEDOWNLOAD : UDINT := 16#20000;

FTPADS_IGR_DIRREMOVE : UDINT := 16#30000; FTPADS_IGR_DIRCREATE : UDINT := 16#30001;

FTPADS_IGR_FILEEXIST : UDINT := 16#40000; FTPADS_IGR_FILERENAME : UDINT := 16#40001; FTPADS_IGR_FILEREMOVE : UDINT := 16#40002; FTPADS_IGR_FILELIST : UDINT := 16#40003; FTPADS_IGR_FILELISTEX : UDINT := 16#40004;

MAX_FTP_CONNECTIONS : UDINT := 25; MAX_FILELIST_ITEMS : UDINT := 255;

DEFAULT_FTP_PORT : UDINT := 21;

Voraussetzungen



Beispiele

6 Beispiele

6.1 BeispieleDie folgende Tabelle gibt eine Übersicht über alle verfügbaren Samples.

Nr. Beispiel1 Hochladen einer Datei auf einen FTP-Server [} 47]2 Herunterladen einer Datei von einem FTP-Server

[} 48]3 Auslesen von Verbindungsinformationen [} 50]4 Löschen einer Datei von einem FTP-Server [} 51]5 Auslesen einer Dateiliste [} 52]

Hinweis:

Die Beispiele stehen zusätzlich als Download in einer TwinCAT 3 Solution zur Verfügung. Die folgendeTabelle bietet Ihnen Download-Links zu dieser Solution, abhängig von der verwendeten TwinCAT 3 Version.

TwinCAT Version Sample download3.0 Download3.1 Download

Voraussetzungen


6.2 TwinCAT FTP Client: Hochladen einer Datei auf einenFTP Server

In diesem Beispiel wird eine Datei von einem ADS-Gerät auf einen FTP Server hochgeladen.

Um dieses Beispiel ausführen zu können, sollten Sie einen Benutzer mit dem Namen "TestUser" und demPasswort "TestPwd123" bei Ihrem FTP Server einrichten. Wenn Sie nun an den Eingang "bExecute" einepositive Flanke anlegen mit Hilfe der Variable "startstop", so wird die Datei "\Program Files\TestFile1.txt" aufden FTP Server geladen. Auf dem Server hat die Datei dann den Namen "\TestFolder\File1.txt". Ist derOrdner "TestFolder" nicht vorhanden wird dieser erzeugt.

Achten Sie darauf, dass der TestUser Schreib- und Leserechte besitzt.

VariablendeklarationPROGRAM MAINVAR FB_FTPFileUpload1 : FB_FTP_FileUploadEx; startstop : BOOL; busy : BOOL; err : BOOL; errid : UDINT; progress : UDINT;END_VAR


http://download.beckhoff.com/download/Software/TwinCAT/TwinCAT3/Samples/TF6300-FTP/Samples30/TF6300-FTP-Samples.zip

http://download.beckhoff.com/download/Software/TwinCAT/TwinCAT3/Samples/TF6300-FTP/Samples31/TF6300-FTP-Samples.zip

Beispiele

SPS ProgrammFB_FTPFileUpload1( sNetID:= , sHost:= '172.16.235.100', nPort:= DEFAULT_FTP_PORT, sUsername:= 'TestUser', sPassword:= 'TestPwd123', sSrcFile:= '\Program Files\TestFile1.txt', sDesFile:= '\TestFolder\File1.txt', bExecute:= startstop, tTimeout:= T#15s, bBusy=> busy, bError=> err, nErrId=> errid, nProgress=> progress);

Für dieses Sample müssen die folgenden Bibliotheken eingebunden werden: Tc2_FTP, Tc2_System,Tc2_Standard, Tc3_Interfaces, Tc3_Modules.

Voraussetzungen


6.3 TwinCAT FTP Client: Herunterladen einer Datei voneinem FTP Server auf ein CX-Gerät

In diesem Beispiel wird eine Datei von einem FTP Server auf ein CX-Gerät heruntergeladen.

Um dieses Beispiel ausführen zu können, sollten Sie einen Benutzer mit dem Namen "TestUser" und demPasswort "TestPwd123" bei Ihrem FTP Server eingerichtet haben.

Mit einer positiven Flanke an der startstop Variablen wird das Herunterladen gestartet. Zunächst wird eineVerbindung zum FTP Server mit dem FB_FTP_Open erzeugt. Danach wird die angegebene Datei,"\TestFolder\File1.txt", mit dem Baustein FB_FTP_Upload vom FTP Server geladen. Der folgende Pfad"\Program Files\TestFile1.txt", ist der Speicherort der Datei auf dem CX.Zum Schluss wird noch die Verbindung zum FTP Server mit dem Baustein FB_FTP_Close geschlossen.


VariablendeklarationPROGRAM MAINVAR RisingEdge : R_TRIG; startstop : BOOL; state : BYTE; FB_FTP_Open1 : FB_FTP_Open; FB_FTP_FileDownload1 : FB_FTP_FileDownload; FB_FTP_Close1 : FB_FTP_Close; busy : BOOL; err : BOOL; errid : UDINT; handle : T_HFTP; progress : UDINT;END_VAR


Beispiele

SPS ProgrammRisingEdge(CLK:= startstop);IF RisingEdge.Q THEN state := 1;END_IF

CASE state OF 0: ;

1: FB_FTP_Open1( sNetID:= '5.0.252.142.1.1', sHost:= '172.16.9.223', nPort:= 21, sUsername:= 'TestUser', sPassword:= 'TestPwd123', bExecute:= TRUE, tTimeout:= T#15s, bBusy=> busy, bError=> err, nErrId=> errid, hFTP=> handle);

IF NOT busy AND NOT err THEN FB_FTP_Open1(bExecute:= FALSE); state := 2; END_IF

2: FB_FTP_FileDownload1( sNetID:= '5.0.252.142.1.1', hFTP:= handle, sSrcFile:= '\TestFolder\File1.txt', sDesFile:= '\Program Files\TestFile1.txt', bExecute:= TRUE, tTimeout:= T#15s, bBusy => busy, bError => err, nErrId => errid, nProgress => progress);

IF NOT busy AND NOT err THEN FB_FTP_FileDownload1(bExecute:= FALSE); state := 3; END_IF

3: FB_FTP_Close1( sNetID:= '5.0.252.142.1.1', hFTP:= handle, bExecute:= TRUE, tTimeout:= T#15s, bBusy => busy, bError => err, nErrId => errid);

IF NOT busy AND NOT err THEN FB_FTP_Close1(bExecute:= FALSE); state := 0; END_IF

END_CASE



Beispiele

Voraussetzungen


6.4 TwinCAT FTP Client: Auslesen derVerbindungsinformationen mit FB_FTP_Info

In diesem Beispiel wird gezeigt, wie Verbindungsinformationen vom TwinCAT FTP Client ausgelesenwerden können.

VariablendeklarationPROGRAM MAINVAR FB_FTP_Info1 : FB_FTP_Info; list : ARRAY [0..5] OF ST_FTP_ConnInfo; startstop : BOOL; busy : BOOL; err : BOOL; errid : UDINT; entries : UDINT;END_VAR

SPS ProgrammFB_FTP_Info1( sNetID:= , pList:= ADR(list), cbList:= SIZEOF(list), bExecute:= startstop, tTimeout:= T#15s, bBusy=> busy, bError=> err, nErrID=> errid, nEntries=> entries);


Im folgenden Bild sehen Sie eine mögliche Ausgabe:

Abb. 2: Info_Sample


Beispiele

Voraussetzungen


6.5 TwinCAT FTP Client: Löschen einer Datei vom FTPServer

In diesem Beispiel wird gezeigt, wie eine Datei vom FTP Server gelöscht wird.

Zunächst wird mit dem Baustein FB_FTP_Open eine Verbindung zum FTP Server hergestellt. Danach wirdüberprüft ob die Datei, welche gelöscht werden soll, überhaupt auf dem FTP Server existiert. Dies geschiehtmit dem Baustein FB_FTP_FileExist. Der Löschvorgang wird mit dem Baustein FB_FTP_FileRemovedurchgeführt. Zum Schluss wird dann nur noch die Verbindung zum Server geschlossen.

Sie starten das Beispiel indem Sie eine Positive Flanke mit der Variablen "startstop" erzeugen.

VariablendeklarationPROGRAM MAINVAR RisingEdge : R_TRIG; startstop : BOOL; state : BYTE; FB_FTP_Open1 : FB_FTP_Open; FB_FTP_FileExist1 : FB_FTP_FileExist; FB_FTP_FileRemove1 : FB_FTP_FileRemove; FB_FTP_Close1 : FB_FTP_Close; busy : BOOL; err : BOOL; errid : UDINT; handle : T_HFTP; exist : BOOL;END_VAR

SPS ProgrammRisingEdge(CLK:=startstop);IF RisingEdge.Q THEN state := 1;END_IF

CASE state OF 0: ; 1: FB_FTP_Open1( sNetID:= , sHost:= '172.16.9.223', nPort:= DEFAULT_FTP_PORT, sUsername:= 'TestUser', sPassword:= 'TestPwd123', bExecute:= TRUE, tTimeout:= T#15s, bBusy=> busy, bError=> err, nErrID=> errid, hFTP=> handle);

IF NOT busy AND NOT err THEN state := 2; FB_FTP_Open1(bExecute:=FALSE); END_IF

2:


Beispiele

FB_FTP_FileExist1( sNetID:= , hFTP:= handle, sFile:= '\TestFolder\File1.txt', bExecute:= TRUE, tTimeout:= T#15s, bBusy=> busy, bError=> err, nErrID=> errid, bExist=> exist);

IF NOT busy AND NOT err THEN IF exist THEN state := 3; ELSE state := 4; END_IF FB_FTP_FileExist1(bExecute:= FALSE); END_IF 3: FB_FTP_FileRemove1( sNetID:= , hFTP:= handle, sFile:= '\TestFolder\File1.txt', bExecute:= TRUE, tTimeout:= T#15s, bBusy=> busy, bError=> err, nErrID=> errid);

IF NOT busy AND NOT err THEN state := 4; FB_FTP_FileRemove1(bExecute:=FALSE); END_IF 4: FB_FTP_Close1( sNetID:= , hFTP:= handle, bExecute:= TRUE, tTimeout:= T#15s, bBusy=> busy, bError=> err, nErrID=> errid);

IF NOT busy AND NOT err THEN state := 0; FB_FTP_Close1(bExecute:=FALSE); END_IFEND_CASE


Voraussetzungen


6.6 TwinCAT FTP Client: Auslesen einer Dateiliste voneinem FTP Server

In diesem Beispiel wird eine Dateiliste von einem FTP Server gelesen.

Um dieses Beispiel ausführen zu können, sollten Sie einen Benutzer mit dem Namen "TestUser" und demPasswort "TestPwd123" bei Ihrem FTP Server eingerichtet haben.


Beispiele

Mit einer positiven Flanke an der startstop Variablen wird eine Dateiliste erzeugt. Zunächst wird eineVerbindung zum FTP Server mit dem FB_FTP_Open erzeugt. Danach werden alle Dateien ausgegeben diedie Endung "*.txt" haben, mit dem Baustein FB_FTP_FileList vom FTP Server geladen. Zum Schluss wirdnoch die Verbindung zum FTP Server mit dem Baustein FB_FTP_Close geschlossen.


VariablendeklarationPROGRAM MAINVAR RisingEdge : R_TRIG; startstop : BOOL; state : BYTE; FB_FTP_Open1 : FB_FTP_Open; FB_FTP_FileList1 : FB_FTP_FileList; FB_FTP_Close1 : FB_FTP_Close; busy : BOOL; err : BOOL; errid : UDINT; handle : T_HFTP; FileList : ARRAY [0..MAX_FILELIST_ITEMS] OF STRING; Items : UDINT;END_VAR

SPS Programm´RisingEdge(CLK:= startstop);IF RisingEdge.Q THEN state := 1;END_IF

CASE state OF 0: ;

1: FB_FTP_Open1( sNetID:= , sHost:= '172.16.9.223', nPort:= 21, sUsername:= 'TestUser', sPassword:= 'TestPwd123', bExecute:= TRUE, tTimeout:= T#15s, bBusy=> busy, bError=> err, nErrId=> errid, hFTP=> handle);

IF NOT busy AND NOT err THEN FB_FTP_Open1(bExecute:= FALSE); state := 2; END_IF

2: FB_FTP_FileList1( sNetID:= , hFTP:= handle, sMask:= '*.txt', nIndex:= 0, pList:= ADR(FileList), cbList:= SIZEOF(FileList), bExecute:= TRUE, tTimeout:= T#15s, bBusy=> busy, bError=> err, nErrID=> errid, nItems=> Items);

IF NOT busy AND NOT err THEN FB_FTP_FileList1(bExecute:= FALSE); state := 3; END_IF

3: FB_FTP_Close1(


Beispiele

sNetID:= , hFTP:= handle, bExecute:= TRUE, tTimeout:= T#15s, bBusy => busy, bError => err, nErrId => errid);

IF NOT busy AND NOT err THEN FB_FTP_Close1(bExecute:= FALSE); state := 0; END_IF

END_CASE


Voraussetzungen



Anhang

7 Anhang

7.1 Return Codes

7.1.1 Übersicht der Fehlercodes des TwinCAT FTP ClientOffset + Fehlercode Bereich Beschreibung0x00000000 + TwinCAT SystemFehler

0x00000000-0x00007800 TwinCAT System Fehler (ADS-Fehlercodes inklusive)

0x00008000 + Interner TwinCATFTP Client Fehler [} 59]

0x00008000-0x000081C4 Interne Fehler des TwinCAT FTPClients

Voraussetzungen


7.1.2 ADS Return CodesFehlercode: 0x000 [} 55]..., 0x500 [} 56]..., 0x700 [} 56]..., 0x1000 [} 58]......

Globale Fehlercodes


Anhang

Hex Dec Beschreibung0x0 0 Kein Fehler0x1 1 Interner Fehler0x2 2 Keine Echtzeit0x3 3 Zuweisung gesperrt-Speicherfehler0x4 4 Postfach voll0x5 5 Falsches HMSG0x6 6 Ziel-Port nicht gefunden0x7 7 Zielrechner nicht gefunden0x8 8 Unbekannte Befehl-ID0x9 9 Ungültige Task-ID0xA 10 Kein IO0xB 11 Unbekannter ADS-Befehl0xC 12 Win32 Fehler0xD 13 Port nicht angeschlossen0xE 14 Ungültige ADS-Länge0xF 15 Ungültige AMS Net ID0x10 16 niedrige Installationsebene0x11 17 Kein Debugging verfügbar0x12 18 Port deaktiviert0x13 19 Port bereits verbunden0x14 20 ADS Sync Win32 Fehler0x15 21 ADS Sync Timeout0x16 22 ADS Sync AMS Fehler0x17 23 Keine Index-Map für ADS Sync vorhanden0x18 24 Ungültiger ADS-Port0x19 25 Kein Speicher0x1A 26 TCP Sendefehler0x1B 27 Host nicht erreichbar0x1C 28 Ungültiges AMS Fragment

Router Fehlercodes

Hex Dec Name Beschreibung0x500 1280 ROUTERERR_NOLOCKEDMEMORY Lockierter Speicher kann nicht zugewiesen werden.0x501 1281 ROUTERERR_RESIZEMEMORY Die Größe des Routerspeichers konnte nicht geändert

werden.0x502 1282 ROUTERERR_MAILBOXFULL Das Postfach hat die maximale Anzahl der möglichen

Meldungen erreicht. Die aktuell gesendete Nachricht wur-de abgewiesen.

0x503 1283 ROUTERERR_DEBUGBOXFULL Das Postfach hat die maximale Anzahl der möglichenMeldungen erreicht.Die gesendete Nachricht wird nicht im ADS Monitor an-gezeigt.

0x504 1284 ROUTERERR_UNKNOWNPORTTYPE Der Porttyp ist unbekannt.0x505 1285 ROUTERERR_NOTINITIALIZED Router ist nicht initialisiert.0x506 1286 ROUTERERR_PORTALREADYINUSE Die gewünschte Portnummer ist bereits vergeben.0x507 1287 ROUTERERR_NOTREGISTERED Der Port ist nicht registriert.0x508 1288 ROUTERERR_NOMOREQUEUES Die maximale Anzahl von Ports ist erreicht.0x509 1289 ROUTERERR_INVALIDPORT Der Port ist ungültig.0x50A 1290 ROUTERERR_NOTACTIVATED Der Router ist nicht aktiv.

Allgemeine ADS Fehlercodes


Anhang

Hex Dec Name Beschreibung0x700 1792 ADSERR_DEVICE_ERROR Gerätefehler0x701 1793 ADSERR_DEVICE_SRVNOTSUPP Service wird vom Server nicht unterstützt0x702 1794 ADSERR_DEVICE_INVALIDGRP Ungültige Index-Gruppe0x703 1795 ADSERR_DEVICE_INVALIDOFFSET Ungültiger Index-Offset0x704 1796 ADSERR_DEVICE_INVALIDACCESS Lesen und schreiben nicht gestattet.0x705 1797 ADSERR_DEVICE_INVALIDSIZE Parametergröße nicht korrekt0x706 1798 ADSERR_DEVICE_INVALIDDATA Ungültige Parameter-Werte0x707 1799 ADSERR_DEVICE_NOTREADY Gerät ist nicht betriebsbereit0x708 1800 ADSERR_DEVICE_BUSY Gerät ist beschäftigt0x709 1801 ADSERR_DEVICE_INVALIDCONTEXT Ungültiger Kontext (muss in Windows sein)0x70A 1802 ADSERR_DEVICE_NOMEMORY Nicht genügend Speicher0x70B 1803 ADSERR_DEVICE_INVALIDPARM Ungültige Parameter-Werte0x70C 1804 ADSERR_DEVICE_NOTFOUND Nicht gefunden (Dateien,...)0x70D 1805 ADSERR_DEVICE_SYNTAX Syntax-Fehler in Datei oder Befehl0x70E 1806 ADSERR_DEVICE_INCOMPATIBLE Objekte stimmen nicht überein0x70F 1807 ADSERR_DEVICE_EXISTS Objekt ist bereits vorhanden0x710 1808 ADSERR_DEVICE_SYMBOLNOTFOUND Symbol nicht gefunden0x711 1809 ADSERR_DEVICE_SYMBOLVERSIONINVALID Symbol-Version ungültig0x712 1810 ADSERR_DEVICE_INVALIDSTATE Gerät im ungültigen Zustand0x713 1811 ADSERR_DEVICE_TRANSMODENOTSUPP AdsTransMode nicht unterstützt0x714 1812 ADSERR_DEVICE_NOTIFYHNDINVALID Notification Handle ist ungültig0x715 1813 ADSERR_DEVICE_CLIENTUNKNOWN Notification-Client nicht registriert0x716 1814 ADSERR_DEVICE_NOMOREHDLS Keine weitere Notification Handle0x717 1815 ADSERR_DEVICE_INVALIDWATCHSIZE Größe der Notification zu groß0x718 1816 ADSERR_DEVICE_NOTINIT Gerät nicht initialisiert0x719 1817 ADSERR_DEVICE_TIMEOUT Gerät hat einen Timeout0x71A 1818 ADSERR_DEVICE_NOINTERFACE Interface Abfrage fehlgeschlagen0x71B 1819 ADSERR_DEVICE_INVALIDINTERFACE Falsches Interface angefordert0x71C 1820 ADSERR_DEVICE_INVALIDCLSID Class-ID ist ungültig0x71D 1821 ADSERR_DEVICE_INVALIDOBJID Object-ID ist ungültig0x71E 1822 ADSERR_DEVICE_PENDING Anforderung steht aus0x71F 1823 ADSERR_DEVICE_ABORTED Anforderung wird abgebrochen0x720 1824 ADSERR_DEVICE_WARNING Signal-Warnung0x721 1825 ADSERR_DEVICE_INVALIDARRAYIDX Ungültiger Array-Index0x722 1826 ADSERR_DEVICE_SYMBOLNOTACTIVE Symbol nicht aktiv0x723 1827 ADSERR_DEVICE_ACCESSDENIED Zugriff verweigert0x724 1828 ADSERR_DEVICE_LICENSENOTFOUND Fehlende Lizenz0x725 1829 ADSERR_DEVICE_LICENSEEXPIRED Lizenz abgelaufen0x726 1830 ADSERR_DEVICE_LICENSEEXCEEDED Lizenz überschritten0x727 1831 ADSERR_DEVICE_LICENSEINVALID Lizenz ungültig0x728 1832 ADSERR_DEVICE_LICENSESYSTEMID Lizenz der System-ID ungültig0x729 1833 ADSERR_DEVICE_LICENSENOTIMELIMIT Lizenz nicht zeitlich begrenzt0x72A 1834 ADSERR_DEVICE_LICENSEFUTUREISSUE Lizenzproblem: Zeitpunkt in der Zukunft0x72B 1835 ADSERR_DEVICE_LICENSETIMETOLONG Lizenz-Zeitraum zu lang0x72c 1836 ADSERR_DEVICE_EXCEPTION Exception beim Systemstart0x72D 1837 ADSERR_DEVICE_LICENSEDUPLICATED Lizenz-Datei zweimal gelesen0x72E 1838 ADSERR_DEVICE_SIGNATUREINVALID Ungültige Signatur0x72F 1839 ADSERR_DEVICE_CERTIFICATEINVALID öffentliches Zertifikat0x740 1856 ADSERR_CLIENT_ERROR Clientfehler0x741 1857 ADSERR_CLIENT_INVALIDPARM Dienst enthält einen ungültigen Parameter0x742 1858 ADSERR_CLIENT_LISTEMPTY Polling-Liste ist leer0x743 1859 ADSERR_CLIENT_VARUSED Var-Verbindung bereits im Einsatz0x744 1860 ADSERR_CLIENT_DUPLINVOKEID Die aufgerufene ID ist bereits in Benutzung0x745 1861 ADSERR_CLIENT_SYNCTIMEOUT Timeout ist aufgetreten0x746 1862 ADSERR_CLIENT_W32ERROR Fehler im Win32 Subsystem0x747 1863 ADSERR_CLIENT_TIMEOUTINVALID Ungültiger Client Timeout-Wert0x748 1864 ADSERR_CLIENT_PORTNOTOPEN ADS-Port nicht geöffnet0x750 1872 ADSERR_CLIENT_NOAMSADDR Interner Fehler in Ads-Sync


Anhang

Hex Dec Name Beschreibung0x751 1873 ADSERR_CLIENT_SYNCINTERNAL Hash-Tabelle-Überlauf0x752 1874 ADSERR_CLIENT_ADDHASH Schlüssel nicht gefunden im Hash0x753 1875 ADSERR_CLIENT_REMOVEHASH Keine weitere Symbole im Cache0x754 1876 ADSERR_CLIENT_NOMORESYM Ungültige Antwort empfangen0x755 1877 ADSERR_CLIENT_SYNCRESINVALID Sync Port ist gesperrt

RTime Fehlercodes

Hex Dec Name Beschreibung0x1000 4096 RTERR_INTERNAL Interner Fehler im TwinCAT Echtzeit-System.0x1001 4097 RTERR_BADTIMERPERIODS Timer-Wert ist nicht gültig.0x1002 4098 RTERR_INVALIDTASKPTR Task-Pointer hat den ungültigen Wert 0 (null).0x1003 4099 RTERR_INVALIDSTACKPTR Task Stackpointer hat den ungültigen Wert 0.0x1004 4100 RTERR_PRIOEXISTS Die Request Task Priority ist bereits vergeben.0x1005 4101 RTERR_NOMORETCB Kein freies TCB (Task Control Block) zur Verfügung. Ma-

ximale Anzahl von TCBs beträgt 64.0x1006 4102 RTERR_NOMORESEMAS Keine freien Semaphoren zur Verfügung. Maximale An-

zahl der Semaphoren beträgt 64.0x1007 4103 RTERR_NOMOREQUEUES Kein freier Platz in der Warteschlange zur Verfügung.

Maximale Anzahl der Plätze in der Warteschlange be-trägt 64.

0x100D 4109 RTERR_EXTIRQALREADYDEF Ein externer Synchronisations-Interrupt wird bereits an-gewandt.

0x100E 4110 RTERR_EXTIRQNOTDEF Kein externer Synchronisations-Interrupt angewandt.0x100F 4111 RTERR_EXTIRQINSTALLFAILED Anwendung des externen Synchronisierungs- Interrupts

ist fehlgeschlagen0x1010 4112 RTERR_IRQLNOTLESSOREQUAL Aufruf einer Service-Funktion im falschen Kontext0x1017 4119 RTERR_VMXNOTSUPPORTED Intel VT-x Erweiterung wird nicht unterstützt.0x1018 4120 RTERR_VMXDISABLED Intel VT-x Erweiterung ist nicht aktiviert im BIOS.0x1019 4121 RTERR_VMXCONTROLSMISSING Fehlende Funktion in Intel VT-x Erweiterung.0x101A 4122 RTERR_VMXENABLEFAILS Aktivieren von Intel VT-x schlägt fehl.

TCP Winsock-Fehlercodes

Hex Dec Name Beschreibung0x274c 10060 WSAETIMEDOUT Verbindungs Timeout aufgetreten.

Fehler beim Herstellen der Verbindung, da die Gegenstelle nach einer be-stimmten Zeitspanne nicht ordnungsgemäß reagiert hat, oder die hergestellteVerbindung konnte nicht aufrecht erhalten werden, da der verbundene Hostnicht reagiert hat.

0x274d 10061 WSAECONNREFUSED Verbindung abgelehnt.

Es konnte keine Verbindung hergestellt werden, da der Zielcomputer dies ex-plizit abgelehnt hat. Dieser Fehler resultiert normalerweise aus dem Versuch,eine Verbindung mit einem Dienst herzustellen, der auf dem fremden Host in-aktiv ist—das heißt, einem Dienst, für den keine Serveranwendung ausgeführtwird.

0x2751 10065 WSAEHOSTUNREACH Keine Route zum Host

Ein Socketvorgang bezog sich auf einen nicht verfügbaren Host.Weitere Winsock-Fehlercodes: Win32-Fehlercodes


Anhang

7.1.3 FTP Client Return Codes


Anhang

Hex Dez Beschreibung0x00008001 32768 + 1 := 32769 Interner Fehler TwinCAT FTP

Client.0x00008002 32768 + 2 := 32770 Datei Fehler (z.B. Datei nicht

gefunden, Zugriff verweigert)0x00008003 32768 + 3 := 32771 Übertragungsfehler (z.B.

Verbindung abgebrochen)0x00008004 32768 + 4 := 32772 Fehler beim Verbinden auf den

Server. Verbindung konnte nichthergestellt werden.

0x00008005 32768 + 5 := 32773 Keinen Response vom FTP Serverempfangen.

0x000081F4 32768 + 500 := 33268 Syntax Fehler, Kommandounbekannt. Dies kann den Fehler"Kommandozeile zu lang"beinhalten.

0x000081F5 32768 + 501 := 33269 Syntax Fehler bei Parametern oderArgumenten.

0x000081F6 32768 + 502 := 33270 Kommando nicht implementiert.0x000081F7 32768 + 503 := 33271 Falsche Abfolge der Kommandos.0x000081F8 32768 + 504 := 33272 Kommando nicht für diesen

Parameter implementiert.0x00008212 32768 + 530 := 33298 Nicht eingeloggt.0x00008214 32768 + 532 := 33300 Benötigt Account um Dateien zu

speichern.0x00008226 32768 + 550 := 33318 Angeforderte Aktion nicht

ausgeführt. Datei nicht erreichbar(z.B. Datei nicht gefunden, keinenZugriff).

0x00008227 32768 + 551 := 33319 Angeforderte Aktion abgebrochen,Seitentyp unbekannt.

0x00008228 32768 + 552 := 33320 Angeforderte Dateiaktionabgebrochen. ZugewiesenenSpeicher überschritten (füraktuelles Verzeichnis oder Datei).

0x00008229 32768 + 553 := 33321 Angeforderte Aktion nichtausgeführt. Dateiname nichterlaubt.

0x000081A5 32768 + 421 := 33189 Service nicht erreichbar, schließtControl Verbindungen. Dies istvermutlich die Rückantwort aufjedes Kommando welches einenNeustart verursacht.

0x000081A9 32768 + 425 := 33193 Kann keine Datenverbindungöffnen.

0x000081AA 32768 + 426 := 33194 Verbindung geschlossen; Transferabgebrochen.

0x000081C2 32768 + 450 := 33218 Angeforderte Dateiaktion nichtausgeführt.

0x000081C3 32768 + 451 := 33219 Angeforderte Aktion abgebrochen.Lokaler Fehler während derAbarbeitung.


Anhang

Hex Dez Beschreibung0x000081C4 32768 + 452 := 33220 Angeforderte Aktion nicht

ausgeführt. UnzureichenderSpeicherplatz im System. Dateinicht erreichbar (z.B. Datei inBenutzung).

Voraussetzungen


7.2 Troubleshooting

7.2.1 TroubleshootingDie folgende Liste bietet grundlegende Hilfe, falls Fehler auftreten, bitte lesen Sie sie, bevor Sie unserenSupport kontaktieren. Lesen Sie bitte auch unsere Übersicht der Fehlercodes [} 55].

• Einer der SPS-Funktionsbausteine liefert den Fehlercode 0x6 zurück: Zielport nicht gefunden Stellen Sie sicher, dass der Prozess TcFtpClient.exe läuft, überprüfen Sie das mit dem WindowsTask Manager. Falls er nicht läuft, installieren Sie das Produkt TF6300 FTP noch einmal.

• Einer der SPS-Funktionsbausteine liefert den Fehlercode 0x00008005: Keine Antwort vom FTP-ServerStellen Sie sicher, dass der FTP-Server verfügbar ist und dass keine Firewall den Zugriff zu den FTPPorts blockiert. In den Grundlagen zum FTP [} 17] finden Sie mehr Informationen zu FTP Ports.

Sollten diese Schritte nicht helfen, kontaktieren Sie unseren Support [} 61].

7.2.2 Kontakt Beckhoff Support

7.2.2.1 Kontakt Beckhoff Support

Lässt sich das Problem nicht anhand der Fehlersuch-Prüfliste lösen, wenden Sie sich bitte mit folgendenAngaben an den Support:

Typ BeschreibungAllgemeine Informationen [} 62] Allgemeine Angaben zum System, die unser Support

benötigtProduktinformationen [} 62] Allgemeine Angaben zum Produkt, die unser Support

benötigt


Anhang

7.2.2.2 Allgemeine Systeminformationen• Welche Hardware wird in dem Rechner verwendet, auf dem TF6300 FTP läuft?

◦ Beckhoff Industrie-PC: Produktnummer des IPC?◦ Beckhoff Embedded PC: Produktnummer des Embedded PC?

◦ Welche Image-Version des Betriebssystems [} 64] ist gegenwärtig auf dem Rechner instal-liert?

• Welches Betriebssystem ist auf dem Rechner installiert, auf dem TF6300 FTP läuft?◦ Windows CE5, Windows CE6, Windows CE7?◦ Windows XP, Windows 7, Windows Embedded?

• Welche Version von TwinCAT [} 62] wird mit TF6300 FTP verwendet?◦ Sind auf diesem Rechner mehrere TwinCAT-Versionen installiert? (Zum Beispiel: TwinCAT 2

und TwinCAT 3 nebeneinander installiert)• Bitte beschreiben Sie das Problem genau

7.2.2.3 Produktbezogene Systeminformationen• Welche Version von TF6300 FTP wird verwendet?• Welche Bausteine der Tc2_Ftp-Bibliothek werden im SPS-Programm verwendet?• Welche FTP-Server-Software wird verwendet?

◦ Microsoft Internet Information Service (welche Version?)◦ FileZilla FTP-Server◦ Linux/Unix NcFtpd◦ ...

• Bitte beschreiben Sie die Umgebung genau, in der TF6300 FTP verwendet wird◦ Wo befindet sich der Rechner, auf dem TF6300 FTP läuft?◦ Wo befindet sich der FTP-Server? (Lokales Netzwerk, Internet)◦ Welche sind die IP-Einstellungen des FTP-Servers und des Rechners, auf dem TF6300 FTP

läuft? (IP-Adresse, Subnetzmaske, Gateway, DNS)◦ Wenn zwischen beiden Rechnern eine Firewall installiert ist:

Welche Firewall wird verwendet (mit Anbieterinformationen)?

Ist die Firewall so konfiguriert, dass sie FTP-Verbindungen erlaubt?

7.2.2.4 Die TwinCAT Version bestimmen

Dieser Artikel beschreibt, wie Sie die aktuell verwendete TwinCAT-Version bestimmen können.


Anhang

Windows XP, Windows 7Sie finden die TwinCAT-Version unter dem TwinCAT-Symbol auf der Taskleiste.


Anhang

Windows CESie finden die TwinCAT-Version unter dem TwinCAT-Symbol auf der Taskleiste.

7.2.2.5 Die Betriebssystem-Image-Version bestimmen

Dieser Artikel beschreibt, wie Sie - bei Verwendung eines Beckhoff IPC/EPC - die aktuell benutzte Versiondes Betriebssystem-Images bestimmen können.

Windows XP, Windows 7Sie finden die Image-Version im Fenster System Eigenschaften. Bitte führen Sie die folgenden Schritte aufdem Beckhoff IPC/EPC aus:

• Öffnen Sie die Windows Systemsteuerung• Führen Sie einen Doppelklick auf „System“ aus


Anhang

Windows CEUnter CX Configuration Tool finden Sie die Image-Version. Bitte führen Sie die folgenden Schritte auf demBeckhoff IPC/EPC aus:

• Öffnen Sie die Windows Systemsteuerung• Führen Sie einen Doppelklick auf „CX Configuration Tool“ aus


Anhang


TF6300 TC3 FTP CLIENT DE - download.beckhoff.com · Übersicht ArtikelSystemvoraussetzungen [...

Documents

Transcript of TF6300 TC3 FTP CLIENT DE - download.beckhoff.com · Übersicht ArtikelSystemvoraussetzungen [...