Deckblatt. WinAC File I/O. Anwenderdokumentation. V1.5 Februar Applikationen & Tools. Answers for industry.

Transkript

1 Deckblatt WinAC File I/O Anwenderdokumentation V1.5 Februar 2010 Applikationen & Tools Answers for industry.

2 Industry Automation und Drives Technologies Service & Support Portal Dieser Beitrag stammt aus dem Internet Serviceportal der Siemens AG, Industry Automation und Drives Technologies. Durch den folgenden Link gelangen Sie direkt zur Downloadseite dieses Dokuments. Bei Fragen zu diesem Beitrag wenden Sie sich bitte über folgende -Adresse an uns: 2 V1.5, Beitrags-ID:

3 s Grundlegende Informationen 1 Quickstart 2 Schnittstelle 3 SIMATIC Access DB Funktionsweise des File-I/O-FB 4 Projektierung in WinAC 5 S7 Beispielprogramm 6 Anwendungsbeispiele 7 Fehlercodes 8 Historie 9 V1.5, Beitrags-ID:

4 Gewährleistung und Haftung Gewährleistung und Haftung Hinweis Die Applikationsbeispiele sind unverbindlich und erheben keinen Anspruch auf Vollständigkeit hinsichtlich Konfiguration und Ausstattung sowie jeglicher Eventualitäten. Die Applikationsbeispiele stellen keine kundenspezifischen Lösungen dar, sondern sollen lediglich Hilfestellung bieten bei typischen Aufgabenstellungen. Sie sind für den sachgemäßen Betrieb der beschriebenen Produkte selbst verantwortlich. Diese Applikationsbeispiele entheben Sie nicht der Verpflichtung zu sicherem Umgang bei Anwendung, Installation, Betrieb und Wartung. Durch Nutzung dieser Applikationsbeispiele erkennen Sie an, dass wir über die beschriebene Haftungsregelung hinaus nicht für etwaige Schäden haftbar gemacht werden können. Wir behalten uns das Recht vor, Änderungen an diesen Applikationsbeispielen jederzeit ohne Ankündigung durchzuführen. Bei Abweichungen zwischen den Vorschlägen in diesem Applikationsbeispiel und anderen Siemens Publikationen, wie z.b. Katalogen, hat der Inhalt der anderen Dokumentation Vorrang. Für die in diesem Dokument enthaltenen Informationen übernehmen wir keine Gewähr. Unsere Haftung, gleich aus welchem Rechtsgrund, für durch die Verwendung der in diesem Applikationsbeispiel beschriebenen Beispiele, Hinweise, Programme, Projektierungs- und Leistungsdaten usw. verursachte Schäden ist ausgeschlossen, soweit nicht z.b. nach dem Produkthaftungsgesetz in Fällen des Vorsatzes, der groben Fahrlässigkeit, wegen der Verletzung des Lebens, des Körpers oder der Gesundheit, wegen einer Übernahme der Garantie für die Beschaffenheit einer Sache, wegen des arglistigen Verschweigens eines Mangels oder wegen Verletzung wesentlicher Vertragspflichten zwingend gehaftet wird. Der Schadensersatz wegen Verletzung wesentlicher Vertragspflichten ist jedoch auf den vertragstypischen, vorhersehbaren Schaden begrenzt, soweit nicht Vorsatz oder grobe Fahrlässigkeit vorliegt oder wegen der Verletzung des Lebens, des Körpers oder der Gesundheit zwingend gehaftet wird. Eine Änderung der Beweislast zu Ihrem Nachteil ist hiermit nicht verbunden. Weitergabe oder Vervielfältigung dieser Applikationsbeispiele oder Auszüge daraus sind nicht gestattet, soweit nicht ausdrücklich von Siemens Industry Sector zugestanden. 4 V1.5, Beitrags-ID:

5 Inhaltsverzeichnis Inhaltsverzeichnis Gewährleistung und Haftung... 4 Einführung Grundlegende Informationen Referenzsystem Installation Quickstart Schnittstelle Funktionsweise des File-I/O-FB Projektierung in WinAC Initialisierung Normaler Aufruf S7-Beispielprogramm Übersicht Benutzung des Demo-Programmes Anwendungsbeispiele Fehlercodes Historie V1.5, Beitrags-ID:

