Brzi početak
Povežite breakout pločicu s kontrolerom Qwiic kabelom, instalirajte biblioteku i očitajte koncentraciju SO2 u ppm. Pločica se u isporučenom stanju odaziva na I2C adresi 0x30.
Programirate kontroler spojen na ovu breakout pločicu. Sama breakout pločica se ne programira.
Pločica radi isključivo na 3,3 V. Nema regulator, pa headeri i oba Qwiic konektora dijele isto napajanje od 3,3 V.
- Arduino
- MicroPython
1. Spojite breakout pločicu
Utaknite Qwiic kabel u Qwiic konektor svojeg kontrolera i u bilo koji Qwiic konektor na breakout pločici. Kabel prenosi 3,3 V, GND i I2C.
| NULA DeepSleep | Soldered Electrochemical SO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic konektor | Qwiic konektor |
Bez Qwiica: spajanje na eksperimentalnoj pločici
Zalemite priložene pin headere i spojite četiri pina gornjeg headera koji nose glavnu I2C sabirnicu. Koristite pinove SDA1 i SCL1, a ne SDA2 i SCL2.
| NULA DeepSleep | Soldered Electrochemical SO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
2. Instalirajte biblioteku
Instalirajte Electrochemical Gas Sensor Soldered iz njezina GitHub repozitorija kao ZIP biblioteku.
🔗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 ga dodajte u Arduino IDE-u preko Sketch → Include Library → Add .ZIP Library....
3. Pokrenite prvi primjer
Ovo je primjer bridgeBoard iz biblioteke, koji komunicira s breakout pločicom na adresi 0x30. Biblioteka prema toj adresi odabire način komunikacije s pločicom: 0x30 do 0x37 je mikrokontroler na ovoj pločici.
- Kopirajte skicu u Arduino IDE.
- U retku koji stvara
sensorpromijeniteSENSOR_COuSENSOR_SO2.SENSOR_SO2je predefinirana postavka biblioteke za ćeliju SGX-4SO2 na ovoj pločici. - Učitajte je i otvorite serijski monitor na 115200 baud.
Popis je datoteka biblioteke na zaključanom commitu, osim nekoliko redaka koji sadrže samo komentare, koji konektor nazivaju starijim imenom ili vode na druge Soldered proizvode, pa su izostavljeni. Tamo gdje komentari kažu da se adresa postavlja jumperima, na ovoj se pločici adresa postavlja prekidačem ADDRESS (0x30 u isporučenom stanju), a adresni jumperi JP2 do JP4 ostaju kako su isporučeni. Tamo gdje kažu da je LMPEN spojen izravno na GND, na ovoj je pločici LMPEN spojen na GND otpornikom od 10 kΩ i vodi i do mikrokontrolera na pločici (pogledajte Hardverski detalji).
/**
**************************************************
*
* @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);
}
4. Provjerite rezultat
Serijski monitor najprije potvrđuje da se pločica odazvala. Nakon toga se svake 2,5 sekunde pojavljuje novi redak Sensor reading: s koncentracijom SO2 u ppm na pet decimala. Mjerenje na čistom zraku izgledalo je ovako:
Sensor initialized successfully!
Sensor reading: 0.00282 PPM
Sensor reading: 0.00315 PPM
Sensor reading: 0.00292 PPM
Sensor reading: 0.00290 PPM
Biblioteka nikada ne prijavljuje negativnu vrijednost: sve ispod nule ispisuje se kao 0.
Ako umjesto toga vidite ERROR: Can't init the sensor! Check connections and jumper address!, pločica se nije odazvala na adresi 0x30.
5. Ako ne radi
Nastavite s poglavljem Otklanjanje poteškoća i nakon svake promjene ponovno pokrenite ovaj najmanji primjer.
1. Spojite breakout pločicu
Utaknite Qwiic kabel u Qwiic konektor svojeg kontrolera i u bilo koji Qwiic konektor na breakout pločici. Kabel prenosi 3,3 V, GND i I2C.
| NULA DeepSleep | Soldered Electrochemical SO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic konektor | Qwiic konektor |
Primjer postavlja SDA na pin 21, a SCL na pin 22. Na pločici NULA DeepSleep promijenite ih u 8 (SDA) i 9 (SCL), I2C pinove pločice prikazane na dijagramu.
Bez Qwiica: spajanje na eksperimentalnoj pločici
Zalemite priložene pin headere i spojite četiri pina gornjeg headera koji nose glavnu I2C sabirnicu.
| NULA DeepSleep | Soldered Electrochemical SO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
Primjer postavlja SDA na pin 21, a SCL na pin 22. Na pločici NULA DeepSleep promijenite ih u 8 (SDA) i 9 (SCL), I2C pinove pločice prikazane na dijagramu.
2. Instalirajte modul
Nakon instalacije paketa mpremote instalirajte biblioteku na pločicu sljedećom naredbom:
mpremote mip install github:SolderedElectronics/Soldered-ElectrochemicalGasSensor-MicroPython-Library
Ili, ako koristite operacijski sustav Windows:
python -m mpremote mip install github:SolderedElectronics/Soldered-ElectrochemicalGasSensor-MicroPython-Library
🔗Soldered ElectrochemicalGasSensor MicroPython Library
Provjeren 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 preko
File → Save as... → MicroPython device kopirajte na pločicu.
Ova biblioteka treba tri datoteke na pločici: ElectrochemicalGasSensor.py, ads1115.py i lmp91000.py.
3. Pokrenite prvi primjer
Ovo je primjer electrochemical-bridgeBoard.py iz biblioteke. Stvara I2C sabirnicu na GPIO 22 (SCL) i GPIO 21 (SDA) i komunicira s breakout pločicom na adresi 0x30.
- Otvorite primjer u Thonnyju.
- Promijenite
SENSOR_O3uSENSOR_SO2na oba mjesta: u retkuimporti u retku koji stvarasensor.SENSOR_SO2je predefinirana postavka biblioteke za ćeliju SGX-4SO2 na ovoj pločici. - Ako Qwiic konektor vaše pločice koristi druge pinove, promijenite brojeve u retku
I2C(...). - Pokrenite skriptu.
Popis je datoteka biblioteke na zaključanom commitu, osim nekoliko redaka koji sadrže samo komentare, koji konektor nazivaju starijim imenom, vode na drugi Soldered proizvod ili imenuju kontrolersku pločicu na dijagramu spajanja, pa su izostavljeni. Tamo gdje komentari kažu da se adresa postavlja jumperima, na ovoj se pločici adresa postavlja prekidačem ADDRESS (0x30 u isporučenom stanju), a adresni jumperi JP2 do JP4 ostaju kako su isporučeni. Tamo gdje kažu da je LMPEN spojen izravno na GND, na ovoj je pločici LMPEN spojen na GND otpornikom od 10 kΩ i vodi i do mikrokontrolera na pločici (pogledajte Hardverski detalji).
# 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
electrochemical-bridgeBoard.py na zaključanom commitu
4. Provjerite rezultat
Thonny konzola najprije prikazuje naslov primjera i potvrđuje da se pločica odazvala:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Nakon toga se svake 2,5 sekunde pojavljuje novi redak Sensor reading: s koncentracijom SO2 u ppm na pet decimala. Vrijednosti ispod nule ispisuju se kao 0.
5. Ako ne radi
Nastavite s poglavljem Otklanjanje poteškoća i nakon svake promjene ponovno pokrenite ovaj najmanji primjer.