# Ajouter un module

<details id="bkmrk-pr%C3%A9requis-installez-"><summary>Prérequis</summary>

- Installez le(s) nouveau(x) module(s) conformément aux recommandations d'installation *[Raccordement électrique](https://modlink.fr/help/books/2-pio/page/raccordement-electrique "Raccordement électrique")*
- Contrôlez l'[Etat des voyants](https://modlink.fr/help/link/179#bkmrk-%C2%A0) pour vérifier que le(s) module(s) fonctionne(nt) normalement
- Les modules doivent se trouver **à proximité les uns des autres lors du transfert de la clé de cryptage**
- Seuls les utilisateurs dont le profil dispose de la permission « Appairage de modules » sont autorisés à ajouter de nouveaux modules à un réseau
- Pour **partager des variables** entre les modules d'un réseau, celles-ci doivent être exposées. Les variables non exposées restent internes au module et ne sont pas accessibles par les autres modules du réseau

</details><p class="callout warning">Pour constituer un réseau ModLink, **tous les modules doivent partager la même clé de cryptage**.  
Cette clé permet aux modules de communiquer</p>

Lors de l'ajout d'un nouveau module, la clé de cryptage doit être transférée depuis un module déjà configuré vers le nouveau module. Pour des raisons de sécurité, ce transfert ne peut être réalisé que lorsque les deux modules se trouvent à proximité immédiate l'un de l'autre.

<p class="callout warning">Pour des raisons de sécurité, **le partage de la clé de cryptage** ne peut se faire que si les **modules se trouvent à proximité les uns des autres** (uniquement au moment du transfert de la clé)  
</p>


L'ajout d'un nouveau module au réseau peut être réalisé <span style="text-decoration: underline;">de deux façons</span> :

- Directement sur le module à l'aide du **bouton de commande**
- **Via l'interface Web**

### 1- Appairage manuel 

#### 1.1- Sur le module à ajouter (récepteur)

