Teil C Programmbeschreibung
Micro Automation
Haftung Eine Haftung der Siemens AG, gleich aus welchem Rechtsgrund, fr durch die Verwendung der vorliegenden Applikation verursachte Schden ist ausgeschlossen, soweit nicht z.B. bei Schden an privat genutzten Sachen, Personenschden oder wegen Vorsatzes oder grober Fahrlssigkeit zwingend gehaftet wird. Gewhrleistung Bei den Programmbeispielen handelt es sich um ausgewhlte Lsungsvorschlge zu Anfragen mit komplexen Aufgaben, die im Customer Support erarbeitet wurden. Wir weisen auerdem darauf hin, dass es nach dem Stand der Technik nicht mglich ist, Fehler in Softwareprogrammen unter allen Anwendungsbedingungen auszuschlieen. Die Programmbeispiele wurde nach bestem Wissen erstellt. Eine Haftung die ber die bliche Gewhrleistung fr Software der Klasse C entsprechend unseren "Allgemeinen Bedingungen fr die berlassung von Softwareprodukten fr Automatisierungs- und Antriebstechnik" hinaus geht, knnen wir jedoch nicht bernehmen. Die Programmbeispiele werden im Internet als Einzellizenzen angeboten. Eine Weitergabe an Dritte ist nicht gestattet.
Inhaltsverzeichnis
Teil A1 : Applikationsbeschreibung............................................................................ 8 1 2 2.1 2.2 2.3 2.4 2.5 3
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Automatisierungsaufgabe......................................................................... 9 Automatisierungslsung......................................................................... 11 bersicht .................................................................................................... 11 E-Mail Statuspuffer..................................................................................... 12 Kernfunktionen ........................................................................................... 13 Erforderliche Standardkomponenten ......................................................... 15 Applikationssoftware-Komponenten........................................................... 17 Leistungseckdaten................................................................................... 18
Teil A2 : Funktionsmechanismen.............................................................................. 19 4 4.1 4.2 4.3 4.3.1 4.3.2 4.3.3 4.3.4 4.3.5 4.3.6 4.3.7 4.3.8 4.4 Funktionsmechanismen .......................................................................... 20 berblick .................................................................................................... 22 E-Mail Aufbau............................................................................................. 22 Micro/WIN-Projekt ...................................................................................... 26 Hauptprogramm MAIL_MAIN (OB 1)....................................................... 26 Unterprogramm ETH0_CTRL (SBR0) ..................................................... 26 Unterprogramm MAIL_EVENT (SBR4) ................................................... 27 Unterprogramm MAIL_ORG (SBR5) ....................................................... 31 Unterprogramm MAIL_ACKN (SBR6) ..................................................... 32 Unterprogramm MAIL_IN_OUT (SBR7) .................................................. 32 Unterprogramm ETH0_EMAIL (SBR1).................................................... 33 Datenbaustein ............................................................................................ 34 Java-Applikation......................................................................................... 35
Teil B : Installation der Beispielapplikation ............................................................. 38 5 5.1 5.2 5.3 6 6.1 6.2 Inbetriebnahme der Hard- und Software................................................ 39 Einrichten der Bedienstation (PG/ PC)....................................................... 39 Hardwareaufbau......................................................................................... 45 Einrichten der Steuerung und des CP 243-1 IT ......................................... 47 Bedienung der Applikation ..................................................................... 54 Alarme auslsen ........................................................................................ 54 Alarme quittieren ........................................................................................ 56
3/65
Teil C : Programmbeschreibung ............................................................................... 58 7 7.1 7.2 8 8.1 8.2 8.3 8.4 Details des Micro/WIN-Projektes ............................................................ 59 Micro/WIN-Programmcode......................................................................... 59 Belegte Speicher und Timer....................................................................... 60 Vernderungen im Micro/WIN-Projekt.................................................... 63 Event-Bits verschalten ............................................................................... 63 Speichern von realen Prozesswerten ........................................................ 64 Timeout-Werte ndern ............................................................................... 64 E-Mail Aufbau ndern ................................................................................ 65
4/65
Prambel
Aufbau des Themenkomplexes Das Thema Wide Area Network - Kommunikation mit dem SIMATIC CP 243-1 IT ist aufgrund seiner groen Komplexitt in mehrere Teilapplikationen aufgeteilt, die einzeln im Intra- und Internet erhltlich sind. Alle diese Einzeldokumente/- Applikationen, sind voneinander unabhngig installierbar und fr sich alleine ablauffhig. Jedes Einzeldokument enthlt die fr diese Teilfunktion notwendigen Informationen. Alle Einzeldokumente/-Applikationen und Funktionen sind so realisiert, dass sie auch zusammen auf einer Hardware getestet werden knnen. Als Klammer um diese funktionsorientierten Themensammlungen dient der Band Auswahl und Aufbau einer Wide Area Network - Kommunikation. Er beinhaltet neben den Grundlagen zum Gesamtthema die notwendigen infrastrukturellen Manahmen, um die obigen Einzelapplikationen ber eine reales WideAreaNetwork (ISDN-Ankopplung, Mobilfunknetz) zu betreiben. Fr das tiefere Verstndnis der Gesamtzusammenhnge ist dieser Band auf jeden Fall zu empfehlen. Die folgende Grafik verdeutlicht diesen Zusammenhang und die Positionierung der hier vorliegenden Applikation im Gesamtkomplex.
MAE 15
Auswahl und Aufbau einer Wide Area Network - Kommunikation
MAE 15A
Steuern und Beobachten mit dem CP 243-1 IT basierend auf Web-Technologie (S7-200, CP243-1 IT und ESM TP40)
MAE 15B
Melden von Anlagenzustnden via E-Mail Melden von Anlagenzustnden weltweit via E-Mail mit dem CP 243-1 IT (S7-200, CP243-1 IT und ESM TP40)
MAE 15C
Datenbertragung per File Transfer Protocol mit dem CP 243-1 IT IT (S7-200, CP243-1 IT und ESM TP40)
Bild 0-1
Konfigurationsband
5/65
Inhalt dieses Dokuments In der heutigen Automatisierungswelt arbeiten dezentrale Anlagen hufig im automatischen Betrieb. Das heit, dass das Bedien- und Wartungspersonal nur noch bei Bedarf vor Ort ist. Hier gilt es Mechanismen zu schaffen, die eine Bedienung und berwachung der Station von entfernten Terminals in einer Zentrale aus ermglichen. Eine wichtige Aufgabe ist es, das Bedienpersonal von auftretenden Alarmen unverzglich zu informieren, unabhngig vom derzeitigen Aufenthaltsort der jeweiligen Person. Hierfr bietet sich der Versand von E-Mail an. Diese kann von stationren oder mobilen Mail Clients weltweit empfangen werden. Dazu muss die dezentrale Anlage in der Lage sein, E-Mails zu generieren und zu versenden. Der SIMATIC CP 243-1 IT stellt diese Funktionalitt zur Verfgung. Fr die Applikation werden unterschiedliche Komponenten (Hard- und Software) bentigt. Diese werden zum Teil mit dieser Applikation mitgeliefert, teilweise stellen Sie die Komponenten zur Verfgung. Um welche Komponenten es dabei im einzelnen geht und wie deren Zusammenspiel miteinander funktioniert, wird in dieser Dokumentation vermittelt. Sie erhalten hier eine Komplettlsung und werden durch die zur Verfgung gestellte Applikationssoftware von Parametrier- und Programmieraufgaben entlastet.
SIEMENS Standard-PC Antriebe mit und Motoren Mail Server und Web-Browser (HW+SW) Client
Bild 0-2
6/65
Integrierte Funktionalitten Eintrag von auftretenden Alarmen in einen Statuspuffer Versand einer E-Mail an den fr den Alarm parametrierten Empfnger Mail enthlt Zeitstempel des Ereignisses und zwei Prozesswerte Quittierung des Alarms durch den Benutzer Erneutes Versenden der gleichen Mail an einen weiteren Empfnger, wenn innerhalb einer festgelegten Zeit keine Quittierung erfolgte Signalisierung eines Alarms, wenn die Quittierung wieder ausbleibt Denkbare Einsatzbereiche fr diese Applikation liegen bei Kleinen Wasserkraftwerken Windkraftwerken Klranlagen
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
7/65
Teil A1 : Applikationsbeschreibung
Ziel Teil A1 Der Teil A1 dieses Dokuments soll dem Leser das Automatisierungsproblem klarmachen eine Lsungsmglichkeit aufzeigen die Leistungsfhigkeit der Gesamtapplikation aufzeigen.
8/65
Automatisierungsaufgabe
Problemstellung Melden von Alarmen mit Standard Mail Client: Alarme in dezentralen Anlagen mssen unverzglich an das Service Personal gemeldet werden. Dies kann ber verschiedene Mechanismen erfolgen. In den meisten Anlagen bzw. Firmennetzen existiert eine Ethernet Infrastruktur, die das Standard Protokoll TCP/IP untersttzt. Da zudem in nahezu allen Bronetzen Standard Mail Clients Verwendung finden, bietet es sich an, Meldungen von der Anlage per Mail zu versenden. Quittieren von E-Mail Meldungen: Aus Anwendersicht ist es oft fr den Prozess wichtig zu erfahren, ob eine Meldung auch korrekt angekommen ist. Dazu ist ein Quittiermechanismus notwendig. Der CP 243-1 IT ist als Mail Client implementiert, sodass auf diesem Weg keine Quittierung erfolgen kann. ber den Umweg einer JavaApplikation, welche direkt auf den Variablenspeicher der Steuerung zugreift, ist dies jedoch mglich. Struktureller Aufbau
Lokale Datenverarbeitung
TCP/IP-Verbindung (WAN)
QuittierSoftware
Netzanschluss
Mail Client
Bild 1-1
Lokale Datenverarbeitung
Mail Server
9/65
Anforderungen an die Lsung Alle S7-Stationen knnen ihre zustands- oder aktionsgetriggerten Meldungen selbststndig absenden. Dies geschieht durch den E-Mail Mechanismus des CP 243-1 IT. Es sollen 16 E-Mail Meldungen fr jeweils 2 Empfnger (insgesamt 32 E-Mail Meldungen) konfigurierbar sein. Die Meldungen sollen einen Zeitstempel und 2 Prozesswerte, die beim Auftreten des Ereignisses erfasst werden, enthalten. Eine Erweiterung durch den Anwender soll einfach mglich sein. Die Simulation der Ereignisse zum Auslsen der E-Mail Meldung soll ber digitale Eingnge erfolgen. Zum Quittieren der Meldungen soll eine Java-Applikation dienen, welche ber einen Link im Text der Mail aufgerufen wird. Technologische bersicht
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Diese Anforderungen werden mit dem E-Mail Mechanismus erfllt. Am fiktiven Beispiel eines Wasserkraftwerkes (Anlage) mit Leitstelle (Zentrale) soll gezeigt werden, wie Alarme per E-Mail gemeldet werden. Die Datenbertragung erfolgt ber ein Local Area Network (LAN).
Bild 1-2
Ein E-Mail Server (hier im Bild in der Zentrale) nimmt die vom CP 243-1 IT gesendeten E-Mails entgegen. Der Empfnger bentigt zum Lesen dieser E-Mails einen E-Mail Client auf seinem Rechner. Die meisten Microsoft Betriebssysteme enthalten bereits ein einfachen vorinstallierten E-MailClient (z.B. Outlook Express), der zu diesem Zweck genutzt werden kann. Dabei kann der E-Mail Server und E-Mail Client auf ein und demselben Rechner ablaufen.
10/65
Automatisierungslsung
In diesem Kapitel erfahren Sie konkret, wie die vorliegende Applikation das in Kapitel 1 genannte Automatisierungsproblem lst. Dabei wird aufgezeigt, was die Applikation leisten kann und wie sie funktioniert. Die Beschreibung des Funktionsmechanismus hlt sich dabei bewusst auf einem globalen Niveau. Ein tiefergehendes Verstndnis wird Ihnen im Teil A2 dieser Dokumentation vermittelt, den Sie allerdings nur dann bentigen, wenn Sie den Detailablauf und das Zusammenspiel der Lsungskomponenten kennenlernen wollen.
2.1
bersicht
Eine Applikation, die obige Anforderungen erfllt, kann sehr einfach mit dem CP 243-1 IT implementiert werden. Er enthlt neben einem Webserver und einem internen Speichermedium fr Dateien auch einen Mail Client. Dieser kann vom S7-Programm per Funktionsaufruf angesprochen werden. Die Kopplung des CP 243-1 IT an den PC der Zentrale erfolgt ber eine TCP/IP-Verbindung. Ein Mail Server zum Empfang von E-Mails ist im CP 243-1 IT nicht vorhanden. Der Quittiermechanismus wird deshalb per direktem Zugriff auf eine Variable der Steuerung durch eine Java-Applikation realisiert.
Hinweis Die folgende Beschreibung bezieht sich auf eine direkte Verbindung mit einem gekreuzten TCP/IP Kabel. Wie das System mit Routern aufgebaut werden kann, zeigt der zum Themenkomplex zugehrige MAE 15 Konfigurationsband Auswahl und Aufbau einer Wide Area Network- Kommunikation.
Bild 2-1
11/65
Das zentrale Element des vorliegenden Applikationsbeispiels bildet ein Speicherbereich in der Steuerung namens E-Mail Statuspuffer. Er stellt das Bindeglied zwischen den drei Kernfunktionen der Applikation dar.
Alarme eintragen E-Mails senden Alarme quittieren
Im Folgenden werden zuerst der E-Mail Statuspuffer und anschlieend die drei genannten Kernfunktionen beschrieben.
2.2
bersicht
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
E-Mail Statuspuffer
Der Statuspuffer ist ein statischer Speicherbereich in der Steuerung, ber den das Eintragen von Alarmen, das Versenden von E-Mails und das Quittieren gesteuert und verwaltet werden.
Alarme eintragen
E-Mail Statuspuffer
E-Mails senden
16 Speicherpltze [0..15]
Bild 2-2
Alarme quittieren
Der E-Mail Statuspuffer enthlt alle wesentlichen Informationen, die zwischen dem Auftreten eines Alarms (Ereignis) und der Quittierung anfallen. Jeder der 16 mglichen Alarme hat seinen eigenen Statusspeicherplatz. Folgende Informationen sind in jedem Eintrag gespeichert:
Ein Statusbyte, das den aktuellen Bearbeitungszustand der jeweiligen Alarme kennzeichnet. Ein Byte zum Zhlen der Minuten in den Wait for AcknowledgementZustnden. Beim Erreichen eines parametrierbaren Zeitlimits kommt es zum Timeout.
12/65
Die Unterscheidung der unterschiedlichen Status im Statusbyte werden durch entsprechend zugeordnete Zahlenwerte wie folgt vorgenommen:
0 Idle state 1 Send Mail to receiver 1 2 Wait for acknowledgement 1 3 Send Mail to receiver 2 4 Wait for acknowledgement 2
2.3
Kernfunktionen
Alarme eintragen
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Tritt ein Alarm auf, fr welchen zu diesem Zeitpunkt noch kein Sendeauftrag aktiv ist (Status '0'), so wird sein Statusbyte auf 1 gesetzt. Zudem werden die aktuelle Uhrzeit sowie die, dem Alarm zugeordneten Prozesswerte in einem weiteren Speicherbereich, dem sogenannten Erstwertpuffer abgelegt.
Hinweis Wie im Statuspuffer hat auch im Erstwertpuffer jeder der 16 Alarme seinen eigenen Speicherbereich. Eine Abbildung der Speicherbelegung des Erstwertpuffers finden Sie im Bild 4-5.
Wenn der CP 243-1 IT nicht gerade eine E-Mail sendet, werden in jedem CPU Zyklus die Eintrge im E-Mail Statuspuffer geprft. Ist dort ein Statusbyte mit dem Wert 1 vorhanden, dann beginnt folgender Mechanismus:
Der Status des Alarms wird auf 2 gesetzt, wodurch der entsprechende Sendevorgang aktiviert wird. Der CP 243-1 IT sendet, die fr den betreffenden Alarm konfigurierte EMail an den ersten Empfnger. Der Mail-Text enthlt die Daten aus dem Erstwertpuffer. Solange der Erhalt der E-Mail nicht quittiert ist, wird der Zeitwert des Alarms im Statuspuffer mintlich erhht. Die Quittierung setzt das Statusbyte zurck auf 0. Dadurch wird auch der Zeitwert zurckgesetzt. Bleibt die Quittierung bis zum Erreichen des konfigurierten Zeitlimits aus, kommt es zum Timeout. Der Status wird auf 3 und bei Abarbeitung auf 4 gesetzt, wodurch die Sendeprozedur wiederholt wird.
13/65
Die gleiche Mail wird nun noch einmal an den zweiten konfigurierten Empfnger gesendet. Bleibt auch dessen Quittierung aus, werden Status und Zeitwert dennoch zurck gesetzt und es wird an einem digitalen Ausgang der Steuerung ein Fehler signalisiert.
Hinweis Die Erfassung neuer Ereignisse mit neuen Prozesswerten ist nur mglich, wenn das entsprechende Statusbyte zurckgesetzt, also 0 ist.
14/65
2.4
Hardware
Tabelle 2-1
Erforderliche Standardkomponenten
Komponente
Typ
MLFB/ Bestellinfo
Hinweis
PC mit Netzwerkkarte S7-200 CPU CP 243-1 IT Stromversorgung Electrical Switch Module Hinweis
!
Zubehr
Tabelle 2-2
In der CPU 222 ist standardmig keine Hardware-Uhr enthalten, welche fr die Zeitstempel bentigt wird. Diese ist separat zu bestellen (vgl. Tabelle 2-2)
Komponente
Typ
MLFB/ Bestellinfo
Hinweis
PC/PPI-Cable
Zum automatischen Stellen der CPU-Systemzeit kann ein SIPLUS DCF77 verwendet werden. Damit wird die Uhr durch einen Funksender in Frankfurt synchronisiert. Eine beschriebene Automatisierungskonfiguration zu diesem Thema finden Sie im Micro Automation Set 23 S7-CPU Uhrzeit via Zeitzeichensender synchronisieren.
15/65
Software
Tabelle 2-3 Komponente Typ MLFB/ Bestellinfo Hinweis
Programmier- S7-Micro/WIN V3.2 Software SP4 Mail Server Imail Express V8.0 (Freeware) Mail Client Java Virtual Machine Outlook Express 6 JVM 1.4.1
6ES7810-2BC02-0YX0 http://www.ipswitch.com (siehe Downloads) http://www.microsoft.com (siehe Downloads) http://java.sun.com/getjava Kostenlos Oder anderer Mail Client Oder anderer Mail Server
16/65
2.5
Applikationssoftware-Komponenten
Zur Applikationssoftware gehren:
Micro/WIN-Projekt Java-Applikation zum Quittieren (Zurcksetzen der Statusbytes)
Nachfolgend werden die in der S7-CPU ablaufenden Micro/WINProgrammteile aufgezhlt und deren Funktionen und technische Daten angegeben.
Tabelle 2-4 Name Funktionsbeschreibung
Aufruf der Unterprogramme Initialisierung des CP 243-1 IT (automatisch von Internet-Assistenten generiert) Ansto des Sendevorgangs (automatisch von Internet-Assistenten generiert) Lesen der CPU-Zeit (Zeit und Datum) und getrenntes Aufspalten der enthaltenen Zeiteinheiten Speichern der Uhrzeit und der aktuellen Prozesswerte berwachen der Event-Bits und Setzen der dazugehrigen Statusbytes, wenn nicht gerade derjenige Sendeauftrag in Arbeit ist Starten der Mail-Auftrge und Warten auf Quittierung (bei Ausbleiben: Timeout) Zurcksetzen der Statusbytes nach erfolgter Quittierung
ETH0_EMAIL (SBR1) MAIL_CLOCK (SBR2) MAIL_STORE (SBR3) MAIL_EVENT (SBR4) MAIL_ORG (SBR5) MAIL_ACKN (SBR6)
17/65
Leistungseckdaten
In diesem Kapitel geben wir Ihnen einen berblick ber die Leistungsfhigkeit der Beispielapplikation und ihrer Komponenten.
Programmgre
566 Bytes 8 2 1 1024 Zeichen 16 Vordefinierte Timeout-Werte fr beide Empfnger: Jeweils 3 Minuten Benutzername: administrator Passwort: administrator
VB0 bis VB565 I0.0 T37 Jeweils fr zwei Empfnger (insgesamt 32 E-Mails) Mit einer Minute Toleranz nderungen nach Kapitel 8.3 Timeout-Werte ndern mglich Benutzername und Passwort fr die Quittierung per JavaApplikation Vgl. Tabelle 6-3 fr Abfrage nderung Benutzername und Passwort entsprechend der Anleitung in Tabelle 5-9 mglich bis I0.7 Q0.0 bis Q0.1
Verwendete Timer Maximale Lnge eines Mail-Textes Anzahl unterschiedlicher Alarme Timeout-Erkennung
18/65
Teil A2 : Funktionsmechanismen
Ziel Teil A2
Grundstzlich ist die vorliegende Applikation nach einer eventuellen Anpassung an die lokalen Gegebenheiten sofort einsetzbar. Mit der Installationsanleitung knnen Sie die Applikation in Betrieb nehmen, ohne dieses Kapitel durchgearbeitet zu haben. Wollen Sie aber Teile daraus fr Ihren eigenen Anwendungsfall verwenden und dementsprechend modifizieren, werden etwas tiefere Kenntnisse der Zusammenhnge und der Grundlagen bentigt.
19/65
Funktionsmechanismen
Kommunikationswege
Dieses Dokument ist Teil einer Serie, die Applikationen rund um den CP 243-1 IT enthlt. Die folgende Grafik zeigt rot hervorgehoben den E-Mail Kommunikationsweg von einer S7-200 CPU ber den Mail Server in der Zentrale bis zum Mail Client und die daran beteiligten Funktionskomponenten.
Grn hervorgehoben ist hingegen der Quittiermechanismus.
Folgende Komponenten werden dabei sowohl vom Sende- als auch vom Quittiermechanismus genutzt:
LAN-Netzanbindung und Ethernet LAN Programm- und Speicherelemente der S7-200 CPU
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Die Funktionskomponenten, die fr diese Teilapplikation keine Rolle spielen, sind grau dargestellt.
Bild 4-1
20/65
Wie im Bild deutlich wird, knnen E-Mails nur vom CP 243-1 IT zur Zentrale bertragen werden. Der umgekehrte Weg ist mit dem E-Mail Mechanismus des CP 243-1 IT nicht mglich. Deshalb dient eine Java-Applikation dazu, dem Prozess den Meldungsempfang mitteilen zu knnen. Sie kann ber den CP 243-1 IT direkt auf den Variablenspeicher der Steuerung zugreifen.
Beschreibung der Teilkomponenten
Die folgende Tabelle bietet eine Funktionsbeschreibung der Teilkomponenten, die in dieser Applikation miteinander interagieren.
Tabelle 4-1 Ort Gert S7-200 CPU Komponente Sendemechanismus Funktion
Anlage
Versenden von E-Mails per SMTP (Simple Mail Transfer Protocol) an einen Mail Server Hardware und Treiberschichten (Hardware- und Protokolltreiber), die eine TCP/IP Kommunikation ermglichen. (wie bei Anlage) Empfangen der E-Mails vom CP 243-1 IT (per SMTP) Speichern der Mails in den Empfangspostfchern der bekannten Benutzer.
PG/ PC
Zentrale
Mail Client
Holen der E-Mails aus dem entsprechenden Empfangspostfach des Mail Servers per Post Office Protocol (POP3) Quittierung und Zurcksetzen der Alarme, indem das zum Alarm zugehrige Statusbyte durch eine Java-Applikation direkt beschrieben wird (weiter in Abschnitt 4.2)
Quittiermechanismus
21/65
4.1
berblick
Nachfolgende Abbildung zeigt das Zusammenspiel der einzelnen Komponenten und Mechanismen.
Anlage
Anwenderprogramm (Ausfhrung in der S7-200 CPU) Statuspuffer (V-Bereich) 0 SBR 2 - 7 Freigabe Timeout
Event-Bits 0..15
Zentrale
Kapitel 4.3
Datensatz
STATUS
PG/ PC E-Mail
Kapitel 4.4
ZEIT(min)
<FROM> Stationx <TO> Zentrale <Subject> Strung <TEXT> Zeitstempel Meldungstext Mx Prozesswert 1 + 2 (Erstwerte) [Link zu Quittier-Applikation]
QuittierApplikation QUITT
S7API-Beans
15
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
ETH0_EMAIL Quittierung
CP 243-1 IT
LAN
Vorkonfigurierte E-Mail Meldungen (Internet-Assistent) Empfnger 2 Empfnger 1 Meldung M15 Prozesswert 1+2 Meldung M15 Prozesswert 1+2 Empfnger 2 EmpfngerMeldung M1 1 Meldung M1 Prozesswert 1+2 Prozesswert 1+2
Meldung 15
Meldung 0
Kapitel 4.2
Bild 4-2
4.2
Allgemein
E-Mail Aufbau
Mit dem Internet-Assistenten von Micro/WIN sind 32 verschiedene E-Mail Konfigurationen mglich.
E-Mail Inhalt
In der Beispielapplikation wurden fr 16 unterschiedliche Ereignisse die Meldetexte 0 bis 15 vordefiniert. Sie haben alle die gleiche Empfngeradresse (mail_user@mailtest.com). Entsprechend der Aufgabenstellung soll eine solche Meldung an einen zweiten Empfnger gesendet werden, wenn der erste den Erhalt den Alarm nicht innerhalb einer bestimmten Zeit quittiert hat.
22/65
Aus diesem Grund enthalten die E-Mails 16 bis 32 nochmals die gleichen Texte und Betreffzeilen. D.h. Mail 0 entspricht Mail 16, Mail 1 entspricht Mail 17 und so weiter. Einzig die Empfngeradresse hat sich gendert (hier: mail_superuser@mailtest.com). Im folgenden Bild ist eine empfangene E-Mail (Mail 5) mit ihren, im Text enthaltenen Informationseinheiten dargestellt.
Bild 4-3
Hinweis Die Elemente, die der Quittierung dienen sind in Bild 4-20 beschrieben.
Statuspuffer
Der E-Mail Statuspuffer enthlt alle wesentlichen Informationen, die zwischen dem Auftreten eines Alarms (Ereignis) und der Quittierung anfallen. Jeder der 16 mglichen Alarme hat seinen eigenen Statusspeicherplatz. Folgende Informationen sind in jedem Eintrag gespeichert:
Ein Statusbyte, das den aktuellen Bearbeitungszustand der jeweiligen Alarme kennzeichnet. 0 Idle state 1 Send Mail to receiver 1 2 Wait for acknowledgement 1 3 Send Mail to receiver 2 4 Wait for acknowledgement 2
23/65
Wo sich der Statuspuffer im Variablenspeicher der Steuerung befindet, ist im folgenden Bild dargestellt.
0 0 0 0
Bild 4-4
0 0 0 0 0 0
VB534
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Statusbyte von Alarm 0 Byte fr Zeitmessung bis zum Timeout von Alarm 0 Statusbyte von Alarm 1 Byte fr Zeitmessung bis zum Timeout von Alarm 1
...
...
VB564 VB565
Statusbyte von Alarm 15 Byte fr Zeitmessung bis zum Timeout von Alarm 15
Erstwertpuffer
Die in der E-Mail befindlichen Daten (Datum, Uhrzeit, Prozesswerte) werden beim Senden dynamisch aus dem Erstwertpuffer gelesen. Jeder der 16 mglichen Alarme hat darin seinen eigenen Speicherplatz. Aktualisiert werden die Speicherpltze beim Auftreten des jeweiligen Ereignisses durch das Unterprogramm MAIL_STORE (vgl. Kapitel 4.3.3 Unterprogramm MAIL_EVENT (SBR4)). Wo sich der Erstwertpuffer im Variablenspeicher der Steuerung befindet, ist im folgenden Bild dargestellt.
24/65
Prozesswert 2
Prozesswert 2
Prozesswert 1
0 0 0 0
VB533 Alarm 15
0 0 0 0 0 0 0 0 0 0 0 0 0 0
VB323 VB319 VB315 Alarm 0 VB310
Bild 4-5
E-Mail Konfiguration
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Die nachfolgende Abbildung zeigt die diesbezgliche Konfiguration des Mail-Textes mit dem Internet-Assistenten von Micro/WIN.
Bild 4-6
Der Wizard erzeugt selbstndig entsprechende Eintrge im Datenbaustein sowie die System-Unterprogramme ETH0_CTRL und ETH0_EMAIL (siehe nachfolgendes Kapitel). Wie Sie die Konfiguration ndern knnen, ist in Tabelle 8-3 beschrieben.
Rev. A - Endgltig 04.11.2003 25/65
4.3
Micro/WIN-Projekt
Das Micro/WIN-Projekt besitzt nachfolgend dargestellte Struktur:
MAIL_EVENT (SBR4)
MAIL_STORE (SBR3)
MAIL_CLOCK (SBR2)
Kapitel 4.3.3
MAIL_MAIN (OB1)
MAIL_ORG (SBR5) Kapitel 4.3.4 MAIL_ACKN (SBR6) Kapitel 4.3.5 MAIL_IN_OUT (SBR7) Digitale Einund Ausgnge
Kapitel 4.3.6
4.3.1
Das Hauptprogramm dient als Trger der einzelnen Unterprogramme, die in jedem Ablaufzyklus aufgerufen werden.
4.3.2
Das Unterprogramm ETH0_CTRL wurde automatisch vom InternetAssistenten erstellt. Es dient zur Initialisierung und berwachung des CP243-1 IT.
26/65
Ist in dem IT-CP ein Fehler aufgetreten, kann dieser ber die Rckgabewerte analysiert werden. In der Beispielapplikation werden die Rckgabewerte zwar im Variablenspeicher abgelegt, aber nicht ausgewertet.
Bild 4-8
4.3.3
Dieser Programmteil berwacht die Event-Bits. Bei einem gefundenen High-Zustand wird in das entsprechende Statusbyte der Wert 1 geschrieben, sofern derjenige Sendeauftrag nicht bereits in Arbeit ist. Der Status 1 bedeutet, dass ein neuer Sendeauftrag aktiviert ist (vgl. Tabelle 4-3).
Bild 4-9
Die 16 Event-Bits sind in zwei Bytes (je 8 Bit) des Variablenspeichers abgelegt. Das gesamte Wort (16 Bit) wird mit einer Bit-Maske AND-verknpft, um den Zustand jedes einzelnen Event-Bits getrennt abfragen zu knnen. Die Bit-Maske wird hierfr in jedem CPU-Zyklus um ein Bit nach links verschoben.
27/65
Event 7 I0.7
Event 0 I0.0
Event 8
Event-Bits VW300
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
VB300 VB301
... 256 128 64 32 16 8 4 2 1
Bit-Maske VW304
0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0
AND
Verknpfungsergebnis LW0
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 = 0
Bild 4-10
Das Setzen eines Alarms im Statuspuffer (Status 5) nach dem Auftreten eines Ereignisses (Event 5) ist im nchsten Bild dargestellt.
Event 5
Event-Bits
Event-Index
0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0
7 6
4 3 2 1 0 15 14 13 12 11 10 9 8
Bit-Maske
0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0
AND
Verknpfungsergebnis
0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 <> 0
E-Mail Statuspuffer
if (Status_5 == 0)
Status_5 := 1
Bild 4-11
28/65
Sobald das Verknpfungsergebnis nicht mehr 0 ist, wird das, dem Index entsprechende Byte im Statuspuffer abgefragt. Befindet sich der Status des Alarms im Ruhezustand (Status ist 0), wird ein neuer Sendeauftrag aktiviert (Status wird 1). (vgl. Bild 4-11) Zudem wird das Unterprogramm MAIL_STORE (SBR3) aufgerufen, welches den entsprechenden Bereich im Erstwertpuffer mit den aktuellen Daten (Datum, Uhrzeit, 2 Prozesswerte) versorgt.
Speichern des aktuellen Zeitstempels
Zum Lesen der Systemzeit ruft Mail_STORE wiederum das Unterprogramm MAIL_CLOCK (SBR2) auf, welches die einzelnen Bestandteile (Jahr, Monat, Tag, Stunde, Minute und Sekunde) zurck liefert.
Bild 4-12
Anhand des Event-Index, welcher dem Unterptogramm MAIL_STORE bei dessen Aufruf bergeben wurde, werden die Zeitwerte in den entsprechenden Bereichen des Erstwertpuffers geschrieben.
29/65
In der Beispielapplikation werden exemplarisch nur die Speicherbereiche der ersten zwei Alarme mit beliebig gewhlten Werten (Prozesswerten) versorgt. Alle anderen Alarme behalten ihre Initialisierungswerte, die im Datenbaustein definiert wurden (vgl. Bild 4-18).
Bild 4-13
Auch die Prozesswerte werden anhand des Event-Index in den entsprechenden Bereichen des Erstwertpuffers geschrieben. Wie Sie den Erstwertpuffer mit Werten aus einem realen Prozess versorgen knnen, ist im Abschnitt 8.2 Speichern von realen Prozesswerten beschrieben.
30/65
4.3.4
Die einzelnen Statusbytes (aus dem Statuspuffer) werden nacheinander abgefragt und entsprechende Aktionen ausgefhrt. Die folgende Tabelle zeigt die Bedeutung der mglichen Zustnde sowie die daraus resultierenden Reaktionen des Unterprogramms MAIL_ORG.
Tabelle 4-3
Wert
Bezeichnung
Idle state
Ruhezustand Alarm wird weder gerade gesendet, noch wird gerade auf eine Quittierung gewartet Bereit fr neue Ereigniserfassung durch das Unterprogramm MAIL_EVENT
1
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Neuer Sendeauftrag durch erkanntes Ereignis Wartezustand, falls der CP 243-1 IT gerade beschftigt ist Wechsel in Zustand 2, sobald der CP 243-1 IT frei ist
Wait for acknowledgement 1 Sendevorgang des Alarms zum ersten Empfnger wurde angestoen Mintliches Erhhen des Zeitwertes im Statuspuffer Wechsel in Zustand 3 und Zurcksetzen des Zeitwertes, wenn parametrierter Timeout erreicht ist
3 4
Wait for acknowledgement 2 Sendevorgang des Alarms zum zweiten Empfnger wurde angestoen Mintliches Erhhen des Zeitwertes im Statuspuffer Wechsel zum Zustand 0, Zurcksetzen des Zeitwertes und Fehlersignalisierung an Q 0.1, sobald der parametrierter Timeout erreicht ist
Bild 4-14
31/65
Am Aufruf des MAIL_ORG im Hauptprogramm knnen die Timeouts definiert werden. Sie geben an, in welchem Zeitraum der jeweilige Empfnger die Zukenntnisnahme einer E-Mail besttigt haben muss, bevor das Programm Folgeschritte einleitet.
4.3.5
MAIL_ACKN reagiert auf eingehende Quittierungen und setzt das entsprechende Statusbyte zurck (Zustand 0). Die Java-Applikation setzt ein hierfr definiertes Bit im Variablenspeicher auf Low und anschlieend wieder auf High. Gleichzeitig schreibt sie die Alarmnummer in ein ebenfalls dafr vorgesehenes Byte. Die positive Flanke des Bits wird erkannt und daraufhin das, der Alarmnummer entsprechende Statusbyte zurckgesetzt.
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Bild 4-15
4.3.6
Um die vorliegende Applikation einfach den eigenen Bedingungen anzupassen, knnen die belegten Ein- und Ausgnge zentral in diesem Unterprogramm definiert werden. Eine entsprechende Anleitung befindet sich im Teil C im Abschnitt 8.1 Event-Bits verschalten.
Bild 4-16
32/65
Die ersten 8 Ereignisse (Event 0 bis 7) wurden digitalen Eingngen zugewiesen. Die restlichen Event-Bits sind nicht verschaltet. Die nachfolgende Tabelle zeigt die vordefinierten Ein- und Ausgnge.
Tabelle 4-4
Ein-/Ausgang
Funktion
Event-Bit 0 Event-Bit 1 Event-Bit 2 Event-Bit 3 Event-Bit 4 Event-Bit 5 Event-Bit 6 Event-Bit 7 Rckgabewert Done des Unterprogramms ETH0_EMAIL CP 243-1 IT sendet nicht gerade und ist deshalb bereit fr neue Auftrge
Q0.1
4.3.7
Wie ETH0_CTRL stammt auch dieses Unterprogramm vom InternetAssistenten. Durch den Aufruf von ETH0_EMAIL wird der CP 243-1 IT dazu veranlasst, eine vordefinierte E-Mail abzusenden.
Bild 4-17
33/65
Das Unterprogramm ETH0_EMAIL kann zeitgleich nur einen Sendeauftrag ausfhren. Daher bildet neben dem eigentlichen Trigger Loop_End noch der Rckgabewert Done sowie das entsprechende Bit des Rckgabewertes CH_Ready des ETH0_CTRL als Startbedingung. Welche der 32 vordefinierten E-Mails gesendet werden soll, wird ber den Parameter Mail_Number bestimmt. Die Variable Abort_Job zum Abbrechen des Sendeauftrags ist hingegen nicht verschaltet. Wie auch beim ETH0_CTRL wird auch hier der Rckgabewert fr mgliche Fehlercodes im Variablenspeicher abgelegt jedoch nicht ausgewertet.
4.3.8 Datenbaustein
Im Datenbaustein sind die Projektierungsdaten des Internet-Assistenten abgelegt, die bei Neustart in den CP 243-1 IT geladen werden. Darber hinaus wurden im Datenbaustein fr jeden der 16 Alarme 2 Prozesswerte beliebig definiert und direkt in den Erstwertpuffer geschrieben.
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Bei Anbindung der Applikation an einen reellen Prozess knnen diese Initialwerte gelscht werden. Die Versorgung des Erstwertpuffers erfolgt dann ausschlielich ber das Unterprogramm MAIL_STORE.
Bild 4-18
34/65
4.4
berblick
Java-Applikation
Die Quittierung erfolgt immer fr einen konkreten Alarm, d.h. fr einen bestimmten Eintrag im E-Mail Statuspuffer. Damit der E-Mail Empfnger wei, welchen Eintrag er quittieren muss, steht die ID des Eintrags in der E-Mail.
PC (Empfnger 1) JavaApplikation
PC (Empfnger 2)
ID
ID
ODER
Status_(ID) : = 0
Event_(ID)
E-Mail Statuspuffer
Status_(ID) <> 0
Bild 4-19
35/65
Der Empfnger einer E-Mail kann direkt ber einen Link im Textfeld die Java-Applikation starten. Die Datei AckAlarm.jar ist Bestandteil der MailApplikation und befindet sich hier in der Beispielapplikation im Stammverzeichnis des Laufwerks C: . Ebenfalls in der Mail enthalten sind die zwei bentigten Parameter (IP-Adresse und ID), die in dem Applet angegeben werden mssen.
Link zum Start der Java-Applikation IP-Adresse der Station, von der die Mail stammt ID, die den betreffenden Alarm spezifiziert
Bild 4-20
Die Java-Applikation besteht aus einer Bedienoberflche, in der die zwei genannten Parameter angegeben werden mssen.
Bild 4-21
Anschlieend kann die Quittierung ber den Button Acknowledge gestartet werden.
36/65
Die wesentliche Aufgabe ist es, der Steuerung ber ein Variablenbyte mitzuteilen, welcher Eintrag im E-Mail Statuspuffer quittiert werden soll. Dazu werden folgende Schritte ausgefhrt:
Acknowledge Button
Status_Ackn prfen
1
Bild 4-22
1) Nach dem Bettigen des Acknowledge-Buttons baut das Applet selbstndig eine Verbindung zum CP 243-1 IT in der Anlage auf. 2) Die binre Variable Status_Ackn, die beim Anlauf der Steuerung gesetzt wurde, wird zurckgesetzt. 3) Wenn Status_Ackn den Wert 0 hat, wird das Programm fortgesetzt, ansonsten abgebrochen. 4) In das Variablenbyte Ackn_ID wird die ID (z.B. der Wert 5) des Alarms geschrieben, der quittiert werden soll. 5) Abschlieend wird Status_Ackn wieder gesetzt. Die positive Flanke des Bits Status_Ackn wird vom Programm der Steuerung erkannt und daraufhin das Statusbyte zurckgesetzt, das der bergebenen ID entspricht.
Hinweis
Wenn Sie mehr zum Thema Java-Applets im Zusammenhang mit dem CP 243-1 IT erfahren mchten, so sei auf den Band MAE 15A Steuern und Beobachten mit dem CP243-1 IT (vgl. Bild 0-1) verwiesen.
37/65
38/65
5.1
Installationen
Schritt
Aktion
Hinweis/ Erklrung
Installation der Java Runtime Environment JRE 1 Laden Sie die JRE von der Website http://java.sun.com/j2se/1.4/ Klicken Sie dort auf den rechts abgebildeten Link. Whlen Sie die JRE unter Windows Offline Installation zum Download aus und speichern Sie die Datei auf Ihrer Festplatte. 2 Starten Sie das Setup-Programm und folgen Sie den Installationsanweisungen. Laden Sie den IMail Express-Mail Server von der Website http://www.ipswitch.com/downloads/index.html Klicken Sie auf den Link Get IMail Express und fllen Sie das Benutzerprofil in der neu geffneten Seite das aus. Speichern Sie die Datei auf Ihrer Festplatte. 4 Starten Sie das Setup-Programm und folgen Sie den Installationsanweisungen. Beantworten Sie die Abfrage Do you wish to add an IMail user? mit Nein. Schlieen Sie die Installation ab. Hinweis
Das Setup-Programm ist selbsterklrend.
Der Download ist kostenfrei. Das Setup-Programm ist selbsterklrend. Der Download ist kostenfrei.
Sie knnen auch einen im Netzwerk vorhandenen Mail Server nutzen. Die Anleitungen in dieser Applikation beziehen sich aber nur auf den IMail Express-Mail Server.
39/65
TCP/IP-Netzwerkeinstellungen
Fr die E-Mail-Verbindung wird hier im Beispiel eine fest zugewiesene IPAdresse verwendet.
Tabelle 5-2
Schritt
Manahme
Erklrung/Bild
ffnen Sie die Netzwerkeinstellungen Ihres Rechners ber den entsprechenden Icon in der Systemsteuerung. Markieren Sie im Register Protocols das TCP/IP Protocol und Bettigen Sie den Button Properties.. um den entsprechenden Dialog zu ffnen.
Selektieren Sie die gewnschte Netzwerkkarte (falls Sie ber mehrere verfgen) und vergeben Sie nebenstehende Adressen. Besttigen Sie die Einstellungen mit OK und schlieen Sie die Dialoge der Systemsteuerung.
Falls erforderlich, starten Sie Ihren Rechner neu, damit die Einstellungen wirksam werden. 40/65
Im Mail Server mssen die Empfngeradressen in Form von Benutzerkonten angelegt werden.
Tabelle 5-3
Schritt
Manahme
Erklrung/Bild
Starten Sie die Software zur Mail Server Administration ber Start Programs IMail IMail Administrator. Klicken Sie mit der rechten Maustaste im Verzeichnisbaum auf localhost und whlen Sie im Kontextmen Add Host.
Klicken Sie im ersten Fenster auf Next. Geben Sie im Feld Host Name des zweiten Fensters mailtest.com an und klicken Sie auf Next.
Whlen Sie im nchsten Fenster die konfigurierte IP-Adresse aus: 195.143.3.86. Beenden Sie anschlieend die Konfiguration. Klicken Sie gegebenfalls F5, um den Verzeichnisbaum zu aktualisieren.
41/65
Schritt
Manahme
Erklrung/Bild
Klicken Sie mit der rechten Maustaste auf Users und whlen Sie im Kontextmen Add User.
Im Feld User ID: des ersten Fensters geben Sie mail_user an. Klicken auf Next bis Sie zu Passwortabfrage gelangen..
Wiederholen Sie die Schritte 4 bis 6 fr ein weiteres fr ein weiteres Benutzerkonto mit dem Namen mail_superuser.
Als E-Mail Client wird Microsoft Outlook Express verwendet. Es mssen zwei neue Konten eingerichtet werden, um die E-Mails vom Mail Server abzurufen.
Tabelle 5-4
Schritt
Manahme
Erklrung/Bild
Starten Sie Microsoft Outlook Express (msimn.exe) ber Start Programs Outlook Express. Whlen Sie im Men File Identities Add New Identity. Geben Sie den Namen des ersten Empfngers mail_user an und klicken Sie auf OK.
42/65
Schritt
Manahme
Erklrung/Bild
Markieren Sie die neue Identitt und klicken Sie auf OK. Daraufhin wird der Internet Connection Wizard geffnet.
Tragen Sie hier im ersten Fenster nochmals den Namen mail_user ein und klicken Sie auf Next. Geben Sie im zweiten Fenster die vollstndige E-Mail Adresse an (mail_user@mailtest.com) und klicken Sie auf Next.
Tragen Sie dann sowohl fr den Posteingang als auch fr den Postausgang die IP-Adresse Ihres lokalen Rechners an. Klicken Sie auf Next.
43/65
Schritt
Manahme
Erklrung/Bild
Geben Sie das Kennwort ein, dass Sie im IMail Administrator fr dieses Konto vergeben haben. Schlieen Sie die Kontoerstellung ab.
Es empfiehlt sich in den Kontoeinstellungen unter Tools Options im Register General den Zeitwert zu minimieren, der angibt, wie oft der Nachrichteneingang aktualisiert wird. Schlieen Sie den Dialog mit OK.
10
44/65
5.2
Hardwareaufbau
Die Komponenten des Hardwareaufbaus entnehmen Sie bitte dem Kapitel 2.4 Erforderliche Standardkomponenten.
Im Folgenden wird grob beschrieben, wie Sie die Komponenten auf einer Hutschiene anordnen.
Tabelle 5-5
Schritt
Fokus
Aktion
ffnen Sie den Rasthaken an der Rckseite der beiden Komponenten und hngen sie die CPU mit der Rckseite auf der Hutschiene ein. Schwenken Sie die CPU nach unten zur Hutschiene, bis sie merklich einrastet und schlieen Sie den Rasthaken. Achten Sie darauf, das der Haken richtig einrastet und die CPU sicher auf der Hutschiene sitzt. Schlieen Sie das Bus-Flachkabel des CP243-1 IT an den Erweiterungsanschluss der S7-CPU (bzw. des anderen Positioniermoduls) an (unter der Fronttr).
Electrial Switch Module Schwenken Sie das Electrial Switch Modul nach unten zur ESM TP40 auf Hutschiene bis es merklich einrastet. Achten Sie darauf, Hutschiene einhngen dass der Haken richtig einrastet und das ESM sicher auf der Hutschiene sitzt.
Wenn Sie eine CPU mit einem Anschluss fr Wechselspannung besitzen, knnen Sie diese direkt an 220V anschlieen.
Tabelle 5-6
Schritt
Manahme
Erklrung/Bild
L1 N PE
PE
45/65
Tabelle 5-7
Schritt
Manahme
Erklrung/Bild
1
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Stecken Sie den RS-485-Stecker (mit PPI gekennzeichnet) des PC/PPI-Kabels an die Kommunikationsschnittstelle der CPU. 2 Verbinden Sie die Ethernet-Karte Ihres PGs/PCs ber ein RJ45 ITP Ethernet Kabel mit dem Switch (ESM TP40) oder Hub. Verbinden Sie anschlieend die TCP/IPSchnittstelle des CP2431 IT ber ein Standard RJ45 ITPKabel mit dem ESM TP40 Switch (alternativ mit einem Ihnen zur Verfgung stehenden Hub).
PC
PC
EthernetSchnittstelle
COM Schnittstelle
Stecken Sie den RS-232-Stecker (mit PC gekennzeichnet) des PC/PPI-Kabels an die serielle Schnittstelle Ihres PCs (COM1 oder 2).
46/65
5.3
PPI-Kommunikationsparameter
ffnen Sie das Micro/WINProjekt und dort den Dialog Communications mit dem Menpunkt View Component Communications, oder klicken Sie in der Navigationsleiste auf:
Doppelklicken Sie dort auf den Zugangspunkt (im Screenshot PC/PPI cable). Daraufhin wird das Dialogfeld Set PG/PC Interface aufgerufen. 2 Sollte bei Ihnen ein anderer Zugangspunkt voreingestellt sein, ndern Sie diesen bitte durch Markieren von PC/PPI cable(PPI) in der Listbox. Klicken Sie auf die Schaltflche Properties....
47/65
Schritt
Manahme
Erklrung/Bild
berprfen Sie die Einstellungen. Geben Sie im Register Local Connection Ihre verwendete COM-Schnittstelle an. Quittieren Sie anschlieend zweimal mit OK um zurck zum Dialogfeld Communications zu gelangen.
Klicken Sie doppelt auf die Schaltflche Double-Click to Refresh um die Kommunikationsverbindung zu vervollstndigen. Wird Ihre CPU-Station wie in der nebenstehenden Abbildung erkannt, funktioniert die Kommunikation. Verlassen Sie den Dialog mit OK.
48/65
Die folgende Tabelle beschreibt, wie Sie Ihren CP 243-1 IT fr die sptere Kommunikation parametrieren mssen.
Tabelle 5-9
Schritt Manahme Erklrung/Bild
Starten Sie den InternetAssistenten ber den Menpunkt Tools --> Internet Wizard und klicken Sie im ersten Dialog auf die Schaltflche Next>.. Falls Sie die projektierte Modulposition aufgrund eines gegenber dieser Applikation verschiedenen Hardwareaufbaus ndern mssen, so setzen Sie den Haken der Option Move this configuration to a different module position. Durch Klick auf die Schaltflche Read Modules knnen Sie sich die angeschlossenen Module im Listenfeld ausgeben lassen. Tragen Sie die fr den CP 243-1 IT angezeigte Position in das rot markierte Feld ein. Klicken Sie anschlieend auf die Schaltflche Next>.
Passen Sie die IP-Adresse, die Subnetzmaske und die GatewayAdresse an. Klicken Sie anschlieend auf die Schaltflche Next>.
49/65
Schritt
Manahme
Erklrung/Bild
Verwenden Sie eine S7-224/ oder eine -226 CPU mssen Sie in dem rot markierten Feld eine 2 angeben. Mit einer S7-222 CPU knnen Sie nebenstehende Einstellungen belassen. Klicken Sie anschlieend zweimal auf die Schaltflche Next> (ein Dialog kann bersprungen werden).
5
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Im nebenstehenden Dialog knnen Sie den Benutzernamen und das Passwort fr den Administrator ndern. Klicken Sie anschlieend auf die Schaltflche Next>.
Setzen Sie die Hkchen wie im nebenstehenden Bild. Klicken Sie anschlieend auf die Schaltflche Next>.
50/65
Schritt
Manahme
Erklrung/Bild
Der Adressbereich, welchen der Internet-Assistent zur Ablage der Initialisierungsdaten fr den IT_CP nutzt, kann frei gewhlt werden. Bitte beachten Sie, dass zur Verwendung weiterer Teilapplikationen zum Themenkomplex die hier vorgeschlagene Einstellung zu empfehlen ist. Klicken Sie zweimal auf die Schaltflche Next> und dann auf Finish, um die Konfiguration abzuschlieen.
Download
bertragen Sie die Bausteine mittels File Download... oder ber die Schaltflche: Belassen Sie die DefaultEinstellungen und starten Sie den Ladevorgang durch Klick auf den Download-Button.
2 3
Versetzen Sie die CPU in Run. ffnen Sie erneut den Dialog Communications mit dem Menpunkt View Component Communications, oder klicken Sie in der Navigationsleiste auf:
Der CP 243-1 IT wird initialisiert (LEDs Link und Run leuchten grn).
Doppelklicken Sie dort auf den Zugangspunkt (im Screenshot PC/PPI cable). Daraufhin wird das Dialogfeld Set PG/PC Interface aufgerufen.
51/65
Schritt
Manahme
Erklrung/Bild
Wechseln Sie jetzt zu den Einstellungen Ihrer TCP/IPSchnittstelle und besttigen Sie mit OK. Besttigen Sie die darauffolgende Warnung ebenfalls mit OK.
Geben Sie wie im nebenstehenden Bild die IPAdresse des CP 243-1 IT an und klicken Sie anschlieend doppelt auf Double-Click to Refresh um die Kommunikationsverbindung zu vervollstndigen.
Wird Ihre CPU-Station wie in der nebenstehenden Abbildung erkannt, funktioniert die Kommunikation. Verlassen Sie den Dialog mit OK.
Die Bausteine werden noch einmal in die CPU geladen. Zudem werden dem CP 243-1 IT jetzt die Mail-Konfigurationen bergeben.
52/65
Hinweis STEP 7-Micro/WIN kommuniziert jetzt ber Ethernet-LAN, wodurch das PC/PPISchnittstellenkabel nicht mehr bentigt wird.
Damit einem Ereignis spter ein Zeitstempel zugewiesen werden kann, muss die Steuerung ber eine korrekt eingestellte Hardware-Uhr verfgen. In der nachfolgenden Tabelle ist beschrieben, wie Sie die Uhr stellen knnen. Voraussetzung hierfr ist eine bestehende Verbindung von Micro/WIN zur CPU (wie oben beschrieben).
Tabelle 5-11
Schritt Manahme Erklrung/Bild
1
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
ffnen Sie in Micro/WIN den Dialog Time of Day Clock mit dem Menpunkt PLC Time of Day Clock.... Passen Sie die Daten manuell an und bettigen Sie den SetButton oder bernehmen Sie Ihre Systemzeit mittels Set to PC. Schlieen Sie den Dialog.
53/65
6.1
Alarme auslsen
Von den 16 verschiedenen Alarmen knnen in der Beispielapplikation die ersten 8 zu Testzwecken ber digitale Eingnge der Steuerung ausgelst werden. Die restlichen 8 Alarme knnen in der Statustabelle aktiviert werden. Darber hinaus knnen dort auch die Statusbytes sowie die entsprechenden Zeitwerte beobachtet werden. Die Statustabellen knnen Sie ffnen, indem Sie in der Menleiste von Wicro/WIN auf Ansicht Komponente Statustabelle oder in der Navigationsleiste auf folgendes Symbol klicken:
Bild 6-1
54/65
Wie Sie die Online-Werte in der Statustabelle steuern knnen, ist in der Hilfe von Micro/WIN ausfhrlich beschrieben. Nachfolgend ist noch einmal die Tabelle aufgefhrt, in welcher die vordefinierten Ein- und Ausgnge beschrieben werden.
Tabelle 6-1
Ein-/Ausgang Funktion
Event-Bit 0 Event-Bit 1 Event-Bit 2 Event-Bit 3 Event-Bit 4 Event-Bit 5 Event-Bit 6 Event-Bit 7 Rckgabewert Done des Unterprogramms ETH0_EMAIL CP 243-1 IT sendet nicht gerade und ist deshalb bereit fr neue Auftrge
Q0.0
Q0.1
Zum Auslsen eines Alarms brauchen Sie nur einen Impuls auf einen digitalen Eingang (z.B. I0.4) zu geben. Die folgende Tabelle beschreibt, was Sie anschlieend beobachten knnen.
Tabelle 6-2
Nr. Aktion Zu beobachten?
1 2
Status_4 wird auf 1 gesetzt Status_4 wird auf 2 gesetzt Mail 4 wird an Empfnger 1 gesendet
Nur sehr kurzzeitig zu beobachten. Statustabelle Q0.0 wird wenige Sekunden Low und dann wieder High Statusanzeige RX/TX des CP 243-1 IT flackert in dieser Zeit
Empfnger 1 empfngt Mail 4 Der Wert von Time_4 wird mintlich erhht 3 4 Status_4 wird auf 3 gesetzt Status_4 wird auf 4 gesetzt Time_4 wird auf 0 zurckgesetzt Mail 4 wird an Empfnger 2 gesendet
Sobald Time_4 den Wert 3 erreicht hat (Timeout nach ca. 3 Minuten) Nur sehr kurzzeitig zu beobachten. Statustabelle Q0.0 wird wenige Sekunden Low und dann wieder High
55/65
Nr.
Aktion
Zu beobachten?
Statusanzeige RX/TX des CP 243-1 IT flackert in dieser Zeit Empfnger 2 empfngt Mail 4 Der Wert von Time_4 wird mintlich erhht 5 6 Steuerung signalisiert Fehler Status_4 wird auf 0 zurckgesetzt Time_4 wird auf 0 zurckgesetzt Outlook Express (Posteingang von mail_superuser@mailtest.com) Statustabelle
Sobald Time_4 den Wert 3 erreicht hat (Timeout nach ca. 6 Minuten) Q0.1 wird 30s auf High gesetzt Statustabelle
6.2
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Alarme quittieren
Starten Sie erneut einen Sendeauftrag (z.B. Alarm 5 ber I0.5) und folgen Sie den nachfolgenden Schrittanweisungen, um den Alarm zu quittieren.
Tabelle 6-3
Schritt Manahme Erklrung/Bild
Wenn die Mail den Empfnger 1 erreicht hat, ffnen Sie diese und klicken auf den enthaltenen Link, um die Java-Applikation zu starten. Wenn der Download-Dialog erscheint: Klicken Sie auf Open.
Je nach Einstellungen Ihres Systems (genauer: den Einstellungen im System fr den Dateityp .jar) ffnet sich das Java Quittier-Applet entweder sofort oder es geht der Dateidownload Dialog auf. Das Java Quittier-Applet wird geffnet. Achtung: Es kann vorkommen, dass das Applet im Hintergrund geffnet wird. Minimieren Sie in diesem Fall alle offenen Fenster.
Geben Sie die in der E-Mail enthaltenen Parameter an und bettigen Sie den Acknowledge-Button.
56/65
Schritt
Manahme
Erklrung/Bild
Die Autorisierungsabfrage bentigt zweimal administrator. Hinweis: Es knnen zur Quittierung auch weitere Benutzer mit Hilfe des Internet-Assistenten in STEP7 Micro/WIN eingerichtet werden.
Wurden die Daten ordnungsgem bertragen, erscheind nebenstehende Meldung. Der Status von Alarm 5 ist jetzt wieder 0. Somit kann er durch das erneute Auftreten von Event 5 (I0.5) neu aktiviert werden.
Hinweis Die Vorgehensweise bei der Quittierung der Alarme durch Empfnger 2 ist gleich.
57/65
Teil C : Programmbeschreibung
Ziel Teil C
Dies ist keine Einfhrung in STEP7 Micro/WIN. Der Leser sollte die Grundlagen beherrschen. Hilfreich ist es, vor der Code-Beschreibung die entsprechenden Kapitel im Teil A1 und A2 zu lesen.
58/65
7
7.1
Hinweis Im Folgenden werden ausschlielich einige wichtige Programmzeilen des funktionell zentralen Unterprogramms MAIL_ORG erlutert. Fr das Verstndnis der restlichen Unterprogramme sind die Beschreibungen aus Kapitel 4.3 Micro/WIN-Projekt sowie die Kommentare zu den einzelnen Codeelementen im Programm selbst ausreichend.
Tabelle 7-1
NW
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Code in AWL
Bemerkung
Set &Status_0, #Status_Pointer &Status_0, #Time_Pointer Job_Index, #Index_int #Index_int, #Offset_Status +2, #Offset_Status #Offset_Status, #Offset_Time +1, #Offset_Time #Offset_Status, LW4 #Offset_Time, LW8 Loop_End *#Status_Pointer, 1 2, *#Status_Pointer Job_Index, Mail_Number L63.7 *#Status_Pointer, 3 4, *#Status_Pointer +16, #Index_int
Die Zeiger zum Statusbyte (Status_Pointer ) und Zeitwert (Time_Pointer) des Statuspuffers werden vorerst mit der Adresse des Statusbyte von Alarm 0 (Status_0) vorbelegt. Der Schleifenindex (Job_Index) wird zu zwei entsprechenden Offsets umgewandelt.
Die Offsets werden zu den Zeigeradressen addiert. Dadurch zeigen die Zeiger jetzt auf die dem Index entsprechenden Bereiche im Statuspuffer. Loop_End=0 heit, es wird nicht gerade gesendet. Wenn das Statusbyte den der Zeiger aktuell adressiert den Wert 1 hat, erhlt es den Wert 2. Der Schleifen-Index wird in Mail_Number gespeichert. Loop_End wird 1 gesetzt, der Schleifendurchlauf gestoppt und ein neuer Sendeauftrag im Hauptprogramm MAIL_ MAIN gestartet. Wenn das Statusbyte den Wert 3 hat, erhlt es den Wert 4. Jetzt wird zu dem Schleifenindex der Wert 16 addiert, um eine von den Mails zu versenden, die fr den zweiten Empfnger konfiguriert wurden. Anschlieend wird auch hier wie oben der Loop_End auf 1 gesetzt. Zuletzt wird der Schleifenindex erhht. Hat er den Wert 15 erreicht, wird wieder bei 0 begonnen.
LDN LPS UB= MOVB UENO MOVB UENO = LRD UB= MOVB UENO +I
UB>
Job_Index, 15
NW
Code in AWL
Bemerkung
Wenn das Statusbyte den Wert 2 oder 4 hat, wird der entsprechende Zeitwert mintlich um 1 erhht. Hold_one_loop bleibt nach einem Minutenimpuls der CPU solange 1, bis die alle Statusbytes abgefragt wurden. Hat das Statusbyte den Wert 2 und der entsprechende Zeitwert hat den, am Unterprogrammaufruf parametrierten Wert (Ack_ Time1) berschritten, kommt es zum ersten Timeout. Das Statusbyte erhlt den Wert 3 und der Zeitwert wird zurck gesetzt.
LDB= UB>=
Hat das Statusbyte den Wert 4 und der entsprechende Zeitwert hat den, am Unterprogrammaufruf parametrierten Wert (Ack_ Time2) berschritten, kommt es zum zweiten Timeout. Das Statusbyte erhlt den Wert 0, der Zeitwert wird zurck gesetzt und die fehlende Quittierung wird gemerkt um spter durch das Unterprogramm MAIL_IN_OUT signalisiert zu werden.
7.2
Dort whlen Sie dann die Register Verwendete Bytes und Verwendete Bits. Im Bild 7-1 und 7-2 sind diese Listen in Screenshots dargestellt und die wichtigsten Bereiche grob beschrieben.
Verwendete Bytes
Wie bereits erwhnt, werden nur die Speicherbereiche als belegt gekennzeichnet, die im Programmcode direkt adressiert werden. Die freien Speicherpltze innerhalb der Markierungen werden durch Initialisierungen im Datenbaustein belegt und vom Programm mittel indirekter Adressierung genutzt. Die hchste Speicheradresse, die vom Programm belegt wird ist VB565 (wie aus dem Bild 7-1 ersichtlich).
60/65
Erstwertpuffer
Statuspuffer
Bild 7-1
61/65
Verwendete Bits
Bild 7-2
Die Eingnge E0.0 bis E0.7 sowie die Ausgnge A0.0 bis A0.1 werden durch die Applikation genutzt. A1.0 bis A1.7 werden hingegen von den System-Unterprogrammen ETH0_CTRL und ETH0_EMAIL verwendet (bei der S7-224/ bzw. -226 CPU sind dies A2.0 bis A2.7).
Verwendete Timer
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Die Applikation nutzt lediglich den Timer T37, welcher im Unterprogramm MAIL_IN_OUT verschalten ist.
62/65
Vernderungen im Micro/WIN-Projekt
Nachfolgend ist aufgefhrt, welche Schritte Sie durchfhren mssen/ knnen, um die Applikation Ihren Anforderungen anzupassen. Im Einzelnen werden gezeigt:
Event-Bits verschalten Speichern von realen Prozesswerten Timeout-Werte ndern E-Mail Layout umgestalten
8.1
Event-Bits verschalten
In der Beispielapplikation wurden im Unterprogramm MAIL_IN_OUT die ersten 8 Ereignisse (Event 0 bis 7) digitalen Eingngen zugewiesen. Die restlichen Event-Bits (Event 8 bis 15) sind noch nicht verschaltet.
Die folgende Tabelle zeigt, wie Sie das Ereignis 8 einer UND-Verknpfung von zwei beliebigen Merker-Bits (M2.0 und M2.1) zuweisen.
Tabelle 8-1
Schritt Manahme Erklrung/Bild
Fgen Sie im Unterprogramm MAIL_IN_OUT ein neues Netzwerk nach dem Netzwerk 8 ein und beschriften Sie es mit Start Mail 8.
Nach einem erneuten Ladevorgang (vgl. Schritt 7 aus Tabelle 5-10) sind die nderungen aktiv.
Wenn Sie nun mittels der Statustabelle (vgl. Bild 6-1) M2.0 und M2.1 auf 1 setzen, wird das Event-Bit 8 (V301.0) gesetzt und somit der Alarm 8 ausgelst.
Rev. A - Endgltig 04.11.2003 63/65
Analog knnen Sie die restlichen Ereignisse nach Ihren Bedrfnissen zuweisen bzw. die vordefinierten Verschaltungen ndern, um die Trigger aus einem realen Prozess zu holen.
8.2
Tabelle 8-2
Schritt
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc
Manahme
Erklrung/Bild
ffnen Sie das Unterprogramm MAIL_STORE. Ersetzen Sie die vorhandenen Programmzeilen durch nebenstehenden Code. Geben Sie dabei anstelle der angegebenen Speicheradressen (VD600, VD604, VD 610, usw.) Ihre Wunschadressen an. Die rot umrahmten Zeilen gelten fr Alarm 1. Setzen Sie die Programmierung in dieser Art fort, bis hin zu Alarm 15.
Die Initialwerte (Prozesswerte) im Datenbaustein knnen anschlieend gelscht werden. Nach einem erneuten Ladevorgang (vgl. Schritt 7 aus Tabelle 5-10) sind die nderungen aktiv.
8.3
Timeout-Werte ndern
Die Timeout-Werte geben an, wieviel Zeit jeder der beiden Empfnger zum Quittieren hat, bis eine Reaktion entsprechend der Tabelle 4-3 eingeleitet wird. Beide Werte sind auf 3 Minuten voreingestellt und knnen direkt am Aufruf des Unterprogramms MAIL_ORG im Hauptprogramm MAIL_MAIN angepasst werden (vgl. Bild 4-14). Nach einem erneuten Ladevorgang (vgl. Schritt 7 aus Tabelle 5-10) sind die nderungen aktiv.
64/65
8.4
Tabelle 8-3
Schritt Manahme Erklrung/Bild
Starten Sie den InternetAssistenten ber den Menpunkt Tools --> Internet Wizard und klicken Sie im ersten Dialog auf die Schaltflche Next>.. Wechseln Sie im nchsten Dialog mittels rechts abgebildeter Schaltflche in das Register Email Configuration Hier knnen Sie dem CP 243-1 IT eine neue Absenderadresse zuweisen. Zudem kann die IP-Adresse des Zielrechners (Mail Server) gendert werden. Klicken Sie anschlieend auf die Schaltflche Next>..
Im darauffolgenden Dialog knnen Sie die restlichen Parameter wie Zieladresse, Betreffzeile oder das Layout des Meldetextes fr jede der 32 Mails ndern. Klicken Sie auf die Schaltflche Next>.. und anschlieend auf Finish um die Konfiguration zu bernehmen.
Nach einem erneuten Ladevorgang (vgl. Schritt 7 aus Tabelle 5-10) sind die nderungen aktiv.
65/65