Zum Hauptinhalt springen

Zwei Sensoren an einem Bus auslesen

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-twoSensors.py liest zwei Boards an einem I2C-Bus aus und gibt beide Messwerte alle 2,5 Sekunden in ppb (parts per billion) aus. Es erstellt pro Board ein Sensorobjekt: sensor1 mit adc_addr=0x4A und config_pin=25 sowie sensor2 mit adc_addr=0x49 und config_pin=32. Bei diesen Adressen kommuniziert das Modul direkt mit dem ADS1115 und dem LMP91000 jedes Boards, nicht über die ATtiny404-Bridge, und die Kommentare des Beispiels verlangen, dass LMPEN jedes Boards mit dessen GPIO verbunden ist. Wie die Adresse dies bestimmt, steht in der Übersicht der Bibliothek.

Auf diesem Board wird die ADS1115-Adresse über die Lötjumper JP2 (0x49, im Lieferzustand geschlossen), JP3 (0x4A) und JP4 (0x4B) festgelegt. Das Board für sensor2 lässt JP2 für 0x49 geschlossen. Beim Board für sensor1 trennen Sie JP2 auf und überbrücken dann JP3 für 0x4A. Auf jedem Board darf genau einer der Jumper JP2, JP3 und JP4 geschlossen sein. Die Jumper-Tabelle und die zu vermeidenden Kombinationen finden Sie unter Hardware-Details.

Das Beispiel ö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 diese abweichen.

Das Beispiel verwendet SENSOR_O3, die Voreinstellung des Moduls für eine Ozonzelle. Für eine Stickstoffmonoxid-Messung verwenden Sie SENSOR_NO anstelle von SENSOR_O3 an allen drei Stellen (der import-Zeile und beiden ElectrochemicalGasSensor(...)-Zeilen). SENSOR_NO ist die Voreinstellung 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 festgelegten Commit. Nur Kommentarzeilen wurden weggelassen: die Kopfzeile, die auf die Shopseite eines anderen Produkts verweist, und die Zeilen des Anschlussdiagramms, die ein altes Board nennen.

# FILE: electrochemical-twoSensors.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Two O3 sensor PPB reading example using two breakouts on one I2C bus.
# LAST UPDATED: 2026-05-21

# Connecting diagram:
#
# Qwiic------------------------>Qwiic
# LMPEN------------------------>25 (GPIO pin, required for I2C configuration)
#
# Qwiic------------------------>Qwiic (same bus)
# LMPEN------------------------>32 (GPIO pin, required for I2C configuration)
#
# Set different ADC I2C addresses on each breakout using the address jumpers.
# Both LMP91000 chips share address 0x48 — the LMPEN pin selects which one
# is active during configuration, so a GPIO pin is required for each sensor.

from machine import I2C, Pin
import time
from ElectrochemicalGasSensor import ElectrochemicalGasSensor, SENSOR_O3

# Initialize shared I2C bus
i2c = I2C(0, scl=Pin(22), sda=Pin(21))

# Sensor 1: ADC address 0x4A, LMPEN on pin 25
sensor1 = ElectrochemicalGasSensor(SENSOR_O3, i2c, adc_addr=0x4A, config_pin=25)

# Sensor 2: ADC address 0x49, LMPEN on pin 32
sensor2 = ElectrochemicalGasSensor(SENSOR_O3, i2c, adc_addr=0x49, config_pin=32)

# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Two Sensors Example")

if not sensor1.begin():
print("ERROR: Can't init sensor 1! Check connections!")
while True:
time.sleep_ms(100)

print("Sensor 1 initialized successfully!")

if not sensor2.begin():
print("ERROR: Can't init sensor 2! Check connections!")
while True:
time.sleep_ms(100)

print("Sensor 2 initialized successfully!")

# -------------------------------------------------------------------------
# Main loop
# -------------------------------------------------------------------------
while True:
reading1 = sensor1.getPPB()
reading2 = sensor2.getPPB()

print("Sensor 1 reading: {:.5f} PPB".format(reading1))
print("Sensor 2 reading: {:.5f} PPB".format(reading2))

time.sleep_ms(2500)

🔗Vollständiges Beispiel öffnen

Examples/electrochemical-twoSensors.py beim Commit 623e1e6

→

Erwartetes Ergebnis mit SENSOR_NO für beide Boards (Messwerte in sauberer Luft; Ihre werden abweichen):

