Zum Hauptinhalt springen

Alle Werte auslesen

Was dieses Beispiel zeigt​

Temperatur, Luftfeuchtigkeit, Luftdruck und Höhe aus dem BME280 auslesen, zuerst jeden Wert einzeln und dann alle drei Messgrößen mit einem einzigen Aufruf. Beide Varianten stehen im selben Beispiel, sodass Sie die für Ihr Projekt passende wählen können.

Der Beispielcode​

Dies ist BME280_Read_All_Values.ino aus der fixierten Bibliotheksversion, mit einer Änderung: Der Kopfkommentar der Datei fehlt, weil er die Produktseite des BME680 nennt und nicht dieses Board. Der Sketch selbst ist genau so, wie er ausgeliefert wird.

Select Board
BME280_Read_All_Values.ino
#include "BME280-SOLDERED.h"

// Declare your sensors here
BME280 bme280;

void setup()
{
// Initialize the sensors
Serial.begin(115200);

// Initialize the sensors
bme280.begin();
}

void loop() // Temperature is not factory calibrated, you can add offset to it
{
float offset = 0; // offset in °C

Serial.println("Reading one by one: ");

float temperature = bme280.readTemperature() + offset;
Serial.print("Temperature: ");
Serial.println(temperature);

float humidity = bme280.readHumidity();
Serial.print("Humidity: ");
Serial.println(humidity);

float pressure = bme280.readPressure();
Serial.print("Pressure: ");
Serial.println(pressure);

float altitude = bme280.readAltitude();
Serial.print("Altitude: ");
Serial.println(altitude);

delay(1000);

Serial.println("\nReading all at once: ");

float temperature2, humidity2, pressure2;
bme280.readSensorData(temperature2, humidity2, pressure2);

Serial.print("Temperature: " + String(temperature2 + offset) + " C");
Serial.println();

Serial.print("Humidity: " + String(humidity2) + " %");
Serial.println();

Serial.print("Pressure: " + String(pressure2) + " hPa");
Serial.println();

// We need to caluclate altitude from pressure and sea level pressure
float altitude2 = bme280.calculateAltitude(pressure2);

Serial.print("Altitude: " + String(altitude2) + " m");
Serial.println();
Serial.println();
}

Erwartetes Ergebnis:

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
Reading one by one:
Temperature: 23.30
Humidity: 46.00
Pressure: 1002.40
Altitude: 90.73

Reading all at once:
Temperature: 23.30 C
Humidity: 46.00 %
Pressure: 1002.38 hPa
Altitude: 90.90 m

Die ersten vier Zeilen geben die reinen Zahlen aus, die nächsten vier ergänzen die Einheiten, und der Block wiederholt sich etwa einmal pro Sekunde. Die Beschriftungen stammen aus dem Beispiel selbst, die Form ist also exakt. Die Zahlen sind eine anschauliche Beispielausgabe für Osijek, Kroatien: etwa 23 °C, 46 % relative Luftfeuchtigkeit und 1002,4 hPa. Bezogen auf den Referenzwert der Bibliothek von 1013,25 hPa ergibt dieser Druck etwa 90 m, nahe an der tatsächlichen Höhe von Osijek. Ihre Messwerte hängen von Ihrem Raum und dem Wetter ab.

Verwendete Funktionen​

BME280()returns None

Erzeugt das Sensorobjekt. Es braucht keine Adresse: begin() findet den Sensor selbstständig am I2C-Bus.

ReturnsKonstruktor; kein Rückgabewert.

begin()returns void

Startet I2C, sucht den BME280 anhand seiner Chip-ID am Bus und richtet ihn ein: Normalmodus, 16-faches Oversampling für Temperatur, Luftfeuchtigkeit und Luftdruck, der stärkste Rauschfilter und eine Pause von 1000 ms zwischen den Messungen. Antwortet der Sensor nicht, versucht es die Funktion einmal pro Sekunde erneut, bis zu 10-mal. Rufen Sie sie einmal in setup() auf.

ReturnsNichts. Sie meldet nicht, ob der Sensor gefunden wurde.

readTemperature()returns float

Liest den Sensor aus und gibt die Temperatur zurück.

ReturnsTemperatur in °C.

readHumidity()returns float

Liest den Sensor aus und gibt die relative Luftfeuchtigkeit zurück.

ReturnsRelative Luftfeuchtigkeit in %.

readPressure()returns float

Liest den Sensor aus und gibt den barometrischen Luftdruck zurück.

ReturnsLuftdruck in hPa.

readAltitude()returns float

Liest den Luftdruck und rechnet ihn in eine Höhe um, wobei der Standard-Luftdruck auf Meereshöhe von 1013,25 hPa angenommen wird.

ReturnsGeschätzte Höhe in Metern.

readSensorData(float &temp, float &humidity, float &pressure)returns void

Liest alle drei Messgrößen aus einem einzigen Messzyklus und schreibt sie in die drei übergebenen Variablen. Das ist schneller als drei einzelne Leseaufrufe, weil jeder davon den Sensor erneut ausliest.

ReturnsNichts. Die Ergebnisse werden in die Argumente geschrieben.

Parameter

TypNameBeschreibung
float &tempErhält die Temperatur in °C.
float &humidityErhält die relative Luftfeuchtigkeit in %.
float &pressureErhält den Luftdruck in hPa.
calculateAltitude(float pressure)returns float

Rechnet einen bereits vorhandenen Luftdruckwert in eine Höhe um, mit derselben Formel und demselben Luftdruck auf Meereshöhe von 1013,25 hPa wie readAltitude(), ohne den Sensor erneut auszulesen.

ReturnsGeschätzte Höhe in Metern.

Parameter

TypNameBeschreibung
floatpressureLuftdruck in hPa, zum Beispiel der Wert aus readSensorData().

Alles zusammen​

begin() übernimmt die gesamte Einrichtung, danach können Sie die Lesefunktionen in beliebiger Reihenfolge aufrufen. readTemperature(), readHumidity(), readPressure() und readAltitude() holen sich jeweils eine eigene, frische Messung vom Sensor. Wenn Sie mehrere Werte aus demselben Moment brauchen, liefert readSensorData() alle drei aus einer Messung, und calculateAltitude() rechnet diesen Druck in eine Höhe um, ohne den Sensor erneut auszulesen.

Die Höhe ist ein Schätzwert. Beide Höhenfunktionen gehen von 1013,25 hPa auf Meereshöhe aus, daher weicht das Ergebnis ab, wenn das Wetter den tatsächlichen Luftdruck auf Meereshöhe verändert.

Laut Bibliothek ist die Temperaturmessung nicht werkseitig kalibriert. Vergleichen Sie sie mit einem Referenzthermometer und setzen Sie offset am Anfang von loop() auf die Differenz.