https://github.com/mcauser/adafruit-pure-python-bme280
A pure python library for drive Adafruit BME280 - Temperature, Humidity & Barometic Pressure Sensor
https://github.com/mcauser/adafruit-pure-python-bme280
Last synced: 5 months ago
JSON representation
A pure python library for drive Adafruit BME280 - Temperature, Humidity & Barometic Pressure Sensor
- Host: GitHub
- URL: https://github.com/mcauser/adafruit-pure-python-bme280
- Owner: mcauser
- License: mit
- Created: 2020-12-07T13:58:31.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-12-07T13:58:43.000Z (over 5 years ago)
- Last Synced: 2025-03-25T12:33:39.972Z (about 1 year ago)
- Size: 16.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Introduction
============
.. image:: https://readthedocs.org/projects/adafruit-circuitpython-bme280/badge/?version=latest
:target: https://circuitpython.readthedocs.io/projects/bme280/en/latest/
:alt: Documentation Status
.. image :: https://img.shields.io/discord/327254708534116352.svg
:target: https://discord.gg/nBQh6qu
:alt: Discord
.. image:: https://github.com/adafruit/Adafruit_CircuitPython_BME280/workflows/Build%20CI/badge.svg
:target: https://github.com/adafruit/Adafruit_CircuitPython_BME280/actions/
:alt: Build Status
I2C and SPI driver for the Bosch BME280 Temperature, Humidity, and Barometric Pressure sensor
Installation and Dependencies
=============================
This driver depends on:
* `Adafruit CircuitPython `_
* `Bus Device `_
Please ensure that the driver and all dependencies are available on the
CircuitPython filesystem. This can be most easily achieved by downloading and
installing the latest
`Adafruit library and driver bundle `_
on your device.
Installing from PyPI
--------------------
On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally `from
PyPI `_. To install for current user:
.. code-block:: shell
pip3 install adafruit-circuitpython-bme280
To install system-wide (this may be required in some cases):
.. code-block:: shell
sudo pip3 install adafruit-circuitpython-bme280
To install in a virtual environment in your current project:
.. code-block:: shell
mkdir project-name && cd project-name
python3 -m venv .env
source .env/bin/activate
pip3 install adafruit-circuitpython-bme280
Usage Example
=============
.. code-block:: python
import board
import digitalio
import busio
import time
import adafruit_bme280
# Create library object using our Bus I2C port
i2c = busio.I2C(board.SCL, board.SDA)
bme280 = adafruit_bme280.Adafruit_BME280_I2C(i2c)
# OR create library object using our Bus SPI port
#spi = busio.SPI(board.SCK, board.MOSI, board.MISO)
#bme_cs = digitalio.DigitalInOut(board.D10)
#bme280 = adafruit_bme280.Adafruit_BME280_SPI(spi, bme_cs)
# change this to match the location's pressure (hPa) at sea level
bme280.sea_level_pressure = 1013.25
while True:
print("\nTemperature: %0.1f C" % bme280.temperature)
print("Humidity: %0.1f %%" % bme280.humidity)
print("Pressure: %0.1f hPa" % bme280.pressure)
print("Altitude = %0.2f meters" % bme280.altitude)
time.sleep(2)
Contributing
============
Contributions are welcome! Please read our `Code of Conduct
`_
before contributing to help this project stay welcoming.
Documentation
=============
For information on building library documentation, please check out `this guide `_.