Skip to main content

Python library for the BME680 temperature, humidity and gas sensor

Project description

BME680

Build Status Coverage Status PyPi Package Python Versions

https://shop.pimoroni.com/products/bme680

The state-of-the-art BME680 breakout lets you measure temperature, pressure, humidity, and indoor air quality.

Installing

Full install (recommended):

We've created an easy installation script that will install all pre-requisites and get your BME680 up and running with minimal efforts. To run it, fire up Terminal which you'll find in Menu -> Accessories -> Terminal on your Raspberry Pi desktop, as illustrated below:

Finding the terminal

In the new terminal window type the command exactly as it appears below (check for typos) and follow the on-screen instructions:

curl https://get.pimoroni.com/bme680 | bash

Manual install:

Library install for Python 3:

sudo pip3 install bme680

Library install for Python 2:

sudo pip2 install bme680

Development:

If you want to contribute, or like living on the edge of your seat by having the latest code, you should clone this repository, cd to the library directory, and run:

sudo python3 setup.py install

(or sudo python setup.py install whichever your primary Python environment may be)

In all cases you will have to enable the i2c bus.

Documentation & Support

Changelog

1.1.0

  • New: support for BME688 "high" gas resistance variant
  • New: set/get gas heater disable bit
  • Enhancement: fail with descriptive RuntimeError when chip is not detected

1.0.5

  • New: set_temp_offset to calibrate temperature offset in degrees C

1.0.4

  • Fix to range_sw_err for extremely high gas readings
  • Convert to unsigned int to fix negative gas readings

1.0.3

  • Merged temperature compensation fix from Bosch's BME680_driver 3.5.3

1.0.2

  • Fixed set_gas_heater_temperature to avoid i2c TypeError

1.0.1

  • Added Manifest to Python package

1.0.0

  • Initial release

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

bme680-1.1.0.tar.gz (11.8 kB view hashes)

Uploaded source

Built Distributions

bme680-1.1.0-py3-none-any.whl (11.4 kB view hashes)

Uploaded py3

bme680-1.1.0-py2-none-any.whl (11.4 kB view hashes)

Uploaded py2

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page