Premiers pas avec Node-RED

Dernière mise à jour:

Introduction

Node-RED est un outil de développement open source basé sur les flux, destiné à connecter des appareils, des API et des services en ligne. Son éditeur web permet de créer des processus de traitement des données et d’automatisation en reliant des nœuds, ce qui convient aux applications IoT et industrielles en périphérie.

Dans ce tutoriel, nous allons installer Node-RED sur un appareil reComputer RK Series, effectuer la configuration initiale, ouvrir l’éditeur web et déployer un flux de test simple.

Configuration matérielle et logicielle requise

ÉlémentExigence
Appareil en périphérieAppareil reComputer RK Series
Système d’exploitationLinux 64 bits basé sur Debian, par exemple Debian ou Armbian
RéseauAccès Internet pour l’installation ; accès à l’appareil sur le réseau local
AccèsTerminal ou SSH avec les privilèges sudo
ClientUn ordinateur doté d’un navigateur web moderne

Étape 1 : Se connecter à l’appareil reComputer RK

Connectez-vous à la carte depuis un terminal ou par SSH. Par exemple :

bash
ssh seeed@<DEVICE_IP>

Remplacez <DEVICE_IP> par l’adresse IP de la carte et seeed par le nom d’utilisateur réel s’il est différent.

Vérifiez l’architecture du système et la distribution Linux :

bash
uname -m
cat /etc/os-release

Sur un système RK 64 bits, l’architecture doit être aarch64.

Étape 2 : Installer Node-RED

Installez les paquets nécessaires au programme d’installation officiel :

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

Exécutez le programme d’installation officiel de Node-RED pour Debian :

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

L’option --node22 installe Node.js 22, tandis que --skip-pi ignore les nœuds spécifiques au Raspberry Pi qui ne sont pas nécessaires à la série RK. Le programme installe Node-RED et configure son service système.

Exécutez le programme avec votre utilisateur Linux habituel disposant des privilèges sudo, sans préfixer la commande complète par sudo. Confirmez l’installation lorsque cela est demandé et suivez les instructions à l’écran.

Étape 3 : Effectuer la configuration initiale

Lors d’une nouvelle installation, répondez aux invites d’initialisation des paramètres Node-RED lorsqu’elles apparaissent. Si l’initialisation a été ignorée et qu’aucun fichier de configuration n’existe encore, exécutez la commande suivante avec le même utilisateur que celui ayant installé Node-RED :

bash
node-red admin init

Initialisation des paramètres Node-RED

La configuration est enregistrée dans le répertoire utilisateur de Node-RED. Pour un utilisateur Linux nommé seeed, le chemin par défaut est :

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

Pour des raisons de sécurité, utilisez l’éditeur sur un réseau de confiance et n’exposez pas directement le port 1880 à Internet. Le mot de passe administrateur est configuré pour l’éditeur web.

Étape 4 : Vérifier l’installation et démarrer Node-RED

Vérifiez les versions installées :

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

Démarrez le service Node-RED :

bash
node-red-start

Cette commande démarre le service en arrière-plan et affiche ses journaux en continu. Appuyez sur Ctrl+C pour quitter l’affichage des journaux ; le service continue de fonctionner.

Après avoir quitté l’affichage des journaux, vérifiez que le service fonctionne dans le même terminal ou dans un autre :

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

Le service doit indiquer active (running).

Activez le démarrage automatique après un redémarrage :

bash
sudo systemctl enable nodered.service

Étape 5 : Accéder à l’éditeur web Node-RED

Recherchez l’adresse IP de votre appareil reComputer RK :

bash
hostname -I

Depuis un ordinateur sur le même réseau, ouvrez :

text
http://<DEVICE_IP>:1880

Node-RED utilise le port 1880 par défaut. Si vous avez activé la sécurité utilisateur lors de l’initialisation, connectez-vous avec le compte créé.

L’éditeur de flux Node-RED apparaît, avec la palette de nœuds à gauche, l’espace de travail au centre et les panneaux latéraux à droite.

Éditeur de flux Node-RED

Étape 6 : Créer et exécuter votre premier flux

Nous allons créer un flux simple avec les nœuds intégrés Inject et Debug.

  1. Recherchez le nœud inject dans la palette de gauche et faites-le glisser dans l’espace de travail.

  2. Double-cliquez sur le nœud Inject. Définissez msg.payload sur le type string avec la valeur Hello from reComputer RK Series!, puis cliquez sur Done.

    Configurer le contenu du nœud Inject

  3. Faites glisser un nœud debug dans l’espace de travail.

  4. Reliez la sortie du nœud Inject à l’entrée du nœud Debug.

  5. Cliquez sur Deploy en haut à droite pour déployer le flux.

  6. Ouvrez le panneau Debug messages et cliquez sur le petit bouton à gauche du nœud Inject.

Le panneau Debug doit afficher :

text
Hello from reComputer RK Series!

Flux Inject vers Debug et sortie du message

Cela confirme que l’éditeur Node-RED peut déployer et exécuter un flux sur l’appareil RK.

Étape 7 : Commandes utiles du service Node-RED

ActionCommande
Démarrer Node-REDnode-red-start
Arrêter Node-REDnode-red-stop
Redémarrer Node-REDnode-red-restart
Afficher les journauxnode-red-log
Vérifier l’état du servicesudo systemctl status nodered.service --no-pager
Activer le démarrage automatiquesudo systemctl enable nodered.service

Conclusion

Vous avez installé Node-RED sur un appareil reComputer RK Series, configuré l’éditeur, activé son service en arrière-plan et déployé un flux simple. Node-RED peut désormais servir de base à des applications IoT en périphérie utilisant des protocoles comme MQTT et Modbus TCP, qui pourront être abordés dans des tutoriels distincts.

Références