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 library waits up to 500 ms for the board to answer on the address you passed. Is the Qwiic cable fully seated at both ends, and does the address in your code match the ADDRESS switch? | Reseat the cable, then pass the switch's address (0x30 by default, up to 0x37) to the constructor and reset the controller. An example that uses any other address talks to the ADS1115 directly: wire it to the header's SDA2 and SCL2 pins, not over Qwiic. |
| Readings do not look like ammonia values | Which preset does your code use? The bridge examples ship with SENSOR_CO (Arduino) or SENSOR_O3 (MicroPython), whose sensitivity and gain differ from this cell's. | Use SENSOR_NH3, the preset for this board's SGX-4NH3 cell. |
| The reading stays at 0 | The library prints any result below zero as 0. | Check your zero offset with the calibration example and set it with setCustomZeroCalibration(). |
Board not recognized, please pass an I2C object manually in MicroPython | The module picks I2C pins by itself only on the few boards it recognises by name, among them ESP32 and ESP8266. | Create an I2C object for your board's pins and pass it as the second argument, as the examples do. |
Still blocked?
Ask on the community forum. Include the following so someone can reproduce it:
- product name and SKU: Soldered Electrochemical NH3 Gas Sensor Breakout (Qwiic),
333330 - 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