Versenden von E-Mails mit dem 750-842 - Wago

Versenden von E-Mails,mit dem 750-842AnwendungshinweisA103002, DeutschVersion 1.0.0

ii • AllgemeinesCopyright © 2001 by WAGO Kontakttechnik GmbHAlle Rechte vorbehalten.WAGO Kontakttechnik GmbHHansastraße 27D-32423 MindenTel.: +49 (0) 571/8 87 – 0Fax: +49 (0) 571/8 87 – 1 69E-Mail: info@wago.comWeb: http://www.wago.comTechnischer SupportTel.: +49 (0) 571/8 87 – 5 55Fax: +49 (0) 571/8 87 – 4 30E-Mail: support@wago.comEs wurden alle erdenklichen Maßnahmen getroffen, um die Richtigkeit undVollständigkeit der vorliegenden Dokumentation zu gewährleisten. Da sichFehler, trotz aller Sorgfalt, nie vollständig vermeiden lassen, sind wir für Hinweiseund Anregungen jederzeit dankbar.Wir weisen darauf hin, dass die im Dokument verwendeten Soft- und Hardwarebezeichnungenund Markennamen der jeweiligen Firmen im Allgemeineneinem Warenzeichenschutz, Markenschutz oder patentrechtlichem Schutz unterliegen.AnwendungshinweisA103002

Inhalt• iiiINHALTSVERZEICHNIS1 Wichtige Erläuterungen............................................................................ 21.1 Rechtliche Grundlagen ................................................................................ 21.1.1 Urheberschutz................................................................................... 21.1.2 Personalqualifikation........................................................................ 21.1.3 Bestimmungsgemäßer Gebrauch...................................................... 21.2 Gültigkeitsbereich........................................................................................ 31.3 Symbole ....................................................................................................... 32 Beschreibung.............................................................................................. 43 Material ...................................................................................................... 44 Lösungen..................................................................................................... 54.1 Email an Mail-Server im Intranet ................................................................ 54.2 Email an Mail-Server im Internet ................................................................ 64.3 Email an Mail-Server im Internet oder Intranet........................................... 75 Die Beispielanwendung „MailProxyExample.pro“ ................................ 85.1 Anpassung der Action „Update_User“........................................................ 9Verwendete Funktionsbausteine .................................................................. 106.1 POP3 Client ............................................................................................... 116.2 SMTP Client.............................................................................................. 127 Anhang...................................................................................................... 147.1 Einstellungen für den Cisco Router Series 800 ......................................... 147.2 Konfiguration für den BinTec X1000 Router............................................ 16AnwendungshinweisA10302

2 • Wichtige Erläuterungen1 Wichtige ErläuterungenUm dem Anwender eine schnelle Installation und Inbetriebnahme der beschriebenenGeräte zu gewährleisten, ist es notwendig, die nachfolgendenHinweise und Erläuterungen sorgfältig zu lesen und zu beachten.1.1 Rechtliche Grundlagen1.1.1 UrheberschutzDieses Dokument, einschließlich aller darin befindlichen Abbildungen, ist urheberrechtlichgeschützt. Jede Weiterverwendung dieses Dokumentes, die vonden urheberrechtlichen Bestimmungen abweicht, ist nicht gestattet.Die Reproduktion, Übersetzung in andere Sprachen, sowie die elektronischeund fototechnische Archivierung und Veränderung bedarf der schriftlichenGenehmigung der WAGO Kontakttechnik GmbH, Minden. Zuwiderhandlungenziehen einen Schadenersatzanspruch nach sich.Die WAGO Kontakttechnik GmbH behält sich Änderungen, die dem technischenFortschritt dienen, vor.Alle Rechte für den Fall der Patenterteilung oder des Gebrauchmusterschutzessind der WAGO Kontakttechnik GmbH vorbehalten. Fremdprodukte werdenstets ohne Vermerk auf Patentrechte genannt. Die Existenz solcher Rechte istdaher nicht auszuschließen.1.1.2 PersonalqualifikationDer in diesem Dokument beschriebene Produktgebrauch richtet sich ausschließlichan Fachkräfte mit einer Ausbildung in der SPS-Programmierung,Elektrofachkräfte oder von Elektrofachkräften unterwiesene Personen, die außerdemmit den geltenden Normen vertraut sind. Für Fehlhandlungen undSchäden, die an WAGO-Produkten und Fremdprodukten durch Missachtungder Informationen dieses Dokumentes entstehen, übernimmt dieWAGO Kontakttechnik GmbH keine Haftung.1.1.3 Bestimmungsgemäßer GebrauchDie Komponenten werden ab Werk für den jeweiligen Anwendungsfall mit einerfesten Hard- und Softwarekonfiguration ausgeliefert. Änderungen sind nurim Rahmen der in dem Dokument aufgezeigten Möglichkeiten zulässig. Alleanderen Veränderungen an der Hard- oder Software, sowie der nicht bestimmungsgemäßeGebrauch der Komponenten, bewirken den Haftungsausschlussder WAGO Kontakttechnik GmbH.Wünsche an eine abgewandelte bzw. neue Hard- oder Softwarekonfigurationrichten Sie bitte an WAGO Kontakttechnik GmbH.AnwendungshinweisA103002

