WinCC Runtime Professional S7-Graph Übersicht und PLC- Code-Viewer

Transkript

1 Anwendungsbeispiel 11/2015 WinCC Runtime Professional S7-Graph Übersicht und PLC- Code-Viewer WinCC V13 SP1

2 Gewährleistung und Haftung Gewährleistung und Haftung Hinweis Die Anwendungsbeispiele sind unverbindlich und erheben keinen Anspruch auf Vollständigkeit hinsichtlich Konfiguration und Ausstattung sowie jeglicher Eventualitäten. Die Anwendungsbeispiele 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 Anwendungsbeispiele entheben Sie nicht der Verpflichtung zu sicherem Umgang bei Anwendung, Installation, Betrieb und Wartung. Durch Nutzung dieser Anwendungsbeispiele 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 Anwendungsbeispiele jederzeit ohne Ankündigung durchzuführen. Bei Abweichungen zwischen den Vorschlägen in diesem Anwendungsbeispiel 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 Anwendungsbeispiele oder Auszüge daraus sind nicht gestattet, soweit nicht ausdrücklich von der Siemens AG zugestanden. Securityhinweise Siemens bietet Produkte und Lösungen mit Industrial Security-Funktionen an, die den sicheren Betrieb von Anlagen, Lösungen, Maschinen, Geräten und/oder Netzwerken unterstützen. Sie sind wichtige Komponenten in einem ganzheitlichen Industrial Security-Konzept. Die Produkte und Lösungen von Siemens werden unter diesem Gesichtspunkt ständig weiterentwickelt. Siemens empfiehlt, sich unbedingt regelmäßig über Produkt-Updates zu informieren. Für den sicheren Betrieb von Produkten und Lösungen von Siemens ist es erforderlich, geeignete Schutzmaßnahmen (z. B. Zellenschutzkonzept) zu ergreifen und jede Komponente in ein ganzheitliches Industrial Security-Konzept zu integrieren, das dem aktuellen Stand der Technik entspricht. Dabei sind auch eingesetzte Produkte von anderen Herstellern zu berücksichtigen. Weitergehende Informationen über Industrial Security finden Sie unter Um stets über Produkt-Updates informiert zu sein, melden Sie sich für unseren produktspezifischen Newsletter an. Weitere Informationen hierzu finden Sie unter Beitrags-ID: , V2.0, 11/2015 2

3 1 Aufgabe Inhaltsverzeichnis Gewährleistung und Haftung Aufgabe Lösung Aufbau Hard- und Software-Komponenten Gültigkeit Verwendete Komponenten Funktionsweise Diagnose von Störungen mittels PLC-Code-Anzeige und STEP Grundlagen Verwenden von Funktionsbibliotheken STEP 7 Programm Projektierung HMI Objekte Projektierung S7 GRAPH Übersicht Projektierung C-Skripte Anzeige in der PLC-Code-Anzeige Funktion OpenViewerIECPLByFCCall() Funktion OpenViewerIECPLByCall() Funktion OpenViewerIECPLByAssignment() Funktion OpenViewerS7GraphByBlock() Anzeige in STEP Funktion OpenTIAPortalProject() Funktion OpenTIAPortalIECPLByCall() Funktion OpenTIAPortalIECPLByAssignment() Funktion OpenTIAPortalS7GraphByBlock() Bedienung der Applikation Inbetriebnahme des Beispielprojektes für WinCC Bedienung des Beispielprojekts Literaturhinweise Historie Beitrags-ID: , V2.0, 11/2015 3

4 1 Aufgabe 1 Aufgabe Beschreibung der Automatisierungsaufgabe In Fertigungsanlagen kann es während des Betriebes zu Störungen im Programmablauf kommen. Um diese möglichst schnell zu diagnostizieren und zu beheben, greifen Sie gezielt von Ihrem SCADA System aus auf Bausteine der CPU zu. Dabei können Sie diese sowohl direkt aus der Runtime aus beobachten, als auch im Engineering System öffnen und beobachten. Überblick über die Automatisierungsaufgabe Abbildung 1-1 Beitrags-ID: , V2.0, 11/2015 4

5 2 Lösung 2.1 Aufbau 2 Lösung 2.1 Aufbau Schema Abbildung 2-1 PROFINET IE Beschreibung Zur schnellen und einfachen Diagnose stehen die PLC-Code-Anzeige und das TIA Engineering Framework bereit. Um im Leitstand schon eine Fehlerdiagnose betreiben zu können, kann mittels verschiedener C-Skript Funktionen im HMI der Code einzelner Bausteine in den Programmiersprachen KOP, FUP und S7-Graph angezeigt werden. Weitere Informationen zu Systemdiagnose mit S und TIA-Portal finden Sie unter der Beitrags-ID: Leitstand, WinCC-Komponenten Zur Lösung der Aufgabe werden zwei Standard-Controls aus der WinCC Runtime Professional verwendet. PLC-Code-Anzeige S7-GRAPH-Übersicht Vorausgesetzte Kenntnisse Grundlegende Kenntnisse über WinCC V13 und STEP 7 V13 werden voraus gesetzt. Beitrags-ID: , V2.0, 11/2015 5

