Die NO2-Konzentration auslesen
Was dieses Beispiel zeigt
Das Beispiel electrochemical-bridgeBoard.py des Moduls erstellt den Sensor an der
I2C-Adresse des Boards, startet ihn und gibt alle 2,5 Sekunden die Gaskonzentration in ppm aus. Eine adc_addr von 0x30 bis 0x37 teilt dem Modul mit, dass es mit dem ATtiny404 des Boards kommuniziert, der den LMP91000 und den ADS1115 für Sie steuert.
Das Beispiel erstellt den Sensor mit der Ozon-Voreinstellung SENSOR_O3. Ändern Sie SENSOR_O3 an beiden Stellen in SENSOR_NO2, in der import-Zeile und in der Zeile, die den Sensor erstellt: SENSOR_NO2 ist die Voreinstellung des Moduls für die SGX-4NO2-Zelle auf diesem Board. Das Beispiel öffnet den I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21; passen Sie diese an Ihren Controller an. Wenn Sie die ADDRESS-Schalter verstellt haben, ändern Sie 0x30 auf die Adresse, die sie einstellen.
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
Examples/electrochemical-bridgeBoard.py im Commit 623e1e6
Der Kommentar am Anfang des Beispiels besagt, dass LMPEN fest mit GND verbunden ist. Auf diesem Board ist LMPEN der Enable-Eingang des LMP91000 und zusätzlich mit dem ATtiny404 verbunden, wie Hardware-Details
zeigt. In beiden Fällen schließen Sie nichts daran an: Bei adc_addr 0x30 bis 0x37 verwendet das Modul config_pin nicht.
Erwartetes Ergebnis:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Sensor reading: 0.01433 PPM
Sensor reading: 0.01325 PPM
Sensor reading: 0.01431 PPM
Sensor reading: 0.01395 PPM
Alle 2,5 Sekunden folgt eine neue Zeile Sensor reading: mit der NO2-Konzentration in ppm auf fünf Nachkommastellen. Wenn das Board nicht antwortet, gibt das Modul ERROR: Can't init the sensor! Check connections and jumper address! aus und wartet in einer Schleife.
Verwendete Funktionen
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt das Sensorobjekt. Es wird nichts an das Board gesendet, bis Sie begin() aufrufen. Die Adresse bestimmt, wie begin() mit dem Board kommuniziert: Bei 0x30 bis 0x37 sendet es seine Befehle an den ATtiny404, und bei 0x48 bis 0x4B (standardmäßig 0x49) spricht es den ADS1115 unter adc_addr und den LMP91000 direkt an.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
SensorConfig | sensor_type | Die Voreinstellung der Zelle. Verwenden Sie SENSOR_NO2 für die SGX-4NO2-Zelle dieses Boards. |
I2C | i2c | Der I2C-Bus. Bei None wählt das Modul die Pins anhand des von MicroPython gemeldeten Ports: I2C-Bus 0 an Pin 22 (SCL) und 21 (SDA) beim ESP32-Port, scl=Pin(5), sda=Pin(4) beim ESP8266-Port. Bei einem Port, den es nicht erkennt, löst es Board not recognized, please pass an I2C object manually aus. |
int | adc_addr | Die I2C-Adresse des Boards. Verwenden Sie 0x30 bis 0x37, wie von den ADDRESS-Schaltern eingestellt; im Auslieferungszustand 0x30. |
int | config_pin | GPIO für den Enable-Pin des LMP91000. Bei den Adressen 0x30 bis 0x37 nicht verwendet; lassen Sie ihn weg. |
sensor.begin()returns boolPrüft, ob das Board antwortet, und sendet ihm dann die ADC-Verstärkung und die Datenrate sowie die LMP91000-Konfiguration aus der Voreinstellung. Jeder Schritt wird wiederholt, bis das Board antwortet oder 500 ms vergangen sind. Rufen Sie die Funktion einmal vor dem Auslesen auf.
ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.
sensor.getPPM()returns floatFordert vom Board einen neuen ADC-Messwert an und rechnet ihn in eine Gaskonzentration um: die Spannung minus den internen Nullpunkt, plus den Kalibrierungs-Offset, geteilt durch die TIA-Verstärkung und durch die Empfindlichkeit der Zelle aus der Voreinstellung. Ein negatives Ergebnis wird als 0.0 zurückgegeben.
ReturnsDie Gaskonzentration in ppm.
sensor.getPPB()returns floatDieselbe Messung wie getPPM(), multipliziert mit 1000. Das Beispiel erwähnt sie in einem Kommentar als die Zeile, die Sie verwenden, wenn Teile pro Milliarde für Ihren Sensor besser geeignet sind.
ReturnsDie Gaskonzentration in ppb.
Zusammenfassung
Das Beispiel erstellt zuerst den I2C-Bus und übergibt ihn an den Sensor, sodass es nicht von den Standard-Pins des Ports abhängt. Wenn begin() den Wert False zurückgibt, gibt es den Fehler aus und bleibt in einer Schleife. Andernfalls ruft jeder Durchlauf der Hauptschleife getPPM() auf und gibt den Wert mit fünf Nachkommastellen aus.