Didactum Monitoring-Systeme
Modem, SMS-Befehle & GPS einrichten

Didactum-Überwachungssysteme (Modelle 50T, 100T, 500T und 550T) können mit einem GSM- bzw. 4G/LTE-Modem ausgestattet werden. Damit ist es möglich, SMS-Benachrichtigungen zu versenden, das Gerät per SMS-Befehl fernzusteuern und – bei kompatiblen LTE-Modems – eine Internetverbindung als Failover-Lösung sowie eine GPS-Ortung zu nutzen.

Die Modems arbeiten im Primärmodus. Ist der Primärmodus nicht verfügbar (z. B. kein 4G-Empfang), wechselt das Modem automatisch in den Sekundärmodus (2G).

Aufgabe: Alarmmeldungen so lange senden, bis der Alarm per SMS-Befehl deaktiviert wird oder sich die Bedingungen ändern.

Um dies umzusetzen, wird ein Trigger-Element als Zwischenschritt verwendet. Der Trigger wird beim Auftreten eines Alarms aktiviert ("ein") und bei Normalisierung wieder deaktiviert ("aus"). Solange der Trigger aktiv ist, werden Nachrichten- bzw. Anruf-Aktionen ausgeführt. Über einen SMS-Befehl kann der Trigger deaktiviert werden, wenn die Benachrichtigung nicht mehr benötigt wird.

Schritt 1 – Trigger-Element „Trigger Alarm" erstellen

🔍 Vergrößern

Legen Sie im System-Tree-Panel ein neues Trigger-Element mit dem Namen „Trigger Alarm" an. Dieses Element dient als Zwischenspeicher für den Alarmzustand.

Schritt 2 – Logikschaltung zur Steuerung des Triggers

🔍 Vergrößern

Erstellen Sie eine Logikschaltung (Preferences → Logic schemes), die den Trigger bei Eintreten des Alarms einschaltet und bei Rückkehr zum Normalzustand wieder ausschaltet.

Schritt 3 – Logikschaltung für Benachrichtigungen

🔍 Vergrößern

Im Alarmfall wird eine SMS gesendet (Benachrichtigungselement „SMS to Admin") und anschließend ein Anruf an die hinterlegte Nummer ausgelöst (Anruf-Aufgabe „Dial to Admin"). Der Anruf wird gemäß Feld „Repeat/Duration" alle 10 Minuten wiederholt, bis der Alarm zurückgesetzt wird. Die SMS wird nur einmal versendet.

Schritt 4 – Alarm vorzeitig per SMS deaktivieren

Um den Alarm vorzeitig zu deaktivieren, sobald die Benachrichtigung den Empfänger erreicht hat und keine weiteren Meldungen mehr benötigt werden, muss der „Trigger Alarm" ausgeschaltet werden. Tragen Sie dazu die zulässigen Rufnummern im Feld „List of allowed phone numbers" auf der Seite „SMS messages" ein. Senden Sie dann folgende SMS:

Geräte ohne eigenes GSM-/4G-Modem (z. B. ein Didactum 50T ohne Modemoption) können SMS-Benachrichtigungen über ein anderes Didactum-Gerät versenden, das mit einem GSM-Modem ausgestattet ist (sogenanntes SMS-Gate).

Mit dieser Funktion können eingehende SMS empfangen und deren Inhalt an andere Telefonnummern oder E-Mail-Adressen weitergeleitet werden. Die Einstellungen befinden sich auf der Seite „SMS messages", Reiter „Incoming".

🔍 Vergrößern

Auf der rechten Seite wird eine Liste aller eingehenden SMS angezeigt. Hier finden Sie die zentralen Einstellungen für SMS-Weiterleitung und SMS-Befehle.

Verfügbare Einstellungen

SMS-Befehle zur Fernsteuerung

SMS-Befehle ermöglichen die Fernsteuerung des Überwachungssystems: Auslesen von Systemstatus, Sensorwerten und Gruppenwerten sowie Schalten von Relais (Steckdosen). Die berechtigten Rufnummern werden unter Main menu → SMS messages → List of allowed phone numbers hinterlegt.

