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:
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 SensorConfigEnthä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
| Name | Typ | Beschreibung |
|---|---|---|
nano_amperes_per_ppm | float | Die Empfindlichkeit der Zelle in nA pro PPM, aus ihrem Datenblatt. Die NO2- und O3-Voreinstellungen der Bibliothek verwenden negative Werte. |
internal_zero_calibration | float | Ein Spannungsoffset, der zu jeder Messung addiert wird; derselbe Wert, den setCustomZeroCalibration() setzt. |
ads_gain | int | Der 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_gain | int | Der 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. |
rload | int | Der Lastwiderstand: RLOAD_10_OHM, RLOAD_33_OHM, RLOAD_50_OHM oder RLOAD_100_OHM. |
ref_source | int | Die Referenz: REF_INTERNAL oder REF_EXTERNAL. |
internal_zero | int | Der interne Nullpunkt als Anteil der Referenz: INTERNAL_ZERO_20_PERCENT, INTERNAL_ZERO_50_PERCENT, INTERNAL_ZERO_67_PERCENT oder INTERNAL_ZERO_BYPASSED. |
bias_sign | int | Die Polarität der Vorspannung: BIAS_SIGN_NEGATIVE oder BIAS_SIGN_POSITIVE. |
bias | int | Die Vorspannung als Anteil der Referenz, von BIAS_0_PERCENT bis BIAS_24_PERCENT. |
fet_short | int | FET_SHORT_DISABLED oder FET_SHORT_ENABLED. |
op_mode | int | Der 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 ElectrochemicalGasSensorErstellt 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
| Name | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Hier das eigene SENSOR_CUSTOM des Beispiels. |
i2c | machine.I2C | Der 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_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 interpretiert. 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 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 boolRichtet 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 floatNimmt 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.