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:
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 ElectrochemicalGasSensorStvara objekt senzora. Primjer prosljeđuje predložak i I2C sabirnicu, a adc_addr i config_pin ostavlja na zadanim vrijednostima.
ReturnsObjekt senzora.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
sensor_type | SensorConfig | Predložak ćelije. Za SGX-4CO ćeliju ove pločice predložak modula je SENSOR_CO. |
i2c | machine.I2C | Inicijalizirana 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_addr | int | I2C adresa. Zadano 0x49. Od 0x30 do 0x37 modul komunicira s mostom ATtiny404 na pločici. |
config_pin | int ili None | GPIO 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 boolPokreć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 floatUzima 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
| Parametar | Tip | Opis |
|---|---|---|
num_measurements | int | Koliko se očitanja usrednjuje. Zadano 5. |
seconds_delay | int | Sekunde čekanja nakon svakog očitanja. Zadano 2. |
getAveragedPPM(num_measurements=5, seconds_delay=2)returns floatIsti 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
| Parametar | Tip | Opis |
|---|---|---|
num_measurements | int | Koliko se očitanja usrednjuje. Zadano 5. |
seconds_delay | int | Sekunde č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.