TCPP Mask Node

Was ein Masken-Node ist

tcpp-mask ist eine zweite ausführbare Datei, aus demselben Code gebaut wie der Node: ein TCPP-Modul, das sich wie ein Display verhält. Ein Node liefert ihm mit mask_output ein Layout und füllt es mit display_output; der Masken-Node zeichnet das Ergebnis als Gerätebildschirm und beantwortet jede Anfrage von sich aus, mit einer signierten Antwort, deren error_code sagt, was er vorgefunden hat. Damit hat ein Node, oder eine eigene TCPP-Implementierung, ein Gegenüber, das das Gesendete so prüft, wie ein Display es täte.

Alles Übrige an ihm ist der Node: dieselbe Identität, dasselbe Frame-Log, dieselben Peers und Signaturen, und dieselben Ansichten Compose, Inbox, Sent, Peers, Identity und Log, als Debug-Reiter unter seiner eigenen Ansicht Mask. Das Handbuch des Nodes beschreibt sie, und was es sagt, gilt hier unverändert. Dieses Handbuch behandelt, was der Masken-Node hinzufügt.

Erste Schritte

Was Sie bekommen haben

Eine ausführbare Datei, heruntergeladen als eigenes Archiv neben dem des Nodes, tcpp-mask-…-windows-amd64.zip. Wie der Node braucht sie keine Installation und greift auf nichts im Internet zu. Entpacken Sie sie und starten Sie sie aus einem Terminal:

# Windows
.\tcpp-mask.exe

# macOS und Linux
chmod +x tcpp-mask
./tcpp-mask

Der Download ist nicht signiert, beim ersten Start kommen also dieselben Warnungen wie beim Node; Erste Schritte im Handbuch des Nodes sagt, wie man an jeder vorbeikommt.

Neben einem Node starten

Allein nützt ein Masken-Node nichts: Er wartet darauf, dass ein Node ihm Masken schickt. Seine Standardwerte sind so gewählt, dass er zu einem Node auf dem üblichen Port passt:

# PowerShell, zwei Fenster
.\tcpp-node.exe --peer localhost:8444
.\tcpp-mask.exe

# macOS und Linux
./tcpp-node --peer localhost:8444
./tcpp-mask

Öffnen Sie https://localhost:8443/ für den Node und https://localhost:8444/ für den Masken-Node. Jeder hat sein eigenes selbstsigniertes Zertifikat, der Browser warnt also für jeden einmal.

Was auf der Platte entsteht

Jeder hält Schlüssel, Zertifikat, Log und Records in einem eigenen Ordner, tcpp-node-data/ oder tcpp-mask-data/; deshalb lässt sich der Masken-Node in dasselbe Verzeichnis entpacken wie ein Node, ohne dass beide eine Identität teilen. Die Dateien in tcpp-mask-data/ sind die des Nodes, aufgeführt unter Was auf der Platte entsteht. Beim Start gibt er die Übersicht des Nodes aus und drei eigene Zeilen:

2026/10/22 11:39:51 TCPP mask node LDU / P:NODE-01D1F0C8
2026/10/22 11:39:51   listening   https://localhost:8445/
2026/10/22 11:39:51   identity    C:\Users\User\tcpp-lab\m\tcpp-mask-data
…
2026/10/22 11:39:51   masks       0 in the library
2026/10/22 11:39:51   accepts     mask_output, display_output, ping
2026/10/22 11:39:51   auto-reply  on, strict checks on

Das Labor dieses Handbuchs

Die Abbildungen stammen aus dem Zwei-Node-Labor des Node-Handbuchs und einer dritten Instanz daneben, M, gestartet mit --port 8445, weil Node B schon 8444 belegt. Node A hat ihr das mask_output des Zählerbeispiels geschickt, dann sein display_output, dann ein display_output mit einer Maske, die M nie bekommen hat, und ein ping.

Die Ansicht Mask

• Masks, links, ist die Bibliothek: jede Maske, die der Node angenommen hat, jede mit ihrer Größe in Zeichen × Zeilen, ihrer Herkunft, ihren Layout-Befunden und ob schon Werte für sie eingegangen sind. Ein Klick zeigt sie an. Ein Frame, der für eine Maske eingeht, schaltet die Ansicht auf diese Maske um.
• Die mittlere Spalte ist die Maske selbst: Kennzeichen, Id, Größe und der Frame, mit dem sie kam, der Gerätebildschirm, der Frame, aus dem die Werte stammen, und die Tabelle Fields, eine Zeile je Feld mit Id, Kennzeichen, Typ, Position, Länge, aktuellem Wert und Merkmalen.
• Answers, rechts, listet jede empfangene Anfrage mit dem Code, mit dem sie beantwortet wurde.

Der Bildschirm

