Den Nullpunkt kalibrieren
Was dieses Beispiel zeigt
Das Beispiel electrochemical-calibrateSensor.py des Moduls addiert Ihren eigenen Offset zur vom Sensor gemessenen Spannung und gibt dann alle 2,5 Sekunden die Gaskonzentration in ppb (parts per billion, Teile pro Milliarde) aus.
CUSTOM_CALIBRATION am Anfang ist dieser Offset in Volt. Wie der Kommentar im Beispiel sagt, bringen Sie das Board in Luft ohne das Zielgas und passen den Wert an, bis die Anzeige gerade eben 0 ppb beträgt. Das Beispiel beginnt mit 0.
Das Beispiel erzeugt den Sensor mit dem Ozon-Preset SENSOR_O3.
SENSOR_NO2 ist das Preset des Moduls für die SGX-4NO2-Zelle dieses Boards; ändern Sie es in der import-Zeile und in der Zeile, die den Sensor erzeugt. Das Beispiel öffnet I2C-Bus 0 mit SCL auf Pin 22 und SDA auf Pin 21; passen Sie diese an Ihren Controller an.
Der Beispielcode
# 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)
🔗Das vollständige Beispiel öffnen
Examples/electrochemical-calibrateSensor.py im Commit 623e1e6
Erwartetes Ergebnis:
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!
Danach gibt das Beispiel alle 2,5 Sekunden eine Zeile aus, die mit Sensor reading: beginnt, gefolgt von der Konzentration in ppb mit fünf Nachkommastellen. Schlägt begin() fehl, gibt es ERROR: Can't init the sensor! Check connections! aus und wartet in einer Schleife.
Verwendete Funktionen
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErzeugt das Sensorobjekt. Mit einem config_pin setzt es diesen Pin zusätzlich als Ausgang und schaltet ihn auf High. Über I2C wird nichts gesendet, bis Sie begin() aufrufen.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
SensorConfig | sensor_type | Das Preset der Zelle. SENSOR_NO2 ist das Preset 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 auf den Pins 22 (SCL) und 21 (SDA) beim ESP32-Port, scl=Pin(5), sda=Pin(4) beim ESP8266-Port. Bei einem nicht erkannten Port löst es Board not recognized, please pass an I2C object manually aus. |
int | adc_addr | Die Adresse, mit der begin() kommuniziert, standardmäßig 0x49; das Beispiel übergibt 0x49. Von 0x30 bis 0x37 sendet das Modul seine Befehle an den ATtiny404; von 0x48 bis 0x4B adressiert es den ADS1115 unter adc_addr und den LMP91000 direkt. |
int | config_pin | GPIO-Nummer für den Enable-Pin des LMP91000 (LMPEN), nur bei 0x48 bis 0x4B verwendet. Standardmäßig None; das Beispiel übergibt 32. |
sensor.begin()returns boolStartet den Sensor und schreibt das Preset in ihn. Bei 0x30 bis 0x37 prüft es, ob der ATtiny404 antwortet, und sendet dann Verstärkung und Datenrate des ADC sowie die Konfiguration des LMP91000; jeder Schritt wird wiederholt, bis das Board antwortet oder 500 ms vergangen sind. Bei 0x48 bis 0x4B prüft es, ob der ADS1115 bei adc_addr in einem I2C-Scan erscheint, stellt dessen Verstärkung und seine langsamste Datenrate ein und schreibt die Konfiguration an den LMP91000 bei 0x48, wobei es config_pin auf Low zieht. Rufen Sie es einmal vor dem Lesen auf.
ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.
sensor.setCustomZeroCalibration(calibration)returns NoneSetzt den Kalibrierungs-Offset, den getPPM() zur gemessenen Spannung addiert, bevor daraus eine Konzentration berechnet wird. Es ändert diesen Wert im Preset-Objekt, das Sie beim Erzeugen des Sensors übergeben haben.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
float | calibration | Der Offset in Volt. Das Beispiel übergibt CUSTOM_CALIBRATION. |
sensor.getPPB()returns floatFührt eine neue Messung durch und gibt die Gaskonzentration in parts per billion zurück: getPPM() mal 1000, mit angewendetem Kalibrierungs-Offset.
ReturnsDie Gaskonzentration in ppb.
Alles zusammen
Das Beispiel erzeugt zuerst den I2C-Bus und übergibt ihn an den Sensor. Es ruft begin() auf und bleibt in einer Schleife stehen, wenn das fehlschlägt. Dann setzt es den Offset mit setCustomZeroCalibration() vor der ersten Messung, sodass jeder ausgegebene Wert ihn bereits enthält. Jeder Durchlauf der Hauptschleife ruft getPPB() auf, gibt den Wert mit fünf Nachkommastellen aus und wartet 2,5 Sekunden.