Skip to main content

Usrednjavanje više očitanja

Što prikazuje ovaj primjer​

Primjer electrochemical-averagedMeasurement.py pokreće jedan senzor s presetom za ozon i ispisuje prosjek pet očitanja, snimljenih u razmaku od 3 sekunde, u dijelovima na milijardu (PPB).

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 izravno komunicira s ADS1115 i LMP91000 preko SDA2 i SCL2; premosnik ATtiny404 na pločici na adresi 0x30 ne koristi se. Preko Qwiic konektora radi samo primjer s premosnikom iz Brzog početka .

Kod primjera​

NUM_READINGS određuje koliko se očitanja uključuje u svaki prosjek, a SECS_BETWEEN_READINGS koliko sekundi biblioteka čeka nakon svakog od njih. Primjer otvara I2C sabirnicu 0 s pinom 22 za SCL i pinom 21 za SDA. Promijenite SENSOR_O3 u preset za svoju ćeliju, kako navodi njegov komentar.

Spojni dijagram u komentarima primjera spaja LMPEN na GND ili na GPIO. Na ovoj pločici LMPEN ide na header i na ATtiny404 na pločici.

# 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 cijeli primjer

Examples/electrochemical-averagedMeasurement.py u commitu 623e1e6

→

Shell prikazuje:

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

Zatim jedan redak Sensor reading: po prosjeku, s pet decimala i PPB. Svaki prosjek uzima pet očitanja s 3 sekunde nakon svakog, dakle oko 15 sekundi, a skripta pravi stanku od 2,5 sekunde prije sljedećeg. 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 njegova modula time. Funkcije u nastavku pripadaju biblioteci.

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

Stvara objekt senzora za jednu pločicu. Biblioteka čita adc_addr kako bi odlučila kako komunicirati: za adresu od 0x30 do 0x37 koristi protokol premosnika ATtiny404; za svaku drugu adresu sama komunicira s ADS1115 na toj adresi i s LMP91000 na 0x48.

ReturnsObjekt senzora.

Parametri

NazivTipOpis
sensor_typeSensorConfigPreset za vašu ćeliju: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 ili vaš vlastiti SensorConfig.
i2cmachine.I2CI2C sabirnica. Ako 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 baca iznimku.
adc_addrintAdresa koju koristi begin(). Raspon od 0x30 do 0x37 odabire protokol premosnika; ova pločica odgovara na 0x30 po tvorničkim postavkama ili na adresi koju postavi njezin prekidač. Svaka druga vrijednost tumači se kao adresa ADS1115. Zadano je 0x49.
config_pinintBroj GPIO-a za liniju omogućavanja LMP91000. Biblioteka ga drži u visokom stanju i spušta ga samo dok sama upisuje registre LMP91000; za adresu od 0x30 do 0x37 ne koristi se. Zadano je None.
begin()returns bool

Postavlja vezu za adc_addr i konfigurira LMP91000 s presetom. Za 0x30 do 0x37 provjerava odgovara li premosnik, šalje pojačanje ADC-a i traži da premosnik upiše registre LMP91000, pri čemu svaki korak odustaje nakon 500 ms. Za svaku drugu adresu I2C skeniranjem provjerava odgovara li uređaj na adc_addr, a zatim upisuje registre LMP91000 na 0x48 kad njegov status pokazuje spremnost.

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

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

Uzima num_measurements očitanja pomoću getPPM(), čekajući seconds_delay sekundi nakon svakog, i vraća njihov prosjek u dijelovima na milijardu. Blokira dok ne završi.

ReturnsUsrednjena koncentracija plina u PPB, getAveragedPPM() x 1000.

Parametri

NazivTipOpis
num_measurementsintKoliko se očitanja usrednjava. Zadano je 5.
seconds_delayintSekunde čekanja nakon svakog očitanja. Zadano je 2.
getAveragedPPM(num_measurements=5, seconds_delay=2)returns float

Isti prosjek u dijelovima na milijun. Primjer ga prikazuje kao zakomentiranu alternativu.

ReturnsUsrednjena koncentracija plina u PPM.

Parametri

NazivTipOpis
num_measurementsintKoliko se očitanja usrednjava. Zadano je 5.
seconds_delayintSekunde čekanja nakon svakog očitanja. Zadano je 2.

Sastavljanje u cjelinu​

Stvorite senzor s presetom za svoju ćeliju i jednom pozovite begin(). Zatim pozovite getAveragedPPB() ili getAveragedPPM() s brojem očitanja i čekanjem između njih. Svaki poziv blokira otprilike num_measurements x seconds_delay sekundi, pa vaša skripta u tom vremenu ne radi ništa drugo.