Skip to main content

Troubleshooting

Start with the symptom you can observe. Apply one change at a time, then retry the smallest Quick Start example.

SymptomCheckFix
ERROR: Can't init the sensor! right after startThe address you pass to the constructorThe 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 switchThe address in your codePass the new address to the constructor.
ERROR: Can't init the sensor! with the right addressThe cable and the wiringReseat the Qwiic cable on both ends. With header wiring, use SDA1 and SCL1, not SDA2 and SCL2.
The readings do not look like SO2 valuesThe sensor preset in the constructorUse 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.00000Whether the calculated value is below zeroThe 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 manuallyThe second argument of ElectrochemicalGasSensor()Create an I2C object for your board's pins and pass it, as the examples do.
Nothing worksThe supply voltageThe 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