EVENTDISTR.mw

   1 Im Space gibt es ein standardisiertes Protokoll, wie Events über das Netzwerk verteilt werden. Das Protokoll baut auf UDP auf und benutzt Port 31337. Die Pakete können sowohl als Unicast als auch als Broadcast oder Multicast gesendet werden.
   2
   3 Der Payload der UDP-Pakete hat folgenden Aufbau:
   4
   5 [[Datei:Beispiel UDP-Paket.jpg|thumb|300px|Beispiel-Paket in Wireshark]]
   6 {| class="prettytable"
   7 ! Offset (Byte) !! Inhalt !! Bemerkung
   8 |-
   9 | 0 || <tt>EVENTDISTR</tt> || Magic String zur Erkennung des Protokolls
  10 |-
  11 | 10 || <tt>v</tt> || Trennzeichen
  12 |-
  13 | 11 || Protokollversion || Zur Zeit wird Version 1 eingesetzt: <tt>ord("1")</tt> == 49
  14 |-
  15 | 12 || <tt>;</tt> || Trennzeichen
  16 |-
  17 | 13-… || Event-Informationen || siehe unten. Dieser Teil des Paketes darf eine maximale Länge von 100 Byte nicht überschreiten! (Andernfalls wird gebeten, RFC 3514 zu beachten.)
  18 |}
  19
  20 == Events ==
  21 Es folgt eine vollständige Auflistung der zur Zeit verwendeten Events.
  22
  23 === DingDong ===
  24 Die Klingel an einer der beiden Haustüren wurde betätigt. Wird vom [[Doorbell Extender]] im Frickelraum verarbeitet. Hinter dem Namen des Events kann <tt>=RISING</tt> oder <tt>=FALLING</tt> angehängt werden, um die steigende oder fallende Flanke zu kennzeichnen.
  25
  26 Beispiel:
  27  0000000: 4556 454e 5444 4953 5452 7631 3b44 696e  EVENTDISTRv1;Din
  28  0000010: 6744 6f6e 673d 5249 5349 4e47            gDong=RISING
  29
  30 === DoorUnten ===
  31 Der Türoffnungsknopf am Doorbell Extender wurde betätigt. Wird vom [[Doorbell Extender]] an der Tür oben verarbeitet. Hinter dem Event-Namen kann <tt>=RISING</tt> oder <tt>=FALLING</tt> angehängt werden, um die steigende oder fallende Flanke zu kennzeichnen.
  32
  33 Beispiel:
  34  0000   4556 454e 5444 4953 5452 7631 3b44 6f6f    EVENTDISTRv1;Doo
  35  0010   7255 6e74 656e 3d52 4953 494e 47           rUnten=RISING
  36
  37 == SpaceOpened ==
  38 Wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „offen“ gesetzt wird.
  39
  40 Beispiel:
  41  0000000: 4556 454e 5444 4953 5452 7631 3b53 7061  EVENTDISTRv1;Spa
  42  0000010: 6365 4f70 656e 6564                      ceOpened
  43
  44 == SpaceClosed ==
  45 Wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „geschlossen“ gesetzt wird.
  46
  47 Beispiel:
  48  0000000: 4556 454e 5444 4953 5452 7631 3b53 7061  EVENTDISTRv1;Spa
  49  0000010: 6365 436c 6f73 6564                      ceClosed
  50
  51 [[Kategorie:Dokumentation]]
  52 [[Kategorie:Infrastruktur]]