Skip to main content

Usrednjavanje više očitanja

Što ovaj primjer prikazuje​

Primjer modula electrochemical-averagedMeasurement.py izvodi pet očitanja u razmaku od tri sekunde, izračunava njihov prosjek i ispisuje rezultat u ppb (dijelovi na milijardu).

Primjer koristi preset za ozon, SENSOR_O3, a njegov komentar traži da ga promijenite prema svojem senzoru. SENSOR_NO2 je preset modula za SGX-4NO2 ćeliju ove pločice; promijenite ga u retku import i u retku koji stvara senzor. Primjer otvara I2C sabirnicu 0 s pinom SCL na pinu 22 i pinom SDA na pinu 21; promijenite ih prema svojem kontroleru. NUM_READINGS i SECS_BETWEEN_READINGS na vrhu određuju koliko se očitanja uključuje u svaki prosjek i koliko se čeka između njih.

Kôd primjera​

# 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 u commitu 623e1e6

→

Očekivani rezultat:

ShellMicroPython
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!

Zatim primjer ispisuje redak koji počinje s Sensor reading:, a iza njega slijedi usrednjena koncentracija u ppb s pet decimala. Svaki prosjek čeka tri sekunde nakon svakog od svojih pet očitanja, a petlja zatim čeka još 2,5 sekunde, pa se novi redak pojavljuje najmanje svakih 17,5 sekunda. Ako begin() ne uspije, ispisuje ERROR: Can't init the sensor! Check connections! i čeka u petlji.

Korištene funkcije​

ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Stvara objekt senzora. S parametrom config_pin taj pin dodatno postavlja kao izlaz i postavlja ga u visoko stanje. Ništa se ne šalje preko I2C sabirnice dok ne pozovete begin().

ReturnsObjekt senzora.

Parametri

TipNazivOpis
SensorConfigsensor_typePreset ćelije. SENSOR_NO2 je preset za SGX-4NO2 ćeliju ove pločice.
I2Ci2cI2C sabirnica. S vrijednošću None modul bira 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.
intadc_addrAdresa s kojom begin() komunicira, prema zadanim postavkama 0x49; primjer je ostavlja na zadanoj vrijednosti. Od 0x30 do 0x37 modul šalje naredbe ATtiny404 čipu; od 0x48 do 0x4B izravno se obraća ADS1115 čipu na adc_addr i LMP91000 čipu.
intconfig_pinGPIO broj pina za omogućivanje LMP91000 čipa (LMPEN), koristi se samo od 0x48 do 0x4B. Prema zadanim postavkama None; primjer ga ne prosljeđuje.
sensor.begin()returns bool

Pokreće senzor i upisuje u njega preset. Na adresama od 0x30 do 0x37 provjerava odgovara li ATtiny404, zatim šalje pojačanje ADC-a, brzinu podataka i konfiguraciju LMP91000 čipa; svaki se korak ponavlja dok pločica ne odgovori ili ne prođe 500 ms. Na adresama od 0x48 do 0x4B provjerava pojavljuje li se ADS1115 u I2C skeniranju na adc_addr, postavlja njegovo pojačanje i najsporiju brzinu podataka te upisuje konfiguraciju u LMP91000 na 0x48. Pozovite ga jednom prije očitavanja.

ReturnsTrue ako su svi koraci uspjeli, inače False.

sensor.getAveragedPPB(num_measurements=5, seconds_delay=2)returns float

Isti prosjek kao getAveragedPPM(), pomnožen s 1000. Blokira dok se ne izvedu sva očitanja.

ReturnsUsrednjena koncentracija plina u ppb.

Parametri

TipNazivOpis
intnum_measurementsKoliko se očitanja usrednjava. Prema zadanim postavkama 5; primjer prosljeđuje NUM_READINGS (5).
intseconds_delaySekunde čekanja nakon svakog očitanja. Prema zadanim postavkama 2; primjer prosljeđuje SECS_BETWEEN_READINGS (3).
sensor.getAveragedPPM(num_measurements=5, seconds_delay=2)returns float

Poziva getPPM() num_measurements puta, nakon svakog očitanja čeka seconds_delay sekundi i vraća prosjek. Blokira dok se ne izvedu sva očitanja. Primjer je u komentaru navodi kao redak koji treba koristiti kada vašem senzoru više odgovara ppm.

ReturnsUsrednjena koncentracija plina u ppm.

Parametri

TipNazivOpis
intnum_measurementsKoliko se očitanja usrednjava. Prema zadanim postavkama 5.
intseconds_delaySekunde čekanja nakon svakog očitanja. Prema zadanim postavkama 2.

Sve zajedno​

Primjer prvo stvara I2C sabirnicu i prosljeđuje je senzoru, pa ne ovisi o zadanim pinovima porta. Ako begin() vrati False, ispisuje pogrešku i ostaje u petlji. U suprotnom svaki prolaz glavne petlje poziva getAveragedPPB(), koja prije povratka izvede sva pet očitanja, ispisuje prosjek s pet decimala i čeka 2,5 sekunde.