Očitavanje koncentracije plina
Što ovaj primjer prikazuje
Primjer modula electrochemical-singleSensor.py stvara senzor, pokreće ga i svake 2,5 sekunde ispisuje koncentraciju plina u ppb (dijelovi na milijardu).
Primjer koristi preset za ozon, SENSOR_O3, a njegov komentar traži da ga promijenite tako da odgovara vašem senzoru. SENSOR_NO2 je preset modula za SGX-4NO2 ćeliju ove pločice; promijenite ga u retku import i u retku koji stvara senzor. Primjer otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21; promijenite ih prema svojem kontroleru.
Kôd primjera
# 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 cjeloviti primjer
Examples/electrochemical-singleSensor.py u commitu 623e1e6
Očekivani rezultat:
Electrochemical Gas Sensor - Single Sensor Example
Sensor initialized successfully!
Zatim primjer svake 2,5 sekunde ispisuje redak koji počinje s Sensor reading:, a nakon toga koncentraciju u ppb s pet decimala. Ako begin() ne uspije, ispisuje ERROR: Can't init the sensor! Check connections! i čeka u petlji.
Korištene funkcije
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora. S parametrom config_pin taj pin postavlja i kao izlaz te ga postavlja u visoku razinu. Preko I2C-a se ništa ne šalje dok ne pozovete begin().
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Preset ćelije. SENSOR_NO2 je preset za SGX-4NO2 ćeliju ove pločice. |
I2C | i2c | I2C sabirnica. S vrijednošću None modul bira pinove prema portu koji MicroPython prijavi: I2C sabirnica 0 na pinovima 22 (SCL) i 21 (SDA) na ESP32 portu, scl=Pin(5), sda=Pin(4) na ESP8266 portu. Na portu koji ne prepoznaje javlja grešku Board not recognized, please pass an I2C object manually. |
int | adc_addr | Adresa s kojom begin() komunicira, prema zadanim postavkama 0x49. Od 0x30 do 0x37 modul šalje naredbe čipu ATtiny404; od 0x48 do 0x4B izravno se obraća čipu ADS1115 na adc_addr i čipu LMP91000. Primjer ostavlja zadanu vrijednost. |
int | config_pin | Broj GPIO pina za pin za omogućavanje čipa LMP91000 (LMPEN), koristi se samo od 0x48 do 0x4B. Prema zadanim postavkama None; primjer ga ne prosljeđuje. |
sensor.begin()returns boolPokreće senzor i upisuje u njega preset. Na 0x30 do 0x37 provjerava odgovara li ATtiny404, zatim šalje pojačanje i brzinu podataka ADC-a te konfiguraciju čipa LMP91000, pri čemu se svaki korak ponavlja dok pločica ne odgovori ili ne prođe 500 ms. Na 0x48 do 0x4B provjerava pojavljuje li se ADS1115 u I2C skeniranju na adc_addr, postavlja njegovo pojačanje i najsporiju brzinu podataka te upisuje konfiguraciju u LMP91000 na 0x48. Pozovite ga jednom prije očitavanja.
ReturnsTrue ako su svi koraci uspjeli, inače False.
sensor.getPPB()returns floatObavlja novo očitavanje i vraća koncentraciju plina u dijelovima na milijardu: getPPM() pomnožen s 1000.
ReturnsKoncentracija plina u ppb.
sensor.getPPM()returns floatObavlja novo očitavanje kanala plina i pretvara ga u koncentraciju plina: napon minus unutarnja nula, plus kalibracijski pomak, podijeljeno s TIA pojačanjem i osjetljivošću ćelije iz preseta. Negativan rezultat vraća se kao 0.0. Primjer ga u komentaru navodi kao redak koji treba koristiti kada vašem senzoru više odgovara ppm.
ReturnsKoncentracija plina u ppm.
Sastavljanje cjeline
Primjer prvo stvara I2C sabirnicu i prosljeđuje je senzoru, pa ne ovisi o zadanim pinovima porta. Ako begin() vrati False, ispisuje grešku i ostaje u petlji. Inače svaki prolaz glavne petlje poziva getPPB(), ispisuje vrijednost s pet decimala i čeka 2,5 sekunde.