Crate bme280_rs

Source
Expand description

§Rust BME280 Crate

Version Documentation Downloads License MSRV

A Rust crate to query temperature, pressure and humidity from sensor BME280

https://gitlab.com/claudiomattera/bme280-rs/

This crate supports both embedded-hal and embedded-hal-async.

See the changelog for this project.

§Usage

Add the dependency to Cargo.toml.

[dependencies.bme280-rs]
version = "0.3.0"

Optionally enable the desired features.

FeatureDescription
blocking (default)Enable the blocking sensor Bme280
async (default)Enable the async sensor AsyncBme280
uomUse uom for measurement types

A Bme280 structure can be created from an I²C interface and a delay function. The initial sampling configuration disables all measurements, so it is necessary to reconfigure the chip with the desired settings before read samples.

use bme280_rs::{Bme280, Configuration, Oversampling, SensorMode};

let i2c = ...
let delay = ...

let mut bme280 = Bme280::new(i2c, delay);

bme280.init()?;

bme280.set_sampling_configuration(
    Configuration::default()
        .with_temperature_oversampling(Oversampling::Oversample1)
        .with_pressure_oversampling(Oversampling::Oversample1)
        .with_humidity_oversampling(Oversampling::Oversample1)
        .with_sensor_mode(SensorMode::Normal)
)?;

delay.delay_ms(10);

if let Some(temperature) = bme280.read_temperature()? {
    println!("Temperature: {} C", temperature);
} else {
    println!("Temperature reading was disabled");
}

An AsyncBme280 structure can be used with asynchronous HALs. Its API is completely identical to Bme280, just with .await at the end of function calls.

use bme280_rs::{AsyncBme280, Configuration, Oversampling, SensorMode};

let i2c = ...
let delay = ...

let mut bme280 = AsyncBme280::new(i2c, delay);

bme280.init()?;

bme280.set_sampling_configuration(
    Configuration::default()
        .with_temperature_oversampling(Oversampling::Oversample1)
        .with_pressure_oversampling(Oversampling::Oversample1)
        .with_humidity_oversampling(Oversampling::Oversample1)
        .with_sensor_mode(SensorMode::Normal)
).await?;

delay.delay_ms(10).await;

if let Some(temperature) = bme280.read_temperature().await? {
    println!("Temperature: {} C", temperature);
} else {
    println!("Temperature reading was disabled");
}

See the examples for more information.

§Unit of Measurements

By default, this crate uses f32 values for all the measurements temperature, pressure and humidity. When instead enabling the Cargo feature uom, it uses quantities from crate uom. Temperature measurements have type uom::si::f32::ThermodynamicTemperature, pressure measurements have type uom::si::f32::Pressure, and humidity measurements have type uom::si::f32::Ratio.

§License

Copyright Claudio Mattera 2022-2024

You are free to copy, modify, and distribute this application with attribution under the terms of either

at your option.

This project is entirely original work, and it is not affiliated with nor endorsed in any way by Bosch Sensortec.

Structs§

AsyncBme280
Async interface to BME280 sensor over I²C
Bme280
Interface to BME280 sensor over I²C
Configuration
Chip configuration
Sample
A full sample: temperature, pressure and humidity
Status
Chip status

Enums§

Filter
Filter coefficient
Oversampling
Oversampling setting
SensorMode
Sensor working mode
StandbyTime
Standby time between readings in normal mode

Constants§

CHIP_ID
Hardcoded chip ID
DEFAULT_ADDRESS
Default I²C address

Type Aliases§

Humidity
Type for temperature measurements
Pressure
Type for pressure measurements
Temperature
Type for temperature measurements