nanoFramework.AtomMatrix 1.1.232

---

欢迎使用 .NET nanoFramework M5Stack 库仓储

构建状态

组件	构建状态	NuGet 包
nanoFramework.M5Core
nanoFramework.M5Stick
nanoFramework.M5StickCPlus
nanoFramework.M5Core2
nanoFramework.Fire
nanoFramework.AtomLite
nanoFramework.AtomMatrix
nanoFramework.Tough

用法

这些 NuGet 包为 M5Stack 产品提供支持

• 核心（灰色）和基础
• M5StickC
• M5StickCPlus
• M5Core2
• Fire
• Atom Lite
• Atom Matrix
• Tough

注意 1：在尝试将 NuGet 包添加到您的项目和/或在使用下一个部分中说明的设备上烧录之前（使用 MS Visual Studio [VS]），请打开 VS > 工具 > 选项 > NuGet 包管理器 > 包源，并确保其中包含一个指向 https://api.nuget.org/v3/index.json 的条目；如果没有，请添加。注意 2：在调用 VS > 项目 > 管理NuGet包时，请确保在包源下拉菜单（右上角）中选中 "nuget.org"。

这些NuGet包也支持屏幕，并且需要用正确的图像进行烧录（使用nanoff dotnet CLI）。下面示例中，将COM3替换成你设备连接的COM端口号（在Windows设备管理器中可以查看这个端口号）。

针对M5Core

nanoff --target M5Core --update --serialport COM3

针对M5StickC

nanoff --target M5StickC --update --serialport COM3 --baud 115200

针对M5StickCPlus

nanoff --target M5StickCPlus --update --serialport COM3

针对M5Core2、Tough和Fire

nanoff --target M5Core2 --update --serialport COM3

针对Atom Lite和Matrix

nanoff --target ESP32_PICO --update --serialport COM3

备注3：如果nanoff命令失败，请确保你已经遵循了上面第1个备注的说明。

一旦你有了NuGet包，你就可以享受访问屏幕、加速度计、接入Grove I2C接口、在按钮上添加事件的乐趣。你甚至不必费心思考，所有的事情都以最透明的方式为你完成！

备注4：所有你可以访问的类都使用懒汉模式进行实例化，包括屏幕。这优点是尽可能少使用内存和提高设置时间。

以下示例我们将使用M5Core或M5Stick作为例子，它们都按非常相似的方式工作。

命名空间

请确保你在C#程序头中添加适当的命名空间引用，例如：using nanoFramework;

屏幕

要访问屏幕，你只需要进行初始化（请注意InitializeScreen()是针对特定目标的）例如：

对于Core

M5Core.InitializeScreen();

对于StickCPlus

M5StickCPlus.InitializeScreen();

一旦你初始化了它，你可以访问Screen静态类和Console静态类。

Screen类提供了直接在屏幕点或块上写入基本图形的功能，以及写入文本。

例如，你可以这样在0,0位置写一个10x10的蓝色方块：

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);

Console类与经典System.Console工作方式类似。为了使用它，你必须使用方法的全限定名进行引用，如下所示

nanoFramework.Console.Clear();

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

备注：你还可以更改默认字体，你需要将其作为属性提供。光标位置是用最大的字符计算的。

M5Core2和Fire拥有PSRAM，因此你可以获得完整的屏幕缓存。请参考图形示例了解你能用它做什么。

如果你对任何M5Stack有大量的图形需求，你可以调整请求的内存。虽然M5Core2和Fire都有PSRAM，可以容纳非常大的容量，比如2Mb或更多，但那些没有PSRAM的不可能超过几个Kb或几十Kb。

// This will allocate 2 Mb of memory for the graphics
M5Core2.InitializeScreen(2 * 1024 * 1024);

按钮

除了电源按钮之外的主要按钮都是公开的。

在M5Stack和Fire中，它们称为ButtonLeft、ButtonCenter和ButtonRight。你还可以获取访问事件。例如

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

在M5StickC/CPlus中，它们称为ButtonM5和ButtonRight。你可以获取访问按钮的状态、事件以及所有你需要的东西。例如

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

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

在Atom Lite/Matrix中，它被称为Button。你可以获取访问按钮的状态、事件以及所有你需要的东西。例如

AtomLite.Button.Press +=> (sender, e)
{
    var color = AtomLite.NeoPixel.GetColor();
    if(color.R > 0)
    {
        AtomLite.NeoPixel.SetColor(Color.FromArgb(255, 0, 255, 0));
    }
    else if (color.G > 0)
    {
        AtomLite.NeoPixel.SetColor(Color.FromArgb(255, 0, 0, 255));
    }
    else
    {
        AtomLite.NeoPixel.SetColor(Color.FromArgb(255, 255, 0, 0));
    }
};

