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.
| Argument | U primjeru | Vrijednost 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 |
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:
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 SensorConfigSadrž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
| Parametar | Tip | Opis |
|---|---|---|
nano_amperes_per_ppm | float | Osjetljivost ćelije u nA po ppm, iz njezina tehničkog lista. |
internal_zero_calibration | float | Naponski pomak, u voltima, koji se dodaje kako bi se očitanje u čistom zraku postavilo na nulu. |
ads_gain | int | Puni mjerni opseg ADC-a, konstanta ADS_GAIN_* iz ads1115. |
tia_gain | int | Povratni otpornik ulaznog stupnja, konstanta TIA_GAIN_*. |
rload | int | Opteretni otpornik, konstanta RLOAD_*. |
ref_source | int | Izvor reference, REF_INTERNAL ili REF_EXTERNAL. |
internal_zero | int | Interna nula kao postotak reference, konstanta INTERNAL_ZERO_*. |
bias_sign | int | Polaritet pristranskog napona, BIAS_SIGN_NEGATIVE ili BIAS_SIGN_POSITIVE. |
bias | int | Pristranski napon kao postotak reference, konstanta BIAS_*_PERCENT. |
fet_short | int | FET_SHORT_DISABLED ili FET_SHORT_ENABLED. |
op_mode | int | Radni 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 ElectrochemicalGasSensorIzrađuje objekt senzora. Primjer prosljeđuje SENSOR_CUSTOM i I2C sabirnicu, a adc_addr i config_pin ostavlja na zadanim vrijednostima.
ReturnsObjekt senzora.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
sensor_type | SensorConfig | Konfiguracija ćelije: unaprijed definirana konfiguracija modula ili vaš vlastiti SensorConfig. |
i2c | machine.I2C | Inicijalizirana 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_addr | int | I2C adresa. Zadano 0x49. Od 0x30 do 0x37 modul komunicira s mostom ATtiny404 na pločici. |
config_pin | int ili None | GPIO 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 boolPokreć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 floatIzvodi 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().