nanoFramework.Hardware.Esp32 1.6.19

欢迎使用 .NET nanoFramework nanoFramework.Hardware.Esp32 库仓库

构建状态

组件	构建状态	NuGet 包
nanoFramework.Hardware.Esp32

触控板基础

本节将为您提供有关如何在 ESP32 和 ESP32-S2 上使用触控板引脚的基本要素。

触控板与 GPIO 引脚

触控板引脚的编号与 GPIO 引脚不同。您可以使用以下方式检查哪些 GPIO 引脚对应于哪个 GPIO 引脚：

const int TouchPadNumber = 5;
var pinNum = TouchPad.GetGpioNumberFromTouchNumber(TouchPadNumber);
Console.WriteLine($"Pad {TouchPadNumber} is GPIO{pinNum}");

在 ESP32 和 S2 上，引脚编号不同。ESP32 上有 10 个有效的触控板（0 到 9），而在 S2 上有 13 个（1 到 13）。

在此示例中，触控板 5 在 ESP32 上将对应于 GPIO 12，而在 S2 上将对应于 GPIO 5。

ESP32 基本用法

在 ESP32 上，如果您触摸传感器，则值会变低，因此您必须设置一个低于校准数据的阈值

TouchPad touchpad = new(TouchPadNumber);
Console.WriteLine($"Calibrating touch pad {touchpad.TouchPadNumber}, DO NOT TOUCH it during the process.");
var calib = touchpad.GetCalibrationData();
Console.WriteLine($"calib: {calib} vs Calibration {touchpad.CalibrationData}");
// On ESP32: Setup a threshold, usually 2/3 or 80% is a good value.
touchpad.Threshold = (uint)(touchpad.CalibrationData * 2 / 3);
touchpad.ValueChanged += TouchpadValueChanged;

Thread.Sleep(Timeout.Infinite);

private static void TouchpadValueChanged(object sender, TouchPadEventArgs e)
{
    Console.WriteLine($"Touchpad {e.PadNumber} is {(e.Touched ? "touched" : "not touched")}");
}

S2 基本用法

在S2上，如果您触摸传感器，值将变高，因此您需要设置一个高于校准数据的阈值，并将其触发模式设置为如下

TouchPad touchpad = new(TouchPadNumber);
Console.WriteLine($"Calibrating touch pad {touchpad.TouchPadNumber}, DO NOT TOUCH it during the process.");
var calib = touchpad.GetCalibrationData();
Console.WriteLine($"calib: {calib} vs Calibration {touchpad.CalibrationData}");
// On S2/S3, the actual read values will be higher, so let's use 20% more
TouchPad.TouchTriggerMode = TouchTriggerMode.AboveThreshold;
touchpad.Threshold = (uint)(touchpad.CalibrationData * 1.2);

touchpad.ValueChanged += TouchpadValueChanged;

Thread.Sleep(Timeout.Infinite);

private static void TouchpadValueChanged(object sender, TouchPadEventArgs e)
{
    Console.WriteLine($"Touchpad {e.PadNumber} is {(e.Touched ? "touched" : "not touched")}");
}

其他功能

您还有许多其他功能可供选择，包括过滤器，一些特定去噪功能。您可以在样本仓库中查看更多详情。

睡眠模式

您可以通过触摸唤醒ESP32或ESP32-S2。

ESP32上的睡眠模式

ESP32可以通过1或2个触摸垫唤醒。以下是使用1个触摸垫的方式

Sleep.EnableWakeupByTouchPad(PadForSleep1, thresholdCoefficient: 80);

以及使用2个触摸垫的方式

Sleep.EnableWakeupByTouchPad(PadForSleep1, PadForSleep2);

请注意，系数可以通过进行几次测试来调整，默认值为80，似乎适用于所有情况。该系数表示一个百分比值。

S2上的睡眠模式

S2只能通过1个触摸垫唤醒。建议进行测试以找到最佳系数

Sleep.EnableWakeupByTouchPad(PadForSleep, thresholdCoefficient: 90);

从轻睡眠模式唤醒UART

您可以使用UART唤醒任何受支持的nanoFramework ESP32的轻睡眠模式。以下是一些需要注意的元素

• 必须正确设置您的串行端口号，以下为COM2

  nanoFramework.Hardware.Esp32.Configuration.SetPinFunction(19, nanoFramework.Hardware.Esp32.DeviceFunction.COM2_TX);
  nanoFramework.Hardware.Esp32.Configuration.SetPinFunction(21, nanoFramework.Hardware.Esp32.DeviceFunction.COM2_RX);
  

• 支持COM1和COM2。请注意，默认情况下COM1用于调试。除非您已构建自己的版本，否则您可能不必将其用作常规UART。但是，您可以肯定地将其用于唤醒您的板子。在这种情况下，引脚是默认的，并且不需要执行前面的步骤。

• 为了唤醒板子，您需要设置一个阈值，指定接收引脚（UART的接收引脚）中必须有多少变化。根据文档，您将会丢失一些字符。因此，发送方应在协议中考虑到这一点。

使用方法简单直接

EnableWakeupByUart(WakeUpPort.COM2, 5);
StartLightSleep();

脉冲计数器

脉冲计数器允许在不设置GPIO控制器和事件的情况下计数脉冲。这是在特定时间内获取计数的快速方法。此脉冲计数器还允许使用2个不同的引脚，并根据各自的极性获取脉冲计数值。

单引脚脉冲计数器

以下代码演示了如何设置一个单引脚的计数器

Gpio​PulseCounter counter = new Gpio​PulseCounter(26);
counter.Polarity = GpioPulsePolarity.Rising;
counter.FilterPulses = 0;

counter.Start();
int inc = 0;
GpioPulseCount counterCount;
while (inc++ < 100)
{
    counterCount = counter.Read();
    Console.WriteLine($"{counterCount.RelativeTime}: {counterCount.Count}");
    Thread.Sleep(1000);
}

counter.Stop();
counter.Dispose();

计数器始终是正数且递增的。您可以通过调用《code>Reset函数将计数重置为0

GpioPulseCount pulses = counter.Reset();
// pulses.Count contains the actual count, it is then put to 0 once the function is called

双引脚脉冲计数器

这通常是旋转编码器场景。在这种情况下，您需要2个引脚，并且它们的作用如下所示:

然后您可以使用连接到2个引脚的旋转编码器

相关的代码与单引脚相同，除了在构造函数中

Gpio​PulseCounter encoder = new Gpio​PulseCounter(12, 14);
encoder.Start();
int incEncod = 0;
GpioPulseCount counterCountEncode;
while (incEncod++ < 100)
{
    counterCountEncode = encoder.Read();
    Console.WriteLine($"{counterCountEncode.RelativeTime}: {counterCountEncode.Count}");
    Thread.Sleep(1000);
}

encoder.Stop();
encoder.Dispose();

结果，您将得到正脉冲和负脉冲

反馈与文档

有关文档，提供反馈、问题以及了解如何贡献，请参阅主仓库。

加入我们的Discord社区 这里。

致谢

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

许可协议

nanoFramework类库是按照MIT许可证授权的。

行为准则

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

.NET基金会

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