SMS versenden

Versionsübersicht

Beschreibung	Version	letzte Änderung
FB SMS Versenden	2.0.0	20.06.2019

Unterstützte TIA-Versionen

• TIA V19 (ab Version 2.0.0)

Übersicht des Bausteines

Beschreibung

Allgemein

Im folgenden Abschnitt werden die grundlegenden Funktionen einer Kommunikation zwischen der S7-1500er und einem Lucom-Modem vom Typ UR5i V2 zum Versenden von SMS beschrieben.

Funktion

Über diesen Baustein und ein Lucom-Modem im Netzwerk kann der Bediener SMS, z.B. im Alarmfall, versenden.

Um eine Verbindung zu einem Lucom-Modem aufbauen zu können, muss an dem Eingang „Connect“ ein dauerhaftes „True“ anliegen. Über die IP-Adresse und der lokalen Hardwarekennung kann jetzt der Baustein eine Verbindung herstellen. Bei einem Fehler im Verbindungsaufbau wird der Ausgang „Error“ gesetzt und der entsprechende Fehlercode (siehe Tabelle 2) am Ausgang „Status“ ausgegeben. Bei erfolgreicher Verbindung wird der Ausgang „Connected“ gesetzt.

Um eine SMS verschicken zu können, muss der Eingang „Number“ mit einer Telefonnummer und der Eingang „Message“ mit dem entsprechenden Text beschrieben werden. Eine positive Flanke am Eingang „Send“ startet den Vorgang. Während des Vorganges ist der Ausgang „Busy“ gesetzt. Bei einem erfolgreichen Versenden der SMS wird der Ausgang „Done“ gesetzt. Bei einem Fehler werden der Ausgang „Error“ und der entsprechende Fehlercode am Ausgang „Status“ ausgegeben.

Wichtig: Eine SMS darf maximal 160 Zeichen beinhalten.

Beispielhafter Bausteinaufruf im OB 1

Übersicht der Parameter vom Baustein "SMS Versenden":

Parameter	Deklaration	Datentyp	Beschreibung
IP	Input	IP_V4	IP-Adresse Modem
InterfaceID	Input	HW_ANY	Hardware-Kennung der lokalen Schnittstelle
Connect	Input	Bool	0: Kommunikationsverbindung trennen / 1: Kommunikationsverbindung aufbauen und halten
Send	Input	Bool	Mit einer positiven Flanke wird der Text versendet
Number	Input	String	Telefonnummer
Message	Input	String	SMS-Text (max. 160 Zeichen)
Busy	Output	Bool	SMS wird gesendet
Done	Output	Bool	Sendevorgang abgeschlossen
Error	Output	Bool	Fehler beim Senden
Connected	Output	Bool	Mit Lucom-Modem verbunden
Status	Output	Word	Status der Verbindung

Parameter ERROR und STATUS

In der folgenden Tabelle sind die Fehlerbeschreibungen der Parameter ERROR und STATUS aufgelistet.

