nanoFramework.Iot.Device.Bh1745 1.2.335

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package nanoFramework.Iot.Device.Bh1745 --version 1.2.335
NuGet\Install-Package nanoFramework.Iot.Device.Bh1745 -Version 1.2.335
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="nanoFramework.Iot.Device.Bh1745" Version="1.2.335" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.Iot.Device.Bh1745 --version 1.2.335
#r "nuget: nanoFramework.Iot.Device.Bh1745, 1.2.335"
#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 nanoFramework.Iot.Device.Bh1745 as a Cake Addin
#addin nuget:?package=nanoFramework.Iot.Device.Bh1745&version=1.2.335

// Install nanoFramework.Iot.Device.Bh1745 as a Cake Tool
#tool nuget:?package=nanoFramework.Iot.Device.Bh1745&version=1.2.335

Bh1745 - RGB Sensor

The Bh1745 is a digital color sensor able to detect 3 distinct channels of light (red, green, blue) and is most suitable to obtain the illuminance and color temperature of ambient light. The device can detect light intensity in a range of 0.005 to 40 000 lux.

Documentation

Datasheet of the Bh1745

Usage

Important: make sure you properly setup the I2C pins especially for ESP32 before creating the I2cDevice, make sure you install the nanoFramework.Hardware.ESP32 nuget:

//////////////////////////////////////////////////////////////////////
// when connecting to an ESP32 device, need to configure the I2C GPIOs
// used for the bus
Configuration.SetPinFunction(21, DeviceFunction.I2C1_DATA);
Configuration.SetPinFunction(22, DeviceFunction.I2C1_CLOCK);

For other devices like STM32, please make sure you're using the preset pins for the I2C bus you want to use.

2 examples on how to use this device binding are available in the samples folder.

sensor

The quality of the color measurements is very reliant on the lighting. For accurate color readings it is advisable to calibrate the sensor on first use and to use it under stable lighting conditions.

Some breakout boards come with built in LEDs for this purpose (some of the API functionality may also have been repurposed to control these LEDs).

Basic usage:

using System;
using System.Device.I2c;
using System.Threading;
using Iot.Device.Bh1745;

// bus id on the MCU
const int busId = 1;

// create device
I2cConnectionSettings i2cSettings = new(busId, Bh1745.DefaultI2cAddress);
using I2cDevice i2cDevice = I2cDevice.Create(i2cSettings);
using Bh1745 i2cBh1745 = new Bh1745(i2cDevice);
// wait for first measurement
Thread.Sleep(i2cBh1745.MeasurementTimeAsTimeSpan());

while (true)
{
    var color = i2cBh1745.GetCompensatedColor();
    Debug.WriteLine("RGB color read: #{0:X2}{1:X2}{2:X2}", color.R, color.G, color.B);
    Debug.WriteLine($"Raw illumination value: {i2cBh1745.ReadClearDataRegister()}");

    Thread.Sleep(i2cBh1745.MeasurementTimeAsTimeSpan());
}

Advance usage with configuration:

// bus id on the MCU
const int busId = 1;

// create device
var i2cSettings = new I2cConnectionSettings(busId, Bh1745.DefaultI2cAddress);
var i2cDevice = I2cDevice.Create(i2cSettings);

using Bh1745 i2cBh1745 = new Bh1745(i2cDevice)
{
    // multipliers affect the compensated values
    // ChannelCompensationMultipliers:  Red, Green, Blue, Clear
    ChannelCompensationMultipliers = new(2.5, 0.9, 1.9, 9.5),

    // set custom  measurement time
    MeasurementTime = MeasurementTime.Ms1280,

    // interrupt functionality is detailed in the datasheet
    // Reference: https://www.mouser.co.uk/datasheet/2/348/bh1745nuc-e-519994.pdf (page 13)
    LowerInterruptThreshold = 0xABFF,
    HigherInterruptThreshold = 0x0A10,

    LatchBehavior = LatchBehavior.LatchEachMeasurement,
    InterruptPersistence = InterruptPersistence.UpdateMeasurementEnd,
    InterruptIsEnabled = true,
};

// wait for first measurement
Thread.Sleep(i2cBh1745.MeasurementTimeAsTimeSpan());

