nanoFramework.Iot.Device.KeyMatrix 1.2.570

按键矩阵

M×N 按键矩阵驱动程序。

(M 是输出引脚数，N 是输入引脚数。)

文档

这些按键矩阵看起来像这样

这是一个 4x4 矩阵。 这里是原理图

理论上，您可以通过使用 M+N 个 GPIO 引脚来连接任何 MxN 按键矩阵。

您还可以使用任何兼容的 GPIO 控制器，如 Mcp23xxx，而不是原生控制器。

• 按键矩阵如何工作
• 4x4 键盘

用法

您需要创建两个整数列表，一个用于输入，一个用于输出。

int[] outputs = new int[] { 26, 19, 13, 6 };
int[] inputs = new int[] { 21, 20, 16, 12 };
KeyMatrix mk = new KeyMatrix(outputs, inputs, TimeSpan.FromMilliseconds(20));

您还可以在以下示例中使用任何 GpioController，例如 MCP23017

var settings = new System.Device.I2c.I2cConnectionSettings(1, 0x20);
var i2cDevice = System.Device.I2c.I2cDevice.Create(settings);
var mcp23017 = new Iot.Device.Mcp23xxx.Mcp23017(i2cDevice);
GpioController gpio = new GpioController(PinNumberingScheme.Logical, mcp23017);
int[] outputs = new int[] { 26, 19, 13, 6 };
int[] inputs = new int[] { 21, 20, 16, 12 };
KeyMatrix mk = new KeyMatrix(outputs, inputs, TimeSpan.FromMilliseconds(20), gpio, true);

读取按键

要读取按键，只需使用 ReadKey 函数

KeyMatrixEvent? key = mk.ReadKey();

KeyMatrixEvent 包含发生的事件。请注意，读取按键在被检测到事件之前是阻塞的。

基于事件的途径

KeyMatrix 支持“事件”。只需订阅事件并有一个处理事件的功能。

Debug.WriteLine("This will now start listening to events and display them for 60 seconds.");
mk.KeyEvent += KeyMatrixEventReceived;
mk.StartListeningKeyEvent();
Thread.Sleep(60000);

mk.StopListeningKeyEvent();

void KeyMatrixEventReceived(object sender, KeyMatrixEvent keyMatrixEvent)
{
    // Do something here, you have an event!
}

技巧和技巧

• 对于每个按钮使用二极管（例如 1N4148）可防止“鬼影”或“掩盖”问题。
• 如果您的微控制器（MCU）没有自带下拉电阻，输入引针需要接地连接收集电阻。例如，您需要在MCU上添加下拉电阻。
• 如果您的键盘矩阵工作不正常，请尝试交换输出和输入引脚。一些包含了二极管，如果用反方向使用将无法正常工作。

键盘矩阵样本

此图显示了如何连接矩阵。

重要：请务必在输入矩阵上放置下拉电阻。

使用板载GPIO进行连接

使用MCP23017进行连接