nanoFramework.M5Core2 1.0.0-preview.99

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
This is a prerelease version of nanoFramework.M5Core2.
There is a newer version of this package available.
See the version list below for details.
dotnet add package nanoFramework.M5Core2 --version 1.0.0-preview.99
NuGet\Install-Package nanoFramework.M5Core2 -Version 1.0.0-preview.99
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="nanoFramework.M5Core2" Version="1.0.0-preview.99" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.M5Core2 --version 1.0.0-preview.99
#r "nuget: nanoFramework.M5Core2, 1.0.0-preview.99"
#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 nanoFramework.M5Core2 as a Cake Addin
#addin nuget:?package=nanoFramework.M5Core2&version=1.0.0-preview.99&prerelease

// Install nanoFramework.M5Core2 as a Cake Tool
#tool nuget:?package=nanoFramework.M5Core2&version=1.0.0-preview.99&prerelease

Quality Gate Status Reliability Rating License NuGet #yourfirstpr Discord

nanoFramework logo


Welcome to the .NET nanoFramework M5Stack Library repository

Build status

Component Build Status NuGet Package
nanoFramework.M5Stack Build Status NuGet
nanoFramework.M5Stack (preview) Build Status NuGet
nanoFramework.M5Stick Build Status NuGet
nanoFramework.M5Stick (preview) Build Status NuGet
nanoFramework.M5StickCPlus Build Status NuGet
nanoFramework.M5StickCPlus (preview) Build Status NuGet
nanoFramework.M5Core2 Build Status NuGet
nanoFramework.M5Core2 (preview) Build Status NuGet

Usage

Those 3 nugets provide a support for the M5Stack, M5StickC, M5StickCPlus and M5Core2.

They bring support for the screens as well and require to be flashed with the proper image:

# Replace the com port number by your COM port
# For the M5Stack:
nanoff --target M5Stack --update --preview --serialport COM3
# For the M5StickC:
nanoff --target M5StickC --update --preview --serialport COM3 --baud 115200
# For the M5StickCPlus:
nanoff --target M5StickCPlus --update --preview --serialport COM3 --baud 115200
# For the M5Core2:
nanoff --target M5Core2 --update --preview --serialport COM3

Once you have the nugets, you can then enjoy accessing the screen, the accelerometer, get a Grove I2C connecter, add events on the buttons. And you don't even need to think about anything, all is done for you in the most transparent way!

Note: All the classes that you'll have access are all using the Lazy pattern to be instantiated including the screen. This have the advantage to use as little memory and setup time as possible.

In the samples below, we'll use either M5Stack, either M5Stick as examples, they are all working in a very similar way.

Screen

The only thing you need to do to access the screen is to initialize it:

M5Stack.InitializeScreen();

Once you've initialized it, you can access both a Screen static class and a Console static class.

THe Screen one brings primitives to write directly on the screen points or scare of colors as well as writing a text.

For example, you can write a blue square of 10x10 at the position 0, 0 like this:

ushort[] toSend = new ushort[100];
ushort blue = ColorUtility.To16Bpp(Color.Blue);

for (int i = 0; i < toSend.Length; i++)
{
    toSend[i] = blue;
}

Screen.Write(0, 0, 10, 10, toSend);

The Console class works in a similar way as the classic System.Console:

Console.Clear();

// Test the console display
Console.Write("This is a short text. ");
Console.ForegroundColor = Color.Red;
Console.WriteLine("This one displays in red after the previous one and is already at the next line.");
Console.BackgroundColor = Color.Yellow;
Console.ForegroundColor = Color.RoyalBlue;
Console.WriteLine("And this is blue on yellow background");
Console.ResetColor();
Console.CursorLeft = 0;
Console.CursorTop = 8;
Console.Write("This is white on black again and on 9th line");

Note: You can change the default font as well, you need to provide it as a property. The Cursor positions are calculated with the largest possible character.

M5Core2 has SPRAM, so you can get a full screen buffer as well. Refer to the Graphics samples to understand all you can do with it.

Buttons

The main buttons except the power buttons are exposed.

On the M5Stack they are called ButtonLeft, ButtonCenter and ButtonRight. You can get access to the events as well. For example:

M5Stack.ButtonLeft.Press += (sender, e) =>
{
    Console.ForegroundColor = Color.Yellow;
    Console.CursorLeft = 0;
    Console.CursorTop = 0;
    Console.Write($"Left Pressed  ");
};

