Zum Hauptinhalt springen

Gaskonzentration auslesen

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-bridgeBoard.py startet das Board mit seiner Standardadresse 0x30, richtet das analoge Frontend für eine Gaszelle ein und gibt die Gaskonzentration alle 2,5 Sekunden in Parts per Million (PPM) aus.

Hinter der Adresse 0x30 steckt der ATtiny404 des Boards. Er konfiguriert den LMP91000 und liest den ADS1115 über den boardeigenen internen Bus aus, sodass Ihr Skript immer nur mit einem einzigen I2C-Gerät kommuniziert.

Der Beispielcode​

Das Beispiel verwendet die Ozon-Voreinstellung SENSOR_O3 und öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Passen Sie die Pins an Ihren Controller an und ersetzen Sie bei Bedarf die Voreinstellung durch import and pass the preset for your cell: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_NO, SENSOR_H2S, SENSOR_NH3 oder SENSOR_CL2. Die Kommentare des Beispiels nennen die Adresseinstellung „Jumper auf der Rückseite des Boards“; bei diesem Board ist es der ADDRESS-Schalter auf der Oberseite. Wenn Sie eine andere Adresse einstellen, ändern Sie adc_addr entsprechend. Die Kommentare besagen außerdem, LMPEN liege auf GND; bei diesem Board führt es zum Header und zum ATtiny404, und die Bibliothek steuert es nicht an. Der Kommentar mit den „legacy boards with 0x49/0x4A/0x4B“ meint Boards, die unter diesen Adressen gelesen werden und bei denen die Bibliothek direkt mit einem ADS1115 statt mit der Bridge kommuniziert. Dieses Board antwortet unter 0x30 bis 0x37.

# FILE: electrochemical-bridgeBoard.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Single sensor PPM reading example for the ATtiny404 bridge board revision,
# which allows daisy-chaining multiple boards on one I2C bus.
# LAST UPDATED: 2026-07-23

# Connecting diagram:
#
# Qwiic------------------------>Qwiic
#
# Note: on this board revision, LMPEN is hardwired to GND, so there's no
# config_pin to set - it's ignored whenever adc_addr falls in the bridge
# range (0x30-0x37). Set the desired address using the jumpers on the back
# of the board before powering it on.

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

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

# (address = 0x30 + jumper offset, giving a range of 0x30-0x37).
# Any additional boards on the same bus just need a different jumper
# setting, same as twoSensors.py does for legacy boards with 0x49/0x4A/0x4B.
sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c, adc_addr=0x30)

# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - ATtiny Bridge Board Example")

if not sensor.begin():
print("ERROR: Can't init the sensor! Check connections and jumper address!")
while True:
time.sleep_ms(100)

print("Sensor initialized successfully!")

# -------------------------------------------------------------------------
# Main loop
# -------------------------------------------------------------------------
while True:
reading = sensor.getPPM()

# If PPB is more relevant for your sensor, use:
# reading = sensor.getPPB()

print("Sensor reading: {:.5f} PPM".format(reading))

time.sleep_ms(2500)

🔗Das vollständige Beispiel öffnen

Examples/electrochemical-bridgeBoard.py bei Commit 623e1e6

→

Erwartetes Ergebnis in der Shell:

ShellMicroPython
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!

Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration mit fünf Dezimalstellen und PPM. Antwortet das Board nicht, gibt das Skript ERROR: Can't init the sensor! Check connections and jumper address! aus und wartet.

Verwendete Funktionen​

I2C und Pin stammen aus dem machine-Modul von MicroPython selbst, time.sleep_ms() aus dessen time-Modul. 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 Board kommuniziert: Bei einer Adresse von 0x30 bis 0x37 verwendet sie das Protokoll der ATtiny404-Bridge; bei jeder anderen Adresse kommuniziert sie mit einem ADS1115 unter dieser Adresse und selbst mit dem LMP91000 unter 0x48. Das Beispiel übergibt 0x30.

ReturnsDas Sensorobjekt.

Parameter

NameTypBeschreibung
sensor_typeSensorConfigDie Voreinstellung 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, an dem das Board angeschlossen ist. 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 Exception aus.
adc_addrintDie I2C-Adresse des Boards, 0x30 bis 0x37, wie über den Adressschalter eingestellt. Werkseitig 0x30.
config_pinintEine GPIO-Nummer für die Enable-Leitung des LMP91000. Die Bibliothek hält sie auf High und zieht sie nur auf Low, während sie die Register des LMP91000 selbst beschreibt; bei einer Adresse von 0x30 bis 0x37 wird sie nicht verwendet, daher lässt das Beispiel sie weg. Standardmäßig None.
begin()returns bool

Prüft, ob die Bridge antwortet, sendet die ADC-Verstärkung aus der Voreinstellung und konfiguriert den LMP91000 mit Verstärkung, Last, Referenz, Bias und Modus der Voreinstellung. Rufen Sie sie einmal vor dem Auslesen auf.

ReturnsTrue, wenn die Bridge geantwortet hat und beide Konfigurationen erfolgreich waren, andernfalls False. Jeder Schritt wird nach 500 ms ohne Antwort abgebrochen.

getPPM()returns float

Nimmt über die Bridge einen ADC-Messwert auf und rechnet ihn mithilfe der Voreinstellung 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. Ein negatives Ergebnis wird als 0 zurückgegeben.

ReturnsDie Gaskonzentration in PPM.

getPPB()returns float

Derselbe Messwert wie bei getPPM(), in Parts per Billion.

ReturnsDie Gaskonzentration in PPB, getPPM() x 1000.

Zusammenfassung​

Erstellen Sie pro Board ein ElectrochemicalGasSensor mit der Voreinstellung für die jeweilige Zelle, dem I2C-Bus und der Adresse des Boards. Rufen Sie begin() einmal auf und brechen Sie ab, falls es False zurückgibt. Rufen Sie danach getPPM() oder getPPB() so oft auf, wie Sie einen Messwert benötigen.

Um mehrere Boards am selben Bus zu betreiben, geben Sie jedem über den Adressschalter eine eigene Adresse (0x30 bis 0x37) und erstellen Sie für jede Adresse ein Objekt am selben i2c-Bus.