Einzelner Sensor
Was dieses Beispiel zeigt
Das Beispiel electrochemical-singleSensor.py der Bibliothek erzeugt ein Sensorobjekt, startet es und gibt alle 2,5 Sekunden die Gaskonzentration in ppb (Teile pro Milliarde) aus.
Das Beispiel erzeugt den Sensor mit dem Ozonzellen-Preset SENSOR_O3. SENSOR_SO2 ist das Preset der Bibliothek für die SO2-Zelle dieses Boards: Ändern Sie SENSOR_O3 in der import-Zeile und in der Zeile, die sensor erzeugt, in SENSOR_SO2, um SO2-Werte zu erhalten. Das Skript erzeugt den I2C-Bus auf GPIO 22 (SCL) und GPIO 21 (SDA); ändern Sie diese Nummern, wenn Ihr Board andere Pins verwendet.
Auf diesem Board liegen der LMP91000 und der ADS1115 am boardeigenen Bus 2, und Ihr Controller erreicht sie über die Adresse des Boards am Qwiic-Bus: 0x30 im Auslieferungszustand, 0x30 bis 0x37 mit dem ADDRESS-Schalter. Das Beispiel übergibt kein adc_addr und verwendet daher den Standardwert des Moduls, 0x49, der direkt mit einem ADS1115 kommuniziert. Übergeben Sie die Adresse des Boards als adc_addr, zum Beispiel sensor = ElectrochemicalGasSensor(SENSOR_SO2, i2c, adc_addr=0x30). Wo das Anschlussdiagramm angibt, dass LMPEN mit GND oder einem GPIO-Pin verbunden wird: Auf diesem Board ist LMPEN bereits über einen 10-kΩ-Widerstand auf GND gezogen und führt außerdem zum Mikrocontroller auf dem Board, und bei den Adressen des Boards verwendet das Modul config_pin nicht (siehe Hardware-Details).
Das Listing ist die Datei der Bibliothek am festgelegten Commit, bis auf zwei reine Kommentarzeilen, die auf ein anderes Soldered-Produkt verweisen oder im Anschlussdiagramm ein Controller-Board nennen und weggelassen wurden.
Der Beispielcode
# FILE: electrochemical-singleSensor.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Single sensor PPM reading example.
# LAST UPDATED: 2026-05-21
# Connecting diagram:
#
# Qwiic------------------------>Qwiic
# LMPEN------------------------>GND or GPIO pin (see config_pin parameter below)
from machine import I2C, Pin
import time
from ElectrochemicalGasSensor import ElectrochemicalGasSensor, SENSOR_O3
# Initialize I2C
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
# Create sensor object - change SENSOR_O3 to match your sensor type
# Available types: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3,
# SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2
sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c)
# If using a custom ADC address or a GPIO pin for LMP91000 MENB:
# sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c, adc_addr=0x4B, config_pin=5)
# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Single Sensor Example")
if not sensor.begin():
print("ERROR: Can't init the sensor! Check connections!")
while True:
time.sleep_ms(100)
print("Sensor initialized successfully!")
# -------------------------------------------------------------------------
# Main loop
# -------------------------------------------------------------------------
while True:
reading = sensor.getPPB()
# If PPM is more relevant for your sensor, use:
# reading = sensor.getPPM()
print("Sensor reading: {:.5f} PPB".format(reading))
time.sleep_ms(2500)
🔗Vollständiges Beispiel öffnen
electrochemical-singleSensor.py am festgelegten Commit
Erwartetes Ergebnis:
Electrochemical Gas Sensor - Single Sensor Example
Sensor initialized successfully!
Nach diesen Zeilen folgt alle 2,5 Sekunden eine neue Zeile Sensor reading: mit der Konzentration in ppb auf fünf Dezimalstellen.
Verwendete Funktionen
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErzeugt das Sensorobjekt aus einem Zellen-Preset, einem I2C-Objekt, einer Adresse und einem optionalen Enable-Pin. Das Beispiel übergibt nur das Preset und das I2C-Objekt, daher ist die Adresse der Standardwert 0x49.
ReturnsDas Sensorobjekt.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Das Zellen-Preset. SENSOR_SO2 ist das Preset für die Zelle dieses Boards. |
i2c | I2C | Ein initialisiertes machine.I2C-Objekt. Ohne dieses wählt das Modul die Pins nur auf einigen bekannten Boards und löst auf jedem anderen Board not recognized aus. |
adc_addr | int | Die Adresse, mit der das Modul kommuniziert. 0x30 bis 0x37 wählt den Bridge-Modus des Moduls, der mit dem Mikrocontroller auf dem Board kommuniziert; jeder andere Wert kommuniziert direkt mit einem ADS1115 unter dieser Adresse. Standard 0x49. |
config_pin | int | GPIO für die Enable-Leitung des LMP91000. Wird bei den Adressen 0x30 bis 0x37 nicht verwendet. Standard None. |
begin()returns boolStartet den Transport, den die Adresse auswählt, und sendet die ADC- und LMP91000-Einstellungen aus dem Preset. Rufen Sie sie einmal vor jeder Messung auf.
ReturnsTrue, wenn die Einrichtung erfolgreich war, andernfalls False.
getPPB()returns floatFührt eine ADC-Messung durch und gibt die Gaskonzentration in Teilen pro Milliarde zurück: getPPM() x 1000. Ein Ergebnis unter null wird als 0 zurückgegeben.
ReturnsGaskonzentration in ppb.
getPPM()returns floatDieselbe Messung in ppm. Das Beispiel zeigt sie als Alternative in einem Kommentar.
ReturnsGaskonzentration in ppm.
Alles zusammen
Der Messbereich der SO2-Zelle beträgt 0 bis 20 ppm, daher ist ppm oft die praktischere Einheit. Um ppm auszugeben, tauschen Sie die beiden reading =-Zeilen und ändern Sie in der Zeile print("Sensor reading: ...") PPB in PPM, damit die Bezeichnung zum Wert passt.