nanoFramework.Iot.Device.Mcp3xxx 1.0.272

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.Mcp3xxx --version 1.0.272
NuGet\Install-Package nanoFramework.Iot.Device.Mcp3xxx -Version 1.0.272
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.Mcp3xxx" Version="1.0.272" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.Iot.Device.Mcp3xxx --version 1.0.272
#r "nuget: nanoFramework.Iot.Device.Mcp3xxx, 1.0.272"
#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.Mcp3xxx as a Cake Addin
#addin nuget:?package=nanoFramework.Iot.Device.Mcp3xxx&version=1.0.272

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

MCP3xxx family of Analog to Digital Converters

Some devices like the Raspberry Pi cannot read analog values directly so rely on analog to digital converters, like the ones available from Microchip in the Mcp3000, Mcp3200 and Mcp3300 ranges. These chips can be accessed as an SPI device or manually via raw GPIO pins. Normally all MCU has an analogic capability but the number of pins can be limited. This is typically useful when you want your MCU to have more than the number of ADC available. Another case is if you need a different resolution or voltage reference.

You can use these converters in your project to access analog devices.

The following fritzing diagram illustrates one way to wire up the Mcp3008, with an ESP32 and a potentiometer.

ESP32 Breadboard diagram

Documentation

The sample is based on following resources:

Major thanks to Adafruit for providing python implementations, which were ported to C# for this sample.

Usage

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

//////////////////////////////////////////////////////////////////////
// when connecting to an ESP32 device, need to configure the SPI GPIOs
// used for the bus
Configuration.SetPinFunction(21, DeviceFunction.SPI1_MOSI);
Configuration.SetPinFunction(22, DeviceFunction.SPI1_MISO);
Configuration.SetPinFunction(23, DeviceFunction.SPI1_CLOCK);
// Make sure as well you are using the right chip select

For other devices like STM32, please make sure you're using the preset pins for the SPI bus you want to use. The chip select can as well be pre setup.

Hardware elements

The following elements are used in this sample:

Accessing the MCP3008 via SPI

The MCU has support for SPI.

You can use the following code to access the MCP3008 via hardware SPI:

var hardwareSpiSettings = new SpiConnectionSettings(1, 42)
{
    ClockFrequency = 1000000
};

using (SpiDevice spi = SpiDevice.Create(hardwareSpiSettings))
using (Mcp3008 mcp = new Mcp3008(spi))
{
    while (true)
    {
        double value = mcp.Read(0);
        value = value / 10.24;
        value = Math.Round(value);
        Debug.WriteLine($"{value}%");
        Thread.Sleep(500);
    }
}

The following pin layout can be used:

  • MCP3008 VDD to MCU 3.3V
  • MCP3008 VREF to MCU 3.3V
  • MCP3008 AGND to MCU GND
  • MCP3008 DGND to MCU GND
  • MCP3008 CLK to MCU SCLK
  • MCP3008 DOUT to MCU MISO
  • MCP3008 DIN to MCU MOSI
  • MCP3008 CS/SHDN to MCU CE0

ESP32 Breadboard diagram

Accessing the MCP3008 via GPIO

You can also access the MCP3008 via GPIO pins, implementing SPI manually. This method is referred to as bit-banging.

You can use the following code to access the MCP3008 via GPIO:

using (SpiDevice spi = new SoftwareSpi(clk: 18, miso: 23, mosi: 24, cs: 25))
using (Mcp3008 mcp = new Mcp3008(spi))
{
    while (true)
    {
        double value = mcp.Read(0);
        value = value / 10.24;
        value = Math.Round(value);
        Debug.WriteLine($"{value}%");
        Thread.Sleep(500);
    }
}

The following pin layout can be used:

  • MCP3008 VDD to MCU 3.3V
  • MCP3008 VREF to MCU 3.3V
  • MCP3008 AGND to MCU GND
  • MCP3008 DGND to MCU GND
  • MCP3008 CLK to any valid GPIO on the MCU
  • MCP3008 DOUT to any valid GPIO on the MCU
  • MCP3008 DIN to any valid GPIO on the MCU
  • MCP3008 CS/SHDN to any valid GPIO on the MCU

ESP32 Breadboard diagram

Processing the data

Independent of the way in which you access the MCP3008 chip, the code to process its results is the same, which follows.

while (true)
{
    double value = mcp.Read(0);
    value = value / 10.24;
    value = Math.Round(value);
    Debug.WriteLine(value);
    Thread.Sleep(500);
}

The chip is 10-bit, which means that it will generate values from 0-1023 (recall that 2^10 is 1024). We can transform the value to a more familiar 0-100 scale by dividing the 10-bit value by 10.24.