备注：M5Core2具有触摸屏幕，按钮是“虚拟”的。查看下一节了解如何使用它们。

M5Core2触摸屏和按钮

触摸屏与屏幕一起提供。它们同时初始化和激活。要获取触摸事件，你需要注册到TouchEvent事件

M5Core2.InitializeScreen();
M5Core2.TouchEvent += TouchEventCallback;

以下是如何检查你是否在按钮上以及获取各种元素的示例

void TouchEventCallback(object sender, TouchEventArgs e)
{
    const string StrLB = "LEFT BUTTON PRESSED  ";
    const string StrMB = "MIDDLE BUTTON PRESSED  ";
    const string StrRB = "RIGHT BUTTON PRESSED  ";
    const string StrXY1 = "TOUCHED at X= ";
    const string StrXY2 = ",Y= ";
    const string StrID = ",Id= ";
    const string StrDoubleTouch = "Double touch. ";
    const string StrMove = "Moving... ";
    const string StrLiftUp = "Lift up. ";

    Debug.WriteLine($"Touch Panel Event Received Category= {e.EventCategory} Subcategory= {e.TouchEventCategory}");
    Console.CursorLeft = 0;
    Console.CursorTop = 0;

    Debug.WriteLine(StrXY1 + e.X + StrXY2 + e.Y + StrID + e.Id);
    Console.WriteLine(StrXY1 + e.X + StrXY2 + e.Y + StrID + e.Id + "  ");

    if ((e.TouchEventCategory & TouchEventCategory.LeftButton) == TouchEventCategory.LeftButton)
    {
        Debug.WriteLine(StrLB);
        Console.WriteLine(StrLB);
    }
    else if ((e.TouchEventCategory & TouchEventCategory.MiddleButton) == TouchEventCategory.MiddleButton)
    {
        Debug.WriteLine(StrMB);
        Console.WriteLine(StrMB);
    }
    else if ((e.TouchEventCategory & TouchEventCategory.RightButton) == TouchEventCategory.RightButton)
    {
        Debug.WriteLine(StrRB);
        Console.WriteLine(StrRB);
    }

    if ((e.TouchEventCategory & TouchEventCategory.Moving) == TouchEventCategory.Moving)
    {
        Debug.WriteLine(StrMove);
        Console.Write(StrMove);
    }

    if ((e.TouchEventCategory & TouchEventCategory.LiftUp) == TouchEventCategory.LiftUp)
    {
        Debug.WriteLine(StrLiftUp);
        Console.Write(StrLiftUp);
    }

    if ((e.TouchEventCategory & TouchEventCategory.DoubleTouch) == TouchEventCategory.DoubleTouch)
    {
        Debug.WriteLine(StrDoubleTouch);
        Console.Write(StrDoubleTouch);
    }

    Console.WriteLine("                                    ");
    Console.WriteLine("                                    ");
    Console.WriteLine("                                    ");
}

TouchEventCategory 枚举是一个标志，可以组合按钮和状态。按钮是互斥的，因此您只能有左、中或右按钮，状态有 Moving 和 LiftUp。当接触已经发生且触摸点正在移动时，会发生 Moving。当接触释放时将出现 LiftUp。

DoubleTouch 是一个专用标识，告知您存在另一个接触点。每个接触点都将接收此标志。事件将被触发两次，每个点一次。在双触控情况下，您可能无法获得第二个点的 LiftUp 事件，但您将获得 DoubleTouch 标志的消失和第一个点的最终 LiftUp 的变化。

电源管理

M5Core 和 M5StickC/CPlus 暴露了它们的电源管理元素。除非您知道自己在做什么，否则不建议更改任何默认值。

请参考 M5StickC/CPlus 中使用的 AXP192 的详细示例；M5Core2 和 IP5306 用于 M5Core 和 Fire。

加速度计和陀螺仪

您可以通过以下方式访问加速度计和陀螺仪：

var ag = M5Core.AccelerometerGyroscope;
// Do not move the M5Core/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");

有关此传感器的更多详细使用信息，请参阅 MPU6886 文档。

磁力计

M5Core 有一个磁力计，您也可以访问它。

var mag = M5Core.Magnetometer;
// It is more than strongly recommended to calibrate the magnetometer.
// Move the M5Core 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}  ");

串口

M5Core 和 M5Core2 可以提供串口，只需这样获取即可：

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

有关更多信息，请参阅 SerialPort 文档。

ADC 通道

在 M5Core、M5Core2、Fire 和 Atom Lite/Matrix 上预先设置了 ADC 通道，可以这样访问它们：

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

