Datasheet

CircuitPython Software

Adafruit CircuitPython Module Install

To use the MPR121 with your Adafruit CircuitPython board you'll need to install the Adafruit_CircuitPython_MPR121

module on your board.

First make sure you are running the latest version of Adafruit CircuitPython for your board.

Next you'll need to install the necessary libraries to use the hardware--carefully follow the steps to find and install these

libraries from Adafruit's CircuitPython library bundle. For example the Circuit Playground Express guide has a great

page on how to install the library bundle for both express and non-express boards.

Remember for non-express boards like the Trinket M0, Gemma M0, and Feather/Metro M0 basic you'll need to

manually install the necessary libraries from the bundle:

adafruit_mpr121

adafruit_bus_device

You can also download the adafruit_mpr121.zip which contains the adafruit_mpr121 folder from its releases page on

Github.

If your board doesn't support USB mass storage, like the ESP8266, then use a tool like ampy to copy the file to the

board.

Before continuing make sure your board's lib folder or root filesystem has

the adafruit_mpr121, and adafruit_bus_device folders copied over.

Example

To learn how to use the MPR121 module code you can look at the simpletest.py example included in the library. Save

this as a main.py file on your board:

https://learn.adafruit.com/adafruit-mpr121-12-key-capacitive-touch-sensor-breakout-

tutorial

Page 18 of 24