Hilfe
===============

1) Einleitung

Das OK Lab Stuttgart hat ein Projekt, bei dem man Feinstaub-Sensoren selbst bauen kann und die Daten dann an die Datenbank von https://Luftdaten.Info schicken kann. Mit dieser App kannst Du Dir die Messwerte aus diesem Netzwerk anzeigen lassen. Dazu ist es nicht nötig, einen eigenen Sensor zu betreiben.

Dabei sind verschiedene Sensortypen Teil des Netzwerks. Diese App fokussiert darauf, folgende Parameter darzustellen:

- Feinstaub,
- Temperatur und Luftfeuchtigkeit.

Häufig werden von einem Sensor mehrere dieser Parameter erfasst.

2) Kurze Bedienungsanleitung

a) Feinstaubwerte in Deiner Nähe („mobil“)

Nach der Installation solltest Du die App starten. Die App wird dich möglicherweise Fragen, ob Sie auf Deinen Standort zugreifen darf. Danach wirst Du in einem grünen Feld gefragt, ob Du eine Liste bekannter Sensoren laden möchtest. Beides ist erforderlich, wenn die App die Feinstaubwerte in Deiner Nähe darstellen soll.

Stelle zunächst sicher, dass Du über eine Datenverbindung, z.B. WLAN, verfügst. Tippe dann auf den Knopf „Sensor-Standorte laden“. Während Du die Liste der Sensoren lädst, solltest Du die App nicht beenden. Sonst kann die Liste nicht erfolgreich geladen werden. Die App wird dir den Fortschritt anzeigen.

Sobald die Liste erfolgreich geladen wurde, schalte ggf. Deine Standortbestimmung ein.

Die Feinstaubwerte in Deiner Umgebung sollten Dir in Kürze angezeigt werden.

Diese Funktion kann auch mittels eines Widgets auf Deinem Homescreen dargestellt werden.

Wenn Du in der App anstelle der Feinstaubwerte die Temperatur und Luftfeuchtigkeit darstellen möchtest, gibt es hierfür oben rechts einen Schiebeschalter.

b) Einen bestimmten Sensor dauerhaft beobachten („lokal“)

Ein „Sensor“ misst häufig neben den Feinstaubwerten auch Temperatur und Luftfeuchtigkeit. Die App kann alle drei Parameter beobachten. Du kannst aber auch zwei Sensoren auswählen und jeweils nur die Feinstaubwerte oder die Temperatur- und Luftfeuchtigkeitswerte dieser Sensoren anzeigen lassen.

Um diese Sensoren auszuwählen, kannst Du in der mobilen Ansicht auf die Sensornummer tippen. Es erscheint ein detailliertes Informationsfenster. Anhand von Knöpfen kannst Du diesen Sensor als lokalen Sensor Nr. 1 oder Nr. 2 festlegen.

Alternativ hierzu kannst Du auch Sensornummern per Hand eingeben. Gehe hierzu in die Einstellungen und wähle „Lokale Sensoren einstellen“.  Nun  kannst Du die Sensornummern eingeben. Die App wird (sofern Du das in den Einstellungen nicht deaktiviert hast) versuchen, anhand des Feinstaubsensors Nr. 1 den zugehörigen Temperatur- und Luftfeuchtigkeitssensor zu finden, und falls das nicht möglich ist, den nächst gelegenen.

Dieses Fenster verfügt noch über weitere Einstellungsmöglichkeiten für die Widgets, siehe 4).

3) Anzeige der Messwerte

Diese App bietet zwei grundlegende Funktionen, um diese Werte anzuzeigen. Diese werden "mobil" und "lokal" genannt.

MOBIL: die App zeigt Dir die Werte von Sensoren in Deiner Nähe an.

LOKAL: die App zeigt Dir die Werte eines fest eingegebenen Sensors an. Hier kannst Du z.B. Deinen eigenen Sensor angeben oder einen Sensor in Deiner Nähe.

Wenn Du auf eine Sensornummer in der mobilen Anzeige bzw. auf die graphische Darstellung in der lokalen Anzeige tippst, bekommst Du detaillierte Informationen über einen Sensor.

Die App baut vor allem darauf auf, die Messwerte anhand von „Widgets“ auf dem Homescreen darzustellen. Widgets sind „Werkzeuge“, mit denen man seinen Homescreen individuell gestalten und um Funktionen erweitern kann.

Die App bietet insgesamt drei Widgets an:
- ein großes Widget, dass die Werte der Sensoren in Deiner Nähe anzeigt
- ein kleines Text-Widget, dass die Werte eines lokalen Sensors anzeigt
- ein großes Widget, das die Werte eines lokalen Sensors graphisch über 24 Stunden anzeigt

Wenn die App die Werte der lokalen Sensoren kontinuierlich ermitteln soll, muss eines der beiden letztgenannten Widgets auf dem Homescreen sein. Ansonsten wird die App keine Messwerte automatisch sammeln.

4) Detaillierte Widget-Einstellungen

