Editing Archiv:Lichtsteuerung (section)

== Software ==

* [https://github.com/chaosdorf/dorfmap dorfmap]
* [https://github.com/chaosdorf/dorfmap-deb dorfmap-deb] (Helfer)

=== Automatik ===

Die Außenbeleuchtung wird automatisch nach der aktuellen Tageszeit geschaltet. Benutzt wird dazu die Perl-Library Astro::Sunrise, die anhand unserer Koordinaten und dem aktuellen Datum recht akkurate Zeiten für Sonnenauf- und -untergang [https://github.com/chaosdorf/dorfmap-deb/blob/master/bin/is_sundown berechnet]. Per [https://github.com/chaosdorf/dorfmap-deb/blob/master/debian/dorfmap-deb.cron.d cronjob] wird alle 6 Minuten überprüft, ob Nacht ist oder nicht, und entsprechend die Beleuchtung geschaltet.

Der [[Printer/HP2100]] und die [[Windowgarden]]-Pumpe werden nach einiger Zeit automatisch abgeschaltet.

=== Manuell ===

Grundlage ist ein [https://github.com/chaosdorf/dorfmap/blob/master/public/images/map.png Grundriss] des Clubraums. Aus einer [https://github.com/chaosdorf/dorfmap-deb/blob/master/etc/dorfmap/coordinates Koordinatendatei] wird ausgelesen, wo welche Lampe ist, und abhängig von ihrem Status ein entsprechendes Symbol angezeigt. Bei automatisch gesteuerten Lampen wird die Automatik gesteuert, alle anderen können durch einen Klick aufs Symbol getoggelt werden.

Weil die Karte eh schon da ist, wird außerdem der Status von einigen Servern / Embedded Hosts, unseren WLAN-APs und den Druckern angezeigt. Der ist sinnvollerweise auch read-only, die Hosts werden einfach angepingt. Eingeschaltete Hosts sind grün, ausgeschaltete grau oder rot.

Es gibt eine Reihe von Shortcuts, die mehrere Aktionen zusammenfassen. "Shutdown" schaltet z.B. alle Lampen aus und den Raumstatus auf nicht-öffentlich, "Putzen" sorgt für viel Licht, etc.

=== API ===

Es existiert eine (noch nicht finale) JSON-API. In einigen Fällen wird auch Textausgabe unterstützt.  Für Textformat <tt>.txt</tt> an Anfragen anhängen (oder <tt>curl -H 'Accept: text/plain'</tt> benutzen), für JSON entsprechend <tt>.json</tt> bzw. <tt>application/json</tt>.

<tt>/get</tt> liefert derzeit auch PNGs. Sie entsprechen den in der Übersicht verwendeten.

{| class="wikitable"
! Request
! Parameter
! Aktion
|-
| POST <tt>/action</tt>
| '''action'''=<nowiki>on|off|toggle</nowiki>, '''device'''=''lampe''
| Schaltet ''lampe'' an / aus, gibt den neuen Status als JSON zurück
|-
| POST <tt>/action</tt>
| '''action'''=shortcut, '''shortcut'''=''aktion''
| Führt ''aktion'' aus (z.B. shutdown oder amps on)
|-
| POST <tt>/action</tt>
| '''action'''=preset, '''preset'''=''preset''
| Schaltet die Lampen wie in ''preset'' angegeben
|-
| GET <tt>/ajax/blinkencontrol</tt>
| '''device'''=''lampe''
| Gibt alle gespeicherten [[Blinkencontrol]]-Animationen (und falls bekannt die aktuell laufende) als JSON zurück
|-
| POST <tt>/ajax/blinkencontrol</tt>
| '''device'''=''lampe'', '''raw_string'''=''animation''
| Setzt ''animation'' auf ''lampe''. Format ist <tt>delay1,red1,green1,blue1 delay2,red2,green2,blue2</tt> <nowiki>[...]</nowiki>, siehe [[Blinkencontrol]]
|-
| POST <tt>/ajax/blinkencontrol</tt>
| '''device'''=''lampe'', '''raw_string'''=''animation'', '''name'''=''name''
| Setzt ''animation'' auf ''lampe'' und speichert sie unter ''name'' ab, so dass sie im Webinterface ausgewählt werden kann.
|-
| POST <tt>/ajax/blinkencontrol</tt>
| '''device'''=''lampe'', '''name'''=''name'', '''delete'''=1
| Löscht die Animation ''name'' von ''lampe''
|-
| GET <tt>/ajax/charwrite</tt>
|
| Gibt die möglichen Modi zurück
|-
| POST <tt>/ajax/charwrite</tt>
| '''device'''=''anzeige'', '''text'''=''modus''<nowiki>|</nowiki>''text''
| Setzt modus oder freitext für ''anzeige''
|-
| GET <tt>/ajax/menu</tt>
|
| Gibt die vorhandenen Shortcuts und Presets (siehe <tt>/action</tt>) zurück
|-
| GET <tt>/get/''device''</tt>
|
| Gibt den aktuellen Status von ''device'' zurück
|-
| GET <tt>/list/all</tt>
|
| Gibt alle Geräte mit Koordinaten, Status, Beschreibung etc. zurück
|-
| GET <tt>/space_api</tt>
|
| Hackerspacestatus für die [http://spaceapi.net/ spaceAPI]
|-
|}