Troubleshooting
Start with the symptom you can observe. Apply one change at a time, then retry the smallest Quick Start example.
| Symptom | Check | Fix |
|---|---|---|
| Every reading is zero | Did 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 bus | Is 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 zero | Which 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 0x76 | Is 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 high | Is 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 altitude | What 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 Monitor | Baud rate and port | Set 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