Benutzerdefinierte Konfiguration
Was dieses Beispiel zeigt
Das Bibliotheksbeispiel electrochemical-customConfig.py erstellt eine eigene SensorConfig: die Empfindlichkeit der Zelle, einen Nullpunkt-Offset, den ADC-Bereich und die Einstellungen des LMP91000 (Verstärkung, Lastwiderstand, Referenz, interner Nullpunkt, Bias, Betriebsmodus). begin() sendet diese Einstellungen an das Board. Das Skript erstellt den I2C-Bus auf GPIO 22 (SCL) und GPIO 21 (SDA).
Das Preset SENSOR_SO2 des Moduls verwendet nano_amperes_per_ppm=400.0, internal_zero_calibration=0, ADS_GAIN_4_096V, TIA_GAIN_120_KOHM, RLOAD_10_OHM, REF_EXTERNAL, INTERNAL_ZERO_20_PERCENT, BIAS_SIGN_POSITIVE, BIAS_0_PERCENT, FET_SHORT_DISABLED und OP_MODE_3LEAD_AMP_CELL. Die Werte des Beispiels gelten für eine andere Zelle. Importieren Sie daher die benötigten Namen und beginnen Sie für die SO2-Zelle mit diesen Werten.
Auf diesem Board sitzen der LMP91000 und der ADS1115 am eigenen Bus 2 des Boards, und Ihr Controller erreicht sie über die Adresse des Boards am Qwiic-Bus: 0x30 im Auslieferungszustand, 0x30 bis 0x37 mit dem ADDRESS-Schalter. Das Beispiel übergibt kein adc_addr und verwendet daher den Standardwert des Moduls, 0x49, der direkt mit einem ADS1115 kommuniziert. Übergeben Sie die Adresse des Boards als adc_addr, zum Beispiel sensor = ElectrochemicalGasSensor(SENSOR_CUSTOM, i2c, adc_addr=0x30). Wo das Anschlussschema angibt, dass LMPEN an einen GPIO-Pin geht, ist LMPEN auf diesem Board bereits über einen 10-kΩ-Widerstand auf GND gezogen und führt außerdem zum Mikrocontroller auf dem Board. Bei den Adressen des Boards verwendet das Modul config_pin nicht (siehe Hardware-Details).
Der Listing-Code ist die Datei der Bibliothek beim fixierten Commit, abgesehen von zwei reinen Kommentarzeilen, die auf ein anderes Soldered-Produkt verweisen oder im Anschlussschema ein Controller-Board nennen und weggelassen wurden.
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
electrochemical-customConfig.py beim fixierten Commit
Erwartetes Ergebnis:
Electrochemical Gas Sensor - Custom Config Example
Sensor initialized successfully!
Danach folgt alle 2,5 Sekunden eine Zeile Sensor reading: in ppb.
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 elektrochemische Zelle. Auch die Presets des Moduls, wie SENSOR_SO2, sind SensorConfig-Objekte.
ReturnsDas Konfigurationsobjekt.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
nano_amperes_per_ppm | float | Die Empfindlichkeit der Zelle in nA pro ppm, aus ihrem Datenblatt. |
internal_zero_calibration | float | Spannungs-Offset, der addiert wird, um die Messung in sauberer Luft auf null zu setzen. |
ads_gain | int | ADC-Messbereich, ADS_GAIN_6_144V bis ADS_GAIN_0_256V (aus ads1115). |
tia_gain | int | Verstärkungswiderstand des Frontends, TIA_GAIN_2_75_KOHM bis TIA_GAIN_350_KOHM, oder TIA_GAIN_EXTERNAL. |
rload | int | Lastwiderstand, RLOAD_10_OHM bis RLOAD_100_OHM. |
ref_source | int | REF_INTERNAL oder REF_EXTERNAL. |
internal_zero | int | INTERNAL_ZERO_20_PERCENT, _50_PERCENT, _67_PERCENT oder INTERNAL_ZERO_BYPASSED. |
bias_sign | int | BIAS_SIGN_NEGATIVE oder BIAS_SIGN_POSITIVE. |
bias | int | Bias als Anteil der Referenz, BIAS_0_PERCENT bis BIAS_24_PERCENT. |
fet_short | int | FET_SHORT_DISABLED oder FET_SHORT_ENABLED. |
op_mode | int | Betriebsmodus, OP_MODE_3LEAD_AMP_CELL für den Normalbetrieb. |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt das Sensorobjekt aus einer Konfiguration, einem I2C-Objekt, einer Adresse und einem optionalen Enable-Pin. Das Beispiel übergibt nur die Konfiguration und das I2C-Objekt, daher ist die Adresse der Standardwert 0x49.
ReturnsDas Sensorobjekt.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Die Konfiguration, hier SENSOR_CUSTOM. |
i2c | I2C | Ein initialisiertes machine.I2C-Objekt. |
adc_addr | int | Die Adresse, mit der das Modul kommuniziert. 0x30 bis 0x37 wählt den Bridge-Modus des Moduls, der mit dem Mikrocontroller auf dem Board kommuniziert; jeder andere Wert kommuniziert direkt mit einem ADS1115 unter dieser Adresse. Standard 0x49. |
config_pin | int | GPIO für die Enable-Leitung des LMP91000. Wird bei den Adressen 0x30 bis 0x37 nicht verwendet. Standard None. |
begin()returns boolPrüft, ob das Board antwortet, und sendet die aus der Konfiguration erstellten ADC-Verstärkungs- und LMP91000-Registerwerte an das Board.
ReturnsTrue, wenn das Board geantwortet und alle Einstellungen übernommen hat, sonst False.
getPPB()returns floatLässt das Board eine ADC-Messung durchführen und gibt die Konzentration in Parts per Billion zurück, anhand von Verstärkung und Empfindlichkeit der Konfiguration. Ein Ergebnis unter null wird als 0 zurückgegeben.
ReturnsGaskonzentration in ppb.
Zusammenfassung
Die Empfindlichkeit skaliert jedes Ergebnis, daher liefert ein falscher Wert ein falsches Resultat, selbst wenn die Hardware funktioniert. Rufen Sie bei TIA_GAIN_EXTERNAL zusätzlich setCustomTiaGain() auf, damit das Modul den Wert des Verstärkungswiderstands kennt.