Transmitting s in a local network with a WAGO CONTROLLER Application note

(1)

Transmitting e-mails in a local

network with a WAGO

CONTROLLER 750-842

Application note

A103000, English

Version 1.0.2

(2)

2 • General

Application note A103000

Copyright ã 2002 by WAGO Kontakttechnik GmbH

WAGO Kontakttechnik GmbH Hansastraße 27 D-32423 Minden Phone: +49 (0) 571/8 87 – 0 Fax: +49 (0) 571/8 87 – 1 69 E-Mail: [email protected] Web: http://www.wago.com Technical Support Phone: +49 (0) 571/8 87 – 5 55 Fax: +49 (0) 571/8 87 – 85 55 E-Mail: [email protected]

Every conceivable measure has been taken to ensure the correctness and com-pleteness of this documentation. However, as errors can never be fully ex-cluded we would appreciate any information or ideas at any time.

We wish to point out that the software and hardware terms as well as the trademarks of companies used and/or mentioned in the present manual are generally trademark or patent protected.

(3)

Table of Contents • 3

1 Important comments

To ensure fast installation and start-up of the units described in this manual, we strongly recommend that the following information and explanation is carefully read and adhered to.

1.1 Legal principles

1.1.1 Copyright

This manual is copyrighted, together with all figures and illustrations con-tained therein. Any use of this manual which infringes the copyright provisions stipulated herein, is not permitted. Reproduction, translation and electronic and photo-technical archiving and amendments require the written consent of WAGO Kontakttechnik GmbH. Non-observance will entail the right of claims for damages.

1.1.2 Personnel qualification

The use of the product detailed in this manual is exclusively geared to spe-cialists having qualifications in PLC programming, electrical spespe-cialists or persons instructed by electrical specialists who are also familiar with the valid standards. WAGO Kontakttechnik GmbH declines all liability resulting from improper action and damage to WAGO products and third party products due to non-observance of the information contained in this manual.

1.1.3 Intended use

For each individual application, the components supplied are to work with a dedicated hardware and software configuration. Modifications are only admit-ted within the framework of the possibilities documenadmit-ted in the manuals. All other changes to the hardware and/or software and the non-conforming use of the components entail the exclusion of liability on part of WAGO Kon-takttechnik GmbH.

Please direct any requirements pertaining to a modified and/or new hardware or software configuration directly to WAGO Kontakttechnik GmbH.

(5)

Important comments • 5

1.2 Range of validity

This application note is based on the stated hardware and software of the spe-cific manufacturer as well as the correspondent documentation. This applica-tion note is therefore only valid for the described installaapplica-tion.

New hardware and software versions may need to be handled differently. Please note the detailed description in the specific manuals.

1.3 Symbols

Danger

Always observe this information to protect persons from injury.

Warning

Always observe this information to prevent damage to the device.

Attention

Marginal conditions must always be observed to ensure smooth operation.

ESD (Electrostatic Discharge)

Warning of damage to the components by electrostatic discharge. Observe the precautionary measure for handling components at risk.

Note

Routines or advice for efficient use of the device and software optimisation.

More information

References to additional literature, manuals, data sheets and INTERNET pages

(6)

6 • Description

2 Description

The WAGO Ethernet controller 750-842 is used in this application note to dis-patch e-mails to a Microsoft Exchange server over a local network. The

SMTP-protocol is used to dispatch e-mails. The Ethernet-Controller operates in this case as a SMTP-Client.

The Microsoft Exchange server operates as a SMTP-Server and receives the e-mails.

The email recipient checks and fetches its e-mails from the Microsoft Exchange server with the POP3-protocol.

3 Reference Material

The connection was tested under the following prerequisites.

Assigned hardware components:

WAGO Controller 750-842 Standard PC

Assigned software components:

WAGO I/O Pro 32 V2.1SP10+ SMTP_MAIL.lib Version 1.1 Microsoft Outlook 98, Microsoft Exchange

Server 750-842 Ethernet-Controller PC Microsoft Exchange Server PC Microsoft Outlook 98

(7)

Solution • 7

4 Solution

4.1 Integration into a WAGO I/O PRO program

A mail client is implemented on the part of the WAGO controller. For this purpose a functional module is made available in the library MAIL_01.lib. The call of this module can be seen in the following picture. A detailed description of the parameters is to be found in chapter 4.2.

In this example mail is sent by "SYSTEM" to "[email protected]". In the reference text line of Outlook appears the following:

"ALARM: Fire early recognition system computer centre ". The actual message reads:

"Fire early recognition system responded".

(8)

8 • Solution

4.2 Function block description

WAGO-I/O-PRO Library elements

Category:

Name: SMTP_CLIENT

Type: Function Function block X Program

Library name: MAIL_01.lib

Applicable to: Ethernet controller 750-842

Input: Datatyp: Comments:

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 Data type: Comments:

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 Data type: Comments:

XDone BOOL 0: failure while sending mail, details according to wError

1: mail send, will stay on until a new rising edge of xSend is detected 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 Data send by the mail server according to SMTP protocol

(9)

(10)

WAGO Kontakttechnik GmbH Postfach 2880 • D-32385 Minden Hansastraße 27 • D-32423 Minden Phone: 05 71/8 87 – 0 Telefax: 05 71/8 87 – 1 69 E-Mail: [email protected] Internet: http://www.wago.com