Projekt:SpaceStatus: Unterschied zwischen den Versionen

Aus k4cg.org
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(7 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Infobox
{{Infobox
| maintainer = [[User:noqqe|noqqe]]
| maintainer = [[User:noqqe|noqqe]]
| machine = [[Host:heimat.intern.k4cg.org|heimat.intern.k4cg.org]]
| machine = [[Host:mqtt.intern.k4cg.org|mqtt.intern.k4cg.org]]
| jahr = 2016
| jahr = 2016
| url = https://github.com/k4cg/spacestatus
| url = https://github.com/k4cg/spacestatus
Zeile 15: Zeile 15:


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


= Topologie =
= Topologie =


Bild kommt noch.  
[[Datei:Spacestatus.png]]


= Sensoren =
= Sensoren =
Zeile 27: Zeile 26:
== Sensor door-status ==
== Sensor door-status ==


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


== Sensor The famous "Tennisschläger" ==
== Sensor The famous "Tennisschläger" ==


Die ehemaligen Sensoren von [https://organic-entropy.org organic-entropy.org] wurden unterhalb von [[Host:scotty.intern.k4cg.org]] angebracht und an diesen angeschlossen.
Die ehemaligen Sensoren von [https://organic-entropy.org organic-entropy.org] wurde ans Kreuz^Wdie Wand genagelt und ist mit [[Host:tennis.intern.k4cg.org]] verbunden


Die Sensoren liefern Daten über folgendes:
Die Sensoren liefern Daten über folgendes:
Zeile 41: Zeile 40:
* Accelerometer (pretty much useless, weil an die Wand gehängt)
* Accelerometer (pretty much useless, weil an die Wand gehängt)


Auch diese Sensoren werden von Heimat eingesammel
Sensordaten gelangen über brickd2mqtt proxy in MQTT siehe für mehr details [[Host:tennis.intern.k4cg.org]]
 
== Sensor Temperatur von Wajib ==
 
'''Derzeit inaktiv'''
 
Der Temperatursensor ist auch auf Scotty installiert.
Unter <code>/root/tempi</code> liegt das compilte Binary.
 
Der Source Code ist von https://www.poempelfox.de/ds1820tousb/ds1820tousb-v1.03-221211.tar.gz
 
[[User:Wajib]] hat die Hardware und Software zusammengebaut.
 
Der Daemon wird beim Starten von Scotty via <code>supervisor</code> gestartet.


<pre>
== Sensor WLAN AP ==
conifg-file "/etc/supervisor/conf.d/tempi.conf":


[program:tempi]
Dieser Sensor liefert die Daten wie viele WLAN Geräte gerade in der CG sind.  
directory=/root/tempi
command=/root/tempi/hostsoftware daemon 00000740df6e:31337:%%T
autostart=true
autorestart=true
startsecs=10
user=root
stdout_logfile=/root/tempi/logs/tempi.log
stdout_logfile_maxbytes=1MB
stdout_logfile_backups=10
stdout_capture_maxbytes=1MB
stderr_logfile=/root/tempi/logs/tempi.log
stderr_logfile_maxbytes=1MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1MB
environment = HOME="/root/", USER="root"
</pre>


Der Aufruf sieht wie folgt aus:
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.
Dieses wird dann in MQTT published.


<pre>
Auf [[Projekt:wifi2mqtt]] steht beschrieben wie genau das funktioniert.
/root/tempi/hostsoftware daemon 00000740df6e:31337:%T
</pre>


= Collector =
= Collector =


Im Moment führt die [[Host:heimat.intern.k4cg.org|heimat]] alle 5 Minuten das spacestatus.py Script auf und sammelt damit die Daten aller Sensoren ein.  
Auf [[Host:mqtt.intern.k4cg.org]] läuft ein Daemon der allen Sensor Topics in MQTT Subscribed ist uns Daten dort ausließt und dann in status.json persistiert.
Siehe Repo.
status.json wird von einem lokalen Apache ausgeliefert und unter http://k4cgrouter.duckdns.org:59468/status.json veröffentlicht.  


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.
Details siehe Repo https://github.com/k4cg/spacestatus


== JSON Document ==
== JSON Document ==
Zeile 96: Zeile 64:
<pre>
<pre>
{
{
     "date": "2018-02-20T10:50:03.736701",
     "date": "2018-03-21T10:35:49.759406",
     "hosts": [],
     "door": "closed",
    "hservierer": {
    "humidity": "31.26",
        "date_GMT": "2018-02-20T09:47:52.000000",
    "light": 0,
        "door": "closed",
     "noise": 1976,
        "humidity": "37.54",
     "online": 0.0,
        "tempDoor": "16.24"
     "sound": 1955,
    },
     "temperature": 13.37
     "light": null,
     "online": 0,
     "sound": 0.0,
     "temp": 16.75
}
}
</pre>
</pre>
== cron ==
*/5  * * * *  /usr/local/bin/python2.7 /usr/local/bin/spacestatus/spacestatus.py


= Schnittstellen =  
= Schnittstellen =  
Zeile 119: Zeile 79:
== Schnittstelle IRC ==
== Schnittstelle IRC ==


Damit die Rezeptionistin diese Informationen abholen kann, läuft auf Heimat auch ein kleiner Webserver (OpenHTTPD), der das JSON File ausliefert.
Das Plugin in Rezeptionistin verbindet sich also auf dem Webserver [[Host:mqtt.intern.k4cg.org]] das json File ab und gibt die Informationen im IRC Channel wieder.
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 ==
== Schnittstelle graphs.k4cg.org ==

Aktuelle Version vom 21. März 2018, 12:04 Uhr

Projekt:SpaceStatus
Betreuer*In noqqe
Jahr 2016
Läuft auf mqtt.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

Spacestatus.png

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 wurde ans Kreuz^Wdie Wand genagelt und ist mit Host:tennis.intern.k4cg.org verbunden

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)

Sensordaten gelangen über brickd2mqtt proxy in MQTT siehe für mehr details Host:tennis.intern.k4cg.org

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. Dieses wird dann in MQTT published.

Auf Projekt:wifi2mqtt steht beschrieben wie genau das funktioniert.

Collector

Auf Host:mqtt.intern.k4cg.org läuft ein Daemon der allen Sensor Topics in MQTT Subscribed ist uns Daten dort ausließt und dann in status.json persistiert. status.json wird von einem lokalen Apache ausgeliefert und unter http://k4cgrouter.duckdns.org:59468/status.json veröffentlicht.

Details siehe Repo https://github.com/k4cg/spacestatus

JSON Document

Zum Beispiel

{
    "date": "2018-03-21T10:35:49.759406",
    "door": "closed",
    "humidity": "31.26",
    "light": 0,
    "noise": 1976,
    "online": 0.0,
    "sound": 1955,
    "temperature": 13.37
}

Schnittstellen

Schnittstelle IRC

Das Plugin in Rezeptionistin verbindet sich also auf dem Webserver Host:mqtt.intern.k4cg.org 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