Zum Hauptinhalt springen

Den Nullpunkt kalibrieren

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-calibrateSensor.py der Bibliothek addiert zu jedem ADC-Messwert einen festen Spannungsoffset, CUSTOM_CALIBRATION, bevor dieser in eine Konzentration umgerechnet wird. Stellen Sie diesen Wert in Luft ohne das Zielgas so ein, dass der Messwert gerade eben 0 beträgt.

Das Beispiel erzeugt den Sensor mit dem Ozonzellen-Preset SENSOR_O3 bei adc_addr=0x49 mit config_pin=32. SENSOR_SO2 ist das Preset der Bibliothek für die SO2-Zelle dieses Boards: Ändern Sie SENSOR_O3 in der import-Zeile und in der Zeile, die sensor erzeugt, in SENSOR_SO2, um SO2-Werte zu erhalten. Das Skript erstellt den I2C-Bus an GPIO 22 (SCL) und GPIO 21 (SDA); ändern Sie diese Nummern, wenn Ihr Board andere Pins verwendet.

Auf diesem Board sitzen der LMP91000 und der ADS1115 am boardeigenen Bus 2, und Ihr Controller erreicht sie über die Adresse des Boards am Qwiic-Bus: 0x30 im Auslieferungszustand, 0x30 bis 0x37 mit dem ADDRESS-Schalter. Das adc_addr=0x49 des Beispiels spricht einen ADS1115 direkt an. Übergeben Sie stattdessen die Adresse des Boards, zum Beispiel sensor = ElectrochemicalGasSensor(SENSOR_SO2, i2c, adc_addr=0x30). Wo das Anschlussdiagramm sagt, dass LMPEN an GPIO 32 geht, ist LMPEN auf diesem Board bereits über einen 10-kΩ-Widerstand auf GND gelegt und führt außerdem zum Mikrocontroller auf dem Board; bei den Adressen des Boards verwendet das Modul config_pin nicht (siehe Hardware-Details).

Das Listing ist die Datei der Bibliothek beim festgelegten Commit, abgesehen von zwei Zeilen, die nur Kommentare enthalten, auf ein anderes Soldered-Produkt verweisen oder im Anschlussdiagramm ein Controller-Board nennen und weggelassen wurden.

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

electrochemical-calibrateSensor.py beim festgelegten Commit

→

Erwartetes Ergebnis:

ShellMicroPython
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!

Danach folgt alle 2,5 Sekunden eine Zeile Sensor reading: in ppb.

Verwendete Funktionen​

ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Erzeugt das Sensorobjekt aus einem Zellen-Preset, einem I2C-Objekt, einer Adresse und einem optionalen Enable-Pin. Das Beispiel übergibt adc_addr=0x49 und config_pin=32.

ReturnsDas Sensorobjekt.

Parameter

ParameterTypBeschreibung
sensor_typeSensorConfigDas Zellen-Preset. SENSOR_SO2 ist das Preset für die Zelle dieses Boards.
i2cI2CEin initialisiertes machine.I2C-Objekt.
adc_addrintDie Adresse, mit der das Modul kommuniziert. 0x30 bis 0x37 wählt den Bridge-Modus des Moduls, der mit dem Mikrocontroller auf dem Board kommuniziert; jeder andere Wert spricht einen ADS1115 direkt unter dieser Adresse an. Standard 0x49.
config_pinintGPIO für die Enable-Leitung des LMP91000. Wird bei den Adressen 0x30 bis 0x37 nicht verwendet. Standard None.
begin()returns bool

Prüft, ob das Board antwortet, und sendet die ADC- und LMP91000-Einstellungen aus dem Preset an das Board.

ReturnsTrue, wenn das Board geantwortet und alle Einstellungen übernommen hat, sonst False.

setCustomZeroCalibration(calibration)returns None

Legt den Spannungsoffset fest, der vor der Umrechnung in eine Konzentration zu jedem Messwert addiert wird. Er ersetzt den eigenen Nullpunkt-Kalibrierwert des Presets, der für SENSOR_SO2 0 beträgt.

ReturnsNichts.

Parameter

ParameterTypBeschreibung
calibrationfloatDer Offset in Volt.
getPPB()returns float

Lässt das Board einen ADC-Messwert aufnehmen und gibt die Konzentration in Parts per Billion (ppb) zurück, einschließlich des Offsets der Nullpunktkalibrierung. Ein Ergebnis unter null wird als 0 zurückgegeben.

ReturnsGaskonzentration in ppb.

getPPM()returns float

Derselbe Messwert in ppm. Das Beispiel nennt ihn in einem Kommentar als Alternative.

ReturnsGaskonzentration in ppm.

Zusammenfassung​

Bringen Sie das Board in Luft ohne SO2 und führen Sie das Skript mit CUSTOM_CALIBRATION = 0 aus. Ändern Sie den Wert, bis der Messwert gerade eben 0 beträgt, und verwenden Sie denselben Wert dann mit setCustomZeroCalibration() in Ihrem eigenen Skript.