Node-RED
Node-RED est un outil de programmation par flux (flow-based) qui permet de câbler visuellement des équipements, des API et des services. Il s'exécute dans des environnements très variés : conteneur Docker, Raspberry Pi, serveur, ou encore embarqué sur une passerelle industrielle.
Le template d'interfaçage dDruid est un flow Node-RED prêt à l'emploi qui envoie les données circulant dans votre flow vers la plateforme IoT magic Builder. Il est indépendant de la source : que vos valeurs proviennent de MQTT, d'une API HTTP, de Modbus, d'OPC-UA ou de capteurs LoRa, le principe reste identique.
Son rôle se résume à deux opérations réutilisables :
- Construire un stream au format dDruid à partir de votre message ;
- Publier ce stream vers dDruid, en HTTPS (recommandé) ou en MQTT sécurisé (MQTTS).
Le format des données est identique dans les deux cas : seul le transport change. Le HTTPS ne demande qu'un unique nœud http request, sans configuration de broker — c'est le plus simple et le plus universel.
Fonctionnement
| Étape | Description |
|---|---|
| 1. Collecte | N'importe quel nœud source alimente le flow (MQTT in, HTTP, Modbus, OPC-UA, capteur, inject…) |
| 2. Formatage | Un nœud function transforme vos valeurs en stream au format v2 / dataset S1 |
| 3. Publication | Le stream est envoyé à dDruid en HTTPS (POST /streams) ou en MQTTS (topic {apiKey}/streams) |
Architecture
Seule la partie source (à gauche) change selon votre installation. La partie Build stream est commune à toutes les intégrations ; le transport final (HTTPS ou MQTTS) est au choix.
Cas d'usage
- Remonter vers dDruid des données déjà présentes dans un flow Node-RED (supervision Modbus, messages MQTT, relevés d'API…)
- Centraliser des sources hétérogènes sur une même instance Node-RED, sans backend intermédiaire à héberger
- Prototyper rapidement une intégration avant industrialisation
- Faire le pont entre un protocole terrain (LoRa, Modbus, OPC-UA) et la plateforme dDruid
Prérequis
| Élément | Détail |
|---|---|
| Instance Node-RED | Une instance Node-RED opérationnelle (Docker, Raspberry Pi, serveur, passerelle…) |
| Une source de données | Un flux de valeurs disponible dans Node-RED (peu importe le protocole d'origine) |
| Équipement dDruid | Un équipement créé sur IoT magic Builder, avec son Device developer ID (UUID) |
| Clé API dDruid | Récupérable depuis l'interface d'Administration, dans la section Connect de l'équipement |
| Accès réseau sortant | En HTTPS : streams-api.magicbuilder.io (port 443). En MQTTS : streams-mqtt.magicbuilder.io (port 8883) |
Chaque flux de données doit être associé à un Device developer ID dDruid. Un même flow Node-RED peut alimenter plusieurs équipements dDruid.
