Skip to main content

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.

PoljeVrijednost SENSOR_NO
nano_amperes_per_ppm400.0
internal_zero_calibration0
ads_gainADS_GAIN_4_096V
tia_gainTIA_GAIN_120_KOHM
rloadRLOAD_10_OHM
ref_sourceREF_EXTERNAL
internal_zeroINTERNAL_ZERO_20_PERCENT
bias_signBIAS_SIGN_POSITIVE
biasBIAS_12_PERCENT
fet_shortFET_SHORT_DISABLED
op_modeOP_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):

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

Sadrž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

TipNazivOpis
floatnano_amperes_per_ppmOsjetljivost ćelije u nA po ppm, u primjeru -1000.0.
floatinternal_zero_calibrationNapon dodan svakom očitanju, u primjeru -0.0012.
intads_gainPuni raspon ADC-a, konstanta ADS_GAIN_* iz ads1115, u primjeru ADS_GAIN_2_048V.
inttia_gainPojač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.
intrloadOpteretni otpornik, od RLOAD_10_OHM do RLOAD_100_OHM, u primjeru RLOAD_10_OHM.
intref_sourceREF_INTERNAL ili REF_EXTERNAL, u primjeru REF_EXTERNAL.
intinternal_zeroINTERNAL_ZERO_20_PERCENT, _50_PERCENT, _67_PERCENT ili INTERNAL_ZERO_BYPASSED, u primjeru INTERNAL_ZERO_67_PERCENT.
intbias_signBIAS_SIGN_NEGATIVE ili BIAS_SIGN_POSITIVE, u primjeru BIAS_SIGN_NEGATIVE.
intbiasOd BIAS_0_PERCENT do BIAS_24_PERCENT, u primjeru BIAS_0_PERCENT.
intfet_shortFET_SHORT_DISABLED ili FET_SHORT_ENABLED, u primjeru FET_SHORT_DISABLED.
intop_modeNačin rada ulaznog stupnja, u primjeru OP_MODE_3LEAD_AMP_CELL.
I2C(0, scl=Pin(22), sda=Pin(21))returns I2C

Stvara 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

TipNazivOpis
intidSklopovska I2C sabirnica, u primjeru 0.
PinsclPin takta, u primjeru Pin(22).
PinsdaPin podataka, u primjeru Pin(21).
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Stvara 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

TipNazivOpis
SensorConfigsensor_typePredpostavka, u primjeru SENSOR_CUSTOM.
I2Ci2cI2C sabirnica na kojoj se nalazi pločica.
intadc_addrI2C 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.
intconfig_pinGPIO za LMPEN. U primjeru je izostavljen (None), pa modul ne prebacuje nijedan pin.
sensor.begin()returns bool

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

Uzima 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.