EVENTDISTR - Versionsgeschichte

Comawill: /* NowPlaying */ Lounge -> Chillraum

2014-11-04T23:08:34Z

‎NowPlaying: Lounge -> Chillraum

Daniel Bohrer: +Wireshark-Plugin und anderes Bild, das kein jpg ist

2013-07-04T02:25:53Z

+Wireshark-Plugin und anderes Bild, das kein jpg ist

Daniel Bohrer: /* Paketformat */

2013-06-27T09:12:30Z

‎Paketformat

Daniel Bohrer: Überarbeitung, RFC 2119

2013-06-20T03:04:06Z

Überarbeitung, RFC 2119

Daniel Bohrer: /* NowPlaying */ Beispiel repariert

2013-06-20T02:11:39Z

‎NowPlaying: Beispiel repariert

Daniel Bohrer: /* NowPlaying */ Null-Pakete, um beendete Wiedergabe zu signalisieren

2013-06-20T02:10:51Z

‎NowPlaying: Null-Pakete, um beendete Wiedergabe zu signalisieren

Daniel Bohrer: /* NowPlaying */ fix pre

2013-06-19T00:22:42Z

‎NowPlaying: fix pre

Daniel Bohrer: v2, Codename Bach.

2013-06-19T00:06:19Z

v2, Codename Bach.

Daniel Bohrer: +Format-Header

2013-06-18T23:36:19Z

+Format-Header

Daniel Bohrer: /* Implementierungen */ schöner & weiter nach unten

2013-06-18T23:33:52Z

‎Implementierungen: schöner & weiter nach unten

@@ Zeile 59: / Zeile 59: @@
 ;Area: Teilbereich des Spaces, für den das Event gilt. Dieses Feld SOLLTE einen der folgenden Werte annehmen:
 :*<tt>A</tt> für den Teilbereich [[Frickelraum]]
-:*<tt>B</tt> für den Teilbereich [[Lounge]]
+:*<tt>B</tt> für den Teilbereich [[Chillraum]]
 :*<tt>0</tt> für den Teilbereich [[Bad]]
 :*<tt>K</tt> für den Teilbereich [[Küche]]

@@ Zeile 1: / Zeile 1: @@
-{{Projekt|kontakt=[[Benutzer:Daniel Bohrer|Daniel Bohrer]], [[Benutzer:chrissi^|chrissi^]]|status=aktiv|beschreibung=Paketspezifikation für Events aller Art|bild=Beispiel UDP-Paket.jpg|bildbeschreibung=Beispiel-Paket in Wireshark}}
+{{Projekt|kontakt=[[Benutzer:Daniel Bohrer|Daniel Bohrer]], [[Benutzer:chrissi^|chrissi^]]|status=aktiv|beschreibung=Paketspezifikation für Events aller Art|bild=EVENTDISTR Wireshark.png|bildbeschreibung=Beispiel-Paket in Wireshark}}
 {{Hinweis|Die Schlüsselwörter MUSS, DARF NICHT, ERFORDERLICH, SOLL, SOLL NICHT, SOLLTE, SOLLTE NICHT, EMPFOHLEN, KANN und OPTIONAL in dieser Spezifikation sollen wie in RFC 2119 beschrieben interpretiert werden.}}
@@ Zeile 106: / Zeile 106: @@
 == Implementierungen ==
 * [https://github.com/stratum0/pyEventdistr pyEventdistr]: Python-Paket mit einigen Scripts um EVENTDISTR-Pakete zu generieren und empfangen (von {{Benutzer|comawill}})
 [[Kategorie:Dokumentation]]
 [[Kategorie:Infrastruktur]]

@@ Zeile 21: / Zeile 21: @@
 | 12 || <tt>;</tt> || Trennzeichen
 |-
-| 13-… || <tt><i>Event</i>=<i>Wert</i></tt> || Der Rest des Pakets besteht aus dem Namen des Events, OPTIONAL gefolgt von einem Trennzeichen (ASCII "<tt>=</tt>" == 61 == 0x3D) und einem zusätzlichem Wert. Es ist zu beachten, dass einige Implementierungen unter Umständen nicht das komplette Paket verarbeiten, sondern auf eine bestimmte Länge beschränkt sind; die Begrenzung der Länge von Paketen wird jedoch für neue Implementierungen NICHT EMPFOHLEN. Generell SOLLTE RFC 3514 beachtet werden.
+| 13-… || <tt><i>Name</i>=<i>Wert</i></tt> || Der Rest des Pakets besteht aus dem Namen des Events, OPTIONAL gefolgt von einem Trennzeichen (ASCII "<tt>=</tt>" == 61 == 0x3D) und einem zusätzlichem Wert. Es ist zu beachten, dass einige Implementierungen unter Umständen nicht das komplette Paket verarbeiten, sondern auf eine bestimmte Länge beschränkt sind; die Begrenzung der Länge von Paketen wird jedoch für neue Implementierungen NICHT EMPFOHLEN. Generell SOLLTE RFC 3514 beachtet werden.
 |}

