Izračun prosjeka više očitanja
Što prikazuje ovaj primjer
Primjer electrochemical-averagedMeasurement.py izvodi pet očitanja u razmaku od tri sekunde i ispisuje njihov prosjek u ppb (dijelovi na milijardu). Jedna usrednjena vrijednost izglađuje male razlike između pojedinačnih očitanja.
Primjer stvara senzor samo s postavkom ćelije i I2C sabirnicom, pa modul koristi zadanu adresu, 0x49. Otvara I2C sabirnicu 0 s SCL na pinu 22 i SDA na pinu 21; ako se pinovi I2C vašeg kontrolera razlikuju, promijenite te brojeve pinova. Na adresi 0x49 modul komunicira izravno s ADS1115 i LMP91000, a ne preko ATtiny404 mosta na pločici, a komentari u primjeru traže da LMPEN bude spojen na GND ili na GPIO. Pogledajte
pregled biblioteke
da biste saznali kako adresa to određuje.
Primjer koristi SENSOR_O3, postavku modula za ćeliju za ozon. Za očitanje dušikova monoksida upotrijebite SENSOR_NO na oba mjesta (u retku import i u retku ElectrochemicalGasSensor(...)). SENSOR_NO je postavka za ćeliju SGX-4NO-250 na ovoj pločici: 400 nA po ppm, pojačanje pojačala od 120 kΩ i pozitivan pomak (bias) od 12 %.
Kôd primjera
Ispis je datoteka modula na pričvršćenom commitu. Izostavljeni su samo retci komentara: zaglavni redak koji navodi stranicu trgovine drugog proizvoda i redak s dijagramom spajanja koji navodi staru pločicu.
# FILE: electrochemical-averagedMeasurement.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Averaged PPM reading example using the built-in averaging function.
# LAST UPDATED: 2026-05-21
# Connecting diagram:
#
# Qwiic------------------------>Qwiic
# LMPEN------------------------>GND or GPIO pin (see config_pin parameter below)
from machine import I2C, Pin
import time
from ElectrochemicalGasSensor import ElectrochemicalGasSensor, SENSOR_O3
# How many readings to average and how many seconds to wait between them
NUM_READINGS = 5
SECS_BETWEEN_READINGS = 3
# Initialize I2C
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
# Create sensor object - change SENSOR_O3 to match your sensor type
# Available types: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3,
# SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2
sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c)
# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Averaged Measurement 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:
# getAveragedPPM is a blocking call — it waits between each reading
reading = sensor.getAveragedPPB(NUM_READINGS, SECS_BETWEEN_READINGS)
# If PPM is more relevant for your sensor, use:
# reading = sensor.getAveragedPPM(NUM_READINGS, SECS_BETWEEN_READINGS)
print("Sensor reading: {:.5f} PPB".format(reading))
time.sleep_ms(2500)
🔗Otvorite cjeloviti primjer
Examples/electrochemical-averagedMeasurement.py na commitu 623e1e6
Očekivani rezultat sa SENSOR_NO (očitanja na čistom zraku; vaša će se razlikovati):
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!
Sensor reading: 5.94850 PPB
Sensor reading: 5.85231 PPB
Sensor reading: 6.31483 PPB
Svaki redak Sensor reading: jedan je prosjek, s koncentracijom u ppb na pet decimala i oznakom PPB na kraju. Svaki prosjek uzima pet očitanja s pauzom od 3 sekunde nakon svakog, a primjer zatim čeka još 2,5 sekunde, pa se novi redak pojavljuje otprilike svakih 17,5 sekundi. Ako begin() ne uspije, primjer ispisuje
ERROR: Can't init the sensor! Check connections! i ostaje u petlji.
Korištene funkcije
I2C(0, scl=Pin(22), sda=Pin(21))returns I2CStvara sklopovsku I2C sabirnicu 0 na zadanim pinovima SCL i SDA. machine.I2C i machine.Pin dolaze s MicroPythonom i nisu dio Soldered modula (pogledajte docs.micropython.org, machine.I2C i machine.Pin).
ReturnsObjekt I2C sabirnice koji prosljeđujete senzoru.
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 preko I2C dok ne pozovete begin(). Uz i2c=None modul sam otvara sabirnicu na pločicama koje prepoznaje, uključujući ESP32, na kojem otvara I2C(0, scl=Pin(22), sda=Pin(21)), i ESP8266, na kojem otvara I2C(scl=Pin(5), sda=Pin(4)). Na pločici koju ne prepoznaje javlja iznimku.
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Postavka ćelije, u primjeru SENSOR_O3. Za ćeliju na ovoj pločici koristi se SENSOR_NO. Modul ima i SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_H2S, SENSOR_NH3 i SENSOR_CL2. |
I2C | i2c | I2C sabirnica na kojoj se nalazi pločica. |
int | adc_addr | I2C adresa. U primjeru je izostavljena, pa vrijedi zadana adresa modula, 0x49. Za 0x30 do 0x37 modul komunicira s ATtiny404 mostom na pločici; za bilo koju drugu adresu komunicira s ADS1115 na toj adresi i izravno s LMP91000. |
int | config_pin | GPIO za LMPEN. U primjeru je izostavljen (None), pa modul ne prebacuje nijedan pin. |
sensor.begin()returns boolZa adresu od 0x30 do 0x37 provjerava odgovara li most na pločici i preko njega šalje postavke ADC-a i ulaznog sklopa, čekajući do 500 ms za svaki korak. Za bilo koju drugu adresu provjerava odgovara li ADS1115 na adresi adc_addr u I2C skeniranju, postavlja ADC pojačanje iz postavke ćelije i najsporiju brzinu podataka, zatim konfigurira LMP91000 na 0x48 (pojačanje, opterećenje, referencu, unutarnju nulu, bias i način rada), pri čemu config_pin spušta na nisku razinu samo tijekom te konfiguracije, ako je zadan.
ReturnsTrue ako su svi koraci uspjeli, inače False.
sensor.getAveragedPPB(num_measurements=5, seconds_delay=2)returns floatUzima num_measurements očitanja funkcijom getPPM(), čekajući seconds_delay sekundi nakon svakog, i vraća njihov prosjek pomnožen s 1000. Blokira dok se sva očitanja ne završe.
ReturnsUsrednjena koncentracija plina u ppb.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | num_measurements | Koliko se očitanja usrednjava, u primjeru NUM_READINGS (5). |
int | seconds_delay | Sekunde čekanja nakon svakog očitanja, u primjeru SECS_BETWEEN_READINGS (3). |
sensor.getAveragedPPM(num_measurements=5, seconds_delay=2)returns floatAlternativa koju nudi komentar u primjeru: isti prosjek u ppm. Svako očitanje je jedan getPPM(): čita ADC kanal 0 (na 0x30 do 0x37 pretvorbu izvodi most), oduzima unutarnju nulu (2,5 V puta postotak unutarnje nule iz postavke ćelije), dodaje kalibraciju nule te dijeli s pojačanjem pojačala i s nA po ppm iz postavke ćelije. Negativno očitanje računa se kao 0.0.
ReturnsUsrednjena koncentracija plina u ppm.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | num_measurements | Koliko se očitanja usrednjava. |
int | seconds_delay | Sekunde čekanja nakon svakog očitanja. |
Sve zajedno
begin() se izvodi jednom prije petlje. Ako vrati False, primjer ispisuje pogrešku i čeka zauvijek, pa problem odmah vidite. U petlji getAveragedPPB() blokira dok prikuplja pet očitanja, a zatim primjer ispisuje prosjek i čeka 2,5 sekunde prije sljedećeg.