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 board did not answer at the address in your code within 500 ms. Check the Qwiic cable at both ends, that the board gets 3.3 V, and that the address in the code matches the board's address switches. | Reseat the cable, power the board from 3.3 V, and pass the board's address (0x30 as shipped) to the constructor. Then reset the controller. |
| Readings do not look like CO | Look at the preset in the line that creates the sensor. The MicroPython examples use SENSOR_O3, the ozone cell's preset (customConfig builds its own SensorConfig with the same values). Some Arduino examples use SENSOR_NH3, SENSOR_SO2, SENSOR_NO2 or their own sensorType. | Use SENSOR_CO, the libraries' preset for this board's SGX-4CO cell. In MicroPython, change it in the import line too. |
The reading is always 0.00000 | The libraries never return a negative concentration: a result below zero is reported as 0, so a reading that never moves from 0 can also come from a preset that does not match the cell. Check that your code uses SENSOR_CO. | Test the cell with a known CO source if you have one: the cell's datasheet gives its response time (T90) as under 30 s, so expect most of the response within about 30 seconds. setCustomZeroCalibration() sets the zero-calibration voltage, in volts, that getPPM() adds to the measured voltage before it converts it to ppm. |
| Two boards on one bus, only one answers or both fail | Both boards are at the same address. | Move one board's address switches so each board has its own address from 0x30 to 0x37, and create one object per address. The libraries' two-sensor examples create their objects at 0x4A and 0x49, which are ADS1115 addresses, not these board addresses: see "What it needs on this board" on the Arduino and MicroPython two-sensor pages. |
| Wiring the header, nothing answers | With a board address from 0x30 to 0x37 in your code, as in the Quick Start, check that your controller's I2C goes to SDA1 and SCL1, not to SDA2 and SCL2. | SDA2 and SCL2 are the board's internal bus. Move the wires to SDA1 and SCL1. Only the examples that use an ADS1115 address (0x49, 0x4A or 0x4B) are wired to SDA2 and SCL2, as their pages say. |
Still blocked?
Ask on the community forum. Include the following so someone can reproduce it:
- product name and SKU: Soldered Electrochemical CO Gas Sensor Breakout (Qwiic),
333328 - controller board and software environment
- library or module revision
- complete error text or unexpected output
- connection method and power source
- the I2C address in your code and the position of the address switches
- a clear photo of the wiring