Benutzerdefinierte Sensorkonfiguration
Was dieses Beispiel zeigt
Das Beispiel electrochemical-customConfig.py erstellt eine eigene SensorConfig
mit dem Namen SENSOR_CUSTOM, statt eines der Presets des Moduls zu verwenden, und
gibt die Gaskonzentration alle 2,5 Sekunden in Parts per Billion (ppb) aus.
Der Kommentar im Beispiel sagt, dass Sie die Werte an das Datenblatt Ihres Sensors anpassen sollen. In der vorliegenden Form sind es die Werte des Ozon-Presets des Moduls, SENSOR_O3. Die Messwerte werden also für die Ozonzelle umgerechnet, nicht für die Kohlenmonoxidzelle SGX-4CO dieses Boards.
Setzen Sie vor dem Ausführen die Argumente von SensorConfig(...) auf die Werte von
SENSOR_CO, dem Preset des Moduls für die Zelle dieses Boards, aus der Tabelle unten.
Drei davon werden im Beispiel nicht importiert: Fügen Sie ADS_GAIN_4_096V zur
Zeile from ads1115 import hinzu, und TIA_GAIN_14_KOHM sowie
INTERNAL_ZERO_20_PERCENT zur Liste
from ElectrochemicalGasSensor import.
| Argument | Im Beispiel | Wert von SENSOR_CO |
|---|---|---|
nano_amperes_per_ppm | -1000.0 | 70.0 |
internal_zero_calibration | -0.0012 | 0 |
ads_gain | ADS_GAIN_2_048V | ADS_GAIN_4_096V |
tia_gain | TIA_GAIN_35_KOHM | TIA_GAIN_14_KOHM |
rload | RLOAD_10_OHM | RLOAD_10_OHM |
ref_source | REF_EXTERNAL | REF_EXTERNAL |
internal_zero | INTERNAL_ZERO_67_PERCENT | INTERNAL_ZERO_20_PERCENT |
bias_sign | BIAS_SIGN_NEGATIVE | BIAS_SIGN_NEGATIVE |
bias | BIAS_0_PERCENT | BIAS_0_PERCENT |
fet_short | FET_SHORT_DISABLED | FET_SHORT_DISABLED |
op_mode | OP_MODE_3LEAD_AMP_CELL | OP_MODE_3LEAD_AMP_CELL |
Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie
diese auf die I2C-Pins Ihres Controllers, falls sie abweichen.
Was es auf diesem Board benötigt
Das Beispiel erstellt den Sensor ohne adc_addr, daher verwendet das Modul
den Standardwert 0x49. Bei einer Adresse außerhalb von 0x30 bis 0x37 läuft das Modul nicht
über die Bridge des Boards: begin() sucht den ADS1115 an dieser Adresse
mit einem I2C-Scan und schreibt dann die Konfiguration des LMP91000 an 0x48, beides auf dem
Bus, den Sie übergeben. Auf diesem Board liegen diese beiden Chips am internen Bus, den
die obere Stiftleiste als SDA2 und SCL2 herausführt. Die Qwiic-Connectors und
SDA1/SCL1 erreichen nur die ATtiny404-Bridge, und ein I2C-Scan über Qwiic findet
nur die Bridge, im Auslieferungszustand an 0x30. Das Beispiel übergibt kein config_pin, und
LMPEN ist auf dem Board auf GND gelegt; siehe
Hardware-Details.
Verdrahten Sie für dieses Beispiel also die obere Stiftleiste, nicht das Qwiic-Kabel: Verbinden Sie
SDA Ihres Controllers mit SDA2, SCL mit SCL2, den 3,3-V-Pin mit 3V3 und
GND mit GND. Das Anschlussdiagramm im Listing zeigt eine Qwiic-Leitung, aber über
Qwiic antwortet nur die Bridge.
Die Adresse der Bridge, 0x30 bis 0x37, ist diejenige, die das Beispiel CO-Konzentration auslesen übergibt.
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)
Die folgenden Zeilen stammen aus einem Lauf dieses Beispiels auf diesem Board, wobei der
Controller wie oben beschrieben mit den Pins SDA2, SCL2, 3V3 und GND der Stiftleiste verbunden war.
Erwartetes Ergebnis in der Thonny-Shell:
Electrochemical Gas Sensor - Custom Config Example
Sensor initialized successfully!
Sensor reading: 309.60422 PPB
Sensor reading: 316.97594 PPB
Sensor reading: 300.25541 PPB
Sensor reading: 324.21363 PPB
Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration in ppb
mit fünf Nachkommastellen und PPB. Ein Ergebnis unter null wird als 0.00000 ausgegeben.
Schlägt begin() fehl, zeigt die Shell
ERROR: Can't init the sensor! Check connections! an, und das Skript bleibt dort stehen.
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. Die Presets des Moduls (SENSOR_CO, SENSOR_O3 und weitere) sind SensorConfig-Objekte; dieses Beispiel erstellt ein eigenes.
ReturnsDie Konfiguration, bereit zur Übergabe an ElectrochemicalGasSensor().
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
nano_amperes_per_ppm | float | Die Empfindlichkeit der Zelle in nA pro ppm, aus ihrem Datenblatt. |
internal_zero_calibration | float | Ein Spannungsoffset in Volt, der addiert wird, um die Messung in sauberer Luft auf null zu setzen. |
ads_gain | int | Der Vollausschlagsbereich des ADC, eine ADS_GAIN_*-Konstante aus ads1115. |
tia_gain | int | Der Rückkopplungswiderstand der Eingangsstufe, eine TIA_GAIN_*-Konstante. |
rload | int | Der Lastwiderstand, eine RLOAD_*-Konstante. |
ref_source | int | Die Referenzquelle, REF_INTERNAL oder REF_EXTERNAL. |
internal_zero | int | Der interne Nullpunkt als Prozentsatz der Referenz, eine INTERNAL_ZERO_*-Konstante. |
bias_sign | int | Die Polarität der Vorspannung, BIAS_SIGN_NEGATIVE oder BIAS_SIGN_POSITIVE. |
bias | int | Die Vorspannung als Prozentsatz der Referenz, eine BIAS_*_PERCENT-Konstante. |
fet_short | int | FET_SHORT_DISABLED oder FET_SHORT_ENABLED. |
op_mode | int | Der Betriebsmodus, eine OP_MODE_*-Konstante; OP_MODE_3LEAD_AMP_CELL für den normalen Betrieb. |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorErstellt das Sensorobjekt. Das Beispiel übergibt SENSOR_CUSTOM und den I2C-Bus und lässt adc_addr und config_pin auf ihren Standardwerten.
ReturnsDas Sensorobjekt.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
sensor_type | SensorConfig | Die Konfiguration der Zelle: ein Preset des Moduls oder Ihre eigene SensorConfig. |
i2c | machine.I2C | Ein initialisierter I2C-Bus. Bei None öffnet das Modul I2C 0 an den Pins 22 und 21 auf einem ESP32 bzw. an den Pins 5 und 4 auf einem ESP8266 und löst auf jedem anderen Board Board not recognized, please pass an I2C object manually aus. |
adc_addr | int | Die I2C-Adresse. Standard 0x49. Von 0x30 bis 0x37 kommuniziert das Modul mit der ATtiny404-Bridge des Boards. |
config_pin | int oder None | Ein GPIO, den das Modul auf Low zieht, während es die Konfiguration der Eingangsstufe sendet, und sonst auf High. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. Standard None. |
begin()returns boolStartet den Sensor. Bei einer adc_addr von 0x30 bis 0x37 prüft es, ob die Bridge antwortet, sendet ihr die ADC-Verstärkung und die Datenrate aus der Konfiguration, danach die Einstellungen der Eingangsstufe aus der Konfiguration, wobei ein Busfehler bei jedem Schritt bis zu einem Timeout von 500 ms wiederholt wird. Bei jeder anderen adc_addr prüft es, ob der ADC an dieser Adresse antwortet, stellt dessen Verstärkung und Datenrate ein und schreibt dann die Einstellungen der Eingangsstufe.
ReturnsTrue, wenn jeder Schritt erfolgreich war, sonst False.
getPPB()returns floatFührt eine Messung mit der Empfindlichkeit und dem Nullpunkt der Konfiguration durch und gibt sie in Parts per Billion zurück.
ReturnsgetPPM() multipliziert mit 1000.
Zusammenfassung
Erstellen Sie eine SensorConfig mit den Werten Ihrer Zelle (für dieses Board die
oben genannten SENSOR_CO-Werte), übergeben Sie sie an ElectrochemicalGasSensor(), rufen Sie
einmal begin() auf und prüfen Sie das Ergebnis, lesen Sie dann mit getPPB().