Systèmes de surveillance Didactum
Configurer modem, commandes SMS & GPS

Les systèmes de surveillance Didactum (modèles 50T, 100T, 500T et 550T) peuvent être équipés d'un modem GSM ou 4G/LTE. Cela permet d'envoyer des notifications SMS, de piloter l'appareil par commande SMS et – avec les modems LTE compatibles – d'utiliser une connexion Internet en solution de secours (failover) ainsi que la localisation GPS.

Les modems fonctionnent en mode primaire. Si le mode primaire n'est pas disponible (par exemple, absence de réception 4G), le modem passe automatiquement en mode secondaire (2G).

Objectif : envoyer des messages d'alerte tant que l'alerte n'est pas désactivée par commande SMS ou que les conditions ne changent pas.

Pour mettre cela en œuvre, on utilise un élément Trigger comme intermédiaire. Le Trigger est activé (“on") lorsqu'une alerte se produit et désactivé (“off") lorsque la situation revient à la normale. Tant que le Trigger est actif, les actions de notification ou d'appel sont exécutées. Via une commande SMS, le Trigger peut être désactivé lorsque la notification n'est plus nécessaire.

Étape 1 – Créer l'élément Trigger “Trigger Alarm"

🔍 Agrandir

Créez dans le panneau System Tree un nouvel élément Trigger nommé “Trigger Alarm". Cet élément sert de stockage intermédiaire pour le statut d'alerte.

Étape 2 – Schéma logique pour contrôler le Trigger

🔍 Agrandir

Créez un schéma logique (Preferences → Logic schemes) qui active le Trigger lorsqu'une alerte se produit et le désactive lorsque la situation revient à la normale.

Étape 3 – Schéma logique pour les notifications

🔍 Agrandir

En cas d'alerte, un SMS est envoyé (élément de notification “SMS to Admin") puis un appel est déclenché vers le numéro enregistré (tâche d'appel “Dial to Admin"). L'appel est répété toutes les 10 minutes selon le champ “Repeat/Duration" jusqu'à la réinitialisation de l'alerte. Le SMS est envoyé une seule fois.

Étape 4 – Désactiver l'alerte prématurément par SMS

Pour désactiver l'alerte prématurément, dès que la notification a atteint le destinataire et qu'aucune autre message n'est nécessaire, le “Trigger Alarm" doit être désactivé. Pour cela, indiquez les numéros de téléphone autorisés dans le champ “List of allowed phone numbers" sur la page “SMS messages". Envoyez ensuite l'SMS suivant :

Les appareils sans modem GSM/4G intégré (par exemple un Didactum 50T sans option modem) peuvent envoyer des notifications SMS via un autre appareil Didactum équipé d'un modem GSM (appelé SMS-Gate).

Cette fonction permet de recevoir les SMS entrants et de rediriger leur contenu vers d'autres numéros de téléphone ou adresses e-mail. Les paramètres se trouvent sur la page “SMS messages", onglet “Incoming".

🔍 Agrandir

Sur le côté droit, une liste de tous les SMS entrants est affichée. Vous y trouverez les paramètres centraux pour la redirection de SMS et les commandes SMS.

Paramètres disponibles

Commandes SMS pour le pilotage distant

Les commandes SMS permettent le pilotage distant du système de surveillance : lecture du statut du système, des valeurs des sensors et des valeurs de groupe, ainsi que l'activation de relais (sockets). Les numéros de téléphone autorisés sont enregistrés dans Main menu → SMS messages → List of allowed phone numbers.

1. Lire le statut : get

Syntaxe : get [ID] ou get [Name] – ID est le numéro d'ID de l'élément, Name le nom de l'élément. “get" n'est pas sensible à la casse (aussi Get, GET possibles). Le nom doit être entre guillemets, est sensible à la casse et doit être unique.

Le SMS de réponse contient le statut du sensor ou relais demandé.

2. Activer/désactiver relais / sockets : set

Syntaxe : set [ID] [state] ou set [Name] [state] – state peut être on (activer) ou off (désactiver). Le nom est sensible à la casse.

Réponse : The element (Elementname) was switched on ou ... was switched off

3. Impuls de relais (Pulse) : set ... pulse

Syntaxe : set [ID] pulse {Durée} ou set [Name] pulse {Durée} – Durée est le délai en secondes (domaine de valeurs 1–120). Si aucune durée n'est indiquée, la valeur précédemment définie est utilisée. La commande active et désactive le relais deux fois (impuls) avec le délai indiqué.

Réponse : The element (Elementname) was switched

4. Contrôle des schémas logiques : logic

