+NowPlaying

[stratum0-wiki.git] / EVENTDISTR.mw

diff --git a/EVENTDISTR.mw b/EVENTDISTR.mw
index 55c0b30..75f4bf4 100644 (file)
--- a/EVENTDISTR.mw
+++ b/EVENTDISTR.mw
@@ -10,43 +10,61 @@ Der Payload der UDP-Pakete hat folgenden Aufbau:
 |-
 | 10 || <tt>v</tt> || Trennzeichen
 |-
 |-
 | 10 || <tt>v</tt> || Trennzeichen
 |-

-| 11 || Protokollversion || Zur Zeit wird Version 1 eingesetzt: <tt>ord("1")</tt> == 49
+| 11 || Protokollversion || Zur Zeit wird nur Version 1 eingesetzt: ASCII "<tt>1</tt>" == 49 == 0x31

 |-
 | 12 || <tt>;</tt> || Trennzeichen
 |-
 |-
 | 12 || <tt>;</tt> || Trennzeichen
 |-

-| 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.)
+| 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. Dieser Teil des Paketes darf eine maximale Länge von 100 Byte nicht überschreiten! (Andernfalls wird gebeten, RFC 3514 zu beachten.)

 |}
 
 == Events ==
 Es folgt eine vollständige Auflistung der zur Zeit verwendeten Events.
 
 === DingDong ===
 |}
 
 == Events ==
 Es folgt eine vollständige Auflistung der zur Zeit verwendeten Events.
 
 === DingDong ===

-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.
+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.

 
 Beispiel:
  0000000: 4556 454e 5444 4953 5452 7631 3b44 696e  EVENTDISTRv1;Din
  0000010: 6744 6f6e 673d 5249 5349 4e47            gDong=RISING
 
 === DoorUnten ===
 
 Beispiel:
  0000000: 4556 454e 5444 4953 5452 7631 3b44 696e  EVENTDISTRv1;Din
  0000010: 6744 6f6e 673d 5249 5349 4e47            gDong=RISING
 
 === DoorUnten ===

-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.
+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.

 
 Beispiel:
  0000   4556 454e 5444 4953 5452 7631 3b44 6f6f    EVENTDISTRv1;Doo
  0010   7255 6e74 656e 3d52 4953 494e 47           rUnten=RISING
 
 
 Beispiel:
  0000   4556 454e 5444 4953 5452 7631 3b44 6f6f    EVENTDISTRv1;Doo
  0010   7255 6e74 656e 3d52 4953 494e 47           rUnten=RISING
 

-== SpaceOpened ==
-Wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „offen“ gesetzt wird.
+=== SpaceOpened ===
+Wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „offen“ gesetzt wird. Es wird kein Wert gesendet.

 
 Beispiel: 
  0000000: 4556 454e 5444 4953 5452 7631 3b53 7061  EVENTDISTRv1;Spa
  0000010: 6365 4f70 656e 6564                      ceOpened
 
 
 Beispiel: 
  0000000: 4556 454e 5444 4953 5452 7631 3b53 7061  EVENTDISTRv1;Spa
  0000010: 6365 4f70 656e 6564                      ceOpened
 

-== SpaceClosed ==
-Wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „geschlossen“ gesetzt wird.
+=== SpaceClosed ===
+Wird vom [[statusberry]] gesendet, wenn der Space-Öffnungsstatus auf „geschlossen“ gesetzt wird. Es wird kein Wert gesendet.

 
 Beispiel: 
  0000000: 4556 454e 5444 4953 5452 7631 3b53 7061  EVENTDISTRv1;Spa
  0000010: 6365 436c 6f73 6564                      ceClosed
 
 
 Beispiel: 
  0000000: 4556 454e 5444 4953 5452 7631 3b53 7061  EVENTDISTRv1;Spa
  0000010: 6365 436c 6f73 6564                      ceClosed
 

+=== NowPlaying ===
+Dient zur Ankündigung von aktuell gespielten Songtitel/Interpreten im Space. Der Wert besteht aus folgenden Feldern, die jeweils durch Nullbytes abgeschlossen sind:
+;Area: Teilbereich des Spaces, für den das Event gilt. Kann folgende 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)
+;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)
+
+Durch die Beschränkung der Payload auf 100 Byte sind die Felder ''Interpret'' und ''Title'' faktisch zusammen auf 87 Byte (jeweils inkl. abschließenden Nullbytes) beschränkt. Es wird empfohlen, größere Zeichenketten an geeigneten Stellen durch „<tt>...</tt>“ zu beenden.
+
+Beispiel: Im Frickelraum wird gerade „Carry on My Wayward Son“ von „Kansas“ gespielt.
+ 0000000: 4556 454e 5444 4953 5452 7631 3b4e 6f77  EVENTDISTRv1;Now
+ 0000010: 506c 6179 696e 673d 4100 4b61 6e73 6173  Playing=A.Kansas
+ 0000020: 0043 6172 7279 206f 6e20 4d79 2057 6179  .Carry on My Way
+ 0000030: 7761 7264 2053 6f6e 00                   ward Son.
+

 [[Kategorie:Dokumentation]]
 [[Kategorie:Infrastruktur]]
 [[Kategorie:Dokumentation]]
 [[Kategorie:Infrastruktur]]