Koristite vlastitu konfiguraciju senzora
Što ovaj primjer prikazuje
Primjer electrochemical-customConfig.py iz modula sam izrađuje SensorConfig
umjesto da koristi unaprijed definiranu postavku, pomoću njega stvara senzor i
svakih 2,5 sekunde ispisuje koncentraciju plina u ppb (parts per billion, dijelova na milijardu).
Komentar iznad SENSOR_CUSTOM navodi što koja vrijednost postavlja; uredite ih
prema tehničkom listu svog senzora. Za SGX-4NO2 ćeliju na ovoj pločici
postavka SENSOR_NO2 iz samog modula koristi nano_amperes_per_ppm=-600.0 i
internal_zero_calibration=0, a sve ostalo ima iste vrijednosti kao ovaj primjer.
Primjer otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21;
promijenite ih prema svom kontroleru.
Kôd 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
Očekivani rezultat:
Electrochemical Gas Sensor - Custom Config Example
Sensor initialized successfully!
Zatim primjer svakih 2,5 sekunde ispisuje redak koji počinje s
Sensor reading:, a nakon njega koncentraciju u ppb s pet decimala. Ako
begin() ne uspije, ispisuje ERROR: Can't init the sensor! Check connections!
i čeka 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 SensorConfigSadrži postavke jedne elektrokemijske ćelije: njezinu osjetljivost, nulti pomak, opseg ADS1115 i postavke ulaznog stupnja LMP91000. Unaprijed definirane postavke modula, poput SENSOR_NO2, također su SensorConfig objekti.
ReturnsKonfiguracijski objekt koji se prosljeđuje ElectrochemicalGasSensoru.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
float | nano_amperes_per_ppm | Osjetljivost ćelije u nA po ppm, iz njezina tehničkog lista. |
float | internal_zero_calibration | Pomak u voltima koji getPPM() dodaje izmjerenom naponu. |
int | ads_gain | Puni mjerni opseg ADS1115, jedna od vrijednosti ADS_GAIN_6_144V, ADS_GAIN_4_096V, ADS_GAIN_2_048V, ADS_GAIN_1_024V, ADS_GAIN_0_512V, ADS_GAIN_0_256V iz ads1115.py. |
int | tia_gain | Povratni otpornik transimpedancijskog pojačala (TIA) LMP91000, od TIA_GAIN_2_75_KOHM do TIA_GAIN_350_KOHM, ili TIA_GAIN_EXTERNAL. |
int | rload | Opteretni otpornik, RLOAD_10_OHM, RLOAD_33_OHM, RLOAD_50_OHM ili RLOAD_100_OHM. |
int | ref_source | Izvor referentnog napona, REF_INTERNAL ili REF_EXTERNAL. |
int | internal_zero | Unutarnja nula, INTERNAL_ZERO_20_PERCENT, INTERNAL_ZERO_50_PERCENT, INTERNAL_ZERO_67_PERCENT ili INTERNAL_ZERO_BYPASSED. |
int | bias_sign | Polaritet prednapona, BIAS_SIGN_NEGATIVE ili BIAS_SIGN_POSITIVE. |
int | bias | Prednapon kao postotak referentnog napona, od BIAS_0_PERCENT do BIAS_24_PERCENT. |
int | fet_short | FET kratki spoj, FET_SHORT_DISABLED ili FET_SHORT_ENABLED. |
int | op_mode | Radni način rada LMP91000. OP_MODE_3LEAD_AMP_CELL je uobičajen rad. |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora. S config_pin također postavlja taj pin kao izlaz i postavlja ga u visoko stanje. Ništa se ne šalje preko I2C dok ne pozovete begin().
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Postavke ćelije: unaprijed definirana postavka ili vaš vlastiti SensorConfig. Primjer prosljeđuje SENSOR_CUSTOM. |
I2C | i2c | I2C sabirnica. S None modul odabire pinove prema portu koji MicroPython prijavi: I2C sabirnica 0 na pinovima 22 (SCL) i 21 (SDA) na ESP32 portu, scl=Pin(5), sda=Pin(4) na ESP8266 portu. Na portu koji ne prepoznaje javlja Board not recognized, please pass an I2C object manually. |
int | adc_addr | Adresa s kojom begin() komunicira, prema zadanim postavkama 0x49. Od 0x30 do 0x37 modul šalje naredbe na ATtiny404; od 0x48 do 0x4B izravno se obraća ADS1115 na adc_addr i LMP91000. Primjer ostavlja zadanu vrijednost. |
int | config_pin | Broj GPIO-a za pin za omogućavanje LMP91000 (LMPEN), koristi se samo na 0x48 do 0x4B. Prema zadanim postavkama None; primjer ga ne prosljeđuje. |
sensor.begin()returns boolPokreće senzor i zapisuje konfiguraciju u njega. Na 0x30 do 0x37 provjerava odgovara li ATtiny404, zatim šalje pojačanje ADC-a, brzinu podataka i konfiguraciju LMP91000, a svaki korak se ponavlja dok pločica ne odgovori ili ne prođe 500 ms. Na 0x48 do 0x4B provjerava pojavljuje li se ADS1115 u I2C skeniranju na adc_addr, postavlja njegovo pojačanje i najsporiju brzinu podataka te zapisuje konfiguraciju u LMP91000 na 0x48. Pozovite ga jednom prije čitanja.
ReturnsTrue ako su svi koraci uspjeli, inače False.
sensor.getPPB()returns floatOčitava novu vrijednost i vraća koncentraciju plina u dijelovima na milijardu: očitanje u ppm, izračunato s osjetljivošću, TIA pojačanjem i unutarnjom nulom iz vaše konfiguracije, pomnoženo s 1000. Negativan rezultat vraća se kao 0.0.
ReturnsKoncentracija plina u ppb.
Sve zajedno
Primjer najprije izrađuje SENSOR_CUSTOM, zatim stvara I2C sabirnicu i
senzor s njom. begin() zapisuje ADC opseg konfiguracije i postavke
ulaznog stupnja; ako vrati False, primjer ispisuje pogrešku i ostaje u
petlji. Svaki prolaz glavne petlje poziva getPPB(), ispisuje vrijednost s pet
decimala i čeka 2,5 sekunde.