Notions clés 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. Connectivité et accès au module ModLink communique avec le réseau local et les autres équipements via une connexion Wi-Fi . Selon l’architecture de l’installation, le module peut être accessible en local et/ou à distance . 1- Modes de connexion Plusieurs modes de connexion peuvent être utilisés : Mode AP avec portail captif ModLink crée son propre réseau Wi-Fi pour permettre une connexion directe au module, notamment lors de sa configuration initiale Connexion via un routeur Wi-Fi ModLink se connecte comme client à un réseau Wi-Fi : le réseau local de l'installation  un réseau isolé, dédié aux équipements IoT Connexion via un routeur 4G ou un partage de connexion ModLink utilise une connexion cellulaire pour accéder à Internet 2- Accès au module Une fois connecté au réseau, le module est accessible depuis un navigateur Web, sans logiciel ni application spécifique. La connexion s'effectue à l'aide de l' identifiant du module composé de 4 caractères alphanumériques Aucune configuration d’adresse IP n’est nécessaire pour accéder au module. En local, saisissez dans la barre d'adresse de votre navigateur Web  2pio_ _ _ _.local.fr A distance, tapez dans la barre d'adresse de votre navigateur Web  2pio_ _ _ _.modlink.fr ModLink ne nécessite pas de  cloud applicatif pour son fonctionnement. Les données et la logique d’automatisation sont gérées localement par le module. L’accès à distance, lorsqu’il est configuré et activé, repose sur une connexion sécurisée et ne nécessite pas d’ouverture de port sur le routeur. 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 : Scénario I/O Widgets Planification Paramètres 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 Comptes utilisateurs : rôles, permissions et accès Les comptes utilisateurs permettent d’identifier les personnes accédant au système et de définir leur niveau d’utilisation. Chaque compte est associé à un identifiant et à un mot de passe permettant d’authentifier l’utilisateur. 1 - Rôles Chaque compte est également associé à un  rôle qui détermine les actions autorisées et les fonctionnalités accessibles. Le système propose deux rôles prédéfinis : Installateur et Utilisateur. Les rôles définissent les droits d’accès aux différentes fonctionnalités du système. Ils déterminent notamment les opérations possibles dans l’interface. 1.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 1.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 2 - Permissions Les permissions déterminent les actions qu’un utilisateur est autorisé à effectuer dans le système. Les permissions disponibles permettent notamment d’autoriser ou non : l’édition des scénarios  l’appairage d’appareils  la mise à jour du firmware  le changement du nom de l’appareil  l’accès à la clé externe (API)  la modification des variables  la gestion des sauvegardes  la connexion OPC UA  la gestion des utilisateurs 3 - Accès aux pages L’accès aux pages de l’interface est configurable . Il peut être adapté au rôle attribué et aux besoins de chaque utilisateur. Les accès aux pages peuvent notamment concerner : la page Scénario  la page I/O  la page Paramètres  la page Variables  la page Documentation Scénario  la page Widgets  la page DMX  la page Programmation  la page Configuration des états Cette organisation permet d’adapter précisément le niveau d’accès de chaque utilisateur tout en limitant l’accès aux fonctions de configuration et d’administration aux personnes autorisées. 2.1- Accès en mode application Le mode application offre un accès simplifié à ModLink depuis un smartphone, pour un pilotage rapide et quotidien du module. Après une première authentification, l’utilisateur peut sélectionner l’option  « Rester connecté » afin de ne pas avoir à saisir son code d’accès à chaque ouverture. Pour plus d'informations : accès en mode application Le mode application permet à l’utilisateur d’accéder rapidement à ModLink depuis son Smartphone. Quel que soit son rôle, l’utilisateur arrive directement sur la page Widgets et peut piloter les équipements et consulter leurs états sans passer par les menus de configuration Variables Les variables sont des éléments essentiels pour le fonctionnement des scénarios, elles permettant de  suivre, stocker et transmettre des informations au sein du système. Elles sont notamment utilisées pour : mémoriser l’état d’un appareil suivre des mesures gérer des délais ou événements déclencher des actions automatiques 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 de leur côté ; 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 6 premières s'affichent, pour consulter l’ensemble des variables, cliquer sur “ +10 Tout afficher ” ) ou bien aller dans le menu " I/O " pour 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 2.1- Boucle de fonctionnement Un scénario fonctionne selon le principe d’une  boucle d’exécution continue Chaque scénario doit former une  boucle fonctionnelle complète  : entrée → test / logique → sortie / action → mise à jour variable d’état 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 2.2- Déclencheurs Les déclencheurs déterminent quand le scénario est exécuté. Exemples : Changement d'état d'une entrée Valeur d'une mesure Horaire ou calendrier Modification d'une variable 2.3- Conditions Les conditions permettent de vérifier qu'un ou plusieurs critères sont respectés avant l'exécution des actions. Exemples : Température supérieure à une valeur définie Sortie inactive Plage horaire spécifique 2.4- Actions Les actions définissent les opérations à exécuter lorsque les conditions sont remplies. Exemples : la commande de sorties l'écriture de variables l'envoi d'email et / ou SMS la modification d'états utilisateurs 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 d'exploitation Les widgets permettent aux opérateurs et aux utilisateurs finaux de piloter les équipements et de visualiser leur état. Ils offrent un moyen simple d'interagir avec le module sans avoir à accéder aux variables ou aux scénarios. Chaque widget est associé à une ou plusieurs variables et peut afficher un état ,  déclencher une action ou présenter une information en temps réel . Selon son type, il peut par exemple permettre d'actionner une sortie, visualiser l'état d'un équipement, afficher une valeur ou représenter graphiquement une donnée. Les widgets sont entièrement personnalisables . Vous pouvez les ajouter, les modifier, les organiser sur la page et configurer leurs associations avec les variables du module afin de créer une interface parfaitement adaptée à votre installation. 1- Types de widgets interrupteur switch à glissière variateur variateur d'ouvrant capteur voyant d'état 2- Liaison avec les variables Chaque widget est lié à une ou plusieurs variable(s), en local ou à distance.