@@ Zeile 1: / Zeile 1: @@
 {{Projekt|kontakt=[[Benutzer:Daniel Bohrer|Daniel Bohrer]], [[Benutzer:chrissi^|chrissi^]]|status=aktiv|beschreibung=Paketspezifikation für Events aller Art|bild=Beispiel UDP-Paket.jpg|bildbeschreibung=Beispiel-Paket in Wireshark}}
-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.
+{{Hinweis|Die Schlüsselwörter MUSS, DARF NICHT, ERFORDERLICH, SOLL, SOLL NICHT, SOLLTE, SOLLTE NICHT, EMPFOHLEN, KANN und OPTIONAL in dieser Spezifikation sollen wie in RFC 2119 beschrieben interpretiert werden.}}
-== Format ==
+Das EVENTDISTR-Protokoll ist ein Netzwerkprotokoll auf Anwendungsebene und spezifiziert ein Paketformat, um Events über das Netzwerk im Space zu verteilen.
-Der Payload der UDP-Pakete hat folgenden Aufbau:
 {| class="prettytable"
@@ Zeile 13: / Zeile 17: @@
 | 10 || <tt>v</tt> || Trennzeichen
 |-
-| 11 || Protokollversion || Version des Protokolls in ASCII. Zur Zeit wird Version 2 eingesetzt: ASCII "<tt>2</tt>" == 50 == 0x32. (Siehe auch [[#Changelog]])
+| 11 || Protokollversion || Version des Protokolls in ASCII. Implementierungen SOLLTEN frühere Protokollversionen verarbeiten können. Zur Zeit wird Version 2 eingesetzt: ASCII "<tt>2</tt>" == 50 == 0x32. (Siehe auch [[#Changelog]])
 |-
 | 12 || <tt>;</tt> || Trennzeichen
 |-
-| 13-… || <tt><i>Event</i>=<i>Wert</i></tt> || Name des Events, optional gefolgt von einem Trennzeichen (ASCII "<tt>=</tt>" == 61 == 0x3D) und einem zusätzlichem Wert. Es ist zu beachten, dass einige Implementierungen unter Umständen nicht das komplette Event verarbeiten, sondern auf eine bestimmte Länge beschränkt sind. Generell wird gebeten, RFC 3514 zu beachten.
+| 13-… || <tt><i>Event</i>=<i>Wert</i></tt> || Der Rest des Pakets besteht aus dem Namen des Events, OPTIONAL gefolgt von einem Trennzeichen (ASCII "<tt>=</tt>" == 61 == 0x3D) und einem zusätzlichem Wert. Es ist zu beachten, dass einige Implementierungen unter Umständen nicht das komplette Paket verarbeiten, sondern auf eine bestimmte Länge beschränkt sind; die Begrenzung der Länge von Paketen wird jedoch für neue Implementierungen NICHT EMPFOHLEN. Generell SOLLTE RFC 3514 beachtet werden.
 |}
 == Events ==
-Es folgt eine vollständige Auflistung der zur Zeit verwendeten Events.
+Events und Werte können frei gewählt werden, wobei es sinnvoll ist, weit verbreitete Events zu standardisieren. Es folgt deshalb eine vollständige Auflistung der zur Zeit spezifizierten Events, zusammen mit einer Beschreibung, in welchen Fällen sie genutzt werden und ihrer möglichen Werte.
 === DingDong ===
-Die Klingel an einer der beiden Haustüren wurde betätigt. Wird vom [[Doorbell Extender]] im Frickelraum verarbeitet. Das Event kann optional die Werte <tt>RISING</tt> oder <tt>FALLING</tt> annehmen, um die steigende oder fallende Flanke zu kennzeichnen.
+Die Klingel an einer der beiden Haustüren wurde betätigt. Dieses Event wird vom [[Doorbell Extender]] verwendet. Das Event kann OPTIONAL die Werte <tt>RISING</tt> oder <tt>FALLING</tt> annehmen, um die steigende oder fallende Flanke zu kennzeichnen.
 Beispiel:
@@ Zeile 31: / Zeile 35: @@
 === DoorUnten ===
-Der Türoffnungsknopf am Doorbell Extender wurde betätigt. Wird vom [[Doorbell Extender]] an der Tür oben verarbeitet. Das Event kann optional die Werte <tt>RISING</tt> oder <tt>FALLING</tt> annehmen, um die steigende oder fallende Flanke zu kennzeichnen.
+Der Türoffnungsknopf am Doorbell Extender wurde betätigt. Dieses Event wird vom [[Doorbell Extender]] verwendet. Das Event kann OPTIONAL die Werte <tt>RISING</tt> oder <tt>FALLING</tt> annehmen, um die steigende oder fallende Flanke zu kennzeichnen.
 Beispiel:
@@ Zeile 38: / Zeile 42: @@
 === SpaceOpened ===
-Wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „offen“ gesetzt wird. Es wird kein Wert gesendet.
+Dieses Event wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „offen“ gesetzt wird. Ein Wert SOLLTE nicht gesendet werden.
 Beispiel:
@@ Zeile 45: / Zeile 49: @@
 === SpaceClosed ===
-Wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „geschlossen“ gesetzt wird. Es wird kein Wert gesendet.
+Dieses Event wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „geschlossen“ gesetzt wird. Ein Wert SOLLTE nicht gesendet werden.
 Beispiel:
@@ Zeile 52: / Zeile 56: @@
 === NowPlaying ===
-Dient zur Ankündigung von aktuell gespielten Songtitel/Interpreten im Space. Der Wert besteht aus folgenden Feldern, die jeweils durch Nullbytes abgeschlossen sind:
+Dient zur Ankündigung von aktuell gespielten Songtiteln/Interpreten im Space. Der Wert des Events MUSS aus folgenden Feldern bestehen, die jeweils durch Nullbytes abgeschlossen werden:
-;Area: Teilbereich des Spaces, für den das Event gilt. Kann folgende Werte annehmen:
+;Area: Teilbereich des Spaces, für den das Event gilt. Dieses Feld SOLLTE einen der folgenden Werte annehmen:
 :*<tt>A</tt> für den Teilbereich [[Frickelraum]]
 :*<tt>B</tt> für den Teilbereich [[Lounge]]
 :*<tt>0</tt> für den Teilbereich [[Bad]]
 :*<tt>K</tt> für den Teilbereich [[Küche]]
-;Interpret: Der Interpret des Musikstücks, das zur Zeit im Teilbereich des Spaces gespielt wird, kodiert im UTF-8-Zeichensatz (RFC 3629, ISO/IEC 10646-1:2000 Annex D)
+;Interpret: Der Interpret des Musikstücks, das zur Zeit im Teilbereich des Spaces gespielt wird. Dieses Feld SOLLTE im UTF-8-Zeichensatz (RFC 3629, ISO/IEC 10646-1:2000 Annex D) kodiert sein.
-;Title: der Titel des Musikstücks, das zur Zeit im Teilbereich des Spaces gespielt wird, kodiert im UTF-8-Zeichensatz (RFC 3629, ISO/IEC 10646-1:2000 Annex D)
+;Title: der Titel des Musikstücks, das zur Zeit im Teilbereich des Spaces gespielt wird. Dieses Feld SOLLTE im UTF-8-Zeichensatz (RFC 3629, ISO/IEC 10646-1:2000 Annex D) kodiert sein.
-Falls durch Implementierungen eine Begrenzung der Paketgröße vorgenommen wird, wird empfohlen, längere Zeichenketten von <em>Interpret</em> und <em>Title</em> an geeigneten Stellen durch „<tt>...</tt>“ abzukürzen.
+Falls durch Implementierungen eine Begrenzung der Paketgröße vorgenommen wird, KÖNNEN längere Zeichenketten in den Feldern <em>Interpret</em> und <em>Title</em> an geeigneten Stellen durch „<tt>...</tt>“ abgekürzt werden.
-Das Versenden eines NowPlaying-Events macht alle vorher gesendeten NowPlaying-Events ungültig. Alternativ kann in diesem Fall auch ein NowPlaying-Event gesendet werden, in dem die Felder ''Interpret'' und ''Title'' die leere Zeichenkette enthalten (z.B. wenn das Ende einer Playlist erreicht wurde und kein neuer Titel folgt).
+Mit dem Senden eines gültigen NowPlaying-Events erklärt der Sender die Ungültigkeit aller vorher gesendeten NowPlaying-Events. OPTIONAL kann in diesem Fall auch ein NowPlaying-Event gesendet werden, in dem die Felder ''Interpret'' und ''Title'' die leere Zeichenkette enthalten (bspw. wenn das Ende einer Playlist erreicht wurde und kein neuer Titel folgt).
-Beispiel: Im Frickelraum wird gerade „J. S. Bach: St Matthew Passion, Part I: No. 1. Chorus: Kommt, ihr Töchter, helft mir klagen (Chorus, Soprano in ripieno)“ von „Cologne Chamber Orchestra“ gespielt.
+Beispiel: Im Frickelraum wird gerade „J. S. Bach: St Matthew Passion, Part I: No. 1. Chorus: Kommt, ihr Töchter, helft mir klagen (Chorus, Soprano in ripieno)“ von „Cologne Chamber Orchestra“ wiedergegeben.
   0000000: 4556 454e 5444 4953 5452 7632 3b4e 6f77  EVENTDISTRv2;Now
@@ Zeile 77: / Zeile 81: @@
   0000080: 2e00                                     ..
-Beispiel: Die Wiedergabe im Frickelraum wurde beendet und es folgt kein weiteres Lied.
+Beispiel: Die Wiedergabe im Frickelraum wurde beendet und es folgt kein weiteres Musikstück.
   0000000: 4556 454e 5444 4953 5452 7632 3b4e 6f77  EVENTDISTRv2;Now
@@ Zeile 83: / Zeile 87: @@
 === VirtualMsg ===
-Zum Ankündigungen von Nachrichten aus dem virtuellen Raum im Space. Die Nachricht kann z.&nbsp;B. aus dem IRC kommen und im Space auf einer LED-Leiste angezeigt werden. Der Wert des Events besteht aus der entsprechenden Nachricht, die angezeigt werden soll.
+Dieses Event kann zum Ankündigungen von Nachrichten aus dem virtuellen Raum im Space genutzt werden. Die Nachricht kann z.&nbsp;B. aus dem IRC kommen und im Space auf einer LED-Leiste angezeigt werden. Der Wert des Events MUSS existieren und besteht aus der entsprechenden Nachricht, die angezeigt werden soll.
 Beispiel:

@@ Zeile 75: / Zeile 75: @@
   0000060: 312e 2043 686f 7275 733a 204b 6f6d 6d74  1. Chorus: Kommt
   0000070: 2c20 6968 7220 54c3 b663 6874 6572 2e2e  , ihr T..chter..
-  0000080: 2e00
+  0000080: 2e00                                     ..
 Beispiel: Die Wiedergabe im Frickelraum wurde beendet und es folgt kein weiteres Lied.

@@ Zeile 65: / Zeile 65: @@
 Beispiel: Im Frickelraum wird gerade „J. S. Bach: St Matthew Passion, Part I: No. 1. Chorus: Kommt, ihr Töchter, helft mir klagen (Chorus, Soprano in ripieno)“ von „Cologne Chamber Orchestra“ gespielt.
-0000000: 4556 454e 5444 4953 5452 7632 3b4e 6f77  EVENTDISTRv2;Now
+ 0000000: 4556 454e 5444 4953 5452 7632 3b4e 6f77  EVENTDISTRv2;Now
-0000010: 506c 6179 696e 673d 4100 436f 6c6f 676e  Playing=A.Cologn
+ 0000010: 506c 6179 696e 673d 4100 436f 6c6f 676e  Playing=A.Cologn
-0000020: 6520 4368 616d 6265 7220 4f72 6368 6573  e Chamber Orches
+ 0000020: 6520 4368 616d 6265 7220 4f72 6368 6573  e Chamber Orches
-0000030: 7472 6100 4a2e 2053 2e20 4261 6368 3a20  tra.J. S. Bach:
+ 0000030: 7472 6100 4a2e 2053 2e20 4261 6368 3a20  tra.J. S. Bach:
-0000040: 5374 204d 6174 7468 6577 2050 6173 7369  St Matthew Passi
+ 0000040: 5374 204d 6174 7468 6577 2050 6173 7369  St Matthew Passi
-0000050: 6f6e 2c20 5061 7274 2049 3a20 4e6f 2e20  on, Part I: No.
+ 0000050: 6f6e 2c20 5061 7274 2049 3a20 4e6f 2e20  on, Part I: No.
-0000060: 312e 2043 686f 7275 733a 204b 6f6d 6d74  1. Chorus: Kommt
+ 0000060: 312e 2043 686f 7275 733a 204b 6f6d 6d74  1. Chorus: Kommt
-0000070: 2c20 6968 7220 54c3 b663 6874 6572 2e2e  , ihr T..chter..
+ 0000070: 2c20 6968 7220 54c3 b663 6874 6572 2e2e  , ihr T..chter..
-0000080: 2e00
+ 0000080: 2e00
 === VirtualMsg ===

← Nächstältere Version		Version vom 18. Juni 2013, 23:36 Uhr
Zeile 3:		Zeile 3:
	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.		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.

		+	== Format ==
	Der Payload der UDP-Pakete hat folgenden Aufbau:		Der Payload der UDP-Pakete hat folgenden Aufbau:

@@ Zeile 77: / Zeile 77: @@
   0000030: 616e 6420 696d 2073 7061 6365 3f         and im space?
 :''siehe auch [[StratumPing]]''
 [[Kategorie:Dokumentation]]
 [[Kategorie:Infrastruktur]]