Schnellstart
Verbinden Sie das Breakout über Qwiic, installieren Sie die Bibliothek und geben Sie die Kohlenmonoxidkonzentration in ppm alle 2,5 Sekunden aus.
Sie programmieren den Controller, der mit diesem Breakout verbunden ist. Das Breakout selbst wird nicht geflasht: Sein ATtiny404 wird mit Firmware geliefert und übernimmt für Sie das Front-End der Gaszelle und den ADC.
Das Board läuft nur mit 3,3 V. Es hat keinen Regler, daher teilen sich die 3V3-Pins der Stiftleiste
und beide Qwiic-Connectors eine gemeinsame 3,3-V-Versorgung. Schließen Sie keine 5 V an.
- Arduino
- MicroPython
1. Das Breakout-Board anschließen
Stecken Sie ein Qwiic-Kabel in einen der beiden Qwiic-Connectors am Board und in den Qwiic-Connector
Ihres Controllers. Jeder Qwiic-Connector führt 3V3, SDA, SCL
und GND, daher versorgt das eine Kabel das Board und stellt die I2C-Verbindung her.
| NULA DeepSleep | Soldered Electrochemical CO Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic-Connector | Qwiic-Connector |
Ohne Qwiic: Verdrahtung über die Stiftleiste
Löten Sie die mitgelieferten Header-Pins an und verbinden Sie die oberen Header-Pins direkt mit der
3,3-V-Versorgung, der Masse und den I2C-Pins Ihres Controllers. Verwenden Sie SDA1 und SCL1: SDA2 und SCL2
sind der interne Bus des Boards zwischen dem ATtiny404 und den Sensorchips.
Die Tabelle und das Diagramm zeigen einen Beispiel-Controller, dessen Standard-I2C-Pins GPIO 8 (SDA) und GPIO 9 (SCL) sind. Verwenden Sie bei einem anderen Controller dessen eigene I2C-Pins.
| NULA DeepSleep | Soldered Electrochemical CO 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.
🔗Arduino-Bibliothek Electrochemical Gas Sensor
Geprüfte Arduino-Bibliothek beim 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 dann in der Arduino IDE über Sketch → Include Library → Add .ZIP Library... hinzu.
3. Das erste Beispiel ausführen
Öffnen Sie bridgeBoard aus den Beispielen der Bibliothek, wählen Sie Ihr Board und den Port aus
und laden Sie es hoch. Es erstellt den Sensor mit dem Preset der CO-Zelle, SENSOR_CO, an der
Standardadresse 0x30 des Boards und gibt alle 2,5 Sekunden einen Messwert aus.
/**
**************************************************
*
* @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);
}
Bei diesem Board wird die Adresse mit dem dreipoligen DIP-Schalter ADDRESS auf der Oberseite
oben links eingestellt, nicht mit Jumpern auf der Rückseite, und die Standardadresse 0x30 muss
nicht geändert werden. LMPEN ist über 10 kΩ auf GND gelegt, statt direkt damit verbunden zu sein;
in beiden Fällen schließen Sie daran nichts an.
🔗Vollständiges Beispiel öffnen
examples/bridgeBoard beim Commit c4df54b
4. Das Ergebnis prüfen
Öffnen Sie den Serial Monitor mit 115200 Baud. In sauberer Luft zeigt ein Durchlauf auf diesem Board Folgendes:
Sensor initialized successfully!
Sensor reading: 0.29553 PPM
Sensor reading: 0.32187 PPM
Sensor reading: 0.29429 PPM
Sensor reading: 0.30653 PPM
Danach folgt alle 2,5 Sekunden eine neue Zeile: Sensor reading: , die
CO-Konzentration in ppm mit fünf Nachkommastellen und PPM. Die Bibliothek meldet nie
eine negative Konzentration: Ein Ergebnis unter null wird als 0.00000 ausgegeben.
Wenn stattdessen ERROR: Can't init the sensor! Check connections and jumper address!
erscheint, 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
Das Beispiel des Moduls öffnet den I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21.
Ändern Sie die Pinnummern im Beispiel, falls sich der Qwiic-Connector Ihres Controllers oder
die Pins, die Sie verdrahten, woanders befinden.
Stecken Sie ein Qwiic-Kabel in einen der beiden Qwiic-Connectors am Board und in den Qwiic-Connector
Ihres Controllers. Jeder Qwiic-Connector führt 3V3, SDA, SCL
und GND, daher versorgt das eine Kabel das Board und stellt die I2C-Verbindung her. Das Diagramm
zeigt einen Beispiel-Controller; der Pin-Hinweis darunter gilt für dieses Board.
| NULA DeepSleep | Soldered Electrochemical CO 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 über die Stiftleiste
Löten Sie die mitgelieferten Header-Pins an und verbinden Sie die oberen Header-Pins direkt mit der
3,3-V-Versorgung, der Masse und den Pins, die Sie im Beispiel festlegen, Ihres Controllers. Verwenden Sie SDA1 und
SCL1: SDA2 und SCL2 sind der interne Bus des Boards.
Die Tabelle und das Diagramm zeigen einen Beispiel-Controller, dessen Standard-I2C-Pins GPIO 8 (SDA) und GPIO 9 (SCL) sind. Verwenden Sie bei einem anderen Controller dessen eigene I2C-Pins und tragen Sie dieselben Nummern im Beispiel ein.
| NULA DeepSleep | Soldered Electrochemical CO 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 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
🔗MicroPython-Bibliothek Electrochemical Gas Sensor
Geprüftes MicroPython-Modul beim 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. Dieses
Modul benötigt drei Dateien auf dem Board: ElectrochemicalGasSensor.py,
lmp91000.py und ads1115.py.
3. Das erste Beispiel ausführen
Dies ist das Beispiel electrochemical-bridgeBoard.py des Moduls. Es öffnet I2C,
erstellt den Sensor an der Standardadresse 0x30 des Boards und gibt alle 2,5 Sekunden
einen Messwert aus.
Ändern Sie vor dem Ausführen SENSOR_O3 in der import-Zeile und
in der Zeile ElectrochemicalGasSensor(...) in SENSOR_CO. SENSOR_O3 ist das Preset
des Moduls für die Ozonzelle, daher würde getPPM() mit der Empfindlichkeit und dem Nullpunkt
dieser Zelle umrechnen. Dieses Board trägt die Kohlenmonoxidzelle SGX-4CO,
und das Preset des Moduls dafür ist 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)
Bei diesem Board wird die Adresse mit dem dreipoligen DIP-Schalter ADDRESS auf der Oberseite
oben links eingestellt, nicht mit Jumpern auf der Rückseite, und die Standardadresse 0x30 muss
nicht geändert werden. LMPEN ist über 10 kΩ auf GND gelegt, statt direkt damit verbunden zu sein;
in beiden Fällen schließen Sie daran nichts an.
🔗Vollständiges Beispiel öffnen
Examples/electrochemical-bridgeBoard.py beim Commit 623e1e6
4. Das Ergebnis prüfen
In sauberer Luft zeigt ein Durchlauf auf diesem Board in der Shell Folgendes:
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
Danach folgt alle 2,5 Sekunden eine neue Zeile: Sensor reading: , die
Konzentration in ppm mit fünf Nachkommastellen und PPM. Ein Ergebnis unter null wird
als 0.00000 ausgegeben.
Wenn stattdessen ERROR: Can't init the sensor! Check connections and jumper address!
erscheint, 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.