Skip to main content

Prilagođena konfiguracija senzora

Što prikazuje ovaj primjer​

Primjer electrochemical-customConfig.py izrađuje vlastiti SensorConfig pod nazivom SENSOR_CUSTOM, umjesto da koristi neku od unaprijed definiranih konfiguracija modula, i ispisuje koncentraciju plina u dijelovima na milijardu (ppb) svakih 2,5 sekundi.

Komentar u primjeru kaže da vrijednosti treba urediti prema tehničkom listu vašeg senzora. U zapisanom obliku to su vrijednosti konfiguracije modula za ozon, SENSOR_O3, pa se očitanja pretvaraju za ozonsku ćeliju, a ne za ćeliju za ugljikov monoksid SGX-4CO na ovoj pločici.

Prije pokretanja postavite argumente SensorConfig(...) na vrijednosti SENSOR_CO, konfiguracije modula za ćeliju na ovoj pločici, iz donje tablice. Tri od njih primjer ne uvozi: dodajte ADS_GAIN_4_096V u redak from ads1115 import, a TIA_GAIN_14_KOHM i INTERNAL_ZERO_20_PERCENT u popis from ElectrochemicalGasSensor import.

ArgumentU primjeruVrijednost 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

Primjer otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21. Promijenite ih u I2C pinove svojeg kontrolera ako se razlikuju.

Što je potrebno na ovoj pločici​

Primjer izrađuje senzor bez adc_addr, pa modul koristi zadanu adresu, 0x49. Na adresi izvan raspona od 0x30 do 0x37 modul ne ide preko mosta na pločici: begin() traži ADS1115 na toj adresi I2C skeniranjem, a zatim zapisuje konfiguraciju čipa LMP91000 na adresu 0x48, oboje na sabirnici koju mu proslijedite. Na ovoj pločici ta se dva čipa nalaze na internoj sabirnici, koju gornji header izvodi kao SDA2 i SCL2. Qwiic konektori i SDA1/SCL1 dosežu samo most ATtiny404, a I2C skeniranje preko Qwiica pronalazi samo most, na adresi 0x30 kako se isporučuje. Primjer ne prosljeđuje config_pin, a LMPEN je na pločici spojen na GND; pogledajte Pojedinosti o hardveru.

Zato za ovaj primjer spojite gornji header, a ne Qwiic kabel: spojite SDA svojeg kontrolera na SDA2, SCL na SCL2, pin 3,3 V na 3V3, a GND na GND. Dijagram spajanja u ispisu prikazuje Qwiic liniju, ali preko Qwiic konektora odgovara samo most.

Adresa mosta, od 0x30 do 0x37, ona je koju prosljeđuje primjer Očitavanje koncentracije CO.

Kod primjera​

# 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)

Donji retci potječu iz pokretanja ovog primjera na ovoj pločici, s kontrolerom spojenim na pinove SDA2, SCL2, 3V3 i GND headera kako je opisano gore.

Očekivani rezultat u Thonny konzoli:

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

Zatim svakih 2,5 sekundi slijedi redak: Sensor reading: , koncentracija u ppb s pet decimala i PPB. Rezultat manji od nule ispisuje se kao 0.00000. Ako begin() ne uspije, konzola prikazuje ERROR: Can't init the sensor! Check connections! i skripta se tu zaustavlja.

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 elektrokemijsku ćeliju. Unaprijed definirane konfiguracije modula (SENSOR_CO, SENSOR_O3 i ostale) objekti su tipa SensorConfig; ovaj primjer izrađuje vlastitu.

ReturnsKonfiguracija, spremna za prosljeđivanje funkciji ElectrochemicalGasSensor().

Parametri

ParametarTipOpis
nano_amperes_per_ppmfloatOsjetljivost ćelije u nA po ppm, iz njezina tehničkog lista.
internal_zero_calibrationfloatNaponski pomak, u voltima, koji se dodaje kako bi se očitanje u čistom zraku postavilo na nulu.
ads_gainintPuni mjerni opseg ADC-a, konstanta ADS_GAIN_* iz ads1115.
tia_gainintPovratni otpornik ulaznog stupnja, konstanta TIA_GAIN_*.
rloadintOpteretni otpornik, konstanta RLOAD_*.
ref_sourceintIzvor reference, REF_INTERNAL ili REF_EXTERNAL.
internal_zerointInterna nula kao postotak reference, konstanta INTERNAL_ZERO_*.
bias_signintPolaritet pristranskog napona, BIAS_SIGN_NEGATIVE ili BIAS_SIGN_POSITIVE.
biasintPristranski napon kao postotak reference, konstanta BIAS_*_PERCENT.
fet_shortintFET_SHORT_DISABLED ili FET_SHORT_ENABLED.
op_modeintRadni način, konstanta OP_MODE_*; OP_MODE_3LEAD_AMP_CELL za normalan rad.
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Izrađuje objekt senzora. Primjer prosljeđuje SENSOR_CUSTOM i I2C sabirnicu, a adc_addr i config_pin ostavlja na zadanim vrijednostima.

ReturnsObjekt senzora.

Parametri

ParametarTipOpis
sensor_typeSensorConfigKonfiguracija ćelije: unaprijed definirana konfiguracija modula ili vaš vlastiti SensorConfig.
i2cmachine.I2CInicijalizirana I2C sabirnica. S vrijednošću None modul otvara I2C 0 na pinovima 22 i 21 na ESP32, odnosno pinovima 5 i 4 na ESP8266, a na bilo kojoj drugoj pločici javlja Board not recognized, please pass an I2C object manually.
adc_addrintI2C adresa. Zadano 0x49. Od 0x30 do 0x37 modul komunicira s mostom ATtiny404 na pločici.
config_pinint ili NoneGPIO koji modul drži u niskom stanju dok šalje konfiguraciju ulaznog stupnja, a inače u visokom. Ne koristi se na adresi od 0x30 do 0x37. Zadano None.
begin()returns bool

Pokreće senzor. Kod adc_addr od 0x30 do 0x37 provjerava odgovara li most, šalje mu pojačanje ADC-a i brzinu podataka iz konfiguracije, a zatim postavke ulaznog stupnja iz konfiguracije, pri čemu svaki korak ponavlja nakon pogreške sabirnice do isteka od 500 ms. Kod bilo koje druge adc_addr provjerava odgovara li ADC na toj adresi, postavlja njegovo pojačanje i brzinu podataka, a zatim zapisuje postavke ulaznog stupnja.

ReturnsTrue ako je svaki korak uspio, inače False.

getPPB()returns float

Izvodi jedno mjerenje s osjetljivošću i nulom iz konfiguracije i vraća ga u dijelovima na milijardu.

ReturnsgetPPM() pomnožen s 1000.

Sastavljanje u cjelinu​

Izradite SensorConfig s vrijednostima svoje ćelije (za ovu pločicu vrijednosti SENSOR_CO iz gornje tablice), proslijedite ga funkciji ElectrochemicalGasSensor(), jednom pozovite begin() i provjerite rezultat, a zatim očitajte pomoću getPPB().