1
0
mirror of https://github.com/cmur2/python-bme280.git synced 2024-10-09 09:02:17 +02:00
python-bme280/README.md

26 lines
1.5 KiB
Markdown
Raw Permalink Normal View History

2016-05-30 22:13:05 +02:00
# python-bme280
2021-05-21 13:48:54 +02:00
![ci](https://github.com/cmur2/python-bme280/workflows/ci/badge.svg?branch=master)
2016-05-30 22:13:05 +02:00
A Python library for accessing the [BME280 combined humidity and pressure](https://ae-bst.resource.bosch.com/media/_tech/media/datasheets/BST-BME280_DS001-11.pdf) from Bosch via `python-smbus` using the I2C interface.
Default settings are suitable for Raspberry Pi 2 and 3 and was successfully tested using a [breakout](https://github.com/watterott/BME280-Breakout).
I created this Python library in style of e.g. [python-veml6070](https://github.com/cmur2/python-veml6070) or [python-tsl2591](https://github.com/maxlklaxl/python-tsl2591) since I found only [python scripts](https://github.com/SWITCHSCIENCE/BME280) with limited functionality and minor bugs and the official driver from Bosch is only in C(++).
Although, it is heavily based on existing code from Bosch translated to Python and from [SWITCHSCIENCE](https://github.com/SWITCHSCIENCE/BME280).
## Usage
Consult the data sheet and see [demo.py](demo.py) for clues how to use this library.
Not all functions of the chip are supported since I focused on the *forced mode* but data readout and parameter setting should work in *normal mode*, too. Please send pull requests for improvements and bug fixes!
## Develop
Run `make help` to find out about the available development commands.
2016-05-30 22:13:05 +02:00
## License
Python files in this repository are released under the [MIT license](LICENSE) except those parts from other sources which are indicated where appropriate in the files.