Syntaxe : logic [ID] [state] {Durée} ou logic * [state] – ID est le numéro de logique (* = toutes les logiques), state est on ou off, Durée le temps de désactivation en secondes (uniquement pour une logique seule). Tous les champs ne sont pas sensibles à la casse.

Réponse : OK

Cette section est destinée aux utilisateurs techniquement avancés et aux intégrateurs qui souhaitent gérer directement les comptes d'utilisateurs et les permis via l'API ouconfigurer une authentification centralisée via un serveur RADIUS.

Concept de permis

Chaque profil utilisateur peut accéder aux ressources du système en s lecture (read-only) ou en lecture/écriture (read-write). Chaque ressource possède un identifiant d'accès ; le contrôle d'accès se fait via des listes d'identifiants séparées par des commas.

IDs importantes de ressources serveur (sélection) : accesskeys, cameras, canbus, devvirt, elements, groups, gsm, log, logics, modules, notify, relays, sdcard, system, users, view ainsi que all (accès complet à toutes les ressources).

Pour les permis de groupe (GRead/GWrite) s'applique également : all = accès complet à tous les groupes, none = accès complètement refusé. Par défaut, les éléments n'appartiennent à aucun groupe – l'accès est alors possible uniquement avec all.

Authentification & session

Lors de l'authentification (querytype=auth, champs name et hash de mot de passe h), le client reçoit une clé de session (k) avec laquelle toutes les autres appels API sont authentifiés. Alternativement, une authentification par code PIN est possible (querytype=authpin, champs name et n, 4–8 caractères).

La session est terminée avec querytype=authclose et la transmission de la clé de session. Après un redémarrage du système, toutes les sessions sont perdues – une nouvelle authentification est nécessaire.

Lire, créer et supprimer les comptes d'utilisateurs

Authentification centralisée via RADIUS

En alternative à la base de données d'utilisateurs locale, l'authentification peut se faire via un serveur RADIUS externe. L'authentification se fait en deux étapes : l'utilisateur est首先 recherché dans la base de données locale ; s'il n'y est pas trouvé, une requête est envoyée au serveur RADIUS.

Attributs spécifiques du fournisseur (code fabricant 39052)

Sur le serveur RADIUS, le dictionary spécifique du fabricant dictionary.local doit être enregistré dans le dossier /etc/raddb/ et incluse dans le fichier dictionary principal.

🔍 Agrandir

Dans les paramètres de politique : supprimer les attributs RADIUS par défaut. Dans la section “Spécifique du fournisseur" → fournisseur : “Personnalisé" → code fournisseur : 39052. Inscrire les attributs par numéro (voir tableau ci-dessous).

🔍 Agrandir

Résultat : tous les utilisateurs du groupe “RADIUS Gruppe" obtiennent un accès administrateur complet sur l'unité Didactum. Pour des droits différents sur différents appareils, des politiques séparées avec des conditions d'adresse NAS-IP peuvent être créées.

Fichiers de configuration exemples

Vérifier si le modem est prêt à fonctionner

1. Insérer la carte SIM dans le modem. Vérifier qu'il y a suffisamment de crédit ou un contrat LTE valide.
2. Vérifier que les antennes externes sont bien attachées au modem – tant “MAIN" que “AUXILIARY".
3. Activer le système. Lors du démarrage, le modem est détecté automatiquement.
4. Si la carte SIM a été insérée avec le système activé, l'enregistrement dans le réseau peut prendre jusqu'à 15 minutes.
5. Si la détection du modem est réussie, le point de menu “SMS messages" apparaît.
6. Vérifier l'intensité du signal (exemple : 48 %).

🔍 Agrandir

L'intensité du signal est affichée comme une valeur en pourcentage (0–100 %). Une valeur plus élevée signifie une meilleure réception.

Envoyer un SMS de test

1. Cliquez sur “+" à droite de “List of SMS messages" – une fenêtre pour envoyer un SMS de test s'ouvre.
2. Entrez le numéro de mobile et le texte du message, puis cliquez sur “OK".
3. Le SMS devrait arriver au mobile indiqué.
4. Dans l'interface web, une confirmation d'envoi réussi apparaît.

🔍 Agrandir

Entrez le numéro de mobile et le texte de test, puis confirmez avec “OK".

🔍 Agrandir

Après un envoi réussi, le système affiche un message de confirmation correspondant.

Connexion Internet via LTE

À partir de la version de firmware 2.7.4, le modem LTE peut également être utilisé pour la connexion aux services Internet (VPN, SMTP, FTP, etc.) ainsi que pour l'accès distant à l'appareil. Les paramètres se trouvent dans Preferences → LTE.

🔍 Agrandir

Vue générale des paramètres LTE configurables (voir tableau ci-dessous pour les détails de chaque champ).

