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"
DansRecherchezla barre de recherchez tapezl'intégration ALCANTE / module Alcante
Deux méthodes d'ajout sont alors possibles :
Découverte automatique
Home Assistant lancerecherche automatiquement une recherche desles modules présentsdisponibles sur le réseau local.
- Sélectionnez
le(s)lemodule(s)ouquelesvousmodulessouhaitezà 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 AssistantAssistant. etLes sesvariables équipementsexposées deviennent accessiblesdisponibles pour la supervision, le pilotage et les automatisations.automatisations, selon leur configuration.
Configuration manuelle
Si le module n'n’est pas détecté automatiquement, ilvous est possible depouvez procéder à une configuration manuelle.
Lors de l'l’ajout de l'l’intégration, il faut renseignez la clé API du module.module,
puis validez la configuration.
Une fois la clé validée, Home Assistant établit la connexion avec le module l'et l’ajoute automatiquement.
La fréquence de rafraîchissement détermine l'l’intervalle entre chaquedeux misemises à jour des variables envoyéestransmises à Home Assistant.
Cette durée estdurée, configurable en secondessecondes, afinpermet d'd’adapter la réactivitéfréquence dudes systèmemises à jour aux besoins de l'l’installation.
3-4- Intégration OPC UA
OPC UA (Open Platform Communications Unified Architecture) est un protocolestandard 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 UAil facilite l'l’interconnexion entre les équipements techniques, les systèmes de contrôle, de supervisioncontrôle et les équipements techniques du bâtiment. Il permetlogiciels de centraliser les informations, de superviser les installations et d'échanger des données de manière fiable et sécurisée.supervision.
L'intégration OPC UA permet au module de mettre à disposition sesles variables, états et mesures du module auprès des systèmes GTB compatibles afin de faciliterpour 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