Zum Hauptinhalt springen

Gemessener Mittelwert

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-averagedMeasurement.py mittelt mehrere Messwerte, bevor es einen ausgibt. Es nimmt NUM_READINGS (5) Messwerte auf, mit SECS_BETWEEN_READINGS (3) Sekunden Abstand dazwischen, gibt den Mittelwert in PPB aus, wartet dann 2,5 Sekunden und beginnt von vorn. Es übergibt keine Adresse, daher verwendet der Konstruktor seinen Standardwert adc_addr=0x49.

Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie diese auf die Pins, die der Qwiic-Connector Ihres Controllers oder Ihre Verdrahtung verwendet.

Sie müssen LMPEN an diesem Board nicht anschließen, was auch immer die Kommentare im Beispiel sagen: Das Board legt es selbst auf Low.

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)

🔗Das vollständige Beispiel öffnen

Examples/electrochemical-averagedMeasurement.py im Commit 623e1e6

→

Was dieses Board mit dem Beispiel in der vorliegenden Form ausgibt, wurde noch nicht gemessen. Beim Test dieses Boards über Qwiic fand ein I2C-Scan nur eine Adresse, 0x30, und begin() schlug für einen Sensor fehl, der mit 0x49 erzeugt wurde, dem Standardwert, den dieses Beispiel verwendet. Schlägt begin() fehl, gibt das Beispiel nach seiner Titelzeile ERROR: Can't init the sensor! Check connections! aus und hält dort an.

Wenn begin() erfolgreich ist, zeigt die Shell:

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

Danach erscheint einmal pro Runde von fünf Messwerten eine Zeile Sensor reading: , gefolgt von einem Wert mit fünf Nachkommastellen und PPB.

Verwendete Funktionen​

I2C(id, scl, sda)returns I2C

Erzeugt das I2C-Busobjekt aus dem Modul machine von MicroPython, das das Sensorobjekt verwendet. Das Beispiel nutzt Bus 0 mit SCL an Pin(22) und SDA an Pin(21). I2C und Pin gehören zu MicroPython und sind nicht Teil dieser Bibliothek.

ReturnsDas I2C-Busobjekt.

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

Erzeugt das Sensorobjekt. Es wird nichts an das Board gesendet, bis Sie begin() aufrufen. Das Beispiel übergibt die Sensorkonfiguration und den Bus und lässt adc_addr und config_pin auf ihren Standardwerten.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
SensorConfigsensor_typeDie Einstellungen für Frontend und Wandlung, etwa SENSOR_O3. Die Voreinstellungen sind in ElectrochemicalGasSensor.py definiert.
I2Ci2cDer zu verwendende Bus. Wird er weggelassen, wählt das Modul Pins nur auf Boards, die es erkennt (ESP32: Bus 0, SCL 22, SDA 21; ESP8266: SCL 5, SDA 4), und löst sonst eine Exception aus.
intadc_addrDie Adresse, mit der das Modul kommuniziert, standardmäßig 0x49, wie in diesem Beispiel. Bei einer Adresse von 0x30 bis 0x37 verwendet begin() die Bridge-Befehle; jede andere Adresse wird als eigene Adresse des ADS1115 aufgefasst.
intconfig_pinEin GPIO-Pin, den das Modul auf High hält und auf Low zieht, während es die LMP91000-Einstellungen schreibt. Standardmäßig None; wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet.
sensor.begin()returns bool

Konfiguriert den ADC und den LMP91000 anhand der Sensorkonfiguration. Bei einer adc_addr von 0x30 bis 0x37 prüft es, ob die Bridge des Boards antwortet, und sendet ihr die ADC-Verstärkung, die langsamste ADC-Datenrate und die LMP91000-Einstellungen, wobei jeder Befehl bis zu 500 ms lang wiederholt wird. Bei jeder anderen Adresse richtet es den ADS1115 unter dieser Adresse mit derselben Verstärkung und Datenrate ein und schreibt die LMP91000-Einstellungen direkt, wobei es config_pin auf Low zieht, sofern eines angegeben ist.

ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.

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

Gibt den Mittelwert mehrerer Messwerte in Parts per Billion zurück: das Ergebnis von getAveragedPPM() multipliziert mit 1000. Die Funktion blockiert, bis alle Messwerte aufgenommen sind.

ReturnsDie gemittelte Konzentration 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 auskommentierte Alternative im Beispiel. Nimmt num_measurements Messwerte mit getPPM() auf, wartet nach jedem seconds_delay Sekunden und gibt ihren Mittelwert zurück. Ein Messwert von getPPM() unter null zählt als 0.0.

ReturnsDie gemittelte Konzentration in PPM.

Parameter

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

Zusammenfassung​

SENSOR_O3 ist die Voreinstellung für eine Ozonzelle SGX-403-20. Für die Sauerstoffzelle SGX-4OX-ROHS dieses Boards hat das Modul noch keine Voreinstellung, daher wird der vom Beispiel ausgegebene Wert mit den Einstellungen der Ozonzelle berechnet. Die Seite benutzerdefinierte Konfiguration zeigt, wie Sie Ihre eigene schreiben.