Pour une connexion Internet permanente, il est également recommandé d'utiliser un client OpenVPN : la connexion VPN reste active via Ethernet et via LTE (en cas de panne d'Ethernet), assurant ainsi un accès permanent au réseau protégé et une adresse IP fixe de l'appareil.

Accès à l'appareil via LTE depuis Internet

Si la carte SIM supporte un APN privé avec adresse IP statique, l'appareil peut être atteint directement via cette IP (requête auprès de l'opérateur mobile nécessaire). L'adresse IP LTE attribuée se trouve dans l'onglet “Network" (champ “LTE IP address").

🔍 Agrandir

Vue générale des adresses réseau de l'appareil (voir tableau ci-dessous pour l'explication de chaque champ).

Le modem est utilisé dans le système pour l'envoi de notifications SMS et la réception de commandes SMS.

Procédure de base

1. Insérer la carte SIM dans un téléphone mobile et vérifier son fonctionnement ainsi que le code PIN.
2. Insérer la carte SIM dans le modem.
3. Activer le système de surveillance.
4. Configurer le modem (voir ci-dessous).
5. Configurer les notifications SMS et les schémas logiques ou les notifications de groupe correspondants.

Configuration du modem

La configuration du modem se fait dans l'onglet Main Menu → SMS messages.

🔍 Agrandir

Vue générale de toutes les propriétés du modem et des champs de paramétrage (voir tableau ci-dessous pour l'explication de chaque champ).

Si une erreur de modem se produit, qu'aucune carte SIM n'est insérée ou que le code PIN est incorrect, un message correspondant est écrit dans la queue de journal ("GSM modem: Error, check your SIM card and PIN code" ou "GSM modem: modem error, restart smsd"). Le message est affiché maximum 5 fois pour ne pas saturer le journal.

La "List of SMS messages" affiche jusqu'à 100 SMS récemment envoyés (sur les systèmes VT9xx jusqu'à 1000). Cette liste n'est pas conservée lors d'un redémarrage de l'appareil.

Liste des opérateurs de réseau GSM

La liste des opérateurs est mise à jour automatiquement à intervalles réguliers après l'activation et peut être consultée manuellement de nouveau via un bouton. La consultation peut prendre plusieurs minutes ; en cas de succès, un message de journal correspondant apparaît. Si aucune connexion ne peut être établie avec l'opérateur sélectionné, le modem passe au mode de sélection automatique. L'opérateur actuellement utilisé est affiché dans le champ "Operator".

Éléments du modem GSM dans le System Tree

Dans le menu "System Tree", des éléments sont disponibles qui affichent le statut du modem. Ceux-ci n'influencent pas l'état de l'élément "System" et peuvent être utilisés dans les schémas logiques.

🔍 Agrandir

Ces éléments peuvent être intégrés dans des groupes comme des sensors réguliers et utilisés pour les notifications ou les schémas logiques.

Configurer les notifications SMS

Ouvrez dans le menu "System Tree" la fenêtre "SMS" pour ajouter un destinataire de notification :

Les paramètres sont validés avec "Save", une SMS de test peut être envoyée avec "Test" (note : dans les messages de test, les macros %1/%2 peuvent contenir des données de sensor erronées – ceci est normal pour des tests).

Après la configuration du destinataire, l'événement pour lequel la SMS est envoyée doit être défini dans Preferences → Logic schemes → Add. Par schéma logique, maximum 15 destinataires SMS peuvent être enregistrés pour un ou plusieurs événements. Si plus de 15 destinataires sont nécessaires pour le même événement, un schéma logique supplémentaire avec la même condition d'entrée doit être créé.

Les messages SMS sont mis dans une queue (max. 100 messages) pour ne pas devoir attendre la fin de l'envoi précédent. En cas de surcharge, les messages déjà envoyés sont automatiquement supprimés. Les informations d'envoi sont journalisées dans le système-Log.

Envoi de SMS via des programmes tiers (par exemple cURL)

Les SMS peuvent également être envoyés via des programmes externes comme cURL. Le script Bash suivant montre le processus pour la version de firmware 2.4.x et supérieure : authentification dans l'interface web, récupération de la clé de session et envoi de la SMS via le point de terminaison HTTP(S) engine.htm.

Le modem 4G/LTE supporte les informations de localisation GPS, si une antenne GPS appropriée est connectée. Une carte SIM insérée et une connexion existante au réseau GSM sont requises. Les modems LTE plus anciens supportent également la localisation GPS.

Les paramètres et informations GPS se trouvent dans Preferences → GPS.

🔍 Agrandir

Vue générale des paramètres GPS disponibles (voir tableau ci-dessous pour l'explication de chaque champ).