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:
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 I2CStvara 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
| Tip | Naziv | Opis |
|---|---|---|
int | id | Hardverska I2C sabirnica, u primjeru 0. |
Pin | scl | Pin takta, u primjeru Pin(22). |
Pin | sda | Pin podataka, u primjeru Pin(21). |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara 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
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Postavke ulaznog stupnja i pretvorbe, npr. SENSOR_O3. Predlošci su definirani u ElectrochemicalGasSensor.py. |
I2C | i2c | Sabirnica 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. |
int | adc_addr | Adresa 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. |
int | config_pin | GPIO 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 boolProvjerava 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 floatTraž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 floatAlternativa 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.