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! right after start | The address you pass to the constructor | The board's switch address is 0x30 to 0x37 (0x30 as shipped), for example ElectrochemicalGasSensor sensor(SENSOR_SO2, 0x30);. |
ERROR: Can't init the sensor! after changing the ADDRESS switch | The address in your code | Pass the new address to the constructor. |
ERROR: Can't init the sensor! with the right address | The cable and the wiring | Reseat the Qwiic cable on both ends. With header wiring, use SDA1 and SCL1, not SDA2 and SCL2. |
| The readings do not look like SO2 values | The sensor preset in the constructor | Use SENSOR_SO2. Most library examples are written for other cells (SENSOR_CO, SENSOR_O3, SENSOR_NH3), and each preset sets its own gain and sensitivity. |
The reading stays at 0.00000 | Whether the calculated value is below zero | The library prints any value below zero as 0. Run the calibration example to set the zero point in clean air. |
MicroPython stops with Board not recognized, please pass an I2C object manually | The second argument of ElectrochemicalGasSensor() | Create an I2C object for your board's pins and pass it, as the examples do. |
| Nothing works | The supply voltage | The board runs from 3.3 V only and has no regulator. Do not connect 5 V to 3V3 or to a Qwiic connector. |
Still blocked?
Ask on the community forum. Include the following so someone can reproduce it:
- product name and SKU: Soldered Electrochemical SO2 Gas Sensor Breakout (Qwiic),
333325 - 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