Remarks

These bindings support the following ADC's

  • Mcp3001 10 bit resolution with a single pseudo-differential input.

  • Mcp3002 10 bit resolution with two single ended inputs or a single pseudo-differential input.

  • Mcp3004 10 bit resolution with four single ended inputs or two single pseudo-differential inputs.

  • Mcp3008 10 bit resolution with eight single ended inputs or four single pseudo-differential inputs.

  • Mcp3201 12 bit resolution with a single pseudo-differential input.

  • Mcp3202 12 bit resolution with two single ended inputs or a single pseudo-differential input.

  • Mcp3204 12 bit resolution with four single ended inputs or two single pseudo-differential inputs.

  • Mcp3208 12 bit resolution with eight single ended inputs or four single pseudo-differential inputs.

  • Mcp3301 13 bit signed resolution with a single true differential input.

  • Mcp3202 12 bit resolution with four single ended inputs or 13 bit signed resolution with two true differential inputs.

  • Mcp3304 12 bit resolution with eight single ended inputs or 13 bit signed resolution with four true differential inputs.

Note: Currently untested on the Mcp33xx family.

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.436 194 11/10/2023
1.2.416 76 11/8/2023
1.2.329 139 5/26/2023
1.2.316 130 5/16/2023
1.2.313 133 5/12/2023
1.2.297 112 5/3/2023
1.2.212 293 1/5/2023
1.2.203 308 12/28/2022
1.2.159 370 11/14/2022
1.2.153 361 11/5/2022
1.2.141 378 10/25/2022
1.2.122 419 10/12/2022
1.2.114 382 10/8/2022
1.2.95 443 9/22/2022
1.2.87 505 9/15/2022
1.2.73 418 9/8/2022
1.2.5 428 7/13/2022
1.1.141.41205 428 7/6/2022
1.1.116.8772 440 6/24/2022
1.1.113.2032 439 6/23/2022
1.1.97.17326 434 6/13/2022
1.1.92.53000 417 6/8/2022
1.1.58.10097 426 5/23/2022
1.1.27 443 4/26/2022
1.1.20 441 4/21/2022
1.1.3 454 4/15/2022
1.1.1 425 4/14/2022
1.0.300 451 3/31/2022
1.0.277-preview.126 117 3/25/2022
1.0.277-preview.125 110 3/25/2022
1.0.277-preview.116 100 3/22/2022
1.0.277-preview.115 98 3/21/2022
1.0.277-preview.112 108 3/19/2022
1.0.277-preview.111 108 3/18/2022
1.0.277-preview.110 103 3/18/2022
1.0.277-preview.106 117 3/15/2022
1.0.277-preview.105 106 3/15/2022
1.0.277-preview.99 107 3/10/2022
1.0.277-preview.98 107 3/8/2022
1.0.277-preview.89 109 2/27/2022
1.0.277-preview.87 99 2/26/2022
1.0.277-preview.85 107 2/25/2022
1.0.277-preview.77 105 2/18/2022
1.0.277-preview.75 104 2/16/2022
1.0.277-preview.73 111 2/12/2022
1.0.277-preview.70 110 2/10/2022
1.0.277-preview.65 104 2/9/2022
1.0.277-preview.60 124 2/4/2022
1.0.277-preview.53 126 1/31/2022
1.0.277-preview.41 118 1/28/2022
1.0.277-preview.32 126 1/27/2022
1.0.277-preview.30 123 1/27/2022
1.0.277-preview.17 125 1/24/2022
1.0.277-preview.13 120 1/21/2022
1.0.277-preview.1 122 1/11/2022
1.0.272 464 1/10/2022
1.0.259 332 12/9/2021
1.0.258 302 12/7/2021
1.0.221 149 10/19/2021
1.0.219 160 10/19/2021
1.0.218 177 10/18/2021
1.0.157 153 9/4/2021
1.0.155 154 8/31/2021
1.0.153 147 8/14/2021
1.0.151 163 8/6/2021
1.0.146 153 7/22/2021
1.0.136 220 7/17/2021
1.0.135 152 7/16/2021
1.0.134 160 7/15/2021
1.0.133 180 7/14/2021
1.0.131 157 7/8/2021
1.0.129 150 7/6/2021
1.0.127 166 7/5/2021
1.0.125 182 7/5/2021
1.0.122 204 6/30/2021
1.0.121 188 6/29/2021
1.0.119 213 6/28/2021
1.0.105 269 5/29/2021
1.0.97 160 5/28/2021
1.0.63 161 5/26/2021
1.0.47 176 5/24/2021