KI-GESTÜTZTE DOKUMENTATION
Was möchten Sie wissen?
Node-RED Grundlagen
Diese Seite bietet eine Einführung in Node-RED, wie es im OV20i-Kamerasystem implementiert ist, und erläutert die wichtigsten Konzepte und Funktionen, die Ihnen helfen, leistungsstarke Inspektions-Workflows zu erstellen.
Was ist Node-RED?
Node-RED ist ein flussbasiertes Programmierwerkzeug, das einen browserbasierten Editor zur visuellen Verbindung von Hardwaregeräten, APIs und Online-Diensten bereitstellt. Ursprünglich von IBM entwickelt, ist es heute ein Open-Source-Projekt, das einen Low-Code-Ansatz für Automatisierung und Datenverarbeitung bietet.
Die OV20i-Kamera nutzt Node-RED als Automatisierungsplattform und ermöglicht es Ihnen, anspruchsvolle Inspektions-Workflows mit minimalen Programmierkenntnissen zu erstellen. Über eine einfache Drag-and-Drop-Oberfläche können Sie schnell komplexe Logik entwickeln, die andernfalls umfangreiche Programmierkenntnisse erfordern würde.
Wichtige Konzepte in Node-RED
Flows
Flows sind die visuellen Darstellungen Ihrer automatisierten Prozesse. Jeder Flow besteht aus Nodes, die durch Wires verbunden sind und darstellen, wie Daten durch das System fließen. Die OV20i-Kamera verwendet Flows, um Inspektionsergebnisse zu verarbeiten und mit externen Systemen zu kommunizieren.
Nodes
Nodes sind die Bausteine Ihrer Flows und repräsentieren jeweils eine bestimmte Funktion oder Fähigkeit:
- Input Nodes – Empfangen Daten (z. B. Kamera-Trigger, HTTP-Anfragen)
- Processing Nodes – Transformieren oder analysieren Daten (z. B. Klassifizierungslogik)
- Output Nodes – Senden Daten an externe Systeme oder lösen Aktionen aus (z. B. SPS-Kommunikation)
Nachrichten
Nodes kommunizieren miteinander, indem sie Nachrichten austauschen. Im OV20i-System enthalten diese Nachrichten häufig:
- Inspektionsergebnisse
- Metadaten über inspizierte Objekte
- Befehle für externe Systeme
- Trigger-Signale
Kontextspeicher
Node-RED bietet eine Methode zum Speichern von Informationen, die zwischen verschiedenen Nodes geteilt werden können, ohne auf Nachrichten angewiesen zu sein, die durch einen Flow geleitet werden.
Der „Scope" eines bestimmten Kontextwerts bestimmt, wer darauf zugreifen kann:
| Scope-Typ | Sichtbarkeit | Anwendungsfall |
|---|---|---|
| Node Context | Nur sichtbar für den Node, der den Wert gesetzt hat | Speichern node-spezifischer temporärer Zustandsinformationen |
| Flow Context | Sichtbar für alle Nodes im selben Flow (Tab) | Datenaustausch zwischen Nodes innerhalb desselben Flows |
| Global Context | Sichtbar für alle Nodes über alle Flows hinweg | Anwendungsweiter Zustand oder Konfiguration |
Vorteile des Kontextspeichers
- Datenpersistenz – Speichern von Daten zwischen Nachrichtenflüssen
- Scope-Flexibilität – Verschiedene Ebenen der Datenfreigabe
- Zustandsverwaltung – Aufrechterhaltung des Anwendungszustands über Nodes hinweg
Deploy-Schaltfläche
Mit der Deploy-Schaltfläche in Node-RED können Sie Konfigurationen anwenden und an die Laufzeitumgebung übertragen.
Deploy-Optionen:
- Full Deploy – Aktualisiert alle Nodes und Flows
- Modified Nodes – Aktualisiert nur die geänderten Nodes
- Modified Flows – Aktualisiert nur die Flows, die geänderte Nodes enthalten
Importieren und Exportieren
Node-RED ermöglicht den Export und Import von Flow-Konfigurationen als JSON-Dateien, was Folgendes ermöglicht:
- Sicherung Ihrer Kamerakonfigurationen
- Austausch von Flows zwischen Teammitgliedern
- Übertragung von Konfigurationen zwischen verschiedenen Kameras
Exportprozess
- Öffnen Sie den Node-RED-Editor der Kamera
- Wählen Sie die zu exportierenden Flows aus
- Klicken Sie auf die Menüschaltfläche und wählen Sie „Export"
- Wählen Sie das JSON-Format
Importprozess
- Öffnen Sie den Node-RED-Editor der Kamera
- Klicken Sie auf die Menüschaltfläche und wählen Sie „Import"
- Fügen Sie die JSON-Daten ein oder laden Sie die JSON-Datei hoch
- Klicken Sie auf „Import", um die Konfiguration zu integrieren
- Führen Sie ein Deploy aus, um die neuen Flows anzuwenden
Debug
Zweck und Funktionalität
Der Debug-Node zeigt Nachrichten in der Debug-Seitenleiste des Node-RED-Editors an und erleichtert die Entwicklung und Fehlerbehebung von Inspektions-Flows.
Hauptmerkmale
- Strukturierte Nachrichtenansicht in der Debug-Seitenleiste
- Detaillierte Informationen zu Zeitpunkt und Quelle der Nachrichten
- Möglichkeit, Quell-Nodes im Arbeitsbereich zu lokalisieren
- Umschaltfunktion zum Aktivieren/Deaktivieren der Debug-Ausgabe
Dashboard-Funktionen
Das Node-RED Dashboard bietet eine webbasierte Oberfläche zur Überwachung und Steuerung Ihres Kamerasystems über eine anpassbare UI.
Hauptkomponenten
- Layout Manager – Organisieren von UI-Komponenten
- UI Nodes – Hinzufügen spezifischer Oberflächenelemente
- Theme-Anpassung – Personalisierung des Erscheinungsbilds
Häufige UI-Elemente
- Buttons – Auslösen von Aktionen wie Rezeptwechsel
- Charts – Visualisierung von Inspektionsmetriken im Zeitverlauf
- Gauges – Überwachung von Werten innerhalb eines Bereichs
- Textanzeigen – Anzeige des aktuellen Kamerastatus
- Slider – Anpassen von Parametern in Echtzeit
Schritte zum Erstellen eines Dashboards
- UI Nodes zu Flows hinzufügen – Ziehen Sie UI Nodes per Drag-and-Drop aus der Palette in Ihre Flows, um die Daten und Steuerelemente zu definieren, die im Dashboard enthalten sein sollen
- UI Nodes konfigurieren – Konfigurieren Sie die Eigenschaften jedes UI Nodes, wie Beschriftungen, Wertebereiche und Datenquellen
- Komponenten anordnen – Verwenden Sie den Layout Manager, um die UI-Komponenten auf dem Dashboard so anzuordnen, dass ein logisches und benutzerfreundliches Layout entsteht
- Dashboard bereitstellen und aufrufen – Führen Sie ein Deploy Ihrer Flows aus und greifen Sie auf das Dashboard zu, indem Sie zur entsprechenden URL navigieren (typischerweise
http://\{hostname\}/ui)
Arbeiten mit Node-RED im OV20i
Zugriff auf den Editor
Auf den Node-RED-Editor Ihrer OV20i-Kamera können Sie über die UI zugreifen.
Standard-Flow
Der OV20i wird mit einem vorkonfigurierten Standard-Flow geliefert, der grundlegende Inspektionsvorgänge abwickelt. Dieser dient als Ausgangspunkt für Ihre benutzerdefinierten Konfigurationen und veranschaulicht Best Practices für die Kameraintegration.
OV20i Custom Nodes
Die Kamera erweitert Node-RED um spezialisierte Nodes für Vision-Anwendungen:
- Classification Logic – Verarbeitung von Klassifizierungsergebnissen
- PLC Format – Formatierung von Daten für Industriesteuerungen
- Final Pass/Fail – Bestimmung von Inspektionsergebnissen
Integrationsmöglichkeiten
Die Node-RED-Umgebung im OV20i unterstützt die Integration mit verschiedenen industriellen Systemen:
- SPS via Ethernet/IP, Profinet oder Modbus
- MQTT für IoT-Anwendungen
- HTTP/REST für Webdienste
- Datenbanksysteme für die Datenprotokollierung
- HMI-Schnittstellen für die Bedienersteuerung
Best Practices
Flow-Organisation
- Organisieren Sie Flows nach Funktion
- Verwenden Sie Kommentare zur Dokumentation komplexer Logik
- Benennen Sie Nodes eindeutig, um ihren Zweck anzugeben
- Verwenden Sie Subflows für wiederkehrende Muster
Leistungsaspekte
- Minimieren Sie die Anzahl der Debug-Nodes in der Produktion
- Berücksichtigen Sie die Auswirkungen hochfrequenter Trigger
- Nutzen Sie Kontextvariablen effizient
- Testen Sie gründlich vor dem Deployment
Backup-Strategie
- Exportieren und sichern Sie Ihre Flows regelmäßig
- Dokumentieren Sie Ihre Konfigurationsänderungen
- Erwägen Sie Versionskontrolle für Teamumgebungen
- Testen Sie wiederhergestellte Flows vor dem Produktionseinsatz
Der Integration Builder kann vollständige Node-RED-Flows aus einer einfachen englischen Beschreibung generieren. Anstatt Flows Node für Node aufzubauen, beschreiben Sie, was Sie möchten, und erhalten in Sekundenschnelle einen produktionsreifen Flow. Ideal für gängige Muster wie Benachrichtigungen, Datenprotokollierung und SPS-Kommunikation.