6 2 Lösung 2.2 Hard- und Software-Komponenten 2.2 Hard- und Software-Komponenten Gültigkeit Diese Applikation ist gültig für TIA Portal V13 SP Verwendete Komponenten Die Applikation wurde mit nachfolgenden Komponenten erstellt: Software-Komponenten Tabelle 2-1 Komponente Anz. Artikelnummer Hinweis WinCC Runtime Professional V13 SP1 WinCC Engineering V13 SP1 STEP 7 Professional V13 SP1 1 6AV AV ES Beispieldateien und Projekte Die folgende Liste enthält alle Dateien und Projekte, die in diesem Beispiel verwendet werden. Tabelle 2-2 Komponente _PLC_Code_Viewer_Doku_de.pdf _PLC_Code_Viewer_Code.zip Hinweis Dieses Dokument Projekt Beitrags-ID: , V2.0, 11/2015 6

7 3 Funktionsweise 3 Funktionsweise 3.1 Diagnose von Störungen mittels PLC-Code-Anzeige und STEP 7 Abbildung 3-1 PROFINET IE WinCC V13 Diagnose von Störungen Zur schnellen und einfachen Diagnose von Störungen Ihres aktuellen PLC Code stehen Ihnen für die WinCC Runtime Professional 2 Möglichkeiten zur Verfügung. 1. Anzeigen des Codes in der PLC-Code-Anzeige Das Objekt PLC-Code-Anzeige ist für das Bediengerät WinCC Runtime Professional verfügbar. Dieses Objekt dient zur Anzeige des aktuellen Programmstatus von PLC-Programmen, die in den Programmiersprachen KOP, FUP oder S7-GRAPH programmiert wurden. Hinweis In der TIA Portal Hilfe finden Sie, die derzeitig unterstützten Bausteine unter Prozesse visualisieren Bilder erstellen Anzeige- und Bedienobjekte Objekte PLC-Code-Anzeige. 2. Anzeigen des Codes in STEP 7 Mit diesen Funktionen können Sie von einem Bild in WinCC Runtime direkt zur Verwendungsstelle einer Prozessvariablen im Programmcode von STEP 7 wechseln. Beitrags-ID: , V2.0, 11/2015 7

8 4 Grundlagen 4.1 Verwenden von Funktionsbibliotheken 4 Grundlagen 4.1 Verwenden von Funktionsbibliotheken Jede Applikation von WinCC (Benutzerverwaltung, Rezepturen, Meldungen usw.) stellen eigene API Funktionen zur Verfügung, welche in einer DLL oder auf mehreren DLL s verteilt sind. Unter einer DLL (Dynamic Link Library) versteht man dabei eine dynamisch zu ladende Funktionsbibliothek. Die in einer DLL vorhandenen Funktionen liegen in einer zugehörigen Headerdatei. Die Einbindung einer DLL in eine C-Aktion oder eine andere Funktion wird im nachfolgenden Programmcode beispielhaft gezeigt. In der ersten Zeile wird der Name der DLL angegeben, welche geladen werden soll. Im vorliegenden Beispiel handelt es sich dabei um die DLL, welche die Funktionen für die PLC-Code- Anzeige enthalten. In der zweiten Zeile wird die Headerdatei mit den Funktionsdeklarationen eingebunden. Den Abschluss bildet die Zeile #pragma code(). In dem hier gezeigten Beispiel stimmen die Namen von DLL und Headerdatei überein. #pragma code("kopapi.dll") #include "kopapi.h" #pragma code() Beitrags-ID: , V2.0, 11/2015 8

9 5.1 STEP 7 Programm 5.1 STEP 7 Programm Zur Demonstration der PLC-Code-Anzeige wurde ein Programm für eine Prägemaschine erstellt. Dieses enthält Organisationsbausteine Funktionsbausteine, Datenbausteine und Funktionen mit deren Hilfe die einzelnen Netzwerke in der dargestellt werden. Abbildung 5-1 S7_Graph InstanceDB_FB1 OB1 FB1 DB1 Simu_Zylin1 InstanceDB_FB2 FB2 DB2 Simu_Zylin2 InstanceDB_FB6 FB6 DB8 UDT_DB DB5 Simu_Error FC1 Tabelle 5-1 Nr. Beschreibung 1. OB1 Über den OB1 werden die in der Programmstruktur aufgeführten Bausteine aufgerufen. 2. FB1 Der FB1 enthält die S7-GRAPH Schrittkette für die Prägemaschine. 3. FB2 Der FB2 enthält das Programm zur Simulation des Druckluftzylinder FB6 Der FB6 enthält das Programm zur Simulation des Druckluftzylinder DB5 Der DB5 enthält die UDT Datenstruktur. 6. FC1 Der FC1 überwacht Störungen an den Druckluftzylindern. 7. DB1, DB2, DB8 Instanzdatenbausteine für die zugewiesenen Funktionsbausteine. Beitrags-ID: , V2.0, 11/2015 9

