Zum Hauptinhalt springen

Den Sensor auslesen

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-bridgeBoard.py startet das Board über seinen ATtiny404 unter 0x30, sendet dem Analog-Frontend seine Einstellungen und gibt alle 2,5 Sekunden einen Messwert aus. Ihr Controller spricht immer nur mit dem ATtiny404; dieser leitet die Einstellungen an den LMP91000 weiter und liest für Sie den ADS1115 aus.

Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie diese auf die Pins, die der Qwiic-Connector Ihres Controllers oder Ihre Verdrahtung verwendet. Sie müssen LMPEN nicht verdrahten: Das Board hält diesen Pin selbst auf Low. Wo die Kommentare des Beispiels Adress-Jumper auf der Rückseite des Boards erwähnen, verwendet dieses Board stattdessen den dreistufigen ADDRESS-Schalter auf seiner Oberseite.

Der Beispielcode​

# 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 im Commit 623e1e6

→

Erwartetes Ergebnis:

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

Danach trifft alle 2,5 Sekunden eine Zeile Sensor reading: gefolgt von einem Wert mit fünf Nachkommastellen und PPM ein. Wenn das Board nicht antwortet, gibt das Beispiel ERROR: Can't init the sensor! Check connections and jumper address! aus und hält dort an.

Verwendete Funktionen​

I2C(id, scl, sda)returns I2C

Erstellt das I2C-Busobjekt aus dem Modul machine von MicroPython, das das Sensorobjekt verwendet. Das Beispiel nutzt Bus 0 mit SCL an Pin(22) und SDA an Pin(21). I2C und Pin gehören zu MicroPython und sind nicht Teil dieser Bibliothek.

ReturnsDas I2C-Busobjekt.

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 das Sensorobjekt. Es wird nichts an das Board gesendet, bis Sie begin() aufrufen. Eine adc_addr von 0x30 bis 0x37 teilt dem Modul mit, dass es sich um ein Board mit der ATtiny404-Bridge handelt; config_pin wird dann ignoriert.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
SensorConfigsensor_typeDie Einstellungen für Frontend und Wandlung, etwa SENSOR_O3. Die Voreinstellungen sind in ElectrochemicalGasSensor.py definiert.
I2Ci2cDer zu verwendende Bus. Wird er weggelassen, wählt das Modul Pins nur bei Boards, die es erkennt (ESP32: Bus 0, SCL 22, SDA 21; ESP8266: SCL 5, SDA 4), und löst andernfalls eine Exception aus.
intadc_addrDie Adresse, mit der das Modul spricht, standardmäßig 0x49 und in diesem Beispiel 0x30. Eine Adresse von 0x30 bis 0x37 lässt begin() die Bridge-Befehle verwenden, passend zum ADDRESS-Schalter des Boards.
intconfig_pinEin GPIO-Pin, den das Modul auf High hält und auf Low zieht, während es die LMP91000-Einstellungen schreibt. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet.
sensor.begin()returns bool

Prüft, ob die Bridge antwortet, sendet ihr die ADC-Verstärkung und die langsamste ADC-Datenrate und sendet dann die LMP91000-Einstellungen aus der Sensorkonfiguration. Jeder Befehl an die Bridge wird bis zu 500 ms lang wiederholt.

ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.

sensor.getPPM()returns float

Fordert von der Bridge eine ADC-Wandlung an und wandelt die Spannung in eine Konzentration um: Es subtrahiert die interne Null (ein Anteil der 2,5-V-Referenz des Boards), addiert die Nullpunktkalibrierung der Konfiguration, teilt durch die TIA-Verstärkung, um den Zellenstrom zu erhalten, und teilt dann durch die Nanoampere pro PPM der Konfiguration. Ein negatives Ergebnis wird als 0.0 zurückgegeben.

ReturnsDie Konzentration in PPM, berechnet mit der Sensorkonfiguration, die Sie dem Konstruktor übergeben haben.

sensor.getPPB()returns float

Die auskommentierte Alternative im Beispiel: derselbe Messwert wie bei getPPM(), multipliziert mit 1000.

ReturnsDie Konzentration in PPB.

Alles zusammen​

SENSOR_O3 ist die Voreinstellung für eine Ozonzelle SGX-403-20. Das Modul hat noch keine Voreinstellung für die Sauerstoffzelle SGX-4OX-ROHS dieses Boards, daher wird der vom Beispiel ausgegebene Wert mit den Einstellungen der Ozonzelle berechnet. Die Seite Benutzerdefinierte Konfiguration zeigt, wie Sie eine eigene SensorConfig mit den Bias- und Referenzeinstellungen für diese Zelle schreiben.

Nach dem Einschalten kann die Zelle bis zu 15 Minuten brauchen, um sich einzupendeln. Lassen Sie sie daher laufen, bevor Sie einem Messwert vertrauen.

Bis zu acht Boards teilen sich einen Bus: Geben Sie jedem Board mit dem ADDRESS-Schalter eine eigene Adresse und erstellen Sie pro Adresse ein ElectrochemicalGasSensor, von 0x30 bis 0x37.