Komponenten > Kommunikation

Diese Komponente dient zum Senden und Empfangen von SMS Nachrichten über GSM/UMTS Funksticks.

Es wird die Verwendung eines GSM LAN Modem empfohlen. Getestet wurde das ConiuGo GSM-LAN-Modem LTE. Hier befindet sich die Konfigurationsanleitung.

Außerdem wurden die Sticks HUAWEI Stick E303 sowie der 4G XS Stick P14 getestet.
Bei Verwendung einiger Sticks muss am EisBär SCADA Server PC ein Benutzer angemeldet sein. Nur so ist sichergestellt, dass die Stick spezifische Software startet und diesen als COM-Port zur Verfügung stellt.

Bei Verwendung des HUAWEI Stick E303 ist dies nicht erforderlich. Hier funktioniert die Komponente auch ohne Benutzeranmeldung am Server-PC.

Die empfangenen SMS werden auf dem Stick automatisch gelöscht! Wenn keine Netzverbindung besteht oder die Hardware nicht erkannt wurde, wird die SMS gespeichert und erst gesendet, wenn wieder eine Verbindung besteht (Treiber muss an sein).

Bei fehlerhafter Übertragung, wird alle 5 Minuten versucht, die SMS erneut zu senden. Dies ist auf 60 Versuche limitiert.

Datenpunkte der Komponente:

