Usrednjeno mjerenje
Što prikazuje ovaj primjer
Primjer electrochemical-averagedMeasurement.py iz biblioteke očitava pet vrijednosti u razmaku od tri sekunde i ispisuje njihov prosjek u ppb (parts per billion, dijelova na milijardu). Usrednjavanje ublažava šum u malom signalu.
Primjer stvara senzor s predloškom ćelije za ozon, SENSOR_O3. SENSOR_SO2 je predložak biblioteke za SO2 ćeliju ove pločice: zamijenite SENSOR_O3 s SENSOR_SO2 u retku import i u retku koji stvara sensor da biste dobili SO2 vrijednosti. Skripta stvara I2C sabirnicu na GPIO 22 (SCL) i GPIO 21 (SDA); promijenite te brojeve ako vaša pločica koristi druge pinove.
Na ovoj pločici LMP91000 i ADS1115 nalaze se na vlastitoj sabirnici 2 pločice, a vaš kontroler im pristupa preko adrese pločice na Qwiic sabirnici: 0x30 kako se isporučuje, 0x30 do 0x37 pomoću prekidača ADDRESS. Primjer ne prosljeđuje adc_addr, pa koristi zadanu vrijednost modula, 0x49, koja komunicira izravno s ADS1115. Proslijedite adresu pločice kao adc_addr, na primjer sensor = ElectrochemicalGasSensor(SENSOR_SO2, i2c, adc_addr=0x30). Gdje dijagram spajanja kaže da LMPEN ide na GND ili na GPIO pin, na ovoj je pločici LMPEN već spojen na GND otpornikom od 10 kΩ i vodi se i do mikrokontrolera na pločici, a na adresama pločice modul ne koristi config_pin (pogledajte Detalji o hardveru).
Ispis je datoteka iz biblioteke na zapisanom commitu, osim dvaju redaka koji sadrže samo komentare, a koji povezuju na drugi Soldered proizvod ili u dijagramu spajanja imenuju kontrolersku pločicu; oni su izostavljeni.
Primjer koda
# 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
electrochemical-averagedMeasurement.py na zapisanom commitu
Očekivani rezultat:
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!
Zatim se za svaki skup od pet očitanja pojavljuje redak Sensor reading: s usrednjenom koncentracijom u ppb. Svaki skup traje 15 sekundi, a skripta čeka još 2,5 sekunde prije sljedećeg skupa.
Korištene funkcije
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora iz predloška ćelije, objekta I2C, adrese i neobveznog pina za omogućavanje. Primjer prosljeđuje samo predložak i objekt I2C, pa je adresa zadana, 0x49.
ReturnsObjekt senzora.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
sensor_type | SensorConfig | Predložak ćelije. SENSOR_SO2 je predložak za ćeliju ove pločice. |
i2c | I2C | Inicijalizirani objekt machine.I2C. |
adc_addr | int | Adresa s kojom modul komunicira. Adrese od 0x30 do 0x37 odabiru premosni način rada modula, koji komunicira s mikrokontrolerom na pločici; svaka druga vrijednost komunicira izravno s ADS1115 na toj adresi. Zadano 0x49. |
config_pin | int | GPIO za liniju za omogućavanje LMP91000. Ne koristi se na adresama od 0x30 do 0x37. Zadano None. |
begin()returns boolProvjerava odgovara li pločica i šalje joj postavke ADC-a i LMP91000 iz predloška.
ReturnsTrue ako je pločica odgovorila i prihvatila sve postavke, inače False.
getAveragedPPB(num_measurements=5, seconds_delay=2)returns floatUsrednjuje nekoliko očitanja i vraća rezultat u dijelovima na milijardu. Nakon svakog očitanja čeka zadani broj sekundi i blokira izvođenje dok ne završi.
ReturnsUsrednjena koncentracija plina u ppb.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
num_measurements | int | Koliko očitanja treba usrednjiti. 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. Primjer ga prikazuje u komentaru kao alternativu.
ReturnsUsrednjena koncentracija plina u ppm.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
num_measurements | int | Koliko očitanja treba usrednjiti. Zadano 5. |
seconds_delay | int | Sekunde čekanja nakon svakog očitanja. Zadano 2. |
Sve zajedno
Raspon SO2 ćelije je od 0 do 20 ppm, pa je ppm često praktičnija jedinica. Da biste ispisali ppm, zamijenite dva retka reading = i promijenite PPB u PPM u retku print("Sensor reading: ...") kako bi oznaka odgovarala vrijednosti. Poziv blokira izvođenje NUM_READINGS x SECS_BETWEEN_READINGS sekundi.