while (true)
{
    var color = i2cBh1745.GetCompensatedColor();

    if (!i2cBh1745.ReadMeasurementIsValid())
    {
        Debug.WriteLine("Measurement was not valid!");
        continue;
    }

    Debug.WriteLine("RGB color read: #{0:X2}{1:X2}{2:X2}", color.R, color.G, color.B);
    Debug.WriteLine($"Raw illumination value: {i2cBh1745.ReadClearDataRegister()}");

    Thread.Sleep(i2cBh1745.MeasurementTimeAsTimeSpan());
}
Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.580 0 6/28/2024
1.2.573 77 6/19/2024
1.2.570 78 6/14/2024
1.2.560 79 5/29/2024
1.2.548 71 5/15/2024
1.2.536 87 4/15/2024
1.2.514 86 3/22/2024
1.2.494 85 2/28/2024
1.2.474 104 1/24/2024
1.2.462 129 1/5/2024
1.2.458 119 12/20/2023
1.2.436 139 11/10/2023
1.2.416 117 11/8/2023
1.2.403 110 10/6/2023
1.2.396 130 9/27/2023
1.2.384 130 9/6/2023
1.2.378 109 8/16/2023
1.2.369 133 8/2/2023
1.2.363 131 7/28/2023
1.2.357 140 7/19/2023
1.2.354 129 7/14/2023
1.2.345 114 6/21/2023
1.2.341 142 6/14/2023
1.2.337 126 6/7/2023
1.2.335 126 6/2/2023
1.2.329 138 5/26/2023
1.2.313 153 5/12/2023
1.2.308 149 5/11/2023
1.2.304 132 5/10/2023
1.2.302 115 5/10/2023
1.2.297 128 5/3/2023
1.2.273 212 3/17/2023
1.2.267 207 3/10/2023
1.2.263 233 3/8/2023
1.2.259 227 2/27/2023
1.2.256 251 2/24/2023
1.2.253 246 2/22/2023
1.2.236 249 2/13/2023
1.2.222 295 1/9/2023
1.2.217 290 1/6/2023
1.2.212 283 1/5/2023
1.2.208 311 1/3/2023
1.2.203 282 12/28/2022
1.2.159 364 11/14/2022
1.2.153 365 11/5/2022
1.2.141 380 10/25/2022
1.2.128 378 10/22/2022
1.2.122 443 10/12/2022
1.2.114 376 10/8/2022
1.2.95 438 9/22/2022
1.2.87 500 9/15/2022
1.2.73 410 9/8/2022
1.2.63 419 9/3/2022
1.2.47 396 8/15/2022
1.2.40 428 8/6/2022
1.2.38 426 8/5/2022
1.2.32 424 8/2/2022
1.2.28 431 8/1/2022
1.2.13 405 7/24/2022
1.2.10 401 7/23/2022
1.1.145.58726 439 7/7/2022
1.1.133.52556 420 6/30/2022
1.1.121.35854 462 6/26/2022
1.1.116.8772 416 6/24/2022
1.1.113.2032 404 6/23/2022
1.1.102.51394 420 6/15/2022
1.1.99.36719 435 6/14/2022
1.1.97.17326 438 6/13/2022
1.1.92.53000 429 6/8/2022
1.1.72.29765 423 5/31/2022
1.1.64.21380 433 5/26/2022
1.1.58.10097 449 5/23/2022
1.1.54.28879 457 5/23/2022
1.1.40 457 5/5/2022
1.1.3 473 4/15/2022
1.1.1 455 4/14/2022
1.0.300 446 3/31/2022
1.0.288-preview.114 115 3/25/2022
1.0.288-preview.113 110 3/25/2022
1.0.288-preview.110 102 3/25/2022
1.0.288-preview.104 98 3/22/2022
1.0.288-preview.103 103 3/21/2022
1.0.288-preview.100 105 3/19/2022
1.0.288-preview.99 115 3/18/2022
1.0.288-preview.98 108 3/18/2022
1.0.288-preview.93 106 3/15/2022
1.0.288-preview.86 110 3/8/2022
1.0.288-preview.77 112 2/27/2022
1.0.288-preview.75 107 2/26/2022
1.0.288-preview.65 109 2/18/2022
1.0.288-preview.63 106 2/16/2022
1.0.288-preview.61 116 2/12/2022
1.0.288-preview.58 111 2/10/2022
1.0.288-preview.53 103 2/9/2022
1.0.288-preview.48 125 2/4/2022
1.0.288-preview.41 119 1/31/2022
1.0.288-preview.29 124 1/28/2022
1.0.288-preview.22 122 1/27/2022
1.0.288-preview.20 126 1/27/2022
1.0.288-preview.19 126 1/27/2022
1.0.288-preview.18 123 1/27/2022
1.0.288-preview.5 130 1/24/2022
1.0.288-preview.3 123 1/21/2022
1.0.288-preview.1 124 1/21/2022
1.0.272 149 1/10/2022
1.0.270 274 1/6/2022
1.0.260 320 12/10/2021
1.0.259 310 12/9/2021
1.0.258 275 12/7/2021
1.0.218 192 10/18/2021
1.0.155 324 8/31/2021
1.0.136 224 7/17/2021
1.0.135 154 7/16/2021
1.0.134 159 7/15/2021
1.0.133 169 7/14/2021
1.0.130 151 7/6/2021
1.0.129 150 7/6/2021
1.0.125 183 7/5/2021
1.0.121 193 6/29/2021
1.0.119 213 6/28/2021
1.0.40 165 5/24/2021
1.0.23 206 5/21/2021