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 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.

3.1. Installation de Home Assistant et de l’intégration Alcante

Avant d’ajouter un module 2PIO, vous devez disposer d’une installation fonctionnelle de Home Assistant sur un ordinateur ou un système compatible.

L’intégration Alcante doit ensuite être installée via HACS (Home Assistant Community Store), qui permet d’ajouter des intégrations communautaires à Home Assistant.

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

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

3. Choisissez « Home Assistant »

4. Cliquez sur « Configurer »

Une fois l’intégration installée, vous pouvez procéder à l’ajout du module 2PIO dans Home Assistant.

3.2. Ajout du module 2PIO dans Home Assistant

Pour accéder aux paramètres nécessaires à l’intégration :

2.  

Vous accédez alors 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.

---

3. Intégration avec Home Assistant

3.3. Ajout du module 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 ou de configuration manuelle du module.

Deux méthodes d’ajout sont possibles.

Découverte automatique

Home Assistant recherche automatiquement les modules disponibles sur le réseau 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 d’une action HTTP intégrée aux scénarios.

Cette fonction permet notamment de transmettre des informations à un autre système ou de déclencher une action sur un équipement ou un service disposant d’une interface HTTP compatible.

4.1. Création d’une action HTTP

Pour configurer l’envoi d’une requête HTTP :

1. Ouvrez l’éditeur de scénarios du module.

2. Créez ou modifiez le scénario concerné.

3. Ajoutez une action HTTP.

4. Renseignez les paramètres de la requête conformément aux exigences du système destinataire.

5. Enregistrez le scénario et vérifiez son fonctionnement.

Les paramètres à renseigner dépendent de la requête attendue par le système tiers et des possibilités proposées par l’action HTTP.

Lorsque la requête transmet des valeurs issues des variables du 2PIO, celles-ci doivent être préalablement exposées dans la configuration du module.

5. Intégration OPC UA

OPC UA (Open Platform Communications Unified Architecture) est un standard de communication permettant l’échange 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

Pour activer le serveur OPC UA :

1. Ouvrez le menu « Paramètres ».

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

3. Dans la section « OPC UA », cliquez sur « 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.