FB_SmtpV2

Der Funktionsbaustein FB_SmtpV2 sendet einen Datenstrom zu einem entfernten ADS Gerät via ADS. Der TwinCAT ADS SMTP Service muss auf dem entfernten ADS Gerät laufen, so dass der Datenstrom empfangen und in eine E-Mail verarbeitet werden kann. Sobald der Datenstrom verarbeitet wurde, wird die E-Mail versendet.

Eingänge

VAR_INPUT
    sNetId       : T_AmsNetID;  (* AmsNetID *)
    sSmtpServer  : T_MaxString; (* Smtp Server addres ( IP or Name) *)
    sUsername    : T_MaxString; (* Smtp Username *)
    sPassword    : T_MaxString; (* Smtp Password *)
    nAuth        : UDINT;       (* Smtp Auth Type *)
    sFrom        : T_MaxString; (* Sender stzring *)
    sTo          : T_MaxString; (* To recipient string *)
    sCc          : T_MaxString; (* Cc recipient string *)
    sBcc         : T_MaxString; (* Bcc recipient string *)
    sSubject     : T_MaxString; (* Subject string *)
    pMessage     : DWORD;       (* Pointer to the message *)
    cbMessage    : UDINT;       (* Message lenght in byte to send *)
    bExecute     : BOOL;
    tTimeout     : TIME := T#20s;
END_VAR

Name	Typ	Beschreibung
sNetId	T_AmsNetID	AmsNetID, auf dem der TwinCAT SMS Server läuft.
sSmtpServer	T_MaxString	Name oder IP des SMTP-Servers
sUsername	T_MaxString	Benutzername des SMTP Servers
sPassword	T_MaxString	Passwort für den SMTP Server
nAuth	UDINT	Smtp Auth Type: 0 = AUTH NONE 1 = RESERVED 2 = AUTH LOGIN 3 = AUTH NTLM 4 = AUTH PLAIN
sFrom	T_MaxString	Ein String, der die E-Mail-Adresse des Absenders enthält. Der Absender muss festgelegt werden. Der String ist auf 255 Zeichen limitiert.
sTo	T_MaxString	Ein String, der die E-Mail-Adresse des Empfängers enthält. Mindestens ein Empfänger muss eingetragen werden. Es ist auch möglich mehrere Adressen einzutragen. Diese müssen per Semikolon getrennt werden. Der String ist auf 255 Zeichen limitiert.
sCc	T_MaxString	Ein String, der die E-Mail-Adresse von weiteren Empfängern enthält (cc=carbon copy). Es ist möglich, mehrere Adressen von Empfängern einzutragen. Diese müssen dann durch ein Semikolon getrennt werden. Der String kann aber auch leer bleiben. Dem/den Empfänger(n) wird eine Kopie der E-Mail zugeschickt. Die E-Mail-Adresse des Empfängers ist für andere Empfänger sichtbar. Der String ist auf 255 Zeichen limitiert.
sBcc	T_MaxString	Ein String, der die E-Mail-Adressen von weiteren Empfängern enthält (Bcc = blind carbon copy). Es ist möglich, mehrere Adressen von Empfängern einzutragen. Diese müssen dann durch ein Semikolon getrennt werden. Der String kann aber auch leer bleiben. Dem/den Empfänger(n) wird eine Kopie der E-Mail zugeschickt. Die E-Mail-Adresse der Empfänger ist für andere Empfänger nicht sichtbar. Der String ist auf 255 Zeichen limitiert.
sSubject	T_MaxString	Dieser String enthält den Betreff der E-Mail. Falls die E-Mail ohne Betreff gesendet wird, wird automatisch der Computername des Absenders in die Betreffzeile geschrieben (z. B. "E-Mail gesendet von: CX_00762C"). Der String der Betreffzeile ist auf 255 Zeichen limitiert.
pMessage	DWORD	Dieser Parameter gibt die Adresse des Strings, welcher den Nachrichtentext enthält, an. Falls die E-Mail ohne Text gesendet wird, wird automatisch das Datum und die Uhrzeit eingesetzt (z. B. "Mail send at Thu, 23 Mar 2006 02:31:44 -0800"). Die Adresse des Strings kann mit dem ADR Operator festgelegt werden.
cbMessage	UDINT	Länge des E-Mail-Textes. Die Länge kann durch den LEN Operator festgelegt werden.
bExecute		Der Funktionsbaustein wird durch eine steigende Flanke an dieser Eingangsvariablen aktiviert.
tTimeout		Die maximale, erlaubte Zeit, um einen Befehl auszuführen.

Ausgänge

VAR_OUTPUT
    bBusy   : BOOL;
    bError  : BOOL;
    nErrId  : UDINT;
END_VAR

Name	Typ	Beschreibung
bBusy	BOOL	Die Ausgangsvariable bleibt TRUE, bis der Block einen Befehl ausgeführt hat, allerdings nur bis zum Ablauf von tTimeOut.
bError	BOOL	Die Ausgangsvariable wird auf TRUE umgeschaltet, sobald ein Fehler bei der Ausführung des Befehls auftaucht. Der befehlsspezifische Fehler ist in iErrorId enthalten.
nErrId	UDINT	Beinhaltet den befehlsspezifischen Fehlercode des zuletzt ausgeführten Befehls (siehe Tabelle).

	Stellen Sie sicher, dass Sie \o nicht innerhalb der Byte-Anordnung verwenden, ansonsten wird die Nachricht gestoppt. Die maximale Anzahl von Zeichen in einer Nachricht beträgt 510.725 - insgesamt haben Sie 1275 Zeichen für From, To, Cc, Bcc und Subject.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliothek
TwinCAT v3.0.0	PC or CX (x86)	Tc2_Smtp