BME688 AirMeter App

Mit dieser BME688 AirMeter App für PiCockpitkönnen Sie eine BME688 oder BME680-Sensor, der über I2C mit dem Raspberry Pi verbunden ist. Wir (pi3g e.K.) bieten eine Plug & Play BME688 Breakout-Moduldie Sie direkt an den Raspberry Pi anschließen können.

Die App verfügt über drei verschiedene Ansichten, die es Ihnen ermöglichen, die Daten so zu visualisieren, wie Sie es wünschen:

Installation und Einrichtung

Vergewissern Sie sich zunächst, dass Sie bereits PiCockpit auf Ihrem Raspberry Pi installiert.

Schalten Sie Ihren Raspberry Pi aus, und schließen Sie das BME688-Modul an.

Schauen Sie in den Anweisungen Ihres Anbieters nach, wie Sie dies tun können.

Schalten Sie Ihren Raspberry Pi wieder ein.

Sie müssen außer PiCockpit keine weitere Software installieren, damit diese App funktioniert.

Öffnen Sie die BME688 AirMeter App, und klicken Sie auf die Schaltfläche Setup:

Aktivieren Sie den BME688-Sensor, indem Sie auf den Kippschalter "Sensor aktivieren" klicken.

Prüfen Sie, ob die I2C-Adresse korrekt ist. (Bei der BME688-Breakout-Platine pi3g ist dies standardmäßig 0x77 - bei anderen Anbietern kann dies variieren).

Wenn der Sensor erreicht werden kann, sollte sich die Meldung unten in "Daten empfangen: ..." mit einem Zeitstempel des zuletzt empfangenen Datenpakets.

Hinweis: Die Häufigkeit der Datenpakete hängt von den Einstellungen ab - wenn Sie die IAQ-Berechnung aktivieren, werden sie möglicherweise weniger häufig empfangen.

IAQ-Berechnung aktivieren

Bosch liefert eine Software namens BSEC 2. Wir haben sie in PiCockpit integriert, um Ihnen die Arbeit zu erleichtern. Diese Software ermöglicht es, die Rohwerte, die der Sensor misst, zu nehmen und zusätzliche Werte zu berechnen.

Eine davon ist die IAQ. (Luftqualität in Innenräumen), mit dem Sie die Qualität der Innenraumluft messen können.

Um sie zu aktivieren, klicken Sie auf die Schaltfläche "IAQ-Berechnung aktivieren", und klicken Sie auf "Ich stimme zu" in der Bosch BSEC-Lizenzvertrag Dialog.

Dadurch wird PiCockpit automatisch veranlasst, auch die IAQ zu berechnen.

Erweiterte Ansicht (alle Daten anzeigen)

Wenn Sie die erweiterte Ansicht aktivieren, werden alle Parameter angezeigt, die die BSEC2-Software berechnen kann.

Alle Einstellungen zurücksetzen

Mit dieser Schaltfläche können Sie die Einstellungen auf die Werkseinstellungen zurücksetzen.

Liniendiagramm anzeigen

Verwenden Sie die Schaltflächen "show me", um den Messwert auszuwählen, den Sie sehen möchten.

Nutzen Sie die Suche, um sich auf die Werte zu konzentrieren, an denen Sie interessiert sind:

Die Elemente am unteren Rand und rechts neben dem Diagramm ermöglichen es Ihnen, bestimmte Daten- und Wertebereiche, die Sie interessieren, aufzuschlüsseln. Sie eignen sich hervorragend zum Zoomen in ein Diagramm:

Beachten Sie, dass die historischen Datenwerte nur in Ihrem Webbrowser erhalten bleiben, solange die App geöffnet ist.

Sobald Sie die Registerkarte verlassen oder schließen, gehen die Daten verloren.

Ansicht des Messgeräts

In der Ansicht "Messgerät" erhalten Sie schöne Messgeräte zur Anzeige der aktuellen Werte. Hier können Sie die folgenden Werte überwachen:

• Luftfeuchtigkeit
• Lufttemperatur
• Luftdruck
• Gasbeständigkeit
• Innenraumluftqualität (IAQ) - falls aktiviert

Die Messgeräteansicht enthält auch eine Tabelle mit den Daten am unteren Rand.

Tabelle Ansicht

