====== MQTT ======

Weil IoT das Ding ist, sind wir dabei zunehmend $dinge ans Netzwerk zu klemmen.

Unser MQTT-Server lässt sie miteinander sprechen. It's a tremendous network!

====== unverbindliche Topic-Empfehlungen ======


<code> Orte:
 foobar/oben/baellebad/# für $dinge im Bällebad
 foobar/oben/lounge/# für $dinge in der Lounge

 foobar/keller/elab/#
 foobar/keller/werkstatt/#
 foobar/keller/trollhoehle/#
</code>
<code> Sensordaten unter $location/$device/sensor/$metrik
</code>



====== MQTT-Endpunkte ======



===== Beamer =====

Der Beamer in der Lounge lässt sich über folgendes Topic steuern.

<code> foobar/oben/lounge/beamer/action = [on|off|vga|hdmi1|hdmi2]
</code>
Über die Nachrichten on/off kann der Beamer in Betrieb genommen und wieder ausgeschaltet werden. Die Nachrichten vga/hdmi1/hdmi2 wählt die Videoquelle aus.

Die nachstehenden Topics liefern verschiedene Informationen über den Betriebsstatus und die Videoquelle. no_input wird zurückgegeben, wenn auf der gewählten Videoquelle kein Signal angeschlossen ist.

<code> foobar/oben/lounge/beamer/source [vga|hdmi|no_input|off]
 foobar/oben/lounge/beamer/status [off|on]
</code>

===== Leinwand =====


Leinwand up/down steuern per Message:

<code> foobar/oben/lounge/leinwand/action = [up|halt|down]
</code>
<code> foobar/oben/lounge/leinwand/set/r = 0-255
 foobar/oben/lounge/leinwand/set/g = 0-255
 foobar/oben/lounge/leinwand/set/b = 0-255
</code>
<code> foobar/oben/lounge/leinwand/set/default = Mb2.r5oHf-0t
</code>

===== Borg16 =====

Über das Topic kann die Anzeige des borg16 an- und abgeschaltet werden.

<code> foobar/oben/lounge/borg/action = [on|blank]
</code>
Zeigt Nachrichten <nowiki><=</nowiki> 128 byte auf der Matrix an.

<code> foobar/oben/lounge/borg/msg = [$Text]
</code>
Das folgende Topic liefert Informationen über den Status des borg16.

<code> foobar/oben/lounge/borg/status [on|blank]
</code>

===== Türstatus =====


Liefert up/down für den Türschloß-Status

<code> foobar/oben/tuer
 foobar/keller/tuer
</code>

===== Temperatur =====


Liefert Temparatur in Celsius

<code> foobar/oben/lounge/sensor/temp
</code>

===== Deckenlautsprecher =====

Der (Test)-Lautsprecher befindet sich gegenwärtig im Bällebad unter

<code> foobar/oben/baellebad/speaker/
</code>
Software und Endpoints dokumentiert auf [[https://github.com/c3e/mqpb|github]]


===== Licht/Elektronik =====

Licht und Elektronik im Club an und aus schalten

<code> foobar/aerie/licht = [0-9]
 foobar/aerie/licht = [flur, baellebad, lounge-front, lounge-back, baellebad-ein, 
                       lounge-ein, cantina-ein, zentral-aus, cantina]
</code>
Wenn der Endpunkt mit Namen benutzt wird, kann man auch Parameter übergeben. Auf einer Skala von 1 bis 100 sollte man so dimmen können [WIP].

<code> foobar/aerie/licht = [baellebad,10],[lounge-front,20]
</code>

Auf besonderen Wunsch entstanden auch folgenden Endpunkte:

<code> foobar/aerie/licht = [cantina-strobo,2n],[flur-strobo,2n],
                       [deineelternhabenneziemlichepartygefeiert,2n]
</code>

===== Licht/Elektronik (neu) =====

Die neue Api hat einen Rückkanal für Status-Updates.

==== Licht ====

<code> 
foobar/aerie/lounge-front   /licht/action
             lounge-back    /     /status
             cantina        /
             flur           /               
             baellebad      /
</code>

==== Strom ====

<code>
foobar/aerie/lounge    /strom/action
             cantina         /status      
             baellebad       /
             zentral         /        # nur "off"
</code> 
Auf dem Endpunkt ''../action'' erwartet die Api "on"/"off" als Payload, auf status werden updates propagiert (ebenfalls mit "on"/"off"). 

===== HIFI =====

Man kann in Aerie alle Hifi Anlagen per MQTT steuern. Dies geschieht mit Hilfe des Projekts auf https://git.chaospott.de/aeris/mqtt-ir-bridge. Beschrieben wird es **[[infrastruktur:hifi:|HIER]]**.


===== Terminals =====


Schaltet die Terminal Monitore an/aus (für Szenen und Stromsparen)

<code> foobar/keller/labor/terminal = [ON/OFF]
 foobar/oben/flur/terminal = [ON/OFF]
</code>

===== Energiesparmodus =====


Wenn man alleine im Club sitzt und nicht alles blinken soll...

<code> foobar/powersave = [ON/OFF]
</code>

===== CYBER-Alarm / IPv6-Bug-Alarm =====


Schaltet die mobile Alarmleuchte an bzw. aus.

<code>  foobar/alarm/alaarm = [beliebig]
</code>

===== Flipdot =====

Für das [[projekte:flipdot:start|Flipdot Display]] im Keller gibt es auch diverse Endpunkte.

Die Dokumentation für das Projekt ist [[projekte:flipdot:start|hier]].
===== Mqtt-Sprechdings =====


Der MPD im Keller hat Bewusstsein erlangt und spricht:

<code>  foobar/keller/elab/mptalk = text
</code>

===== Getränkebestand =====

  foobar/tantemate/stocks/$item


===== Heizung =====
Geplant

  foobar/oben/baellebad/heizung/action [off|int|on]
  foobar/oben/baellebad/heizung/status [int | int off]

  
  foobar/oben/lounge/heizung/action [off|int|on]
  foobar/oben/lounge/heizung/status [int | int off]
  
  foobar/oben/cantina/heizung/action [off|int|on]
  foobar/oben/cantina/heizung/status [int | int off]

  foobar/keller/elab/heizung/action [off|int|on]
  foobar/keller/elab/heizung/status [int | int off]
   
  foobar/keller/werkstatt/heizung/action [off|int|on]
  foobar/keller/werkstatt/heizung/status [int | int off]

====== Clients ======


Siehe [[http://www.hivemq.com/blog/seven-best-mqtt-client-tools|Empfehlungsliste]].


===== Beispiel =====


  mosquitto_pub -h mqtt.chaospott.de -t foobar/oben/licht -m "baellebad,100"