Wichtige Erläuterungen • 31.2 GültigkeitsbereichDieser Anwendungshinweis basiert auf die genannte Hard- und Software derjeweiligen Hersteller sowie auf die zugehörige Dokumentation. Daher gilt dieserAnwendungshinweis 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.1.3 SymboleGefahrInformationen unbedingt beachten, um Personen vor Schaden zu bewahren.AchtungInformationen unbedingt beachten, um am Gerät Schäden zu verhindern.BeachtenRandbedingungen, die für einen fehlerfreien Betrieb unbedingt zu beachtensind.ESD (Electrostatic Discharge)Warnung vor Gefährdung der Komponenten durch elektrostatische Entladung.Vorsichtsmaßnahme bei Handhabung elektrostatisch entladungsgefährdeterBauelemente beachten.HinweisRoutinen oder Ratschläge für den effizienten Geräteeinsatz und die Softwareoptimierung.Weitere InformationenVerweise auf zusätzliche Literatur, Handbücher, Datenblätter undINTERNET Seiten.AnwendungshinweisA103002

4 • Beschreibung2 BeschreibungVerwendung der Bibliothek „Mail_02“ zum Versenden von Emails mit demEthernet-Controller 750-842.– direkt an einen Mail-Server im Intranet.– direkt an einen Mail-Server im Internet über einen Router.– an einen Mail-Server im Internet oder Intranet über einen lokalen Proxy.3 MaterialDie Anbindung ist unter den folgenden Voraussetzungen getestet worden.Eingesetzte Hardware Komponenten:WAGO ControllerISDN - RouterISDN - RouterISDN - Karte750-842-HW:06 SW:06BinTec - X1000Cisco 800 SeriesAVM Fritz PCIEingesetzte Software Komponenten:WAGO I/O Pro 32V2.1SP10+MAIL_02.lib Version 1.0MailProxyExample.proAnwendungsbeispielMicrosoft Outlook 98Microsoft Internet Explorer 5Microsoft Exchange ServerProxyPlus2.5 (Freeware)http://proxyplus.czWAN:Internet ProviderMail ProviderArcor, FreenetWeb.deAnwendungshinweisA103002

Lösungen • 54 LösungenDer Ethernet Controller bietet die Möglichkeit u.a. E-Mails zu versenden. Inder Bibliothek Mail_02 werden zu diesem Zweck zwei Funktionsblöcke zurVerfügung gestellt, die es dem Anwender erlauben, ohne Kenntnisse des MailProtokolls (SMTP), eine Mail zu verschicken.Im folgenden werden drei Varianten aufgezeigt, alle Varianten sind mit demAnwendungsbeispiel abgedeckt. Abhängig von der gewählten Variante sindzusätzliche Tools einzusetzen und zu konfigurieren.4.1 Email an Mail-Server im IntranetDas Anwendungsbeispiel erlaubt das Senden von Emails mit beliebigem Absenderan eine bestimmte Emailadresse im Intranet.Voraussetzungen:- Mail-Server im Netzwerk: z.B.: ArGoSoft-Mail-Server- Account für Mail-Server: z.B.: MyLocalAccount/MyLocalPassword- Emailadresse: z.B.: MyLocalEmail@MyDomain.comWAGO 750-842EmpfängerEthernetMail ServerParametrierung des Ethernet-Controllers 750-842 mit „BootP.exe“:- IP-Adresse zuweisen.– Netzwerkmaske anpassen.– Die IP-Adresse des Mail-Servers als Gateway eintragen.Zur Anpassung des Anwendungsbeispieles ist die Aktion „Update_User“im Hauptprogramm „PLC_PRG“ zu überarbeiten.AnwendungshinweisA103002

