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

This is a prerelease version of Meadow.Foundation.Motors.Stepper.GpioStepper.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Meadow.Foundation.Motors.Stepper.GpioStepper --version 1.12.8.6-beta                
NuGet\Install-Package Meadow.Foundation.Motors.Stepper.GpioStepper -Version 1.12.8.6-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.12.8.6-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.12.8.6-beta                
#r "nuget: Meadow.Foundation.Motors.Stepper.GpioStepper, 1.12.8.6-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.12.8.6-beta&prerelease

// Install Meadow.Foundation.Motors.Stepper.GpioStepper as a Cake Tool
#tool nuget:?package=Meadow.Foundation.Motors.Stepper.GpioStepper&version=1.12.8.6-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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.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
2.0.1.2 32 2 days ago
2.0.1.1 29 2 days ago
2.0.0.9 27 2 days ago
2.0.0.8-beta 30 5 days ago
2.0.0.7-beta 54 7 days ago
2.0.0.6-beta 63 8 days ago
2.0.0.5-beta 54 9 days ago
2.0.0.4-beta 41 12 days ago
2.0.0.3 65 13 days ago
1.15.0.10-beta 63 13 days ago
1.15.0.9-beta 92 17 days ago
1.15.0.8-beta 75 a month ago
1.15.0.7-beta 78 a month ago
1.15.0.6-beta 74 2 months ago
1.15.0.5-beta 67 2 months ago
1.15.0.4-beta 72 2 months ago
1.15.0.3-beta 77 3 months ago
1.15.0.2-beta 72 3 months ago
1.15.0.1-beta 80 3 months ago
1.15.0 110 3 months ago
1.14.0.6-beta 83 3 months ago
1.14.0.5-beta 66 4 months ago
1.14.0.4-beta 75 4 months ago
1.14.0.3-beta 103 4 months ago
1.14.0.2-beta 94 4 months ago
1.14.0.1-beta 96 4 months ago
1.14.0 108 5 months ago
1.13.0.1-beta 117 5 months ago
1.13.0 132 5 months ago
1.12.8.7-beta 109 5 months ago
1.12.8.6-beta 79 5 months ago
1.12.8.5-beta 73 6 months ago
1.12.8.4-beta 92 6 months ago
1.12.8.2-beta 74 6 months ago
1.12.8.1-beta 87 6 months ago
1.12.8 105 6 months ago
1.12.2.9-beta 87 6 months ago
1.12.2.7-beta 64 7 months ago
1.12.2.6-beta 90 7 months ago
1.12.2.5-beta 100 7 months ago
1.12.2.4-beta 88 7 months ago
1.12.2.3-beta 97 7 months ago
1.12.2.1-beta 100 7 months ago
1.12.2 105 7 months ago
1.12.0.2-beta 98 8 months ago
1.12.0.1-beta 88 8 months ago
1.12.0 139 8 months ago
1.11.0.5-beta 99 8 months ago
1.11.0.4-beta 100 8 months ago
1.11.0.3-beta 104 8 months ago
1.11.0.2-beta 105 8 months ago
1.11.0.1-beta 96 8 months ago
1.11.0 145 9 months ago
1.10.2.1-beta 107 9 months ago
1.10.2 116 9 months ago
1.10.0.3-beta 87 9 months ago
1.10.0.2-beta 90 9 months ago
1.10.0.1-beta 98 10 months ago
1.10.0 133 10 months ago
1.9.0.6-beta 114 10 months ago
1.9.0.5-beta 104 3/19/2024
1.9.0.4-beta 88 3/13/2024
1.9.0.3 119 3/6/2024
1.9.0.2-beta 96 3/6/2024
1.9.0.1 136 3/1/2024
1.9.0 145 2/27/2024
1.8.0.8-beta 105 2/23/2024
1.8.0.7-beta 108 2/22/2024
1.8.0.6-beta 108 2/20/2024
1.8.0.5-beta 117 2/13/2024
1.8.0.4-beta 123 2/6/2024
1.8.0.3-beta 110 2/1/2024
1.8.0.2-beta 100 1/24/2024
1.8.0.1 140 1/20/2024
1.8.0 191 1/16/2024
1.7.0 146 1/9/2024
1.6.0.6-beta 120 1/3/2024
1.6.0.5-beta 116 12/27/2023
1.6.0.4-beta 137 12/20/2023
1.6.0.3-beta 95 12/19/2023
1.6.0.2-beta 156 12/12/2023
1.6.0 243 12/6/2023
1.5.0.1-beta 146 12/4/2023