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.

Prérequis

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.

1- Exposition des variables

Configuration de l'exposition d'une variable

• Ouvrez le menu "I/O"
• Sélectionnez la variable à partager
• Cliquez sur l'icône "Modifier" (pinceau) pour accéder à sa configuration
• Cochez les options d'exposition souhaitées :
  • exposition Modbus
  • exposition OPC UA
  • exposition Home Assistant
• Enregistrez la configuration

• 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 :

• Ouvrez le menu "Paramètres"

• 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

• Ouvrez le menu "Paramètres"
• Sélectionnez l'onglet "Connectivité"
• Choisissez "Home Assistant"
• Cliquez sur le bouton Configurer

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.

4.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 distant est opérationnel et accessible via OPC UA.

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

4.2- Utilisation du Tunnel SSH

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.