Zum Hauptinhalt springen

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.

FeldWert SENSOR_NO
nano_amperes_per_ppm400.0
internal_zero_calibration0
ads_gainADS_GAIN_4_096V
tia_gainTIA_GAIN_120_KOHM
rloadRLOAD_10_OHM
ref_sourceREF_EXTERNAL
internal_zeroINTERNAL_ZERO_20_PERCENT
bias_signBIAS_SIGN_POSITIVE
biasBIAS_12_PERCENT
fet_shortFET_SHORT_DISABLED
op_modeOP_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):

ShellMicroPython
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 SensorConfig

Enthä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

TypNameBeschreibung
floatnano_amperes_per_ppmDie Empfindlichkeit der Zelle in nA pro ppm, im Beispiel -1000.0.
floatinternal_zero_calibrationEine Spannung, die zu jedem Messwert addiert wird, im Beispiel -0.0012.
intads_gainDer Vollausschlagbereich des ADC, eine ADS_GAIN_*-Konstante aus ads1115, im Beispiel ADS_GAIN_2_048V.
inttia_gainDie 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.
intrloadDer Lastwiderstand, RLOAD_10_OHM bis RLOAD_100_OHM, im Beispiel RLOAD_10_OHM.
intref_sourceREF_INTERNAL oder REF_EXTERNAL, im Beispiel REF_EXTERNAL.
intinternal_zeroINTERNAL_ZERO_20_PERCENT, _50_PERCENT, _67_PERCENT oder INTERNAL_ZERO_BYPASSED, im Beispiel INTERNAL_ZERO_67_PERCENT.
intbias_signBIAS_SIGN_NEGATIVE oder BIAS_SIGN_POSITIVE, im Beispiel BIAS_SIGN_NEGATIVE.
intbiasBIAS_0_PERCENT bis BIAS_24_PERCENT, im Beispiel BIAS_0_PERCENT.
intfet_shortFET_SHORT_DISABLED oder FET_SHORT_ENABLED, im Beispiel FET_SHORT_DISABLED.
intop_modeDer Modus des Front-Ends, im Beispiel OP_MODE_3LEAD_AMP_CELL.
I2C(0, scl=Pin(22), sda=Pin(21))returns I2C

Erstellt 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

TypNameBeschreibung
intidDer Hardware-I2C-Bus, im Beispiel 0.
PinsclDer Taktpin, im Beispiel Pin(22).
PinsdaDer Datenpin, im Beispiel Pin(21).
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Erstellt 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

TypNameBeschreibung
SensorConfigsensor_typeDie Voreinstellung, im Beispiel SENSOR_CUSTOM.
I2Ci2cDer I2C-Bus, an dem das Board angeschlossen ist.
intadc_addrDie 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.
intconfig_pinEin GPIO für LMPEN. Im Beispiel weggelassen (None), daher schaltet das Modul keinen Pin.
sensor.begin()returns bool

Bei 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 float

Nimmt 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.