Zum Hauptinhalt springen

Mehrere Messwerte mitteln

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-averagedMeasurement.py nimmt fünf Messwerte im Abstand von drei Sekunden auf und gibt deren Mittelwert in ppb (parts per billion) aus. Ein gemittelter Wert glättet die kleinen Schwankungen zwischen einzelnen Messwerten.

Das Beispiel erstellt den Sensor nur mit dem Zellen-Preset und dem I2C-Bus, sodass das Modul seine Standardadresse 0x49 verwendet. Es öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21; ändern Sie diese Pin-Nummern auf die I2C-Pins Ihres Controllers, falls diese abweichen. Bei 0x49 spricht das Modul direkt mit dem ADS1115 und dem LMP91000, nicht über die ATtiny404-Brücke des Boards, und die Kommentare des Beispiels verlangen LMPEN mit GND oder einem GPIO verbunden. Siehe die Bibliotheksübersicht, wie die Adresse dies bestimmt.

Das Beispiel übergibt SENSOR_O3, das Preset des Moduls für eine Ozonzelle. Für eine Stickstoffmonoxid-Messung verwenden Sie SENSOR_NO an beiden Stellen (in der import-Zeile und in der Zeile ElectrochemicalGasSensor(...)). SENSOR_NO ist das Preset für die SGX-4NO-250-Zelle dieses Boards: 400 nA pro ppm, eine Verstärkung von 120 kΩ und eine positive Vorspannung von 12 %.

Der Beispielcode​

Die Auflistung ist die Datei des Moduls beim festgelegten Commit. Nur Kommentarzeilen wurden weggelassen: die Kopfzeile, die die Shop-Seite eines anderen Produkts nennt, und die Zeile des Anschlussdiagramms, die ein altes Board nennt.

# 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)

🔗Das vollständige Beispiel öffnen

Examples/electrochemical-averagedMeasurement.py beim Commit 623e1e6

→

Erwartetes Ergebnis mit SENSOR_NO (Messwerte in sauberer Luft; Ihre werden abweichen):

ShellMicroPython
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!
Sensor reading: 5.94850 PPB
Sensor reading: 5.85231 PPB
Sensor reading: 6.31483 PPB

Jede Zeile Sensor reading: ist ein Mittelwert, mit der Konzentration in ppb auf fünf Dezimalstellen und PPB am Ende. Jeder Mittelwert nimmt fünf Messwerte mit je 3 Sekunden Pause danach auf, und das Beispiel wartet anschließend weitere 2,5 Sekunden, sodass etwa alle 17,5 Sekunden eine neue Zeile erscheint. Wenn begin() fehlschlägt, gibt das Beispiel ERROR: Can't init the sensor! Check connections! aus und bleibt in einer Schleife.

Verwendete Funktionen​

I2C(0, scl=Pin(22), sda=Pin(21))returns I2C

Erstellt den Hardware-I2C-Bus 0 an den angegebenen Pins SCL und SDA. machine.I2C und machine.Pin gehören zu MicroPython und sind nicht Teil des Soldered-Moduls (siehe docs.micropython.org, machine.I2C und machine.Pin).

ReturnsDas I2C-Bus-Objekt, das Sie an den Sensor übergeben.

Parameter

TypNameBeschreibung
intidDer Hardware-I2C-Bus, im Beispiel 0.
PinsclDer Takt-Pin, im Beispiel Pin(22).
PinsdaDer Daten-Pin, im Beispiel Pin(21).
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Erstellt das Sensorobjekt. Über I2C wird nichts gesendet, bis Sie begin() aufrufen. Mit i2c=None öffnet das Modul auf den Boards, die es erkennt, selbst einen Bus, darunter ein ESP32, bei dem es I2C(0, scl=Pin(22), sda=Pin(21)) öffnet, und ein ESP8266, bei dem es I2C(scl=Pin(5), sda=Pin(4)) öffnet. Auf einem Board, das es nicht erkennt, löst es eine Ausnahme aus.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
SensorConfigsensor_typeDas Zellen-Preset, im Beispiel SENSOR_O3. SENSOR_NO ist das Preset für die Zelle dieses Boards. Das Modul hat außerdem SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_H2S, SENSOR_NH3 und SENSOR_CL2.
I2Ci2cDer I2C-Bus, an dem das Board angeschlossen ist.
intadc_addrDie I2C-Adresse. Im Beispiel weggelassen, daher gilt die Standardadresse des Moduls, 0x49. Bei 0x30 bis 0x37 spricht das Modul mit der ATtiny404-Brücke des Boards; bei jeder anderen Adresse spricht es mit dem ADS1115 an dieser Adresse und direkt mit dem LMP91000.
intconfig_pinEin GPIO für LMPEN. Im Beispiel weggelassen (None), daher schaltet das Modul keinen Pin.
sensor.begin()returns bool

Bei einer Adresse von 0x30 bis 0x37 prüft es, ob die Brücke des Boards antwortet, und sendet die ADC- und Front-End-Einstellungen darüber, wobei es bei jedem Schritt bis zu 500 ms wartet. Bei jeder anderen Adresse prüft es in einem I2C-Scan, ob der ADS1115 unter adc_addr antwortet, setzt die ADC-Verstärkung des Presets und die langsamste Datenrate und konfiguriert dann den LMP91000 bei 0x48 (Verstärkung, Last, Referenz, interner Nullpunkt, Vorspannung und Modus), wobei config_pin nur während dieser Konfiguration auf Low gezogen wird, falls einer angegeben ist.

ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.

sensor.getAveragedPPB(num_measurements=5, seconds_delay=2)returns float

Nimmt num_measurements Messwerte mit getPPM() auf, wartet nach jedem seconds_delay Sekunden und gibt deren Mittelwert mal 1000 zurück. Es blockiert, bis alle Messwerte aufgenommen sind.

ReturnsDie gemittelte Gaskonzentration in ppb.

Parameter

TypNameBeschreibung
intnum_measurementsWie viele Messwerte gemittelt werden, im Beispiel NUM_READINGS (5).
intseconds_delaySekunden, die nach jedem Messwert gewartet wird, im Beispiel SECS_BETWEEN_READINGS (3).
sensor.getAveragedPPM(num_measurements=5, seconds_delay=2)returns float

Die Alternative, die der Kommentar des Beispiels anbietet: derselbe Mittelwert in ppm. Jeder Messwert ist ein getPPM(): Es liest ADC-Kanal 0 (bei 0x30 bis 0x37 führt die Brücke die Wandlung aus), subtrahiert den internen Nullpunkt (2,5 V mal den prozentualen internen Nullpunkt des Presets), addiert die Nullpunktkalibrierung und teilt durch die Verstärkung und durch die nA pro ppm des Presets. Ein negativer Messwert zählt als 0.0.

ReturnsDie gemittelte Gaskonzentration in ppm.

Parameter

TypNameBeschreibung
intnum_measurementsWie viele Messwerte gemittelt werden.
intseconds_delaySekunden, die nach jedem Messwert gewartet wird.

Zusammenspiel​

begin() läuft einmal vor der Schleife. Gibt es False zurück, gibt das Beispiel den Fehler aus und wartet endlos, sodass Sie das Problem sofort sehen. In der Schleife blockiert getAveragedPPB(), während es fünf Messwerte sammelt, danach gibt das Beispiel den Mittelwert aus und wartet 2,5 Sekunden bis zum nächsten.