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.

Prérequis

Avant de configurer une intégration, exposez les variables qui doivent être utilisées par les systèmes tiers.

Les variables non exposées restent internes au module et ne sont pas accessibles aux services tiers concernés. L’exposition doit être configurée en fonction du protocole ou du service utilisé.
Exposer les variables

1- Intégration ModBus TCP

Modbus est un protocole de communication industriel ouvert, largement utilisé pour l’échange de données entre des équipements d’automatisation : automates, contrôleurs, capteurs, compteurs et systèmes de supervision.

1.1. Activation de l’accès Modbus distant

Pour autoriser les échanges Modbus à distance :

1. Ouvrez le menu « Paramètres »

2. Sélectionnez l’onglet « Connectivité », puis cliquez sur « Configurer »

3. Dans la fenêtre qui s’affiche, repérez la section « Commande Modbus »

4. Activez l’option « Modbus distant »

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

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.

Prérequis

L’intégration du 2PIO dans Home Assistant nécessite une installation fonctionnelle de Home Assistant sur un ordinateur ainsi que l’installation de l’intégration Alcante via HACS (Home Assistant Community Store).

2.1. Configuration du module 2PIO

1. Ouvrez le menu « Paramètres » 

2. Sélectionnez l’onglet « Connectivité »

3. Choisissez « Home Assistant »

4. Cliquez sur « Configurer »

Une fenêtre d'appairage s'ouvre alors avec un code de validation

Une fois cette configuration effectuée vous pouvez procéder à l’ajout du module.

2.2- Ajout du module 2PIO dans Home assistant

Dans Home Assistant :

1. Ouvrez « Paramètres », puis « Appareils et services »

2. Ajoutez l’intégration Alcante, si elle n’est pas déjà installée

3. Suivez la procédure de découverte automatique ou de configuration manuelle pour ajouter le module

Découverte automatique

1. Home Assistant recherche automatiquement les modules disponibles sur le réseau local.
   local

   1. Sélectionnez le ou les modules à ajouter

   2. Consultez l’interface d’administration du module pour récupérer le code de validation à 6 chiffres

   3. Saisissez ce code dans la fenêtre de configuration de Home Assistant pour confirmer l’intégration

   

   

   

   

   Une fois la validation effectuée, le module est ajouté à Home Assistant. Les variables exposées deviennent disponibles pour la consultation, le pilotage et les automatisations, selon leur configuration.

   Configuration manuelle

   Si le module n’est pas détecté automatiquement, vous pouvez procéder à une configuration manuelle.

   Lors de l’ajout de l’intégration, renseignez la clé ou les informations d’authentification demandées par l’interface, puis validez la configuration.

   Une fois la connexion établie, Home Assistant ajoute le module à l’intégration.

   La fréquence de rafraîchissement, configurable en secondes, détermine l’intervalle entre deux mises à jour des variables transmises à Home Assistant. Adaptez cette valeur aux besoins de l’installation.

   

   4- Intégration HTTP

   Le module 2PIO permet d’envoyer des requêtes HTTP à des systèmes tiers à l’aide de variables d’action HTTP. Ces variables permettent de déclencher une requête lorsqu’une valeur leur est affectée depuis un scénario, un widget ou une planification.

   Les méthodes disponibles sont GET, POST et PUT. La requête est envoyée à l’URL configurée et peut inclure des paramètres supplémentaires ainsi qu’un mécanisme d’authentification, selon les possibilités proposées.

   4.1. Configuration des variables d’action HTTP

   Pour créer et configurer une variable d’action HTTP :

   1. Ouvrez le menu « Paramètres » du module

   2. Sélectionnez l’onglet « Connectivité »

   3. Dans la section « Variables action HTTP », cliquez sur « Configurer »

   4. Cliquez sur « Nouvelle variable »

   

   

   Renseignez ensuite les paramètres de la variable :

   • Nom de la variable : indiquez un nom permettant d’identifier l’action HTTP

   • Méthode : sélectionnez la méthode HTTP à utiliser : GET, POST ou PUT

   • URL : renseignez l’adresse du système tiers à interroger. Le champ accepte le paramètre {value}, qui sera remplacé par la valeur affectée à la variable

   • Paramètres ajoutés à toutes les requêtes (facultatif) : indiquez les paramètres supplémentaires à ajouter aux requêtes, par exemple un jeton d’authentification si le système distant le prévoit

   • Valeurs faciles (facultatif) : définissez des valeurs prédéfinies permettant d’associer des valeurs écrites à des fragments ajoutés à la requête

   • Authentification : sélectionnez le type d’authentification requis par le système tiers et renseignez les informations demandées

   • TLS (HTTPS) : configurez les paramètres de sécurisation de la connexion lorsque le système tiers utilise HTTPS

   Enregistrez la configuration de la variable.

   

   4.2. Utilisation dans un scénario

   Une fois créée, la variable d’action HTTP peut être utilisée dans un scénario, un widget ou une planification.

   Lorsqu’une valeur lui est affectée, le 2PIO envoie automatiquement la requête HTTP configurée au système tiers. La valeur affectée à la variable est transmise dans la requête, notamment à l’emplacement du paramètre {value} dans l’URL.

   La réponse du système tiers n’est pas exploitée par le 2PIO : la lecture de la variable renvoie la dernière valeur qui lui a été affectée.

   Cette fonction permet notamment de déclencher une action sur un système externe à partir d’un scénario du 2PIO, sans nécessiter de connexion matérielle directe entre les équipements.

   5- Intégration OPC UA

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

   Dans le domaine de la GTB/GTC, il facilite l’interconnexion entre les équipements techniques, les systèmes de contrôle et les logiciels de supervision.

   L’intégration OPC UA permet de mettre à disposition des systèmes compatibles les variables, les états et les mesures du module pour leur exploitation, notamment en supervision. Les possibilités de pilotage dépendent des fonctions prises en charge et des droits configurés.

   5.1- Activation du serveur OPC UA

   1. Ouvrez le menu "Paramètres"
   2. Sélectionnez l'onglet "Connectivité"
   3. Dans la section "OPC UA", cliquez sur le bouton "Configurer"

   4. Dans la fenêtre qui s’ouvre, activez l’option « Serveur »

   Les indicateurs « Activé » et « Actif » s’affichent alors pour confirmer que le serveur est activé et opérationnel.

   Seules les variables exposées à OPC UA sont accessibles depuis les systèmes externes

   

   

   

   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.