Konfigurirajte vlastitu ćeliju
Što prikazuje ovaj primjer
Primjer electrochemical-customConfig.py gradi vlastiti SensorConfig
umjesto korištenja gotove postavke, pa možete postaviti svaku vrijednost iz
tehničkog lista svoje ćelije. Zatim ispisuje koncentraciju plina u dijelovima na milijardu (PPB)
svakih 2,5 sekundi.
Za ovaj primjer povežite kontroler na gornji header, a ne na Qwiic
konektor: SDA kontrolera na SDA2, SCL na SCL2, napajanje od 3,3 V
na 3V3 i masu na GND. Na ovoj adresi biblioteka komunicira s ADS1115 i LMP91000 izravno preko SDA2 i SCL2; ATtiny404 most na pločici na adresi 0x30
se ne koristi. Preko
Qwiic konektora radi samo primjer s mostom iz
Brzog početka
.
Kôd primjera
Vrijednosti u SENSOR_CUSTOM jesu gotova postavka biblioteke za ozon, SENSOR_O3.
Zamijenite ih osjetljivošću svoje ćelije i postavkama LMP91000 koje su joj potrebne;
komentar iznad SENSOR_CUSTOM navodi raspon svake od njih. Primjer
otvara I2C sabirnicu 0 s SCL na pinu 22 i SDA na pinu 21.
Dijagram povezivanja u komentarima primjera povezuje LMPEN na GPIO. Na
ovoj pločici LMPEN ide na header i na ATtiny404 na pločici.
# 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
Konzola prikazuje:
Electrochemical Gas Sensor - Custom Config Example
Sensor initialized successfully!
Zatim svake 2,5 sekunde redak: Sensor reading: , koncentracija s pet
decimala i PPB. Ako begin() ne uspije, skripta ispisuje
ERROR: Can't init the sensor! Check connections! i čeka.
Korištene funkcije
I2C i Pin dolaze iz MicroPythonova vlastitog modula machine, a
time.sleep_ms() iz modula time. ADS_GAIN_2_048V dolazi iz
pomoćne datoteke biblioteke ads1115.py, a ostale konstante iz
ElectrochemicalGasSensor.py. Funkcije u nastavku pripadaju biblioteci.
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: vrijednosti koje biblioteka koristi za pretvorbu napona u koncentraciju te vrijednosti registara koje šalje ADS1115 i LMP91000. Gotove postavke poput SENSOR_O3 također su objekti SensorConfig.
ReturnsKonfiguracijski objekt, proslijeđen funkciji ElectrochemicalGasSensor() kao sensor_type.
Parametri
| Name | Type | Description |
|---|---|---|
nano_amperes_per_ppm | float | Osjetljivost ćelije u nA po PPM, iz njezina tehničkog lista. Postavke biblioteke za NO2 i O3 koriste negativne vrijednosti. |
internal_zero_calibration | float | Naponski pomak dodan svakom očitanju, ista vrijednost koju postavlja setCustomZeroCalibration(). |
ads_gain | int | Puni mjerni raspon ADS1115: ADS_GAIN_6_144V, ADS_GAIN_4_096V, ADS_GAIN_2_048V, ADS_GAIN_1_024V, ADS_GAIN_0_512V ili ADS_GAIN_0_256V, iz ads1115. |
tia_gain | int | Povratni otpornik pojačala LMP91000: TIA_GAIN_2_75_KOHM, TIA_GAIN_3_5_KOHM, TIA_GAIN_7_KOHM, TIA_GAIN_14_KOHM, TIA_GAIN_35_KOHM, TIA_GAIN_120_KOHM, TIA_GAIN_350_KOHM ili TIA_GAIN_EXTERNAL. |
rload | int | Opteretni otpornik: RLOAD_10_OHM, RLOAD_33_OHM, RLOAD_50_OHM ili RLOAD_100_OHM. |
ref_source | int | Referenca: REF_INTERNAL ili REF_EXTERNAL. |
internal_zero | int | Unutarnja nula kao udio reference: INTERNAL_ZERO_20_PERCENT, INTERNAL_ZERO_50_PERCENT, INTERNAL_ZERO_67_PERCENT ili INTERNAL_ZERO_BYPASSED. |
bias_sign | int | Polaritet pristranskog napona: BIAS_SIGN_NEGATIVE ili BIAS_SIGN_POSITIVE. |
bias | int | Pristranski napon kao udio reference, od BIAS_0_PERCENT do BIAS_24_PERCENT. |
fet_short | int | FET_SHORT_DISABLED ili FET_SHORT_ENABLED. |
op_mode | int | Način rada LMP91000: OP_MODE_3LEAD_AMP_CELL za normalan rad ili OP_MODE_DEEP_SLEEP, OP_MODE_2LEAD_GROUND_CELL, OP_MODE_STANDBY, OP_MODE_TEMPERATURE_TIA_OFF, OP_MODE_TEMPERATURE_TIA_ON. |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora za jednu pločicu. Biblioteka čita adc_addr kako bi odlučila kako komunicirati: za adresu od 0x30 do 0x37 koristi protokol ATtiny404 mosta; za svaku drugu adresu sama komunicira s ADS1115 na toj adresi i s LMP91000 na 0x48.
ReturnsObjekt senzora.
Parametri
| Name | Type | Description |
|---|---|---|
sensor_type | SensorConfig | Ovdje vlastiti SENSOR_CUSTOM iz primjera. |
i2c | machine.I2C | I2C sabirnica. Kad se izostavi, biblioteka otvara I2C sabirnicu 0 s SCL na pinu 22 i SDA na pinu 21 na ESP32 portu, odnosno I2C s SCL na pinu 5 i SDA na pinu 4 na ESP8266 portu, a na bilo kojoj drugoj pločici izaziva iznimku. |
adc_addr | int | Adresa koju koristi begin(). Adrese od 0x30 do 0x37 biraju protokol mosta; ova pločica odgovara na 0x30 u tvorničkim postavkama ili na adresi koju postavi njezin prekidač. Svaka druga vrijednost tumači se kao adresa ADS1115. Zadano je 0x49. |
config_pin | int | Broj GPIO-a za liniju omogućivanja LMP91000. Biblioteka je drži visokom i spušta je samo dok sama upisuje registre LMP91000; za adresu od 0x30 do 0x37 ne koristi se. Zadano None. |
begin()returns boolPostavlja vezu za adc_addr i konfigurira LMP91000 pojačanjem, opterećenjem, referencom, pristranskim naponom i načinom rada iz konfiguracije. Za 0x30 do 0x37 provjerava odgovara li most, šalje pojačanje ADC-a i traži da most upiše registre LMP91000, a svaki korak odustaje nakon 500 ms. Za svaku drugu adresu I2C skeniranjem provjerava odgovara li uređaj na adc_addr, zatim upisuje registre LMP91000 na 0x48 kad njegov status pokazuje spremnost.
ReturnsTrue ako su svi koraci uspjeli, inače False.
getPPB()returns floatOčitava kanal 0 ADS1115 jednom (preko mosta za 0x30 do 0x37) i pretvara ga u koncentraciju prema konfiguraciji: uklanja pomak unutarnje nule, dodaje kalibraciju nule, dijeli s pojačanjem pojačala i osjetljivošću u nA po PPM te množi s 1000. Negativan rezultat vraća se kao 0.
ReturnsKoncentracija plina u PPB.
Sve zajedno
Izgradite SensorConfig iz tehničkog lista svoje ćelije i proslijedite ga funkciji
ElectrochemicalGasSensor() tamo gdje biste proslijedili gotovu postavku. begin() šalje
njegove postavke LMP91000, a getPPB() koristi njegovu osjetljivost i vrijednosti nule
za svako očitanje.