Telegramm

Aus homeautomation.x-api.de
Version vom 4. November 2017, 12:56 Uhr von Robertadmin (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „Auf dieser Seite wird die Gestaltung der über Rundruf versendeten Telegramme (Botschaften, Nachrichten, etc.) erläutert. Die Einhaltung dieser Festlegungen g…“)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

Auf dieser Seite wird die Gestaltung der über Rundruf versendeten Telegramme (Botschaften, Nachrichten, etc.) erläutert. Die Einhaltung dieser Festlegungen garantiert, dass ein Follower (Folgender, Zuhörer, Lauscher, etc.) alle Twitter (Zwitschernde, Redende, Informierende, etc.) versteht und Geräte einfach, in der Regel ohne weitere Installationsmaßnahmen, in das Netzwerk integriert werden können.

Übersicht (Struktur)

Die Telegramme wurden mit Blick auf die typische Internet- bzw. Intranet-Kommunikation festgelegt. Als Randbedingung wurde berücksichtigt,

  • dass das beim Rundruf verwendete UDP eine maximale Telegrammlänge von 1460 Zeichen nahelegt,
  • dass wegen der Nutzung in heterogenen Netzen für die Verteilung (Routing) geeignete Informationen (z.B. MAC-Adresse und IP-Adresse) enthalten sind und
  • dass nicht benötigte Elemente einfach leer bleiben können.

Mit Blick auf eine möglichst flexible inhaltliche Nutzung und die einfache Lesbarkeit wurden die Telegramme als Folge von Textzeichen (UTF-8) definiert und die Separation der verschiedenen Inhalte über spezielle Textzeichen (Doppelpunkt : und Semikolon ;) vorgenommen. Daraus ergab sich folgende Struktur

Kopf1:Kopf2: .... KopfN:Info1;Info2; .... InfoM::

Damit sind die Zeichen : und ; in den Inhalten (Kopf, Info) nicht zulässig, sie würden zu Fehlinterpretationen führen. Aus diesem Grund wird die Anzahl der Inhalte/Felder entweder fest vorgegeben oder über eine Regel in den Inhalten definiert. Telegramme mit einer unzulässigen Anzahl von : und ; werden verworfen.