voir aussi [Navigation avec le bouton de commande](https://modlink.fr/help/link/264#bkmrk-page-title)

1. Effectuez un **double appui** <span style="background-color: rgb(251, 238, 184);">La LED "*Wireless mode*" s'allume en bleu foncé</span>
2. Puis faîtes un **appui simple  
    La LED "*Wireless mode*" se met alors à clignoter en bleu

Répétez cette opération pour chaque module supplémentaire à intégrer au réseau.

<p class="callout info">**Le mode appairage est activé pour une durée de 2 minutes**.   
Durant ce délai uniquement, il est possible de dupliquer les informations du dispositif **émetteur** vers le ou les dispositifs récepteurs.  
</p>

#### 1.2- Sur le module déjà configuré (émetteur)

Pour transférer la **clé de cryptage** et la **configuration du réseau WiFi (SSID + mot de passe)** du module déjà configuré vers le(s) module(s) à ajouter :

1. Effectuez un **double appui  
    <span style="background-color: rgb(251, 238, 184);">La LED "*Wireless mode*" s'allume en bleu foncé</span>**
2. Puis faîtes un appui **long**

Pour vérifier que le transfert a été correctement effectué, contrôlez l'état des voyants <span style="text-decoration: underline;">sur le(s) module(s) récepteur(s)</span>

- 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 n'a pas été pris en compte. Dans ce cas, recommencez l'intégralité de la procédure, en effectuant à nouveau l'appairage puis le transfert des informations.

<p class="callout warning">Le transfert de la **configuration Wi-Fi et des clés de cryptage** ne peut être effectuée que pendant les **2 minutes** suivant l’ouverture de l’appairage sur le module à ajouter.   
Passé ce délai, le processus (appairage et transfert) devra être relancé</p>

### 2- Appairage en local via les interfaces Web

#### 2.1- Activer le WiFi sur le module à ajouter

Connectez-vous **au réseau Wi-Fi temporaire** du module à ajouter

- Connectez-vous au module ModLink en saisissant **`2pioXXXX.local`** dans la barre d’adresse de votre Smartphone
- Activez le Wi-Fi dans les paramètres de votre appareil
- Rechercher la liste des réseaux sans fils disponibles
- Sélectionner le SSID du réseau Wi-Fi du module ("Captive Portal" + numéro d'identification du module)  
    *le message "réseau non sécurisé - pas de connexion Wi-Fi" s'affiche*
- La page du portail captif s’affiche automatiquement - cela peut prendre un certain temps  
    *Une fenêtre peut s'afficher 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*
- Choisissez le réseau Wi-Fi 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 (minimum recommandé 25 %)* Saisissez le mot de passe du réseau et appuyer sur "*Appliquer*"  
    *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*

Le module devient alors **accessible à distance** via son interface Web.


#### 2.2- Sur l'interface Web des modules

Dans le menu "I/O", sélectionnez le mode "Wireless" puis "Clés"

**Autoriser l'appairage (depuis le module déjà <span style="text-decoration: underline;">configuré)</span> :**

- Dans "*Clé et appairage sécurisé*" cliquer sur le bouton <span style="background-color: rgb(53, 152, 219); color: rgb(0, 0, 0);">Ouvrir l'appairage</span>

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

**Recruter l'appareil cible (depuis l'interface du module <span style="text-decoration: underline;">à ajouter)</span> :**

- Dans "*Clé et appairage sécurisé*" cliquer sur le bouton "<span style="background-color: rgb(53, 152, 219); color: rgb(0, 0, 0);"><span style="background-color: rgb(220, 40, 197);">Demander à rejoindre</span></span><span style="color: rgb(0, 0, 0);">"</span>

**Transférer la clé de cryptage (depuis l'interface du module <span style="text-decoration: underline;">déjà configuré)</span> :**

- Dans "T*ransférer les clés chiffrées*" cliquez sur "<span style="background-color: rgb(53, 152, 219); color: rgb(0, 0, 0);">Transférer les clés</span>"

<span style="color: rgb(34, 34, 34); font-family: 'Noto Sans', sans-serif; font-size: 1.666em; font-weight: 400;">[![Capture d’écran 2026-07-06 160612.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/capture-decran-2026-07-06-160612.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-06-160612.jpg)</span>

<p class="callout warning">Le transfert des clés doit se faire **dans les 2 minutes qui suivent l'ouverture de l'appairage** sur le module principal</p>

Si la clé est manquante, appuyez sur le bouton "*Actualiser l'état*" ou bien regénérez-la depuis le menu *"Paramètres" dans l'onglet* "Sécurité" puis "Clés"

<span style="color: rgb(68, 68, 68);">**Importer les appareils (depuis l'interface des <span style="text-decoration: underline;">deux modules)</span> :**</span>

- Dans le menu "I/O", sélectionnez le mode "*Distant*" puis cliquez sur le bouton <span style="background-color: rgb(45, 194, 107); color: rgb(0, 0, 0);">Scanner mDNS</span><span style="color: rgb(0, 0, 0);"> pour lancer la détection des modules sur le réseau</span>
- Dans la liste des appareils détectés, repérez le module que vous souhaitez ajouter, cochez-le, puis cliquez sur <span style="background-color: rgb(53, 152, 219); color: rgb(0, 0, 0);">Importer la sélection</span>
- <span style="color: rgb(68, 68, 68);">Cliquez sur <span style="background-color: rgb(220, 40, 197); color: rgb(0, 0, 0);">Sauvegarder</span>, puis sur le bouton <span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">Redémarrer</span> dans la barre de navigation pour finaliser l'opération</span>

<span style="color: rgb(68, 68, 68);">[![Capture d’écran 2026-07-07 123042.jpg](https://modlink.fr/help/uploads/images/gallery/2026-07/scaled-1680-/capture-decran-2026-07-07-123042.jpg)](https://modlink.fr/help/uploads/images/gallery/2026-07/capture-decran-2026-07-07-123042.jpg)</span>

<p class="callout success">Toute modification de la composition du réseau de modules (ajout, suppression ou remplacement) nécessite un redémarrage afin d'appliquer la nouvelle configuration</p>

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 [Définir le rôle d'un module](https://modlink.fr/help/link/263#bkmrk-page-title)**