Schnellstart
Verbinden Sie das Breakout über Qwiic, installieren Sie die Bibliothek und führen Sie das Beispiel der Bibliothek für dieses Board aus. Es findet das Board unter seiner Standardadresse 0x30, richtet das analoge Frontend ein und gibt alle 2,5 Sekunden einen Messwert aus.
Sie programmieren den Controller, der mit diesem Breakout verbunden ist. Das Breakout selbst wird nicht geflasht: Sein ATtiny404 wird mit bereits aufgespielter Firmware geliefert.
Das Board arbeitet ausschließlich mit 3,3 V. Es hat keinen Spannungsregler, daher teilen sich die Stiftleiste und beide Qwiic-Connectors eine gemeinsame 3,3-V-Versorgung. Schließen Sie keine 5 V an 3V3 an.
Die Bibliotheken haben noch keine Voreinstellung für die Sauerstoffzelle SGX-4OX-ROHS dieses Boards. Die folgenden Beispiele verwenden eine Voreinstellung, die für ein anderes Gas geschrieben wurde (SENSOR_CO in Arduino, SENSOR_O3 in MicroPython). Sie belegen die Verbindung und zeigen das Format der Messwerte, aber der ausgegebene Wert wird mit den Einstellungen dieses Gases berechnet, nicht mit denen der Sauerstoffzelle. Die Beispielseiten für Arduino
und MicroPython
erklären, was für die Sauerstoffzelle zu ändern ist.
- Arduino
- MicroPython
1. Breakout-Board verbinden
Stecken Sie ein Qwiic-Kabel in einen der beiden Qwiic-Connectors auf dem Board und in den Qwiic-Connector Ihres Controllers. Jeder Qwiic-Connector führt 3V3, SDA1, SCL1 und GND, sodass das eine Kabel das Board versorgt und I2C verbindet.
| NULA DeepSleep | Soldered Electrochemical O2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic connector | Qwiic connector |
Ohne Qwiic: Verdrahtung auf dem Breadboard
Löten Sie die mitgelieferten Stiftleisten an und verbinden Sie 3V3, GND, SDA1 und SCL1 der oberen Stiftleiste mit der 3,3-V-Versorgung, der Masse und den I2C-Pins Ihres Controllers. SDA1 und SCL1 sind derselbe Bus wie an den Qwiic-Connectors.
| NULA DeepSleep | Soldered Electrochemical O2 Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
Lassen Sie SDA2 und SCL2 unbeschaltet: Sie bilden den internen Bus des Boards zwischen dem ATtiny404 und den beiden Analogchips.
2. Bibliothek installieren
Installieren Sie Electrochemical Gas Sensor Soldered aus dem zugehörigen GitHub-Repository.
🔗Soldered Electrochemical Gas Sensor Arduino-Bibliothek
Verifizierte 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 → Include Library → Add .ZIP Library... hinzu.
3. Erstes Beispiel ausführen
Öffnen Sie bridgeBoard aus den Beispielen der Bibliothek, wählen Sie Ihr Board und Ihren Port aus und laden Sie es hoch. Der Sketch erzeugt den Sensor unter 0x30, der Adresse, auf der dieses Board bei der Standardstellung des ADDRESS-Schalters antwortet.
Wo die Kommentare des Sketches Adress-Jumper auf der Rückseite des Boards erwähnen, hat dieses Board stattdessen den dreistufigen ADDRESS-Schalter auf der Oberseite.
/**
**************************************************
*
* @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. Ergebnis prüfen
Öffnen Sie den Serial Monitor mit 115200 Baud. Wenn das Board antwortet, lautet die erste Zeile:
Sensor initialized successfully!
Danach erscheint alle 2,5 Sekunden eine Zeile Sensor reading: gefolgt von einem Wert mit fünf Nachkommastellen und PPM.
Wenn stattdessen ERROR: Can't init the sensor! Check connections and jumper address! erscheint, hat das Board unter 0x30 nicht geantwortet.
5. Wenn es nicht funktioniert
Fahren Sie mit der Fehlerbehebung fort und wiederholen Sie dieses kleinste Beispiel nach jeder Änderung.
1. Breakout-Board verbinden
Das Beispiel des Moduls öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie die Pinnummern im Beispiel, wenn der Qwiic-Connector Ihres Controllers oder die Pins, die Sie verdrahten, woanders liegen.
Stecken Sie ein Qwiic-Kabel in einen der beiden Qwiic-Connectors auf dem Board und in den Qwiic-Connector Ihres Controllers. Jeder Qwiic-Connector führt 3V3, SDA1, SCL1 und GND, sodass das eine Kabel das Board versorgt und I2C verbindet.
| NULA DeepSleep | Soldered Electrochemical O2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic connector | Qwiic connector |
Das Beispiel setzt SDA auf Pin 21 und SCL auf Pin 22. Ändern Sie sie am NULA DeepSleep auf 8 (SDA) und 9 (SCL), die I2C-Pins des Boards, die im Diagramm gezeigt sind.
Ohne Qwiic: Verdrahtung auf dem Breadboard
Löten Sie die mitgelieferten Stiftleisten an und verbinden Sie SDA1 der oberen Stiftleiste mit IO8 und SCL1 mit IO9 am NULA DeepSleep. Ändern Sie dann die Pins des Beispiels auf 8 (SDA) und 9 (SCL).
| NULA DeepSleep | Soldered Electrochemical O2 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 sie am NULA DeepSleep auf 8 (SDA) und 9 (SCL), die I2C-Pins des Boards, die im Diagramm gezeigt sind.
Lassen Sie SDA2 und SCL2 unbeschaltet: Sie bilden den internen Bus des Boards zwischen dem ATtiny404 und den beiden Analogchips.
2. Modul installieren
Nachdem Sie das mpremote-Paket 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 Electrochemical Gas Sensor MicroPython-Bibliothek
Verifiziertes 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 File → Save as... → MicroPython device auf das Board. Diese Bibliothek besteht aus drei Dateien: ElectrochemicalGasSensor.py, ads1115.py und lmp91000.py.
3. Erstes Beispiel ausführen
Dies ist das Beispiel electrochemical-bridgeBoard.py des Moduls. Es erzeugt den Sensor unter 0x30, bricht mit einem Fehler ab, wenn das Board nicht antwortet, und gibt alle 2,5 Sekunden einen Messwert aus. Ändern Sie scl und sda, wenn Sie andere Pins verdrahtet haben.
Wo die Kommentare des Beispiels Adress-Jumper auf der Rückseite des Boards erwähnen, hat dieses Board stattdessen den dreistufigen ADDRESS-Schalter auf der Oberseite.
# 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)
🔗Vollständiges Beispiel öffnen
Examples/electrochemical-bridgeBoard.py bei Commit 623e1e6
4. Ergebnis prüfen
Wenn das Board antwortet, beginnt die Shell mit:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Danach erscheint alle 2,5 Sekunden eine Zeile Sensor reading: gefolgt von einem Wert mit fünf Nachkommastellen und PPM.
Wenn stattdessen ERROR: Can't init the sensor! Check connections and jumper address! erscheint, hat das Board unter 0x30 nicht geantwortet.
5. Wenn es nicht funktioniert
Fahren Sie mit der Fehlerbehebung fort und wiederholen Sie dieses kleinste Beispiel nach jeder Änderung.