Editing Archiv:Lichtsteuerung

{{Project
|name=Lichtsteuerung
|description=Verbraucher per Webinterface steuern
|project category=Hardware
|image=dorfmap.png
|status=stable
|people={{U|derf}}, {{U|marudor}}
|source=https://github.com/chaosdorf/dorfmap{{!}}github
}}
Lampen, Blinkenlights und weitere Geräte, fernsteuerbar per Automatik, Website und Android-App.

== Web ==

Die Lichtsteuerung findet sich unter [http://dorfmap/ dorfmap] im Chaosdorfnetz. Das Interface basiert auf AngularJS und wird von {{U|marudor}} entwickelt. Für sehr alte Geräte (und ggf. Smartphonebrowser) gibt es ein weniger hübsches Legacy-Interface unter [http://dorfmap/m dorfmap/m].

== Hardware ==

[[File:Avrmf.png|Generischer SI2C Slave|200x200px|framed|right]]
[[File:Chaosdoorlicht.png|Außenbeleuchtung|200x200px|framed|right]]

Kernstück des Ganzen sind [[SI2C]]-Instanzen an {{H|feedback}} und {{H|donationprint}}. Daran hängen die Steuer-AVRs der jeweiligen Geräte und tun (wenn sie mit der richtigen Adresse angesprochen werden) Dinge.

Einige Verbraucher werden noch direkt über GPIO-Pins (Optokoppler + Transistor) geschaltet, das ist aber Legacy und wird abgebaut.

Die Schaltspannung der Schieberegister ist 12V und geht wahlweise direkt zum Kleinverbraucher oder zu einem 230V-Relais.

== 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 20 Minuten automatisch abgeschaltet.

=== Manuell ===

Grundlage ist ein [https://github.com/chaosdorf/dorfmap/blob/master/public/map.png Grundriss] des Clubraums. Aus einer [https://github.com/chaosdorf/dorfmap/blob/master/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]
|-
|}

== Angeschlossene Geräte ==

Die genaue Zuordnung zwischen Kabel / GPIO-Pin und Gerät ist auf {{H|donationprint}} und {{H|feedback}} dokumentiert. Jede Automatik ist individuell deaktivierbar.

{| class="wikitable"
! Gerät !! Steuerung
|-
| Außenbeleuchtung (Röhre über Tür) || Automatik: Nicht Shutdown && Nacht (+10 Minuten Dämmerung)
|-
| LEDS im Schaufenster || Automatik: Nacht (+30 Minuten Dämmerung)
|-
| LED-Leiste über Chaosdorflogo, Schleuse || Automatik: Nicht Shutdown && Nacht (+90 Minuten Dämmerung)
|-
| RGB-LED-Leiste, Lounge || Manuell: [[Blinkencontrol]]
|-
| Weißer LED-Strahler, Lounge || Manuell
|-
| Grüner LED-Strahler, Lounge || Manuell
|-
| Luft-/Wasserpumpe [[Windowgarden]], Lounge || Manuell an, automatisch nach 5 Minuten aus
|-
| Kaltweiße LED-Platte, Treppe || Manuell
|-
| 4x7Segment-Anzeige, Lounge || Wahlweise Uhrzeit / Hostcount / eigener Text
|-
| [[Printer/HP2100]] || Manuell an, automatisch nach 20 Minuten aus
|-
| Blassblaue LED-Röhre, Hackcenter || Manuell
|-
| Lampe im eMac-Gehäuse, Hackcenter || Manuell
|-
| LED-Leuchten-Reihe, Hackcenter || Manuell
|-
| Blauer LED-Streifen, Hackcenter || Manuell
|-
| Warmweiße LED-Spots, Hackcenter || Manuell
|-
| Helle weiße Doppelröhre, Hackcenter || Manuell
|-
| [[Verstärker]], Serverraum || Manuell: [[Verstärkerschaltung]]
|-
| [[Ladegerät]] || Automatik: An bei Unshutdown, aus bei Shutdown
|}

Die Automatik der Außenbeleuchtung lässt sich durch Klick auf die Lampe an / aus schalten, nach maximal sechs Minuten wird die Änderung an der Lampe übernommen. Im Gegensatz zu anderen Aktionen ändert das auch nichts am Dorf-Shutdownstatus. Im Webinterface steht "A" für Automatik, "X" für keine Automatik.

Was weiterhin angezeigt wird:

* Drucker (readonly, per ping, alle 5 Minuten aktualisiert)
* WLAN-APs (readonly, per ping, alle 5 Minuten aktualisiert)
* Server (readonly, per ping, alle 5 Minuten aktualisiert)
* Türstatus (readonly, alle 5 Minuten aktualisiert)

== Shutdown-Konzept ==

Per Default (z.B. nach einem Stromausfall) befindet sich das Dorf im Shutdown. Der Shutdown / Nicht-Shutdown Status ist jederzeit in der dorfmap und an der grünen LED am [[Spendenterminal]] sichtbar.

=== Shutdown einschalten ===

* Klick auf <tt>Actions &gt; Shutdown</tt> in [http://dorfmap/ dorfmap] oder dreisekündiges Drücken des schwarzen Tasters am [[Spendenterminal]]
* Beleuchtung in der Schleuse (Logo und über der Tür) geht nach 1 bis 6 Minuten aus
* Beleuchtung im Schaufenster leuchtet weiterhin, falls Nacht ist
* Alle anderen angeschlossenen Geräte werden sofort ausgeschaltet

=== Shutdown ausschalten ===

* Klick auf <tt>Actions > Unshutdown</tt> oder irgendeine steuerbare Lampe in [http://dorfmap/ dorfmap] oder dreisekündiges Drücken des schwarzen Tasters am [[Spendenterminal]]
* Falls eine Lampe angeklickt wurde, wird diese eingeschaltet
* Ein paar andere Geräte (z.B. [[Dashboard]] und [[Ladegerät]]) werden ebenfalls automatisch eingeschaltet
* Beleuchtung in der Schleuse (Logo und über der Tür) geht nach 1 bis 6 Minuten an, falls Nacht ist; alternativ sobald die Sonne untergegangen ist