Didactum Monitoring-Systemen
Modem, SMS-commando's & GPS instellen

Didactum-monitoringsystemen (modellen 50T, 100T, 500T en 550T) kunnen worden uitgerust met een GSM- of 4G/LTE-modem. Hiermee is het mogelijk om SMS-notificaties te verzenden, het apparaat via SMS-commando afstandbesturen en – bij compatibele LTE-modems – een internetverbinding als failover-oplossing en GPS-bepaling te gebruiken.

De modems werken in de primairmodus. Als de primairmodus niet beschikbaar is (bijv. geen 4G-ontvangst), schakelt het modem automatisch over naar de secundairmodus (2G).

Taak: Alarmmeldingen zolang verzenden tot het alarm via SMS-commando wordt gedeactiveerd of de omstandigheden veranderen.

Om dit te implementeren, wordt een Trigger-element als tussenstap gebruikt. De Trigger wordt bij het optreden van een alarm geactiveerd ("in") en bij normalisatie weer gedeactiveerd ("uit"). Zolang de Trigger actief is, worden bericht- of opdracht-acties uitgevoerd. Via een SMS-commando kan de Trigger worden gedeactiveerd wanneer de notificatie niet meer nodig is.

Stap 1 – Trigger-element "Trigger Alarm" aanmaken

🔍 Vergroten

Maak in het System-Tree-paneel een nieuw Trigger-element aan met de naam "Trigger Alarm". Dit element dient als tijdelijke opslag voor de alarmtoestand.

Stap 2 – Logische schakeling voor Trigger-bediening

🔍 Vergroten

Maak een logische schakeling (Preferences → Logic schemes) die de Trigger bij alarm inschakelt en bij terugkeer naar normale toestand weer uitschakelt.

Stap 3 – Logische schakeling voor notificaties

🔍 Vergroten

Bij alarm wordt een SMS verzonden (notificatie-element "SMS to Admin") en vervolgens een opdracht aan het opgeslagen nummer gestart (opdracht-taak "Dial to Admin"). De opdracht wordt volgens veld "Repeat/Duration" elke 10 minuten herhaald tot het alarm wordt teruggezet. De SMS wordt alleen één keer verzonden.

Stap 4 – Alarm vroegtijdig via SMS deactiveren

Om het alarm vroegtijdig te deactiveren, wanneer de notificatie de ontvanger heeft bereikt en geen verdere meldingen meer nodig zijn, moet de "Trigger Alarm" worden uitgeschakeld. Vul hiervoor de toegestane nummers in het veld "List of allowed phone numbers" op pagina "SMS messages". Verzend vervolgens de volgende SMS:

Apparaten zonder eigen GSM-/4G-modem (bijv. een Didactum 50T zonder modemoptie) kunnen SMS-notificaties via een ander Didactum-apparaat verzenden dat met een GSM-modem is uitgerust (zogenaamde SMS-Gate).

Met deze functie kunnen inkomende SMS'en worden ontvangen en hun inhoud naar andere telefoonnummers of e-mailadressen worden doorgevect. De instellingen bevinden zich op de pagina „SMS messages", tab „Incoming".

🔍 Vergroten

Aan de rechterkant wordt een lijst van alle inkomende SMS'en getoond. Hier vind je de centrale instellingen voor SMS-doorgave en SMS-commando's.

Beschikbare instellingen

SMS-commando's voor remote besturing

SMS-commando's maken remote besturing van het bewakingssysteem mogelijk: Uitlezen van systeemstatus, sensorwaarden en groepswaarden alsmede schakelen van relais (stopcontacten). De bevoegde telefoonnummers worden onder Main menu → SMS messages → List of allowed phone numbers opgeslagen.

1. Status uitlezen: get

Syntax: get [ID] of get [Name] – ID is de ID-nummer van het element, Name de naam van het element. „get" is niet case-sensitief (ook Get, GET mogelijk). De naam moet in aanhalingstekens staan, is case-sensitief en moet uniek zijn.

De antwoord-SMS bevat de status van de gevraagde sensor of relais.

2. Relais / stopcontacten schakelen: set

Syntax: set [ID] [state] of set [Name] [state] – state kan on (inschakelen) of off (uitschakelen) zijn. De naam is case-sensitief.

Antwoord: The element (Elementnaam) was switched on of ... was switched off

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

Syntax: set [ID] pulse {Tijd} of set [Name] pulse {Tijd} – Tijd is de vertraging in seconden (waardebereik 1–120). Wordt geen tijd gegeven, geld de eerder ingestelde waarde. Het commando schakelt het relais tweemaal om (puls) met de gegeven vertraging.

Antwoord: The element (Elementnaam) was switched

4. Logicaschakelingen besturen: logic