10 5.2 Projektierung HMI Objekte 5.2 Projektierung HMI Objekte In diesem Abschnitt wird gezeigt, welche Objekte Sie für die Projektierung benötigen. Tabelle 5-2 Nr. 1. Öffnen Sie Ihr TIA Portal Projekt. Aktion 2. Fügen Sie ein neues HMI Bild ein und öffnen Sie dieses. 3. Öffnen Sie die Task Card Werkzeuge. 4. Ziehen Sie per Drag & Drop folgende Controls in Ihr Bild: 1.PLC-Code-Anzeige Zeigt die PLC-Programmbausteine, die in den Programmiersprachen KOP, FUP oder S7-GRAPH programmiert wurden. Fehler einer S7-GRAPH Schrittkette werden direkt am entsprechenden Schritt angezeigt. Das in der PLC-Code-Anzeige darzustellende Netzwerk, wird über benutzerdefinierte Funktionen festgelegt. - OpenViewerS7GraphByBlock() - OpenViewerIECPLByCall() - OpenViewerIECPLByFCCall() - OpenViewerIECPByAssignment() 2.Skriptdiagnose Dieses Objekt dient dazu, Inhalte aus Skripten darzustellen. 3.S7-GRAPH-Übersicht Dieses Objekt dient zur Anzeige des aktuellen Programmstatus für ausgeführte Schritte der PLC-Ablaufkette. Fehler beim Ablauf eines Programms werden direkt am entsprechenden Schritt angezeigt. Hinweis Die PLC-Code-Anzeige sowie die S7-GRAPH-Übersicht verfügen über ein Fehler Ereignis. Mithilfe dieses Ereignisses können Sie auf Fehler reagieren, mittels VB-Skript oder C-Skript. Beitrags-ID: , V2.0, 11/

11 5.3 Projektierung S7 GRAPH Übersicht 5.3 Projektierung S7 GRAPH Übersicht In diesem Abschnitt wird gezeigt wie Sie das Objekt S7 GRAPH Übersicht projektieren. Tabelle 5-3 Nr. Aktion 1. Erstellen Sie einen S7-GRAPH Baustein mit Schrittkette und öffnen Sie diesen. 2. Öffnen Sie das Menü Bearbeiten und aktivieren Sie die Schaltfläche Interne Parameter sichtbar/erreichbar aus HMI. 3. Öffnen Sie das HMI Bild, in das Sie die S7-GRAPH-Übersicht eingefügt haben. 4. Wählen Sie in den Eigenschaften des Controls als Zugeordnete S7-GraphDB- Variable eine Variable des S7-GRAPH Bausteins aus. Beitrags-ID: , V2.0, 11/

12 5.3 Projektierung S7 GRAPH Übersicht Hinweis Sie können mittels des Objektes PLC-Code-Anzeige einen aufgerufenen Schritt aus einer Ablaufkette darstellen. Projektieren Sie hierfür ein C-Skript an einem Klick Ereignis und fügen Sie die Funktion OpenViewerS7GraphByBlock() ein. Weitere Informationen zur Funktion OpenViewerS7GraphByBlock() finden Sie im Kapitel Hinweis Sie können mittels eines VBScript die aktuelle Schrittkette der S7-GRAPH- Übersicht wechseln, während die Runtime im Betrieb ist. Beispiel Funktionsaufruf Dim graphctrl Set graphctrl = ScreenItems("S7-GraphOverview1") graphctrl.cpuname = PLC_1 graphctrl.blockname = S7_Graph_DB Beitrags-ID: , V2.0, 11/

13 5.4 Projektierung C-Skripte 5.4 Projektierung C-Skripte In diesem Abschnitt wird gezeigt, wie Sie C-Skripte für die PLC-Code-Anzeige und die Anzeige in STEP 7 erstellen. Tabelle 5-4 Nr. Aktion 1. Erstellen Sie in der Projektnavigation unter dem Ordner Skripte C- Skripte 8 neue C Funktionen. - OpenTIAPortalIECPLByAssignment - OpenTIAPortalIECPLByCall - OpenTIAPortalProject - OpenTIAPortalS7GraphByBlock - OpenViewerIECPLByAssignment - OpenViewerIECPLByCall - OpenViewerIECPLByFCCall - OpenViewerS7GraphByBlock 2. Öffnen Sie ein HMI Bild und erstellen Sie 8 Schaltflächen zum Aufruf der Skripte. 3. Rufen Sie am Ereignis Klicken der jeweiligen Schaltfläche die zugehörige C- Funktion auf. Beitrags-ID: , V2.0, 11/

