Skip to main content

Očitanje u PPB

Što prikazuje ovaj primjer​

Primjer electrochemical-singleSensor.py stvara jedan objekt senzora, pokreće ga i svakih 2,5 sekunde ispisuje očitanje u PPB. Ne prosljeđuje adresu, pa konstruktor koristi svoju zadanu vrijednost, adc_addr=0x49.

Primjer otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21. Promijenite ih u pinove koje koristi Qwiic konektor vašeg kontrolera ili vaše ožičenje.

Na ovoj pločici ne morate spajati LMPEN, što god pisalo u komentarima primjera: pločica ga sama drži na niskoj razini.

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 cijeli primjer

Examples/electrochemical-singleSensor.py u commitu 623e1e6

→

Što ova pločica ispisuje s primjerom u neizmijenjenom obliku, još nije izmjereno. Kad je ova pločica testirana preko Qwiic konektora, I2C skeniranje pronašlo je samo jednu adresu, 0x30, a begin() nije uspio za senzor stvoren na 0x49, zadanoj adresi koju ovaj primjer koristi. Ako begin() ne uspije, primjer nakon naslovne linije ispisuje ERROR: Can't init the sensor! Check connections! i tu staje.

Kad begin() uspije, shell prikazuje:

ShellMicroPython
Electrochemical Gas Sensor - Single Sensor Example
Sensor initialized successfully!

Nakon toga svakih 2,5 sekunde stiže redak Sensor reading: iza kojeg slijedi vrijednost s pet decimala i PPB.

Korištene funkcije​

I2C(id, scl, sda)returns I2C

Stvara 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

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 pločici dok ne pozovete begin(). Primjer prosljeđuje konfiguraciju senzora i sabirnicu, a adc_addr i config_pin ostavlja na zadanim vrijednostima.

ReturnsObjekt senzora.

Parametri

TipNazivOpis
SensorConfigsensor_typePostavke ulaznog stupnja i pretvorbe, na primjer SENSOR_O3. Predlošci su definirani u ElectrochemicalGasSensor.py.
I2Ci2cSabirnica koju treba koristiti. 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.
intadc_addrAdresa 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 tumači se kao vlastita adresa ADS1115.
intconfig_pinGPIO 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 bool

Konfigurira 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, pri čemu svaku naredbu ponavlja 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, ako je config_pin zadan, za to vrijeme spušta config_pin na nisku razinu.

ReturnsTrue ako je svaki korak uspio, inače False.

sensor.getPPB()returns float

Izvodi jedno očitanje i vraća ga u dijelovima na milijardu (PPB): vrijednost getPPM() pomnožena s 1000.

ReturnsKoncentracija u PPB.

sensor.getPPM()returns float

Alternativa iz primjera koja je zakomentirana. Izvodi jedno očitanje ADC-a i pretvara napon u koncentraciju: oduzima internu nulu (dio referentnog napona pločice od 2,5 V), dodaje nultu kalibraciju konfiguracije, dijeli s TIA pojačanjem kako bi dobio struju ćelije, a zatim dijeli s nanoamperima po PPM-u iz konfiguracije. Negativan rezultat vraća se kao 0.0.

ReturnsKoncentracija u PPM.

Sve zajedno​

SENSOR_O3 je predložak za ćeliju ozona SGX-403-20. Modul još nema predložak za kisikovu ćeliju SGX-4OX-ROHS na ovoj pločici, pa se vrijednost koju primjer ispisuje izračunava s postavkama ćelije ozona. Stranica prilagođena konfiguracija pokazuje kako napisati vlastitu.