Syntax: logic [ID] [state] {Tijd} of logic * [state] – ID is de logica-nummer (* = alle logica's), state is on of off, Tijd de deactiveringstijd in seconden (alleen bij enkele logica). Alle velden zijn niet case-sensitief.

Antwoord: OK

Deze sectie is gericht op technisch ervaren gebruikers en integratoren die gebruikersaccounts en bevoegdheden direct via de API willen beheren of centrale authentificatie via een RADIUS-server willen instellen.

Bevoegdheidsconcept

Elk gebruikersprofiel kan op systeembronnen lezend (read-only) of lezend/schrijvend (read-write) toegankelijk zijn. Elke bron heeft een toegangskenmerk; de toegangcontrole occurs via kommagescheiden lijsten van kenmerken.

Belangrijke server-bron-IDs (selectie): accesskeys, cameras, canbus, devvirt, elements, groups, gsm, log, logics, modules, notify, relays, sdcard, system, users, view alsmede all (volledige toegang op alle bronnen).

Bij groep-bevoegdheden (GRead/GWrite) geldt additionally: all = volledige toegang op alle groepen, none = toegang volledig geweigerd. Standaard zijn elementen aan geen groep toegewezen – toegang is dan alleen met all mogelijk.

Authentificatie & Session

Bij de aanmelding (querytype=auth, velden name en wachtwoord-hash h) ontvangt de client een session-key (k), waarmee alle verdere API-aanroepen worden geauthentificeerd. Alternatief is een aanmelding per PIN-code mogelijk (querytype=authpin, velden name en n, 4–8-stellig).

De session wordt met querytype=authclose en overdracht van de session-key beëindigd. Na een restart van het systeem gaan alle sessions verloren – een nieuwe aanmelding is vereist.

Gebruikersaccounts lezen, aanmaken en verwijderen

Centrale authentificatie via RADIUS

Alternatief voor de lokale gebruikersdatabase kan de aanmelding via een externe RADIUS-server worden uitgevoerd. De aanmelding occurs tweestaps: Eerst wordt de gebruiker in de lokale database gezocht; wordt hij daar niet gevonden, occurs een aanvraag aan de RADIUS-server.

Vendor-Specific Attributes (Fabrikant-code 39052)

Op de RADIUS-server moet het fabrikantspecifieke dictionary dictionary.local in de directory /etc/raddb/ worden opgeslagen en in de hoofd-dictionary-file worden opgenomen.

🔍 Vergroten

In de regelinstellingen: Standaard-RADIUS-attributen verwijderen. In het gebied „Fabrikantspecifiek" → Fabrikant: „Gedefinieerd" → Fabrikant-code: 39052. Attributen per nummer invoeren (zie tabel onder).

🔍 Vergroten

Resultaat: Alle gebruikers in de groep „RADIUS Groep" erhalten volledige administrator-toegang op de Didactum-unit. Voor verschillende rechten op verschillende apparaten kunnen aparte regels met NAS-IP-adres-condities worden gemaakt.

Voorbeeld-configuratiebestanden

Controleren of het modem bedrijfsklaar is

1. SIM-badge in het modem plaatsen. Verzorgen dat voldoende credit of een geldige LTE-overeenkomst aanwezig is.
2. Verzorgen dat de externe antennes aan het modem bevestigd zijn – zowel „MAIN" als ook „AUXILIARY".
3. Systeem inschakelen. Bij het opstarten wordt het modem automatisch herkend.
4. Werd de SIM-badge bij ingeschakeld systeem geplaatst, kan de netwerkregistratie tot 15 minuten duren.
5. Bij succesvolle modem-herkennung verschijnt het menu-item „SMS messages".
6. Signaalsterkte controleren (voorbeeld: 48 %).

🔍 Vergroten

De signaalsterkte wordt als procentwaarde (0–100 %) getoond. Een hogere waarde betekent betere ontvangst.

Test-SMS sturen

1. Klik op „+" rechts naast „List of SMS messages" – een venster voor het sturen van een test-SMS opent zich.
2. Mobielnummer en berichttekst invoeren en op „OK" klikken.
3. De SMS moet bij het aangegeven mobiele telefoon arriveren.
4. In het webinterface verschijnt een bevestiging over de succesvolle verzending.

🔍 Vergroten

Voer mobielnummer en testtekst invoer en bevestig met „OK".

🔍 Vergroten

Na succesvolle verzending toont het systeem een passende bevestigingsmelding.

Internetverbinding via LTE

Vanaf firmware-versie 2.7.4 kan het LTE-modem additionally voor de verbinding met internetdiensten (VPN, SMTP, FTP enz.) alsmede voor remote toegang op het apparaat worden gebruikt. De instellingen vinden u onder Preferences → LTE.

🔍 Vergroten

Overzicht van de configureerbare LTE-parameters (zie tabel onder voor details over elk veld).

Voor een permanente internetaansluiting wordt additionally het gebruik van een OpenVPN-client aanbevolen: De VPN-verbinding blijft zowel via Ethernet als via LTE (bij uitval van Ethernet) bestaan en securet zo de permanente toegang op het beschermde netwerk alsmede een vaste IP-adres van het apparaat.

Toegang op het apparaat via LTE uit het internet

Ondersteunt de SIM-badge een private APN met statische IP-adres, kan het apparaat direct via deze IP worden bereikt (aanvraag bij de mobiele provider vereist). De toegewezen LTE-IP-adres vindt u in tab „Network" (veld „LTE IP address").

