Zum Hauptinhalt springen

Einen Sensor in PPB auslesen

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-singleSensor.py startet einen Sensor mit dem Ozon-Preset und gibt die Gaskonzentration alle 2,5 Sekunden in Parts per Billion (PPB) aus.

Verbinden Sie Ihren Controller für dieses Beispiel mit dem oberen Header, nicht mit einem Qwiic-Connector: SDA des Controllers mit SDA2, SCL mit SCL2, die 3,3-V-Versorgung mit 3V3 und Masse mit GND. Bei dieser Adresse kommuniziert die Bibliothek direkt über SDA2 und SCL2 mit dem ADS1115 und dem LMP91000; die ATtiny404-Bridge des Boards bei 0x30 wird nicht verwendet. Über Qwiic funktioniert nur das Bridge-Beispiel in der Schnellstartanleitung.

Der Beispielcode​

Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie SENSOR_O3 auf das Preset für Ihre Zelle, wie es der Kommentar dazu auflistet.

Im Verbindungsdiagramm in den Kommentaren des Beispiels wird LMPEN mit GND oder einem GPIO verbunden. Bei diesem Board führt LMPEN zum Header und zum ATtiny404 des Boards.

# 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

→

Die Shell zeigt:

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

Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration mit fünf Nachkommastellen und PPB. Schlägt begin() fehl, gibt das Skript ERROR: Can't init the sensor! Check connections! aus und wartet.

Verwendete Funktionen​

I2C und Pin stammen aus dem eigenen Modul machine von MicroPython und time.sleep_ms() aus dessen Modul time. Die folgenden Funktionen gehören zur Bibliothek.

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

Erstellt das Sensorobjekt für ein Board. Die Bibliothek liest adc_addr, um zu entscheiden, wie sie mit dem Sensor kommuniziert: Bei einer Adresse von 0x30 bis 0x37 verwendet sie das Protokoll der ATtiny404-Bridge; bei jeder anderen Adresse kommuniziert sie selbst mit einem ADS1115 an dieser Adresse und mit dem LMP91000 bei 0x48.

ReturnsDas Sensorobjekt.

Parameter

NameTypeDescription
sensor_typeSensorConfigDas Preset für Ihre Zelle: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 oder Ihre eigene SensorConfig.
i2cmachine.I2CDer I2C-Bus. Wird er weggelassen, öffnet die Bibliothek bei einem ESP32-Port I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21, bei einem ESP8266-Port I2C mit SCL an Pin 5 und SDA an Pin 4 und löst bei jedem anderen Board eine Ausnahme aus.
adc_addrintDie Adresse, die begin() verwendet. 0x30 bis 0x37 wählt das Bridge-Protokoll; dieses Board antwortet werkseitig bei 0x30 oder bei der Adresse, die sein Schalter einstellt. Jeder andere Wert wird als ADS1115-Adresse behandelt. Der Standardwert ist 0x49.
config_pinintEine GPIO-Nummer für die Enable-Leitung des LMP91000. Die Bibliothek hält sie auf High und zieht sie nur dann auf Low, solange sie selbst die Register des LMP91000 beschreibt; bei einer Adresse von 0x30 bis 0x37 wird sie nicht verwendet. Standardmäßig None.
begin()returns bool

Richtet die Verbindung für adc_addr ein und konfiguriert den LMP91000 mit dem Preset. Bei 0x30 bis 0x37 prüft sie, ob die Bridge antwortet, sendet die ADC-Verstärkung und lässt die Bridge die Register des LMP91000 beschreiben, wobei jeder Schritt nach 500 ms aufgegeben wird. Bei jeder anderen Adresse prüft sie mit einem I2C-Scan, ob ein Gerät an adc_addr antwortet, und beschreibt dann die Register des LMP91000 bei 0x48, sobald dessen Status bereit anzeigt.

ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.

getPPB()returns float

Nimmt eine Messung von Kanal 0 des ADS1115 auf (bei 0x30 bis 0x37 über die Bridge) und rechnet sie mit dem Preset in eine Konzentration um: Sie entfernt den internen Nullpunkt-Offset, addiert die Nullpunktkalibrierung, teilt durch die Verstärkung des Verstärkers und durch die Empfindlichkeit der Zelle in nA pro PPM und multipliziert mit 1000. Ein negatives Ergebnis wird als 0 zurückgegeben.

ReturnsDie Gaskonzentration in PPB, getPPM() x 1000.

getPPM()returns float

Dieselbe Messung in Parts per Million. Das Beispiel zeigt sie als auskommentierte Alternative.

ReturnsDie Gaskonzentration in PPM.

Alles zusammen​

Erstellen Sie den Sensor mit dem Preset für Ihre Zelle und dem I2C-Bus, rufen Sie begin() einmal auf und brechen Sie ab, wenn es False zurückgibt. Rufen Sie dann für jede Messung getPPB() oder getPPM() auf.