Schnellstart
Verbinden Sie das Breakout über Qwiic, installieren Sie die Bibliothek und geben Sie die NO2- Konzentration in ppm aus.
Sie programmieren den Controller, der mit diesem Breakout verbunden ist. Das Breakout selbst wird nicht geflasht: Sein ATtiny404 läuft mit einer Werksfirmware, mit der die Bibliotheken kommunizieren.
Das Board arbeitet ausschließlich mit 3,3 V. Es hat keinen Spannungsregler, und die Stiftleiste und beide
Qwiic-Connectors teilen sich eine 3,3-V-Versorgung. Schließen Sie niemals 5 V an 3V3 oder an
einen Signalpin an.
- Arduino
- MicroPython
1. Breakout-Board anschließen
Stecken Sie ein Qwiic-Kabel in einen der beiden Qwiic-Connectors am Board und in den Qwiic- Connector Ihres Controllers. Das Kabel führt 3,3 V, Masse und I2C und versorgt das Board daher mit Strom und verbindet es in einem Schritt. Lassen Sie die drei ADDRESS-Schalter im Auslieferungszustand: Das Beispiel kommuniziert mit dem Board unter seiner Standardadresse 0x30.
| NULA DeepSleep | Soldered Electrochemical NO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic-Connector | Qwiic-Connector |
Ohne Qwiic: Verdrahtung auf dem Breadboard
Das Board ist nicht zum Einstecken in ein Breadboard gedacht. Löten Sie die mitgelieferten
Stiftleisten an und verbinden Sie die vier Pins am linken Ende der oberen Stiftleiste mit der 3,3-V-Versorgung,
der Masse und den I2C-Pins Ihres Controllers, und zwar mit Jumper-Kabeln. SDA1 und
SCL1 sind derselbe Bus wie an den Qwiic-Connectors.
| NULA DeepSleep | Soldered Electrochemical NO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
Lassen Sie SDA2 und SCL2 unverbunden: Sie bilden den internen Bus des Boards zwischen
dem ATtiny404, dem LMP91000 und dem ADS1115.
2. Bibliothek installieren
Installieren Sie Electrochemical Gas Sensor Soldered aus dem 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 dann in der Arduino IDE über Sketch → Bibliothek einbinden → .ZIP-Bibliothek hinzufügen... hinzu.
3. Erstes Beispiel ausführen
Öffnen Sie bridgeBoard aus den Beispielen der Bibliothek. Es erstellt den Sensor unter der Adresse 0x30, wodurch die Bibliothek mit dem ATtiny404 des Boards kommuniziert, und gibt dann alle 2,5 Sekunden einen Messwert aus.
Das Beispiel erstellt den Sensor mit der Voreinstellung für Kohlenmonoxid, SENSOR_CO.
Ändern Sie SENSOR_CO
in SENSOR_NO2, bevor Sie hochladen: SENSOR_NO2 ist die Voreinstellung der Bibliothek
für die SGX-4NO2-Zelle auf diesem Board, und die ppm-Berechnung verwendet ihre Werte.
/**
**************************************************
*
* @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);
}
Der Kommentar am Anfang des Beispiels besagt, dass LMPEN fest mit GND verbunden ist. Auf diesem
Board ist LMPEN der Enable-Eingang des LMP91000 und zusätzlich mit dem ATtiny404 verbunden,
wie Hardware-Details
zeigt. In beiden Fällen schließen Sie nichts daran an: Bei den Adressen 0x30 bis 0x37 verwendet die
Bibliothek das dritte Argument des Konstruktors nicht.
4. Ergebnis prüfen
Öffnen Sie den Serial Monitor mit 115200 Baud. Sobald das Board antwortet, gibt der Sketch Folgendes aus:
Sensor initialized successfully!
Sensor reading: 0.01439 PPM
Sensor reading: 0.01405 PPM
Sensor reading: 0.01371 PPM
Sensor reading: 0.01442 PPM
Alle 2,5 Sekunden folgt eine neue Zeile Sensor reading: mit der NO2-
Konzentration in ppm auf fünf Nachkommastellen. Die Bibliothek meldet nie
eine negative Konzentration: Ein Ergebnis unter null wird als 0 angezeigt.
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 anschließen
Stecken Sie ein Qwiic-Kabel in einen der beiden Qwiic-Connectors am Board und in den Qwiic- Connector Ihres Controllers. Das Kabel führt 3,3 V, Masse und I2C und versorgt das Board daher mit Strom und verbindet es in einem Schritt. Lassen Sie die drei ADDRESS-Schalter im Auslieferungszustand: Das Beispiel kommuniziert mit dem Board unter seiner Standardadresse 0x30.
| NULA DeepSleep | Soldered Electrochemical NO2 Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic-Connector | Qwiic-Connector |
Das Beispiel setzt SDA auf Pin 21 und SCL auf Pin 22. Ändern Sie sie beim NULA DeepSleep auf 8 (SDA) und 9 (SCL), die im Diagramm gezeigten I2C-Pins des Boards.
Ohne Qwiic: Verdrahtung auf dem Breadboard
Das Board ist nicht zum Einstecken in ein Breadboard gedacht. Löten Sie die mitgelieferten
Stiftleisten an und verbinden Sie die vier Pins am linken Ende der oberen Stiftleiste mit Ihrem
Controller, und zwar mit Jumper-Kabeln. Das Beispiel öffnet I2C-Bus 0 mit SCL an Pin 22
und SDA an Pin 21; ändern Sie diese Nummern im Beispiel, wenn Sie andere Pins verdrahten.
| NULA DeepSleep | Soldered Electrochemical NO2 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 beim NULA DeepSleep auf 8 (SDA) und 9 (SCL), die im Diagramm gezeigten I2C-Pins des Boards.
Lassen Sie SDA2 und SCL2 unverbunden: Sie bilden den internen Bus des Boards zwischen
dem ATtiny404, dem LMP91000 und dem ADS1115.
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 ein Windows-Betriebssystem 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 benötigt alle drei Dateien: ElectrochemicalGasSensor.py, ads1115.py und
lmp91000.py.
3. Erstes Beispiel ausführen
Dies ist das Beispiel electrochemical-bridgeBoard.py des Moduls. Es erstellt den
Sensor unter der Adresse 0x30, wodurch das Modul mit dem ATtiny404 des Boards kommuniziert,
und gibt dann alle 2,5 Sekunden einen Messwert aus.
Das Beispiel erstellt den Sensor mit der Ozon-Voreinstellung SENSOR_O3. Ändern Sie
SENSOR_O3 an beiden Stellen in SENSOR_NO2, in der import-Zeile und in der Zeile,
die den Sensor erstellt: SENSOR_NO2 ist die Voreinstellung des Moduls für die SGX-4NO2-
Zelle auf diesem 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
Der Kommentar am Anfang des Beispiels besagt, dass LMPEN fest mit GND verbunden ist. Auf diesem
Board ist LMPEN der Enable-Eingang des LMP91000 und zusätzlich mit dem ATtiny404 verbunden,
wie Hardware-Details
zeigt. In beiden Fällen schließen Sie nichts daran an: Bei adc_addr 0x30 bis 0x37 verwendet das
Modul config_pin nicht.
4. Ergebnis prüfen
Sobald das Board antwortet, zeigt die Shell Folgendes an:
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Sensor reading: 0.01443 PPM
Sensor reading: 0.01407 PPM
Sensor reading: 0.01431 PPM
Sensor reading: 0.01423 PPM
Alle 2,5 Sekunden folgt eine neue Zeile Sensor reading: mit der NO2-
Konzentration in ppm auf fünf Nachkommastellen. Ein Ergebnis unter
null wird als 0 angezeigt.
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.