Meadow.Foundation.Motors.Stepper.GpioStepper 1.15.0.2-beta

This is a prerelease version of Meadow.Foundation.Motors.Stepper.GpioStepper.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Meadow.Foundation.Motors.Stepper.GpioStepper --version 1.15.0.2-beta                
NuGet\Install-Package Meadow.Foundation.Motors.Stepper.GpioStepper -Version 1.15.0.2-beta                
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="Meadow.Foundation.Motors.Stepper.GpioStepper" Version="1.15.0.2-beta" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Meadow.Foundation.Motors.Stepper.GpioStepper --version 1.15.0.2-beta                
#r "nuget: Meadow.Foundation.Motors.Stepper.GpioStepper, 1.15.0.2-beta"                
#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 Meadow.Foundation.Motors.Stepper.GpioStepper as a Cake Addin
#addin nuget:?package=Meadow.Foundation.Motors.Stepper.GpioStepper&version=1.15.0.2-beta&prerelease

// Install Meadow.Foundation.Motors.Stepper.GpioStepper as a Cake Tool
#tool nuget:?package=Meadow.Foundation.Motors.Stepper.GpioStepper&version=1.15.0.2-beta&prerelease                

Meadow.Foundation.Motors.Stepper.GpioStepper

Digital input stepper motor controller

The GpioStepper library is included in the Meadow.Foundation.Motors.Stepper.GpioStepper nuget package and is designed for the Wilderness Labs Meadow .NET IoT platform.

This driver is part of the Meadow.Foundation peripherals library, an open-source repository of drivers and libraries that streamline and simplify adding hardware to your C# .NET Meadow IoT applications.

For more information on developing for Meadow, visit developer.wildernesslabs.co.

To view all Wilderness Labs open-source projects, including samples, visit github.com/wildernesslabs.

Installation

You can install the library from within Visual studio using the the NuGet Package Manager or from the command line using the .NET CLI:

dotnet add package Meadow.Foundation.Motors.Stepper.GpioStepper

Usage

private IStepperMotor stepper;

private bool UseStepDirConfiguration { get; set; } = true;

public override Task Initialize()
{
    if (UseStepDirConfiguration)
    {
        // use a drive configured for STEP/DIR GPIOs
        stepper = new StepDirStepper(
            Device.Pins.D15.CreateDigitalOutputPort(),
            Device.Pins.D14.CreateDigitalOutputPort(),
            stepsPerRevolution: 200);
    }
    else
    {
        // use a drive configured for CW/CCW GPIOs
        stepper = new CwCcwStepper(
            Device.Pins.D15.CreateDigitalOutputPort(),
            Device.Pins.D14.CreateDigitalOutputPort(),
            stepsPerRevolution: 200);
    }

    return base.Initialize();
}

public override Task Run()
{
    // return RunUntilCancelled();
    // return RunForSpecifiedTime();
    // return RunToSpecificPositions();
    return RotateSpecifiedAmount();
}

private async Task RunUntilCancelled()
{
    var direction = RotationDirection.Clockwise;
    var rate = new AngularVelocity(1, AngularVelocity.UnitType.RevolutionsPerSecond);

    while (true)
    {
        var tokenSource = new CancellationTokenSource();

        Resolver.Log.Info($"Start running...");
        var task = stepper.Run(direction, rate, tokenSource.Token);

        Resolver.Log.Info($"wait for 3 seconds...");
        await Task.Delay(3000);

        Resolver.Log.Info($"cancelling motion...");
        tokenSource.Cancel();

        Resolver.Log.Info($"wait for motion to stop");
        task.Wait();

        Resolver.Log.Info($"motion stopped");

        direction = direction switch
        {
            RotationDirection.CounterClockwise => RotationDirection.Clockwise,
            _ => RotationDirection.CounterClockwise
        };

        await Task.Delay(500);
    }
}

private async Task RunForSpecifiedTime()
{
    while (true)
    {
        var direction = RotationDirection.Clockwise;
        var rate = new AngularVelocity(1, AngularVelocity.UnitType.RevolutionsPerSecond);

        Resolver.Log.Info($"Run for 2 seconds...");
        await stepper.RunFor(TimeSpan.FromSeconds(2), direction, rate);

        direction = RotationDirection.CounterClockwise;
        rate = new AngularVelocity(2, AngularVelocity.UnitType.RevolutionsPerSecond);

        await stepper.RunFor(TimeSpan.FromSeconds(2), direction, rate);
    }
}

private async Task RotateSpecifiedAmount()
{
    while (true)
    {
        for (var turns = 0.5d; turns <= 5; turns += 0.5)
        {
            Resolver.Log.Info($"Moving {turns:0.0} revolutions");

            var direction = RotationDirection.Clockwise;
            var rate = new AngularVelocity(4, AngularVelocity.UnitType.RevolutionsPerSecond);

            await stepper.Rotate(new Angle(turns, Angle.UnitType.Revolutions), direction, rate);

            await Task.Delay(1000);
        }
    }
}

