Usrednjeno očitanje
Što ovaj primjer prikazuje
Primjer electrochemical-averagedMeasurement.py usrednjuje nekoliko očitanja
prije nego što ispiše jedno. Uzima NUM_READINGS (5) očitanja s
SECS_BETWEEN_READINGS (3) sekunde između njih, ispisuje prosjek u PPB,
zatim čeka 2,5 sekunde i počinje ponovno. Ne prosljeđuje adresu, pa konstruktor
koristi zadanu vrijednost, adc_addr=0x49.
Primjer otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21. Promijenite
ih na pinove koje koristi Qwiic konektor vašeg kontrolera ili vaše ožičenje.
Na ovoj pločici ne morate spajati LMPEN, bez obzira na komentare u primjeru:
pločica ga sama drži na niskoj razini.
Kôd 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)
🔗Otvorite cijeli primjer
Examples/electrochemical-averagedMeasurement.py u commitu 623e1e6
Što ova pločica ispisuje s primjerom u zadanom obliku, još nije izmjereno.
Kad je ova pločica testirana preko Qwiic konektora, I2C pretraga pronašla je samo jednu adresu,
0x30, a begin() nije uspio za senzor stvoren na 0x49, zadanoj adresi koju
koristi ovaj primjer. Ako begin() ne uspije, primjer nakon naslovne linije ispisuje
ERROR: Can't init the sensor! Check connections! i tu se zaustavlja.
Kad begin() uspije, shell prikazuje:
Electrochemical Gas Sensor - Averaged Measurement Example
Sensor initialized successfully!
Nakon toga se redak Sensor reading: iza kojeg slijedi vrijednost s pet decimala
i PPB pojavljuje jednom po krugu od pet očitanja.
Korištene funkcije
I2C(id, scl, sda)returns I2CStvara objekt I2C sabirnice iz MicroPythonova modula machine, koji koristi objekt senzora. Primjer koristi sabirnicu 0 sa SCL na Pin(22) i SDA na Pin(21). I2C i Pin dolaze s MicroPythonom i nisu dio ove biblioteke.
ReturnsObjekt I2C sabirnice.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | id | Sklopovska I2C sabirnica, u primjeru 0. |
Pin | scl | Pin takta, u primjeru Pin(22). |
Pin | sda | Pin podataka, u primjeru Pin(21). |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora. Ništa se ne šalje na pločicu dok ne pozovete begin(). Primjer prosljeđuje konfiguraciju senzora i sabirnicu, a adc_addr i config_pin ostavlja na zadanim vrijednostima.
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Postavke ulaznog stupnja i konverzije, npr. SENSOR_O3. Predlošci su definirani u ElectrochemicalGasSensor.py. |
I2C | i2c | Sabirnica koja se koristi. Ako je izostavljena, modul bira pinove samo na pločicama koje prepoznaje (ESP32: sabirnica 0, SCL 22, SDA 21; ESP8266: SCL 5, SDA 4), a inače baca iznimku. |
int | adc_addr | Adresa s kojom modul komunicira, prema zadanim postavkama 0x49, kao u ovom primjeru. Adresa od 0x30 do 0x37 uzrokuje da begin() koristi naredbe mosta; svaka druga adresa uzima se kao vlastita adresa ADS1115. |
int | config_pin | GPIO pin koji modul drži na visokoj razini i spušta na nisku dok upisuje postavke LMP91000. Prema zadanim postavkama None; ne koristi se za adresu od 0x30 do 0x37. |
sensor.begin()returns boolKonfigurira ADC i LMP91000 prema konfiguraciji senzora. Za adc_addr od 0x30 do 0x37 provjerava odgovara li most na pločici te mu šalje pojačanje ADC-a, najsporiju brzinu podataka ADC-a i postavke LMP91000, ponavljajući svaku naredbu do 500 ms. Za svaku drugu adresu postavlja ADS1115 na toj adresi s istim pojačanjem i brzinom podataka te izravno upisuje postavke LMP91000, pri čemu spušta config_pin na nisku razinu ako je zadan.
ReturnsTrue ako su svi koraci uspjeli, inače False.
sensor.getAveragedPPB(num_measurements=5, seconds_delay=2)returns floatVraća prosjek nekoliko očitanja u dijelovima na milijardu: rezultat getAveragedPPM() pomnožen s 1000. Blokira dok se ne izvrše sva očitanja.
ReturnsUsrednjena koncentracija u PPB.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | num_measurements | Koliko očitanja se usrednjuje, u primjeru NUM_READINGS (5). |
int | seconds_delay | Sekunde čekanja nakon svakog očitanja, u primjeru SECS_BETWEEN_READINGS (3). |
sensor.getAveragedPPM(num_measurements=5, seconds_delay=2)returns floatAlternativa u primjeru koja je pretvorena u komentar. Uzima num_measurements očitanja getPPM(), nakon svakog čeka seconds_delay sekundi i vraća njihovu srednju vrijednost. Očitanje getPPM() ispod nule računa se kao 0.0.
ReturnsUsrednjena koncentracija u PPM.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | num_measurements | Koliko očitanja se usrednjuje. |
int | seconds_delay | Sekunde čekanja nakon svakog očitanja. |
Sve zajedno
SENSOR_O3 je predložak za ćeliju ozona SGX-403-20. Modul još nema
predložak za kisikovu ćeliju SGX-4OX-ROHS ove pločice, pa se vrijednost koju primjer
ispisuje izračunava s postavkama ozonske ćelije.
Stranica
prilagođena konfiguracija
pokazuje kako napisati vlastitu.