1. Status auslesen: get

Syntax: get [ID] oder get [Name] – ID ist die ID-Nummer des Elements, Name der Name des Elements. „get" ist nicht case-sensitiv (auch Get, GET möglich). Der Name muss in Anführungszeichen stehen, ist case-sensitiv und muss eindeutig sein.

Die Antwort-SMS enthält den Status des angefragten Sensors bzw. Relais.

2. Relais / Steckdosen schalten: set

Syntax: set [ID] [state] oder set [Name] [state] – state kann on (einschalten) oder off (ausschalten) sein. Der Name ist case-sensitiv.

Antwort: The element (Elementname) was switched on bzw. ... was switched off

3. Relais-Impuls (Pulse): set ... pulse

Syntax: set [ID] pulse {Dauer} oder set [Name] pulse {Dauer} – Dauer ist die Verzögerung in Sekunden (Wertebereich 1–120). Wird keine Dauer angegeben, gilt der zuvor eingestellte Wert. Der Befehl schaltet das Relais zweimal um (Impuls) mit der angegebenen Verzögerung.

Antwort: The element (Elementname) was switched

4. Logikschaltungen steuern: logic

Syntax: logic [ID] [state] {Dauer} oder logic * [state] – ID ist die Logiknummer (* = alle Logiken), state ist on oder off, Dauer die Deaktivierungszeit in Sekunden (nur bei einzelner Logik). Alle Felder sind nicht case-sensitiv.

Antwort: OK

Dieser Abschnitt richtet sich an technisch versierte Anwender und Integratoren, die Benutzerkonten und Berechtigungen direkt über die API verwalten oder eine zentrale Authentifizierung über einen RADIUS-Server einrichten möchten.

Berechtigungskonzept

Jedes Benutzerprofil kann auf Systemressourcen lesend (read-only) oder lesend/schreibend (read-write) zugreifen. Jede Ressource besitzt eine Zugriffskennung; die Zugriffskontrolle erfolgt über kommagetrennte Listen von Kennungen.

Wichtige Server-Ressourcen-IDs (Auswahl): accesskeys, cameras, canbus, devvirt, elements, groups, gsm, log, logics, modules, notify, relays, sdcard, system, users, view sowie all (Vollzugriff auf alle Ressourcen).

Bei Gruppen-Berechtigungen (GRead/GWrite) gilt zusätzlich: all = voller Zugriff auf alle Gruppen, none = Zugriff vollständig verweigert. Standardmäßig sind Elemente keiner Gruppe zugeordnet – Zugriff ist dann nur mit all möglich.

Authentifizierung & Session

Bei der Anmeldung (querytype=auth, Felder name und Passwort-Hash h) erhält der Client einen Session-Key (k), mit dem alle weiteren API-Aufrufe authentifiziert werden. Alternativ ist eine Anmeldung per PIN-Code möglich (querytype=authpin, Felder name und n, 4–8-stellig).

Die Session wird mit querytype=authclose und Übergabe des Session-Keys beendet. Nach einem Neustart des Systems gehen alle Sessions verloren – eine erneute Anmeldung ist erforderlich.

Benutzerkonten lesen, anlegen und löschen

Zentrale Authentifizierung über RADIUS

Alternativ zur lokalen Benutzerdatenbank kann die Anmeldung über einen externen RADIUS-Server erfolgen. Die Anmeldung erfolgt zweistufig: Zunächst wird der Benutzer in der lokalen Datenbank gesucht; wird er dort nicht gefunden, erfolgt eine Anfrage an den RADIUS-Server.

Vendor-Specific Attributes (Hersteller-Code 39052)

Auf dem RADIUS-Server muss das herstellerspezifische Dictionary dictionary.local im Verzeichnis /etc/raddb/ hinterlegt und in die Haupt-Dictionary-Datei eingebunden werden.

🔍 Vergrößern

