Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pimoroni/bme680-python

Python library for the BME680 gas, temperature, humidity and pressure sensor.
https://github.com/pimoroni/bme680-python

air-quality pypi-package python python-library raspberry-pi sensor

Last synced: 27 days ago
JSON representation

Python library for the BME680 gas, temperature, humidity and pressure sensor.

Host: GitHub
URL: https://github.com/pimoroni/bme680-python
Owner: pimoroni
License: mit
Created: 2017-10-15T10:28:37.000Z (about 7 years ago)
Default Branch: main
Last Pushed: 2024-05-10T10:51:55.000Z (6 months ago)
Last Synced: 2024-09-30T10:21:02.577Z (about 1 month ago)
Topics: air-quality, pypi-package, python, python-library, raspberry-pi, sensor
Language: Python
Homepage: https://shop.pimoroni.com/products/bme680
Size: 485 KB
Stars: 268
Watchers: 33
Forks: 96
Open Issues: 12
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

awesome-air-quality - bme680-python - _Python library for the BME680 gas, temperature, humidity and pressure sensor._ (Software Libraries)

README

# BME680

[![Build Status](https://img.shields.io/github/actions/workflow/status/pimoroni/bme680-python/test.yml?branch=main)](https://github.com/pimoroni/bme680-python/actions/workflows/test.yml)
[![Coverage Status](https://coveralls.io/repos/github/pimoroni/bme680-python/badge.svg?branch=main)](https://coveralls.io/github/pimoroni/bme680-python?branch=main)
[![PyPi Package](https://img.shields.io/pypi/v/bme680.svg)](https://pypi.python.org/pypi/bme680)
[![Python Versions](https://img.shields.io/pypi/pyversions/bme680.svg)](https://pypi.python.org/pypi/bme680)

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](http://get.pimoroni.com/resources/github-repo-terminal.png)

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

```bash
git clone https://github.com/pimoroni/bme680-python
cd bme680-python
./install.sh
```

**Note** Libraries will be installed in the "pimoroni" virtual environment, you will need to activate it to run examples:

```
source ~/.virtualenvs/pimoroni/bin/activate
```

### Development:

If you want to contribute, or like living on the edge of your seat by having the latest code, you can install the development version like so:

```bash
git clone https://github.com/pimoroni/bme680-python
cd bme680-python
./install.sh --unstable
```

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

```
sudo raspi-config nonint do_i2c 0
```

## Documentation & Support

* Guides and tutorials - https://learn.pimoroni.com/bme680-breakout
* Get help - http://forums.pimoroni.com/c/support