TCP-Kommunikationseinrichtung

Diese Anleitung zeigt Ihnen, wie Sie die TCP-Kommunikation zwischen Ihrer OV80i-Kamera und externen Geräten mithilfe von Node-RED konfigurieren. Verwenden Sie die TCP-Kommunikation für den Echtzeit-Datenaustausch, die Fernsteuerung oder die Integration mit benutzerdefinierten Anwendungen und Systemen.

Video-Anleitung

Sehen Sie sich dieses Thema in Aktion an: Auto-Integration Builder

Wann Sie TCP-Kommunikation einsetzen sollten: Echtzeit-Datenstreaming, Integration benutzerdefinierter Anwendungen, bidirektionale Kommunikation mit externen Systemen, hochfrequenter Datenaustausch oder wenn HTTP/REST-APIs nicht geeignet sind.

Voraussetzungen

• OV80i-Kamerasystem eingerichtet und angeschlossen
• Zielgerät/-system mit TCP-Kommunikationsfähigkeit
• Netzwerkverbindung zwischen Kamera und Zielgerät
• Grundkenntnisse von IP-Adressen und Portnummern
• Aktives Recipe konfiguriert (Imaging- und Inspektionseinrichtung abgeschlossen)

Schritt 1: Netzwerkkonfiguration überprüfen

1.1 Kamera-IP-Adresse prüfen

1. Navigieren Sie zu den Systemeinstellungen
2. Notieren Sie sich die Kamera-IP-Adresse (z. B. 10.250.0.100)
3. Überprüfen Sie die Subnetzmaske und die Netzwerkkonfiguration

1.2 Zielgerätenetzwerk bestätigen

Netzwerkkompatibilität sicherstellen:

• Gleiches Subnetz: Kamera und Zielgerät müssen sich im gleichen Netzwerkbereich befinden
• Zugängliche Ports: Die Ports des Zielgeräts dürfen nicht durch Firewalls blockiert werden
• Netzwerkverbindung: Wenn möglich, mit dem Ping-Befehl testen

1.3 Netzwerkanforderungen

Anforderung	Kamera	Zielgerät	Hinweise
IP-Bereich	10.250.0.100	10.250.0.xxx	Muss im gleichen Subnetz sein
Subnetzmaske	255.255.255.0	255.255.255.0	Standardkonfiguration
Portzugriff	49155 (Beispiel)	49155 (Beispiel)	Reservierte Ports vermeiden
Firewall	TCP-Verkehr zulassen	TCP-Verkehr zulassen	Beide Richtungen

Schritt 2: Auf den Node-RED-Editor zugreifen

2.1 Zum IO Block navigieren

1. Klicken Sie auf „IO Block" im Breadcrumb-Menü des Recipes, ODER
2. Wählen Sie „Configure I/O" im Recipe Editor

2.2 Node-RED-Editor öffnen

1. Klicken Sie auf Configure IO, um den Node-RED-Flow-Editor zu öffnen
2. Überprüfen Sie, dass die Node-RED-Oberfläche korrekt geladen wird

Prüfpunkt: Sie sollten den Node-RED-Flow-Editor mit der Node-Palette auf der linken Seite sehen.

Schritt 3: TCP-Eingang konfigurieren (Daten empfangen)

3.1 TCP-Input-Node hinzufügen

1. Suchen Sie die „tcp in"-Node im linken Bereich (Abschnitt Network)
2. Ziehen Sie die „tcp in"-Node auf die Flow-Arbeitsfläche
3. Doppelklicken Sie auf die Node, um sie zu konfigurieren

3.2 TCP-Eingangseinstellungen konfigurieren

Node-Konfiguration:

Einstellung	Wert	Beschreibung
Type	Listen on	Kamera fungiert als Server
Port	49155	Port, auf dem die Kamera lauscht
Data mode	Stream	Kontinuierlicher Datenfluss
Data type	UTF8	Textbasierte Kommunikation
Topic	(optional)	Nachrichtenkategorisierung

3.3 Konfigurationsschritte für TCP-Eingang

1. Serverkonfiguration:
   • Wählen Sie „Listen on port" (Servermodus)
   • Geben Sie die Portnummer ein (z. B. 49155)
2. Datenverarbeitung:
   • Data mode: Wählen Sie „Stream" für kontinuierliche Daten
   • Data type: Wählen Sie „UTF8" für Text oder „Buffer" für Binärdaten
3. Erweiterte Einstellungen:
   • New line character: Leer lassen, sofern kein spezifisches Trennzeichen benötigt wird
   • Topic: Optionale Kennung für das Nachrichten-Routing
