Aan de slag met Node-RED

Laatst bijgewerkt:

Inleiding

Node-RED is een opensource ontwikkeltool op basis van flows voor het verbinden van apparaten, API’s en onlinediensten. Met de browsereditor bouw je workflows voor gegevensverwerking en automatisering door nodes met elkaar te verbinden. Dit is handig voor IoT en industriële edge-toepassingen.

In deze handleiding installeren we Node-RED op een reComputer RK Series-apparaat, voltooien we de eerste configuratie, openen we de webeditor en implementeren we een eenvoudige testflow.

Hardware- en softwarevereisten

OnderdeelVereiste
Edge-apparaatreComputer RK Series-apparaat
Besturingssysteem64-bits Linux op basis van Debian, zoals Debian of Armbian
NetwerkInternettoegang voor de installatie en toegang tot het apparaat via het lokale netwerk
ToegangTerminal of SSH met sudo-rechten
ClientEen computer met een moderne webbrowser

Stap 1: Verbinding maken met het reComputer RK-apparaat

Maak verbinding met het board via een terminal of SSH. Bijvoorbeeld:

bash
ssh seeed@<DEVICE_IP>

Vervang <DEVICE_IP> door het IP-adres van je board en seeed door de werkelijke gebruikersnaam als die anders is.

Controleer de systeemarchitectuur en Linux-distributie:

bash
uname -m
cat /etc/os-release

Op een 64-bits RK-systeem moet de architectuur aarch64 zijn.

Stap 2: Node-RED installeren

Installeer de pakketten die het officiële installatieprogramma nodig heeft:

bash
sudo apt update
sudo apt install -y curl git build-essential ca-certificates

Voer het officiële Node-RED-installatieprogramma voor Debian uit:

bash
bash <(curl -fsSL https://github.com/node-red/linux-installers/releases/latest/download/install-update-nodered-deb) --node22 --skip-pi

De optie --node22 installeert Node.js 22. --skip-pi slaat Raspberry Pi-specifieke nodes over die de RK-serie niet nodig heeft. Het installatieprogramma installeert Node-RED en configureert de systeemservice.

Voer het installatieprogramma uit als je gewone Linux-gebruiker met sudo-rechten, zonder sudo vóór de volledige opdracht te zetten. Bevestig de installatie wanneer daarom wordt gevraagd en volg de instructies op het scherm.

Stap 3: De eerste configuratie voltooien

Volg bij een nieuwe installatie de vragen voor de initialisatie van de Node-RED-instellingen wanneer deze verschijnen. Als de initialisatie is overgeslagen en er nog geen instellingenbestand bestaat, voer je de volgende opdracht uit als dezelfde gebruiker die Node-RED heeft geïnstalleerd:

bash
node-red admin init

Initialisatie van Node-RED-instellingen

De configuratie wordt opgeslagen in de gebruikersmap van Node-RED. Voor een Linux-gebruiker met de naam seeed is het standaardpad:

text
/home/seeed/.node-red/settings.js

Gebruik de editor voor de veiligheid op een vertrouwd netwerk en stel poort 1880 niet rechtstreeks bloot aan het openbare internet. Het beheerderswachtwoord wordt ingesteld voor de webeditor.

Stap 4: De installatie controleren en Node-RED starten

Controleer de geïnstalleerde versies:

bash
node -v
npm -v
node-red --version

Start de Node-RED-service:

bash
node-red-start

Deze opdracht start de achtergrondservice en toont continu de logboeken. Druk op Ctrl+C om de logweergave te verlaten; de service blijft actief.

Controleer na het verlaten van de logweergave in dezelfde of een andere terminal of de service actief is:

bash
sudo systemctl status nodered.service --no-pager

De service moet active (running) aangeven.

Schakel automatisch starten na een herstart in:

bash
sudo systemctl enable nodered.service

Stap 5: De Node-RED-webeditor openen

Zoek het IP-adres van je reComputer RK-apparaat:

bash
hostname -I

Open het volgende adres op een computer in hetzelfde netwerk:

text
http://<DEVICE_IP>:1880

Node-RED gebruikt standaard poort 1880. Als je gebruikersbeveiliging tijdens de initialisatie hebt ingeschakeld, meld je je aan met het aangemaakte account.

De Node-RED-floweditor verschijnt, met het nodepalet links, de werkruimte in het midden en de zijpanelen rechts.

Node-RED-floweditor

Stap 6: Je eerste flow maken en uitvoeren

We maken een eenvoudige flow met de ingebouwde nodes Inject en Debug.

  1. Zoek de inject-node in het linkerpalet en sleep deze naar de werkruimte.

  2. Dubbelklik op de Inject-node. Stel msg.payload in als string met de waarde Hello from reComputer RK Series! en klik op Done.

    Payload van de Inject-node instellen

  3. Sleep een debug-node naar de werkruimte.

  4. Verbind de uitgang van de Inject-node met de ingang van de Debug-node.

  5. Klik rechtsboven op Deploy om de flow te implementeren.

  6. Open het zijpaneel Debug messages en klik op de kleine knop links van de Inject-node.

Het Debug-zijpaneel moet het volgende weergeven:

text
Hello from reComputer RK Series!

Inject-naar-Debug-flow en berichtuitvoer

Dit bevestigt dat de Node-RED-editor een flow op het RK-apparaat kan implementeren en uitvoeren.

Stap 7: Handige opdrachten voor de Node-RED-service

ActieOpdracht
Node-RED startennode-red-start
Node-RED stoppennode-red-stop
Node-RED opnieuw startennode-red-restart
Logboeken bekijkennode-red-log
Servicestatus controlerensudo systemctl status nodered.service --no-pager
Automatisch starten bij het opstarten inschakelensudo systemctl enable nodered.service

Conclusie

Je hebt Node-RED geïnstalleerd op een reComputer RK Series-apparaat, de editor geconfigureerd, de achtergrondservice ingeschakeld en een eenvoudige flow geïmplementeerd. Node-RED kan nu dienen als basis voor edge-IoT-toepassingen met protocollen zoals MQTT en Modbus TCP, die in afzonderlijke handleidingen kunnen worden behandeld.

Referenties