On the M5StickC/CPlus they are called ButtonM5 and ButtonRight. You can get access to the status of the button, the events and everything you need. For example:

while (!M5StickC.ButtonRight.IsPressed)
{
    Thread.Sleep(10);
}

M5StickC.M5Button.IsHoldingEnabled = true;
M5StickC.M5Button.Holding += (sender, e) =>
{
    Console.Write("M5 button hold long.");
};

Note: The M5Core2 has touch screen and the buttons are part of it. So far .NET nanoFramework does not have the support for them and thus, they are not supported yet. PR to improve this situation welcome!

Power management

Both M5Stack and M5StickC/CPlus are exposing their power management elements. It is not recommended to change any default value except if you know what you are doing.

Please refer to the detailed examples for the AXP192 used in the M5StickC/CPlus; M5Core2 and IP5306 for the M5Stack.

Accelerometer and Gyroscope

You can get access to the Accelerometer and Gyroscope like this:

var ag = M5Stack.AccelerometerGyroscope;
// Do not move the M5Stack/M5Stick during the calibration
ag.Calibrate(100);
var acc = ag.GetAccelerometer();
var gyr = ag.GetGyroscope();
Debug.WriteLine($"Accelerometer data x:{acc.X} y:{acc.Y} z:{acc.Z}");
Debug.WriteLine($"Gyroscope data x:{gyr.X} y:{gyr.Y} z:{gyr.Z}\n");

Refer to the MPU6886 documentation for more detailed usage on this sensor.

Magnetometer

The M5Stack has a magnetometer, you can access it as well:

var mag = M5Stack.Magnetometer;
// It is more than strongly recommended to calibrate the magnetometer.
// Move the M5Stack in all directions to have a proper calibration.
mag.CalibrateMagnetometer(100);
var magVal = mag.ReadMagnetometer();
Console.WriteLine($"x={magVal.X:N2}   ");
Console.WriteLine($"y={magVal.Y:N2}   ");
Console.WriteLine($"Z={magVal.Z:N2}   ");
var headDir = Math.Atan2(magVal.X, magVal.Y) * 180.0 / Math.PI;
Console.WriteLine($"h={headDir:N2}  ");

SerialPort

The M5Stack and M5Core2 can provide a Serial Port, just get it like this:

// You can access any of the Serial Port feature
M5Stack.SerialPort.Open(115200);
// Do anything else you need
M5Stack.SerialPort.Close();

Refer to the SerialPort documentation for more information.

ADC Channels

ADC Channels are pre setup on the M5Stack, access them like this:

// This will give you the ADC1 channel 7 which is on pin 35
AdcChannel myChannel = M5Stack.GetAdcGpio(35);

Refer to the M5Stack documentation to have the mapping of the ADC channels and the pins.

I2C Device/Grove

You can get an I2cDevice/Grove like this:

// In this example, the I2C address of the device is 0x42:
I2cDevice myDevice = M5Stack.GetGrove(0x42);
// replacing GetGrove by GetI2cDevice will have the same impact

SPI Device

The M5Stack provides as well an SPiDevice:

// In this case GPIO5 will be used as chip select:
SpiDevice mySpi = M5Stack.GetSpiDevice(5);

GPIO Controller

Similar as previously, you can get the GpioController on any of the M5Stack, M5Core2 and M5StickC/CPlus:

// This will open the GPIO 36 as output
var pin5 = M5StickC.GpioController.OpenPin(36, PinMode.Output);

DAC

The M5Stack exposes 2 DAC and you can access them thru the Dac1 and Dac2 properties. Refer to the DAC documentation for more information.

Led

The M5StickC/CPlus exposes a led. You can access it thru the Led property:

// This will toggle the led:
M5StickC.Led.Toggle();

Infrared Led

The M5StickC/CPlus exposes an infrared led. You can access it thru the InfraredLed property. This will give you a TransmitterChannel. Check out the sample pack to understand how to use it.

Feedback and documentation

For documentation, providing feedback, issues and finding out how to contribute please refer to the Home repo.

Join our Discord community here.

Credits

The list of contributors to this project can be found at CONTRIBUTORS.

License

The nanoFramework Class Libraries are licensed under the MIT license.

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behaviour in our community. For more information see the .NET Foundation Code of Conduct.

