Skip to main content

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

ShellMicroPython
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 I2C

Stvara 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

TipNazivOpis
intidHardverska I2C sabirnica, u primjeru 0.
PinsclPin takta, u primjeru Pin(22).
PinsdaPin podataka, u primjeru Pin(21).
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Stvara 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

TipNazivOpis
SensorConfigsensor_typePredlož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.
I2Ci2cI2C sabirnica na kojoj se nalazi pločica.
intadc_addrI2C 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.
intconfig_pinGPIO za LMPEN (MENB čipa LMP91000). U primjeru je izostavljen (None), pa modul ne prebacuje nijedan pin.
sensor.begin()returns bool

Za 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 float

Radi 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 float

Alternativa 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.