Quick Start
Connect the breakout over Qwiic, install the library, and print the nitric oxide (NO) concentration in ppm.
You program the controller connected to this breakout. The breakout itself is not flashed: its ATtiny404 runs factory firmware.
The board is 3.3 V only and has no regulator. The header and both Qwiic
connectors share one 3.3 V supply. Do not connect 5 V to 3V3 or to the
signal pins.
- Arduino
- MicroPython
1. Connect the breakout board
Plug a Qwiic cable into either Qwiic connector on the board and into the Qwiic connector on your controller. Leave the ADDRESS switch as it came, so the board answers at its default address, 0x30.
| NULA DeepSleep | Soldered Electrochemical NO Gas Sensor Breakout (Qwiic) |
|---|---|
| Qwiic connector | Qwiic connector |
Without Qwiic: breadboard wiring
The board is not breadboard compatible, so wire it through its header pads
with jumper wires. Use the SDA1/SCL1 pair on the top edge: it is the bus
the board answers on. SDA2/SCL2 is the board's internal bus.
| NULA DeepSleep | Soldered Electrochemical NO Gas Sensor Breakout (Qwiic) |
|---|---|
| GND | GND |
| 3V3 | 3V3 |
| IO8 | SDA1 |
| IO9 | SCL1 |
2. Install the library
Install Electrochemical Gas Sensor Soldered from its GitHub repository.
🔗Soldered Electrochemical Gas Sensor Arduino library
Verified Arduino library at commit c4df54b
Tip: downloading from GitHub. On the library's GitHub page, click the green Code button and choose Download ZIP, then add it in Arduino IDE with Sketch → Include Library → Add .ZIP Library....
3. Run the first example
Open bridgeBoard from the library's examples. It creates the sensor at 0x30, the board's default address, so the library talks to the board's ATtiny404 bridge. It starts the sensor and prints a reading, waiting 2.5 seconds between readings.
Change SENSOR_CO to SENSOR_NO before you upload. SENSOR_NO is the
library's preset for this board's SGX-4NO-250 cell. SENSOR_CO sets up the
front end for a carbon monoxide cell, with another bias, gain and
sensitivity, so its result is not NO in ppm.
The listing is the library's file at the pinned commit. Only comment lines are left out: the three that name the old connector, and the header lines that link other products' store pages.
The sketch's comment says LMPEN is hardwired to GND. On this board a 10 kΩ
resistor pulls LMPEN to GND, and the pin is also wired to the ATtiny404 and
the header. Either way you pass no pin for it: at 0x30 to 0x37 the library
ignores the constructor's third argument.
/**
**************************************************
*
* @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. Check the result
Open the Serial Monitor at 115200 baud. When the board answers, you see this (readings in clean air; yours will differ):
Sensor initialized successfully!
Sensor reading: 0.00630 PPM
Sensor reading: 0.00622 PPM
Sensor reading: 0.00573 PPM
Sensor reading: 0.00601 PPM
Each Sensor reading: line is one reading, with the NO concentration in ppm
to five decimals and PPM at the end. The library reports a negative result
as 0.00000.
If you see ERROR: Can't init the sensor! Check connections and jumper address!
instead, the board did not answer at 0x30.
5. If it does not work
Continue with Troubleshooting and retry this smallest example after each change.
1. Connect the breakout board
The module's example opens I2C bus 0 with SCL on pin 22 and SDA on pin 21.
Change those pin numbers in the example if your controller's Qwiic connector
uses other pins.
Plug a Qwiic cable into either Qwiic connector on the board and into the Qwiic connector on your controller. Leave the ADDRESS switch as it came, so the board answers at its default address, 0x30.
| NULA DeepSleep | Soldered Electrochemical NO 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.
Without Qwiic: breadboard wiring
The board is not breadboard compatible, so wire it through its header pads
with jumper wires. Use the SDA1/SCL1 pair on the top edge: it is the bus
the board answers on. SDA2/SCL2 is the board's internal bus.
| NULA DeepSleep | Soldered Electrochemical NO 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. Install the module
After installing the mpremote package, install the library on your board using the following command:
mpremote mip install github:SolderedElectronics/Soldered-ElectrochemicalGasSensor-MicroPython-Library
Or, if you're running a Windows OS:
python -m mpremote mip install github:SolderedElectronics/Soldered-ElectrochemicalGasSensor-MicroPython-Library
🔗Soldered Electrochemical Gas Sensor MicroPython library
Verified MicroPython module at commit 623e1e6
Tip: downloading from GitHub. Without mpremote, open the module's .py
file on GitHub and click Download raw file, then open it in Thonny and use
File → Save as... → MicroPython device to copy it onto the board. This
library needs all three files: ElectrochemicalGasSensor.py, lmp91000.py
and ads1115.py.
3. Run the first example
This is the module's electrochemical-bridgeBoard.py example. It creates the
sensor at 0x30, the board's default address, so the module talks to the
board's ATtiny404 bridge. It starts the sensor and prints a reading, waiting
2.5 seconds between readings.
Change SENSOR_O3 to SENSOR_NO in both places (the import line and the
ElectrochemicalGasSensor(...) line) before you run it. SENSOR_NO is the
module's preset for this board's SGX-4NO-250 cell. SENSOR_O3 sets up the
front end for an ozone cell, so its result is not NO in ppm.
The listing is the module's file at the pinned commit. Only comment lines are left out: the one that names the old connector, the header line that names another product's store page, and the connecting-diagram line that names an old board.
The example's comment says LMPEN is hardwired to GND. On this board a 10 kΩ
resistor pulls LMPEN to GND, and the pin is also wired to the ATtiny404 and
the header. Either way you set no config_pin: at 0x30 to 0x37 the module
ignores it.
# 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)
🔗Open the complete example
Examples/electrochemical-bridgeBoard.py at commit 623e1e6
4. Check the result
When the board answers, the shell shows this (readings in clean air; yours will differ):
Electrochemical Gas Sensor - ATtiny Bridge Board Example
Sensor initialized successfully!
Sensor reading: 0.00630 PPM
Sensor reading: 0.00614 PPM
Sensor reading: 0.00610 PPM
Sensor reading: 0.00606 PPM
Each Sensor reading: line is one reading, with the NO concentration in ppm
to five decimals and PPM at the end. The module reports a negative result
as 0.00000.
If you see ERROR: Can't init the sensor! Check connections and jumper address!
instead, the board did not answer at 0x30.
5. If it does not work
Continue with Troubleshooting and retry this smallest example after each change.