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):
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 I2CErstellt 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
| Typ | Name | Beschreibung |
|---|---|---|
int | id | Der Hardware-I2C-Bus, im Beispiel 0. |
Pin | scl | Der Taktpin, im Beispiel Pin(22). |
Pin | sda | Der Datenpin, im Beispiel Pin(21). |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt 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
| Typ | Name | Beschreibung |
|---|---|---|
SensorConfig | sensor_type | Das 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. |
I2C | i2c | Der I2C-Bus, an dem das Board angeschlossen ist. |
int | adc_addr | Die 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. |
int | config_pin | Ein GPIO für LMPEN (MENB des LMP91000). Im Beispiel weggelassen (None), daher schaltet das Modul keinen Pin. |
sensor.begin()returns boolBei 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 floatNimmt 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 floatDie 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.