Skip to main content

Očitavanje koncentracije plina

Što ovaj primjer prikazuje​

Primjer electrochemical-bridgeBoard.py pokreće pločicu na zadanoj adresi, 0x30, postavlja analogni ulazni stupanj za jednu plinsku ćeliju i svake 2,5 sekunde ispisuje koncentraciju plina u dijelovima na milijun (PPM).

Iza adrese 0x30 nalazi se ATtiny404 na pločici. On konfigurira LMP91000 i čita ADS1115 na internoj sabirnici pločice, pa vaša skripta uvijek komunicira samo s jednim I2C uređajem.

Kod primjera​

Primjer koristi preset za ozon, SENSOR_O3, i otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21. Promijenite pinove prema svojem kontroleru, a import and pass the preset for your cell: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_NO, SENSOR_H2S, SENSOR_NH3 ili SENSOR_CL2. Komentari u primjeru postavku adrese nazivaju „jumpers on the back of the board”; na ovoj pločici to je prekidač ADDRESS na gornjoj strani. Ako ga postavite na drugu adresu, promijenite adc_addr u skladu s tim. Komentari također navode da je LMPEN spojen na GND; na ovoj pločici ide na header i na ATtiny404, a biblioteka ga ne upravlja. Komentar koji spominje „legacy boards with 0x49/0x4A/0x4B” odnosi se na pločice koje se čitaju na tim adresama, kod kojih biblioteka komunicira izravno s ADS1115, a ne s mostom. Ova pločica odgovara na adresama od 0x30 do 0x37.

# FILE: electrochemical-bridgeBoard.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Single sensor PPM reading example for the ATtiny404 bridge board revision,
# which allows daisy-chaining multiple boards on one I2C bus.
# LAST UPDATED: 2026-07-23

# Connecting diagram:
#
# Qwiic------------------------>Qwiic
#
# Note: on this board revision, LMPEN is hardwired to GND, so there's no
# config_pin to set - it's ignored whenever adc_addr falls in the bridge
# range (0x30-0x37). Set the desired address using the jumpers on the back
# of the board before powering it on.

from machine import I2C, Pin
import time
from ElectrochemicalGasSensor import ElectrochemicalGasSensor, SENSOR_O3

# Initialize I2C
i2c = I2C(0, scl=Pin(22), sda=Pin(21))

# (address = 0x30 + jumper offset, giving a range of 0x30-0x37).
# Any additional boards on the same bus just need a different jumper
# setting, same as twoSensors.py does for legacy boards with 0x49/0x4A/0x4B.
sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c, adc_addr=0x30)

# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - ATtiny Bridge Board Example")

if not sensor.begin():
print("ERROR: Can't init the sensor! Check connections and jumper address!")
while True:
time.sleep_ms(100)

print("Sensor initialized successfully!")

# -------------------------------------------------------------------------
# Main loop
# -------------------------------------------------------------------------
while True:
reading = sensor.getPPM()

# If PPB is more relevant for your sensor, use:
# reading = sensor.getPPB()

print("Sensor reading: {:.5f} PPM".format(reading))

time.sleep_ms(2500)

🔗Otvorite cijeli primjer

Examples/electrochemical-bridgeBoard.py u commitu 623e1e6

→

Očekivani rezultat, u ljusci:

ShellMicroPython
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!

Zatim svake 2,5 sekunde slijedi redak: Sensor reading: , koncentracija s pet decimala i PPM. Ako pločica ne odgovori, skripta ispisuje ERROR: Can't init the sensor! Check connections and jumper address! i čeka.

Korištene funkcije​

I2C i Pin dolaze iz MicroPythonova vlastitog modula machine, a time.sleep_ms() iz njegova modula time. Funkcije u nastavku pripadaju biblioteci.

ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Stvara objekt senzora za jednu pločicu. Biblioteka čita adc_addr kako bi odlučila kako će komunicirati: za adresu od 0x30 do 0x37 koristi protokol mosta ATtiny404; za bilo koju drugu adresu komunicira s ADS1115 na toj adresi, a s LMP91000 na adresi 0x48 izravno. Primjer prosljeđuje 0x30.

ReturnsObjekt senzora.

Parametri

NazivTipOpis
sensor_typeSensorConfigPreset za vašu ćeliju: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 ili vaš vlastiti SensorConfig.
i2cmachine.I2CI2C sabirnica na kojoj se nalazi pločica. Ako se izostavi, biblioteka otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21 na ESP32 portu, odnosno I2C sa SCL na pinu 5 i SDA na pinu 4 na ESP8266 portu, a na bilo kojoj drugoj pločici baca iznimku.
adc_addrintI2C adresa pločice, od 0x30 do 0x37, kako je postavljena prekidačem za adresu. Zadano je 0x30.
config_pinintBroj GPIO pina za liniju za omogućavanje LMP91000. Biblioteka je drži visokom i spušta je nisko samo dok sama upisuje registre LMP91000; za adresu od 0x30 do 0x37 ne koristi se, pa je primjer izostavlja. Zadano je None.
begin()returns bool

Provjerava odgovara li most, šalje pojačanje ADC-a iz preseta i konfigurira LMP91000 s pojačanjem, opterećenjem, referencom, prednaponom i načinom rada iz preseta. Pozovite ga jednom prije čitanja.

ReturnsTrue ako je most odgovorio i obje konfiguracije uspjele, inače False. Svaki korak odustaje nakon 500 ms bez odgovora.

getPPM()returns float

Izvodi jedno ADC očitanje preko mosta i pretvara ga u koncentraciju pomoću preseta: uklanja interni pomak nule, dodaje kalibraciju nule, dijeli s pojačanjem pojačala i s osjetljivošću ćelije u nA po PPM. Negativan rezultat vraća se kao 0.

ReturnsKoncentracija plina u PPM.

getPPB()returns float

Isto očitanje kao getPPM(), u dijelovima na milijardu.

ReturnsKoncentracija plina u PPB, getPPM() x 1000.

Sve zajedno​

Za svaku pločicu napravite po jedan ElectrochemicalGasSensor, s presetom za njezinu ćeliju, I2C sabirnicom i njezinom adresom. Jednom pozovite begin() i zaustavite se ako vrati False. Zatim pozivajte getPPM() ili getPPB() koliko god često trebate očitanje.

Za rad s više pločica na istoj sabirnici svakoj dodijelite vlastitu adresu pomoću prekidača za adresu (od 0x30 do 0x37) i napravite po jedan objekt za svaku adresu na istoj i2c sabirnici.