In den Richtlinieneinstellungen: Standard-RADIUS-Attribute löschen. Im Bereich „Anbieterspezifisch" → Anbieter: „Benutzerdefiniert" → Anbieter-Code: 39052. Attribute nach Nummer eintragen (siehe Tabelle unten).

🔍 Vergrößern

Ergebnis: Alle Benutzer in der Gruppe „RADIUS Gruppe" erhalten vollen Administrator-Zugang auf die Didactum-Einheit. Für unterschiedliche Rechte auf verschiedenen Geräten können separate Richtlinien mit NAS-IP-Adressen-Bedingungen erstellt werden.

Beispiel-Konfigurationsdateien

Prüfen, ob das Modem betriebsbereit ist

1. SIM-Karte in das Modem einsetzen. Sicherstellen, dass ausreichendes Guthaben bzw. ein gültiger LTE-Vertrag vorhanden ist.
2. Sicherstellen, dass die externen Antennen am Modem angebracht sind – sowohl „MAIN" als auch „AUXILIARY".
3. System einschalten. Beim Hochfahren wird das Modem automatisch erkannt.
4. Wurde die SIM-Karte bei eingeschaltetem System eingesetzt, kann die Netzregistrierung bis zu 15 Minuten dauern.
5. Bei erfolgreicher Modem-Erkennung erscheint der Menüpunkt „SMS messages".
6. Signalstärke prüfen (Beispiel: 48 %).

🔍 Vergrößern

Die Signalstärke wird als Prozentwert (0–100 %) angezeigt. Ein höherer Wert bedeutet besseren Empfang.

Test-SMS senden

1. Klicken Sie auf „+" rechts neben „List of SMS messages" – ein Fenster zum Senden einer Test-SMS öffnet sich.
2. Mobilnummer und Nachrichtentext eingeben und auf „OK" klicken.
3. Die SMS sollte am angegebenen Mobiltelefon eingehen.
4. Im Webinterface erscheint eine Bestätigung über den erfolgreichen Versand.

🔍 Vergrößern

Geben Sie Mobilnummer und Testtext ein und bestätigen Sie mit „OK".

🔍 Vergrößern

Nach erfolgreichem Versand zeigt das System eine entsprechende Bestätigungsmeldung an.

Internetverbindung über LTE

Ab Firmware-Version 2.7.4 kann das LTE-Modem zusätzlich für die Verbindung zu Internetdiensten (VPN, SMTP, FTP usw.) sowie für den Fernzugriff auf das Gerät verwendet werden. Die Einstellungen finden Sie unter Preferences → LTE.

🔍 Vergrößern

Übersicht der konfigurierbaren LTE-Parameter (siehe Tabelle unten für Details zu jedem Feld).

Für eine dauerhafte Internetanbindung empfiehlt sich zusätzlich der Einsatz eines OpenVPN-Clients: Die VPN-Verbindung bleibt sowohl über Ethernet als auch über LTE (bei Ausfall von Ethernet) bestehen und sichert so den permanenten Zugriff auf das geschützte Netzwerk sowie eine feste IP-Adresse des Geräts.

Zugriff auf das Gerät über LTE aus dem Internet

Unterstützt die SIM-Karte einen privaten APN mit statischer IP-Adresse, kann das Gerät direkt über diese IP erreicht werden (Anfrage beim Mobilfunkprovider erforderlich). Die zugewiesene LTE-IP-Adresse finden Sie im Reiter „Network" (Feld „LTE IP address").

🔍 Vergrößern

Übersicht der Netzwerkadressen des Geräts (siehe Tabelle unten zur Erläuterung der einzelnen Felder).

Das Modem wird im System zum Versand von SMS-Benachrichtigungen und zum Empfang von SMS-Befehlen verwendet.

Grundsätzliches Vorgehen

1. SIM-Karte in ein Mobiltelefon einsetzen und Funktionsfähigkeit sowie PIN-Code prüfen.
2. SIM-Karte in das Modem einsetzen.
3. Überwachungssystem einschalten.
4. Modem konfigurieren (siehe unten).
5. SMS-Benachrichtigungen einrichten und passende Logikschaltungen bzw. Gruppen-Benachrichtigungen konfigurieren.