6 • Lösungen4.2 Email an Mail-Server im InternetDas Anwendungsbeispiel erlaubt das Senden von Emails an beliebige Empfängerim Internet.Als Absender wird ein gültiger Mail-Server-Account eines Internet-Service-Providers (ISP) benötigt.Voraussetzungen:- ISDN-Router- Mail-Server im Internet: z.B.: web.de- Account für Mail-Server: z.B.: MyWebAccount/MyWebPassword- Emailadresse: z.B.: MyEmail@web.deWAGO 750-842EmpfängerEthernetISDN-RouterISDNISP-Mail-Server (web.de)SMTP-Server: 217.72.192.134POP3-Server: 217.72.192.157Parametrierung des Ethernet-Controllers 750-842 mit „BootP.exe“:- IP-Adresse zuweisen.– Netzwerkmaske anpassen.– Die IP-Adresse des ISDN-Routers als Gateway eintragen.Zur Anpassung des Anwendungsbeispieles ist die Aktion „Update_User“im Hauptprogramm „PLC_PRG“ zu überarbeiten.AnwendungshinweisA103002

Lösungen • 74.3 Email an Mail-Server im Internet oder IntranetDas Anwendungsbeispiel erlaubt wahlweise:- Das Senden von Emails an beliebige Empfänger im Internet.Die Übertragung der Email erfolgt in zwei Abschnitten. Zunächst wird dieEmail an den lokalen Intranet-Mail-Server übertragen. Anschließend wirddie Email vom Proxy-Server maskiert und an ISP-Mail-Server übertragen.- - Das Senden von Emails mit beliebigem Absender an einebestimmte Emailadresse im Intranet.Voraussetzungen für Internetbetrieb:- ISDN-Karte- Local-Mail-Server:- Account für Local-Mail-Server:z.B.: MyLocalAccount/MyLocalPassword- Account für ISP-Mail-Server: z.B.: MyWebAccount/MyWebPassword– ISP-Emailadresse: z.B.: MyEmail@web.deVoraussetzungen für Intranetbetrieb:- Local-Mail-Server:- Account für Local-Mail-Server:z.B.: MyLocalAccount/MyLocalPassword– Local-Emailadresse: z.B.: MyLocalEmail@MyDomain.comWAGO 750-842EthernetProxy-ServerIntranet-Mail-ServerSMTP-Server:POP3-Server:ISDNISP-Mail-Server (web.de)SMTP-Server: 217.72.192.134POP3-Server: 217.72.192.157Empfänger1Empfänger2Parametrierung des Ethernet-Controllers 750-842 mit „BootP.exe“:- IP-Adresse zuweisen.– Netzwerkmaske anpassen.– Die IP-Adresse des Proxy-Servers als Gateway eintragen.Zur Anpassung des Anwendungsbeispieles ist die Aktion „Update_User“im Hauptprogramm „PLC_PRG“ zu überarbeiten.AnwendungshinweisA103002

8 • Die Beispielanwendung „MailProxyExample.pro“5 Die Beispielanwendung „MailProxyExample.pro“Die Bedienoberfläche der Beispielanwendung:Abhängig vom Modus (local/www), arbeitet die Anwendung mit einer festenZiel- oder Absenderadresse. Die feste Adresse ist grau hinterlegt.Beide Betriebsarten werden nur bei Verwendung eines Proxy-Servers mitMail-Server-Funktionalität unterstützt.AnwendungshinweisA103002

