Očitajte jedan senzor u ppb
Što prikazuje ovaj primjer
Primjer electrochemical-singleSensor.py pokreće jedan senzor i svakih 2,5 sekunde ispisuje očitanje u ppb (parts per billion, dijelova na milijardu).
Primjer stvara senzor samo s predloškom ćelije i I2C sabirnicom, pa modul koristi zadanu adresu, 0x49. Otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21; ako se razlikuju od I2C pinova vašeg kontrolera, promijenite te brojeve pinova. Na adresi 0x49 modul izravno komunicira s ADS1115 i LMP91000, a ne preko ATtiny404 mosta na pločici, a komentari u primjeru traže da LMPEN bude spojen na GND ili na GPIO. Pogledajte
pregled biblioteke
da vidite kako adresa to određuje.
Primjer koristi SENSOR_O3, predložak modula za ćeliju za ozon. Za
očitanje dušikova oksida upotrijebite SENSOR_NO na oba mjesta (u retku import
i u retku ElectrochemicalGasSensor(...)). SENSOR_NO je predložak za ćeliju
SGX-4NO-250 na ovoj pločici: 400 nA po ppm, pojačanje pojačala od 120 kΩ i
pozitivan pomak (bias) od 12 %.
Kôd primjera
Ispis je datoteka modula na zapisanom commitu. Izostavljeni su samo retci s komentarima: zaglavni redak koji navodi stranicu trgovine drugog proizvoda i redak s dijagramom spajanja koji navodi staru pločicu.
# FILE: electrochemical-singleSensor.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Single sensor PPM reading example.
# 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
# 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)
# If using a custom ADC address or a GPIO pin for LMP91000 MENB:
# sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c, adc_addr=0x4B, config_pin=5)
# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Single Sensor 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:
reading = sensor.getPPB()
# If PPM is more relevant for your sensor, use:
# reading = sensor.getPPM()
print("Sensor reading: {:.5f} PPB".format(reading))
time.sleep_ms(2500)
🔗Otvorite cijeli primjer
Examples/electrochemical-singleSensor.py na commitu 623e1e6
Očekivani rezultat s SENSOR_NO (očitanja u čistom zraku; vaša će se razlikovati):
Electrochemical Gas Sensor - Single Sensor Example
Sensor initialized successfully!
Sensor reading: 5.77892 PPB
Sensor reading: 6.29446 PPB
Sensor reading: 5.67951 PPB
Sensor reading: 5.90313 PPB
Redak Sensor reading: pojavljuje se svakih 2,5 sekunde, s
koncentracijom u ppb na pet decimala i s PPB na kraju. Ako pločica
ne odgovori, primjer ispisuje
ERROR: Can't init the sensor! Check connections! i ostaje u petlji.
Korištene funkcije
I2C(0, scl=Pin(22), sda=Pin(21))returns I2CStvara hardversku I2C sabirnicu 0 na zadanim pinovima SCL i SDA. machine.I2C i machine.Pin dolaze s MicroPythonom i nisu dio Soldered modula (pogledajte docs.micropython.org, machine.I2C i machine.Pin).
ReturnsObjekt I2C sabirnice koji predajete senzoru.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | id | Hardverska 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 preko I2C dok ne pozovete begin(). Uz i2c=None modul sam otvara sabirnicu na pločicama koje prepoznaje, uključujući ESP32, na kojem otvara I2C(0, scl=Pin(22), sda=Pin(21)), i ESP8266, na kojem otvara I2C(scl=Pin(5), sda=Pin(4)). Na pločici koju ne prepoznaje podiže iznimku.
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Predložak ćelije, u primjeru SENSOR_O3. Za ćeliju na ovoj pločici služi SENSOR_NO. Modul ima i SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_H2S, SENSOR_NH3 i SENSOR_CL2. |
I2C | i2c | I2C sabirnica na kojoj se nalazi pločica. |
int | adc_addr | I2C adresa. U primjeru je izostavljena, pa vrijedi zadana adresa modula, 0x49; komentar u primjeru prikazuje poziv s adc_addr=0x4B. Za 0x30 do 0x37 modul komunicira s ATtiny404 mostom na pločici; za svaku drugu adresu izravno komunicira s ADS1115 na toj adresi i s LMP91000. |
int | config_pin | GPIO za LMPEN (MENB čipa LMP91000). U primjeru je izostavljen (None), pa modul ne prebacuje nijedan pin. |
sensor.begin()returns boolZa adresu od 0x30 do 0x37 provjerava odgovara li most na pločici i preko njega šalje postavke ADC-a i ulaznog stupnja, čekajući do 500 ms na svaki korak. Za svaku drugu adresu provjerava u I2C skeniranju odgovara li ADS1115 na adresi adc_addr, postavlja ADC pojačanje predloška i najsporiju brzinu podataka, zatim konfigurira LMP91000 na 0x48 (pojačanje, opterećenje, referencu, unutarnju nulu, pomak i način rada), pri čemu config_pin, ako je zadan, povlači na nisko stanje samo tijekom te konfiguracije.
ReturnsTrue ako su svi koraci uspjeli, inače False.
sensor.getPPB()returns floatRadi jedno očitanje pomoću getPPM() i množi ga s 1000.
ReturnsKoncentracija plina u ppb. Negativan rezultat vraća se kao 0.0.
sensor.getPPM()returns floatAlternativa koju nudi komentar u primjeru. Čita ADC kanal 0 (na 0x30 do 0x37 pretvorbu izvodi most), oduzima unutarnju nulu (2,5 V puta postotak unutarnje nule predloška), dodaje kalibraciju nule, zatim dijeli s pojačanjem pojačala i s nA po ppm predloška.
ReturnsKoncentracija plina u ppm. Negativan rezultat vraća se kao 0.0.
Sve zajedno
begin() se izvršava jednom prije petlje. Ako vrati False, primjer ispisuje
pogrešku i čeka zauvijek, pa problem odmah vidite. U petlji svaki
getPPB() radi jedno novo mjerenje, a primjer ga ispisuje s pet
decimala, zatim čeka 2,5 sekunde.