Projekt:SpaceStatus

Projekt:SpaceStatus
Betreuer*In	noqqe
Jahr	2016
Läuft auf	heimat.intern.k4cg.org
URL	https://github.com/k4cg/spacestatus

Was tut diese Dokumentation

Dieses Projekt beschreibt die Situation der Daten die wir in der K4CG sammeln.

• Wir erheben Daten mittels Sensoren
• Wir sammeln die erhobenen Daten mittels Collector
• Wir werten Daten aus mittels der Schnittstellen

Alle Stichwörter sind unten genau erklärt um neue Sensoren und Schnittstellen für Mitglieder zu ermöglichen und zu vereinfachen.

Topologie

Sensoren

Eine Liste aller Sensoren die wir in der CG haben und betreiben.

Sensor door-status

Im Projekt door-status wurde ein Sensor am Türschloss angebracht der es uns erlaubt abzufragen, ob gerade abgesperrt oder offen ist. Details bitte hieraus entnehmen.

Sensor The famous "Tennisschläger"

Die ehemaligen Sensoren von organic-entropy.org wurden unterhalb von Host:scotty.intern.k4cg.org angebracht und an diesen angeschlossen.

Die Sensoren liefern Daten über folgendes:

• Temperatur (schon wieder...)
• Licht Intensität (i.e. Helligkeit)
• Geräusch Pegel (KEIN Aufnahmegerät)
• Accelerometer (pretty much useless, weil an die Wand gehängt)

Auch diese Sensoren werden von Heimat eingesammel

Sensor WLAN AP

Dieser Sensor liefert die Daten wie viele WLAN Geräte gerade in der CG sind.

Momentan wird das Admin Webinterface via Python requests.POST eingeloggt und aus der status.cgi das JSON Dokument abgeholt und daraus das online-count Feld ausgelesen.

TODO: Dieser Sensor muss mittels Script/Telegraf in MQTT geschrieben werden.

Collector

Im Moment führt die heimat alle 5 Minuten das spacestatus.py Script auf und sammelt damit die Daten aller Sensoren ein. Siehe Repo.

Alle gesammelten Informationen landen in einem Python Dictionary. Die in ein File als JSON persistiert werden und mittels des httpd Webservers zur Verfügung gestellt werden.

JSON Document

Zum Beispiel

{
    "date": "2018-02-20T10:50:03.736701",
    "hosts": [],
    "hservierer": {
        "date_GMT": "2018-02-20T09:47:52.000000",
        "door": "closed",
        "humidity": "37.54",
        "tempDoor": "16.24"
    },
    "light": null,
    "online": 0,
    "sound": 0.0,
    "temp": 16.75
}

cron

*/5  * * * *  /usr/local/bin/python2.7 /usr/local/bin/spacestatus/spacestatus.py

Schnittstellen

Schnittstelle IRC

Damit die Rezeptionistin diese Informationen abholen kann, läuft auf Heimat auch ein kleiner Webserver (OpenHTTPD), der das JSON File ausliefert. Gesichert ist der Zugriff mit IP Limitierung und htaccess.

Das Plugin in Rezeptionistin verbindet sich also auf dem Webserver der Heimat, holt das json File ab und gibt die Informationen im IRC Channel wieder.

Schnittstelle graphs.k4cg.org

Damit wir auch ein bisschen Zucker auf die Augen bekommen wird das oben genannte JSON File auch von https://github.com/k4cg/sensor-fetcher/ genutzt um die Daten in eine schönen Grafana Graphen zu laden.

Siehe auch Projekt:graphs.k4cg.org

Schnittstelle Wiki

Das Wiki holt sich den door-status (linker roter/grüner Kasten) ebenfalls aus diesem JSON File ab und stellt dann dem Besucher der Webseite dar ob die CG im Moment offen oder geschlossen ist.

Misc

ICH WILL LIVEDATEN

Ich auch. In der Realtiät stellt sich aber heraus das das instabile Internet und die nicht statische v4 IP, die unfähigkeit von Libraries von mediawiki, BRICKD und die Unfähigkeit von Hardware Herstellern wie Philips Hue es nicht auf die Reihe bekommen eine IPv6 Anbindung sicherzustellen.

All diese Probleme haben seit Mitte 2016 immer wieder für Frust und Ausfälle gesorgt, wesegen wir jetzt ein einheitliches Format des Datenaustauschs mithilfe des HTTP+JSON auf der Heimat geschaffen haben.

All das führt natürlich dazu das die Daten nichtmehr komplett Live sind sondern mit 5 Minuten delay in Projekt:graphs.k4cg.org und im IRC auftauchen