Mehrere Messwerte mitteln
Was dieses Beispiel zeigt
Das Beispiel electrochemical-averagedMeasurement.py startet einen Sensor mit der
Ozon-Voreinstellung und gibt den Mittelwert von fünf Messwerten in Parts per Billion (PPB) aus,
die im Abstand von 3 Sekunden erfasst werden.
Verbinden Sie Ihren Controller für dieses Beispiel mit dem oberen Header und nicht mit einem Qwiic-
Connector: SDA des Controllers mit SDA2, SCL mit SCL2, die 3,3-V-Versorgung
mit 3V3 und Masse mit GND. Bei dieser Adresse kommuniziert die Bibliothek direkt über SDA2 und SCL2 mit dem ADS1115 und dem LMP91000; die ATtiny404-Bridge des Boards bei 0x30
wird nicht verwendet. Über
Qwiic funktioniert nur das Bridge-Beispiel in der
Kurzanleitung.
Der Beispielcode
NUM_READINGS legt fest, wie viele Messwerte in jeden Mittelwert einfließen, und
SECS_BETWEEN_READINGS, wie viele Sekunden die Bibliothek nach jedem Messwert wartet.
Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie
SENSOR_O3 auf die Voreinstellung für Ihre Zelle, wie es der Kommentar dort auflistet.
Das Anschlussdiagramm in den Kommentaren des Beispiels verbindet LMPEN mit GND oder einem
GPIO. Auf diesem Board führt LMPEN zum Header und zum ATtiny404 des Boards.
# FILE: electrochemical-averagedMeasurement.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Averaged PPM reading example using the built-in averaging function.
# LAST UPDATED: 2026-05-21
# Connecting diagram:
#
# Qwiic------------------------>Qwiic
# LMPEN------------------------>GND or GPIO pin (see config_pin parameter below)
from machine import I2C, Pin
import time
from ElectrochemicalGasSensor import ElectrochemicalGasSensor, SENSOR_O3
# How many readings to average and how many seconds to wait between them
NUM_READINGS = 5
SECS_BETWEEN_READINGS = 3
# Initialize I2C
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
# Create sensor object - change SENSOR_O3 to match your sensor type
# Available types: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3,
# SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2
sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c)
# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Averaged Measurement Example")
if not sensor.begin():
print("ERROR: Can't init the sensor! Check connections!")
while True:
time.sleep_ms(100)
print("Sensor initialized successfully!")
# -------------------------------------------------------------------------
# Main loop
# -------------------------------------------------------------------------
while True:
# getAveragedPPM is a blocking call — it waits between each reading
reading = sensor.getAveragedPPB(NUM_READINGS, SECS_BETWEEN_READINGS)
# If PPM is more relevant for your sensor, use:
# reading = sensor.getAveragedPPM(NUM_READINGS, SECS_BETWEEN_READINGS)
print("Sensor reading: {:.5f} PPB".format(reading))
time.sleep_ms(2500)
🔗Vollständiges Beispiel öffnen
Examples/electrochemical-averagedMeasurement.py im Commit 623e1e6
Die Shell zeigt:
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!
Danach folgt pro Mittelwert eine Zeile Sensor reading: mit fünf Nachkommastellen und PPB.
Jeder Mittelwert umfasst fünf Messwerte mit jeweils 3 Sekunden Wartezeit, dauert also etwa 15
Sekunden, und das Skript pausiert 2,5 Sekunden vor dem nächsten. Schlägt begin()
fehl, gibt das Skript ERROR: Can't init the sensor! Check connections! aus
und wartet.
Verwendete Funktionen
I2C und Pin stammen aus dem machine-Modul von MicroPython selbst und
time.sleep_ms() aus dessen time-Modul. Die folgenden Funktionen gehören zur
Bibliothek.
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt das Sensorobjekt für ein Board. Die Bibliothek liest adc_addr, um zu entscheiden, wie sie mit dem Board kommuniziert: Bei einer Adresse von 0x30 bis 0x37 verwendet sie das Protokoll der ATtiny404-Bridge; bei jeder anderen Adresse kommuniziert sie selbst mit einem ADS1115 unter dieser Adresse und mit dem LMP91000 bei 0x48.
ReturnsDas Sensorobjekt.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Die Voreinstellung für Ihre Zelle: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 oder Ihre eigene SensorConfig. |
i2c | machine.I2C | Der I2C-Bus. Wird er weggelassen, öffnet die Bibliothek I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21 bei einem ESP32-Port bzw. I2C mit SCL an Pin 5 und SDA an Pin 4 bei einem ESP8266-Port und löst auf jedem anderen Board eine Exception aus. |
adc_addr | int | Die Adresse, die begin() verwendet. 0x30 bis 0x37 wählt das Bridge-Protokoll; dieses Board antwortet werkseitig bei 0x30 oder unter der Adresse, die sein Schalter einstellt. Jeder andere Wert wird als ADS1115-Adresse behandelt. Standardwert ist 0x49. |
config_pin | int | Eine GPIO-Nummer für die Enable-Leitung des LMP91000. Die Bibliothek hält sie auf High und zieht sie nur dann auf Low, wenn sie selbst die Register des LMP91000 beschreibt; bei einer Adresse von 0x30 bis 0x37 wird sie nicht verwendet. Standardmäßig None. |
begin()returns boolRichtet die Verbindung für adc_addr ein und konfiguriert den LMP91000 mit der Voreinstellung. Bei 0x30 bis 0x37 prüft sie, ob die Bridge antwortet, sendet die ADC-Verstärkung und lässt die Bridge die Register des LMP91000 beschreiben, wobei jeder Schritt nach 500 ms abgebrochen wird. Bei jeder anderen Adresse prüft sie per I2C-Scan, ob ein Gerät unter adc_addr antwortet, und beschreibt dann die Register des LMP91000 bei 0x48, sobald sein Status „bereit“ anzeigt.
ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.
getAveragedPPB(num_measurements=5, seconds_delay=2)returns floatErfasst num_measurements Messwerte mit getPPM(), wartet nach jedem seconds_delay Sekunden und gibt deren Mittelwert in Parts per Billion zurück. Die Funktion blockiert, bis sie fertig ist.
ReturnsDie gemittelte Gaskonzentration in PPB, getAveragedPPM() x 1000.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
num_measurements | int | Wie viele Messwerte gemittelt werden. Standardwert ist 5. |
seconds_delay | int | Sekunden, die nach jedem Messwert gewartet wird. Standardwert ist 2. |
getAveragedPPM(num_measurements=5, seconds_delay=2)returns floatDerselbe Mittelwert in Parts per Million. Das Beispiel zeigt ihn als auskommentierte Alternative.
ReturnsDie gemittelte Gaskonzentration in PPM.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
num_measurements | int | Wie viele Messwerte gemittelt werden. Standardwert ist 5. |
seconds_delay | int | Sekunden, die nach jedem Messwert gewartet wird. Standardwert ist 2. |
Alles zusammenfügen
Erstellen Sie den Sensor mit der Voreinstellung für Ihre Zelle und rufen Sie begin() einmal auf. Rufen Sie dann
getAveragedPPB() oder getAveragedPPM() mit der Anzahl der Messwerte und der Wartezeit dazwischen auf. Jeder
Aufruf blockiert für etwa num_measurements x seconds_delay Sekunden, sodass Ihr
Skript in der Zwischenzeit nichts anderes tut.