# TCP-Client

Die TCP-Client-Funktion definiert eine Tabellenzelle als TCP/IP-Client, der die Kommunikation mit einem anderen TCP/IP-Gerät für den Austausch von Daten über das Netzwerk startet.

Hinweis:

- Die Verbindung zwischen der TCP-Tabellenfunktion und einem anderen TCP/IP-Gerät wird sofort aufgebaut, wenn Sie die TCP-Client-Funktion hinzufügen oder den Job in die Tabelle laden.

- TCP-Client generiert nach dem Empfang eines Pakets ein Ereignis. Dieses Ereignis aktualisiert die Tabelle.

## TCP-Client – Eingaben

Parameter | Beschreibung
--- | ---
Hostname | Gibt den Namen oder die IP-Adresse des TCP-Geräts an, mit dem Sie eine Verbindung herstellen. Wenn Sie den Hostnamen nicht angeben, gibt die TCP-Client-Funktion #ERR zurück.
Portnummer | Gibt die Portnummer an, an der eine Verbindung zwischen TCP/IP-Geräten besteht. Die Portnummer ist eine 16-Bit-Portnummer ohne Vorzeichen. 0 ist kein gültiger Anschluss. Die Standard-Portnummer ist 3000. Hinweis: Die hier eingegebene Portnummer müssen Sie auf dem Server zuweisen.
Pakettyp | Definiert die Formatierung der Datenzeichenfolge, die zwischen TCP/IP-Geräten ausgetauscht wird.
Typ | Beschreibung
--- | ---
0 = Zeichenkette CR + LF (Standard) | ASCII-Format. Wenn eine TCP-Tabellenfunktion sendet, hängt die Software das ASCII-Zeichen 13 (Wagenrücklauf) und 10 (Zeilenvorschub) an die Datenzeichenfolge an. Beim Empfang schließt CR+LF die Datenzeichenfolge ab.
1 = Zeichenkette CR (13) | ASCII-Format. Wenn eine TCP-Tabellenfunktion sendet, hängt die Software das ASCII-Zeichen 13 (Wagenrücklauf) an die Datenzeichenfolge beim Empfang an. Beim Empfang schließt CR die Datenzeichenfolge ab.
2 = Zeichenkette LF (10) | ASCII-Format. Wenn eine TCP-Tabellenfunktion sendet, hängt die Software das ASCII-Zeichen 10 (Zeilenvorschub) an die Datenzeichenfolge an. Beim Empfang schließt LF die Datenzeichenfolge ab.
3 = Zeichenkette Nullchar (0) | ASCII-Format. Wenn eine TCP-Tabellenfunktion sendet, hängt die Software das ASCII-Zeichen 0 (Nullchar) an die Datenzeichenfolge an. Beim Empfang schließt Nullchar die Datenzeichenfolge ab. Hinweis: Wenn unabhängig vom Pakettyp ein In-Sight Vision-System Daten empfängt, beschließt das ASCII-Zeichen 0 (Nullchar) die Datenzeichenkette.
5 = Zeichenfolge mit benutzerdefiniertem Terminator | ASCII-Format. Wenn eine TCP-Tabellenfunktion sendet, hängt die Software das angegebene Abschlusszeichen an die Datenzeichenfolge an. Beim Empfang schließt das angegebene Abschlusszeichen die Datenzeichenfolge ab.
Zeitlimit | Die Anzahl von Millisekunden (1000 bis 15000; der Standardwert ist 1000), die abgewartet werden soll, bis TCP-Client eine TCP/IP-Verbindung hergestellt hat, bevor der Verbindungsversuch abgebrochen wird. Wenn keine Verbindung besteht, versucht WriteDevice, die Verbindung erneut herzustellen. Wenn der Versuch während des Zeitlimit-Zeitraums nicht erfolgreich ist, wird #ERR angezeigt. Wenn eine Verbindung besteht, TCP-Client das Paket während des Zeitlimit-Zeitraums jedoch nicht in die Warteschlange des Netzwerk-Socket stellen konnte, zeigt WriteDevice ebenfalls #ERR an. TCP-Client gibt kein #ERR zurück.
Abschlusszeichen | Gibt den Byte-Wert an, den Sie verwenden, wenn Sie „Zeichenfolge mit kundenseitigem Abschlusszeichen“ oder „Binär mit kundenseitigem Abschlusszeichen“ für den Pakettyp angeben.
Maximale Paketgröße | Legt die maximale Paketgröße fest, die TCP-Client empfangen kann. Wenn der Remote-Sender die maximale Paketgröße überschreitet, zeigt ReadDevice #ERR an.

## TCP-Client – Ausgaben

Rückgabewert | Eine Device-Datenstruktur. Gibt #ERR zurück, wenn ein oder mehrerer Eingabeparameter ungültig sind.
Ergebnisse | Beim Einfügen der TCP-Client-Funktion in eine Zelle wird automatisch eine Funktion WriteDevice in die rechts nebenstehende Zelle eingefügt.

## Beispiel

Konfigurieren Sie einen In-Sight-Host Vision-Systemmit der Bezeichnung SYSTEM0, wobei die zugehörigen Zellen die folgenden Parameterwerte enthalten:

A3=TCPClient("SYSTEM1",3000,0,1000,0,1024)

B3=WriteDevice($A$0,A3,C3)

Angenommen, Sie konfigurieren ein zweites Hostsystem mit der Bezeichnung System1, das einen TCP/IP-Server enthält, mit den zugehörigen Zellen, die die folgenden Parameterwerte enthalten:

A4=TCPServer(3000,0,0,1024)

B4=ReadDevice(A4)

Beide Systeme, SYSTEM0 und SYSYEM1, sind online.

Immer wenn das Standardbild in Zelle $A$0 auf SYSTEM0 aufgenommen wird, baut der TCP/IP-Client in Zelle A3 (wenn nicht bereits verbunden) eine Verbindung mit dem TCP/IP-Server in Zelle A4 auf SYSTEM1 über Port 3000 auf.

Die Funktion WriteDevice in Zelle B3 auf SYSTEM0 exportiert dann die Daten in Zelle C3 in die Funktion ReadDevice in die Zelle B4 auf SYSTEM1.