4. Klicken Sie auf Done, um die Konfiguration zu speichern

3.4 Richtlinien zur Portauswahl

Portbereich	Verwendung	Empfehlung
1-1023	Systemreserviert	Vermeiden
1024-49151	Registrierte Ports	Verfügbarkeit prüfen
49152-65535	Dynamisch/privat	Empfohlen

Schritt 4: TCP-Ausgang konfigurieren (Daten senden)

4.1 TCP-Ausgangsknoten hinzufügen

1. Knoten "tcp out" suchen im linken Bereich (Abschnitt Network)
2. Knoten "tcp out" ziehen auf die Flow-Arbeitsfläche
3. Doppelklick auf den Knoten zur Konfiguration

4.2 TCP-Ausgangseinstellungen konfigurieren

Knotenkonfiguration:

Einstellung	Wert	Beschreibung
Type	Connect to	Kamera fungiert als Client
Host	192.168.0.200	IP-Adresse des Zielgeräts
Port	49155	Port des Zielgeräts
Mode	Client	Ausgehende Verbindung

4.3 Konfigurationsschritte für TCP-Ausgang

1. Verbindungseinstellungen:
   • Type: "Connect to" auswählen (Client-Modus)
   • Host: IP-Adresse des Zielgeräts eingeben
   • Port: Portnummer des Zielgeräts eingeben
2. Verbindungsoptionen:
   • Mode: Als "Client" belassen
   • End connection: Je nach Anwendungsfall konfigurieren
3. Datenformat:
   • Base64: Für Textdaten in der Regel deaktiviert
   • TLS: Nur aktivieren, wenn eine sichere Verbindung erforderlich ist
4. Klicken Sie auf Done, um die Konfiguration zu speichern

Schritt 5: Kommunikations-Flow erstellen

5.1 Vollständigen Flow aufbauen

Erstellen Sie einen Flow, der TCP-Daten sowohl senden als auch empfangen kann:

1. Fügen Sie diese Knoten zu Ihrer Arbeitsfläche hinzu:
   • Inject-Knoten (zum Auslösen von Nachrichten)
   • Function-Knoten (zur Nachrichtenverarbeitung)
   • TCP Out-Knoten (zum Senden von Daten)
   • TCP In-Knoten (zum Empfangen von Daten)
   • Debug-Knoten (zur Überwachung)

5.2 Inject-Knoten konfigurieren

1. Doppelklick auf den Inject-Knoten
2. Einstellungen konfigurieren:
   • Name: "Send Message"
   • Payload: Timestamp
   • Topic: (leer lassen)
3. Klicken Sie auf Done

5.3 Function-Knoten konfigurieren

Der Function-Knoten formatiert Ihre ausgehende Nachricht:

msg.payload = "Hello from OV80i camera";
return msg;

1. Doppelklick auf den Function-Knoten
2. Code von oben kopieren in die Registerkarte "On Message"
3. Name: "Format Message"
4. Klicken Sie auf Done

5.4 Verbindungen verdrahten

Verbinden Sie die Knoten in dieser Reihenfolge:

Ausgehender Flow:

• Inject → Function → TCP Out
• Function → Debug (zur Anzeige ausgehender Nachrichten)

Eingehender Flow:

• TCP In → Debug (zur Anzeige eingehender Nachrichten)

5.5 Vollständige Flow-Struktur

Ihr finaler Flow sollte folgendermaßen aufgebaut sein:

• Inject verbunden mit Function
• Function verbunden mit sowohl TCP Out als auch Debug
• TCP In verbunden mit separatem Debug-Knoten

Ergebnis: Sie können Nachrichten durch Klicken auf die Inject-Schaltfläche senden und sowohl ausgehende als auch eingehende Nachrichten im Debug-Panel anzeigen.

Schritt 6: Nachrichtenformat konfigurieren

6.1 Nachrichtenformat definieren

Halten Sie die Nachrichtenstruktur einfach:

Nachrichtentyp	Format	Beispiel
Einfacher Text	Reine Zeichenkette	"Hello from camera"
Statusmeldungen	Text mit Information	"STATUS: READY"
Datenwerte	Schlüssel-Wert-Format	"TEMPERATURE: 25.5"

6.2 Beispiele für benutzerdefinierte Nachrichten

Sie können den Function-Node für verschiedene Nachrichtentypen anpassen:

Einfache Statusmeldung:

msg.payload = "Camera Ready";
return msg;

Zeitstempel-Nachricht:

