Zum Hauptinhalt springen

Alle Werte auslesen

Was dieses Beispiel zeigt​

Temperatur, Luftdruck, Luftfeuchtigkeit und die aus dem Luftdruck berechnete Höhe, alle 5 Sekunden auf vier Zeilen ausgegeben. Der Kopf des Beispiels nennt dieses Produkt selbst, daher ist eindeutig, für welches Board es gedacht ist.

Der Beispielcode​

Dies ist Examples/bme280-allValues.py aus dem festgelegten Modul, unverändert. Speichern Sie es auf Ihrem Board und führen Sie es aus.

# FILE: bme280-allValues.py
# AUTHOR: Josip Šimun Kuči @ Soldered
# BRIEF: An example for the BME280 sensor that reads temperature, humidity,
# pressure and calculates the altitude using the pressure measurement
# WORKS WITH: Enviromental sensor BME280 breakout: www.solde.red/333036
# LAST UPDATED: 2025-05-23
from machine import Pin, I2C
from bme280 import BME280
import time

# If you aren't using the Qwiic connector, manually enter your I2C pins
# i2c = I2C(0, scl=Pin(22), sda=Pin(21))
# bme280 = BME280(i2c)

# Initialize sensor over Qwiic
bme280 = BME280()

# Infinite loop
while 1:
# Read the temperature, humidity and pressure values and store them in their respective variables
temp, pres, hum = bme280.readAllValues()
# Calculate the altitude using the pressure read by the sensor
altitude = bme280.calculateAltitude()

# Print the measured values, each in their own line
print("Temperature: {:.2f} °C".format(temp))
print("Pressure: {:.2f} hPa".format(pres))
print("Humidity: {:.2f} %".format(hum))
print("Altitude: {:.2f} m".format(altitude))

# Pause for 5 seconds
time.sleep(5.0)

Erwartetes Ergebnis:

ShellMicroPython
Temperature: 23.30 °C
Pressure: 1002.40 hPa
Humidity: 46.00 %
Altitude: 90.73 m

Jede Zeile entspricht einem der print()-Aufrufe des Beispiels, mit dem Wert auf zwei Nachkommastellen, die Form ist also exakt. Die Zahlen sind ein anschauliches Beispiel für Osijek, Kroatien: etwa 23 °C, 46 % relative Luftfeuchtigkeit und 1002,4 hPa. Gegenüber dem Referenzwert der Bibliothek von 1013,25 hPa ergibt dieser Luftdruck etwa 90 m, nahe an der tatsächlichen Höhe von Osijek. Ihre Messwerte hängen von Ihrem Raum und dem Wetter ab. Der Block wiederholt sich alle 5 Sekunden.

Verwendete Funktionen​

BME280(i2c=None, address=0x76)returns BME280

Erstellt das Sensorobjekt. Es liest die Kalibrierwerte aus dem Sensor aus und konfiguriert die Messung, daher ist es der einzige Einrichtungsschritt, den Sie benötigen. Ohne Argumente aufgerufen, verwendet es die eigenen I2C-Pins des Moduls, die es nur auf einem ESP32, einem ESP8266 oder einem Soldered Dasduino CONNECTPLUS gibt; auf jedem anderen Board löst es eine Ausnahme aus und fordert Sie zur Angabe der Pins auf, übergeben Sie also Ihr eigenes I2C-Objekt.

ReturnsEin einsatzbereites Sensorobjekt.

Parameter

TypNameBeschreibung
I2Ci2cEin initialisiertes I2C-Objekt. Optional; wenn Sie es weglassen, erstellt das Modul ein eigenes I2C(0) mit SCL an GPIO22 und SDA an GPIO21.
intaddressDie I2C-Adresse des Sensors. Optional, und es gibt keinen Grund, sie zu ändern: Dieses Board ist fest auf 0x76 eingestellt.
readAllValues()returns tuple

Führt eine Messung durch und gibt alle drei Werte daraus zurück, bereits mit den Kalibrierdaten kompensiert und in ihren jeweiligen Einheiten. Die drei Werte stammen aus derselben Messung und beschreiben daher denselben Zeitpunkt.

ReturnsEin Tupel aus drei Floats: Temperatur in °C, Luftdruck in hPa und relative Luftfeuchtigkeit in %.

calculateAltitude()returns float

Führt eine neue Luftdruckmessung durch und rechnet sie in eine Höhe um, wobei der Standard-Luftdruck auf Meereshöhe von 1013,25 hPa angenommen wird. Die bereits ausgelesenen Werte werden nicht verwendet, der Sensor misst also erneut.

ReturnsGeschätzte Höhe in Metern.

Alles zusammen​

BME280() erledigt die gesamte Einrichtung, daher geht das Beispiel direkt in die Schleife: readAllValues() für die drei Messwerte, dann calculateAltitude() für die Höhe. Alles wird mit zwei Nachkommastellen ausgegeben, und die Schleife pausiert 5 Sekunden, damit die Messwerte nicht vorbeirauschen.

Die Höhe ist ein Schätzwert. calculateAltitude() geht von 1013,25 hPa auf Meereshöhe aus, daher weicht sie ab, wenn das Wetter den tatsächlichen Luftdruck auf Meereshöhe verändert, und sie ist eher auf einige Dutzend Meter als auf einzelne Meter genau.

Wenn Sie stattdessen den Weg über die Rohdaten gehen möchten, stellt das Modul ihn bereit: read_raw_data() liefert die drei unkompensierten Messwerte, und readTemperature(adc_T), readPressure(adc_P) und readHumidity(adc_H) rechnen sie einzeln um. Die beiden anderen Umrechner erwarten den passenden Rohwert aus read_raw_data(), und readTemperature() muss zuerst laufen, weil die Umrechnung von Luftdruck und Luftfeuchtigkeit die dabei ermittelte Temperatur verwendet.