Zum Hauptinhalt springen

Eigene Sensorkonfiguration verwenden

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-customConfig.py des Moduls erstellt eine eigene SensorConfig, statt ein Preset zu verwenden, legt den Sensor damit an und gibt alle 2,5 Sekunden die Gaskonzentration in ppb (parts per billion) aus.

Der Kommentar über SENSOR_CUSTOM listet auf, was die einzelnen Werte festlegen; passen Sie sie an das Datenblatt Ihres Sensors an. Für die SGX-4NO2-Zelle dieses Boards verwendet das Preset SENSOR_NO2 des Moduls nano_amperes_per_ppm=-600.0 und internal_zero_calibration=0 sowie für alles andere dieselben Werte wie dieses Beispiel. Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21; ändern Sie sie passend zu Ihrem Controller.

Der Beispielcode​

# FILE: electrochemical-customConfig.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Custom LMP91000 configuration example for any electrochemical sensor.
# LAST UPDATED: 2026-05-21

# Connecting diagram:
#
# Qwiic------------------------>Qwiic
# LMPEN------------------------>GPIO pin (see config_pin parameter below)

from machine import I2C, Pin
import time
from ElectrochemicalGasSensor import (
ElectrochemicalGasSensor, SensorConfig,
TIA_GAIN_35_KOHM, RLOAD_10_OHM, REF_EXTERNAL,
INTERNAL_ZERO_67_PERCENT, BIAS_SIGN_NEGATIVE, BIAS_0_PERCENT,
FET_SHORT_DISABLED, OP_MODE_3LEAD_AMP_CELL,
)
from ads1115 import ADS_GAIN_2_048V

# Custom sensor configuration — edit these values to match your sensor's datasheet.
#
# nanoAmperesPerPPM: Sensitivity from the sensor datasheet (nA/PPM)
# internalZeroCalibration: Voltage offset added to zero the reading in clean air
# adsGain: ADS1115 full-scale range (ADS_GAIN_6_144V .. ADS_GAIN_0_256V)
# tia_gain: TIA feedback resistor (TIA_GAIN_2_75_KOHM .. TIA_GAIN_350_KOHM)
# rload: Load resistor (RLOAD_10_OHM .. RLOAD_100_OHM)
# ref_source: Reference voltage source (REF_INTERNAL / REF_EXTERNAL)
# internal_zero: Internal zero percentage (INTERNAL_ZERO_20/50/67_PERCENT or _BYPASSED)
# bias_sign: Bias polarity (BIAS_SIGN_NEGATIVE / BIAS_SIGN_POSITIVE)
# bias: Bias percentage of Vref (BIAS_0_PERCENT .. BIAS_24_PERCENT)
# fet_short: FET short (FET_SHORT_DISABLED / FET_SHORT_ENABLED)
# op_mode: Operating mode (OP_MODE_3LEAD_AMP_CELL for normal operation)
SENSOR_CUSTOM = SensorConfig(
nano_amperes_per_ppm=-1000.0,
internal_zero_calibration=-0.0012,
ads_gain=ADS_GAIN_2_048V,
tia_gain=TIA_GAIN_35_KOHM,
rload=RLOAD_10_OHM,
ref_source=REF_EXTERNAL,
internal_zero=INTERNAL_ZERO_67_PERCENT,
bias_sign=BIAS_SIGN_NEGATIVE,
bias=BIAS_0_PERCENT,
fet_short=FET_SHORT_DISABLED,
op_mode=OP_MODE_3LEAD_AMP_CELL,
)

# Initialize I2C
i2c = I2C(0, scl=Pin(22), sda=Pin(21))

sensor = ElectrochemicalGasSensor(SENSOR_CUSTOM, i2c)

# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Custom Config Example")

if not sensor.begin():
print("ERROR: Can't init the sensor! Check connections!")
while True:
time.sleep_ms(100)

print("Sensor initialized successfully!")

# -------------------------------------------------------------------------
# Main loop
# -------------------------------------------------------------------------
while True:
reading = sensor.getPPB()

print("Sensor reading: {:.5f} PPB".format(reading))

time.sleep_ms(2500)

🔗Vollständiges Beispiel öffnen

Examples/electrochemical-customConfig.py im Commit 623e1e6

→

Erwartetes Ergebnis:

ShellMicroPython
Electrochemical Gas Sensor - Custom Config Example
Sensor initialized successfully!

Danach gibt das Beispiel alle 2,5 Sekunden eine Zeile aus, die mit Sensor reading: beginnt, gefolgt von der Konzentration in ppb mit fünf Nachkommastellen. Schlägt begin() fehl, gibt es ERROR: Can't init the sensor! Check connections! aus und wartet in einer Schleife.

Verwendete Funktionen​

SensorConfig(nano_amperes_per_ppm, internal_zero_calibration, ads_gain, tia_gain, rload, ref_source, internal_zero, bias_sign, bias, fet_short, op_mode)returns SensorConfig

Enthält die Einstellungen für eine elektrochemische Zelle: ihre Empfindlichkeit, den Nullpunkt-Offset, den Bereich des ADS1115 und die Front-End-Einstellungen des LMP91000. Auch die Presets des Moduls, etwa SENSOR_NO2, sind SensorConfig-Objekte.