ShellMicroPython
Electrochemical Gas Sensor - Two Sensors Example
Sensor 1 initialized successfully!
Sensor 2 initialized successfully!
Sensor 1 reading: 5.88777 PPB
Sensor 2 reading: 6.11838 PPB
Sensor 1 reading: 6.30553 PPB
Sensor 2 reading: 6.01070 PPB
Sensor 1 reading: 5.75920 PPB
Sensor 2 reading: 5.93205 PPB

Die Messwerte kommen in Zeilenpaaren, die mit Sensor 1 reading: und Sensor 2 reading: beginnen, ein Paar alle 2,5 Sekunden, mit jeder Konzentration in ppb auf fünf Nachkommastellen und PPB am Ende. Schlägt ein begin() fehl, gibt das Beispiel ERROR: Can't init sensor 1! Check connections! (bzw. sensor 2) aus und verharrt in einer Schleife.

Verwendete Funktionen​

I2C(0, scl=Pin(22), sda=Pin(21))returns I2C

Erstellt den Hardware-I2C-Bus 0 an den angegebenen Pins SCL und SDA. 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 beide Sensoren gemeinsam nutzen.

Parameter

TypNameBeschreibung
intidDer Hardware-I2C-Bus, im Beispiel 0.
PinsclDer Taktpin, im Beispiel Pin(22).
PinsdaDer Datenpin, im Beispiel Pin(21).
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Erstellt pro Board ein Sensorobjekt. Über I2C wird nichts gesendet, bis Sie begin() aufrufen. Mit i2c=None öffnet das Modul selbst einen Bus auf den Boards, die es erkennt, darunter ein ESP32, auf dem es I2C(0, scl=Pin(22), sda=Pin(21)) öffnet, und ein ESP8266, auf dem es I2C(scl=Pin(5), sda=Pin(4)) öffnet. Auf einem nicht erkannten Board löst es eine Exception aus.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
SensorConfigsensor_typeDie Zellen-Voreinstellung, im Beispiel SENSOR_O3 für beide Boards. SENSOR_NO ist die für die Zelle dieses Boards.
I2Ci2cDer I2C-Bus, für beide Boards derselbe.
intadc_addrDie I2C-Adresse des Boards, im Beispiel 0x4A für Sensor 1 und 0x49 für Sensor 2. Bei 0x30 bis 0x37 kommuniziert das Modul mit der ATtiny404-Bridge dieses Boards; bei jeder anderen Adresse kommuniziert es mit dem ADS1115 an dieser Adresse und direkt mit dem LMP91000.
intconfig_pinEin GPIO für das LMPEN dieses Boards, im Beispiel 25 und 32. Das Modul hält ihn auf High und zieht ihn nur während der Konfiguration des LMP91000 dieses Boards auf Low. Bei den Adressen 0x30 bis 0x37 ungenutzt.
sensor1.begin()returns bool

Startet Sensor 1. Bei 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 an adc_addr antwortet, setzt die ADC-Verstärkung der Voreinstellung und die langsamste Datenrate und konfiguriert dann den LMP91000 an 0x48 (Verstärkung, Last, Referenz, interner Nullpunkt, Vorspannung und Modus), wobei config_pin nur während dieser Konfiguration auf Low gezogen wird. sensor2.begin() macht dasselbe für das zweite Board.

ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.

sensor1.getPPB()returns float

Nimmt mit getPPM() einen Messwert von diesem Board auf und multipliziert ihn mit 1000. getPPM() liest ADC-Kanal 0 (bei 0x30 bis 0x37 führt die Bridge die Wandlung aus), subtrahiert den internen Nullpunkt (2,5 V mal dem Prozentsatz des internen Nullpunkts der Voreinstellung), addiert die Nullpunktkalibrierung und teilt dann durch die Verstärkung und durch die nA pro ppm der Voreinstellung. sensor2.getPPB() liest das zweite Board aus.

ReturnsDie Gaskonzentration in ppb. Ein negatives Ergebnis wird als 0.0 zurückgegeben.

Zusammenfassung​

Jedes Board erhält ein eigenes Sensorobjekt unter einer eigenen Adresse, und beide teilen sich einen I2C-Bus. Das Beispiel startet Sensor 1, dann Sensor 2, und hält beim ersten an, der fehlschlägt. In der Schleife liest es beide Boards aus und gibt die beiden Messwerte gemeinsam aus.