private async Task RunToSpecificPositions()
{
    RotationDirection direction;

    var rate = new AngularVelocity(2, AngularVelocity.UnitType.RevolutionsPerSecond);

    // turn in smaller and smaller degree increments
    var increments = new double[] { 180, 90, 60, 45, 30 };

    while (true)
    {
        direction = RotationDirection.Clockwise;

        Resolver.Log.Info($"{direction}");

        foreach (var increment in increments)
        {
            Resolver.Log.Info($"Moving in increments of {increment} degrees");

            await stepper.GoTo(new Angle(0), direction, rate);
            await Task.Delay(1000);

            var nextPosition = 0d;

            while (nextPosition < 360)
            {
                Resolver.Log.Info($"Moving to {nextPosition} degrees");

                nextPosition += increment;

                await stepper.GoTo(new Angle(nextPosition, Meadow.Units.Angle.UnitType.Degrees), direction, rate);
                await Task.Delay(1000);
            }
        }

        await Task.Delay(3000);

        direction = RotationDirection.CounterClockwise;

        Resolver.Log.Info($"{direction}");

        foreach (var increment in increments)
        {
            Resolver.Log.Info($"Moving in increments of {increment} degrees");

            var nextPosition = 360d;

            await stepper.GoTo(new Angle(0), direction, rate);
            await Task.Delay(1000);

            while (nextPosition > 0)
            {
                Resolver.Log.Info($"Moving to {nextPosition} degrees");

                nextPosition -= increment;

                await stepper.GoTo(new Angle(nextPosition, Meadow.Units.Angle.UnitType.Degrees), direction, rate);
                await Task.Delay(1000);
            }
        }

        await Task.Delay(3000);

        Resolver.Log.Info($"--- Cycle complete ---");
    }
}

How to Contribute

Need Help?

If you have questions or need assistance, please join the Wilderness Labs community on Slack.

About Meadow

Meadow is a complete, IoT platform with defense-grade security that runs full .NET applications on embeddable microcontrollers and Linux single-board computers including Raspberry Pi and NVIDIA Jetson.

Build

Use the full .NET platform and tooling such as Visual Studio and plug-and-play hardware drivers to painlessly build IoT solutions.

Connect

Utilize native support for WiFi, Ethernet, and Cellular connectivity to send sensor data to the Cloud and remotely control your peripherals.

Deploy

Instantly deploy and manage your fleet in the cloud for OtA, health-monitoring, logs, command + control, and enterprise backend integrations.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
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.15.0.6-beta 59 11/20/2024
1.15.0.5-beta 55 11/19/2024
1.15.0.4-beta 60 11/16/2024
1.15.0.3-beta 67 11/4/2024
1.15.0.2-beta 62 10/29/2024
1.15.0.1-beta 65 10/22/2024
1.15.0 96 10/15/2024
1.14.0.6-beta 79 10/8/2024
1.14.0.5-beta 60 10/2/2024
1.14.0.4-beta 68 9/24/2024
1.14.0.3-beta 99 9/17/2024
1.14.0.2-beta 88 9/12/2024
1.14.0.1-beta 92 9/10/2024
1.14.0 100 9/5/2024
1.13.0.1-beta 113 8/21/2024
1.13.0 122 8/15/2024
1.12.8.7-beta 103 8/14/2024
1.12.8.6-beta 73 8/6/2024
1.12.8.5-beta 67 7/30/2024
1.12.8.4-beta 87 7/30/2024
1.12.8.2-beta 68 7/24/2024
1.12.8.1-beta 80 7/17/2024
1.12.8 94 7/11/2024
1.12.2.9-beta 78 7/9/2024
1.12.2.7-beta 57 7/3/2024
1.12.2.6-beta 85 6/29/2024
1.12.2.5-beta 93 6/28/2024
1.12.2.4-beta 82 6/24/2024
1.12.2.3-beta 90 6/24/2024
1.12.2.1-beta 94 6/19/2024
1.12.2 96 6/11/2024
1.12.0.2-beta 93 6/4/2024
1.12.0.1-beta 84 5/30/2024
1.12.0 131 5/28/2024
1.11.0.5-beta 93 5/24/2024
1.11.0.4-beta 94 5/21/2024
1.11.0.3-beta 96 5/15/2024
1.11.0.2-beta 98 5/9/2024
1.11.0.1-beta 92 5/8/2024
1.11.0 138 4/30/2024
1.10.2.1-beta 102 4/23/2024
1.10.2 111 4/17/2024
1.10.0.3-beta 82 4/15/2024
1.10.0.2-beta 85 4/11/2024
1.10.0.1-beta 93 4/5/2024
1.10.0 128 3/26/2024
1.9.0.6-beta 109 3/25/2024
1.9.0.5-beta 98 3/19/2024
1.9.0.4-beta 82 3/13/2024
1.9.0.3 113 3/6/2024
1.9.0.2-beta 91 3/6/2024
1.9.0.1 130 3/1/2024
1.9.0 141 2/27/2024
1.8.0.8-beta 100 2/23/2024
1.8.0.7-beta 102 2/22/2024
1.8.0.6-beta 102 2/20/2024
1.8.0.5-beta 106 2/13/2024
1.8.0.4-beta 118 2/6/2024
1.8.0.3-beta 104 2/1/2024
1.8.0.2-beta 93 1/24/2024
1.8.0.1 134 1/20/2024
1.8.0 183 1/16/2024
1.7.0 140 1/9/2024
1.6.0.6-beta 113 1/3/2024
1.6.0.5-beta 110 12/27/2023
1.6.0.4-beta 129 12/20/2023
1.6.0.3-beta 89 12/19/2023
1.6.0.2-beta 150 12/12/2023
1.6.0 238 12/6/2023
1.5.0.1-beta 141 12/4/2023