Meadow.Foundation.Sensors.Atmospheric.Bme68x 1.8.0.8-beta

This is a prerelease version of Meadow.Foundation.Sensors.Atmospheric.Bme68x.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Meadow.Foundation.Sensors.Atmospheric.Bme68x --version 1.8.0.8-beta
NuGet\Install-Package Meadow.Foundation.Sensors.Atmospheric.Bme68x -Version 1.8.0.8-beta
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Meadow.Foundation.Sensors.Atmospheric.Bme68x" Version="1.8.0.8-beta" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Meadow.Foundation.Sensors.Atmospheric.Bme68x --version 1.8.0.8-beta
#r "nuget: Meadow.Foundation.Sensors.Atmospheric.Bme68x, 1.8.0.8-beta"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Meadow.Foundation.Sensors.Atmospheric.Bme68x as a Cake Addin
#addin nuget:?package=Meadow.Foundation.Sensors.Atmospheric.Bme68x&version=1.8.0.8-beta&prerelease

// Install Meadow.Foundation.Sensors.Atmospheric.Bme68x as a Cake Tool
#tool nuget:?package=Meadow.Foundation.Sensors.Atmospheric.Bme68x&version=1.8.0.8-beta&prerelease

Meadow.Foundation.Sensors.Atmospheric.Bme68x

Bosch BME68x SPI / I2C humidity, barometric pressure, ambient temperature and gas (VOC) sensor

The Bme68x library is designed for the Wilderness Labs Meadow .NET IoT platform and is part of Meadow.Foundation.

The Meadow.Foundation peripherals library is an open-source repository of drivers and libraries that streamline and simplify adding hardware to your C# .NET Meadow IoT application.

For more information on developing for Meadow, visit developer.wildernesslabs.co.

To view all Wilderness Labs open-source projects, including samples, visit github.com/wildernesslabs.

Usage

Bme680? sensor;

public override Task Initialize()
{
    Resolver.Log.Info("Initializing...");

    //CreateSpiSensor();
    CreateI2CSensor();

    //uncomment to enable on sensor heater for gas readings
    //EnableGasHeater();

    var consumer = Bme680.CreateObserver(
        handler: result =>
        {
            Resolver.Log.Info($"Observer: Temp changed by threshold; new temp: {result.New.Temperature?.Celsius:N2}C, old: {result.Old?.Temperature?.Celsius:N2}C");
        },
        filter: result =>
        {
            if (result.Old?.Temperature is { } oldTemp &&
                result.Old?.Humidity is { } oldHumidity &&
                result.New.Temperature is { } newTemp &&
                result.New.Humidity is { } newHumidity)
            {
                return ((newTemp - oldTemp).Abs().Celsius > 0.5 &&
                        (newHumidity - oldHumidity).Percent > 0.05);
            }
            return false;
        }
    );

    sensor?.Subscribe(consumer);

    if (sensor != null)
    {
        sensor.Updated += (sender, result) =>
        {
            Resolver.Log.Info($"  Temperature: {result.New.Temperature?.Celsius:N2}C");
            Resolver.Log.Info($"  Relative Humidity: {result.New.Humidity:N2}%");
            Resolver.Log.Info($"  Pressure: {result.New.Pressure?.Millibar:N2}mbar ({result.New.Pressure?.Pascal:N2}Pa)");
            if (sensor.GasConversionIsEnabled)
            {
                Resolver.Log.Info($"  Gas Resistance: {result.New.GasResistance:N0}Ohms");
            }
        };
    }

    sensor?.StartUpdating(TimeSpan.FromSeconds(2));

    ReadConditions().Wait();

    return base.Initialize();
}

void EnableGasHeater()
{
    if (sensor != null)
    {
        sensor.GasConversionIsEnabled = true;
        sensor.HeaterIsEnabled = true;
        sensor.ConfigureHeatingProfile(Bme688.HeaterProfileType.Profile1, new Meadow.Units.Temperature(300), TimeSpan.FromMilliseconds(100), new Meadow.Units.Temperature(22));
        sensor.HeaterProfile = Bme688.HeaterProfileType.Profile1;
    }
}

void CreateSpiSensor()
{
    Resolver.Log.Info("Create BME680 sensor with SPI...");

    var spiBus = Device.CreateSpiBus();
    sensor = new Bme680(spiBus, Device.CreateDigitalOutputPort(Device.Pins.D14));
}

void CreateI2CSensor()
{
    Resolver.Log.Info("Create BME680 sensor with I2C...");

    var i2c = Device.CreateI2cBus();
    sensor = new Bme680(i2c, (byte)Bme688.Addresses.Address_0x76);
}