Die Beispielanwendung „MailProxyExample.pro“ • 95.1 Anpassung der Action „Update_User“Ein Mail-Provider betreibt in der Regel einen POP3 und einen Mail Server.Beide Server verfügen über eine eigene IP Adresse. Damit eine Mail vomWAGO Ethernet Controller verschickt werden kann, ist es in der Regel notwendig,sich beim Provider zu authentifizieren. Dieses geschieht am POP3Server. Der Benutzer wird durch die Angabe seines User Namens sowie seinesPaßwortes identifiziert.Bei Verwendung eines Proxy-Servers beziehen sich beide Accounts auflokale Konten, da heißt, der Ethernet-Controller sendet die Email zunächst anden Lokalen-Mail-Server des Proxy.Abhängig von der Konfiguration sendet dieser die Email sofort oder zu festgelegtenZeiten an den ISP-Mail-Server.AnwendungshinweisA103002

10 • Verwendete Funktionsbausteine6 Verwendete FunktionsbausteineDie folgende Abbildung zeigt den Aufruf und die Verschaltung der BausteineMAIL_Pop3Client und MAIL_SmtpClient.Zu beachten ist, dass der Ausgang xDone des SMTP_Clients mit demEingang xCLOSE_POP_CONNECTION des POP3_Clients, sowie derAusgang xAUTHORIZATION_OK mit dem Eingang xSend zu beschaltenist.Der Baustein POP3_Client stellt die Verbindung zum Server her und baut sieerst wieder ab, wenn er durch den SMTP_Client mitgeteilt bekommt, dass dereigentliche Mail-Vorgang abgeschlossen ist.Bei diesem Vorgehen wird unterstellt, dass die Autorisierung beim Mail Providerdurch das POP3 Protokoll, gemäß „Pop3 before SMTP“ möglich ist.Ferner wird von einer festen IP Adresse für den SMTP- und POP3 Server ausgegangen.AnwendungshinweisA103002

Verwendete Funktionsbausteine • 116.1 POP3 ClientWAGO-I/O-PRO – Library - ElementeKategorie:Name:MAIL_Pop3ClientTyp: Funktion Funktionsblock X ProgrammName der Bibliothek: MAIL_02.libAnwendbar für: Ethernet controller 750-842Input: Datatyp: Comment:sIP STRING IP Address of the computer on whichthe pop3 server is runningsUSER STRING User name for your mail boxsPASS STRING Password for your mail boxxSTART BOOL With the rising edge of START the connectionto your pop3 server will be establishedxCLOSE_POP_CONNECTIONBOOLWith the rising edge of this signal theconnection to the pop3 server will beclosedOutput Datatyp: Comment:xAUTHORIZATION_OK BOOL User authorized and connection establishedxDONEBOOLwERROR WORD 0: no error1: ethernet connection to thepop3 server not available65: wrong user name97: wrong user or password129: wrong passwordsANSWERSTRINGDescription:This function block uses POP3 protocol. It will establish a connection to the pop3server. While this connection is set up successful, the user may send E-mails usingthe MAIL_SmtpClient function block.The function will be started with the rising edge of the input START. The output parameterswill indicate the result of the function. To close the connection you have toprovide a rising edge at the input xCLOSE_POP_CONNECTION.AnwendungshinweisA103002

