nanoFramework.Iot.Device.Mpr121 1.2.570

Prefix Reserved
dotnet add package nanoFramework.Iot.Device.Mpr121 --version 1.2.570                
NuGet\Install-Package nanoFramework.Iot.Device.Mpr121 -Version 1.2.570                
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.Mpr121" Version="1.2.570" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.Iot.Device.Mpr121 --version 1.2.570                
#r "nuget: nanoFramework.Iot.Device.Mpr121, 1.2.570"                
#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.
// Install nanoFramework.Iot.Device.Mpr121 as a Cake Addin
#addin nuget:?package=nanoFramework.Iot.Device.Mpr121&version=1.2.570

// Install nanoFramework.Iot.Device.Mpr121 as a Cake Tool
#tool nuget:?package=nanoFramework.Iot.Device.Mpr121&version=1.2.570                

MPR121 - Proximity Capacitive Touch Sensor Controller

The 12-channels I2C proximity capacitive touch sensor controller.

Documentation

Usage

Important: make sure you properly setup the I2C pins especially for ESP32 before creating the I2cDevice, make sure you install the nanoFramework.Hardware.ESP32 nuget:

//////////////////////////////////////////////////////////////////////
// when connecting to an ESP32 device, need to configure the I2C GPIOs
// used for the bus
Configuration.SetPinFunction(21, DeviceFunction.I2C1_DATA);
Configuration.SetPinFunction(22, DeviceFunction.I2C1_CLOCK);

For other devices like STM32, please make sure you're using the preset pins for the I2C bus you want to use.

Default configuration with manually updating of channel statuses

var i2cDevice = I2cDevice.Create(new I2cConnectionSettings(busId: 1, deviceAddress: Mpr121.DefaultI2cAddress));
var mpr121 = new Mpr121(device: i2cDevice);

var statuses = mpr121.ReadChannelStatuses();
var status = statuses[Channels.Channel01]
    ? "pressed"
    : "released";

Debug.WriteLine($"The 1st channel is {status}");

Channel statuses auto refresh

var i2cDevice = I2cDevice.Create(new I2cConnectionSettings(busId: 1, deviceAddress: Mpr121.DefaultI2cAddress));

// Initialize controller with default configuration and auto-refresh the channel statuses every 100 ms.
var mpr121 = new Mpr121(device: i2cDevice, periodRefresh: 100);

// Subscribe to channel statuses updates.
mpr121.ChannelStatusesChanged += (object sender, ChannelStatusesChangedEventArgs e) =>
    {
        var channelStatuses = e.ChannelStatuses;
        // do something.
    };

Custom MPR121 registers configuration

var i2cDevice = I2cDevice.Create(new I2cConnectionSettings(busId: 1, deviceAddress: Mpr121.DefaultI2cAddress));
var config = new Mpr121Configuration
{
    MaxHalfDeltaRising = 0x01,
    NoiseHalfDeltaRising = 0x01,
    NoiseCountLimitRising = 0x00,
    FilterDelayCountLimitRising = 0x00,
    MaxHalfDeltaFalling = 0x01,
    NoiseHalfDeltaFalling = 0x01,
    NoiseCountLimitFalling = 0xFF,
    FilterDelayCountLimitFalling = 0x01,
    ElectrodeTouchThreshold = 0x0F,
    ElectrodeReleaseThreshold = 0x0A,
    ChargeDischargeTimeConfiguration = 0x04,
    ElectrodeConfiguration = 0x0C
};

var mpr121 = new Mpr121(device: i2cDevice, configuration: config);

This sample demonstrates how to read channel statuses using auto-refresh configuration.

Handling the channel statuses changes

mpr121.ChannelStatusesChanged += (object sender, ChannelStatusesChangedEventArgs e) =>
    {
        var channelStatuses = e.ChannelStatuses;
        // do something.
    };

Binding Notes

The binding provides different options of device configuration. The device can be configured to update the channel statuses periodically. Also it supports custom configuration of controller registers.

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.570 70 6/14/2024
1.2.436 236 11/10/2023
1.2.416 104 11/8/2023
1.2.329 151 5/26/2023
1.2.313 126 5/12/2023
1.2.297 137 5/3/2023
1.2.212 287 1/5/2023
1.2.203 290 12/28/2022
1.2.159 345 11/14/2022
1.2.153 358 11/5/2022
1.2.141 392 10/25/2022
1.2.87 459 9/15/2022
1.2.82 454 9/14/2022
1.1.116.8772 421 6/24/2022
1.1.113.2032 425 6/23/2022
1.1.97.17326 428 6/13/2022
1.1.92.53000 420 6/8/2022
1.1.3 459 4/15/2022
1.1.1 422 4/14/2022
1.0.300 425 3/31/2022
1.0.288-preview.114 119 3/25/2022
1.0.288-preview.113 112 3/25/2022
1.0.288-preview.104 103 3/22/2022
1.0.288-preview.100 107 3/19/2022
1.0.288-preview.98 120 3/18/2022
1.0.288-preview.93 110 3/15/2022
1.0.288-preview.87 107 3/10/2022
1.0.288-preview.65 114 2/18/2022
1.0.288-preview.29 126 1/28/2022
1.0.288-preview.20 129 1/27/2022
1.0.288-preview.1 120 1/21/2022
1.0.259 322 12/9/2021
1.0.155 320 8/31/2021
1.0.136 388 7/17/2021
1.0.134 161 7/15/2021
1.0.133 181 7/14/2021
1.0.132 180 7/8/2021
1.0.130 153 7/6/2021
1.0.129 157 7/6/2021
1.0.125 188 7/5/2021
1.0.121 193 6/29/2021
1.0.119 214 6/28/2021
1.0.105 278 5/29/2021
1.0.54 210 5/25/2021