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 : Ouvrez le menu « Paramètres » Sélectionnez l’onglet « Connectivité » , puis cliquez sur « Configurer » Dans la fenêtre qui s’affiche, repérez la section « Commande Modbus » 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 Ouvrez le menu « Paramètres »   Sélectionnez l’onglet « Connectivité » Choisissez « Home Assistant » Cliquez sur « Configurer » Une fenêtre d'appairage s'ouvre alors avec un code de validation 2.2- Ajout du module 2PIO dans Home assistant Dans Home Assistant : Ouvrez « Paramètres » , puis « Appareils et services » Ajoutez l’intégration Alcante Suivez la procédure de découverte automatique ou de configuration manuelle pour ajouter le module Découverte automatique Home Assistant recherche automatiquement les modules disponibles sur le réseau local Sélectionnez le ou les modules à ajouter Consultez l’interface d’administration du module pour récupérer le code de validation à 6 chiffres 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 : Ouvrez le menu « Paramètres » du module Sélectionnez l’onglet « Connectivité » Dans la section « Variables action HTTP » , cliquez sur « Configurer » 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 Ouvrez le menu "Paramètres" Sélectionnez l'onglet "Connectivité" Dans la section "OPC UA" , cliquez sur le bouton " Configurer" 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.