Sie sind auf Seite 1von 65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT (S7-200, CP 243-1 IT und ESM TP40)

Micro Application Example 15B V1.0 (Ausgabe 09/2003)

Aufbau des Dokuments


Teil A1 Automatisierungslsung (inkl. Komponentenliste/Leistungseckdaten)

Teil A2 Funktionsmechanismen im Detail

Teil B Aufbau und Inbetriebnahme Schritt fr Schritt

Teil C Programmbeschreibung

Micro Application Examples Der schnelle Weg zur optimierten Lsung

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.

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Rev. A - Endgltig 04.11.2003

3/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Rev. A - Endgltig 04.11.2003

4/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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)

Aufgabenstellungen, Gesamtaufbau, TCP/IP Grundlagen, Security Grundlagen , Kommunikationsprojektierungen in ISDN-Routern

Bild 0-1

Rev. A - Endgltig 04.11.2003

Datenbertragung per FTP

Steuern und Beobachten

Konfigurationsband

5/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

SIEMENS SIMATIC Komponenten (HW+SW)

SIEMENS Standard-PC Antriebe mit und Motoren Mail Server und Web-Browser (HW+SW) Client

Applikations software (SW)

... stellen Sie bereit

... wird mit der Applikation geliefert

Bild 0-2

Projektierung Projektierung eines E-Mail Servers an Hand eines konkreten Fremdproduktes

Rev. A - Endgltig 04.11.2003

6/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Rev. A - Endgltig 04.11.2003

7/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Rev. A - Endgltig 04.11.2003

8/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

S7-200 CPU (Verwaltung der Alarme bis zu deren Quittierung)


Automatisierungsstation Servicestation (PC)

Lokale Datenverarbeitung

IT-CP mit Mail Client

TCP/IP-Verbindung (WAN)

QuittierSoftware

Netzanschluss

Mail Client
Bild 1-1

Lokale Datenverarbeitung

Mail Server

Rev. A - Endgltig 04.11.2003

9/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Rev. A - Endgltig 04.11.2003

10/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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

Rev. A - Endgltig 04.11.2003

11/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Rev. A - Endgltig 04.11.2003

12/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Mgliche Werte fr das Statusbyte

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.

E-Mails senden und Alarme quittieren

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.

Rev. A - Endgltig 04.11.2003

13/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Rev. A - Endgltig 04.11.2003

14/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Simatic Field PG CPU 222 CP 243-1 IT LOGO! Power ESM TP40

6ES7710-xxxxx-xxxx 6ES7212-1AB22-0XB0 6GK7243-1GX00-0XE0 6EP1332-1SH41 6GK1105-3AC00

Oder anderer PC Oder grere CPU

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

!
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

Verbindungskabel CPU-PC Gekreuztes EthernetKabel Nur fr S7-222: Uhr-Modul Hinweis

PC/PPI-Cable

6ES7901-3BF21-0XA0 6XV1850-2HH10 Bei direkter Verbindung des CP 243-1 IT zum PC

S7-22X Clock and Battery Cartr.

6ES7 297-1AA20-0XA0 Ab S7-224 standardmig enthalten

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.

Rev. A - Endgltig 04.11.2003

15/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Rev. A - Endgltig 04.11.2003

16/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

MAIL_MAIN (OB 1) ETH0_CTRL (SBR0)


Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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)

TANK_IN_OUT Definition der gewnschten Ein- und Ausgnge (SBR7)

Rev. A - Endgltig 04.11.2003

17/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Leistungseckdaten
In diesem Kapitel geben wir Ihnen einen berblick ber die Leistungsfhigkeit der Beispielapplikation und ihrer Komponenten.

Tabelle 3-1 Kriterium Wert Zustzlicher Hinweis

Programmgre

Programmbaustein: 1747 Bytes Datenbaustein: 534 Bytes

Belegter Variablenspeicher Belegte Eingnge Belegte Ausgnge


Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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

