Brzi početak
Povežite pločicu preko Qwiic konektora, instalirajte biblioteku i ispišite koncentraciju plina koju ćelija mjeri, u dijelovima na milijun (PPM).
Programirate mikrokontroler spojen na ovu pločicu. Sama pločica se ne flashira: njezin ATtiny404 izvodi tvornički firmware.
Pločica radi isključivo na 3,3 V. Nema regulator, pa 3V3 pinovi headera i
oba Qwiic konektora dijele isto napajanje od 3,3 V. Ne spajajte 5 V.
- Arduino
- MicroPython
1. Povežite pločicu
Spojite Qwiic kabel na bilo koji Qwiic konektor na pločici i na Qwiic
konektor na svojem mikrokontroleru. Svaki Qwiic konektor vodi 3V3, GND i
I2C sabirnicu pločice (SDA1 i SCL1), pa jedan kabel napaja pločicu i
povezuje je.
| NULA DeepSleep | Soldered Electrochemical Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic connector | Qwiic connector |
Pločica se isporučuje s I2C adresom 0x30, a tu adresu koristi i primjer u nastavku.
Bez Qwiica: spojite header
Pločica nije kompatibilna s eksperimentalnom pločicom. Zalemite priložene pin headere i
spojite gornji header na napajanje od 3,3 V, masu i I2C pinove svojeg mikrokontrolera. Koristite SDA1 i SCL1: ovaj primjer komunicira s
ATtiny404 mostom na adresi 0x30, koji je na SDA1 i SCL1. SDA2 i SCL2
čine sabirnicu između ATtiny404 i dvaju analognih čipova; samo primjeri s izravnim adresiranjem spajaju mikrokontroler tamo.
| NULA DeepSleep | Soldered Electrochemical Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
2. Instalirajte biblioteku
Instalirajte Electrochemical Gas Sensor Soldered iz njezina GitHub repozitorija.
🔗Electrochemical Gas Sensor Soldered
Provjerena Arduino biblioteka na commitu c4df54b
Savjet: preuzimanje s GitHuba. Na GitHub stranici biblioteke kliknite zeleni gumb Code i odaberite Download ZIP, zatim je dodajte u Arduino IDE preko Sketch → Include Library → Add .ZIP Library....
3. Pokrenite prvi primjer
Otvorite bridgeBoard iz primjera biblioteke, odaberite svoju pločicu i port te ga učitajte. Komunicira s ATtiny404 mostom na adresi 0x30 i ispisuje očitanje svakih 2,5 sekundi.
Skica koristi preset za ugljikov monoksid, SENSOR_CO. Ako vaša ćelija mjeri
drugi plin, prije učitavanja promijenite ga u preset za taj plin: SENSOR_NO2,
SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3 ili
SENSOR_CL2.
Dva komentara u skici ne odgovaraju ovoj pločici. Adresa se postavlja
prekidačem ADDRESS na vrhu pločice, a ne jumperima na poleđini, i
isporučuje se kao 0x30. LMPEN nije spojen na GND: 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, gdje
biblioteka izravno komunicira s ADS1115, a ne s mostom. Ova pločica
odgovara na adresama od 0x30 do 0x37. Gdje komentari govore o novoj ATtiny404 pločici
s mostom, misle na pločicu s ATtiny404 mostom, što je upravo ova pločica.
/**
**************************************************
*
* @file bridgeBoard.ino
* @brief See how to init a sensor on the new ATtiny404 bridge board revision,
*
* To successfully run the sketch:
* - Set the desired address using the jumpers on the back of the board
* (address = 0x30 + jumper offset, giving a range of 0x30-0x37)
* - Run the sketch and open serial monitor at 115200 baud!
*
* Note: on this board revision, LMPEN is hardwired to GND, so there's
* no configPin argument to pass - the constructor's third argument
* is ignored whenever the address falls in the bridge range (0x30-0x37).
*
*
* @authors @ soldered.com
***************************************************/
// Include the required library
#include "Electrochemical-Gas-Sensor-SOLDERED.h"
// Any additional boards on the same bus just need a different jumper setting
// (0x30-0x37), same as twoSensors.ino does for legacy boards with 0x49/0x4A/0x4B.
ElectrochemicalGasSensor sensor(SENSOR_CO, 0x30);
void setup()
{
Serial.begin(115200); // For debugging
// Init the breakout
if (!sensor.begin())
{
// Can't init? Notify the user and go to infinite loop
Serial.println("ERROR: Can't init the sensor! Check connections and jumper address!");
while (true)
delay(100);
}
Serial.println("Sensor initialized successfully!");
}
void loop()
{
// Make the reading
double reading = sensor.getPPM();
// If PPB is more relevant for your sensor, you can use:
// double reading = sensor.getPPB();
// Print the reading with 5 digits of precision
Serial.print("Sensor reading: ");
Serial.print(reading, 5);
Serial.println(" PPM");
// Wait a bit before reading again
delay(2500);
}
🔗Otvorite cijeli primjer
examples/bridgeBoard na commitu c4df54b
4. Provjerite rezultat
Otvorite serijski monitor na 115200 baud. Kada pločica odgovori, skica ispisuje:
Sensor initialized successfully!
Sensor reading: 0.30045 PPM
Sensor reading: 0.30838 PPM
Sensor reading: 0.32838 PPM
Sensor reading: 0.30712 PPM
Novi redak s očitanjem stiže svakih 2,5 sekundi: Sensor reading: ,
koncentracija s pet decimala i PPM. Negativan rezultat ispisuje se kao
0.
Ako umjesto toga vidite ERROR: Can't init the sensor! Check connections and jumper address!,
pločica nije odgovorila na adresi 0x30. Skica se ondje zaustavlja; popravite
spoj, a zatim pritisnite reset.
5. Ako ne radi
Nastavite s Otklanjanjem poteškoća i ponovite ovaj najmanji primjer nakon svake promjene.
1. Povežite pločicu
Spojite Qwiic kabel na bilo koji Qwiic konektor na pločici i na Qwiic
konektor na svojem mikrokontroleru. Svaki Qwiic konektor vodi 3V3, GND i
I2C sabirnicu pločice (SDA1 i SCL1), pa jedan kabel napaja pločicu i
povezuje je.
| NULA DeepSleep | Soldered Electrochemical Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic connector | Qwiic connector |
Primjer postavlja SDA na pin 21 i SCL na pin 22. Na pločici NULA DeepSleep promijenite ih na 8 (SDA) i 9 (SCL), I2C pinove pločice prikazane na dijagramu.
Primjer otvara I2C sabirnicu 0 s SCL na pinu 22 i SDA na pinu 21. Promijenite
ta dva broja u primjeru ako su Qwiic konektor vašeg mikrokontrolera ili
pinovi koje spajate drugdje.
Bez Qwiica: spojite header
Pločica nije kompatibilna s eksperimentalnom pločicom. Zalemite priložene pin headere i
spojite gornji header na napajanje od 3,3 V, masu i I2C pinove
koje primjer koristi. Koristite SDA1 i SCL1: ovaj primjer komunicira s ATtiny404
mostom na adresi 0x30, koji je na SDA1 i SCL1. SDA2 i SCL2 su sabirnica
između ATtiny404 i dvaju analognih čipova; samo primjeri s izravnim
adresiranjem spajaju mikrokontroler tamo.
| NULA DeepSleep | Soldered Electrochemical Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
Primjer postavlja SDA na pin 21 i SCL na pin 22. Na pločici NULA DeepSleep promijenite ih na 8 (SDA) i 9 (SCL), I2C pinove pločice prikazane na dijagramu.
2. Instalirajte modul
Nakon instalacije paketa mpremote, instalirajte biblioteku na svoju pločicu sljedećom naredbom:
mpremote mip install github:SolderedElectronics/Soldered-ElectrochemicalGasSensor-MicroPython-Library
Ili, ako koristite Windows:
python -m mpremote mip install github:SolderedElectronics/Soldered-ElectrochemicalGasSensor-MicroPython-Library
🔗Soldered ElectrochemicalGasSensor MicroPython Library
Provjereni MicroPython modul na commitu 623e1e6
Savjet: preuzimanje s GitHuba. Bez mpremote otvorite .py
datoteku modula na GitHubu i kliknite Download raw file, zatim je otvorite u Thonnyju i koristite
File → Save as... → MicroPython device da je kopirate na pločicu.
Biblioteka se sastoji od triju datoteka: ElectrochemicalGasSensor.py, ads1115.py i
lmp91000.py. Ako instalirate ručno, kopirajte sve tri.
3. Pokrenite prvi primjer
Ovo je primjer electrochemical-bridgeBoard.py iz modula. Komunicira s
ATtiny404 mostom na adresi 0x30 i ispisuje očitanje svakih 2,5 sekundi.
Koristi preset za ozon, SENSOR_O3. Ako vaša ćelija mjeri drugi plin,
import and pass that gas's preset instead: SENSOR_CO, SENSOR_NO2,
SENSOR_SO2, SENSOR_NO, SENSOR_H2S, SENSOR_NH3 ili SENSOR_CL2.
Dva komentara u primjeru ne odgovaraju ovoj pločici. Adresa se postavlja
prekidačem ADDRESS na vrhu pločice, a ne jumperima na poleđini, i
isporučuje se kao 0x30. LMPEN nije spojen na GND: 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, gdje
biblioteka izravno komunicira s ADS1115, a ne s mostom. Ova pločica
odgovara na adresama od 0x30 do 0x37. Gdje komentari govore o pločici
s ATtiny404 mostom, misle na pločicu s ATtiny404 mostom, što je upravo ova pločica.
# 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 na commitu 623e1e6
4. Provjerite rezultat
Kada pločica odgovori, shell prikazuje:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Sensor reading: 0.03165 PPM
Sensor reading: 0.03202 PPM
Sensor reading: 0.03062 PPM
Sensor reading: 0.03069 PPM
Novi redak s očitanjem stiže svakih 2,5 sekundi: Sensor reading: ,
koncentracija s pet decimala i PPM. Negativan rezultat ispisuje se kao
0.
Ako umjesto toga vidite ERROR: Can't init the sensor! Check connections and jumper address!,
pločica nije odgovorila na adresi 0x30, a skripta ondje čeka. Popravite
spoj i pokrenite je ponovno.
5. Ako ne radi
Nastavite s Otklanjanjem poteškoća i ponovite ovaj najmanji primjer nakon svake promjene.