Ziel: Einen einfachen Node-RED-Flow erstellen, der einen digitalen Ausgang eines Revolution Pi Systems mit einem RevPi DIO ansteuert und damit eine externe LED ein- und ausschaltet.

Node-RED ist eine browserbasierte Programmierumgebung, die keine tiefgehenden Programmierkenntnisse erfordert. Sie basiert auf einem Flow-Prinzip: Funktionsblöcke (Nodes) werden visuell miteinander verbunden, um Datenflüsse zu definieren.

Dieses Tutorial ist anwendbar mit allen Basismodulen der RevPi Core und RevPi Connect Serie und den Erweiterungsmodulen RevPi DIO oder RevPi MIO. Hier werden beispielhaft ein RevPi Connect 4 mit einem RevPi DIO verwendet.

Voraussetzungen #

Geräte #

✓ Basismodul RevPi Connect 4

✓ Erweiterungsmodul RevPi DIO

✓ Externe LED-Signallampe mit 24 V

Hardware-Installation #

✓ RevPi Basis- und Erweiterungsmodul sind über die PiBridge verbunden.

✓ RevPi Basismodul ist mit dem Netzwerk verbunden.

✓ RevPi Basismodul ist an die Spannungsversorgung angeschlossen.

✓ RevPi Erweiterungsmodul und die Ein- und Ausgänge sind an die Spannungsversorgung angeschlossen.

✓ Externe Signallampe ist an den ersten Ausgangskanal des RevPi Erweiterungsmoduls angeschlossen.

system architecture

Software-Installation #

✓ RevPi Bookworm oder höher ist auf dem RevPi installiert.

✓ Webbrowser auf deinem PC

✓ Es besteht eine Netzwerkverbindung zwischen dem RevPi und deinem PC.

1. Hardware in PiCtory konfigurieren #

Bevor Node-RED auf die Ein- und Ausgänge des RevPi zugreifen kann, muss die angeschlossene Hardware über die Applikation PiCtory konfiguriert werden. Es wird festgelegt, welche Module verbunden sind und wie deren Ein- und Ausgänge im Prozessabbild benannt werden. Diese Namen werden später in Node-RED verwendet, um gezielt einzelne Ausgänge anzusprechen.

▷ Logge dich über einen Webbrowser auf dem RevPi ein.

❯ Die Applikation Cockpit ist geöffnet.

▷ Öffne PiCtory.

▷ Ziehe das RevPi Basismodul aus dem Device Catalog auf den leeren Slot mit der Positionsnummer 0.

▷ Ziehe das RevPi DIO aus dem Device Catalog links neben das Basismodul.

▷ Weise für das RevPi DIO im Value Editor dem Output O_1 den Namen Output1_LED zu.

PiCtory configuration

▷ Speichere die Konfiguration mit File › Save as.

▷ Starte mit Tools › Reset Driver den piControl Treiber neu, um die Änderungen anzuwenden.

2. Flow in Node-RED erstellen #

Flow manuell erstellen #

Node-RED starten

▷ Richte Node-RED ein, wenn du es zum ersten Mal verwendest.

▷ Konfiguriere und öffne Node-RED.

Dashboard-Paket installieren

▷ Wähle im Menü Manage palette.

❯ Das Fenster Palette öffnet sich.

▷ Wechsle in den Tab Install.

▷ Suche nach dem Paket node-red-dashboard.

▷ Wähle Install, falls das Paket noch nicht installiert ist.

❯ In der Palette stehen zusätzliche Dashboard-Nodes zur Verfügung.

Dashboard-Node Switch anlegen

▷ Ziehe aus der Dashboard-Palette einen Node switch auf die Arbeitsfläche.
Mit diesem Node schaltest du den LED-Status um.

▷ Öffne den Node switch, um ihn zu konfigurieren.

▷ Vergebe einen Gruppennamen, z. B. LED Control.

▷ Gib einen Namen ein, z. B. ON/OFF.

▷ Bestätige mit Done.

Switch configuration
Node RevPi Output anlegen

Der Node RevPi Output aus der Palette Revolution Pi leitet das Signal an den physischen Ausgang weiter.

▷ Ziehe den Node revpi-output auf die Arbeitsfläche.

▷ Öffne den Node, um ihn zu konfigurieren.

▷ Wähle das Stift-Symbol neben Server, um einen neuen Server anzulegen.

▷ Gib als Host die IP-Adresse des RevPi und als Port 8000 ein.

▷ Gib User und Password des RevPi ein.

▷ Bestätige mit Update.