Benutzer-Autorisierung (fr Quittiermechanismus)

Rev. A - Endgltig 04.11.2003

18/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Teil A2 : Funktionsmechanismen
Ziel Teil A2

Der Teil A2 dieses Dokuments soll dem Leser


alle vorkommenden Funktionselemente verstndlich machen, die Komponenten aufzeigen, die einfach in eigene Anwendungen integrierbar sind sowie die notwendigen Grundlagen vermitteln.

Was knnen Sie damit anfangen?

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Rev. A - Endgltig 04.11.2003

19/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Rev. A - Endgltig 04.11.2003

20/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Alarme eintragen E-Mails versenden Auf Quittierung warten

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Anlage

(weiter in Abschnitt 4.1)


CP243-1 IT

Mail Client LAN-Netzanbindung

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

LAN-Netzanbindung Mail Server

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

Rev. A - Endgltig 04.11.2003

21/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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)

15 Erstwertpuffer (V-Bereich) Datensatz Zeitstempel 0

Mail Server (lokal)


PW 1 PW2

<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

E-Mail

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.

Rev. A - Endgltig 04.11.2003

22/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Zeitpunkt, zu dem das Ereignis auftrat

Zwei Prozesswerte, die beim Auftreten des Ereignisses gespeichert wurden


Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Informationen zur Quittierung

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

Rev. A - Endgltig 04.11.2003

23/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Wo sich der Statuspuffer im Variablenspeicher der Steuerung befindet, ist im folgenden Bild dargestellt.

VB565 VB563 VB564 VB562

VB539 VB537 VB535 VB538 VB536 VB534

0 0 0 0
Bild 4-4

0 0 0 0 0 0

Die Tabelle gibt Auskunft ber die Speicherinhalte des Statuspuffers.


Tabelle 4-2 Speicherplatz Inhalt

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

VB535 VB536 VB537

...

...

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.

Rev. A - Endgltig 04.11.2003

24/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Prozesswert 2

Prozesswert 2

Prozesswert 1

Datum und Uhrzeit

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

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

4.3

Micro/WIN-Projekt
Das Micro/WIN-Projekt besitzt nachfolgend dargestellte Struktur:

ETH0_CTRL (SBR0) Kapitel 4.3.2


Kapitel 4.3.1

Variablenspeicher (DB) Kapitel 4.3.8

MAIL_EVENT (SBR4)

MAIL_STORE (SBR3)

MAIL_CLOCK (SBR2)

Kapitel 4.3.3

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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

ETH0_EMAIL (SBR1) Kapitel 4.3.7 Unterprogramme fr Sendemechanismus Unterprogramm fr Quittiermechanismus


Bild 4-7

4.3.1

Hauptprogramm MAIL_MAIN (OB 1)

Das Hauptprogramm dient als Trger der einzelnen Unterprogramme, die in jedem Ablaufzyklus aufgerufen werden.

4.3.2

Unterprogramm ETH0_CTRL (SBR0)

Das Unterprogramm ETH0_CTRL wurde automatisch vom InternetAssistenten erstellt. Es dient zur Initialisierung und berwachung des CP243-1 IT.

Rev. A - Endgltig 04.11.2003

26/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Bild 4-8

4.3.3

Unterprogramm MAIL_EVENT (SBR4)

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.

Rev. A - Endgltig 04.11.2003

27/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Suche nach Index

E-Mail Statuspuffer

if (Status_5 == 0)

Status_5 := 1

Bild 4-11

Rev. A - Endgltig 04.11.2003

28/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Aktivieren eines neuen Sendeauftrags

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Rev. A - Endgltig 04.11.2003

29/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Speichern der aktuellen Prozesswerte

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).

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Rev. A - Endgltig 04.11.2003

30/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

4.3.4

Unterprogramm MAIL_ORG (SBR5)

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

Bedeutung und Folgen

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

Send Mail to receiver 1

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

Send Mail to receiver 2

Wie Zustand 1, nur dass sich der Zustand 4 anschliet

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

