Brzi početak
Povežite pločicu preko Qwiic konektora, instalirajte biblioteku i ispisujte koncentraciju ugljikova monoksida u ppm svakih 2,5 sekunde.
Programirate kontroler spojen na ovu pločicu. Sama pločica se ne programira: njezin ATtiny404 dolazi s vlastitim firmwareom i umjesto vas upravlja ulaznim stupnjem plinske ćelije i ADC-om.
Pločica radi isključivo na 3,3 V. Nema regulator, pa pinovi 3V3 na headeru i oba Qwiic konektora dijele isto napajanje od 3,3 V. Nemojte spajati 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 vašem kontroleru. Svaki Qwiic konektor nosi 3V3, SDA, SCL i GND, pa jedan kabel napaja pločicu i povezuje I2C.
| NULA DeepSleep | Soldered Electrochemical CO Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic konektor | Qwiic konektor |
Bez Qwiic konektora: spajanje preko headera
Zalemite priložene pin headere i gornje pinove headera izravno spojite na napajanje od 3,3 V, masu i I2C pinove vašeg kontrolera. Koristite SDA1 i SCL1: SDA2 i SCL2 interna su sabirnica pločice između ATtiny404 i čipova senzora.
Tablica i dijagram prikazuju jedan primjer kontrolera čiji su zadani I2C pinovi GPIO 8 (SDA) i GPIO 9 (SCL). Na drugom kontroleru koristite njegove vlastite I2C pinove.
| NULA DeepSleep | Soldered Electrochemical CO Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
2. Instalirajte biblioteku
Instalirajte Electrochemical Gas Sensor Soldered iz njezina GitHub repozitorija.
🔗Arduino biblioteka Electrochemical Gas Sensor
Provjerena Arduino biblioteka na commitu c4df54b
Savjet: preuzimanje s GitHuba. Na GitHub stranici biblioteke kliknite zeleni gumb Code i odaberite Download ZIP, a zatim je dodajte u Arduino IDE-u 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. Primjer stvara senzor s postavkom za CO ćeliju, SENSOR_CO, na zadanoj adresi pločice 0x30 i ispisuje očitanje svakih 2,5 sekunde.
/**
**************************************************
*
* @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);
}
Na ovoj se pločici adresa postavlja pomoću DIP preklopnika ADDRESS s tri sklopke na gornjoj strani, u gornjem lijevom kutu, a ne pomoću jumpera na poleđini, a zadana adresa 0x30 ne treba promjenu. LMPEN je preko 10 kΩ povučen na GND, a nije spojen izravno na njega; u oba slučaja na njega ništa ne spajate.
🔗Otvorite cijeli primjer
examples/bridgeBoard na commitu c4df54b
4. Provjerite rezultat
Otvorite Serijski monitor na 115200 baud. U čistom zraku izvođenje na ovoj pločici prikazuje:
Sensor initialized successfully!
Sensor reading: 0.29553 PPM
Sensor reading: 0.32187 PPM
Sensor reading: 0.29429 PPM
Sensor reading: 0.30653 PPM
Nakon toga nova linija stiže svakih 2,5 sekunde: Sensor reading: , koncentracija CO u ppm s pet decimala i PPM. Biblioteka nikada ne javlja negativnu koncentraciju: rezultat ispod nule ispisuje se kao 0.00000.
Ako umjesto toga vidite ERROR: Can't init the sensor! Check connections and jumper address!, pločica nije odgovorila na adresi 0x30.
5. Ako ne radi
Nastavite s poglavljem Rješavanje problema i nakon svake promjene ponovno pokrenite ovaj najmanji primjer.
1. Povežite pločicu
Primjer modula otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21. Promijenite brojeve pinova u primjeru ako je Qwiic konektor vašeg kontrolera ili pinovi koje spajate drugdje.
Spojite Qwiic kabel na bilo koji Qwiic konektor na pločici i na Qwiic konektor na vašem kontroleru. Svaki Qwiic konektor nosi 3V3, SDA, SCL i GND, pa jedan kabel napaja pločicu i povezuje I2C. Dijagram prikazuje jedan primjer kontrolera; napomena o pinovima ispod njega odnosi se na tu pločicu.
| NULA DeepSleep | Soldered Electrochemical CO 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 Qwiic konektora: spajanje preko headera
Zalemite priložene pin headere i gornje pinove headera izravno spojite na napajanje od 3,3 V, masu i pinove koje ste postavili u primjeru. Koristite SDA1 i SCL1: SDA2 i SCL2 interna su sabirnica pločice.
Tablica i dijagram prikazuju jedan primjer kontrolera čiji su zadani I2C pinovi GPIO 8 (SDA) i GPIO 9 (SCL). Na drugom kontroleru koristite njegove vlastite I2C pinove i postavite iste brojeve u primjeru.
| NULA DeepSleep | Soldered Electrochemical CO 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
🔗MicroPython biblioteka Electrochemical Gas Sensor
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 pomoću File → Save as... → MicroPython device kopirajte na pločicu. Ovaj modul na pločici treba tri datoteke: ElectrochemicalGasSensor.py, lmp91000.py i ads1115.py.
3. Pokrenite prvi primjer
Ovo je primjer modula electrochemical-bridgeBoard.py. Otvara I2C, stvara senzor na zadanoj adresi pločice 0x30 i ispisuje očitanje svakih 2,5 sekunde.
Prije pokretanja promijenite SENSOR_O3 u SENSOR_CO u liniji import i u liniji ElectrochemicalGasSensor(...). SENSOR_O3 je preset modula za ćeliju ozona, pa bi getPPM() pretvarao s osjetljivošću i nulom te ćelije. Ova pločica nosi ćeliju ugljikova monoksida SGX-4CO, a preset modula za nju je SENSOR_CO.
# 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)
Na ovoj se pločici adresa postavlja pomoću DIP preklopnika ADDRESS s tri sklopke na gornjoj strani, u gornjem lijevom kutu, a ne pomoću jumpera na poleđini, a zadana adresa 0x30 ne treba promjenu. LMPEN je preko 10 kΩ povučen na GND, a nije spojen izravno na njega; u oba slučaja na njega ništa ne spajate.
🔗Otvorite cijeli primjer
Examples/electrochemical-bridgeBoard.py na commitu 623e1e6
4. Provjerite rezultat
U čistom zraku izvođenje na ovoj pločici u shellu prikazuje:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Sensor reading: 0.31492 PPM
Sensor reading: 0.29677 PPM
Sensor reading: 0.30840 PPM
Sensor reading: 0.31346 PPM
Nakon toga nova linija stiže svakih 2,5 sekunde: Sensor reading: , koncentracija u ppm s pet decimala i PPM. Rezultat ispod nule ispisuje se kao 0.00000.
Ako umjesto toga vidite ERROR: Can't init the sensor! Check connections and jumper address!, pločica nije odgovorila na adresi 0x30.
5. Ako ne radi
Nastavite s poglavljem Rješavanje problema i nakon svake promjene ponovno pokrenite ovaj najmanji primjer.