Schnellstart
Verbinden Sie das Breakout mit einem Qwiic-Kabel mit Ihrem Controller, installieren Sie die Bibliothek und lesen Sie die SO2-Konzentration in ppm aus. Das Board antwortet im Auslieferungszustand auf der I2C-Adresse 0x30.
Sie programmieren den Controller, der mit diesem Breakout verbunden ist. Das Breakout selbst wird nicht geflasht.
Das Board arbeitet ausschließlich mit 3,3 V. Es hat keinen Spannungsregler, daher teilen sich die Stiftleisten und beide Qwiic-Connectoren dieselbe 3,3-V-Versorgung.
- Arduino
- MicroPython
1. Das Breakout-Board anschließen
Stecken Sie ein Qwiic-Kabel in den Qwiic-Connector Ihres Controllers und in einen der beiden Qwiic-Connectoren am Breakout. Das Kabel führt 3,3 V, GND und I2C.
| NULA DeepSleep | Soldered Electrochemical SO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic-Connector | Qwiic-Connector |
Ohne Qwiic: Verdrahtung auf dem Steckbrett
Löten Sie die mitgelieferten Stiftleisten an und verdrahten Sie die vier Pins der oberen Stiftleiste, die den Haupt-I2C-Bus führen. Verwenden Sie die Pins SDA1 und SCL1, nicht SDA2 und SCL2.
| NULA DeepSleep | Soldered Electrochemical SO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
2. Die Bibliothek installieren
Installieren Sie Electrochemical Gas Sensor Soldered aus dem GitHub-Repository als ZIP-Bibliothek.
🔗Electrochemical Gas Sensor Soldered
Geprüfte Arduino-Bibliothek bei Commit c4df54b
Tipp: Download von GitHub. Klicken Sie auf der GitHub-Seite der Bibliothek auf die grüne Schaltfläche Code und wählen Sie Download ZIP. Fügen Sie die Datei anschließend in der Arduino IDE über Sketch → Bibliothek einbinden → .ZIP-Bibliothek hinzufügen... hinzu.
3. Das erste Beispiel ausführen
Dies ist das Beispiel bridgeBoard der Bibliothek, das mit dem Breakout unter der Adresse 0x30 kommuniziert. Die Bibliothek wählt anhand dieser Adresse aus, wie sie mit dem Board kommuniziert: 0x30 bis 0x37 ist der Mikrocontroller auf diesem Board.
- Kopieren Sie den Sketch in die Arduino IDE.
- Ändern Sie
SENSOR_COinSENSOR_SO2in der Zeile, diesensorerzeugt.SENSOR_SO2ist die Voreinstellung der Bibliothek für die SGX-4SO2-Zelle auf diesem Board. - Laden Sie ihn hoch und öffnen Sie den Serial Monitor mit 115200 Baud.
Das Listing ist die Datei der Bibliothek beim fixierten Commit, abgesehen von einigen reinen Kommentarzeilen, die den Connector mit einem älteren Namen bezeichnen oder auf andere Soldered-Produkte verweisen und weggelassen wurden. Wo die Kommentare sagen, die Adresse werde mit Jumpern eingestellt, wird sie auf diesem Board mit dem ADDRESS-Schalter eingestellt (0x30 im Auslieferungszustand), und die Adress-Jumper JP2 bis JP4 bleiben wie ausgeliefert. Wo sie sagen, LMPEN sei fest mit GND verbunden, wird LMPEN auf diesem Board durch einen 10-kΩ-Widerstand auf GND gezogen und führt zusätzlich zum Mikrocontroller auf dem Board (siehe Hardware-Details).
/**
**************************************************
*
* @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. Das Ergebnis prüfen
Der Serial Monitor bestätigt zuerst, dass das Board geantwortet hat. Danach folgt alle 2,5 Sekunden eine neue Zeile Sensor reading: mit der SO2-Konzentration in ppm auf fünf Nachkommastellen. Ein Durchlauf in sauberer Luft sah so aus:
Sensor initialized successfully!
Sensor reading: 0.00282 PPM
Sensor reading: 0.00315 PPM
Sensor reading: 0.00292 PPM
Sensor reading: 0.00290 PPM
Die Bibliothek meldet nie einen negativen Wert: Alles unter null wird als 0 ausgegeben.
Sehen Sie stattdessen ERROR: Can't init the sensor! Check connections and jumper address!, hat das Board nicht auf 0x30 geantwortet.
5. Wenn es nicht funktioniert
Fahren Sie mit der Fehlerbehebung fort und wiederholen Sie dieses kleinste Beispiel nach jeder Änderung.
1. Das Breakout-Board anschließen
Stecken Sie ein Qwiic-Kabel in den Qwiic-Connector Ihres Controllers und in einen der beiden Qwiic-Connectoren am Breakout. Das Kabel führt 3,3 V, GND und I2C.
| NULA DeepSleep | Soldered Electrochemical SO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic-Connector | Qwiic-Connector |
Das Beispiel setzt SDA auf Pin 21 und SCL auf Pin 22. Ändern Sie diese beim NULA DeepSleep auf 8 (SDA) und 9 (SCL), die im Diagramm gezeigten I2C-Pins des Boards.
Ohne Qwiic: Verdrahtung auf dem Steckbrett
Löten Sie die mitgelieferten Stiftleisten an und verdrahten Sie die vier Pins der oberen Stiftleiste, die den Haupt-I2C-Bus führen.
| NULA DeepSleep | Soldered Electrochemical SO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
Das Beispiel setzt SDA auf Pin 21 und SCL auf Pin 22. Ändern Sie diese beim NULA DeepSleep auf 8 (SDA) und 9 (SCL), die im Diagramm gezeigten I2C-Pins des Boards.
2. Das Modul installieren
Nachdem Sie das Paket mpremote installiert haben, installieren Sie die Bibliothek mit dem folgenden Befehl auf Ihrem Board:
mpremote mip install github:SolderedElectronics/Soldered-ElectrochemicalGasSensor-MicroPython-Library
Oder, wenn Sie Windows verwenden:
python -m mpremote mip install github:SolderedElectronics/Soldered-ElectrochemicalGasSensor-MicroPython-Library
🔗Soldered ElectrochemicalGasSensor MicroPython-Bibliothek
Geprüftes MicroPython-Modul bei Commit 623e1e6
Tipp: Download von GitHub. Ohne mpremote öffnen Sie die .py-Datei
des Moduls auf GitHub und klicken auf Download raw file. Öffnen Sie sie dann in Thonny und kopieren Sie sie
über Datei → Speichern unter... → MicroPython-Gerät auf das Board.
Diese Bibliothek benötigt drei Dateien auf dem Board: ElectrochemicalGasSensor.py, ads1115.py und lmp91000.py.
3. Das erste Beispiel ausführen
Dies ist das Beispiel electrochemical-bridgeBoard.py der Bibliothek. Es erzeugt den I2C-Bus auf GPIO 22 (SCL) und GPIO 21 (SDA) und kommuniziert mit dem Breakout unter der Adresse 0x30.
- Öffnen Sie das Beispiel in Thonny.
- Ändern Sie
SENSOR_O3an beiden Stellen inSENSOR_SO2: in der Zeile mitimportund in der Zeile, diesensorerzeugt.SENSOR_SO2ist die Voreinstellung der Bibliothek für die SGX-4SO2-Zelle auf diesem Board. - Wenn der Qwiic-Connector Ihres Boards andere Pins verwendet, ändern Sie die Zahlen in der Zeile
I2C(...). - Führen Sie das Skript aus.
Das Listing ist die Datei der Bibliothek beim fixierten Commit, abgesehen von einigen reinen Kommentarzeilen, die den Connector mit einem älteren Namen bezeichnen, auf ein anderes Soldered-Produkt verweisen oder im Anschlussdiagramm ein Controller-Board nennen und weggelassen wurden. Wo die Kommentare sagen, die Adresse werde mit Jumpern eingestellt, wird sie auf diesem Board mit dem ADDRESS-Schalter eingestellt (0x30 im Auslieferungszustand), und die Adress-Jumper JP2 bis JP4 bleiben wie ausgeliefert. Wo sie sagen, LMPEN sei fest mit GND verbunden, wird LMPEN auf diesem Board durch einen 10-kΩ-Widerstand auf GND gezogen und führt zusätzlich zum Mikrocontroller auf dem Board (siehe Hardware-Details).
# 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)
🔗Das vollständige Beispiel öffnen
electrochemical-bridgeBoard.py beim fixierten Commit
4. Das Ergebnis prüfen
Die Thonny-Shell zeigt zuerst den Titel des Beispiels und bestätigt, dass das Board geantwortet hat:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Danach folgt alle 2,5 Sekunden eine neue Zeile Sensor reading: mit der SO2-Konzentration in ppm auf fünf Nachkommastellen. Werte unter null werden als 0 ausgegeben.
5. Wenn es nicht funktioniert
Fahren Sie mit der Fehlerbehebung fort und wiederholen Sie dieses kleinste Beispiel nach jeder Änderung.