Nullpunktkalibrierung
Was dieses Beispiel zeigt
Das Beispiel electrochemical-calibrateSensor.py addiert zu jedem Messwert einen festen Spannungsoffset,
CUSTOM_CALIBRATION, und gibt die Messwerte anschließend alle 2,5
Sekunden in PPB aus. Es erzeugt den Sensor mit adc_addr=0x49 und config_pin=32.
Der Kommentar im Beispiel selbst beschreibt, wie der Offset zu verwenden ist: Passen Sie CUSTOM_CALIBRATION an, solange keines der Zielgase vorhanden ist,
bis der Messwert knapp über 0
PPB liegt. Der Startwert ist 0, das addiert nichts.
Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie
diese auf die Pins, die der Qwiic-Connector Ihres Controllers oder Ihre Verdrahtung verwendet.
Sie müssen LMPEN bei diesem Board nicht mit Pin 32 verbinden, was auch immer die
Kommentare im Beispiel sagen: Das Board legt ihn selbst auf Low.
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)
🔗Vollständiges Beispiel öffnen
Examples/electrochemical-calibrateSensor.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 erzeugt wurde, der Adresse, die dieses
Beispiel übergibt. Schlägt begin() fehl, gibt das Beispiel nach der Titelzeile
ERROR: Can't init the sensor! Check connections! aus
und bleibt dort stehen.
Wenn begin() erfolgreich ist, zeigt die Shell:
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!
Danach folgt alle 2,5 Sekunden eine Zeile Sensor reading: mit einem Wert mit fünf Nachkommastellen
und PPB.
Verwendete Funktionen
I2C(id, scl, sda)returns I2CErzeugt 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 ElectrochemicalGasSensorErzeugt das Sensorobjekt. Es wird nichts an das Board gesendet, bis Sie begin() aufrufen. Das Beispiel übergibt die Sensorkonfiguration, den Bus, adc_addr=0x49 und config_pin=32.
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 auf Boards, die es kennt (ESP32: Bus 0, SCL 22, SDA 21; ESP8266: SCL 5, SDA 4), und löst andernfalls eine Exception aus. |
int | adc_addr | Die Adresse, mit der das Modul kommuniziert, standardmäßig und in diesem Beispiel 0x49. Eine Adresse von 0x30 bis 0x37 lässt begin() die Bridge-Befehle verwenden; jede andere Adresse wird als eigene Adresse des ADS1115 aufgefasst. |
int | config_pin | Ein GPIO-Pin, den das Modul auf High hält und auf Low zieht, während es die LMP91000-Einstellungen schreibt, in diesem Beispiel 32. 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 an dieser Adresse mit derselben Verstärkung und Datenrate ein und schreibt die LMP91000-Einstellungen direkt, wobei es config_pin auf Low zieht, sofern eines angegeben ist.
ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.
sensor.setCustomZeroCalibration(calibration)returns NoneSetzt den Nullpunktoffset in Volt, den getPPM() zur gemessenen Spannung addiert. Der Wert wird in das Sensorkonfigurationsobjekt geschrieben, das Sie dem Konstruktor übergeben haben, im Beispiel SENSOR_O3.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
float | calibration | Der Offset in Volt, im Beispiel CUSTOM_CALIBRATION. |
sensor.getPPB()returns floatNimmt einen Messwert auf und gibt ihn in Parts per Billion zurück: den Wert von getPPM() multipliziert mit 1000. getPPM() subtrahiert den internen Nullpunkt (einen Anteil der 2,5-V-Referenz des Boards), addiert den Nullpunktoffset, dividiert durch die TIA-Verstärkung und durch die Nanoampere pro PPM der Konfiguration und gibt bei einem negativen Ergebnis 0.0 zurück.
ReturnsDie Konzentration in PPB.
Zusammenfassung
SENSOR_O3 ist die Voreinstellung für eine Ozonzelle SGX-403-20. Für die Sauerstoffzelle SGX-4OX-ROHS dieses Boards hat das Modul noch keine
Voreinstellung, daher wird der Wert, den das Beispiel
ausgibt, mit den Einstellungen der Ozonzelle berechnet. Die Seite
Benutzerdefinierte Konfiguration
zeigt, wie Sie eine eigene schreiben; ihr Feld internal_zero_calibration setzt
denselben Offset, wenn die Konfiguration erstellt wird.