nanoFramework.Iot.Device.Ds18b20 1.0.820

Prefix Reserved
dotnet add package nanoFramework.Iot.Device.Ds18b20 --version 1.0.820
                    
NuGet\Install-Package nanoFramework.Iot.Device.Ds18b20 -Version 1.0.820
                    
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.Ds18b20" Version="1.0.820" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="nanoFramework.Iot.Device.Ds18b20" Version="1.0.820" />
                    
Directory.Packages.props
<PackageReference Include="nanoFramework.Iot.Device.Ds18b20" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add nanoFramework.Iot.Device.Ds18b20 --version 1.0.820
                    
#r "nuget: nanoFramework.Iot.Device.Ds18b20, 1.0.820"
                    
#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.
#addin nuget:?package=nanoFramework.Iot.Device.Ds18b20&version=1.0.820
                    
Install as a Cake Addin
#tool nuget:?package=nanoFramework.Iot.Device.Ds18b20&version=1.0.820
                    
Install as a Cake Tool

Ds18b20 - Temperature Sensor

The DS18B20 digital thermometer provides 9-bit to 12-bit Celsius temperature measurements and has an alarm function with nonvolatile user-programmable upper and lower trigger points.

Documentation

Product datasheet can be found here

Sensor Image

sensor

Circuit

circuit

  • DATA - RX2 + TX2 shorted
  • VCC - 3.3V
  • GND - GND

Important: make sure you've connected data pin of sensor to two pins on the board!

Usage

Important: make sure you properly setup the Rx/Tx pins especially for ESP32 before creating the OneWireHost, make sure you install the nanoFramework.Hardware.ESP32 nuget:

Configuration.SetPinFunction(16, DeviceFunction.COM3_RX);
Configuration.SetPinFunction(17, DeviceFunction.COM3_TX);

Library supports three approaches to read the data from Ds18b20 sensors:

  1. Reading from first found sensor on OneWire bus or sensor with address passed as second parameter to the constructor:
 private static void ReadingFromOneSensor()
 {
     OneWireHost oneWire = new OneWireHost();


     Ds18b20 ds18b20 = new Ds18b20(oneWire, null, false, TemperatureResolution.VeryHigh);

     ds18b20.IsAlarmSearchCommandEnabled = false;
     if (ds18b20.Initialize())
     {
         Console.WriteLine($"Is sensor parasite powered?:{ds18b20.IsParasitePowered}");
         string devAddrStr = "";
         foreach (var addrByte in ds18b20.Address)
         {
             devAddrStr += addrByte.ToString("X2");
         }

         Console.WriteLine($"Sensor address:{devAddrStr}");

         while (true)
         {
             if (!ds18b20.TryReadTemperature(out var currentTemperature))
             {
                 Console.WriteLine("Can't read!");
             }
             else
             {
                 Console.WriteLine($"Temperature: {currentTemperature.DegreesCelsius.ToString("F")}\u00B0C");
             }

             Thread.Sleep(5000);
         }
     }


     oneWire.Dispose();
 }
  1. Notification mode from first found sensor on OneWire bus or sensor with address passed as second parameter to the constructor:
private static void NotificationWhenValueHasChanged()
{
    OneWireHost oneWire = new OneWireHost();

    Ds18b20 ds18b20 = new Ds18b20(oneWire, null, false, TemperatureResolution.VeryHigh);

    if (ds18b20.Initialize())
    {
        ds18b20.SensorValueChanged += (currentTemperature) =>
        {
            Console.WriteLine($"Temperature: {currentTemperature.DegreesCelsius.ToString("F")}\u00B0C");
        };
        ds18b20.BeginTrackChanges(TimeSpan.FromMilliseconds(2000));
        // do whatever you want or sleep
        Thread.Sleep(60000);
        ds18b20.EndTrackChanges();
    }

    oneWire.Dispose();
}
  1. Using alarms - alarm is a mode when sensor has value either higher or lower than defined tresholds.
