Mehrere Messwerte mitteln
Was dieses Beispiel zeigt
Das Beispiel electrochemical-averagedMeasurement.py des Moduls nimmt fünf
Messwerte im Abstand von drei Sekunden auf, bildet den Mittelwert und gibt das Ergebnis in ppb
(parts per billion) aus.
Das Beispiel verwendet die Ozon-Voreinstellung SENSOR_O3, und der zugehörige Kommentar fordert Sie auf, sie an Ihren Sensor anzupassen. SENSOR_NO2 ist die Voreinstellung des Moduls für die SGX-4NO2-Zelle dieses Boards; ändern Sie sie in der import-Zeile und in der Zeile, die den Sensor erzeugt. Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA
an Pin 21; passen Sie diese an Ihren Controller an. NUM_READINGS und
SECS_BETWEEN_READINGS am Anfang legen fest, wie viele Messwerte in jeden Mittelwert eingehen
und wie lange zwischen ihnen gewartet wird.
Der Beispielcode
# 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
Erwartetes Ergebnis:
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!
Danach gibt das Beispiel eine Zeile aus, die mit Sensor reading: beginnt, gefolgt von
der gemittelten Konzentration in ppb mit fünf Nachkommastellen. Jeder Mittelwert wartet drei
Sekunden nach jedem seiner fünf Messwerte, und die Schleife wartet dann weitere 2,5
Sekunden, sodass mindestens alle 17,5 Sekunden eine neue Zeile erscheint. Schlägt begin() fehl,
gibt es ERROR: Can't init the sensor! Check connections! aus und wartet in einer
Schleife.
Verwendete Funktionen
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErzeugt das Sensorobjekt. Mit einem config_pin setzt es diesen Pin zusätzlich als Ausgang und legt ihn auf High. Über I2C wird nichts gesendet, bis Sie begin() aufrufen.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
SensorConfig | sensor_type | Die Voreinstellung der Zelle. SENSOR_NO2 ist die Voreinstellung für die SGX-4NO2-Zelle dieses Boards. |
I2C | i2c | Der I2C-Bus. Mit None wählt das Modul die Pins anhand des von MicroPython gemeldeten Ports: I2C-Bus 0 an Pin 22 (SCL) und 21 (SDA) beim ESP32-Port, scl=Pin(5), sda=Pin(4) beim ESP8266-Port. Bei einem Port, den es nicht erkennt, löst es Board not recognized, please pass an I2C object manually aus. |
int | adc_addr | Die Adresse, mit der begin() kommuniziert, standardmäßig 0x49; das Beispiel belässt den Standardwert. Von 0x30 bis 0x37 sendet das Modul seine Befehle an den ATtiny404; von 0x48 bis 0x4B spricht es den ADS1115 unter adc_addr und den LMP91000 direkt an. |
int | config_pin | GPIO-Nummer für den Enable-Pin des LMP91000 (LMPEN), nur bei 0x48 bis 0x4B verwendet. Standardmäßig None; das Beispiel übergibt keinen. |
sensor.begin()returns boolStartet den Sensor und schreibt die Voreinstellung in ihn. Bei 0x30 bis 0x37 prüft es, ob der ATtiny404 antwortet, und sendet dann Verstärkung und Datenrate des ADC sowie die Konfiguration des LMP91000, wobei jeder Schritt wiederholt wird, bis das Board antwortet oder 500 ms vergangen sind. Bei 0x48 bis 0x4B prüft es, ob der ADS1115 bei adc_addr in einem I2C-Scan erscheint, stellt dessen Verstärkung und seine langsamste Datenrate ein und schreibt die Konfiguration in den LMP91000 bei 0x48. Rufen Sie es einmal vor dem Lesen auf.
ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.
sensor.getAveragedPPB(num_measurements=5, seconds_delay=2)returns floatDerselbe Mittelwert wie bei getAveragedPPM(), multipliziert mit 1000. Die Funktion blockiert, bis alle Messwerte aufgenommen sind.
ReturnsDie gemittelte Gaskonzentration in ppb.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | num_measurements | Wie viele Messwerte gemittelt werden. Standardmäßig 5; das Beispiel übergibt NUM_READINGS (5). |
int | seconds_delay | Sekunden, die nach jedem Messwert gewartet wird. Standardmäßig 2; das Beispiel übergibt SECS_BETWEEN_READINGS (3). |
sensor.getAveragedPPM(num_measurements=5, seconds_delay=2)returns floatRuft getPPM() num_measurements-mal auf, wartet nach jedem Messwert seconds_delay Sekunden und gibt den Mittelwert zurück. Die Funktion blockiert, bis alle Messwerte aufgenommen sind. Das Beispiel nennt sie in einem Kommentar als die Zeile, die Sie verwenden, wenn ppm für Ihren Sensor besser geeignet ist.
ReturnsDie gemittelte Gaskonzentration in ppm.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | num_measurements | Wie viele Messwerte gemittelt werden. Standardmäßig 5. |
int | seconds_delay | Sekunden, die nach jedem Messwert gewartet wird. Standardmäßig 2. |
Alles zusammen
Das Beispiel erstellt zuerst den I2C-Bus und übergibt ihn an den Sensor, sodass es
nicht von den Standard-Pins des Ports abhängt. Gibt begin() False zurück, gibt es
den Fehler aus und bleibt in einer Schleife. Andernfalls ruft jeder Durchlauf der Hauptschleife
getAveragedPPB() auf, das alle fünf Messwerte aufnimmt, bevor es zurückkehrt, gibt
den Mittelwert mit fünf Nachkommastellen aus und wartet 2,5 Sekunden.