14 5.5 Anzeige in der PLC-Code-Anzeige 5.5 Anzeige in der PLC-Code-Anzeige In diesem Abschnitt wird gezeigt, wie Sie mittels der Funktionen OpenViewerS7GraphByBlock() Open ViewerIECPLByCall() OpenViewerIECPLByFCCall() OpenViewerIECPByAssignment() den Programmcode in der PLC-Code-Anzeige darstellen. Feste Parameter Folgende Parameter sind für alle 4 Funktionen gleich. Tabelle 5-5 Parameter dwflags Funktion Bit Feld, in dem die einzelnen Werte bitweise mit ODER verknüpft werden. Standardmäßig sollte dwflags 0 sein. Mit dwflags können, Sie Einfluss auf den Aufruf der einzelnen Funktionen nehmen. Sie können zum Beispiel einstellen, dass nach einem Teilstring innerhalb eines Strings gesucht wird. IpszServerPrefix IpszPictureName Weitere Informationen finden Sie in der TIA Portal Hilfe unter Prozesse visualisieren Schnittstellen Runtime API Funktionen zur Anzeige von PLC-Code Anzeige in der PLC-Code-Anzeige. Der Parameter ist für spätere Erweiterungen reserviert. Name des Bildes mit der PLC-Code-Anzeige. IpszObjectName Name der PLC-Code-Anzeige. IpszCpuName Name der S7-CPU. Der Name ist identisch mit dem Stationsnamen, der in der Projektnavigation im TIA Portal angezeigt wird. IpdmError Zeiger auf die Daten der erweiterten Fehlermeldung in der Beitrags-ID: , V2.0, 11/

15 5.5 Anzeige in der PLC-Code-Anzeige Parameter Funktion Struktur CMN_ERROR. Im Fehlerfall schreibt das System Fehlerinformationen in diese Struktur. Aufbau Struktur dwerror1 dwerror5 Enthält die Informationen, welcher Fehlerfall aufgetreten ist. Weitere Informationen zum Fehlerfall finden Sie in der TIA Portal Hilfe unter Prozesse visualisieren Schnittstellen Runtime API Fehlerbehandlung. szerrortext Puffer für textuelle Beschreibung der Fehlerursache. Beitrags-ID: , V2.0, 11/

16 5.5 Anzeige in der PLC-Code-Anzeige Funktion OpenViewerIECPLByFCCall() Beschreibung Die Funktion zeigt für die PLC-Sprachen KOP und FUP die Vorverschaltung eines Netzwerkeingangs eines Standardbausteins unter Berücksichtigung der UDT- Instanz in der PLC-Code-Anzeige an. Deklaration Folgende Parameter müssen zusätzlich zu den festen Parametern in Kapitel 5.5 hinzugefügt werden. Tabelle 5-6 Parameter IpszContainingBlock IpszCalledBlock IpszPin IpszUdtInstance Funktion Name des Bausteins, der geöffnet und angezeigt werden soll, oder Name der Instanz eines FBs. Als Name können verwendet werden: - Name eines Singleinstanz DBs - Name einer Multiinstanz in einem Instanz-DB. - Name eines FCs Name der lokalen oder globalen Instanz, die im IpszContainingBlock gehörigen Code-Baustein aufgerufen wird. Bei lokalen Instanzen muss hier das Hash-Zeichen mit angegeben werden. Bei globalen Instanz DBs muss der globale Name ohne das Hash-Zeichen # angegeben werden. Name eines Input-Pins vom IpszCalledBlock. Der Parameter dient dazu, dass in der PLC-Code-Anzeige das Netzwerk angezeigt wird, das mit dem Input-Pin verschaltet ist. Mit dem Parameter kann die Anzeige eines mehrfach aufgerufenen FBs oder FCs eingegrenzt werden. Die Eingrenzung erfolgt anhand der an einem beliebigen Input-Pin oder In/Out- Pin verschalteten UDT-Instanz. Beispiel Funktionsaufruf In diesem Beispiel wird gezeigt, wie Sie innerhalb des Funktionsbausteins Simu_Zylin1 die Vorverschaltung des Netzwerkeingangs einer UDT-Instanz anzeigen. #pragma code("kopapi.dll") #include "kopapi.h" #pragma code() BOOL result; CMN_ERROR error; DWORD dwflags = 0; char* serverprefix = ""; char* screenname = "Bild_1"; Beitrags-ID: , V2.0, 11/

