Zum Hauptinhalt springen

Eigene Zelle konfigurieren

Was dieses Beispiel zeigt​

Das Beispiel electrochemical-customConfig.py erstellt eine eigene SensorConfig, statt eine Voreinstellung zu verwenden, sodass Sie jeden Wert aus dem Datenblatt Ihrer Zelle festlegen können. Anschließend gibt es die Gaskonzentration alle 2,5 Sekunden in Parts per Billion (PPB) aus.

Verbinden Sie Ihren Controller für dieses Beispiel mit dem oberen Header, 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 in der Schnellstartanleitung.

Der Beispielcode​

Die Werte in SENSOR_CUSTOM entsprechen der Ozon-Voreinstellung der Bibliothek, SENSOR_O3. Ersetzen Sie sie durch die Empfindlichkeit Ihrer Zelle und die benötigten LMP91000-Einstellungen; der Kommentar oberhalb von SENSOR_CUSTOM nennt den Bereich jedes Werts. Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21.

Das Anschlussdiagramm in den Kommentaren des Beispiels verbindet LMPEN mit einem GPIO. Auf diesem Board führt LMPEN zum Header und zum ATtiny404 des Boards.

# 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

→

Die Shell zeigt:

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

Danach 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 machine-Modul von MicroPython selbst und time.sleep_ms() aus dessen time-Modul. ADS_GAIN_2_048V stammt aus dem Hilfsmodul ads1115.py der Bibliothek, die übrigen Konstanten aus ElectrochemicalGasSensor.py. Die folgenden Funktionen gehören zur Bibliothek.

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: die Werte, mit denen die Bibliothek eine Spannung in eine Konzentration umrechnet, und die Registerwerte, die sie an den ADS1115 und den LMP91000 sendet. Auch die Voreinstellungen wie SENSOR_O3 sind SensorConfig-Objekte.

ReturnsDas Konfigurationsobjekt, das als sensor_type an ElectrochemicalGasSensor() übergeben wird.

Parameter

NameTypBeschreibung
nano_amperes_per_ppmfloatDie Empfindlichkeit der Zelle in nA pro PPM, aus ihrem Datenblatt. Die NO2- und O3-Voreinstellungen der Bibliothek verwenden negative Werte.
internal_zero_calibrationfloatEin Spannungsoffset, der zu jeder Messung addiert wird; derselbe Wert, den setCustomZeroCalibration() setzt.
ads_gainintDer Messbereich des ADS1115: ADS_GAIN_6_144V, ADS_GAIN_4_096V, ADS_GAIN_2_048V, ADS_GAIN_1_024V, ADS_GAIN_0_512V oder ADS_GAIN_0_256V, aus ads1115.
tia_gainintDer Rückkopplungswiderstand des Verstärkers im LMP91000: TIA_GAIN_2_75_KOHM, TIA_GAIN_3_5_KOHM, TIA_GAIN_7_KOHM, TIA_GAIN_14_KOHM, TIA_GAIN_35_KOHM, TIA_GAIN_120_KOHM, TIA_GAIN_350_KOHM oder TIA_GAIN_EXTERNAL.
rloadintDer Lastwiderstand: RLOAD_10_OHM, RLOAD_33_OHM, RLOAD_50_OHM oder RLOAD_100_OHM.
ref_sourceintDie Referenz: REF_INTERNAL oder REF_EXTERNAL.
internal_zerointDer interne Nullpunkt als Anteil der Referenz: INTERNAL_ZERO_20_PERCENT, INTERNAL_ZERO_50_PERCENT, INTERNAL_ZERO_67_PERCENT oder INTERNAL_ZERO_BYPASSED.
bias_signintDie Polarität der Vorspannung: BIAS_SIGN_NEGATIVE oder BIAS_SIGN_POSITIVE.
biasintDie Vorspannung als Anteil der Referenz, von BIAS_0_PERCENT bis BIAS_24_PERCENT.
fet_shortintFET_SHORT_DISABLED oder FET_SHORT_ENABLED.
op_modeintDer Modus des LMP91000: OP_MODE_3LEAD_AMP_CELL für den Normalbetrieb oder OP_MODE_DEEP_SLEEP, OP_MODE_2LEAD_GROUND_CELL, OP_MODE_STANDBY, OP_MODE_TEMPERATURE_TIA_OFF, OP_MODE_TEMPERATURE_TIA_ON.
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Erstellt das Sensorobjekt für ein Board. Anhand von adc_addr entscheidet die Bibliothek, wie sie 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_typeSensorConfigHier das eigene SENSOR_CUSTOM des Beispiels.
i2cmachine.I2CDer I2C-Bus. Wird er weggelassen, öffnet die Bibliothek bei einem ESP32-Port I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21, bei einem ESP8266-Port I2C mit SCL an Pin 5 und SDA an Pin 4 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 interpretiert. 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 dann auf Low, wenn sie selbst die Register des LMP91000 schreibt; 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 Verstärkung, Last, Referenz, Vorspannung und Modus der Konfiguration. 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 schreiben; jeder Schritt wird nach 500 ms abgebrochen. Bei jeder anderen Adresse prüft sie per I2C-Scan, ob an adc_addr ein Gerät antwortet, und schreibt dann die Register des LMP91000 bei 0x48, sobald dessen Status bereit anzeigt.

ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.

getPPB()returns float

Nimmt eine Messung von Kanal 0 des ADS1115 auf (bei 0x30 bis 0x37 über die Bridge) und rechnet sie mit der Konfiguration in eine Konzentration um: Sie entfernt den internen Nullpunkt-Offset, addiert die Nullpunktkalibrierung, teilt durch die Verstärkung des Verstärkers und durch die Empfindlichkeit in nA pro PPM und multipliziert mit 1000. Ein negatives Ergebnis wird als 0 zurückgegeben.

ReturnsDie Gaskonzentration in PPB.

Zusammenfassung​

Erstellen Sie aus dem Datenblatt Ihrer Zelle eine SensorConfig und übergeben Sie sie an ElectrochemicalGasSensor(), wo Sie sonst eine Voreinstellung übergeben würden. begin() sendet die Einstellungen an den LMP91000, und getPPB() verwendet die Empfindlichkeit und die Nullpunktwerte für jede Messung.