Downloads

Referenzknoten

Alles, was der Knoten zur Laufzeit braucht, ist einkompiliert: Schemasatz, ausgearbeitete Beispiele und die Weboberfläche. Schlüssel, Zertifikat und Protokolle legt er beim ersten Start neben sich ab.

Prüfsummen zu allen Dateien dieser Seite: SHA256SUMS.txt.

Weitere Plattformen auf Anfrage. Der Knoten ist reines Go ohne Abhängigkeiten und lässt sich unverändert für Linux, macOS und ARM-Maschinen übersetzen. Diese Binärdateien sind hier nicht veröffentlicht, wir stellen sie aber gern bereit: eine Anfrage an info@iw-service.de genügt, mit Angabe von Betriebssystem und Prozessorarchitektur.

Starten

# .zip entpacken, dann in diesem Ordner
tcpp-node.exe

Der Knoten öffnet https://localhost:8443/. Das Zertifikat, das er sich selbst ausstellt, ist selbstsigniert; der Browser warnt daher einmal. Endpunkt wählen, Beispiel laden, dann Sign & Send.

Interessant wird es mit zwei Knoten, die miteinander sprechen; dafür genügen zwei Kopien in zwei Verzeichnissen:

a\tcpp-node.exe --port 8443 --node-type CSU --peer localhost:8444
b\tcpp-node.exe --port 8444 --node-type TMH --peer localhost:8443

Ein auf A signierter Frame erscheint sofort im Posteingang von B; ihn auszuwählen öffnet ein vorbefülltes Antwortformular. Das Handbuch beschreibt jeden Bildschirm, die Kommandozeile, die Dateien des Knotens und seine HTTP-Schnittstelle.

Maskenknoten

Eine zweite Binärdatei aus demselben Code: ein TCPP-Modul, das sich wie ein Display verhält. Es zeigt die Masken, die ein Knoten mit mask_output liefert, füllt sie mit den Werten aus display_output, beantwortet ping und antwortet von sich aus auf jede Anfrage mit einer signierten Antwort, deren error_code sagt, was es vorgefunden hat. So hat ein Knoten, oder eine eigene Implementierung, ein Gegenüber.

Neben einem Knoten starten

tcpp-node.exe --peer localhost:8444
tcpp-mask.exe

Der Maskenknoten lauscht auf https://localhost:8444/, nennt sich LDU und schickt seine Antworten an localhost:8443; diese zwei Zeilen sind also schon ein vollständiges Paar. Auf dem Knoten mask_output wählen, example_meter laden und senden, dann dasselbe mit display_output: Der Maskenknoten zeigt die Zählermaske mit ihren Werten, und im Posteingang des Knotens liegen beide Antworten.

Schlüssel, Zertifikat und Protokoll legt er in einem Ordner tcpp-mask-data neben sich ab, so wie der Knoten in tcpp-node-data. Er lässt sich daher in denselben Ordner entpacken wie ein Knoten, ohne dessen Identität mitzubenutzen. Sein Handbuch beschreibt die Maskenansicht, die Fehlercodes seiner Antworten und seine Kommandozeile.

Handbücher

Ein Handbuch je Binärdatei. Das des Knotens ist die Betreibersicht auf ihn: jeder Bildschirm und jeder Arbeitsablauf, illustriert mit Abbildungen aus einem laufenden Zwei-Knoten-Labor, dazu Kommandozeile, Dateien, HTTP-Schnittstelle und der Aufbau einer TCPP-Nachricht. Das des Maskenknotens beschreibt, was er hinzufügt: die Maskenansicht, die Codes seiner Antworten, seine Flags und Routen. Hier lesen, oder als PDF auf einen Rechner ohne Verbindung mitnehmen.

Schema 1.3.0

Alle 57 Schemadateien: 28 Request/Response-Paare und der gemeinsame Rahmen. Derselbe Satz, den der Knoten mitbringt, und derselbe, der hier unter den URLs ausgeliefert wird, die die $id der Dateien selbst nennt.

Lizenz

TCPP ist ein offenes Protokoll. Schemas, Beispiele und diese Dokumentation dürfen frei verwendet und weiterverarbeitet werden, auch in kommerziellen Produkten. Die Spezifikation ist ein Entwurf: Version 1.3.0 ist vollständig genug, um dagegen zu entwickeln; Änderungen werden hier veröffentlicht.