private static void UsingAlarms()
{
    using OneWireHost oneWire = new OneWireHost();

    Ds18b20 ds18b20 = new Ds18b20(oneWire, null, false, TemperatureResolution.VeryHigh);

    if (ds18b20.Initialize())
    {
        for (int i = 0; i < ds18b20.AddressNet.Length; i++)
        {
            string devAddrStr = "";
            ds18b20.Address = ds18b20.AddressNet[i];

            foreach (var addrByte in ds18b20.AddressNet[i])
            {
                devAddrStr += addrByte.ToString("X2");
            }

            Console.WriteLine("18b20-" + i.ToString("X2") + " " + devAddrStr);

            ds18b20.ConfigurationRead(false);
            Console.WriteLine("Alarm set-points before changes:");
            Console.WriteLine("Hi alarm = " + ds18b20.TemperatureHighAlarm.DegreesCelsius + " C");
            Console.WriteLine("Lo alarm = " + ds18b20.TemperatureLowAlarm.DegreesCelsius + " C");
            SetAlarmSetting();
        }
        alarmSearch();
    }
    else
    {
        Console.WriteLine("No devices found.");
    }

    oneWire.Dispose();

    void alarmSearch()
    {
        int loopRead = 1000;
        ds18b20.IsAlarmSearchCommandEnabled = true;

        while (loopRead > 0)
        {
            Console.WriteLine("LoopRead " + loopRead);

            if (ds18b20.SearchForAlarmCondition())
            {
                for (int index = 0; index < ds18b20.AddressNet.Length; index++)
                {
                    ds18b20.Address = ds18b20.AddressNet[index];
                    if (ds18b20.TryReadTemperature(out var currentTemperature))
                    {
                        break;
                    }

                    string devAddrStr = "";
                    foreach (var addrByte in ds18b20.AddressNet[index]) devAddrStr += addrByte.ToString("X2");
                    Console.WriteLine("DS18B20[" + devAddrStr + "] Sensor reading in One-Shot-mode; T = " + currentTemperature.DegreesCelsius.ToString("f2") + " C");

                    ds18b20.ConfigurationRead(false);
                    Console.WriteLine("Alarm set-points:");
                    Console.WriteLine("Hi alarm = " + ds18b20.TemperatureHighAlarm.DegreesCelsius + " C");
                    Console.WriteLine("Lo alarm = " + ds18b20.TemperatureLowAlarm.DegreesCelsius + " C");
                }
            }
            else
            {
                Console.WriteLine("***** No devices in alarm ****");
            }

            loopRead--;
        }

        Console.WriteLine("");
    }

    void SetAlarmSetting()
    {
        ds18b20.TemperatureHighAlarm = Temperature.FromDegreesCelsius(30);
        ds18b20.TemperatureLowAlarm = Temperature.FromDegreesCelsius(25);
        // Write configuration on ScratchPad.
        ds18b20.ConfigurationWrite(false);
        // Write configuration on EEPROM too.
        ds18b20.ConfigurationWrite(true);
        // Read configuration to check if changes were applied
        ds18b20.ConfigurationRead(true);
        Console.WriteLine("Alarm set-points after changes:");
        Console.WriteLine("Hi alarm = " + ds18b20.TemperatureHighAlarm.DegreesCelsius.ToString("F") + " C");
        Console.WriteLine("Lo alarm = " + ds18b20.TemperatureLowAlarm.DegreesCelsius.ToString("F") + " C");
    }
}

Check samples project for more usage examples.

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.0.820 234 4/2/2025
1.0.815 175 4/2/2025
1.0.803 200 3/11/2025
1.0.797 185 3/10/2025
1.0.773 152 2/26/2025
1.0.726 156 2/4/2025
1.0.723 123 2/4/2025
1.0.706 130 1/31/2025
1.0.694 128 1/20/2025
1.0.669 138 12/30/2024
1.0.647 134 12/16/2024
1.0.624 161 10/23/2024
1.0.607 144 10/3/2024
1.0.590 139 9/6/2024
1.0.582 142 8/28/2024
1.0.564 169 8/9/2024
1.0.557 111 8/2/2024
1.0.552 122 7/26/2024
1.0.541 137 7/17/2024
1.0.524 148 6/19/2024
1.0.487 183 4/15/2024
1.0.465 164 3/22/2024
1.0.445 157 2/28/2024
1.0.425 183 1/24/2024
1.0.413 202 1/5/2024
1.0.409 178 12/20/2023
1.0.387 172 11/10/2023
1.0.367 138 11/8/2023
1.0.354 191 10/6/2023
1.0.347 169 9/27/2023
1.0.335 202 9/6/2023
1.0.329 211 8/16/2023
1.0.320 189 8/2/2023
1.0.314 203 7/28/2023
1.0.308 197 7/19/2023
1.0.305 181 7/14/2023
1.0.296 199 6/21/2023
1.0.292 184 6/14/2023
1.0.288 198 6/7/2023
1.0.286 211 6/2/2023
1.0.280 206 5/26/2023
1.0.253 224 5/10/2023
1.0.248 183 5/3/2023
1.0.224 326 3/17/2023
1.0.218 321 3/10/2023
1.0.214 326 3/8/2023
1.0.210 347 2/27/2023
1.0.207 315 2/24/2023
1.0.204 332 2/22/2023
1.0.173 380 1/9/2023
1.0.168 390 1/6/2023
1.0.159 376 1/3/2023
1.0.154 379 12/28/2022
1.0.110 461 11/14/2022
1.0.104 467 11/5/2022
1.0.38 578 9/15/2022
1.0.14 516 9/3/2022
1.0.3 519 8/17/2022
1.0.1 487 8/16/2022