17 5.5 Anzeige in der PLC-Code-Anzeige char* objectname = "PLCCodeAnzeige"; char* cpuname = "PLC_1"; char* containingblock = "Simu_Zylin1"; char* calledblock = "Simu_Zylin2_DB"; char* pinname = "Error"; char* UdtInstance = "\"UDT_DB\".Error"; result = OpenViewerIECPLByFCCall(dwFlags, serverprefix, screenname, objectname, cpuname, containingblock, calledblock, pinname, udtinstance, &error); if(!result) { printf("openvieweriecplbyfccall failed: err1=%ld, err2=%ld, "" err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r\n", result, error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerrortext); } Ausgabe im PLC-Code-Viewer Abbildung 5-2 Beitrags-ID: , V2.0, 11/

18 5.5 Anzeige in der PLC-Code-Anzeige Funktion OpenViewerIECPLByCall() Beschreibung Die Funktion zeigt in den PLC-Sprachen KOP und FUP die Vorverschaltung eines Netzwerkeingangs eines Standardbausteins in der PLC-Code-Anzeige an. Deklaration Folgende Parameter müssen zusätzlich zu den festen Parametern in Kapitel 5.5 hinzugefügt werden. Tabelle 5-7 Parameter IpszContainingBlock IpszCalledBlock IpszPin Funktion Name des Bausteins der geöffnet und angezeigt werden soll oder Name der Instanz eines FBs. Als Name können verwendet werden: - Name eines Singleinstanz DBs - Name einer Multiinstanz in einem Instanz-DB. - Name eines FCs Name der lokalen oder globalen Instanz, die zu IpszContainingBlock gehörigen Code-Baustein aufgerufen wird. Bei lokalen Instanzen muss hier das Hash-Zeichen mit angegeben werden. Bei globalen Instanz DBs muss der globale Name ohne das Hash-Zeichen # angegeben werden. Name eines Input-Pins vom IpszCalledBlock. Der Parameter dient dazu, dass in der PLC-Code-Anzeige das Netzwerk angezeigt wird, das mit dem Input-Pin verschaltet ist. Beispiel Funktionsaufruf In diesem Beispiel wird gezeigt, wie Sie innerhalb des Funktionsbausteins Simu_Zylin1 die Vorverschaltung des Netzwerkeingangs vom Funktionsbaustein Simu_Zylin2 den Eingangspin air cylinder on anzeigen. #pragma code("kopapi.dll") #include "kopapi.h" #pragma code() BOOL result; CMN_ERROR error; DWORD dwflags = 0; char* serverprefix = ""; char* screenname = "Bild_1"; char* objectname = "PLCCodeAnzeige"; char* cpuname = "PLC_1"; char* containingblock = "Simu_Zylin1"; char* calledblock = "Simu_Zylin2_DB"; Beitrags-ID: , V2.0, 11/

19 5.5 Anzeige in der PLC-Code-Anzeige char* pinname = "air cylinder on"; result = OpenViewerIECPLByCall(dwFlags, serverprefix, screenname, objectname, cpuname, containingblock, calledblock, pinname, &error); if(!result) { printf("openvieweriecplbycall failed: err1=%ld, err2=%ld, err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r\n", result, error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerrortext); } Ausgabe im PLC-Code-Viewer Abbildung 5-3 Beitrags-ID: , V2.0, 11/

20 5.5 Anzeige in der PLC-Code-Anzeige Funktion OpenViewerIECPLByAssignment() Beschreibung Die Funktion zeigt für die PLC-Sprachen KOP und FUP die Zuweisung auf einen Operanden und dessen Vorverschaltung in der PLC-Code-Anzeige an. Deklaration Folgende Parameter müssen zusätzlich zu den festen Parametern in Kapitel 5.5 hinzugefügt werden. Tabelle 5-8 Parameter IpszContainningBlock IpszOperand Funktion Name des Bausteins der geöffnet und angezeigt werden soll oder Name der Instanz eines FBs. Als Name können verwendet werden: - Name eines Singleinstanz DBs - Name einer Multiinstanz in einem Instanz-DB. - Name eines FCs Name eines lokalen oder globalen Operanden auf den zugewiesen wird. Beispiel Funktionsaufruf In diesem Beispiel wird gezeigt wie Sie innerhalb des Funktionsbausteins Simu_Zylin1 den Operanden Start anzeigen. #pragma code("kopapi.dll") #include "kopapi.h" #pragma code() BOOL result; CMN_ERROR error; DWORD dwflags = 0; char* serverprefix = ""; char* screenname = "Bild_1"; char* objectname = "PLCCodeAnzeige"; char* cpuname = "PLC_1"; char* containingblock = "Simu_Zylin1"; char* operand = "Start"; result = OpenViewerIECPLByAssignment(dwFlags, serverprefix, screenname, objectname, cpuname, containingblock, operand, &error); if(!result) { printf("openvieweriecplbyassignment failed: err1=%ld, err2=%ld, err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r\n", result, Beitrags-ID: , V2.0, 11/

