Skip to main content

Očitavanje senzora

Što ovaj primjer prikazuje​

Primjer electrochemical-bridgeBoard.py pokreće pločicu preko njezina ATtiny404 na adresi 0x30, šalje analognom ulaznom stupnju njegove postavke i ispisuje očitanje svakih 2,5 sekunde. Vaš kontroler komunicira samo s ATtiny404; on prosljeđuje postavke čipu LMP91000 i umjesto vas čita ADS1115.

Primjer otvara I2C sabirnicu 0 s 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. LMPEN ne morate spajati: pločica ga sama drži na niskoj razini. Gdje komentari u primjeru spominju adresne jumpere na stražnjoj strani pločice, ova pločica umjesto njih koristi tropoložajni ADDRESS prekidač na gornjoj strani.

Kôd primjera​

# 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 cjeloviti primjer

Examples/electrochemical-bridgeBoard.py u commitu 623e1e6

→

Očekivani rezultat:

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

Nakon toga svakih 2,5 sekunde stiže redak Sensor reading: iza kojeg slijedi vrijednost s pet decimala i PPM. Ako pločica ne odgovori, primjer ispisuje ERROR: Can't init the sensor! Check connections and jumper address! i ondje staje.

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(). Vrijednost adc_addr od 0x30 do 0x37 govori modulu da je ovo pločica s ATtiny404 mostom, a config_pin se tada ignorira.

ReturnsObjekt senzora.

Parametri

TipNazivOpis
SensorConfigsensor_typePostavke ulaznog stupnja i pretvorbe, npr. SENSOR_O3. Predlošci su definirani u ElectrochemicalGasSensor.py.
I2Ci2cSabirnica koja se koristi. Ako se izostavi, 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 na kojoj modul komunicira, prema zadanim postavkama 0x49, a u ovom primjeru 0x30. Adresa od 0x30 do 0x37 navodi begin() da koristi naredbe mosta, u skladu s ADDRESS prekidačem na pločici.
intconfig_pinGPIO pin koji modul drži na visokoj razini i spušta na nisku dok upisuje postavke čipa LMP91000. Ne koristi se za adresu od 0x30 do 0x37.
sensor.begin()returns bool

Provjerava odgovara li most, šalje mu pojačanje ADC-a i najsporiju brzinu podataka ADC-a, zatim šalje postavke čipa LMP91000 iz konfiguracije senzora. Svaka naredba mostu ponavlja se do 500 ms.

ReturnsTrue ako su svi koraci uspjeli, inače False.

sensor.getPPM()returns float

Traži od mosta jednu ADC pretvorbu i pretvara napon u koncentraciju: oduzima unutarnju nulu (dio referentnog napona pločice od 2,5 V), dodaje nultu kalibraciju iz konfiguracije, dijeli s TIA pojačanjem da dobije struju ćelije, a zatim dijeli s nanoamperima po PPM iz konfiguracije. Negativan rezultat vraća se kao 0.0.

ReturnsKoncentracija u PPM, izračunata sa konfiguracijom senzora koju ste proslijedili konstruktoru.

sensor.getPPB()returns float

Alternativa iz primjera koja je zakomentirana: isto očitanje kao getPPM(), pomnoženo s 1000.

ReturnsKoncentracija u PPB.

Sve zajedno​

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

Nakon uključivanja ćeliji može trebati do 15 minuta da se stabilizira, pa je pustite da radi prije nego što povjerujete očitanju.

Do osam pločica dijeli jednu sabirnicu: svakoj dodijelite vlastitu adresu ADDRESS prekidačem i izradite jedan ElectrochemicalGasSensor po adresi, od 0x30 do 0x37.