Zum Hauptinhalt springen

Die SO2-Konzentration auslesen

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-bridgeBoard.py der Bibliothek startet das Breakout an der I2C-Adresse 0x30 und gibt die Gaskonzentration alle 2,5 Sekunden in ppm aus. Es ist dasselbe Skript, das auch der Schnellstart verwendet.

Das Beispiel erstellt den Sensor mit der Ozonzellen-Voreinstellung SENSOR_O3. SENSOR_SO2 ist die Voreinstellung der Bibliothek für die SGX-4SO2-Zelle auf diesem Board: Ändern Sie SENSOR_O3 in der import-Zeile und in der Zeile, die sensor erstellt, in SENSOR_SO2, um SO2-Werte zu erhalten. Das Skript erstellt den I2C-Bus an GPIO 22 (SCL) und GPIO 21 (SDA); ändern Sie diese Nummern, wenn der Qwiic-Connector Ihres Boards andere Pins verwendet.

Das Listing ist die Datei der Bibliothek beim festgelegten Commit, bis auf einige reine Kommentarzeilen, die den Connector mit einem älteren Namen benennen, auf ein anderes Soldered-Produkt verweisen oder im Anschlussdiagramm ein Controller-Board nennen und weggelassen wurden. Wo die Kommentare sagen, die Adresse werde mit Jumpern eingestellt, wird sie bei diesem Board über den ADDRESS-Schalter eingestellt (0x30 im Auslieferungszustand), und die Adress-Jumper JP2 bis JP4 bleiben im Auslieferungszustand. Wo sie sagen, LMPEN sei fest mit GND verbunden, ist LMPEN bei diesem Board über einen 10-kΩ-Widerstand auf GND gezogen und führt außerdem zum On-Board-Mikrocontroller (siehe Hardware-Details).

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)

🔗Vollständiges Beispiel öffnen

electrochemical-bridgeBoard.py beim festgelegten Commit

→

Erwartetes Ergebnis:

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

Nach diesen Zeilen folgt alle 2,5 Sekunden eine neue Zeile Sensor reading: mit der Konzentration in ppm auf fünf Nachkommastellen.

Verwendete Funktionen​

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

Erstellt das Sensorobjekt. Der Sensortyp ist eine Voreinstellung mit der Empfindlichkeit der Zelle sowie den Einstellungen des Front-Ends und des ADC. Die Adresse bestimmt, wie das Modul mit dem Board kommuniziert: 0x30 bis 0x37 ist der Bridge-Bereich.

ReturnsDas Sensorobjekt.

Parameter

ParameterTypBeschreibung
sensor_typeSensorConfigDie Zellen-Voreinstellung. SENSOR_SO2 ist die Voreinstellung für die Zelle dieses Boards.
i2cI2CEin initialisiertes machine.I2C-Objekt. Ohne dieses wählt das Modul die Pins nur bei einigen bekannten Boards und löst bei jedem anderen Board not recognized aus.
adc_addrintDie Adresse, mit der das Modul kommuniziert. 0x30 bis 0x37 ist die über den ADDRESS-Schalter eingestellte Adresse des Boards und wählt den Bridge-Modus des Moduls; jeder andere Wert spricht einen ADS1115 direkt unter dieser Adresse an. Standard: 0x49.
config_pinintGPIO für die Enable-Leitung des Front-Ends. Wird bei den Adressen 0x30 bis 0x37 nicht verwendet; dieses Beispiel lässt ihn weg.
begin()returns bool

Prüft, ob das Board antwortet, und sendet die ADC- und LMP91000-Einstellungen aus der Voreinstellung an das Board. Rufen Sie sie einmal vor der ersten Messung auf.

ReturnsTrue, wenn das Board geantwortet und alle Einstellungen übernommen hat, sonst False.

getPPM()returns float

Lässt das Board eine ADC-Messung durchführen und rechnet sie in eine Gaskonzentration um, unter Verwendung der 2,5-V-Referenz, der Verstärkung des Front-Ends und der Empfindlichkeit der Zelle aus der Voreinstellung. Ein Ergebnis unter null wird als 0 zurückgegeben.

ReturnsGaskonzentration in ppm.

getPPB()returns float

Dieselbe Messung wie getPPM(), in Parts per Billion. Das Beispiel zeigt sie als Alternative in einem Kommentar.

ReturnsGaskonzentration in ppb (getPPM() x 1000).

Zusammenfassung​

begin() sendet die Einstellungen der Zelle einmal, danach fordert jeder Aufruf von getPPM() vom Board eine neue Wandlung an. Halten Sie adc_addr identisch mit der Einstellung des ADDRESS-Schalters, und geben Sie jedem Board am selben Bus eine eigene Adresse.

Die anderen Beispiele der Bibliothek haben jeweils eine eigene Seite, darunter Einzelner Sensor und Zwei Sensoren.