nanoFramework.MagicBit 1.2.150

欢迎使用 .NET nanoFramework MagicBit 库存储库

构建状态

组件	构建状态	NuGet 包
MagicBit

用法

此 nuget 可与出色的 MagicBit 板一起使用。

它几乎支持所有传感器和机器人元件。然而，其中一些不是本地的，因为它们是现有 IoT.Device 绑定 的一部分。请参见已知的限制。

您只需确保您的 MagicBit 已按照以下方式刷机

# Replace the com port number by your COM port
nanoff --platform esp32 --update --preview --serialport COM3

更详细的示例也可见于测试应用程序中。

屏幕

要访问屏幕，您需要初始化它。

MagicBit.InitializeScreen();

初始化后，您可以访问 Screen 静态类和 Console 静态类。

Screen 带来写入屏幕点的原语、选择颜色以及写入文本。

例如，您可以将一个8x8的缓冲区方框写入位置0, 26，宽度为8，如下所示

byte[] _heart = new byte[] {
            0b0100_0010,
            0b0110_0110,
            0b1111_1111,
            0b1111_1111,
            0b1111_1111,
            0b0011_1100,
            0b0011_1100,
            0b0001_1000,
        };
Screen.DrawBitmap(0, 26, 8, _heart);

请注意，宽度只能是8的倍数，缓冲区应为宽度/8的倍数。每个比特代表一个像素。这是展示图像的方式。

屏幕还提供其他基本函数，下面是一个快速示例

// You can use the Screen primitives like this:
Screen.Clear();
Screen.Write(2, 0, "MagicBit", 2);
Screen.Write(2, 26, "loves .NET", 1, true);
Screen.Write(2, 40, "nanoFramework", 1, true);
Screen.Write(2, 50, "Clk right button", 1, false);
Screen.DrawBitmap(0, 26, 8, _heart);
Screen.DrawBitmap(Screen.Width - 9, 26, 8, _heart);
// You should make sure that you call Display
Screen.Display();

通过 Screen.Device，您还将获得更多。

Console类与经典 System.Console 类工作方式相似

Console.Clear();
Console.WriteLine("Motors");
Console.CursorTop = 2;
Console.WriteLine("Motors will run reverse then rotate both direction");

注意：您也可以更改默认字体，您需要将其作为属性提供。光标位置是根据字体的宽度计算的。

按钮

提供了2个按钮。

它们分别命名为 ButtonLeft 和 ButtonRight。您还可以访问事件。例如

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

// Simple way of getting the button status
while (!MagicBit.ButtonRight.IsPressed)
{
    Thread.Sleep(20);
}

另一个使用事件的示例

MagicBit.ButtonRight.IsHoldingEnabled = true;
MagicBit.ButtonRight.Holding += (sender, e) =>
{
    Console.Write("ButtonRight hold long.");
};

电机

MagicBit有一个驱动程序，可以控制2个直流电机。如果您有机器人套件，您将能够控制它们。如果您没有机器人套件，您仍然可以自己使用，只要将它们插入正确的引脚即可。

Console.Clear();
Console.WriteLine("Motors");
Console.CursorTop = 2;
Console.WriteLine("Motors will run reverse then rotate both direction");
var motor1 = MagicBit.Motor1;
var motor2 = MagicBit.Motor2;
motor1.Speed = -0.5;
motor2.Speed = -0.5;
Thread.Sleep(2000);
motor1.Speed = +0.5;
motor2.Speed = -0.5;
Thread.Sleep(2000);
motor1.Speed = -0.5;
motor2.Speed = +0.5;
Thread.Sleep(2000);
motor1.Speed = 0;
motor2.Speed = 0;

蜂鸣器

当然，可以使用蜂鸣器。以下是一个播放音调的示例

var buzz = MagicBit.Buzzer;
for (int i = 0; i < 10; i++)
{
    buzz.PlayTone(500 + i * 25, 1000);
}

电位器和光度

这两个内置传感器可以直接访问和使用。以下是一个完整示例，读取它们，在屏幕上显示值，并在按下左边按钮时中断它们

CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
MagicBit.ButtonLeft.Press += (sender, e) =>
{
    cancellationTokenSource.Cancel();
};

Console.Clear();
Console.WriteLine("Sensors");
Console.CursorTop = 2;
Console.WriteLine("Clk left button to stop");

