MakoIoT.Device 1.0.55.5721

Mako-IoT.Device

This is the composition framework of MAKO-IoT. These components provide backbone for your solution.

Projects structure

Create two nanoFramework projects:

MyProject.Device (nanoFramework Class Library)

Implement your logic here. You will be able to unit test this project (without hardware!). Place everything your software needs to do here, abstracting hardware-specific operations with interfaces. For example, if you want to blink a LED - create IBlinker interface here with void Blink(bool isOn); method.

MyProject.Device.App (nanoFramework Application)

This is the entry point to your software. Use DeviceBuilder to link all components together (MAKO IoT and your code) in the Main() method of Program class. Also, implement your hardware-specific logic here. For example, concrete blinker class for the interface above: LedBlinker : IBlinker. Link the interface with the class in ConfigureDI section of DeviceBuilder.

public class Program
{
    public static void Main()
    {
        DeviceBuilder.Create()
            .ConfigureDI(services =>
            {
                //dependency injection registrations go here
            })
            //add other MAKO-IoT components & configuration here
            
            .Build()
            .Start();

        Thread.Sleep(Timeout.InfiniteTimeSpan);
    }
}

See Blink sample

Device events

You can attach handlers to DeviceStarting and DeviceStopped events:

var builder = DeviceBuilder.Create();

builder.DeviceStarting += device =>
{
    //do something on start
};

builder.DeviceStopped += device =>
{
    //do something on stop
};

builder.Build().Start();

Device start behavior

With IDeviceStartBehavior you can intercept device startup. For example, based on certain condition either continue normal operation go into configuration mode.

public class MyDeviceStartBehavior : IDeviceStartBehavior
{
    public bool DeviceStarting()
    {
      if (normalOperationMode)
        return true; //continue normal device startup
      
      return false; //don't continue device startup
    }
}

public class Program
{
    public static void Main()
    {
        DeviceBuilder.Create()
            .ConfigureDI(services =>
            {
                services.AddSingleton(typeof(IDeviceStartBehavior), typeof(MyDeviceStartBehavior));
            }).Build().Start();

        Thread.Sleep(Timeout.InfiniteTimeSpan);
    }
}