(+avrshift) |
(API) |
||
| Line 47: | Line 47: | ||
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. | 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 API, unterstützt wird sowohl ein einfaches Textformat (z.B. für Shellskripte) als auch JSON. 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>. | |||
{| class="wikitable" | |||
! Request !! Aktion !! Rückgabe | |||
|- | |||
| <tt>/get/'''id'''</tt> || Keine || Aktueller Status des Verbrauchers (1 == an, 0 == aus, -1 == unbekannt) | |||
|- | |||
| <tt>/off/'''id'''</tt> || Schaltet Verbraucher aus || Beliebig | |||
|- | |||
| <tt>/on/'''id'''</tt> || Schaltet Verbraucher an || Beliebig | |||
|- | |||
| <tt>/list/readables</tt> || Keine || Liste aller Verbraucher mit auslesbarem Status | |||
|- | |||
| <tt>/list/writables</tt> || Keine || Liste aller Verbraucher mit schreibbarem Status | |||
|- | |||
| <tt>/shutdown</tt> || Setzt Raum in Shutdownmodus (s.u.) || Beliebig | |||
|- | |||
| <tt>/toggle/'''id'''</tt> || Schaltet Verbraucher von An → Aus bzw. Aus → An | |||
|- | |||
| <tt>/unshutdown</tt> || Setzt Raum in Nicht-Shutdownmodus (s.u.) || Beliebig | |||
|- | |||
|} | |||
== Angeschlossene Geräte == | == Angeschlossene Geräte == | ||
{| | {| class="wikitable" | ||
! Gerät !! Steuerung | ! Gerät !! Steuerung | ||
|- | |- | ||
Revision as of 23:03, 10 March 2013
| Lichtsteuerung beta | |
|---|---|
| |
| blinkenlichten | |
| Beteiligt | derf |
| Quelltext | github |
Benutze Beleuchtung mit Hackspace.
Hardware
Kernstück des Ganzen ist aktuell feedback
, ein Raspberry Pi. Jeder GPIO-Pin schaltet einen Verbraucher. Schaltsignale kommen mit 3V3 (maximale Last 3mA ja Pin) aus feedback und schalten über Optokoppler + Transistor 12V (werden vom Türnetzteil abgegriffen). Die 12V gehen über diverse Kabel zu den jeweiligen Verbrauchen und schalten sie entweder direkt (bei Kleinverbrauchern in der Schleuse) oder über 230V-Relais.
avrshift
Es gibt nur eine begrenzte Zahl an GPIO-Pins, die teilweise auch für andere Dinge gebraucht werden. Da auch normale Schieberegister schon vier Inputpins brauchen, wird ein AVR mit zwei Eingabepins als Software-Schieberegister verwendet. Die Firmware und Software zum ansteuern liegen jeweils auf Github. Das Protokoll ist an I²C angelehnt und sieht folgendermaßen aus:
| CLOCK | DATA | Aktion |
|---|---|---|
| ↑ | X | Bit X von rechts (als Least Significant Bit) ins Register schieben |
| ↓ | 1 | Aktuelle Registerwerte auf Ausgänge übernehmen |
| ↓ | 0 | Keine |
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.
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. Automatisch gesteuerte Lampen sind read-only, 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 API, unterstützt wird sowohl ein einfaches Textformat (z.B. für Shellskripte) als auch JSON. Für Textformat .txt an Anfragen anhängen (oder curl -H 'Accept: text/plain' benutzen), für JSON entsprechend .json bzw. application/json.
| Request | Aktion | Rückgabe |
|---|---|---|
| /get/id | Keine | Aktueller Status des Verbrauchers (1 == an, 0 == aus, -1 == unbekannt) |
| /off/id | Schaltet Verbraucher aus | Beliebig |
| /on/id | Schaltet Verbraucher an | Beliebig |
| /list/readables | Keine | Liste aller Verbraucher mit auslesbarem Status |
| /list/writables | Keine | Liste aller Verbraucher mit schreibbarem Status |
| /shutdown | Setzt Raum in Shutdownmodus (s.u.) | Beliebig |
| /toggle/id | Schaltet Verbraucher von An → Aus bzw. Aus → An | |
| /unshutdown | Setzt Raum in Nicht-Shutdownmodus (s.u.) | Beliebig |
Angeschlossene Geräte
| Gerät | Steuerung |
|---|---|
| Außenbeleuchtung (Röhre über Tür) | Automatik: Nicht Shutdown && Nacht |
| LEDS im Schaufenster | Automatik: Nacht (+90 Minuten Dämmerung) |
| LED-Leiste über Chaosdorflogo, Schleuse | Automatik: Nicht Shutdown && Nacht (+90 Minuten Dämmerung) |
| Blassblaue LED-Röhre, Hackcenter | Manuell |
| Lampe im eMac-Gehäuse, Hackcenter | Manuell |
| LED-Leuchten-Reihe, Hackcenter | Manuell |
| Blauer LED-Streifen, Hackcenter | Manuell |
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 Shutdown in dorfmap
- 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 Unshutdown oder irgendeine steuerbare Lampe in dorfmap
- 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