请参阅 M5Stack 文档以获取 ADC 通道和引脚的映射。

I2C 设备/Grove

您可以通过以下方式获取 I2cDevice/Grove：

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

SPI 设备

M5Core、M5Core2、Fire 和 Atom Lite/Matrix 也提供 SpiDevice。

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

GPIO 控制器

与之前类似，您可以在 M5Core、M5Core2、Fire 和 M5StickC/CPlus 中的任何设备上获取 GpioController。

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

DAC

M5Core、M5Core2、Fire 和 Atom Lite/Matrix 暴露了 2 个 DAC，您可以通过 Dac1 和 Dac2 属性来访问它们。有关更多信息，请参阅 DAC 文档。

I2S（声音）

在 M5Core2 上，可以通过安装 nanoFramework.System.Device.I2s 包来使用 I2S 播放 wav 文件。要在 M5Core2 上播放 wav 文件，请使用以下初始化：

int bckPin = 12;
int dataPin = 2;
int wsPin = 0;
I2sWavPlayer.Bus bus = I2sWavPlayer.Bus.One;
var audioFile = "D:\\Variation-CLJ013901.wav";
using (var player = new I2sWavPlayer(bus, audioFile, bckPin, dataPin, wsPin))
{
    M5Core2.Power.Gpio2Value = PinValue.High; //speaker power on
    player.Play();
    M5Core2.Power.Gpio2Value = PinValue.Low; //speaker power off
}

LED

M5StickC/CPlus 暴露了一个 LED。您可以通过 Led 属性来访问它。

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

红外 LED

M5StickC/CPlus 和 Atom Lite/Matrix 暴露了一个红外 LED。您可以通过 InfraredLed 属性来访问它。这将为您提供 TransmitterChannel。请查看 示例包 以了解如何使用它。

AtomLite 上的 NeoPixel

Atom Lite 暴露了一个 rgb LED。您可以通过 NeoPixel 属性来访问它。

// This will set NeoPixel to green:
AtomLite.NeoPixel.Image.SetPixel(0, 0, Color.Green);
AtomLite.NeoPixel.Update();

AtomMatrix 上的 RGB LED 矩阵和 Fire 上的 LED 条

Atom Matrix 有一个 25 个 RGB LED 的矩阵。数组中 LED 的位置按照矩阵中的放置位置进行排列，0 表示位于左上角的 LED，向左到右，向上到下增长。

您可以通过 AtomMatrix 上的 LedMatrix 属性来访问它，如下所示：

// This will set the RGB LED at position 2, 2 to green
AtomMatrix.LedMatrix.Image.SetPixel(2, 2, Color.Green);

类似地，您可以在 Fire 上通过 LedBar 属性访问它。

// This will set the second RGB LED to green
Fire.LedBar.Image.SetPixel(2, 0, Color.Green);

在更新了所有想要更改的 LED 之后，将更新刷新到 LED 上，如下所示：

// This will update all RGB LED 
AtomMatrix.LedMatrix.Update();

在 Fire 上：

// This will update all RGB LED 
Fire.LedBar.Update();

SD卡

M5Core、M5Core2、Fire和Tough都具有SD卡读卡器。您可以直接访问它，如下所示：

SDCard sdCard = M5Core.SDCard;
try
{
    // This will actually mount the SD Card, if no card, you will get an exception
    sdCard.Mount();
    // Mounting properly a card can take a bit of time, so wait for the card to be mounted
    // Note: it is recommended to use a cancellation token or equivalent to make sure you are not in a dead loop
    while (!sdCard.IsMounted)
    {
        Thread.Sleep(10);
    }

    // You can now access the files on the SD Card
    // As an example you can read a json file and deserialize it
    // D: is the drive from the SD Card
    const string ParamFile = "D:\\params.json";
    using FileStream fs = new FileStream(ParamFile, FileMode.Open, FileAccess.Read);
    // In this case, you will need to have a class called Configuration and a properly serialized file
    Configuration config = (Configuration)JsonConvert.DeserializeObject(fs, typeof(Configuration));
}
catch
{
    // Something wrong happened
}

有关如何使用文件系统的更多示例，请参阅这里。

反馈和文档

有关文档编写、提供反馈、报告问题以及了解如何贡献，请参阅Home存储库。

加入我们的Discord社区这里。

致谢

关于此项目的贡献者名单可在CONTRIBUTORS中找到。

许可证

nanoFramework类库采用MIT许可证。

行为准则

此项目采用了贡献者公约中定义的行为准则，以阐明我们社区中期望的行为。欲获取更多信息，请参阅.NET Foundation行为准则。

.NET Foundation

本项⽬由.NET Foundation支持。