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:
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 ElectrochemicalGasSensorStvara 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
| Naziv | Tip | Opis |
|---|---|---|
sensor_type | SensorConfig | Preset za vašu ćeliju: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 ili vaš vlastiti SensorConfig. |
i2c | machine.I2C | I2C 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_addr | int | Adresa 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_pin | int | Broj 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 boolPostavlja 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 floatUzima 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
| Naziv | Tip | Opis |
|---|---|---|
num_measurements | int | Koliko se očitanja usrednjava. Zadano je 5. |
seconds_delay | int | Sekunde čekanja nakon svakog očitanja. Zadano je 2. |
getAveragedPPM(num_measurements=5, seconds_delay=2)returns floatIsti prosjek u dijelovima na milijun. Primjer ga prikazuje kao zakomentiranu alternativu.
ReturnsUsrednjena koncentracija plina u PPM.
Parametri
| Naziv | Tip | Opis |
|---|---|---|
num_measurements | int | Koliko se očitanja usrednjava. Zadano je 5. |
seconds_delay | int | Sekunde č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.