Protocoles de communication et interopérabilité
2PIO permet d’échanger des données avec des systèmes externes à l’aide de différents protocoles et services de communication, notamment Modbus, Home Assistant et OPC UA.
1- Exposition des variables
Configuration préalable
Avant de configurer l'intégration, exposez les variables qui doivent être partagées avec Modbus, OPC UA ou Home Assistant.
Les variables non exposées restent internes au module et ne sont pas accessibles depuis les services tiers
Configuration de l'exposition d'une variable
La variable devient alors accessible via les protocoles et services sélectionnés.
Pour plus d'information, vous pouvez consulter Configurer une variable
2- Intégration ModBus
Modbus est un protocole de communication industriel ouvert et largement utilisé pour l'échange de données entre des équipements d'automatisation : automates, contrôleurs, capteurs, compteurs et systèmes de supervision.
Activation de l'accès Modbus distant
Pour autoriser l'échange de données via Modbus à distance :
- Sélectionnez l'onglet "Connectivité" puis cliquez sur le bouton "Configurer"
- Une nouvelle fenêtre s'affiche alors, dans "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
3- 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.
L’intégration du module 2PIO permet de superviser ses états, d’utiliser 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.
3.1- Configuration depuis l'interface d'administration
Vous pourrez alors accéder aux paramètres nécessaires à l'intégration du module dans Home Assistant.
3.2- Ajout du module dans Home Assistant
- Dans Home Assistant, ouvrez le menu "Paramètres" puis "Appareils et services"
- Recherchez l'intégration ALCANTE / module Alcante
Deux méthodes d'ajout sont possibles :
Découverte automatique
Home Assistant recherche automatiquement les modules disponibles sur le réseau local.
- Sélectionnez le ou les modules à ajouter
- Un code de validation à 6 chiffres s'affiche dans l'interface d'administration du module
- Saisissez ce code dans la fenêtre de configuration de Home Assistant afin de confirmer l'intégration.
Une fois la validation effectuée, le module est ajouté à Home Assistant. Les variables exposées deviennent disponibles pour la supervision, 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é API du module, puis validez la configuration.
Une fois la clé validée, Home Assistant établit la connexion avec le module et l’ajoute à l’intégration.
La fréquence de rafraîchissement détermine l’intervalle entre deux mises à jour des variables transmises à Home Assistant.
Cette durée, configurable en secondes, permet d’adapter la fréquence des mises à jour aux besoins de l’installation.
4- 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 de supervision.
Dans le domaine de la GTB (Gestion Technique du Bâtiment), 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 les variables, états et mesures du module auprès des systèmes GTB compatibles pour la supervision et selon les droits et fonctions disponibles, le pilotage de l'installation.
3.1- Activation du serveur OPC UA
- Dans la fenêtre qui s'ouvre, activez l'option Serveur
Les indicateurs Activé et Actif s'affichent alors pour confirmer que le serveur distant est opérationnel et accessible via OPC UA.
Le tunnel SSH est partagé entre l'accès distant de 2PIO 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 de 2PIO est désactivé.
Le module reste alors accessible uniquement depuis le réseau local
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 d'administration.
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
La variable devient alors accessible via les protocoles et services sélectionnés.
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
Pour plus d'information, vous pouvez consulter Configurer une variable