# Paramètres complémentaires

# Entrées et sorties

L'interface permet de **configurer** et de **visualiser en temps réel l'état** de chaque entrée et de chaque sortie, facilitant le diagnostic, la mise en service et le suivi du fonctionnement du module.

### 1- Configurer les entrées et les sorties

Les entrées et les sorties du module peuvent être visualisées et configurées depuis le menu *« I/O »*, à la suite des variables du système.  
Pour chaque entrée et sortie, les paramètres suivants peuvent être personnalisés :

- **Nom** : permet d'attribuer un nom explicite à l'entrée ou à la sortie afin de faciliter son identification
- **Accessible** : lorsque cette option est cochée, l'I/O est diffusé et devient visible sur le réseau
- **Commentaire** : ce champ est renseigné par défaut avec la référence de la borne à laquelle l'entrée ou la sortie est raccordée. Il peut être modifié pour ajouter des informations complémentaires

### [![Capture d’écran 2026-06-12 122947.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-12-122947.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-12-122947.jpg)

#### 1.1- Paramétrage spécifique des entrées analogiques en double canal

Lorsqu'une entrée est utilisée en mode analogique :

1. Cochez l'option **« Analogique »**
2. Si nécessaire, cochez **« Séparer en 2 entrées A et B »** afin de créer deux canaux analogiques distincts
3. Activez l'option **« Valeur moyenne »** pour lisser les mesures, puis renseignez la **fenêtre de moyenne** en millisecondes (durée pendant laquelle il faut faire la moyenne)
4. Renseignez les **valeurs minimale et maximale** correspondant à la plage de mesure du capteur (par exemple : -20 °C à +40 °C pour une sonde de température)
5. Ajustez l'**offset** si nécessaire afin de corriger un éventuel décalage de mesure observé sur le capteur

Une fois la configuration terminée, appuyer sur "<span style="background-color: rgb(220, 40, 197);">Sauvegarder</span>" pour enregistrez vos modifications.   
Chaque entrée peut être *sauvegardée individuellement* ou l'ensemble de la configuration peut être enregistré en une seule opération à l'aide du bouton *« <span style="background-color: rgb(45, 194, 107);">Sauvegarder toutes les I/O </span>».*

Pour diffuser les "I/O" sur le réseau, cochez l'option *« Diffuser sur le réseau (mDNS) après sauvegarde »* avant d'enregistrer la configuration. Les I/O marqués comme *« Accessible »* seront alors publiés sur le réseau et pourront être découverts et utilisés par les équipements ou services compatibles. Un redémarrage du module est nécessaire pour que les changements soient pris en compte.

Après avoir enregistré les modifications et activé leur diffusion, un redémarrage du module est nécessaire pour que les changements soient pris en compte.

<p class="callout warning">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)  
</p>

#### 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 &gt; Informations &gt; 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.

