Schnellstart
Verbinden Sie den Breakout über Qwiic, installieren Sie die Bibliothek und geben Sie die Gaskonzentration, die die Zelle misst, in Parts per Million (PPM) aus.
Sie programmieren den Controller, der an diesen Breakout angeschlossen ist. Der Breakout selbst wird nicht geflasht: Sein ATtiny404 läuft mit der Werksfirmware.
Das Board arbeitet nur mit 3,3 V. Es hat keinen Spannungsregler, 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. Breakout-Board verbinden
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, GND und den
I2C-Bus des Boards (SDA1 und SCL1), sodass das eine Kabel das Board versorgt und
verbindet.
| NULA DeepSleep | Soldered Electrochemical Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic Connector | Qwiic Connector |
Das Board wird mit der I2C-Adresse 0x30 ausgeliefert, die das folgende Beispiel verwendet.
Ohne Qwiic: die Stiftleiste verdrahten
Das Board ist nicht steckbrettkompatibel. Löten Sie die mitgelieferten Stiftleisten an und
verbinden Sie die obere Stiftleiste mit der 3,3-V-Versorgung, der Masse und den I2C-Pins Ihres Controllers. Verwenden Sie SDA1 und SCL1: Dieses Beispiel kommuniziert mit der
ATtiny404-Bridge unter 0x30, die an SDA1 und SCL1 liegt. SDA2 und SCL2
sind der Bus zwischen dem ATtiny404 und den beiden Analogchips; nur die
Beispiele mit Direktadressierung verdrahten den Controller dort.
| NULA DeepSleep | Soldered Electrochemical Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
2. Bibliothek installieren
Installieren Sie Electrochemical Gas Sensor Soldered aus dem zugehörigen GitHub-Repository.
🔗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 dann 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. Es kommuniziert mit der ATtiny404-Bridge unter der Adresse 0x30 und gibt alle 2,5 Sekunden einen Messwert aus.
Der Sketch verwendet die Voreinstellung für Kohlenmonoxid, SENSOR_CO. Wenn Ihre Zelle
ein anderes Gas misst, ändern Sie sie vor dem Hochladen auf die Voreinstellung dieses Gases: SENSOR_NO2,
SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3 oder
SENSOR_CL2.
Zwei Kommentare des Sketches passen nicht zu diesem Board. Die Adresse wird mit
dem ADDRESS-Schalter oben auf dem Board eingestellt, nicht mit Jumpern auf der Rückseite, und sie
ist ab Werk 0x30. LMPEN liegt nicht an GND: Er führt zur Stiftleiste und zum
ATtiny404, und die Bibliothek steuert ihn nicht an. Der Kommentar, der
„legacy boards with 0x49/0x4A/0x4B“ erwähnt, meint Boards, die unter diesen Adressen gelesen werden und bei denen
die Bibliothek direkt mit einem ADS1115 statt mit der Bridge kommuniziert. Dieses Board
antwortet unter 0x30 bis 0x37. Wo die Kommentare vom neuen ATtiny404-Bridge-Board sprechen,
meinen sie ein Board mit der ATtiny404-Bridge, und genau das hat dieses Board.
/**
**************************************************
*
* @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);
}
🔗Vollständiges Beispiel öffnen
examples/bridgeBoard bei Commit c4df54b
4. Ergebnis prüfen
Öffnen Sie den Seriellen Monitor mit 115200 Baud. Wenn das Board antwortet, gibt der Sketch Folgendes aus:
Sensor initialized successfully!
Sensor reading: 0.30045 PPM
Sensor reading: 0.30838 PPM
Sensor reading: 0.32838 PPM
Sensor reading: 0.30712 PPM
Alle 2,5 Sekunden kommt eine neue Messzeile: Sensor reading: , die
Konzentration mit fünf Nachkommastellen und PPM. Ein negatives Ergebnis wird als
0 ausgegeben.
Wenn stattdessen ERROR: Can't init the sensor! Check connections and jumper address!
erscheint, hat das Board nicht unter 0x30 geantwortet. Der Sketch hält dort an; beheben Sie
die Verbindung und drücken Sie dann Reset.
5. Wenn es nicht funktioniert
Fahren Sie mit der Fehlerbehebung fort und wiederholen Sie dieses kleinste Beispiel nach jeder Änderung.
1. Breakout-Board verbinden
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, GND und den
I2C-Bus des Boards (SDA1 und SCL1), sodass das eine Kabel das Board versorgt und
verbindet.
| NULA DeepSleep | Soldered Electrochemical Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic Connector | Qwiic Connector |
The example sets SDA to pin 21 and SCL to pin 22. On the NULA DeepSleep, change them to 8 (SDA) and 9 (SCL), the board's I2C pins shown in the diagram.
Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21. Ändern Sie
diese beiden Zahlen im Beispiel, wenn der Qwiic Connector Ihres Controllers oder die
Pins, die Sie verdrahten, woanders liegen.
Ohne Qwiic: die Stiftleiste verdrahten
Das Board ist nicht steckbrettkompatibel. Löten Sie die mitgelieferten Stiftleisten an und
verbinden Sie die obere Stiftleiste mit der 3,3-V-Versorgung, der Masse und den I2C-Pins,
die das Beispiel verwendet. Verwenden Sie SDA1 und SCL1: Dieses Beispiel kommuniziert mit der ATtiny404-
Bridge unter 0x30, die an SDA1 und SCL1 liegt. SDA2 und SCL2 sind der Bus
zwischen dem ATtiny404 und den beiden Analogchips; nur die Beispiele mit
Direktadressierung verdrahten den Controller dort.
| NULA DeepSleep | Soldered Electrochemical Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
The example sets SDA to pin 21 and SCL to pin 22. On the NULA DeepSleep, change them to 8 (SDA) and 9 (SCL), the board's I2C pins shown in the diagram.
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 ElectrochemicalGasSensor MicroPython Library
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
File → Save as... → MicroPython device auf das Board.
Die Bibliothek besteht aus drei Dateien: ElectrochemicalGasSensor.py, ads1115.py und
lmp91000.py. Kopieren Sie alle drei, wenn Sie manuell installieren.
3. Erstes Beispiel ausführen
Dies ist das Beispiel electrochemical-bridgeBoard.py des Moduls. Es kommuniziert mit der
ATtiny404-Bridge unter der Adresse 0x30 und gibt alle 2,5 Sekunden einen Messwert aus.
Es verwendet die Voreinstellung für Ozon, SENSOR_O3. Wenn Ihre Zelle ein anderes Gas misst,
import and pass that gas's preset instead: SENSOR_CO, SENSOR_NO2,
SENSOR_SO2, SENSOR_NO, SENSOR_H2S, SENSOR_NH3 oder SENSOR_CL2.
Zwei Kommentare des Beispiels passen nicht zu diesem Board. Die Adresse wird mit
dem ADDRESS-Schalter oben auf dem Board eingestellt, nicht mit Jumpern auf der Rückseite, und sie
ist ab Werk 0x30. LMPEN liegt nicht an GND: Er führt zur Stiftleiste und zum
ATtiny404, und die Bibliothek steuert ihn nicht an. Der Kommentar, der
„legacy boards with 0x49/0x4A/0x4B“ erwähnt, meint Boards, die unter diesen Adressen gelesen werden und bei denen
die Bibliothek direkt mit einem ADS1115 statt mit der Bridge kommuniziert. Dieses Board
antwortet unter 0x30 bis 0x37. Wo die Kommentare vom ATtiny404-Bridge-Board sprechen,
meinen sie ein Board mit der ATtiny404-Bridge, und genau das hat dieses Board.
# 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, zeigt die Shell Folgendes an:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Sensor reading: 0.03165 PPM
Sensor reading: 0.03202 PPM
Sensor reading: 0.03062 PPM
Sensor reading: 0.03069 PPM
Alle 2,5 Sekunden kommt eine neue Messzeile: Sensor reading: , die
Konzentration mit fünf Nachkommastellen und PPM. Ein negatives Ergebnis wird als
0 ausgegeben.
Wenn stattdessen ERROR: Can't init the sensor! Check connections and jumper address!
erscheint, hat das Board nicht unter 0x30 geantwortet, und das Skript wartet dort. Beheben Sie
die Verbindung und führen Sie es erneut aus.
5. Wenn es nicht funktioniert
Fahren Sie mit der Fehlerbehebung fort und wiederholen Sie dieses kleinste Beispiel nach jeder Änderung.