Die NO-Konzentration auslesen
Was dieses Beispiel zeigt
Das Beispiel electrochemical-bridgeBoard.py spricht das Board unter seiner I2C-Adresse 0x30 an. Das Modul erkennt eine Adresse von 0x30 bis 0x37 und nutzt die ATtiny404-Bridge des Boards: begin() prüft, ob die Bridge antwortet, richtet den ADC ein und konfiguriert das LMP91000-Frontend für die gewählte Zelle. Jeder Aufruf von getPPM() löst dann eine ADC-Wandlung aus und rechnet sie in eine Konzentration in ppm um.
Das Beispiel öffnet den I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie diese Pins, wenn der Qwiic-Connector Ihres Controllers andere Pins verwendet, und lassen Sie den ADDRESS-Schalter in der Auslieferungsstellung, damit das Board unter seiner Standardadresse 0x30 antwortet.
Ändern Sie vor dem Ausführen SENSOR_O3 an beiden Stellen in SENSOR_NO (in der import-Zeile und in der Zeile ElectrochemicalGasSensor(...)). SENSOR_NO ist die Voreinstellung des Moduls 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 %. SENSOR_O3 ist die Voreinstellung für eine Ozonzelle, daher ist ihr Ergebnis kein NO in ppm.
Der Beispielcode
Das Listing ist die Datei des Moduls beim festgelegten Commit. Nur Kommentarzeilen wurden weggelassen: die Zeile, die den alten Connector nennt, die Kopfzeile, die die Shopseite eines anderen Produkts nennt, und die Zeile des Anschlussdiagramms, die ein altes Board nennt.
Der Kommentar im Beispiel besagt, dass LMPEN fest mit GND verbunden ist. Auf diesem Board zieht ein 10-kΩ-Widerstand LMPEN auf GND, und der Pin ist außerdem mit dem ATtiny404 und der Stiftleiste verbunden. In beiden Fällen setzen Sie kein config_pin: Bei 0x30 bis 0x37 ignoriert das Modul es.
# 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 beim Commit 623e1e6
Erwartetes Ergebnis mit SENSOR_NO (Messwerte in sauberer Luft; Ihre werden abweichen):
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Sensor reading: 0.00624 PPM
Sensor reading: 0.00588 PPM
Sensor reading: 0.00575 PPM
Sensor reading: 0.00585 PPM
Jede Zeile Sensor reading: ist ein Messwert, mit der NO-Konzentration in ppm auf fünf Nachkommastellen und PPM am Ende. Wenn das Board nicht antwortet, gibt das Beispiel
ERROR: Can't init the sensor! Check connections and jumper address! aus und bleibt in einer Schleife.
Verwendete Funktionen
I2C(0, scl=Pin(22), sda=Pin(21))returns I2CErstellt den Hardware-I2C-Bus 0 an den angegebenen SCL- und SDA-Pins. 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 Sie an den Sensor übergeben.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | id | Der Hardware-I2C-Bus, im Beispiel 0. |
Pin | scl | Der Taktpin, im Beispiel Pin(22). |
Pin | sda | Der Datenpin, im Beispiel Pin(21). |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt das Sensorobjekt für ein Board. Über I2C wird nichts gesendet, bis Sie begin() aufrufen. Mit i2c=None öffnet das Modul auf den Boards, die es erkennt, selbst einen Bus, 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. Bei einem Board, das es nicht erkennt, löst es eine Exception aus.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
SensorConfig | sensor_type | Die Zellenvoreinstellung. Verwenden Sie für dieses Board SENSOR_NO. Das Modul hat außerdem SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_H2S, SENSOR_NH3 und SENSOR_CL2. |
I2C | i2c | Der I2C-Bus, an dem das Board angeschlossen ist. |
int | adc_addr | Die I2C-Adresse. Das Beispiel übergibt 0x30, die Adresse, mit der das Board ausgeliefert wird. Der ADDRESS-Schalter verschiebt sie innerhalb von 0x30 bis 0x37, aber welche Stellung welche Adresse ergibt, ist noch nicht bestätigt, daher ist nur 0x30 sicher. Bei jeder Adresse außerhalb von 0x30 bis 0x37, etwa der Standardadresse 0x49, spricht das Modul den ADS1115 unter dieser Adresse und den LMP91000 direkt an. |
int | config_pin | Ein GPIO für LMPEN. Bei den Adressen 0x30 bis 0x37 unbenutzt, daher lässt das Beispiel ihn weg. |
sensor.begin()returns boolPrüft, ob die Bridge des Boards antwortet, setzt die ADC-Verstärkung aus der Voreinstellung und die langsamste ADC-Datenrate und konfiguriert dann das LMP91000-Frontend (Verstärkung, Last, Referenz, interner Nullpunkt, Vorspannung und Modus) anhand der Voreinstellung. Jeder Schritt wartet bis zu 500 ms auf die Antwort der Bridge.
ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.
sensor.getPPM()returns floatNimmt einen ADC-Messwert auf und rechnet ihn um: Sie zieht den internen Nullpunkt ab (2,5 V mal den Prozentwert des internen Nullpunkts der Voreinstellung), addiert die Nullpunktkalibrierung, teilt durch die Verstärkung, um den Zellenstrom zu erhalten, und teilt diesen durch die nA pro ppm der Voreinstellung.
ReturnsDie Gaskonzentration in ppm. Ein negatives Ergebnis wird als 0.0 zurückgegeben.
sensor.getPPB()returns floatDie Alternative, die der Kommentar im Beispiel anbietet: nimmt denselben Messwert wie getPPM() auf und multipliziert ihn mit 1000.
ReturnsDie Gaskonzentration in ppb.
Zusammenfassung
begin() läuft einmal vor der Schleife. Gibt es False zurück, gibt das Beispiel
den Fehler aus und wartet endlos, damit Sie das Problem sofort sehen, statt Nullen zu erhalten.
In der Schleife führt jeder Aufruf von getPPM() eine neue Messung durch, und das Beispiel gibt
sie mit fünf Nachkommastellen aus und wartet dann 2,5 Sekunden.