Luftdaten.info/Feinstaub: Unterschied zwischen den Versionen

LuftdatenInfo
Zweck / Funktion
	Collect data from the Lufdaten.info project
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE; Thema
Support (Forum)	Bastelecke
Modulname	59_LuftdatenInfo.pm
Ersteller	igami (Forum / Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Aktuelle Version vom 8. September 2019, 20:40 Uhr

LuftdatenInfo ist ein Modul, das Sensor-Daten des Projektes luftdaten.info in FHEM abrufbar macht. Es können lokale oder entfernte Sensoren abgefragt werden.

Sensor bauen

Der Bau eines Sensors wird auf der Projektseite beschrieben. Die Kosten belaufen sich - je nach Bezugsquelle der einzelnen Bauteile und Bauform - auf ca. 30-50 €.

Zwei kurze Videos zum Aufbau und Flashen des Sensors sind u.a. auf Youtube zu finden:

Datenschutz

In der Standard-Einstellung der Software werden die Messwerte zu der Projektseite hochgeladen und dort, nachdem man den Maintainern des Projekts eine E-Mail mit weiteren Daten hat zukommen lassen, auf einer Karte dargestellt. Dazu sind die "letzten Schritte" auf der Anleitungsseite ganz unten zu befolgen.

Sollte keine Übertragung der Daten gewünscht sein, lassen sich die Geräte auch ausschließlich lokal betreiben und nicht von Fremden auslesen. Zumindest den Betreibern der Seite ist die Verknüpfung von Gerät zu Standort bekannt, ggf. lassen sich über die ermittelten Sensordaten auch genauere Standortdaten ermitteln.

Daten nutzen

LuftdatenInfo unterstützt folgende drei Betriebsmodi:

Entfernte Abfrage

Mit defmod <name> LuftdatenInfo remote <SensorID1> [<SensorID2> ..] können - auch fremde - entfernte Geräte von luftdaten.info abgefragt werden. Angelegt werden neben den Werten für PM2.5 und PM10 auch Ortsdaten (ungefähre Latitude, ungefähre Longitude und Postleitzahl + Stadt). Weitere Sensoren eines Gerätes kann man ggf. durch Hochzählen der SensorID einbinden, z.B. liefert die SensorID 17382 Feinstaubdaten, SensorID 17383 liefert darüber hinaus auch noch Temperatur, Luftdruck und Luftfeuchte zurück. Andere Sensoren als der Feinstaubsensor werden aktuell auf luftdaten.info nicht angezeigt, müssen also erprobt werden.

Lokale Abfrage

Ein Gerät, welches Daten nicht an luftdaten.info oder eine der anderen Plattformen melden soll, kann trotzdem lokal abgefragt werden. Dazu ist mit defmod <name> LuftdatenInfo local <IP> das Gerät anzulegen. Es muss hier keine SensorID angegeben werden. Ohne weitere Einstellungen (rawReadings) liefert der Sensor hier allerdings keine Sensordaten! Diese kann man über den Slave-Modus einbinden. [Das ist nicht unbedingt richtig, siehe Diskussion]

Lokaler Slave-Modus

Im Slave-Modus können zu einem lokalen Gerät die einzelnen Sensoren als FHEM-Devices angelegt werden. Um den Slave-Modus nutzen zu können muss wie oben beschrieben ein lokales (Master-)Gerät angelegt werden. Einen Slave legt man mit define <slave-name> LuftdatenInfo slave <master-name> [name-sensor1, name-sensor2] an. Die Namen der Sensoren enthält man, indem man get <master-name> sensors ausführt. Das Ergebnis könnte eine Liste ähnlich wie diese sein:

BME680_air_quality
BME680_humidity
BME680_pressure
BME680_pressure_nn
BME680_quality_data
BME680_temperature
DHT22_humidity
DHT22_temperature
SDS011_P1
SDS011_P2
max_micro
min_micro
samples
sensor_start_date
sensor_start_time
signal

In diesem Gerät ist ein SDS011-Feinstaubsensor (vergebene Bezeichnung SDS011), ein BME680-Umweltsensor (vergebene Bezeichnung BME680) und ein DHT22-Luftfeuchte-/Temperatursensor (vergebene Bezeichnung DHT22) verbaut.

Möchte man nun die Werte des BME680 in ein Slave-Gerät umleiten, muss man dieses wie folgt definieren:

defmod <slave-bme680> LuftdatenInfo slave <master-name> BME680_air_quality BME680_humidity BME680_pressure BME680_pressure_nn BME680_quality_data BME680_temperature

Die anderen gelisteten "Sensoren" sind keine, sondern Datenpunkte:

Wert	Bedeutung
max_micro	unbekannt
min_micro	unbekannt
sensor_start_date	Datum an dem das Gerät gestartet wurde
sensor_start_time	Zeitpunkt zu dem das Gerät gestartet wurde
signal	WiFi-Leistungspegel (Signalstärke) in dBm

@@ Zeile 8: / Zeile 8: @@
 |ModOwner=igami ({{Link2FU|4106|Forum}} / [[Benutzer:no_Legend|Wiki]])
 }}
