Den Nullpunkt kalibrieren
Was dieses Beispiel zeigt
Das Beispiel electrochemical-calibrateSensor.py addiert mit setCustomZeroCalibration() einen Spannungsoffset zu jedem
Messwert. Das Modul meldet jedes negative
Ergebnis als 0. Passen Sie daher in Luft ohne das Zielgas CUSTOM_CALIBRATION an, bis der Messwert gerade eben 0 ppb beträgt, wie es der Kommentar im Beispiel beschreibt. Danach gibt es alle
2,5 Sekunden einen Messwert in ppb (parts per billion) aus.
Das Beispiel erstellt den Sensor mit adc_addr=0x49 und config_pin=32 für
LMPEN. Es öffnet den I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21; ändern Sie
diese Pin-Nummern auf die I2C-Pins Ihres Controllers, falls diese abweichen. Bei 0x49 kommuniziert das
Modul direkt mit dem ADS1115 und dem LMP91000, nicht über die ATtiny404-Bridge des Boards. Siehe die
Bibliotheksübersicht,
um zu erfahren, wie die Adresse dies bestimmt.
Das Beispiel übergibt SENSOR_O3, die Voreinstellung des Moduls für eine Ozonzelle. Für eine
Stickstoffmonoxid-Messung verwenden Sie SENSOR_NO an beiden Stellen (in der import-Zeile und
in der Zeile ElectrochemicalGasSensor(...)). SENSOR_NO ist die Voreinstellung für die
SGX-4NO-250-Zelle dieses Boards: 400 nA pro ppm, eine Verstärkung des Verstärkers von 120 kΩ und eine
positive Vorspannung von 12 %.
Der Beispielcode
Das Listing ist die Datei des Moduls beim fixierten Commit. Nur Kommentarzeilen wurden weggelassen: die Kopfzeile, die die Shopseite eines anderen Produkts nennt, und die Zeile mit dem Anschlussdiagramm, die ein altes Board nennt.
# FILE: electrochemical-calibrateSensor.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Sensor zero-point calibration example.
# LAST UPDATED: 2026-05-21
# Connecting diagram:
#
# Qwiic------------------------>Qwiic
# LMPEN------------------------>32 (GPIO pin, required for configuration)
from machine import I2C, Pin
import time
from ElectrochemicalGasSensor import ElectrochemicalGasSensor, SENSOR_O3
# This value is added to the voltage read from the ADC.
# In an environment with 0 of the target gas, the reading after calibration
# should be just barely 0 PPB — adjust this value until that is the case.
CUSTOM_CALIBRATION = 0
# Initialize I2C
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
# Custom ADC address (0x49 default) and GPIO pin for LMPEN
sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c, adc_addr=0x49, config_pin=32)
# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Calibration Example")
if not sensor.begin():
print("ERROR: Can't init the sensor! Check connections!")
while True:
time.sleep_ms(100)
# Apply the zero-point calibration offset
sensor.setCustomZeroCalibration(CUSTOM_CALIBRATION)
print("Sensor initialized successfully!")
# -------------------------------------------------------------------------
# Main loop
# -------------------------------------------------------------------------
while True:
reading = sensor.getPPB()
# O3 is typically measured in PPB
# Switch to getPPM() if PPM is more relevant for your use case
print("Sensor reading: {:.5f} PPB".format(reading))
time.sleep_ms(2500)
🔗Vollständiges Beispiel öffnen
Examples/electrochemical-calibrateSensor.py beim Commit 623e1e6
Erwartetes Ergebnis mit SENSOR_NO (Messwerte in Luft ohne NO; Ihre
weichen ab). Der Wert von CUSTOM_CALIBRATION, mit dem diese Messwerte aufgenommen wurden, ist nicht
festgehalten, daher können sie von dem abweichen, was die 0 im Listing ergibt: Sie zeigen die
Form der Ausgabe, und Ihre Zahlen hängen vom eingestellten Offset ab.
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!
Sensor reading: 6.04131 PPB
Sensor reading: 6.16508 PPB
Sensor reading: 6.27205 PPB
Sensor reading: 5.68221 PPB
Alle 2,5 Sekunden erscheint eine Zeile Sensor reading: , mit
der Konzentration in ppb mit fünf Nachkommastellen und PPB am Ende. Schlägt begin()
fehl, gibt das Beispiel ERROR: Can't init the sensor! Check connections! 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 Pins SCL und SDA. 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
| Type | Name | Description |
|---|---|---|
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. Ü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. Auf einem Board, das es nicht erkennt, löst es eine Exception aus.
ReturnsDas Sensorobjekt.
Parameter
| Type | Name | Description |
|---|---|---|
SensorConfig | sensor_type | Die Zellenvoreinstellung, im Beispiel SENSOR_O3. SENSOR_NO ist die für die Zelle dieses Boards. Das Modul hat außerdem SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_H2S, SENSOR_NH3 und SENSOR_CL2. |
I2C | i2c | Der I2C-Bus, an dem das Board angeschlossen ist. |
int | adc_addr | Die I2C-Adresse, im Beispiel 0x49. Bei 0x30 bis 0x37 kommuniziert das Modul mit der ATtiny404-Bridge des Boards; bei jeder anderen Adresse kommuniziert es mit dem ADS1115 an dieser Adresse und direkt mit dem LMP91000. |
int | config_pin | Ein GPIO für LMPEN, im Beispiel 32. Das Modul hält ihn auf High und zieht ihn nur während der Konfiguration des LMP91000 auf Low. Bei den Adressen 0x30 bis 0x37 ungenutzt. |
sensor.begin()returns boolBei einer Adresse von 0x30 bis 0x37 prüft es, ob die Bridge des Boards antwortet, und sendet die ADC- und Frontend-Einstellungen darüber, wobei es bei jedem Schritt bis zu 500 ms wartet. Bei jeder anderen Adresse prüft es in einem I2C-Scan, ob der ADS1115 unter adc_addr antwortet, stellt die ADC-Verstärkung der Voreinstellung und die langsamste Datenrate ein und konfiguriert dann den LMP91000 bei 0x48 (Verstärkung, Last, Referenz, interner Nullpunkt, Vorspannung und Modus). Dabei zieht es config_pin nur während dieser Konfiguration auf Low, wenn einer angegeben ist.
ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.
sensor.setCustomZeroCalibration(calibration)returns NoneLegt die Nullpunktkalibrierung der Voreinstellung des Sensors fest: eine Spannung, die getPPM() vor der Umrechnung zu jedem Messwert addiert. Sie ändert das Voreinstellungsobjekt selbst, sodass jeder mit derselben Voreinstellung erstellte Sensor den neuen Wert verwendet.
ReturnsNichts.
Parameter
| Type | Name | Description |
|---|---|---|
float | calibration | Der Offset in Volt, im Beispiel CUSTOM_CALIBRATION (0). |
sensor.getPPB()returns floatNimmt mit getPPM() einen Messwert auf und multipliziert ihn mit 1000. getPPM() liest ADC-Kanal 0 (bei 0x30 bis 0x37 führt die Bridge die Wandlung aus), subtrahiert den internen Nullpunkt (2,5 V mal dem Prozentwert des internen Nullpunkts der Voreinstellung), addiert die Nullpunktkalibrierung und teilt dann durch die Verstärkung des Verstärkers und durch die nA pro ppm der Voreinstellung.
ReturnsDie Gaskonzentration in ppb. Ein negatives Ergebnis wird als 0.0 zurückgegeben.
sensor.getPPM()returns floatDie Alternative, die der Kommentar im Beispiel anbietet: derselbe Messwert in ppm.
ReturnsDie Gaskonzentration in ppm. Ein negatives Ergebnis wird als 0.0 zurückgegeben.
Zusammenspiel
begin() konfiguriert das Frontend einmalig, dann legt setCustomZeroCalibration()
den Offset vor dem ersten Messwert fest. Ändern Sie CUSTOM_CALIBRATION, führen Sie das
Beispiel erneut in Luft ohne das Zielgas aus und wiederholen Sie dies, bis die
Messwerte gerade eben 0 ppb betragen.