Name	Typ	Funktion
Diagnose Fehler [Text]	Ausgang	Hier werden die Statusausgaben formatiert ausgegeben. Der Ausgang dient zur Diagnose bei Fehlschaltungen. Zur Anzeige des Textes empfiehlt sich die Anzeigekomponente Protokollfenster mit dessen Eingang (Signal) zu verwenden. Verbunden mit dem Eingang [Signal] des Protokollfensters werden dort die Diagnoseinformationen angezeigt.
Diagnose Info [Text]	Ausgang	Hier werden alle Vorgänge des Treibers ausgegeben.
Externe Benachrichtigungs-anforderung	Eingang	Dieser Datenpunkt kann mit der Störmeldemanager-Komponente verknüpft werden. Sollen Störungen an die Komponente SMS weitergegeben werden, so muss bei der "To Adress" eine pseudo E-Mail eingetragen werden. Diese hat folgende Form: <Nummer>@local.sms Bsp: 0170123456789@local.sms
Dynamisch	Ordner	In diesem Ordner befinden sich die Unterordner für die Empfänger und der Kanäle.
- Kanäle	Ordner	Dieser Ordner beinhaltet die angelegten Kanäle. Diese haben folgende Datenpunkte
- - Debug	Ausgang	Hier werden die Statusausgaben formatiert ausgegeben. Der Ausgang dient zur Diagnose bei Fehlschaltungen. Zur Anzeige des Textes empfiehlt sich die Anzeigekomponente Wertabhängiger Text mit dessen Wertanzeige-Eingang zu verwenden. Verbunden mit dem Eingang [Signal] des Protokollfensters werden dort die Diagnoseinformationen angezeigt.
- - Nachricht	Eingang	Eingang für den zu sendenden Text
- - Sendefehler	Ausgang	Anzeige, ob die Nachricht gesendet wurde oder nicht. Bei einem True ist die Übertragung fehlgeschlagen.
- - Trigger	Eingang	Über einen beliebigen Befehl wird der Kanal getriggert. Dies kann in der Kanalliste eingestellt werden. Beliebiges Ereignis: Ein beliebiges Eingangssignal an dem Trigger-Eingang sendet eine SMS mit dem Inhalt, der bei "Text (senden bei Trigger)" eingetragen wurde. Bei AN oder AUS: Mit einem True oder False am Trigger-Eingang wird eine SMS mit dem Inhalt, der bei "Text (senden bei Trigger)" eingetragen wurde gesendet.
- - URL	Ausgang	Wird eine URL in der SMS erkannt, wird diese hier ausgegeben.
- - Wert	Eingang	Wert für den vordefinierten Text, bei dem ein Platzhalter mit {{ }} formatiert vorkommt.
- Kontakte	Ordner	Der Ordner beinhaltet die hinterlegten Kontakte.
- - Nachricht	Ausgang	Wird von einem Kontakt eine SMS an den Eisbär gesendet, so wird die Nachricht hier ausgegeben.
- - URL	Ausgang	Wird eine URL in der SMS erkannt, wird diese hier ausgegeben.
Gültige PIN	Ausgang	Bei einem True, war die PIN-Eingabe gültig.
Herstellerinformationen	Ausgang	Gibt den Hersteller und die Modellbezeichnung des Sticks aus.
HW Status	Ausgang	Gibt an, ob mit dem Stick kommuniziert werden kann.
IMEI	Ausgang	Gibt die IMEI Nummer der SIM Karte aus.
Letzte Nachricht (empfangen)	Ausgang	Ausgabe der letzten empfangenen SMS mit "Nummer -> Text"
Letzte Nachricht (gesendet)	Ausgang	Ausgabe der letzten gesendeten SMS mit "Tag, Datum und Uhrzeit, Kanalname -> Text"
Netzwerk-Status	Ausgang	Gibt an, ob der Stick in einem Netzwerk eingebucht ist
Netzwerk-Status (enum)	Ausgang	Gibt einen Zahlencode aus. Hierbei sind die Zuordnungen wie folgt: 0 = nicht eingebucht, keine Netzsuche 1 = eingebucht im Heimnetzwerk (Senden und Empfangen möglich) 2 = nicht eingebucht, Netzsuche 3 = nicht eingebucht, Einbuchung abgelehnt 4 = Status nicht bekannt 5 = eingebucht im Fremdnetz
Sendefehler	Ausgang	Ist der Ausgang auf true gesetzt, ist das Senden einer SMS fehlgeschlagen.
Sendungswiederholung löschen	Eingang	Löscht die Nachrichtenliste, die entsteht, wenn die Nachrichten nicht gesendet werden können.
Seriennummer	Ausgang	Gibt die Seriennummer des Sticks aus.
Signalstärke	Ausgang	Gibt die Empfangsstärke in dBm an. Es wird alle Minute aktualisiert.
Signalqualität	Ausgang	Ausführungsbefehl meldet die Signalqualitätsindikatoren entsprechend dem Netz (2G, 3G, 4G), in dem das Modul registriert ist. Siehe Abschnitt Zusatzinfo unten.
SIM PIN	Eingang	Über „SIM PIN“ kann abweichend von der eingestellten PIN (die nur bei Start der Komponente übertragen wird) eine SIM PIN eingegeben werden (gilt nur temporär).
Treiber An/Aus	Bidirektional	Schaltet den Treiber An oder Aus
Url	Ausgang	Wird eine URL in der SMS erkannt, wird diese hier ausgegeben.

