TCP-Kommunikationskonfiguration

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

Video-Anleitung

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

Manuelle Konfiguration überspringen

Beschreiben Sie Ihre TCP-Integration in einfachem Englisch, und der Auto-Integration Builder generiert in Sekunden einen vollständigen Node-RED-Flow für Sie.

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

Voraussetzungen

• OV10i-Kamerasystem eingerichtet und verbunden
• Zielgerät/-system mit TCP-Kommunikationsfähigkeit
• Netzwerkverbindung zwischen Kamera und Zielgerät
• Grundkenntnisse von IP-Adressen und Portnummern
• Aktives Rezept konfiguriert (Bildaufnahme- und Inspektionseinrichtung abgeschlossen)

Schritt 1: Netzwerkkonfiguration überprüfen

1.1 Kamera-IP-Adresse überprüfen

1. Zu den Systemeinstellungen navigieren
2. Kamera-IP-Adresse notieren (z. B. 192.168.0.100)
3. Subnetzmaske und Netzwerkkonfiguration überprüfen

1.2 Zielgerät-Netzwerk bestätigen

Netzwerkkompatibilität sicherstellen:

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

1.3 Netzwerkanforderungen

Anforderung	Kamera	Zielgerät	Hinweise
IP-Bereich	192.168.0.100	192.168.0.xxx	Muss dasselbe 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: Node-RED Editor öffnen

2.1 Zum IO-Block navigieren

1. Auf "IO Block" im Rezept-Breadcrumb-Menü klicken, ODER
2. "Configure I/O" im Recipe Editor auswählen

2.2 Node-RED Editor öffnen

1. Auf Configure IO klicken, um den Node-RED-Flow-Editor zu öffnen
2. Node-RED-Oberfläche auf korrektes Laden überprüfen

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. Den "tcp in"-Node im linken Bereich (Abschnitt Network) lokalisieren
2. Den "tcp in"-Node auf die Flow-Arbeitsfläche ziehen
3. Doppelklick auf den Node, um ihn zu konfigurieren

3.2 TCP-Input-Einstellungen konfigurieren

Node-Konfiguration:

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

3.3 Schritte zur Konfiguration des TCP-Eingangs

1. Server-Konfiguration:
   • "Listen on port" (Servermodus) auswählen
   • Portnummer eingeben (z. B. 49155)
2. Datenhandhabung:
   • Data mode: "Stream" für kontinuierliche Daten auswählen
   • Data type: "UTF8" für Text oder "Buffer" für Binärdaten auswählen
3. Erweiterte Einstellungen:
   • New line character: Leer lassen, sofern kein spezifisches Trennzeichen erforderlich ist
   • Topic: Optionale Kennung für das Message-Routing
4. Auf Done klicken, 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-Ausgangsnode hinzufügen

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

4.2 TCP-Ausgangseinstellungen konfigurieren

Node-Konfiguration:

Einstellung	Wert	Beschreibung
Type	Connect to	Kamera agiert 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: Auf "Client" belassen
   • End connection: Je nach Anwendungsfall konfigurieren
3. Datenformat:
   • Base64: Für Textdaten üblicherweise deaktiviert
   • TLS: Nur aktivieren, wenn eine sichere Verbindung erforderlich ist
4. Auf Done klicken, um die Konfiguration zu speichern

Schritt 5: Kommunikationsflow erstellen

5.1 Vollständigen Flow aufbauen

Einen Flow erstellen, der sowohl TCP-Daten senden als auch empfangen kann:

1. Folgende Nodes auf der Arbeitsfläche hinzufügen:
   • Inject-Node (zum Auslösen von Nachrichten)
   • Function-Node (zur Nachrichtenverarbeitung)
   • TCP Out-Node (zum Senden von Daten)
   • TCP In-Node (zum Empfangen von Daten)
   • Debug-Nodes (zur Überwachung)

5.2 Inject-Node konfigurieren

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

5.3 Function-Node konfigurieren

