Benutzerdefinierte Konfiguration
Was dieses Beispiel zeigt
Das Beispiel electrochemical-customConfig.py erstellt eine eigene Sensorkonfiguration, SENSOR_CUSTOM, statt ein Preset zu verwenden, und gibt alle 2,5 Sekunden Messwerte in PPB aus. In der ausgelieferten Fassung sind seine Werte identisch mit dem Ozon-Preset SENSOR_O3; hier tragen Sie die eigenen Einstellungen Ihrer Zelle ein. Der Sensor wird ohne Adresse erstellt, daher verwendet der Konstruktor seinen Standardwert adc_addr=0x49.
Das Beispiel öffnet den I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie diese auf die Pins, die der Qwiic Connector Ihres Controllers oder Ihre Verdrahtung verwendet.
Den Pin LMPEN müssen Sie bei diesem Board nicht anschließen, was auch immer die Kommentare im Beispiel sagen: Das Board legt ihn selbst auf Low.
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
Examples/electrochemical-customConfig.py im Commit 623e1e6
Was dieses Board mit dem Beispiel in der vorliegenden Form ausgibt, wurde noch nicht gemessen. Als dieses Board über Qwiic getestet wurde, fand ein I2C-Scan nur eine Adresse, 0x30, und begin() schlug für einen Sensor fehl, der auf 0x49 erstellt wurde, den Standardwert, den dieses Beispiel verwendet. Schlägt begin() fehl, gibt das Beispiel nach seiner Titelzeile ERROR: Can't init the sensor! Check connections! aus und hält dort an.
Wenn begin() erfolgreich ist, zeigt die Shell:
Electrochemical Gas Sensor - Custom Config Example
Sensor initialized successfully!
Danach folgt alle 2,5 Sekunden eine Zeile Sensor reading: mit einem Wert mit fünf Nachkommastellen und 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: wie getPPM() die Spannung umrechnet und was begin() an den ADC und den LMP91000 sendet. Importieren Sie sie und ihre Konstanten aus ElectrochemicalGasSensor; die ADC-Verstärkungskonstanten stammen aus ads1115.
ReturnsDas Konfigurationsobjekt, das an den Konstruktor übergeben wird.
Parameter
| Type | Name | Description |
|---|---|---|
float | nano_amperes_per_ppm | Die Empfindlichkeit der Zelle in nA pro PPM. |
float | internal_zero_calibration | Ein Spannungsoffset, der zu jedem Messwert addiert wird. |
int | ads_gain | Der Vollausschlagsbereich des ADS1115, zum Beispiel ADS_GAIN_2_048V. |
int | tia_gain | Die TIA-Verstärkung des LMP91000, TIA_GAIN_2_75_KOHM bis TIA_GAIN_350_KOHM, oder TIA_GAIN_EXTERNAL. |
int | rload | Der Lastwiderstand, RLOAD_10_OHM bis RLOAD_100_OHM. |
int | ref_source | REF_INTERNAL oder REF_EXTERNAL. |
int | internal_zero | INTERNAL_ZERO_20_PERCENT, _50_PERCENT, _67_PERCENT oder INTERNAL_ZERO_BYPASSED. |
int | bias_sign | BIAS_SIGN_NEGATIVE oder BIAS_SIGN_POSITIVE. |
int | bias | Die Bias-Spannung als Anteil der Referenz, BIAS_0_PERCENT bis BIAS_24_PERCENT. |
int | fet_short | FET_SHORT_DISABLED oder FET_SHORT_ENABLED. |
int | op_mode | Der Betriebsmodus, zum Beispiel OP_MODE_3LEAD_AMP_CELL. |
I2C(id, scl, sda)returns I2CErstellt das I2C-Busobjekt aus dem Modul machine von MicroPython, das das Sensorobjekt verwendet. Das Beispiel nutzt Bus 0 mit SCL an Pin(22) und SDA an Pin(21). I2C und Pin gehören zu MicroPython und sind nicht Teil dieser Bibliothek.
ReturnsDas I2C-Busobjekt.
Parameter
| Type | Name | Description |
|---|---|---|
int | id | Der Hardware-I2C-Bus, im Beispiel 0. |
Pin | scl | Der Takt-Pin, im Beispiel Pin(22). |
Pin | sda | Der Daten-Pin, im Beispiel Pin(21). |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt das Sensorobjekt. Es wird nichts an das Board gesendet, bis Sie begin() aufrufen. Das Beispiel übergibt SENSOR_CUSTOM und den Bus und belässt adc_addr und config_pin auf ihren Standardwerten.
ReturnsDas Sensorobjekt.
Parameter
| Type | Name | Description |
|---|---|---|
SensorConfig | sensor_type | Die zu verwendende Konfiguration, im Beispiel SENSOR_CUSTOM. |
I2C | i2c | Der zu verwendende Bus. Wird er weggelassen, wählt das Modul Pins nur bei Boards, die es erkennt (ESP32: Bus 0, SCL 22, SDA 21; ESP8266: SCL 5, SDA 4), und löst andernfalls eine Exception aus. |
int | adc_addr | Die Adresse, mit der das Modul kommuniziert, standardmäßig 0x49, wie in diesem Beispiel. Eine Adresse von 0x30 bis 0x37 lässt begin() die Bridge-Befehle verwenden; jede andere Adresse wird als eigene Adresse des ADS1115 aufgefasst. |
int | config_pin | Ein GPIO-Pin, den das Modul auf High legt und auf Low zieht, während es die LMP91000-Einstellungen schreibt. Standardmäßig None; wird für eine Adresse von 0x30 bis 0x37 nicht verwendet. |
sensor.begin()returns boolKonfiguriert den ADC und den LMP91000 anhand der Sensorkonfiguration. Bei einer adc_addr von 0x30 bis 0x37 prüft es, ob die Bridge des Boards antwortet, und sendet ihr die ADC-Verstärkung, die langsamste ADC-Datenrate und die LMP91000-Einstellungen, wobei es jeden Befehl bis zu 500 ms lang wiederholt. Bei jeder anderen Adresse richtet es den ADS1115 an dieser Adresse mit derselben Verstärkung und Datenrate ein und schreibt die LMP91000-Einstellungen direkt, wobei es config_pin auf Low zieht, sofern einer angegeben ist.
ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.
sensor.getPPB()returns floatNimmt einen Messwert auf und gibt ihn in Parts per Billion zurück: den getPPM()-Wert multipliziert mit 1000. getPPM() subtrahiert die interne Null (ein Anteil der 2,5-V-Referenz des Boards), addiert internal_zero_calibration, dividiert durch die TIA-Verstärkung und durch nano_amperes_per_ppm und gibt bei einem negativen Ergebnis 0.0 zurück.
ReturnsDie Konzentration in PPB.
Zusammenfassung
Die Werte in SENSOR_CUSTOM des Listings sind die eigenen Platzhalter des Beispiels, keine Einstellungen für die Sauerstoffzelle SGX-4OX-ROHS dieses Boards. Das Argument bias=BIAS_0_PERCENT legt keine Bias-Spannung an, die Zelle benötigt aber eine. Ändern Sie daher die Konfiguration, bevor Sie sie mit diesem Board verwenden:
- Die Zelle benötigt eine Bias-Spannung von −600 mV. Mit der 2,5-V-Referenz des Boards ergibt das
bias_sign=BIAS_SIGN_NEGATIVEmitbias=BIAS_24_PERCENT(24 % von 2,5 V sind 0,6 V). Importieren SieBIAS_24_PERCENTanstelle vonBIAS_0_PERCENT. - Behalten Sie
ref_source=REF_EXTERNALbei: Das Board hat eine externe 2,5-V-Referenz. - Der Ausgangsstrom der Zelle an Luft beträgt 0,1 ± 0,03 mA, und ihr Ausgang ist logarithmisch, S = K ln(1/(1-C)), sodass die lineare PPM-Berechnung des Moduls ihn nicht direkt in Vol.-% umrechnet.
Nach dem Einschalten kann die Zelle bis zu 15 Minuten brauchen, um sich einzupegeln. Lassen Sie sie daher laufen, bevor Sie einem Messwert vertrauen.