Wie Du ein Widget auf dem Homescreen platzierst, hängt von Deinem installierten System ab. Typischer weise machst Du folgendes:

Gehe auf den Homescreen. Das ist der Bildschirm, der nach dem Start des Gerätes erscheint. Tippe länger auf eine freie Fläche. Es sollte dann eine Auswahl erscheinen, die „Widgets“ heißt. Diese antippen und das Widget auswählen, ggf. muss man entsprechend scrollen. Das entsprechende Widget muss man dann länger drücken und - ohne den Finger vom Bildschirm zu nehmen - auf die gewünschte Stelle des Homescreens ziehen.

Bei den beiden Widgets, die Messwerte eines „lokalen“ Sensors anzeigen, öffnet sich nun ein Fenster, in dem ggf. die Sensornummern eingegeben werden müssen. Hier kann man auch weitere Einstellungen vornehmen:

a) „verbinde die Messwerte durch Linien“

Die Messwerte können anstelle einer (wissenschaftlich korrekteren) Punktdarstellung auch durch Linien verbunden werden.

b) „benutze das dunkle Widget-Motiv“

Das Widget kann auch dunkel-auf-hell dargestellt werden. Das ist gerade dann sinnvoll, wenn der Hintergrund des Homescreens sehr hell oder farbenreich ist.

c) „zeige kompakte Werte im großen Widget“

Durch diese Einstellung wird die Schriftgröße etwas verkleinert und die Messwerte in zwei (anstelle von drei) Zeilen angezeigt.

d) „Deckkraft Widget“

Hier kann man einstellen, wie stark das Widget den Hintergrund übertönen soll. Ein Wert von 100% ist eine Darstellung ohne Transparenz.

Um das Widget zu platzieren, muss dieses Fenster mit dem Knopf „weiter“ beendet werden, der sich ganz unten befindet.

Änderungen der Einstellungen machen sich möglicherweise erst verzögert bemerkbar, wenn das Widget aktualisiert wird. Hierfür dann einmalig das Widget antippen, falls die Aktualisierung automatisch nicht gelingt.

Du kannst alle Widgets in ihrer Größe verändern.

5) Wie sammelt die App Sensor-Daten?

Die App bezieht die Daten von der Schnittstelle von https://luftdaten.info.
Falls mindestens ein Widget für die lokalen Daten auf dem Homescreen platziert ist, fragt jeder lokale Widget-Typ alle 30 Minuten aktuelle Sensor-Daten ab.

Um die aktuellen Daten zu bekommen, einfach das Widget berühren.

Für die Anzeige der mobilen Daten fragt die App Deinen Standort ab und aktualisiert ggf. die Anzeige. Wann und wie oft das geschieht, kannst Du in den Einstellungen angeben.

6) das Widget wird nicht kontinuierlich aktualisiert

Das kann mehrere Gründe haben:

- Stelle sicher, dass eine Internet-Verbindung besteht. Wenn das Gerät die Internet-Verbindung verliert, insbesondere im Ruhe-Modus, wird das Widget nicht kontinuierlich aktualisiert werden. Manchmal ist die Internet-Verbindung brüchig, insbesondere WLAN-Verbindungen. Man kann versuchen, die Option "WLAN im Ruhemodus aktiviert lassen" auf "Immer" in den WLAN-Einstellungen zu ändern.

- Eine "Sicherheits-App" könnte den Internet-Zugriff blockiert haben.

- Eine "Akku-Spar-App" könnte die Aktualisierungen verhindern.

Datenschutz
=========

Zusammengefasst: die App ermittelt den Standort, um die Sensoren in der Nähe auszumachen. Um die Messwerte dieser Sensoren zu laden, werden Sensornummern an die Schnittstelle bei https://luftdaten.info verschickt. Hierzu muss auch Deine IP-Adresse https://luftdaten.info im Rahmen der Internetverbindung übermittelt werden, da sonst keine Sensordaten an Dich verschickt werden könnten.

Falls Du Messwerte als Bilder speicherst und/oder teilst, können diese Deinen Standort kombiniert mit Datum und Uhrzeit enthalten. Andere Apps auf Deinem Gerät können auf diese Bilder zugreifen.

Im Detail:

1) Die App benötigt folgende Berechtigungen:

- INTERNET: diese Berechtigung wird benötigt, um die Messdaten von https://luftdaten.info zu laden.
- ACCESS_FINE_LOCATION: diese Berechtigung wird benötigt, um Deinen Standort und somit die nächsten Sensoren in Deiner Nähe auszumachen.
- READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE: diese Berechtigungen werden benötigt, um aktuelle Werte lokal als Bild zu speichern und dann ggf. zu teilen.

2) Welche Daten speichert die App?

Die App speichert lokal:

a) eine Liste bekannter Sensoren

Die App fordert Dich zu Anfang auf, diese Liste zu laden. Die Liste kann aus den App-Einstellungen heraus erneut geladen werden. Diese Liste wird gelöscht, wenn die App-Daten gelöscht werden und/oder die App deinstalliert wird.

