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! | 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 wiring | The 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 0 | The 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