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:
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 ElectrochemicalGasSensorStvara 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
| Naziv | Tip | Opis |
|---|---|---|
sensor_type | SensorConfig | Preset za vašu ćeliju: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 ili vaš vlastiti SensorConfig. |
i2c | machine.I2C | I2C 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_addr | int | I2C adresa pločice, od 0x30 do 0x37, kako je postavljena prekidačem za adresu. Zadano je 0x30. |
config_pin | int | Broj 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 boolProvjerava 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 floatIzvodi 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 floatIsto 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.