Nullpunktkalibrierung
Was dieses Beispiel zeigt
Das Beispiel electrochemical-calibrateSensor.py wendet mit setCustomZeroCalibration() einen Offset zur Nullpunktkalibrierung an und gibt anschließend alle 2,5 Sekunden die Gaskonzentration in Parts per Billion (ppb) aus.
Der Offset ist CUSTOM_CALIBRATION am Anfang des Skripts, im Beispiel 0. Der Kommentar im Beispiel erklärt die Verwendung: Der Wert wird zur vom ADC gelesenen Spannung addiert, und in Luft ohne das Zielgas stellen Sie ihn so ein, dass die Anzeige gerade eben 0 ppb beträgt.
Ändern Sie vor dem Ausführen SENSOR_O3 in der import-Zeile und in der Zeile, die den Sensor erzeugt, in SENSOR_CO. SENSOR_O3 ist die Voreinstellung des Moduls für die Ozonzelle. Dieses Board trägt die Kohlenmonoxidzelle SGX-4CO, und die Voreinstellung des Moduls dafür ist SENSOR_CO. Der Offset wird addiert, bevor das Modul mit Empfindlichkeit und Nullpunkt der Voreinstellung umrechnet. Stellen Sie ihn daher mit SENSOR_CO ein: Ein mit der Ozon-Voreinstellung ermittelter Offset stellt diese Zelle nicht auf null.
Das Beispiel öffnet den I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie diese auf die I2C-Pins Ihres Controllers, falls sie abweichen.
Was es auf diesem Board braucht
Das Beispiel erzeugt den Sensor mit adc_addr=0x49 und config_pin=32. Bei einer Adresse außerhalb von 0x30 bis 0x37 läuft das Modul nicht über die Bridge des Boards: begin() sucht den ADS1115 mit einem I2C-Scan unter dieser Adresse und schreibt dann die Konfiguration des LMP91000 an 0x48, beides auf dem Bus, den Sie übergeben. Auf diesem Board liegen diese beiden Chips am internen Bus, den die obere Stiftleiste als SDA2 und SCL2 herausführt. Die Qwiic-Connectors und SDA1/SCL1 erreichen nur die Bridge mit dem ATtiny404, und ein I2C-Scan über Qwiic findet nur die Bridge, im Auslieferungszustand bei 0x30.
Verdrahten Sie daher für dieses Beispiel die obere Stiftleiste und nicht das Qwiic-Kabel: Verbinden Sie SDA Ihres Controllers mit SDA2, SCL mit SCL2, den 3,3-V-Pin mit 3V3 und GND mit GND. Das Anschlussdiagramm im Listing zeigt eine Qwiic-Leitung, aber über Qwiic antwortet nur die Bridge.
Das Modul setzt Pin 32 auf Low, während es die Konfiguration des Frontends schreibt, sonst auf High, und der Anschlusskommentar im Beispiel verbindet diesen Pin mit LMPEN. Auf dem Board liegt LMPEN an der unteren Stiftleiste, ist über 10 kΩ nach GND gezogen und zusätzlich mit dem ATtiny404 verbunden; siehe
Hardware-Details.
Die Adresse der Bridge, 0x30 bis 0x37, ist die, die das Beispiel CO-Konzentration auslesen übergibt.
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)
Die folgenden Zeilen stammen aus einem Lauf dieses Beispiels auf diesem Board, wobei der Controller wie oben beschrieben mit den Pins SDA2, SCL2, 3V3 und GND der Stiftleiste verbunden war.
Erwartetes Ergebnis in der Thonny-Shell:
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!
Sensor reading: 291.45891 PPB
Sensor reading: 314.34645 PPB
Sensor reading: 300.00720 PPB
Sensor reading: 318.97074 PPB
Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration in ppb mit fünf Nachkommastellen und PPB. Ein Ergebnis unter null wird als 0.00000 ausgegeben.
Schlägt begin() fehl, zeigt die Shell
ERROR: Can't init the sensor! Check connections!, und das Skript stoppt dort.
Verwendete Funktionen
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErzeugt das Sensorobjekt. Das Beispiel übergibt die Voreinstellung, den I2C-Bus, adc_addr=0x49 und config_pin=32.
ReturnsDas Sensorobjekt.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Die Voreinstellung der Zelle. Für die SGX-4CO-Zelle dieses Boards ist die Voreinstellung des Moduls SENSOR_CO. |
i2c | machine.I2C | Ein initialisierter I2C-Bus. Mit None öffnet das Modul I2C 0 an den Pins 22 und 21 bei einem ESP32 oder an den Pins 5 und 4 bei einem ESP8266 und löst bei jedem anderen Board Board not recognized, please pass an I2C object manually aus. |
adc_addr | int | Die I2C-Adresse. Standard 0x49. Von 0x30 bis 0x37 spricht das Modul mit der ATtiny404-Bridge des Boards. |
config_pin | int oder None | Ein GPIO, den das Modul auf Low setzt, während es die Konfiguration des Frontends sendet, und sonst auf High. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. Standard None. |
begin()returns boolStartet den Sensor. Bei einer adc_addr von 0x30 bis 0x37 prüft es, ob die Bridge antwortet, sendet ihr die ADC-Verstärkung und Datenrate aus der Voreinstellung und danach die Konfiguration des Frontends, wobei ein Busfehler bei jedem Schritt bis zu einem Timeout von 500 ms wiederholt wird. Bei jeder anderen adc_addr prüft es, ob der ADC unter dieser Adresse antwortet, stellt dessen Verstärkung und Datenrate ein und schreibt dann die Konfiguration des Frontends, während config_pin auf Low gehalten wird.
ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.
setCustomZeroCalibration(calibration)returns NoneSetzt den Offset für die Nullpunktkalibrierung. getPPM() und getPPB() addieren ihn in Volt zur gemessenen Spannung, nachdem der interne Nullpunkt abgezogen wurde und bevor in eine Konzentration umgerechnet wird. Er wird im Voreinstellungsobjekt gespeichert, das dem Konstruktor übergeben wurde.
ReturnsNichts.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
calibration | float | Der Offset in Volt. Das Beispiel übergibt CUSTOM_CALIBRATION, also 0. |
getPPB()returns floatFührt eine Messung durch und gibt sie in Parts per Billion zurück. Der Kommentar im Beispiel empfiehlt, auf getPPM() zu wechseln, falls ppm besser passt.
ReturnsgetPPM() multipliziert mit 1000.
Zusammenfügen
Erzeugen Sie das Objekt mit SENSOR_CO, der Voreinstellung für die Zelle dieses Boards, rufen Sie begin() einmal auf und prüfen Sie das Ergebnis. Rufen Sie dann setCustomZeroCalibration() mit Ihrem Offset auf, bevor Sie mit dem Lesen beginnen. In Luft ohne das Zielgas ändern Sie CUSTOM_CALIBRATION und führen das Skript erneut aus, bis die Anzeige gerade eben 0 ppb beträgt, wie es der Kommentar im Beispiel sagt.