`EVNTouchArray`#

This class provides the following features and functionalities for our Capacitive Touch Array Standard Peripheral (MPR121 IC):

12 Capacitive Touch Buttons (3*4 array)

Configurable Touch and Release Thresholds

Note

This class does I2C port selection automatically, so users do not need to call setPort() using their EVNAlpha objects.

Wiring (I2C)#

class EVNTouchArray(uint8_t port, uint8_t touch_threshold = 12, uint8_t release_threshold = 6)#

Parameters

port – I2C port the sensor is connected to (1-16)
touch_threshold – Threshold for a button press to be registered (0-255)
release_threshold – Threshold for a button released to be registered (0-255)

bool begin()

Initializes capacitive touch array. Call this function before using the other functions.

Returns: Boolean indicating whether the array was successfully initialized. If false is returned, all other functions will return 0.

void setThresholds(uint8_t channel, uint8_t touch_threshold, uint8_t release_threshold)

Set touch and release thresholds for the given channel.

Lowering the touch threshold increases the sensitivity of the touch array to button presses.

Conversely, lowering the release threshold lowers the sensitivity to button releases.

Parameters

channel – Channel to calibrate (0-11)
touch_threshold – Threshold for a button press to be registered (0-255)
release_threshold – Threshold for a button released to be registered (0-255)

bool read(uint8_t channel)

Returns: true if the given channel (0-11) is being pressed, false otherwise

bool pressed()

uint8_t lastPressed()

uint8_t lastReleased()