Für die Puristen unter uns, die ihre Daten gerne in tabellarischer Form darstellen, ist die Tabellenansicht genau das Richtige:

Sie können die Suchfunktion nutzen, um die Ansicht auf die Artikel einzugrenzen, die Sie interessieren:

Vollständige Liste der "Erweiterten Ansicht"

Dies sind alle Messwerte, die in der BME688 AirQuality App in PiCockpit verfügbar sind, wenn Sie die erweiterte Ansicht aktivieren:

• Luftfeuchtigkeit
• Luftfeuchtigkeit (roh)
• Luftdruck
• Luftqualität (IAQ)
• Genauigkeit der Luftqualität (IAQ)
• Lufttemperatur
• Lufttemperatur (roh)
• Atem VOC-Äquivalent
• Atem VOC-Äquivalent Genauigkeit
• CO2-Äquivalent
• Genauigkeit der CO2-Äquivalente
• Vergleichsgaswert
• Genauigkeit der Gaswerte
• Gasanteil
• prozentuale Gasgenauigkeit
• Gaswiderstand (roh)
• Probennummer
• statische IAQ (roh)
• statische IAQ-Genauigkeit
• Zeitstempel

Hinweis: Für eine genauere CO2-Messung bieten wir auch ein CO2-Sensor-App!

FAQ

Wird auch der BME680 unterstützt?

Ja, der BME680 wird ebenfalls unterstützt.

Wo kann ich einen kompatiblen Sensor kaufen?

Wir von pi3g haben entwickelt ein Plug & Play BME688-Modul für den GPIO-Anschluss des Raspberry Pi.

Andere Anbieter, z. B. Pimoroni und Adafruit, verkaufen auch BME688- und BME680-Breakout-Boards.

Unterstützt diese Anwendung auch den SPI-Betrieb?

Der BME688 und BME680 unterstützen auch den SPI-Betrieb. Diese App unterstützt jedoch nur den I2C-Betrieb.

Fehlerbehandlung

KeyError 'status'

Symptome auf dem Frontend: Im Setup wird "Waiting for data" angezeigt, aber es kommen keine Daten an.

die Untersuchung des Protokolls (mit sudo journalctl -u picockpit-client -n 250) finden Sie etwas, das dem folgenden Eintrag entspricht:

Nov 01 17:00:43 jaya picockpit-client[4591]: Traceback (most recent call last):
Nov 01 17:00:43 jaya picockpit-client[4591]: File "/usr/lib/python3.9/threading.py", line 954, in _bootstrap_inner
Nov 01 17:00:43 jaya picockpit-client[4591]: self.run()
Nov 01 17:00:43 jaya picockpit-client[4591]: File "/usr/lib/python3.9/threading.py", line 892, in run
Nov 01 17:00:43 jaya picockpit-client[4591]: self._target(*self._args, **self._kwargs)
Nov 01 17:00:43 jaya picockpit-client[4591]: File "/usr/share/picockpit-client/lib/python3.9/site-packages/com_picockpit/bme688airmeter/bme688airmeter.py", line 136, in stats_thread
Nov 01 17:00:43 jaya picockpit-client[4591]: stats=self.get_stats()
Nov 01 17:00:43 jaya picockpit-client[4591]: File "/usr/share/picockpit-client/lib/python3.9/site-packages/com_picockpit/bme688airmeter/bme688airmeter.py", line 231, in get_stats
Nov 01 17:00:43 jaya picockpit-client[4591]: stats['s'] = data['status']
Nov 01 17:00:43 jaya picockpit-client[4591]: KeyError: 'status'

Dies geschieht, weil das Frontend im falschen Zustand ist - neben der Aktivierung des Sensors sollten Sie auch die IAQ-Berechnung aktivieren:

Wie kann ich überprüfen, ob die I2C-Adresse korrekt ist?

Führen Sie i2cdetect als root aus:

 i2cdetect -y 1

Dies zeigt Ihnen den BME688 und anderes I2C-Zubehör, das mit diesem Algorithmus erkannt werden kann:

Die Standardadresse für unser eigenes BME688-Breakout-Board ist 0x77

Schlussfolgerung

Wenn Sie Fragen haben oder Probleme auftreten, zögern Sie nicht, uns zu kontaktieren, und wir werden versuchen, Ihnen zu helfen, die BME688 AirMeter App so schnell wie möglich zu installieren.