.NET Foundation

This project is supported by the .NET Foundation.

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
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 (1)

Showing the top 1 popular GitHub repositories that depend on nanoFramework.M5Core2:

Repository Stars
nanoframework/nanoFramework.IoT.Device
📦 This repo includes .NET nanoFramework implementations for various sensors, chips, displays, hats and drivers
Version Downloads Last updated
1.1.207 32 3/27/2024
1.1.203 170 2/28/2024
1.1.201 205 1/31/2024
1.1.199 87 1/26/2024
1.1.197 92 1/24/2024
1.1.187 469 11/17/2023
1.1.185 147 11/14/2023
1.1.183 162 11/9/2023
1.1.180 121 11/8/2023
1.1.177 306 10/11/2023
1.1.175 200 9/29/2023
1.1.171 234 9/8/2023
1.1.169 154 9/6/2023
1.1.167 252 8/18/2023
1.1.163 361 8/2/2023
1.1.161 165 7/28/2023
1.1.157 220 7/19/2023
1.1.155 178 7/14/2023
1.1.152 367 6/21/2023
1.1.150 217 6/14/2023
1.1.148 185 6/7/2023
1.1.146 228 5/31/2023
1.1.144 297 5/24/2023
1.1.142 189 5/17/2023
1.1.139 196 5/11/2023
1.1.137 197 5/5/2023
1.1.135 328 4/5/2023
1.1.133 260 3/29/2023
1.1.131 221 3/24/2023
1.1.128 259 3/17/2023
1.1.125 271 3/16/2023
1.1.123 269 3/13/2023
1.1.121 398 3/9/2023
1.1.119 428 2/27/2023
1.1.117 264 2/27/2023
1.1.115 261 2/22/2023
1.1.113 283 2/20/2023
1.1.111 261 2/16/2023
1.1.106 447 1/10/2023
1.1.104 300 1/9/2023
1.1.102 312 1/6/2023
1.1.100 313 1/6/2023
1.1.98 315 1/5/2023
1.1.96 490 12/29/2022
1.1.90 548 11/15/2022
1.1.88 371 11/14/2022
1.1.86 412 11/5/2022
1.1.84 369 11/5/2022
1.1.82 375 11/4/2022
1.1.80 356 11/3/2022
1.1.78 359 11/1/2022
1.1.76 399 10/27/2022
1.1.70 508 10/13/2022
1.1.68 414 10/12/2022
1.1.64 420 10/7/2022
1.1.62 389 10/7/2022
1.1.58 530 9/23/2022
1.1.55 836 9/23/2022
1.1.53 454 9/22/2022
1.1.47 414 9/21/2022
1.1.45 473 9/16/2022
1.1.42 462 9/15/2022
1.1.40 473 9/8/2022
1.1.38 413 9/7/2022
1.1.36 428 9/3/2022
1.1.34 470 8/15/2022
1.1.32 468 8/6/2022
1.1.30 671 8/5/2022
1.1.28 413 8/4/2022
1.1.26 439 8/3/2022
1.1.24 432 8/3/2022
1.1.22 448 8/2/2022
1.1.20 453 7/30/2022
1.1.18 463 7/26/2022
1.1.16 437 7/24/2022
1.1.14 429 7/23/2022
1.1.12 474 7/13/2022
1.1.7 611 7/7/2022
1.1.5 447 7/7/2022
1.1.3 459 7/6/2022
1.1.1 444 7/5/2022
1.0.107.13280 462 7/1/2022
1.0.105.49254 461 6/30/2022
1.0.102.851 448 6/28/2022
1.0.100.17145 439 6/28/2022
1.0.98.48733 488 6/28/2022
1.0.96.40373 481 6/26/2022
1.0.92.59206 454 6/24/2022
1.0.90.38187 473 6/16/2022
1.0.88.50207 462 6/15/2022
1.0.86.52668 430 6/14/2022
1.0.83.14512 481 6/13/2022
1.0.81.41619 483 6/8/2022
1.0.79.53990 480 6/3/2022
1.0.77.26764 442 6/3/2022
1.0.75.37268 443 6/1/2022
1.0.72.43325 457 5/31/2022
1.0.70.15497 452 5/31/2022
1.0.68.55953 464 5/31/2022
1.0.66.24331 452 5/27/2022
1.0.64.6330 444 5/26/2022
1.0.62.28047 472 5/26/2022
1.0.60.49583 467 5/25/2022
1.0.58.20063 453 5/24/2022
1.0.56.35800 473 5/23/2022
1.0.54.60782 470 5/20/2022
1.0.51.48271 471 5/12/2022
1.0.49.30985 535 5/6/2022
1.0.46 487 5/5/2022
1.0.42 503 4/26/2022
1.0.40 471 4/25/2022
1.0.38 479 4/24/2022
1.0.36 468 4/23/2022
1.0.34 487 4/22/2022
1.0.32 471 4/22/2022
1.0.30 465 4/21/2022
1.0.26 479 4/21/2022
1.0.24 466 4/20/2022
1.0.22 452 4/19/2022
1.0.20 470 4/18/2022
1.0.18 522 4/17/2022
1.0.16 467 4/16/2022
1.0.14 469 4/15/2022
1.0.12 497 4/13/2022
1.0.10 498 4/6/2022
1.0.8 488 4/4/2022
1.0.6 473 4/3/2022
1.0.4 473 3/31/2022
1.0.2 131 3/31/2022
1.0.1-preview.68 107 3/30/2022
1.0.1-preview.67 125 3/25/2022
1.0.1-preview.66 116 3/25/2022
1.0.1-preview.65 109 3/25/2022
1.0.1-preview.64 108 3/23/2022
1.0.1-preview.63 90 3/22/2022
1.0.1-preview.62 101 3/21/2022
1.0.1-preview.61 111 3/20/2022
1.0.1-preview.60 112 3/19/2022
1.0.1-preview.58 113 3/16/2022
1.0.1-preview.57 117 3/16/2022
1.0.1-preview.56 118 3/14/2022
1.0.1-preview.55 115 3/14/2022
1.0.1-preview.54 107 3/11/2022
1.0.1-preview.53 108 3/9/2022
1.0.1-preview.52 116 3/8/2022
1.0.1-preview.51 113 3/7/2022
1.0.1-preview.50 108 3/4/2022
1.0.1-preview.49 116 3/3/2022
1.0.1-preview.48 115 2/27/2022
1.0.1-preview.47 108 2/26/2022
1.0.1-preview.46 106 2/25/2022
1.0.1-preview.45 116 2/18/2022
1.0.1-preview.43 113 2/16/2022
1.0.1-preview.42 116 2/12/2022
1.0.1-preview.41 111 2/10/2022
1.0.1-preview.40 119 2/9/2022
1.0.1-preview.39 123 2/8/2022
1.0.1-preview.38 122 2/6/2022
1.0.1-preview.37 122 2/5/2022
1.0.1-preview.36 126 2/4/2022
1.0.1-preview.35 128 2/3/2022
1.0.1-preview.34 130 1/31/2022
1.0.1-preview.32 130 1/31/2022
1.0.1-preview.31 184 1/29/2022
1.0.1-preview.30 137 1/28/2022
1.0.1-preview.28 136 1/28/2022
1.0.1-preview.26 140 1/27/2022
1.0.1-preview.25 146 1/27/2022
1.0.1-preview.24 143 1/26/2022
1.0.1-preview.23 143 1/24/2022
1.0.1-preview.22 140 1/21/2022
1.0.1-preview.21 131 1/21/2022
1.0.1-preview.20 135 1/21/2022
1.0.1-preview.19 127 1/21/2022
1.0.1-preview.18 133 1/20/2022
1.0.1-preview.17 128 1/20/2022
1.0.1-preview.16 135 1/16/2022
1.0.1-preview.15 142 1/14/2022
1.0.1-preview.14 131 1/14/2022
1.0.1-preview.13 138 1/12/2022
1.0.1-preview.12 149 1/11/2022
1.0.1-preview.9 146 1/5/2022
1.0.1-preview.8 136 12/31/2021
1.0.1-preview.7 129 12/31/2021
1.0.1-preview.6 142 12/29/2021
1.0.1-preview.5 126 12/28/2021
1.0.1-preview.3 136 12/27/2021
1.0.0 375 12/23/2021
1.0.0-preview.99 138 12/23/2021
1.0.0-preview.98 138 12/23/2021
1.0.0-preview.94 179 11/12/2021
1.0.0-preview.91 166 11/9/2021
1.0.0-preview.88 170 11/9/2021