21 5.5 Anzeige in der PLC-Code-Anzeige error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerrortext); } Ausgabe im PLC-Code-Viewer Abbildung 5-4 Beitrags-ID: , V2.0, 11/

22 5.5 Anzeige in der PLC-Code-Anzeige Funktion OpenViewerS7GraphByBlock() Beschreibung Die Funktion zeigt einen in der PLC Sprache S7-GRAPH aufgerufenen Schritt aus einer Ablaufkette in der PLC-Code-Anzeige an. Deklaration Folgende Parameter müssen zusätzlich zu den festen Parametern in Kapitel 5.5 hinzugefügt werden. Tabelle 5-9 Parameter IpszBlock dwstepnumber Funktion Instanzname des S7-GRAPH Bausteins, der angezeigt werden soll. Nummer des Schritts der angezeigt werden soll. Mit dwstepnumber = 0 wird der aktive Schritt automatisch gesucht. Beispiel Funktionsaufruf In diesem Beispiel wird gezeigt, wie Sie die S7 GRAPH Schrittkette S7_Graph_DB in der anzeigen. #pragma code("kopapi.dll") #include "kopapi.h" #pragma code() BOOL result; CMN_ERROR error; DWORD dwflags = 0; char* serverprefix = ""; char* screenname = "Bild_1"; char* objectname = "PLCCodeAnzeige"; char* cpuname = "PLC_1"; char* instancedbname = "S7_Graph_DB"; DWORD stepnumber = 0; result = OpenViewerS7GraphByBlock(dwFlags, serverprefix, screenname, objectname, cpuname, instancedbname, stepnumber, &error); if(!result) { printf("openviewers7graphbyblock failed: err1=%ld, err2=%ld, err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r\n", result, error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerrortext); } Beitrags-ID: , V2.0, 11/

23 5.5 Anzeige in der PLC-Code-Anzeige Ausgabe im PLC-Code-Viewer Abbildung 5-5 Beitrags-ID: , V2.0, 11/

24 5.6 Anzeige in STEP Anzeige in STEP 7 In diesem Abschnitt wird gezeigt, wie Sie mittels der Einsprung-Funktionen OpenTIAPortalProject() OpenTIAPortalIECPLByCall() OpenTIAPortalIECPLByAssignment() OpenTIAPortalS7GraphByBlock() in ein projektiertes TIA Portal Projekt springen. Feste Parameter Folgende Parameter sind für alle 4 Funktionen gleich. Tabelle 5-10 Parameter dwflags Funktion Bit Feld, in dem die einzelnen Werte bitweise mit ODER verknüpft werden. Standardmäßig sollte dwflags 0 sein. Mit dwflags können, Sie Einfluss auf den Aufruf der einzelnen Funktionen nehmen. Sie können zum Beispiel einstellen, dass nach dem Öffnen des Bausteins das TIA Portal nicht in den Online Modus geht. IpszTiaPortalProjectPath Weitere Informationen finden Sie in der TIA Portal Hilfe unter Prozesse visualisieren Schnittstellen Runtime API Funktionen zur Anzeige von PLC-Code Anzeige in STEP 7. Name der Projektdatei einschließlich der Angabe des absoluten Pfades. Achten Sie darauf, dass innerhalb einer C Funktion der doppelte Backslash(\\) für Pfadangaben zu verwenden ist. Beispiel: C:\\Users\\WinCC\\Documents\\...\\.ap13 IpszErrorTag IpdmError Achten Sie auf die Endung. Diese entspricht der Version Ihres TIA Portal Projektes. Für V12 Projekte ist beispielsweise die Endung.ap12 vorgesehen. Name einer internen WinCC Variable vom Datentyp String. Beim Aufruf von asynchronen Funktionen, die nicht sofort ein Ergebnis liefern, werden in IpszErrorTag die Fehlerinformationen zurückgeliefert. Zeiger auf die Daten der erweiterten Fehlermeldung in der Struktur CMN_ERROR. Im Fehlerfall schreibt das System Fehlerinformationen in diese Struktur. Aufbau Struktur dwerror1 dwerror5 Beitrags-ID: , V2.0, 11/

25 5.6 Anzeige in STEP 7 Parameter Funktion Enthält die Informationen, welcher Fehlerfall aufgetreten ist. Weitere Informationen zum Fehlerfall finden Sie in der TIA Portal Hilfe unter Prozesse visualisieren Schnittstellen Runtime API Fehlerbehandlung. szerrortext Puffer für textuelle Beschreibung der Fehlerursache. Beitrags-ID: , V2.0, 11/

