Utilisez les identifiants suivants pour vous connecter : Nom d'utilisateur : **demo **Mot de passe : **demo**
[](https://modlink.fr/help/uploads/images/gallery/2026-10/capture-decran-2026-10-01-112508.jpg)**Limitations du mode démonstration :** le module est configuré pour permettre l’exploration et le test de ses principales fonctionnalités, tout en préservant sa configuration. - les scénarios ne **peuvent pas être modifiés** - certaines fonctions de configuration **ne sont pas accessibles** - les fonctions liées à la sécurité et à la gestion des comptes **sont limitées**
### 2- Découvrir l'interface Après connexion, le module affiche le **tableau de bord**, qui regroupe les **widgets d’exploitation** permettant de piloter l’installation et de visualiser l’état des équipements : - commander les sorties du module - visualiser l’état des relais et des entrées - modifier certains paramètres directement depuis l’interface Le bouton **« Gérer les widgets »** ouvre directement le menu *Widgets*, qui permet d’organiser les widgets affichés sur le tableau de bord. Les **différents menus** donnent accès aux fonctions de configuration, de supervision et de gestion du module. *Pour plus d’informations, consultez la page* [*Interface d’administration*](https://modlink.fr/help/link/195#bkmrk-page-title)*.* ### 3 – Télérupteur avec double temporisation : tester les commandes et les widgets Le module de démonstration permet de découvrir un scénario préconfiguré et de comprendre son interaction avec les widgets d’exploitation. Vous pouvez notamment : - déclencher le scénario depuis les widgets - observer les changements d’état des équipements - modifier les paramètres proposés et constater leurs effets sur le fonctionnement du scénario #### 3.1- Fonctionnement du scénario d'automatisation Le scénario préconfiguré utilise normalement un bouton-poussoir et un capteur de détection de présence, raccordés aux entrées du module. Dans le mode démonstration, ces entrées ne sont pas utilisées pour déclencher le scénario. Les widgets permettent de simuler les commandes correspondantes depuis l’interface Web, sans avoir à raccorder ni à actionner de bouton-poussoir ou de capteur physique. Le scénario repose sur deux temporisations : - Temporisation courte : durée réglable dans le scénario - Temporisation longue : durée réglable directement depuis un widget, sans modifier le scénarioEn mode démonstration, les durées des temporisations sont volontairement réduites à quelques secondes afin de faciliter la compréhension et l’observation du fonctionnement
Le scénario peut également tenir compte de données contextuelles, notamment des horaires du lever et du coucher du soleil, calculés à partir de la position géographique du module. #### 3.2- Widgets de pilotage Plusieurs widgets permettent de tester le fonctionnement du scénario et d’observer l’état du module. [](https://modlink.fr/help/uploads/images/gallery/2026-10/capture-decran-2026-10-06-150517.jpg) Ces widgets permettent notamment de : - **simuler les commandes** du bouton-poussoir et du capteur de présence ; - **commander l’éclairage** selon deux modes : allumage de courte durée ou de longue durée ; - **régler la durée de l’allumage longue durée** à l’aide du curseur, sans modifier le scénario ; - **commander les relais et visualiser leur état** directement depuis l’interface. Cette démonstration illustre plusieurs fonctions du module 2PIO : commandes manuelles, simulation de détection, temporisations différenciées, réglage d’un paramètre depuis un widget et prise en compte de données contextuelles. *Pour approfondir les fonctions de configuration, d’automatisation et de communication, consultez les chapitres correspondants de la documentation du module 2PIO.* # Présentation Pilotage - Supervision - Communication # Présentation fonctionnelle Le 2PIO est un module d’automatisation IP compact avec serveur Web intégré, conçu pour automatiser et piloter des équipements techniques, ainsi que pour communiquer avec d’autres systèmes. ### 1- Programmation graphique et boucle d'exécution Le 2PIO intègre une interface graphique de programmation permettant de créer des automatismes sans écrire de code. Les scénarios sont construits à partir de **blocs fonctionnels.** Les principales fonctions comprennent : - **La gestion des entrées et des sorties** : acquisition des états et des mesures, commande des équipements raccordés et suivi de leur fonctionnement - **La gestion des variables** : mémorisation, traitement et échange d’informations utilisées par les automatismes - **L’exécution des scénarios** : réalisation des actions selon les conditions et la logique configurées - **La planification** : programmation d’actions en fonction de dates ou d’horaires - **Le pilotage par widgets** : commande des équipements et visualisation des informations depuis le tableau de bord Les blocs fonctionnels permettant de définir : - **des tests** : vérification d’un changement d’état d’une entrée, d’une modification de variable, d’une valeur mesurée, d’une date ou d’un horaire - **des actions** : commande des relais, modification des variables, envoi de notifications, pilotage d’ouvrants avec gestion et suivi de la position - **des temporisations** : gestion des délais et des durées selon la logique configurée. - **de la régulation** : régulation de grandeurs telles que la température ou la luminosité, en mode tout ou rien (TOR) ou par modulation de largeur d’impulsion (PWM), avec fonction d’auto-apprentissage - **des compteurs** : incrémentation ou décrémentation d’une valeur pour comptabiliser des événements ou suivre une quantité *Pour plus d'informations sur les blocs de fonction, consultez : [Utiliser les blocs de fonction](https://modlink.fr/help/link/220#bkmrk-page-title)* Les scénarios s’exécutent **en boucle de manière continue**. Ils analysent les entrées, les mesures, les sorties et les variables du système afin d’appliquer les actions prévues par la logique configurée. Les tests sont évalués dans l’ordre défini et les actions correspondantes sont exécutées lorsque les conditions requises sont remplies. Chaque module peut gérer jusqu’à **3 scénarios indépendants**, exécutés de façon autonome et pouvant être activés ou désactivés individuellement selon les besoins de l’application.Tel un agent de sécurité qui effectue des rondes, un scénario vérifie en permanence différents points de contrôle dans un ordre défini : **Les entrées** : boutons, détecteurs, capteurs et mesures environnementales **Les sorties** : éclairage, vannes, équipements commandés ou dispositifs d’alerte **Les variables** : informations et états utilisés par les scénarios (rapports des agents précédents) *Lorsque les conditions définies sont remplies, les actions correspondantes sont exécutées. Le scénario poursuit ensuite ses vérifications et recommence le cycle en continu*
### 2- Fonctionnement autonome : Edge Automation Le 2PIO repose sur une architecture d’**Edge Automation** : les données sont traitées et les scénarios exécutés directement par le module, au plus près des équipements pilotés. Les automatismes locaux peuvent ainsi continuer à fonctionner sans connexion Internet et sans dépendre d’un serveur central ou d’un service SaaS, sous réserve que les équipements et les ressources nécessaires à leur fonctionnement restent disponibles. Le module peut fonctionner de manière autonome ou s’intégrer à un réseau de modules ModLink grâce au partage de variables. ### 3- Gestion et partage de variables Les variables permettent de **mémoriser et d’échanger des informations** utilisées par les scénarios : état d'un équipement, valeur d'une mesure, résultat d’un calcul ou état intermédiaire d’un automatisme. Lorsqu’elles sont partagées entre plusieurs modules, elles permettent à leurs scénarios respectifs d’échanger des informations et de coordonner leurs actions sans nécessiter de serveur central en cloud. Ce mécanisme contribue à une **architecture d’automatisation décentralisée**, dans laquelle chaque module exécute ses propres scénarios tout en pouvant interagir avec les autres modules du réseau. ### 4- Connectivité IP et découverte des modules Le 2PIO communique sur un réseau **Wi-Fi utilisant les protocoles TCP/IP**. L’intégration au réseau est facilitée par le **DHCP**, qui permet l’attribution automatique des adresses IP, et le **mDNS**, qui permet de découvrir les équipements sur le réseau local sans avoir à saisir leur adresse IP. Ces mécanismes facilitent l’accès au module et la communication entre les équipements du réseau. *Pour plus d'information sur l'accès au module [Accès au module](https://modlink.fr/help/link/211#bkmrk-page-title) et sur les modalités de découverte des modules, consultez [Rechercher un module](https://modlink.fr/help/link/257#bkmrk-page-title)* ### 5. Accès distant sécurisé Le 2PIO intègre un mécanisme d’accès distant reposant sur un **tunnel SSH sécurisé**, qui permet d’accéder au module via Internet sans nécessiter de redirection de ports sur le routeur. Lorsque le tunnel SSH est activé et autorisé, l’interface Web du module est accessible à distance depuis un navigateur Web, sans logiciel spécifique à installer. *Pour plus d'informations sur le tunnel SSH consultez : [Utilisation du tunnel SSH](https://modlink.fr/help/link/259#bkmrk-5.2--utilisation-du-)* ### 6- Communication et intégration Grâce à sa connectivité IP et à ses interfaces de communication, le 2PIO peut échanger des données avec des équipements et des systèmes tiers, notamment dans les domaines de l’automatisation, de la gestion technique du bâtiment (GTB/GTC), de la supervision et de la domotique. Selon la configuration et les interfaces utilisées, les possibilités d’intégration comprennent notamment : - **Home Assistant**, pour exploiter les données du module dans une installation domotique ; - **Modbus TCP**, pour échanger des données avec des équipements et des systèmes compatibles ; - **OPC UA**, pour l’intégration à des systèmes de supervision et de gestion technique ; - **HTTP**, pour transmettre des informations ou déclencher des actions sur des systèmes tiers. Le 2PIO conserve sa propre logique d’automatisation : son fonctionnement local ne nécessite pas qu’un système externe assure en permanence le pilotage des scénarios. Pour plus d'informations sur la communication, consultez : [Protocoles de communication et interopérabilité](https://modlink.fr/help/books/2-pio/page/protocoles-de-communication-et-interoperabilite "Protocoles de communication et interopérabilité")**Pour être utilisées par un système tiers, les variables concernées doivent être préalablement exposées** dans la configuration du 2PIO, conformément aux paramètres requis par l’interface de communication utilisée
### 7- Architecture réseau[](https://modlink.fr/help/uploads/images/gallery/2026-10/architecture-2pio.png) # Schéma d'architecture [](https://modlink.fr/help/uploads/images/gallery/2026-10/XNTschema-2pio.webp) # Description du boîtier ### 1- Etat des voyants Le dispositif comporte **6 voyants LED** permettant de visualiser l’état du système, des communications et des entrées / sorties. [](https://modlink.fr/help/uploads/images/gallery/2026-02/2pio3.jpeg) #### 1.1- Voyant "Process information" - Scénario| **État du voyant** | **Signification** | **Action recommandée** |
|---|---|---|
| vert** clignotant** | Démarrage | Attendre la fin de l’initialisation |
| vert **fixe** | Fonctionnement normal | |
| rouge **clignotant** | Erreur survenue | Réinitialiser le voyant depuis le menu "Paramètres" |
| **État du voyant** | **Signification** |
| bleu **fixe** | Transmissions activées |
| bleu **clignotant** | mode "appairage" |
| rouge **fixe** | Transmissions désactivées |
| **État du voyant** | **Signification** |
| vert **fixe** | Connexion Wi-Fi active |
| vert **clignotant** | mode AP - routeur |
| violet **fixe** | Tunnel SSH actif |
| orange **clignotant** | Tunnel SSH inactif |
| rouge **fixe** | absence de connexion Wi-Fi |
| **État du voyant** | **Signification** |
| **Eteint** | contacts 1 et 2 ouverts |
| rouge **fixe** | contact 1 fermé / contact 2 ouvert |
| bleu **fixe** | contact 2 fermé / contact 1 ouvert |
| violet **fixe** | contacts 1 et 2 fermés |
| **État du voyant** | **Signification** |
| **Eteint** | entrée 1 et 2 ouvertes |
| rouge **fixe** | entrée 1 fermée / entrée 2 ouverte |
| bleu **fixe** | entrée 2 fermée / entrée 1 ouverte |
| Violet **fixe** | entrée 1 et 2 fermées |
| **État du voyant** | **Signification** |
| **Eteint** | entrées 1 et 2 ouvertes |
| rouge **fixe** | entrée 1 fermée / entrée 2 ouverte |
| bleu **fixe** | entrée 2 fermée / entrée 1 ouverte |
| violet **fixe** | entrée 1 et 2 fermées |
| *rangée haute* | ||||||||
| **A1** **Phase** | **A2** **Relais 1 COM** | **A3** **Relais 1 NO** | **A4** **Relais 2** **COM** | **A5** **Relais 2** **NO** | **A6** **Entrée 220V** **1** | **A7** **GND** | **A8** **Alim 24V 1** | **A9** **Alim 24V 2** |
| *rangée basse* | ||||||||
| **B1** **Neutre** | **B2** **Relais 1** **COM** | **B3** **Relais 1** **NO** | **B4** **Relais 2** **COM** | **B5** **Relais 2** **NO** | **B6** **Entrée 220V** **2** | **B7** **GND** | **B8** **Entrée BT 1** | **B9** **Entrée BT 2** |
| **230 AC** | **RLA 1** | **RLA 1** | **RLA 2** | **RLA 2** | **2 in AC** | **GND** | **in 1 BT** | **in 2 BT** |
| État | Action sur le bouton | Fonction | LED |
|---|---|---|---|
| ***hors menu*** | Double appui | Accès au **menu 1** | bleu foncé |
| **menu 1** | Appui simple | Accès au **menu 2** | jaune |
| Double appui | Lance le mode appairage | bleu clignotant | |
| Appui long | Transfert de la configuration Wi-Fi (SSID et mot de passe) ainsi que de la clé de chiffrement | ||
| **menu 2** | Appui simple | Accès au **menu 3** | violet |
| Double appui | Quitte le mode **Slave/Wireless** | ||
| Appui long | Redémarre le module | ||
| **menu 3** | Appui simple | Quitte le menu | bleu clair |
| Double appui | Active ou désactive le mode **Wireless**, puis quitte le mode **Slave** | ||
| Appui long | Réinitialisation complète du module (configuration usine) |
- placer le module 2PIO dans un endroit sec et ventilé - éviter une exposition directe aux rayons du soleil et à l'humidité
# Raccordement électriqueAssurez-vous que l'alimentation électrique est coupée avant de procéder au câblage. Respectez le schéma de câblage
- Utilisez des câbles de section appropriée : 1,5 mm 16A / 2,5 mm 20A - Enficher les fils dans le bornier à insertion directe jusqu’en butée - Pour les retirer, appuyer sur le bouton orange du bornier et extraire le fil
### 1- Tableau de raccordement Réaliser les connexions en vous référant au tableau suivant :| *rangée haute* | ||||||||
| A1 **Phase** | A2 **Relais 1 COM** | A3 **Relais 1 NO** | A4 **Relais 2** **COM** | A5 **Relais 2** **NO** | A6 **Entrée 220V** **1** | A7 **GND** | A8 **Alim 24V 1** | A9 **Alim 24V 2** |
| *rangée basse* | ||||||||
| B1 **Neutre** | B2 **Relais 1** **COM** | B3 **Relais 1** **NO** | B4 **Relais 2** **COM** | B5 **Relais 2** **NO** | B6 **Entrée 220V** **2** | B7 **GND** | B8 **Entrée BT 1** | B9 **Entrée BT 2** |
| **230 AC** | **RLA 1** | **RLA 1** | **RLA 2** | **RLA 2** | **2 in AC** | **GND** | **in 1 BT** | **in 2 BT** |
Il est conseillé d'utiliser des **disjoncteurs distincts** pour l’alimentation (commande) et la puissance
### 1.2- Sorties / relais Les contacts sont libres de potentiel et fonctionnent comme des interrupteurs mécaniques ; ils ne fournissent aucune tension. Les contacts peuvent au maximum couper du 277 VAC avec 30A ou 30 VDC avec 20A. - raccorder **la phase de puissance (alimentation)** au bornier à insertion - relais 1 **(A2 / B2)** contacts en parallèle, l'un au dessus de l'autre - relais 2 **(A4 / B4)** contacts en parallèle, l'un au dessus de l'autre - raccordez la **phase de la charge** de l'autre côté du bornier - relais 1 **(A3 / B3)** contacts en parallèle, l'un au dessus de l'autre - relais 2 **(A5 / B5)** contacts en parallèle, l'un au dessus de l'autre - raccorder le **neutre de la charge au neutre de puissance (alimentation)** - *ils ne passent pas par le module*Pour que les relais puissent commuter au **zéro crossing**, la phase utilisée pour l'alimentation du module et de la charge doivent être synchrones
### 1.3- Entrées #### Entrées AC (220V) - Raccorder le retour de la **phase à piloter** au bornier à insertion \- entrée AC 1 **(A6)** \- entrée AC 2 **(B6)**Le neutre de référence est celui qui est raccordé sur l'alimentation 220 V du module
#### Entrées BT TOR - Raccorder le **contact à piloter** au bornier à insertion \- entrée BT 1 **entre A8 et B8** (A8 sortie 24V / B8 entrée) \- entrée BT 2 **entre A9 et B9 **(A9 sortie 24V / B9 entrée) #### Entrées BT à boucle de courant (analogiques) 4/20mAEn **mode analogique**, les entrées doivent être configurées depuis l'interface Web, dans le menu « *I/O* ». Une entrée basse tension 4-20 mA peut être divisée en **deux canaux distincts A et B**, permettant ainsi de disposer d'une entrée supplémentaire. *L'utilisation de ce mode nécessite un **câblage spécifique** au niveau des capteurs. Veillez à respecter les préconisations de câblage*
#### Raccordement des capteurs [](https://modlink.fr/help/uploads/images/gallery/2026-10/cXvbranchement-4-20ma.webp) #### Raccordement des entrées BT en mode 2 canaux **MANQUE LE SCHEMA** ### 2- Vérification des entrées et des sorties - Remettez l’alimentation et vérifiez que le voyant vert s'allume bien en fixe au démarrage du module. - Pour vérifier que les entrées et sorties réagissent bien, visualiser l'état des voyants sur la façade du module [Description du boîtier](https://modlink.fr/help/books/2-pio/page/description-du-boitier "Description du boîtier") # Première mise en service > La mise en service doit être effectuée **en local, à proximité du module**. Elle consiste à : > > - mettre le module sous tension > - configurer la connexion Wi-Fi > > Cette étape est **indispensable pour permettre l’accès à distance au module**Le comportement et la **signification des voyants** sont détaillés dans le chapitre [« *Description du boîtier* »](https://modlink.fr/help/books/2-pio/page/description-du-boitier "Description du boîtier")
### 2- Identification du module Pour identifier le module : - Soulever le capot amovible - Relevez l’identifiant indiqué sur le moduleChaque module possède un **identifiant unique** au format **2pioxxxx** où `XXXX` correspond à une combinaison de quatre lettres et chiffres. Cet identifiant est utilisé pour accéder au module, aussi bien **en local qu’à distance**
### 3- Configuration de la connexion WiFi Lors de la première mise en service, le module crée automatiquement son propre **réseau Wi-Fi temporaire**, qui permet d’accéder à son interface de configuration. Le voyant "*Wi-Fi mode"* clignote en vert lorsque le module fonctionne en mode point d’accès Wi-Fi. La configuration peut être réalisée à l’aide d’un smartphone, d’une tablette ou d’un ordinateur équipé du Wi-Fi.**Remarque concernant la sécurité du navigateur** La connexion locale au module utilise le protocole **HTTP, sans chiffrement**. Selon le navigateur utilisé, un avertissement de sécurité / absence de connexion Internet peut s’afficher. *Ces messages sont liés au mode de connexion utilisé lors de la configuration initiale.* Autorisez l’accès au site ou poursuivez vers la page proposée par le navigateur.
#### 3.1- Connexion au réseau Wi-Fi du module 1. **Activez le Wi-Fi** sur l’appareil utilisé pour la configuration. 2. **Sélectionnez le réseau Wi-Fi du module** dans la liste des réseaux disponibles. Lors de la première connexion, le nom du réseau (SSID) apparaît sous la forme **Modlink\_2pioXXXX**, où `XXXX` correspond à l’identifiant du module. *un message "réseau non sécurisé" peut s'afficher - ce comportement est normal et il n'y a aucun risque* 3. **Accédez au portail captif** en sélectionnant le réseau Wi-Fi du module. La page de configuration peut s’ouvrir automatiquement ou nécessiter un délai avant son affichage, selon l’appareil utilisé. *Si une notification indique que le réseau Wi-Fi n’a pas accès à Internet, restez connecté à ce réseau pour poursuivre la configuration.* 4. **Sélectionnez le réseau Wi-Fi** auquel le module doit se connecter. *Vérifiez que le signal Wi-Fi est suffisamment puissant pour assurer une connexion stable. Un niveau de signal d’au moins 25% est recommandé.* 5. **Saisissez le mot de passe du réseau Wi-Fi**, puis cliquez sur **Appliquer** #### 3.2- Vérification de la connexion Wi-Fi Après l’application des paramètres, le voyant "*Wi-Fi mode"* indique l’état de la connexion : - **rouge fixe** : le module est connecté au réseau Wi-Fi (il cesse de fonctionner en mode point d'accès WiFi et disparaît de la liste des réseaux WiFi disponibles) - **violet fixe** : le tunnel SSH est actif - **vert clignotant** : le module reste en mode point d’accès Wi-Fi. La connexion au réseau configuré a échoué ou n’a pas abouti (vérifiez le nom du réseau, le mot de passe et la qualité du signal). Le portail captif s'affiche à nouveau**Important : modification des paramètres Wi-Fi** Le module utilise les paramètres Wi-Fi enregistrés lors de sa configuration, notamment le nom du réseau (SSID) et son mot de passe. Si ces paramètres sont modifiés sur le routeur, le module ne pourra plus se reconnecter au réseau avec les informations enregistrées (le voyant *Wi-Fi mode* clignotera en vert) et une nouvelle configuration Wi-Fi en local sera alors nécessaire. Pour faciliter la maintenance et limiter les dépendances au réseau principal, il est recommandé de réserver au module 2PIO un **SSID et un mot de passe spécifiques**
### 4- Connexion et configuration initiale #### 4.1- Accès à l'interface Web L’interface Web permet de configurer, de paramétrer et de superviser le module. Ouvrez un navigateur Web sur un smartphone, une tablette ou un ordinateur, puis saisissez l’adresse correspondant au mode d’accès souhaité dans la barre d’adresse. ##### Accès depuis le réseau local L’appareil utilisé pour accéder au module doit être connecté au **même réseau local que le module**. Saisissez directement l’adresse suivante dans la barre d’adresse du navigateur : `2pioXXXX.local` *Remplacez XXXX par l’identifiant du module, composé de quatre caractères (lettres et chiffres).* ##### Accès à distance via Internet Saisissez directement l’adresse suivante dans la barre d’adresse du navigateur : `2pioXXXX.modlink.fr` *Remplacez XXXX par l’identifiant du module, composé de quatre caractères (lettres et chiffres).* #### 4.2- Authentification et sécurisation des accès L'écran de connexion s'affiche, saisissez les identifiants par défaut :**Identifiant :** `admin` **Mot de passe :** `admin`
Un avertissement indiquant que le certificat de sécurité n’est pas valide peut apparaître. Confirmez l’exception de sécurité pour poursuivre vers l’interface Web. ##### Personnalisation des identifiants Pour sécuriser l’accès au module, il est fortement recommandé de modifier les identifiants par défaut dès la première connexion. Vous pouvez également créer différents **profils utilisateurs** et leur attribuer les droits d’accès correspondant à leurs fonctions. Consultez le chapitre [Comptes utilisateurs](https://modlink.fr/help/link/225#bkmrk-page-title) pour plus d’informations. ##### Configuration du profil gestionnaire Dans **Paramètres > Informations > Profil > Gestionnaire**, renseignez les données de géolocalisation du module. Ces informations permettent de déterminer les heures locales de lever et de coucher du soleil, utilisées notamment par les scénarios d’automatisation de l’éclairage. Renseignez également l’adresse e-mail du gestionnaire afin de recevoir les notifications automatiques envoyées par le module lorsqu’une erreur est détectée. ### 5- Utilisation d'un scénario préconfiguré**Avantages d'un scénario préconfiguré : -** Mise en place immédiate - Logique déjà validée - Réduction du risque d’erreur
Dans le cas contraire, il est possible : - de modifier un scénario existant afin de l’adapter aux besoins de l’installation [Modifier un scénario préconfiguré](https://modlink.fr/help/books/2-pio/page/scenarios-preconfigures "Scénarios préconfigurés") - de créer un nouveau scénario entièrement personnalisé [Créer un scénario personnalisé](https://modlink.fr/help/books/2-pio/page/creer-un-scenario-personnalise "Créer un scénario personnalisé")Le **mode point d’accès** est particulièrement utile lors de la première mise en service ou lorsqu’aucun réseau Wi-Fi configuré n’est disponible. Le module reste opérationnel en local (les scénarios et automatismes configurés continuent de s’exécuter) mais aucun accès à distance n'est possible
Procédure de connexion : 1. Activez le Wi-Fi sur votre appareil 2. Recherchez les réseaux Wi-Fi disponibles 3. Sélectionnez le réseau du module, identifié par son SSID 4. Si votre appareil indique que le réseau Wi-Fi ne dispose pas d’un accès à Internet, cela est normal dans ce mode. Connectez-vous au réseau du module, même si votre appareil signale l’absence d’Internet. 5. Lorsque le portail captif s'affiche, suivez les instructions pour accéder à l'interface du module #### 1.2- Accès via un réseau Wi-Fi (mode standard*)*Un réseau **Wi-Fi dédié aux équipements IoT** permet de séparer les équipements techniques du réseau principal. Cette séparation facilite l’administration du réseau et peut renforcer la sécurité, selon la configuration mise en place. Lorsque les identifiants du réseau Wi-Fi principal sont modifiés, la connexion des modules au réseau IoT dédié n’est pas affectée.
Procédure de connexion 1. Connectez votre ordinateur, tablette ou smartphone au même réseau local que le module 2. Ouvrez un navigateur Web 3. Saisissez l’adresse du module dans la barre d'adresse du navigateur suivi de .local `2pioXXXX.local` Remplacez `XXXX` par l’identifiant unique du module, composé de quatre caractères alphanumériques. 4. Sur la page de connexion, saisissez le nom d’utilisateur et le mot de passe**identifiant par défaut** : admin **mot de passe** **par défaut** : admin *Modifiez les identifiants par défaut lors de la mise en service afin de limiter les accès non autorisés*
La **connexion locale** utilise le protocole HTTP. Selon le navigateur, un avertissement de sécurité peut apparaître pour indiquer l'absence de chiffrement HTTPS. Vérifiez que l’adresse saisie correspond bien au module puis autorisez l'accès au site / page selon les options proposées
> 💡 **Astuce** : si la page de connexion n’apparaît pas, vérifiez que l’appareil et le module sont bien sur le même réseau, que le numéro unique est correct et que la mise en service a été réaliséeUne fois la configuration Wi-Fi effectuée et le module connecté à Internet, celui-ci devient **accessible à distance**. Par défaut, **le tunnel SSH est activé** afin de permettre cet accès distant
En l'**absence de connexion Internet**, le module 2PIO continue d'assurer le **fonctionnement local de l'installation** : - Les scénarios, temporisations et automatismes configurés continuent de s'exécuter - Les interfaces et les équipements connectés au module restent opérationnels sur le réseau local - L'administration et le pilotage restent possibles localement, *L'accès distant via Internet n'est pas disponible tant qu'une connexion Internet opérationnelle n'est pas rétablie*
#### 1.3- Par adresse IP Il est également possible d'accéder à l'interface web d'un module en utilisant directement son adresse IP. ##### Consulter l’adresse IP du module L’adresse IP du module est consultable dans l’interface Web, dans le menu **Paramètres > Informations > Résumé système**. Cette page regroupe également les principales informations d’identification du module : - Numéro de série - Adresse MAC - Adresse IP - Clé sécurisée - Informations relatives au réseau Wi-Fi [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-26-143528.jpg) ##### Accéder à l’interface Web 1. Connectez votre ordinateur, tablette ou smartphone au même réseau local que le module 2PIO 2. Ouvrez un navigateur Web 3. Saisissez l’adresse IP du module dans la barre d’adresse du navigateur 4. Sur la page de connexion, saisissez votre nom d’utilisateur et votre mot de passe L’adresse IP permet ainsi d’accéder à l’interface Web du module sans utiliser son nom d’hôte local.l’adresse IP attribuée par le réseau peut changer, notamment après une reconnexion ou un redémarrage du module.
Pour conserver une adresse IP constante, vous pouvez configurer une adresse IP statique dans **Paramètres > Connectivité > Connexion Internet > Configurer**, puis activer l’option **Utiliser une IP statique**. [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-22-171605.jpg) ### 2- Accès à distanceDans certains cas d’usage, un accès à distance peut être mis en place temporairement **en l’absence de connexion Internet permanente sur site**, grâce au partage de connexion mobile d’un smartphone. Ce mode d’accès nécessite la présence d’un intervenant sur place pour activer le partage de connexion et établir la liaison. Il est destiné à des interventions ponctuelles, telles que la mise en service ou la programmation du module. Il ne remplace pas une connexion Internet locale permanente et peut être soumis aux limitations du réseau mobile (débit, stabilité, consommation de données)
**Mise en œuvre :** 1. L’intervenant sur site active le partage de connexion Wi-Fi de son smartphone 2. Il connecte le module à ce réseau Wi-Fi temporaire 3. Le technicien à distance peut alors accéder au module, sous réserve que les fonctions d’accès distant nécessaires soient configurées et opérationnelles #### 2.3- Désactiver la connexion à distance**Par défaut, l’accès à distance au module 2PIO est activé** **via le tunnel SSH.** Ce tunnel est partagé entre l’accès distant à l’interface Web du module 2PIO et l’accès distant via OPC UA. Il ne peut être utilisé que par une seule de ces fonctionnalités à la fois. Lorsque le tunnel SSH est affecté à l’accès OPC UA distant, l’accès distant à l’interface Web du module est désactivé. L’accès local au module reste disponible.
Si vous ne souhaitez pas que le module soit accessible depuis l'extérieur du réseau local : - accédez au menu "*Paramètres*" > "*Connectivité*" > *"Accès à distance"* - appuyer sur le bouton *Configurer* - cochez l'option "*Désactiver le SSH*". [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-22-173944.jpg) - Une fois l'option activée, l'état de la connexion est mis à jour et affiche « *SSH désactivé* », confirmant que l'accès à distance est désormais désactivé [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-22-174020.jpg) ### 3- Page d'accueil et tableau de bord Après connexion, l’interface Web du 2PIO affiche la page d’accueil, organisée sous forme de **tableau de bord**. La barre de navigation, située en haut de l’écran, permet d’accéder aux différents **menus** de l’interface : Scénarios, I/O, Widgets, Planification et Paramètres. La page d’accueil regroupe des **raccourcis vers les principales fonctions du module**, ainsi qu’une zone dédiée aux **widgets** configurés. Ces derniers permettent notamment de commander les équipements, de consulter l’état des entrées et des sorties et de visualiser les mesures disponibles. Le bouton **« Gérer les widgets »** permet d’accéder à leur configuration afin de personnaliser le tableau de bord. ### 4- Mode application sur smartphone (PWA)L’interface Web du 2PIO peut être utilisée en **mode application (PWA)** sur smartphone. Un raccourci est ajouté à l’écran d’accueil **pour accéder directement à l'interface du module**, sans avoir à ouvrir le navigateur ni à saisir son adresse. *Cette fonctionnalité ne nécessite aucune installation depuis un magasin d’applications*
#### Installation sur smartphone Android *La procédure ci-dessous a été validée avec **Firefox sur Android**. Les intitulés des menus peuvent varier selon la version du navigateur et du système.* **1. Ouvrir l’interface Web du 2PIO** Depuis Firefox, accéder à l’interface Web du module. [](https://modlink.fr/help/uploads/images/gallery/2026-09/screenshot-20260907-113010-firefox.jpg) **2. Ouvrir le menu du navigateur** Appuyer sur le menu de Firefox, puis sélectionner l’option permettant d’ajouter ou d’installer la page sur l’écran d’accueil. [](https://modlink.fr/help/uploads/images/gallery/2026-09/screenshot-20260907-112934-firefox.jpg) **3. Nommer le raccourci** Saisir le nom souhaité pour identifier le module sur l’écran d’accueil, puis valider. [](https://modlink.fr/help/uploads/images/gallery/2026-09/screenshot-20260907-112955-firefox.jpg) **4. Accéder au 2PIO depuis l’écran d’accueil** Une nouvelle icône apparaît sur l’écran d’accueil du smartphone. Appuyer dessus pour ouvrir directement l’interface Web du 2PIO en mode application (cette icône constitue un raccourci vers l’interface Web du module, elle ne correspond pas à une application native à télécharger et à installer). # Réseau et communication Les modules 2PIO peuvent être interconnectés pour former un réseau de communication sécurisé, dès lors qu’ils partagent la même clé de chiffrement. Ils échangent des informations en temps réel et partagent leurs variables, permettant de coordonner leurs automatismes et d’utiliser des entrées ou des sorties distantes sans câblage supplémentaire. Le réseau peut être étendu à tout moment par l’ajout de nouveaux modules, et les échanges avec des systèmes tiers permettent d’intégrer le 2PIO à des solutions de supervision et de gestion technique du bâtiment. # Rechercher et ajouter un moduleAvant toute importation, **transférez les clés de chiffrement vers les modules** afin de sécuriser les communications. Une fois cette opération réalisée, vous pouvez lancer la découverte mDNS et importer les modules souhaités *[Transférer les clés de chiffrement](https://modlink.fr/help/link/184#bkmrk-3--transfert-des-cl%C3%A9)*
Une fois importé, le module apparaît dans la liste des modules connectés. Pour chaque module, il est possible de consulter les **informations de connexion** (ports, adresse MAC, clé API), la **liste des I/O** et des **variables** partagées. Cliquez sur les listes déroulantes pour développer leur contenu et afficher les informations disponibles. [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-07-142350.jpg) ### 2. Ajout manuel d’un module Si vous connaissez l'identifiant du module, vous pouvez **l'ajouter manuellement** sans effectuer de scan mDNS 1. Dans le menu **I/O > Distant**, cliquez sur **+ Ajouter un appareil [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-07-165512.jpg)** 2. Renseignez les champs **Nom de l’appareil et Nom d'hôte** au format attendu, par exemple `2pioXXXX.modlink.fr` 3. Sélectionnez le protocole **HTTP** 4. Cliquez sur **Ajouter l’appareil** pour confirmer [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-07-170004.jpg) ### 3- Consulter les informations de connexion Après l’ajout d’un module, vous pouvez consulter les informations disponibles dans la liste des modules distants, notamment les ports, l’adresse MAC, la clé API, les entrées/sorties et les variables. Pour consulter les informations réseau du module lui-même, ouvrez **Paramètres > Informations > Résumé système**. Cette page affiche notamment : - le numéro de série - l’adresse MAC - l’adresse IP - la clé sécurisée - les informations relatives à la connexion Wi-Fi # Appairer les modules et créer un réseau Cette procédure décrit comment créer un réseau de communication entre plusieurs modules 2PIO ou intégrer un nouveau module à un réseau existant. Deux méthodes sont disponibles : - **Appairage manuel**, à l’aide du bouton de configuration des modules. - **Appairage via les interfaces Web**, pour effectuer les opérations en local depuis un navigateur Web Ces deux méthodes permettent de transférer les clés de chiffrement et de configurer la connexion Wi-Fi du nouveau module. Pour que l’intégration soit effective, la configuration doit être sauvegardée et le module redémarré.**Conditions d'appairage et de transfert de la clé de chiffrement :** L'appairage nécessite une **intervention sur place** (y compris lorsqu'il est effectué via les interfaces Web). Pour des raisons de sécurité, les modules doivent se trouver **à proximité immédiate** les uns des autres et le transfert de la clé de chiffrement doit être effectué dans les **2 minutes suivant** l'activation de l'appairage. Passé ce délai, relancez la procédure d'appairage avant de tenter à nouveau le transfert
### 1. Appairage manuel avec le bouton de configuration Consultez le chapitre [navigation avec le bouton de configuration](https://modlink.fr/help/link/264#bkmrk-page-title) pour connaître le fonctionnement des boutons, #### 1.1. Préparer le module à ajouter (récepteur) Sur le module à intégrer au réseau : 1. Effectuez un **double appui** sur le bouton de commande ; la LED *Wireless mode* s'allume en bleu foncé 2. Effectuez ensuite un **appui simple** ; la LED *Wireless mode* se met alors à clignoter en bleu Le mode appairage est alors **activé pour une durée de deux minutes** Répétez cette opération pour chaque module supplémentaire à intégrer au réseau. #### 1.2. Transférer les informations depuis le module déjà configuré (émetteur) Sur le module déjà configuré : 1. Effectuez un **double appui** sur le bouton de configuration ; la LED *Wireless mode* s'allume en bleu foncé 2. Effectuez ensuite un **appui long** pour lancer le transfert de la clé de chiffrement et de la configuration Wi-Fi (SSID et mot de passe) vers le ou les modules à ajouter Vérifiez que le transfert a été correctement effectué en contrôlant l'état des voyants sur le module récepteur : - la LED *"Process info"* passe au **vert fixe** - la LED "WiFi mode*"* passe au **violet.** Si elle reste **verte clignotante,** cela signifie que le transfert a échoué. Dans ce cas, recommencez l'intégralité de la procédure : activez à nouveau l'appairage sur le module récepteur, puis relancez le transfert depuis le module émetteur. ### 2. Appairage via les interfaces Web en local Cette méthode permet de configurer la connexion Wi-Fi du nouveau module, de transférer les clés de chiffrement et d'intégrer les modules au réseau depuis leurs interfaces Web en local. #### 2.1. Connecter le module à ajouter au réseau Wi-Fi ##### Se connecter au réseau Wi-Fi temporaire du module 1. Activez le Wi-Fi sur votre smartphone ou sur l’équipement utilisé pour la configuration. 2. Recherchez les réseaux Wi-Fi disponibles. 3. Sélectionnez le réseau temporaire du module à ajouter. Son nom correspond au SSID « Captive Portal », suivi de l’identifiant du module. *Si un message indique que le réseau n’est pas sécurisé ou qu’il ne dispose pas d’une connexion Internet, maintenez la connexion à ce réseau Wi-Fi.* La page du portail captif s’affiche automatiquement. Son ouverture peut prendre quelques instants. ##### Configurer la connexion Wi-Fi 1. Sur le portail captif, sélectionnez le réseau Wi-Fi auquel le module doit se connecter *Vérifiez que la qualité du signal est suffisante pour assurer une connexion stable. Le niveau recommandé est d'au moins **25%**.* 2. Saisissez le mot de passe du réseau Wi-Fi puis cliquez sur *« Appliquer »* Contrôlez ensuite l'état de la LED **Wi-Fi mode** : - elle passe au rouge lorsque le module se connecte au Wi-Fi - elle passe ensuite au violet fixe lorsque le tunnel SSH est actif Si le mot de passe est incorrect ou si le signal Wi-Fi est insuffisant, la LED peut continuer à clignoter en vert et le portail captif peut s'afficher à nouveau. Dans ce cas, vérifiez les paramètres de connexion et recommencez la configuration si nécessaire. Une fois la connexion établie, ouvrez un navigateur Web et saisissez l'adresse locale du module dans la barre d'adresse : **`2pioXXXX.local`** *Remplacez `XXXX` par l’identifiant du module* #### 2.2. Ouvrir l'appairage sur le module déjà configuré Depuis l'interface Web du module déjà configuré : 1. Ouvrez le menu *"I/O"* 2. Sélectionnez le mode "*Wireless"*, puis l'onglet "*Clés"* 3. Dans la section "*Clé et appairage sécurisé"*, cliquez sur "*Ouvrir l'appairage"* L'appairage est alors ouvert sur le module principal *[](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-06-160422.jpg)* #### 2.3. Demander l'intégration du nouveau module Depuis l'interface Web du module à ajouter : 1. Ouvrez le menu "*I/O"* 2. Sélectionnez le mode "*Wireless",* puis l'onglet *"Clés"* 3. Dans la section "*Clé et appairage sécurisé"*, cliquez sur "*Demander à rejoindre"* Cette opération permet au nouveau module de demander son intégration au réseau #### 2.4. Transférer la clé de chiffrement Revenez sur l'interface Web du module déjà configuré : 1. Dans la section *"Transférer les clés chiffrées"*, cliquez sur *"Transférer les clés"* 2. Vérifiez que le transfert a bien été pris en compte sur le module à ajouter [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-06-160612.jpg)le transfert doit être effectué dans **les deux minutes suivant l'ouverture de l'appairage** sur le module principal. Si le délai expire, relancez la procédure d'appairage
Si l'interface signale que la clé est manquante, cliquez sur *« Actualiser l'état »*. Si nécessaire, vérifiez la disponibilité des clés dans **Paramètres > Sécurité > Clés** avant d'envisager leur régénération. #### 2.5. Détecter et importer les modules Une fois les clés transférées, les modules doivent être détectés et importés dans la configuration du réseau. Depuis l'interface Web : 1. Ouvrez le menu *"I/O", s*électionnez le mode *"Distant"* 2. Cliquez sur *"Scanner mDNS"* pour lancer la détection des modules présents sur le réseau 3. Dans la liste des appareils détectés, repérez le module à ajouter, cochez-le puis cliquez sur *"Importer la sélection"* 4. Cliquez sur *"Sauvegarder"* pour enregistrer la configuration ### 3. Finaliser l'intégration au réseau Toute modification de la composition du réseau de modules — ajout, suppression ou remplacement — nécessite un redémarrage pour appliquer la nouvelle configuration. Après avoir enregistré les modifications : 1. Cliquez sur le bouton *"Redémarrer"* dans la barre de navigation 2. Attendez que le module redémarre et vérifiez l'état des voyants 3. Vérifiez que les modules communiquent correctement au sein du réseau [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-07-123042.jpg) Une fois les modules appairés et le réseau de communication établi, il est nécessaire de définir le rôle de chaque module. Consultez le chapitre [définir le rôle d'un module](https://modlink.fr/help/link/263#bkmrk-page-title) pour poursuivreToute modification de la composition du réseau de modules (ajout, suppression ou remplacement) nécessite un redémarrage afin d'appliquer la nouvelle configuration
# Remplacer un module défaillant Dans une installation comportant plusieurs modules, il est possible de remplacer un module défaillant sans avoir à reconfigurer l'ensemble du réseau. Pour cela, attribuez au nouveau module **le nom et le numéro de série du module défaillant**, puis restaurez sa configuration à partir d’une sauvegarde. Les autres modules pourront ainsi retrouver automatiquement le module de remplacement et poursuivre leurs échanges sans modification supplémentaire du réseau. ## 1. Renommer le module de remplacement Dans l’interface Web du nouveau module, accédez à **Paramètres > Informations > Identité**, puis cliquez sur "*Changer de nom"*, à côté du champ *Nom de l’appareil*. [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-105738.jpg) Reportez les informations du module défaillant : - **Nouveau nom** : saisissez le nom de l’ancien module - **Numéro de série** : saisissez le numéro de série de l’ancien module. Celui-ci figure sur l’étiquette d’identification située sous le capot du module - Confirmez la demande de remplacement [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-105223.jpg)Le **numéro de série** du module s'affiche dans l’interface Web, sous Paramètres > Informations > Identité > Résumé système, il figure également sur l'étiquette d'identification située sous le capot amovible
### 2- Restaurer la configuration de l'ancien module Pour restaurer la configuration du module défaillant : 1. Accédez à **Paramètres > Informations > Maintenance**. 2. Dans la section *Sauvegardes*, cliquez sur **Restaurer** pour restaurer la dernière sauvegarde une sauvegarde du module défaillant. Les cinq dernières sauvegardes sont conservées. Vous pouvez donc choisir une sauvegarde antérieure si nécessaire. Une fois le remplacement effectué et la configuration restaurée, le nouveau module reprend le fonctionnement de l’ancien, sans qu’il soit nécessaire de reconfigurer les autres modules du réseau ni les scénarios enregistrés dans la sauvegarde. **Remarque :** si le module défaillant est réparé puis remis en service, il ne retrouvera pas son nom initial. Au démarrage, il prendra automatiquement le nom attribué au module de remplacement. - Accédez au menu "*Paramètres"* - Sélectionnez l'onglet "*Informations"*, puis cliquez sur "*Maintenance"* - Dans la section *Sauvegardes,* cliquez sur le bouton *Restaurer* afin de restaurer la dernière sauvegarde disponible. *Les cinq dernières sauvegardes restent toutefois disponibles et peuvent être restaurées si nécessaire*Une fois le changement de nom effectué et la configuration restaurée, le nouveau module remplacera automatiquement le module défaillant et pourra être utilisé sans nécessiter de reconfiguration du réseau ni des scénarios
Si le module défaillant est réparé puis remis en service, il ne reprendra pas son nom d'origine. Au démarrage, **il prendra automatiquement le nom du module de remplacement**
# Protocoles de communication et interopérabilité Le module 2PIO permet d’échanger des données avec des systèmes externes à l’aide de différents protocoles et services de communication, notamment **Modbus TCP, Home Assistant, OPC UA et HTTP**. Ces interfaces permettent notamment de transmettre les données du module à des systèmes tiers, de les exploiter dans des applications de supervision ou de domotique et, selon les fonctionnalités disponibles, de déclencher des actions à distance.Seules les variables préalablement exposées à Modbus sont accessibles via ce protocole
### 2- Intégration avec Home Assistant Home Assistant est une plateforme open source de domotique permettant de centraliser et d’automatiser la gestion de nombreux équipements connectés au sein d’une interface unique. L’intégration du module 2PIO permet de consulter ses états, d’exploiter ses mesures et de commander ses sorties depuis Home Assistant. Les variables exposées peuvent être utilisées dans les tableaux de bord et les automatisations de la plateforme.Seules les **variables exposées à OPC UA** sont accessibles depuis les systèmes externes
[](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-150230.jpg) [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-170217.jpg) **[](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-171359.jpg)** #### 5.2- Utilisation du tunnel SSH Le tunnel SSH est partagé entre l’accès distant au 2PIO et l’accès distant à OPC UA. Il ne peut être affecté qu’à **une seule de ces fonctionnalités à la fois**. Lorsque le tunnel SSH est affecté à l’accès OPC UA distant, l’accès distant à l’interface Web du 2PIO est désactivé. Le module reste alors accessible via son interface Web uniquement depuis le réseau local. # Variables Les variables permettent aux scénarios, aux widgets et aux systèmes externes d'interagir avec le module. Elles se répartissent en deux catégories : les **variables d'état**, qui reflètent l'état d'un équipement ou d'une fonction, et les **variables d'action**, qui permettent de commander ou de modifier cet état. Une utilisation appropriée de ces variables facilite la création de scénarios, le pilotage de l'installation et son intégration avec des systèmes tiers. # Gestion des variablesUne variable est une zone mémoire contenant une **valeur susceptible d’évoluer** au cours du temps (températures, états des relais, consignes, compteurs ...)
Les variables sont des **éléments essentiels** pour le fonctionnement **des scénarios,** elles permettent de stocker, échanger et exploiter les informations par le module local ou être diffusées sur le réseau pour être partagées avec d'autres modules. Les variables peuvent être : - **Lues** → utilisées dans des blocs de test pour prendre des décisions - **Modifiées** → via des blocs d’action - **Comparées** → pour orienter le déroulement Les variables sont utilisées pour : - **mémoriser** des valeurs ou l'état d'un appareil - réaliser des **tests et des conditions** - déclencher des **actions** ; - **échanger des information**s entre modules du réseau. - Effectuer des **calculs simples** - Gérer des **temporisations et des compteurs**Les variables peuvent être : - **préconfigurées** et disponibles immédiatement sur un module - créées par l'utilisateur selon les besoins du scénario - utilisées localement, **partagées entre les modules d'un réseau** ou **exposées vers les systèmes tiers**
Bonnes pratiques : *une variable bien définie et correctement documentée sera plus facile à comprendre, à configurer et à utiliser* ** **- **Définir le besoin** : déterminer précisément ce que la variable doit mesurer, représenter ou contrôler dans le scénario - **Vérifier les variables préconfigurées** : identifier celles qui sont déjà disponibles afin d’éviter de créer des doublons - **Choisir un nom explicite** : utiliser une appellation qui reflète clairement la fonction de la variable et facilite son identification dans les scénarios - **Vérifier le type de variable** : s’assurer qu’il est compatible avec les actions et les scénarios prévus (numérique, booléen, texte, etc.) - **Définir une valeur initiale** : attribuer une valeur à la variable avant de l’utiliser - **Préciser son rôle** : renseigner un commentaire décrivant sa fonction afin de faciliter la compréhension et la maintenance de la configuration
### 1- Afficher les variables Pour afficher les variables d'un module : - allez dans le menu "*I/O*" - puis sélectionner le mode "*Local*" [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-24-144252.jpg) Les variables disponibles sur le module s'affichent alors ### 2- Créer une nouvelle variable Certaines variables sont préconfigurées sur le module et peuvent être utilisées immédiatement dans les scénarios. *Elles couvrent les besoins les plus courants et ne nécessitent aucune configuration préalable.* Toutefois, pour répondre à des besoins fonctionnels spécifiques ou mettre en œuvre des logiques d'automatisation plus avancées, il peut être nécessaire de **créer des variables supplémentaires**. Ces variables personnalisées permettent d'adapter précisément le fonctionnement des scénarios aux exigences de l'installation. - Aller dans le menu « *I/O* » - Cliquer sur le bouton "*+Ajouter*" [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-24-153854.jpg) - Compléter les informations pour la création de la nouvelle variable [](https://modlink.fr/help/uploads/images/gallery/2026-11/capture-decran-2026-11-03-172419.jpg)La variable créée apparaitra à la suite des variables déjà configurées. Le nombre de variables maximal est limité à 32. Une variable peut être utilisée simultanément dans plusieurs scénarios.
#### 2.1- Paramétrer une variable - Sélectionner la variable que vous souhaitez configurer et cliquer sur *l’icône pinceau.* [](https://modlink.fr/help/uploads/images/gallery/2026-11/0grcapture-decran-2026-11-03-174632.jpg) - Renseignez ensuite les informations de la variable dans la fenêtre qui s'ouvre [](https://modlink.fr/help/uploads/images/gallery/2026-11/capture-decran-2026-11-03-174421.jpg) - **le nom** il est recommandé d'utiliser un nom explicite afin d’identifier clairement la variable dans les scénarios et la supervisionChoisissez soigneusement le nom des variables lors de leur création. Si une variable est renommée par la suite, **son nouveau nom ne sera pas automatiquement mis à jour dans les scénarios et les widgets qui l'utilisent** et il faudra nécessairement la remplacer manuellement
- **la valeur par défaut** Valeur appliquée à la variable lors du démarrage du module ou après un redémarrage. Ce paramètre permet de garantir un état de fonctionnement sûr au lancement. - **l’unité et le type d’unité** Précise l’unité de mesure associée à la variable (par exemple : température et degrés celcius). Important pour la cohérence des scénarios et l’affichage correct dans la supervision - **le type de variable Home Assistant** Ce paramètre est essentiel pour assurer la bonne communication et l’interopérabilité avec les plateformes domotiques - **les droits d’accès** Ils permettent de définir comment la variable peut être utilisée : \- lecture seule : elle peut être consultée mais non modifiée \- écriture seule : elle peut être modifiée sans possibilité de lecture \- lecture et écriture : elle peut être à la fois consultée et modifiée Ce paramétrage garantit un contrôle sécurisé de l’utilisation des variables dans les scénarios et les interfaces externes - **un commentaire, descriptif personnalisé** Champ libre permettant de saisir tout type de remarque ou d'information complémentaire pour documenter l’usage spécifique ou les particularités de la variable - les **options d'exposition et de diffusion** sur le réseau Permettent de définir la visibilité des variables sur d'autres interfaces, avec d'autres protocoles Facilitent l’intégration avec des systèmes tiers et le pilotage à distance. - ***Scénario distant*** Permet l’utilisation de la variable par des scénarios exécutés à distance (supervision ...) - ***Home Assistant*** Expose la variable dans Home Assistant. *Exemple : récupération d’un état (alarme, disjoncteur) ou commande d’un équipement depuis Home Assistant - **Wireless*** Autorise l’échange direct avec les modules 2PIO distants - ***Modbus*** Expose la variable via le protocole Modbus (utilisé en automatisme, GTB) - ***Site Web*** Rend la variable accessible depuis l’interface Web locale ou distante du système - ***OPC UA*** Permet l’intégration avec des superviseurs industriels (SCADA, GTB ...) - ***Non sécurisé*** Permet un accès simplifié à la variable sans mécanisme de sécurité renforcé. *À utiliser uniquement dans des environnements maîtrisés* Appuyer sur le bouton "Sauvegarder" pour enregistrer les modifications #### 2.2- Configurer les valeurs d'une variable| **Variable** | **Principe** | **Utilisation** |
|---|---|---|
| **Bouton télérupteur ⚙️** | Mémorise l'état du bouton poussoir (ON / OFF) | lié au scénario "télérupteur" |
| **Compteur de boucle 🔒** | Compte le nombre de passages dans une boucle de scénario | Limitation de répétition, contrôle de boucle |
| **Courant relais 1 🔒** | Indique le courant consommé sur le relais 1 | Surveillance de charge, détection de surcharge |
| **Courant relais 2 🔒** | Indique le courant consommé sur le relais 2 | Analyse de consommation, diagnostic |
| **Disjoncteur 🔒** | Indique l’état du disjoncteur (actif / déclenché) | Sécurité, détection de coupure ou surcharge |
| **Temporisation télérupteur ON / OFF ⚙️** | Applique la temporisation ou non | |
| **Sortie 1 🔒** | Indique l’état de la sortie 1 (ON / OFF) | Vérification d’état d’un actionneur |
| **Sortie 2 🔒** | Indique l’état de la sortie 2 (ON / OFF) | Synchronisation et contrôle logique |
| **Entrée 220V 1 🔒** | Indique la présence de tension sur l’entrée 220V 1 | Détection alimentation secteur |
| **Entrée 220V 2 🔒** | Indique la présence de tension sur l’entrée 220V 2 | Surveillance réseau électrique |
| **Entrée 12V 1 🔒** | Indique l’état de l’entrée 12V 1 | Lecture de capteurs ou contacts secs |
| **Entrée 12V 2 🔒** | Indique l’état de l’entrée 12V 2 | Détection d’événements ou commandes externes |
| Usage | Route | Authentification |
|---|---|---|
| Systèmes externes (présente documentation) | `/api/public/variable` | Clé externe |
| Home Assistant (appairage intégré) | `/api/ha/*` | Clé externe |
| Communication entre cartes 2PIO | `/api/v2/*`, `/subscribe/*` | Réservée aux cartes ; la clé externe est refusée |
| Interface Web de la carte | Toutes les autres routes | Session utilisateur |
Accès réservé : seuls les utilisateurs disposant du rôle **Installateur** et des **permissions** associées peuvent accéder à la gestion des scénarios
Les scénarios sont représentés graphiquement sous forme de **blocs fonctionnels** d'entrée et de sortie **interconnectés**, illustrant le comportement du module et les relations entre les différentes conditions, actions et temporisations. Les scénarios chargés sur le module sont accessibles depuis le menu *« Scénarios ».* Ils apparaissent dans le bandeau latéral situé à gauche de l'écran. Vous pouvez naviguer dans la *zone de travail* pour visualiser la structure et la logique du scénario. Une *mini-fenêtre de visualisation*, située en bas à droite de l’écran, offre un aperçu global des blocs. La *barre d'outils latérale* affichée à 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 blocsChaque module peut contenir un maximum de **3 scénarios** Seuls les scénarios **chargés sur le module** sont affichés dans l'interface d'administration
Depuis le menu "Scénario" il est possible de : - **éditer** un scénario - la mention *« Scénario ouvert »* s'affiche alors - **activer ou désactiver** un scénario - **supprimer** un scénario - **modifier les informations** d'un scénario (nom, description, etc.) à l'aide du bouton *« Modifier »* - **exporter** un scénario vers un ordinateur local ou un emplacement distant - **importer** un scénario modèle depuis le serveur distant Pour quitter le mode édition sans enregistrer les modifications effectuées, cliquez sur *« Abandonner ».* Pour conserver les modifications apportées au scénario, cliquez sur *« Sauvegarder ».*Plusieurs options de scénario sont possibles : - utiliser un **scénario préconfiguré** si son fonctionnement correspond à votre besoin - importer et activer un **scénario modèle** si son fonctionnement correspond à votre besoin - **modifier un scénario existant** pour l’adapter à votre usage - **créer un nouveau scénario** entièrement personnalisé
# Scénarios préconfigurés**Deux scénarios préconfigurés** sont intégrés par défaut dans chaque module. Ils peuvent être **utilisés immédiatement** sans création de logique ni programmation complémentaire Les **variables, les blocs de fonction ainsi que les widgets** associés à ces scénario sont également créés et disponibles automatiquement dès leur chargement
### 1- scénario préconfiguré 1 Télérupteur avec ou sans temporisationLes scénarios sont construits à partir de **blocs fonctionnels interconnectés.** Chaque bloc remplit une fonction logique précise dans le traitement des **entrées**, des **variables** et des **sorties**.
### 1- Tests sur les entrées** ** Ces blocs sont utilisés pour **contrôler l’état ou le comportement des éléments physiques connectés aux entrées du module**. Ils permettent de traiter les différents types de signaux d'entrées provenant des capteurs ou des interrupteurs (impulsions, états logiques, variations ...) avant de déclencher une action. #### 1.1- impulsion simple Ce bloc permet de détecter **un appui court et unique** sur une entrée. Il génère une action uniquement lors de la détection d’une impulsion, sans maintien de l’état. #### 1.2- une impulsion doubleCe bloc de fonction ne s’applique pas à la régulation du chauffage. Pour cet usage, un bloc spécifique est disponible dans la section « Régulation ».
Le bloc devient VRAI uniquement au moment du changement, puis redevient FAUX - il ne reste pas actif - il déclenche une seule fois par changement
#### 1.7- Test état ON / OFF Ce bloc permet de **vérifier l’état d’une entrée**. Il détecte si l’entrée est en position ON ou OFF et déclenche les actions associées en fonction de l’état constaté.Ce bloc vérifie un **état stable**
#### 1.8- Test contact radar Ce bloc permet de vérifier l’**état du contact issu d’un détecteur radar**. Il détecte la présence ou l’absence de détection et déclenche les actions associées en fonction de l’état du contact. Il faut paramétrer le **délai de défaut en minutes**. Par exemple, si le capteur reste ouvert pendant une durée supérieure à 30 minutes, il passe automatiquement en état d’erreur.| **Bloc** | **Type de test** | **Utilisation** |
|---|---|---|
| **Impulsion simple** | Détecte une seule impulsion | Déclencher une action sur appui court |
| **Impulsion double** | Détecte deux impulsions successives rapprochées | Utilisé pour commandes type double-clic |
| **Impulsion longue** | Détecte une impulsion maintenue dans le temps | Déclencher une action sur appui long |
| **3 impulsions** | Détecte trois impulsions successives | Commandes spécifiques multi-clic |
| **Test analogique** | Compare une valeur analogique à un seuil | Lecture capteurs (température, luminosité, etc.) |
| **Test état front** **ON / OFF** | Détecte un changement d’état (front montant ou descendant) | Déclenchement sur transition ON ↔ OFF |
| **Test état ON / OFF** | Vérifie l’état stable d’une entrée | Vérifier si une entrée est active ou inactive |
| **Test contact radar** | Détecte l’état ou l’activation d’un contact radar | Utilisation avec détection de présence |
Chaque égalité correspond à une valeur possible de la variable. Le bloc réalise donc un test d’appartenance à une liste de valeurs définies.
| **Bloc** | **Type de test** | **Principe** | **Utilisation** |
| **Test variable simple** | 1 variable | Compare une variable à une valeur avec une condition logique (=, >, <) | Tester un seuil ou un état précis |
| **Test changement** **de variable** | 1 variable | Détecte une variation d’état ou de valeur (front montant, descendant ou toute modification) | Déclencher une action uniquement lors d’un changement |
| **Test variables multiples** **ET / OU** | Plusieurs variables | Combine plusieurs variables avec une logique booléenne ET / OU | Valider une condition basée sur plusieurs états |
| **Test variable égale multiple** | 1 variable | Permet de définir plusieurs égalités possibles pour une même variable | Vérifier si une variable correspond à un ensemble de valeurs autorisées |
| **Bloc** | **Type d’action** | **Principe** | **Utilisation** |
| **On / Off / Flip** | Commande directe | Active, désactive ou inverse l’état d’une sortie instantanément | Pilotage simple d’un éclairage, relais ou équipement |
| **Tous les relais (On / Off / Flip)** | Commande globale | Applique une action (ON, OFF ou inversion) à l’ensemble des relais d’un module | Coupure générale, mise en marche globale, reset des sorties |
| **Impulsion cyclique** | Commande cyclique | Génère une succession d’impulsions ON/OFF selon un cycle paramétré (répétition dans le temps) | Signalisation lumineuse, alerte, clignotement |
| **On / Off après temporisation** | Commande temporisée | Exécute une action ON ou OFF après un délai défini | Extinction automatique, démarrage différé, temporisation d’équipement |
| **BSO** | Commande spécifique | Pilote des brise-soleil orientables avec gestion des positions et de l’orientation | Gestion de la lumière naturelle, confort thermique |
| **Ouvrants** | Commande spécifique | Permet de contrôler des équipements motorisés (ouverture, fermeture, arrêt) | Volets roulants, stores, fenêtres motorisées |
| **Bloc** | **Type d’action** | **Principe** | **Utilisation** |
|---|---|---|---|
| **Action variable** | Affectation | Attribue directement une valeur à une variable (fixe ou issue d’une autre variable) | Initialisation d’un état, changement de mode (présence / absence) |
| **Valeur variables multiples** | Calcul / sélection | Détermine la valeur d’une variable à partir de plusieurs sources ou conditions | Gestion de logiques complexes, combinaison de plusieurs états (sécurité, confort, énergie) |
| **Incrémenter le compteur** | Calcul (addition) | Augmente la valeur d’une variable numérique d’un pas défini | Comptage d’événements, suivi d’occurrences |
| **Décrémenter le compteur** | Calcul (soustraction) | Diminue la valeur d’une variable numérique d’un pas défini | Décompte, gestion de cycles restants, temporisations logiques |
| **Ajouter variable à variable** | Calcul (addition entre variables) | Additionne deux variables et stocke le résultat dans une variable cible | Calcul de totaux, cumul de consommations, agrégation de données |
| **Bloc** | **Type d’action** | **Principe** | **Utilisation** |
|---|---|---|---|
| **Retour début** | Boucle / réinitialisation | Renvoie l’exécution du scénario au premier bloc | Répétition continue, redémarrage du scénario |
| **Saut avec retour** | Saut avec mémorisation | Redirige vers un bloc cible tout en mémorisant le point de départ | Appel de sous-séquences avec retour au flux principal |
| **Retour empilé** | Retour de pile | Revient au dernier point mémorisé par un “Saut avec retour” | Retour automatique après exécution d’un sous-scenario |
| **Saut aléatoire** | Branchement aléatoire | Redirige vers un bloc cible choisi aléatoirement parmi plusieurs | Scénarios dynamiques, comportements variables |
| **GoTo ciblé** | Saut direct | Redirige directement vers un bloc précis défini | Branchements logiques et navigation dans le scénario |
Bonnes pratiques : - Toujours vérifier l’état de régulation avant activation - Éviter les démarrages/arrêts répétés rapides - Associer la régulation à des conditions claires (horaires, présence, consigne) - Documenter les scénarios utilisant ces blocs pour faciliter la maintenance
| **Bloc** | **Type d’action** | **Principe** | **Utilisation** |
|---|---|---|---|
| **Démarrer la régulation** | Activation | Lance un processus automatique de régulation sur un équipement ou une zone définie | Mise en service d’un chauffage, contrôle de température ou d’humidité |
| **Arrêter la régulation** | Désactivation | Stoppe le processus de régulation en cours | Arrêt manuel ou automatique d’un système de régulation |
une fois que la commande est lancée dans un scénario, il n'est pas possible de l'annuler ni de la redémarrer
Paramétrage : - Sélection de la variable timer et du scénario - Configuration de la valeur et du délai (en ms) Utilisation : - Mesure de durée d’un événement - Suivi d’un temps d’activation ##### 7.3- Test timer Ce bloc permet de **tester la valeur d’un timer afin de conditionner le scénario**. Paramétrage : - Sélection du timer - Condition de test (supérieur, égal, inférieur à une valeur) Fonctionnement : - Compare la valeur du timer à une consigne - Oriente le scénario selon le résultat du test Utilisation : - Déclenchement d’actions après un délai - Surveillance de durées maximales ##### 7.4- Arrêter le timer Ce bloc permet de **stopper l’évolution d’un timer actif**. Paramétrage : - Sélection du timer Fonctionnement : - Le comptage temporel est figé - La valeur actuelle est conservée Utilisation : - Fin de mesure de durée - Arrêt conditionnel d’un chronométrage ##### 7.5- Réinitialiser le timer Ce bloc permet de **remettre un timer à zéro**. Paramétrage : - Sélection du timer Fonctionnement : - La valeur du timer est réinitialisée - Le timer revient à son état initial Utilisation : - Réinitialisation de cycle - Préparation à une nouvelle mesureBonnes pratiques : - Nommer clairement les timers selon leur fonction (ex : `Timer_Presence`, `Timer_Delai_Sortie`) - Éviter les démarrages multiples simultanés d’un même timer - Toujours réinitialiser les timers avant réutilisation dans un nouveau cycle - Combiner les timers avec des tests pour structurer les scénarios
| **Bloc** | **Type d’action** | **Principe** | **Utilisation** |
|---|---|---|---|
| **Pause** | Temporisation | Interrompt l’exécution du scénario pendant une durée définie, puis reprend automatiquement | Création de délais entre actions, séquences différées |
| **Variable Timer** | Mesure / temporisation | Déclenche ou met à jour une variable Timer après un délai, permettant de suivre une durée | Mesure d’un temps d’événement, suivi d’une durée d’activation |
| **Test Timer** | Condition temporelle | Compare la valeur d’un Timer à une consigne (>, <, =) pour orienter le scénario | Déclenchement conditionnel basé sur un temps écoulé, contrôle de durée maximale |
| **Arrêter le Timer** | Stop | Stoppe l’évolution d’un Timer tout en conservant sa valeur actuelle | Fin de chronométrage, gel d’une mesure en cours |
| **Réinitialiser le Timer** | Remise à zéro | Remet un Timer à zéro et restaure son état initial | Redémarrage de cycle, préparation d’une nouvelle mesure |
| **Bloc** | **Type d’action** | **Principe** | **Utilisation** |
|---|---|---|---|
| **Début** | Point d’entrée | Définit le point de départ du scénario lorsqu’il ne commence pas au bloc n°1 | Organisation du démarrage du scénario et redirection vers un bloc spécifique |
| **Label** | Repère / saut | Définit un point de repère permettant de sauter directement vers un bloc sans liaison physique | Simplification des scénarios et accès direct à une étape donnée |
| **Test heure** | Condition horaire | Déclenche ou conditionne un scénario à une heure définie (journalier) | Automatisation quotidienne à heure fixe |
| **Test coucher / lever** | Condition astronomique | Compare l’exécution du scénario aux heures de lever et coucher du soleil avec offsets | Gestion jour/nuit, éclairage extérieur, scénarios liés à la luminosité |
| **Envoyer** **un mail** | Notification | Envoie un e-mail avec destinataire, sujet et contenu | Alertes, notifications, rapports automatiques |
| **Envoyer** **un SMS** | Notification | Envoie un SMS vers un ou plusieurs numéros avec un message défini | Alertes urgentes et notifications en temps réel |
**Les timers** permettent de gérer les temporisations **à l'intérieur d'un scénario**. Ils interviennent dans la logique d'exécution en introduisant des délais, des temporisations ou des actions différées entre les différentes étapes du scénario
**La planification**, permet de définir **quand un scénario doit être exécuté**. Elle sert à programmer le lancement automatique d'un scénario selon un calendrier (heure, jour, date, etc ...)
### 2- Configurer un "Timer" dans un scénario Les scénarios permettent l’utilisation de **10 créneaux de temporisation (timers)** maximum par scénario. Ces timers servent à exécuter des actions à intervalles réguliers ou différés. Pour chaque timer disponible, trois éléments doivent être configurés : #### 2.1-Nom du "Timer" Champ libre permettant d’identifier le Timer dans le scénario. *Il est recommandé d’utiliser un nom explicite lié à la fonction.* **Exemples :** - Surveillance chauffage - Relance éclairage - Contrôle présence #### 2.2- Intervalle Définit la périodicité d’exécution du timer. - Unité : secondes - Le timer se déclenche à chaque intervalle écoulé **Exemples :** - 10 → exécution toutes les 10 secondes - 60 → exécution toutes les minutes #### 2.3- Étape cible Correspond à l’étape du scénario exécutée lors du déclenchement du Timer. Cette étape peut être : - une action - un test logique - une séquence de blocs > **Contrairement aux planifications, qui déterminent les dates et heures d'exécution d'un scénario, les Timers sont utilisés au sein même des scénarios pour gérer des plages horaires, des délais ou des temporisations. Ils permettent d'ajouter une logique temporelle sans avoir à créer de planification dédiée** ## 3. Fonctionnement Une fois activé dans le scénario : - le timer démarre automatiquement selon sa configuration - à chaque échéance, il exécute l’étape cible définie - plusieurs timers peuvent fonctionner simultanément dans un même scénarioBonnes pratiques : - Donner des **noms explicites** à chaque timer pour faciliter le débogage - Limiter les intervalles très courts afin d’éviter une surcharge de traitement - Bien associer chaque timer à une étape précise pour garder un scénario lisible - Eviter les doublons de timers pour des fonctions identiques
# Scénarios modèles Contrairement aux scénarios préconfigurés qui sont installés par défaut sur le module et peuvent être utilisés immédiatement, les **scénarios modèles** doivent être téléchargés depuis le serveur distant. Une fois importé sur le module, un scénario modèle peut être utilisé tel quel ou bien modifié afin de répondre aux besoins spécifiques de l'installation. Les scénarios modèles couvrent les **cas d'usage les plus courants** et constituent une solution rapide pour tester les entrées/sorties (I/O), les relais ou certaines fonctions du système. Ils intègrent déjà les variables, les widgets et la logique de fonctionnement nécessaires, ce qui permet une **mise en œuvre rapide** sans avoir à créer un scénario à partir de zéro. Ils représentent également un excellent support d'apprentissage pour découvrir l'environnement 2PIO, comprendre la structure d'un scénario et se familiariser avec les différents blocs de fonction disponibles.Objectif des scénarios modèles : - Vérifier le bon câblage des entrées et des sorties - Tester le fonctionnement des relais - Valider la communication entre les modules - Faciliter la mise en service
## 1. Scénarios modèles disponibles Les scénarios préconfigurés sont fournis afin de simplifier la mise en service, les tests fonctionnels et le diagnostic des modules. Ils couvrent les cas d’usage standards liés aux entrées, aux relais et à la connectivité. ### 1.1- Scénario variables**Usage :** - ???
### 1.2- Scénario ouvrant**Usage :** - ???
### 1.3- Scénario Test**Usage :** - ???
### 2. Importer un scénario modèle 1. **Accéder au menu Scénario** Depuis l’interface, ouvrez le menu Scénario 2. Importer un scénario Cliquez sur **Importer un scénario**, puis sélectionnez **Import distant** 3. Sélectionner le type d'import Choisissez import local ou import distant 4. Sélectionner le scénario à importer dans la liste des scénarios modèles disponibles 5. Choisir la destination - **Remplacer** : remplace un scénario existant du module - **Créer** : génère un nouveau scénario sans affecter les existants 6. Finaliser l’importation Cliquez sur **Importer** pour charger le scénario dans votre interface Un redémarrage du système est nécessaire afin de prendre en compte la mise à jour du scénario. Après redémarrage : - le scénario apparaît dans le bandeau latéral situé à gauche de l’écran, - les variables, blocs de fonction et widgets associés sont automatiquement disponibles.**Avantages d'un scénario modèle :** - Mise en place immédiate - Logique déjà validée - Réduction du risque d’erreur
### [3- Modifier un scénario modèle](https://modlink.fr/help/books/2-pio/page/scenarios-modeles "Scénarios modèles") - Dupliquer un scénario modèle pour créer un scénario personnalisé - Permet d’adapter la logique aux besoins spécifiques de l’application - **Modifications courantes :** - Ajout de temporisation ou délai anti-rebond - Inversion logique (1 → OFF, 0 → ON) - Ajout de conditions supplémentaires (ex. seuils, état réseau, watchdog) Voir [Créer un scénario personnalisé](https://modlink.fr/help/link/213#bkmrk-page-title) # Créer un scénario personnaliséPour créer ou modifier un scénario, il est **recommandé d’utiliser un ordinateur**. *L’édition sur téléphone peut entraîner des problèmes d’affichage ou une visibilité limitée des paramètres avancés*
### 1- Généralités Les scénarios personnalisés permettent d'adapter le fonctionnement du module à des besoins spécifiques qui ne sont pas couverts par les scénarios préconfigurés ou les scénarios modèles. Ils offrent une grande souplesse pour automatiser des actions en fonction d'événements, de mesures, d'états ou de conditions définies par l'utilisateur.Avant de commencer un scénario, assurez-vous que : - vous disposez des **droits d'accès** nécessaires - les **entrées et sorties** sont correctement configurées dans la section « I/O » - les **variables associées** sont bien définies
Disposez les blocs de manière **ordonnée** pour que le f**lux reste clair et lisible** *cela facilitera la compréhension et la maintenance du scénario*
chaque scénario doit former une **boucle fonctionnelle complète** : **entrée → test / logique → sortie / action → mise à jour variable d’état**
Il est impératif de refermer la boucle fonctionnelle : toute commande générée par un bloc de sortie doit avoir un impact sur un état ou une variable réutilisable par un bloc d’entrée, garantissant ainsi un fonctionnement cohérent du scénario. Un scénario est structuré sous forme de boucles logiques : 1. Entrée dans une boucle 2. Tests (servant de déclencheurs) 3. Tests de conditions 4. Actions 5. Retour - dans la même boucle - dans une autre boucle - reliez les blocs entre eux pour définir la logique de fonctionnement du scénario, identifier les points de connexion (ronds de couleur) - chaque bloc possède des entrées et des sorties - Relier les blocs entre eux Cliquez sur la sortie d’un bloc et faites glisser vers l’entrée du bloc suivant. Reliez la sortie du bloc aux actions à exécuter si la condition est vraie et éventuellement à une autre sortie si la condition est fausse \- Vérifier la logique, les paramètres et les liaisons (assurez-vous que le flux respecte la séquence souhaitée et que tous les blocs nécessaires sont connectés) - Vérifier que le scénario forme une boucle complète ##### 2.3.5- Tester le scénario Sauvegardez votre scénario et redémarrez le module pour synchroniser les scénarios et appliquer les modifications. Testez le comportement du scénario via les widgets ou les entrées physiques reliées**Un **redémarrage**** du module est nécessaire pour appliquer un nouveau scénario
Les **scénarios modèles** couvrent les cas d'usages les plus courants, ce sont des outils rapides et fiables pour tester les I/O et les relais. Ils permettent de tester rapidement le fonctionnement du système sans avoir à créer une logique de commande complète. Ces scénarios **peuvent être utilisés tels quels,** **ou bien modifiés** pour réponde à des besoins spécifiques.
## 1. Scénarios modèles disponibles Les scénarios modèles sont fournis afin de simplifier la mise en service, les tests fonctionnels et le diagnostic des modules. Ils couvrent les cas d’usage standards liés aux entrées, aux relais et à la connectivité. ## 1.1 Test des entrées (Inputs) ### Lecture d’entrée - Surveillance de l’état d’une entrée digitale - Affichage temps réel de l’état (0 / 1) - Historisation des changements d’état**Usage :** - Validation du câblage - Test capteur, bouton, contact sec
## 1.2 Test des relais (Outputs) ### Commande manuelle de relais - Activation / désactivation manuelle d’un relais - Commande depuis l’interface**Usage :** - Test du relais - Validation actionneur (lampe, moteur, contacteur)
### Commande temporisée de relais - Activation du relais pendant une durée définie - Retour automatique à l’état OFF**Usage :** - Test de temporisation - Simulation d’impulsion
## 1.3 Test Entrée → Relais (I/O binding) ### Entrée digitale → relais (mode suivi) **Scénario standard** - Entrée = 1 → relais ON - Entrée = 0 → relais OFF**Usage :** - Test complet DI/DO - Validation bout-en-bout - Commissioning
### Entrée digitale → relais (logique inversée) - Entrée = 1 → relais OFF - Entrée = 0 → relais ON**Usage :** - Cas de sécurité - Adaptation logique terrain
## 1.4 Scénarios conditionnels ### Seuil sur entrée analogique - Si valeur > seuil → activer relais - Si valeur < seuil → désactiver relais**Usage :** - Alarmes - Régulation simple
### Entrée → relais avec temporisation - Entrée = 1 - Délai configurable - Activation relais**Usage :** - Anti-rebond - Séquencement simple
## 1.5 Scénarios de connectivité et supervision ### Test de connectivité réseau - Vérification connexion Wi-Fi / Ethernet - Test ping ou heartbeat - Remontée état connecté / déconnecté**Usage :** - Diagnostic réseau - Validation accès plateforme
### Heartbeat / watchdog - Envoi périodique d’un message de vie - Mise en sécurité du relais en cas de perte de communication**Usage :** - Sécurité - Supervision industrielle
# Widgets # Widgets d'exploitation Les widgets sont des éléments de l’interface Web du module 2PIO qui permettent aux opérateurs et aux utilisateurs finaux de **piloter les équipements et de visualiser leur état**, directement depuis le tableau de bord. Associés aux variables du module, ils permettent d’**envoyer des commandes, de consulter des états ou d’afficher des mesures,** sans avoir à accéder directement aux variables ou aux scénarios. ### 1 – Types de widgets Différents widgets sont disponibles selon les besoins de l’installation : - **Interrupteur** : commande marche/arrêt d’un équipement - **Switch à glissière** : sélection entre plusieurs états ou modes de fonctionnement - **Variateur** : réglage d’une valeur sur une plage définie - **Variateur d’ouvrant** : commande de la position d’un ouvrant (volet, brise-soleil orientable…) - **Capteur** : affichage d’une mesure ou d’une valeur - **Voyant d’état** : visualisation de l’état d’une variable (marche/arrêt, défaut, alarme…) - **Régulation** : pilotage d’un équipement à partir d’une consigne et d’une mesure Les widgets disponibles permettent ainsi de créer une interface adaptée aux besoins de pilotage et de consultation de l’installation. ### 2 – Liaison avec les variables Chaque widget est associé à une ou plusieurs variables du module, en local ou à distance. Selon son type et les variables utilisées, il permet de consulter une information, de transmettre une commande ou d’assurer ces deux fonctions. ### 3- Accès direct aux widgets en mode application sur smartphone L’interface Web du module 2PIO peut être utilisée en mode application sur smartphone. Une icône placée sur l’écran d’accueil permet d’accéder rapidement à la page Widgets, sans avoir à ouvrir le navigateur et à saisir l’adresse du module. L’utilisateur peut sélectionner l’option *« Rester connecté »* pour conserver sa session et accéder plus rapidement aux widgets lors des utilisations suivantes. Pour découvrir les étapes d’installation et d’utilisation, consultez la page :[ accès en mode application sur smartphone](https://modlink.fr/help/link/211#bkmrk-3--acc%C3%A8s-en-mode-app) # Gestion des widgets Les widgets sont administrés depuis la page d'accueil du tableau de bord en cliquant le bouton **Gérer les widgets**, ou directement depuis le menu *"Widgets".* Ce gestionnaire permet d'ajouter, de modifier, de réorganiser et de supprimer les widgets. ### 1- Créer un widgetLa création de widgets est réservée aux utilisateurs disposant des droits appropriés
1. 1. Apuyez sur + Ajouter un widget 2. Une nouvelle fenêtre s'ouvre, configurez les paramètres du widget : - **Nom** du widget ; - **Variable d'entrée** associée ; - **Scénario** à associer (si applicable) ; - **Type de widget**. Les autres champs sont facultatifs et permettent de personnaliser l'affichage du widget, notamment : - son **emplacement** ; - son **icône** ; - l'**unité** de la valeur affichée [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-28-130139.jpg) Le nouveau widget est alors ajouté au tableau de bord.Bonnes pratiques : - Limiter le nombre de widgets afin de conserver une interface lisible - Donner un nom explicite à chaque widget - Réserver les widgets techniques aux utilisateurs expérimentés - Consultez régulièrement les widgets d'état pour contrôler le bon fonctionnement du système et détecter rapidement toute anomalie
#### 1.1- Modifier ou supprimer un widget Une fois le widget créé, vous pouvez à tout moment le modifier ou le supprimer - - Pour **modifier** un widget, cliquez sur l'icône **Modifier**, apportez les modifications souhaitées, puis enregistrez-les - [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-30-142750.jpg) - Si vous n'avez plus besoin d'un widget, cliquez sur l'icône **Supprimer**, puis confirmez l'opération Le widget est alors retiré du gestionnaire et ne sera plus affiché sur le tableau de bord [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-30-130927.jpg) ## 2- Configurer les mappages d'état et d'action**Le mappage d'état** permet de **personnaliser l'affichage des widgets d'état** en associant à chaque valeur d'une variable une **icône**, une **couleur** et un **libellé**. *Il permet ainsi de représenter visuellement les différents états de la variable de manière adaptée à votre application*
**Le mappage d'action** permet d'**associer chaque valeur lue à la commande de sortie** à exécuter. *Le **libellé** décrit l'action qui sera envoyée lorsque cette valeur est sélectionnée ou reçue*
- Pour définir le mappage, cliquez sur l’icône **Réglages** du widget Une fenêtre de configuration s’ouvre [](https://modlink.fr/help/uploads/images/gallery/2026-07/vjvcapture-decran-2026-07-28-173733.jpg) - Pour ajouter une correspondance, cliquez sur **Ajouter un état / Ajouter un mappage** (selon le type de widget) [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-30-113417.jpg) - Cliquez sur chaque état / action nouvellement créé pour saisir les paramètres de configuration [](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-30-115244.jpg) - Paramétrez un affichage visuel pour chaque état configuré - **Icône** : symbole affiché dans le widget ; - **Couleur** : couleur associée à cet état ; - **Libellé** : texte affiché pour identifier l’état - Paramétrez un libellé personnalisé pour chaque action configurée [](https://modlink.fr/help/uploads/images/gallery/2026-07/DXJcapture-decran-2026-07-30-120040.jpg)Le mappage est prioritaire sur la configuration générale des états. Lorsqu’un état possède un mappage personnalisé, ses paramètres d’affichage remplacent ceux définis dans la configuration des états
### 3- Outils de gestion des widgets Dépliez le widget pour afficher l'ensemble des informations, notamment tous les états associés Plusieurs fonctions facilitent également l'administration des widgets. Vous pouvez rechercher un widget, le filtrer selon son type, réorganiser son affichage, l'exporter ou l'importer afin de simplifier sa gestion et son déploiement. - **Rechercher un widget** Permet de retrouver rapidement un widget en saisissant tout ou partie de son nom dans le champ de recherche - **Filtrer les widgets** Permet d'afficher uniquement les widgets d'un type donné (interrupteur, interrupteur à glissière, bouton, widget d'état, etc.) afin de faciliter leur gestion - **Réorganiser les widgets** Permet de modifier l'ordre d'affichage des widgets dans le gestionnaire ou sur le tableau de bord - **Exporter des widgets** Permet d'exporter un ou plusieurs widgets afin de les sauvegarder ou de les réutiliser sur une autre installation - **Importer des widgets** Permet d'importer des widgets afin de les intégrer rapidement dans une nouvelle configuration # Widgets préconfigurés Les widgets préconfigurés sont fournis par défaut avec le système afin de faciliter la mise en service et l’exploitation de l’installation. Ils permettent d’afficher et de piloter rapidement les principales fonctions du module sans nécessiter de configuration avancée. Ils apparaissent sur la page d’accueil du tableau de bord ou bien depuis le menu Widget. Les widgets préconfigurés peuvent être utilisés tels quels ou adaptés selon les besoins de l’installation et les autorisations accordées à l’utilisateur. #### 1- Widgets disponibles Deux widgets préconfigurés sont disponibles par défaut : - un widget de type **switch ON/OFF** permettant le pilotage d’une sortie bistable - un widget de type **bouton** permettant l’envoi d’une commande impulsionnelle Ces widgets permettent une mise en service rapide des fonctions de commande principales sans configuration supplémentaire. L’accès, la création et la modification des widgets dépendent des droits attribués à l’utilisateur ainsi que de son rôle. # Planification La planification permet d'automatiser l'exécution des scénarios selon des dates, des horaires ou des périodes prédéfinis. Elle offre une gestion centralisée des **plages de fonctionnement récurrentes** pouvant être utilisées par un ou plusieurs scénarios. **Par exemple :** - **Tous les jours à 08h00** - **Du lundi au vendredi à 18h00** - **Les jours fériés à 10h00** # Généralités **La planification** permet de programmer l'exécution automatique d'un scénario à des dates et heures définies. Elle permet de déclencher un scénario selon un calendrier, de manière ponctuelle ou récurrente, sans intervention de l'utilisateur. Les événements peuvent être programmés selon différentes périodicités : - quotidienne - hebdomadaire - mensuelle - annuelle Il est également possible d’adapter les programmations en fonction du type de jour : - Jours ouvrés - Jours fériés - Périodes spéciales (vacances, fermetures exceptionnelles ...) Cette flexibilité permet de créer des planifications adaptées aux besoins récurrents comme aux situations particulières. Les actions configurées dans ce menu sont **exécutées automatiquement** par le module aux **dates et heures définies**.Contrairement aux **timers**, qui gèrent des délais ou des temporisations directement au sein d'un scénario, les programmations horaires sont configurées indépendamment et peuvent être réutilisées par plusieurs scénarios
# Créer une planification, un jour férié ou un calendrier spécial En bas de page, le bouton "*+ Ajouter*" permet de créer : - une **nouvelle programmation** - un **jour férié** - une **période spéciale** (vacances, fermeture exceptionnelle, maintenance ...) Les jours fériés et les périodes spéciales peuvent être pris en compte dans les règles de planification afin d'adapter automatiquement le comportement du module à ces périodes particulières. [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-19-154555.jpg) ### 1- Ajouter une nouvelle programmation Sélectionnez l'onglet "*Programmations*", cliquez sur le bouton "*+Ajouter***"** Renseignez les informations demandées dans la fenêtre qui s'affiche [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-19-143351.jpg) - **Libellé** de la programmation - **Type de jour** (classique ou jour férié) - **L'heure de déclenchement** - **Type de récurrence** (quotidienne, hebdomadaire, mensuelle ou annuelle) - **Sélectionnez les jours concernés** - **Horaire d'exécution** - **Scénario à exécuter** - **Variable à mettre à jour** - La **valeur à appliquer** lors du déclenchement de l'événement Une fois enregistrée, la programmation sera exécutée automatiquement par le module aux dates et horaires définis. ### 2- Ajouter un jour férié Dans l'onglet "*jours fériés"*, il est possible d'ajouter de nouveaux jours fériés en cliquant sur le bouton "*+ Ajouter"*. Renseignez les informations demandées dans la fenêtre qui s'affiche. [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-19-153834.jpg) Les jours fériés préconfigurés sont fournis par défaut avec le système et ne peuvent pas être supprimés. Ils peuvent néanmoins être **désactivés** à tout moment depuis la liste des jours fériés afin d'adapter le calendrier aux besoins de l'installation. ### 3- Ajouter une période spéciale Depuis l’onglet *« Période spéciale »*, il est possible de définir des périodes particulières (par exemple, les vacances). Pour cela, cliquez sur *« + Ajouter »*, puis renseignez les informations dans la fenêtre qui s’ouvre.L'utilisation d'une entrée en **mode analogique** nécessite une configuration préalable dans le menu *« I/O ».* L'option *« Séparer en 2 entrées A et B »* requiert un **câblage spécifique du capteur** [Câblage d'une entrée analogique en mode double canal](https://modlink.fr/help/link/179#bkmrk--4)
#### 1.2- Etat des relais Par défaut, les relais 1 et 2 sont éteints au démarrage du module. Pour modifier la configuration par défaut des relais, - accédez au menu **Paramètres > Informations > Sorties** - puis, dans le menu "**État par défaut des relais"**, définissez l'état à appliquer au prochain démarrage. La modification sera effective après un redémarrage du module. ### 2- Vérifier le fonctionnement des entrées et sorties Le **câblage des entrées et des sorties** peut être vérifié directement sur le module à l'aide des voyants d'état [Etat des voyants](https://modlink.fr/help/link/179#bkmrk-%C2%A0) . Ceux-ci permettent de contrôler visuellement l'activation des entrées et des relais et constituent un moyen simple de valider les raccordements réalisés avant toute phase de configuration ou de mise en service. Le menu *« I/O »* permet de **contrôler en temps réel l'état** des entrées et des sorties du module à travers **les variables associées.** Lorsqu'une action est effectuée sur une entrée - par exemple en réalisant une boucle ou en activant un contact - la valeur de la variable correspondante est mise à jour instantanément dans l'interface. Cette visualisation permet de vérifier rapidement le bon fonctionnement de l'entrée et de valider sa configuration. De la même manière, l'état des sorties peut être observé afin de confirmer leur activation ou leur désactivation et de faciliter les opérations de mise en service et de diagnostic. [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-12-151418.jpg) # Gestion des comptes utilisateursLe système permet de créer jusqu’à **5 comptes "Installateur"** et **10 comptes "Utilisateur"**
#### Permissions et accès aux pages Les droits d’accès reposent sur deux éléments complémentaires : - **Les permissions** définissent les actions autorisées, comme la modification des variables, la gestion des scénarios ou la mise à jour du firmware. - **Les accès aux pages** déterminent les rubriques de l'interface Web que le compte est autorisé à consulter.Le rôle sélectionné ne détermine donc pas, à lui seul, l'ensemble des droits du compte. Les **permissions** et les **accès aux pages** permettent d'adapter ces droits aux responsabilités de chaque utilisateur
l'accès aux fonctions du menu « Paramètres » dépend du rôle et des permissions attribués au compte connecté
### 1- Créer un compte Dans la fenêtre "créer un utilisateur" 1. Renseignez un **identifiant** et un **mot de passe** 2. Sélectionnez le rôle souhaité : **Installateur** ou **Utilisateur** 3. Sélectionnez les **permissions** à accorder et les **pages** auxquelles le compte pourra accéder 4. Cliquez sur **Créer l'utilisateur** [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-04-174055.jpg) #### cas particulier du compte installateur : La création d'un compte Installateur nécessite des droits spécifiques. Par défaut, seules les **permissions minimales** prévues pour ce profil sont activées : \- la mise à jour du firmware \- le changement de nom d'un appareil \- uen connexion OPC UA Aucun autre accès aux pages de l'interface n'est accordé tant qu'il n'a pas été **explicitement autorisé par l'utilisateur disposant des droits nécessaires**.**Bonnes pratiques :** - accordez uniquement les permissions et les accès nécessaires à chaque utilisateur - standardisez les rôles et limitez les droits administratifs - vérifier régulièrement les comptes existants et supprimez ceux qui ne sont plus utilisés
### 2- Afficher les comptes La **liste des comptes utilisateurs** apparaît directement sous le bloc de création d'un utilisateur. Elle permet de consulter les comptes existants ainsi que les informations disponibles sur leurs rôles et leurs droits d'accès. [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-11-121359.jpg) ### 3- Modifier un compteLes actions disponibles dépendent des droits attribués au compte connecté
Selon les autorisations disponibles, il est possible de modifier les informations et les droits d'un compte utilisateur, notamment - son identifiant - son mot de passe - son rôle - ses permissions - les pages auxquelles il peut accéder ### 4- Supprimer un compte La suppression d'un compte est réservée aux utilisateurs disposant des droits nécessaires. Cette **opération est** **définitive** : le compte supprimé ne peut plus être utilisé pour accéder à l'interface Web du module. # Modifier la configuration WiFi ### 1- Le module est toujours connecté à Internet Si le module est encore connecté au réseau Wi-Fi et accessible depuis l'interface, la modification de la configuration Wi-Fi peut être réalisée directement depuis les paramètres du module. Accédez au menu "*Paramètres***"**, puis à l'onglet "*Connectivité",* dans la section "Connexion Internet" cliquez sur le bouton "*Configurez*" Vous pourrez alors scanner les réseaux WiFi à proximité, en sélectionner un nouveau puis renseigner les informations de connexion correspondantes. [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-22-162120.jpg) ### [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-22-163644.jpg) ### 2- Le module n'est plus connecté à InternetLe voyant Wi-Fi du module clignote en vert s'il n'est plus connecté à Internet
Si le module n'est plus connecté au réseau Wi-Fi (suite à un changement de box Internet, à la modification du mot de passe ou encore au déplacement du module ...), alors **il n'est pas possible de modifier la configuration à distance.** La nouvelle configuration Wi-Fi devra être réalisée en local afin de reconnecter le module au réseau. - Activez le Wi-Fi dans les paramètres de l'appareil utilisé pour la configuration du module (Smartphone, ordinateur, tablette ...) - Dans la liste des réseaux sans fils disponibles, sélectionnez celui du module que vous voulez configurer. Le SSID du module apparait sous la forme "***2pioXXXX**"* un message "réseau non sécurisé peut s'afficher et c'est normal. Une fenêtre peut apparaître aussi pour indiquer que le réseau Wi-Fi sélectionné n'est pas connecté à Internet ; il faut rester en Wi-Fi et conserver la connexion - Si la connexion est validée, le réseau 2pioXXXX apparait comme étant le réseau actif avec les informations "connecté sans internet / non sécurisé" (comportement normal) - Connectez-vous en local à l'interface Web du module **2pioXXX.local** Une fois connecté, allez dans le menu « *Paramètres* », cliquez sur l’onglet « *Connectivité* » puis dans la section « *Connexion Internet* », appuyer sur le bouton « *Configurer* » [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-25-143757.jpg) - Cliquez ensuite sur "*Scanner les réseaux*" [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-25-142635.jpg) - La liste des réseaux disponibles s'affiche en bas de page Sélectionnez le réseau que le module utilisera pour se connecter *Vérifiez que la qualité du signal réseau est suffisante pour garantir une connexion stable du module (à minima 25 %)* - Saisissez le mot de passe du réseau puis appuyez sur "*Appliquer*" pour valider la configuration *Le voyant "Wi-Fi mode" passe en rouge (connecté à Wi-Fi) puis en violet fixe (tunnel SSH actif).* *S'il y a un problème de connexion au Wi-Fi (erreur de mot de passe ou signal faible), alors le voyant continue de clignoter en vert et la page "portail captif" devrait de nouveau s'afficher* *[](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-25-142731.jpg)*Le module devient **accessible à distance** une fois la configuration du Wi-Fi effectuée. *Il cesse alors de fonctionner en mode point d'accès (routeur) et n’apparaît plus sur la liste des réseaux disponibles*
Pour la **connexion à distance**, 2PIO peut utiliser : - le réseau Wi-Fi local - un réseau Wi-Fi indépendant (souvent dédié aux IoT) - un routeur 4G*Attention* : Le module utilise exclusivement les paramètres Wi-Fi enregistrés lors de la configuration initiale (SSID et mot de passe). En cas de modification du SSID et/ou du mot de passe du réseau, **la reconnexion automatique ne sera plus possible** et une reconfiguration du module sera requise **réseau local dédié = plus de sécurité** *fonctionne même en cas de changement des paramètres du réseau Wi-Fi local*
# Ouvrants / BSO Le pilotage des **ouvrants motorisés** (volets roulants, rideaux métalliques, stores...) et des **BSO** nécessite un paramétrage préalable dans le menu "Paramètres" > "Informations" > "Sorties". Lors de cette configuration, **le module crée automatiquement les variables nécessaires** au pilotage de l'actionneur. Ces variables sont ensuite disponibles dans les scénarios. [](https://modlink.fr/help/uploads/images/gallery/2026-07/image.png)lorsqu'une paire de **relais est affectée à une configuration "BSO ou Ouvrant"**, ces deux relais sont réservés au pilotage de cet actionneur et ne peuvent plus être utilisés par d'autres scénarios ou fonctions
Les ouvrants motorisés peuvent être équipés de **fins de course réglables** intégrées au moteur. Si ce n'est pas le cas, il est possible d'installer des **butées de fin de course** afin de définir précisément les positions d'ouverture et de fermeture
### 1- Créer une nouvelle configuration 1. Saisissez un **nom de configuration** permettant d'identifier facilement l'actionneur (par exemple : *BSO Salon*, *Volet bureau*, *Store Terrasse*) 2. Sélectionnez le **mode de fonctionnement** : - **Relais** : utilisation classique des sorties sans gestion d'ouvrant - **Ouvrant** : pilotage d'un volet roulant, d'un store ou de tout autre ouvrant motorisé - **BSO** : pilotage d'un brise-soleil orientable avec gestion de l'orientation des lames 3. Un **ID technique** est automatiquement généré à partir du nom de la configuration. Cet identifiant est utilisé dans les blocs de scénario via le paramètre `config_id` 4. Sélectionner le **relais utilisé pour le haut et pour le bas** 5. Si l'option "**Butées**" est activée, indiquez les entrées raccordées aux butées haute et basse 6. Dans les champs "*Extra montée"* et "*Extra descente"* indiquez un **décalage temporel** en millisecondes afin d'ajuster précisément les positions d'ouverture et de fermeture 7. Une fois la configuration terminée, cliquez sur **Enregistrer** pour la sauvegarder dans le module. Vous pouvez également **exporter** les configurations au format JSON afin de les sauvegarder ou de les réutiliser sur un autre module, ou **importer** un fichier JSON existant pour restaurer ou compléter les configurations. La liste des configurations enregistrées s'affiche en bas de page. Il est possible de sélectionner une configuration pour la modifier, la recalibrer ou la supprimer ### 2- Centralisation des ouvrants La centralisation permet de **piloter simultanément plusieurs ouvrants** à l'aide d'une seule commande. Cette fonction est particulièrement utile pour ouvrir ou fermer l'ensemble des ouvrants d'un bâtiment, d'un étage ou d'une zone, sans avoir à les commander individuellement. Les ouvrants peuvent être centralisés de deux façons : - à l'aide d'un widget Position/Stop - à l'aide d'un scénario personnalisé #### 2.1- Centralisation à l'aide d'un widget Le widget **Position/Stop** permet de commander simultanément tous les ouvrants appartenant au groupe de centralisation. Les ordres d'ouverture, de fermeture, de positionnement et d'arrêt sont automatiquement transmis à l'ensemble des ouvrants concernés. #### 2.2- Centralisation à l'aide d'un scénario La centralisation peut également être réalisée au moyen d'un scénario, ce qui permet d'adapter le comportement aux besoins de l'installation. Le principe consiste à utiliser l'ouvrant local (celui du module exécutant le scénario) comme référence, puis à reproduire la même commande sur les autres ouvrants. Le scénario est construit de la manière suivante : 1. Tester l'état de l'ouvrant local à l'aide d'un bloc Test d'état 2. Déterminer la commande à exécuter en fonction de l'état détecté (ouverture, fermeture, arrêt, position, etc.) 3. Commander les autres ouvrants à l'aide du bloc "***Variable multiple***". Ce bloc envoie directement la commande aux autres ouvrants du groupe, sans vérifier leur état ou leur position actuelleseul l'état de l'ouvrant local est analysé. Les autres ouvrants reçoivent directement la commande correspondante afin de garantir une exécution rapide de la centralisation.
#### 2.3- Exclure un ouvrant du groupe de centralisation Il possible d'exclure un ou plusieurs ouvrants afin qu'ils ne répondent pas aux commandes de centralisation, tout en conservant leur pilotage individuel. L'ouvrant continuera à fonctionner normalement et pourra toujours être commandé individuellement ou par d'autres scénarios, mais il ne recevra plus les commandes envoyées au groupe de centralisation. Pour exclure un ouvrant : - accédez au menu Paramètres > Informations > Sorties - sélectionnez la variable "*Position**"*** de l'ouvrant concerné, puis cochez l'option *"Désactiver la variable"* # Cas d'usages De la surveillance industrielle à la gestion énergétique, en passant par la maintenance prédictive, le suivi environnemental ou encore le contrôle d'accès, les modules 2PIO s'adaptent à tous vos besoins # Gestion de deux pompes de relevageObjectif : Assurer la gestion automatisée de deux pompes de relevage en fonction du niveau d'eau dans un réservoir, avec alternance des pompes, fonctionnement en renfort et détection des situations de défaut. Le **2PIO assure localement et de manière autonome la gestion de l'installation**. Les informations provenant des capteurs de niveau sont traitées par un scénario qui pilote les pompes selon des seuils et des conditions de fonctionnement prédéfinis. L'automatisme est exécuté directement par le module, sans nécessiter de serveur central ni de service cloud. La communication avec un système tiers, notamment une GTB, peut être ajoutée pour la remontée des informations et le suivi de l'installation.
### Configuration - **Entrées :** capteurs de niveau d'eau et, selon l'installation, retours d'état ou informations de défaut des pompes - **Sorties :** relais de commande des deux pompes - **Variables :** mémorisation des états de fonctionnement, gestion de l'alternance et traitement des informations nécessaires à la détection des défauts - **Scénario :** gestion des seuils de démarrage et d'arrêt, de l'alternance des pompes, du fonctionnement simultané et des situations anormales - **Widgets :** visualisation des niveaux, des états des pompes et des éventuels défauts, avec accès aux commandes autorisées ### Principe de fonctionnement - **Surveillance du niveau :** le 2PIO surveille en continu le niveau d'eau dans le réservoir à partir des informations transmises par les capteurs raccordés - **Démarrage de la première pompe :** lorsque le niveau atteint le seuil de démarrage, le scénario active la pompe prioritaire selon la logique d'alternance définie - **Démarrage de la seconde pompe :** si le niveau continue de monter et atteint un second seuil, la deuxième pompe est également activée afin d'augmenter la capacité de relevage - **Alternance des pompes :** à chaque nouveau cycle, la pompe prioritaire change afin de répartir les durées d'utilisation et de limiter l'usure liée à un fonctionnement déséquilibré Cycle 1 : démarrage prioritaire de la pompe 1 Cycle 2 : démarrage prioritaire de la pompe 2 - **Gestion des défauts :** en cas d'anomalie détectée (absence de consommation, surconsommation ou défaut signalé par un équipement), le scénario peut déclencher une alerte et commander le basculement sur l'autre pompe, selon les conditions configurées. Des notifications peuvent être transmises par e-mail ou SMS. Les informations de défaut peuvent également être communiquées à une GTB ou à un système tiers. - **Exploitation et suivi :** l'interface Web du 2PIO permet, selon le niveau d'autorisation de l'utilisateur, de consulter en temps réél les informations de fonctionnement, notamment l'état des entrées, des sorties et des pompes, ainsi que les éventuels défauts. Les commandes disponibles permettent également d'intervenir sur l'installation dans les limites des droits attribués. ### Fonctionnement autonome et communication Le scénario est exécuté directement par le 2PIO et continue de fonctionner localement, indépendamment de la disponibilité d'une connexion Internet ou d'un système de supervision externe. La connexion à une GTB ou à un autre système tiers permet de remonter les états de fonctionnement et les alarmes pour leur exploitation centralisée, sans intervenir dans l'exécution de l'automatisme local. # Surveillance d'une chambre froide**Objectif :** Surveiller en continu la température d’une chambre froide et détecter rapidement une situation anormale
#### Fonctionnement - La température est analysée en continu via une sonde connectée au système - Des seuils sont définis afin d’identifier une température trop élevée ou toute autre situation nécessitant une intervention - L’état correspondant est affiché dans le widget - En cas de dépassement du seuil, une action ou une alerte peut être déclenchée selon la configuration par exemple : - supérieure à -17°C - inférieure à -20°C #### Action automatique : déclenchement d'alerte en cas d'anomalie Une alerte est déclenchée si la température sort de la plage définie : - un email d’alerte est envoyé automatiquement aux personnes concernées - l’information permet une intervention rapide pour sécuriser la chaîne du froid #### Configuration - Entrée : information provenant de la sonde ou du dispositif de mesure - Variable : température - Scénario : surveillance des seuils - Widget : affichage de la température et des états associés #### Résultat L’état de la chambre froide est facilement identifiable depuis l’interface d'administration et les situations anormales peuvent être détectées. # Redémarrage automatique de systèmes (watchdog)**Objectif :** Surveiller automatiquement le bon fonctionnement d’un équipement et provoquer son redémarrage en cas de dysfonctionnement, afin de limiter les interruptions de service et les interventions manuelles
- onduleurs, routeurs - serveurs - caméras IP - appareils intelligents - ordinateurs, postes de travail - ouvre-portes de parkings Le dispositif 2PIO surveille un signal attestant du bon fonctionnement de l’équipement. Si ce signal n’est plus détecté pendant le délai défini, il considère que l’équipement est potentiellement bloqué et déclenche automatiquement une séquence de redémarrage. #### Configuration - Entrée : signal de fonctionnement ou de présence de l’équipement à surveiller - Variable : mémorisation de l’état ou du signal de surveillance - Scénario : surveillance du signal et gestion du délai d’absence - Temporisation : durée d'absence du signal au delà de laquelle une anomalie est détectée - Sortie : commande permettant de couper puis de rétablir l’alimentation de l’équipement #### Fonctionnement 1. 2PIO surveille régulièrement le signal de fonctionnement de l'équipement 2. Tant que le signal est présent, l'équipement est considéré comme opérationnel 3. Si le signal reste absent au delà du délai configuré, 2PIO détecte une anomalie 4. 2PIO déclenche alors la séquence de redémarrage en commandant la sortie associée 5. L’alimentation est coupée pendant la durée définie, puis rétablie 6. l'équipement redémarre automatiquement 7. 2PIO reprend la surveillance du signal de fonctionnement #### Résultat Le système peut retrouver automatiquement un fonctionnement normal après un blocage, sans intervention sur site. 2PIO assure ainsi une **surveillance autonome et un redémarrage automatique des équipements**. > **Exemple : redémarrage automatique d’un équipement réseau** > 2PIO surveille périodiquement un équipement qui doit rester opérationnel en permanence. En l’absence du signal attendu pendant une durée définie, il coupe son alimentation puis la rétablit afin de provoquer son redémarrage. > Une fois le fonctionnement rétabli, la surveillance reprend automatiquement. # Système de secours et continuité de service**Objectif** : Garantir la continuité de service d’un équipement ou d’une installation en basculant automatiquement vers un système de secours en cas de défaillance du système principal
#### Configuration - Entrée(s) : informations permettant de surveiller l’état ou le bon fonctionnement du système principal - Variables : mémorisation et traitement des états nécessaires au contrôle - Scénario : détection d'une défaillance et gestion du basculement - Sorties : commande du système principal et du système de secours - Temporisation : définition du délai avant le déclenchement du basculement #### Fonctionnement 1. 2PIO surveille en permanence le fonctionnement du système principal 2. Tant que celui-ci fonctionne normalement, le système de secours reste en attente 3. En cas de défaillance, 2PIO détecte l’anomalie selon les conditions définies dans le scénario 4. A l'issue du délai configuré, 2PIO commande le basculement vers le système de secours 5. Le système de secours prend le relais afin d’assurer la continuité du service 6. Le retour au système principal peut être géré selon la configuration définie #### Résultat En cas de défaillance du système principal, 2PIO commande automatiquement le basculement vers le système de secours, limitant ainsi l’interruption de service et le besoin d’une intervention immédiate. # Maintenance Le menu **Maintenance** est accessible depuis **Paramètres > Informations** et permet d’accéder aux fonctions dédiées à la maintenance du module. # Redémarrer le système Le redémarrage permet de **relancer le système** du module afin d’appliquer certaines modifications de configuration et de réinitialiser les services en cours d’exécution. Pour redémarrer le module : 1. Dans le menu *"Paramètres"* accédez à *"Informations"* puis *"Maintenance"* 2. Dans *"Redémarrage* du système" appuyez sur le bouton "Redémarrer" [](https://modlink.fr/help/uploads/images/gallery/2026-09/capture-decran-2026-09-04-110728.jpg)Le redémarrage interrompt temporairement le fonctionnement du module. Les scénarios et les équipements pilotés sont donc momentanément indisponibles pendant cette opération
# Centre d'erreurs Le centre d’erreurs permet de consulter les erreurs détectées par le module afin d’identifier les éventuels dysfonctionnements et d’en faciliter le diagnostic. Le Centre d’erreurs affiche : - les erreurs **non acquittées** - le nombre **total d’erreurs** - les **erreurs critiques** - **l’état général de santé** du module - **l’historique** des erreurs Les erreurs affichées peuvent notamment concerner : - les scénarios - les variables - les entrées et sorties - la communication - le systèmeLorsqu’une erreur est détectée, la LED "Process information" clignote en rouge. En cas d'erreur critique, toutes les LEDS du module passent au rouge
Lorsqu'une erreur est détectée, un e-mail est automatiquement envoyé au **gestionnaire du compte** afin de l'en informer. L'adresse e-mail utilisée pour ces notifications est celle renseignée dans : **Paramètres > Informations > Profil > Gestionnaire** ### 1- Consulter les erreurs Depuis le menu Paramètres, accédez à **Informations >** **Maintenance > Centre d’erreurs** [](https://modlink.fr/help/uploads/images/gallery/2026-09/capture-decran-2026-09-04-111042.jpg) La liste des événements peut être filtrée selon leur niveau : - **Tous les niveaux** : affiche les événements de tous les niveaux - **Critique** : signale un événement nécessitant une attention prioritaire - **Erreur** : signale une anomalie détectée - **Avertissement** : indique une situation nécessitant une vigilance particulière - **Information** : affiche les événements informatifs Pour affiner l'affichage, plusieurs commandes sont disponibles : - **Rafraîchir** : actualise la liste des événements. - **Afficher aussi les acquittées** : inclut les événements déjà acquittés dans la liste. Sélectionner le niveau souhaité pour consulter les événements correspondants. ### 2- Acquitter une erreur Lorsqu’une erreur a été prise en compte, elle peut être acquittée afin de ne plus apparaître comme erreur non acquittée. - le bouton **Acquitter** permet d’acquitter individuellement une erreur - le bouton **Acquitter tout** permet d’acquitter simultanément l’ensemble des erreurs affichées Pour chaque erreur, les informations disponibles peuvent notamment indiquer : - le niveau de l’erreur (critique, erreur, avertissement, information) - le type d’équipement ou de fonction concerné - la description de l’erreur - la source à l’origine de l’erreur ; - le nombre d’occurrences ; - la date et l’heure de détection. > **Remarque :** l’acquittement d’une erreur ne corrige pas nécessairement la cause du problème. Il permet uniquement de signaler que l’erreur a été prise en compte. Si la cause persiste, l’erreur peut réapparaître Le bouton **Rafraîchir** permet de mettre à jour la liste des erreurs et d'afficher les éventuelles nouvelles occurrences. # Sauvegardes La fonction **Sauvegardes** permet de créer et de restaurer des copies de la configuration du module. Les sauvegardes sont chiffrées et stockées sur le serveur afin de pouvoir récupérer la configuration du module en cas de besoin. ### [](https://modlink.fr/help/uploads/images/gallery/2026-09/capture-decran-2026-09-04-123930.jpg) ### 1- Créer une sauvegarde Le système effectue automatiquement une sauvegarde quotidienne de l’ensemble de la configuration du module (scénarios, variables, widgets, paramétrages ...). Il est également possible de créer manuellement une sauvegarde à tout moment en cliquant sur le bouton **Créer un backup**.**Important :** Ce message ne signifie pas que votre réseau ou vos données sont en danger
### Pourquoi ce message apparaît - Le module utilise une connexion **HTTP non chiffrée** pour optimiser la **rapidité et la réactivité** - L’activation de HTTPS / SSL sur le module augmenterait la **latence**, ce qui pourrait ralentir le pilotage et la supervision en **temps réel** - Les navigateurs affichent ce message car la connexion n’est pas chiffrée avec un certificat reconnu, mais cela **n’affecte pas la sécurité** sur un réseau local sécurisé ### Ce que vous pouvez faire - **Continuer l’accès au module** : cliquez sur “Avancé” puis “Continuer” si le navigateur le propose - Assurez-vous que votre **réseau local est sécurisé** (Wi-Fi protégé, utilisateurs autorisés) - Aucune action supplémentaire n’est nécessaire pour un usage normal du module # Remplacer un module défaillant dans un réseau de modules Dans une installation comportant plusieurs modules, il est possible de remplacer rapidement un module défaillant sans avoir à reconfigurer l'ensemble du système. Pour cela, **attribuez au nouveau module le même nom que celui du module défectueux**. Les autres modules pourront ainsi le retrouver automatiquement sur le réseau et poursuivre leurs échanges sans nécessiter de modifications supplémentaires. Cette méthode permet de remplacer un module tout en conservant le fonctionnement existant de l'installation, sans re-paramétrage des communications entre modules. Pour modifier le nom d'un module, accédez au menu "*Paramètres*" > "*Informations*" > "*Identité*", puis cliquez sur "*Changer de nom*" à côté du champ "*Nom de l'appareil"*. [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-105738.jpg) Renseignez ensuite le **numéro de série du module défaillant** (indiqué sous le capot) et confirmez la modification. Le nouveau module pourra alors être utilisé sans nécessiter de reconfiguration. Attribuez ensuite au nouveau module le nom du module défaillant afin de conserver automatiquement les communications existantes. [](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-105223.jpg)