Mit "Text (senden bei Trigger)" kann ein vordefinierter Text beim Triggern versendet werden. Ist "Mit Kanalname Prefix" aktiviert, wird der Kanalname mit gesendet. Werte am Datenpunkt "Wert" können im Kanal übernommen werden, wenn der Platzhalter mit {{ }} formatiert. Beispiel: {{#0.0°C}}

Eigenschaften der Komponente:

Name	Standard	Funktion
Dienst-Konfiguration	COM1 ...	Hier wird die Hardware konfiguriert.
Kontakte	0	Öffnet den Editor zum Anlegen der Kontakte.
Kanäle	0	Öffnet den Editor zum Anlegen von definierten Meldungen als Kanäle.
Treiber An/Aus		Schaltet den Treiber An oder Aus.

Dienst-Konfiguration

Öffnet den Editor zur Konfiguration der Hardware.

Hier muss der COM-Port und die BAUD-Rate zur Kommunikation mit dem Stick eingestellt werden. Bei den beiden getesteten Sticks ist die BAUD Rate jeweils 9600. Der richtige COM-Port kann dem Windows Gerätemanager entnommen werden. Hierbei ist zu beachten, dass je nach Stick und Software mehrere virtuelle COM Ports angelegt werden. Der korrekte Port für den

HUAWEI Stick lautet „HUAWEI Mobile Connect – 3G PC UI Interface“ und für den

4G-Stick „Device-Application Interface“.

Achtung:

•Damit die COM Ports eingerichtet werden, muss die jeweilige Software installiert werden, da hierbei die benötigten Treiber mit installiert werden. Es sollte jeweils die aktuelle Software aus dem Internet verwendet werden. Gegebenenfalls muss in der Herstellersoftware noch die APN für den verwendeten Provider eingegeben werden.

•Damit der Eisbär mit den Sticks kommunizieren kann, darf der COM Port nicht durch die Hersteller-Software belegt sein. Diese ist vorher zu beenden. Meist wird die Software automatisch gestartet, wenn der Stick eingesteckt wird – das ist entweder durch geeignete Maßnahmen zu verhindern, oder die Software muss manuell beendet werden.

•Das Zeichen § kann nicht übertragen werden. Hierfür wird ein Unterstich eingefügt. Weiter ist darauf zu achten, ß nicht zu verwenden.

Kontakte

Hier werden die Empfänger definiert. Hierzu kann ein beliebiger Name und die zugehörige Telefonnummer eingegeben werden. Wenn von einer Nummer auch SMS empfangen werden sollen, dann ist darauf zu achten, dass hier die Nummer exakt wie vom Telefon gesendet eingetragen wird – insbesondere gilt das auch für die Ländervorwahl. Es empfiehlt sich auch die Nummer des Providers hier mit einzutragen. Nachrichten über Kontostand oder Datenvolumen werden meist auch über SMS versendet.

Kanäle

Zu einem Sende-Kanal muss ein zugehörige Empfänger und ein Sende-Trigger angegeben werden. Sende-Trigger bezieht sich auf den Datenpunkt "Trigger" im angelegten Kanal.

Die angelegten Kanäle können auch als XML-Datei exportiert werden.

<?xml version="1.0" encoding="utf-8"?>

</SMSChannelList>

SMS an den EisBär senden

Wird eine SMS an den EisBär gesendet, wird die Nachricht am Ausgang des hinterlegten Empfängers ausgegeben. Die Ausgabe erfolgt über den Datenpunkt "Nachricht" des Kontaktes.

Signalstärke:

ungefähre Bewertung:

· -89 dBm oder besser: 4 Balken (sehr gut)

· -99 dBm bis -108 dBm: 3 Balken

· -109 dBm bis -118 dBm: 2 Balken

· -119 dBm bis -128 dBm: 1 Balken

· -129 dBm oder schlechter: Kein Balken (kein Empfang)

2G-Netze Signalqualität (Bit Error Rate)

Werte (kleinere Zahlen = besser:

0 : weniger als 0,2% (sehr gut)

1 : 0,2% bis 0,4%

2 : 0,4% bis 0,8%

3 : 0,8% bis 1,6%

4 : 1,6% bis 3,2%

5 : 3,2% bis 6,4%

6 : 6,4% bis 12,8%

7 : mehr als 12,8% (sehr schlecht)

99 : nicht bekannt oder nicht nachweisbar

3G-Netze Signalqualität (EC/IO)

Werte (negativer = schlechter):

8 : -24 (oder weniger) dB (sehr schlecht)

7 : -23,5 ... -21 dB

6 : -20,5 ... -18 dB

5 : -17,5 ... -15 dB

4 : -14,5 ... -12 dB

3 : -11,5 ... -9 dB

2 : -8,5 ... -6 dB

0 : -5,5 ... 0 dB (sehr gut)

4G-Netze Signalqualität (RSRQ)

Werte (negativer = schlechter):

0 : -4 ... -3 dB (Sehr gut)

1 : -6 ... -5 dB (Sehr gut)

2 : -8 ... -7 dB (Sehr gut)

3 : -10 ... -9 dB (Sehr gut)

4 : -13 ... -11 dB (gut)

5 : -15 ... -14 dB (mittel)

6 : -17 ... -16 dB (mittel)

7 : -19 ... -18 dB (schlecht)

99 : nicht bekannt oder nicht erfassbar