Skip to main content

Usrednjeno mjerenje

Što ovaj primjer prikazuje​

Primjer electrochemical-averagedMeasurement.py usrednjuje pet očitanja snimljenih u razmaku od tri sekunde i ispisuje rezultat u dijelovima na milijardu (ppb).

Prije pokretanja promijenite SENSOR_O3 u SENSOR_CO u retku import i u retku koji stvara senzor, kako kaže komentar u primjeru: "change SENSOR_O3 to match your sensor type". SENSOR_O3 je predložak modula za ćeliju za ozon. Ova pločica nosi SGX-4CO ćeliju za ugljikov monoksid, a predložak modula za nju je SENSOR_CO. S predloškom za ozon modul pretvara očitanja pomoću osjetljivosti i nule ćelije za ozon, pa prosjeci nisu koncentracije CO.

Primjer otvara I2C sabirnicu 0 s SCL na pinu 22 i SDA na pinu 21. Promijenite ih u I2C pinove svojeg kontrolera ako se razlikuju. NUM_READINGS i SECS_BETWEEN_READINGS na vrhu određuju koliko se očitanja usrednjuje i koliko se čeka među njima.

Što je potrebno na ovoj pločici​

Primjer stvara senzor bez adc_addr, pa modul koristi zadanu adresu, 0x49. Na adresi izvan raspona od 0x30 do 0x37 modul ne ide preko mosta pločice: begin() traži ADS1115 na toj adresi I2C skeniranjem, zatim upisuje konfiguraciju LMP91000 na 0x48, oboje na sabirnici koju mu proslijedite. Na ovoj pločici ta se dva čipa nalaze na internoj sabirnici, koju gornji header izvodi kao SDA2 i SCL2. Qwiic konektori i SDA1/SCL1 dosežu samo most ATtiny404, a I2C skeniranje preko Qwiic konektora pronalazi samo most, na adresi 0x30 kako se isporučuje. Primjer ne prosljeđuje config_pin, a LMPEN je na pločici spojen na GND; pogledajte Detalji o hardveru.

Zato za ovaj primjer spojite gornji header, a ne Qwiic kabel: spojite SDA svojeg kontrolera na SDA2, SCL na SCL2, pin od 3,3 V na 3V3, a GND na GND. Dijagram spajanja u ispisu prikazuje Qwiic liniju, ali preko Qwiic konektora odgovara samo most.

Adresa mosta, od 0x30 do 0x37, ona je koju prosljeđuje primjer Očitavanje koncentracije CO.

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

Retci u nastavku potječu iz pokretanja ovog primjera na ovoj pločici, s kontrolerom spojenim na pinove headera SDA2, SCL2, 3V3 i GND kako je opisano gore.

Očekivani rezultat u Thonny konzoli:

ShellMicroPython
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!
Sensor reading: 291.79010 PPB
Sensor reading: 300.63653 PPB
Sensor reading: 294.22868 PPB

Svaki prosjek uzima pet očitanja uz čekanje od 3 sekunde nakon svakog, a petlja zatim čeka još 2,5 sekunde, pa novi redak stiže otprilike svakih 17,5 sekundi: Sensor reading: , usrednjena koncentracija u ppb s pet decimala i PPB. Ako begin() ne uspije, konzola prikazuje ERROR: Can't init the sensor! Check connections! i skripta se ondje zaustavlja.

Korištene funkcije​

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

Stvara objekt senzora. Primjer prosljeđuje predložak i I2C sabirnicu, a adc_addr i config_pin ostavlja na zadanim vrijednostima.

ReturnsObjekt senzora.

Parametri

ParametarTipOpis
sensor_typeSensorConfigPredložak ćelije. Za SGX-4CO ćeliju ove pločice predložak modula je SENSOR_CO.
i2cmachine.I2CInicijalizirana I2C sabirnica. S None modul otvara I2C 0 na pinovima 22 i 21 na ESP32, odnosno pinovima 5 i 4 na ESP8266, a na bilo kojoj drugoj pločici javlja Board not recognized, please pass an I2C object manually.
adc_addrintI2C adresa. Zadano 0x49. Od 0x30 do 0x37 modul komunicira s mostom ATtiny404 na pločici.
config_pinint ili NoneGPIO koji modul postavlja u nisko stanje dok šalje konfiguraciju prednjeg stupnja, a inače u visoko. Ne koristi se na adresi od 0x30 do 0x37. Zadano None.
begin()returns bool

Pokreće senzor. Na adc_addr od 0x30 do 0x37 provjerava odgovara li most, šalje mu pojačanje ADC-a i brzinu podataka iz predloška, zatim konfiguraciju prednjeg stupnja, pri čemu ponavlja pokušaj nakon greške sabirnice do isteka vremena od 500 ms za svaki korak. Na bilo kojoj drugoj adc_addr provjerava odgovara li ADC na toj adresi, postavlja mu pojačanje i brzinu podataka, zatim upisuje konfiguraciju prednjeg stupnja.

ReturnsTrue ako je svaki korak uspio, inače False.

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

Uzima num_measurements očitanja, čekajući seconds_delay sekundi nakon svakog, i vraća njihov prosjek u dijelovima na milijardu. Blokira dok se ne završe sva očitanja.

ReturnsgetAveragedPPM() s istim argumentima, pomnožen s 1000.

Parametri

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

Isti prosjek u ppm: zbraja num_measurements rezultata funkcije getPPM(), pri čemu nakon svakog čeka seconds_delay sekundi, i dijeli sa num_measurements. Primjer ga prikazuje kao alternativu u komentaru.

ReturnsUsrednjena koncentracija u ppm.

Parametri

ParametarTipOpis
num_measurementsintKoliko se očitanja usrednjuje. Zadano 5.
seconds_delayintSekunde čekanja nakon svakog očitanja. Zadano 2.

Sve zajedno​

Stvorite objekt s SENSOR_CO, predloškom za ćeliju ove pločice, jednom pozovite begin() i provjerite rezultat, zatim u petlji pozovite getAveragedPPB() ili getAveragedPPM(). Svaki poziv traje num_measurements puta seconds_delay sekundi.