🔍 Vergroten

Overzicht van de netwerkadressen van het apparaat (zie tabel onder voor uitleg van de afzonderlijke velden).

Het modem wordt in het systeem gebruikt voor het verzenden van SMS-notificaties en het ontvangen van SMS-commando's.

Basiswijze van handelen

1. SIM-badge in een mobiele telefoon plaatsen en functionaliteit alsmede PIN-code controleren.
2. SIM-badge in het modem plaatsen.
3. Bewakingssysteem inschakelen.
4. Modem configureren (zie onder).
5. SMS-notificaties instellen en passende logica schakelingen alsmede groep-notificaties configureren.

Modem-configuratie

De modem-configuratie occurs in tab Main Menu → SMS messages.

🔍 Vergroten

Overzicht van alle modem-eigenschappen en instellvelden (zie tabel onder voor de uitleg van de afzonderlijke velden).

Wordt een modemfout opgetrokken, is geen SIM-badge geplaatst of de PIN-code verkeerd, wordt een passend bericht in de log-wachtrij geschreven („GSM modem: Error, check your SIM card and PIN code" of „GSM modem: modem error, restart smsd"). Het bericht wordt maximaal 5-mal getoond, om het log niet te overvullen.

De „List of SMS messages" toont tot 100 recent verzonden SMS (bij VT9xx-systemen tot 1000). Deze lijst wordt bij een restart van het apparaat niet opgeslagen.

GSM-netwerkenbedrijvers-lijst

De bedrijfslijst wordt na het inschakelen in regelmatig afstanden automatisch geactualiseerd en kan handelijk per button opnieuw worden opgeroepen. Het ophalen kan meerdere minuten duren; bij succes verschijnt een passend log-bericht. Kan geen verbinding met de geselecteerde bedrijfs worden gemaakt, wisselt het modem in de automatische selectiemodus. De aktuell gebruikte bedrijfs wordt in het veld „Operator" getoond.

GSM-modem-elementen in het systeem-tree

In het menu „System Tree" staan elementen beschikbaar, die de status van het modem tonen. Deze beïnvloeden de toestand van het element „System" niet en kunnen in logica schakelingen worden gebruikt.

🔍 Vergroten

Deze elementen kunnen zoals reguliere sensoren in groepen worden ingebonden en voor notificaties alsmede logica schakelingen worden gebruikt.

SMS-notificaties instellen

Open in het menu „System Tree" het venster „SMS", om een notificatieontvanger toe te voegen:

Met „Save" worden de instellingen overgenomen, met „Test" kan een test-SMS worden verzonden (opmerking: bij testberichten kunnen de macro's %1/%2 foutieve sensordata bevatten – dit is voor testdoelen normal).

Na de configuratie van de ontvanger moet onder Preferences → Logic schemes → Add het gebeurtenis worden vastgelegd, bij welke de SMS wordt verzonden. Per logica schakeling kunnen maximaal 15 SMS-ontvangers voor een of meerdere gebeurtenissen worden opgeslagen. Worden meer dan 15 ontvangers voor hetzelfde gebeurtenis vereist, moet een adicional logica schakeling met dezelfde ingangsconditie worden gemaakt.

SMS-berichten worden in een wachtrij (max. 100 berichten) ingeschakeld, om niet op de afsluiting van de vorige verzending te hoeven wachten. Bij overloop worden reeds verzonden berichten automatisch verwijderd. Verzendinginformatie worden in het systeem-log geprotocolleerd.

SMS-verzending via derdenprogramma's (bijv. cURL)

SMS kunnen additionally via externe programma's zoals cURL worden verzonden. Het volgende Bash-script toont de workflow voor firmware-versie 2.4.x en hoger: Authentificatie aan het webinterface, vaststellen van de session-key en verzending van de SMS via de HTTP(S)-eindpunt engine.htm.

Het 4G/LTE-modem ondersteunt GPS-locatieinformatie, indien een passende GPS-antenne is aangesloten. Voorwaarde is een geplaatste SIM-badge en een bestaande verbinding met het GSM-netwerk. Ook de oudere LTE-modems ondersteunen GPS-lokatie.

De GPS-instellingen en -informatie vinden u onder Preferences → GPS.

🔍 Vergroten

Overzicht van de beschikbare GPS-instellingen (zie tabel onder voor de uitleg van de afzonderlijke velden).