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! Check connections and jumper address!The address in your code matches the address switch. The example uses 0x30, the address the board ships at.Pass the board's address (0x30 to 0x37) to ElectrochemicalGasSensor, then reset or rerun.
The same error with header wiringThe bus matches the address. The bridge examples (0x30 to 0x37) need SDA1 and SCL1; the direct-address examples (0x49 to 0x4B) need SDA2 and SCL2.Move the wires to the pins the example's address needs. Over Qwiic, only the bridge at 0x30 to 0x37 answers, because the Qwiic connectors carry SDA1 and SCL1.
The reading stays at 0The preset matches your cell. Presets differ in sign and range: the NO2 and O3 presets use negative nA/ppm sensitivities.Pass the preset for the gas your cell measures. getPPM() returns 0 for any negative result, so a mismatched preset can hide the signal.

Still blocked?​

Ask on the community forum. Include the following so someone can reproduce it:

  • product name and SKU: Soldered Electrochemical Gas Sensor Breakout (Qwiic), 333417
  • 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