Eigene Front-End-Einstellungen verwenden
Was dieses Beispiel zeigt
Das Beispiel electrochemical-customConfig.py erstellt mit SensorConfig eine eigene Voreinstellung, statt eine der Voreinstellungen des Moduls zu verwenden. Eine Voreinstellung enthält die Empfindlichkeit der Zelle, den ADC-Bereich und alle Front-End-Einstellungen des LMP91000. So können Sie andere Werte für eine Zelle ausprobieren. Anschließend gibt das Beispiel alle 2,5 Sekunden einen Messwert in ppb (parts per billion) aus.
Das Beispiel erstellt den Sensor nur mit der Voreinstellung und dem I2C-Bus, sodass das Modul seine Standardadresse 0x49 verwendet. Es öffnet den I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21; ändern Sie diese Pinnummern auf die I2C-Pins Ihres Controllers, falls diese abweichen. Bei 0x49 kommuniziert das Modul direkt mit dem ADS1115 und dem LMP91000, nicht über die ATtiny404-Brücke des Boards, und die Kommentare des Beispiels verlangen, dass LMPEN mit einem GPIO verbunden ist. In der
Bibliotheksübersicht
steht, wie die Adresse darüber entscheidet.
SENSOR_CUSTOM im Beispiel enthält dieselben Werte wie die Ozon-Voreinstellung des Moduls, SENSOR_O3. Für die Zelle SGX-4NO-250 dieses Boards verwendet die Voreinstellung SENSOR_NO des Moduls die Werte in der folgenden Tabelle.
| Feld | Wert SENSOR_NO |
|---|---|
nano_amperes_per_ppm | 400.0 |
internal_zero_calibration | 0 |
ads_gain | ADS_GAIN_4_096V |
tia_gain | TIA_GAIN_120_KOHM |
rload | RLOAD_10_OHM |
ref_source | REF_EXTERNAL |
internal_zero | INTERNAL_ZERO_20_PERCENT |
bias_sign | BIAS_SIGN_POSITIVE |
bias | BIAS_12_PERCENT |
fet_short | FET_SHORT_DISABLED |
op_mode | OP_MODE_3LEAD_AMP_CELL |
Der Beispielcode
Das Listing ist die Datei des Moduls beim festgelegten Commit. Nur Kommentarzeilen wurden weggelassen: die Kopfzeile, die die Shopseite eines anderen Produkts nennt, und die Zeile mit dem Anschlussdiagramm, die ein altes Board nennt.
# 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 beim Commit 623e1e6
Erwartetes Ergebnis, wenn SENSOR_CUSTOM auf die Werte von SENSOR_NO gesetzt ist (Messwerte in sauberer Luft; Ihre werden abweichen):
Electrochemical Gas Sensor - Custom Config Example
Sensor initialized successfully!
Sensor reading: 5.83691 PPB
Sensor reading: 6.04365 PPB
Sensor reading: 6.00634 PPB
Sensor reading: 5.94344 PPB
Alle 2,5 Sekunden erscheint eine Zeile Sensor reading: mit
der Konzentration in ppb auf fünf Nachkommastellen und am Ende PPB. Antwortet das Board nicht, gibt das Beispiel
ERROR: Can't init the sensor! Check connections! aus und bleibt 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 SensorConfigEnthält die Einstellungen für eine Zelle. Auch die Voreinstellungen des Moduls, etwa SENSOR_NO, sind SensorConfig-Objekte. begin() sendet die Front-End-Felder an den LMP91000 und die ADC-Verstärkung an den ADS1115; getPPM() verwendet die Empfindlichkeit und die Nullpunktkalibrierung.
ReturnsDie Voreinstellung, die Sie an ElectrochemicalGasSensor übergeben.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
float | nano_amperes_per_ppm | Die Empfindlichkeit der Zelle in nA pro ppm, im Beispiel -1000.0. |
float | internal_zero_calibration | Eine Spannung, die zu jedem Messwert addiert wird, im Beispiel -0.0012. |
int | ads_gain | Der Vollausschlagbereich des ADC, eine ADS_GAIN_*-Konstante aus ads1115, im Beispiel ADS_GAIN_2_048V. |
int | tia_gain | Die Verstärkung des Front-End-Verstärkers, TIA_GAIN_2_75_KOHM bis TIA_GAIN_350_KOHM (oder TIA_GAIN_EXTERNAL), im Beispiel TIA_GAIN_35_KOHM. |
int | rload | Der Lastwiderstand, RLOAD_10_OHM bis RLOAD_100_OHM, im Beispiel RLOAD_10_OHM. |
int | ref_source | REF_INTERNAL oder REF_EXTERNAL, im Beispiel REF_EXTERNAL. |
int | internal_zero | INTERNAL_ZERO_20_PERCENT, _50_PERCENT, _67_PERCENT oder INTERNAL_ZERO_BYPASSED, im Beispiel INTERNAL_ZERO_67_PERCENT. |
int | bias_sign | BIAS_SIGN_NEGATIVE oder BIAS_SIGN_POSITIVE, im Beispiel BIAS_SIGN_NEGATIVE. |
int | bias | BIAS_0_PERCENT bis BIAS_24_PERCENT, im Beispiel BIAS_0_PERCENT. |
int | fet_short | FET_SHORT_DISABLED oder FET_SHORT_ENABLED, im Beispiel FET_SHORT_DISABLED. |
int | op_mode | Der Modus des Front-Ends, im Beispiel OP_MODE_3LEAD_AMP_CELL. |
I2C(0, scl=Pin(22), sda=Pin(21))returns I2CErstellt den Hardware-I2C-Bus 0 an den angegebenen SCL- und SDA-Pins. machine.I2C und machine.Pin gehören zu MicroPython und sind nicht Teil des Soldered-Moduls (siehe docs.micropython.org, machine.I2C und machine.Pin).
ReturnsDas I2C-Busobjekt, das Sie an den Sensor übergeben.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | id | Der Hardware-I2C-Bus, im Beispiel 0. |
Pin | scl | Der Taktpin, im Beispiel Pin(22). |
Pin | sda | Der Datenpin, im Beispiel Pin(21). |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt das Sensorobjekt. Über I2C wird nichts gesendet, bis Sie begin() aufrufen. Mit i2c=None öffnet das Modul selbst einen Bus auf den Boards, die es erkennt, darunter ein ESP32, bei dem es I2C(0, scl=Pin(22), sda=Pin(21)) öffnet, und ein ESP8266, bei dem es I2C(scl=Pin(5), sda=Pin(4)) öffnet. Auf einem nicht erkannten Board löst es eine Exception aus.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
SensorConfig | sensor_type | Die Voreinstellung, im Beispiel SENSOR_CUSTOM. |
I2C | i2c | Der I2C-Bus, an dem das Board angeschlossen ist. |
int | adc_addr | Die I2C-Adresse. Im Beispiel weggelassen, daher gilt die Standardadresse des Moduls, 0x49. Bei 0x30 bis 0x37 kommuniziert das Modul mit der ATtiny404-Brücke des Boards; bei jeder anderen Adresse kommuniziert es mit dem ADS1115 unter dieser Adresse und direkt mit dem LMP91000. |
int | config_pin | Ein GPIO für LMPEN. Im Beispiel weggelassen (None), daher schaltet das Modul keinen Pin. |
sensor.begin()returns boolBei einer Adresse von 0x30 bis 0x37 prüft es, ob die Brücke des Boards antwortet, und sendet die ADC- und Front-End-Einstellungen darüber, wobei es bei jedem Schritt bis zu 500 ms wartet. Bei jeder anderen Adresse prüft es in einem I2C-Scan, ob der ADS1115 unter adc_addr antwortet, setzt die ADC-Verstärkung der Voreinstellung und die langsamste Datenrate und konfiguriert dann den LMP91000 bei 0x48 (Verstärkung, Last, Referenz, interner Nullpunkt, Bias und Modus). Dabei zieht es config_pin nur während dieser Konfiguration auf Low, sofern einer angegeben ist.
ReturnsTrue, wenn jeder Schritt erfolgreich war, andernfalls False.
sensor.getPPB()returns floatNimmt mit getPPM() einen Messwert auf und multipliziert ihn mit 1000. getPPM() liest ADC-Kanal 0 (bei 0x30 bis 0x37 führt die Brücke die Wandlung aus), subtrahiert den internen Nullpunkt (2,5 V mal den internen Nullpunkt-Prozentwert der Voreinstellung), addiert die Nullpunktkalibrierung und teilt dann durch die Verstärkung des Verstärkers und durch die nA pro ppm der Voreinstellung.
ReturnsDie Gaskonzentration in ppb. Ein negatives Ergebnis wird als 0.0 zurückgegeben.
Zusammenfassung
Die Voreinstellung besteht nur aus Daten: Erstellen Sie sie einmal, übergeben Sie sie dem Konstruktor, und begin() sendet ihre Front-End-Einstellungen, wenn es den Sensor startet. Um andere Werte auszuprobieren, bearbeiten Sie die Felder von SENSOR_CUSTOM und führen Sie das Beispiel erneut aus.