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
Every reading is zeroDid the sensor answer at all?Zero readings usually mean the sensor never replied. Reseat the Qwiic cable at both ends, or try a second cable. If you wired the header instead, confirm that SDA and SCL go to your controller's actual I2C pins, which are not the same number on every board.
An I2C scan finds nothing on the busIs anything answering?Run an I2C scanner sketch and look at the list. If it is empty, the problem is the wiring, the pull-ups or the controller's I2C bus rather than the sensor.
An I2C scan finds a device, but the sketch still reads zeroWhich address did it find?The BME280 on this board answers at 0x76 and nowhere else, because the address is fixed in hardware. A reading sketch that looks for a different address will not find it.
Another device on the same bus already uses 0x76Is the address free?It cannot be changed on this board, so move the other device or remove it from the bus.
Temperature is consistently a few degrees highIs the sensor heating itself?It does, slightly. Compare against a separate thermometer and add the difference as an offset in your sketch, the way the offset variable in the example does.
The altitude is nowhere near your real altitudeWhat sea-level pressure is assumed?Both altitude functions assume the standard 1013.25 hPa at sea level. When the real sea-level pressure is different, the estimate drifts with the weather, which is expected behaviour rather than a fault.
Nothing appears in the Serial MonitorBaud rate and portSet the monitor to 115200 baud, the rate the examples use, and check that the port belongs to the controller you uploaded to.

Still blocked?​

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

  • product name and SKU: Environmental Sensor BME280 Breakout, 333036
  • 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