Skip to main content

Quick Start

Connect the breakout over Qwiic, install the library, and run the library's example for this board. It finds the board at its default address, 0x30, sets up the analog front end and prints a reading every 2.5 seconds.

You program the controller connected to this breakout. The breakout itself is not flashed: its ATtiny404 comes with its firmware already on it.

The board runs from 3.3 V only. It has no regulator, so the header and both Qwiic connectors share one 3.3 V supply. Do not connect 5 V to 3V3.

The libraries have no preset for this board's SGX-4OX-ROHS oxygen cell yet. The examples below use a preset written for another gas (SENSOR_CO in Arduino, SENSOR_O3 in MicroPython). They prove the connection and show the reading format, but the value they print is calculated with that gas's settings, not the oxygen cell's. The Arduino and MicroPython example pages explain what to change for the oxygen cell.

1. Connect the breakout board​

Plug a Qwiic cable into either Qwiic connector on the board and into the Qwiic connector on your controller. Each Qwiic connector carries 3V3, SDA1, SCL1 and GND, so the one cable powers the board and connects I2C.

NULA DeepSleepSoldered Electrochemical O2 Gas Sensor Breakout (Qwiic)
Qwiic connectorQwiic connector
Wiring diagram: the NULA DeepSleep connected to the Soldered Electrochemical O2 Gas Sensor Breakout (Qwiic) with a Qwiic cable

Without Qwiic: breadboard wiring​

Solder the included header pins and wire the top header's 3V3, GND, SDA1 and SCL1 to your controller's 3.3 V supply, ground and I2C pins. SDA1 and SCL1 are the same bus as the Qwiic connectors.

NULA DeepSleepSoldered Electrochemical O2 Gas Sensor Breakout (Qwiic)
GNDGND
3V33V3
IO8SDA1
IO9SCL1
Wiring diagram: the NULA DeepSleep connected to the Soldered Electrochemical O2 Gas Sensor Breakout (Qwiic): GND to GND, 3V3 to 3V3, IO8 to SDA1, IO9 to SCL1

Leave SDA2 and SCL2 unconnected: they are the board's internal bus between the ATtiny404 and the two analog chips.

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, select your board and port, and upload it. The sketch creates the sensor at 0x30, the address this board answers on with the ADDRESS switch at its default.

Where the sketch's comments mention address jumpers on the back of the board, this board uses the three-position ADDRESS switch on its top side instead.

Select Board
bridgeBoard.ino
/**
**************************************************
*
* @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, the first line is:

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
Sensor initialized successfully!

After it, a line Sensor reading: followed by a value with five decimals and PPM arrives every 2.5 seconds.

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.