Notions clés de ModLink Présentation des concepts fondamentaux nécessaires à la compréhension du fonctionnement du système.Ces notions sont utilisées dans l’ensemble de la configuration et de l’exploitation. Interface d'administration L’interface d’administration constitue le point d’accès central aux fonctions de configuration, de supervision et de maintenance de l’installation. Elle permet à l’intégrateur de paramétrer les équipements, configurer le WiFi, gérer les variables  et concevoir les scénarios d’automatisation.  L’accès à l’interface se fait directement depuis un navigateur internet - que ce soit sur un ordinateur ou un smartphone - sans nécessiter de télécharger une application dédiée. Pour certaines opérations, comme la conception et la gestion des scénarios, il est toutefois recommandé d’utiliser un ordinateur afin de bénéficier d’une meilleure visibilité et d’un confort d’édition optimal. La  page d’accueil se présente sous la forme d’un tableau de bord regroupant des raccourcis d’accès direct aux fonctionnalités principales de l’interface. Ces raccourcis permettent de naviguer et d'accéder rapidement aux fonctions essentielles pour effectuer des opérations de configuration, de diagnostic ou de maintenance : widgets scénarios objets variables 1- Administration d’un ou de plusieurs modules L’intégrateur peut utiliser l’interface pour administrer : Un module unique : accéder et configurer directement les paramètres, variables et scénarios spécifiques à ce module Un groupe de modules : appliquer des configurations communes, synchroniser des scénarios ou superviser plusieurs modules simultanément Cette flexibilité permet de gérer efficacement des installations individuelles comme des parcs multi-modules. 2- Paramètres d’affichage et de langue L’interface permet également de personnaliser l’expérience utilisateur : Choix de la langue de l’interface  Mode d’affichage : possibilité de choisir entre mode clair et mode sombre pour optimiser la lisibilité et le confort visuel selon l’environnement 3- Navigation et ergonomie La barre d’icônes de visualisation  affichée sur la droite de l'écran permet de : - agrandir la vue - réduire la vue - recentrer l’affichage sur la zone des blocs scénario - verrouiller et déverrouiller les blocs - réinitialiser l'édition de blocs Connectivité et accès distant 1- Accès distant au module ModLink Se connecter au réseau Wi‑Fi du module Dans un navigateur, entrer directement dans la barre d'adresse : 2pio_ _ _ _.modlink.fr _ _ _ _  étant l'identifiant du module (4 caractères, chiffres & lettres) Le portail web du module s’ouvre automatiquement sans configuration IP préalable simplifie l'accès et évite les erreurs liées à l'adresse IP - fonctionne en mode AP et en mode client (sur le même réseau local) - aucun cloud applicatif - chaque module ouvre un tunnel SSH sortant vers un serveur - accès sécurisé depuis n'importe où 2- Modes de connexion à Internet Mode AP avec portail captif - ModLink crée son propre réseau Wi‑Fi - Connexion directe via portail captif pour accéder à Internet Mode client / serveur - connexion via un routeur Wi‑Fi  - réseau local existant - réseau isolé dédié aux IoT ModLink se connecte comme client à un réseau local Wi-Fi Connexion via un routeur 4G ModLink se conncte à Internet via un réseau cellulaire Bonnes pratiques :  - Utiliser le mode AP pour la configuration initiale - Privilégier un réseau isolé pour les IoT - Sécuriser les réseaux, documenter les paramètres, vérifier la stabilité du signal 3- Adressage IP DHCP avec annonce mDNS Possibilité de configuration avec une adresse fixe Découverte automatique des autres modules par mDNS Comptes utilisateurs, rôles et permissions Les comptes utilisateurs permettent d’identifier les personnes accédant au système et de définir leurs droits.  Chaque compte possède un identifiant, un mot de passe et un rôle déterminant les actions autorisées. Le système permet de créer, modifier et supprimer des comptes, d’attribuer des rôles, des permissions et de restreindre l'accès aux pages de l'interface. Deux rôles sont disponibles pour les comptes utilisateurs : 1- Installateur Nombre d'accès autorisés : 5 Destiné aux personnes chargées de l'installation, de la configuration et de la maintenance du système.  Ce rôle permet d'accéder à l'ensemble des fonctions avancées de configuration, d'administration et de mise en service selon les permissions accordées 2- Utilisateur Nombre d'accès autorisés : 10 Destiné à l'exploitation quotidienne du système par l'utilisateur final. Ce rôle dispose d'un accès limité aux fonctionnalités et ne peut pas accéder à la gestion ni à l'administration des comptes Entrées et sorties 1- Entrées 2 entrées basse tension configurables : - ToR - 4 / 20 mA 2 entrées haute tension 220V   Les entrées sont accessibles dans le système sous forme de variables lisibles Leur exploitation dépend des droits et de l' exposition 2- Sorties · 2 sorties de puissance : - courant maximal  50 A - contacts  libres de potentiel - m esure de courant intégrée - commutation au zéro crossing (réduction des contraintes électriques et des perturbations) Les sorties sont commandées par écriture de variables La communication est réalisée au  zéro crossing La mesure de courant peut être exploitée dans les scénarios Les variables Les variables sont des éléments essentiels du système, elles permettant de suivre, stocker et transmettre des informations au sein de l’installation. Elles peuvent représenter l’état d’un équipement, une mesure, une valeur calculée ou tout autre paramètre nécessaire à la gestion des scénarios et des automatismes. Une variable , c'est comme une lampe témoin sur un tableau de bord 1- Types de variables On distingue deux principaux types de variables : - Les variables d’état (variables en lecture) reflètent une situation ou l'état d'un équipement, d'un processus - Les variables de commande (variables en écriture) utilisées pour piloter un équipement ou modifier un état Une variable peut représenter : l'état ou la commande d'une entrée l’état ou la commande d’une sortie une valeur intermédiaire de calcul un état destiné à l’interface utilisateur 1.1- Variables pour un interrupteur Un interrupteur peut avoir des variables liées à son état et à son fonctionnement. Ces variables sont souvent mises à jour automatiquement par le système en temps réel. État : ON / OFF (1 ou 0) Historique : dernière action, timestamp du dernier changement Mode : manuel / automatique / scénario Durée d’activation : combien de temps il est resté actif Exemple de nommage : interrupteur_salon_etat , interrupteur_chambre_mode 1.2- Variables pour un capteur Ces variables stockent des valeurs numériques ou textuelles utilisées dans les calculs ou scénarios, elles peuvent être modifiées manuellement ou automatiquement par le système. Selon le type de capteur, on peut créer des variables spécifiques : Capteur de mouvement : mouvement_detecte (booléen) derniere_detection (timestamp) Capteur de température / humidité : temperature_salon (float, en °C) humidite_salon (float, en %) Capteur de luminosité : luminosite_salon (lux) luminosite_seuil (valeur pour déclencher scénario) 1.3- Variables combinées pour scénarios Ces variables sont utilisées pour piloter la logique des scénarios d’automatisation. Elles peuvent servir de conditions ou de déclencheurs pour activer des actions spécifiques. On peut ainsi créer des variables logiques basées sur plusieurs entrées : presence_detectee = mouvement_detecte AND luminosite_salon < seuil interrupteur_auto = ON si presence_detectee = true 2- Communication entre modules : les drapeaux partagés Lorsque plusieurs modules sont utilisés ensemble, ils peuvent échanger des informations grâce au  partage de variables et de scénarios Imaginez deux agents indépendants qui font leur ronde chacun dans leur coin : ils ne se parlent pas directement mais ils peuvent voir les mêmes lampes témoin sur leur tableau de bord respectif. C'est comme un fil électrique invisible entre deux modules . Lorsqu'un scénario sur le premier module « lève un drapeau » en modifiant une variable partagée, le second module voit ce changement et peut immédiatement exécuter les actions prévues dans son propre scénario. Les variables partagées servent ainsi de moyen de communication entre les modules 2.1- Exposition des variables Lors de la création ou du paramétrage, chaque variable peut être exposée vers : scénarios locaux autres modules ModLink Modbus OPC UA accès non sécurisé (si autorisé) La portée (locale ou distante) dépend exclusivement de ce paramétrage. 2.2- Utilisation des variables Les variables permettent de centraliser les informations et de les rendre accessibles à différents modules et scénarios Les variables disponibles et préconfigurées s’affichent directement sur la page d’accueil sous forme de raccourcis. Seules les 7 premières s'affichent, pour consulter l’ensemble des variables, cliquer sur “Afficher plus” pour ouvrir le menu Variables et visualiser toutes les variables disponibles Elles facilitent la supervision et le diagnostic , car l’intégrateur peut vérifier les valeurs en temps réel pour identifier des dysfonctionnements ou ajuster les comportements des scénarios Bonnes pratiques  : - Nommer les variables de manière claire et cohérente pour faciliter leur identification - Définir précisément la valeur et le type d'unité le cas échéant pour éviter les erreurs dans les scénarios - Utiliser les variables comme points de contrôle pour les commandes  Scénario (automation) 1- Définition Un scénario est un ensemble de règles qui détermine le comportement d'un module. Le scénario , c'est la liste des consignes que le module exécute à chaque cycle de fonctionnement ModLink peut gérer jusqu'à  3 scénarios , exécutés de manière autonome et pouvant être activés ou désactivés indépendamment. Lorsque plusieurs modules sont utilisés ensemble, ils peuvent échanger des informations grâce au partage des variables, des entrées et des sorties 2- Principe de fonctionnement Un scénario fonctionne selon le principe d’une boucle d’exécution continue les conditions sont analysées en permanence, les tests sont exécutés dans l'ordre défini, lorsqu'une condition est satisfaite, l'action correspondante est exécutée, dans le cas contraire, le scénario poursuit son exécution selon la logique configurée Tel un agent de sécurité qui effectue des rondes, le scénario surveille en permanence différents points de contrôle dans un ordre défini : - les entrées (voyants, ouvrants, environnement ...) - les sorties (interrupteur, vanne, alerte ...) - les variables (rapports des agents précédents) Une fois l’ensemble des vérifications effectué, le cycle se répète en permanence Comprendre le principe de fonctionnement d'un scénario Cette section présente un exemple de scénario. Le visuel  est accompagné d'une description des différents blocs utilisés , afin de faciliter la compréhension de leurs rôles et de leurs interactions. Surveillance d'une pompe de relevage Fonctionnement général : Ce scénario pilote une pompe de relevage (sortie 1) et surveille son bon fonctionnement : la pompe démarre lorsque le niveau haut est atteint et s'arrête lorsque le niveau bas est atteint.  Le scénario surveille deux capteurs : - capteur niveau haut (entrée 1) : indique que la cuve est pleine et qu'il faut démarrer la pompe - capteur niveau bas (entrée 2) : indique que la cuve est suffisamment vidée et que la pompe peut être arrêtée Le scénario stoppe le processus et envoie un SMS d'alerte si la cuve n'a pas commencé à se vider après 60 secondes. Il vérifie également qu'aucun défaut n'est déjà signalé avant de lancer un nouveau cycle. Label "DEBUT" Point de départ du scénario (lors de la mise sous tension du module et du redémarrage du système) Bloc 9 "TEST VARIABLE" / Test état de la pompe Vérifie la variable "état de la pompe" - égale à 1 "pompe fonctionnelle" → va au bloc 1 "TEST STATE" - égale à 0 "pompe en défaut" → retour au début du scénario "LABEL DEBUT" le processus est arrêté jusqu'à ce que l'agent de maintenance réinitialise le défaut (à l'aide du widget "état de la pompe") Bloc 1 : "TEST STATE" / Test niveau haut atteint Teste le capteur de niveau haut (entrée 1) - le niveau haut est-il atteint ? - si ON (la cuve est pleine) → va au bloc 2 "SORTIE SIMPLE" - si OFF (la cuve n'est pas pleine) → retour au début du bloc 1 "TEST STATE" Bloc 2 "SORTIE SIMPLE" / Pompe ON Active la sortie 1 la pompe démarre et commence à évacuer l'eau → va ensuite au bloc 3 "TEST TIMER" Bloc 4 "TEST TIMER" / Temporisation avant défaut Lance une temporisation de 60 secondes, au bout de laquelle s'il n'y a pas eu de changement d'état du capteur de niveau haut (entrée 1), on estime qu'il y a une anomalie de la pompe, on continue alors vers le bloc 7 "ENVOI SMS" " Condition par défaut / test en cours " → va au bloc 3 "TEST STATE" tant que le décompte n'est pas terminé "GOTO1 time elapsed" : une fois le temps écoulé, si l'état de la variable "niveau haut" n'a toujours pas changé (le niveau de la cuve n'a pas diminué malgré le fonctionnement de la pompe) on estime qu'il y a un défaut → va au bloc 7 "ENVOI SMS" Bloc 3 "TEST STATE" Test vidange commencée  Teste le niveau du capteur haut (entrée 1) On s'attend à ce que le niveau du capteur baisse. Si le niveau n'a pas changé au bout de 60 secondes, on sort en anomalie au niveau du bloc 4. si ON (contact fermé : le capteur haut n'a pas changé d'état)  → retourne   au bloc 4 "TEST TIMER"  si OFF (contact ouvert : le niveau a baissé avant les 60 secondes)  → va   au bloc 6 "TEST NIVEAU BAS ATTEINT"  Bloc 6 : "TEST STATE" / Test niveau bas atteint Teste le capteur de niveau bas (entrée 2) - le niveau bas est-il atteint ? - si ON (le niveau bas n'est pas encore atteint : la cuve n'est pas encore vide )  → retour au début du bloc 6 "TEST STATE" - si OFF (le niveau bas est atteint : la cuve est vide)  → va au bloc 10 "SORTIE SIMPLE" Bloc 10 "SORTIE SIMPLE" / Pompe Off Arrête la sortie 1  la pompe est stoppée   → va ensuite au bloc 11 "GOTO START" Bloc 7 "ENVOI SMS" / ENVOI SMS Envoie une alerte par SMS   → va ensuite au bloc 5 "VALEUR VARIABLE" personnalisation du message et du numéro de Smartphone Bloc 5 "VALEUR VARIABLE" / Pompe en défaut Fixe la valeur de l'état de la pompe à 1 (pompe en défaut) → va ensuite au bloc 8 "GOTO START" Visualisation de l'état de la pompe depuis l'application et possibilité pour le technicien de bloquer le processus de fonctionnement Bloc 8 "GOTO START" / Retour au début Retour au début du scénario (boucle) → va au bloc 9 "TEST VARIABLE" Ce scénario nécessite la création préalable d'une variable nommée  « état de la pompe » Widgets : Pour ce scénario, 4 widgets ont été créés Widget pour l' état de la pompe Il permet au technicien d' activer ou bien de mettre en défaut la pompe de relevage, après la réception du SMS d'alerte OU Widgets de visualisation des niveaux de la cuve : OU OU Ce scénario est fourni à titre d'exemple et présente un cas d'usage simple.  Selon les besoins de l'installation, il peut être enrichi par des fonctions avancées telles que la surveillance de la tension ou du courant de la pompe, l'envoi d'alertes par e-mail, l'affichage de défauts sur d'autres modules, la gestion d'une pompe de secours, ou toute autre logique de contrôle adaptée à l'application. Pour plus d'information, consulter  Gestion des scénarios Widgets utilisateurs Les widgets sont principalement destinés aux opérateurs et utilisateurs finaux . Ils permettent : le contrôle des appareils la visualisation des données des capteurs 1- Types de widgets disponibles interrupteur switch à glissière variateur variateur d'ouvrant capteur voyant d'état 2- Liaison avec les variables Chaque widget est lié à une ou plusieurs variables, locales ou distantes selon les droits définis.