Zum Hauptinhalt springen

Anzeige in PPB

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-singleSensor.py erstellt ein Sensorobjekt, startet es und gibt alle 2,5 Sekunden einen Messwert in PPB aus. 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 Pins auf die Pins, die der Qwiic-Connector Ihres Controllers oder Ihre Verdrahtung verwendet.

Sie müssen LMPEN bei diesem Board nicht verdrahten, was auch immer die Kommentare im Beispiel sagen: Das Board hält den Pin selbst auf Low.

Der Beispielcode​

# FILE: electrochemical-singleSensor.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Single sensor PPM reading example.
# 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

# 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)

# If using a custom ADC address or a GPIO pin for LMP91000 MENB:
# sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c, adc_addr=0x4B, config_pin=5)

# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Single Sensor 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:
reading = sensor.getPPB()

# If PPM is more relevant for your sensor, use:
# reading = sensor.getPPM()

print("Sensor reading: {:.5f} PPB".format(reading))

time.sleep_ms(2500)

🔗Vollständiges Beispiel öffnen

Examples/electrochemical-singleSensor.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 erstellt 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 - Single Sensor Example
Sensor initialized successfully!

Danach erscheint alle 2,5 Sekunden eine Zeile Sensor reading: , gefolgt von einem Wert mit fünf Nachkommastellen und PPB.

Verwendete Funktionen​

I2C(id, scl, sda)returns I2C

Erstellt das I2C-Bus-Objekt 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-Bus-Objekt.

Parameter

TypNameBeschreibung
intidDer Hardware-I2C-Bus, im Beispiel 0.
PinsclDer Taktpin, im Beispiel Pin(22).
PinsdaDer Datenpin, im Beispiel Pin(21).
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

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

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
SensorConfigsensor_typeDie Front-End- und Wandlungseinstellungen, etwa SENSOR_O3. Die Voreinstellungen sind in ElectrochemicalGasSensor.py definiert.
I2Ci2cDer zu verwendende Bus. Wird er weggelassen, wählt das Modul die Pins nur bei 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. Eine Adresse von 0x30 bis 0x37 lässt begin() die Bridge-Befehle verwenden; jede andere Adresse wird als eigene Adresse des ADS1115 verstanden.
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 dabei auf Low zieht, falls einer angegeben ist.

ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.

sensor.getPPB()returns float

Nimmt einen Messwert auf und gibt ihn in Parts per Billion zurück: der Wert von getPPM() multipliziert mit 1000.

ReturnsDie Konzentration in PPB.

sensor.getPPM()returns float

Die auskommentierte Alternative im Beispiel. Nimmt einen ADC-Messwert auf und wandelt die Spannung in eine Konzentration um: Sie zieht den internen Nullpunkt ab (ein Anteil der 2,5-V-Referenz des Boards), addiert die Nullpunktkalibrierung der Konfiguration, teilt durch die TIA-Verstärkung, um den Zellstrom zu erhalten, und teilt dann durch die Nanoampere pro PPM der Konfiguration. Ein negatives Ergebnis wird als 0.0 zurückgegeben.

ReturnsDie Konzentration in PPM.

Zusammenfassung​

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