Der Function-Node formatiert die ausgehende Nachricht:

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

1. Doppelklick auf den Function-Node
2. Obigen Code in den Tab "On Message" kopieren
3. Name: "Format Message"
4. Auf Done klicken

5.4 Verbindungen herstellen

Nodes in dieser Reihenfolge verbinden:

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

Der finale Flow sollte folgende Verbindungen aufweisen:

• Inject verbunden mit Function
• Function verbunden mit TCP Out und Debug
• TCP In verbunden mit separatem Debug-Node

Ergebnis: Sie können Nachrichten durch Klicken auf den Inject-Button senden und sowohl ausgehende als auch eingehende Nachrichten im Debug-Panel sehen.

Schritt 6: Nachrichtenformat konfigurieren

6.1 Nachrichtenformat definieren

Nachrichtenstruktur einfach halten:

Nachrichtentyp	Format	Beispiel
Einfacher Text	Reine Zeichenfolge	"Hello from camera"
Statusaktualisierungen	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 Statusnachricht:

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 (obere rechte Ecke)
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: Verbindungsaufbau läuft

7.2 TCP-Kommunikation testen

7.2.1 Grundlegender Konnektivitätstest

Mit Kommandozeilen-Tools:

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

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

Windows PowerShell:

Test-NetConnection -ComputerName 192.168.0.100 -Port 49155

7.2.2 Testnachrichten senden

1. Verbindung zum TCP-Port der Kamera herstellen
2. Testbefehle senden:
   • "STATUS" → Sollte eine Statusantwort empfangen
   • "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, ob 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	☐
Nachrichtenverarbeitung	Function-Node verarbeitet korrekt	☐
Antwortversand	Zielgerät empfängt Antworten	☐
Fehlerbehandlung	Ungültige Nachrichten werden ordnungsgemäß behandelt	☐

Schritt 8: Integration mit dem Inspektionssystem

8.1 Mit Inspektions-Triggern verbinden

Verbinden Sie die TCP-Kommunikation mit dem Inspektions-Workflow:

1. Fügen Sie den Node "All Block Outputs" hinzu (falls noch nicht 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	Datenformat-Einstellungen prüfen
Beschädigte Daten	Unleserlicher Text im Debug	Codierung überprüfen (UTF8/Buffer)
Nachrichtenverlust	Fehlende Nachrichten	Netzwerkstabilität prüfen
Probleme mit großen Nachrichten	Abgeschnittene Daten	Kürzere Nachrichten verwenden

9.3 Debug-Techniken

Systematische Fehlerbehebung:

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

Erfolg! Ihre TCP-Kommunikation ist bereit

Ihr TCP-Kommunikationssystem kann jetzt:

• 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 über die Zeit überwachen
• Datenübertragung verifizieren auf konsistente Funktion
• Debug-Logs prüfen auf Fehlermuster
• Kommunikation testen nach Netzwerkänderungen

Nächste Schritte

Nach Einrichtung der grundlegenden TCP-Kommunikation:

1. Mit Ihren externen Systemen testen über die hergestellte 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-Kommunikationseinrichtung
• RS-232-Kommunikationseinrichtung
• Verbindung zur PLC (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 an 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 jetzt:

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

Laufende Wartung

Regelmäßige Systemprüfungen

• Verbindungsstabilität überwachen im Laufe der Zeit
• Datenintegrität verifizieren in der Produktion
• Sicherheitskonfigurationen aktualisieren bei Bedarf
• Performance optimieren basierend auf Nutzungsmustern

Performance-Überwachung

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

Nächste Schritte

Nach der Einrichtung der TCP-Kommunikation:

1. Integrieren Sie Ihre externen Systeme mithilfe des etablierten Protokolls
2. Implementieren Sie eine umfassende Fehlerbehandlung für den Produktionseinsatz
3. Richten Sie Logging und Monitoring für die Systemzustandsüberwachung ein
4. Erwägen Sie Sicherheitserweiterungen für den Produktiveinsatz

🔗 Siehe auch

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