Node-RED-Integration

Zugriff auf Node-RED

HyperVisu umfasst eine leistungsstarke Node-RED-Integration, die es Ihnen ermöglicht, benutzerdefinierte Automatisierungen zu erstellen und mit externen Systemen zu integrieren. Node-RED ist ein flowbasiertes Programmierwerkzeug, das es einfach macht, Hardwaregeräte, APIs und Online-Dienste ohne umfangreiche Programmierkenntnisse zu verbinden.

Um auf die Node-RED-Anwendung zuzugreifen:

Navigieren Sie zur HyperVisu-Administrationsoberfläche, indem Sie die IP-Adresse Ihres Servers in einen Webbrowser eingeben
Melden Sie sich mit Ihren Administrationsdaten (Benutzername und Passwort) an
Klicken Sie auf die Schaltfläche "Node-RED" auf der Serververwaltungsseite
Ein neuer Browser-Tab öffnet sich mit der Anmeldeseite von Node-RED
Verwenden Sie denselben Benutzernamen und dasselbe Passwort wie in der HyperVisu-Administrationsoberfläche, um auf Node-RED zuzugreifen

Hinweis: Die Node-RED-Umgebung läuft auf derselben Hardware wie Ihr HyperVisu-Server, sodass alle Integrationen lokal sind und keine externen Cloud-Dienste erfordern.

Verwendung von HyperVisu-Knoten

HyperVisu erweitert Node-RED, indem benutzerdefinierte Knoten hinzugefügt werden, die jeden Typ von Widget in Ihrem Hausautomationssystem darstellen. Diese Knoten ermöglichen es Ihnen, direkt von Node-RED aus mit Ihren KNX-Geräten zu interagieren.

Knotenstruktur

Die HyperVisu-Node-RED-Integration dreht sich um einen Hauptknoten "HyperVisu", der die Verbindung zum Server verwaltet und Zugriff auf alle Widgets, Räume und Kategorien bietet. Dieser Kernknoten stellt Folgendes her und hält es aufrecht:

Kommunikation mit dem Server
Echtzeitaktualisierungen der Widget-Werte

Zusätzliche benutzerdefinierte Knoten repräsentieren jeden verfügbaren Widgettyp in HyperVisu:

Taster - Für Taster mit optionalem Status-Feedback
Lichtschalter - Für EIN/AUS-Schalter speziell für Beleuchtung
Schalter EIN/AUS - Für allgemeine EIN/AUS-Schalter (Steckdosen usw.)
Analoge Ausgabe - Zum Senden analoger Werte innerhalb eines vordefinierten Bereichs
Rollladen/Jalousie - Zum Steuern von Rollläden und Jalousien
Temperaturregler - Für Heizungs-/Kühlungssteuerung
Dimmer - Für Standardbeleuchtungsdimmer
RGB-Dimmer - Zum Steuern von RGB(W)-Lichtern
Tunable White Dimmer - Zum Anpassen der Farbtemperatur von weißen Lichtern
Analoge Eingabe - Zum Anzeigen analoger Werte mit optionalem Trend
Digitale Eingabe - Zum Anzeigen digitaler Statuswerte

Globale Befehlsknoten sind ebenfalls verfügbar:

Globale Lichter - Zum Steuern aller Lichter in einem Raum oder einer Kategorie
Globale Rollläden - Zum Steuern aller Rollläden in einem Raum oder einer Kategorie
Szenario - Zum Auslösen vordefinierter Szenarien

Jeder Knoten zeigt seinen Namen und den zugehörigen Raum oder die Kategorie innerhalb des Knotens zur einfachen Identifizierung an.

Eingänge und Ausgänge

Widget-Knoten haben typischerweise mehrere Eingänge und Ausgänge, die den Funktionen des Widgets entsprechen. Zum Beispiel:

Dimmer-Knoten:

Eingänge: Umschalten, Ein, Aus, Sollwert (Dimmwert)
Ausgänge: Zustand (ein/aus-Status), Wert (Helligkeitsstufe), Ein-Befehl, Aus-Befehl

Rollladen/Jalousie-Knoten:

Eingänge: Hoch, Runter, Stop, Jalousie-Sollwert, Lamellen-Sollwert
Ausgänge: Hochfahren, Runterfahren, Jalousieposition, Lamellenposition, Hoch, Runter, Stop

Wenn ein Knoten Daten empfängt oder sendet:

Die Nachrichtenlast enthält den Wert des Aus- oder Eingangs
Ein Themenfeld enthält die Widget-Objekt-ID
Ein Widget-Feld enthält die Widget-ID

Diese standardisierten Formate erleichtern die Verarbeitung von Nachrichten zwischen Knoten und den Aufbau komplexer Automatisierungen.

Flows erstellen

Node-RED verwendet einen visuellen Programmieransatz, bei dem Sie Knoten miteinander verbinden, um "Flows" von Daten zu erstellen.

Knoten verbinden

Um einen Flow im Node-RED-Editor zu erstellen:

Finden Sie die HyperVisu-Knoten in der Knotenpalette auf der linken Seite
Ziehen Sie den gewünschten Knotentyp in den Flow
Verbinden Sie Knoten, indem Sie Linien vom Ausgang eines Knotens zum Eingang eines anderen ziehen
Knoten verarbeiten Nachrichten sequenziell, während sie durch die Verbindungen fließen

Grundlegende Flussmuster umfassen:

Trigger-Flows: Ein Triggerknoten (wie ein Eingangs- oder Zeitereignis) verursacht eine Aktion über einen Ausgangsknoten
Transformations-Flows: Daten durchlaufen Funktionsknoten, die Werte ändern, bevor sie die Ausgangsknoten erreichen
Entscheidungs-Flows: Schalterknoten leiten Nachrichten je nach empfangenen Werten unterschiedlich weiter
Integrations-Flows: Knoten aus verschiedenen Systemen (MQTT, HTTP usw.) verbinden sich, um Daten auszutauschen

Knoten konfigurieren

Jeder HyperVisu-Knoten muss konfiguriert werden, um sich mit einem bestimmten Widget in Ihrem System zu verbinden:

Doppelklicken Sie auf einen Knoten, um sein Konfigurationspanel zu öffnen
Verwenden Sie das Dropdown-Menü, um das Widget auszuwählen, mit dem es verbunden werden soll
- Filtern Sie Optionen nach Raum, Kategorie und Widgettyp, um das richtige Widget zu finden
- Die Liste zeigt alle Widgets mit demselben Typ, die in Ihrer HyperVisu-Konfiguration verfügbar sind
Aktivieren/deaktivieren Sie die MQTT-Broker-Publikation, falls erforderlich (sendet Widget-Werte an den integrierten MQTT-Broker)
Klicken Sie auf Fertig, um die Konfiguration zu speichern

Für virtuelle Widgets können Sie Werte direkt von Node-RED senden, um den Status des Widgets zu aktualisieren, sodass Sie Sensoren oder Systeme integrieren können, die nicht direkt mit Ihrem KNX-Bus verbunden sind.

Flows bereitstellen

Nachdem Sie Ihre Flows erstellt und konfiguriert haben:

Klicken Sie auf die Schaltfläche Bereitstellen in der oberen rechten Ecke der Node-RED-Oberfläche
Warten Sie auf die Bestätigungsnachricht, die eine erfolgreiche Bereitstellung anzeigt
Ihre Flows sind jetzt aktiv und beginnen mit der Verarbeitung von Daten

Die Node-RED-Umgebung speichert Ihre Flows automatisch, und sie werden neu gestartet, wenn der HyperVisu-Server neu gestartet wird.

Sie können den Flussstatus in Echtzeit anzeigen:

Aktive Verbindungen zeigen Statusanzeigen mit Werten
Fehler erscheinen im Debug-Panel (erreichbar über die rechte Seitenleiste)
Daten können mithilfe von Debug-Knoten, die im Flow platziert sind, nachverfolgt werden

Erweiterte Funktionen

Integration globaler Befehle

Globale Befehle ermöglichen es Ihnen, mehrere Geräte gleichzeitig zu steuern:

Fügen Sie einen Global Lights- oder Global Shutters-Knoten zu Ihrem Flow hinzu
Konfigurieren Sie ihn, um einen bestimmten Raum oder eine Kategorie anzusprechen
Senden Sie eine "Ein"- oder "Aus"-Nachricht an den Eingang des Knotens, um alle Lichter in diesem Raum zu steuern
Für Rollläden senden Sie "Hoch" oder "Runter", um alle Jalousien/Rollläden zu steuern

Dies ist besonders nützlich, um Szenen oder zeitgesteuerte Steuerungen zu erstellen, die mehrere Geräte betreffen.

Szenarioauslösung

HyperVisu-Szenarien (vordefinierte Gruppen von Geräteständen) können direkt von Node-RED aus ausgelöst werden:

Fügen Sie einen Szenario-Knoten zu Ihrem Flow hinzu
Konfigurieren Sie ihn, um das spezifische Szenario aus der Liste der verfügbaren Szenarien auszuwählen
Verbinden Sie einen beliebigen Triggerknoten mit seinem Eingang
Wenn das Szenario ausgelöst wird, wird es ausgeführt, als ob es über die mobile App aktiviert wurde

Dies ermöglicht es Ihnen, komplexe Trigger für Ihre Szenarien basierend auf Zeit, externen Ereignissen oder Sensordaten zu erstellen.

IoT-Geräteintegration

Ein großer Vorteil der Node-RED-Integration besteht darin, nicht-KNX-IoT-Geräte mit Ihrem HyperVisu-System zu verbinden:

Integration externer Sensoren:

Erstellen Sie ein virtuelles Widget in HyperVisu
Fügen Sie den entsprechenden Node-RED-Knoten (wie Analogeingang) hinzu
Verbinden Sie eine externe Datenquelle (MQTT, HTTP usw.) mit diesem Knoten
Wenn Daten ankommen, aktualisiert es das virtuelle Widget und erscheint in der HyperVisu-App

Steuerung externer Geräte:

Erstellen Sie ein virtuelles Ausgangs-Widget in HyperVisu
Fügen Sie den entsprechenden Node-RED-Knoten (wie Schalter) hinzu
Verbinden Sie den Ausgang mit einem Knoten, der Ihr externes Gerät steuert (HTTP-Anfrage, MQTT-Veröffentlichung usw.)
Wenn Sie das virtuelle Widget in HyperVisu steuern, wird die externe Aktion ausgelöst

Der integrierte MQTT-Broker kann für jedes Widget aktiviert werden, das seine Statusänderungen auf Themen überträgt, die mit der Widget-Objekt-ID übereinstimmen. Dies erleichtert es, dass andere MQTT-fähige Geräte auf Ereignisse in Ihrem Zuhause reagieren.

Integrationsbeispiele:

Verbinden Sie Wetter-APIs, um die Außentemperaturen auf virtuellen Widgets anzuzeigen
Steuern Sie intelligente Geräte, die unterschiedliche Protokolle verwenden
Erfassen Sie den Energieverbrauch von Smart Metern in InfluxDB
Erstellen Sie benutzerdefinierte Logik für fortgeschrittene Automatisierungen basierend auf mehreren Bedingungen

Durch die Nutzung dieser Node-RED-Integration können Sie HyperVisu über seine nativen KNX-Funktionen hinaus erweitern, um eine wirklich umfassende Smart-Home-Lösung zu schaffen, die alle Ihre Systeme integriert.