Zum Hauptinhalt springen

Gemittelte Messung

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-averagedMeasurement.py mittelt fünf Messwerte im Abstand von drei Sekunden und gibt das Ergebnis in Teilen pro Milliarde (ppb) aus.

Ändern Sie vor dem Ausführen in der import-Zeile und in der Zeile, die den Sensor erzeugt, SENSOR_O3 in SENSOR_CO, wie es der Kommentar im Beispiel sagt: „change SENSOR_O3 to match your sensor type“. SENSOR_O3 ist die Voreinstellung des Moduls für die Ozonzelle. Dieses Board trägt die Kohlenmonoxidzelle SGX-4CO, und die Voreinstellung des Moduls dafür ist SENSOR_CO. Mit der Ozon-Voreinstellung rechnet das Modul die Messwerte mit der Empfindlichkeit und dem Nullpunkt der Ozonzelle um, sodass die Mittelwerte keine CO-Konzentrationen sind.

Das Beispiel öffnet den I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie diese auf die I2C-Pins Ihres Controllers, falls sie abweichen. NUM_READINGS und SECS_BETWEEN_READINGS am Anfang legen fest, wie viele Messwerte gemittelt werden und wie lange zwischen ihnen gewartet wird.

Was es auf diesem Board braucht​

Das Beispiel erzeugt den Sensor ohne adc_addr, daher verwendet das Modul seinen Standardwert 0x49. Bei einer Adresse außerhalb von 0x30 bis 0x37 läuft das Modul nicht über die Bridge des Boards: begin() sucht den ADS1115 an dieser Adresse per I2C-Scan und schreibt dann die Konfiguration des LMP91000 an 0x48, beides auf dem Bus, den Sie übergeben. Auf diesem Board liegen diese beiden Chips am internen Bus, den die obere Stiftleiste als SDA2 und SCL2 herausführt. Die Qwiic-Connectors und SDA1/SCL1 erreichen nur die ATtiny404-Bridge, und ein I2C-Scan über Qwiic findet nur die Bridge, im Auslieferungszustand an 0x30. Das Beispiel übergibt kein config_pin, und LMPEN ist auf dem Board mit GND verbunden; siehe Hardware-Details.

Verdrahten Sie für dieses Beispiel also die obere Stiftleiste, nicht das Qwiic-Kabel: Verbinden Sie SDA Ihres Controllers mit SDA2, SCL mit SCL2, den 3,3-V-Pin mit 3V3 und GND mit GND. Das Anschlussdiagramm im Listing zeigt eine Qwiic-Leitung, aber über Qwiic antwortet nur die Bridge.

Die Adresse der Bridge, 0x30 bis 0x37, ist die, die das Beispiel CO-Konzentration auslesen übergibt.

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)

Die folgenden Zeilen stammen aus einem Lauf dieses Beispiels auf diesem Board, wobei der Controller wie oben beschrieben mit den Pins SDA2, SCL2, 3V3 und GND der Stiftleiste verbunden war.

Erwartetes Ergebnis in der Thonny-Shell:

ShellMicroPython
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!
Sensor reading: 291.79010 PPB
Sensor reading: 300.63653 PPB
Sensor reading: 294.22868 PPB

Jeder Mittelwert umfasst fünf Messwerte mit je 3 Sekunden Wartezeit danach, und die Schleife wartet anschließend weitere 2,5 Sekunden, sodass etwa alle 17,5 Sekunden eine neue Zeile erscheint: Sensor reading: , die gemittelte Konzentration in ppb mit fünf Nachkommastellen und PPB. Schlägt begin() fehl, zeigt die Shell ERROR: Can't init the sensor! Check connections!, und das Skript hält dort an.

Verwendete Funktionen​

ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Erzeugt das Sensorobjekt. Das Beispiel übergibt die Voreinstellung und den I2C-Bus und lässt adc_addr und config_pin auf ihren Standardwerten.

ReturnsDas Sensorobjekt.

Parameter

ParameterTypBeschreibung
sensor_typeSensorConfigDie Voreinstellung der Zelle. Für die SGX-4CO-Zelle dieses Boards ist die Voreinstellung des Moduls SENSOR_CO.
i2cmachine.I2CEin initialisierter I2C-Bus. Mit None öffnet das Modul I2C 0 an den Pins 22 und 21 bei einem ESP32 oder an den Pins 5 und 4 bei einem ESP8266 und löst bei jedem anderen Board Board not recognized, please pass an I2C object manually aus.
adc_addrintDie I2C-Adresse. Standard 0x49. Von 0x30 bis 0x37 spricht das Modul mit der ATtiny404-Bridge des Boards.
config_pinint oder NoneEin GPIO, den das Modul auf Low zieht, während es die Konfiguration des Frontends sendet, und sonst auf High. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. Standard None.
begin()returns bool

Startet den Sensor. Bei einer adc_addr von 0x30 bis 0x37 prüft es, ob die Bridge antwortet, sendet ihr die ADC-Verstärkung und Datenrate aus der Voreinstellung und dann die Konfiguration des Frontends, wobei ein Busfehler pro Schritt bis zu einem Timeout von 500 ms wiederholt wird. Bei jeder anderen adc_addr prüft es, ob der ADC an dieser Adresse antwortet, setzt dessen Verstärkung und Datenrate und schreibt dann die Konfiguration des Frontends.

ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.

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

Nimmt num_measurements Messwerte auf, wartet nach jedem seconds_delay Sekunden und gibt deren Mittelwert in Teilen pro Milliarde zurück. Die Funktion blockiert, bis alle Messungen abgeschlossen sind.

ReturnsgetAveragedPPM() mit denselben Argumenten, multipliziert mit 1000.

Parameter

ParameterTypBeschreibung
num_measurementsintWie viele Messwerte gemittelt werden. Standard 5.
seconds_delayintSekunden, die nach jedem Messwert gewartet wird. Standard 2.
getAveragedPPM(num_measurements=5, seconds_delay=2)returns float

Derselbe Mittelwert in ppm: Es addiert num_measurements Ergebnisse von getPPM(), wartet nach jedem seconds_delay Sekunden und teilt durch num_measurements. Das Beispiel zeigt ihn als auskommentierte Alternative.

ReturnsDie gemittelte Konzentration in ppm.

Parameter

ParameterTypBeschreibung
num_measurementsintWie viele Messwerte gemittelt werden. Standard 5.
seconds_delayintSekunden, die nach jedem Messwert gewartet wird. Standard 2.

Alles zusammensetzen​

Erzeugen Sie das Objekt mit SENSOR_CO, der Voreinstellung für die Zelle dieses Boards, rufen Sie einmal begin() auf und prüfen Sie das Ergebnis, dann rufen Sie in Ihrer Schleife getAveragedPPB() oder getAveragedPPM() auf. Jeder Aufruf dauert num_measurements mal seconds_delay Sekunden.