12 • Verwendete Funktionsbausteine6.2 SMTP ClientWAGO-I/O-PRO – Library - ElementeKategorie:Name:MAIL_SmtpClientTyp: Funktion Funktionsblock X ProgrammName der Bibliothek: MAIL_02.libAnwendbar für: Ethernet controller 750-842Input: Datatyp: Comment:sSmtpServerIP STRING IP Address of the computer on whichthe mail server is runningsFrom STRING Address from the users Mail providersTo STRING e-mail address of the person whoshould receive the messagesSubject STRING This text will be placed in the head ofthe mail formsMessage STRING(255) Message textsAttachmentFileName STRING(255) File name of the attachmentptAttachmentPointer toArray[1..1500]of ByteThis pointer shows to the data sourcefor the attachmentiAttachmentLength INT Number of Bytes in the attachment(max approximately1400 Byte)In_Output Datatyp: Comment:xSend BOOL The message will be send with the risingedge of the start input. This signalwill be automatically reset after executionof the function block.Output Datatyp: Comment:xDoneBOOLwError WORD 0: no error17: attachment data to long33, 65, 97, 129, 257, 305, 337:failure during smtp protocol254: internal error, check your applicationprogram255: ethernet connection to the mailserver not availablesAnswerSTRINGDescription:This function block uses SMTP protocol. The mail may include an attachment.Attachment data is base_64 coded. Therefore it is possible to mail binary data.The mail server must be able to handle Mime V1.0 format.In case of sending a simple mail without attachment, do not use the inputssAttachmentFileName, ptAttachment and iAttachmentLength.The mail function will be started with the rising edge of the input xSend. The outputparameters will indicate the result of the function. The variable xSend will be reset bythe function block.AnwendungshinweisA103002

Anhang • 137 Anhang7.1 Einstellungen für den Cisco Router Series 800Die meisten Einstellungen sind durch das mitgelieferte Konfigurationstool vorzunehmen. Die zuwählende Rufnummer des Internet Providers konnte jedoch nicht korrekt vorgegeben werden, dadas Konfigurationstool die Verwendung einer Nebenstelle(einfügen einer 0 zur Amtsholung)nichtvorsieht.Der von uns getesteten Anbindung lag seitens des Cisco Routers folgende Konfiguration zuGrunde:AnwendungshinweisA103002Current configuration : 1828 bytes!version 12.2no service padservice timestamps debug uptimeservice timestamps log uptimeservice password-encryption!hostname r801_test!enable secret 5 $1$W0RF$RzjAxjotUVsZRIGa/Gorq/!username r801_test password 7 15050A0B0Bip subnet-zerono ip source-route!ip name-server 145.253.2.11ip name-server 145.253.2.75isdn switch-type basic-net3!!interface Ethernet 0ip address 10.1.3.250 255.255.0.0ip access-group 121 inno ip proxy-arpip nat inside!interface BRI0no ip addressencapsulation pppdialer pool-member 1isdn switch-type basic-net3ppp authentication chap pap callin!interface Dialer1description ISP

14 • Anhangip address negotiatedip access-group 121 inno ip proxy-arpip nat outsideencapsulation pppno ip split-horizondialer pool 1dialer remote-name Cisco1dialer idle-timeout 60dialer string 00101901929 class DialClassdialer hold-queue 10dialer-group 1pulse-time 0ppp authentication chap pap callinppp chap hostname arcorppp chap password 7 130C19060E1E0A2F3Fppp pap sent-username arcor password 7 011A08105E19080A35!ip nat inside source list 18 interface Dialer1 overloadip http serverip classlessip route 0.0.0.0 0.0.0.0 Dialer1!map-class dialer DialClassdialer isdn short-hold 120access-list 18 permit 10.1.0.0 0.0.255.255access-list 121 deny udp any eq netbios-dgm anyaccess-list 121 deny udp any eq netbios-ns anyaccess-list 121 deny udp any eq netbios-ss anyaccess-list 121 deny tcp any eq 137 anyaccess-list 121 deny tcp any eq 138 anyaccess-list 121 deny tcp any eq 139 anyaccess-list 121 permit ip any any time-range TIMEdialer-list 1 protocol ip permit!line con 0exec-timeout 120 0stopbits 1line vty 0 4exec-timeout 0 0login local!no rcapi server!time-range TIMEperiodic daily 0:00 to 23:59!endAnwendungshinweisA103002

Anhang • 157.2 Konfiguration für den BinTec X1000 RouterDie Konfiguration des Routers läßt sich vollständig mit dem Configurations Wizard durchführen.Zur Inbetriebnahme des Routers sind die Schritte des Quick Install Guides von Bintec durchzuführen.AnwendungshinweisA103002

WAGO Kontakttechnik GmbHPostfach 2880 • D-32385 MindenHansastraße 27 • D-32423 MindenTelefon: 05 71/8 87 – 0Telefax: 05 71/8 87 – 1 69E-Mail: info@wago.comInternet:http://www.wago.com