Touch Board + Grapher

Use the Grapher to visualise the sensitivity and precision of the Touch Board's capacitive sensors

The Touch Board has 12 electrodes that can be used as capacitive sensors and we’ve developed the Grapher as a tool to visualise the capacitance of these sensors. This is a great tool for observing the behaviour of the sensors and see if there is any noise or whether the sensors are triggered or not. You can also use it for calibration of capacitive proximity sensing, or trying to capture measurement of a sensor. If you are using a laptop, make sure the laptop is connected to power to avoid grounding issues.

Step 1 Update the code on the Touch Board

First, if you are using a laptop, make sure to have it connected to power, otherwise, you might experience some grounding issues.

If you haven’t set up your Touch Board, then check out the setup tutorial. In the code that you are using, look out for const bool MPR121_DATASTREAM_ENABLE = false; in the Arduino IDE and change it to const bool MPR121_DATASTREAM_ENABLE = true;. Upload the updated code to the Touch Board, making sure that you have selected the right settings for the Touch Board.

Step 2 Download and install the Grapher

Next, you need to download Processing, if you haven’t installed it yet. Once downloaded, open and close it once so that it generates the necessary files.

Then, download our Grapher. Unzip the file and move the folder “mpr121_grapher” to the corresponding location:




My Documents\Processing



Linux (Ubuntu)


Step 3 Install the necessary libraries

With the folder in place, open Processing. You need to install two libraries for the Grapher, controlP5 and oscp5. In Processing, head to

Sketch→Import Library→Add Library…

In the search field, look for the two libraries and then click “Install”. Once you have installed the libraries, open the Grapher sketch, by heading to


and then opening “mpr121_grapher”.

Step 4 Run the Grapher

Plug in your Touch Board and run the Grapher sketch. Select your Touch Board from the dropdown menu that appears in the window. You’ll probably have a number of choices, but generally, the device is the last or near the end of the list, named something like “/DEV/CU.USBMODEM…”

You’ll know you’ve selected the right serial port when you see a scrolling display of data. Touch electrode 0 and you should see a reaction that shows the change in the electric field of the sensors as a touch event. You can also view the data from other electrodes, either by selecting them from the dropdown menu or by using the arrow keys.

Step 5 Different modes

If you click “Help” you can see all the possible commands for the Grapher. By pressing “S”, you can view the solo mode where you only see the touch and release events on black and white.

Step 6 Change the thresholds values

Try pressing “B” on your computer, you should see 12 red bars, which are the capacitive sensors of the Touch Board. Touch any of them and see the red bar dropping and turning white. This means the board is registering an event. So now you can see all of the sensors at once.

If you now click and drag one of the bars, you can see a dark green and a yellow line being moved along. These are the touch and release thresholds of a sensor and are saved in your Touch Board, so if you turn the Touch Board off and on, it will have the same threshold values as you set them in the bar mode, they remain constant.

Step 7 Reset the Touch Board

Whenever you attach something to the electrodes of the Touch Board, you need will need to reset the board. The Grapher is also able to reset the Touch Board, so that if you connect something to the electrodes, you don’t need to manually turn the board off and on again. Instead, you can do it by clicking the “Reset” button at the top.

Step 8 Retrieve the data

If you press “D”, you can export all of the data of the sensors. At the time of writing this is in development, so for now it’s simply a CSV file.

Step 9 Next steps

Now that you have the Grapher running, you can explore the Touch Board’s capacitive sensors much further.

For example, if you want to do some prototyping with proximity sensing, you can simply attach a Printed Sensor to one of the electrodes, reset the board, a measure the distance of your hand to the sensor. Or you can use it to test your next project, where you need to detect a target and hiding your sensors behind a second layer.

The Grapher is also great for troubleshooting. If you feel like your sensors aren’t responding, for example, if you have painted connections with Electric Paint, then you can figure out where along the line it starts to lose signal. Or you can see if there is noise anywhere in your design.

If you have any questions, contact us


Have you seen these related resources?