ReturnsDas Konfigurationsobjekt, das an ElectrochemicalGasSensor übergeben wird.

Parameter

TypNameBeschreibung
floatnano_amperes_per_ppmDie Empfindlichkeit der Zelle in nA pro ppm, aus ihrem Datenblatt.
floatinternal_zero_calibrationOffset in Volt, den getPPM() zur gemessenen Spannung addiert.
intads_gainDer Vollausschlagsbereich des ADS1115, einer von ADS_GAIN_6_144V, ADS_GAIN_4_096V, ADS_GAIN_2_048V, ADS_GAIN_1_024V, ADS_GAIN_0_512V, ADS_GAIN_0_256V aus ads1115.py.
inttia_gainDer Rückkopplungswiderstand des Transimpedanzverstärkers (TIA) des LMP91000, TIA_GAIN_2_75_KOHM bis TIA_GAIN_350_KOHM oder TIA_GAIN_EXTERNAL.
intrloadDer Lastwiderstand, RLOAD_10_OHM, RLOAD_33_OHM, RLOAD_50_OHM oder RLOAD_100_OHM.
intref_sourceDie Quelle der Referenzspannung, REF_INTERNAL oder REF_EXTERNAL.
intinternal_zeroDer interne Nullpunkt, INTERNAL_ZERO_20_PERCENT, INTERNAL_ZERO_50_PERCENT, INTERNAL_ZERO_67_PERCENT oder INTERNAL_ZERO_BYPASSED.
intbias_signDie Polarität der Vorspannung, BIAS_SIGN_NEGATIVE oder BIAS_SIGN_POSITIVE.
intbiasDie Vorspannung als Prozentsatz der Referenz, BIAS_0_PERCENT bis BIAS_24_PERCENT.
intfet_shortDer FET-Kurzschluss, FET_SHORT_DISABLED oder FET_SHORT_ENABLED.
intop_modeDer Betriebsmodus des LMP91000. OP_MODE_3LEAD_AMP_CELL ist der Normalbetrieb.
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Erstellt das Sensorobjekt. Mit einem config_pin setzt es diesen Pin außerdem als Ausgang und legt ihn auf High. Über I2C wird nichts gesendet, bis Sie begin() aufrufen.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
SensorConfigsensor_typeDie Einstellungen der Zelle: ein Preset oder Ihre eigene SensorConfig. Das Beispiel übergibt SENSOR_CUSTOM.
I2Ci2cDer I2C-Bus. Bei None wählt das Modul die Pins anhand des von MicroPython gemeldeten Ports: I2C-Bus 0 an Pin 22 (SCL) und 21 (SDA) beim ESP32-Port, scl=Pin(5), sda=Pin(4) beim ESP8266-Port. Bei einem Port, den es nicht erkennt, löst es Board not recognized, please pass an I2C object manually aus.
intadc_addrDie Adresse, mit der begin() kommuniziert, standardmäßig 0x49. Von 0x30 bis 0x37 sendet das Modul seine Befehle an den ATtiny404; von 0x48 bis 0x4B spricht es den ADS1115 unter adc_addr und den LMP91000 direkt an. Das Beispiel belässt den Standardwert.
intconfig_pinGPIO-Nummer für den Enable-Pin des LMP91000 (LMPEN), nur bei 0x48 bis 0x4B verwendet. Standardmäßig None; das Beispiel übergibt keinen.
sensor.begin()returns bool

Startet den Sensor und schreibt die Konfiguration hinein. Bei 0x30 bis 0x37 prüft es, ob der ATtiny404 antwortet, und sendet dann die ADC-Verstärkung und die Datenrate sowie die LMP91000-Konfiguration, wobei jeder Schritt wiederholt wird, bis das Board antwortet oder 500 ms vergangen sind. Bei 0x48 bis 0x4B prüft es, ob der ADS1115 bei adc_addr in einem I2C-Scan erscheint, stellt dessen Verstärkung und die langsamste Datenrate ein und schreibt die Konfiguration bei 0x48 in den LMP91000. Rufen Sie es einmal vor dem Lesen auf.

ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.

sensor.getPPB()returns float

Führt eine neue Messung durch und gibt die Gaskonzentration in parts per billion zurück: den Messwert in ppm, berechnet mit der Empfindlichkeit, der TIA-Verstärkung und dem internen Nullpunkt Ihrer Konfiguration, multipliziert mit 1000. Ein negatives Ergebnis wird als 0.0 zurückgegeben.

ReturnsDie Gaskonzentration in ppb.

Zusammenfassung​

Das Beispiel erstellt zuerst SENSOR_CUSTOM und dann den I2C-Bus und damit den Sensor. begin() schreibt den ADC-Bereich und die Front-End-Einstellungen der Konfiguration; gibt es False zurück, gibt das Beispiel den Fehler aus und bleibt in einer Schleife. Jeder Durchlauf der Hauptschleife ruft getPPB() auf, gibt den Wert mit fünf Nachkommastellen aus und wartet 2,5 Sekunden.