Zum Hauptinhalt springen

Einen Sensor in ppb auslesen

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-singleSensor.py startet einen Sensor und gibt alle 2,5 Sekunden einen Messwert in ppb (parts per billion) aus.

Das Beispiel erstellt den Sensor nur mit dem Zellen-Preset und dem I2C-Bus, sodass das Modul seine Standardadresse 0x49 verwendet. Es öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21; ändern Sie diese Pinnummern auf die I2C-Pins Ihres Controllers, falls sie abweichen. Bei 0x49 kommuniziert das Modul direkt mit dem ADS1115 und dem LMP91000, nicht über die ATtiny404-Bridge des Boards, und die Kommentare des Beispiels verlangen, dass LMPEN mit GND oder einem GPIO verbunden ist. Wie die Adresse darüber entscheidet, steht in der Bibliotheksübersicht.

Das Beispiel übergibt SENSOR_O3, das Preset des Moduls für eine Ozonzelle. Für eine Stickstoffmonoxid-Messung verwenden Sie SENSOR_NO an beiden Stellen (in der import-Zeile und in der Zeile ElectrochemicalGasSensor(...)). SENSOR_NO ist das Preset für die SGX-4NO-250-Zelle dieses Boards: 400 nA pro ppm, eine Verstärkung von 120 kΩ und eine positive Vorspannung von 12 %.

Der Beispielcode​

Das Listing ist die Datei des Moduls beim fixierten Commit. Nur Kommentarzeilen sind weggelassen: die Kopfzeile, die die Shopseite eines anderen Produkts nennt, und die Zeile des Anschlussdiagramms, die ein altes Board nennt.

# 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 bei Commit 623e1e6

→

Erwartetes Ergebnis mit SENSOR_NO (Messwerte in sauberer Luft; Ihre werden abweichen):

ShellMicroPython
Electrochemical Gas Sensor - Single Sensor Example
Sensor initialized successfully!
Sensor reading: 5.77892 PPB
Sensor reading: 6.29446 PPB
Sensor reading: 5.67951 PPB
Sensor reading: 5.90313 PPB

Alle 2,5 Sekunden erscheint eine Zeile Sensor reading: mit der Konzentration in ppb auf fünf Dezimalstellen und PPB am Ende. Antwortet das Board nicht, gibt das Beispiel ERROR: Can't init the sensor! Check connections! aus und bleibt in einer Schleife.

Verwendete Funktionen​

I2C(0, scl=Pin(22), sda=Pin(21))returns I2C

Erstellt den Hardware-I2C-Bus 0 an den angegebenen SCL- und SDA-Pins. machine.I2C und machine.Pin gehören zu MicroPython und sind nicht Teil des Soldered-Moduls (siehe docs.micropython.org, machine.I2C und machine.Pin).

ReturnsDas I2C-Busobjekt, das Sie an den Sensor übergeben.

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. Über I2C wird nichts gesendet, bis Sie begin() aufrufen. Mit i2c=None öffnet das Modul auf den Boards, die es erkennt, selbst einen Bus: beim ESP32 I2C(0, scl=Pin(22), sda=Pin(21)), beim ESP8266 I2C(scl=Pin(5), sda=Pin(4)). Auf einem Board, das es nicht erkennt, löst es eine Ausnahme aus.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
SensorConfigsensor_typeDas Zellen-Preset, im Beispiel SENSOR_O3. SENSOR_NO ist das Preset für die Zelle dieses Boards. Das Modul hat außerdem SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_H2S, SENSOR_NH3 und SENSOR_CL2.
I2Ci2cDer I2C-Bus, an dem das Board angeschlossen ist.
intadc_addrDie I2C-Adresse. Im Beispiel weggelassen, daher gilt die Standardadresse des Moduls, 0x49; der Kommentar des Beispiels zeigt den Aufruf mit adc_addr=0x4B. Bei 0x30 bis 0x37 kommuniziert das Modul mit der ATtiny404-Bridge des Boards; bei jeder anderen Adresse kommuniziert es mit dem ADS1115 unter dieser Adresse und direkt mit dem LMP91000.
intconfig_pinEin GPIO für LMPEN (MENB des LMP91000). Im Beispiel weggelassen (None), daher schaltet das Modul keinen Pin.
sensor.begin()returns bool

Bei einer Adresse von 0x30 bis 0x37 prüft es, ob die Bridge des Boards antwortet, und sendet die ADC- und Front-End-Einstellungen darüber, wobei es pro Schritt bis zu 500 ms wartet. Bei jeder anderen Adresse prüft es in einem I2C-Scan, ob der ADS1115 unter adc_addr antwortet, setzt die ADC-Verstärkung des Presets und die langsamste Datenrate und konfiguriert dann den LMP91000 bei 0x48 (Verstärkung, Last, Referenz, interner Nullpunkt, Vorspannung und Modus). Dabei zieht es config_pin nur während dieser Konfiguration auf Low, sofern ein Pin angegeben ist.

ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.

sensor.getPPB()returns float

Nimmt mit getPPM() einen Messwert auf und multipliziert ihn mit 1000.

ReturnsDie Gaskonzentration in ppb. Ein negatives Ergebnis wird als 0.0 zurückgegeben.

sensor.getPPM()returns float

Die Alternative, die der Kommentar des Beispiels anbietet. Liest ADC-Kanal 0 (bei 0x30 bis 0x37 führt die Bridge die Wandlung aus), subtrahiert den internen Nullpunkt (2,5 V mal den internen Nullpunkt-Prozentsatz des Presets), addiert die Nullpunktkalibrierung und teilt dann durch die Verstärkung und durch die nA pro ppm des Presets.

ReturnsDie Gaskonzentration in ppm. Ein negatives Ergebnis wird als 0.0 zurückgegeben.

Zusammenspiel​

begin() läuft einmal vor der Schleife. Gibt es False zurück, gibt das Beispiel den Fehler aus und wartet endlos, sodass Sie das Problem sofort sehen. In der Schleife führt jedes getPPB() eine neue Messung durch, und das Beispiel gibt sie mit fünf Dezimalstellen aus und wartet dann 2,5 Sekunden.