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 details)

Uploaded Source

Built Distributions

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

Uploaded Python 3

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

Uploaded Python 2

File details

Details for the file bme680-1.1.0.tar.gz.

File metadata

  • Download URL: bme680-1.1.0.tar.gz
  • Upload date:
  • Size: 11.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.20.0 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.7.3

File hashes

Hashes for bme680-1.1.0.tar.gz
Algorithm Hash digest
SHA256 fb426bfa7485ef9a02a30e8dc5b6f82f4b6b1947ab0d9fda20605ad14baafea2
MD5 49c6d40aab09d07916eb433f1365a484
BLAKE2b-256 06b4910c31831227bce08bbe8ea12578ea5c7d67cefbf8934e0c70f293699e5f

See more details on using hashes here.

File details

Details for the file bme680-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: bme680-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 11.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.20.0 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.7.3

File hashes

Hashes for bme680-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f0363c7de2b202d48afda2eb22c3cb230f810d28c3eb668f45a451440c639816
MD5 20f45e167172557f265ab6e97a8184bf
BLAKE2b-256 9da67fa8684e80081088202d77a62fa9c5ae997399cbd797f4d2250c6d145526

See more details on using hashes here.

File details

Details for the file bme680-1.1.0-py2-none-any.whl.

File metadata

  • Download URL: bme680-1.1.0-py2-none-any.whl
  • Upload date:
  • Size: 11.4 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.20.0 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.7.3

File hashes

Hashes for bme680-1.1.0-py2-none-any.whl
Algorithm Hash digest
SHA256 c1a7b1fba0ea129d2bea14f0e326475f942f234673f7d50e93520447249b168d
MD5 fa071266f637b0dd51b196d49f9a8e7f
BLAKE2b-256 e943e247bf1d327ca452f1aa6ca609525e43411f0f5eaba26e3b37409cb2c096

See more details on using hashes here.

Supported by

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