Zum Hauptinhalt springen

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:

ShellMicroPython
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 ElectrochemicalGasSensor

Erzeugt 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

TypNameBeschreibung
SensorConfigsensor_typeDie Voreinstellung der Zelle. SENSOR_NO2 ist die Voreinstellung für die SGX-4NO2-Zelle dieses Boards.
I2Ci2cDer 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.
intadc_addrDie 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.
intconfig_pinGPIO-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 bool

Startet 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 float

Derselbe Mittelwert wie bei getAveragedPPM(), multipliziert mit 1000. Die Funktion blockiert, bis alle Messwerte aufgenommen sind.

ReturnsDie gemittelte Gaskonzentration in ppb.

Parameter

TypNameBeschreibung
intnum_measurementsWie viele Messwerte gemittelt werden. Standardmäßig 5; das Beispiel übergibt NUM_READINGS (5).
intseconds_delaySekunden, 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 float

Ruft 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

TypNameBeschreibung
intnum_measurementsWie viele Messwerte gemittelt werden. Standardmäßig 5.
intseconds_delaySekunden, 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.