Zum Hauptinhalt springen

Mehrere Messwerte mitteln

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-averagedMeasurement.py startet einen Sensor mit der Ozon-Voreinstellung und gibt den Mittelwert von fünf Messwerten in Parts per Billion (PPB) aus, die im Abstand von 3 Sekunden erfasst werden.

Verbinden Sie Ihren Controller für dieses Beispiel mit dem oberen Header und nicht mit einem Qwiic- Connector: SDA des Controllers mit SDA2, SCL mit SCL2, die 3,3-V-Versorgung mit 3V3 und Masse mit GND. Bei dieser Adresse kommuniziert die Bibliothek direkt über SDA2 und SCL2 mit dem ADS1115 und dem LMP91000; die ATtiny404-Bridge des Boards bei 0x30 wird nicht verwendet. Über Qwiic funktioniert nur das Bridge-Beispiel in der Kurzanleitung.

Der Beispielcode​

NUM_READINGS legt fest, wie viele Messwerte in jeden Mittelwert einfließen, und SECS_BETWEEN_READINGS, wie viele Sekunden die Bibliothek nach jedem Messwert wartet. Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie SENSOR_O3 auf die Voreinstellung für Ihre Zelle, wie es der Kommentar dort auflistet.

Das Anschlussdiagramm in den Kommentaren des Beispiels verbindet LMPEN mit GND oder einem GPIO. Auf diesem Board führt LMPEN zum Header und zum ATtiny404 des Boards.

# 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

→

Die Shell zeigt:

ShellMicroPython
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!

Danach folgt pro Mittelwert eine Zeile Sensor reading: mit fünf Nachkommastellen und PPB. Jeder Mittelwert umfasst fünf Messwerte mit jeweils 3 Sekunden Wartezeit, dauert also etwa 15 Sekunden, und das Skript pausiert 2,5 Sekunden vor dem nächsten. Schlägt begin() fehl, gibt das Skript ERROR: Can't init the sensor! Check connections! aus und wartet.

Verwendete Funktionen​

I2C und Pin stammen aus dem machine-Modul von MicroPython selbst und time.sleep_ms() aus dessen time-Modul. Die folgenden Funktionen gehören zur Bibliothek.

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

Erstellt das Sensorobjekt für ein Board. Die Bibliothek liest adc_addr, um zu entscheiden, wie sie mit dem Board kommuniziert: Bei einer Adresse von 0x30 bis 0x37 verwendet sie das Protokoll der ATtiny404-Bridge; bei jeder anderen Adresse kommuniziert sie selbst mit einem ADS1115 unter dieser Adresse und mit dem LMP91000 bei 0x48.

ReturnsDas Sensorobjekt.

Parameter

NameTypBeschreibung
sensor_typeSensorConfigDie Voreinstellung für Ihre Zelle: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 oder Ihre eigene SensorConfig.
i2cmachine.I2CDer I2C-Bus. Wird er weggelassen, öffnet die Bibliothek I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21 bei einem ESP32-Port bzw. I2C mit SCL an Pin 5 und SDA an Pin 4 bei einem ESP8266-Port und löst auf jedem anderen Board eine Exception aus.
adc_addrintDie Adresse, die begin() verwendet. 0x30 bis 0x37 wählt das Bridge-Protokoll; dieses Board antwortet werkseitig bei 0x30 oder unter der Adresse, die sein Schalter einstellt. Jeder andere Wert wird als ADS1115-Adresse behandelt. Standardwert ist 0x49.
config_pinintEine GPIO-Nummer für die Enable-Leitung des LMP91000. Die Bibliothek hält sie auf High und zieht sie nur dann auf Low, wenn sie selbst die Register des LMP91000 beschreibt; bei einer Adresse von 0x30 bis 0x37 wird sie nicht verwendet. Standardmäßig None.
begin()returns bool

Richtet die Verbindung für adc_addr ein und konfiguriert den LMP91000 mit der Voreinstellung. Bei 0x30 bis 0x37 prüft sie, ob die Bridge antwortet, sendet die ADC-Verstärkung und lässt die Bridge die Register des LMP91000 beschreiben, wobei jeder Schritt nach 500 ms abgebrochen wird. Bei jeder anderen Adresse prüft sie per I2C-Scan, ob ein Gerät unter adc_addr antwortet, und beschreibt dann die Register des LMP91000 bei 0x48, sobald sein Status „bereit“ anzeigt.

ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.

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

Erfasst num_measurements Messwerte mit getPPM(), wartet nach jedem seconds_delay Sekunden und gibt deren Mittelwert in Parts per Billion zurück. Die Funktion blockiert, bis sie fertig ist.

ReturnsDie gemittelte Gaskonzentration in PPB, getAveragedPPM() x 1000.

Parameter

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

Derselbe Mittelwert in Parts per Million. Das Beispiel zeigt ihn als auskommentierte Alternative.

ReturnsDie gemittelte Gaskonzentration in PPM.

Parameter

NameTypBeschreibung
num_measurementsintWie viele Messwerte gemittelt werden. Standardwert ist 5.
seconds_delayintSekunden, die nach jedem Messwert gewartet wird. Standardwert ist 2.

Alles zusammenfügen​

Erstellen Sie den Sensor mit der Voreinstellung für Ihre Zelle und rufen Sie begin() einmal auf. Rufen Sie dann getAveragedPPB() oder getAveragedPPM() mit der Anzahl der Messwerte und der Wartezeit dazwischen auf. Jeder Aufruf blockiert für etwa num_measurements x seconds_delay Sekunden, sodass Ihr Skript in der Zwischenzeit nichts anderes tut.