Zum Hauptinhalt springen

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.

ArgumentIm BeispielWert von SENSOR_CO
nano_amperes_per_ppm-1000.070.0
internal_zero_calibration-0.00120
ads_gainADS_GAIN_2_048VADS_GAIN_4_096V
tia_gainTIA_GAIN_35_KOHMTIA_GAIN_14_KOHM
rloadRLOAD_10_OHMRLOAD_10_OHM
ref_sourceREF_EXTERNALREF_EXTERNAL
internal_zeroINTERNAL_ZERO_67_PERCENTINTERNAL_ZERO_20_PERCENT
bias_signBIAS_SIGN_NEGATIVEBIAS_SIGN_NEGATIVE
biasBIAS_0_PERCENTBIAS_0_PERCENT
fet_shortFET_SHORT_DISABLEDFET_SHORT_DISABLED
op_modeOP_MODE_3LEAD_AMP_CELLOP_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:

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

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

ParameterTypBeschreibung
nano_amperes_per_ppmfloatDie Empfindlichkeit der Zelle in nA pro ppm, aus ihrem Datenblatt.
internal_zero_calibrationfloatEin Spannungsoffset in Volt, der addiert wird, um die Messung in sauberer Luft auf null zu setzen.
ads_gainintDer Vollausschlagsbereich des ADC, eine ADS_GAIN_*-Konstante aus ads1115.
tia_gainintDer Rückkopplungswiderstand der Eingangsstufe, eine TIA_GAIN_*-Konstante.
rloadintDer Lastwiderstand, eine RLOAD_*-Konstante.
ref_sourceintDie Referenzquelle, REF_INTERNAL oder REF_EXTERNAL.
internal_zerointDer interne Nullpunkt als Prozentsatz der Referenz, eine INTERNAL_ZERO_*-Konstante.
bias_signintDie Polarität der Vorspannung, BIAS_SIGN_NEGATIVE oder BIAS_SIGN_POSITIVE.
biasintDie Vorspannung als Prozentsatz der Referenz, eine BIAS_*_PERCENT-Konstante.
fet_shortintFET_SHORT_DISABLED oder FET_SHORT_ENABLED.
op_modeintDer 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 ElectrochemicalGasSensor

Erstellt 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

ParameterTypBeschreibung
sensor_typeSensorConfigDie Konfiguration der Zelle: ein Preset des Moduls oder Ihre eigene SensorConfig.
i2cmachine.I2CEin 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_addrintDie I2C-Adresse. Standard 0x49. Von 0x30 bis 0x37 kommuniziert das Modul mit der ATtiny404-Bridge des Boards.
config_pinint oder NoneEin 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 bool

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

Fü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().