Der Bildschirm wird auf dem Zeichenraster der Maske gezeichnet. Region wählt, in welcher Region der Maske (etwa de-DE) die Beschriftungen erscheinen. Field outlines and ruler rahmt jedes Feld und nummeriert die Zeilen und jede zehnte Spalte; so fällt ein Feld, das um eins verrutscht ist, am schnellsten auf. Ein Druck auf eine Taste oder Enter in einem Eingabefeld des Bildschirms zeigt unter dem Bildschirm das display_input, für das er steht; gesendet wird es nicht.

Antworten und die beiden Schalter

Jede Zeile nennt die Anfrage, den Code der Antwort, den Peer und ob die Antwort zugestellt wurde. Ein anderer Code als 000000 kommt mit dem Grund, den die Antwort auch in error_text trägt.

Beide sind standardmäßig an. Die Flags setzen sie beim Start, etwa --strict-layout=false; die Schalter ändern sie im laufenden Betrieb.

Was er annimmt und was er antwortet

• mask_output liefert ein Layout. Angenommen, kommt es in die Bibliothek, ersetzt dort eines mit derselben mask_id und wird angezeigt.
• display_output füllt eine Maske mit Werten. Die Maske wird über display_mask_id benannt, jeder Wert über field_id an sein Feld gebunden.
• ping wird mit dem Record des Beispiels ping_response beantwortet.

Jede andere Anfrage erhält eine Fehlerantwort. Antworten werden nie beantwortet, daher können sich zwei antwortende Nodes nicht gegenseitig aufschaukeln. Die Codes stammen aus all_error_codes, mit FFF als Modulstellen, wie in den Beispielen der Spezifikation selbst:

parsed trägt den Code am Pfad jedes Befunds, etwa record/mask/mask_fields/14, und weiter oben an record/mask und record. error_text sagt, was falsch war, gekürzt auf die Zeichen, die das Muster des Heads zulässt. Ein Head-Element, das seine eigene Prüfung nicht bestanden hat, wird nicht zurückgespiegelt: Typ und Id des Nodes selbst, oder das X-TCPP-Node des Absenders, treten an seine Stelle.

Die Bibliothek über Neustarts hinweg

Die Bibliothek folgt dem Frame-Log, wie der Posteingang. Sie beginnt leer — Masken kommen nur von einem Peer, die mitgelieferten Beispiele sind für den Node, der sie sendet —, und beim Start werden die empfangenen Frames vom ältesten an wieder eingespielt. Wo das Log die Antwort enthält, die hinausging, zählt diese Antwort: Eine Maske, die bei ausgeschalteten strikten Prüfungen angenommen wurde, bleibt auch nach einem Neustart mit eingeschalteten angenommen.

Um mit einer leeren Bibliothek neu anzufangen, halten Sie den Masken-Node an und entfernen tcpp-frames.jsonl aus tcpp-mask-data/. Schlüssel und Peers bleiben, für jeden, der ihn prüft, ist er also derselbe Node.

Arbeitsabläufe

Kommandozeile

Der Masken-Node versteht jedes Flag des Nodes, beschrieben unter Kommandozeile und Dateien in dessen Handbuch. Vier davon haben andere Standardwerte, zwei sind seine eigenen:

Der Datenordner heißt nicht tcpp-mask/, weil unter macOS und Linux die Binärdatei selbst so heißt. Er läuft und hält an wie der Node; ein gescheiterter Start gibt tcppmask: <Grund> aus und endet mit 1.

HTTP-API

Der Masken-Node bedient jede Route des Nodes, aufgeführt unter HTTP-API in dessen Handbuch, ebenso ohne Authentifizierung. Die Ansicht Mask nutzt drei weitere:

# strikte Prüfungen an einem laufenden Masken-Node abschalten
curl -k -X PUT https://localhost:8444/api/mask/settings \
  -H 'content-type: application/json' -d '{"strict":false}'

Anhang

Glossar

Maske

Ein Bildschirmlayout, geliefert mit mask_output: ein Raster aus Zeichen × Zeilen und die darauf platzierten Felder, benannt durch seine mask_id.

Feld

Eine Stelle auf einer Maske, benannt durch ihre field_id, in die ein Wert aus display_output geschrieben wird.

Region

Eine Sprachfassung der Beschriftungen einer Maske, etwa de-DE.

Masken-Node

tcpp-mask, ein Node, der Masken anzeigt und jede Anfrage mit einem Fehlercode beantwortet, wie es ein Display täte.

Frame, Peer, Record

Wie im Handbuch des Nodes.

Über die Abbildungen

Jede Abbildung in diesem Handbuch stammt von einem laufenden Masken-Node neben dem Zwei-Node-Labor des Node-Handbuchs, keine ist gezeichnet; was Sie hier sehen, ist also, was die Anwendung tut. Aufgenommen werden sie vom selben Skript wie die Abbildungen des Nodes, das einen Browser ohne Anzeige durch die Schritte eines Bedieners führt; sie werden neu aufgenommen, wann immer sich die Oberfläche ändert. Die Anwendung ist englisch, deshalb zeigen auch die Abbildungen dieser Ausgabe die englische Oberfläche.