Intégration Node-RED

Accéder à Node-RED

HyperVisu comprend une puissante intégration Node-RED qui vous permet de créer des automatisations personnalisées et d'intégrer des systèmes externes. Node-RED est un outil de programmation basé sur des flux qui facilite la connexion des dispositifs matériels, des API et des services en ligne sans nécessiter de connaissances approfondies en programmation.

Pour accéder à l'application Node-RED :

Accédez à l'interface d'administration de HyperVisu en tapant l'adresse IP de votre serveur dans un navigateur web
Connectez-vous avec vos identifiants d'administration (nom d'utilisateur et mot de passe)
Cliquez sur le bouton "Node-RED" sur la page d'administration du serveur
Un nouvel onglet de navigateur s'ouvrira avec la page de connexion de Node-RED
Utilisez le même nom d'utilisateur et mot de passe que l'interface d'administration de HyperVisu pour accéder à Node-RED

Remarque : L'environnement Node-RED fonctionne sur le même matériel que votre serveur HyperVisu, donc toutes les intégrations sont locales et ne nécessitent pas de services cloud externes.

Utilisation des nœuds HyperVisu

HyperVisu étend Node-RED en ajoutant des nœuds personnalisés qui représentent chaque type de widget dans votre système d'automatisation domestique. Ces nœuds vous permettent d'interagir directement avec vos dispositifs KNX depuis Node-RED.

Structure des nœuds

L'intégration HyperVisu Node-RED tourne autour d'un nœud principal "HyperVisu" qui gère la connexion avec le serveur et fournit l'accès à tous les widgets, pièces et catégories. Ce nœud central établit et maintient :

Communication avec le serveur
Mises à jour en temps réel des valeurs des widgets

Des nœuds personnalisés supplémentaires représentent chaque type de widget disponible dans HyperVisu :

Bouton-poussoir - Pour les boutons-poussoirs avec retour d'état optionnel
Interrupteur - Pour les interrupteurs ON/OFF spécifiquement pour l'éclairage
Interrupteur ON/OFF - Pour les interrupteurs ON/OFF généraux (prises électriques, etc.)
Sortie analogique - Pour envoyer des valeurs analogiques dans une plage prédéfinie
Volet/Rideau - Pour contrôler les volets et les rideaux
Contrôleur de température - Pour le contrôle de chauffage/refroidissement
Variateur - Pour les variateurs d'éclairage standard
Variateur RGB - Pour contrôler les lumières RGB(W)
Variateur blanc ajustable - Pour ajuster la température de couleur des lumières blanches
Entrée analogique - Pour afficher des valeurs analogiques avec tendance optionnelle
Entrée numérique - Pour afficher des valeurs d'état numériques

Des nœuds de commande globaux sont également disponibles :

Lumières globales - Pour contrôler toutes les lumières dans une pièce ou une catégorie
Volets globaux - Pour contrôler tous les volets dans une pièce ou une catégorie
Scénario - Pour déclencher des scénarios prédéfinis

Chaque nœud affiche son nom et la pièce ou la catégorie associée à l'intérieur du nœud pour une identification facile.

Entrées et sorties

Les nœuds de widget ont généralement plusieurs entrées et sorties qui correspondent aux fonctions du widget. Par exemple :

Nœud Variateur :

Entrées : Basculer, On, Off, Point de consigne (valeur de variation)
Sorties : État (statut on/off), Valeur (niveau de luminosité), Commande On, Commande Off

Nœud Volet/Rideau :

Entrées : Monter, Descendre, Arrêter, Point de consigne du volet, Point de consigne des lamelles
Sorties : En train de monter, En train de descendre, Position du volet, Position des lamelles, Monter, Descendre, Arrêter

Lorsqu'un nœud reçoit ou envoie des données :

La charge utile du message contient la valeur de la sortie ou de l'entrée
Un champ de sujet contient l'ID de l'objet widget
Un champ widget contient l'ID du widget

Ces formats standardisés facilitent le traitement des messages entre les nœuds et la création d'automatisations complexes.

Création de flux

Node-RED utilise une approche de programmation visuelle où vous connectez des nœuds ensemble pour créer des "flux" de données.

Connexion des nœuds

Pour construire un flux dans l'éditeur Node-RED :

Trouvez les nœuds HyperVisu dans la palette de nœuds sur le côté gauche
Faites glisser le type de nœud souhaité sur le flux
Connectez les nœuds en traînant des lignes entre la sortie d'un nœud et l'entrée d'un autre
Les nœuds traitent les messages séquentiellement au fur et à mesure qu'ils circulent à travers les connexions

Les modèles de flux de base incluent :