Rev. A - Endgltig 04.11.2003

31/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Unterprogramm MAIL_ACKN (SBR6)

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

Unterprogramm MAIL_IN_OUT (SBR7)

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

Rev. A - Endgltig 04.11.2003

32/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

I0.0 I0.1 I0.2 I0.3 I0.4 I0.5 I0.6 I0.7 Q0.0


Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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

30s High, wenn auch der zweite Timeout erreicht wurde

4.3.7

Unterprogramm ETH0_EMAIL (SBR1)

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

Rev. A - Endgltig 04.11.2003

33/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Initialwerte fr den IT-CP, die vom InternetAssistenten eingetragen wurden

Bereiche des Erstwertpuffers: Beliebig gewhlte Prozesswerte

Bild 4-18

Rev. A - Endgltig 04.11.2003

34/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

ODER

Anlage (IP-Addr: 195.143.3.85)


Quittiermechanismus (Unterprogramm MAIL_ACKN)

Status_(ID) : = 0
Event_(ID)

E-Mail Statuspuffer

Status_(ID) <> 0

Bild 4-19

Rev. A - Endgltig 04.11.2003

35/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Aufruf der Java-Applikation

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

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Bild 4-20

Start der Quittierung

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.

Rev. A - Endgltig 04.11.2003

36/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Funktionsweise der Java-Applikation

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

Variablenbit Status_Ackn :=0

Status_Ackn prfen

Variablenbyte Ackn_ID :=5

Variablenbit Status_Ackn :=1

1
Bild 4-22

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Rev. A - Endgltig 04.11.2003

37/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Teil B : Installation der Beispielapplikation


Ziel Teil B

Der Teil B dieses Dokuments soll dem Leser


die Installation des Beispiels mit allen HW-/SW-Komponenten erklren. die Bedienung der Applikation zeigen.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Rev. A - Endgltig 04.11.2003

38/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Inbetriebnahme der Hard- und Software


In diesem Kapitel erfahren Sie, wie Sie die Applikation auf schnellstem Wege in Betrieb nehmen knnen. Die komplette Applikation ist auf Basis der unter Kapitel 2.4 genannten Standard- und Applikationskomponenten nach der Installation sofort ablauffhig.

5.1

Einrichten der Bedienstation (PG/ PC)


Es wird vorausgesetzt, dass Micro/WIN V3.2 inkl. SP4 sowie ein Mail Client (z.B. Outlook Express) bereits auf dem Rechner installiert sind.

Installationen

Fr die folgende Anleitung wird ein Internet-Zugang bentigt.


Tabelle 5-1
Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Installation des Mail Servers 3

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.

Rev. A - Endgltig 04.11.2003

39/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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

Rev. A - Endgltig 04.11.2003

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Mail Server Konfiguration

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Rev. A - Endgltig 04.11.2003

41/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Schritt

Manahme

Erklrung/Bild

Klicken Sie mit der rechten Maustaste auf Users und whlen Sie im Kontextmen Add User.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Im Feld User ID: des ersten Fensters geben Sie mail_user an. Klicken auf Next bis Sie zu Passwortabfrage gelangen..

Vergeben Sie ein Passwort und beenden Sie die Konfiguration.

Wiederholen Sie die Schritte 4 bis 6 fr ein weiteres fr ein weiteres Benutzerkonto mit dem Namen mail_superuser.

Mail Client Konfiguration

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.

Rev. A - Endgltig 04.11.2003

42/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Schritt

Manahme

Erklrung/Bild

Die nachfolgende Abfrage beantworten Sie mit Yes.

Markieren Sie die neue Identitt und klicken Sie auf OK. Daraufhin wird der Internet Connection Wizard geffnet.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Rev. A - Endgltig 04.11.2003

43/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Schritt

Manahme

Erklrung/Bild

Geben Sie das Kennwort ein, dass Sie im IMail Administrator fr dieses Konto vergeben haben. Schlieen Sie die Kontoerstellung ab.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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

