Hilfe

Node-RED Nodes einrichten

Installation

Installiere als erstes Remote-RED in Node-RED. Verwende hierzu “Palette verwalten” innerhalb des Node-RED Editors und installiere das Paket

node-red-contrib-remote

Access-Node

Die Access-Node ermöglicht Dir von der App lokal oder auch remote aus der Ferne auf eine Webseite zuzugreifen. In der Regel ist dies Dein Dashboard oder eine Seite des UI-Builders.

Erstelle eine Node vom Typ “remote access” für jede Seite, auf die Du zugreifen möchtest. Neben dem Namen enthält diese Node lediglich eine Config-Node. Die Konfiguration ist in die Config-Node ausgelagert, da diese Einstellungen auch für weitere Funktionen wie Push Notifications genutzt werden.

Config-Node

Pro Access-Node erstellt Du eine entsprechende Config-Node. In dieser wird hinterlegt, mit welchem Host, Port und URL die Verbindung stattfindet. Die Vorgabewerte zeigen als Beispiel das Dashboard. Es ist aber auch möglich weitere Seiten aus dem lokalen Netzwerk zu konfigurieren, insofern der Server auf dem Node-RED installiert ist darauf zugreifen kann.

  • Name: Mit diesem Titel wird die Seite später in der App angezeigt.
  • Protokoll: Das verwendete Protokoll des Webservers. Bei Node-RED ist dies normalerweise http, über die settings.js kann dies jedoch auf https umgestellt werden.
  • Host: Die lokale IP des Host, dessen Webseite freigegeben werden soll. “localhost” verwendet den Node-RED Server auf dem die Access-Node läuft.
  • Port: Der Port der weitergeleitet wird. Bei Node-RED ist dies normalerweise 1880, bei sonstigen Webseiten meist 80.
  • Basis URL: Die initial aufzurufende Seite.

Den Standort des Servers kannst Du nur einmalig bearbeiten. Hier gibst Du an, in welcher Ecke der Welt der Server stehen soll, über den Deine Webseite geoutet wird. Für eine möglichst schnelle Verbindung wähle den Ort, der am nächsten bei Dir ist.

Sobald Du diese Einstellungen erstellt hast und die iOS oder Android App installiert hast, kannst Du über die Schaltfläche “Remote-RED App verbinden” eine App verbinden. Hierzu mehr im Abschnitt App verbinden.

Notification-Node

Über diese Node kannst Du eine Push Notification an die Geräte versenden, die mit der gewählten Config-Node verbunden sind. Wähle hierzu eine Config-Node, die Du auch z.B. bereits in einer Access-Node verwendest. Du kannst in mehreren Notification-Nodes die selbe Config-Node verwenden.

Konfiguriere den Titel und den Text der Benachrichtigung. Die Vorgabewerte gehen davon aus, das im Payload der eingehenden Notification die Strings “title” und “body” enthalten sind. Du kannst aber auch feste Texte eingeben oder Flow- bzw. Global-Variablen verwenden.

Immer sobald eine Message bei der Notification-Node ankommt, wird eine Notification an Deine Geräte versendet.

Question-Node

Über diese Node kannst Du eine Frage per Push Notification an die Geräte versenden, die mit der gewählten Config-Node verbunden sind. Wähle hierzu eine Config-Node, die Du bereits in einer Access-Node verwendest. Du kannst in mehreren Question-Nodes die selbe Config-Node verwenden.

Wichtig ist, das die Confg-Node auf Deinen lokalen Node-RED Rechner verweist und eine Access-Node damit aktiv ist. Die Basis URL ist dabei irrelevant.

Konfiguriere den Titel und den Text der Benachrichtigung. Die Vorgabewerte gehen davon aus, das im Payload der eingehenden Nachricht die Strings “title” und “body” enthalten sind. Du kannst aber auch feste Texte eingeben oder Flow- bzw. Global-Variablen verwenden.

Du kannst bis zu drei Antworten vorgeben. Der Text der Antworten kannst Du direkt als String eingeben oder aus der eingehenden Nachricht übernehmen. Ist der Text leer, wird die Antwort nicht angezeigt. Über den Wert kannst Du angeben, was die Node per msg.payload ausgibt, wenn Du diese Antwort wählst.

Immer sobald eine Message bei der Question-Node ankommt, wird eine Notification an Deine Geräte versendet.

App installieren und verbinden

App installieren

Die Apps kannst Du aus dem Apple AppStore bzw. aus dem Google PlayStore installieren. Die App wird Dich nach dem ersten Start um das Recht bitten, Dir Push Notifications zu senden. Erlaube dies, insofern Du die Notification Funktion nutzen möchtest.

Instanzen

Innerhalb der App wird immer wieder von einer Node-RED Instanz gesprochen. Eine Instanz ist die Verbindung mit einer Config-Node aus Node-RED. Innerhalb der App kannst Du mehrere Instanzen, also lokale Seiten, hinzufügen.

Solange die App nicht mit mindestens einer Config-Node verbunden ist, kannst Du mit Ihr nicht viel anfangen.

App verbinden

Durch das Verbinden werden Zertifikate zum Zugriff auf Deine lokale Seite an die App übertragen. Ebenfalls wird die Konfiguration übertragen. Für nachträgliche Änderungen an diesen Feldern muss die Instanz in der App gelöscht und neu verbunden werden.

Öffne in Node-RED die Config-Node, die Du verbinden möchtest. Drücke die Schaltfläche “Remote-RED App verbinden”. Die Config-Node nimmt nun Verbindung mit einem der Remote-RED Servern auf und stellt kurz darauf einen QR-Code dar.

Verwende innerhalb der App die Funktion “Node-RED Instanz verbinden” und scanne den QR-Code. Die App sollte nun verbunden sein. Um weitere Apps (z.B. auf einem anderen Handy) zu verbinden, drücke den Button erneut und generiere dadurch einen weiteren QR-Code.

Ganz wichtig ist, dass Du die Config-Node mit “Hinzufügen” bzw. “Aktualisieren” verlässt und danach die Änderungen mit “deploy” speicherst.