Flux de déclenchement : Un nœud de déclenchement (comme un événement d'entrée ou de temps) provoque une action via un nœud de sortie
Flux de transformation : Les données passent par des nœuds de fonction qui modifient les valeurs avant d'atteindre les nœuds de sortie
Flux de décision : Les nœuds de commutation acheminent les messages différemment en fonction des valeurs reçues
Flux d'intégration : Les nœuds de différents systèmes (MQTT, HTTP, etc.) se connectent pour échanger des données

Configuration des nœuds

Chaque nœud HyperVisu doit être configuré pour se connecter à un widget spécifique dans votre système :

Double-cliquez sur un nœud pour ouvrir son panneau de configuration
Utilisez le menu déroulant pour sélectionner le widget auquel il doit se connecter
- Filtrez les options par pièce, catégorie et type de widget pour trouver le bon widget
- La liste affiche tous les widgets du même type disponibles dans votre configuration HyperVisu
Activez/désactivez la publication du courtier MQTT si nécessaire (envoie les valeurs des widgets au courtier MQTT intégré)
Cliquez sur Terminé pour enregistrer la configuration

Pour les widgets virtuels, vous pouvez envoyer des valeurs directement depuis Node-RED pour mettre à jour l'état du widget, vous permettant d'intégrer des capteurs ou des systèmes qui ne sont pas directement connectés à votre bus KNX.

Déploiement des flux

Après avoir construit et configuré vos flux :

Cliquez sur le bouton Déployer dans le coin supérieur droit de l'interface Node-RED
Attendez le message de confirmation indiquant un déploiement réussi
Vos flux sont maintenant actifs et commenceront à traiter des données

L'environnement Node-RED enregistre automatiquement vos flux, et ils redémarreront lorsque le serveur HyperVisu sera redémarré.

Vous pouvez visualiser l'état du flux en temps réel :

Les connexions actives affichent des indicateurs de statut avec des valeurs
Les erreurs apparaissent dans le panneau de débogage (accessible via la barre latérale droite)
Les données peuvent être tracées à l'aide de nœuds de débogage placés dans le flux

Fonctionnalités avancées

Intégration des commandes globales

Les commandes globales vous permettent de contrôler plusieurs dispositifs simultanément :

Ajoutez un nœud Lumières globales ou Volets globaux à votre flux
Configurez-le pour cibler une pièce ou une catégorie spécifique
Envoyez un message "On" ou "Off" à l'entrée du nœud pour contrôler toutes les lumières dans cette pièce
Pour les volets, envoyez "Monter" ou "Descendre" pour contrôler tous les volets/rideaux

Ceci est particulièrement utile pour créer des scènes ou des contrôles basés sur le temps qui affectent plusieurs dispositifs.

Déclenchement de scénarios

Les scénarios HyperVisu (groupes prédéfinis d'états de dispositifs) peuvent être déclenchés directement depuis Node-RED :

Ajoutez un nœud Scénario à votre flux
Configurez-le pour sélectionner le scénario spécifique dans la liste des scénarios disponibles
Connectez n'importe quel nœud de déclenchement à son entrée
Lorsqu'il est déclenché, le scénario s'exécutera comme s'il avait été activé depuis l'application mobile

Cela vous permet de créer des déclencheurs complexes pour vos scénarios basés sur le temps, des événements externes ou des données de capteurs.

Intégration des dispositifs IoT

Un des principaux avantages de l'intégration Node-RED est de connecter des dispositifs IoT non-KNX à votre système HyperVisu :

Intégration de capteurs externes :

Créez un widget virtuel dans HyperVisu
Ajoutez le nœud Node-RED correspondant (comme Entrée analogique)
Connectez une source de données externe (MQTT, HTTP, etc.) à ce nœud
Lorsque les données arrivent, elles mettent à jour le widget virtuel et apparaissent dans l'application HyperVisu

Contrôle des dispositifs externes :

Créez un widget de sortie virtuel dans HyperVisu
Ajoutez le nœud Node-RED correspondant (comme Interrupteur)
Connectez la sortie à un nœud qui contrôle votre dispositif externe (requête HTTP, publication MQTT, etc.)
Lorsque vous contrôlez le widget virtuel dans HyperVisu, cela déclenche l'action externe

Le courtier MQTT intégré peut être activé pour n'importe quel widget, diffusant ses changements d'état sur des sujets correspondant à l'ID de l'objet widget. Cela facilite la réponse d'autres dispositifs compatibles MQTT aux événements de votre maison.

Exemples d'intégration :

Connecter des API météo pour afficher les conditions extérieures sur des widgets virtuels
Contrôler des dispositifs intelligents utilisant différents protocoles
Enregistrer des données de consommation d'énergie à partir de compteurs intelligents dans InfluxDB
Construire une logique personnalisée pour des automatisations avancées basées sur plusieurs conditions

En tirant parti de cette intégration Node-RED, vous pouvez étendre HyperVisu au-delà de ses capacités KNX natives pour créer une solution de maison intelligente véritablement complète qui intègre tous vos systèmes.