Den Nullpunkt kalibrieren
Was dieses Beispiel zeigt
Das Beispiel electrochemical-calibrateSensor.py addiert einen Nullpunkt-Offset zu
den Messwerten des Sensors und gibt die Gaskonzentration alle 2,5 Sekunden in Parts per Billion
(PPB) aus.
Verbinden Sie Ihren Controller für dieses Beispiel mit der oberen Stiftleiste, nicht mit einem Qwiic-
Connector: SDA des Controllers mit SDA2, SCL mit SCL2, die 3,3-V-Versorgung
mit 3V3 und Masse mit GND. Bei dieser Adresse kommuniziert die Bibliothek direkt über SDA2 und SCL2 mit dem ADS1115 und dem LMP91000; die ATtiny404-Bridge des Boards bei 0x30
wird nicht verwendet. Über
Qwiic funktioniert nur das Bridge-Beispiel im
Schnellstart.
Der Beispielcode
CUSTOM_CALIBRATION ist eine Spannung, die die Bibliothek zu jedem ADC-Messwert addiert. Wie der Kommentar des
Beispiels sagt, passen Sie sie in Luft ohne das Zielgas so an, bis
der Messwert gerade eben 0 PPB beträgt. Das Beispiel verwendet das Ozon-Preset, öffnet
I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21 und erstellt den Sensor
mit adc_addr=0x49 und config_pin=32.
Wie das Anschlussdiagramm in den Kommentaren des Beispiels zeigt, verbinden Sie den Pin
LMPEN des Boards an der Stiftleiste mit GPIO 32, dem config_pin des Beispiels. Auf diesem
Board führt LMPEN außerdem zum ATtiny404 des Boards.
# 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
Die Shell zeigt:
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!
Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration mit fünf
Nachkommastellen und PPB. Schlägt begin() fehl, gibt das Skript
ERROR: Can't init the sensor! Check connections! aus und wartet.
Verwendete Funktionen
I2C und Pin stammen aus dem eigenen Modul machine von MicroPython, und
time.sleep_ms() aus dessen Modul time. Die folgenden Funktionen gehören
zur Bibliothek.
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt das Sensorobjekt für ein Board. Die Bibliothek liest adc_addr, um zu entscheiden, wie sie mit ihm kommuniziert: Bei einer Adresse von 0x30 bis 0x37 verwendet sie das Protokoll der ATtiny404-Bridge; bei jeder anderen Adresse kommuniziert sie mit einem ADS1115 an dieser Adresse und selbst mit dem LMP91000 bei 0x48.
ReturnsDas Sensorobjekt.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Das Preset für Ihre Zelle: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 oder Ihre eigene SensorConfig. |
i2c | machine.I2C | Der I2C-Bus. Wenn er weggelassen wird, öffnet die Bibliothek I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21 bei einem ESP32-Port bzw. I2C mit SCL an Pin 5 und SDA an Pin 4 bei einem ESP8266-Port und löst bei jedem anderen Board eine Exception aus. |
adc_addr | int | Die Adresse, die begin() verwendet. 0x30 bis 0x37 wählt das Bridge-Protokoll; dieses Board antwortet werkseitig bei 0x30 oder bei der Adresse, die sein Schalter einstellt. Jeder andere Wert wird als ADS1115-Adresse verstanden. Der Standardwert ist 0x49. |
config_pin | int | Eine GPIO-Nummer für die Enable-Leitung des LMP91000. Die Bibliothek hält sie auf High und zieht sie nur auf Low, während sie selbst die Register des LMP91000 beschreibt; bei einer Adresse von 0x30 bis 0x37 wird sie nicht verwendet. Standardmäßig None. |
begin()returns boolRichtet die Verbindung für adc_addr ein und konfiguriert den LMP91000 mit dem Preset. Bei 0x30 bis 0x37 prüft sie, ob die Bridge antwortet, sendet die ADC-Verstärkung und lässt die Bridge die Register des LMP91000 beschreiben; jeder Schritt wird nach 500 ms abgebrochen. Bei jeder anderen Adresse prüft sie per I2C-Scan, ob ein Gerät bei adc_addr antwortet, und beschreibt dann die Register des LMP91000 bei 0x48, sobald dessen Status bereit anzeigt.
ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.
setCustomZeroCalibration(calibration)returns NoneLegt den Nullpunkt-Offset in Volt fest, den getPPM() und getPPB() nach dem Entfernen des internen Nullpunkts zu jedem Messwert addieren. Der Wert wird im Preset-Objekt gespeichert, das Sie dem Konstruktor übergeben haben, sodass ihn jeder mit demselben Preset erstellte Sensor ebenfalls verwendet.
ReturnsNichts.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
calibration | float | Der Offset in Volt. |
getPPB()returns floatNimmt einen Messwert von Kanal 0 des ADS1115 auf (bei 0x30 bis 0x37 über die Bridge) und rechnet ihn mit dem Preset in eine Konzentration um: Er entfernt den internen Nullpunkt-Offset, addiert die Nullpunktkalibrierung, teilt durch die Verstärkung des Verstärkers und durch die Empfindlichkeit der Zelle in nA pro PPM und multipliziert mit 1000. Ein negatives Ergebnis wird als 0 zurückgegeben.
ReturnsDie Gaskonzentration in PPB, getPPM() x 1000.
getPPM()returns floatDerselbe Messwert in Parts per Million. Der Kommentar des Beispiels nennt es als Alternative.
ReturnsDie Gaskonzentration in PPM.
Zusammenfassung
Erstellen Sie den Sensor und rufen Sie begin() auf. Rufen Sie dann vor dem Lesen setCustomZeroCalibration()
mit Ihrem Offset auf. Passen Sie den Offset in Luft ohne das Zielgas so an,
bis der Messwert gerade eben 0 beträgt. getPPM() gibt für jedes
negative Ergebnis 0 zurück, ein Messwert von genau 0 zeigt also nicht, wie weit der unkorrigierte Wert
unter null liegt.