ERROR	STATUS* (W#16#....)	Beschreibung
0	0000	Sendeauftrag wurde fehlerfrei ausgeführt.
0	0001	Kommunikationsverbindung wurde aufgebaut.
0	0003	Kommunikationsverbindung wurde abgebaut.
0	7000	Keine Sendeauftragsbearbeitung aktiv, keine Kommunikationsverbindung aufgebaut.
0	7001	Erstaufruf beim Aufbau einer Verbindung.
0	7002	Zweitaufruf beim Aufbau einer Verbindung
0	7003	Kommunikationsverbindung wird abgebaut.
0	7004	Kommunikationsverbindung ist aufgebaut und wird überwacht. Keine Sendeauftragsverarbeitung aktiv.
0	7005	Senden der Daten läuft.
1	80A1	Verbindung oder Port wird vom Anwender bereits verwendet. Kommunikationsfehler: Die angegebene Verbindung wurde noch nicht aufgebaut. Die angegebene Verbindung wird gerade beendet. Eine Übertragung über diese Verbindung ist nicht möglich. Die Schnittstelle wird neu initialisiert.
1	80A3	Die unterlagerte Anweisung "T_DIAG" hat den Abbau der Verbindung gemeldet.
1	80A4	IP-Adresse des remoten Endpunkts der Verbindung ist ungültig, oder sie passt zur IP-Adresse des lokalen Partners.
1	80A7	Kommunikationsfehler: Sie haben die Anweisung mit COM_RST = 1 aufgerufen, bevor der Sendeauftrag beendet war.
1	80AA	Es läuft gerade ein Verbindungsaufbau mit der gleichen Verbindungs-ID durch einen anderen Baustein. Bitte wiederholen Sie den Auftrag durch einen erneuten Flankenanstieg am Parameter REQ.
1	80B3	Bei Verwendung der Protokollvariante UDP enthält der Parameter ADDR keine Daten. Fehler in der Verbindungsbeschreibung Der lokale Port wird bereits in einer anderen Verbindungsbeschreibung verwendet.
1	80B4	Bei Verwendung der Protokollvariante ISO on TCP (connection_type = B#16#12) für den passiven Aufbau einer Verbindung (active_est = FALSE) wurde eine oder beide der folgenden Bedingungen verletzt: local_tsap_id_len >= B#16#02 local_tsap_id[1] = B#16#E0
1	80B5	Bei Verbindungstyp 13 = UDP ist nur ein passiver Verbindungsaufbau zulässig.
1	80B6	Parametrierfehler im Parameter connection_type des Datenbausteins für Verbindungsbeschreibung.
1	80B7	Für Systemdatentyp TCON_Param: Fehler in einem der folgenden Parameter des Datenbausteins für Verbindungsbeschreibung: block_length, local_tsap_id_len, rem_subnet_id_len, rem_staddr_len, rem_tsap_id_len, next_staddr_len. Für Systemdatentypen TCON_IP_V4 und TCON_IP_RFC: IP-Adresse des Partner-Endpunkts wurde auf 0.0.0.0 gesetzt.
1	8085	Parameter LEN ist größer als der größte zulässige Wert.
1	8086	Der Parameter ID innerhalb des Parameters CONNECT liegt außerhalb des zulässigen Bereichs.
1	8087	Maximale Anzahl von Verbindungen erreicht, keine weitere Verbindung möglich.
1	8088	Der Wert am Parameter LEN passt nicht zu den am Parameter DATA angegebenen Empfangsbereich.
1	8089	Der Parameter CONNECT zeigt nicht auf einen Datenbaustein. Der Parameter CONNECT zeigt nicht auf eine Verbindungsbeschreibung. Die manuell erstellte Verbindungsbeschreibung hat für den gewählten Verbindungstyp eine falsche Struktur.
1	8091	Maximale Schachtelungstiefe überschritten.
1	809A	Der Parameter CONNECT zeigt auf ein Feld, das nicht der Länge der Verbindungsbeschreibung entspricht.
1	809B	InterfaceID ist ungültig. Sie ist entweder Null, oder sie zeigt nicht auf eine lokale CPU-Schnittstelle oder einen CP.
1	80C3	Alle Verbindungsressourcen sind belegt. Ein Baustein mit dieser ID wird bereits in einer anderen Prioritätsgruppe bearbeitet.
1	80C4	Temporärer Kommunikationsfehler: Die Verbindung kann derzeit nicht aufgebaut werden. Die Verbindung kann nicht aufgebaut werden, weil auf dem Verbindungsweg liegende Firewalls für die benötigten Ports nicht freigeschaltet sind. Die Schnittstelle empfängt gerade neue Parameter oder die Verbindung wird gerade aufgebaut. Die projektierte Verbindung wird gerade von einer Anweisung "TDISCON" entfernt. Die benutzte Verbindung wird gerade durch einen Aufruf mit COM_RST = 1 beendet. Temporär sind keine Empfangsressourcen beim Verbindungspartner verfügbar. Der Verbindungspartner ist nicht empfangsbereit.
1	80C5	Verbindung durch den Kommunikationspartner abgebaut. LSAP des remoten Verbindungspartners nicht freigegeben.
1	80C6	Netzwerkfehler: Remoter Partner kann nicht erreicht werden. Physikalische Unterbrechung an PROFIBUS.
1	8722	Parameter CONNECT: Der Quellbereich ist ungültig. Der Bereich ist im DB nicht vorhanden.
1	873A	Parameter CONNECT: Zugriff auf Verbindungsbeschreibung nicht möglich (z. B. weil der DB nicht verfügbar ist).
1	877F	Parameter CONNECT: Interner Fehler.
1	8822	Parameter DATA: Quellbereich ungültig, Bereich im DB nicht vorhanden.
1	8824	Parameter DATA: Bereichsfehler im VARIANT-Zeiger.
1	8832	Parameter DATA: DB-Nummer ist zu groß.
1	883A	Parameter CONNECT: Zugriff auf die angegebenen Verbindungsdaten nicht möglich (z. B. weil der DB nicht vorhanden ist).
1	887F	Parameter DATA: Interner Fehler, z. B. unzulässige VARIANT-Referenz.
1	893A	Parameter DATA: Zugriff auf den Sendebereich nicht möglich (z.B. weil der DB nicht vorhanden ist).
* Die Fehlercodes im Programmeditor können als Integer- oder Hexadezimalwert dargestellt werden.

Lucom-Modem

Im folgenden Abschnitt werden die nötigen Einstellungen für das Versenden von SMS im Lucom-Modem „UR5i V2“ näher erläutert.

Einstellung SMS

Die folgende Abbildung zeigt das Einstellungsfenster „SMS“ in der Parametrieroberfläche des Lucom-Modems. Per Klick links unter „Configuration“ auf „Services“ (1) und „SMS“ (2) öffnet sich dieses Fenster. Unter 3 muss der TCP-Port für eine Kommunikation mit einer SPS eingetragen werden. Dieser Port ist auf 2001 festgelegt. Zusätzlich muss der Haken bei dem Parameter „Enable AT-SMS protocol over TCP“ gesetzt werden.

Einstellungsfenster "SMS Versenden"

Nachdem alle Einstellungen vorgenommen wurden, muss das Lucom-Modem neu gestartet werden.