+'''LuftdatenInfo''' ist ein Modul, das Sensor-Daten des Projektes [http://luftdaten.info/ luftdaten.info] in FHEM abrufbar macht.
+Es können lokale oder entfernte Sensoren abgefragt werden.
-'''Dieser Artikel befindet sich noch im Aufbau.'''
+== Sensor bauen ==
+Der Bau eines Sensors wird auf der [http://luftdaten.info/feinstaubsensor-bauen/ Projektseite] beschrieben.
+Die Kosten belaufen sich - je nach Bezugsquelle der einzelnen Bauteile und Bauform - auf ca. 30-50 €.
+Zwei kurze Videos zum Aufbau und Flashen des Sensors sind u.a. auf Youtube zu finden:
+* [https://youtu.be/8oLCTeCfabU Luftdaten.info Feinstaubsensor selber bauen]
+* [https://youtu.be/NK3E083WayM luftdaten.info Feinstaubsensor NodeMCU flashen unter Windows]
+== Datenschutz ==
+In der Standard-Einstellung der Software werden die Messwerte zu der Projektseite hochgeladen und dort, nachdem man den Maintainern des Projekts eine E-Mail mit weiteren Daten hat zukommen lassen, auf einer [http://deutschland.maps.luftdaten.info/ Karte] dargestellt. Dazu sind die "letzten Schritte" auf der [https://luftdaten.info/feinstaubsensor-bauen/ Anleitungsseite] ganz unten zu befolgen.
+Sollte keine Übertragung der Daten gewünscht sein, lassen sich die Geräte auch ausschließlich lokal betreiben und nicht von Fremden auslesen. Zumindest den Betreibern der Seite ist die Verknüpfung von Gerät zu Standort bekannt, ggf. lassen sich über die ermittelten Sensordaten auch genauere Standortdaten ermitteln.
+== Daten nutzen ==
+'''LuftdatenInfo''' unterstützt folgende drei Betriebsmodi:
-'''FeinstaubInfo''' ist ein Modul, das die Daten des Projektes http://luftdaten.info/ in FHEM abrufbar macht.
+=== Entfernte Abfrage ===
-Es können eigene Sensoren abgefragt werden oder externe Sensoren verwendet werden.
+Mit <code>defmod <name> LuftdatenInfo remote <SensorID1> [<SensorID2> ..]</code> können - auch fremde - entfernte Geräte von luftdaten.info abgefragt werden. Angelegt werden neben den Werten für PM2.5 und PM10 auch Ortsdaten (ungefähre Latitude, ungefähre Longitude und Postleitzahl + Stadt). Weitere Sensoren eines Gerätes kann man ggf. durch Hochzählen der SensorID einbinden, z.B. liefert die SensorID 17382 Feinstaubdaten, SensorID 17383 liefert darüber hinaus auch noch Temperatur, Luftdruck und Luftfeuchte zurück. Andere Sensoren als der Feinstaubsensor werden aktuell auf luftdaten.info nicht angezeigt, müssen also erprobt werden.
-== Sensor bauen ==
+=== Lokale Abfrage ===
-http://luftdaten.info/feinstaubsensor-bauen/
+Ein Gerät, welches Daten nicht an luftdaten.info oder eine der anderen Plattformen melden soll, kann trotzdem lokal abgefragt werden. Dazu ist mit <code>defmod <name> LuftdatenInfo local <IP></code> das Gerät anzulegen. Es muss hier keine SensorID angegeben werden. Ohne weitere Einstellungen (<code>rawReadings</code>) liefert der Sensor hier allerdings keine Sensordaten! Diese kann man über den Slave-Modus einbinden. [Das ist nicht unbedingt richtig, siehe Diskussion]
-Der Bau eines Sensors wird auf der Projektseite (siehe Link oben).
-Die Kosten belaufen sich auf ca. 30-50 €, je nach Bezugsquelle der einzelnen Bauteile.
+=== Lokaler Slave-Modus ===
+Im Slave-Modus können zu einem lokalen Gerät die einzelnen Sensoren als FHEM-Devices angelegt werden. Um den Slave-Modus nutzen zu können muss wie oben beschrieben ein lokales (Master-)Gerät angelegt werden. Einen Slave legt man mit <code>define <slave-name> LuftdatenInfo slave <master-name> [name-sensor1, name-sensor2]</code> an. Die Namen der Sensoren enthält man, indem man <code>get <master-name> sensors</code> ausführt. Das Ergebnis könnte eine Liste ähnlich wie diese sein:
+ BME680_air_quality
+ BME680_humidity
+ BME680_pressure
+ BME680_pressure_nn
+ BME680_quality_data
+ BME680_temperature
+ DHT22_humidity
+ DHT22_temperature
+ SDS011_P1
+ SDS011_P2
+ max_micro
+ min_micro
+ samples
+ sensor_start_date
+ sensor_start_time
+ signal
-Zwei Kurze Videos zum Aufbau und Flashen des Sensor sind auf Youtube zu finden:
+In diesem Gerät ist ein SDS011-Feinstaubsensor (vergebene Bezeichnung ''SDS011''), ein BME680-Umweltsensor (vergebene Bezeichnung ''BME680'') und ein DHT22-Luftfeuchte-/Temperatursensor (vergebene Bezeichnung ''DHT22'') verbaut.
-https://youtu.be/8oLCTeCfabU
-https://youtu.be/NK3E083WayM
+Möchte man nun die Werte des BME680 in ein Slave-Gerät umleiten, muss man dieses wie folgt definieren:
+ defmod <slave-bme680> LuftdatenInfo slave <master-name> BME680_air_quality BME680_humidity BME680_pressure BME680_pressure_nn BME680_quality_data BME680_temperature
-== Datenschutz ==
+Die anderen gelisteten "Sensoren" sind keine, sondern Datenpunkte:
-Die Standard-Einstellung des Sensor laden die Messwerte zu der Projektseite hoch.
-Die Darstellung auf der Seite erfolgt allerdings erst, wenn man den Gründern des Projekt eine Email zugesendet hat. Wie dies funktioniert, ist der Anleitung unter "Letzte Schritte" auf der Projektseite zu entnehmen.
-Der Sensor kann auch "nur lokal" arbeiten.
+{| class="wikitable"
-Da dies ein Projekt von Usern und für User ist, sollte man von der "nur lokal" Version des Sensors Abstand nehmen.
+|-
+! Wert !! Bedeutung
+|-
+| max_micro || unbekannt
+|-
+| min_micro || unbekannt
+|-
+| sensor_start_date || Datum an dem das Gerät gestartet wurde
+|-
+| sensor_start_time || Zeitpunkt zu dem das Gerät gestartet wurde
+|-
+| signal || WiFi-Leistungspegel (Signalstärke) in dBm
+|}
 [[Kategorie:Other Components]]