26 5.6 Anzeige in STEP Funktion OpenTIAPortalProject() Beschreibung Mit dieser Funktion können, Sie das TIA Portal starten und ein Projekt öffnen. Beispiel Funktionsaufruf In diesem Beispiel wird gezeigt, wie Sie das TIA Portal aus der Runtime Professional heraus öffnen. #pragma code("kopapi.dll") #include "kopapi.h" #pragma code() BOOL result; CMN_ERROR error; DWORD dwflags = 0; char* TiaPortalProject = " C:\\Users\\WinCC\\PLCCodeAnzeige.ap13"; char* ErrorTag = "Fehler"; result = OpenTIAPortalProject(dwFlags, TiaPortalProject, ErrorTag, &error); if(!result) { printf("opentiaportalproject failed: err1=%ld, err2=%ld, "" err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r\n", result, error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerrortext); } Ausgabe im TIA Portal Abbildung 5-6 Beitrags-ID: , V2.0, 11/

27 5.6 Anzeige in STEP Funktion OpenTIAPortalIECPLByCall() Beschreibung Die Funktion wird für die Sprachen KOP und FUP verwendet und zeigt die Vorverschaltung eines Netzwerkeingangs eines Standardbausteins. Deklaration Folgende Parameter müssen zusätzlich zu den festen Parametern in Kapitel 5.6 hinzugefügt werden. Tabelle 5-11 Parameter IpszCpuName IpszContainingBlock IpszCalledBlock IpszPin Funktion Name der S7-CPU. Der Name ist identisch mit dem Stationsnamen, der in der Projektnavigation im TIA Portal angezeigt wird. Name des Bausteins, der geöffnet und angezeigt werden soll oder Name der Instanz eines FBs. Als Name können verwendet werden: - Name eines Singleinstanz DBs - Name einer Multiinstanz in einem Instanz-DB. - Name eines FCs oder OBs Name der lokalen oder globalen Instanz, die im IpszContainingBlock gehörigen Code-Baustein aufgerufen wird. Bei lokalen Instanzen muss hier das Hash-Zeichen mit angegeben werden. Bei globalen Instanz DBs muss der globale Name ohne das Hash-Zeichen # angegeben werden. Name eines Input-Pins vom IpszCalledBlock. Der Parameter dient dazu, dass im Editor des Netzwerks der spezifizierte Pin sichtbar angezeigt wird. Beispiel Funktionsaufruf In diesem Beispiel wird gezeigt wie sie aus der Funktion Simu_Error die Vorverschaltung des Eingangspin Error1 im TIA Portal anzeigen. #pragma code("kopapi.dll") #include "kopapi.h" #pragma code() BOOL result; CMN_ERROR error; DWORD dwflags = 0; char* TiaPortalProject = " C:\\Users\\WinCC\\PLCCodeAnzeige.ap13"; char* CpuName = "PLC_1"; char* ContainingBlock = "Main"; Beitrags-ID: , V2.0, 11/

28 5.6 Anzeige in STEP 7 char* CalledBlock = "Simu_Error"; char* Pin = "Error1"; char* perrortag = "Error"; result = OpenTIAPortalIECPLByCall(dwFlags, TiaPortalProject, CpuName, ContainingBlock, CalledBlock, Pin, perrortag, &error); printf("opentiaportaliecplbycall failed: err1=%ld, err2=%ld, "" err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r\n", result, error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerrortext); Ausgabe im TIA Portal Abbildung 5-1 Beitrags-ID: , V2.0, 11/

29 5.6 Anzeige in STEP Funktion OpenTIAPortalIECPLByAssignment() Beschreibung Die Funktion wird für die Sprachen KOP und FUP verwendet und zeigt die Zuweisung auf einen Operanden und dessen Vorverschaltung. Deklaration Folgende Parameter müssen zusätzlich zu den festen Parametern in Kapitel 5.6 hinzugefügt werden. Tabelle 5-12 Parameter IpszCpuName IpszContainingBlock IpszOperand Funktion Name der S7-CPU. Der Name ist identisch mit dem Stationsnamen, der in der Projektnavigation im TIA Portal angezeigt wird. Name des Bausteins der geöffnet und angezeigt werden soll oder Name der Instanz eines FBs. Als Name können verwendet werden: - Name eines Singleinstanz DBs - Name einer Multiinstanz in einem Instanz-DB. - Name eines FCs oder OBs Name eines lokalen oder globalen Operanden. Beispiel Funktionsaufruf In diesem Beispiel wird gezeigt wie Sie aus dem Organisationsbaustein Main die Vorverschaltung des Operanden Start im TIA Portal anzeigen. #pragma code("kopapi.dll") #include "kopapi.h" #pragma code() BOOL result; CMN_ERROR error; DWORD dwflags = 0; char* TiaPortalProject = " C:\\Users\\WinCC\\PLCCodeAnzeige.ap13"; char* CpuName = "PLC_1"; char* ContainingBlock = "Main"; char* Operand = " Start"; char* ErrorTag = "Error"; result = OpenTIAPortalIECPLByAssignment(dwFlags, TiaPortalProject, CpuName, ContaingBlock, Operand, ErrorTag, &error); printf("opentiaportaliecplbyassignment failed: err1=%ld, err2=%ld, "" err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r\n", result, Beitrags-ID: , V2.0, 11/