Modem-Konfiguration

Die Modem-Konfiguration erfolgt im Reiter Main Menu → SMS messages.

🔍 Vergrößern

Übersicht aller Modem-Eigenschaften und Einstellfelder (siehe Tabelle unten für die Erläuterung der einzelnen Felder).

Tritt ein Modemfehler auf, ist keine SIM-Karte eingesetzt oder der PIN-Code falsch, wird eine entsprechende Meldung in die Log-Warteschlange geschrieben („GSM modem: Error, check your SIM card and PIN code" bzw. „GSM modem: modem error, restart smsd"). Die Meldung wird maximal 5-mal angezeigt, um das Log nicht zu überfüllen.

Die „List of SMS messages" zeigt bis zu 100 zuletzt gesendete SMS (bei VT9xx-Systemen bis zu 1000). Diese Liste wird bei einem Neustart des Geräts nicht gespeichert.

GSM-Netzbetreiber-Liste

Die Betreiberliste wird nach dem Einschalten in regelmäßigen Abständen automatisch aktualisiert und kann manuell per Button erneut abgerufen werden. Das Abrufen kann mehrere Minuten dauern; bei Erfolg erscheint eine entsprechende Log-Meldung. Kann keine Verbindung zum gewählten Betreiber hergestellt werden, wechselt das Modem in den automatischen Auswahlmodus. Der aktuell genutzte Betreiber wird im Feld „Operator" angezeigt.

GSM-Modem-Elemente im System-Tree

Im Menü „System Tree" stehen Elemente zur Verfügung, die den Status des Modems anzeigen. Diese beeinflussen den Zustand des Elements „System" nicht und können in Logikschaltungen verwendet werden.

🔍 Vergrößern

Diese Elemente lassen sich wie reguläre Sensoren in Gruppen einbinden und für Benachrichtigungen bzw. Logikschaltungen verwenden.

SMS-Benachrichtigungen einrichten

Öffnen Sie im Menü „System Tree" das Fenster „SMS", um einen Benachrichtigungsempfänger hinzuzufügen:

Mit „Save" werden die Einstellungen übernommen, mit „Test" kann eine Test-SMS gesendet werden (Hinweis: Bei Testnachrichten können die Makros %1/%2 fehlerhafte Sensordaten enthalten – dies ist für Testzwecke normal).

Nach der Konfiguration des Empfängers muss unter Preferences → Logic schemes → Add das Ereignis festgelegt werden, bei dem die SMS versendet wird. Pro Logikschaltung können maximal 15 SMS-Empfänger für ein oder mehrere Ereignisse hinterlegt werden. Werden mehr als 15 Empfänger für dasselbe Ereignis benötigt, muss eine zusätzliche Logikschaltung mit derselben Eingangsbedingung erstellt werden.

SMS-Nachrichten werden in eine Warteschlange (max. 100 Nachrichten) eingereiht, damit nicht auf den Abschluss des vorherigen Versands gewartet werden muss. Bei Überlauf werden bereits gesendete Nachrichten automatisch gelöscht. Versandinformationen werden im System-Log protokolliert.

SMS-Versand über Drittprogramme (z. B. cURL)

SMS können auch über externe Programme wie cURL versendet werden. Das folgende Bash-Skript zeigt den Ablauf für Firmware-Version 2.4.x und höher: Authentifizierung am Webinterface, Ermittlung des Session-Keys und Versand der SMS über den HTTP(S)-Endpunkt engine.htm.

Das 4G/LTE-Modem unterstützt GPS-Standortinformationen, sofern eine passende GPS-Antenne angeschlossen ist. Voraussetzung ist eine eingesetzte SIM-Karte und eine bestehende Verbindung zum GSM-Netz. Auch die älteren LTE-Modems unterstützen GPS-Ortung.

Die GPS-Einstellungen und -Informationen finden Sie unter Preferences → GPS.

🔍 Vergrößern

Übersicht der verfügbaren GPS-Einstellungen (siehe Tabelle unten zur Erläuterung der einzelnen Felder).