Skip to main content

Meadow.Foundation.ICs.IOExpanders.Mcp3001

Mcp3001
StatusStatus badge: working
Source codeGitHub
Datasheet(s)GitHub
NuGet packageNuGet Gallery for Meadow.Foundation.ICs.ADCs.Mcp3xxx

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
TypeNameDescription
Meadow.Foundation.ICs.IOExpanders.Mcp3xxx.InputTypeinputTypeThe 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
TypeName
System.Int32sampleCount

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
TypeName
System.Int32sampleCount
System.TimeSpansampleInterval
Meadow.Units.VoltagevoltageReference

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
TypeNameDescription
System.Int32channelChannel 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.InputTypeinputTypeThe type of input channel to read
System.Int32adcResolutionBitsThe number of bits in the returned value

Implements

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