6 0 Einführung Einführung Ziel der Applikation: Die Erweiterung FileI/O für WinAC ermöglicht auf einfache Weise File- Operationen (Schreiben / Lesen / Löschen). Es können Bereiche von Datenbausteinen in eine Datei geschrieben werden und Daten aus Datenbausteinen gelesen werden. Die Daten werden binär in die Datei geschrieben. Werden Daten aus einem File gelesen, ist darauf zu achten, dass der Ziel-DB den gleichen Aufbau hat wie der DB, aus dem die Daten geschrieben worden sind. Außerdem ist das Löschen von Dateien möglich. 6 V1.5, Beitrags-ID:

7 1 Grundlegende Informationen 1 Grundlegende Informationen 1.1 Referenzsystem Die in dieser Dokumentation beschriebene Applikation basiert auf folgendem Referenzsystem: WinAC RTX-F 2009 Simatic Field PG mit Simatic Manager V5.4, SP4 Windows XP / Windows XPE SP3 mit Auslieferungsimage für SIMATIC IPC427C 1.2 Installation Die Installation erfolgt über den Aufruf des gelieferten Setup. Dieser installiert alle notwendigen Dateien (DLL, Hilfe) sowie das Step7-Demoprogramm. Während der Installation muss der Anwender ein Verzeichnis zur Ablage der erforderlichen Dateien angeben. In diesem Verzeichnis werden neben den Hilfedateien das Step7 Demoprogramm ( File-IO-Demo.zip ) abgelegt. Um das Step7-Demo verwenden zu können, muss es mit dem Simatic Manager dearchiviert werden. V1.5, Beitrags-ID:

8 2 Quickstart 2 Quickstart Ausführen setup.bat FB FileI/O aus dem Demo-Projekt in das Anwender-Projekt übernehmen Initialisieren von File-I/O (siehe Bsp. OB100) Verwenden des FileI/O FBs (see Demo-Projekt) 8 V1.5, Beitrags-ID:

9 3 Schnittstelle 3 Schnittstelle Die Schnittstelle der WinAC-Erweiterung File-I/O ist in einem Funktionsbausteinen realisiert. Dieser ist im Step7 Demo-Programm enthalten und kann für die Benutzerprojekte verwendet werden. Funktion File-I/O Der Funktionsbaustein FileIO ermöglicht die Fileoperationen. Das Flag Init darf nur bei einem Aufruf des FB aktiviert sein (z.b. im OB100). Über die Befehls-Bits Read, Write und Delete wird die gewünschte Funktion ausgewählt. ACHTUNG Es darf immer nur eine Funktion gleichzeitig aktiviert sein. Es darf immer nur mit einer Datei gleichzeitig gearbeitet werden. Der Filename legt den Namen der Datei fest, auf den die Operation ausgeführt werden soll. Die drei Parameter DBNr, DBOffset und DBLength spezifizieren den Bereich eines DB, der in die Datei geschrieben, bzw. aus der Datei gelesen werden soll. Das Bit Req ist als IN/OUT-Wert realisiert. D.h. zum Auslösen der Funktion wird das Bit gesetzt. Die Funktion setzt es zurück, wenn die Bearbeitung fertig ist. Setzt die Funktion Req zurück, können das Bit Error und Status ausgewertet werden (siehe Fehlercodes). V1.5, Beitrags-ID:

10 4 Funktionsweise des File-I/O-FB 4 Funktionsweise des File-I/O-FB Der nachfolgende Abschnitt beschreibt die interne Funktionsweise des Funktionsbausteins FileIO. Der Funktionsbaustein arbeitet asynchron. Der Anwender beschaltet den DB mit den erforderlichen Daten (Filename, DB,...) und dem gewünschten Befehl (Lesen, Schreiben,...). Mit dem Setzen des Req-Bits wird die Abarbeitung des Befehls im Hintergrund ausgelöst. Setzt der FB das Req-Bit zurück, ist die Abarbeitung beendet. Ablauf im Step7-Funktionsbaustein: Im FB FileIO sind die WinAC-Aufrufe CREA_COMM und EXEC_COM gekapselt, damit der Anwender die Funktionalitäten der Fileoperationen möglichst komfortabel nutzen kann. Initialisierung Ist das Init -Bit gesetzt wird der CREA_COMM Baustein aufgerufen und das zurückgegebenen Handle im STATIC-Bereich des Instanz-DBs gespeichert. Kopieren Parameter Nur wenn das Req -Bit gesetzt ist, wird die normale Funktionalität des Baustein ausgeführt. Die übergebenen Informationen werden in den STATIC-Bereich des Instanz-DBs kopiert. Anschließend wird ein ANY-Pointer erzeugt, der auf diesen Parameterbereich im Instanz-DB verweist. Danach erfolgt eine Prüfung der DB- Parameter. Ablauf-Schrittkette Die eigentliche Funktionalität der Fileoperationen wird durch mehrere Aufrufe des EXEC_COM-Bausteins in einer Schrittkette realisiert. Die eigentliche Ausführung erfolgt asynchron. Der letzte Zustand der Schrittkette ist das Abragen des Befehls-Status. Wird das Ende des Hintergrundprozesses signalisiert, wird das Req-Bit zurückgesetzt. Ablaufsequenz Die Ausführung erfolgt asynchron, dass heißt, sie wird von außen nur angestoßen und erfolgt dann parallel zu den unbeeinträchtigten anderen Prozessen. Die Ausführung lässt sich im folgenden Ablaufdiagramm darstellen: 10 V1.5, Beitrags-ID:

11 4 Funktionsweise des File-I/O-FB V1.5, Beitrags-ID:

12 5 Projektierung in WinAC 5 Projektierung in WinAC Der folgende Abschnitt erläutert beispielhaft die Projektierung mit File-I/O. 5.1 Initialisierung Der FB File-I/O muss einmal initialisiert werden (z.b. im OB100). Dafür muss nur der Init-Eingang auf TRUE stehen. CALL "TestFileIO", DB100 Init :=TRUE Read := Write := Delete := Filename:= DBNr := DBOffset:= DBLenght:= Error :="Error" Status :="Status" Req := 5.2 Normaler Aufruf Wird der FB File-I/O benutzt, darf der Init-Eingang nicht mehr auf TRUE stehen. Es müssen die erforderlichen Parameter beschaltet sein und ein Befehl ausgewählt sein, z.b.: CALL "TestFileIO", DB100 Init :=FALSE Read :="Read" Write :="Write" Delete :="Delete" Filename:="FileIO-Param".Filename DBNr :=110 DBOffset:=10 DBLenght:=6 Error :="Error" Status :="Status" Req :="Req" ACHTUNG WinAC File-I/O ist nicht multitasking-fähig. Wenn mehr als eine Datei verarbeitet werden soll, muss erst das Ende einer Operation abgewartet werden, bevor die nächste gestartet wird. 12 V1.5, Beitrags-ID:

13 6 S7-Beispielprogramm 6 S7-Beispielprogramm 6.1 Übersicht Relevante DBs / FBs sind in der folgenden Tabelle zusammengestellt: FB100 DB100 OB100 OB1 DB101 DB110 / DB111 DB112 / DB113 Der File-I/O-Funktionsbaustein. Der zugehörige Instanz-DB In diesem OB wird der File-I/O-FB initialisiert In diesem OB wird der File-I/O-FB benutzt Sammlung von Filenamen für File-I/O Daten-DBs aus dem gelesen bzw. in den geschrieben wird (einheitliche Daten: alles INT) Daten-DBs aus dem gelesen bzw. in den geschrieben wird (enthalten verschiedene Datentypen, Datenstruktur um ein INT verschoben) SFB65001 SFB65002 SFC24 Zusätzlich werden einige System-Funktionen für die Funktionalität vom File-I/O benötigt: Initialisierung Anwender-Code Ausführung Anwender-Code TEST_DB 6.2 Benutzung des Demo-Programmes Zunächst muss man im OB1 beim Aufruf des File-I/O-FB die folgenden Parameter entsprechend den eigenen Wünschen ändern: Filename DBNr, DBOffset, DBLength In der Variablen-Tabelle VAT_1 sind einige Variablen zusammengestellt, über die man die Funktionen des File-I/O bequem testen kann. Über die drei BOOLs Read, Write, Delete wählt man die gewünschte Funktion (nur einen auf true setzen!). Mit Req auf true löst man den Befehl aus. Im Error / Status ist der Rückgabewert des File-I/O-FBs gespeichert. V1.5, Beitrags-ID:

14 7 Anwendungsbeispiele 7 Anwendungsbeispiele File-I/O ist beispielsweise anwendbar für alle Arten der Datenarchivierung und Datenrestauration, die direkt aus der SPS erfolgen müssen. 14 V1.5, Beitrags-ID:

15 8 Fehlercodes 8 Fehlercodes In der folgenden Übersicht sind alle Fehlercodes zusammengestellt, die vom Funktionsbaustein FileIO zurückgegeben werden können. Allgemeine Fehler WinAC Open Development Kit 0x807F Interner Fehler aufgetreten. 0x8001 Exception aufgetreten. 0x8002 Input: der ANY pointer ist ungültig. 0x8003 Input: der ANY pointer Bereich ist ungültig. 0x8004 Output: der ANY pointer ist ungültig. 0x8005 Output: der ANY pointer Bereich ist ungültig. 0x8006 Mehr Bytes wurden in den Output-Bereich geschrieben, als allokiert worden sind. 0x8007 Das ODK System ist nicht initialisiert: kein Aufruf von SFB65001 (CREA_COM) erfolgt. 0x8008 Das Handle passt nicht zu einem gültigen Erweiterungsobjekt. 0x8009 Mehr Bytes wurden in den Input-Puffer geschrieben, als allokiert. 0x8102 Der Aufruf von CLSIDFromProgID ist fehlgeschlagen. 0x8103 Der Aufruf von CoInitializeEx ist fehlgeschlagen. 0x8104 Der Aufruf von CoCreateInstance ist fehlgeschlagen. 0x8105 Die ODK-DLL konnte nicht geladen werden. 0x8106 Windows-Timout aufgetreten. 0x8107 Controller ist in einem ungültigen Zustand für den Aufruf eines OB. 0x8108 Aufrufinfo für OB ist ungültig. 0x8109 Instanz ID für SFB65001 ist ungültig. 0x810A Controller konnte die Proxy DLL nicht laden. 0x810B Die WinAC konnte den shared memory nicht anlegen oder initialisieren. 0x810C Versuch eine nicht unterstützte Option zu benutzen. Allgemeine Fehlercodes für Anwender-Code (ab 0x8000) 0x0000 kein Fehler 0x8002 ODK-Init-Fehler (z.b. DLL nicht gefunden) 0x8201 int. Fehler: Unbekanntes Commando 0x8250 int. Fehler: Jobliste voll 0x8252 int. Fehler: ungültiger Zähler 0x8255 int. Fehler: Speicherbereich ungültig 0x8256 int. Fehler: ungültige DB-Nummer 0x8259 int. Fehler: Datenmenge ungültig V1.5, Beitrags-ID:

16 8 Fehlercodes 0x825F int. Fehler: Adressfehler 0x8261 int. Fehler: Hardwarefehler 0x8401 int. Fehler: ungültiges asynchrones Event 0x8402 int. Fehler: Queue asynchr. Prozessor leer 0x8403 int. Fehler: Queue asynchr. Prozessor voll Spezielle Fehlercodes File-I/O (ab 0x9000) 0x9001 Filepfad/-name zu lang 0x9002 int. Fehler: unbekannter Befehls-Code 0x9011 int. Fehler: async. Event nicht vorhanden 0x9012 int. Fehler: Service Handle nicht definiert 0x9021 int. Fehler: S7-Lesen 0x9022 int. Fehler: S7-Schreiben 0x9031 int. Fehler: undefinierter Status async. Event 0x9032 int. Fehler: unbekannter Status async. Event 0x9041 int. Fehler: ungültiger Aufruf, async. Event läuft gerade 0x9051 Fehler beim Anlegen der Datei (zum Schreiben) 0x9052 Fehler beim Öffnen der Datei (zum Lesen) 0x9053 Fehler beim Schreiben 0x9054 Fehler beim Lesen 0x9055 Fehler beim Löschen der Datei 0x9061 int. Fehler: ODK-Lesen 0x9062 int. Fehler: ODK-Schreiben 0x9091 DB existiert nicht 0x9092 DB-Länge überschritten 0x9999 int. Fehler: undefinierter Fehler-Code 16 V1.5, Beitrags-ID:

17 9 Historie 9 Historie Version Datum V Systeanforderungen hinzugefügt V Kontaktinfo auf Titelseite Exportkennzeichen V Anpassung Titelseite Formatierungen und Überschriften verändert Fehlermeldungen ergänzt (allg. ODK Fehler) Argumente für FB jetzt WORD anstelle INT V mit WinAC RTX 2008 getestet V mit WinAC RTX-F 2009 getestet V1.5, Beitrags-ID: