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.1

  • New: constants to clarify heater on/off states

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.1.tar.gz (11.9 kB view details)

Uploaded Source

Built Distributions

bme680-1.1.1-py3-none-any.whl (11.5 kB view details)

Uploaded Python 3

bme680-1.1.1-py2-none-any.whl (11.5 kB view details)

Uploaded Python 2

File details

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

File metadata

  • Download URL: bme680-1.1.1.tar.gz
  • Upload date:
  • Size: 11.9 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.1.tar.gz
Algorithm Hash digest
SHA256 287f9329d6befb88e091186502df87949ed796d5615419aa0ce92920752c852f
MD5 494fa245a96efc09e49078194147c47e
BLAKE2b-256 e5b45576f6f4fe94b4b518ddf40e24d29ba00117ab9b92fcb90e4c23e16eff4f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bme680-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 11.5 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 314023ef62b96aa93039a0aedb5fc2015f772cd25fc4333bec9f6b9304e9fbdf
MD5 cba0bf185b9492f9d8345a773e402d45
BLAKE2b-256 25d1ddb7aa5ca15599d8ccbf5591469006d493ee038f688b9353594ec253fc84

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bme680-1.1.1-py2-none-any.whl
  • Upload date:
  • Size: 11.5 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.1-py2-none-any.whl
Algorithm Hash digest
SHA256 60cfee6c5e871d1f1003b90606c79092cb26a2402830fdf347851c8e39948f70
MD5 19a5a9fcd03b72ebee5b377e353e0d1a
BLAKE2b-256 a593b8d8dff256742650c40f7ebab1deba62cbc194202b814e05048aac997b15

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