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:
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 ElectrochemicalGasSensorErstellt 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
| Parameter | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Die Voreinstellung der Zelle. Für die SGX-4CO-Zelle dieses Boards ist die Voreinstellung des Moduls SENSOR_CO. |
i2c | machine.I2C | Ein 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_addr | int | Die I2C-Adresse. Standard 0x49. Von 0x30 bis 0x37 kommuniziert das Modul mit der ATtiny404-Bridge des Boards. |
config_pin | int oder None | Ein 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 boolStartet 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 floatFührt eine Messung durch und gibt sie in Parts per Billion zurück.
ReturnsgetPPM() multipliziert mit 1000.
getPPM()returns floatLiest 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.