30 5.6 Anzeige in STEP 7 error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerrortext); Ausgabe im TIA Portal Abbildung 5-7 Beitrags-ID: , V2.0, 11/

31 5.6 Anzeige in STEP Funktion OpenTIAPortalS7GraphByBlock() Beschreibung Die Funktion wird für Programmbausteine in der Sprache S7-GRAPH verwendet und zeigt einen Schritt in einer Ablaufkette. Deklaration Folgende Parameter müssen zusätzlich zu den festen Parametern in Kapitel 5.6 hinzugefügt werden. Tabelle 5-13 Parameter IpszCpuName IpszBlock dwstepnumber Funktion Name der S7-CPU. Der Name ist identisch mit dem Stationsnamen der in der Projektnavigation im TIA Portal angezeigt wird. Instanzname des S7-GRAPH Bausteins der angezeigt werden soll. Nummer des Schritts der angezeigt werden soll. Mit dwstepnumber = 0 wird der aktive Schritt automatisch aktiviert. Beispiel Funktionsaufruf In diesem Beispiel wird gezeigt, wie Sie die S7-GRAPH Schrittkette S7_Graph im TIA Portal anzeigen. #pragma code("kopapi.dll") #include "kopapi.h" #pragma code() BOOL result; CMN_ERROR error; DWORD dwflags = 0; char* TiaPortalProject = " C:\\Users\\WinCC\\PLCCodeAnzeige.ap13"; char* CpuName = "PLC_1"; char* Block = "S7_Graph_DB" DWORD stepnumber = 0; char* ErrorTag = "Error"; result = OpenTIAPortalS7GraphByBlock(dwFlags, TiaPortalProject, CpuName, Block, stepnumber, ErrorTag, &error); printf("opentiaportals7graphbyblock failed: err1=%ld, err2=%ld, "" err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r\n", result, error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerrortext); Beitrags-ID: , V2.0, 11/

32 5.6 Anzeige in STEP 7 Ausgabe im TIA Portal Abbildung 5-8 Beitrags-ID: , V2.0, 11/

33 6 Bedienung der Applikation 6.1 Inbetriebnahme des Beispielprojektes für WinCC 6 Bedienung der Applikation Es werden Ihnen im Rahmen dieser Anwendung folgendes Beispielprojekt angeboten. WinCC Professional zeigt den Programmstatus von PLC-Programmen in der PLC-Code-Anzeige an und ermöglicht mittels der STEP 7 Anzeige direkt in die Verwendungsstelle im TIA Portal zu wechseln. 6.1 Inbetriebnahme des Beispielprojektes für WinCC Tabelle 6-1 Nr. Aktion 1. Entpacken Sie die Datei _WinCC_Code.zip. 2. Starten Sie das TIA Portal. 3. Dearchivieren Sie das Projekt PLC_Code_Viewer.zap Laden Sie das Projekt in die CPU oder starten Sie die Simulation. 5. Starten Sie die Runtime. 6.2 Bedienung des Beispielprojekts Abbildung Beitrags-ID: , V2.0, 11/

34 6 Bedienung der Applikation 6.2 Bedienung des Beispielprojekts Tabelle 6-2 Nr. Aktion 1. Drücken Sie die Rundschaltfläche zum Einschalten der Schrittkette für die simulierte Prägemaschine. 2. Geben Sie im E/A-Feld den Pfad des TIA Portal Projektes ein. Der Pfad wird für die Funktionen OpenTIAPortalProject, OpenTIAPortalIECPLByCall, OpenTIAPortalIECPLbyAssignment und OpenTIAPortalS7GraphByBlock benötigt. 3. Drücken Sie die Schaltflächen um die Befehle für die und das Tia Portal aufzurufen. Beitrags-ID: , V2.0, 11/

35 7 Literaturhinweise 7 Literaturhinweise Tabelle 7-1 Themengebiet Titel \1\ Siemens Industry Online Support \2\ Downloadseite des Beitrages Historie Tabelle 8-1 Version Datum Änderung V1.0 07/2015 Erste Ausgabe V2.0 11/2015 Aktualisierung des Beispielprojektes Beitrags-ID: , V2.0, 11/