Siemens SIMATIC S7-1200 - Page 1304

TeleService communication (SMTP email)
14.1 TM_Mail (Send email) instruction
S7-1200 Programmable controller
1304 System Manual, V4.2, 09/2016, A5E02486680-AK
Parameter and type
Data types
Description
ADDR_MAIL_SERVER
1
Static DWord IP address of the mail server: You must assign each IP
address fragment as an octet of two 4-bit hexadecimal char-
acters. If the IP address fragment = decimal value 10 which
equals hexadecimal value A, then you must enter "0A" for
that octet.
For example: IP address = 192.168.0.10
ADDR_MAIL_SERVER = DW#16#C0A8000A, where:
• 192 = 16#C0,
• 168 =16#A8
• 0 = 16#00
• 10 = 16#0A
WATCH_DOG_TIME
1
Static Time The maximum time allowed for TM_MAIL to complete the
entire SMTP process, from the initiation of the connection to
the SMTP to the end of the SMTP transmission. If this time
is exceeded, then TM_MAIL execution ends with an error.
The actual time delay until TM_MAIL ends and the error is
issued may exceed the WATCH_DOG_TIME, because of
the additional time required for the disconnect operation.
At first you should set a time of 2 minutes. This time can be
much smaller for an ISDN phone connection.
USERNAME
1
Static String Mail account user name: STRING data with a maximum
length 180 characters.
PASSWORD
1
Static String Mail server password: STRING data with a maximum length
180 characters.
FROM
1
Static String Sender address: STRING with a maximum length of 240
characters
SFC_STATUS
1
Static Word Execution condition code of the called communication
blocks
1
The values of these parameters are not modified at every call of TM_MAIL. The values are assigned in the TM_MAIL
instance data block and are only referenced once, on the first call of TM_MAIL.
SMTP authentication
TM_MAIL supports the SMTP AUTH LOGIN authentication method. For information on this
authentication method, please refer to the manual of the mail server or the website of your
internet service provider.
The AUTH LOGIN authentication method uses the TM_MAIL USERNAME and PASSWORD
parameters to connect with the mail server. The user name and password must be
previously set up on an email account at an email server.
If no value is assigned for the USERNAME parameter, then the AUTH LOGIN authentication
method is not used and the email is sent without authentication.