E-Mails in einem lokalen Netzwerk senden mit einem WAGO Controller 750-842, Deutsch Version 1.0.2
ii Allgemeines Copyright 2002 by WAGO Kontakttechnik GmbH Alle Rechte vorbehalten. WAGO Kontakttechnik GmbH Hansastraße 27 D-32423 Minden Tel.: +49 (0) 571/8 87 0 Fax: +49 (0) 571/8 87 1 69 E-Mail: info@wago.com Web: http://www.wago.com Technischer Support Tel.: +49 (0) 571/8 87 5 55 Fax: +49 (0) 571/8 87 85 55 E-Mail: support@wago.com Es wurden alle erdenklichen Maßnahmen getroffen, um die Richtigkeit und Vollständigkeit der vorliegenden Dokumentation zu gewährleisten. Da sich Fehler, trotz aller Sorgfalt, nie vollständig vermeiden lassen, sind wir für Hinweise und Anregungen jederzeit dankbar. Wir weisen darauf hin, dass die im Dokument verwendeten Soft- und Hardwarebezeichnungen und Markennamen der jeweiligen Firmen im Allgemeinen einem Warenzeichenschutz, Markenschutz oder patentrechtlichem Schutz unterliegen.
Inhalt iii INHALTSVERZEICHNIS 1 Wichtige Erläuterungen... 2 1.1 Rechtliche Grundlagen... 2 1.1.1 Urheberschutz... 2 1.1.2 Personalqualifikation... 2 1.1.3 Bestimmungsgemäßer Gebrauch... 2 1.2 Gültigkeitsbereich... 3 2 Beschreibung... 4 3 Material... 4 4 Lösung... 5 4.1 Einbindung in ein WAGO-I/O-PRO Programm... 5 4.2 Beschreibung der Bibliotheksfunktion... 6
2 Wichtige Erläuterungen 1 Wichtige Erläuterungen Um dem Anwender eine schnelle Installation und Inbetriebnahme der beschriebenen Geräte zu gewährleisten, ist es notwendig, die nachfolgenden Hinweise und Erläuterungen sorgfältig zu lesen und zu beachten. 1.1 Rechtliche Grundlagen 1.1.1 Urheberschutz Dieses Dokument, einschließlich aller darin befindlichen Abbildungen, ist urheberrechtlich geschützt. Jede Weiterverwendung dieses Dokumentes, die von den urheberrechtlichen Bestimmungen abweicht, ist nicht gestattet. Die Reproduktion, Übersetzung in andere Sprachen, sowie die elektronische und fototechnische Archivierung und Veränderung bedarf der schriftlichen Genehmigung der WAGO Kontakttechnik GmbH, Minden. Zuwiderhandlungen ziehen einen Schadenersatzanspruch nach sich. Die WAGO Kontakttechnik GmbH behält sich Änderungen, die dem technischen Fortschritt dienen, vor. Alle Rechte für den Fall der Patenterteilung oder des Gebrauchmusterschutzes sind der WAGO Kontakttechnik GmbH vorbehalten. Fremdprodukte werden stets ohne Vermerk auf Patentrechte genannt. Die Existenz solcher Rechte ist daher nicht auszuschließen. 1.1.2 Personalqualifikation Der in diesem Dokument beschriebene Produktgebrauch richtet sich ausschließlich an Fachkräfte mit einer Ausbildung in der SPS- Programmierung, Elektrofachkräfte oder von Elektrofachkräften unterwiesene Personen, die außerdem mit den geltenden Normen vertraut sind. Für Fehlhandlungen und Schäden, die an WAGO-Produkten und Fremdprodukten durch Missachtung der Informationen dieses Dokumentes entstehen, übernimmt die WAGO Kontakttechnik GmbH keine Haftung. 1.1.3 Bestimmungsgemäßer Gebrauch Die Komponenten werden ab Werk für den jeweiligen Anwendungsfall mit einer festen Hard- und Softwarekonfiguration ausgeliefert. Änderungen sind nur im Rahmen der in dem Dokument aufgezeigten Möglichkeiten zulässig. Alle anderen Veränderungen an der Hard- oder Software, sowie der nicht bestimmungsgemäße Gebrauch der Komponenten, bewirken den Haftungsausschluss der WAGO Kontakttechnik GmbH. Wünsche an eine abgewandelte bzw. neue Hard- oder Softwarekonfiguration richten Sie bitte an WAGO Kontakttechnik GmbH.
Wichtige Erläuterungen 3 1.2 Gültigkeitsbereich Dieser basiert auf die genannte Hard- und Software der jeweiligen Hersteller sowie auf die zugehörige Dokumentation. Daher gilt dieser nur für die beschriebene Installation. Neue Hard- und Softwareversionen erfordern eventuell eine geänderte Handhabung. Beachten Sie die ausführliche Beschreibung in den jeweiligen Handbüchern.
4 Beschreibung 2 Beschreibung Im Rahmen dieser Application note wird der WAGO Ethernet-Controller 750-842 zum versenden von E-Mails an einen Microsoft-Exchange-Server über ein lokales Netzwerk eingesetzt. Zum versenden von Emails wird das SMTP-Protokoll genutzt. Der Ethernet- Controller arbeitet in diesem Fall als SMTP-Client. Der Microsoft-Exchange-Server arbeitet als SMTP-Server und nimmt die Email entgegen. Der Emailempfänger prüft und holt mit dem POP3-Protokoll seine Emails vom Microsoft-Exchange-Server ab. 750-842 Ethernet-Controller PC Microsoft Outlook 98 PC Microsoft Exchange Server 3 Material Die Anbindung ist unter den folgenden Voraussetzungen getestet worden Eingesetzte Hardware Komponenten: WAGO Controller 750-842 Standard PC Eingesetzte Software Komponenten: WAGO I/O Pro 32 V2.1SP10+ SMTP_MAIL.lib Version 1.1 Microsoft Outlook 98, Microsoft Exchange Server
Lösung 5 4 Lösung 4.1 Einbindung in ein WAGO-I/O-PRO Programm Seitens des WAGO Controllers wird ein Mail Client realisiert. Dazu wird in der Bibliothek MAIL_01.lib ein Funktionsbaustein zur Verfügung gestellt. Der Aufruf dieses Bausteins ist im folgenden Bild zu sehen. Eine detaillierte Beschreibung der Parameter ist im Kapitel 4.2 zu finden. In diesem Beispiel wird eine Mail von SYSTEM an IT_Service@domain.com geschickt. In der Betreff-Zeile seitens Outlook erscheint: ALARM: Brandfrüherkennungsanlage Rechenzentrum. Die eigentliche Meldung lautet: Brandfrüherkennungsanlage hat angesprochen. Der Parameter sip gibt die IP-Adresse des Microsoft-Exchange-Servers an.
6 Lösung 4.2 Beschreibung der Bibliotheksfunktion WAGO-I/O-PRO Library - Elemente Kategorie: Name: SMTP_CLIENT Typ: Funktion Funktionsblock X Programm Name der Bibliothek: MAIL_01.lib Anwendbar für: Ethernet controller 750-842 Input: Datatyp: Comment: sip STRING IP Address of the computer on which the mail server is running smail_from STRING Address from the users Mail provider smail_to STRING e-mail address of the person who should receive the message ssubject STRING This text will be placed in the head of the mail form smail_message STRING(255) Message text sattachment_file_name STRING(255) File name of the attachment ptattachment Pointer to Array[1..1500] of Byte This pointer shows to the data source for the attachment iattachment_length INT Number of Bytes in the attachment (max approximately1400 Byte) In_Output Datatyp: Comment: xsend BOOL The message will be send with the rising edge of the start input. This signal will be automatically reset after execution of the function block. Output Datatyp: Comment: xdone BOOL werror WORD 0: no error 17: attachment data to long 33, 65, 97, 129, 257, 305, 337: failure during smtp protocol 254: internal error, check your application program 255: ethernet connection to the mail server not available sanswer STRING Description:
WAGO Kontakttechnik GmbH Postfach 2880 D-32385 Minden Hansastraße 27 D-32423 Minden Telefon: 05 71/8 87 0 Telefax: 05 71/8 87 1 69 E-Mail: info@wago.com Internet: http://www.wago.com