async Task ReadConditions()
{
    if (sensor == null) { return; }

    var (Temperature, Humidity, Pressure, Resistance) = await sensor.Read();

    Resolver.Log.Info("Initial Readings:");
    Resolver.Log.Info($"  Temperature: {Temperature?.Celsius:N2}C");
    Resolver.Log.Info($"  Pressure: {Pressure?.Hectopascal:N2}hPa");
    Resolver.Log.Info($"  Relative Humidity: {Humidity?.Percent:N2}%");
    Resolver.Log.Info($"  Gas Resistance: {Resistance?.Ohms:N0}Ohms");
}

How to Contribute

Need Help?

If you have questions or need assistance, please join the Wilderness Labs community on Slack.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Meadow.Foundation.Sensors.Atmospheric.Bme68x:

Package Downloads
Meadow.ProjectLab

Library for the Meadow ProjectLab IoT accelerator

Meadow.GnssTracker

Convenience library for the Meadow GnssTracker family of boards

Meadow.Clima

Library for the Meadow Clima IoT accelerator

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.10.0.2-beta 35 4/11/2024
1.10.0.1-beta 91 4/5/2024
1.10.0 219 3/26/2024
1.9.0.6-beta 120 3/25/2024
1.9.0.5-beta 113 3/19/2024
1.9.0.4-beta 136 3/13/2024
1.9.0.3 292 3/6/2024
1.9.0.2-beta 202 3/6/2024
1.9.0.1 256 3/1/2024
1.9.0 324 2/27/2024
1.8.0.8-beta 189 2/23/2024
1.8.0.7-beta 199 2/22/2024
1.8.0.6-beta 204 2/20/2024
1.8.0.5-beta 212 2/13/2024
1.8.0.4-beta 248 2/6/2024
1.8.0.3-beta 225 2/1/2024
1.8.0.2-beta 260 1/24/2024
1.8.0.1 426 1/20/2024
1.8.0 359 1/16/2024
1.7.0 401 1/9/2024
1.6.0.6-beta 330 1/3/2024
1.6.0.5-beta 362 12/27/2023
1.6.0.4-beta 370 12/20/2023
1.6.0.3-beta 372 12/19/2023
1.6.0.2-beta 396 12/12/2023
1.6.0 677 12/6/2023
1.5.0.1-beta 409 12/4/2023
1.5.0 560 11/28/2023
1.4.0.9-beta 417 11/28/2023
1.4.0.8-beta 407 11/27/2023
1.4.0.7-beta 427 11/8/2023
1.4.0.6-beta 414 11/7/2023
1.4.0.4-beta 423 11/1/2023
1.4.0.3 536 10/31/2023
1.3.4.10-beta 391 10/25/2023
1.3.4.9-beta 443 10/24/2023
1.3.4.8-beta 448 10/17/2023
1.3.4.7-beta 451 10/10/2023
1.3.4.6-beta 439 10/5/2023
1.3.4.5-beta 451 10/4/2023
1.3.4.4-beta 441 10/3/2023
1.3.4.3-beta 410 10/3/2023
1.3.4.2-beta 471 9/30/2023
1.3.4.1-beta 494 9/30/2023
1.3.4 713 9/26/2023
1.3.2.5-beta 469 9/21/2023
1.3.2.4-beta 442 9/20/2023
1.3.2.3-beta 438 9/19/2023
1.3.2.2-beta 459 9/15/2023
1.3.2.1-beta 460 9/14/2023
1.3.2-beta 448 9/13/2023
1.3.1.1-beta 487 9/5/2023
1.3.0 746 8/29/2023
1.2.1.11-beta 535 8/24/2023
1.2.1.9-beta 577 8/17/2023
1.2.1.8-beta 614 8/8/2023
1.2.1.6-beta 645 8/4/2023
1.2.0 738 8/1/2023
1.1.1.11-beta 671 7/24/2023
1.1.1.10-beta 588 7/22/2023
1.1.1.9-beta 577 7/22/2023
1.1.1.8-beta 565 7/21/2023
1.1.0 837 7/11/2023
1.0.2.1 692 6/3/2023
1.0.2 630 6/3/2023
1.0.0.1 686 5/30/2023
1.0.0 689 5/28/2023
0.99.0 807 5/28/2023
0.98.2-alpha 590 5/27/2023
0.98.0 714 5/6/2023
0.96.0 835 4/2/2023
0.95.0 827 3/5/2023
0.94.2 827 2/7/2023
0.94.1 823 2/2/2023
0.92.5 864 12/31/2022
0.90.0 795 11/23/2022
0.89.2 786 11/23/2022
0.1.11 950 11/21/2022
0.1.10 1,058 10/24/2022
0.1.7 907 5/30/2022
0.1.1 906 3/7/2022
0.1.0 903 1/24/2022