Die CO-Konzentration auslesen
Was dieses Beispiel zeigt
Das Beispiel electrochemical-bridgeBoard.py öffnet I2C, erzeugt den Sensor mit der Standardadresse des Boards, 0x30, und gibt die Gaskonzentration alle 2,5 Sekunden in ppm aus. Jede Adresse von 0x30 bis 0x37 veranlasst das Modul, mit der ATtiny404-Bridge des Boards zu kommunizieren, die das Frontend und den ADC für Sie einrichtet, sodass LMPEN keine Verdrahtung benötigt.
Ändern Sie vor dem Ausführen in der import-Zeile und in der Zeile ElectrochemicalGasSensor(...) jeweils SENSOR_O3 in SENSOR_CO. SENSOR_O3 ist die Voreinstellung des Moduls für die Ozonzelle, daher würde getPPM() mit der Empfindlichkeit und dem Nullpunkt dieser Zelle umrechnen. Dieses Board trägt die Kohlenmonoxidzelle SGX-4CO, und die Voreinstellung des Moduls dafür ist SENSOR_CO.
Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie diese auf die I2C-Pins Ihres Controllers, falls sie abweichen.
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)
Auf diesem Board wird die Adresse mit dem dreipoligen ADDRESS-DIP-Schalter auf der Oberseite, oben links, eingestellt, nicht mit Jumpern auf der Rückseite, und die Standardadresse 0x30 muss nicht geändert werden. LMPEN ist über 10 kΩ auf GND gezogen und nicht direkt damit verbunden; in beiden Fällen schließen Sie nichts daran an.
Erwartetes Ergebnis in der Thonny-Shell, sobald das Board antwortet:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Sensor reading: 0.29653 PPM
Sensor reading: 0.32569 PPM
Sensor reading: 0.32431 PPM
Sensor reading: 0.32453 PPM
Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration in ppm mit fünf Nachkommastellen und PPM. Ein Ergebnis unter null wird als 0.00000 ausgegeben.
Verwendete Funktionen
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErzeugt das Sensorobjekt. Bei adc_addr von 0x30 bis 0x37 kommuniziert begin() über die ATtiny404-Bridge mit dem Board; dieses Beispiel übergibt 0x30, die Standardadresse des Boards.
ReturnsDas Sensorobjekt.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Die Voreinstellung der Zelle. Für die SGX-4CO-Zelle dieses Boards ist die Voreinstellung des Moduls SENSOR_CO. |
i2c | machine.I2C | Ein initialisierter I2C-Bus. Bei None öffnet das Modul I2C 0 an den Pins 22 und 21 auf einem ESP32 oder an den Pins 5 und 4 auf einem ESP8266 und löst auf jedem anderen Board Board not recognized, please pass an I2C object manually aus. |
adc_addr | int | Die I2C-Adresse. Standard 0x49. Von 0x30 bis 0x37 verwendet das Modul die Bridge. |
config_pin | int oder None | Ein GPIO, den das Modul auf Low setzt, während es die Konfiguration des Frontends sendet, und sonst auf High. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. Standard None. |
begin()returns boolPrüft bei einer Bridge-Adresse, ob die Bridge antwortet, sendet ihr die ADC-Verstärkung und die Datenrate aus der Voreinstellung und anschließend die Konfiguration des Frontends. Ein Busfehler wird bis zu einem Timeout von 500 ms je Schritt wiederholt.
ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.
getPPM()returns floatLässt die Bridge eine ADC-Wandlung durchführen, zieht den internen Nullpunkt ab und addiert die Nullpunktkalibrierung, und rechnet dann den Zellenstrom mit der Empfindlichkeit der Voreinstellung in ppm um.
ReturnsDie Gaskonzentration in ppm; 0.0, wenn das Ergebnis negativ wäre.
getPPB()returns floatDieselbe Messung wie getPPM(), in ppb (parts per billion). Das Beispiel zeigt sie als auskommentierte Alternative.
ReturnsgetPPM() multipliziert mit 1000.
Zusammenfassung
Öffnen Sie den I2C-Bus, erzeugen Sie das Objekt mit SENSOR_CO und adc_addr=0x30, rufen Sie einmal begin() auf und prüfen Sie das Ergebnis, und rufen Sie dann getPPM() in Ihrer Schleife auf. Ein zweites Board am selben Bus benötigt eine andere Adresse an seinen Schaltern und ein eigenes Objekt.