Skip to main content

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):

ShellMicroPython
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 I2C

Stvara 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

TipNazivOpis
intidSklopovska I2C sabirnica, u primjeru 0.
PinsclPin takta, u primjeru Pin(22).
PinsdaPin podataka, u primjeru Pin(21).
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Stvara 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

TipNazivOpis
SensorConfigsensor_typePostavka ć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.
I2Ci2cI2C sabirnica na kojoj se nalazi pločica.
intadc_addrI2C 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.
intconfig_pinGPIO za LMPEN. U primjeru je izostavljen (None), pa modul ne prebacuje nijedan pin.
sensor.begin()returns bool

Za 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 float

Uzima 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

TipNazivOpis
intnum_measurementsKoliko se očitanja usrednjava, u primjeru NUM_READINGS (5).
intseconds_delaySekunde čekanja nakon svakog očitanja, u primjeru SECS_BETWEEN_READINGS (3).
sensor.getAveragedPPM(num_measurements=5, seconds_delay=2)returns float

Alternativa 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

TipNazivOpis
intnum_measurementsKoliko se očitanja usrednjava.
intseconds_delaySekunde č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.