msg.payload = "Time: " + new Date().toLocaleString();
return msg;

Daten mit Werten:

msg.payload = "INSPECTION_COUNT: 42";
return msg;

Schritt 7: Konfiguration bereitstellen und testen

7.1 Node-RED-Flow bereitstellen

1. Klicken Sie auf die Schaltfläche Deploy (oben rechts)
2. Überprüfen Sie die Erfolgsmeldung der Bereitstellung
3. Prüfen Sie die Statusanzeigen der Nodes:
   • Grüner Punkt: Erfolgreich verbunden
   • Roter Punkt: Verbindungsfehler
   • Gelber Punkt: Verbindungsversuch läuft

7.2 TCP-Kommunikation testen

7.2.1 Grundlegender Verbindungstest

Mit Kommandozeilen-Tools:

# Test TCP connection (Linux/Mac)
telnet [camera-ip] [port]
# Example: telnet 10.250.0.100 49155

# Test with netcat
nc [camera-ip] [port]
# Example: nc 10.250.0.100 49155

Windows PowerShell:

Test-NetConnection -ComputerName 10.250.0.100 -Port 49155

7.2.2 Testnachrichten senden

1. Mit dem TCP-Port der Kamera verbinden
2. Testbefehle senden:
   • "STATUS" → sollte eine Statusantwort liefern
   • "TRIGGER" → sollte eine Inspektion auslösen
   • "INVALID" → sollte unbekannte Befehle behandeln

7.2.3 Debug-Ausgabe überwachen

1. Öffnen Sie das Node-RED-Debug-Panel (rechte Seitenleiste)
2. Senden Sie Testnachrichten über TCP
3. Überprüfen Sie, dass die Debug-Ausgabe Folgendes anzeigt:
   • Eingehende Nachrichten
   • Verarbeitungsergebnisse
   • Ausgehende Antworten

7.3 Validierungs-Checkliste

Test	Erwartetes Ergebnis	Status
TCP-Verbindung	Erfolgreiche Verbindung zum Kameraport	☐
Nachrichtenempfang	Debug zeigt eingehende Nachrichten an	☐
Nachrichtenverarbeitung	Function-Node verarbeitet korrekt	☐
Antwortversand	Zielgerät empfängt Antworten	☐
Fehlerbehandlung	Ungültige Nachrichten werden ordnungsgemäß behandelt	☐

Schritt 8: Integration in das Inspektionssystem

8.1 Verbindung zu Inspektions-Triggern

TCP-Kommunikation mit dem Inspektions-Workflow verknüpfen:

1. Fügen Sie den Node "All Block Outputs" hinzu (sofern nicht bereits vorhanden)
2. Verbinden Sie die Inspektionsergebnisse mit dem TCP-Ausgang
3. Formatieren Sie die Inspektionsdaten für die TCP-Übertragung

8.2 Integration der Inspektionsdaten

Function-Node zur Verarbeitung der Inspektionsergebnisse:

// Get inspection results from All Block Outputs
const results = msg.payload;

// Extract key information
const inspectionSummary = {
    result: results.pass ? "PASS" : "FAIL",
    timestamp: new Date().toISOString(),
    processing_time: results.processing_time,
    roi_count: results.roi_results ? results.roi_results.length : 0
};

// Format for TCP transmission
msg.payload = JSON.stringify(inspectionSummary);
return msg;

8.3 Bidirektionale Steuerung

Fernsteuerung über TCP aktivieren:

// Handle remote commands
const command = msg.payload.toString().toUpperCase();

switch(command) {
    case "START_INSPECTION":
        // Trigger inspection sequence
        global.set("trigger_inspection", true);
        msg.payload = "INSPECTION_STARTED";
        break;

    case "STOP_INSPECTION":
        // Stop inspection sequence
        global.set("trigger_inspection", false);
        msg.payload = "INSPECTION_STOPPED";
        break;

    case "CHANGE_RECIPE":
        // Recipe change logic
        msg.payload = "RECIPE_CHANGED";
        break;
}

return msg;

Schritt 9: Fehlerbehebung bei häufigen Problemen

9.1 Verbindungsprobleme

Problem	Symptome	Lösung
Verbindung nicht möglich	Rote Statusanzeige	IP-Adresse und Port prüfen
Verbindungsabbrüche	Zeitweise gelber Status	Netzwerkstabilität überprüfen
Timeout-Fehler	Verzögerte Antworten	Timeout-Einstellungen anpassen
Port-Konflikte	Verbindung abgelehnt	Andere Portnummer verwenden

9.2 Probleme bei der Datenübertragung

