Koristite vlastite postavke ulaznog stupnja
Što prikazuje ovaj primjer
Primjer electrochemical-customConfig.py gradi vlastitu predpostavku pomoću
SensorConfig umjesto da koristi jednu od predpostavki modula. Predpostavka sadrži
osjetljivost ćelije, raspon ADC-a i sve postavke ulaznog stupnja LMP91000, pa je to
način za isprobavanje drugih vrijednosti za ćeliju. Primjer zatim ispisuje očitanje
u ppb (dijelovi na milijardu) svakih 2,5 sekunde.
Primjer stvara senzor samo s predpostavkom i I2C sabirnicom, pa modul koristi svoju
zadanu adresu, 0x49. Otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21;
promijenite te brojeve pinova u I2C pinove svojeg kontrolera ako se razlikuju. Na
adresi 0x49 modul komunicira izravno s ADS1115 i LMP91000, a ne preko ATtiny404
mosta na pločici, a komentari u primjeru traže da LMPEN bude spojen na GPIO. Pogledajte
pregled biblioteke
da vidite kako adresa to određuje.
SENSOR_CUSTOM iz primjera sadrži iste vrijednosti kao predpostavka modula za ozon,
SENSOR_O3. Za ćeliju SGX-4NO-250 na ovoj pločici predpostavka modula
SENSOR_NO koristi vrijednosti iz tablice u nastavku.
| Polje | Vrijednost SENSOR_NO |
|---|---|
nano_amperes_per_ppm | 400.0 |
internal_zero_calibration | 0 |
ads_gain | ADS_GAIN_4_096V |
tia_gain | TIA_GAIN_120_KOHM |
rload | RLOAD_10_OHM |
ref_source | REF_EXTERNAL |
internal_zero | INTERNAL_ZERO_20_PERCENT |
bias_sign | BIAS_SIGN_POSITIVE |
bias | BIAS_12_PERCENT |
fet_short | FET_SHORT_DISABLED |
op_mode | OP_MODE_3LEAD_AMP_CELL |
Kod primjera
Ispis je datoteka modula na zakovanom commitu. Izostavljeni su samo retci komentara: zaglavni redak koji navodi stranicu trgovine drugog proizvoda i redak dijagrama spajanja koji navodi staru pločicu.
# 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)
🔗Otvorite cijeli primjer
Examples/electrochemical-customConfig.py na commitu 623e1e6
Očekivani rezultat, sa SENSOR_CUSTOM postavljenim na vrijednosti SENSOR_NO (očitanja
na čistom zraku; vaša će se razlikovati):
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
Redak Sensor reading: pojavljuje se svakih 2,5 sekunde, s
koncentracijom u ppb na pet decimala i PPB na kraju. Ako pločica
ne odgovori, primjer ispisuje
ERROR: Can't init the sensor! Check connections! i ostaje u petlji.
Korištene funkcije
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 SensorConfigSadrži postavke za jednu ćeliju. Predpostavke modula, poput SENSOR_NO, također su objekti SensorConfig. begin() šalje polja ulaznog stupnja na LMP91000, a pojačanje ADC-a na ADS1115; getPPM() koristi osjetljivost i nulto umjeravanje.
ReturnsPredpostavka koju prosljeđujete ElectrochemicalGasSensoru.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
float | nano_amperes_per_ppm | Osjetljivost ćelije u nA po ppm, u primjeru -1000.0. |
float | internal_zero_calibration | Napon dodan svakom očitanju, u primjeru -0.0012. |
int | ads_gain | Puni raspon ADC-a, konstanta ADS_GAIN_* iz ads1115, u primjeru ADS_GAIN_2_048V. |
int | tia_gain | Pojačanje pojačala ulaznog stupnja, od TIA_GAIN_2_75_KOHM do TIA_GAIN_350_KOHM (ili TIA_GAIN_EXTERNAL), u primjeru TIA_GAIN_35_KOHM. |
int | rload | Opteretni otpornik, od RLOAD_10_OHM do RLOAD_100_OHM, u primjeru RLOAD_10_OHM. |
int | ref_source | REF_INTERNAL ili REF_EXTERNAL, u primjeru REF_EXTERNAL. |
int | internal_zero | INTERNAL_ZERO_20_PERCENT, _50_PERCENT, _67_PERCENT ili INTERNAL_ZERO_BYPASSED, u primjeru INTERNAL_ZERO_67_PERCENT. |
int | bias_sign | BIAS_SIGN_NEGATIVE ili BIAS_SIGN_POSITIVE, u primjeru BIAS_SIGN_NEGATIVE. |
int | bias | Od BIAS_0_PERCENT do BIAS_24_PERCENT, u primjeru BIAS_0_PERCENT. |
int | fet_short | FET_SHORT_DISABLED ili FET_SHORT_ENABLED, u primjeru FET_SHORT_DISABLED. |
int | op_mode | Način rada ulaznog stupnja, u primjeru OP_MODE_3LEAD_AMP_CELL. |
I2C(0, scl=Pin(22), sda=Pin(21))returns I2CStvara sklopovsku I2C sabirnicu 0 na zadanim pinovima SCL i SDA. machine.I2C i machine.Pin dolaze s MicroPythonom i nisu dio Soldered modula (vidi docs.micropython.org, machine.I2C i machine.Pin).
ReturnsObjekt I2C sabirnice koji prosljeđujete senzoru.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | id | Sklopovska I2C sabirnica, u primjeru 0. |
Pin | scl | Pin takta, u primjeru Pin(22). |
Pin | sda | Pin podataka, u primjeru Pin(21). |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora. Ništa se ne šalje preko I2C-a dok ne pozovete begin(). S i2c=None modul sam otvara sabirnicu na pločicama koje prepoznaje, uključujući ESP32, na kojoj otvara I2C(0, scl=Pin(22), sda=Pin(21)), i ESP8266, na kojem otvara I2C(scl=Pin(5), sda=Pin(4)). Na pločici koju ne prepoznaje baca iznimku.
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Predpostavka, u primjeru SENSOR_CUSTOM. |
I2C | i2c | I2C sabirnica na kojoj se nalazi pločica. |
int | adc_addr | I2C adresa. U primjeru je izostavljena, pa je to zadana adresa modula, 0x49. Za 0x30 do 0x37 modul komunicira s ATtiny404 mostom na pločici; za svaku drugu adresu komunicira s ADS1115 na toj adresi i izravno s LMP91000. |
int | config_pin | GPIO za LMPEN. U primjeru je izostavljen (None), pa modul ne prebacuje nijedan pin. |
sensor.begin()returns boolZa adresu od 0x30 do 0x37 provjerava odgovara li most na pločici i preko njega šalje postavke ADC-a i ulaznog stupnja, čekajući do 500 ms na svaki korak. Za svaku drugu adresu provjerava odgovara li ADS1115 na adc_addr u I2C skeniranju, postavlja pojačanje ADC-a iz predpostavke i najsporiju brzinu podataka, zatim konfigurira LMP91000 na 0x48 (pojačanje, opterećenje, referenca, unutarnja nula, bias i način rada), pri čemu config_pin povlači na nisku razinu samo tijekom te konfiguracije, ako je zadan.
ReturnsTrue ako su svi koraci uspjeli, inače False.
sensor.getPPB()returns floatUzima jedno očitanje pomoću getPPM() i množi ga s 1000. getPPM() čita ADC kanal 0 (na 0x30 do 0x37 pretvorbu izvodi most), oduzima unutarnju nulu (2,5 V puta postotak unutarnje nule iz predpostavke), dodaje nulto umjeravanje, zatim dijeli s pojačanjem pojačala i s nA po ppm iz predpostavke.
ReturnsKoncentracija plina u ppb. Negativan rezultat vraća se kao 0.0.
Sastavljanje cjeline
Predpostavka su obični podaci: izradite je jednom, proslijedite konstruktoru, a
begin() šalje njezine postavke ulaznog stupnja kad pokrene senzor. Za isprobavanje drugih
vrijednosti uredite polja SENSOR_CUSTOM i ponovno pokrenite primjer.