Zum Hauptinhalt springen

Gaskonzentration auslesen

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-singleSensor.py des Moduls erstellt den Sensor, startet ihn und gibt alle 2,5 Sekunden die Gaskonzentration in ppb (parts per billion) aus.

Das Beispiel verwendet die Ozon-Voreinstellung SENSOR_O3; ein Kommentar darin fordert Sie auf, sie an Ihren Sensor anzupassen. SENSOR_NO2 ist die Voreinstellung des Moduls für die SGX-4NO2-Zelle dieses Boards; ändern Sie sie in der import-Zeile und in der Zeile, die den Sensor erstellt. Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21; passen Sie diese Pins an Ihren Controller an.

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

→

Erwartetes Ergebnis:

ShellMicroPython
Electrochemical Gas Sensor - Single Sensor Example
Sensor initialized successfully!

Anschließend gibt das Beispiel alle 2,5 Sekunden eine Zeile aus, die mit Sensor reading: beginnt, gefolgt von der Konzentration in ppb mit fünf Nachkommastellen. Schlägt begin() fehl, gibt es ERROR: Can't init the sensor! Check connections! aus und wartet in einer Schleife.

Verwendete Funktionen​

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

Erstellt das Sensorobjekt. Mit config_pin setzt es diesen Pin außerdem als Ausgang und schaltet ihn auf High. Über I2C wird nichts gesendet, bis Sie begin() aufrufen.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
SensorConfigsensor_typeDie Voreinstellung der Zelle. SENSOR_NO2 ist die Voreinstellung für die SGX-4NO2-Zelle dieses Boards.
I2Ci2cDer I2C-Bus. Mit None wählt das Modul die Pins anhand des Ports, den MicroPython meldet: I2C-Bus 0 an Pin 22 (SCL) und 21 (SDA) beim ESP32-Port, scl=Pin(5), sda=Pin(4) beim ESP8266-Port. Bei einem Port, den es nicht erkennt, löst es Board not recognized, please pass an I2C object manually aus.
intadc_addrDie Adresse, mit der begin() kommuniziert, standardmäßig 0x49. Von 0x30 bis 0x37 sendet das Modul seine Befehle an den ATtiny404; von 0x48 bis 0x4B spricht es den ADS1115 unter adc_addr und den LMP91000 direkt an. Das Beispiel belässt es beim Standardwert.
intconfig_pinGPIO-Nummer für den Enable-Pin des LMP91000 (LMPEN), nur bei 0x48 bis 0x4B verwendet. Standardmäßig None; das Beispiel übergibt keinen.
sensor.begin()returns bool

Startet den Sensor und schreibt die Voreinstellung in ihn. Bei 0x30 bis 0x37 prüft es, ob der ATtiny404 antwortet, und sendet dann die ADC-Verstärkung, die Datenrate und die LMP91000-Konfiguration; jeder Schritt wird wiederholt, bis das Board antwortet oder 500 ms vergangen sind. Bei 0x48 bis 0x4B prüft es, ob der ADS1115 in einem I2C-Scan unter adc_addr erscheint, setzt dessen Verstärkung und seine langsamste Datenrate und schreibt die Konfiguration in den LMP91000 bei 0x48. Rufen Sie es einmal vor dem Auslesen auf.

ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.

sensor.getPPB()returns float

Führt eine neue Messung durch und gibt die Gaskonzentration in parts per billion zurück: getPPM() multipliziert mit 1000.

ReturnsDie Gaskonzentration in ppb.

sensor.getPPM()returns float

Führt eine neue Messung des Gaskanals durch und wandelt sie in eine Gaskonzentration um: die Spannung minus den internen Nullpunkt, plus den Kalibrierungsoffset, geteilt durch die TIA-Verstärkung und durch die Empfindlichkeit der Zelle in der Voreinstellung. Ein negatives Ergebnis wird als 0.0 zurückgegeben. Das Beispiel nennt sie in einem Kommentar als die Zeile, die Sie verwenden, wenn ppm für Ihren Sensor besser geeignet ist.

ReturnsDie Gaskonzentration in ppm.

Zusammenspiel​

Das Beispiel erstellt zuerst den I2C-Bus und übergibt ihn an den Sensor, sodass es nicht von den Standard-Pins des Ports abhängt. Gibt begin() den Wert False zurück, gibt es den Fehler aus und bleibt in einer Schleife. Andernfalls ruft jeder Durchlauf der Hauptschleife getPPB() auf, gibt den Wert mit fünf Nachkommastellen aus und wartet 2,5 Sekunden.