Brzi početak
Povežite pločicu preko Qwiic konektora, instalirajte biblioteku i pokrenite primjer iz biblioteke za ovu pločicu. Primjer pronalazi pločicu na zadanoj adresi 0x30, postavlja analogni ulazni stupanj i ispisuje očitanje svakih 2,5 sekunde.
Programirate kontroler spojen na ovu pločicu. Sama pločica se ne flasha: njezin ATtiny404 već dolazi s ugrađenim firmwareom.
Pločica radi isključivo na 3,3 V. Nema regulator, pa header i oba Qwiic konektora dijele isto napajanje od 3,3 V. Ne spajajte 5 V na 3V3.
Biblioteke još nemaju unaprijed postavljene postavke za kisikovu ćeliju SGX-4OX-ROHS ove pločice. Primjeri u nastavku koriste postavke napisane za drugi plin (SENSOR_CO u
Arduinu, SENSOR_O3 u MicroPythonu). Oni dokazuju da je veza ispravna i prikazuju format očitanja, ali vrijednost koju ispisuju izračunata je s postavkama tog plina, a ne kisikove ćelije. Stranice s primjerima za Arduino
i MicroPython
objašnjavaju što treba promijeniti za kisikovu ćeliju.
- Arduino
- MicroPython
1. Povežite pločicu
Utaknite Qwiic kabel u bilo koji Qwiic konektor na pločici i u Qwiic konektor na svom kontroleru. Svaki Qwiic konektor vodi 3V3, SDA1, SCL1 i GND, pa jedan kabel napaja pločicu i povezuje I2C.
| NULA DeepSleep | Soldered Electrochemical O2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic connector | Qwiic connector |
Bez Qwiica: spajanje na eksperimentalnoj pločici
Zalemite priloženi pin header i povežite 3V3, GND, SDA1 i SCL1 gornjeg headera na napajanje od 3,3 V, masu i I2C pinove svog kontrolera. SDA1 i SCL1 isti su bus kao i na Qwiic konektorima.
| NULA DeepSleep | Soldered Electrochemical O2 Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
SDA2 i SCL2 ostavite nespojene: to je interni bus pločice između ATtiny404 i dvaju analognih čipova.
2. Instalirajte biblioteku
Instalirajte Electrochemical Gas Sensor Soldered s njezina GitHub repozitorija.
🔗Soldered Electrochemical Gas Sensor Arduino biblioteka
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 preko Sketch → Include Library → Add .ZIP Library....
3. Pokrenite prvi primjer
Iz primjera biblioteke otvorite bridgeBoard, odaberite svoju pločicu i port te ga učitajte. Skica stvara senzor na adresi 0x30, na kojoj ova pločica odgovara kada je preklopnik ADDRESS u zadanom položaju.
Gdje komentari u skici spominju adresne jumpere na stražnjoj strani pločice, ova pločica umjesto njih koristi preklopnik ADDRESS s tri položaja na gornjoj strani.
/**
**************************************************
*
* @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
Otvorite Serijski monitor na 115200 baud. Kada pločica odgovori, prvi redak je:
Sensor initialized successfully!
Nakon toga svake 2,5 sekunde stiže redak Sensor reading: iza kojeg slijedi vrijednost s pet decimala i PPM.
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 Otklanjanje poteškoća i nakon svake promjene ponovno pokrenite ovaj najmanji primjer.
1. Povežite pločicu
Primjer iz modula otvara I2C bus 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.
Utaknite Qwiic kabel u bilo koji Qwiic konektor na pločici i u Qwiic konektor na svom kontroleru. Svaki Qwiic konektor vodi 3V3, SDA1, SCL1 i GND, pa jedan kabel napaja pločicu i povezuje I2C.
| NULA DeepSleep | Soldered Electrochemical O2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic connector | Qwiic connector |
Primjer postavlja SDA na pin 21, a SCL na pin 22. Na pločici NULA DeepSleep promijenite ih na 8 (SDA) i 9 (SCL), I2C pinove pločice prikazane na dijagramu.
Bez Qwiica: spajanje na eksperimentalnoj pločici
Zalemite priloženi pin header i povežite SDA1 gornjeg headera na IO8, a SCL1 na IO9 pločice NULA DeepSleep, zatim promijenite pinove u primjeru na 8 (SDA) i 9 (SCL).
| NULA DeepSleep | Soldered Electrochemical O2 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 na 8 (SDA) i 9 (SCL), I2C pinove pločice prikazane na dijagramu.
SDA2 i SCL2 ostavite nespojene: to je interni bus pločice između ATtiny404 i dvaju analognih čipova.
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 Electrochemical Gas Sensor MicroPython biblioteka
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 preko
File → Save as... → MicroPython device kopirajte na pločicu. Ova
biblioteka ima tri datoteke: ElectrochemicalGasSensor.py, ads1115.py i
lmp91000.py.
3. Pokrenite prvi primjer
Ovo je primjer electrochemical-bridgeBoard.py iz modula. Stvara senzor na adresi 0x30, zaustavlja se s pogreškom ako pločica ne odgovori i ispisuje očitanje svakih 2,5 sekunde. Promijenite scl i sda ako ste spojili druge pinove.
Gdje komentari u primjeru spominju adresne jumpere na stražnjoj strani pločice, ova pločica umjesto njih koristi preklopnik ADDRESS s tri položaja na gornjoj strani.
# 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 počinje s:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Nakon toga svake 2,5 sekunde stiže redak Sensor reading: iza kojeg slijedi vrijednost s pet decimala i PPM.
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 Otklanjanje poteškoća i nakon svake promjene ponovno pokrenite ovaj najmanji primjer.