Prilagođena konfiguracija
Što ovaj primjer prikazuje
Primjer electrochemical-customConfig.py izrađuje vlastitu konfiguraciju senzora,
SENSOR_CUSTOM, umjesto da koristi unaprijed postavljenu, i ispisuje očitanja
u PPB svakih 2,5 sekunde. U isporučenom obliku njezine su vrijednosti iste kao u
unaprijed postavljenoj konfiguraciji za ozon SENSOR_O3; ovdje upišite postavke
vlastite ćelije.
Senzor se stvara bez adrese, pa konstruktor koristi svoju zadanu vrijednost,
adc_addr=0x49.
Primjer otvara I2C sabirnicu 0 sa signalom SCL na pinu 22 i SDA na pinu 21.
Promijenite ih u pinove koje koristi Qwiic konektor vašeg kontrolera ili vaše ožičenje.
Na ovoj pločici ne trebate spajati LMPEN, što god pisalo u komentarima primjera:
pločica ga sama drži na niskoj razini.
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)
🔗Otvorite cijeli primjer
Examples/electrochemical-customConfig.py u commitu 623e1e6
Što ova pločica ispisuje s primjerom u zadanom obliku, još nije izmjereno.
Kada je ova pločica testirana preko Qwiic konektora, I2C skeniranje pronašlo je samo jednu adresu,
0x30, a begin() nije uspio za senzor stvoren na adresi 0x49, zadanoj adresi
koju koristi ovaj primjer. Ako begin() ne uspije, primjer nakon naslovne linije ispisuje
ERROR: Can't init the sensor! Check connections!
i tu staje.
Kada begin() uspije, u shellu se prikazuje:
Electrochemical Gas Sensor - Custom Config Example
Sensor initialized successfully!
Nakon toga svakih 2,5 sekunde stiže redak Sensor reading: iza kojeg slijedi vrijednost s pet decimala
i PPB.
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: kako getPPM() pretvara napon i što begin() šalje ADC-u i LMP91000. Uvezite je zajedno s njezinim konstantama iz ElectrochemicalGasSensor; konstante pojačanja ADC-a dolaze iz ads1115.
ReturnsKonfiguracijski objekt koji se prosljeđuje konstruktoru.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
float | nano_amperes_per_ppm | Osjetljivost ćelije u nA po PPM. |
float | internal_zero_calibration | Naponski pomak koji se dodaje svakom očitanju. |
int | ads_gain | Puni mjerni opseg ADS1115, na primjer ADS_GAIN_2_048V. |
int | tia_gain | TIA pojačanje LMP91000, od TIA_GAIN_2_75_KOHM do TIA_GAIN_350_KOHM, ili TIA_GAIN_EXTERNAL. |
int | rload | Otpornik opterećenja, od RLOAD_10_OHM do RLOAD_100_OHM. |
int | ref_source | REF_INTERNAL ili REF_EXTERNAL. |
int | internal_zero | INTERNAL_ZERO_20_PERCENT, _50_PERCENT, _67_PERCENT ili INTERNAL_ZERO_BYPASSED. |
int | bias_sign | BIAS_SIGN_NEGATIVE ili BIAS_SIGN_POSITIVE. |
int | bias | Prednapon kao udio referentnog napona, od BIAS_0_PERCENT do BIAS_24_PERCENT. |
int | fet_short | FET_SHORT_DISABLED ili FET_SHORT_ENABLED. |
int | op_mode | Radni način, na primjer OP_MODE_3LEAD_AMP_CELL. |
I2C(id, scl, sda)returns I2CStvara objekt I2C sabirnice iz MicroPythonova modula machine, koji koristi objekt senzora. Primjer koristi sabirnicu 0 sa SCL na Pin(22) i SDA na Pin(21). I2C i Pin dolaze s MicroPythonom i nisu dio ove biblioteke.
ReturnsObjekt I2C sabirnice.
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 pločici dok ne pozovete begin(). Primjer prosljeđuje SENSOR_CUSTOM i sabirnicu, a adc_addr i config_pin ostavlja na zadanim vrijednostima.
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Konfiguracija koja se koristi, u primjeru SENSOR_CUSTOM. |
I2C | i2c | Sabirnica koja se koristi. Ako se izostavi, modul bira pinove samo na pločicama koje prepoznaje (ESP32: sabirnica 0, SCL 22, SDA 21; ESP8266: SCL 5, SDA 4), a inače izaziva iznimku. |
int | adc_addr | Adresa s kojom modul komunicira, prema zadanim postavkama 0x49, kao u ovom primjeru. Adresa od 0x30 do 0x37 uzrokuje da begin() koristi naredbe mosta; svaka druga adresa tumači se kao vlastita adresa ADS1115. |
int | config_pin | GPIO pin koji modul drži na visokoj razini i povlači na nisku dok upisuje postavke LMP91000. Prema zadanim postavkama None; ne koristi se za adresu od 0x30 do 0x37. |
sensor.begin()returns boolKonfigurira ADC i LMP91000 prema konfiguraciji senzora. Za adc_addr od 0x30 do 0x37 provjerava odgovara li most na pločici i šalje mu pojačanje ADC-a, najsporiju brzinu podataka ADC-a i postavke LMP91000, ponavljajući svaku naredbu do 500 ms. Za svaku drugu adresu postavlja ADS1115 na toj adresi s istim pojačanjem i brzinom podataka te izravno upisuje postavke LMP91000, pritom povlačeći config_pin na nisku razinu ako je zadan.
ReturnsTrue ako su svi koraci uspjeli, inače False.
sensor.getPPB()returns floatIzvodi jedno očitanje i vraća ga u dijelovima na milijardu (PPB): vrijednost getPPM() pomnožena s 1000. getPPM() oduzima unutarnju nulu (udio referentnih 2,5 V pločice), dodaje internal_zero_calibration, dijeli s TIA pojačanjem i s nano_amperes_per_ppm te vraća 0.0 za negativan rezultat.
ReturnsKoncentracija u PPB.
Sve zajedno
Vrijednosti u SENSOR_CUSTOM iz ispisa vlastiti su rezervirani prostori primjera,
a ne postavke za kisikovu ćeliju SGX-4OX-ROHS na ovoj pločici. Njezin
bias=BIAS_0_PERCENT ne primjenjuje nikakav prednapon, a ćelija ga treba, zato
promijenite konfiguraciju prije nego je upotrijebite s ovom pločicom:
- Ćeliji je potreban prednapon od −600 mV. Uz referentni napon pločice od 2,5 V to je
bias_sign=BIAS_SIGN_NEGATIVEsbias=BIAS_24_PERCENT(24 % od 2,5 V je 0,6 V). UveziteBIAS_24_PERCENTumjestoBIAS_0_PERCENT. - Zadržite
ref_source=REF_EXTERNAL: pločica ima vanjski referentni napon od 2,5 V. - Izlaz ćelije na zraku iznosi 0,1 ± 0,03 mA, a njezin je izlaz logaritamski, S = K ln(1/(1-C)), pa ga linearni izračun PPM-a u modulu ne pretvara izravno u % vol.
Nakon uključivanja napajanja ćeliji može trebati do 15 minuta da se stabilizira, pa je pustite da radi prije nego što povjerujete očitanju.