Zum Hauptinhalt springen

Einen Sensor in ppb auslesen

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-singleSensor.py öffnet I2C, erstellt einen Sensor und gibt die Gaskonzentration alle 2,5 Sekunden in Parts per Billion (ppb) aus.

Bevor Sie es ausführen, ändern Sie in der import-Zeile und in der Zeile, die den Sensor erstellt, SENSOR_O3 in SENSOR_CO, wie es der Kommentar des Beispiels sagt: „change SENSOR_O3 to match your sensor type“. SENSOR_O3 ist die Voreinstellung des Moduls für die Ozonzelle. Dieses Board trägt die Kohlenmonoxidzelle SGX-4CO, und die Voreinstellung des Moduls dafür ist SENSOR_CO. Mit der Ozon-Voreinstellung rechnet das Modul den Messwert mit der Empfindlichkeit und dem Nullpunkt der Ozonzelle um, die Zahlen sind also keine CO-Konzentrationen.

Das Beispiel öffnet den I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie diese auf die I2C-Pins Ihres Controllers, falls sie abweichen.

Was es auf diesem Board braucht​

Das Beispiel erstellt den Sensor ohne adc_addr, daher verwendet das Modul seinen Standardwert 0x49. Bei einer Adresse außerhalb von 0x30 bis 0x37 läuft das Modul nicht über die Bridge des Boards: begin() sucht den ADS1115 mit einem I2C-Scan an dieser Adresse und schreibt dann die Konfiguration des LMP91000 an 0x48, beides auf dem Bus, den Sie übergeben. Auf diesem Board liegen diese beiden Chips am internen Bus, den der obere Header als SDA2 und SCL2 herausführt. Die Qwiic-Connectors und SDA1/SCL1 erreichen nur die ATtiny404-Bridge, und ein I2C-Scan über Qwiic findet nur die Bridge, im Auslieferungszustand bei 0x30. Das Beispiel übergibt kein config_pin, und LMPEN ist auf dem Board auf GND gelegt; siehe Hardware-Details.

Verdrahten Sie für dieses Beispiel also den oberen Header, nicht das Qwiic-Kabel: Verbinden Sie SDA Ihres Controllers mit SDA2, SCL mit SCL2, den 3,3-V-Pin mit 3V3 und GND mit GND. Das Verbindungsdiagramm im Listing zeigt eine Qwiic-Leitung, aber über Qwiic antwortet nur die Bridge.

Die Adresse der Bridge, 0x30 bis 0x37, ist die, die das Beispiel Die CO-Konzentration auslesen übergibt.

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)

Die folgenden Zeilen stammen aus einem Lauf dieses Beispiels auf diesem Board, wobei der Controller wie oben beschrieben an die Pins SDA2, SCL2, 3V3 und GND des Headers angeschlossen war.

Erwartetes Ergebnis in der Thonny-Shell:

ShellMicroPython
Electrochemical Gas Sensor - Single Sensor Example
Sensor initialized successfully!
Sensor reading: 324.33022 PPB
Sensor reading: 325.16876 PPB
Sensor reading: 319.71396 PPB
Sensor reading: 301.64568 PPB

Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration in ppb mit fünf Nachkommastellen und PPB. Ein Ergebnis unter null wird als 0.00000 ausgegeben. Schlägt begin() fehl, zeigt die Shell ERROR: Can't init the sensor! Check connections!, und das Skript bricht dort ab.

Verwendete Funktionen​

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

Erstellt das Sensorobjekt. Das Beispiel übergibt die Voreinstellung und den I2C-Bus und lässt adc_addr und config_pin auf ihren Standardwerten.

ReturnsDas Sensorobjekt.

Parameter

ParameterTypBeschreibung
sensor_typeSensorConfigDie Voreinstellung der Zelle. Für die SGX-4CO-Zelle dieses Boards ist die Voreinstellung des Moduls SENSOR_CO.
i2cmachine.I2CEin initialisierter I2C-Bus. Bei None öffnet das Modul I2C 0 an den Pins 22 und 21 bei einem ESP32 oder an den Pins 5 und 4 bei einem ESP8266 und löst auf jedem anderen Board Board not recognized, please pass an I2C object manually aus.
adc_addrintDie I2C-Adresse. Standard 0x49. Von 0x30 bis 0x37 kommuniziert das Modul mit der ATtiny404-Bridge des Boards.
config_pinint oder NoneEin GPIO, den das Modul auf Low zieht, während es die Konfiguration des Frontends sendet, und sonst auf High. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. Standard None.
begin()returns bool

Startet den Sensor. Bei einer adc_addr von 0x30 bis 0x37 prüft es, ob die Bridge antwortet, sendet ihr die ADC-Verstärkung und Datenrate aus der Voreinstellung und dann die Konfiguration des Frontends, wobei ein Busfehler bis zu einem Timeout von 500 ms pro Schritt wiederholt wird. Bei jeder anderen adc_addr prüft es, ob der ADC an dieser Adresse antwortet, stellt dessen Verstärkung und Datenrate ein und schreibt dann die Konfiguration des Frontends.

ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.

getPPB()returns float

Führt eine Messung durch und gibt sie in Parts per Billion zurück.

ReturnsgetPPM() multipliziert mit 1000.

getPPM()returns float

Liest den ADC, zieht den internen Nullpunkt ab und addiert die Nullpunktkalibrierung, rechnet dann den Zellstrom mit der Empfindlichkeit der Voreinstellung in ppm um. Das Beispiel zeigt es als auskommentierte Alternative.

ReturnsDie Gaskonzentration in ppm; 0.0, wenn das Ergebnis negativ wäre.

Alles zusammen​

Öffnen Sie den I2C-Bus, erstellen Sie das Objekt mit SENSOR_CO, der Voreinstellung für die Zelle dieses Boards, rufen Sie begin() einmal auf und prüfen Sie das Ergebnis, rufen Sie dann getPPB() (oder getPPM()) in Ihrer Schleife auf.