▷ Wähle im Feld Pin den Ausgang PIN: Output1_LED aus.

▷ Bestätige mit Done.

▷ Verbinde auf der Arbeitsfläche den Ausgang des Switch-Nodes mit dem Eingang des Output-Nodes.

Debug-Node anlegen

Die Aufgabe des Debug-Nodes besteht darin, Debugging-Informationen anzuzeigen. Er unterstützt bei der Fehlersuche, indem er die Nachrichten listet, die durch den Flow fließen.

▷ Ziehe den Node debug auf die Arbeitsfläche.

▷ Verbinde den Ausgang des Switch-Nodes mit dem Eingang des Debug-Nodes.

▷ Wähle Deploy in der oberen rechten Ecke der Oberfläche, um den Node-RED Flow anzuwenden.

Flow Active

❯ Der Flow ist aktiviert.

Alternativ: Vorgefertigten Flow verwenden #

Dieser Flow kann alternativ mit dem unten bereitgestellten JSON-Export erstellt werden. Er enthält alle notwendigen Nodes, bereits korrekt konfiguriert und verbunden.

✓ Dashboard-Paket ist installiert.

▷ Kopiere den folgenden JSON-Export:

[
 {
     "id": "45371098831c2f50",
     "type": "tab",
     "label": "Flow 1",
     "disabled": false,
     "info": "",
     "env": []
 },
 {
     "id": "dd91c103fca0df54",
     "type": "ui_switch",
     "z": "45371098831c2f50",
     "name": "ON/OFF",
     "label": "switch",
     "tooltip": "",
     "group": "c5aa454786599927",
     "order": 0,
     "width": 0,
     "height": 0,
     "passthru": true,
     "decouple": "false",
     "topic": "topic",
     "topicType": "msg",
     "style": "",
     "onvalue": "true",
     "onvalueType": "bool",
     "onicon": "",
     "oncolor": "",
     "offvalue": "false",
     "offvalueType": "bool",
     "officon": "",
     "offcolor": "",
     "animate": false,
     "className": "",
     "x": 340,
     "y": 300,
     "wires": [
         [
             "b97624cf8482ce4c",
             "76cf80f93d913ac5"
         ]
     ]
 },
 {
     "id": "b97624cf8482ce4c",
     "type": "revpi-output",
     "z": "45371098831c2f50",
     "server": "23bf8ad0f3c174d6",
     "outputpin": "Output1_LED",
     "overwritevalue": false,
     "outputvalue": "",
     "x": 620,
     "y": 300,
     "wires": []
 },
 {
     "id": "76cf80f93d913ac5",
     "type": "debug",
     "z": "45371098831c2f50",
     "name": "debug 1",
     "active": true,
     "tosidebar": true,
     "console": false,
     "tostatus": false,
     "complete": "false",
     "statusVal": "",
     "statusType": "auto",
     "x": 680,
     "y": 460,
     "wires": []
 },
 {
     "id": "c5aa454786599927",
     "type": "ui_group",
     "name": "Standard",
     "tab": "dfde44665fc52d64",
     "order": 1,
     "disp": true,
     "width": "6",
     "collapse": false,
     "className": ""
 },
 {
     "id": "23bf8ad0f3c174d6",
     "type": "revpi-server",
     "host": "<your IP_address>",
     "port": "8000",
     "user": "pi",
     "password": "<your_password>",
     "rejectUnauthorized": false,
     "ca": ""
 },
 {
     "id": "dfde44665fc52d64",
     "type": "ui_tab",
     "name": "Home",
     "icon": "dashboard",
     "disabled": false,
     "hidden": false
 }
]

▷ Wähle im Node-RED-Editor im Menü Import.

▷ Füge den JSON-Export in das leere Fenster ein.

▷ Bestätige mit Import.

▷ Platziere die importierten Nodes auf dem Arbeitsbereich und wähle Deploy, um den Flow zu aktivieren.

3. Flow testen #

▷ Öffne das Node-RED-Dashboard in deinem Webbrowser mit:

http://<revpi_ip_address>:41880/ui

▷ Verwende den ON/OFF-Schalter switch im Dashboard, um die Anwendung zu testen.

❯ Beim Umschalten des Schalters wird ein Boolescher Wert (true oder false) an den Node Pin: Output1_LED gesendet, der den LED-Status simuliert.

❯ Die Payload wird im Debug-Bereich des Node-RED-Editors angezeigt.

Node-RED flow debug

❯ Die LED leuchtet auf, wenn der Schalter im Node-RED-Dashboard auf ON gestellt wird.

Weitere Ressourcen #