1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
# BME-280 sensor device driver with Micropython and Linux support (I2C + SPI)
[Project website](https://bues.ch/)
[Git repository](https://bues.ch/cgit/bme280-upy.git)
This driver runs on Micropython and on regular Python (e.g. Raspberry Pi or other Linux devices).
It has support for both I2C and SPI bus.
# Example: I2C
import bme280
try:
# Connect to BME-280 via I2C-0 hardware with default pinning:
bme = bme280.BME280(i2cBus=0)
# Alternatively:
# Connect to BME-280 via I2C-0 hardware with custom pinning (not supported by all microcontrollers):
#bme = bme280.BME280(i2cBus={ "index": 0, "scl": 1, "sda": 0 })
# Alternatively:
# Connect to BME-280 via software I2C with custom pinning (not supported by all microcontrollers):
#bme = bme280.BME280(i2cBus={ "scl": 1, "sda": 0 })
# Alternatively:
# Connect to BME-280 via pre-initialized Micropython bus object:
#bme = bme280.BME280(i2cBus=machine.I2C(0, ...))
# Synchronously trigger a MODE_FORCED conversion and return the result.
temperature, humidity, pressure = bme.readForced(filter=bme280.FILTER_2,
tempOversampling=bme280.OVSMPL_4,
humidityOversampling=bme280.OVSMPL_4,
pressureOversampling=bme280.OVSMPL_4)
# See help(bme280.BME280) for documentation and more methods.
# Print the result.
print(f"{temperature:.1f} *C; {humidity * 100:.1f} % rel. hum.; {pressure / 100:.1f} hPa")
except bme280.BME280Error as e:
print(f"BME280 error: {e}")
# Example: SPI
import bme280
try:
# Connect to BME-280 via SPI-0 hardware with default pinning and pin 5 as chip select:
bme = bme280.BME280(spiBus=0, spiCS=5)
# Alternatively:
# Connect to BME-280 via SPI-0 hardware with custom pinning (not supported by all microcontrollers):
#bme = bme280.BME280(spiBus={ "index": 0, "sck": 1, "mosi": 2, "miso": 3 }, spiCS=5)
# Alternatively:
# Connect to BME-280 via software SPI with custom pinning (not supported by all microcontrollers):
#bme = bme280.BME280(spiBus={ "sck": 1, "mosi": 2, "miso": 3 }, spiCS=5)
# Alternatively:
# Connect to BME-280 via pre-initialized Micropython bus object:
#bme = bme280.BME280(spiBus=machine.SPI(0, ...), spiCS=machine.Pin(5, ...))
# Synchronously trigger a MODE_FORCED conversion and return the result.
temperature, humidity, pressure = bme.readForced(filter=bme280.FILTER_2,
tempOversampling=bme280.OVSMPL_4,
humidityOversampling=bme280.OVSMPL_4,
pressureOversampling=bme280.OVSMPL_4)
# See help(bme280.BME280) for documentation and more methods.
# Print the result.
print(f"{temperature:.1f} *C; {humidity * 100:.1f} % rel. hum.; {pressure / 100:.1f} hPa")
except bme280.BME280Error as e:
print(f"BME280 error: {e}")
# Example: Context Manager
The BME280 instance can also be used as Context Manager (Python `with` statement).
import bme280
try:
with bme280.BME280(i2cBus=0) as bme:
temperature, humidity, pressure = bme.readForced(filter=bme280.FILTER_2,
tempOversampling=bme280.OVSMPL_4,
humidityOversampling=bme280.OVSMPL_4,
pressureOversampling=bme280.OVSMPL_4)
# ...
except bme280.BME280Error as e:
print(f"BME280 error: {e}")
# Example: Normal mode
The driver also supports normal mode, where the bme280 does all measurements on its own in the background.
See the datasheet for more information about normal mode.
import bme280
try:
with bme280.BME280(i2cBus=0) as bme:
# Start in normal mode with specified measurement interval (standby time).
bme.start(mode=bme280.MODE_NORMAL,
standbyTime=bme280.T_SB_10ms,
filter=bme280.FILTER_2,
tempOversampling=bme280.OVSMPL_4,
humidityOversampling=bme280.OVSMPL_4,
pressureOversampling=bme280.OVSMPL_4)
while True:
# Read the most recent values from the device.
temperature, humidity, pressure = bme.read()
# ... do something else here and let the bme280 run measurements in the mean time.
except bme280.BME280Error as e:
print(f"BME280 error: {e}")
# License
Copyright (c) 2020-2023 Michael Büsch <m@bues.ch>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
