Skip to main content

bme280pi: the BME280 Sensor Reader for Raspberry Pi

Project description

Build Status Coverage Codacy Badge Maintainability

bme280pi: the BME280 Sensor Reader for Raspberry Pi

How to Install

Enable the I2C Interface

  1. sudo raspi-config
  2. Select "Interfacing Options"
  3. Highlight the "I2C" option, and activate "Select" (use tab)
  4. Answer the question if you'd like the ARM I2C interface to be enabled with "Yes"
  5. Select "Ok"
  6. Reboot

For a walk-through with screenshots see the references below.

Install Utilities

Install python-smbus and i2ctools: sudo apt-get update && sudo apt-get install -y python-smbus i2c-tools

Then, shut down your Raspberry Pi: sudo halt . Disconnect your Raspberry Pi power supply. You are now ready to connect the BME280 sensor.

Connect the BME280 sensor


Install This Module

You can then install this module by running python install

Using it in your script

You can initialize the sensor class as follows:

from bme280pi import Sensor

sensor = Sensor()

You can then use the sensor object to fetch data, sensor.get_data(), which will return a dictionary with temperature, humidity, and pressure readings.

You can also just get the temperature (sensor.get_temperature()), just the pressure (sensor.get_pressure()), or just the humidity (sensor.get_humidity()).

Note that all commands support user-specified units, e.g. sensor.get_temperature(unit='F'), or sensor.get_pressure(unit='mmHg').

You can e.g. query the sensor every 10 seconds, and add the results to a dictionary, and then turn that into a pandas DataFrame and plot that (requires matplotlib and pandas):

import time
import datetime

import pandas
import matplotlib.pyplot as plt

from bme280pi import Sensor

measurements = {}

for i in range(20):
    measurements[] = sensor.get_data()

measurements = pd.DataFrame(measurements).transpose()

plt.subplot(2, 2, 1)
plt.title("Temperature (C)")

plt.subplot(2, 2, 2)
plt.title("Pressure (hPa)")

plt.subplot(2, 2, 3)
plt.title("Relative Humidity (%)")


Potential issues

If you see a FileNotFoundError being raised by SMBus, then you may not have properly configured I2C. Have a look at the instructions above to enable to I2C interface, and make sure you reboot.


Bosch BME280 Data Sheet

Raspberry-Spy: Using BME280 sensor in python

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bme280pi-1.0.1.tar.gz (16.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page