Anzeige in PPB
Was dieses Beispiel zeigt
Das Beispiel electrochemical-singleSensor.py erstellt ein Sensorobjekt,
startet es und gibt alle 2,5 Sekunden einen Messwert in PPB aus. Es übergibt
keine Adresse, daher verwendet der Konstruktor seinen Standardwert, adc_addr=0x49.
Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern
Sie diese Pins auf die Pins, die der Qwiic-Connector Ihres Controllers oder Ihre Verdrahtung verwendet.
Sie müssen LMPEN bei diesem Board nicht verdrahten, was auch immer die Kommentare im Beispiel sagen:
Das Board hält den Pin selbst auf Low.
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
Examples/electrochemical-singleSensor.py im Commit 623e1e6
Was dieses Board mit dem Beispiel in der vorliegenden Form ausgibt, wurde noch nicht gemessen.
Beim Test dieses Boards über Qwiic fand ein I2C-Scan nur eine Adresse,
0x30, und begin() schlug für einen Sensor fehl, der mit 0x49 erstellt wurde, dem Standardwert, den dieses
Beispiel verwendet. Schlägt begin() fehl, gibt das Beispiel nach seiner Titelzeile
ERROR: Can't init the sensor! Check connections! aus
und hält dort an.
Wenn begin() erfolgreich ist, zeigt die Shell:
Electrochemical Gas Sensor - Single Sensor Example
Sensor initialized successfully!
Danach erscheint alle 2,5 Sekunden eine Zeile Sensor reading: , gefolgt von einem Wert mit fünf Nachkommastellen
und PPB.
Verwendete Funktionen
I2C(id, scl, sda)returns I2CErstellt das I2C-Bus-Objekt aus dem Modul machine von MicroPython, das das Sensorobjekt verwendet. Das Beispiel nutzt Bus 0 mit SCL an Pin(22) und SDA an Pin(21). I2C und Pin gehören zu MicroPython und sind nicht Teil dieser Bibliothek.
ReturnsDas I2C-Bus-Objekt.
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. Es wird nichts an das Board gesendet, bis Sie begin() aufrufen. Das Beispiel übergibt die Sensorkonfiguration und den Bus und belässt adc_addr und config_pin auf ihren Standardwerten.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
SensorConfig | sensor_type | Die Front-End- und Wandlungseinstellungen, etwa SENSOR_O3. Die Voreinstellungen sind in ElectrochemicalGasSensor.py definiert. |
I2C | i2c | Der zu verwendende Bus. Wird er weggelassen, wählt das Modul die Pins nur bei Boards, die es erkennt (ESP32: Bus 0, SCL 22, SDA 21; ESP8266: SCL 5, SDA 4), und löst sonst eine Exception aus. |
int | adc_addr | Die Adresse, mit der das Modul kommuniziert, standardmäßig 0x49, wie in diesem Beispiel. Eine Adresse von 0x30 bis 0x37 lässt begin() die Bridge-Befehle verwenden; jede andere Adresse wird als eigene Adresse des ADS1115 verstanden. |
int | config_pin | Ein GPIO-Pin, den das Modul auf High hält und auf Low zieht, während es die LMP91000-Einstellungen schreibt. Standardmäßig None; wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. |
sensor.begin()returns boolKonfiguriert den ADC und den LMP91000 anhand der Sensorkonfiguration. Bei einer adc_addr von 0x30 bis 0x37 prüft es, ob die Bridge des Boards antwortet, und sendet ihr die ADC-Verstärkung, die langsamste ADC-Datenrate und die LMP91000-Einstellungen, wobei jeder Befehl bis zu 500 ms lang wiederholt wird. Bei jeder anderen Adresse richtet es den ADS1115 unter dieser Adresse mit derselben Verstärkung und Datenrate ein und schreibt die LMP91000-Einstellungen direkt, wobei es config_pin dabei auf Low zieht, falls einer angegeben ist.
ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.
sensor.getPPB()returns floatNimmt einen Messwert auf und gibt ihn in Parts per Billion zurück: der Wert von getPPM() multipliziert mit 1000.
ReturnsDie Konzentration in PPB.
sensor.getPPM()returns floatDie auskommentierte Alternative im Beispiel. Nimmt einen ADC-Messwert auf und wandelt die Spannung in eine Konzentration um: Sie zieht den internen Nullpunkt ab (ein Anteil der 2,5-V-Referenz des Boards), addiert die Nullpunktkalibrierung der Konfiguration, teilt durch die TIA-Verstärkung, um den Zellstrom zu erhalten, und teilt dann durch die Nanoampere pro PPM der Konfiguration. Ein negatives Ergebnis wird als 0.0 zurückgegeben.
ReturnsDie Konzentration in PPM.
Zusammenfassung
SENSOR_O3 ist die Voreinstellung für eine Ozonzelle SGX-403-20. Das Modul hat
noch keine Voreinstellung für die Sauerstoffzelle SGX-4OX-ROHS dieses Boards, daher wird der Wert, den das Beispiel
ausgibt, mit den Einstellungen der Ozonzelle berechnet. Die Seite
Eigene Konfiguration
zeigt, wie Sie Ihre eigene schreiben.