Meadow.Foundation.ICs.IOExpanders.Mcp3001

Mcp3001
Status
Source code	GitHub
Datasheet(s)	GitHub
NuGet package

Code Example

Mcp3001 mcp;

IAnalogInputPort port;

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

    IDigitalOutputPort chipSelectPort = Device.CreateDigitalOutputPort(Device.Pins.D01);

    mcp = new Mcp3001(Device.CreateSpiBus(), chipSelectPort);

    port = mcp.CreateAnalogInputPort();

    port.Updated += (s, result) =>
    {
        Resolver.Log.Info($"Analog event, new voltage: {result.New.Volts:N2}V, old: {result.Old?.Volts:N2}V");
    };

    var observer = IAnalogInputPort.CreateObserver(
        handler: result =>
        {
            Resolver.Log.Info($"Analog observer triggered; new: {result.New.Volts:n2}V, old: {result.Old?.Volts:n2}V");
        },
        filter: result =>
        {
            if (result.Old is { } oldValue)
            {
                return (result.New - oldValue).Abs().Volts > 0.1;
            }
            else { return false; }
        }
    );
    port.Subscribe(observer);

    return base.Initialize();
}

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

    port.StartUpdating();

    return Task.CompletedTask;
}

Sample project(s) available on GitHub

Class Mcp3001

MCP3001 Analog to Digital Converter (ADC)

Assembly: Mcp3xxx.dll

View Source

Declaration

public class Mcp3001 : Mcp3xxx, IAnalogInputController, IPinController, ISpiPeripheral, IDisposable

Inheritance: System.Object -> Meadow.Foundation.ICs.IOExpanders.Mcp3xxx

Implements:
Meadow.Hardware.IAnalogInputController, Meadow.Hardware.IPinController, Meadow.Hardware.ISpiPeripheral, System.IDisposable

Properties

Pins

The pins

View Source

Declaration

public Mcp3001.PinDefinitions Pins { get; }

Methods

IsInputTypeSupported(InputType)

Is the input type supported on this MCP3xxx version

View Source

Declaration

public override bool IsInputTypeSupported(Mcp3xxx.InputType inputType)

Returns

System.Boolean: True if supported, false if not supported

Parameters

Type	Name	Description
Meadow.Foundation.ICs.IOExpanders.Mcp3xxx.InputType	inputType	The input type

CreateAnalogInputPort(int)

Create an analog input port for a pin

View Source

Declaration

public IAnalogInputPort CreateAnalogInputPort(int sampleCount = 64)

Returns

Meadow.Hardware.IAnalogInputPort

Parameters

Type	Name
System.Int32	sampleCount

CreateAnalogInputPort(int, TimeSpan, Voltage)

Create an analog input port for a pin

View Source

Declaration

public IAnalogInputPort CreateAnalogInputPort(int sampleCount, TimeSpan sampleInterval, Voltage voltageReference)

Returns

Meadow.Hardware.IAnalogInputPort

Parameters

Type	Name
System.Int32	sampleCount
System.TimeSpan	sampleInterval
Meadow.Units.Voltage	voltageReference

ReadInternal(int, InputType, int)

Reads a value from the device

View Source

Declaration

protected override int ReadInternal(int channel, Mcp3xxx.InputType inputType, int adcResolutionBits)

Returns

System.Int32: A value corresponding to relative voltage level on specified device channel

Parameters

Type	Name	Description
System.Int32	channel	Channel to read - for differential inputs this represents a channel pair (valid values: 0 - channelcount - 1 or 0 - channelcount / 2 - 1 with differential inputs)
Meadow.Foundation.ICs.IOExpanders.Mcp3xxx.InputType	inputType	The type of input channel to read
System.Int32	adcResolutionBits	The number of bits in the returned value

Implements

• Meadow.Hardware.IAnalogInputController
• Meadow.Hardware.IPinController
• Meadow.Hardware.ISpiPeripheral
• System.IDisposable