Wiederholen Sie alle Schritte fr den zweiten Empfnger mail_ superuser.

Rev. A - Endgltig 04.11.2003

44/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

5.2

Hardwareaufbau
Die Komponenten des Hardwareaufbaus entnehmen Sie bitte dem Kapitel 2.4 Erforderliche Standardkomponenten.

Montieren der Hardware-Komponenten

Im Folgenden wird grob beschrieben, wie Sie die Komponenten auf einer Hutschiene anordnen.
Tabelle 5-5

Schritt

Fokus

Aktion

S7-200 CPU und CP243-1 IT montieren

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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).

Busverbindung des CP243-1 IT an S7-200 CPU anschieen

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.

Anschlieen der S7-200 CPU an die Netzspannung

Wenn Sie eine CPU mit einem Anschluss fr Wechselspannung besitzen, knnen Sie diese direkt an 220V anschlieen.
Tabelle 5-6

Schritt

Manahme

Erklrung/Bild

Versorgen Sie die Bauteile mit Spannung.

L1 N PE

PE

Rev. A - Endgltig 04.11.2003

45/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Verbinden der Komponenten


Hinweis Als Kommunikationsverbindung zwischen dem PG/ PC und der Steuerung wird hier auf ein PC/PPI-Kabel verwiesen, da dieses die serielle Schnittstelle (COM) nutzt, welche an jedem PC vorhanden ist. Verfgen Sie ber einen CP5611 oder eine PC ISA-Karte knnen Sie die Verbindung auch ber MPI herstellen. Dies hat neben der hheren Zugriffsgeschwindigkeit den Vorteil, dass die COMSchnittstelle frei bleibt.

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

mit STEP 7-Micro/ WIN32

PC
EthernetSchnittstelle

mit Mail Server und Client

Rev. A - Endgltig 04.11.2003

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

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

5.3

Einrichten der Steuerung und des CP 243-1 IT

PPI-Kommunikationsparameter

Richten Sie jetzt folgendermaen die PG/PC-Schnittstelle ein:


Tabelle 5-8
Schritt Manahme Erklrung/Bild

ffnen Sie das Micro/WINProjekt und dort den Dialog Communications mit dem Menpunkt View Component Communications, oder klicken Sie in der Navigationsleiste auf:

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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....

Rev. A - Endgltig 04.11.2003

47/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Rev. A - Endgltig 04.11.2003

48/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Anpassen der CP 243-1 IT Projektierung

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>.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Passen Sie die IP-Adresse, die Subnetzmaske und die GatewayAdresse an. Klicken Sie anschlieend auf die Schaltflche Next>.

Rev. A - Endgltig 04.11.2003

49/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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>.

Rev. A - Endgltig 04.11.2003

50/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Download

Nun knnen Sie das Micro/WIN-Programm in die CPU laden.


Tabelle 5-10
Schritt Manahme Erklrung/Bild

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.

Rev. A - Endgltig 04.11.2003

51/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Wiederholen Sie die Aktion von Schritt 1.

Die Bausteine werden noch einmal in die CPU geladen. Zudem werden dem CP 243-1 IT jetzt die Mail-Konfigurationen bergeben.

Rev. A - Endgltig 04.11.2003

52/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Hinweis STEP 7-Micro/WIN kommuniziert jetzt ber Ethernet-LAN, wodurch das PC/PPISchnittstellenkabel nicht mehr bentigt wird.

Einrichten der Echtzeituhr

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.

Rev. A - Endgltig 04.11.2003

53/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Bedienung der Applikation


Fr die folgenden Anleitungen werden die in Kapitel 5 beschriebenen Installationen und Konfigurationen vorausgesetzt. Die Steuerung muss das Micro/WIN-Programm enthalten und gestartet sein. Die Java-Applikation (AckAlarm.jar) wurde direkt in C:\ der Bedienstation kopiert.

6.1

Alarme auslsen