Problem	Symptome	Lösung
Keine Daten empfangen	Debug zeigt leere Nachrichten	Einstellungen des Datenformats prüfen
Beschädigte Daten	Unleserlicher Text im Debug	Kodierung überprüfen (UTF8/Buffer)
Nachrichtenverlust	Fehlende Nachrichten	Netzwerkstabilität überprüfen
Probleme mit großen Nachrichten	Abgeschnittene Daten	Kürzere Nachrichten verwenden

9.3 Debug-Techniken

Systematische Fehlerbehebung:

1. Debug-Nodes aktivieren bei jedem Schritt
2. Node-RED-Logs überwachen auf Fehler
3. Zuerst mit einfachen TCP-Clients testen
4. Netzwerkverbindung mit Ping überprüfen

Erfolg! Ihre TCP-Kommunikation ist bereit

Ihr TCP-Kommunikationssystem kann nun:

• Daten senden und empfangen zwischen Kamera und externen Geräten
• Einfache Nachrichten verarbeiten für die grundlegende Kommunikation
• Datenfluss überwachen mit Debug-Nodes
• Grundlegende Netzwerkkommunikation handhaben für Ihre Anwendungen

Laufende Wartung

Regelmäßige Systemprüfungen

• Verbindungsstabilität überwachen über die Zeit
• Datenübertragung überprüfen auf konsistente Funktion
• Debug-Logs prüfen auf Fehlermuster
• Kommunikation testen nach Netzwerkänderungen

Nächste Schritte

Nach der Einrichtung der grundlegenden TCP-Kommunikation:

1. Mit Ihren externen Systemen testen über die etablierte Verbindung
2. Nachrichtenformate anpassen an Ihre spezifischen Anforderungen
3. Komplexere Logik hinzufügen, wenn Ihre Anforderungen wachsen
4. Andere Kommunikationsmethoden in Betracht ziehen, falls TCP nicht alle Anforderungen erfüllt

🔗 Siehe auch

• MQTT-Kommunikation einrichten
• RS-232-Kommunikation einrichten
• Mit PLC verbinden (Ethernet/IP, PROFINET)
• Node-RED-Grundlagen
• Overview Node-RED Custom Blocks
• IP- und Netzwerkerkennungsfehler

Für Anwendungen mit hohem Datendurchsatz:

1. Nachrichtenfrequenz reduzieren
2. Mehrere Nachrichten bündeln
3. Binärformat für große Daten verwenden
4. Komprimierung implementieren

Debug-Techniken

Systematische Fehlerbehebung:

1. Debug-Nodes aktivieren bei jedem Schritt
2. Node-RED-Logs überwachen auf Fehler
3. Netzwerk-Monitoring-Tools verwenden (Wireshark)
4. Zuerst mit einfachen TCP-Clients testen

Erfolg! Ihre TCP-Kommunikation ist bereit

Ihr TCP-Kommunikationssystem kann nun:

• Daten senden und empfangen zwischen Kamera und externen Geräten
• Befehle verarbeiten für die Fernsteuerung
• Inspektionsergebnisse übertragen in Echtzeit
• Fehler ordnungsgemäß behandeln mit angemessener Fehlerbehandlung
• In Produktionssysteme integrieren für automatisierte Workflows

Laufende Wartung

Regelmäßige Systemprüfungen

• Verbindungsstabilität überwachen im Zeitverlauf
• Datenintegrität verifizieren in der Produktion
• Sicherheitskonfigurationen aktualisieren nach Bedarf
• Leistung optimieren basierend auf Nutzungsmustern

Leistungsüberwachung

• Nachrichtendurchsatz und Latenz verfolgen
• Fehlerraten und Verbindungsausfälle überwachen
• Datenmuster analysieren zur Identifizierung von Optimierungspotenzialen

Nächste Schritte

Nach der Einrichtung der TCP-Kommunikation:

1. Integrieren Sie Ihre externen Systeme über das eingerichtete Protokoll
2. Implementieren Sie eine umfassende Fehlerbehandlung für den Produktionseinsatz
3. Richten Sie Logging und Monitoring zur Überwachung der Systemzustände ein
4. Erwägen Sie Sicherheitserweiterungen für den Produktionseinsatz

🔗 Siehe auch

• MQTT-Kommunikation einrichten
• RS-232-Kommunikation einrichten
• Verbindung zur PLC herstellen (Ethernet/IP, PROFINET)
• Node-RED Grundlagen
• Overview Node-RED Custom Blocks
• IP- und Netzwerk-Discovery-Fehler