b) Messwerte inklusive Informationen über die Sensoren, die sie gemessen haben

Die App speichert die Messwerte (und die dazu gehörenden Sensorinformationen) über 24 Stunden. Sobald sich ein Widget aktualisiert oder die App gestartet wird, werden alle Werte, die älter als 24 Stunden sind, gelöscht. Bitte beachte, dass ein automatisches Löschen der Messwerte nur erfolgt, wenn sich ein Widget aktualisiert und/oder die App gestartet wird. Diese Daten werden auch gelöscht, wenn die App-Daten gelöscht werden und/oder die App deinstalliert wird.

c) die manuell als Bild abgespeicherten und geteilten Daten

Die App bietet die Funktion, Messwerte als Bild zu speichern und diese Bilder zu teilen.

Wenn ein Bild mit Messwerten von Dir geteilt wird, wird dieses Bild auch immer lokal auf dem Gerät gespeichert. Diese Bilder werden nicht intern in der App abgelegt, sondern auf dem allgemein zugänglichen Speicher (auch „internal/external storage“ genannt) Deines Geräts. So kann man z.B. auch mittels der Galerie diese Bilder aufrufen. Andere Apps auf Deinem Gerät können auf diese Bilder auch zugreifen.

Bitte beachte, dass diese abgespeicherten Bilder ggf. Deinen Standort, das Datum und die Uhrzeit enthalten. Das sind möglicherweise sensible Informationen.

Diese abgespeicherten Bilder werden nicht automatisch gelöscht, auch dann nicht, wenn die App-Daten gelöscht werden und/oder die App deinstalliert wird.

Die Bilder liegen in einem Unterverzeichnis des Ordners, in dem Dein Gerät Bilder abspeichert. Dort können sie z.B. mit dem Dateimanager manuell gelöscht werden.

3) Welche Daten verschickt die App?

Die App verschickt Sensornummern an die Schnittstelle bei https://luftdaten.info, um Messwerte zu erhalten. Im Rahmen der Internetverbindung muss dazu auch Deine IP-Adresse an die Schnittstelle bei https://luftdaten.info verschickt werden.

Wenn Du die Liste bekannter Sensoren lädst, muss hierzu auch im Rahmen der Internetverbindung Deine IP-Adresse an  die Schnittstelle bei https://luftdaten.info geschickt werden.

Im Detail:

Wenn Du der App die Berechtigung erteilt hast, den Standort zu bestimmen, werden aus Deinen Standortdaten lokal auf dem Gerät die nächsten Sensoren in Deiner Nähe anhand der Liste bekannter Sensoren ermittelt.

Die App schickt die lokal ermittelten Sensornummern an die Schnittstelle bei https://luftdaten.info und kann dann so Messwerte laden.

Die App sendet auch die Sensornummern der "lokalen" Sensoren an die Schnittstelle bei https://luftdaten.info, um die Messwerte zu erhalten.

Der Datentransfer zwischen der App und der Schnittstelle von https://luftdaten.info erfolgt verschlüsselt über das HTTPS Protokoll. Bitte beachte, dass zur Abfrage der Sensordaten und zum Laden der Liste der bekannten Sensoren Deine IP-Adresse ebenfalls im Rahmen der Internetverbindung an https://luftdaten.info geschickt werden muss, damit Dir die Daten von der Schnittstelle geschickt werden können.

Es werden außer den Sensornummern, die an die Schnittstelle von https://luftdaten.info gesendet werden, keine Daten automatisch durch die App verschickt.

Es werden insbesondere keine Standortdaten und keine Messwerte automatisch weitergegeben und/oder verschickt.

Das passiert nur dann, wenn Du Bilder der Messwerte abspeicherst und/oder teilst: damit speicherst Du ggf. Deine Standortdaten (mit Datum und Uhrzeit) lokal auf Deinem Gerät als Bild und teilst Sie auf die Art und Weise, die Du selbst ausgewählt hast.

4) Sonstiges

In manchen Fällen werden mehr Sensoren abgerufen, als angezeigt werden. Dies hat den Grund, dass einige Sensoren nicht immer aktuelle Daten zur Verfügung stellen. Sofern ein Sensor aktuell keine Daten liefert, wird er in der Anzeige ignoriert.

Die App verwendet zur Standortbestimmung auch den zuletzt bekannten Standort. Sie zeigt an, von wann diese Standortbestimmung ist – gerade bei schnellem Standortwechsel kann diese Standortbestimmung älter sein und muss nicht der aktuellen Position entsprechen. Sobald sich der Standort ändert, aktualisiert sich die App bzw. das mobile Widget entsprechend. Wenn kein Standort verfügbar ist, kann es einen Moment dauern, bis das Gerät erfolgreich den Standort bestimmt hat. Ein grüner Balken weist dann darauf hin.

Wie kann ich beitragen?
=================

Teile dem Autor gefundene Fehler, Probleme und Deine Vorschläge mit. Das kannst Du entweder unter https://codeberg.org auf der Projektseite oder per Email ( pawel@kaffeemitkoffein.de ) tun.