nanoFramework.Iot.Device.KeyMatrix 1.2.864

Prefix Reserved
dotnet add package nanoFramework.Iot.Device.KeyMatrix --version 1.2.864
                    
NuGet\Install-Package nanoFramework.Iot.Device.KeyMatrix -Version 1.2.864
                    
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.Iot.Device.KeyMatrix" Version="1.2.864" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="nanoFramework.Iot.Device.KeyMatrix" Version="1.2.864" />
                    
Directory.Packages.props
<PackageReference Include="nanoFramework.Iot.Device.KeyMatrix" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add nanoFramework.Iot.Device.KeyMatrix --version 1.2.864
                    
#r "nuget: nanoFramework.Iot.Device.KeyMatrix, 1.2.864"
                    
#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.
#addin nuget:?package=nanoFramework.Iot.Device.KeyMatrix&version=1.2.864
                    
Install as a Cake Addin
#tool nuget:?package=nanoFramework.Iot.Device.KeyMatrix&version=1.2.864
                    
Install as a Cake Tool

Key Matrix

An M×N key matrix driver.

(M is number of output pins and N is number of input pins.)

Documentation

These key matrices look like this:

4x4-Keypad

This is a 4×4 matrix. And here is the schematic

You can connect any M×N key matrix, theoretically, by using M+N GPIO pins.

You can also use any compatible GPIO controller like Mcp23xxx instead of native controller.

Usage

You need to create 2 lists of int, one for the input and one for the output.

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

You can use as well any GpioController like the MCP23017 in the following example

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

Read on Key

To read a key, just the ReadKey function:

KeyMatrixEvent? key = mk.ReadKey();

KeyMatrixEvent contains the event that happened. Please note that ReadKey is blocked up to the moment an event is detected.

Event based approach

KeyMatrix supports events. Just subscribe to the event and have a function to handle the events:

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!
}

Tips and tricks

  • Using diodes(eg. 1N4148) for each button prevents "ghosting" or "masking" problem.
  • Input pins need pull-down resistors connect to ground if your MCU doesn't have it. So you need to have a pull-down on a the MCU for example.
  • If your key matrix doesn't work well, try to swap output and input pins. Some includes diodes and if they are used the reverse way won't work properly.

Key Matrix Samples

This shows how to connect the matrix.

Important: Please make you don't forget to place a pull down on the input matrix.

Connection using on-board GPIO

Connection using MCU

Connection using MCP23017

Connection using a MCP23017

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

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.2.864 183 4/2/2025
1.2.852 208 3/11/2025
1.2.822 136 2/26/2025
1.2.772 139 2/4/2025
1.2.755 144 1/31/2025
1.2.737 116 1/13/2025
1.2.696 131 12/16/2024
1.2.673 139 10/23/2024
1.2.631 133 8/28/2024
1.2.570 153 6/14/2024
1.2.560 150 5/29/2024
1.2.548 128 5/15/2024
1.2.436 258 11/10/2023
1.2.329 213 5/26/2023
1.2.313 172 5/12/2023
1.2.297 199 5/3/2023
1.2.203 365 12/28/2022
1.2.141 436 10/25/2022
1.2.122 489 10/12/2022
1.2.114 426 10/8/2022
1.2.95 443 9/22/2022
1.2.87 504 9/15/2022
1.2.73 459 9/8/2022
1.1.113.2032 459 6/23/2022
1.1.58.10097 490 5/23/2022
1.1.1 511 4/14/2022
1.0.300 458 3/31/2022
1.0.277-preview.125 174 3/25/2022
1.0.277-preview.110 172 3/18/2022
1.0.277-preview.105 177 3/15/2022
1.0.277-preview.98 179 3/8/2022
1.0.277-preview.77 174 2/18/2022
1.0.277-preview.41 190 1/28/2022
1.0.277-preview.32 193 1/27/2022
1.0.277-preview.17 194 1/24/2022
1.0.277-preview.15 179 1/21/2022
1.0.277-preview.13 186 1/21/2022
1.0.277-preview.1 187 1/11/2022
1.0.259 362 12/9/2021
1.0.218 260 10/18/2021
1.0.155 362 8/31/2021
1.0.135 354 7/16/2021
1.0.134 235 7/15/2021
1.0.133 255 7/14/2021
1.0.129 224 7/6/2021
1.0.125 254 7/5/2021
1.0.121 265 6/29/2021
1.0.119 286 6/28/2021
1.0.33 233 5/24/2021