Troubleshooting
Start with the symptom you can observe. Apply one change at a time, then retry the smallest Quick Start example.
| Symptom | Check | Fix |
|---|---|---|
ERROR: Can't init the sensor! Check connections and jumper address! | Whether the Qwiic cable is seated at both ends, and whether the address in your code matches the ADDRESS switches. begin() returns false when the board does not answer each setup step within 500 ms. | Reseat the cable and reset the controller. Pass the address the switches set, from 0x30 to 0x37, when you create the sensor. |
| Readings do not look like NO2 values | Which preset the sensor is created with. The bridgeBoard examples use SENSOR_CO (Arduino) and SENSOR_O3 (MicroPython). | Change it to SENSOR_NO2, the libraries' preset for the SGX-4NO2 cell. |
| The reading stays at 0 | Whether the result would be below zero. The libraries report any negative result as 0. | Readings at or near zero NO2 show as 0. |
MicroPython raises Board not recognized, please pass an I2C object manually | Whether you created ElectrochemicalGasSensor without an I2C object. The module picks the pins by the port MicroPython reports, ESP32 or ESP8266. | Create I2C(...) with your pins and pass it, as the example does. |
The board runs from 3.3 V only and has no regulator. Never power it from 5 V.
Still blocked?
Ask on the community forum. Include the following so someone can reproduce it:
- product name and SKU: Soldered Electrochemical NO2 Gas Sensor Breakout (Qwiic),
333326 - controller board and software environment
- library or module revision
- complete error text or unexpected output
- connection method and power source
- a clear photo of the wiring