while (!cancellationTokenSource.Token.IsCancellationRequested)
{
    // Read the potentiometer ratio, from 0.0 to 1.0
    var ratio = MagicBit.Potentiometer.ReadRatio();
    // Read the luminosity sensor ratio from 0.0 (full dark) to 1.0 (full light)
    var lumi = MagicBit.Luminosity.ReadRatio();
    Console.CursorTop = 4;
    Console.CursorLeft = 0;
    Console.WriteLine($"Pot: {ratio * 100:N2}%  ");
    Console.CursorTop = 5;
    Console.CursorLeft = 0;
    Console.WriteLine($"lum: {lumi * 100:N2}%  ");
    cancellationTokenSource.Token.WaitHandle.WaitOne(200, true);
}

伺服电机

可以连接伺服电机。到目前为止，您在蓝色引脚上有直接简单的方法。本完整示例显示了如何将角度从0度改为180度，显示下一个角度并等待按下左边按钮以停止

CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
MagicBit.ButtonLeft.Press += (sender, e) =>
{
    cancellationTokenSource.Cancel();
};

Console.Clear();
Console.WriteLine("Servo");
Console.CursorTop = 2;
Console.WriteLine("Clk left button to stop");

// The servo can be different and you can adjust the values as needed
var servo = MagicBit.GetServoPinBlue(180, 500, 2400);
// This is needed to start the servo
servo.Start();
int angle = 0;
while (!cancellationTokenSource.Token.IsCancellationRequested)
{
    servo.WriteAngle(angle);
    angle = angle == 0 ? 180 : 0;
    Console.CursorTop = 4;
    Console.CursorLeft = 0;
    Console.WriteLine($"Angle: {angle}deg  ");
    cancellationTokenSource.Token.WaitHandle.WaitOne(3000, true);
}

// Don't forget to stop it at the end.
servo.Stop();

注意：技术上可以使用任何可用的引脚来插入伺服电机。如果使用蓝色引脚，板包将使您的生活更轻松。否则，您将不得不自己设置伺服电机。

LED灯

有4个内置LED灯可用。

MagicBit.LedBlue.Write(PinValue.High);

重要：您不能将它们与电机一起使用，因为它们使用相同的引脚。

I2C设备

默认情况下，您可以通过红色引脚获取I2C设备。您可以使用 GetRed 或 GetI2cDevice。例如，如果您想创建地址为0x42的I2C设备，只需这样做

var myI2cDevice = MagicBit.GetI2cDevice(0x42);

黑色左边和右边引脚

您可以获取GPIO引脚，这是一个您可以从中直接使用单个输出或输入的引脚。 GetPinBlackLeft 和 GetPinBlackRight 都会为您提供

// This will create an output mode pint, you can for example attach a led
var myPin = MagicBit.GetPinBlackLeft(PinMode.Output);
// This will change the pin to high
myPin.Write(PinValue.High);

蓝色引脚

蓝色引脚默认设置为PWM。在获取时，您将获得一个PWM通道

var myPwm = MagicBit.GetPinBlue();

更改默认引脚行为

这是一个更高级的场景，但您可以在未使用默认功能之前更改任何引脚的功能。例如，您可以从黑色左边引脚创建PWM通道

Configuration.SetPinFunction(32, DeviceFunction.PWM11);
var myBlackPwm = PwmChannel.CreateFromPin(32);

即使蓝色引脚的默认行为是PWM，如果您不请求它，您也可以以不同的方式使用它。例如，用作简单的输入

var myBluePin = MagicBit.GpioController.Open(26, PinMode.Input);

已知限制

有几个传感器将无法工作，请参阅以下列表、原因和可能的缓解措施。

• DHT传感器在ESP32 .NET托管代码中尚不支持。您可以使用其他支持的温度和湿度传感器。 请参考这里。
• 机器人上的HCSR04尚不支持，因为它使用相同的引脚用于信号的发射和接收。这是正在进行中的工作，以找到解决方案。单独出售的，当与红色端口一起使用时，将完美工作。
• QRT传感器组尚未支持，这是正在进行中的工作。同时，您可以将它们作为模拟传感器单独读取。

反馈和文档

有关文档、提供反馈、问题以及了解如何贡献的信息，请参考 Home仓库。

加入我们的 Discord 社区 这里。

致谢

此项目的贡献者名单可以在 贡献者 页面找到。

许可协议

nanoFramework 类库采用 MIT 许可协议 许可。

行为准则

本项目采纳了贡献者公约定义的行为准则，以阐明我们社区中预期的行为。更多信息请参阅 .NET 基金会行为准则。

.NET 基金会

本项目由 .NET 基金会 支持。