TCP-Verbindungen

TCP kommt als Plugin tcp. Es bringt einen eigenen Python-Prozess mit (Python ab 3.11) und braucht im Manifest die Berechtigung net:socket. Installieren und einschalten Sie es unter Einstellungen → Plugins; danach steht TCP auf der Verbindungsseite zur Auswahl.

Der Punkt, an dem TCP anders ist als MQTT

TCP ist ein Strom ohne Grenzen. Es gibt keine Nachrichten, es gibt Bytes. Wo ein Telegramm endet, müssen Sie festlegen — über ein Trennzeichen, ersatzweise über eine Stillepause.

Die Verbindung

Feld	Bedeutung
Rolle	Client baut die Verbindung auf, Server nimmt sie an. Client, wenn die Maschine lauscht; Server, wenn die Maschine sich von sich aus meldet
Host	nur als Client: die Gegenstelle, Name oder IP-Adresse
Bind-Adresse	nur als Server: die eigene Netzkarte. 0.0.0.0 nimmt jede, 127.0.0.1 nur die lokale
Port	als Client der Port der Gegenstelle, als Server der eigene Lauschport
Trennzeichen	LF, CRLF, CR, NUL, ETX oder keines
Kodierung	UTF-8, Latin-1, ASCII oder Hex
Stille-Rückfall (ms)	Vorgabe 250
Nachrichtengrenze (Bytes)	Vorgabe 65536
Backoff, kürzeste / längste Wartezeit (ms)	nur als Client, Vorgabe 500 und 30000

Kodierung. Ist das Protokoll binär, wählen Sie Hex. Dann bleibt jedes Byte lesbar, statt beim Umwandeln ersetzt zu werden.

Stille-Rückfall. Wirkt nur, wenn kein Trennzeichen gesetzt ist oder eines ausbleibt: Was bis zu dieser Stille ankam, gilt als eine Meldung. Zu kurz gewählt zerschneidet es ein Telegramm, in dem der Sender kurz zögert.

Nachrichtengrenze. Obergrenze für ein Telegramm. Wird sie ohne Trennzeichen überschritten, wird der Puffer verworfen, statt endlos zu wachsen.

Backoff. Die Wartezeit vor dem Wiederverbinden verdoppelt sich bis zum Deckel. Eine ausgeschaltete Maschine wird damit nicht im Sekundentakt angeklopft.

Das Tag: der Kanal

Ein TCP-Tag hat genau ein Feld, Kanal:

Kanal	Was das Tag führt
data	die Nutzlast — das eigentliche Telegramm
connected	der Verbindungszustand
lastError	die letzte Störung
rxCount	empfangene Telegramme
txCount	gesendete Telegramme

Nur data trägt Nutzlast. Die übrigen vier beschreiben die Verbindung selbst und werden nur gelesen — sie eignen sich gut als Kacheln auf einem Dashboard, wenn jemand im Blick behalten soll, ob eine Maschine noch spricht.

Nach außen schreiben

TCP kann schreiben. Ein Tag mit Kanal data und der Richtung Schreibt zur Maschine oder Beides sendet seinen Wert als Telegramm. Der Schreibvorgang gilt erst als erfolgreich, wenn der Sidecar-Prozess ihn bestätigt hat.