[![Capture d’écran 2026-06-12 151418.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-12-151418.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-12-151418.jpg)

# Comptes utilisateurs

<p class="callout success">Le système prévoit :  
**- 5 comptes "Installateur"  
- 10 comptes "Utilisateur"**   
*attribuer les autorisations et niveaux d’accès en fonction du rôle défini*   
Le **rôle "Installateur"** offre un accès étendu aux fonctions de configuration et de maintenance :  
- changement de nom d’appareil  
- gestion des utilisateurs  
- gestion des sauvegardes  
Le rôle **"Utilisateur"** donne un accès limité à l’exploitation et à la supervision du module :  
</p>

Pour accéder aux paramètres des comptes :

- Ouvrez le menu **Paramètres**
- Sélectionnez l'onglet **Sécurité**
- Cliquez sur **Accès**
- Dans "*Authentification et utilisateurs*" cliquez sur le bouton **Gérer**

**[![Capture d’écran 2026-06-04 173545.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-04-173545.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-04-173545.jpg)**

> ⚠️ L'accès aux fonctions du menu « *Paramètres* » est déterminé par le **rôle** et les **permissions** attribués à chaque utilisateur.  
> Cette gestion des droits permet de sécuriser la configuration et l'exploitation du module tout en assurant une répartition claire des responsabilités entre les différents profils d'utilisateurs

### 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. Cochez les **permissions** et les **accès aux pages** de l'interface que vous souhaitez autoriser
4. Cliquez sur **Créer l'utilisateur**

[![Capture d’écran 2026-06-04 174055.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-04-174055.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-04-174055.jpg)

<p class="callout success"><span data-end="966" data-start="803">L</span>a création d’un **compte Installateur** nécessite des droits spécifiques.   
Assurez-vous de disposer des autorisations nécessaires avant de créer ce type de compte.  
  
Lors de la création d'un nouveau compte installateur, seules les *permissions minimales* requises sont activées par défaut (mise à jour du firmware, changement de nom et 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'administrateur* </p>

<p class="callout warning">Pour des raisons de **sécurité**, il est recommandé de standardiser les rôles, limiter les droits administratifs et vérifier régulièrement les comptes inactifs</p>

### <span role="text">2- Afficher les comptes</span>

La **liste des comptes utilisateurs** apparaît directement sous le bloc **« Créer un utilisateur »**.  
Elle permet de visualiser rapidement toutes les informations des comptes existants, leurs rôles et leurs permissions.

[![Capture d’écran 2026-06-11 121359.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-11-121359.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-11-121359.jpg)

### <span role="text">3- Gestion des comptes</span>

> <span role="text">⚠️ <span style="color: rgb(52, 73, 94);">Les actions disponibles dépendent du rôle et des droits qui ont été attribués</span></span>

#### <span role="text">3.1- Modifier un compte</span>

Selon les droits d'accès, il est possible de modifier l'identifiant, le mot de passe, le rôle, les permissions ainsi que les pages accessibles pour un compte utilisateur.

#### 3.2- Supprimer un compte

Seuls les comptes disposant des droits nécessaires peuvent être supprimés. La suppression est définitive et entraîne la perte de toutes les permissions associées.

# Modifier la configuration WiFi

### <span style="color: rgb(68, 68, 68);">1- Le module est toujours connecté à Internet</span>

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 "<span style="background-color: rgb(53, 152, 219); color: rgb(0, 0, 0);">*Configurez*</span>"  
Vous pourrez alors scanner les réseaux WiFi à proximité, en sélectionner un nouveau puis renseigner les informations de connexion correspondantes.

[![Capture d’écran 2026-06-22 162120.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-22-162120.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-22-162120.jpg)

### [![Capture d’écran 2026-06-22 163644.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-22-163644.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-22-163644.jpg)

### 2- Le module n'est plus connecté à Internet

<p class="callout info">Le voyant Wi-Fi du module clignote en vert s'il n'est plus connecté à Internet</p>

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.  
    <span style="color: rgb(52, 73, 94);">Le SSID du module apparait sous la forme "</span>***<span style="background-color: rgb(206, 212, 217);">2pioXXXX</span>**"*    
    un message "réseau non sécurisé peut s'afficher et c'est normal.  
    <span style="color: rgb(52, 73, 94);">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 </span>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 « <span style="color: rgb(0, 0, 0);">*<span style="background-color: rgb(53, 152, 219);">Configurer</span>*</span> »

[![Capture d’écran 2026-06-25 143757.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-25-143757.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-25-143757.jpg)

- Cliquez ensuite sur "<span style="background-color: rgb(53, 152, 219); color: rgb(0, 0, 0);">*Scanner les réseaux*</span>"

   
[![Capture d’écran 2026-06-25 142635.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-25-142635.jpg)](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 "<span style="background-color: rgb(53, 152, 219); color: rgb(0, 0, 0);">*Appliquer*</span>" 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*

*[![Capture d’écran 2026-06-25 142731.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-25-142731.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-25-142731.jpg)*


<p class="callout info">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*</p>

Pour la **connexion à distance**, Modlink peut utiliser :

- le réseau Wi-Fi local
- un réseau Wi-Fi indépendant (souvent dédié aux IoT)
- un routeur 4G


<p class="callout warning">*<span style="text-decoration: underline;">Attention</span>* :  
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*</p>

# Protocoles de communication et interopérabilité

<details id="bkmrk-pr%C3%A9requis-pour-le-pa"><summary>Configuration préalable : exposition des variables</summary>

Avant de poursuivre la configuration de l'intégration, **exposez toutes les variables qui devront être échangées avec Modbus, OPC UA ou Home Assistant.**   
Sans cette configuration, les variables resteront internes au module et ne seront pas accessibles depuis les systèmes externes

</details>### 1- Intégration ModBus

Modbus est un **protocole de communication industrie**l ouvert et largement utilisé pour l'échange de données entre des équipements d'automatisation tels que des automates, contrôleurs, capteurs, compteurs ou systèmes de supervision.

#### 1.1- Activation de l'accès Modbus distant

Pour autoriser l'échange de données via Modbus à distance :

- Ouvrez le menu "*Paramètres*"

[![Capture d’écran 2026-06-23 145818.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-145818.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-145818.jpg)

- Sélectionnez l'onglet "*Connectivité*" puis cliquez sur le bouton "*Configurer*"

[![Capture d’écran 2026-06-23 145604.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-145604.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-145604.jpg)

- Une nouvelle fenêtre s'affiche alors, dans "*Commande Modbus"*, activez l'option "*Modbus distant*"

[![Capture d’écran 2026-06-23 144859.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-144859.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-144859.jpg)

Une fois cette option activée, les échanges de données Modbus à distance sont autorisés sur le module.

### 2- Intégration 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.

Le module peut être connecté à Home Assistant afin de permettre son pilotage et sa supervision depuis une interface domotique centralisée.   
Une fois l'intégration configurée, les équipements, mesures et commandes du module sont automatiquement accessibles dans Home Assistant et peuvent être utilisés dans des tableaux de bord, automatisations et scénarios personnalisés.

#### 2.1- Configuration depuis l'interface ModLink

- Ouvrez le menu "*Paramètres*"
- Sélectionnez l'onglet "*Connectivité*"
- Choisissez "*Home Assistant*"
- Cliquez sur le bouton <span style="background-color: rgb(53, 152, 219);">Configurer</span>

[![Capture d’écran 2026-06-23 150230.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-150230.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-150230.jpg)

Vous pourrez alors accéder aux paramètres nécessaires à l'intégration du module dans Home Assistant.

#### 2.2- Ajout du module dans Home Assistant

- Dans Home Assistant, ouvrez le menu *"Paramètres"* puis "*Appareils et services*"
- Dans la barre de recherchez tapez ALCANTE / module Alcante

[![Capture d’écran 2026-06-23 154953.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/XDecapture-decran-2026-06-23-154953.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/XDecapture-decran-2026-06-23-154953.jpg)

Deux méthodes d'ajout sont alors possibles :

##### <span style="text-decoration: underline;">Découverte automatique</span>

Home Assistant lance automatiquement une recherche des modules présents sur le réseau local.

[![Capture d’écran 2026-06-23 161150.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-161150.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-161150.jpg)

Sélectionnez le(s) module(s) que vous souhaitez ajouter

[![Capture d’écran 2026-06-23 161257.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-161257.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-161257.jpg)

Un **code de validation à 6 chiffres** s'affiche dans l'interface ModLink.

[![Capture d’écran 2026-06-23 151928.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-151928.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-151928.jpg)

Saisissez ce code dans la fenêtre de configuration de Home Assistant afin de confirmer l'intégration.

[![Capture d’écran 2026-06-23 151944.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-151944.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-151944.jpg)

Une fois la validation effectuée, le module est ajouté à Home Assistant et ses équipements deviennent accessibles pour la supervision, le pilotage et les automatisations.

##### <span style="text-decoration: underline;">Configuration manuelle</span>

Si le module n'est pas détecté automatiquement, il est possible de procéder à une configuration manuelle.

Lors de l'ajout de l'intégration, il faut renseignez la **clé API** du module.   
Une fois la clé validée, Home Assistant établit la connexion avec le module l'ajoute automatiquement.

[![Capture d’écran 2026-06-23 153043.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-153043.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-153043.jpg)

La **fréquence de rafraîchissement** détermine l'intervalle entre chaque mise à jour des variables envoyées à Home Assistant. Cette durée est configurable en secondes afin d'adapter la réactivité du système aux besoins de l'installation.

### 3- Intégration OPC UA

OPC UA (Open Platform Communications Unified Architecture) est un protocole de communication standardisé permettant l'échange sécurisé de données entre différents équipements et logiciels de supervision.

Dans le **domaine de la GTB** (Gestion Technique du Bâtiment), OPC UA facilite l'interconnexion entre les systèmes de contrôle, de supervision et les équipements techniques du bâtiment. Il permet de centraliser les informations, de superviser les installations et d'échanger des données de manière fiable et sécurisée.

L'intégration OPC UA permet au module de mettre à disposition ses variables, états et mesures auprès des systèmes GTB compatibles afin de faciliter la supervision et le pilotage de l'installation.

#### 3.1- Activation du serveur OPC UA

- Ouvrez le menu "Paramètres"
- Sélectionnez l'onglet "Connectivité"
- Dans la section "OPC UA", cliquez sur le bouton <span style="background-color: rgb(53, 152, 219);">Configurer</span>

<span style="background-color: rgb(53, 152, 219);">[![Capture d’écran 2026-06-23 150230.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-150230.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-150230.jpg)</span>

- Dans la fenêtre qui s'ouvre, activez l'option **Serveur**

**[![Capture d’écran 2026-06-23 171359.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-171359.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-171359.jpg)**

Les indicateurs **Activé** et **Actif** s'affichent alors pour confirmer que le serveur distant est opérationnel et accessible via OPC UA.

[![Capture d’écran 2026-06-23 170217.jpg](https://modlink.fr/help/uploads/images/gallery/2026-06/scaled-1680-/capture-decran-2026-06-23-170217.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-06/capture-decran-2026-06-23-170217.jpg)

<p class="callout warning">**Le tunnel SSH est partagé entre l'accès distant ModLink et l'accès OPC UA distant** *- 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 ModLink est désactivé.   
*Le module reste alors accessible uniquement depuis le réseau local*</p>

### 4- Exposition des variables

Pour qu'une variable soit accessible depuis un système externe, elle doit être exposée dans sa configuration sur l'interface Modlink.  
L'exposition des variables permet de les rendre disponibles pour les différents protocoles et services pris en charge par le module, tels que Modbus, OPC UA et Home Assistant.

#### 4.1- Configuration de l'exposition d'une variable

- Ouvrez le menu "*I/O"*
- Sélectionnez la variable à partager
- Cliquez sur l'icône "*Modifier"* (pinceau) afin d'accéder à sa configuration
- Cochez les options d'exposition souhaitées : 
    - exposition Modbus
    - exposition OPC UA
    - exposition Home Assistant
- Enregistrez la configuration

[![Capture d’écran 2026-07-09 143721.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/capture-decran-2026-07-09-143721.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-09-143721.jpg)

La variable devient alors accessible via les protocoles et services sélectionnés.

<p class="callout warning">Seules les **variables exposées peuvent être partagées** avec les services et protocoles externes.  
Pensez à exposer les variables nécessaires avant de configurer les intégrations **Home Assistant, OPC UA ou Modbus.** Les variables non exposées restent internes au module et ne sont pas accessibles depuis le services tiers</p>

Pour plus d'information, vous pouvez consulter [Configurer une variable](https://modlink.fr/help/link/221#bkmrk-2--personnaliser-une)

# 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" &gt; "Informations" &gt; "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.

[![image.png](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/image.png)](https://modlink.fr/help/uploads/images/gallery/2026-07/image.png)

<p class="callout warning">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</p>

<p class="callout success">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</p>

### 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 actuelle

<p class="callout info">seul 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.</p>

#### 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.

<span style="text-decoration: underline;">Pour exclure un ouvrant</span> :

- accédez au menu Paramètres &gt; Informations &gt; Sorties
- sélectionnez la variable "*Position**"*** de l'ouvrant concerné, puis cochez l'option *"Désactiver la variable"*