Beschreibung Datenformat

+++ noch in Arbeit +++

Der Feinstaubsensor liefert die gemessenen Daten im json-Format aus.

Generell werden die Daten seitens des Feinstaubsensors nicht weiter bearbeitet und wie gemessen ausgeliefert.

• PM2,5 Daten
• PM10 Daten
• Temperatur in °C
• Luftfeuchte in rel Prozent
• Luftdruck in Pascal

Hinweis zum Luftdruck:
Der Luftdruck wird als gemessener Wert ausgegeben und nicht auf Meeresniveau umgerechnet. Der ausgegebene Luftdruck weicht damit bei einer Aufstellhöhe ungleich Meeresniveau unter Umständen deutlich von den Angaben der Wetterdienste ab. Abhängig von Temperatur, Aufstellhöhe und Luftfeuchte muss ein für den Sensor individueller Korrekturfaktor berechnet werden. Diese Berechnung ist komplex, für die Firmware ist die Aufstellhöhe nicht bekannt. Daher wird keine Korrektur berechnet. Weiterführende Infos zum Thema:
https://de.wikipedia.org/wiki/Luftdruck#Variabilit.C3.A4t_und_Extremwerte

** Opensensemap und Luftdruck **
Die Daten werden in Pascal (Pa) ausgeliefert. Opensensemap kann Werte in Pascal (Pa) sowie in Hektopascal (hPa) verarbeiten. Bei der Darstellung der Daten in Opensensemap ist daher die Einstellung Pa nötig.

---

Die Daten des Feinstaubsensor können über verschiedene Wege gelesen und lokal gespeichert werden. Die Messdaten stehen als .csv-Dateien zur Verfügung. Achtung beim Import z.b. nach Excel: Da ein Punkt und kein Komma als Dezimaltrenner verwendet wird, interpretiert ein deutsches Excel Teile der Daten als Datum. Entweder stellt man nach dem Import die betroffene Spalte manuell ein oder benennt die .csv-Datei erst in eine Text-Datei .txt um und stellt die Importregeln dementsprechend ein.

Die Daten können auf einem lokalen Webserver wie einem Raspberry Pi im lokalen Netzwerk gespeichert werden. Der Menüpunkt "An eigene API senden" auf der Konfigurationsseite des Feinstaubsensors muss entsprechend aktiviert und die Zieladresse mit Server, Pfad, Port sowie optional Benutzer und Passwort eingetragen werden. Zum Speichern und späteren Auswerten der Daten steht ein einfaches PHP-Script bereit:

https://github.com/opendata-stuttgart/madavi-api/blob/master/data_simple.php

Das speichert die gelieferten Daten in einer täglichen .csv-Datei ab. Die Daten werden im .json-Format und nicht im $_post-Format geliefert! Dieses Script kann auch Grundlage zur Speicherung in einer eigenen Datenbank verwendet werden (selbst programmieren).

Die Firmware liefert ebenfalls auf Abruf die letzten gemessenen Daten im .json Format. Unter der Adresse
http://"Ip-Adresse-Sensor"/data.json

Wird eine Ausgabe in dieser Form generiert.

{"software_version": "NRZ-2017-099", "age":"97", "sensordatavalues":[{"value_type":"SDS_P1","value":"26.83"},{"value_type":"SDS_P2","value":"22.60"},{"value_type":"temperature","value":"19.00"},{"value_type":"humidity","value":"73.10"},{"value_type":"BME280_temperature","value":"21.53"},{"value_type":"BME280_humidity","value":"53.64"},{"value_type":"BME280_pressure","value":"97224.53"},{"value_type":"samples","value":"588824"},{"value_type":"min_micro","value":"243"},{"value_type":"max_micro","value":"27694"},{"value_type":"signal","value":"-50"}]}