Steuern und berwachen

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:

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Bild 6-1

Rev. A - Endgltig 04.11.2003

54/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

I0.0 I0.1 I0.2 I0.3 I0.4 I0.5 I0.6 I0.7


Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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

30 sek High, sobald der zweite Timeout erreicht wurde

Sendeszenario ohne Quittierung

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

Outlook Express (Posteingang von mail_user@mailtest.com) Statustabelle

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

Rev. A - Endgltig 04.11.2003

55/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Rev. A - Endgltig 04.11.2003

56/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Hinweis Die Vorgehensweise bei der Quittierung der Alarme durch Empfnger 2 ist gleich.

Rev. A - Endgltig 04.11.2003

57/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Teil C : Programmbeschreibung
Ziel Teil C

Der Teil C dieses Dokuments soll dem Leser


Details aus dem Code einiger Kernprogrammteile erlutern. Hinweise liefern, wo Erweiterungen und Modifikationen sinnvoll sind. Voraussetzung

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Rev. A - Endgltig 04.11.2003

58/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

7
7.1

Details des Micro/WIN-Projektes


Micro/WIN-Programmcode

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

LD MOVD MOVD BTI MOVW *I MOVW +I +I +I

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

MOVB 0, Job_Index Rev. A - Endgltig 04.11.2003 59/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

NW

Code in AWL

Bemerkung

LDB= OB= U INCB

*#Status_Pointer, 2 *#Status_Pointer, 4 Hold_one_loop *#Time_Pointer *#Status_Pointer, 2 *#Time_Pointer, #Ackn_Time_1

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>=

MOVB 3, *#Status_Pointer MOVB 0, *#Time_Pointer

LDB= UB>= LPS

*#Status_Pointer, 4 *#Time_Pointer, #Ackn_Time_2 0, *#Status_Pointer No_Ackn, 1 0, *#Time_Pointer

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

MOVB UENO S LPP MOVB

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

Belegte Speicher und Timer


Welche Speicherbereiche ein Programm belegt (mittels direkter Adressierung), knnen Sie feststellen, indem Sie in der Menleiste von Wicro/WIN Komponente Querverweise oder in der Navigationsleiste auf Ansicht auf folgendes Symbol klicken:

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).

Rev. A - Endgltig 04.11.2003

60/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

Verwendung durch die System-Unterrogramme ETH0_CTRL und ETH0_EMAIL

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

Speicherpltze, die fr den Programmablauf bentigt werden und Reserven

Erstwertpuffer

Statuspuffer

Bild 7-1

Rev. A - Endgltig 04.11.2003

61/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Rev. A - Endgltig 04.11.2003

62/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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.

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Geben Sie nebenstehenden Programmcode ein.

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

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

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

Speichern von realen Prozesswerten


In der Beispielapplikation werden alle, zu einem Alarm gehrigen Prozesswerte im Datenbaustein initialisiert (vgl. Bild 4-18). Die Werte werden direkt in die entsprechenden Bereiche des Erstwertpuffers geschrieben. Zudem ist im Unterprogramm MAIL_STORE exemplarisch dargestellt, wie die Versorgung des Erstwertpuffers mit aktuellen Werten aus einem realen Prozess erfolgen kann (vgl. Bild 4-13). Welche Arbeitsschritte dafr ntig sind, zeigt die nachfolgenden Tabelle.

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.

Rev. A - Endgltig 04.11.2003

64/65

Melden von Anlagenzustnden via E-Mail mit dem CP 243-1 IT

8.4

E-Mail Aufbau ndern


Die Konfigurationen knnen nur mit dem Internet-Assistenten von Micro/WIN verndert werden. Die nachfolgende Tabelle zeigt, welche Schritte dafr ntig sind.

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>..

Copyright Siemens AG 2003 All rights reserved MA_0406_mae15b_s7200_cp243it_DOKU_v00_d.doc

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.

Rev. A - Endgltig 04.11.2003

65/65