We've created a Touchscreen (About Modules) module that allows you to easily access the touchscreen on devices that have them built in. If you've wired up your own touchscreen then you will probably need to use the relevant touchscreen module directly though (such as the ADS7843).

Using the touchscreen is as easy as writing require("Touchscreen").connect( ... ), and supplying a callback function. The callback function has two arguments (X and Y). When you move your finger on the touchscreen the X and Y coordinates are reported back, and when you lift your finger, the callback function is called once with X and Y set to undefined.

The following example draws a rectangle at each point that is reported when you drag your finger.

function onTouch(x,y) {
  if (x!==undefined)


In most cases you'll want to know when the user's finger was first pressed. You can do this by remembering when the user last lifted their finger. The following example shows how to draw lines - note that it uses moveTo when the user first presses their finger.

var fingerLifted = true;


function onTouch(x,y) {
  if (x===undefined) {
    fingerLifted = true;
  } else {
    if (fingerLifted) {
      // first call after finger was lifted
      fingerLifted = false;
    } else {
      // subsequent calls



No tutorials use this yet.

This page is auto-generated from GitHub. If you see any mistakes or have suggestions, please let us know.