Archiv:Lichtsteuerung: Difference between revisions

From Chaosdorf Wiki
(→‎API: Aktueller Stand)
Line 48: Line 48:
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>.
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.n
<tt>/get</tt> liefert derzeit auch PNGs. Sie entsprechen den in der Übersicht verwendeten.


{| class="wikitable"
{| class="wikitable"
! Request !! Aktion !! Rückgabe
! Request
! Parameter
! Aktion
|-
|-
| <tt>/action/shutdown</tt> || Setzt Raum in Shutdownmodus (s.u.) || Beliebig
| POST <tt>/action</tt>
| '''action'''=<nowiki>on|off|toggle</nowiki>, '''device'''=''lampe''
| Schaltet ''lampe'' an / aus, gibt den neuen Status als JSON zurück
|-
|-
| <tt>/action/unshutdown</tt> || Setzt Raum in Nicht-Shutdownmodus (s.u.) || Beliebig
| POST <tt>/action</tt>
| '''action'''=shortcut, '''shortcut'''=''aktion''
| Führt ''aktion'' aus (z.B. shutdown oder amps on)
|-
|-
| <tt>/ajax/blinkencontrol?device='''device'''</tt> ||  || Liste aller Animationen und aktuelles von '''device'''
| POST <tt>/action</tt>
| '''action'''=preset, '''preset'''=''preset''
| Schaltet die Lampen wie in ''preset'' angegeben
|-
|-
| <tt>/ajax/charwrite</tt> || || Liste aller Modi
| GET <tt>/ajax/blinkencontrol</tt>
| '''device'''=''lampe''
| Gibt alle gespeicherten [[Blinkencontrol]]-Animationen (und falls bekannt die aktuell laufende) als JSON zurück
|-
|-
| <tt>/ajax/infoarea</tt> || || HTML-Text der Infoarea (Stromverbrauch etc.)
| 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]]
|-
|-
| <tt>/ajax/menu</tt> || || Liste aller Shortcuts, Presets und Layer
| GET <tt>/ajax/charwrite</tt>
|
| Gibt die möglichen Modi zurück
|-
|-
| <tt>/get/'''id'''</tt> || Keine || Aktueller Status des Verbrauchers (1 == an, 0 == aus, -1 == unbekannt)
| POST <tt>/ajax/charwrite</tt>
| '''device'''=''anzeige'', '''text'''=''modus''<nowiki>|</nowiki>''text''
| Setzt modus oder freitext für ''anzeige''
|-
|-
| <tt>/off/'''id'''</tt> || Schaltet Verbraucher aus || Beliebig
| GET <tt>/ajax/menu</tt>
|
| Gibt die vorhandenen Shortcuts und Presets (siehe <tt>/action</tt>) zurück
|-
|-
| <tt>/on/'''id'''</tt> || Schaltet Verbraucher an || Beliebig
| GET <tt>/get/''device''</tt>
|
| Gibt den aktuellen Status von ''device'' zurück
|-
|-
| <tt>/list/all</tt> ||   || Liste aller Verbraucher mit Name, Typ, Status, Lesbar, Schreibbar
| GET <tt>/list/all</tt>
|
| Gibt alle Geräte mit Koordinaten, Status, Beschreibung etc. zurück
|-
|-
| <tt>/list/readables</tt> ||  || Liste aller Verbraucher mit auslesbarem Status
| GET <tt>/space_api</tt>
|-
|
| <tt>/list/writables</tt> ||  || Liste aller Verbraucher mit schreibbarem Status
| Hackerspacestatus für die [http://spaceapi.net/ spaceAPI]
|-
| <tt>/space_api</tt> ||  || Hackerspacestatus für die [http://spaceapi.net/ spaceAPI]
|-
| <tt>/toggle/'''id'''</tt> || Schaltet Verbraucher von An → Aus bzw. Aus → An || Beliebig
|-
|-
|}
|}

Revision as of 08:54, 31 August 2014

Lichtsteuerung stable
Dorfmap.png
Verbraucher per Webinterface steuern
Beteiligt derf, marudor
Quelltext github

Lampen, Blinkenlights und weitere Geräte, fernsteuerbar per Automatik, Website und Android-App.

Web

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

Hardware

Generischer SI2C Slave
Außenbeleuchtung

Kernstück des Ganzen sind SI2C-Instanzen an feedback und 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

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 berechnet. Per 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 Grundriss des Clubraums. Aus einer 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 .txt an Anfragen anhängen (oder curl -H 'Accept: text/plain' benutzen), für JSON entsprechend .json bzw. application/json.

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

Request Parameter Aktion
POST /action action=on|off|toggle, device=lampe Schaltet lampe an / aus, gibt den neuen Status als JSON zurück
POST /action action=shortcut, shortcut=aktion Führt aktion aus (z.B. shutdown oder amps on)
POST /action action=preset, preset=preset Schaltet die Lampen wie in preset angegeben
GET /ajax/blinkencontrol device=lampe Gibt alle gespeicherten Blinkencontrol-Animationen (und falls bekannt die aktuell laufende) als JSON zurück
POST /ajax/blinkencontrol device=lampe, raw_string=animation Setzt animation auf lampe. Format ist delay1,red1,green1,blue1 delay2,red2,green2,blue2 [...], siehe Blinkencontrol
GET /ajax/charwrite Gibt die möglichen Modi zurück
POST /ajax/charwrite device=anzeige, text=modus|text Setzt modus oder freitext für anzeige
GET /ajax/menu Gibt die vorhandenen Shortcuts und Presets (siehe /action) zurück
GET /get/device Gibt den aktuellen Status von device zurück
GET /list/all Gibt alle Geräte mit Koordinaten, Status, Beschreibung etc. zurück
GET /space_api Hackerspacestatus für die spaceAPI

Angeschlossene Geräte

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

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.

Shutdown einschalten

  • Klick auf Actions > Shutdown in dorfmap oder dreisekündiges Drücken des schwarzen Tasters am Spendenterminal (bis die grüne LED ausgeht)
  • Beleuchtung im Hackcenter geht sofort aus
  • 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

Shutdown ausschalten

  • Klick auf Actions > Unshutdown oder irgendeine steuerbare Lampe in dorfmap oder dreisekündiges Drücken des schwarzen Tasters am Spendenterminal (bis die grüne LED angeht)
  • Falls eine Lampe angeklickt wurde, wird diese 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
Retrieved from "https://wiki.chaosdorf.de/index.php?title=Archiv:Lichtsteuerung&oldid=11655"