Zum Hauptinhalt springen

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:

ShellMicroPython
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 ElectrochemicalGasSensor

Erstellt 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

NameTypBeschreibung
sensor_typeSensorConfigDas 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.
i2cmachine.I2CDer 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_addrintDie 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_pinintEine 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 bool

Richtet 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 None

Legt 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

NameTypBeschreibung
calibrationfloatDer Offset in Volt.
getPPB()returns float

Nimmt 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 float

Derselbe 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.