Gemittelte Messung
Was dieses Beispiel zeigt
Das Beispiel electrochemical-averagedMeasurement.py der Bibliothek nimmt fünf Messwerte im Abstand von drei Sekunden auf und gibt deren Mittelwert in ppb (parts per billion) aus. Die Mittelung glättet das Rauschen bei einem kleinen Signal.
Das Beispiel erstellt den Sensor mit der Voreinstellung für die Ozonzelle, SENSOR_O3. SENSOR_SO2 ist die Voreinstellung der Bibliothek für die SO2-Zelle dieses Boards: Ändern Sie SENSOR_O3 in der import-Zeile und in der Zeile, die sensor erstellt, in SENSOR_SO2, um SO2-Werte zu erhalten. Das Skript erstellt den I2C-Bus auf GPIO 22 (SCL) und GPIO 21 (SDA); ändern Sie diese Nummern, wenn Ihr Board andere Pins verwendet.
Auf diesem Board sitzen der LMP91000 und der ADS1115 am boardeigenen Bus 2, und Ihr Controller erreicht sie über die Adresse des Boards am Qwiic-Bus: 0x30 im Auslieferungszustand, 0x30 bis 0x37 mit dem ADDRESS-Schalter. Das Beispiel übergibt kein adc_addr und verwendet daher den Standardwert des Moduls, 0x49, der direkt mit einem ADS1115 kommuniziert. Übergeben Sie die Adresse des Boards als adc_addr, zum Beispiel sensor = ElectrochemicalGasSensor(SENSOR_SO2, i2c, adc_addr=0x30). Wo im Anschlussdiagramm steht, dass LMPEN an GND oder an einen GPIO-Pin geführt wird, ist LMPEN auf diesem Board bereits über einen 10-kΩ-Widerstand auf GND gezogen und führt zusätzlich zum Mikrocontroller auf dem Board; bei den Adressen des Boards verwendet das Modul config_pin nicht (siehe Hardware-Details).
Die Auflistung ist die Datei der Bibliothek am fixierten Commit, abgesehen von zwei reinen Kommentarzeilen, die auf ein anderes Soldered-Produkt verweisen oder im Anschlussdiagramm ein Controller-Board benennen und weggelassen wurden.
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
electrochemical-averagedMeasurement.py am fixierten Commit
Erwartetes Ergebnis:
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!
Anschließend erscheint für jeden Satz von fünf Messwerten eine Zeile Sensor reading: mit der gemittelten Konzentration in ppb. Jeder Satz dauert 15 Sekunden, und das Skript wartet vor dem nächsten Satz weitere 2,5 Sekunden.
Verwendete Funktionen
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt das Sensorobjekt aus einer Zellen-Voreinstellung, einem I2C-Objekt, einer Adresse und einem optionalen Enable-Pin. Das Beispiel übergibt nur die Voreinstellung und das I2C-Objekt, daher gilt die Standardadresse 0x49.
ReturnsDas Sensorobjekt.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Die Zellen-Voreinstellung. SENSOR_SO2 ist die Voreinstellung für die Zelle dieses Boards. |
i2c | I2C | Ein initialisiertes machine.I2C-Objekt. |
adc_addr | int | Die Adresse, mit der das Modul kommuniziert. 0x30 bis 0x37 wählt den Bridge-Modus des Moduls, der mit dem Mikrocontroller auf dem Board kommuniziert; jeder andere Wert kommuniziert direkt mit einem ADS1115 unter dieser Adresse. Standard 0x49. |
config_pin | int | GPIO für die Enable-Leitung des LMP91000. Wird bei den Adressen 0x30 bis 0x37 nicht verwendet. Standard None. |
begin()returns boolPrüft, ob das Board antwortet, und sendet die ADC- und LMP91000-Einstellungen aus der Voreinstellung an das Board.
ReturnsTrue, wenn das Board geantwortet und alle Einstellungen übernommen hat, sonst False.
getAveragedPPB(num_measurements=5, seconds_delay=2)returns floatMittelt mehrere Messwerte und gibt das Ergebnis in parts per billion zurück. Nach jedem Messwert wartet die Funktion die angegebene Anzahl von Sekunden und blockiert, bis sie fertig ist.
ReturnsDie gemittelte Gaskonzentration in ppb.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
num_measurements | int | Wie viele Messwerte gemittelt werden. Standard 5. |
seconds_delay | int | Sekunden, die nach jedem Messwert gewartet wird. Standard 2. |
getAveragedPPM(num_measurements=5, seconds_delay=2)returns floatDerselbe Mittelwert in ppm. Das Beispiel zeigt ihn in einem Kommentar als Alternative.
ReturnsDie gemittelte Gaskonzentration in ppm.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
num_measurements | int | Wie viele Messwerte gemittelt werden. Standard 5. |
seconds_delay | int | Sekunden, die nach jedem Messwert gewartet wird. Standard 2. |
Alles zusammenfügen
Der Bereich der SO2-Zelle beträgt 0 bis 20 ppm, daher ist ppm oft die praktischere Einheit. Um ppm auszugeben, tauschen Sie die beiden reading =-Zeilen und ändern Sie PPB in der Zeile print("Sensor reading: ...") in PPM, damit die Bezeichnung zum Wert passt. Der Aufruf blockiert für NUM_READINGS x SECS_BETWEEN_READINGS Sekunden.