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! from a bridgeBoard examplebegin() returns false when the board does not answer at the address in your code. Is the Qwiic cable seated at both ends? Is the ADDRESS switch still as it came?Reseat the cable. Leave the ADDRESS switch as it came and keep 0x30 in the code: 0x30 is the only switch address confirmed so far. Run the example again.
ERROR: Can't init the sensor! Check connections! (or, in MicroPython, Can't init sensor 1! or 2!) from another examplebegin() returns false when the board does not answer at the address the sensor is created with. Is the cable seated at both ends? In MicroPython, are the I2C pins in the example (scl=Pin(22), sda=Pin(21)) your controller's I2C pins?Reseat the cable, change the pin numbers to your controller's if they differ, and run the example again.
The example runs, but the reading is not NO in ppmThe library's examples pass presets for other gas cells: SENSOR_CO, SENSOR_NH3, SENSOR_SO2 or SENSOR_NO2 in the Arduino sketches (customConfig builds its own), and SENSOR_O3 in MicroPython (customConfig builds its own preset with the same values).Use SENSOR_NO, the preset for this board's SGX-4NO-250 cell.
The reading stays at 0.00000The library reports any negative result as 0.Use setCustomZeroCalibration() to add a voltage offset, as the library's calibrateSensor example does, so the reading sits just at 0 ppm in air with no NO.
MicroPython stops with Board not recognized, please pass an I2C object manuallyYou created the sensor without an I2C object on a board the module does not recognise.Create an I2C object for your board's pins and pass it as the second argument, as the bridgeBoard example does.
Your controller's supply or I2C lines run at 5 VThe board's supply and logic level are 3.3 V only, with no regulator.Power it from 3.3 V and use 3.3 V I2C. Never connect 5 V to 3V3 or a signal pin.

Still blocked?​

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

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