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

3.1. Configuration du module 2PIO

1. Ouvrez le menu « Paramètres » 

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

3. Choisissez « Home Assistant »

4. Cliquez sur « Configurer »

Une fois cette configuration effectuée vous pouvez procéder à l’ajout du module.

3.2- Ajout du module 2PIO 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 automatique ou de configuration manuelle pour ajouter le module

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

 

5- Intégration OPC UA

1. 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.
2. 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.
3. 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. 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

1. 

• Dans la fenêtre qui s'ouvre, activez l'option "Serveur"

1. 

• Les indicateurs Activé et Actif s'affichent alors pour confirmer que le serveur distant est opérationnel et accessible via OPC UA.

1. 

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

1. 4.2- Utilisation du Tunnel SSH
2. 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
3. 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. Intégration HTTP

1. 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 intégrée:

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

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

   3. Dans la section « Variables action HTTP », cliquez sur « Configurer »

   4. 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 scénarios.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 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.

2. 4.1. Création d’une action HTTP
3. Pour configurer l’envoi d’une requête HTTP :

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

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

6. Ajoutez une action HTTP.

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

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

9. Les paramètresexterne à renseignerpartir dépendentd’un de la requête attendue par le système tiers et des possibilités proposées par l’action HTTP.
10. Lorsque la requête transmet des valeurs issues des variablesscénario du 2PIO, celles-cisans doiventnécessiter êtrede préalablementconnexion exposéesmatérielle dansdirecte laentre configurationles duéquipements.
    module.
11. 5.

    5- Intégration OPC UA

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

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

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

15. 5.1.1- Activation du serveur OPC UA

1. Pour activer le serveur OPC UA :

2. Ouvrez le menu « Paramètres ».

   "Paramètres"

3. Sélectionnez l’l'onglet « Connectivité ».

   "Connectivité"

4. Dans la section « "OPC UA »UA", cliquez sur «le Configurerbouton ».

   "Configurer"

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

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

externes

17. 

    

    

    5.2.2- Utilisation du tunnel SSH

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

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